Catégories :

Fonctions de table

ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY

Renvoie des métadonnées et des informations sur l’instantané concernant l’historique d’actualisation le plus récent d’une table Apache Iceberg™ gérée en externe spécifiée.

Note

La version 9.16 de Snowflake a ajouté la prise en charge des tables basées sur Delta pour cette fonction. La fonction affiche uniquement les données d’actualisation de la table basée sur Delta à partir de la version 9.16.

Voir aussi :

Tables Apache Iceberg™, Métadonnées et conservation des tables Apache Iceberg™, ALTER ICEBERG TABLE … REFRESH

Syntaxe

ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY(
  TABLE_NAME => '<table_name>'
)

Arguments

TABLE_NAME => 'table_name'

Le nom de la table Iceberg gérée en externe pour laquelle vous souhaitez récupérer l’historique d’actualisation des instantanés.

Sortie

La fonction renvoie les colonnes suivantes :

Nom de la colonne

Type de données

Description

Note de table basée sur Delta

REFRESHED_ON

TIMESTAMP_LTZ

Horodatage de la dernière actualisation de la table.

METADATA_FILE_NAME

TEXT

Chemin complet vers le fichier de métadonnées.

Chemin complet vers le fichier de validation ou de point de contrôle.

SNAPSHOT_ID

TEXT

ID de l’instantané de la dernière actualisation.

L’ID de validation résultant de la dernière actualisation.

SEQUENCE_NUMBER

TEXT

Numéro de séquence de la dernière actualisation ; NULL pour Iceberg v1.

Non applicable pour les tables basées sur Delta ; s’affiche en tant que NULL.

ICEBERG_SCHEMA_ID

TEXT

ID de schéma de l’actualisation (à partir des métadonnées).

Non applicable pour les tables basées sur Delta ; s’affiche en tant que NULL.

QUERY_ID

TEXT

ID de la requête qui a effectué l’actualisation. Pour les tables qui utilisent une actualisation automatique, cette colonne contient une valeur sentinelle, qui indique que l’actualisation a été automatisée.

IS_CURRENT_SNAPSHOT

BOOLEAN

TRUE si la table est actualisée sur cet instantané ; sinon, FALSE.

TRUE si la table est actualisée sur cette version (validation) ; sinon, FALSE.

SNAPSHOT_SUMMARY

VARIANT

Résumé de l’instantané Iceberg du fichier metadata.json. NULL s’il n’est pas présent dans le fichier de métadonnées.

Non applicable pour les tables basées sur Delta ; s’affiche en tant que NULL.

Exemples

Récupérer les informations relatives à la version actuelle d’une table Iceberg gérée en externe et nommée my_iceberg_table :

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

Sortie :

+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+
| REFRESHED_ON                  | METADATA_FILE_NAME                                                               | SNAPSHOT_ID         | SEQUENCE_NUMBER | ICEBERG_SCHEMA_ID | QUERY_ID                             | IS_CURRENT_SNAPSHOT | SNAPSHOT_SUMMARY                |
|-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------|
| 2024-12-09 11:00:50.506 -0800 | s3://my-bucket/metadata/00000-e3bf7230-283f-4626-a770-fe97a3ca239e.metadata.json | NULL                | NULL            | 0                 | 01b8ebb4-0002-3a10-0000-012903c7e42a | False               | NULL                            |
| 2024-12-09 11:01:35.543 -0800 | s3://my-bucket/metadata/00001-bf116652-b5b0-479a-947e-6c799e4ca124.metadata.json | 6201065399847600377 | NULL            | 0                 | 01b8ebb5-0002-3a14-0000-012903c7f336 | True                | {                               |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-data-files": "4",      |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-files-size": "144896", |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-records": "150000",    |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-created": "1",     |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-kept": "0",        |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-replaced": "0",    |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-data-files": "4",      |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-files-size": "144896", |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-records": "150000"     |
|                               |                                                                                  |                     |                 |                   |                                      |                     | }                               |
+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+