JDBC - Selectアクション

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

Select rowsアクション

このアクションでは、 WHERE条件で定義した特定の条件に基づいて行を選択できます。 選択したテーブルのうち、WHERE条件に一致する行がこのアクションの出力として返されます。

テーブル

まず、操作対象のテーブル/ビューを選択します。 これは、ピックリストからテーブルを選択するか、入力をテキストモードに切り替えて完全なテーブル名を入力することで実行できます。 テーブル名の大文字と小文字の区別は、接続先のデータベースによって異なります。

WHERE条件

次に、行をフィルタリングするためのWHERE条件を指定します。 この条件は、IDで単一のレコードをフィルタリングするだけのシンプルなものにできます。

sql
ID = 123

また、1つ以上の列の値に基づいて複数の行を選択するためにも使用できます。

sql
STATUS = 'closed' and PRIORITY = 1

サブクエリを含む複雑なWHERE条件も使用できます。 詳細については、WHERE条件ガイドを参照してください。

Order by

このアクションから返される行は、Order by入力フィールドに基づいて並べ替えることができます。 このフィールドは、JDBCデータベースから取得される行のデフォルトの順序を変更するために使用します。

並べ替えの対象にする各列について、並び順の方向も定義できます。 次のorder byステートメントは、priorityで昇順に並べ替えた後、created_dateで降順(最新が先頭)に行を並べ替えます。

sql
PRIORITY asc, CREATED_DATE desc

Limit

この入力フィールドは、返す行の最大数を決定します。 デフォルトの制限は100で、単一のSelect rowsアクションの場合、最大は50,000行です。

Offset

OFFSETの制限

JDBCのSelect rowsアクションは、すべてのデータベースでSQLのOFFSET句をサポートしているわけではありません。 Databricksなど、一部のJDBCドライバーではOFFSETが実装されていません。 このような場合、Offsetフィールドは効果がなく、アクションが失敗する可能性があります。

クエリにOFFSETが必要な場合は、JDBCのSelect rows using custom SQLアクションを使用してください。 カスタムSQLを使用する場合は、OFFSET 100のようにOFFSETを直接指定します。 :offsetとしてパラメーター化しないでください。

この入力フィールドでは、結果セット全体から結果の1ページのみを取得するオプションを指定できます。 たとえば、選択した結果セットの最初の100行をスキップするには、このフィールドに100を入力します。 デフォルトは0です。

Select rows using custom SQLアクション

このアクションでは、カスタムSQLクエリに基づいて行を選択できます。 クエリから返された行がこのアクションの出力として返されます。

50,000件のレコード制限

2026年2月8日以降、カスタムSQLを使用して行を選択アクションは、新規レシピおよび現在この制限を超えていない既存レシピについて、最大50,000件のレコードを返します。 2026年3月15日以降、この制限は、現在制限を超えている既存レシピを含め、このアクションを使用するすべてのレシピに拡張されます。

50,000件を超えるレコードを取得するように設定されたレシピでは、返される結果がこの制限まで切り詰められます。

この変更により、プラットフォームの信頼性とパフォーマンスが向上し、大規模なクエリによってデータベースコネクションに過負荷がかかったり、アップストリームシステムに影響が及んだりすることを防ぎます。

SQL

行を選択するために実行するSQLを指定します。 ここで指定したSQLは、出力データツリーの生成に使用されます。 これを行うために、SQLは指定時に1回実行されます。 ここでデータピルをマッピングして、動的に変化するSQLステートメントを実行できます。 データピルは引用符('')で囲むことを忘れないでください。

SQLでlimit句(LIMIT)を使用しないでください。 これは、クエリで返される行数の制限が、Limitで定義された値に基づくためです。 独自のlimit句を追加すると、アクションは失敗します。

Limit

この入力フィールドは、返す行の最大数を決定します。 デフォルトの制限は100で、1つのSelect rows using custom SQLアクションにつき最大50,000行までに制限されます。

このフィールドを空白のままにすると、LIMIT 100が使用されます。

Last updated: