バインド操作

value()

single_quote()

single_quote() 操作は通常、クエリの "group" および "foreach generate" 行が正しい形式になるように SAQL ステップの選択バインドで使用されます。single_quote() 操作は、値の配列を取得し、二重引用符を単一引用符、角括弧を丸括弧に変換します。たとえば、"Owner-Name" は 'Owner-Name' に変換され、["Owner-Name", "Owner-Region"] は ('Owner-Name', 'Owner-Region') に変換されます。

配列値 ["Account-Name"] および ["Product"] を使用する次の静的セレクタがあるとします。

次の例は、"group by" 値と "foreach generate" 値で単一引用符を使用する必要がある SAQL クエリに配列値をバインドしています。したがって、single_quote() によって ["Account-Name"] が 'Account-Name' に変換されます。

結果のクエリは次のとおりです。

no_quote()

no_quote() 操作は通常、クエリの "order" 行が正しい形式になるように SAQL ステップの選択バインドで使用されます。no_quote() 操作は、値の配列を取得し、二重引用符と角括弧を引用符なしに変換します。たとえば、["desc"] は desc に変換されます。

["desc"] 配列値と ["asc"] 配列値が指定された次の静的ステップがあるとします。

次の例は、配列値を SAQL ステップにバインドしています。

引用符のない desc 値または asc 値が挿入されます。

field()

field() 操作は、配列内の各オブジェクトに対して項目を作成します。

次の静的ステップ (step_measure) では、"$" オプションと "#" オプションに "compact"、"alias"、および "proj" の 3 つの項目値が割り当てられています。

割り当て後、field() 操作を使用して他のステップ選択バインドで各項目値を参照できます。

たとえば、step_measure を使用する切り替えセレクタでダッシュボードユーザが [#] をクリックすると、この集計ステップ (step_top_10) の SAQL クエリは、"proj" 項目を参照して count() 関数を挿入し、"alias" 項目を参照して "count" を文字列として挿入し、"compact" 項目を参照して [["count", "*"]] を挿入します。