DatabaseQuery

Статья создана

Обновлена 15 октября 2025 г.

Выполнение SQL-запросов к базам данных MySQL®, PostgreSQL, ClickHouse® и YDB.

Поля connection и dsn — взаимоисключающие, нужно использовать только одно из них.

Имя поля	Тип	Обязательное	Значение по умолчанию	Поддерживается шаблонизация	Описание
`connection`	DatabaseConnection	Нет	Нет	Нет	Параметры подключения к базе данных.
`dsn`	`string`	Нет	Нет	Нет	Строка подключения (DSN) к базе данных. Поддерживаемые схемы: `postgres://`, `postgresql://`, `clickhouse://`, `grpc://`, `grpcs://`, `ydb://`, а также формат MySQL® DSN (`user:pass@tcp(host:port)/db?...`).
`query`	`string`	Да	Нет	Да	Текст SQL-запроса.
`mode`	`string`	Нет	`EXEC`	Нет	Метод выполнения SQL-запроса. Доступные значения: `EXEC` — выполнить SQL-запрос и вернуть только служебные поля, например `RowsAffected` и `LastInsertId`); `QUERY` — выполнить SQL-запрос и вернуть результат.

DatabaseConnection

Поля simple и iam — взаимоисключающие, нужно использовать только одно из них. Поле iam поддерживается только для базы данных YDB.

Для базы данных MySQL® автоматически устанавливаются parseTime=true и charset=utf8mb4.

Имя поля	Тип	Обязательное	Значение по умолчанию	Поддерживается шаблонизация	Описание
`type`	`string`	Да	Нет	Нет	Тип базы данных. Доступные значения: `MYSQL`, `POSTGRES`, `YDB`, `CLICKHOUSE`.
`host`	`string`	Да	Нет	Нет	Хост базы данных.
`port`	`number`	Да	Нет	Нет	Порт базы данных.
`database`	`string`	Да	Нет	Нет	Имя базы данных.
`ssl`	`bool`	Нет	`false`	Нет	Если значение `true`, для подключения к базе данных используется SSL-соединение. Дополнительно: Для базы данных PostgreSQL устанавливается `sslmode=require`, если `ssl=true`. Иначе — `sslmode=disable`. Для базы данных ClickHouse® устанавливается `secure=true`, если `ssl=true`.
`simple`	DatabaseConnectionSimpleAuth	Нет	Нет	Да	Аутентификация по имени пользователя и паролю.
`iam`	`bool`	Нет	Нет	Нет	Аутентификация по IAM-токену сервисного аккаунта, указанного в настройках рабочего процесса.

Имя поля	Тип	Обязательное	Значение по умолчанию	Поддерживается шаблонизация	Описание
`username`	`string`	Да	Нет	Да	Имя пользователя.
`password`	`string`	Да	Нет	Да	Пароль пользователя.