Перейти к содержанию

Описание баз данных#

Все данные с метками времени хранятся в формате RFC 3339.

Время, используемое для хранения данных в базе данных можно установить в конфигурационном файле для каждого сервиса в параметре STORAGE_TIME. Можно выбрать время хранения: LOCAL или UTC.

Если STORAGE_TIME задано как LOCAL, но время приходит в формате UTC, данные преобразуются в местное время. Если задан формат UTC, а время приходит местное, оно также преобразуется в UTC.

Описание базы данных Faces#

Основная схема базы данных Faces приведена ниже.

БД Faces
БД Faces

Модель таблицы attribute#

Модель таблицы базы данных описывает атрибуты, прикреплённые к лицам.

Имя primary_key Тип Описание
face_id true varchar(36) ID лица
gender - integer Оценка пола. 0- женщина, 1 – мужчина
gender_obtaining_method - integer Алгоритм, используемый для оценки пола
gender_version - integer Версия алгоритма оценки пола
age - integer Оценка возраста
age_obtaining_method - integer Алгоритм, используемый для оценки возраста
age_version - integer Версия алгоритма оценки возраста
ethnicity - integer Оценка этнической принадлежности
ethnicity_obtaining_method - integer Алгоритм, используемый для оценки этнической принадлежности
ethnicity_version - integer Версия алгоритма оценки этнической принадлежности
create_time - timestamp Дата и время создания атрибута
account_id - varchar(36) ID аккаунта, которому принадлежит атрибут
descriptor_samples_generation - integer Поколение используемых БО. Если БО атрибута обновляются, значение изменяется. Начальное значение 0.
namespace - integer 0 - атрибут не прикреплен к лицу.
1 - атрибут прикреплен к лицу.

Модель таблицы descriptor#

Модель таблицы базы данных описывает биометрических шаблонов.

Имя primary_key Тип Описание
attribute_id true varchar(36) ID атрибута
descriptor_version true integer Версия нейросети, которая использовалась для извлечения биометрического шаблона
descriptor - bytea БШ в двоичном формате
descriptor_obtaining_method - integer Алгоритм, используемый для получения биометрического шаблона
descriptor_generation - integer Поколение БШ. Если биометрические образцы биометрического шаблона обновляются, значение изменяется. Оно показывает, что БШ не соответствует существующим биометрическим образцам. Начальное значение 0.

Модель таблицы face#

Модель таблицы базы данных описывает существующие лица.

Имя primary_key Тип Описание
face_id true varchar(36) ID лица
account_id - varchar(36) ID аккаунта, которому принадлежит лицо
event_id - varchar(36) ID события. Ссылка на событие, которое создало лицо
user_data - varchar(128) Данные, заданные пользователем для лица
create_time - timestamp Дата и время создания лица
last_update_time - timestamp Дата и время последнего обновления лица
external_id - varchar(36) ID лица. Внешний ID указывается в запросе на создание лица или в запросе на создание события (когда лицо создается с помощью политики создания лица)
avatar - varchar(256) URL фотоизображения, соответствующего лицу.

Модель таблицы list#

Модель таблицы базы данных описывает существующие списки.

Имя primary_key Тип Описание
list_id true varchar(36) ID списка
account_id - varchar(36) ID аккаунта, которому принадлежит список
user_data - varchar(128) Пользовательские данные для списка
create_time - timestamp Дата и время создания списка
last_update_time - timestamp Дата и время последнего обновления списка

Модель таблицы list_face#

Модель таблицы базы данных описывает историю прикрепления лиц к спискам. При прикреплении лица к списку появляется новая запись.

Имя primary_key Тип Описание
list_id true varchar(36) ID списка
face_id true varchar(36) ID лица
last_update_time - timestamp Дата и время последнего прикрепления лица к списку
link_key - integer Порядковый номер прикрепления лица к списку

Модель таблицы базы данных описывает историю открепления лиц от списков. Если лицо было откреплено от списка, появляется новая запись.

Имя primary_key Тип Описание
unlink_key true integer Порядковый номер открепления лица от списка
list_id - varchar(36) ID списка
face_id - varchar(36) ID лица
link_key - integer Порядковый номер прикрепления лица к списку
update_time - timestamp Дата и время последнего открепления лица от списка

Модель таблицы sample#

Модель таблицы базы данных описывает связи между биометрическими образцами и лицами.

Имя primary_key Тип Описание
sample_id true varchar(36) БО
face_id true varchar(36) ID лица, связанного с биометрическим образцом
type true integer 1 - БО использовался для извлечения биометрического шаблона, 5 - БО использовался для создания базовых атрибутов

