Kategorien:: Systemfunktionen (Systeminformationen)

SYSTEM$CATALOG_LINK_STATUS¶

Gibt den Linkstatus für eine angegebene katalogverknüpfte Datenbank zurück.

Siehe auch:: Verwenden einer mit dem Katalog verbundene Datenbank für Apache Iceberg™-Tabellen

Syntax¶

SYSTEM$CATALOG_LINK_STATUS( '<catalog_linked_db_name>' )

Copy

Argumente¶

'catalog_linked_db_name': Gibt den Namen der katalogverknüpften Datenbank an, deren Status Sie überprüfen möchten.

Rückgabewerte¶

Die Funktion gibt ein JSON-Objekt zurück, das die folgenden Name/Wert-Paare enthält:

{
  "executionState":"<value>",
  "failedExecutionStateReason":"<value>",
  "failedExecutionStateErrorCode":"<value>",
  "lastLinkAttemptStartTime":"<value>",
  "failureDetails":[
    {
      "qualifiedEntityName":"<value>",
      "entityDomain":"<value>",
      "operation":"<value>",
      "errorCode":"<value>",
      "errorMessage":"<value>"
    },
    { ... },
    ...
  ]
}

Copy

Wobei:

executionState
Aktueller Stand der Ausführung der Verknüpfungsoperation, die Snowflake verwendet, um eine Verbindung zu Ihrem Iceberg-Katalog herzustellen.

Werte:

RUNNING: Die nächste Synchronisierung der Tabelle ist geplant oder wird ausgeführt; garantiert nicht, dass alle Tabellen erfolgreich synchronisiert wurden.

FAILED: Die Verknüpfungsoperation ist auf einen Fehler gestoßen und war nicht erfolgreich.

failedExecutionStateReason
Fehlermeldung in Verbindung mit einem FAILED-Ausführungsstatus. Wird nicht in der Ausgabe der Funktion angezeigt, wenn der letzte Synchronisierungsversuch erfolgreich war.

failedExecutionStateErrorCode
Fehlercode in Verbindung mit einem FAILED-Ausführungsstatus. Wird nicht in der Ausgabe der Funktion angezeigt, wenn der letzte Synchronisierungsversuch erfolgreich war.

lastLinkAttemptStartTime
Zeitstempel, der angibt, wann Snowflake den Prozess zum Erkennen und Synchronisieren von Änderungen im Remote-Katalog zuletzt gestartet hat.

failureDetails
Ein Array von Objekten, die Details zu Entitäten (z. B. Tabellen) im Remote-Katalog bereitstellen, die Snowflake nicht synchronisieren kann. Jedes Objekt hat die folgenden Felder:

qualifiedEntityName
Der qualifizierte Name der Entität im Remote-Katalog im Verhältnis zum Katalognamen.

Beispiel: namespace_level_1.namespace_level_2.table_name.

Typ String

entityDomain
Die Entitätsdomäne im Remote-Katalog; z. B. TABLE.

Typ String

operation
Der mit der Synchronisierung verbundene Vorgang in Snowflake; z. B. CREATE (Tabelle oder Schema), DROP.

Typ String

errorCode
Mit dem Fehlschlag verbundener Fehlercode.

Typ String

errorMessage
Mit dem Fehlschlag verbundener Fehlercode.

Typ String

Nutzungshinweise¶

Das Feld failureDetails gibt Informationen zu den DROP SCHEMA- und DROP ICEBERG TABLE-Fehlschlägen zurück.
Gibt Ergebnisse zurück, solange Sie eine Rolle mit einer Berechtigung in der angegebenen katalogverknüpften Datenbank verwenden. Weitere Informationen dazu finden Sie unter Berechtigungen von Datenbanken.

Beispiele¶

Abrufen des Verknüpfungsstatus für eine katalogverknüpften Datenbank namens my_cld:

SELECT SYSTEM$CATALOG_LINK_STATUS('my_cld');

Copy

Ausgabe:

{
  "executionState": "RUNNING",
  "lastLinkAttemptStartTime": "2025-02-14T01:35:01.71Z",
  "failureDetails": [
    {
      "qualifiedEntityName": "my_namespace.table_1",
      "entityDomain": "TABLE",
      "operation": "CREATE",
      "errorCode": "0040000",
      "errorMessage": "An internal error occurred. Please contact Snowflake support."
    },
    {
      "qualifiedEntityName": "my_namespace.table_2",
      "entityDomain": "TABLE",
      "operation": "CREATE",
      "errorCode": "0040000",
      "errorMessage": "An internal error occurred. Please contact Snowflake support."
    }
  ]
}