Schéma :

ACCOUNT_USAGE

Vue ICEBERG_STORAGE_OPTIMIZATION_HISTORY

Utilisez cette vue d’utilisation du compte pour interroger les tâches d’optimisation du stockage Iceberg, qui inclut le compactage des données, au cours des 365 derniers jours (1 an) pour les tables Apache Iceberg™ de votre compte. Vous pouvez interroger des tâches pour les tables Iceberg suivantes :

  • Tables gérées par Snowflake

  • Tables gérées par Open Catalog

Note

  • Snowflake commence à facturer le compactage des données des fichiers de données pour les tables Iceberg gérées par Snowflake le 20 octobre 2025.

  • Pour activer ou désactiver le compactage des données sur les tables Iceberg gérées par Snowflake, voir Définition du compactage des données.

Colonnes

Nom de la colonne

Type de données

Description

START_TIME

TIMESTAMP_LTZ

Début de la plage horaire (sur la marque horaire) pendant laquelle les opérations ont été réalisées.

END_TIME

TIMESTAMP_LTZ

Fin de la plage horaire (sur la marque horaire) pendant laquelle les opérations ont été réalisées.

CREDITS_USED

NUMBER

Nombre de crédits facturés pour le compactage de données au cours de la fenêtre allant de START_TIME à END_TIME.

NUM_BYTES_SCANNED

NUMBER

Nombre d’octets scannés au cours de la fenêtre allant de START_TIME à END_TIME.

NUM_ROWS_WRITTEN

NUMBER

Nombre de lignes compactées au cours de la fenêtre allant de START_TIME à END_TIME.

TABLE_ID

NUMBER

Identificateur interne généré par le système pour la table Iceberg dans Snowflake.

TABLE_NAME

VARCHAR

Nom de la table Iceberg définie dans Snowflake.

ICEBERG_TABLE_UUID

VARCHAR

Identificateur de table Apache Iceberg™, généré par le moteur ou le catalogue Iceberg externe.

SCHEMA_ID

VARCHAR

Identificateur généré par le système pour le schéma Snowflake dans lequel se trouve la table.

SCHEMA_NAME

VARCHAR

Nom du schéma dans lequel se trouve la table.

DATABASE_ID

NUMBER

Identificateur généré par le système pour la base de données Snowflake à laquelle le schéma et la table appartiennent.

DATABASE_NAME

VARCHAR

Nom de la base de données à laquelle le schéma et la table appartiennent.

INSTANCE_ID

NUMBER

Identificateur interne généré par le système pour l’instance à laquelle l’objet appartient.

Notes sur l’utilisation

  • La latence pour la vue peut atteindre 2 heures.

  • La vue contient des données historiques d’utilisation pour les 365 derniers jours.

  • Le rôle USAGE_VIEWER se voit accorder le privilège SELECT sur cette vue. Pour plus d’informations, voir Rôles des bases de données SNOWFLAKE.

  • Cette vue n’inclut pas les informations de compactage des données pour la table Iceberg gérée en externe qui n’est pas gérée par Open Catalog.

Exemples

L’exemple suivant montre comment filtrer les tables dont le nombre de crédits facturés est supérieur à un montant spécifié :

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