SQL-запросы: компонент SQL Database (AI Flowi Workflow)
SQL-запросы к базам данных, совместимым с SQLAlchemy, выполняет компонент SQL Database. Результат, указанный в экспорте, имеет тип Table, поэтому определите принимающий порт, прежде чем подключать запрос к дальнейшей обработке.
SQL Database описан в каталоге; Ai Flowi не проверяла его в рабочих условиях.
Автор: Ai Flowi · Опубликовано
Сведения из каталога
Сведения в этом справочнике по SQL основаны на каталоге AI Flowi Workflow 1.9.2, экспортированный 9 октября 2026 года, а именно запись data_source.SQLComponent. Описание в каталоге: Выполняет SQL-запросы к базам данных, совместимым с SQLAlchemy.
Открыть запись SQL Database в каталоге.
По теме: Генерация SQL по тексту.
Входы
Два обязательных поля — database_url и query; оба допускают подключения типа Message. Для логических полей метаданные допустимых типов входа отсутствуют, что обозначено как «Не указаны».
| Имя | Тип | Обязательный | Допустимые типы входных данных | Пояснение |
|---|---|---|---|---|
add_error | bool | Нет | Не указаны | Логическая настройка add_error; формат ошибок и значение по умолчанию не описаны. |
database_url | str | Да | Message | Обязательный URL подключения к базе данных; допустимый тип подключения — Message. |
include_columns | bool | Нет | Не указаны | Логическая настройка include_columns; экспорт не объясняет её влияние на результат. |
query | str | Да | Message | Обязательный текст SQL-запроса; также допускает подключение от источника типа Message. |
Выходы
| Отображаемое имя | Имя | Тип |
|---|---|---|
| Result Table | run_sql_query | Table |
Result Table — отображаемое имя выхода run_sql_query, объявленного как Table. Для SQL Database не указаны отдельный порт ошибок или выход типа JSON.
Когда использовать SQL Database
Выбирайте SQL Database, когда источник — база данных и у вас уже есть SQL-запрос для выполнения. Для последующей текстовой обработки результата у Parser.input_data указан допустимый тип Table; проверьте возвращённые столбцы, прежде чем задавать следующую конфигурацию.
Когда выбрать другой компонент
Для HTTP-эндпоинта обратитесь к API Request вместо настройки URL базы данных. Для работы с существующим объектом JSON обратитесь к JSON Operations; для преобразования Table в JSON изучите Type Convert перед использованием обработчика, принимающего только JSON.
Пример конфигурации
Пример конфигурации, а не результат документированного тестирования
{
"database_url": "YOUR_DATABASE_URL",
"query": "SELECT 1 AS sample_value;"
}Локально замените YOUR_DATABASE_URL на URL подключения к базе данных, к которой у вас есть разрешение выполнять запросы. Запрос SELECT, возвращающий константу, приведён как начальный пример; для этой страницы не проверялись подключение к базе данных, возвращённая строка или поддерживаемый драйвер.
Сведения об учётных данных SQL-подключений и переменных см. в разделах «Подключения» и «Модели и переменные».
Ограничения
- Каталог заявляет совместимость с SQLAlchemy, но экспорт не содержит списка СУБД или установленных драйверов. В источнике нет примеров строк подключения, настроек TLS или сетевых требований.
- Наличие add_error не подтверждает восстановление после исключений, очистку сообщений об ошибках от чувствительных данных или отдельную ветку ошибок. Проверьте обработку сбоев, прежде чем передавать результаты запросов или подробности ошибок другой системе.
- Для include_columns не документированы значение по умолчанию и структура выхода; сама настройка имён столбцов не определяет структуру Result Table.
- Среди четырёх экспортированных полей нет входа для привязки параметров, управления транзакциями, ограничения числа строк или настройки тайм-аута. Используйте контролируемый запрос и права доступа к базе данных, соответствующие задаче; этот справочник не гарантирует запись, откат или защиту от инъекций.
- Для Select Data.data_list и Filter Data.data указаны типы Data и JSON, но не Table. Списки типов в экспорте не подтверждают прямое подключение Result Table к любому из этих входов.
Расход токенов при запуске узлов
Сведения о расходе токенов в процессах с SQL см. в тарифах и руководстве по затратам.
Связанные компоненты
API Request · Parser · Type Convert · Select Data · Filter Data