SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG¶

Syntax¶

SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG( '<catalog_integration_name>'
  [ , '<parent_namespace>', <levels> ] )

Argumente¶

Benötigt:

catalog_integration_name

Bezeichner für die Katalogintegration für Iceberg REST oder Snowflake Open Catalog.

Optional:

parent_namespace

Der Bezeichner des Namespace, von dem aus die Auflistung der Tabellen beginnen soll. Um Ergebnisse für die 0. Namespace-Ebene im Katalog abzurufen, geben Sie eine leere Zeichenfolge an ('').

Standard: Der Standard-Namespace für die Katalogintegration (CATALOG_NAMESPACE).

levels

Gibt die Anzahl der Ebenen an, die in der Namespace-Hierarchie für die Auflistung von Tabellen durchlaufen werden.

Beispiel:

• Bei einer Einstellung von 0 gibt die Funktion alle Tabellen rekursiv zurück, relativ zum parent_namespace.

• Bei einer Einstellung von 1 gibt die Funktion alle Tabellen innerhalb des parent_namespace zurück.

• Bei Einstellung n gibt die Funktion Tabellen bis zu n Ebenen tief zurück, relativ zum parent_namespace.

Standardeinstellung: 1

Rückgabewerte¶

Gibt eine JSON-formatierte Zeichenfolge zurück, die Tabellen im Iceberg REST-Katalog für den angegebenen Namespace und die Anzahl der Ebenen auflistet.

Die JSON-formatierte Zeichenfolge hat die folgende Struktur:

[
  {
    "namespace": "<namespace_identifier>",
    "name": "<table_name>"
  },
  {
    "namespace": "<namespace_identifier>",
    "name": "<table_name_n>"
  },
]

Anforderungen an die Zugriffssteuerung¶

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

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.

Beispiele¶

Auflistung nur der Tabellen im Standard-Katalog-Namespace:

SELECT SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG('myCatalogIntegration');

Auflistung jeder Tabelle im Katalog:

SELECT SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG('myCatalogIntegration', '', 0);

Auflistung aller Tabellen rekursiv unter dem db1-Namespace:

SELECT SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG('myCatalogIntegration', 'db1', 0);

Auflistung aller Tabellen drei Ebenen unter dem db1-Namespace:

SELECT SYSTEM$LIST_ICEBERG_TABLES_FROM_CATALOG('myCatalogIntegration', 'db1', 3);