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

邏輯用量 (以 MiB 為單位)，在 90 天內。

如果資料集採用實體儲存空間計費模式，則會傳回 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`。

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

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