

 从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

# SHOW MODEL
<a name="r_SHOW_MODEL"></a>

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

## 语法
<a name="r_SHOW_MODEL-synopsis"></a>

```
SHOW MODEL ( ALL | model_name )
```

## 参数
<a name="r_SHOW_MODEL-parameters"></a>

ALL   
返回用户可以使用的所有模型及其 schema。

 *model\$1name*   
模型的名称。schema 中的模型名称必须是唯一的。

## 使用说明
<a name="r_SHOW_MODEL_usage_notes"></a>

SHOW MODEL 命令将返回以下内容：
+ 模型名称。
+ 创建模型所在的 schema。
+ 模型的拥有者。
+ 模型创建时间。
+ 模型的状态，如 READY、TRAINING 或 FAILED。
+ 模型失败的原因消息。
+ 如果模型已完成训练，则会出现验证错误。
+ 为非 BYOM 方法派生模型所需的估计成本。只有模型的拥有者可查看此信息。
+ 用户指定的参数及其值的列表，特别是以下内容：
  + 指定的 TARGET 列。
  + 模型类型，AUTO 或 XGBoost。
  + 问题类型，例如 REGRESSION、BINARY\$1CLASSIFICATION、MULTICLASS\$1CLASSIFICATION。此参数特定于 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\$1proc）中查看 SHOW MODEL 提供的一些信息。Amazon Redshift 返回有关在 pg\$1proc 目录表中注册的预测函数的信息。此信息包括预测函数的输入参数名称及其类型。Amazon Redshift 会在 SHOW MODEL 命令中返回相同的信息。

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

## 示例
<a name="r_SHOW_MODEL-examples"></a>

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

```
SHOW MODEL ALL;

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

customer\$1churn 的拥有者可查看以下输出。仅具有 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
```