Catégories :: Fonctions système (Informations système)

SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG¶

Renvoie les paramètres de configuration définis sur la :doc:` base de données liée au catalogue spécifiée</user-guide/tables-iceberg-catalog-linked-database>`. La sortie est au format JSON.

Syntaxe¶

SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG('<catalog_linked_database_name>');

Arguments¶

catalog_linked_database_name

Le nom de la base de données liée au catalogue pour laquelle vous souhaitez obtenir la configuration.

Spécifiez-le sous forme de littéral de chaîne entre guillemets simples.

Renvoie¶

La fonction renvoie une chaîne contenant un objet JSON avec les paramètres de configuration de la base de données.


Champ	Description
`catalog_integration`	Nom de l’intégration de catalogue utilisée par la base de données liée au catalogue.
`catalog_name`	Nom de l’espace de noms du catalogue dans le catalogue externe. Renvoie `null` si non spécifié.
`external_volume`	Nom du volume externe utilisé pour le stockage de la table.
`sync_interval_seconds`	Intervalle (en secondes) pendant lequel Snowflake interroge le catalogue distant pour détecter les modifications.
`namespace_mode`	Mode de traitement des espaces de noms. Valeurs possibles : `FLATTEN_NESTED_NAMESPACE`, `HIERARCHICAL`.
`namespace_flatten_delimiter`	Délimiteur utilisé lors de l’aplatissement des espaces de noms imbriqués. Uniquement applicable lorsque `namespace_mode` est `FLATTEN_NESTED_NAMESPACE`.
`allowed_write_operations`	Types d’opérations d’écriture autorisées sur la base de données liée au catalogue. Valeurs possibles : `NONE`, `ALL`.
`catalog_case_sensitivity`	Paramètre de sensibilité à la casse pour le catalogue. Valeurs possibles : `CASE_SENSITIVE`, `CASE_INSENSITIVE`.
`is_suspended`	Si oui ou non la synchronisation des bases de données liées au catalogue est suspendue. Renvoie `true` si elle est suspendue,``false`` si elle ne l’est pas.
`allowed_namespaces`	Liste des espaces de noms pouvant être synchronisés. Renvoie `null` si tous les espaces de noms sont autorisés.
`blocked_namespaces`	Liste des espaces de noms dont la synchronisation est bloquée. Renvoie `null` si aucun espace de noms n’est bloqué.

Pour un exemple de sortie, voir Exemples.

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

Un rôle utilisé pour exécuter cette opération doit disposer du privilège MONITOR ,USAGE ,OWNERSHIP, ouALL.

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¶

Obtenir la configuration d’une base de données liée au catalogue nommée my_db :

SELECT SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG('my_db');

Exemple de sortie :

{
  "catalog_integration": "TEST_GET_CLD_CONFIG_EBEC9E22_44BD_4945_A4C3_A402CCBB86AF_CAT",
  "catalog_name": null,
  "external_volume": "EXVOL_GET_CLD_CONFIG",
  "sync_interval_seconds": 600,
  "namespace_mode": "FLATTEN_NESTED_NAMESPACE",
  "namespace_flatten_delimiter": "_",
  "allowed_write_operations": "NONE",
  "catalog_case_sensitivity": "CASE_INSENSITIVE",
  "is_suspended": false,
  "allowed_namespaces": ["'ns1'", "'ns2'"],
  "blocked_namespaces": ["'blocked_ns1'"]
}