Модель таблицы list_deletion_log#

Модель таблицы базы данных описывает историю удаления списков. Если список был удален, то появляется новая запись.

Имя primary_key Тип Описание
list_id - varchar(36) ID списка
account_id - varchar(36) ID аккаунта, к которому был прикреплен список
deletion_time - timestamp Дата и время удаления списка
create_time - timestamp Время создания списка
deletion_id true integer ID удаления

Модель таблицы requests_cache#

Модель таблицы базы данных описывает кеш максимального количества лиц с привязанными БШ или базовыми атрибутами для запросов лицензии.

Имя primary_key Тип Описание
created_at - timestamp Дата и время кеширования данных
value - text Шифрованный кеш значения
name - varchar(36) Уникальное имя кеша

Модель таблицы luna-faces_migrations#

Имя Тип Описание
version_num varchar(32) Параметр, необходимый для миграции БД

Описание базы данных Events#

В данном разделе описана база данных сервиса Events.

БД Events
БД Events

Модель таблицы event#

Модель таблицы базы данных описывает существующие события. Она включает в себя информацию о созданных событиях и лицах.

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой)
account_id uuid ID аккаунта, которому принадлежит событие
create_time timestamp Временной код возникновения события в видеопотоке. Этот параметр используется для мониторинга создания событий в реальном времени.
event_id uuid ID события
handler_id uuid ID обработчика, который создал событие
source varchar(128) Источник события. Источник указывается в запросе на создание события
face_id uuid ID лица, соответствующего событию.
gender smallint Оценка пола по лицу для события
age smallint Оценка возраста по лицу для события
emotion smallint Оценка эмоций для события
ethnic_group smallint Оценка этнической группы для события
user_data varchar(128) Пользовательские данные для лица, соответствующего событию. User_data указывается в запросе на создание события
external_id varchar(36) Внешний ID лица, соответствующего событию. External_id указывается в запросе на создание события
insert_time timestamp Дата и время создания события
top_matching_candidates_label varchar(36) Метка группы кандидатов, используемых для сравнения.
top_similar_object_id uuid ID наиболее похожего объекта из результатов сравнения (политика match_policy). Результаты сравнения получают, когда активирована политика match_policy обработчика.
top_similar_object_similarity double precision Степень схожести наиболее похожего объекта из результатов сравнения. Результаты сравнения получают, когда активирована политика match_policy обработчика.
top_similar_object_type smallint Тип наиболее похожего объекта: 0 - лицо, 1 - событие
mask smallint Результат оценки наличия медицинской маски: отсутствует (1), медицинская маска (2), рот перекрыт (3)
track_id varchar(36) ID трека события
end_time timestamp Временной код окончания события в видеопотоке. Этот параметр используется для мониторинга создания событий в реальном времени. Задаётся равным create_time, если не указан явно
top_similar_external_id varchar(36) External ID наиболее похожего объекта из результатов сравнения (политика match_policy). Результаты сравнения получают, когда активирована политика match_policy обработчика.
apparent_age smallint Оценка возраста по телу для события
apparent_gender smallint Оценка пола по лицу для события: женский (0), мужской (1), неизвестно (2)
backpack_state smallint Состояние рюкзака: отсутствует (0), присутствует (1), неизвестно (2)
headwear_state smallint Состояние головного убора: отсутствует (0), присутствует (1), неизвестно (2)
sleeve_length smallint Длина рукавов: короткие, длинные, неизвестно
upper_clothing_colors smallint Набор цветов верхней одежды: бежевый, чёрный, синий, коричневый, зеленый, серый, хаки, разноцветный, оранжевый, розовый, фиолетовый, красный, белый, желтый, неизвестно
meta jsonb Пользовательская метаинформация
deepfake jsonb Оценка Deepfake

Модель таблицы face_detect_result#

Модель таблицы базы данных описывает обнаружение лиц.

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой)
numeric_id integer Внешний ключ события
rect_x smallint Координата верхнего левого угла ограничивающего прямоугольника лица по оси "X"
rect_y smallint Координата верхнего левого угла ограничивающего прямоугольника лица по оси "Y"
rect_w smallint Ширина ограничивающего прямоугольника
rect_h smallint Высота ограничивающего прямоугольника
sample_id varchar(36) ID биометрического образца
detect_time timestamp Время определения лица
image_origin varchar(256) URL исходного изображения с лицом
detect_ts interval Время относительно чего-либо, например, относительно начала видеофайла

