DESCRIBE ICEBERG TABLE¶

Décrit soit les colonnes dans une table 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.

Voir aussi :: ALTER ICEBERG TABLE, DROP ICEBERG TABLE, CREATE ICEBERG TABLE, SHOW ICEBERG TABLES

Syntaxe¶

DESC[RIBE] [ ICEBERG ] TABLE <name> [ TYPE =  { COLUMNS | STAGE } ]

Copy

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 commande SQL doit avoir les privilèges suivants définis au minimum ainsi :

Privilège	Objet	Remarques
SELECT	Table Iceberg
USAGE	Volume externe
USAGE	Intégration (catalogue)	Nécessaire si la table Iceberg utilise une intégration de catalogue.

Notez que l’exploitation d’un objet dans un schéma requiert également le privilège USAGE sur la base de données et le schéma parents.

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.

Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogée.

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';

Copy

Décrire les colonnes de la table :

DESC ICEBERG TABLE my_iceberg_table ;

Copy