カテゴリ：: テーブル関数

ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY¶

指定した外部管理テーブル Apache Iceberg™ の最新のリフレッシュ履歴に関するメタデータおよびスナップショット情報を返します。

注釈

Snowflakeバージョン9.16に、この関数のデルタベースのテーブルサポートが追加されました。この関数は、バージョン9.16以降のデルタベースのテーブル更新データのみを表示します。

こちらもご参照ください。: Apache Iceberg™ テーブル、 Apache Iceberg™ テーブルのメタデータと保持、 ALTER ICEBERG TABLE ... REFRESH

構文¶

ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY(
  TABLE_NAME => '<table_name>'
)

引数¶

TABLE_NAME => 'table_name': スナップショットのリフレッシュ履歴を取得するための外部管理Icebergテーブルの名前。

出力¶

この関数は、次の列を返します。


列名	データ型	説明	デルタベースのテーブルノート
REFRESHED_ON	TIMESTAMP_LTZ	テーブルが最後にリフレッシュされた時のタイムスタンプ。
METADATA_FILE_NAME	TEXT	メタデータファイルのフルパス。	コミットまたはチェックポイントファイルへのフルパス。
SNAPSHOT_ID	TEXT	最終リフレッシュ時のスナップショット ID。	最終リフレッシュの結果のコミット ID。
SEQUENCE_NUMBER	TEXT	最終リフレッシュ時のシーケンス番号。Iceberg v1の場合は NULL。	デルタベースのテーブルには適用されません。NULL として表示されます。
ICEBERG_SCHEMA_ID	TEXT	リフレッシュのスキーマ ID （メタデータから）。	デルタベースのテーブルには適用されません。NULL として表示されます。
QUERY_ID	TEXT	リフレッシュを実行したクエリの ID。自動リフレッシュを使用するテーブルの場合、この列には、リフレッシュが自動化されたことを示すセンチネル値が含まれます。
IS_CURRENT_SNAPSHOT	BOOLEAN	このスナップショットでテーブルがリフレッシュされた場合は TRUE。それ以外の場合は FALSE。	テーブルがこのバージョンでリフレッシュ（コミット）された場合は TRUE 、それ以外の場合は FALSE。
SNAPSHOT_SUMMARY	VARIANT	`metadata.json` ファイルからのIcebergスナップショットの概要。メタデータファイルに存在しない場合は NULL。	デルタベースのテーブルには適用されません。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"     |
|                               |                                                                                  |                     |                 |                   |                                      |                     | }                               |
+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+