SHOW VERSIONS IN DBT PROJECT

Exibe uma lista de todas as versões de um objeto de projeto dbt.

Consulte também:

ALTER DBT PROJECT, DESCRIBE DBT PROJECT, EXECUTE DBT PROJECT, SHOW DBT PROJECTS, DROP DBT PROJECT

Sintaxe

SHOW VERSIONS IN DBT PROJECT <name>
  [ LIMIT <number> ]
Copy

Parâmetros

name

String que especifica o identificador (ou seja, o nome) do objeto de projeto dbt no Snowflake. Deve ser exclusivo do esquema no qual o projeto dbt é criado.

Além disso, o identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras 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. 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.

Padrão: sem valor (nenhum limite é aplicado à saída).

Requisitos de controle de acesso

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio

Objeto

USAGE

O objeto de projeto dbt

MONITOR

O objeto de projeto dbt

OWNERSHIP

O objeto de projeto dbt

Notas de uso

  • O comando não precisa de um warehouse em funcionamento para ser executado.

  • O comando retorna apenas objetos para os quais a função atual do usuário atual recebeu pelo menos um privilégio de acesso.

  • O privilégio de acesso MANAGE GRANTS permite implicitamente que seu titular consulte todos os objetos da conta. Por padrão, somente o administrador de conta (usuários com a função ACCOUNTADMIN) e o administrador de segurança (usuários com a função SECURITYADMIN) têm o privilégio MANAGE GRANTS.

  • 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 mostra as propriedades e os metadados de tabela das versões de projetos dbt nas seguintes colunas:

Coluna

Descrição

created_on

Data e hora em que o objeto de projeto dbt foi criado.

name

O nome atribuído automaticamente da versão do projeto dbt. Por exemplo, VERSION$1.

alias

O alias do projeto dbt que você atribuiu (por exemplo, ALTER DBT PROJECT <name> ADD VERSION <alias> FROM …). Nulo se não for especificado.

location_uri

URL completo da versão do projeto dbt.

is_default

TRUE se a versão padrão do objeto de projeto dbt apontar para esta versão.

is_live

TRUE se a versão do projeto dbt for uma versão ativa da listagem.

is_first

TRUE se o projeto dbt for a primeira versão.

is_last

TRUE se o projeto dbt for a última versão.

comment

Comentário definido no projeto dbt.

source_location_uri

O URI do local de origem de criação desta versão do projeto dbt.

git_commit_hash

O hash de commit do git, se a versão do projeto dbt foi criada de uma fonte do git.

Exemplos

Mostrar todas as versões do my_dbt_project:

SHOW VERSIONS IN DBT PROJECT my_dbt_project;
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:24.550 -0800 | VERSION$2 | null  |  snow://dbtproject/mydb.my_schema.my_dbt_project/versions/version$2/ | TRUE       | FALSE   | FALSE    |  TRUE   | null    | null                | null            |
|   2025-01-08 11:17:32.894 -0800 | VERSION$1 | null  |  snow://dbtproject/mydb.my_schema.my_dbt_project/versions/version$2/ | FALSE      | FALSE   | TRUE     |  FALSE  | null    | null                | null            |
+---------------------------------+-----------+------------------------------+-----------------------------------------------+------------+--------------------+---------+---------+---------------------+-----------------+
Linguagem: Português