Commande SHOW ICEBERG TABLES : nouvelle colonne dans la sortie (en attente)¶

Attention

Ce changement de comportement est présent dans le bundle 2024_08.

Pour connaître le statut actuel du bundle, reportez-vous à Historique du bundle.

Lorsque ce bundle de changements de comportement est activé, la sortie de la commande SHOW ICEBERG TABLES comprend la nouvelle colonne suivante :

Nom de la colonne	Type de données	Description
`catalog_sync_name`	Chaîne	Indique le nom de l’intégration du catalogue pour Snowflake Open Catalog avec laquelle la table Apache Iceberg™ gérée par Snowflake est configurée pour être synchronisée. Cette configuration est spécifiée via l’un des éléments suivants : Le paramètre `CATALOG_SYNC` de la commande CREATEICEBERGTABLE (Snowflake comme catalogue Iceberg). La commande ALTER <objet> en utilisant la syntaxe ALTER `<domaine>` SET CATALOG_SYNC…, où `<domaine>` peut être soit `account`, `database`, `schema`, ou `iceberg table`. Lors de la définition de `<domaine>` sur un domaine non-table, toutes les tables sous le domaine seront propagées avec la cible CATALOG_SYNC, donc leur colonne `catalog_sync_name` de SHOW ICEBERG TABLES contiendra cette valeur qui a été définie à partir du domaine supérieur. Si le paramètre `CATALOG_SYNC` est défini à la fois sur la table et sur un domaine supérieur, le domaine le plus fin (c’est-à-dire le paramètre sur la table) sera respecté et renvoyé dans la sortie de la commande. Par exemple, si le paramètre est défini à la fois sur le schéma et sur la table, la valeur du paramètre pour la table est renvoyée dans la `catalog_sync_name column` pour SHOW ICEBERG TABLES. Si l’une des affirmations suivantes est vraie, la valeur de `catalog_sync_name` est NULL : Aucune cible de synchronisation n’est configurée pour la table Iceberg. La table Iceberg n’est pas gérée par Snowflake. La colonne `catalog_sync_name` est ajoutée en tant que troisième colonne de la sortie, immédiatement après `name_mapping`.

Nom de la colonne

Type de données

Description

catalog_sync_name

Chaîne

Indique le nom de l’intégration du catalogue pour Snowflake Open Catalog avec laquelle la table Apache Iceberg™ gérée par Snowflake est configurée pour être synchronisée.

Cette configuration est spécifiée via l’un des éléments suivants :

Le paramètre CATALOG_SYNC de la commande CREATEICEBERGTABLE (Snowflake comme catalogue Iceberg).
La commande ALTER <objet> en utilisant la syntaxe ALTER <domaine> SET CATALOG_SYNC…, où <domaine> peut être soit account, database, schema, ou iceberg table. Lors de la définition de <domaine> sur un domaine non-table, toutes les tables sous le domaine seront propagées avec la cible CATALOG_SYNC, donc leur colonne catalog_sync_name de SHOW ICEBERG TABLES contiendra cette valeur qui a été définie à partir du domaine supérieur.

Si le paramètre CATALOG_SYNC est défini à la fois sur la table et sur un domaine supérieur, le domaine le plus fin (c’est-à-dire le paramètre sur la table) sera respecté et renvoyé dans la sortie de la commande. Par exemple, si le paramètre est défini à la fois sur le schéma et sur la table, la valeur du paramètre pour la table est renvoyée dans la catalog_sync_name column pour SHOW ICEBERG TABLES.

Si l’une des affirmations suivantes est vraie, la valeur de catalog_sync_name est NULL :

Aucune cible de synchronisation n’est configurée pour la table Iceberg.
La table Iceberg n’est pas gérée par Snowflake.

La colonne catalog_sync_name est ajoutée en tant que troisième colonne de la sortie, immédiatement après name_mapping.

Réf : 1745