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> ]
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 |
---|---|
|
Data e hora em que a versão foi criada. |
|
O nome da versão gerado pelo sistema. |
|
O alias da versão especificado pelo usuário. |
|
URL completo da versão, no qual as operações de estágio podem ser realizadas. |
|
Identifica a versão da listagem que é publicada. |
|
Identifica se a versão é uma versão ao vivo da listagem. |
|
Identifica se a versão é a primeira versão da listagem. |
|
Identifica se a versão é a última versão da listagem. |
|
Comentários opcionais para a versão de listagem. |
|
O URL do local de origem de onde essa versão foi criada. |
|
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 exceder10000
. SeLIMIT 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
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+
| 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 | |
+-----------------------------------+------------------------------+------------------------------+-----------------------------------------------+--------------------+--------------------+--------------------+--------------------+---------------------------------------------+---------------------------------------+---------------------------------------+