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

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

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

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

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

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

В данном разделе приводится описание полей базы данных Faces.

См. подробную информацию в разделе "Сервис Faces".

Схема БД Faces
Схема БД Faces

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

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

Имя

Тип

Описание

face_id

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.

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

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

Имя

Тип

Описание

attribute_id

varchar(36)

ID атрибута.

descriptor_version

integer

Версия нейросети, которая использовалась для извлечения биометрического шаблона.

descriptor

bytea

Биометрический шаблон в двоичном формате.

descriptor_obtaining_method

integer

Алгоритм, используемый для получения биометрического шаблона.

descriptor_generation

integer

Поколение БШ. Данное значение изменяется при обновлении БШ атрибута. Значение показывает, что БШ не соответствует существующим биометрическим образцам. Начальное значение 0.

encryption_hash

bytea

Хэш-сумма ключа шифрования и алгоритма. См. раздел "Шифрование биометрических шаблонов".

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

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

Имя

Тип

Описание

face_id

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 указывается в запросе на создание лица или в запросе на генерацию события (политика "face_policy").

avatar

varchar(256)

URL фотоизображения, соответствующего лицу.

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

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

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

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

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

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

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

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

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

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

Имя

Тип

Описание

sample_id

varchar(36)

Биометрический образец.

face_id

varchar(36)

ID лица, связанного с биометрическим образцом.

type

integer

Способ использования биометрического образца:

  • "1" — для извлечения биометрического шаблона
  • "5" — для создания базовых атрибутов

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

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

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

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

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

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

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

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

В данном разделе приводится описание полей базы данных 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)

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

external_id

varchar(36)

Внешний ID лица, соответствующего событию. Идентификатор можно указать в запросе на генерацию события.

insert_time

timestamp

Дата и время создания события.

top_matching_candidates_label

varchar(36)

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

top_similar_object_id

uuid

ID наиболее похожего объекта из результатов сравнения. Результаты сравнения получают, когда активирована политика "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 трека. Идентификатор можно указать в запросе на генерацию события.

liveness

smallint

Результат проверки Liveness:

  • "0" — spoof (человек не является реальным)
  • "1" — real (человек является реальным)
  • "2" — неизвестно

end_time

timestamp

Временной код окончания события в видеопотоке. Этот параметр используется для мониторинга создания событий в реальном времени. Задаётся равным "create_time", если не указан явно.

top_similar_external_id

varchar(36)

External ID наиболее похожего объекта из результатов сравнения . Результаты сравнения получают, когда активирована политика "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

Результат оценки длины рукавов:

  • "0" — короткие
  • "1" — длинные
  • "2" — неизвестно

upper_clothing_color

array[int]

Результат оценки цветов верхней одежды:

  • "0" — неизвестно
  • "1" — чёрный
  • "2" — синий
  • "3" — зеленый
  • "4" — серый
  • "5" — оранжевый
  • "6" — фиолетовый
  • "7" — красный
  • "8" — белый
  • "9" — желтый
  • "10" — розовый
  • "11" — коричневый
  • "12" — бежевый
  • "13" — хаки
  • "14" — разноцветный

headwear_apparent_color

smallint

Результат оценки цвета головного убора:

  • "0" — неизвестно
  • "1" — белый
  • "2" — черный
  • "3" — прочий

lower_garment_type

smallint

Результат оценки типа нижней одежды:

  • "0" — неизвестно
  • "1" — брюки
  • "2" — шорты
  • "3" — юбка

lower_garment_colors

array[int]

Результат оценки цветов нижней одежды:

  • "0" — неизвестно
  • "1" — чёрный
  • "2" — синий
  • "3" — зеленый
  • "4" — серый
  • "5" — оранжевый
  • "6" — фиолетовый
  • "7" — красный
  • "8" — белый
  • "9" — желтый
  • "10" — розовый
  • "11" — коричневый
  • "12" — бежевый
  • "13" — хаки
  • "14" — разноцветный

shoes_apparent_color

smallint

Результат оценки цвета обуви:

  • "0" — неизвестно
  • "1" — белый
  • "2" — черный
  • "3" — прочий

meta

jsonb

Пользовательская метаинформация.

stream_id

uuid

ID потока, создаваемого в результате запроса "create stream"

deepfake

smallint

Результат оценки Deepfake:

  • "0" — spoof (человек не является реальным)
  • "1" — real (человек является реальным)

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

