DESCRIBE CATALOG INTEGRATION¶
Descreve as propriedades de uma integração de catálogo.
DESCRIBE pode ser abreviado como DESC.
- Consulte também:
CREATE CATALOG INTEGRATION, ALTER CATALOG INTEGRATION, DROP CATALOG INTEGRATION, SHOW CATALOG INTEGRATIONS
Sintaxe¶
DESC[RIBE] CATALOG INTEGRATION <name>
Parâmetros¶
nameEspecifica 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¶
Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:
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 | | |
+-----------------------+---------------+----------------------------------+------------------+