SHOW ICEBERG TABLES¶

Listet die Iceberg-Tabellen auf, für die Sie Zugriffsrechte haben.

Mit diesem Befehl können Sie Iceberg-Tabellen der aktuellen bzw. der angegebenen Datenbank oder des angegebenen Schemas oder alle Tabellen Ihres Kontos auflisten.

Dieser Befehl gibt andere Ausgabespalten als SHOW TABLES zurück. Die Ausgabe gibt Metadaten und Eigenschaften der Iceberg-Tabellen zurück, lexikographisch geordnet nach Datenbank, Schema und Name der Iceberg-Tabelle (Beschreibungen der Ausgabespalten finden Sie unter diesem Thema unter Ausgabe). Dies muss beachtet werden, wenn Sie die Ergebnisse mit den bereitgestellten Filtern filtern möchten.

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:: CREATE ICEBERG TABLE, DROP ICEBERG TABLE, DESCRIBE ICEBERG TABLE, ALTER ICEBERG TABLE, SHOW TABLES

Syntax¶

SHOW [ TERSE ] [ ICEBERG ] TABLES [ LIKE '<pattern>' ]
                                  [ IN { ACCOUNT | DATABASE [ <db_name> ] | SCHEMA [ <schema_name> ] } ]
                                  [ STARTS WITH '<name_string>' ]
                                  [ LIMIT <rows> [ FROM '<name_string>' ] ]

Copy

Parameter¶

TERSE

Gibt optional nur eine Teilmenge der Ausgabespalten zurück:

created_on
name
kind

Der Spaltenwert kind ist immer ICEBERG TABLE.
database_name
schema_name

Standard: Kein Wert (alle Spalten sind in der Ausgabe enthalten)

ICEBERG

Gibt nur Iceberg-Tabellen zurück.

LIKE 'pattern'

Filtert optional die Befehlsausgabe nach dem Objektnamen. Der Filter verwendet einen Musterabgleich ohne Berücksichtigung der Groß-/Kleinschreibung, aber mit Unterstützung von SQL-Platzhalterzeichen (% und _).

Die folgenden Muster geben beispielsweise die gleichen Ergebnisse zurück:

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. Standard: Kein Wert (die Ausgabe wird nicht gefiltert).

IN ACCOUNT | DATABASE [ db_name ] | SCHEMA [ schema_name ]

Gibt optional den Bereich des Befehls an, der bestimmt, ob der Befehl Datensätze nur für die aktuelle/angegebene Datenbank oder das aktuelle/angegebene Schema oder für Ihr gesamtes Konto auflistet.

Wenn Sie das Schlüsselwort ACCOUNT angeben, ruft der Befehl Datensätze für alle Schemas in allen Datenbanken des aktuellen Kontos ab.

Wenn Sie das Schlüsselwort DATABASE angeben, dann gilt Folgendes:

Wenn Sie einen Wert für db_name angeben, ruft der Befehl Datensätze für alle Schemas der angegebenen Datenbank ab.
Wenn Sie keinen Wert für db_name angeben, dann gilt Folgendes:
- Wenn es eine aktuelle Datenbank gibt, ruft der Befehl Datensätze für alle Schemas in der aktuellen Datenbank ab.
- Wenn es keine aktuelle Datenbank gibt, ruft der Befehl Datensätze aller Datenbanken und Schemas im Konto ab.

Wenn Sie das Schlüsselwort SCHEMA angeben, dann gilt Folgendes:

Wenn Sie einen qualifizierten Schemanamen angeben (z. B. my_database.my_schema), ruft der Befehl Datensätze für die angegebene Datenbank und das angegebene Schema ab.
Wenn Sie einen nicht qualifizierten Wert für schema_name angeben, dann gilt Folgendes:
- Wenn es eine aktuelle Datenbank gibt, ruft der Befehl Datensätze für das angegebene Schema in der aktuellen Datenbank ab.
- Wenn keine aktuelle Datenbank vorhanden ist, zeigt der Befehl den Fehler SQL compilation error: Object does not exist, or operation cannot be performed an.
Wenn Sie keinen Wert für schema_name angeben, dann gilt Folgendes:
- Wenn es eine aktuelle Datenbank gibt, dann gilt Folgendes:
  - Wenn es ein aktuelles Schema gibt, dann ruft der Befehl Datensätze für das aktuelle Schema in der aktuellen Datenbank ab.
  - Wenn kein aktuelles Schema vorhanden ist, ruft der Befehl Datensätze für alle Schemas in der aktuellen Datenbank ab.
- Wenn es keine aktuelle Datenbank gibt, ruft der Befehl Datensätze für alle Datenbanken und alle Schemas im Konto ab.

