DESCRIBE TABLE

Beschreibt entweder die Spalten einer Tabelle oder die aktuellen Werte sowie die Standardwerte für die Stagingbereichseigenschaften einer Tabelle.

DESCRIBE kann mit DESC abgekürzt werden.

Siehe auch:

DROP TABLE, ALTER TABLE, CREATE TABLE, SHOW TABLES

DESCRIBE VIEW

Syntax

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

Parameter

name

Gibt den Bezeichner für die zu beschreibende Tabelle an. Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.

TYPE = COLUMNS | STAGE

Gibt an, ob die Spalten für die Tabelle oder die Stagingbereichseigenschaften (einschließlich ihrer aktuellen Werte und Standardwerte) für die Tabelle angezeigt werden sollen.

Standard: TYPE = COLUMNS

Nutzungshinweise

  • Dieser Befehl zeigt die Objektparameter für eine Tabelle nicht an. Verwenden Sie stattdessen SHOW PARAMETERS IN TABLE ….

  • DESC TABLE und DESCRIBE VIEW sind austauschbar. Alle Befehle rufen die Details für die Tabelle oder Ansicht ab, die den Kriterien in der Anweisung entsprechen. TYPE = STAGE gilt jedoch nicht für Ansichten, da Ansichten keine Stagingbereichseigenschaften haben.

  • Wenn die Tabellenschemaentwicklung für die Tabelle aktiviert ist, enthält die Ausgabe eine Spalte SchemaEvolutionRecord. Diese Spalte wurde mit dem Bundle 2023_08 (Allgemein verfügbar) eingeführt. Weitere Informationen dazu finden Sie unter Tabellenschemaentwicklung.

  • Die Ausgabe enthält eine Spalte POLICY NAME, in der die auf der Spalte festgelegte Maskierungsrichtlinie angegeben ist.

    Wenn für die Spalte keine Maskierungsrichtlinie festgelegt ist oder wenn es sich bei dem Snowflake-Konto nicht um ein Enterprise Edition-Konto oder höher handelt, gibt Snowflake NULL zurück.

  • Zur Weiterverarbeitung der Ausgabe dieses Befehls können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

Beispiele

Erstellen Sie eine Beispieltabelle:

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

Beschreiben Sie die Spalten in der Tabelle:

DESC TABLE emp;
Copy

Beschreiben Sie die Stagingbereichseigenschaften der Tabelle:

DESC TABLE emp TYPE = STAGE;
Copy

Ermitteln Sie die für die Tabellenspalten festgelegten Maskierungsrichtlinien:

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