Имя Тип Описание
id bigint Первичный ключ таблицы (цифровой).
insert_time timestamp Дата и время создания общего события.
event_create_time timestamp Временной код возникновения общего события в видеопотоке. Этот параметр используется для мониторинга создания общих событий в реальном времени.
event_end_time timestamp Временной код окончания общего события в видеопотоке. Этот параметр используется для мониторинга создания общих событий в реальном времени. Задаётся равным "create_time", если не указан явно.
event_id uuid ID общего события.
event_type varchar(36) Тип общего события.
account_id uuid ID аккаунта, которому принадлежит обобщенное событие.
track_id varchar(36) ID трека. Идентификатор можно указать в запросе на генерацию общего события.
stream_id varchar(36) ID потока.
event jsonb Содержимое общего события.
sourse varchar(128) Источник общего события. Источник указывается в запросе на генерацию общего события.

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

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

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

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

Имя Тип Описание
deletion_id bigint Первичный ключ таблицы (цифровой).
id bigint Внешний ключ таблицы.
deletion_time timestamp without time zone Время удаления события.
event_id uuid Идентификатор удаленного события.

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

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

Имя Тип Описание
deletion_id bigint Первичный ключ таблицы (цифровой).
id bigint Внешний ключ таблицы.
deletion_time timestamp without time zone Время удаления события.
event_id uuid Идентификатор удаленного события.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Имя Тип Описание
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) Источник события.
stream_id uuid ID потока, создаваемого в результате запроса "create stream"

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

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

Имя Тип Описание
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(36) Улица.
house_number varchar(36) Номер дома.
geo_position geography Географические координаты (широта, долгота).

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

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

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

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

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

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

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

В данном разделе приводится описание полей базы данных Tasks.

См. подробную информацию в разделе "Сервис Tasks".

Схема БД Tasks
Схема БД Tasks

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

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

Имя

Тип

Описание

task_id

integer

ID задачи.

create_time

timestamp

Время создания задачи.

end_time

timestamp

Время завершения задачи.

last_update_time

timestamp

Время последнего обновления задачи.

task_type

integer

Тип задачи:

  • "0" — неизвестная
  • "1" — Linker
  • "2" — Clustering
  • "3" — Reporter
  • "4" — Garbage collection
  • "5" — Additional extraction
  • "6" — Cross-matching
  • "7" — ROC-curve calculating
  • "8" — Exporter
  • "9" — Estimator

task_status

integer

Статус задачи:

  • "0" — в ожидании
  • "1" — обрабатывается
  • "2" — отменена
  • "3" — сбой
  • "4" — сбор результатов
  • "5" — выполнена

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

ID расписания.

Модель таблицы 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" — выполнена

content

text

Фильтры и параметры запросов для обработки задачи.

Модель таблицы 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

ID расписания.

create_time

timestamp

Дата создания расписания.

last_update_time

timestamp

Дата и время последних изменений расписания.

status

smallint

Статус расписания:

  • "1" — запущено
  • "2" — остановлено

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#

В данном разделе приводится описание полей базы данных Handlers.

См. подробную информацию о сервисе Handlers в разделе "Сервис Handlers".

Схема БД Handlers
Схема БД Handlers

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

Имя

Тип

Описание

handler_id

varchar(36)

ID обработчика в формате UUID4 ("xxxxxxxx-xxxx-4xxx-{8-9}xx-xxxxxxxxxxxx").

account_id

varchar(36)

ID аккаунта в формате UUID4, которому принадлежит обработчик.

create_time

timestamp

Дата и время создания обработчика.

last_update_time

timestamp

Дата и время последних изменений обработчика.

description

varchar(128)

Описание обработчика, заданное пользователем.

handler_type

smallint

Тип обработчика:

  • "0" — статический
  • "1" — динамический
  • "2" — lambda

lambda_id

smallint

Lambda ID.

policies

varchar(36)

Политики обработчика.

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

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

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

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

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

В данном разделе приводится описание полей базы данных Configurator.

См. подробную информацию в разделе "Сервис Configurator".

Схема БД Configurator
Схема БД Configurator

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

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

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

Имя Тип Описание
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#

В данном разделе приводится описание полей базы данных Backport 3.

См. подробную информацию в разделе "Сервис Backport 3".

