SYSTEM$CATALOG_LINK_STATUS¶

Sintaxe¶

SYSTEM$CATALOG_LINK_STATUS( '<catalog_linked_db_name>' )

Argumentos¶

'catalog_linked_db_name'

Especifica o nome do banco de dados vinculado a catálogo cujo status você deseja verificar.

Retornos¶

A função retorna um objeto JSON contendo os seguintes pares nome/valor:

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

Onde:

executionState

Estado de execução atual da operação de vinculação que o Snowflake usa para se conectar ao seu catálogo Iceberg.

Valores:

• RUNNING: a próxima sincronização de descoberta de tabela está agendada ou em execução; não garante que todas as tabelas tenham sincronizadas com sucesso.

• FAILED: a operação de vinculação encontrou um erro e não foi bem-sucedida.

failedExecutionStateReason

Mensagem de erro associada a um estado de execução FAILED. Não aparece na saída da função se a última tentativa de sincronização tiver sido bem-sucedida.

failedExecutionStateErrorCode

Código de erro associado a um estado de execução FAILED. Não aparece na saída da função se a última tentativa de sincronização tiver sido bem-sucedida.

lastLinkAttemptStartTime

Carimbo de data/hora que indica quando o Snowflake iniciou o processo de descoberta e sincronização de alterações no catálogo remoto.

failureDetails

Uma matriz de objetos que fornece detalhes sobre entidades (por exemplo, tabelas) no catálogo remoto que o Snowflake não pode sincronizar. Cada objeto tem os seguintes campos:

qualifiedEntityName

O nome qualificado da entidade no catálogo remoto, relativo ao nome do catálogo.

Por exemplo, namespace_level_1.namespace_level_2.table_name.

Tipo: Cadeia de caracteres

entityDomain

O domínio da entidade no catálogo remoto; por exemplo, TABLE.

Tipo: Cadeia de caracteres

operation

A operação no Snowflake associada à sincronização; por exemplo, CREATE (tabela ou esquema), DROP.

Tipo: Cadeia de caracteres

errorCode

Código de erro associado à falha.

Tipo: Cadeia de caracteres

errorMessage

Código de erro associado à falha.

Tipo: Cadeia de caracteres

Requisitos de controle de acesso¶

Uma função usada para executar este comando SQL deve ter no mínimo os seguintes privilégios:

Notas de uso¶

• O campo failureDetails retorna informações sobre as falhas DROP SCHEMA e DROP ICEBERG TABLE.

• Retorna resultados, desde que você use uma função com privilégio no banco de dados vinculado a catálogo especificado. Para obter mais informações, consulte Privilégios de banco de dados.

Exemplos¶

Recuperar o status do link para um banco de dados vinculado a catálogo chamado my_cld:

SELECT SYSTEM$CATALOG_LINK_STATUS('my_cld');

Saída:

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