Таблицы
Таблица — место внутри проекта, где сценарий запоминает данные между запусками: клиентов, которых видел бот, список заявок, счётчик, очередь заказов. Ничего подключать не нужно: ни базы данных, ни строки подключения, ни SQL. Таблицу создают рядом с функциями, а в узлах выбирают из списка. Если данные уже лежат во внешней базе — используйте Базы данных.
Таблицы и поля
Заголовок раздела «Таблицы и поля»Таблицы лежат в разделе Tables дерева проекта. В таблице задайте поля — имя и тип: text, number, boolean,
date, datetime (хранится в UTC, показывается в вашем часовом поясе), select (список вариантов), json, file.
Имя может быть на русском, должно быть уникальным в таблице (регистр не важен) и не может быть id, version,
createdAt, updatedAt, and, or. У каждой записи есть системные поля id, version, createdAt, updatedAt.
Структура таблиц входит в проект и в его версии. Записи у тестового стенда и прода — свои, поэтому проверка сценария не затронет боевые данные. Записи не попадают ни в экспорт проекта, ни в версии.
Таблица данных
Заголовок раздела «Таблица данных»Редактор таблицы — сетка с переключателем dev / prod: записи листаются по 50, ищутся (по текстовым полям и select), сортируются и правятся прямо в ячейках; у записи есть история с восстановлением прежнего значения. Также можно:
- импортировать CSV (до 5 МБ) — добавить к записям или заменить их, недостающие поля создадутся по заголовку;
- экспортировать CSV;
- очистить записи окружения;
- скопировать dev в prod — боевые записи заменяются тестовыми;
- загружать файлы в ячейки
file; скачивать их могут владелец и редакторы проекта.
- Select — подходящие записи массивом (
where,orderBy,limit: по умолчанию 100, максимум 1000). - Get — одна запись.
- Insert — добавляет запись и возвращает её с
id. При автоматических повторах шага запись не задвоится. - Update — меняет записи по
where, возвращает их число. - Delete — удаляет записи по
where, возвращает их число.
Фильтр where задаётся по именам полей и работает так же, как в Базах данных: значение
означает «равно», объект принимает операторы (eq, ne, gt, gte, lt, lte, in, notIn, isNull,
contains и другие), массивы and/or объединяют условия. В Update и Delete where не может быть пустым.
// where{ status: { in: ['new', 'paid'] }, total: { gt: 100 } }
// orderBy'priority asc, createdAt desc'Защита от одновременных правок. Каждое изменение увеличивает version. Укажите в where и id, и version — запись
изменится, только если её не трогали после чтения. Если изменено 0 записей, кто-то успел раньше: перечитайте запись и
повторите или остановитесь.
// where узла Update{ id: order.id, version: order.version }// patch{ status: 'paid' }Переименование поля не ломает уже опубликованную версию. Если поле удалить, шаг завершится ошибкой
field "x" no longer exists; если сменить тип поля, значения, которые не подходят под новый тип, читаются как пустые.
Триггеры
Заголовок раздела «Триггеры»Три триггера запускают сценарий, когда запись выбранной таблицы создана, изменена или удалена. Сценарий
получает event: { table, record, previous?, changedFields?, source }.
Окружение определяется записью: запуск на стенде будит триггеры стенда, боевой — боевые. Каждое изменение запускает отдельный запуск; доставляется до 600 событий в минуту на таблицу и окружение, остальное видно в журнале запусков. Если стенд был неактивен 10 минут, ожидающее событие отбрасывается.
Лимиты и доступ
Заголовок раздела «Лимиты и доступ»На проект: 20 таблиц, 100 полей в таблице, 10 000 записей на таблицу и окружение, 64 КБ на запись. Владелец и редакторы делают всё; исполнитель проекта видит вкладку Tables только для чтения.
ИИ-агент создаёт таблицы и поля и использует их в сценариях, но сами записи не читает и не правит — для данных есть таблица и CSV.