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 值反映該資料表目前使用的有效位元組，以及該資料表用於時間旅行的位元組。

如要查看資料表本身的有效位元組，請從 ACTIVE_PHYSICAL_BYTES 值減去 TIME_TRAVEL_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`	資料表的上次中繼資料索引重新整理時間。
`TABLE_DELETION_REASON`	`STRING`	如果 `DELETED` 欄位為 true，則為資料表刪除原因。可能的值如下：資料表在設定的到期時間後遭到刪除`TABLE_EXPIRATION:` 使用者已刪除資料集`DATASET_DELETION:` 使用者已刪除 `USER_DELETED:` 個表格
`TABLE_DELETION_TIME`	`TIMESTAMP`	資料表的刪除時間。

範圍和語法

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

檢視表名稱	資源範圍	區域範圍
[`PROJECT_ID`.]`region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_BY_FOLDER	包含指定專案的資料夾	`REGION`

取代下列項目：

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

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

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

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 |
+---------------------+---------------------+