

 Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 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 )
```

## Parameters
<a name="r_SHOW_MODEL-parameters"></a>

ALL   
傳回使用者可以使用的所有模型及其結構描述。

 *model\_name*   
模型的名稱。結構描述中的模型名稱必須是唯一的。

## 使用須知
<a name="r_SHOW_MODEL_usage_notes"></a>

SHOW MODEL 會傳回下列結果：
+ 模型名稱。
+ 建立模型所在的結構描述。
+ 模型的擁有者。
+ 模型建立時間。
+ 模型的狀態，例如 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 也會顯示所提供超參數及其值的清單。

您還可以在其他目錄資料表中檢視由 SHOW MODEL 提供的一些資訊，例如 pg\_proc。Amazon Redshift 會傳回 pg\_proc 目錄資料表中註冊的預測函數相關資訊。此資訊包括用於預測函數的輸入引數名稱及其類型。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\_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
```