Поля модели

Поля в карточке объекта сгруппированы в блоки: «идентичность», «ответственность», «отображение», «вычисление», а у таблиц ещё «источник», «первичный ключ» и «связи». Подписи полей на этой странице — те же, что в карточке. Как поля заполняют по шагам: Таблицы и связи, Измерения, Метрики.

Общие поля

Поле	Что принимает
id	Латинские буквы, цифры и _, первым — буква или _. id называет объект навсегда: переименование — это новый объект, а не правка.
название	Как объект называется в интерфейсе и в ответах.
описание	Что объект значит. Его читают люди и агент — пишите конкретно.
владелец	Кто отвечает за определение.
теги	Метки для поиска и группировки.

Таблица

Поле	Что принимает
источник	«таблица» или «запрос».
имя	Имя таблицы так, как его называет хранилище.
пространство имён	Путь перед именем, от внешнего к внутреннему — например main или catalog.schema.
запрос	SQL для источника «запрос»; передаётся в хранилище как есть.
подключение	Подключение модели — все таблицы находятся в нём. Только показывается, не выбирается.
строки	Примерное число строк — используется для оптимизации запросов. «посчитать строки» заполняет его по хранилищу.
первичный ключ	Столбцы, значения которых уникальны. Без ключа ни один столбец не считается уникальным.
связи	Для каждой: «алиас», «цель» (id таблицы) и «условие», например customer_id = customer.id.

Измерение

Поле	Что принимает
тип	Тип значений измерения, например время.
гранулярность	Для времени: самая мелкая гранулярность, с которой можно показать измерение.
таблицы	По строке на таблицу: «таблица» и «выражение» — откуда в ней берётся значение. Несколько таблиц позволяют одному измерению охватить их все.
значения	«нет» — только область значений; «категориальная» — значения образуют именуемое множество, что и даёт список значений.
значение, название, цвет	Для каждого объявленного значения: сырое значение (сопоставляется точно), подпись и цвет на графиках. «null» — подпись для пустых значений.

Метрика

Поле	Что принимает
формат	Как показывать значение: currency:USD, percent:1, number:0, date:long.
пусто	Что показывать, когда у строки нет значения: «нет», число, текст, true или false.
вычисление	«базовая» — считается по своим таблицам; «производная» — вычисляется из других метрик.
выражение (производная)	Формула из других метрик, например revenue / orders_count.
привязки (базовая)	Одна или несколько; поля привязки — ниже.

Привязка базовой метрики

Поле	Что принимает
таблица	id таблицы.
вид	«агрегат» — значение складывается за период; «снимок» — значение на момент времени, например остаток.
выражение	Агрегат по строкам таблицы, например sum(amount).
время	Столбец, который располагает строки на временной шкале. Для агрегата необязателен; для снимка обязателен — это дата каждого снимка, например placed_at.
ключ	Для снимка: что именно снимается, например столбец склада или вагона.
фильтр	Какие строки видит привязка до агрегации — собственный WHERE определения.

Наблюдения

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