本頁面由 Cloud Translation API 翻譯而成。

TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 檢視畫面

INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 檢視畫面會顯示過去 90 天內，下列類型資料表的每日儲存空間用量總計。

標準資料表
具體化檢視表
與基本資料表有位元組差異的資料表本機副本
與基礎資料表有位元組差異的資料表快照

INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 檢視畫面會排除沒有可計費位元組的資料表。系統不會匯出下列表格類型：

外部資料表
匿名資料表
空桌
與基本資料表位元組數沒有差異的資料表本機副本
與基本資料表相比，位元組沒有差異的資料表快照

查詢 INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 檢視表時，查詢結果會針對目前專案上層資料夾 (包括子資料夾) 中的每個資料表或具體化檢視表，每天各列出一個資料列。

這份表格的資料不是即時資料。表格資料大約需要 72 小時才會顯示在這個檢視畫面中。

這個檢視畫面會傳回以 MiB 秒為單位的儲存空間用量。舉例來說，如果專案在 86,400 秒 (24 小時) 內使用 1,000,000 個實體位元組，則實體用量總計為 86,400,000,000 個位元組秒，換算為 82,397 MiB 秒，如下例所示：

86,400,000,000 / 1,024 / 1,024 = 82,397

您可以在「儲存空間用量」BILLABLE_TOTAL_PHYSICAL_USAGE欄中找到該值。詳情請參閱儲存空間定價詳細資料。

所需權限

如要查詢 INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER 檢視區塊，您需要專案父項資料夾的下列身分與存取權管理 (IAM) 權限：

bigquery.tables.get
bigquery.tables.list

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

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

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

結構定義

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

`USAGE_DATE`	`DATE`	顯示位元組的帳單日期，使用 `America/Los_Angeles` 時區
`FOLDER_NUMBERS`	`REPEATED INTEGER`	含有專案的資料夾 ID 編號，從直接含有專案的資料夾開始，接著是含有子資料夾的資料夾，依此類推。舉例來說，如果 `FOLDER_NUMBERS` 是 `[1, 2, 3]`，則資料夾 `1` 會立即包含專案，資料夾 `2` 包含 `1`，而資料夾 `3` 包含 `2`。這個欄位只會在 `TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER` 中填入資料。
`PROJECT_ID`	`STRING`	資料集所屬專案的專案 ID
`TABLE_CATALOG`	`STRING`	資料集所屬專案的專案 ID
`PROJECT_NUMBER`	`INT64`	資料集所屬專案的專案編號
`TABLE_SCHEMA`	`STRING`	包含資料表或具體化檢視區塊的資料集名稱，又稱為 `datasetId`。
`TABLE_NAME`	`STRING`	資料表或具體化檢視表的名稱，又稱為 `tableId`
`BILLABLE_TOTAL_LOGICAL_USAGE`	`INT64`	總邏輯用量，以 MiB 秒為單位。如果資料集採用實體儲存空間計費模式，則會傳回 0。
`BILLABLE_ACTIVE_LOGICAL_USAGE`	`INT64`	最近 90 天內的邏輯用量，以 MiB/秒為單位。如果資料集採用實體儲存空間計費模式，則會傳回 0。
`BILLABLE_LONG_TERM_LOGICAL_USAGE`	`INT64`	超過 90 天的邏輯用量，以 MiB/秒為單位。如果資料集採用實體儲存空間計費模式，則會傳回 0。
`BILLABLE_TOTAL_PHYSICAL_USAGE`	`INT64`	總用量，以 MiB 秒為單位。包括用於安全防護和時間旅行儲存空間的實體位元組。如果資料集採用邏輯儲存空間計費模式，則會傳回 0。
`BILLABLE_ACTIVE_PHYSICAL_USAGE`	`INT64`	90 天內的實體用量 (以 MiB 秒為單位)。這包括用於安全防護和時間旅行儲存空間的實體位元組。如果資料集採用邏輯儲存空間計費模式，則會傳回 0。
`BILLABLE_LONG_TERM_PHYSICAL_USAGE`	`INT64`	超過 90 天的實體用量，以 MiB 秒為單位。如果資料集採用邏輯儲存空間計費模式，則會傳回 0。

範圍和語法

對這個檢視表執行的查詢必須包含區域限定詞。如未指定區域限定符，系統會從所有區域擷取中繼資料。下表說明這個檢視畫面的區域範圍：

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

取代下列項目：

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

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

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

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

範例

下列查詢會顯示資料夾中所有資料表在最近日期的用量：

SELECT
  usage_date,
  project_id,
  table_schema,
  table_name,
  billable_total_logical_usage,
  billable_total_physical_usage
FROM
  (
    SELECT
      *,
      ROW_NUMBER()
        OVER (PARTITION BY project_id, table_schema, table_name ORDER BY usage_date DESC) AS rank
    FROM
      `region-REGION`.INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_FOLDER
  )
WHERE rank = 1;

結果大致如下：

+--------------+------------+--------------+------------+------------------------------+-------------------------------+
| usage_date   | project_id | table_schema | table_name | billable_total_logical_usage | billable_total_physical_usage |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_x    |     734893409201             |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_A    | table_z    |     110070445455             |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_y    |            0                 |         52500873256           |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project1   | dataset_B    | table_t    |            0                 |         32513713981           |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_m    |      8894535352              |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+
|  2023-04-03  | project2   | dataset_C    | table_n    |      4183337201              |              0                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+