スキーマ：

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:
Copy
+------------------+-------------------------------+--------------+
| 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  |
+------------------+-------------------------------+--------------+
言語: 日本語