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