本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用案例

下列使用案例示範如何使用 CREATE MODEL 來滿足您的需求。

簡單 CREATE MODEL

下列摘要說明CREATEMODEL語法的基本選項。

簡單CREATEMODEL語法

CREATE MODEL model_name
FROM { table_name | ( select_query ) }
TARGET column_name
FUNCTION prediction_function_name
IAM_ROLE { default }
SETTINGS (
  S3_BUCKET 'amzn-s3-demo-bucket',
  [ MAX_CELLS integer ]
)

簡單CREATEMODEL參數

CREATE MODEL 使用使用者指南

接下來，除了 中所述的選項CREATEMODEL之外，您還可以找到 的選項描述簡單 CREATE MODEL。

根據預設， CREATE MODEL 會搜尋特定資料集的預先處理和模型的最佳組合。您可能需要模型的額外控制項目或對其引入其他領域知識 (例如問題類型或目標)。在客戶流失案例中，如果「客戶不活躍」的結果很少見，則 F1 目標通常高於準確度目標。因為高準確度模型可能會一直預測到「客戶很活躍」，此結果雖然具有高準確度，但商業價值很小。如需 F1 目標的相關資訊，請參閱 Amazon SageMaker API 參考 中的utoMLJob目標。

然後， 會CREATEMODEL遵循您在指定方面的建議，例如目標。同時， CREATEMODEL會自動探索最佳前置處理器和最佳超參數。

CREATE MODEL 使用使用者指南語法

CREATE MODEL 在您可以指定的各個方面以及 Amazon Redshift 自動探索的各個方面提供更多彈性。

CREATE MODEL model_name
FROM { table_name | ( select_statement ) }
TARGET column_name
FUNCTION function_name
IAM_ROLE { default }
[ MODEL_TYPE { XGBOOST | MLP | LINEAR_LEARNER} ]
[ PROBLEM_TYPE ( REGRESSION | BINARY_CLASSIFICATION | MULTICLASS_CLASSIFICATION ) ]
[ OBJECTIVE ( 'MSE' | 'Accuracy' | 'F1' | 'F1Macro' | 'AUC') ]
SETTINGS (
  S3_BUCKET 'amzn-s3-demo-bucket', |
  S3_GARBAGE_COLLECT { ON | OFF }, |
  KMS_KEY_ID 'kms_key_id', |
  MAX_CELLS integer, |
  MAX_RUNTIME integer (, ...)
)   

CREATE MODEL 使用使用者指南參數

Amazon Redshift 支援以下轉換：

Amazon Redshift ML 會儲存經過訓練的轉換，並在預測查詢中自動套用這些轉換。從模型產生預測時，您不需要指定這些轉換。

CREATE XGBoost 具有 的模型 AUTO OFF

與預設 AUTOOFFCREATEMODEL的目標大致不同CREATEMODEL。

身為進階使用者，其已知道您想要使用的模型類型，且超參數在訓練這些模型時要使用，您可以使用 CREATE MODEL 搭配 AUTOOFF來關閉前置處理器和超參數的CREATEMODEL自動探索。若要這樣做，您必須明確指定模型類型。XGBoost 當 AUTO 設為 時， 目前是唯一支援的模型類型OFF。您可以指定超參數。Amazon Redshift 會針對您指定的任何超參數使用預設值。

CREATE XGBoost 具有語法AUTOOFF的模型

CREATE MODEL model_name
FROM { table_name | (select_statement ) }
TARGET column_name
FUNCTION function_name
IAM_ROLE { default }
AUTO OFF
MODEL_TYPE XGBOOST
OBJECTIVE { 'reg:squarederror' | 'reg:squaredlogerror' | 'reg:logistic' |
            'reg:pseudohubererror' | 'reg:tweedie' | 'binary:logistic' | 'binary:hinge' |
            'multi:softmax' | 'rank:pairwise' | 'rank:ndcg' }
HYPERPARAMETERS DEFAULT EXCEPT (
    NUM_ROUND '10',
    ETA '0.2',
    NUM_CLASS '10',
    (, ...)
)
PREPROCESSORS 'none'
SETTINGS (
  S3_BUCKET 'amzn-s3-demo-bucket', |
  S3_GARBAGE_COLLECT { ON | OFF }, |
  KMS_KEY_ID 'kms_key_id', |
  MAX_CELLS integer, |
  MAX_RUNTIME integer (, ...)
)   

CREATE XGBoost 具有AUTOOFF參數的模型

下列範例會準備 的資料XGBoost。

DROP TABLE IF EXISTS abalone_xgb;

CREATE TABLE abalone_xgb (
length_val float,
diameter float,
height float,
whole_weight float,
shucked_weight float,
viscera_weight float,
shell_weight float,
rings int,
record_number int);

