Первая таблица за 10 минут

Соберём первый датасет — это первый и обязательный шаг перед любым дашбордом. Возьмём пример «Квартира на сдачу», но шаги одинаковы для любого сценария.

Шаг 1. Создайте датасет

В левом сайдбаре нажмите «Датасеты».
В правом верхнем углу — кнопка «Создать».
Введите имя: например, «Объекты недвижимости». Выберите иконку (опционально) и категорию (например, «недвижимость»).
Нажмите «Создать» — откроется пустая схема.

Шаг 2. Добавьте поля

Поля — это колонки таблицы. У каждого поля есть тип (число, дата, текст, валюта…) и ключ на латинице (он будет использоваться в формулах и CSV).

Для примера создадим минимум:

Название	Ключ	Тип
Адрес	`address`	Текст
Дата покупки	`purchase_date`	Дата
Цена покупки	`purchase_price`	Деньги
Площадь, м²	`area_m2`	Число
Сдан в аренду	`is_rented`	Да/Нет
Месячная аренда	`monthly_rent`	Деньги

Чтобы добавить поле:

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

Шаг 3. Внесите первые строки

В левом верхнем углу нажмите «К таблице» — откроется табличный вид.
Нажмите «+ Строка» или клавишу Enter в пустой ячейке.
Заполняйте ячейки прямо в таблице. Поля типа «Дата» открывают календарь, «Деньги» — выбор валюты, «Да/Нет» — переключатель.
Несохранённая строка подсвечена — нажмите Enter или кликните мимо, чтобы зафиксировать.

Подсказка. Если у вас уже есть данные в Excel — экспортируйте в CSV и используйте импорт. Это в разы быстрее, чем вводить вручную.

Шаг 4. Добавьте вычисляемое поле (формула)

Добавим «Валовая доходность» — сколько процентов годовых даёт квартира относительно цены покупки.

Вернитесь в схему: кнопка «Схема» в правом верхнем углу таблицы.
Нажмите «Поле», тип — «Формула».

В поле формулы введите:

gross_yield(monthly_rent * 12, purchase_price)

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

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

Подробнее о синтаксисе формул — в «Синтаксис формул», полный список функций — в «Функции».

Шаг 5. Что важно знать

Удаление строки — мягкое: строка скрывается, но восстановима в течение 30 дней (внутренний срок очистки).
Удаление поля — окончательное для схемы, но значения в jsonb остаются: если вы добавите такое же поле обратно — данные не вернутся автоматически.

⚠️ Уточнить: на момент написания документации поведение автоматической миграции формул при переименовании ключа поля не проверено в коде. Если у вас уже есть формулы — лучше не менять ключ, а создать новое поле.

Частые ошибки

Поставили тип «Число» там, где должно быть «Деньги». «Число» не привязано к валюте — графики и KPI не смогут правильно агрегировать. Меняйте тип сразу, пока строк мало.
Использовали кириллицу в ключе. Ключ должен быть на латинице (snake_case). Название по-русски — отдельное поле.
Поставили «обязательное» для поля-формулы. Это запрещено: формулы вычисляются автоматически и не могут быть «обязательными».
Создали два поля с одинаковым ключом. Ключи уникальны внутри датасета. Проверяйте подсказку под полем «Ключ».