TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION 檢視畫面

預先發布版

這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。 正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION 檢視畫面會提供過去 90 天內，下列類型資料表的每日儲存空間用量總計：

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

如果資料表沒有可計費的位元組，就不會納入 INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION 檢視畫面。包括下列類型的表格：

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

查詢 INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION 檢視表時，查詢結果會針對與目前專案相關聯的整個機構，為每個資料表或具體化檢視表每天列出一個資料列。

這個表格中的資料並非即時資料。表格資料約需 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 資料欄會傳回的值。

詳情請參閱儲存空間定價詳細資料。

注意： 這個檢視畫面的資料開始日期為 2023 年 10 月 1 日。您可以查詢該日期之前的檢視區塊，但傳回的資料不完整。

所需權限

如要查詢 INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION 檢視畫面，您需要貴機構的下列 Identity and Access Management (IAM) 權限：

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

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

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

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

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

結構定義

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

USAGE_DATE	DATE	顯示位元組的帳單日期，使用 America/Los_Angeles 時區
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_ORGANIZATION	包含指定專案的機構	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_ORGANIZATION;

以下範例說明如何傳回機構中資料表的專案儲存空間資訊：

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

範例

以下範例顯示機構中所有資料表在最近一次使用日期時的用量。

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