SYSTEM$CATALOG_LINK_STATUS¶

Syntax¶

SYSTEM$CATALOG_LINK_STATUS( '<catalog_linked_db_name>' )

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

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

Anforderungen an die Zugriffssteuerung¶

Eine Rolle, die zum Ausführen dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

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');

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."
    }
  ]
}