Особенности хранения данных в базе данных временных рядов

Описание

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

Получить доступ к данным метасправочникам можно из навигатора объектов или с помощью языка Fore, используя методы IRubricator.GetDictionary и IRubricatorInstance.GetDictionary.

Структура системных метасправочников

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

Структура метасправочника фактов

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

Наименование метасправочника формируется по следующей схеме: Факты_<наименование базы данных временных рядов>. Например, в базе данных временных рядов «Статистика» метасправочник временных рядов будет иметь наименование «Факты_Статистика».

Метасправочник может содержать следующие типы атрибутов: системные и пользовательские. Системные атрибуты создаются автоматически при создании базы данных временных рядов. Пользовательские атрибуты создаются, если пользователь создаёт дополнительные атрибуты временных рядов.

Системные атрибуты метасправочника фактов:

Наименование атрибута	Идентификатор атрибута	Тип данных	Особенности атрибута	Описание
Ключ	KEY	Целый	Пустые значения не допускаются	Первичный ключ.
Факт	FACTOR	Целый	Пустые значения не допускаются	Ключ временного ряда.
Ревизия	REV	Целый	Пустые значения не допускаются	Ключ ревизии.
Динамика	DL	Целый	Пустые значения не допускаются. Значение по умолчанию - «1».	Календарная динамика временного ряда. Для определения динамики используется перечисление DimCalendarLevel.
Единица измерения	UNIT	Целый	Если единицы измерения являются обязательным атрибутом ряда, то пустые значения не допускаются, если единицы измерения не являются обязательным атрибутом ряда, то пустые значения допускаются.	Единица измерения значений ряда.
Объект	OBT	Целый		Ключ объекта репозитория, связанного с рядом. Значение редактируется только с помощью Fore.
Мнемоника	MNEMO	Строковый	Пустые значения не допускаются. По умолчанию длина 255 символов. Атрибут присутствует, если при создании базы данных временных рядов указали, что ряды имеют идентификатор. Атрибут может отсутствовать в метасправочнике. Наличием/отсутствием атрибута управляет свойство IRubricator.HasMnemonics.	Мнемоника временного ряда. Мнемоника - это уникальное значение, генерируемое на основе значений атрибутов временного ряда и используемое в качестве наименования ряда.
Удален	DLT	Логический	Пустые значения не допускаются. Значение по умолчанию - «False».	Признак того, что временной ряд удален. Возможные значения: True. Ряд присутствует в базе данных временных рядов; False. Ряд удален.
Пуст	EMPT	Логический	Пустые значения не допускаются. Значение по умолчанию - «True». Атрибут присутствует, если при создании базы данных временных рядов указали, что ряды имеют признак пустоты. Атрибут может отсутствовать в метасправочнике. Наличием/отсутствием атрибута управляет свойство IRubricator.HasEmptyAttribute.	Признак того, что временной ряд имеет признак пустоты и пустым считается ряд, не содержащий данных. Возможные значения: True. Ряд пустой; False. Ряд содержит данные.

Структура метасправочника значений временных рядов

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

Наименование метасправочника формируется по следующей схеме: Значения_<наименование базы данных временных рядов>. Например, в базе данных временных рядов «Статистика» метасправочник значений временных рядов будет иметь наименование «Значения_Статистика».

Системные атрибуты метасправочника значений временных рядов:

Наименование атрибуты	Идентификатор атрибуты	Тип данных	Особенности поля	Описание
Ключ	KEY	Целый	Пустые значения не допускаются	Первичный ключ.
Факт	FACTOR	Целый	Пустые значения не допускаются	Ключ временного ряда, которому принадлежит наблюдение.
Ревизия	REV	Целый	Пустые значения не допускаются	Ключ ревизии, в которую было задано или изменено значение наблюдение.
Динамика	DL	Целый	Пустые значения не допускаются	Календарная динамика наблюдения. Для определения динамики используется перечисление DimCalendarLevel.
Дата	DT	Дата	Пустые значения не допускаются	Дата, на которую задано значение наблюдения.
Сценарий	SC	Целый	Пустые значения не допускаются. Значение по умолчанию - «-1».	Ключ сценария, которому принадлежит наблюдение. Если значение «-1», то наблюдение принадлежит сценарию «Факт». Примечание. Атрибут отсутствует, если база данных временных рядов не поддерживает сценарии. Для получения подробной информации обратитесь к описанию IRubricator.HasScenarioDimension.
Значение	VL	Вещественный	Общая длина - 30 знаков, количество десятичных знаков - 8.	Значение наблюдения.
Примечание	CMT	Строковый	По умолчанию длина 255 символов	Примечание к наблюдению.

Особенности метасправочника значений

Если база данных временных рядов использует базу данных на СУБД MS SQL, то для атрибута «VL» доступно снятие ограничения на общую длину знаков. Для этого нужно использовать процедуру, приведенную ниже.