Модель таблицы body_detect_result#

Модель таблицы базы данных описывает обнаружение тел.

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой)
numeric_id integer Внешний ключ события
rect_x smallint Координата верхнего левого угла ограничивающего прямоугольника тела по оси "X"
rect_y smallint Координата верхнего левого угла ограничивающего прямоугольника тела по оси "Y"
rect_w smallint Ширина ограничивающего прямоугольника
rect_h smallint Высота ограничивающего прямоугольника
sample_id varchar(36) ID биометрического образца
detect_time timestamp Время определения тела
image_origin varchar(256) URL исходного изображения с телом
detect_ts interval Время относительно чего-либо, например, относительно начала видеофайла

Модель таблицы face_descriptor#

Модель таблицы базы данных описывает биометрические шаблоны лиц, хранящиеся в базе данных.

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой)
numeric_id bigint Внешний ключ события
descriptor bytea Двоичный БШ лица
descriptor_version integer Версия нейросети, используемая для извлечения БШ

Модель таблицы body_descriptor#

Модель таблицы базы данных описывает биометрические шаблоны тел, хранящиеся в базе данных.

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой)
numeric_id bigint Внешний ключ события
descriptor bytea Двоичный БШ тела
descriptor_version integer Версия нейросети, используемая для извлечения БШ

Модель таблицы event_match_result#

Модель таблицы базы данных описывает результаты сравнения, полученные посредством политики сравнения обработчика. Каждая запись включает в себя информацию о событии, используемом для сравнения, и степень схожести.

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой)
numeric_id bigint Внешний ключ события
label varchar(36) Метка, указываемая для результатов сравнения
similarity double precision Степень схожести, полученная после сравнения БШ события с заданным БШ
event_id uuid ID события
user_data varchar(128) Пользовательские данные, связанные с событием
create_time timestamp Время создания события
external_id varchar(36) Внешний ID лица, созданного во время создания события
handler_id uuid ID, используемый для создания события
source varchar(128) Источник события

Модель таблицы face_match_result#

Модель таблицы базы данных описывает результаты сравнения, полученные посредством политики сравнения обработчика. Каждая запись включает в себя информацию о лице, используемом для сравнения, и степень схожести.

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой)
numeric_id bigint Внешний ключ события
label varchar(36) Метка, указываемая для результатов сравнения
similarity double precision Степень схожести, полученная после сравнения БШ события с заданным БШ лица
face_id uuid ID лица
user_data varchar(128) Пользовательские данные, связанные с лицом
create_time timestamp Время создания лица
external_id varchar(36) Внешний ID лица

Модель таблицы location#

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой)
numeric_id bigint Внешний ключ события
city varchar(36) Город
area varchar(36) Область
district varchar(36) Район
street varchar(128) Улица
house_number varchar(36) Номер дома
geo_position geography Географические координаты (широта, долгота)

Модель таблицы tag#

Модель таблицы базы данных описывает теги для событий. Теги указываются в запросе на создание событий.

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой)
numeric_id integer Внешний ключ события
tag varchar(36) Тег события

Модель таблицы attach_result#

Модель таблицы базы данных описывает прикрепление лица, созданного из события, к списку. Лицо создается с помощью политики "face_policy". Лицо прикрепляется к списку с помощью политики "link_to_lists_policy".

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой)
numeric_id integer Внешний ключ события
list_id uuid Список, к которому прикреплено созданное лицо

Описание базы данных Tasks#

БД Tasks
БД Tasks

Модель таблицы task#

Модель таблицы базы данных описывает созданные задачи. Она включает в себя основную информацию о задаче и ее содержимом.

Имя Тип Описание
task_id integer ID задачи
create_time timestamp Время создания задачи
end_time timestamp Время завершения задачи
last_update_time timestamp Время последнего обновления задачи
task_type integer Тип задачи: неизвестный тип задачи (0), задача Linker (1), задача Clustering (2), задача Reporter (3), задача Garbage collection (4), Additional extraction (5), задача Cross-matching (6), задача ROC-curve calculating (7), задача Exporter (8), Задача Estimator (9)
task_status integer Статус задачи: в ожидании (0), обрабатывается (1), отменена (2), сбой (3), сбор результатов (4), выполнена (5). Статус обновляется рабочими процессами Tasks.
result_id varchar(36) ID результата задачи
account_id varchar(36) ID аккаунта, которому принадлежит задача
count_task_parts_done integer Количество завершенных подзадач
count_task_parts_all integer Общее количество подзадач
content text Содержит фильтры и параметры запросов для обработки задачи
description varchar(128) Содержит заданное пользователем описание задачи
schedule_id integer Идентификатор расписания

