Databricks - カスタムSQLによる行の選択アクション ​

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

カスタムSQLによる行の選択アクション

入力 ​

このアクションを使用するには、次の入力フィールドを設定します。

• SQL

• 行の選択に使用する予定のSQLクエリを指定します。クエリは出力データツリーの生成に使用されます。このため、指定した時点でSQLが実行されます。バインド変数を使用します。たとえば、入力をパラメーター化するには、ID = :idとパラメーターフィールドを使用します。バインド変数を使用する場合は、スキーマを手動で定義する必要があります。

  避けるべき句

  SQLでLIMITやTOP(N)のような制限句を使用しないでください。これは、クエリで返される行数の制限がLimit入力フィールドで定義された値に基づくためです。独自の制限句を追加すると、アクションが失敗します。また、クエリからORDER BY句を削除し、Order by入力フィールドに配置します。

• パラメーター

• このフィールドはWHERE条件と組み合わせて使用します。まず、WHERE入力で名前付きバインド変数を宣言します。次に、この入力フィールドを使用して、これらの変数に値を割り当てます。
  パラメーター値には静的値またはデータピルを使用できます。バインド変数に対してデータベースが期待するものに最も近い対応データ型を選択します。

• Order By

• このアクションから返される行は、Order by入力フィールドに基づいて並べ替えることができます。このフィールドは、Databricksデータベースからの行のデフォルトの並び順を変更するために使用します。
  並べ替えの基準にする予定の各列について、並べ替え方向を定義することもできます。次のOrder byステートメントは、priorityの昇順、続いてupdated_atの降順（最新が先）で行を並べ替えます。

  sql

  PRIORITY ASC, UPDATED_AT DESC

• クォータ

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

• オフセット

• この入力フィールドでは、クエリ式から行を返す前に行をスキップするオプションを指定できます。たとえば、選択した結果セットの最初の100行をスキップするには、このフィールドに100を入力します。デフォルトは0です。

• 出力フィールド

• このフィールドを使用して、クエリで返される列を定義します。 Workatoはこれを動的に行いますが、エラーが発生した場合はこのフィールドを使用して任意の列を上書きできます。ここで定義するフィールド名は、クエリ内の列名と完全に一致している必要があります。

出力 ​

このアクションは次の出力を作成します。

• rows

• オブジェクトのJSON配列。各オブジェクトは、選択されたデータの1行を表します。

• rows_count

• 返された行数。