SQL Server - Selectアクション ​

Select rows ​

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

行の選択アクション

テーブル/ビュー ​

まず、操作対象のテーブル/ビューを選択します。 これは、ピックリストからテーブルまたはビューを選択するか、入力をテキストモードに切り替えてテーブル/ビューの完全な名前を入力することで実行できます。

WHERE条件 ​

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

ID = 123

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

status = 'closed' AND priority = 1

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

パラメーター ​

SQLインジェクションを防ぐために、WHERE条件と組み合わせて使用します。 WHERE入力で名前付きバインド変数を宣言した後、この入力フィールドを使用してこれらの変数に値を割り当てます。 詳細はこちら

Order by ​

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

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

priority asc, created_date desc

Limit ​

この入力フィールドは、返す行の最大数を決定します。 デフォルトの制限は100で、単一のSelect rowsアクションの場合、最大は50,000行です。 1,000行を超える行を選択してレコードを操作する必要がある場合は、バッチで実行できます。 詳細については、ユースケースの例を参照してください。

Offset ​

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

Select rows using custom SQL ​

このアクションでは、カスタムSQLクエリに基づいて行を選択できます。 クエリから返された行がこのアクションの出力として返されます。 カスタムSQLアクションを使用する際のベストプラクティスを確認してください

サポートされているバージョン ​

このアクションはSQL Server 2012以降でのみサポートされています。 SQL Server 2012以降でのみ使用可能なデフォルトのストアドプロシージャsp_describe_first_result_setを使用します。

カスタムSQLを使用した行の選択アクション

SQL ​

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

SQLでTOPのような制限句を使用しないでください。 これは、クエリで返される行数の制限が、Limit入力フィールドで定義された値に基づくためです。 独自のlimit句を追加すると、アクションは失敗します。

Limit ​

この入力フィールドは、返す行の最大数を決定します。 1つのカスタムSQLを使用した行の選択アクションのデフォルトの制限は100で、最大制限は50,000です。

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