Таблицы и связи

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

Таблица в модели описывает таблицу (или запрос) в хранилище: откуда читать строки, что в них уникально и как они соединяются с соседними таблицами. Все шаги — в режиме редактирования.

Добавить таблицу

В дереве у группы «Таблицы» нажмите «+» («Добавить: таблица»).
Задайте id, например invoice_items. Латинские буквы, цифры и _, первым — буква или _. id называет объект навсегда — выберите его сейчас.
В блоке «источник» выберите вид:
- «таблица» — укажите «имя» (как его называет хранилище) и «пространство имён» (путь перед именем, от внешнего к внутреннему, например main или catalog.schema);
- «запрос» — напишите SQL, который возвращает строки. Он передаётся в хранилище как есть.
Необязательно: в поле «строки» нажмите «посчитать строки». Примерное число строк помогает оптимизировать запросы.
Заполните «название» и «описание», чтобы таблицу было легко найти.

Подключение таблице не выбирают: у модели одно подключение, и все таблицы находятся в нём.

Первичный ключ

В блоке «первичный ключ» нажмите «объявить ключ» и укажите столбец (или несколько), значения которого уникальны в таблице. Пока ключ не объявлен, ни один столбец таблицы не считается уникальным.

Связи

Связи говорят, как строки этой таблицы соединяются со строками других. Именно через связи метрика получает разрезы из соседних таблиц (как это работает).

В блоке «связи» нажмите «добавить связь» и заполните:

Поле	Что указать
алиас	Имя связи, например `customer`.
цель	id таблицы, к которой ведёт связь, например `customers`.
условие	Как соединяются строки, например `customer_id = customer.id`.

Проверить работу

«показать строки» — первые строки таблицы прямо в карточке. Удобно убедиться, что имя и пространство имён указаны верно.
«Окружение» — граф связей: видно, с какими таблицами связана новая и какие метрики её читают.

Затем сохраните черновик: проверки выполнят таблицу на хранилище. Все поля таблицы: Поля модели.