COPY abalone_xgb
FROM 's3://redshift-downloads/redshift-ml/abalone_xg/'
REGION 'us-east-1'
IAM_ROLE default
IGNOREHEADER 1 CSV;

下列範例會建立具有指定進階選項的XGBoost模型，例如 MODEL_OBJECTIVE、 TYPE和 PREPROCESSORS。

DROP MODEL abalone_xgboost_multi_predict_age;

CREATE MODEL abalone_xgboost_multi_predict_age
FROM ( SELECT length_val,
              diameter,
              height,
              whole_weight,
              shucked_weight,
              viscera_weight,
              shell_weight,
              rings
   FROM abalone_xgb WHERE record_number < 2500 )
TARGET rings FUNCTION ml_fn_abalone_xgboost_multi_predict_age
IAM_ROLE default
AUTO OFF
MODEL_TYPE XGBOOST
OBJECTIVE 'multi:softmax'
PREPROCESSORS 'none'
HYPERPARAMETERS DEFAULT EXCEPT (NUM_ROUND '100', NUM_CLASS '30')
SETTINGS (S3_BUCKET 'amzn-s3-demo-bucket');

下列範例會使用推論查詢來對記錄編號大於 2500 的魚預測年齡。其使用從上述命令中建立的函數 ml_fn_abalone_xgboost_multi_predict_age。

select ml_fn_abalone_xgboost_multi_predict_age(length_val,
                                                   diameter,
                                                   height,
                                                   whole_weight,
                                                   shucked_weight,
                                                   viscera_weight,
                                                   shell_weight)+1.5 as age
from abalone_xgb where record_number > 2500;

自備模型 （BYOM） - 本機推論

Amazon Redshift ML 支援使用自有模型 （BYOM） 進行本機推論。

下列摘要說明 CREATE MODEL 語法的選項BYOM。您可以在 Amazon Redshift 之外與 Amazon 搭配使用訓練的模型 SageMaker ，在 Amazon Redshift 本機進行資料庫內推論。

CREATE MODEL 本機推論的語法

下列說明本機推論的CREATEMODEL語法。

CREATE MODEL model_name
FROM ('job_name' | 's3_path' )
FUNCTION function_name ( data_type [, ...] )
RETURNS data_type
IAM_ROLE { default }
[ SETTINGS (
  S3_BUCKET 'amzn-s3-demo-bucket', | --required
  KMS_KEY_ID 'kms_string') --optional
];

Amazon Redshift 目前僅支援 的預先訓練 XGBoost、 MLP和 Linear Learner 模型BYOM。您可以使用此路徑，匯入直接在 Amazon 中訓練的 SageMaker Autopilot 和模型， SageMaker 以進行本機推論。

CREATE MODEL 本機推論的參數

CREATE MODEL 本機推論範例

下列範例會建立先前在 Amazon Redshift SageMaker之外在 Amazon 中訓練的模型。由於 Amazon Redshift ML 支援本機推論的模型類型，因此下列 會CREATEMODEL建立可在 Amazon Redshift 本機使用的函數。您可以提供 SageMaker 訓練任務名稱。

CREATE MODEL customer_churn
FROM 'training-job-customer-churn-v4'
FUNCTION customer_churn_predict (varchar, int, float, float)
RETURNS int
IAM_ROLE default
SETTINGS (S3_BUCKET 'amzn-s3-demo-bucket');

建立模型之後，您可以使用函數 customer_churn_predict 與指定的引數類型來進行預測。

使用您自己的模型 （BYOM） - 遠端推論

Amazon Redshift ML 也支援使用自有模型 （BYOM） 進行遠端推論。

下列摘要說明 CREATE MODEL 語法的選項BYOM。

CREATE MODEL 遠端推論的語法

下列說明遠端推論的CREATEMODEL語法。

CREATE MODEL model_name 
FUNCTION function_name ( data_type [, ...] )
RETURNS data_type
SAGEMAKER 'endpoint_name'[:'model_name']
IAM_ROLE { default | 'arn:aws:iam::<account-id>:role/<role-name>' }
[SETTINGS (MAX_BATCH_ROWS integer)];

CREATE MODEL 遠端推論的參數

當模型部署到 SageMaker 端點時， 會在 Amazon Redshift 中 SageMaker 建立模型的資訊。然後透過外部函數執行推斷。您可以使用 SHOWMODEL命令來檢視 Amazon Redshift 叢集上的模型資訊。

CREATE MODEL 適用於遠端推論用量備註

使用 CREATEMODEL進行遠端推論之前，請考慮下列事項：

CREATE MODEL 適用於遠端推論範例

下列範例會建立使用 SageMaker 端點進行預測的模型。確定端點正在執行以進行預測，並在CREATEMODEL命令中指定其名稱。