Standard: Abhängig davon, ob für die Sitzung aktuell eine Datenbank in Verwendung ist:

Datenbank: DATABASE ist der Standardwert. Der Befehl gibt die Objekte zurück, für die Sie Berechtigungen zum Anzeigen in der aktuellen Datenbank haben.
Keine Datenbank: ACCOUNT ist der Standardwert. Der Befehl gibt die Objekte zurück, für die Sie in Ihrem Konto Berechtigungen zum Anzeigen haben.

STARTS WITH 'name_string'

Filtert die Befehlsausgabe optional anhand der Zeichen, die am Anfang des Objektnamens angezeigt werden. Die Zeichenfolge muss in einfache Anführungszeichen gesetzt werden, wobei zwischen Groß-/Kleinschreibung unterschieden wird.

Die folgenden Zeichenfolgen geben beispielsweise unterschiedliche Ergebnisse zurück:

... STARTS WITH 'B' ...

... STARTS WITH 'b' ...

. Standard: Kein Wert (die Ausgabe wird nicht gefiltert)

LIMIT rows [ FROM 'name_string' ]

Schränkt optional die maximale Anzahl der zurückgegebenen Zeilen ein und ermöglicht gleichzeitig die „Paginierung“ der Ergebnisse. Die tatsächliche Anzahl der zurückgegebenen Zeilen kann geringer sein als das angegebene Limit. Beispielsweise ist die Anzahl der vorhandenen Objekte geringer als das angegebene Limit.

Die optionale Unterklausel FROM 'name_string' dient als „Cursor“ für die Ergebnisse. Dies ermöglicht das Abrufen der angegebenen Anzahl von Zeilen nach der ersten Zeile, deren Objektname mit der angegebenen Zeichenfolge übereinstimmt:

Die Zeichenfolge muss in einfache Anführungszeichen gesetzt werden, wobei zwischen Groß-/Kleinschreibung unterschieden wird.
Die Zeichenfolge muss nicht den vollständigen Datenbanknamen enthalten. Partielle Namen werden unterstützt.

Standard: Kein Wert (die Ausgabe wird nicht begrenzt)

Bemerkung

Bei SHOW-Befehlen, die sowohl die FROM 'name_string'- als auch die STARTS WITH 'name_string'-Klausel unterstützen, können Sie diese beiden Klauseln in derselben Anweisung kombinieren. Beide Bedingungen müssen jedoch erfüllt sein, da sie sich sonst gegenseitig aufheben und keine Ergebnisse zurückgegeben werden.

Außerdem werden Objekte in lexikographischer Reihenfolge nach Namen zurückgegeben. Daher gibt FROM 'name_string' nur Zeilen mit einem höheren lexikografischen Wert zurück als die von STARTS WITH 'name_string' zurückgegebenen Zeilen.

Beispiel:

... STARTS WITH 'A' LIMIT ... FROM 'B' würde keine Ergebnisse zurückgeben.
... STARTS WITH 'B' LIMIT ... FROM 'A' würde keine Ergebnisse zurückgeben.
... STARTS WITH 'A' LIMIT ... FROM 'AB' würde Ergebnisse zurückgeben (wenn Zeilen mit den Eingabezeichenfolgen übereinstimmen).

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	Um eine bestimmte Iceberg-Tabelle in der Ausgabe für SHOW ICEBERG TABLES zu sehen, muss eine Rolle die Berechtigung SELECT für diese Tabelle haben.

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¶

Wenn ein Konto (oder eine Datenbank oder ein Schema) eine große Anzahl von Iceberg-Tabellen hat, kann das Durchsuchen des gesamten Kontos (oder der Datenbank oder des Schemas) eine erhebliche Menge an Computeressourcen verbrauchen.

Für die Ausführung des Befehls ist kein aktives Warehouse erforderlich.
Der Wert für LIMIT rows kann 10000 nicht überschreiten. Wenn LIMIT rows nicht angegeben wird und das Resultset mehr als 10.000 Zeilen hat, führt der Befehl zu einem Fehler.

Um Ergebnisse anzuzeigen, für die mehr als 10.000 Datensätze vorhanden sind, fügen Sie entweder LIMIT rows (Zeilen) ein, oder fragen Sie die entsprechende Ansicht im Snowflake Information Schema ab.

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

Ausgabe¶

Bemerkung

Das folgende Ausgabeschema gilt für den Befehl SHOW ICEBERG TABLES. Weitere Informationen zur Ausgabe von SHOW TABLES finden Sie unter Identifizieren von Iceberg-Tabellen mit SHOW TABLES (unter diesem Thema).

Die Befehlsausgabe enthält Tabelleneigenschaften und Metadaten in den folgenden Spalten:

