SYSTEM$LIST_NAMESPACES_FROM_CATALOG¶

Syntaxe¶

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

Arguments¶

Obligatoire :

catalog_integration_name

Identifiant pour l’intégration du catalogue pour Iceberg REST ou Snowflake Open Catalog.

Facultatif :

parent_namespace

L’identificateur de l’espace de noms à partir duquel commencer à lister les espaces de noms. Pour récupérer les résultats du niveau d’espace de noms 0 dans le catalogue, spécifiez une chaîne vide ('').

Par défaut : l’espace de noms par défaut pour l’intégration du catalogue (CATALOG_NAMESPACE).

levels

Spécifie le nombre de niveaux à parcourir dans la hiérarchie de l’espace de noms pour lister les espaces de noms enfants.

Par exemple :

• Si la valeur est définie sur 0, la fonction renvoie tous les espaces de noms, de manière récursive, par rapport à parent_namespace.

• Si la valeur est 1, la fonction renvoie tous les espaces de noms situés à un niveau au-dessous de parent_namespace.

• Si elle est définie sur n, la fonction renvoie des espaces de noms jusqu’à n niveaux de profondeur, par rapport à parent_namespace.

Par défaut : 1

Renvoie¶

Renvoie une chaîne au format JSON qui liste les espaces de noms dans le catalogue REST Iceberg pour l’espace de noms parent et le nombre de niveaux spécifiés.

La chaîne au format JSON a la structure suivante :

[
  "<namespace_identifier>",
  "<namespace_identifier_n>"
]

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette commande SQL doit avoir les privilèges suivants définis au minimum ainsi :

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Exemples¶

Lister uniquement les espaces de noms directement sous l’espace de noms par défaut de l’intégration du catalogue :

SELECT SYSTEM$LIST_NAMESPACES_FROM_CATALOG('my_catalog_integration');

Lister tous les espaces de noms de manière récursive dans le catalogue :

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

Lister uniquement les espaces de noms situés à un niveau en dessous (directement sous) de l’espace de noms « db1 » :

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

Lister les espaces de noms à trois niveaux sous l’espace de noms « db1 » :

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