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 视图，您需要拥有项目的父文件夹的以下 Identity and Access Management (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

总逻辑用量（以 MB 秒为单位）。

如果数据集使用物理存储结算模式，则返回 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_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                |
+--------------+------------+--------------+------------+------------------------------+-------------------------------+