카테고리:: 테이블 함수

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