Описание действий сценариев для взаимодействий с БД.
Найти записи
Действие запрашивает и возвращает массив записей из указанной таблицы. У запроса доступны фильтрация по формуле, ограничение и пропуск записей. Условие фильтра может содержать название колонки в формате
@column_name
. Для запроса всех записей условие не указывается.В случае если ни одна запись не подходит под условие, возвращается пустой массив.
Пример условия фильтра, где запрос к таблице вернет только те записи, у которых в колонке
name
будет строка "Алиса":@name == "Алиса"
Больше примеров создания фильтра по формуле можно увидеть здесь:
Фильтр по формулеНайденные записи есть возможность отсортировать по возрастанию и убыванию. Подробнее о сортировке:
Сортировка по формулеНайти одну запись
Работает аналогично действию "Найти записи", но вместо массива возвращает первую найденную запись или
null
, в случае если ничего не найдено.Посчитать записи
Возвращает число - количество найденных записей таблицы. Как и в действии "Найти записи", можно указать фильтр по формуле.
Создать запись
Позволяет создать в таблице новую запись с указанными значениями. Для корректного создания новой записи типы данных значений должны соответствовать типам данных колонок таблицы. Если типы не соответствуют, при возможности, значения будут приведены к требуемым. Например, если записать строку
“123”
в поле с числовым типом, то строка будет конвертирована в число.Изменить записи
Вносит изменения в одну или множество записей из таблицы, найденных по идентификатору или формуле. Возвращает количество измененных записей.
Удалить записи
Удаляет записи из таблицы, найденные по идентификатору или формуле. Возвращает количество удаленных записей.