モデルバージョンを変更する - MaxCompute - Alibaba Cloud ドキュメントセンター

このトピックでは、MaxCompute モデルとそのバージョンを変更する方法について説明します。

機能概要

タイプ	機能	ロール	エントリポイント
モデルバージョンの追加	既存の MaxCompute モデルに新しいバージョンを追加します。	モデルに対する ALTER 権限を持つユーザー。	このトピックのコマンドは、次のプラットフォームで実行します。 MaxCompute クライアントの使用 SQL 分析を使用した接続 Cloud Shell (odpscmd) を使用した接続 DataWorks を使用した接続
モデルバージョンの削除	既存の MaxCompute モデルの特定のバージョンを削除します。
デフォルトモデルバージョンの設定	既存の MaxCompute モデルのデフォルトバージョンを変更します。

適用範囲

モデルまたはモデルバージョンを変更する前に、MaxCompute モデルオブジェクトがプロジェクトに作成されていることを確認してください。詳細については、「モデルの作成と削除」をご参照ください。

MaxCompute のパブリックモデルは、MaxCompute システムアカウント配下のパブリックプロジェクトにあります。パブリックモデルのバージョン情報は変更できません。パブリックモデルのリストとその使用方法については、「MaxCompute モデル」をご参照ください。

モデルバージョンの追加

既存の MaxCompute モデルに新しいバージョンを追加できます。

コマンドのフォーマット

ALTER MODEL <model_name> ADD VERSION <version_name> 
[INPUT(<input_col_name> <input_data_type>, ... )]
WITH OPTIONS(
    [MODEL_SOURCE_TYPE = '<model_source_type>']
    [,MODEL_TYPE = '<model_type>']
    [,LOCATION = '<location>']  
    [,ROLEARN = '<rolearn>']  
    [,TASKS = '<tasks>']          
    [,PAI_EAS_MODEL_NAME = '<pai_eas_model_name>']   
    [,PAI_EAS_SERVICE_NAME = '<pai_eas_service_name>']
    [,ENDPOINT= '<endpoint>']               
    [,APIKEY = '<apikey>']               
    [,PAI_EAS_SYNC_MODE = 'true']
    [,PAI_EAS_SYNC_REQUEST_TIMEOUT = '5000'] 
)
[COMMENT <model_comment>];

パラメーターの説明

共通パラメーター

パラメーター	必須	説明	注意事項
model_name	はい	モデル名	変更する既存のモデルの名前。モデルが存在しない場合、エラーが報告されます。
version_name	はい	新しいモデルバージョンの名前。	名前では大文字と小文字は区別されません。英字 (a-z、A-Z)、数字、アンダースコア (_) のみを含めることができます。名前は英字で始めることを推奨します。名前の長さは最大 256 バイトです。バージョン名を default_version に設定することはできません。
input_col_name	いいえ	モデルバージョンの入力列名。	列名では大文字と小文字は区別されません。英字 (a-z、A-Z)、数字、アンダースコア (_)、または漢字のみを含めることができます。名前は英字で始めることを推奨します。名前の長さは最大 128 バイトです。それ以外の場合、エラーが報告されます。同じモデルの異なるバージョンに対して、異なる入力列名と列数を指定できます。注：このパラメーターは、モデルソースタイプがインポートされたモデルの場合に必須です。
input_date_type	いいえ	モデルバージョンの入力列のデータ型。	BIGINT、DOUBLE、STRING、BINARY などの複数のデータ型をサポートします。詳細については、「データ型バージョン」をご参照ください。同じモデルの異なるバージョンに対して、異なる入力列の型を指定できます。注：このパラメーターは、モデルソースタイプがインポートされたモデルの場合に必須です。
model_source_type	いいえ	モデルソースタイプ。	このパラメーターはオプションです。このパラメーターを指定する場合、model_source_type の値はモデルのすべてのバージョンで同じでなければなりません。それ以外の場合、エラーが報告されます。 IMPORT：インポートされたモデル REMOTE：リモートモデル
model_type	いいえ	モデルタイプ。	このパラメーターはオプションです。このパラメーターを指定する場合、model_type の値はモデルのすべてのバージョンで同じでなければなりません。それ以外の場合、エラーが報告されます。モデルソースがインポートされたモデルの場合、有効な値は次のとおりです。 BOOSTED_TREE_REGRESSOR：XGBoost 回帰モデル BOOSTED_TREE_CLASSIFIER：XGBoost 分類モデルモデルソースがリモートモデルの場合、有効な値は次のとおりです。 LLM：大規模言語モデル MLLM：マルチモーダル大規模言語モデル
comment	いいえ	新しいモデルバージョンのコメント。	コメントは、長さが 1024 バイトまでの有効な文字列である必要があります。それ以外の場合、エラーが報告されます。

インポートされたモデルのパラメーター

パラメーター

必須

説明

注意事項

location

はい

モデルファイルの OSS パス。

Object Storage Service (OSS) からインポートするモデルファイルのパスを指定します。OSS 内部ネットワークエンドポイントのみがサポートされています。例：LOCATION = 'oss://oss-cn-shanghai-internal.aliyuncs.com/test-mode-bucket/'

