显示模型 - Amazon Redshift
语法参数使用说明示例
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

显示模型

这是 Amazon Redshift 的机器学习功能的预发布文档，目前为预览版。文档和功能均可能随时更改。我们建议您只在测试集群中使用此功能，而不要在生产环境中使用。有关预览版条款和条件，请参阅 AWS 服务条款中的Beta 服务参与。

显示有关Machine Learning模型的有用信息，包括其状态、用于创建它的参数以及预测函数及其输入参数类型。您可以使用 SHOW MODEL 中的信息重新创建模型。如果基表已更改，则使用相同的 SQL 语句运行 CREATE MODEL 会导致不同的模型。SHOW MODEL 返回的信息对于模型所有者和具有 EXECUTE 权限的用户是不同的。

Syntax

SHOW MODEL ( ALL | model_name )

Parameters

ALL

返回用户可以使用的所有模型及其架构。

模型名称

模型的名称。架构中的模型名称必须是唯一的。

使用说明

SHOW MODEL 命令返回以下内容：

  • 模型名称。

  • 在其中创建模型的架构。

  • 模型的拥有者。

  • 模型创建时间。

  • 模型的状态，例如 READY、TRAINING 或 UnDER REFRESH。

  • 验证错误（如果模型已完成训练）。

  • 派生模型所需的估算成本。只有模型的拥有者才能查看此信息。

  • 指定的 TARGET 列。

  • 指定参数及其值的列表，具体如下：

    • 模型类型：AUTO 或 XGBoost。

    • 问题类型，例如 REGRESSION、BINARY_CLASSIFICATION、MULTCLASS_CLASSIFICATION。此参数特定于 AUTO。

    • 目标，如 MSE、F1，准确性。此参数特定于 AUTO。

    • 创建的函数的名称。

    • 预测函数的输入参数。

    • 预测函数输入参数类型。

    • IAM 角色。只有模型的拥有者才能看到此内容。

    • 使用的 S3 存储桶。只有模型的拥有者才能看到此内容。

    • KMS 密钥 （如果已提供）。只有模型的拥有者才能看到此内容。

    • 模型可以运行的最长时间。

  • 如果模型类型不是 AUTO，则 Amazon Redshift 还会显示提供的超参数列表及其值。

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

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

Examples

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

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