SHOW MODEL

聚焦模式

SHOW MODEL - Amazon Redshift

显示有关机器学习模型的有用信息，包括其状态、用于创建模型的参数以及具有输入参数类型的预测函数。可以使用 SHOW MODEL 中的信息重新创建模型。如果基表已更改，则使用相同的 SQL 语句运行 CREATE MODEL 会导致生成不同的模型。SHOW MODEL 返回的信息对于模型拥有者和具有 EXECUTE 权限的用户而言是不同的。当模型从 Amazon Redshift 中进行训练或模型为 BYOM 模型时，SHOW MODEL 会显示不同的输出。

语法


SHOW MODEL ( ALL | model_name )

参数

ALL: 返回用户可以使用的所有模型及其 schema。
model_name: 模型的名称。schema 中的模型名称必须是唯一的。

使用说明

SHOW MODEL 命令将返回以下内容：

模型名称。
创建模型所在的 schema。
模型的拥有者。
模型创建时间。
模型的状态，如 READY、TRAINING 或 FAILED。
模型失败的原因消息。
如果模型已完成训练，则会出现验证错误。
为非 BYOM 方法派生模型所需的估计成本。只有模型的拥有者可查看此信息。
用户指定的参数及其值的列表，特别是以下内容：
- 指定的 TARGET 列。
- 模型类型，AUTO 或 XGBoost。
- 问题类型，例如 REGRESSION、BINARY_CLASSIFICATION、MULTICLASS_CLASSIFICATION。此参数特定于 AUTO。
- Amazon SageMaker AI 训练作业或创建模型的 Amazon SageMaker AI Autopilot 作业的名称。您可以使用此作业名称在 Amazon SageMaker AI 上查找有关该模型的更多信息。
- 目标，如 MSE、F1、精度。此参数特定于 AUTO。
- 所创建的函数的名称。
- 推理的类型，本地或远程。
- 预测函数输入参数。
- 非自带模型 (BYOM) 的预测函数输入参数类型。
- 预测函数的返回类型。此参数特定于 BYOM。
- 具有远程推理功能的 BYOM 模型的 Amazon SageMaker AI 端点的名称。
- IAM 角色。只有模型的拥有者可以看到此内容。
- 所用的 S3 桶。只有模型的拥有者可以看到此内容。
- AWS KMS 键（如果提供了一个）。只有模型的拥有者可以看到此内容。
- 模型可以运行的最长时间。
如果模型类型不是 AUTO，则 Amazon Redshift 还会显示提供的超参数列表及其值。

您还可以在其他目录表（如 pg_proc）中查看 SHOW MODEL 提供的一些信息。Amazon Redshift 返回有关在 pg_proc 目录表中注册的预测函数的信息。此信息包括预测函数的输入参数名称及其类型。Amazon Redshift 会在 SHOW MODEL 命令中返回相同的信息。


SELECT * FROM pg_proc WHERE proname ILIKE '%<function_name>%';

示例

以下示例显示了显示模型输出。


SHOW MODEL ALL;

Schema Name |  Model Name
------------+---------------
 public     | customer_churn

customer_churn 的拥有者可查看以下输出。仅具有 EXECUTE 权限的用户无法看到 IAM 角色、Amazon S3 桶和模式的估计成本。


SHOW MODEL customer_churn;

       Key                 |           Value
---------------------------+-----------------------------------
 Model Name                | customer_churn
 Schema Name               | public
 Owner                     | 'owner'
 Creation Time             | Sat, 15.01.2000 14:45:20
 Model State               | READY
 validation:F1             | 0.855
 Estimated Cost            | 5.7
                           |
 TRAINING DATA:            |
 Table                     | customer_data
 Target Column             | CHURN
                           |
 PARAMETERS:               |
 Model Type                | auto
 Problem Type              | binary_classification
 Objective                 | f1
 Function Name             | predict_churn
 Function Parameters       | age zip average_daily_spend average_daily_cases
 Function Parameter Types  | int int float float
 IAM Role                  | 'iam_role'
 KMS Key                   | 'kms_key'
 Max Runtime               | 36000