「指派項目」檢視畫面

INFORMATION_SCHEMA.ASSIGNMENTS 檢視畫面會列出管理專案中所有目前的指派項目，且清單近乎即時更新。每一列代表一項目前指派的作業。目前指派的項目處於待處理或有效狀態，且尚未刪除。如要進一步瞭解預留項目，請參閱「預留項目簡介」。

必要權限

如要查詢 INFORMATION_SCHEMA.ASSIGNMENTS 檢視畫面，您需要專案的 bigquery.reservationAssignments.list Identity and Access Management (IAM) 權限。下列預先定義的 IAM 角色都包含必要權限：

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

如要進一步瞭解 BigQuery 權限，請參閱「使用 IAM 控管存取權」。

結構定義

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

資料欄名稱 資料類型 值
ddl STRING 用來建立這項指派作業的 DDL 陳述式。
project_id STRING 管理專案的 ID。
project_number INTEGER 管理專案的編號。
assignment_id STRING 可明確識別作業的 ID。
reservation_name STRING 指派項目使用的預留項目名稱。
job_type STRING 可使用保留項目的工作類型。可能的值為 PIPELINE、QUERY、CONTINUOUS、ML_EXTERNAL 或 BACKGROUND。
assignee_id STRING 唯一識別指派對象資源的 ID。
assignee_number INTEGER 可明確識別指派對象資源的號碼。
assignee_type STRING 指派對象資源的類型。可以是 organization、folder 或 project。

為確保穩定性，建議您在資訊結構定義查詢中明確列出資料欄，而非使用萬用字元 (SELECT *)。明確列出資料欄可避免基礎結構定義變更時，查詢中斷。

範圍和語法

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

檢視表名稱 資源範圍 區域範圍
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.ASSIGNMENTS[_BY_PROJECT]
 專案層級 REGION
取代下列項目：
  • 選用：PROJECT_ID：您的 Google Cloud 專案 ID。如未指定，系統會使用預設專案。
  • REGION：任何資料集區域名稱。 例如：`region-us`。

範例

如要對預設專案以外的專案執行查詢，請使用以下格式新增專案 ID：

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.ASSIGNMENTS
。

更改下列內容：

  • PROJECT_ID：您已指派預留事項的專案 ID。
  • REGION_NAME：區域名稱。

例如 `myproject`.`region-us`.INFORMATION_SCHEMA.ASSIGNMENTS。

以下範例會取得專案目前指派的預留項目及其運算單元容量。比較專案的運算單元用量與指派給該專案的預留項目運算單元容量，有助於偵錯工作效能。

SELECT
  reservation.reservation_name,
  reservation.slot_capacity
FROM
  `RESERVATION_ADMIN_PROJECT.region-REGION_NAME`.
  INFORMATION_SCHEMA.ASSIGNMENTS_BY_PROJECT assignment
INNER JOIN
  `RESERVATION_ADMIN_PROJECT.region-REGION_NAME`.
  INFORMATION_SCHEMA.RESERVATIONS_BY_PROJECT AS reservation
ON
  (assignment.reservation_name = reservation.reservation_name)
WHERE
   assignment.assignee_id = "PROJECT_ID"
  AND job_type = "QUERY";