Схема БД 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-{8-9}xx-xxxxxxxxxxxx".
account_id varchar(36) ID аккаунта в формате UUID4, которому принадлежит персона.
user_data varchar(128) Пользовательские данные персоны.
create_time timestamp Дата и время создания персоны.
external_id varchar(36) ID персоны во внешней системе.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В данном разделе приводится описание полей базы данных Accounts.

См. подробную информацию в разделе "Сервис 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"

create_time

timestamp

Дата и время создания аккаунта.

last_update_time

timestamp

Дата и время последнего изменения аккаунта.

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

Имя

Тип

Описание

token_id

varchar(36)

ID токена в формате UUID4.

permissions

varchar(128)

Разрешения токена.

expiration_time

varchar(128)

Время действия токена.

description

varchar(128)

Описание аккаунта.

visibility_area

varchar(128)

Видимость объектов токеном:

  • "all" — все объекты
  • "account" — только объекты своего аккаунта

account_id

varchar(16)

ID аккаунта в формате UUID4, к которому привязан токен.

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

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

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

В данном разделе приводится описание полей базы данных Lambda.

См. подробную информацию в разделе "Сервис Lambda".

Структура БД Lambda
Структура БД Lambda

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

Имя

Тип

Описание

name

varchar(36)

Имя lambda.

description

varchar(256)

Описание lambda.

version

integer

Версия lambda.

account_id

varchar(16)

ID аккаунта в формате UUID4, к которому привязана lambda.

status

smallint

Статус создания lambda:

  • "running" — запущена
  • "waiting" — ожидает запуска
  • "terminated" — остановлена
  • "not_found" — не найдена

create_time

timestamp

Время создания lambda.

last_update_time

timestamp

Дата и время последнего изменения lambda.

user_commands

varchar

Список дополнительных команд Docker для создания lambda-контейнера.

lambda_type

varchar(10)

Тип lambda:

  • "handlers"
  • "standalone"

id

varchar(36)

ID lambda.

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

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

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

В данном разделе приводится описание полей базы данных Video Manager.

См. подробную информацию в разделе "Сервисы видеоаналитики".

Структура БД Video Manager
Структура БД Video Manager

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

Имя

Тип

Описание

id

bigint

Внутренний идентификатор потока.

account_id

varchar(36)

ID аккаунта в формате UUID4, к которому привязан поток.

name

varchar(128)

Имя потока.

description

varchar(512)

Описание потока.

type

varchar(36)

Тип потока - "videofile" или "stream".

reference

varchar(512)

Адрес потока.

rotation

smallint

Угол поворота кадра камеры.

status

smallint

Статус обработки поткоа:

  • "0" — Поток ожидает обработки ("pending").
  • "1" — Обработка потока в процессе ("in_progress").
  • "2" — Обработка потока выполнена ("done").
  • "3" — Обработка потока отправлена в перезагрузку сервером ("restart").
  • "4" — Обработка потока выполнена неуспешно ("failure").
  • "5" — Обработка потока остановлена пользователем ("stop").

version

varchar(10)

Версия потока.

create_time

timestamp

Время создания потока.

status_last_update_time

timestamp

Последнее время обновления статуса.

last_feedback_time

timestamp

Последнее время отправки обратной связи.

stream_id

varchar(36)

Идентификатор потока.

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

В данной таблице содержится информация о группе.

Имя Тип Описание
id bigint Внутренний идентификатор группы.
group_name varchar(128) Название группы.
account_id varchar(36) ID аккаунта в формате UUID4, к которому привязан поток.
description varchar(256) Описание группы.
create_time timestamp Время создания группы.
group_id varchar(36) Идентификатор группы.

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

В данной таблице содержится информация о связи групп и потоков.

Имя Тип Описание
group_id varchar(36) Идентификатор группы.
group_name varchar(128) Имя группы.
stream_id varchar(36) Идентификатор потока.
id bigint Внутренний идентификатор потока.

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

