Базы данных
Интеграция с базой данных подключает сценарий к вашей базе 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 с
limit1. - Insert — вставляет строку и возвращает её как Row, включая значения, заполненные базой (id, дату создания).
- Update — применяет Patch к строкам под
whereи возвращает число изменённых.whereобязателен и не может быть пустым — случайно обновить всю таблицу нельзя. - Delete — так же с обязательным
where, возвращает число удалённых строк. - Query — сырой SQL для join, агрегатов и всего остального, с параметрами через
$1,$2(Postgres) или?(MySQL). Значения всегда передаются параметрами, а не вставляются в текст запроса — это защищает от SQL-инъекций.
Фильтр where
Заголовок раздела «Фильтр where»Значение у колонки означает «равно» (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%' } }Повторы
Заголовок раздела «Повторы»Каждое действие с базой при сбое (обрыв сети, недоступная база) автоматически повторяется. Редкий граничный случай: база записала строку, но подтверждение не дошло до обрыва связи — тогда повтор может вставить ту же строку второй раз. Если это критично, добавьте в таблицу уникальное ограничение или колонку с ключом идемпотентности, чтобы база сама отклонила повтор.