Categorias:: Funções do sistema (Informações do sistema)

SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG¶

Retorna os parâmetros de configuração definidos no banco de dados vinculado a catálogo especificado. A saída é no formato JSON.

Sintaxe¶

SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG('<catalog_linked_database_name>');

Argumentos¶

catalog_linked_database_name

O nome do banco de dados vinculado a catálogo para o qual você deseja obter a configuração.

Especifique-o como uma cadeia de caracteres literal entre aspas simples.

Retornos¶

A função retorna uma cadeia de caracteres que contém um objeto JSON com os parâmetros de configuração do banco de dados.


Campo	Descrição
`catalog_integration`	Nome da integração de catálogo usada pelo banco de dados vinculado a catálogo.
`catalog_name`	Nome do namespace no catálogo externo. Retorna `null` se não for especificado.
`external_volume`	Nome do volume externo usado para armazenamento de tabela.
`sync_interval_seconds`	Intervalo (em segundos) em que o Snowflake pesquisa o catálogo remoto para detectar alterações.
`namespace_mode`	Modo para processar namespaces. Possíveis valores: `FLATTEN_NESTED_NAMESPACE`, `HIERARCHICAL`.
`namespace_flatten_delimiter`	Delimitador usado ao nivelar namespaces aninhados. Aplicável somente quando `namespace_mode` é `FLATTEN_NESTED_NAMESPACE`.
`allowed_write_operations`	Tipos de operações de gravação permitidos no banco de dados vinculado a catálogo. Possíveis valores: `NONE`, `ALL`.
`catalog_case_sensitivity`	Configuração de distinção entre maiúsculas e minúsculas para o catálogo. Possíveis valores: `CASE_SENSITIVE`, `CASE_INSENSITIVE`.
`is_suspended`	Se a sincronização do banco de dados vinculado a catálogo está suspensa. Retorna `true` se estiver suspensa; caso contrário, `false`.
`allowed_namespaces`	Lista de namespaces que podem ser sincronizados. Retorna `null` se todos os namespaces forem permitidos.
`blocked_namespaces`	Lista de namespaces com a sincronização bloqueada. Retorna `null` se nenhum namespace estiver bloqueado.

Para conferir uma saída de amostra, consulte Exemplos.

Requisitos de controle de acesso¶

Uma função usada para executar esta operação deve ter o privilégio MONITOR, USAGE, OWNERSHIP ou ALL.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Exemplos¶

Obter a configuração para um banco de dados vinculado a catálogo chamado my_db:

SELECT SYSTEM$GET_CATALOG_LINKED_DATABASE_CONFIG('my_db');

Exemplo de saída:

{
  "catalog_integration": "TEST_GET_CLD_CONFIG_EBEC9E22_44BD_4945_A4C3_A402CCBB86AF_CAT",
  "catalog_name": null,
  "external_volume": "EXVOL_GET_CLD_CONFIG",
  "sync_interval_seconds": 600,
  "namespace_mode": "FLATTEN_NESTED_NAMESPACE",
  "namespace_flatten_delimiter": "_",
  "allowed_write_operations": "NONE",
  "catalog_case_sensitivity": "CASE_INSENSITIVE",
  "is_suspended": false,
  "allowed_namespaces": ["'ns1'", "'ns2'"],
  "blocked_namespaces": ["'blocked_ns1'"]
}