В данной таблице содержится информация об автоматическом перезапуске потока.

  • ----------------- + ----------- + ---------------------------------------------------------------------------- + | Имя | Тип | Описание | +-------------------+-------------+------------------------------------------------------------------------------+ | restart | smallint | Включен ли автоматический перезапуск потоков. "1" — включен, "0" — выключен. | +-------------------+-------------+------------------------------------------------------------------------------+ | attempt_count | smallint | Количество попыток, которые нужно делать для автоматического перезапуска. | +-------------------+-------------+------------------------------------------------------------------------------+ | delay | integer | Задержка автоматического перезапуска. | +-------------------+-------------+------------------------------------------------------------------------------+ | current_attempt | smallint | Текущее количество выполненных попыток перезапуска. | +-------------------+-------------+------------------------------------------------------------------------------+ | last_attempt_time | timestamp | Время последней попытки перезапуска. | +-------------------+-------------+------------------------------------------------------------------------------+ | status | smallint | Статус автоматического перезапуска потока: | | | | | | | | - "0" — Автоматический перезапуск отключен ("disabled"). | | | | - "1" — Автоматический перезапуск включен ("enabled"). | | | | - "2" — Автоматический перезапуск в процессе ("in_progress"). | | | | - "3" — Ошибка автоматического перезапуска ("failed"). | +-------------------+-------------+------------------------------------------------------------------------------+ | stream_id | varchar(36) | Идентификатор потока. | +-------------------+-------------+------------------------------------------------------------------------------+

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

В данной таблице содержится информация о дополнительной информации потока, задаваемой в запросе на его создание.

Имя Тип Описание
account_id varchar(36) ID аккаунта в формате UUID4, к которому привязан поток.
city varchar(36) Город.
area varchar(36) Область.
district varchar(36) Район.
street varchar(36) Улица.
house_number varchar(36) Номер дома.
geo_position geography Географические координаты (широта, долгота).
stream_id varchar(36) Идентификатор потока.

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

В данной таблице содержится информация о видеоаналитике.

Имя Тип Описание
analytic_name varchar(36) Имя аналитики.
description varchar(512) Описание аналитики.
documentation bytea Файл документации.
version smallint Версия аналитики.
validation_schema varchar Схема валидации.
default_parameters varchar Стандартные параметры аналитики.
account_id varchar(36) ID аккаунта в формате UUID4, к которому привязан поток.
create_time timestamp Время создания аналитики.
last_update_time timestamp Последнее время обновления аналитики.
analytic_id varchar(36) Идентификатор аналитики.

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

В данной таблице содержится информация об агенте.

Имя

Тип

Описание

agent_name

varchar(128)

Имя агента.

description

varchar(512)

Описание агента.

status

smallint

Статус агента:

  • "0" — Не готов ("not_ready").
  • "1" — Готов ("ready").

max_stream_count

smallint

Максимальное количество потоков, которые может обработать агент.

active_stream_count

smallint

Текущее количество потоков, обрабатываемых агентом.

account_id

varchar(36)

ID аккаунта в формате UUID4, к которому привязан агент.

create_time

timestamp

Время создания агента.

last_update_time

timestamp

Время последнего обновления агента.

last_feedback_time

timestamp

Последнее время отправки обратной связи.

agent_id

varchar(36)

Идентификатор агента.

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

В данной таблице содержится информация какие аналитики нужны потоку.

Имя Тип Описание
analytic_id varchar(36) Идентификатор аналитики.
stream_id varchar(36) Идентификатор потока.
analytic_name varchar(36) Название аналитики.
analytic_parameters varchar Параметры аналитики.
id bigint Внутренний идентификатор аналитики.

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

В данной таблице содержится информация с какими аналитиками может работать агент.

Имя Тип Описание
agent_id varchar(36) Идентификатор агента.
analytic_id varchar(36) Идентификатор аналитики.
analytic_name varchar(36) Имя аналитики.
id bigint Внутренний идентификатор агента.

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

Имя Тип Описание
status smallint Внутренний статус агента.
agent_id varchar(36) Идентификатор агента.
stream_id varchar(36) Идентификатор потока.
id bigint Внутренний идентификатор.

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

В данной таблице содержится информация о логах обработки потока.

Имя

Тип

Описание

stream_id

varchar(36)

Идентификатор потока.

time

timestamp

Время создания лога.

error

varchar

Описание ошибки обработки потока.

status

smallint

Cтатус обработки потока.

  • "0" — Поток ожидает обработки ("pending").
  • "1" — Обработка потока в процессе ("in_progress").
  • "2" — Обработка потока выполнена ("done").
  • "3" — Обработка потока отправлена в перезагрузку сервером ("restart").
  • "4" — Обработка потока выполнена неуспешно ("failure").
  • "5" — Обработка потока остановлена пользователем ("stop").

status_last_update_time

timestamp

Время последнего обновления статуса.

meta

varchar

В настоящее время параметр не используется.

log_id

bigint

Идентификатор лога.

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

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