ORGANIZATION_OPTIONS_CHANGES 檢視畫面

您可以查詢 INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 檢視表，擷取機構中 BigQuery 設定變更的即時中繼資料。這個檢視畫面會反映 2024 年 1 月 31 日後所做的機構層級和專案層級設定變更。

所需權限

如要取得查看設定變更所需的權限，請要求管理員授予您機構的 BigQuery 管理員 (roles/bigquery.admin) 身分與存取權管理角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這個預先定義的角色具備 bigquery.config.update 權限，這是取得設定變更的必要條件。

您或許還可透過自訂角色或其他預先定義的角色取得這項權限。

結構定義

查詢 INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 檢視表時，查詢結果會針對機構中的每項設定變更，各列出一個相對應的資料列。

INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 檢視表具有下列結構定義：

資料欄名稱 資料類型 值
update_time TIMESTAMP 設定變更發生的時間。
username STRING 如果是第一方使用者，則為使用者電子郵件。如果是第三方使用者，則為使用者在第三方身分識別提供者中設定的名稱。
updated_options JSON 使用者在變更中更新的設定選項 JSON 物件，內含更新欄位的新舊值。
project_id STRING 專案 ID。如果是機構層級的設定變更，這個欄位會是空白。
project_number INTEGER 專案編號。如果是機構層級的設定變更，這個欄位會是空白。

資料保留

這個檢視畫面會顯示正在執行的工作階段，以及過去 180 天內完成的工作階段記錄。

範圍和語法

對這個檢視表執行的查詢必須具有區域限定詞。

檢視表名稱 資源範圍 區域範圍
`region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES 指定機構內的設定變更。 REGION

取代下列項目：

範例

以下範例會擷取 default_query_job_timeout_ms option 選項的所有變更：

SELECT
  *
FROM
  `region-REGION`.INFORMATION_SCHEMA.ORGANIZATION_OPTIONS_CHANGES
WHERE
  updated_options.default_query_job_timeout_ms is not null;

結果會類似如下：

+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+
| project_number | project_id | update_time             | username        | updated_options                                                                                                  |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 4471534625     | myproject1 | 2023-08-22 06:57:49 UTC | user1@gmail.com | {"default_query_job_timeout_ms":{"new":0,"old":1860369},"default_time_zone":{"new":"America/New_York","old":""}} |
|----------------|------------|-------------------------|-----------------|------------------------------------------------------------------------------------------------------------------|
| 5027725474     | myproject2 | 2022-08-01 00:00:00 UTC | user2@gmail.com | {"default_query_job_timeout_ms":{"new":1860369,"old":1860008}}                                                   |
+----------------+------------+-------------------------+-----------------+------------------------------------------------------------------------------------------------------------------+