카테고리:: 테이블 함수

ICEBERG_TABLE_FILES¶

지정된 시점에 외부에서 관리되는 Apache Iceberg™ 테이블에 등록된 데이터 파일에 대한 정보를 반환합니다.

참고 항목:: Apache Iceberg™ 테이블 , Apache Iceberg™ 테이블의 메타데이터 및 보존 , ALTER ICEBERG TABLE … REFRESH

구문¶

ICEBERG_TABLE_FILES(
  TABLE_NAME => '<table_name>'
  [, AT => '<timestamp_ltz>']
)

Copy

인자¶

필수 사항

TABLE_NAME => 'table_name': 데이터 파일 정보를 검색할 외부에서 관리되는 Iceberg 테이블 의 이름입니다.

선택 사항

AT => 'timestamp_ltz'

파일 정보 검색에 사용할 정확한 날짜와 시간을 지정합니다. 값은 TIMESTAMP_LTZ 데이터 타입으로 명시적으로 형 변환해야 합니다. 자세한 내용은 날짜 및 시간 데이터 타입 섹션을 참조하십시오.

지정하지 않으면 함수는 현재 스냅샷 에 대한 테이블 파일에 대한 정보를 반환합니다.

출력¶

이 함수는 다음 열을 반환합니다.

열 이름	데이터 타입	설명
REGISTERED_ON	TIMESTAMP_LTZ	Parquet 파일이 등록된 시점의 타임스탬프입니다.
FILE_NAME	TEXT	등록된 파일의 전체 경로입니다.
FILE_SIZE	NUMBER	파일의 크기(바이트 단위)입니다.
ROW_COUNT	NUMBER	파일의 행 수입니다.
ROW_COUNT_GROUP	NUMBER	파일의 행 그룹 수입니다.
MD5	HEX	파일의 MD5 체크섬입니다.
ETAG	HEX	파일의 ETag 헤더입니다.
LAST_MODIFIED_ON	TIMESTAMP_LTZ	파일이 마지막으로 업데이트된 시점의 타임스탬프입니다.

예¶

my_iceberg_table 이라는 외부 관리되는 Iceberg 테이블에 등록된 현재 스냅샷 에 대한 Parquet 데이터 파일에 대한 정보를 검색합니다.

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

Copy

출력:

+-------------------------------------------------------+--------------------------------+------------+--------------------------------+------------+------------------+-----------------------------------+-----------------------------------+
| FILE_NAME                                             | REGISTERED_ON                  | FILE_SIZE  | LAST_MODIFIED_ON               | ROW_COUNT  | ROW_GROUP_COUNT  | ETAG                              | MD5                              |
| data/87/snow_D9zlAoeipII_AODxT1uXDxg_0_1_003.parquet  | 1969-12-31 16:00:00.000 -0800  | 27136      | 2024-12-09 11:00:41.000 -0800  | 30000      | 1                | 5cae923b13581f87cf6397ec491fb5d5  | 5cae923b13581f87cf6397ec491fb5d5 |
| data/08/snow_D9zlAoeipII_AODxT1uXDxg_0_1_006.parquet  | 1969-12-31 16:00:00.000 -0800  | 45568      | 2024-12-09 11:00:41.000 -0800  | 45000      | 1                | 3659cb341fec3a57309480d2e1bb7fc3  | 3659cb341fec3a57309480d2e1bb7fc3 |
| data/94/snow_D9zlAoeipII_AODxT1uXDxg_0_1_008.parquet  | 1969-12-31 16:00:00.000 -0800  | 45056      | 2024-12-09 11:00:41.000 -0800  | 45000      | 1                | 5bee899fa8ee60fa668329acae0ed215  | 5bee899fa8ee60fa668329acae0ed215 |
| data/24/snow_D9zlAoeipII_AODxT1uXDxg_0_1_004.parquet  | 1969-12-31 16:00:00.000 -0800  | 27136      | 2024-12-09 11:00:41.000 -0800  | 30000      | 1                | 43a489e450831c717d909a5c79ab9388  | 43a489e450831c717d909a5c79ab9388 |
+-------------------------------------------------------+--------------------------------+------------+--------------------------------+------------+------------------+-----------------------------------+-----------------------------------+

지정된 시간 및 날짜에 my_iceberg_table 이라는 테이블의 Parquet 데이터 파일에 대한 정보를 검색합니다.

SELECT file_name, file_size, row_count, row_group_count, etag, md5
  FROM TABLE(
    INFORMATION_SCHEMA.ICEBERG_TABLE_FILES(
      TABLE_NAME => 'my_iceberg_table',
      AT => CAST('2024-12-09 11:02:00' AS TIMESTAMP_LTZ)
    )
  );

Copy

출력:

+------------------------------------------------------+-----------+-----------+-----------------+----------------------------------+----------------------------------+
| FILE_NAME                                            | FILE_SIZE | ROW_COUNT | ROW_GROUP_COUNT | ETAG                             | MD5                              |
|------------------------------------------------------+-----------+-----------+-----------------+----------------------------------+----------------------------------|
| data/87/snow_D9zlAoeipII_AODxT1uXDxg_0_1_003.parquet |     27136 |     30000 |               1 | 5cae923b13581f87cf6397ec491fb5d5 | 5cae923b13581f87cf6397ec491fb5d5 |
| data/08/snow_D9zlAoeipII_AODxT1uXDxg_0_1_006.parquet |     45568 |     45000 |               1 | 3659cb341fec3a57309480d2e1bb7fc3 | 3659cb341fec3a57309480d2e1bb7fc3 |
| data/94/snow_D9zlAoeipII_AODxT1uXDxg_0_1_008.parquet |     45056 |     45000 |               1 | 5bee899fa8ee60fa668329acae0ed215 | 5bee899fa8ee60fa668329acae0ed215 |
| data/24/snow_D9zlAoeipII_AODxT1uXDxg_0_1_004.parquet |     27136 |     30000 |               1 | 43a489e450831c717d909a5c79ab9388 | 43a489e450831c717d909a5c79ab9388 |
+------------------------------------------------------+-----------+-----------+-----------------+----------------------------------+----------------------------------+
4 Row(s) produced. Time Elapsed: 1.502s