Справочники
Справочник объединяет измерения, описывающие один и тот же объект, и соответствует таблице измерений в базе данных. Он определяет состав измерений, их порядок и первичный ключ, по которому таблица измерений связывается с таблицами фактов. Справочники ведутся на вкладке Справочники экрана РПИ.
Колонки в РПИ таблице со справочниками
| Название колонки | Описание колонки |
|---|---|
| Название | Текстовое поле для понятного бизнес-пользователям названия справочника |
| Описание | Текстовое поле для короткого описания смысла справочника |
| Измерения | Автоматически заполняемое поле со списком принадлежащих справочнику измерений |
| Первичный ключ | Выпадающий список для выбора конкретного поля (колонки) в базе данных для первичного ключа, по которому справочник связывается с таблицами фактов |
| Связанные таблицы фактов | Автоматически заполняемое поле со списком таблиц фактов, связанных со справочником |
По каждой колонке списка доступны сортировка и поиск. Новые порции списка загружаются по мере прокрутки. Если в версии проекта справочников нет, на вкладке отображается сообщение Справочники не найдены вместе с действием создания.
Индикаторы ошибок в списке
| Индикация | Значение |
|---|---|
| Значок предупреждения рядом с названием | В справочнике используются измерения с ошибками |
| Значок предупреждения у измерения | У этого измерения есть ошибки |
| Текст ошибки в колонке Первичный ключ | Первичный ключ использовать нельзя: подключённый источник не настроен в РПИ, подключение удалено или неактивно, колонки больше не существует либо сохранённый источник имеет некорректный формат |
Создание справочника
- Нажмите кнопку Добавить справочник на вкладке Справочники
- Заполните поле Название справочника и, при необходимости, Описание справочника
- Выберите Первичный ключ
- Добавьте измерения справочника и упорядочьте их
- Нажмите Сохранить
Название и описание:
- Название обязательно, должно быть уникальным среди справочников версии и может содержать до 64 символов
- В названии допускаются латинские и кириллические буквы, цифры, пробелы, точки, дефисы и подчёркивания. Название не может начинаться со специального символа
- Описание необязательно и может содержать до 255 символов
Первичный ключ
Первичный ключ — это колонка таблицы измерений, на которую ссылаются таблицы фактов. Он выбирается каскадом:
- Подключение
- Таблица, отображаемая вместе со схемой в виде
схема.таблица - Колонка
Выбранный ключ отображается в виде подключение / схема.таблица / колонка. Этот ключ должен соответствовать первичному ключу таблицы измерений в базе данных — на него опирается генерация SQL для таблиц фактов и витрин. Колонка со стороны таблицы фактов, которая ссылается на этот ключ, настраивается на вкладке Связи экрана РПИ (см. раздел Таблицы фактов).
Измерения справочника
В окне справочника два списка:
- Доступные измерения — измерения версии проекта. Список можно сортировать, по нему доступен поиск
- Измерения в справочнике — измерения, из которых состоит справочник
Измерение добавляется установкой его чекбокса в левом списке и удаляется снятием чекбокса или кнопкой удаления в его строке в правом списке. В обоих списках рядом с измерением есть значок информации, открывающий для него окно Детали из РПИ.
Примечания:
- Измерение может входить только в один справочник. Если добавляемое измерение уже входит в другой справочник, окно предупреждает, что измерение будет перенесено в новый
- Измерения, названия которых дублируются в РПИ, добавить нельзя — сначала устраните дублирование на вкладке Измерения
- Измерения с ошибками отмечаются в списках
Порядок измерений
Измерения в списке Измерения в справочнике упорядочиваются перетаскиванием. Список плоский: одно измерение нельзя вложить в другое, поэтому уровней иерархии внутри справочника нет.
Заданный порядок сохраняется и применяется везде, где отображаются измерения справочника: на вкладке, в этом окне, в таблицах фактов, на канве модели данных, в витринах, в экспортируемом файле и в публичном API.
Редактирование и удаление
- Действие Редактировать в строке справочника открывает то же окно. Кнопка Сохранить сначала запрашивает подтверждение, поскольку изменение затрагивает все элементы версии проекта, использующие этот справочник
- Действие Удалить в строке удаляет справочник после подтверждения. Ссылки на него в РПИ очищаются, а элементы версии проекта, использовавшие справочник, оказываются затронуты, поэтому после удаления их следует проверить
Роли
Создание, редактирование и удаление справочников, а также загрузка их из файла требуют роли Разработчик или выше и действующей лицензии. Роли Аналитик и Наблюдатель могут просматривать список, открывать окно Детали из РПИ и выгружать данные.