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 資料欄會傳回的值。

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

所需權限

如要查詢 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

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

如要進一步瞭解 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：您的 Trusted 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                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+