SHOW MODEL - Amazon Redshift
语法参数使用说明示例

SHOW MODEL

显示有关机器学习模型的有用信息，包括其状态、用于创建模型的参数以及具有输入参数类型的预测函数。可以使用 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 训练工作或创建模型的 Amazon SageMaker Autopilot 任务的名称。您可以使用此任务名称在 Amazon SageMaker 上查找有关该模型的更多信息。

    • 目标，如 MSE、F1、精度。此参数特定于 AUTO。

    • 所创建的函数的名称。

    • 推理的类型，本地或远程。

    • 预测函数输入参数。

    • 非自带模型 (BYOM) 的预测函数输入参数类型。

    • 预测函数的返回类型。此参数特定于 BYOM。

    • 具有远程推理功能的 BYOM 模型的 Amazon SageMaker 端点的名称。

    • 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