「依資料夾分類的工作」檢視畫面

INFORMATION_SCHEMA.JOBS_BY_FOLDER 檢視畫面包含目前專案上層資料夾中所有已提交工作的近乎即時中繼資料，包括子資料夾中的工作。

必要角色

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

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

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

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

結構定義

基礎資料會依 creation_time 資料欄分區，並依 project_id 和 user_email 叢集。「query_info」欄包含查詢工作的其他資訊。

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

資料欄名稱 資料類型 值
bi_engine_statistics RECORD 如果專案已設定為使用 BI Engine，這個欄位會包含 BiEngineStatistics。否則為 NULL。
cache_hit BOOLEAN 這項工作的查詢結果是否來自快取。 如果您有多重查詢陳述式工作，則父項查詢的 cache_hit 為 NULL。
creation_time TIMESTAMP (分區資料欄) 這項工作的建立時間。分區依據是這個時間戳記的世界標準時間。
destination_table RECORD 結果的目標資料表 (如有)。
end_time TIMESTAMP 這項工作的結束時間，自訓練週期後的毫秒數。這個欄位代表工作進入 DONE 狀態的時間。
error_result RECORD 以 ErrorProto 物件形式呈現的任何錯誤詳細資料。
folder_numbers REPEATED INTEGER 含有專案的資料夾 ID 號碼，從直接含有專案的資料夾開始，接著是含有子資料夾的資料夾，依此類推。舉例來說，如果 folder_numbers 是 [1, 2, 3]，則資料夾 1 會立即包含專案，資料夾 2 包含 1，而資料夾 3 包含 2。這個欄位只會在 JOBS_BY_FOLDER 中填入資料。
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_FOLDER 包含指定專案的資料夾 REGION
取代下列項目：
  • 選用：PROJECT_ID：您的 Google Cloud 專案 ID。如未指定，系統會使用預設專案。
  • REGION：任何資料集區域名稱。 例如：`region-us`。