SHOW MODELS¶

列出您有权访问的机器学习模型。

输出返回表元数据和属性，按数据库、架构和模型名称按字典顺序排序（有关输出列的说明，请参阅本主题中的输出）。如果您希望使用提供的筛选器筛选结果，请务必注意这一点。

语法¶

SHOW MODELS [ LIKE '<pattern>' ]
            [ IN { DATABASE [ <db_name> ] | SCHEMA [ <schema_name> ] } ]

Copy

LIKE 'pattern'

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

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

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

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

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

IN DATABASE [ db_name ] | SCHEMA [ schema_name ]

（可选）指定命令的范围，该范围确定命令是仅列出当前/指定数据库还是架构中的模型。

如果您指定关键字 ACCOUNT，则该命令将检索当前账户的所有数据库中所有架构的记录。

如果您指定关键字 DATABASE，那么：

如果指定 db_name，则该命令将检索指定数据库的所有架构的记录。
如果您未指定 db_name，那么：
- 如果存在当前数据库，则该命令将检索当前数据库中所有架构的记录。
- 如果当前没有数据库，则该命令将检索账户中所有数据库和架构的记录。

如果您指定关键字 SCHEMA，那么：

如果指定限定架构名称（例如，my_database.my_schema），则该命令将检索指定数据库和架构的记录。
如果您指定了未限定的 schema_name，那么：
- 如果存在当前数据库，则该命令将检索当前数据库中指定架构的记录。
- 如果当前没有数据库，则该命令会显示错误 SQL compilation error: Object does not exist, or operation cannot be performed。
如果您未指定 schema_name，那么：
- 如果当前有数据库，那么：
  - 如果当前存在架构，则该命令将检索当前数据库中当前架构的记录。
  - 如果不存在当前架构，则该命令将检索当前数据库中所有架构的记录。
- 如果当前没有数据库，则该命令将检索账户中所有数据库和所有架构的记录。

默认：取决于会话当前是否正在使用数据库：

命令输出在以下列中提供表属性和元数据：

列	描述
created_on	模型的创建日期和时间。
name	模型的名称。
model_type	模型的类型，包含用户代码的模型为 USER_MODEL，使用 Cortex Fine-tuning 创建的模型为 CORTEX_FINETUNED
database_name	存储模型的数据库。
schema_name	存储模型的架构。
owner	拥有模型的角色。
comment	为模型添加注释。
版本	JSON 数组列出模型的版本。
default_version_name	引用没有版本的模型时使用的模型的版本。
别名	相应的模型版本名称的 SQL 对象映射模型版本别名。

结果按数据库名称、架构名称和模型名称排序。这意味着数据库的结果可以包含来自多个架构的模型，并且可能会中断分页。为了使分页按预期工作，必须针对单个架构执行该 SHOW MODELS 语句。您可以使用该 SHOW MODELS 命令的 IN SCHEMA schema_name 参数。或者，您可以通过在执行 SHOW MODELS 语句之前执行 USE SCHEMA schema_name，然后在当前上下文中使用架构。

该命令不需要正在运行的仓库即可执行。
该命令仅返回当前用户的当前角色已获授至少一项访问权限的对象。
MANAGE GRANTS 访问权限隐式允许其持有者查看账户中的每个对象。默认情况下，只有账户管理员（具有 ACCOUNTADMIN 角色的用户）和安全管理员（具有 SECURITYADMIN 角色的用户）才具有 MANAGE GRANTS 权限。