SHOW ENTITIES IN DCM PROJECT¶

显示指定 DCM 项目当前管理的所有 Snowflake 对象。

它返回所有对象的完全限定名称的混合列表。要查看任何结果，用户需要对 DCM project 具有 READ 权限，并且对受管对象本身也具有 READ 权限。

备注

返回的结果不一定与最近一次部署的实体相匹配。已手动删除或从项目中分离的对象将不会在此列出。

该命令返回按创建日期排序的对象元数据和属性。

另请参阅：: CREATE DCM PROJECT、ALTER DCM PROJECT、DESCRIBE DCM PROJECT、DROP DCM PROJECT、EXECUTE DCM PROJECT、SHOW DCM PROJECTS

语法¶

SHOW ENTITIES IN DCM PROJECT <name> [ LIMIT <rows> ]

SHOW ENTITIES LIKE <pattern> IN DCM PROJECT <name>;

SHOW ENTITIES IN DCM PROJECT <name> STARTS WITH <prefix>;

SHOW ENTITIES IN DCM PROJECT <name> LIMIT <n> FROM <cursor>;

必填参数¶

IN DCM PROJECT name

指定包含要列出的部署的 DCM 项目的标识符。

如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

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

可选参数¶

LIMIT rows

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

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

LIKE 'pattern'

（可选）按对象名称筛选命令输出。筛选器使用不区分大小写的模式匹配，并支持 SQL 通配符（% 和 _）。

例如，以下模式返回相同的结果：

... LIKE '%testing%' ...

... LIKE '%TESTING%' ...

. 默认：无值（不对输出应用筛选）。

STARTS WITH 'name_string'

（可选）根据对象名称开头显示的字符筛选命令输出。该字符串必须放在单引号内并且区分大小写。

例如，以下字符串会返回不同的结果：

... STARTS WITH 'B' ...

... STARTS WITH 'b' ...

. 默认：无值（不对输出应用筛选）

LIMIT rows [ FROM 'name_string' ]

（可选）限制返回的最大行数，同时还对结果启用“分页”功能。返回的实际行数可能小于指定的限制。例如，现有对象的数量小于指定的限制。

可选的 FROM 'name_string' 分子句实际上会充当结果的“游标”。这样就可以提取对象名称与指定字符串匹配的第一行之后的指定行数：

该字符串必须放在单引号内并且区分大小写。
该字符串不必包含完整的对象名称；支持部分名称。

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

备注

对于支持 FROM 'name_string' 和 STARTS WITH 'name_string' 的 SHOW 子句，您可以将这两个子句组合在同一语句中。但是，两个条件都必须满足，否则它们相互抵消，不返回任何结果。

此外，对象按名称的字典顺序返回，因此 FROM 'name_string' 仅返回字典值高于 STARTS WITH 'name_string' 所返回行的行。

例如：

... STARTS WITH 'A' LIMIT ... FROM 'B' 不会返回任何结果。
... STARTS WITH 'B' LIMIT ... FROM 'A' 不会返回任何结果。
... STARTS WITH 'A' LIMIT ... FROM 'AB' 将返回结果（如果有任何行与输入字符串匹配）。

输出¶


列	描述
`CREATED_ON`	创建时间戳 (LTZ)
`NAME`	对象的完全限定名称 (FQN)，适用于 DESC
`OBJECT_TYPE`	对象类型
`OWNER`	拥有者角色，遵循按域的约定
`COMMENT`	用户指定的注释

访问控制要求¶

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


权限	对象
READ	DCM project 托管对象

对架构中的对象进行操作至少需要父数据库的一项权限和父架构的一项权限。

有关创建具有指定权限集的自定义角色的说明，请参阅创建自定义角色。

有关对安全对象执行 SQL 操作的相应角色和权限授予的一般信息，请参阅访问控制概述。

示例¶

显示 my_project DCM 项目中的所有实体：

SHOW ENTITIES IN DCM PROJECT my_project;

显示 my_project DCM 项目中以 my_ 开头的所有实体：

SHOW ENTITIES LIKE 'my_%' IN DCM PROJECT my_project;

显示 my_project DCM 项目中的所有动态表：

SHOW ENTITIES IN DCM PROJECT my_project
  ->> SELECT * FROM $1 WHERE "object_type" = 'DYNAMIC_TABLE';