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

  • 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 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.

    Os nomes das colunas de saída para este comando são gerados em minúsculas. Se você consumir um conjunto de resultados deste comando com o operador de canal ou a função RESULT_SCAN, use identificadores entre aspas duplas para os nomes das colunas na consulta para garantir que eles correspondam aos nomes das colunas na saída que foi verificada. Por exemplo, se o nome de uma coluna de saída for type, especifique "type" para o identificador.

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.

request_approval_type

Exibe o tipo de solicitação de acesso à listagem. O tipo de solicitação de acesso define como os destinos de descoberta de uma listagem enviam solicitações de acesso ao aprovador de listagem. Qualquer um dos seguintes:

  • 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.

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   | request_approval_type |
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+-----------------------+
|   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""}" |                                 | NULL                  |
+------------------------------+---------------------+------------------+---------------------+--------------------------------------+--------------------------------------+--------------------------------------+----------------------------------------------------------------+----------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------+---------------------+------------------+--------------------+-----------------+---------------+---------------------+-------------+----------------------+-------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------+-------------------------+--------------------------------------------------+-----------------------------+----------------------+------------------------------------------------------------------------------------------------------------------------------------+-------------+-----------------------------------------------------------------------------------+------------------+----------------------+----------------+-----------------------------------------------------------------------------------------------------------------+---------------------------------+-----------------------+
Linguagem: Português