システム変数のリファレンス

BigQuery は、マルチステートメント クエリまたはセッション内で次のシステム変数をサポートしています。ユーザー定義の手続き型言語変数と同様に、システム変数を使用して、クエリの実行時に情報を設定または取得できます。

下位互換性のため、OPTIONS 句または FOR SYSTEM TIME AS OF 句で使用される式はデフォルトで America/Los_Angeles タイムゾーンになり、他のすべての日時式はデフォルトで UTC タイムゾーンになります。複数ステートメント クエリで @@time_zone がすでに設定されている場合、選択されたタイムゾーンが OPTIONS 句と FOR SYSTEM TIME AS OF 句を含めてすべての日時式に適用されます。

マルチステートメント クエリの実行中は、上記のシステム変数に加えて、EXCEPTION システム変数を使用できます。EXCEPTION システム変数の詳細については、手続き型言語ステートメント BEGIN...EXCEPTION をご覧ください。

例

システム変数は作成しませんが、一部の変数は以下のようにデフォルト値をオーバーライドできます。

SET @@dataset_project_id = 'MyProject';

次のクエリは、デフォルトのタイムゾーンを返します。

SELECT @@time_zone AS default_time_zone;

+-------------------+
| default_time_zone |
+-------------------+
| UTC               |
+-------------------+

システム変数は DDL クエリと DML クエリで使用できます。 たとえば、テーブルの作成時と更新時にシステム変数 @@time_zone を使用する方法は次のとおりです。

BEGIN
  CREATE TEMP TABLE MyTempTable
  AS SELECT @@time_zone AS default_time_zone;
END;

CREATE OR REPLACE TABLE MyDataset.MyTable(default_time_zone STRING)
  OPTIONS (description = @@time_zone);

UPDATE MyDataset.MyTable
SET default_time_zone = @@time_zone
WHERE TRUE;

DDL および DML クエリでシステム変数を使用できない場合があります。たとえば、システム変数をプロジェクト名、データセット、テーブル名として使用することはできません。次のクエリで、テーブルパスに @@dataset_id システム変数を設定すると、エラーが発生します。

BEGIN
  CREATE TEMP TABLE @@dataset_id.MyTempTable (id STRING);
END;

マルチステートメント クエリでシステム変数を使用する方法の例については、変数を設定するをご覧ください。

セッションでシステム変数を使用する方法の例については、セッションの例をご覧ください。