JOBS_BY_USER 檢視畫面

INFORMATION_SCHEMA.JOBS_BY_USER 檢視畫面包含目前專案中，目前使用者提交的 BigQuery 工作相關近乎即時的中繼資料。

必要角色

如要取得查詢 INFORMATION_SCHEMA.JOBS_BY_USER 檢視區塊所需的權限，請要求管理員授予您專案的 BigQuery 使用者 (roles/bigquery.user) 身分與存取權管理角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這個預先定義的角色具備 bigquery.jobs.list 權限，這是查詢 INFORMATION_SCHEMA.JOBS_BY_USER 檢視畫面時的必要權限。

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

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

結構定義

基礎資料會依 creation_time 資料欄分區，並依 project_id 和 user_email 叢集。

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

資料欄名稱 資料類型 值
bi_engine_statistics RECORD 如果專案已設定為使用 BI Engine，這個欄位會包含 BiEngineStatistics。否則為 NULL。
cache_hit BOOLEAN 這項工作的查詢結果是否來自快取。 如果您有多重查詢陳述式工作，則父項查詢的 cache_hit 為 NULL。
creation_time TIMESTAMP (分區資料欄) 這項工作的建立時間。分區依據是這個時間戳記的世界標準時間。
destination_table RECORD 結果的目標資料表 (如有)。
dml_statistics RECORD 如果工作是含有 DML 陳述式的查詢，則值為含有下列欄位的記錄：
  • inserted_row_count：插入的資料列數。
  • deleted_row_count：已刪除的資料列數。
  • updated_row_count：更新的資料列數。
如果是其他工作，值為 NULL。
這個資料欄會顯示在 INFORMATION_SCHEMA.JOBS_BY_USER 和 INFORMATION_SCHEMA.JOBS_BY_PROJECT 檢視畫面中。
end_time TIMESTAMP 這項工作的結束時間，自訓練週期後的毫秒數。這個欄位代表工作進入 DONE 狀態的時間。
error_result RECORD 以 ErrorProto 物件形式呈現的任何錯誤詳細資料。
job_creation_reason.code STRING 指定建立工作的概略原因。
可能的值包括：
job_id STRING 如果已建立工作，則為工作 ID。否則，請使用「選擇性建立工作」模式查詢的查詢 ID。例如 bquxjob_1234。
job_stages RECORD 這項工作的查詢階段。

注意：如果查詢是從設有資料列層級存取政策的資料表讀取資料，這個資料欄的值會是空白。詳情請參閱 BigQuery 資料列層級安全防護最佳做法。

job_type STRING 工作類型，可以是 QUERY、LOAD、EXTRACT、COPY 或 NULL。NULL 值表示背景工作。
labels RECORD 以鍵/值組合形式套用至工作的標籤陣列。
parent_job_id STRING 父項工作的 ID (如有)。
priority STRING 這項工作的優先順序。有效值包括 INTERACTIVE 和 BATCH。
project_id STRING (叢集資料欄) 專案的 ID。
project_number INTEGER 專案編號。
query STRING SQL 查詢文字。只有 JOBS_BY_PROJECT 檢視畫面有查詢資料欄。
referenced_tables RECORD 工作參照的資料表陣列。只有非快取命中查詢作業會有這項資料。
reservation_id STRING 指派給這項工作的主要預留項目名稱，格式為 RESERVATION_ADMIN_PROJECT:RESERVATION_LOCATION.RESERVATION_NAME。
輸出內容：
  • RESERVATION_ADMIN_PROJECT：管理預訂的 Google Cloud 專案名稱
  • RESERVATION_LOCATION：預訂地點
  • RESERVATION_NAME：預留項目名稱