Модель таблицы subtask#

Модель таблицы базы данных включает в себя информацию о созданных подзадачах. В зависимости от типа задачи подзадач может быть одна или несколько.

Имя Тип Описание
subtask_id integer ID подзадачи
task_id integer ID соответствующей задачи
result_id varchar(36) ID результата подзадачи
create_time timestamp Время создания подзадачи
end_time timestamp Время завершения подзадачи
subtask_status integer Статус подзадачи: в ожидании (0), обрабатывается (1), отменена (2), сбой (3), сбор результатов (4), выполнена (5). Статус обновляется рабочими процессами Tasks.
content varchar(2048) Содержит фильтры и параметры запросов для обработки подзадачи

Модель таблицы task_error#

Модель таблицы базы данных включает в себя информацию об ошибках, произошедших в процессе обработки задачи. Ошибки добавляются в таблицу рабочими процессами Tasks.

Имя Тип Описание
error_id integer ID ошибки задачи
task_id integer ID соответствующей задачи
error_code integer Код ошибки
description varchar(64) Краткое описание ошибки
detail varchar(1024) Подробное описание ошибки
additional_info varchar(128) Дополнительная информация об ошибке. Может включать в себя ID потерянных объектов и любую другую полезную информацию.
error_time timestamp Время возникновения ошибки

Модель таблицы schedule#

Модель таблицы базы данных включает в себя информацию о расписании выполнения задач.

Имя Тип Описание
schedule_id integer Идентификатор расписания
create_time timestamp Дата создания расписания
last_update_time timestamp Дата и время последних изменений расписания
status smallint Статус расписания (1 - "running" (запущено), 2 - "stopped" (остановлено))
trigger varchar(128) Cron-выражение
trigger_timezone varchar(16) Временная зона (UTC или LOCAL)
account_id varchar(36) ID аккаунта, которому принадлежит расписание
task_type integer Тип задачи, которая выполняется по расписанию
content text Содержимое задачи которая выполняется по расписанию (фильтры, список и пр.)
next_run_at timestamp Время следующего запуска задачи

Модель таблицы luna-tasks_migrations#

Имя Тип Описание
version_num varchar(32) Параметр, необходимый для миграции БД

Описание базы данных Handlers#

Поддерживаются базы данных Oracle и Postgres.

БД Handlers
БД Handlers

Модель таблицы handler#

Имя Тип Описание
account_id varchar(36) ID аккаунта в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx", которому принадлежит обработчик
create_time timestamp Дата и время создания обработчика
description varchar(128) Описание обработчика, заданное пользователем
handler_id varchar(36) ID обработчика в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
is_dynamic boolean Является ли обработчик динамическим
last_update_time timestamp Дата и время последних изменений обработчика
policies varchar(2048) JSON с политиками

Модель таблицы verifier#

Имя Тип Описание
account_id varchar ID аккаунта в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx", которому принадлежит верификатор
create_time timestamp Дата и время создания верификатора
description varchar Описание верификатора, заданное пользователем
verifier_id varchar(36) ID верификатора в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
last_update_time timestamp Дата и время последних изменений
policies varchar(2048) JSON с политиками
version integer Версия верификатора

Модель таблицы luna-handlers_migrations#

Имя Тип Описание
version_num varchar(32) Параметр, необходимый для миграции БД

Описание базы данных Configurator#

БД Configurator
БД Configurator

Модель таблицы limitation#

Таблица с ограничениями.

Имя Тип Описание
limitation_name varchar(128) Название ограничения
validation_schema varchar Схема валидации ограничения
services varchar Список сервисов
default_value varchar Значение ограничения по умолчанию
description varchar(128) Описание ограничения

Модель таблицы settings#

Таблица с настройками.

Имя Тип Описание
id integer ID настройки
value varchar Значение настройки
description varchar(128) Описание настройки
create_time timestamp Время создания настройки
last_update_time timestamp Время последнего изменения настройки
name varchar(128) Название настройки
is_default boolean Является ли эта настройка настройкой по умолчанию

Модель таблицы tag#

Таблица с тегами.

Имя Тип Описание
id integer ID настройки
name varchar(128) Название настройки
tag varchar(128) Строка тега настройки

Модель таблицы group#

Таблица с группами.

Имя Тип Описание
group_name varchar(128) Имя группы
description varchar(256) Описание группы

