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 小时才能反映在此视图中。

存储用量以 MB 秒为单位返回。例如，如果项目在 86,400 秒（24 小时）使用 1,000,000 个物理字节，则物理总用量为 86,400,000,000 字节秒，转换为 82,397 MB 秒，如以下示例所示：

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

此架构视图仅可供已定义 Google Cloud 组织的用户使用。

如需详细了解 BigQuery 权限，请参阅使用 IAM 进行访问权限控制。

架构

INFORMATION_SCHEMA.TABLE_STORAGE_USAGE_TIMELINE_BY_ORGANIZATION 视图具有如下架构：

`USAGE_DATE`	`DATE`	所显示字节的结算日
`PROJECT_ID`	`STRING`	该数据集所属项目的项目 ID
`TABLE_CATALOG`	`STRING`	该数据集所属项目的项目 ID
`PROJECT_NUMBER`	`INT64`	该数据集所属项目的项目编号
`TABLE_SCHEMA`	`STRING`	包含表或物化视图的数据集的名称，也称为 `datasetId`
`TABLE_NAME`	`STRING`	表或物化视图的名称，也称为 `tableId`
`BILLABLE_TOTAL_LOGICAL_USAGE`	`INT64`	总逻辑用量（以 MB 秒为单位）。如果数据集使用物理存储结算模式，则返回 0。
`BILLABLE_ACTIVE_LOGICAL_USAGE`	`INT64`	存在时间少于 90 天的逻辑用量（以 MB 秒为单位）。如果数据集使用物理存储结算模式，则返回 0。
`BILLABLE_LONG_TERM_LOGICAL_USAGE`	`INT64`	存在时间超过 90 天的逻辑用量（以 MB 秒为单位）。如果数据集使用物理存储结算模式，则返回 0。
`BILLABLE_TOTAL_PHYSICAL_USAGE`	`INT64`	总用量（以 MB 秒为单位）。这包括用于故障安全和时间旅行存储的物理字节数。如果数据集使用逻辑存储结算模式，则返回 0。
`BILLABLE_ACTIVE_PHYSICAL_USAGE`	`INT64`	存在时间少于 90 天的物理用量（以 MB 秒为单位）。这包括用于故障安全和时间旅行存储的物理字节数。如果数据集使用逻辑存储结算模式，则返回 0。
`BILLABLE_LONG_TERM_PHYSICAL_USAGE`	`INT64`	存在时间超过 90 天的物理用量（以 MB 秒为单位）。如果数据集使用逻辑存储结算模式，则返回 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                   |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+