ASSIGNMENT_CHANGES 檢視畫面

INFORMATION_SCHEMA.ASSIGNMENT_CHANGES 檢視畫面會列出管理專案中所有指派項目的近乎即時變更清單。每列代表對單一指派作業的單一變更。如要進一步瞭解預留功能，請參閱「預留功能簡介」。

必要權限

如要查詢 INFORMATION_SCHEMA.ASSIGNMENT_CHANGES 檢視畫面，您必須具備專案的 bigquery.reservationAssignments.list 身分與存取權管理 (IAM) 權限。以下每個預先定義的 IAM 角色都包含必要的權限：

  • roles/bigquery.resourceAdmin
  • roles/bigquery.resourceEditor
  • roles/bigquery.resourceViewer
  • roles/bigquery.user
  • roles/bigquery.admin

如要進一步瞭解 BigQuery 權限，請參閱「使用身分與存取權管理功能控管存取權」。

結構定義

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

資料欄名稱 資料類型 值
change_timestamp TIMESTAMP 變更發生的時間。
project_id STRING 管理專案的 ID。
project_number INTEGER 管理專案的編號。
assignment_id STRING 用於唯一識別指派的 ID。
reservation_name STRING 指派項目使用的保留項目名稱。
job_type STRING 可使用保留項目的工作類型。可以是 PIPELINE 或 QUERY。
assignee_id STRING 用於明確識別指派者資源的 ID。
assignee_number INTEGER 用於唯一識別指派者資源的編號。
assignee_type STRING 指派對象資源的類型。可以是 organization、folder 或 project。
action STRING 指派作業時發生的事件類型。可以是 CREATE、UPDATE 或 DELETE。
user_email STRING 做出變更的員工身分聯盟使用者或主體的電子郵件地址。google 代表 Google 所做的變更。NULL：如果電子郵件地址不明，則傳回此值。
state STRING 指派的狀態。可以是 PENDING 或 ACTIVE。

資料保留

這個檢視畫面包含目前的作業和已刪除的作業，這些作業會保留至多 41 天，之後就會從檢視畫面中移除。

範圍和語法

對這個檢視表執行的查詢必須包含區域限定詞。如果未指定區域限定詞，系統會從所有區域擷取中繼資料。下表說明此檢視區域範圍：

檢視表名稱 資源範圍 區域範圍
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ASSIGNMENT_CHANGES[_BY_PROJECT] 專案層級 REGION
替換下列內容：
  • 選用：PROJECT_ID： Google Cloud 專案的 ID。如果未指定，系統會使用預設專案。
  • REGION：任一資料集區域名稱。例如：`region-us`。

範例

以下範例會顯示在指定日期內，針對特定作業進行最新作業更新的使用者。

SELECT
  user_email,
  change_timestamp,
  reservation_name,
  assignment_id
FROM
  `region-us`.INFORMATION_SCHEMA.ASSIGNMENT_CHANGES
WHERE
  change_timestamp BETWEEN '2021-09-30' AND '2021-10-01'
  AND assignment_id = 'assignment_01'
ORDER BY
  change_timestamp DESC
LIMIT 1;

結果大致如下：

+--------------------------------+-----------------------+--------------------+-----------------+
|           user_email           |    change_timestamp   |  reservation_name  |  assignment_id  |
+--------------------------------+-----------------------+--------------------+-----------------+
|  cloudysanfrancisco@gmail.com  |2021-09-30 09:30:00 UTC|   my_reservation   |  assignment_01  |
+--------------------------------+-----------------------+--------------------+-----------------+