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

Базы данных

Интеграция с базой данных подключает сценарий к вашей базе Postgres или MySQL. Строки читаются и пишутся типизированными действиями, а для всего остального есть сырой SQL. После синхронизации структуры редактор знает таблицы базы: подсказывает названия таблиц и колонок, а результат запроса типизирован по строкам таблицы.

Добавьте интеграцию Postgres или MySQL в документе Интеграции и укажите строку подключения: postgres://user:pass@host:5432/db или mysql://user:pass@host:3306/db — отдельно для тестового стенда и прода (обычно это разные базы). Рядом — настройка ssl (prefer / require / disable).

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

После синхронизации у каждой таблицы появляются четыре типа: Row (строка как из запроса), Insert (колонки со значением по умолчанию или допускающие NULL необязательны), Patch (все колонки необязательны) и Where (фильтр, см. ниже). Числа становятся числами, текст, даты и UUID — строками, булевы — булевыми, JSON и всё нераспознанное — типом any.

  • Select — все подходящие строки массивом Row. Необязательные where, orderBy (например, created_at desc) и limit.
  • Select one — одна строка; если ничего не найдено — ошибка. Если «ничего не найдено» — нормальный исход, используйте Select с limit 1.
  • Insert — вставляет строку и возвращает её как Row, включая значения, заполненные базой (id, дату создания).
  • Update — применяет Patch к строкам под where и возвращает число изменённых. where обязателен и не может быть пустым — случайно обновить всю таблицу нельзя.
  • Delete — так же с обязательным where, возвращает число удалённых строк.
  • Query — сырой SQL для join, агрегатов и всего остального, с параметрами через $1, $2 (Postgres) или ? (MySQL). Значения всегда передаются параметрами, а не вставляются в текст запроса — это защищает от SQL-инъекций.

Значение у колонки означает «равно» (null — IS NULL). Для других условий укажите объект с операторами: eq, ne, gt, gte, lt, lte, in, notIn, isNull, а для текста — like, ilike, startsWith, contains. Несколько колонок объединяются через «и»; для «или» используйте массив or (или and), их можно вкладывать:

// status — "new" или "paid", и total больше 100
{ status: { in: ['new', 'paid'] }, total: { gt: 100 } }
// id равен 1 или 2
{ or: [{ id: 1 }, { id: 2 }] }
// note содержит "urgent" без учёта регистра (Postgres)
{ note: { ilike: '%urgent%' } }

Каждое действие с базой при сбое (обрыв сети, недоступная база) автоматически повторяется. Редкий граничный случай: база записала строку, но подтверждение не дошло до обрыва связи — тогда повтор может вставить ту же строку второй раз. Если это критично, добавьте в таблицу уникальное ограничение или колонку с ключом идемпотентности, чтобы база сама отклонила повтор.