Работа с базой данных

Описание действий сценариев для взаимодействий с БД.

Найти записи

Действие запрашивает и возвращает массив записей из указанной таблицы. У запроса доступны фильтрация по формуле, ограничение и пропуск записей. Условие фильтра может содержать название колонки в формате @column_name. Для запроса всех записей условие не указывается.

В случае если ни одна запись не подходит под условие, возвращается пустой массив.

Пример условия фильтра, где запрос к таблице вернет только те записи, у которых в колонке name будет строка "Алиса":

@name == "Алиса"

Пример в песочнице

Больше примеров создания фильтра по формуле можно увидеть здесь:

Найденные записи есть возможность отсортировать по возрастанию и убыванию. Подробнее о сортировке:

Найти одну запись

Работает аналогично действию "Найти записи", но вместо массива возвращает первую найденную запись или null, в случае если ничего не найдено.

Пример в песочнице

Посчитать записи

Возвращает число - количество найденных записей таблицы. Как и в действии "Найти записи", можно указать фильтр по формуле.

Пример в песочнице

Создать запись

Позволяет создать в таблице новую запись с указанными значениями. Для корректного создания новой записи типы данных значений должны соответствовать типам данных колонок таблицы. Если типы не соответствуют, при возможности, значения будут приведены к требуемым. Например, если записать строку “123” в поле с числовым типом, то строка будет конвертирована в число.

Пример в песочнице

Изменить записи

Вносит изменения в одну или множество записей из таблицы, найденных по идентификатору или формуле. Возвращает количество измененных записей.

Пример в песочнице

Удалить записи

Удаляет записи из таблицы, найденные по идентификатору или формуле. Возвращает количество удаленных записей.

Пример в песочнице