DESCRIBE TABLE

Décrit soit les colonnes d’une table, soit les valeurs actuelles, ainsi que les valeurs par défaut des propriétés de zone de préparation d’une table.

DESCRIBE peut être abrégé en DESC.

Voir aussi :

DROP TABLE , ALTER TABLE , CREATE TABLE , SHOW TABLES

DESCRIBE VIEW

Syntaxe

DESC[RIBE] 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

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 TABLE et DESCRIBE VIEW sont interchangeables. Les deux commandes récupèrent 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 ces dernières n’ont pas de propriétés de zone de préparation.

  • Si l’évolution du schéma de la table est activée pour la table, la sortie contiendra une colonne SchemaEvolutionRecord. Cette colonne a été introduite avec le Bundle 2023_08 (activé de manière générale). Pour plus d’informations, voir Évolution du schéma de table.

  • 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.

Exemples

Créer un exemple de table :

CREATE TABLE emp (id NUMBER NOT NULL PRIMARY KEY, fname VARCHAR(50), lname VARCHAR(50), location VARCHAR(100));
Copy

Décrire les colonnes de la table :

DESC TABLE emp;
Copy

Décrire les propriétés de la zone de préparation pour la table :

DESC TABLE emp TYPE = STAGE;
Copy

Déterminer les politiques de masquage définies sur les colonnes de la table :

DESC TABLE ssn_record;

---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+------------------+
      name     |    type     |  kind  | null? | default | primary key | unique key | check  | expression | comment |       policy name          |  privacy domain  |
---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+------------------+
EMPLOYEE_SSN_1 | VARCHAR(32) | COLUMN | Y     | [NULL]  | N           | N          | [NULL] | [NULL]     | [NULL]  | MY_DB.MY_SCHEMA.SSN_MASK_1 |     [NULL]       |
---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+------------------+
Copy