Процедура приведена для базы данных временных рядов с идентификатором «TSDB».

Добавьте ссылки на системные сборки: Cubes, Metabase, Rds.

Sub UserProc;
Var
    mb: IMetabase;
    rub: IRubricator;
    attr: IMetaAttribute;
Begin
    mb := MetabaseClass.Active;
    rub := mb.ItemById("TSDB").Edit As IRubricator;
    attr := rub.EditValues.Attributes.FindById("VL");
    attr.FieldSize := 0;
    rub.AlterAndSave;
End Sub UserProc;

В результате выполнения процедуры в базе данных временных рядов «TSDB» для атрибута «VL» снято ограничение на общую длину знаков.

Важно. Снятие ограничения на общую длину знаков выполняется за счет того, что на уровне СУБД для атрибута устанавливается тип данных float. Это приводит к потере точности после семнадцати знаков.

Структура метасправочника ревизий

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

Наименование метасправочника формируется по следующей схеме: Ревизии_<наименование базы данных временных рядов>. Например, в базе данных временных рядов «Статистика» метасправочник ревизий будет иметь наименование «Ревизии_Статистика».

Наименование атрибуты	Идентификатор атрибуты	Тип данных	Особенности поля	Описание
Ключ	KEY	Целый	Пустые значения не допускаются	Первичный ключ.
Наименование	NAM	Строковый	По умолчанию длина 255 символов	Наименование ревизии.
Дата	DT	Дата		Дата выполнения ревизии.
Вид	KIN	Целый		Признак того, отображается ли данная ревизия в справочнике ревизий. Возможные значения: 0. Ревизия не отображается; 1. Ревизия отображается.
Пользователь	USR	Строковый	По умолчанию длина 255 символов	Пользователь, выполнивший ревизию.
Примечание	CMT	Строковый	По умолчанию длина 255 символов	Примечание к выполнению ревизии.
Объект	OBT	Целый		Ключ объекта репозитория, который инициировал появление ревизии.

Структура метасправочника выполнения правил валидации

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

Наименование метасправочника формируется по следующей схеме: Выполнения правил_<наименование базы данных временных рядов>. Например, в базе данных временных рядов «Статистика» метасправочник ревизий будет иметь наименование «Выполнения правил_Статистика».

Наименование атрибуты	Идентификатор атрибуты	Тип данных	Особенности поля	Описание
Ключ	KEY	Целый	Пустые значения не допускаются	Первичный ключ.
Наименование	NAM	Строковый	По умолчанию длина 255 символов	Наименование выполнения правила валидации.
Ревизия	REV	Целый	Пустые значения не допускаются	Ключ ревизии, в которой было выполнено правило.
Объект	OBT	Целый		Ключ правила валидации как объекта репозитория.
Дата	DT	Дата		Дата выполнения правила валидации.
Правило	CMT	Целый		Список ключей валидаций, входящих в рассчитанную группу валидаций. Если рассчитывалась одна валидация, то только её ключ.
Расчеты валидаций	BY_SC	Целый		Признак того, что валидация была рассчитана в по какому-либо сценарию. Возможные значения: значение отсутствует. Правило валидации не было рассчитано по сценарию; 1. Правило валидации рассчитано по сценарию.
Окончание расчета	FNSH	Логический		Признак того, что выполнение правила валидации окончено. Возможные значения: 0. Правило валидации еще выполняется; 1. Правило валидации уже выполнено.

Структура метасправочника исключений, выявленных правилами валидации

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

Наименование метасправочника формируется по следующей схеме: Значения правил_<наименование базы данных временных рядов>. Например, в базе данных временных рядов «Статистика» метасправочник ревизий будет иметь наименование «Значения правил_Статистика».

Наименование атрибуты	Идентификатор атрибуты	Тип данных	Особенности поля	Описание
Ключ	KEY	Целый	Пустые значения не допускаются	Первичный ключ.
Факт	FACTOR	Целый	Пустые значения не допускаются	Ключ временного ряда, которому принадлежит наблюдение.
Динамика	DL	Целый	Пустые значения не допускаются	Календарная динамика наблюдения. Для определения динамики используется перечисление DimCalendarLevel.
Дата	DT	Дата		Дата наблюдения.
Правило	CMT	Целый		Ключ выполнения правила валидации. По нему можно найти соответствующую запись в метасправочнике выполнения правил валидации.
Значение	VL	Целый		Признак того, что в матрице исключений валидации присутствует значение. Атрибут имеет значение «1», если исключение объяснено, и пустое значение, если исключение не объяснено.
Сценарий	SC	Целый	Пустые значения не допускаются	Ключ сценария, которому принадлежит наблюдение. Если значение «-1», то наблюдение принадлежит сценарию «Факт». Примечание. Атрибут отсутствует, если база данных временных рядов не поддерживает сценарии. Для получения подробной информации обратитесь к описанию IRubricator.HasScenarioDimension.