SHOW VERSIONS IN LISTING

Lista e fornece detalhes de todas as versões de listagem.

Consulte também:

CREATE LISTING, ALTER LISTING, DESCRIBE LISTING, DROP LISTING

Sintaxe

SHOW VERSIONS IN LISTING <name>
  [ LIMIT <rows> ]
Copy

Parâmetros

name

Especifica o identificador (nome) da listagem. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Identificadores entre aspas duplas também diferenciam maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

LIMIT rows

Opcionalmente, limita o número máximo de linhas retornadas, ao mesmo tempo em que permite a «paginação» dos resultados. O número real de linhas retornadas pode ser menor que o limite especificado. Por exemplo, o número de objetos existentes é menor que o limite especificado.

Saída

A saída do comando inclui as seguintes colunas, que descrevem as propriedades e metadados do objeto:

Coluna

Descrição

created_on

Data e hora em que a versão foi criada.

name

O nome da versão gerado pelo sistema.

alias

O alias da versão especificado pelo usuário.

location_url

URL completo da versão, no qual as operações de estágio podem ser realizadas.

is_default

Identifica a versão da listagem que é publicada.

is_live

Identifica se a versão é uma versão ao vivo da listagem.

is_first

Identifica se a versão é a primeira versão da listagem.

is_last

Identifica se a versão é a última versão da listagem.

comment

Comentários opcionais para a versão de listagem.

source_location_url

O URL do local de origem de onde essa versão foi criada.

git_commit_hash

O hash de confirmação do git, se a versão for criada a partir de uma fonte do git.

Requisitos de controle de acesso

  • Para mostrar as versões da listagem, você deve estar usando uma função que tenha privilégios USAGE ou OWNERSHIP na listagem.

Notas de uso

  • O valor de LIMIT rows não pode exceder 10000. Se LIMIT rows for omitido, o comando resultará em um erro se o conjunto de resultados for maior que dez mil linhas.

    Para visualizar os resultados para os quais existem mais de dez mil registros, inclua LIMIT rows ou consulte a exibição correspondente em Snowflake Information Schema.

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

Exemplos

Mostrar todas as versões da listagem MYLISTING:

SHOW VERSIONS IN LISTING MYLISTING
Copy
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
|             created_on            |             name             |             alias            |                  location_uri                 |     is_default     |       is_live      |      is_first      |       is_last      |                   comment                   |          source_location_uri          |             git_commit_hash           |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
|   2025-01-08 11:18:39.921 -0800   |                              |                              |  snow://listing/MYLISTING/versions/live/      |        FALSE       |        TRUE        |        FALSE       |       FALSE        |                                             |            @listingstage              |                                       |
|   2025-01-08 11:18:24.550 -0800   |        VERSION$2             |                              |  snow://listing/MYLISTING/versions/version$2/ |        TRUE        |        FALSE       |        FALSE       |       TRUE         |                                             |            @listingstage              |                                       |
|   2025-01-08 11:17:32.894 -0800   |        VERSION$1             |                              |  snow://listing/MYLISTING/versions/version$1/ |        FALSE       |        FALSE       |        TRUE        |       FALSE        |                                             |            @listingstage              |                                       |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+