架构：

ACCOUNT_USAGE

ICEBERG_STORAGE_OPTIMIZATION_HISTORY 视图

使用此 Account Usage 视图查询账户中的 Apache Iceberg™ 表在过去 365 天（1 年）内的 Iceberg 存储优化作业，包括 数据压缩。您可以查询以下 Iceberg 表的作业

  • Snowflake 管理的表

  • 打开目录管理的表

备注

  • Snowflake 于 2025 年 10 月 20 日开始对 Snowflake 管理的 Iceberg 表的数据文件计算数据压缩费用。

  • 要在 Snowflake 管理的 Iceberg 表上启用或禁用数据压缩，请参阅 Set data compaction。

列

列名称

数据类型

描述

START_TIME

TIMESTAMP_LTZ

执行操作的时间范围（以小时为单位）的开始时间。

END_TIME

TIMESTAMP_LTZ

执行操作的时间范围（以小时为单位）的结束时间。

CREDITS_USED

NUMBER

在 START_TIME 和 END_TIME 时段内计算的数据压缩 credit 数量。

NUM_BYTES_SCANNED

NUMBER

在 START_TIME 和 END_TIME 时段内扫描的字节数。

NUM_ROWS_WRITTEN

NUMBER

在 START_TIME 和 END_TIME 时段内压缩的行数。

TABLE_ID

NUMBER

系统为 Snowflake 中的 Iceberg 表生成的内部标识符。

TABLE_NAME

VARCHAR

在 Snowflake 中定义的 Iceberg 表的名称。

ICEBERG_TABLE_UUID

VARCHAR

Apache Iceberg™ 表标识符，由外部 Iceberg 引擎或目录生成。

SCHEMA_ID

VARCHAR

系统为表所在的 Snowflake 架构生成的标识符。

SCHEMA_NAME

VARCHAR

表所在架构的名称。

DATABASE_ID

NUMBER

系统为架构和表所属的 Snowflake 数据库生成的标识符。

DATABASE_NAME

VARCHAR

架构和表所属数据库的名称。

INSTANCE_ID

NUMBER

系统为对象所属实例的生成的内部标识符。

使用说明

  • 视图的延迟时间长达 2 小时。

  • 该视图包含过去 365 天的历史使用数据。

  • USAGE_VIEWER 角色被授予此视图的 SELECT 权限。有关更多信息，请参阅 SNOWFLAKE 数据库角色。

  • 此视图不包括非由 Open Catalog 管理的外部管理的 Iceberg 表的数据压缩信息。

示例

以下示例显示如何筛选计费的 credit 数量超过指定金额的表：

  SELECT
      table_name,
      start_time,
      credits_used
    FROM SNOWFLAKE.ACCOUNT_USAGE.ICEBERG_STORAGE_OPTIMIZATION_HISTORY
    WHERE credits_used > 0.0005
    ORDER BY
      credits_used DESC;

The query returns the following results:
Copy
+------------------+-------------------------------+--------------+
| TABLE_NAME       | START_TIME                    | CREDITS_USED |
+------------------+-------------------------------+--------------+
| my_iceberg_table | 2025-09-15 09:00:00.000 -0700 | 0.000529445  |
| my_iceberg_table | 2025-09-15 08:00:00.000 -0700 | 0.000516791  |
+------------------+-------------------------------+--------------+
语言: 中文