ブロックリファレンス

Block Reference

BigQuery

クエリーの実行

BigQuery のクエリーを実行するブロックです。

プロパティ名 説明
ブロック名 ブロックの名前を指定します。ブロックに表示されます。
GCPサービスアカウント

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

SQL 文法

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

クエリー

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

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

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

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

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

「結果格納先のデータセット」、「結果格納先のテーブル」および「結果を格納する変数名」を省略すると、クエリー結果は変数 _(アンダースコアー)に出力されます。

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

結果格納先のテーブル

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

「結果格納先のデータセット」、「結果格納先のテーブル」および「結果を格納する変数名」を省略すると、クエリー結果は変数 _(アンダースコアー)に出力されます。

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

空でないテーブルが存在したとき

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

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

ブロックメモ ブロックに対するコメントを指定します。
結果を格納する変数名

クエリー結果を格納する変数名を指定します。クエリ結果の格納上限は、1000 件です。

「結果格納先のデータセット」、「結果格納先のテーブル」および「結果を格納する変数名」を省略すると、クエリー結果は変数 _(アンダースコアー)に出力されます。

エラー時の繰り返し回数 BigQuery のエラーやタイムアウト時の繰り返し回数を指定します。
最小タイムアウト時間 BigQuery からの応答を待つ時間(タイムアウト)を秒単位で指定します。繰り返し回数ごとに2倍に増えます。繰り返し回数ごとに増える時間の最大値は、「最大タイムアウト時間」プロパティで指定します。
最大タイムアウト時間 「最小タイムアウト時間」から繰り返し回数ごとに増やすタイムアウトの最大時間を秒単位指定します。
1000件以上の結果を許可する 1000 件以上の結果を含むクエリの実行を許可します。「結果格納先のデータセット」および「結果格納先のテーブル」が省略された場合は、許可できません。
フラットな結果を許可する テーブルのネストしたフィールドを展開するかどうかを指定します。展開しないとした場合は、「1000件以上の結果を許可する」を許可にできません。
クエリーの優先度

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

  • インタラクティブ (直ぐに実行、同時実行数の制限を受ける)
  • バッチ(リソースがあるときに実行、同時実行数の制限を受けない)
クエリーキャッシュを有効にする クエリーキャッシュを有効にするかしないかを指定します。
ユーザー定義関数

ユーザ定義関数(User Defined Function / UDF)機能を使用する場合に参照する関数定義を文字列で指定します。複数指定できます。

"gs://" で始まる文字列の場合は、URI として解釈されて、対応する GCS 上のオブジェクトから関数定義を読み込みます。

SQL 文法が Legacy SQL のときのみ有効です。

最大料金階層

High-Compute クエリー の実行を制限します。最大料金階層を超える料金階層 のクエリーは実行できません(エラーとなり料金は発生しません)。

参照: 基本操作ガイド > ヒント > BigQuery の料金階層と High-Compute クエリー

最大料金バイト数 クエリーの料金を制限します。クエリーで処理するデータ量が、ここで指定されたバイト数を超える場合は、そのクエリーは実行されません(エラーとなり料金は発生しません)。
実行に必要なテーブル クエリー実行前に、存在確認をするテーブルを指定します。「プロジェクトID:データセットID.テーブルID」のような文字列か、「{“dataset”: “データセットID”, “table”: “テーブルID”}」のようなオブジェクトが指定できます。複数指定する場合は、配列で指定できます。
チェック回数 「実行に必要なテーブル」で指定されたテーブルが存在するかをチェックする最大の回数を指定します。
チェック間隔 「実行に必要なテーブル」で指定されたテーブルが存在するかをチェックする間隔を秒単位で指定します。