rolearn

はい

OSS アクセス認証用の RAM ロール。

OSS パス内のモデルファイルにアクセスするために使用される RAM ロールの認証情報を指定します。例：ROLEARN = 'acs:ram::139******728:role/aliyunodpsdefaultrole'。

このパラメーターを使用する前に、OSS データに対する必要な権限が MaxCompute アクセスアカウントに付与されていることを確認してください。

ここをクリックしてワンクリック権限付与を完了します。デフォルトでは、AliyunODPSDefaultRole 権限が付与されます。
カスタムロールを作成します。詳細については、「OSS の STS モードでの権限付与」をご参照ください。

リモートモデルのパラメーター

パラメーター	必須	説明	注意事項
tasks	はい	タスクタイプ。	有効な値： text-generation chat sentence-embedding
pai_eas_model_name	はい	PAI-EAS にデプロイされたモデルの名前。	PAI-EAS コンソールでデプロイされたモデルとサービス名を表示し、呼び出し情報ページで対応するエンドポイントとトークン情報を取得できます。
pai_eas_service_name	はい	PAI-EAS モデルサービスの名前。説明 EAS サービスがサービスグループに追加されている場合は、`GroupName.ServiceName` の形式でサービス名を指定する必要があります (例：`group.service_name`)。サービスがサービスグループに追加されていない場合は、EAS サービス名のみを指定します。
endpoint	はい	PAI-EAS サービスのエンドポイント。例：http://1*************70.cn-shanghai.pai-eas.aliyuncs.com 注：現在のバージョンでは、EAS のパブリックエンドポイントのみがサポートされています。AI 関数を呼び出す前に、エンドポイントを MaxCompute の許可された外部ネットワークアドレスのリストに追加する必要があります。構成の詳細については、「プロジェクト管理による外部ネットワークアドレスの編集」をご参照ください。
apikey	はい	PAI-EAS サービスのトークン。
pai_eas_sync_mode	はい	サービスがリクエストを処理するモード。	`true` のみがサポートされており、同期モードを示します。
pai_eas_sync_request_timeout	いいえ	同期リクエストのタイムアウト期間。	単位：ミリ秒。デフォルト値：5000。値の範囲：5000～1800000。

例

例 1：既存のリモートモデル PAI_EAS_Qwen25_Omni_3B に v2 という名前のバージョンを追加します。INPUT パラメーターは文字列型の画像 URL として指定され、モデルが画像からテキストへのタスクを実行できるようにします。完全な例については、「MaxCompute リモートモデルを使用して E コマースの商品説明を自動生成する」をご参照ください。

ALTER MODEL PAI_EAS_Qwen25_Omni_3B ADD VERSION v2
INPUT(url STRING, promt STRING) 
WITH OPTIONS(
    TASKS = 'text-generation',
    PAI_EAS_MODEL_NAME = 'Qwen2.5-Omni-3B',
    PAI_EAS_SERVICE_NAME = 'test_remote_model', 
    ENDPOINT = 'http://11261230********.cn-shanghai.pai-eas.aliyuncs.com',
    APIKEY = '<apikey>', 
    PAI_EAS_SYNC_MODE = 'true'
)
COMMENT "PAI EAS remote model string-url input";

例 2：既存の test_xgboost_classifier モデルに v2 という名前のバージョンを追加します。

ALTER MODEL test_xgboost_classifier ADD VERSION V2 
INPUT (f1 int,f2 int,f3 int)
WITH OPTIONS(
  LOCATION = 'oss://oss-cn-shanghai.aliyuncs.com/model-bucket-test/xgboost_classifier_v2/',
  ROLEARN = 'acs:ram::11261230********:role/aliyunodpsdefaultrole'
)
COMMENT 'Import XGBoost model v2';

デフォルトモデルバージョンの設定

既存の MaxCompute モデルのデフォルトバージョンを設定できます。

コマンドのフォーマット

ALTER MODEL <model_name> SET DEFAULT_VERSION <version_name>;

パラメーターの説明

model_name：必須。既存のモデルの名前。モデルが存在しない場合、エラーが返されます。
version_name：必須。デフォルトバージョンとして設定したい既存のモデルバージョンの名前。指定されたバージョンが存在しない場合、エラーが返されます。

例

-- モデルのデフォルトバージョン情報を表示します。デフォルトバージョンは v1 で、サポートされている入力パラメーター列は BINARY 型です。
DESC MODEL PAI_EAS_Qwen25_Omni_3B;

