SHOW MODELS

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

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

另请参阅：

CREATE MODEL、DROP MODEL、ALTER MODEL、SHOW VERSIONS IN MODEL

语法

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，则该命令将检索指定数据库的所有架构的记录。

  • If you don't specify a db_name, then:

    • 如果存在当前数据库，则该命令将检索当前数据库中所有架构的记录。

    • 如果当前没有数据库，则该命令将检索账户中所有数据库和架构的记录。

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

  • If you specify a qualified schema name (for example, my_database.my_schema), then the command retrieves records for the specified database and schema.

  • 如果您指定了未限定的 schema_name，那么：

    • 如果存在当前数据库，则该命令将检索当前数据库中指定架构的记录。

    • 如果当前没有数据库，则该命令会显示错误 SQL compilation error: Object does not exist, or operation cannot be performed。

  • If you don't specify a schema_name, then:

    • 如果当前有数据库，那么：

      • 如果当前存在架构，则该命令将检索当前数据库中当前架构的记录。

      • 如果不存在当前架构，则该命令将检索当前数据库中所有架构的记录。

    • 如果当前没有数据库，则该命令将检索账户中所有数据库和所有架构的记录。

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

  • 数据库：DATABASE 是默认值（即，该命令返回您有权在当前数据库中查看的模型）。

  • 无数据库：账户范围是默认值（即，该命令返回您在账户中有权查看的模型）。

输出

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

列

描述

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 权限。

  • 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.

    The output column names for this command are generated in lowercase. If you consume a result set from this command with the pipe operator or the RESULT_SCAN function, use double-quoted identifiers for the column names in the query to ensure that they match the column names in the output that was scanned. For example, if the name of an output column is type, then specify "type" for the identifier.

语言: 中文