SHOW CATALOG INTEGRATIONS¶
Recurso em versão preliminar — Aberto
Disponível para todas as contas.
Lista as integrações de catálogo em sua conta. A saída retorna metadados e propriedades de integração.
- Consulte também:
CREATE CATALOG INTEGRATION , DROP CATALOG INTEGRATION , DESCRIBE CATALOG INTEGRATION
Sintaxe¶
SHOW CATALOG INTEGRATIONS [ LIKE '<pattern>' ]
Parâmetros¶
LIKE 'pattern'Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (
%e_).Por exemplo, os seguintes padrões retornam os mesmos resultados:
... LIKE '%testing%' ...... LIKE '%TESTING%' .... padrão: sem valor (nenhuma filtragem é aplicada à saída).
Requisitos de controle de acesso¶
Uma função usada para executar esse comando SQL deve ter pelo menos um dos seguintes privilégios, no mínimo:
Privilégio |
Objeto |
Notas |
|---|---|---|
USAGE |
Integração |
|
OWNERSHIP |
Integração |
OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege). |
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.
Notas de uso¶
O comando não precisa de um warehouse em funcionamento para ser executado.
Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.
Saída¶
O comando de saída fornece propriedades de tabela e metadados nas seguintes colunas:
Coluna |
Descrição |
|---|---|
|
Nome da integração do catálogo. |
|
Especifica se a integração do catálogo está disponível para uso em tabelas Iceberg. |
|
Tipo de integração. O valor é sempre CATALOG. |
|
Categoria da integração. O valor é sempre CATALOG. |
|
Cadeia de caracteres (literal) que especifica um comentário da integração. |
|
Data e hora em que a integração do catálogo foi criada. |
Para obter mais informações sobre as propriedades que podem ser especificadas para uma integração de catálogo, consulte CREATE CATALOG INTEGRATION.
Exemplos¶
Mostrar todas as integrações de catálogo:
SHOW CATALOG INTEGRATIONS;
Mostrar todas as integrações de catálogo cujo nome começa com demo que você tem privilégios para visualizar:
SHOW CATALOG INTEGRATIONS LIKE 'demo%';