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

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

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

架构

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`。

    • 以下示例演示了如何返回组织内指定项目中的表的存储信息：

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