系統變數參考資料
BigQuery 支援下列系統變數，可用於多陳述式查詢或工作階段。您可以使用系統變數，在查詢執行期間設定或擷取資訊，類似於使用者定義的程序語言變數。
| 名稱 | 類型 | 讀取及寫入或唯讀 | 說明 |
|---|---|---|---|
@@current_job_id |
STRING |
唯讀 | 目前執行中工作的 ID。在多陳述式查詢中，這會傳回負責目前陳述式的工作，而非整個多陳述式查詢。 |
@@dataset_id |
STRING |
讀取及寫入 |
目前專案中預設資料集的 ID。如果查詢中的專案未指定資料集，系統就會使用這個 ID。您可以使用 SET 陳述式，將 @@dataset_id 指派給目前專案中的其他資料集 ID。系統變數 @@dataset_project_id 和 @@dataset_id 可以一併設定及使用。 |
@@dataset_project_id |
STRING |
讀取及寫入 |
如果查詢中使用的資料集未指定專案，系統會使用預設專案的 ID。如果未設定 @@dataset_project_id，或設為 NULL，則會使用執行查詢的專案 (@@project_id)。您可以使用 SET 陳述式，將 @@dataset_project_id 指派給其他專案 ID。系統變數 @@dataset_project_id 和 @@dataset_id 可以一併設定及使用。 |
@@last_job_id |
STRING |
唯讀 |
在目前的多重陳述式查詢中，最近執行的工作 ID (不含目前的工作)。如果多重陳述式查詢包含 CALL 陳述式，這項工作可能源自其他程序。 |
@@location |
STRING |
讀取及寫入 |
執行查詢的位置。@@location 只能設為包含有效位置的字串常值。SET @@location 陳述式必須是查詢中的第一個陳述式。如果 @@location 與查詢的其他位置資訊設定不符，就會發生錯誤。您可以使用選用的工作建立模式，改善設定 @@location 的查詢延遲時間。您可以在 SQL UDF 和資料表函式中使用 @@location 系統變數。 |
@@max_staleness_override |
INTERVAL |
讀取及寫入 |
覆寫目前多重陳述式查詢或工作階段中，所有適用實體的過時時間間隔上限。適用的實體包括在目前多重陳述式查詢或工作階段中查詢的串流資料表、變更資料擷取 (CDC) 資料表和materialized view。 根據預設，每次執行查詢時，BigQuery 都會傳回最新結果，或遵循實體設定的
|
@@project_id |
STRING |
唯讀 |
用於執行目前查詢的專案 ID。在程序中，@@project_id 是指執行多重陳述式查詢的專案，而非擁有程序的專案。 |
@@query_label |
STRING |
讀取及寫入 |
要與目前多重陳述式查詢或工作階段中的查詢工作建立關聯的查詢標籤。如果是在查詢中設定，指令碼或工作階段中所有後續的查詢工作都會有這個標籤。如未在查詢中設定，這個系統變數的值為 NULL。如需設定這個系統變數的範例，請參閱「
將工作階段中的工作與標籤建立關聯」。 |
@@reservation |
STRING |
讀取及寫入 |
可讓您指定或覆寫要用於執行下列陳述式的預留項目。
必須採用下列格式：projects/project_id/locations/location/reservations/reservation_id。設為 預留項目的位置必須與查詢執行位置相符。如果 |
@@row_count |
INT64 |
唯讀 |
如果用於多陳述式查詢，且前一個陳述式為 DML，則會指定該 DML 陳述式插入、修改或刪除的資料列數量。如果前一個陳述式是 `MERGE` 陳述式，@@row_count 代表插入、修改和刪除的資料列總數。如果不是多重陳述式查詢，這個值會是 NULL。 |
@@script.bytes_billed |
INT64 |
唯讀 |
目前執行的多重陳述式查詢工作中，目前為止計費的總位元組數。如果不在工作中，這個值為 NULL。 |
@@script.bytes_processed |
INT64 |
唯讀 |
目前執行的多重陳述式查詢工作中，至今處理的總位元組數。如果不在工作中，這個值會是 NULL。 |
@@script.creation_time |
TIMESTAMP |
唯讀 |
目前執行的多重陳述式查詢工作建立時間。如果不在工作中，這個值會是 NULL。
|
@@script.job_id |
STRING |
唯讀 |
目前執行的多重陳述式查詢工作 ID。如果不在工作中，則此值為 NULL。 |
@@script.num_child_jobs |
INT64 |
唯讀 |
目前已完成的子項工作數量。如果不在工作中，這個值會是 NULL。 |
@@script.slot_ms |
INT64 |
唯讀 |
指令碼目前使用的運算單元毫秒數。
如果不在工作中，這個值會是 NULL。
|
@@session_id |
STRING |
唯讀 |
與目前查詢相關聯的工作階段 ID。您可以在 SQL user-defined function、資料表函式和邏輯檢視表中使用 @@session_id 系統變數。materialized view 不支援使用這個系統變數。 |
@@time_zone |
STRING |
讀取及寫入 |
受時區影響的 SQL 函式中，如未指定時區做為引數，就會使用這個預設時區。您可以使用 SET 陳述式，將 @@time_zone 修改為任何有效的時區名稱。在每個指令碼的開頭，@@time_zone 會以「UTC」開始。 |
為確保回溯相容性，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';
以下範例會將工作階段中後續查詢的最大過時時間間隔覆寫為 10 分鐘：
SET @@max_staleness_override = INTERVAL 10 MINUTE;
如要強制查詢傳回最新結果，並在查詢執行時套用待處理的修改，請按照下列步驟操作：
SET @@max_staleness_override = INTERVAL 0 SECOND;
如要將過時覆寫值重設回資料表層級設定，請將 @@max_staleness_override 設為 NULL：
SET @@max_staleness_override = NULL;
下列查詢會傳回預設時區：
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;
如要進一步瞭解如何在多陳述式查詢中使用系統變數，請參閱「設定變數」。
如需在工作階段中使用系統變數的範例，請參閱「工作階段範例」。