Как устроена модель

Доступно: аналитикам и администраторам

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

Читать модель могут все. Таблицы и «Окружение» видят аналитики и администраторы, а менять модель могут аналитики и администраторы.

Три вида объектов

Вид	Что описывает	Пример
Таблицы	Таблица или запрос в хранилище, её ключ и связи с другими таблицами.	`orders`, `customers`
Измерения	Атрибут, по которому разбивают и фильтруют, и откуда он берётся в каждой таблице.	Дата заказа, страна клиента
Метрики	Что считать: агрегат по таблице или формула из других метрик.	Выручка, число заказов

У каждого объекта есть id — латинские буквы, цифры и _. id называет объект навсегда: переименование — это новый объект, а не правка.

Откуда у метрики разрезы

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

Схема: метрика revenue привязана к таблице orders, которая связана с таблицей customers. Измерение «Дата» берётся из orders, измерение «Страна» — из customers через связь. Значит, у revenue два разреза: «Дата» и «Страна».

Поэтому, если метрику нельзя разбить по нужному измерению, обычно не хватает связи между таблицами или сопоставления измерения с таблицей. Подробнее: Таблицы и связи, Измерения и их значения.

Несколько привязок

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

Для каждого запроса Дефиника сама выбирает самую дешёвую привязку, которая подходит: если вопрос «выручка по дням», хватит витрины; если «выручка по клиентам», понадобятся заказы. Пользователь об этом не думает, а число получается одинаковым. Важно только, чтобы все привязки одной метрики считали одно и то же.

Окружение

У любого объекта в модели есть боковая панель «Окружение» («Показать окружение» / «Скрыть окружение»). Это граф: что объект читает и что читает его. По нему удобно проверить, какие метрики сломаются, если поменять таблицу, или откуда метрика берёт данные.

Одно подключение на модель

Все таблицы модели находятся в одном хранилище — подключении модели по умолчанию. Таблица показывает подключение, но не даёт выбрать другое. Как сменить хранилище, описано в Изменить модель и Хранилища.