TABLE_STORAGE_BY_ORGANIZATION 檢視表

INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION 檢視畫面會為與目前專案相關聯的整個組織，針對每個資料表或物化檢視表包含一列。

這個表格中的資料並非即時更新，可能會延遲幾秒到幾分鐘。儲存空間變更可能需要最多一天的時間，才能反映在 INFORMATION_SCHEMA.TABLE_STORAGE 檢視畫面中，這取決於變更的時間點是否為分割區或資料表到期，或是變更的時間點是否為資料集時間回溯期。如果資料集刪除作業中包含超過 1,000 個資料表，則在刪除資料集的時間回溯視窗過後，這個檢視畫面才會反映變更。

表格儲存空間檢視畫面可讓您輕鬆觀察目前的儲存空間用量，並提供詳細資訊，說明儲存空間是否使用邏輯未壓縮位元組、實體壓縮位元組或時間旅行位元組。這項資訊可協助您處理各種工作，例如規劃未來的成長策略，以及瞭解資料表的更新模式。

*_BYTES 欄中的資料

表格儲存空間檢視畫面中的 *_BYTES 欄會提供儲存空間位元組用量資訊。這項資訊是根據物化檢視畫面和下列表格類型的儲存空間用量而定：

• 透過「建立及使用資料表」一文所述的任何方法建立的永久資料表。
• 在工作階段中建立的臨時資料表。這些資料表會放入資料集，並產生名稱，例如「_c018003e063d09570001ef33ae401fad6ab92a6a」。
• 在多個陳述式查詢中建立的臨時資料表 (稱為「指令碼」)。這些資料表會放入資料集，並產生名稱，例如「_script72280c173c88442c3a7200183a50eeeaa4073719」。

查詢結果快取中儲存的資料不會向您收費，因此不會包含在 *_BYTES 欄值中。

複本和快照會將 *_BYTES 資料欄值視為完整的資料表，而非顯示基礎資料表所使用的儲存空間差異，因此會高估儲存空間。您的帳單會正確計算儲存空間用量中的差異。如要進一步瞭解由複本和快照儲存及計費的差異位元組，請參閱 TABLE_STORAGE_USAGE_TIMELINE 檢視畫面。

儲存空間預測帳單

如要預測資料集的每月儲存空間計費，您可以根據資料集使用的資料集儲存空間計費模式，使用這個檢視畫面中的 logical 或 physical *_BYTES 欄。請注意，這只是粗略的預測結果，實際的帳單金額會根據 BigQuery 儲存空間帳單基礎架構的用量計算，並顯示在 Cloud Billing 中。

如果資料集使用邏輯帳單模式，您可以按照下列方式預測每月儲存空間費用：

((ACTIVE_LOGICAL_BYTES 值 / POW(1024, 3)) * 使用中的邏輯位元組價格) + ((LONG_TERM_LOGICAL_BYTES 值 / POW(1024, 3)) * 長期邏輯位元組價格)

資料表的 ACTIVE_LOGICAL_BYTES 值會反映該資料表目前使用的有效位元組。

針對採用實體計費模式的資料集，您可以按照下列方式預測儲存空間費用：

((ACTIVE_PHYSICAL_BYTES + FAIL_SAFE_PHYSICAL_BYTES 值 / POW(1024, 3)) * 實體位元組的活動計價) + ((LONG_TERM_PHYSICAL_BYTES 值 / POW(1024, 3)) * 長期實體位元組的計價)

資料表的 ACTIVE_PHYSICAL_BYTES 值會反映該資料表目前使用的有效位元組，以及該資料表用於時間旅行的位元組。

如要單獨查看表格的有效位元組，請將 TIME_TRAVEL_PHYSICAL_BYTES 值減去 ACTIVE_PHYSICAL_BYTES 值。

詳情請參閱「儲存空間定價」。

所需權限

如要查詢 INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION 檢視畫面，您必須具備下列身分與存取權管理 (IAM) 權限：

• bigquery.tables.get
• bigquery.tables.list

以下每個預先定義的 IAM 角色都包含上述權限：

• roles/bigquery.admin
• roles/bigquery.dataViewer
• roles/bigquery.dataEditor
• roles/bigquery.metadataViewer

只有已定義 Google Cloud機構的使用者，才能使用這個結構定義檢視畫面。

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

結構定義

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

範圍和語法

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

• 選用：PROJECT_ID： Google Cloud 專案的 ID。如果未指定，系統會使用預設專案。
• REGION：任一資料集區域名稱。例如：`region-us`。

以下範例說明如何針對組織中指定專案中的資料表，傳回儲存空間資訊：

SELECT * FROM `myProject`.`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION;

以下範例說明如何針對組織中的資料表，依專案傳回儲存空間資訊：

SELECT * FROM `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION;

範例

以下範例說明機構中哪些專案目前使用最多儲存空間。

SELECT
  project_id,
  SUM(total_logical_bytes) AS total_logical_bytes
FROM
  `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_ORGANIZATION
GROUP BY
  project_id
ORDER BY
  total_logical_bytes DESC;

結果大致如下：

+---------------------+---------------------+
|     project_id      | total_logical_bytes |
+---------------------+---------------------+
| projecta            |     971329178274633 |
+---------------------+---------------------+
| projectb            |     834638211024843 |
+---------------------+---------------------+
| projectc            |     562910385625126 |
+---------------------+---------------------+