edition STRING 與指派給這項工作的預留項目相關聯的版本。如要進一步瞭解版本，請參閱「BigQuery 版本簡介」。
session_info RECORD 如果有的話，這項工作執行的工作階段詳細資料。
start_time TIMESTAMP 這項工作的開始時間，自記錄週期後的毫秒數。這個欄位代表工作從 PENDING 狀態轉換為 RUNNING 或 DONE 的時間。
state STRING 此工作的執行狀態。有效狀態包括 PENDING、RUNNING 和 DONE。
statement_type STRING 查詢陳述式類型。例如 DELETE、INSERT、SCRIPT、SELECT 或 UPDATE。如需有效值清單，請參閱 QueryStatementType。
timeline RECORD 這項工作的查詢時間軸。包含查詢執行作業的快照。
total_bytes_billed INTEGER 如果專案設定為使用依用量計價，這個欄位會顯示作業的總計費位元組數。如果專案已設為使用固定費率價格，系統就不會針對位元組收費，這個欄位僅供參考。

注意：如果查詢是從設有資料列層級存取政策的資料表讀取資料，這個資料欄的值會是空白。詳情請參閱 BigQuery 資料列層級安全防護最佳做法。

total_bytes_processed INTEGER

工作處理的位元組總數。

注意：如果查詢是從設有資料列層級存取政策的資料表讀取資料，這個資料欄的值會是空白。詳情請參閱 BigQuery 資料列層級安全防護最佳做法。

total_modified_partitions INTEGER 工作修改的分區總數。這個欄位會填入 LOAD 和 QUERY 工作。
total_slot_ms INTEGER 工作在 RUNNING 狀態的整個期間內，包括重試，所用的運算單元毫秒數。
transaction_id STRING 這項工作執行的交易 ID (如有)。(預覽)
user_email STRING (叢集資料欄) 執行作業的使用者電子郵件地址或服務帳戶。
query_info.resource_warning STRING 如果查詢處理期間的資源用量超過系統內部門檻，就會顯示警告訊息。
如果查詢工作成功，resource_warning 欄位就會填入資料。使用 resource_warning 可取得額外資料點，有助於最佳化查詢，並使用 query_hashes 設定同等查詢集的成效趨勢監控。
query_info.query_hashes.normalized_literals STRING 包含查詢的雜湊。normalized_literals 是十六進位 STRING 雜湊，會忽略註解、參數值、UDF 和常值。如果基礎檢視區塊變更，或查詢隱含參照資料欄 (例如 SELECT *)，且資料表結構定義變更，雜湊值就會不同。
這個欄位會顯示成功的 GoogleSQL 查詢，但不會顯示快取命中。
query_info.performance_insights RECORD 工作的效能深入分析。
query_info.optimization_details STRUCT 這項工作的歷史記錄最佳化。
transferred_bytes INTEGER 跨雲端查詢 (例如 BigQuery Omni 跨雲端移轉工作) 的總移轉位元組數。
materialized_view_statistics RECORD 查詢作業中考量的具體化檢視表統計資料。(預覽)
metadata_cache_statistics RECORD 查詢工作所參照資料表的中繼資料欄索引使用統計資料。
search_statistics RECORD 搜尋查詢的統計資料。
query_dialect STRING 這個欄位將於 2025 年 5 月推出。 用於工作的查詢方言。有效值包括：
  • GOOGLE_SQL：這項作業要求使用 GoogleSQL。
  • LEGACY_SQL：工作要求使用舊版 SQL。
  • DEFAULT_LEGACY_SQL：工作要求中未指定查詢方言。 BigQuery 使用 LegacySQL 的預設值。
  • DEFAULT_GOOGLE_SQL：工作要求中未指定查詢方言。 BigQuery 使用 GoogleSQL 的預設值。

這個欄位只會填入查詢工作。您可以透過設定控制查詢方言的預設選取項目。
continuous BOOLEAN 工作是否為持續查詢。
continuous_query_info.output_watermark TIMESTAMP 代表持續查詢成功處理資料的點。
vector_search_statistics RECORD 向量搜尋查詢的統計資料。

資料保留

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

範圍和語法

對這個檢視表執行的查詢必須包含區域限定詞。下表說明這個檢視畫面的區域範圍：

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