DESCRIBE LISTING¶

Descreve as colunas em um listagem.

Consulte também:: CREATE LISTING, ALTER LISTING, SHOW LISTINGS, SHOW VERSIONS IN LISTING, DROP LISTING

Sintaxe¶

{ DESC | DESCRIBE } LISTING <name>  [ REVISION = { DRAFT | PUBLISHED } ]

Copy

Parâmetros¶

name

O identificador, especificado quando a listagem foi criada, para a listagem 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.

Consulte SHOW LISTINGS para obter detalhes da listagem, incluindo o nome da listagem.

REVISION = { DRAFT | PUBLISHED }

Especifica qual revisão exibir.

Por exemplo, se você tiver um rascunho de uma listagem publicada, poderá especificar o rascunho ou a versão publicada a ser exibida.

Valores válidos:

DRAFT: Descreva a versão preliminar da listagem.
PUBLISHED: Descreva a versão publicada da listagem.

Padrão:: PUBLISHED

Notas de uso¶

Você só pode descrever uma listagem se usar uma função que tenha o privilégio USAGE, MODIFY ou OWNERSHIP na listagem.

Para pós-processar a saída deste comando, você pode usar o operador de canal (->>) ou a função RESULT_SCAN. Ambos os constructos tratam a saída como um conjunto de resultados que você pode consultar.

Por exemplo, é possível usar o operador de canal ou a função RESULT_SCAN para selecionar colunas específicas da saída do comando SHOW ou filtrar as linhas.

Quando você fizer referência a colunas de saída, use identificadores entre aspas duplas para os nomes das colunas. Por exemplo, para selecionar a coluna de saída type, especifique SELECT "type".

Você deve usar identificadores entre aspas duplas porque os nomes das colunas de saída para os comandos SHOW estão em minúsculas. As aspas duplas garantem que os nomes das colunas na lista SELECT ou na cláusula WHERE correspondam aos nomes das colunas na saída do comando SHOW que foi verificada.

Saída¶

A saída do comando fornece propriedades de listagem e metadados nas seguintes colunas:

Coluna	Descrição
`global_name`	Nome global da listagem
`name`	Nome especificado quando a listagem foi criada.
`owner`	O proprietário da listagem.
`owner_role_type`	O tipo de função do proprietário da listagem.
`created_on`	Data e hora em que a listagem foi criada.
`updated_on`	Data e hora da última atualização da listagem.
`published_on`	Data e hora em que a listagem foi publicada pela última vez.
`title`	Título especificado no manifesto de listagem
`subtitle`	Subtítulo especificado no manifesto de listagem
`description`	The listing description.
`listing_terms`	Os termos da listagem.
`state`	O estado da listagem é um dos seguintes: DRAFT PUBLISHED UNPUBLISHED
`share`	O identificador de compartilhamento desta listagem.
`application_package`	O pacote de aplicativo associado à listagem.
`business_needs`	As necessidades comerciais que a listagem atende.
`usage_examples`	Um exemplo mostrando uma consulta da listagem.
`data_attributes`	Os atributos da listagem, incluindo a taxa de atualização, a cobertura geográfica e o intervalo de tempo.
`categories`	As categorias de listagem.
`resources`	Listagem de recursos, como um link de documentação.
`profile`	O nome do perfil do provedor.
`customized_contact_info`	Informações de contato do provedor.
`data_dictionary`	Listagem de metadados.
`data_preview`	Preview of the listing data.
`comment`	Comentário associado, se presente.
`revisions`	Estado de revisão, somente para listagens públicas.
`target_accounts`	Lista de contas de destino separadas por vírgulas.
`regions`	As regiões de listagem.
`refresh_schedule`	A frequência de atualização da listagem em minutos.
`refresh_type`	O tipo de atualização da listagem.
`review_state`	O estado de revisão da listagem.
`rejection_reason`	O motivo pelo qual a listagem foi rejeitada.
`unpublished_by_admin_reasons`	O motivo pelo qual o proprietário da listagem não publicou a listagem.
`is_monetized`	É um sinalizador monetizado.
`is_application`	Is application flag. If `true`, an application package is attached to the listing.
`is_targeted`	É um sinalizador direcionado.
`is_limited_trial`	Is limited trial flag.
`is_by_request`	Sinalizador de «por solicitação».
`limited_trial_plan`	The plan associated with a limited trial listing.
`retired_on`	Date and time the listing was retired. Null if not retired.
`scheduled_drop_time`	Data e hora em que a listagem está programada para ser descartada (não está mais disponível para consumidores existentes). Nulo se não estiver programado.
`manifest_yaml`	Todo o manifesto publicado quando `REVISION` é `PUBLISHED`, e todo o manifesto publicado com rascunhos de alterações quando `REVISION` é `DRAFT`.
`distribution`	Detalhes da distribuição, se presentes, como `EXTERNAL`.
`is_mountless_queryable`	`true` se a listagem puder ser consultada sem ser montada. Caso contrário, será `false`.
`organization_profile_name`	O nome do perfil da organização associada.
`uniform_listing_locator`	O localizador da listagem uniforme (ULL). Para obter mais informações sobre ULLs, consulte Configuração de listagens organizacionais.
`trial_details`	Details associated with trial listings.
`approver_contact`	Approver contact information.
`support_contact`	Support contact information.
`live_version_uri`	Indicador de recurso uniforme (URI) completo da versão ativa da listagem, em que as operações de área de preparação podem ser realizadas. NULL se não houver uma versão ativa para a listagem.
`last_committed_version_uri`	Full URI of the last committed version of the listing.
`last_committed_version_name`	Nome gerado pelo sistema para a última versão confirmada da listagem.
`last_committed_version_alias`	User-specified alias for the last committed version of the listing.
`published_version_uri`	Full URI of the current published version of the listing.
`published_version_name`	System-generated name of the published version of the listing.
`published_version_alias`	User-specified alias for the last published version of the listing.
`compliance_badges`	Compliance badges associated with this listing, if any.
`is_share`	Sinalizador de compartilhamento. Se `true`, a listagem foi criada com base em um compartilhamento.
`monetization_version`	Modelo de monetização usado pela listagem.
`request_approval_type`	Listing access request type. The access request type defines how discovery targets of a listing submit access requests to the listing approver. Any one of: `NULL` `REQUEST_AND_APPROVE_IN_SNOWFLAKE` indica que as solicitações de acesso são enviadas e aprovadas dentro do ambiente Snowflake. `REQUEST_AND_APPROVE_OUTSIDE_SNOWFLAKE` indica que o provedor gerencia os envios e aprovações de solicitações de acesso de forma independente. O valor para listagens externas é sempre `NULL`.
`monetization_display_order`	A ordem em que os planos de precificação e as ofertas são exibidos aos consumidores.
`legacy_uniform_listing_locator`	Especifica o localizador universal de listagem (ULL). Se um perfil de listagem organizacional existente for atualizado para usar um perfil de organização personalizado, esta coluna incluirá o ULL associado ao perfil padrão anterior que continua válido. Se nenhuma atualização de perfil tiver sido feita, esta coluna será NULL. Para obter mais informações sobre ULLs, consulte Definição do localizador universal de listagem ou o nome de listagem.
`share_restrictions`	Um sinalizador que indica se existem restrições de compartilhamento em listagens privadas externas.

Exemplos¶

To describe the columns in a listing named MYLISTING, run the following command:

DESC LISTING MYLISTING;

Copy