DESCRIBE LISTING¶

Descreve as colunas em um listagem.

DESCRIBE pode ser abreviado como DESC.

Consulte também:: CREATE LISTING, ALTER LISTING, SHOW LISTINGS, DROP LISTING, Listagem de referência de manifesto

Sintaxe¶

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

Copy

Parâmetros¶

name

Especifica o identificador, indicado durante a criação da listagem, para descrever a listagem. 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 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¶

Para uma listagem DESCRIBE, você deve estar usando uma função que tenha um dos privilégios USAGE, MODIFY ou OWNERSHIP na listagem.

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 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`	Descrição da listagem.
`target_accounts`	Lista de contas de destino separadas por vírgulas.
`is_monetized`	É um sinalizador monetizado.
`is_application`	É sinalizador de aplicativo. Se `true`, um pacote de aplicativo está anexado à listagem.
`is_targeted`	É um sinalizador direcionado.
`state`	O estado da listagem é um dos seguintes: DRAFT PUBLISHED UNPUBLISHED
`revisions`	Estado de revisão, somente para listagens públicas.
`comment`	Comentário associado, se presente.
`refresh_schedule`	A frequência de atualização da listagem em minutos.
`refresh_type`	O tipo de atualização da listagem.
`business_needs`	As necessidades comerciais que a listagem atende.
`usage_examples`	O caso de uso da listagem.
`listing_terms`	Os termos da listagem.
`profile`	Nome do perfil do provedor conforme especificado no manifesto de listagem.
`customized_contact_info`	Informações de contato do provedor.
`application_package`	O pacote de aplicativo associado à listagem.
`data_dictionary`	Listagem de metadados.
`regions`	As regiões de listagem.
`manifest_yaml`	Todo o manifesto publicado quando `REVISION` é `PUBLISHED`, e todo o manifesto publicado com rascunhos de alterações quando `REVISION` é `DRAFT`.
`review_state`	O estado de revisão da listagem.
`rejection_reason`	O motivo pelo qual a listagem foi rejeitada.
`categories`	As categorias de listagem.
`resources`	Os recursos de listagem.
`unpublished_by_admin_reasons`	O motivo pelo qual o proprietário da listagem não publicou a listagem.

Exemplos¶

Descrever as colunas na listagem nomeada MYLISTING:

DESC LISTING MYLISTING;

Copy

+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+
|   global_name                |   name              |   owner          |   owner_role_type   |   created_on                         |   updated_on                         |   published_on                       |   title                                                        |   subtitle                                         |   description                                                                                                              |   target_accounts   |   is_monetized   |   is_application   |   is_targeted   |   state       |   revisions         |   comment   |   refresh_schedule   |   refresh_type    |   business_needs                                                                                                                                         |   usage_examples                                                                                                     |   listing_terms         |   profile                                        |   customized_contact_info   |  application_package |  data_dictionary                                                                                                                   |   regions   |   manifest_yaml                                                                   |   review_state   |   rejection_reason   |   categories   |   resources                                                                                                     |   unpublished_by_admin_reason   |
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+
|   GZ13Z1VEWNG                |   CDC_COVID_19_DATA |   ACCOUNTADMIN   |   ROLE              |   2023-12-01T13:01:13.367-08:00      |   2023-12-01T13:25:11.331-08:00      |   2023-12-01T13:25:11.331-08:00      |   Understanding COVID-19: Explore the Latest Data from the CDC |   Track cases, deaths, vaccination rates, and more |   Get the most up-to-date information on the COVID-19 pandemic from the Centers for Disease Control and Prevention (CDC).  |                     |   false          |   false            |   false         |   PUBLISHED   |   DRAFT,PUBLISHED   |             |   60 MINUTE          |   FULL_DATABASE   |   [{""type"":""CUSTOM"",""name"":""Public Health Monitoring and Response"",""description"":""Monitor trends in cases, deaths, and other key metrics.""}] |   [{""title"":""Identify potential outbreaks of COVID-19 in [country name] by tracking trends in confirmed cases"    |   {"type":"STANDARD"}   |   RAVENCLAW_9A314599_F644_4664_946B_4DE0B2169C28 |                             |                      |  {""database"":""COVIDDATADB"",""objects"":[{""schema"":""PUBLIC"",""domain"":""TABLE"",""name"":""GLOBAL_COVID_STATISTICS""}]}"   |   ALL       |   title: "Understanding COVID-19: Explore the Latest Data from the CDC"  . . .    |                  |                      |   HEALTH       |   "{""documentation"":""https://snowflake.com/doc"",""media"":""https://www.youtube.com/watch?v=AR88dZG-hwo""}" |                                 |
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+