DESCRIBE CATALOG INTEGRATION¶
Descreve as propriedades de uma integração de catálogo.
DESCRIBE pode ser abreviado como DESC.
Dica
Além do SQL, você também pode usar outras interfaces, como Snowflake REST APIs, Snowflake Python APIs e Snowflake CLI. Consulte Interfaces alternativas.
- Consulte também:
CREATE CATALOG INTEGRATION, ALTER CATALOG INTEGRATION, DROP CATALOG INTEGRATION, SHOW CATALOG INTEGRATIONS
Sintaxe¶
DESC[RIBE] CATALOG INTEGRATION <name>
Parâmetros¶
name
Especifica o identificador da integração de catálogo a ser descrita. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.
Saída¶
A saída do comando inclui as seguintes colunas, que descrevem as propriedades e metadados do objeto:
Coluna |
Descrição |
---|---|
|
O nome da propriedade. Esta coluna pode incluir as propriedades listadas na tabela a seguir. |
|
O tipo de propriedade. |
|
O valor atribuído à propriedade. |
|
O valor da propriedade padrão. |
A coluna property
pode incluir as seguintes propriedades do objeto de integração do catálogo:
Propriedade |
Descrição |
---|---|
|
Especifica se a integração de catálogo está disponível para uso em tabelas Apache Iceberg™. |
|
O tipo de fonte do catálogo; por exemplo, |
|
(AWS Glue) Especifica o namespace do catálogo de dados do AWS Glue. |
|
O formato da tabela fornecido pelo catálogo; por exemplo, |
|
(AWS Glue) O Amazon Resource Name (ARN) da função IAM que o Snowflake assume para se conectar ao AWS Glue. |
|
(AWS Glue) Especifica o ID da sua conta AWS. |
|
(AWS Glue) A região AWS do catálogo de dados do AWS Glue. |
|
(AWS Glue) O ARN do AWS do usuário IAM criado para sua conta Snowflake quando você criou a integração do catálogo. |
|
(AWS Glue) O ID externo que o Snowflake usa para estabelecer uma relação de confiança com AWS Glue. |
|
O comentário para a integração do catálogo. |
Requisitos de controle de acesso¶
A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:
Privilégio |
Objeto |
Notas |
---|---|---|
USAGE |
Integração (catálogo) |
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¶
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.
Exemplos¶
Descreva uma integração de catálogo:
DESC CATALOG INTEGRATION my_catalog_integration;
Veja a seguir a saída de DESCRIBE CATALOG INTEGRATION para uma integração do catálogo AWS Glue. A saída inclui propriedades de integração de catálogo AWS específicas do Glue (por exemplo, GLUE_AWS_ROLE_ARN
) e comuns.
+-----------------------+---------------+----------------------------------+------------------+
| property | property_type | property_value | property_default |
+-----------------------+---------------+----------------------------------+------------------+
| ENABLED | Boolean | true | false |
| CATALOG_SOURCE | String | GLUE | |
| CATALOG_NAMESPACE | String | dbname | |
| TABLE_FORMAT | String | ICEBERG | |
| GLUE_AWS_ROLE_ARN | String | arn:aws:iam::123:role/dummy-role | |
| GLUE_CATALOG_ID | String | 123456789012 | |
| GLUE_REGION | String | us-west-2 | |
| GLUE_AWS_IAM_USER_ARN | String | arn:aws:iam::123:user/example | |
| GLUE_AWS_EXTERNAL_ID | String | exampleGlueExternalId | |
| COMMENT | String | | |
+-----------------------+---------------+----------------------------------+------------------+
Interfaces alternativas¶
Snowflake REST APIs
Ponto de extremidade de busca de integração de catálogo
Snowflake Python APIs
Snowflake CLI
Sem suporte