Модель таблицы group_limitation#

Таблица со ссылками групп ограничений.

Имя Тип Описание
group_name varchar(128) Имя группы
limitation_name varchar(128) Имя ограничения

Модель таблицы configs_migration#

Имя Тип Описание
revision varchar(36) Ревизия миграции настроек

Модель таблицы luna-conf_migrations#

Имя Тип Описание
version_num varchar(32) Параметр, необходимый для миграции БД

Описание базы данных Backport3#

БД Backport3
БД Backport3

Модель таблицы account#

Модель таблицы базы данных для аккаунта.

Имя Тип Описание
account_id varchar(36) ID аккаунта в формате UUID4
active boolean Статус аккаунта

Модель таблицы account_token#

Имя Тип Описание
token_id varchar(36) ID токена
account_id varchar(36) ID аккаунта, к которому привязан токен
token varchar(128) Строка с данными токена

Модель таблицы person#

Модель таблицы базы данных для персон.

Имя Тип Описание
person_id varchar(36) ID персоны в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
account_id varchar(36) ID аккаунта в формате UUID4, которому принадлежит персона, в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
user_data varchar(128) Пользовательские данные персоны
create_time timestamp Дата и время создания персоны
external_id varchar(36) ID персоны во внешней системе

Модель таблицы persons_list#

Имя Тип Описание
list_id varchar(36) ID списка в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
account_id varchar(36) ID аккаунта в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
create_time timestamp Дата и время создания списка

Модель таблицы descriptors_list#

Имя Тип Описание
list_id (varchar(36) ID списка в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
account_id (varchar(36) ID аккаунта, которому принадлежит список, в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
create_time timestamp Дата и время создания списка

Модель таблицы list_person#

Модель таблицы базы данных для связей между персонами и списками.

Имя Тип Описание
list_id varchar(36) ID списка в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
person_id varchar(36) ID персоны в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"

Модель таблицы person_face#

Модель таблицы базы данных для связей между персонами и лицами.

Имя Тип Описание
person_id varchar(36) ID персоны в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
face_id varchar(36) ID лица в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"

Модель таблицы luna-backport3_migrations#

Имя Тип Описание
version_num varchar(32) Параметр, необходимый для миграции БД

Модель таблицы handler#

Модель таблицы базы данных для обработчиков.

Имя Тип Описание
account_id varchar(36) ID аккаунта, которому принадлежит обработчик, в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
type integer Тип обработчика
handler_id varchar(36) ID обработчика в формате UUID4 в формате "xxxxxxxx-xxxx-4xxx-xx-xxxxxxxxxxxx"
create_time timestamp Дата и время создания обработчика
last_update_time timestamp Дата и время последнего изменения обработчика
policies varchar(2048) JSON с политиками
version integer Версия обработчика

Описание базы данных Accounts#

БД Accounts
БД Accounts

Модель таблицы account#

Имя Тип Описание
account_id varchar(36) ID аккаунта в формате UUID4
login varchar(128) Логин аккаунта
password varchar(128) Пароль от аккаунта
description varchar(128) Описание аккаунта
account_type varchar(16) Тип аккаунта: user, advanced_user, admin

Модель таблицы token#

Имя Тип Описание
token_id varchar(36) ID токена в формате UUID4
permissions varchar(128) Разрешения токена
expiration_time varchar(128) Время действия токена
visibility_area varchar(128) Видемость объектов токеном: all (все объекты), account (только объекты своего аккаунта)
description varchar(16) Описание
account_id varchar(16) ID аккаунта в формате UUID4, к которому привязан токен

Модель таблицы luna-accounts_migration#

Имя Тип Описание
version_num varchar(32) Параметр, необходимый для миграции БД

Описание базы данных Lambda#

БД Lambda
БД Lambda

Модель таблицы lambda#

Имя Тип Описание
name varchar(36) Имя lambda
description varchar(256) Описание lambda
version integer Версия lambda
status smallint Cтатус создания lambda ("running", "waiting", "terminated", "not_found")
account_id varchar(16) ID аккаунта в формате UUID4, к которому привязана lambda
create_time timestamp Время создания lambda
last_update_time timestamp Дата и время последнего изменения lambda
user_commands varchar Список дополнительных команд Docker для создания lambda-контейнера
lambda_type varchar(10) Тип lambda - Handlers-lambda или Standalone-lambda
id varchar(36) Идентификатор lambda

Модель таблицы luna-lambda_migration#

Имя Тип Описание
version_num varchar(32) Параметр, необходимый для миграции БД