スキーマ：: ACCOUNT_USAGE

ICEBERG_STORAGE_OPTIMIZATION_HISTORY ビュー¶

このアカウント使用状況ビューを使用すると、アカウント内の Apache Iceberg™ テーブルについて、過去365日（1年間）内に実行された、*データ圧縮*を含むIcebergストレージ最適化ジョブをクエリできます。以下のIcebergテーブルのジョブをクエリできます。

Snowflake管理テーブル
Open Catalog管理テーブル

注釈

Snowflakeは、2025年10月20日から、Snowflake管理Icebergテーブルのデータファイルのデータ圧縮の課金を開始します。
Snowflake管理Icebergテーブルのデータ圧縮を有効または無効にするには、データ圧縮の設定を参照してください。

列¶


列名	データ型	説明
START_TIME	TIMESTAMP_LTZ	操作が実行された時間範囲（時マーク）の開始時刻。
END_TIME	TIMESTAMP_LTZ	操作が実行された時間範囲（時マーク）の終了時刻。
CREDITS_USED	NUMBER	START_TIME と END_TIME の間のデータ圧縮に対して課金されるクレジット数。
NUM_BYTES_SCANNED	NUMBER	START_TIME と END_TIME の間にスキャンされたバイト数。
NUM_ROWS_WRITTEN	NUMBER	START_TIME と END_TIME の間に圧縮された行数。
TABLE_ID	NUMBER	SnowflakeのIcebergテーブルの内部システム生成識別子。
TABLE_NAME	VARCHAR	Snowflakeで定義されたIcebergテーブルの名前。
ICEBERG_TABLE_UUID	VARCHAR	外部Icebergエンジンまたはカタログによって生成されるApache Iceberg™テーブル識別子。
SCHEMA_ID	VARCHAR	テーブルが属するSnowflakeスキーマのシステム生成識別子。
SCHEMA_NAME	VARCHAR	テーブルのスキーマ名。
DATABASE_ID	NUMBER	スキーマとテーブルが属するSnowflakeデータベースのシステム生成識別子。
DATABASE_NAME	VARCHAR	スキーマとテーブルが属するデータベース名。
INSTANCE_ID	NUMBER	オブジェクトが属するインスタンスの内部システム生成識別子。

使用上の注意¶

ビューの待機時間は最大2時間です。
このビューには、過去365日間の使用履歴データが含まれています。
このビューでは、 USAGE_VIEWER ロールに SELECT 権限が付与されます。詳細については、 SNOWFLAKE データベースロールをご参照ください。
このビューには、Open Catalogで管理されていない、外部で管理されているIcebergテーブルのデータ圧縮情報は含まれていません。

例¶

次の例は、請求されるクレジット数が指定金額以上のテーブルをフィルタリングする方法を示しています。

  SELECT
      table_name,
      start_time,
      credits_used
    FROM SNOWFLAKE.ACCOUNT_USAGE.ICEBERG_STORAGE_OPTIMIZATION_HISTORY
    WHERE credits_used > 0.0005
    ORDER BY
      credits_used DESC;

The query returns the following results:

+------------------+-------------------------------+--------------+
| TABLE_NAME       | START_TIME                    | CREDITS_USED |
+------------------+-------------------------------+--------------+
| my_iceberg_table | 2025-09-15 09:00:00.000 -0700 | 0.000529445  |
| my_iceberg_table | 2025-09-15 08:00:00.000 -0700 | 0.000516791  |
+------------------+-------------------------------+--------------+