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 , DROP CATALOG INTEGRATION , SHOW CATALOG INTEGRATIONS

Sintaxe¶

DESC[RIBE] CATALOG INTEGRATION <name>

Copy

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.

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.

Saída¶

A saída do comando fornece propriedades de integração de catálogo e metadados nas seguintes colunas.

Coluna	Descrição
`property`	O nome da propriedade. Para descrições de propriedades, consulte CREATE CATALOG INTEGRATION.
`property_type`	O tipo de propriedade.
`property_value`	O valor atribuído à propriedade.
`property_default`	O valor da propriedade padrão.

Exemplos¶

Descrever as colunas na integração:

DESC CATALOG INTEGRATION myCatalogInt;

Copy

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        |                                  |                  |
+-----------------------+---------------+----------------------------------+------------------+