DESCRIBE ICEBERG TABLE¶
Décrit soit les colonnes dans une table Apache Iceberg, soit les valeurs actuelles, ainsi que les valeurs par défaut, des propriétés d’une table Iceberg.
DESCRIBE peut être abrégé en DESC.
Notez que cette rubrique fait référence aux tables Iceberg en les appelant simplement « tables », sauf lorsque le fait de préciser tables Iceberg permet d’éviter toute confusion.
Syntaxe¶
DESC[RIBE] [ ICEBERG ] TABLE <name> [ TYPE = { COLUMNS | STAGE } ]
Paramètres¶
name
Indique l’identificateur de la table à décrire. Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.
TYPE = COLUMNS | STAGE
Indique s’il faut afficher les colonnes de la table ou les propriétés de la zone de préparation (y compris leurs valeurs actuelles et par défaut) pour la table.
Par défaut :
TYPE = COLUMNS
Exigences en matière de contrôle d’accès¶
Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :
Privilège |
Objet |
Remarques |
---|---|---|
SELECT |
Table Iceberg |
Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.
Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.
Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.
Notes sur l’utilisation¶
Cette commande n’affiche pas les paramètres d’objet d’une table. Au lieu de cela, utilisez SHOW PARAMETERS IN TABLE.
DESC ICEBERG TABLE, DESCRIBE TABLE et DESCRIBE VIEW sont interchangeables. N’importe laquelle de ces commandes récupère les détails de la table ou de la vue qui correspond aux critères de l’instruction ; cependant,
TYPE = STAGE
ne s’applique pas aux vues, car les vues n’ont pas de propriétés de zone de préparation.La sortie inclut une colonne
POLICY NAME
pour indiquer la politique de masquage définie sur la colonne.Si une politique de masquage n’est pas définie sur la colonne ou si le compte Snowflake n’est pas Enterprise Edition ou supérieur, Snowflake renvoie
NULL
.La commande renvoie la colonne
NAME_MAPPING
uniquement si vous configurez Iceberg Compatibility V2 (icebergCompatV2) pour la table Delta sur laquelle votre table Iceberg est basée.Note
Pour voir la colonne
NAME_MAPPING
, vous devez également activer le bundle de changements de comportement 2025_01 dans votre compte.Pour activer ce bundle dans votre compte, exécutez l’instruction suivante :
SELECT SYSTEM$ENABLE_BEHAVIOR_CHANGE_BUNDLE('2025_01');
Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN qui traite la sortie sous forme de table à interroger. Vous pouvez également utiliser l”opérateur de canal pour interroger la sortie de cette commande.
Exemple¶
Créer un exemple de table Iceberg :
CREATE OR REPLACE ICEBERG TABLE my_iceberg_table CATALOG='my_catalog_integration' EXTERNAL_VOLUME='my_ext_volume' METADATA_FILE_PATH='path/to/metadata/v2.metadata.json';
Décrire les colonnes de la table :
DESC ICEBERG TABLE my_iceberg_table ;