类别：: 表函数

ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY¶

返回关于指定的外部管理的 Apache Iceberg™ 表最近刷新历史记录的元数据和快照信息

备注

Snowflake 版本 9.16 增加了针对此函数的基于 Delta 的表支持。从版本 9.16 及更高版本开始，此函数仅显示基于 Delta 的表刷新数据。

另请参阅：: Apache Iceberg™ 表、Apache Iceberg™ 表的元数据与保留、ALTER ICEBERG TABLE ... REFRESH

语法¶

ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY(
  TABLE_NAME => '<table_name>'
)

实参¶

TABLE_NAME => 'table_name': 要检索其快照刷新历史记录的外部管理 Iceberg 表的名称。

输出¶

该函数返回以下列：


列名称	数据类型	描述	基于 Delta 的表说明
REFRESHED_ON	TIMESTAMP_LTZ	表上次刷新的时间戳。
METADATA_FILE_NAME	TEXT	元数据文件的完整路径。	提交或检查点文件的完整路径。
SNAPSHOT_ID	TEXT	上次刷新的快照 ID。	上次刷新产生的提交 ID。
SEQUENCE_NUMBER	TEXT	上次刷新的序列号；Iceberg v1 为 NULL。	不适用于基于 Delta 的表；显示为 NULL。
ICEBERG_SCHEMA_ID	TEXT	刷新的架构 ID（来自元数据）。	不适用于基于 Delta 的表；显示为 NULL。
QUERY_ID	TEXT	执行刷新的查询的 ID。对于使用自动刷新的表，此列包含一个哨兵值，表示已自动刷新。
IS_CURRENT_SNAPSHOT	BOOLEAN	如果基于该快照刷新了表，则为 TRUE，否则为 FALSE。	如果表在此版本（提交）中已刷新，则为 TRUE，否则为 FALSE。
SNAPSHOT_SUMMARY	VARIANT	`metadata.json` 文件中的 Iceberg 快照摘要。如果元数据文件中不存在，则为 NULL。	不适用于基于 Delta 的表；显示为 NULL。

示例¶

检索名为 my_iceberg_table 的外部管理 Iceberg 表的当前版本信息：

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY(
    TABLE_NAME => 'my_iceberg_table'
  ));

输出：

+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+
| REFRESHED_ON                  | METADATA_FILE_NAME                                                               | SNAPSHOT_ID         | SEQUENCE_NUMBER | ICEBERG_SCHEMA_ID | QUERY_ID                             | IS_CURRENT_SNAPSHOT | SNAPSHOT_SUMMARY                |
|-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------|
| 2024-12-09 11:00:50.506 -0800 | s3://my-bucket/metadata/00000-e3bf7230-283f-4626-a770-fe97a3ca239e.metadata.json | NULL                | NULL            | 0                 | 01b8ebb4-0002-3a10-0000-012903c7e42a | False               | NULL                            |
| 2024-12-09 11:01:35.543 -0800 | s3://my-bucket/metadata/00001-bf116652-b5b0-479a-947e-6c799e4ca124.metadata.json | 6201065399847600377 | NULL            | 0                 | 01b8ebb5-0002-3a14-0000-012903c7f336 | True                | {                               |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-data-files": "4",      |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-files-size": "144896", |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-records": "150000",    |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-created": "1",     |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-kept": "0",        |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-replaced": "0",    |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-data-files": "4",      |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-files-size": "144896", |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-records": "150000"     |
|                               |                                                                                  |                     |                 |                   |                                      |                     | }                               |
+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+