SQLクエリ実行：SQL Database コンポーネント（AI Flowi Workflow）
SQLクエリ実行用のSQL Databaseは、SQLAlchemy互換のデータベースに対してSQLクエリを実行します。エクスポートに記載された結果の型はTableなので、クエリを後続の処理に接続する前に、受け側のポートを検討してください。
SQL Databaseはカタログに記載されていますが、Ai Flowiによる本番環境でのテストは行われていません。
執筆：Ai Flowi · 公開日
カタログ参照
このSQLリファレンスは、2026年10月9日にエクスポートされたAI Flowi Workflow 1.9.2カタログのdata_source.SQLComponentに基づいています。カタログの説明：SQLAlchemy互換のデータベースに対してSQLクエリを実行します。
カタログのSQL Database項目を見る。
関連情報：自然言語 SQL 生成。
入力
必須フィールドはdatabase_urlとqueryの2つで、いずれも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クエリがすでにある場合は、SQL Databaseを選びます。結果を使ってテキスト処理を行う場合、Parser.input_dataが受け付ける型にはTableが記載されています。次の設定を決める前に、返された列を確認してください。
別のコンポーネントを選ぶ場合
HTTPエンドポイントを扱う場合は、データベースURLを設定するのではなく、API Requestの手順に従ってください。既存のJSONオブジェクトを処理する場合はJSON Operationsを参照し、TableをJSONに変換する場合は、JSONのみを扱うプロセッサーを使う前にType Convertを確認してください。
設定例
設定例です。実施したテストの記録ではありません
{
"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の構造は判断できません。
- エクスポートされた4つのフィールドには、パラメーターをバインドする入力、トランザクション制御、行数制限、タイムアウト設定はありません。管理されたクエリと、作業に適したデータベース権限を使用してください。このリファレンスは、書き込み、ロールバック、インジェクション対策を保証するものではありません。
- Select Data.data_listとFilter Data.dataの入力型にはDataとJSONが記載されており、Tableは含まれていません。エクスポートされた型の一覧では、Result Tableからどちらの入力への直接接続もサポートされていません。
ノードの使用量
SQLワークフローの使用量については、料金とコストガイドを参照してください。
関連コンポーネント
API Request · Parser · Type Convert · Select Data · Filter Data