Перейти к содержимому
ШагоматШагоматШагоматДокументация
shagomat.ruВойтиПопробовать бесплатно

Таблицы

Таблица — место внутри проекта, где сценарий запоминает данные между запусками: клиентов, которых видел бот, список заявок, счётчик, очередь заказов. Ничего подключать не нужно: ни базы данных, ни строки подключения, ни 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.