DESCRIBE DBT PROJECT¶
描述 :doc:` dbt 项目对象 </user-guide/data-engineering/dbt-projects-on-snowflake>` 的属性。
DESCRIBE 可以缩写为 DESC。
语法¶
{ DESC | DESCRIBE } DBT PROJECT <name>
参数¶
name
指定要描述的 dbt 对象的标识符。
如果标识符包含空格或特殊字符,则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。
有关更多信息,请参阅 标识符要求。
输出¶
命令的输出包括以下列,它们描述了对象的属性和元数据:
列 |
描述 |
---|---|
|
dbt 项目对象的标识符(名称)。 |
|
用于创建 dbt 项目对象的角色。 |
|
与 dbt 项目对象相关的注释。 |
|
在 dbt 项目对象定义中指定的默认 dbt 命令行参数(如有)。 |
访问控制要求¶
权限 |
对象 |
---|---|
MONITOR |
dbt 项目 |
要对架构中的任何对象执行操作,需要对父数据库和架构具有 USAGE 权限。
有关创建具有指定权限集的自定义角色的说明,请参阅 创建自定义角色。
使用说明¶
To post-process the output of this command, you can use the pipe operator (
->>
) or the RESULT_SCAN function. Both constructs treat the output as a result set that you can query.此命令的输出列名称以小写形式生成。如果您通过管道运算符或 RESULT_SCAN 函数使用此命令的结果集,请在查询中对列名使用 加双引号的标识符,以确保它们与已扫描输出中的列名相匹配。例如,如果输出列的名称为
type
,则为标识符指定"type"
。
示例¶
以下示例描述了名为 my_dbt_project
的 dbt 项目对象:
DESCRIBE DBT PROJECT my_dbt_project;
+----------------+--------------+------------+--------------+
| name | owner | comment | default_args |
+----------------+--------------+------------+--------------+
| my_dbt_project | ACCOUNTADMIN | My comment | |
+----------------+--------------+------------+--------------+