Catégories :

Table, vue et séquence DDL

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 :

ALTER TABLE , CREATE TABLE , SHOW TABLES

DESCRIBE VIEW

Syntaxe

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

Paramètres

nom

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.

  • Pour les comptes Enterprise Edition (ou version ultérieure), la sortie inclut une colonne POLICY NAME pour indiquer la politique de masquage Sécurité au niveau des colonnes définie sur la colonne. Si aucune politique de masquage n’est définie sur la colonne, 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));

Décrire les colonnes de la table :

DESC TABLE emp;

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

DESC TABLE emp TYPE = STAGE;

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          |
---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+
EMPLOYEE_SSN_1 | VARCHAR(32) | COLUMN | Y     | [NULL]  | N           | N          | [NULL] | [NULL]     | [NULL]  | MY_DB.MY_SCHEMA.SSN_MASK_1 |
---------------+-------------+--------+-------+---------+-------------+------------+--------+------------+---------+----------------------------+