JOBS_BY_ORGANIZATION 檢視畫面

INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION 檢視畫面包含與目前專案相關聯的機構中，所有已提交工作的近乎即時中繼資料。

必要角色

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

這個預先定義的角色具備 bigquery.jobs.listAll 權限，可查詢 INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION 檢視畫面。

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

只有已定義 Google Cloud機構的使用者才能使用結構定義表格。

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

結構定義

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

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

資料欄名稱	資料類型	值
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	指定建立作業的高層次原因。 可能的值包括： REQUESTED：要求建立工作。 LONG_RUNNING：查詢要求超出系統定義的逾時時間，該時間由 QueryRequest 中的 timeoutMs 欄位指定。因此，系統會將其視為長期執行的作業，並為此建立工作。 LARGE_RESULTS：查詢結果無法納入內嵌回應。 OTHER：系統判斷查詢需要以工作形式執行。
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	專案編號。
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 狀態的整個期間內，包括重試，所用的運算單元毫秒數。
total_services_sku_slot_ms	INTEGER	在外部服務上執行的工作，以及以服務 SKU 計費的工作，其總計的毫秒數。這個欄位只會填入有外部服務費用的工作，且是帳單方式為 "SERVICES_SKU" 的費用總用量。
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	這項工作以記錄為依據進行最佳化。只有 JOBS_BY_PROJECT 檢視畫面會顯示這個資料欄。
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_ORGANIZATION	包含指定專案的機構	REGION

取代下列項目：

• 選用：PROJECT_ID：您的 Google Cloud 專案 ID。如未指定，系統會使用預設專案。
• REGION：任何資料集區域名稱。 例如：`region-us`。
  注意：您必須使用區域限定詞查詢 INFORMATION_SCHEMA 檢視畫面。查詢執行位置必須與 INFORMATION_SCHEMA 檢視區塊的區域相符。

注意： 查詢 INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION 以找出查詢工作的摘要費用時，請排除 SCRIPT 陳述式類型，否則部分值可能會重複計算。SCRIPT 列包含所有子項作業的摘要值，這些作業是做為這項作業的一部分執行。

範例

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

`PROJECT_ID`.`region-REGION_NAME`.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION

請替換下列項目：

• PROJECT_ID：專案 ID
• REGION_NAME：專案的區域

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

找出今天掃描最多位元組的前五個工作

以下範例說明如何找出機構在當天掃描最多位元組的五項工作。您可以在 statement_type 中進一步篩選，查詢負載、匯出和查詢等額外資訊。

SELECT
  job_id,
  user_email,
  total_bytes_billed
FROM
  `region-REGION_NAME`.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION
WHERE
  EXTRACT(DATE FROM  creation_time) = current_date()
ORDER BY
  total_bytes_billed DESC
LIMIT 5;

注意： INFORMATION_SCHEMA 檢視表名稱會區分大小寫。

結果大致如下：

+--------------+--------------+---------------------------+
| job_id       |  user_email  |  total_bytes_billed       |
+--------------+--------------+---------------------------+
| bquxjob_1    |  [e-mail] |    999999                 |
| bquxjob_2    |  [e-mail] |    888888                 |
| bquxjob_3    |  [e-mail] |    777777                 |
+--------------+--------------+---------------------------+

在機構層級匯總使用者的連結試算表用量

以下查詢會提供貴機構過去 30 天內，主要已連結試算表使用者的摘要，並依總計帳單資料量排序。這項查詢會彙整每位使用者的查詢總數、計費位元組總數和運算單元毫秒總數。這項資訊有助於瞭解採用情況，以及找出資源用量最多的消費者。

SELECT
  user_email,
  COUNT(*) AS total_queries,
  SUM(total_bytes_billed) AS total_bytes_billed,
  SUM(total_slot_ms) AS total_slot_ms
FROM
  `region-REGION_NAME.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION`
WHERE
  -- Filter for jobs created in the last 30 days
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  -- Filter for jobs originating from Connected Sheets
  AND job_id LIKE 'sheets_dataconnector%'
  -- Filter for completed jobs
  AND state = 'DONE'
  AND (statement_type IS NULL OR statement_type <> 'SCRIPT')
GROUP BY
  1
ORDER BY
  total_bytes_billed DESC;

將 REGION_NAME 替換為專案的區域。例如：region-us。

注意： 您必須使用區域限定詞查詢 INFORMATION_SCHEMA 檢視畫面。查詢執行位置必須與INFORMATION_SCHEMA檢視區塊的區域相符。

傳回的結果看起來類似下列內容：

+---------------------+---------------+--------------------+-----------------+
| user_email          | total_queries | total_bytes_billed | total_slot_ms   |
+---------------------+---------------+--------------------+-----------------+
| [e-mail]   | 152           | 12000000000        | 3500000         |
| [e-mail]     | 45            | 8500000000         | 2100000         |
| [e-mail] | 210           | 1100000000         | 1800000         |
+---------------------+---------------+--------------------+-----------------+

在機構層級尋找連結試算表查詢作業的工作記錄

下列查詢會提供連結試算表執行的每項查詢詳細記錄。這項資訊有助於稽核及找出特定高成本查詢。

SELECT
  job_id,
  creation_time,
  user_email,
  project_id,
  total_bytes_billed,
  total_slot_ms,
  query
FROM
  `region-REGION_NAME.INFORMATION_SCHEMA.JOBS_BY_ORGANIZATION`
WHERE
  creation_time >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 30 DAY)
  AND job_id LIKE 'sheets_dataconnector%'
  AND state = 'DONE'
  AND (statement_type IS NULL OR statement_type <> 'SCRIPT')
ORDER BY
  creation_time DESC;

將 REGION_NAME 替換為專案的區域。例如：region-us。

注意： 您必須使用區域限定詞查詢 INFORMATION_SCHEMA 檢視畫面。查詢執行位置必須與INFORMATION_SCHEMA檢視區塊的區域相符。

傳回的結果看起來類似下列內容：

+---------------------------------+---------------------------------+-----------------+------------+--------------------+---------------+--------------------------------+
| job_id                          | creation_time                   | user_email      | project_id | total_bytes_billed | total_slot_ms |  query                         |
+---------------------------------+---------------------------------+-----------------+------------+--------------------+---------------+--------------------------------+
| sheets_dataconnector_bquxjob_1  | 2025-11-06 00:26:53.077000 UTC  | [e-mail] | my_project | 12000000000        | 3500000       | SELECT ... FROM dataset.table1 |
| sheets_dataconnector_bquxjob_2  | 2025-11-06 00:24:04.294000 UTC  | [e-mail] | my_project | 8500000000         | 2100000       | SELECT ... FROM dataset.table2 |
| sheets_dataconnector_bquxjob_3  | 2025-11-03 23:17:25.975000 UTC  | [e-mail] | my_project | 1100000000         | 1800000       | SELECT ... FROM dataset.table3 |
+---------------------------------+---------------------------------+-----------------+------------+--------------------+---------------+--------------------------------+