TABLE_STORAGE_BY_FOLDER 檢視畫面

INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER 檢視畫面會針對目前專案上層資料夾 (包括其子資料夾) 中的每個資料表或具象化檢視畫面，各包含一列資料。

這個表格不會保留即時資料，可能會延遲幾秒到幾分鐘。分區或資料表到期，或是資料集時間回溯視窗的修改，可能需要最多一天的時間，才會顯示在 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_FOLDER 檢視畫面，您必須具備專案父項資料夾的以下身分與存取權管理 (IAM) 權限：

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

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

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

如要進一步瞭解 BigQuery 權限，請參閱 BigQuery IAM 角色和權限。

結構定義

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

資料欄名稱 資料類型 值
FOLDER_NUMBERS REPEATED INTEGER 包含專案的資料夾 ID，從立即包含專案的資料夾開始，接著是包含子資料夾的資料夾，以此類推。舉例來說，如果 FOLDER_NUMBERS 是 [1, 2, 3]，則資料夾 1 會立即包含專案，資料夾 2 包含 1，而資料夾 3 則包含 2。此欄僅會在 TABLE_STORAGE_BY_FOLDER 中填入資料。
PROJECT_ID STRING 包含資料集的專案 ID。
PROJECT_NUMBER INT64 資料集所屬專案的專案編號。
TABLE_CATALOG STRING 包含資料集的專案 ID。
TABLE_SCHEMA STRING 資料表或具象化檢視表所屬資料集的名稱 (又稱為 datasetId)。
TABLE_NAME STRING 資料表或已具象化檢視表的名稱，又稱為 tableId。
CREATION_TIME TIMESTAMP 資料表的建立時間。
TOTAL_ROWS INT64 資料表或物化檢視畫面中的資料列總數。
TOTAL_PARTITIONS INT64 資料表或物化檢視畫面中的分區數。未分區的資料表會傳回 0。
TOTAL_LOGICAL_BYTES INT64 表格或具象化檢視畫面中的邏輯 (未壓縮) 位元組總數。
ACTIVE_LOGICAL_BYTES INT64 未滿 90 天的邏輯 (未經壓縮) 位元組數。
LONG_TERM_LOGICAL_BYTES INT64 超過 90 天的邏輯 (未壓縮) 位元組數。
CURRENT_PHYSICAL_BYTES INT64 在所有分區中，目前儲存資料表的實際位元組總數。
TOTAL_PHYSICAL_BYTES INT64 用於儲存空間的實體 (壓縮) 位元組總數，包括使用中、長期和時間回溯 (已刪除或變更的資料) 位元組。不會納入備用 (在時間旅行視窗後刪除或變更的資料) 位元組。
ACTIVE_PHYSICAL_BYTES INT64 90 天內的實體 (壓縮) 位元組數，包括時間旅行 (已刪除或已變更的資料) 位元組。
LONG_TERM_PHYSICAL_BYTES INT64 超過 90 天前的實體 (已壓縮) 位元組數。
TIME_TRAVEL_PHYSICAL_BYTES INT64 時間旅行儲存空間 (已刪除或變更的資料) 使用的實體 (壓縮) 位元組數。
STORAGE_LAST_MODIFIED_TIME TIMESTAMP 資料最近一次寫入資料表的時間。
DELETED BOOLEAN 指出資料表是否已刪除。
TABLE_TYPE STRING 資料表類型。例如 BASE TABLE。
FAIL_SAFE_PHYSICAL_BYTES INT64 備用儲存空間 (已刪除或變更的資料) 使用的實體 (壓縮) 位元組數。
LAST_METADATA_INDEX_REFRESH_TIME TIMESTAMP 資料表上次更新中繼資料索引的時間。

範圍和語法

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

檢視表名稱 資源範圍 區域範圍
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER 包含指定專案的資料夾 REGION
替換下列內容：
  • 選用：PROJECT_ID： Google Cloud 專案的 ID。如果未指定，系統會使用預設專案。
  • REGION：任一資料集區域名稱。例如：`region-us`。

如要擷取指定專案父資料夾中資料表的儲存空間資訊，請執行下列查詢：

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

範例

下列查詢會顯示資料夾中哪些專案使用最多儲存空間：

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

結果大致如下：

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