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

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	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' ) ); 

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 | 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) ) ); 

Copy

出力:

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