SYSTEM$LIST_NAMESPACES_FROM_CATALOG¶

Syntax¶

SYSTEM$LIST_NAMESPACES_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, ab dem die Auflistung der Namespaces 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 der untergeordneten Namespaces durchlaufen werden sollen.

Beispiel:

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

• Bei Einstellung 1 gibt die Funktion alle Namespaces zurück, die eine Ebene unter parent_namespace liegen.

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

Standardeinstellung: 1

Rückgabewerte¶

Gibt eine JSON-formatierte Zeichenfolge zurück, die Auflistungen von Namespaces im Iceberg-REST-Katalog für das angegebene übergeordnete Objekt und die Anzahl der Ebenen enthält.

Die JSON-formatierte Zeichenfolge hat die folgende Struktur:

[
  "<namespace_identifier>",
  "<namespace_identifier_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 Namespaces auf, die direkt unter dem Standard-Namespace der Katalogintegration liegen:

SELECT SYSTEM$LIST_NAMESPACES_FROM_CATALOG('my_catalog_integration');

Auflistung aller Namespaces rekursiv im Katalog:

SELECT SYSTEM$LIST_NAMESPACES_FROM_CATALOG('my_catalog_integration', '', 0);

Auflistung nur der Namespaces, die eine Ebene unter (direkt unter) dem „db1“-Namespace liegen:

SELECT SYSTEM$LIST_NAMESPACES_FROM_CATALOG('my_catalog_integration', 'db1');

Auflistung der Namespaces drei Ebenen unter dem „db1“-Namespace:

SELECT SYSTEM$LIST_NAMESPACES_FROM_CATALOG('my_catalog_integration', 'db1', 3);