ICEBERG_TABLE_FILES

ICEBERG_TABLE_FILES

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

출처: Snowflake SQL Reference - ICEBERG_TABLE_FILES

본문

구문

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

인자

필수

TABLE_NAME => 'table_name'

  • 데이터 파일 정보를 가져오려는 외부 관리 Iceberg 테이블의 이름이에요.

선택

AT => 'timestamp_ltz'

  • 파일 정보를 가져오는 데 사용할 정확한 날짜와 시간을 지정해요. 값은 TIMESTAMP_LTZ 데이터 타입으로 명시적으로 캐스팅해야 해요. 자세한 내용은 Date & time 데이터 타입을 참고하세요. 지정하지 않으면 함수는 현재 스냅샷에 대한 테이블 파일 정보를 반환해요.

출력

이 함수는 다음 열을 반환해요.

Column name Data type Description
REGISTERED_ON TIMESTAMP_LTZ Parquet 파일이 등록된 시각의 타임스탬프.
FILE_NAME TEXT 등록된 파일의 전체 경로.
FILE_SIZE NUMBER 파일의 크기(바이트).
ROW_COUNT NUMBER 파일의 행 수.
ROW_COUNT_GROUP NUMBER 파일의 행 그룹 수.
MD5 N/A 이 필드는 플레이스홀더 값을 반환하며 사용하면 안 됨. 향후 릴리스에서 폐기될 수 있음.
ETAG N/A 이 필드는 플레이스홀더 값을 반환하며 사용하면 안 됨. 향후 릴리스에서 폐기될 수 있음.
LAST_MODIFIED_ON N/A 이 필드는 플레이스홀더 값을 반환하며 사용하면 안 됨. 향후 릴리스에서 폐기될 수 있음.

참고: ETAG, MD5, LAST_MODIFIED_ON 필드는 플레이스홀더 값을 반환하며 사용하면 안 돼요. 이 필드들은 향후 릴리스에서 폐기될 수 있어요.

예시

my_iceberg_table이라는 외부 관리 Iceberg 테이블에 등록된 현재 스냅샷의 Parquet 데이터 파일 정보를 가져와요.

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

출력:

+-------------------------------------------------------+--------------------------------+------------+--------------------------------+------------+------------------+-----------------------------------+-----------------------------------+
| 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      | 1969-12-31 16:00:00.000 -0800  | 30000      | 1                | NULL                              | NULL                              |
| data/08/snow_D9zlAoeipII_AODxT1uXDxg_0_1_006.parquet  | 1969-12-31 16:00:00.000 -0800  | 45568      | 1969-12-31 16:00:00.000 -0800  | 45000      | 1                | NULL                              | NULL                              |
| data/94/snow_D9zlAoeipII_AODxT1uXDxg_0_1_008.parquet  | 1969-12-31 16:00:00.000 -0800  | 45056      | 1969-12-31 16:00:00.000 -0800  | 45000      | 1                | NULL                              | NULL                              |
| data/24/snow_D9zlAoeipII_AODxT1uXDxg_0_1_004.parquet  | 1969-12-31 16:00:00.000 -0800  | 27136      | 1969-12-31 16:00:00.000 -0800  | 30000      | 1                | NULL                              | NULL                              |
+-------------------------------------------------------+--------------------------------+------------+--------------------------------+------------+------------------+-----------------------------------+-----------------------------------+

지정한 시간과 날짜에 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)
    )
  );

출력:

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

더 알아보기