CREATE MODEL remote_customer_churn
FUNCTION remote_fn_customer_churn_predict (varchar, int, float, float)
RETURNS int
SAGEMAKER 'customer-churn-endpoint'
IAM_ROLE default;

下列範例會使用大型語言模型模型 （） 建立具有BYOM遠端推論的 LLM。LLMs 託管在 Amazon SageMaker Jumpstart 上接受並傳回application/json內容類型，且JSON每次調用都支援單一 。輸入和傳回的資料類型必須為 SUPER，且 MAX_BATCH_ROWS 必須設定為 1。

CREATE MODEL sample_super_data_model
FUNCTION sample_super_data_model_predict(super)
RETURNS super
SAGEMAKER 'sample_super_data_model_endpoint'
IAM_ROLE default
SETTINGS (MAX_BATCH_ROWS 1);

CREATE MODEL 使用 K-MEANS

Amazon Redshift 支援可將未標示資料分組的 K 平均值演算法。此演算法可解決您想在資料中探索分組的叢集問題。未分類的資料會根據其相似性和差異進行分組和分割。

CREATE MODEL 使用 K MEANS語法

CREATE MODEL model_name
FROM { table_name | ( select_statement ) }
FUNCTION function_name
IAM_ROLE { default | 'arn:aws:iam::<account-id>:role/<role-name>' }
AUTO OFF
MODEL_TYPE KMEANS
PREPROCESSORS 'string'
HYPERPARAMETERS DEFAULT EXCEPT ( K 'val' [, ...] )
SETTINGS (
  S3_BUCKET 'amzn-s3-demo-bucket',
  KMS_KEY_ID 'kms_string', |
    -- optional
  S3_GARBAGE_COLLECT on / off, |
    -- optional
  MAX_CELLS integer, |
    -- optional
  MAX_RUNTIME integer
    -- optional);

CREATE MODEL 使用 K 參數MEANS

下列範例會準備 K 平均值的資料。

CREATE MODEL customers_clusters
FROM customers
FUNCTION customers_cluster
IAM_ROLE default
AUTO OFF
MODEL_TYPE KMEANS
PREPROCESSORS '[
{
  "ColumnSet": [ "*" ],
  "Transformers": [ "NumericPassthrough" ]
}
]'
HYPERPARAMETERS DEFAULT EXCEPT ( K '5' )
SETTINGS (S3_BUCKET 'amzn-s3-demo-bucket');

select customer_id, customers_cluster(...) from customers;
customer_id | customers_cluster
--------------------
12345            1
12346            2
12347            4
12348            

CREATE MODEL 使用預測

Redshift ML 中的預測模型會使用 Amazon Forecast 來建立準確的時間序列預測。這樣做可讓您使用一段時間內的歷史資料來預測未來事件。Amazon Forecast 的常見使用案例包括使用零售產品資料來決定如何為庫存定價格、製造數量資料來預測要訂購多少項目，以及使用 Web 流量資料來預測 Web 伺服器可能接收的流量。

Amazon Forecast 的配額限制會在 Amazon Redshift 預測模型中強制執行。例如，預測的最大數量為 100，但可調整。捨棄預測模型不會自動刪除 Amazon Forecast 中的相關聯資源。如果您刪除 Redshift 叢集，所有相關聯的模型也會被刪除。

請注意，預測模型目前僅適用於下列區域：

CREATE MODEL 使用預測語法

CREATE [ OR REPLACE ] MODEL forecast_model_name 
FROM { table_name | ( select_query ) } 
TARGET column_name
IAM_ROLE { default | 'arn:aws:iam::<account-id>:role/<role-name>'} 
AUTO ON
MODEL_TYPE FORECAST
SETTINGS (
  S3_BUCKET 'amzn-s3-demo-bucket',
  HORIZON integer,
  FREQUENCY forecast_frequency
  [PERCENTILES '0.1', '0.5', '0.9']
  )

CREATE MODEL 使用預測參數

下列範例說明如何建立簡單預測模型。

CREATE MODEL forecast_example
FROM forecast_electricity_
TARGET target 
IAM_ROLE 'arn:aws:iam::<account-id>:role/<role-name>'
AUTO ON 
MODEL_TYPE FORECAST
SETTINGS (S3_BUCKET 'amzn-s3-demo-bucket',
          HORIZON 24,
          FREQUENCY 'H',
          PERCENTILES '0.25,0.50,0.75,mean',
          S3_GARBAGE_COLLECT OFF);

建立預測模型後，您可以使用預測資料建立新資料表。

CREATE TABLE forecast_model_results as SELECT Forecast(forecast_example)

然後，您可以查詢新資料表以取得預測。

SELECT * FROM forecast_model_results