SHOW VERSIONS IN DBT PROJECT

显示 dbt 项目对象 的所有版本的列表。

另请参阅：

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

语法

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

参数

name

字符串，指定 Snowflake 中 dbt 项目对象的标识符（即名称）；对于在其中创建 dbt 项目的架构必须是唯一的。

此外，标识符必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内（例如，"My object"）。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅 标识符要求。

LIMIT rows

（可选）限制返回的最大行数。返回的实际行数可能小于指定的限制。例如，现有对象的数量小于指定的限制。

默认：无值（不对输出应用限制）。

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限

对象

USAGE

dbt 项目对象

MONITOR

dbt 项目对象

OWNERSHIP

dbt 项目对象

使用说明

  • 该命令不需要正在运行的仓库即可执行。

  • 该命令仅返回当前用户的当前角色已获授至少一项访问权限的对象。

  • MANAGE GRANTS 访问权限隐式允许其持有者查看账户中的每个对象。默认情况下，只有账户管理员（具有 ACCOUNTADMIN 角色的用户）和安全管理员（具有 SECURITYADMIN 角色的用户）才具有 MANAGE GRANTS 权限。

  • 要对该命令的输出进行后处理，可以使用 管道运算符 (->>) 或 RESULT_SCAN 函数。这两种构造都将输出视为可以查询的结果集。

    例如，您可使用管道操作符或 RESULT_SCAN 函数，从 SHOW 命令输出中选择特定列或筛选行数据。

    引用输出列时，为列名使用 双引号标识符。例如，选择输出列 type，指定 SELECT "type"。

    必须使用双引号标识符，因为 SHOW 命令的输出列名均为小写格式。双引号确保 SELECT 列表或 WHERE 子句中的列名，与已扫描的 SHOW 命令输出中的列名完全匹配。

输出

命令输出在以下列中提供有关 dbt 项目版本的表属性和元数据：

列

描述

created_on

创建 dbt 项目对象的日期和时间。

name

dbt 项目版本的自动分配名称。例如 VERSION$1。

alias

您分配的 dbt 项目的别名（例如 ALTER DBT PROJECT <name> ADD VERSION <alias> FROM ...）。如果未指定，则为 Null。

location_uri

dbt 项目版本的完整 URL。

is_default

如果 dbt 项目对象的默认版本指向此版本，则为 TRUE。

is_live

如果 dbt 项目版本是列表的实时版本，则为 TRUE。

is_first

如果 dbt 项目是第一个版本，则为 TRUE。

is_last

如果 dbt 项目是最后一个版本，则为 TRUE。

comment

为 dbt 项目设置的注释。

source_location_uri

创建此 dbt 项目版本的源位置 URI。

git_commit_hash

git 提交哈希（如果 dbt 项目版本是从 git 源创建）。

示例

显示 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            |
+---------------------------------+-----------+------------------------------+-----------------------------------------------+------------+--------------------+---------+---------+---------------------+-----------------+
语言: 中文