+------------------------------------------------------------------------------------+
|                  Model Information                                                 |
+------------------------------------------------------------------------------------+
| Owner:                    ALIYUN$*********                             |
| Project:                  ****_demo                                                |
| Model Name:               pai_eas_qwen25_omni_3b                                   |
| Model Type:               MLLM                                                     |
| Source Type:              REMOTE                                                   |
| Default Version:          v1                                                       |
| CreateTime:               2025-10-09 18:32:48                                      |
| LastModifiedTime:         2025-10-10 16:38:41                                      |
| Comment:                  PAI EAS remote model binary input                        |
+------------------------------------------------------------------------------------+
|                Version Information                                                 |
+------------------------------------------------------------------------------------+
| Owner:                    ALIYUN$*********                             |
| Project:                  ****_demo                                                |
| Model Name:               pai_eas_qwen25_omni_3b                                   |
| Model Type:               MLLM                                                     |
| Source Type:              REMOTE                                                   |
| Version Name:             v1                                                       |
| Path:                                                                              |
| CreateTime:               2025-10-09 18:32:48                                      |
| LastModifiedTime:         2025-10-09 18:32:48                                      |
| APIKEY:                   ZjA5NGRjN2VjOTZiM********TZmZTQ1MThkMGE4ZmUyNj********== |
| ENDPOINT:                 http://11261230********.cn-shanghai.pai-eas.aliyuncs.com |
| PAI_EAS_MODEL_NAME:       Qwen2.5-Omni-3B                                          |
| PAI_EAS_SERVICE_NAME:     test_remote_model                                        |
| PAI_EAS_SYNC_MODE:        true                                                     |
| REMOTE_SERVICE_TYPE:      PAI-EAS                                                  |
+------------------------------------------------------------------------------------+
| Input           | Type       | Comment                                             |
+------------------------------------------------------------------------------------+
| data            | binary     |                                                     |
| promt           | string     |                                                     |
+------------------------------------------------------------------------------------+

OK

-- モデルのデフォルトバージョンを v2 に変更します。
ALTER MODEL PAI_EAS_Qwen25_Omni_3B SET DEFAULT_VERSION v2;

-- モデルのデフォルトバージョン情報を表示します。デフォルトバージョンは v2 に変更され、サポートされている入力パラメーター列は STRING 型です。
DESC MODEL PAI_EAS_Qwen25_Omni_3B;

+------------------------------------------------------------------------------------+
|                  Model Information                                                 |
+------------------------------------------------------------------------------------+
| Owner:                    ALIYUN$*********                                         |
| Project:                  muze_demo                                                |
| Model Name:               pai_eas_qwen25_omni_3b                                   |
| Model Type:               MLLM                                                     |
| Source Type:              REMOTE                                                   |
| Default Version:          v2                                                       |
| CreateTime:               2025-10-09 18:32:48                                      |
| LastModifiedTime:         2025-10-10 16:55:07                                      |
| Comment:                  PAI EAS remote model binary input                        |
+------------------------------------------------------------------------------------+
|                Version Information                                                 |
+------------------------------------------------------------------------------------+
| Owner:                    ALIYUN$*********                             |
| Project:                  *******_demo                                                |
| Model Name:               pai_eas_qwen25_omni_3b                                   |
| Model Type:               MLLM                                                     |
| Source Type:              REMOTE                                                   |
| Version Name:             v2                                                       |
| Path:                                                                              |
| CreateTime:               2025-10-10 16:53:51                                      |
| LastModifiedTime:         2025-10-10 16:53:51                                      |
| apikey:                   ZjA5NGRjN2Vj*********mU0OTZmZTQ1MTh***********jBhMmEzYw== |
| endpoint:                 http://11261230********.cn-shanghai.pai-eas.aliyuncs.com |
| pai_eas_model_name:       Qwen2.5-Omni-3B                                          |
| pai_eas_service_name:     test_remote_model                                        |
| pai_eas_sync_mode:        true                                                     |
| remote_service_type:      PAI-EAS                                                  |
+------------------------------------------------------------------------------------+
| Input           | Type       | Comment                                             |
+------------------------------------------------------------------------------------+
| url             | string     |                                                     |
| promt           | string     |                                                     |
+------------------------------------------------------------------------------------+

モデルバージョンの削除

既存の MaxCompute モデルの特定のバージョンを削除できます。

説明

モデルのデフォルトバージョンは削除できません。現在のデフォルトバージョンを削除するには、まず別のバージョンをデフォルトとして設定する必要があります。

コマンドのフォーマット

ALTER MODEL <model_name> DROP VERSION <version_name>;

パラメーターの説明

model_name：必須。既存のモデルの名前。モデルが存在しない場合、エラーが返されます。
version_name：必須。削除したいモデルバージョンの名前。バージョンが存在しない場合、エラーが返されます。

例

-- モデルの現在のデフォルトバージョンが v2 の場合、このバージョンを削除しようとするとエラーが報告されます。
ALTER MODEL PAI_EAS_Qwen25_Omni_3B DROP VERSION v2;
-- 次のエラーが返されます：FAILED: ODPS-0110061: Failed to run ddltask - The default version of the model cannot be dropped

-- 正しい例：まず、モデルのデフォルトバージョンを v1 に変更し、次にバージョン v2 を削除します。
ALTER MODEL PAI_EAS_Qwen25_Omni_3B SET DEFAULT_VERSION v1;
-- OK

ALTER MODEL PAI_EAS_Qwen25_Omni_3B DROP VERSION v2;
-- OK