SYSTEM$CATALOG_LINK_STATUS¶

Syntaxe¶

SYSTEM$CATALOG_LINK_STATUS( '<catalog_linked_db_name>' )

Arguments¶

'catalog_linked_db_name'

Spécifie le nom de la base de données liée au catalogue dont vous souhaitez vérifier le statut.

Renvoie¶

La fonction renvoie un objet JSON contenant les paires nom/valeur suivantes :

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

Où :

executionState

État d’exécution actuel de l’opération de liaison que Snowflake utilise pour se connecter à votre catalogue Iceberg.

Valeurs :

• RUNNING : La prochaine synchronisation de découverte de la table est planifiée ou en cours d’exécution ; ne garantit pas que toutes les tables ont été synchronisées avec succès.

• FAILED : Échec de l’opération de liaison en raison d’une erreur.

  Si l’opération de liaison échoue, résolvez d’abord l’erreur. Snowflake planifie ensuite automatiquement la synchronisation suivante de la découverte de table, à moins que la découverte n’ait été suspendue pour la base de données liée au catalogue. Si vous avez suspendu la découverte, exécutez ALTER DATABASE … RESUME DISCOVERY après avoir résolu l’erreur pour reprendre la découverte.

  Par exemple :

  CopyExpand

  ALTER DATABASE IF EXISTS my_linked_db RESUME DISCOVERY;
  

  Show lessSee more

  Scroll to top

failedExecutionStateReason

Message d’erreur associé à un état d’exécution FAILED. N’apparaît pas dans la sortie de la fonction si la dernière tentative de synchronisation a réussi.

failedExecutionStateErrorCode

Code d’erreur associé à un état d’exécution FAILED. N’apparaît pas dans la sortie de la fonction si la dernière tentative de synchronisation a réussi.

lastLinkAttemptStartTime

Horodatage indiquant la dernière fois où Snowflake a lancé le processus de détection et de synchronisation des modifications dans le catalogue distant.

failureDetails

Tableau d’objets qui fournissent des détails sur les entités (par exemple, les tables) du catalogue distant que Snowflake ne peut pas synchroniser. Chaque objet comporte les champs suivants :

qualifiedEntityName

Nom qualifié de l’entité dans le catalogue distant, relatif au nom du catalogue.

Par exemple, namespace_level_1.namespace_level_2.table_name.

Type : Chaîne

entityDomain

Le domaine de l’entité dans le catalogue distant ; par exemple, TABLE.

Type : Chaîne

operation

L’opération dans Snowflake associée à la synchronisation ; par exemple, CREATE une table ou un schéma, DROP.

• Si l’opération est CATALOG_CONNECTION, une erreur est survenue lorsque Snowflake a tenté de se connecter au catalogue distant.

• Si l’opération est DISCOVERY, une erreur est survenue lorsque Snowflake a tenté de découvrir les tables ou les espaces de noms de votre catalogue distant. Pour savoir quelle table ou quel espace de noms est à l’origine de l’erreur, voir entityDomain, qui sera soit TABLE ou NAMESPACE.

Type : Chaîne

errorCode

Code d’erreur associé à l’échec.

Type : Chaîne

errorMessage

Code d’erreur associé à l’échec.

Type : Chaîne

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

Un rôle utilisé pour exécuter cette commande SQL doit avoir l’un des privilèges suivants au minimum :

Notes sur l’utilisation¶

• Le champ failureDetails renvoie des informations sur les échecs DROP SCHEMA et DROP ICEBERG TABLE.

• Renvoie les résultats à condition que vous utilisiez un rôle doté d’un privilège sur la base de données liée au catalogue spécifié. Pour plus d’informations, voir Privilèges de base de données.

Exemples¶

Récupérer le statut du lien pour une base de données liée au catalogue nommée my_cld :

SELECT SYSTEM$CATALOG_LINK_STATUS('my_cld');

Sortie :

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