DESCRIBE ICEBERG TABLE

Beschreibt entweder die Spalten einer Iceberg-Tabelle oder die aktuellen Werte sowie die Standardwerte für die Eigenschaften einer Iceberg-Tabelle.

DESCRIBE kann mit DESC abgekürzt werden.

Beachten Sie, dass unter diesem Thema Iceberg-Tabellen einfach als „Tabellen“ bezeichnet werden, es sei denn, die Angabe von Iceberg-Tabellen vermeidet Verwechslungen.

Siehe auch:

ALTER ICEBERG TABLE, DROP ICEBERG TABLE, CREATE ICEBERG TABLE, SHOW ICEBERG TABLES

Syntax

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

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung

Objekt

Anmerkungen

SELECT

Iceberg-Tabelle

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise

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

  • DESC ICEBERG TABLE, DESCRIBE TABLE und DESCRIBE VIEW sind austauschbar. Jeder dieser Befehle ruft 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.

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

  • Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

Beispiel

Erstellen eines Iceberg-Beispieltabelle:

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

Beschreiben Sie die Spalten in der Tabelle:

DESC ICEBERG TABLE my_iceberg_table ;
Copy