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.

  Se a operação de vinculação falhar, resolva o erro primeiro. O Snowflake então agenda automaticamente a próxima sincronização de descoberta de tabela, a menos que a descoberta tenha sido suspensa para o banco de dados vinculado a catálogo. Se você suspendeu a descoberta, execute ALTER DATABASE … RESUME DISCOVERY depois de resolver o erro para retomar a descoberta.

  Por exemplo:

  CopyExpand

  ALTER DATABASE IF EXISTS my_linked_db RESUME DISCOVERY;
  

  Show lessSee more

  Scroll to top

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.

• Se a operação for CATALOG_CONNECTION, ocorreu um erro quando o Snowflake tentou se conectar ao catálogo remoto.

• Se a operação for DISCOVERY, houve um erro quando o Snowflake tentou descobrir as tabelas ou namespaces em seu catálogo remoto. Para ver qual tabela ou namespace causou o erro, consulte entityDomain, que será TABLE ou NAMESPACE.

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