JOBS_TIMELINE_BY_ORGANIZATION 檢視畫面

INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION 檢視畫面會顯示與目前專案相關聯的機構中，所有已提交工作的近乎即時 BigQuery 中繼資料 (以時間切片為單位)。這個檢視畫面會顯示目前執行中和已完成的工作。

所需權限

如要查詢 INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION 檢視畫面，您需要具備機構的 bigquery.jobs.listAll Identity and Access Management (IAM) 權限。下列預先定義的 IAM 角色都包含必要權限：

  • 機構層級的 BigQuery 資源管理員
  • 機構擁有者
  • 機構管理員

只有已定義Google Cloud 機構的使用者，才能存取 JOBS_BY_ORGANIZATION 結構定義表。

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

結構定義

查詢 INFORMATION_SCHEMA.JOBS_TIMELINE_BY_* 檢視表時，查詢結果會針對每項 BigQuery 工作執行期間的每秒，各列出一個相對應的資料列。每個週期都從整秒間隔開始，且持續時間正好為一秒。

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

資料欄名稱 資料類型 值
period_start TIMESTAMP 這個期間的開始時間。
period_slot_ms INTEGER 這段期間消耗的運算單元時間 (毫秒)。
project_id STRING (叢集資料欄) 專案 ID。
project_number INTEGER 專案編號。
folder_numbers REPEATED INTEGER 包含專案的資料夾 ID 號碼，從直接包含專案的資料夾開始，接著是包含子資料夾的資料夾，依此類推。舉例來說，如果 `folder_numbers` 是 `[1, 2, 3]`，則資料夾 `1` 會立即包含專案，資料夾 `2` 包含 `1`，資料夾 `3` 包含 `2`。
user_email STRING (叢集資料欄) 執行工作的使用者電子郵件地址或服務帳戶。
job_id STRING 工作 ID。例如 bquxjob_1234。
job_type STRING 工作類型。可以是 QUERY、LOAD、EXTRACT、COPY 或 null。工作類型 null 表示內部工作，例如指令碼工作陳述式評估或具體化檢視畫面重新整理。
statement_type STRING 查詢陳述式類型 (如有效)。例如 SELECT、INSERT、UPDATE 或 DELETE。
priority STRING 這項工作的優先順序。有效值包括 INTERACTIVE 和 BATCH。
parent_job_id STRING 父項工作的 ID (如有)。
job_creation_time TIMESTAMP (分區資料欄) 這項工作的建立時間。分區依據是這個時間戳記的世界標準時間。
job_start_time TIMESTAMP 這項工作的開始時間。
job_end_time TIMESTAMP 這項工作的結束時間。
state STRING 這段期間結束時，工作的執行狀態。有效狀態包括 PENDING、RUNNING 和 DONE。
reservation_id STRING 如果適用，這個期間結束時指派給這項工作的主要預留項目名稱。
edition STRING 與指派給這項工作的預留項目相關聯的版本。如要進一步瞭解版本，請參閱「BigQuery 版本簡介」。
total_bytes_billed INTEGER 如果專案設定為使用依用量計價，這個欄位會顯示作業的總計費位元組數。如果專案設定為使用固定費率定價，系統就不會針對位元組收費。這個欄位無法設定。
total_bytes_processed INTEGER 工作處理的位元組總數。
error_result RECORD 錯誤詳細資料 (如有)，以 ErrorProto. 形式呈現
cache_hit BOOLEAN 這項工作的查詢結果是否來自快取。
period_shuffle_ram_usage_ratio FLOAT 所選時間範圍內的重組用量比率。
period_estimated_runnable_units INTEGER 這段期間可立即排定的工作單元。如果預訂中的其他查詢不需要額外運算單元，這些作業單元的額外運算單元就能加快查詢速度。

資料保留

這個檢視畫面會顯示目前執行的工作，以及過去 180 天的工作記錄。

範圍和語法

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

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

範例

範例：查看每秒的運算單元總用量

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

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION
。 例如：`myproject`.`region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION。

以下範例顯示指派給 YOUR_RESERVATION_ID 的專案中，所有工作每秒的時段用量：

SELECT
  s.start_time AS period_start,
  SUM(jobs.period_slot_ms) / 1000 AS period_slot_seconds,
  ANY_VALUE(s.slots_assigned) AS estimated_slots_assigned,
  ANY_VALUE(s.slots_max_assigned) AS estimated_slots_max_assigned
FROM `region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION jobs
JOIN `region-us`.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE res
    ON jobs.reservation_id = res.reservation_id
 JOIN res.per_second_details s
    ON jobs.period_start = s.start_time
WHERE
  jobs.job_creation_time
    BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
        AND CURRENT_TIMESTAMP()
  AND res.period_start
    BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
        AND CURRENT_TIMESTAMP()
  AND res.reservation_id = 'YOUR_RESERVATION_ID'
  AND (jobs.statement_type != "SCRIPT" OR jobs.statement_type IS NULL)  -- Avoid duplicate byte counting in parent and children jobs.
GROUP BY
  period_start
ORDER BY
  period_start DESC;

結果會類似如下：

+-----------------------+---------------------+--------------------------+------------------------------+
|     period_start      | period_slot_seconds | estimated_slots_assigned | estimated_slots_max_assigned |
+-----------------------+---------------------+--------------------------+------------------------------+
|2021-06-08 21:33:59 UTC|       100.000       |         100              |           100                |
|2021-06-08 21:33:58 UTC|        96.753       |         100              |           100                |
|2021-06-08 21:33:57 UTC|        41.668       |         100              |           100                |
+-----------------------+---------------------+--------------------------+------------------------------+

範例：各預留項目的運算單元用量

以下範例顯示過去 1 天內每個預訂項目每秒的運算單元用量：

SELECT
  s.start_time AS period_start,
  res.reservation_id,
  SUM(jobs.period_slot_ms) / 1000 AS period_slot_seconds,
  ANY_VALUE(res.slots_assigned) AS estimated_slots_assigned,
  ANY_VALUE(res.slots_max_assigned) AS estimated_slots_max_assigned,
FROM `region-us`.INFORMATION_SCHEMA.JOBS_TIMELINE_BY_ORGANIZATION jobs
JOIN `region-us`.INFORMATION_SCHEMA.RESERVATIONS_TIMELINE res
  ON jobs.reservation_id = res.reservation_id
JOIN res.per_second_details s
  ON jobs.period_start = s.start_time
WHERE
  jobs.job_creation_time
      BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
          AND CURRENT_TIMESTAMP()
  AND res.period_start
      BETWEEN TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 1 DAY)
          AND CURRENT_TIMESTAMP()
  AND (jobs.statement_type != "SCRIPT" OR jobs.statement_type IS NULL)  -- Avoid duplicate byte counting in parent and children jobs.
GROUP BY
  period_start,
  reservation_id
ORDER BY
  period_start DESC,
  reservation_id;

結果會類似如下：

+-----------------------+----------------+---------------------+--------------------------+------------------------------+
|     period_start      | reservation_id | period_slot_seconds | estimated_slots_assigned | estimated_slots_max_assigned |
+-----------------------+----------------+---------------------+--------------------------+------------------------------+
|2021-06-08 21:33:59 UTC|     prod01     |       100.000       |             100          |              100             |
|2021-06-08 21:33:58 UTC|     prod02     |       177.201       |             200          |              500             |
|2021-06-08 21:32:57 UTC|     prod01     |        96.753       |             100          |              100             |
|2021-06-08 21:32:56 UTC|     prod02     |       182.329       |             200          |              500             |
+-----------------------+----------------+---------------------+--------------------------+------------------------------+