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を降順で（最新のものから）行を順序付けます。

  PRIORITY ASC, UPDATED_AT DESC
  

• Limit

• この入力フィールドは、返される行の最大数を決定します。デフォルトの制限は100であり、単一のカスタムSQLを使用して行を選択するアクションに対して最大50000行まで制限されます。

• Offset

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

• 出力フィールド

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

---

出力

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

• rows

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

• rows_count

• 返された行数。