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

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

Все данные с метками времени хранятся в формате 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

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

deepfake

smallint

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

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

Модель таблицы 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 Версия нейросети, используемая для извлечения БШ.
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) Источник события.

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

Схема БД 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) Параметр, необходимый для миграции БД.