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 a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada. Você também pode usar o operador de canal para consultar a saída desse comando.

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