Kategorien:: Systemfunktionen (Systeminformationen)

SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG¶

Gibt die Konfigurationsparameter zurück, die für die angegebene katalogverknüpfte Datenbank festgelegt wurden. Die Ausgabe erfolgt im JSON-Format.

Syntax¶

SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG('<catalog_linked_database_name>');

Argumente¶

catalog_linked_database_name

Der Name der katalogverknüpften Datenbank, für die Sie die Konfiguration abrufen möchten.

Geben Sie sie als ein Zeichenfolgenliteral an, das in einfache Anführungszeichen eingeschlossen ist.

Rückgabewerte¶

Die Funktion gibt eine Zeichenfolge zurück, die ein JSON-Objekt mit den Konfigurationsparametern der Datenbank enthält.


Feld	Beschreibung
`catalog_integration`	Name der Katalogintegration, die von der katalogverknüpften Datenbank verwendet wird.
`catalog_name`	Name des Katalog-Namespace im externen Katalog. Gibt `null` zurück, wenn nicht angegeben.
`external_volume`	Name des externen Volumes, das für die Tabellenspeicherung verwendet wird.
`sync_interval_seconds`	Intervall (in Sekunden), in dem Snowflake den Remote-Katalog abfragt, um Änderungen zu erkennen.
`namespace_mode`	Modus für die Handhabung von Namespaces. Mögliche Werte: `FLATTEN_NESTED_NAMESPACE`, `HIERARCHICAL`.
`namespace_flatten_delimiter`	Trennzeichen, das beim Vereinfachen verschachtelter Namespaces verwendet wird. Nur anwendbar, wenn``namespace_mode`` auf `FLATTEN_NESTED_NAMESPACE` einstellt ist.
`allowed_write_operations`	Typen von Schreibvorgängen, die für die katalogverknüpfte Datenbank zulässig sind. Mögliche Werte: `NONE`, `ALL`.
`catalog_case_sensitivity`	Einstellung der Groß-/Kleinschreibung für den Katalog. Mögliche Werte: `CASE_SENSITIVE`, `CASE_INSENSITIVE`.
`is_suspended`	Gibt an, ob die Synchronisierung der katalogverknüpften Datenbank ausgesetzt ist. Gibt `true` zurück, wenn sie ausgesetzt ist, andernfalls `false`.
`allowed_namespaces`	Liste der Namespaces, die synchronisiert werden dürfen. Gibt `null` zurück, wenn dies für alle Namespaces erlaubt ist.
`blocked_namespaces`	Liste der Namespaces, die für die Synchronisierung blockiert ist. Gibt `null` zurück, wenn keine Namespaces blockiert sind.

Eine Beispielausgabe finden Sie unter Beispiele.

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zur Ausführung dieses Vorgangs verwendet wird, muss über die Berechtigung MONITOR, USAGE, OWNERSHIP oder ALL verfügen.

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¶

Abrufen der Konfiguration für eine katalogverknüpfte Datenbank namens my_db:

SELECT SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG('my_db');

Beispielausgabe:

{
  "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'"]
}