ブロックリファレンス

BLOCKS Reference

BigQuery

クエリーの並列実行

概要

このブロックは、変数の内容によって BigQuery の複数のクエリーを並列に実行します。

「複数パラメーターを参照する変数」で指定された配列の個数分のクエリーを並列に実行します。変数展開時は、この配列内のオブジェクトで指定されたものを優先的に参照します。なければ、フロー間共通変数およびフロー内実行変数を参照します。

プロパティ

プロパティ名 説明
ブロック名

編集パネルに配置した当該ブロックの表示名が変更できます。

ブロックリストパネル中のブロック名は変更されません。

GCP サービスアカウント このブロックで使用する GCP サービスアカウントを選択します。
SQL 文法

「クエリー」プロパティで使用するクエリーの文法を以下から選択します。

クエリー

実行するクエリーを指定します。

クエリ接頭辞 （#legacySQL / #standardSQL）を指定すると、［SQL 文法］プロパティの指定に関わらず、クエリ接頭辞に指定した SQL 文法でクエリーが実行されます。

  • 変数展開の指定が可能
  • % 形式の文字列書式の指定が可能

    ［クエリー内の % 形式の文字列書式を有効にする］プロパティのチェックボックスにチェックが付いているときのみ有効です。

    %Y や %m などの % 形式の文字列書式を BigQuery にそのまま渡したい場合は、% の部分を %% としてください。例えば、%Y や %m の場合は、%%Y、%%m とします。BLOCKS により %% が % へ変換され、%Y、%m が BigQuery に渡ります。

クエリー内の % 形式の文字列書式を有効にする

クエリー内の % 形式の文字列書式を有効にするかしないかを指定します。

チェックボックスにチェックを付けると、クエリー内の % 形式の文字列書式が有効になります。チェックボックスのチェックを外すと、クエリー内の % 形式の文字列書式が無効になります。

結果格納先のデータセット

クエリー結果格納先のデータセット ID を指定します。

［変数展開の指定が可能］［% 形式の文字列書式の指定が可能］
結果格納先のテーブル

クエリー結果格納先のテーブル ID を指定します。

［変数展開の指定が可能］［% 形式の文字列書式の指定が可能］
複数パラメーターを参照する変数 配列データを受け取る変数を指定します。指定内容が文字列のときは JSON としてデコードしてから利用します。
空でないテーブルが存在したとき

出力先のテーブルが存在したときの動作を選択します。
選択できる動作は、次のいずれかです。

追加: 追加で書き込みます。
上書き: テーブルを空にしてから書き込みます。
エラー: テーブルが空でなければ失敗となります。

クエリーの優先度

クエリーの優先度を選択します。選択できる優先度は、次のいずれかです。

  • インタラクティブ（直ぐに実行、同時実行数の制限を受ける）
  • バッチ（リソースがあるときに実行、同時実行数の制限を受けない）
ブロックメモ このブロックに関するメモが記載できます。このブロックの処理に影響しません。
1000 件以上の結果を許可する 1000 件以上の結果を含むクエリーの実行を許可します。「結果格納先のデータセット」および「結果格納先のテーブル」が省略された場合は、許可できません。
フラットな結果を許可する テーブルのネストしたフィールドを展開するかどうかを指定します。展開しないとした場合は、「1000 件以上の結果を許可する」を許可にできません。
クエリーキャッシュを有効にする クエリーキャッシュを有効にするかしないかを指定します。
ユーザー定義関数 ユーザー定義関数（User Defined Function / UDF）機能を使用する場合に参照する関数定義を文字列で指定します。複数指定できます。
"gs://" で始まる文字列の場合は、URI として解釈されて、対応する GCS 上のオブジェクトから関数定義を読み込みます。
最大料金バイト数 クエリーの料金を制限します。クエリーで処理するデータ量が、ここで指定されたバイト数を超える場合は、そのクエリーは実行されません（エラーとなり料金は発生しません）。

この情報は役に立ちましたか？