Spalte	Beschreibung
`created_on`	Datum und Uhrzeit der Erstellung der Tabelle.
`name`	Name der Tabelle.
`database_name`	Datenbank, in der die Tabelle gespeichert ist.
`schema_name`	Schema, in dem die Tabelle gespeichert ist.
`owner`	Rolle, der die Tabelle gehört.
`external_volume_name`	Name des externen Volumes, auf dem die Daten und Metadaten der Iceberg-Tabelle gespeichert sind.
`catalog_name`	Name des mit der Iceberg-Tabelle verbundenen Katalogintegrationsobjekts, wenn die Tabelle nicht von Snowflake verwaltet wird. `SNOWFLAKE`, wenn die Tabelle von Snowflake verwaltet wird.
`iceberg_table_type`	Typ der Iceberg-Tabelle. `UNMANAGED`, wenn die Tabelle nicht von Snowflake verwaltet wird, andernfalls `NOT ICEBERG`.
`catalog_table_name`	Name der Tabelle, wie sie vom Katalog erkannt wird.
`catalog_namespace`	Katalog-Namespace für die Tabelle. Der bei der Erstellung der Tabelle definierte Namespace. Andernfalls der Standard-Namespace, der mit der von der Tabelle verwendeten Katalogintegration verbunden ist.
`file_path`	Relativer Pfad vom Speicherort `EXTERNAL_VOLUME` zu den Metadaten und Datendateien der Tabelle. Wird als `BASE_LOCATION` definiert, wenn Sie bestimmte Typen von Iceberg-Tabellen erstellen.
`can_write_metadata`	Gibt an, ob Snowflake Metadaten an den durch `file_path` angegebenen Speicherort schreiben kann.
`comment`	Kommentar zur Tabelle.
`name_mapping`	Liste von Objekten mit Informationen zu den Tabellenspalten, die die Spaltenprojektion verwenden. Weitere Informationen dazu finden Sie unter name_mapping.
`owner_role_type`	Der Typ der Rolle, die Eigentümer des Objekts ist, entweder `ROLE` oder `DATABASE_ROLE`. . Wenn eine Snowflake Native App Eigentümer des Objekts ist, ist der Wert `APPLICATION`. . Wenn Sie das Objekt löschen, gibt Snowflake NULL zurück, da ein gelöschtes Objekt keine Eigentümerrolle hat.

name_mapping¶

Die Ausgabespalte name_mapping liefert Informationen zu den Tabellenspalten, die die Spaltenprojektion verwenden.

Wenn eine Tabelle keine Spalten mit einer zugehörigen Namenszuordnung enthält, hat die Ausgabespalte den Wert [NULL]. Andernfalls ist der Wert eine Liste von Objekten, wobei jedes Objekt einer Spalte entspricht, die eine zugehörige Namenszuordnung hat (manchmal auch als zugeordnetes Feld bezeichnet). Jedes Objekt kann die folgenden drei Eigenschaften enthalten:

field-id: Die Iceberg-Feld-ID.
names: Eine Liste von Namenzeichenfolgen für das Feld.
fields: Eine Liste von Feldzuordnungen für die untergeordneten Felder von „struct“-, „map“- oder „list“-Spalten.

Beispiel:

[
  {
    "field-id": 1,
    "names": [
      "id",
      "record_id"
    ]
  },
  {
    "field-id": 2,
    "names": [
      "data"
    ]
  },
  {
    "field-id": 3,
    "names": [
      "location"
    ],
    "fields": [
      {
        "field-id": 4,
        "names": [
          "latitude",
          "lat"
        ]
      },
      {
        "field-id": 5,
        "names": [
          "longitude",
          "long"
        ]
      }
    ]
  }
]

Copy

Bemerkung

Feld-IDs müssen nicht aufeinanderfolgend sein, wenn eine Spalte (oder ein Feld in einer Spalte mit einem strukturierten Typ) keine entsprechende Namenszuordnung hat.

Beispiele¶

Zeigen Sie alle Iceberg-Tabellen an, deren Name mit glue beginnt und für die Sie über Berechtigungen zum Anzeigen im Schema tpch.public verfügen:

SHOW ICEBERG TABLES LIKE 'glue%' IN tpch.public;

Copy

Identifizieren von Iceberg-Tabellen mit SHOW TABLES¶

Die Ausgabe des SHOW TABLES-Befehls enthält eine Spalte, die anzeigt, ob eine Tabelle eine Iceberg-Tabelle ist. Diese Spalte wird zusätzlich zu den regulären SHOW TABLES-Ausgabespalten angezeigt.

Die Spalte hat den folgenden Namen und mögliche Werte:

Spaltenname	Werte
is_iceberg	`Y`, wenn die Tabelle eine Iceberg-Tabelle ist, andernfalls `N`.