本文主要介紹MaxCompute模型及模型版本的相關修改操作。
功能概覽
類型 | 功能 | 角色 | 操作入口 |
增加模型版本 | 為已存在的MaxCompute模型新增版本。 | 具備修改模型許可權（ALTER）的使用者。 | 本文中的命令可以在如下工具平台執行： |
刪除模型版本 | 為已存在的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 | 是 | 新增的模型版本名稱 |
|
input_col_name | 否 | 模型版本的輸入列名 |
注意：當模型來源類型為匯入模型時，必填 |
input_date_type | 否 | 模型版本的輸入列的資料類型 |
注意：當模型來源類型為匯入模型時，必填 |
model_source_type | 否 | 模型來源類型 | 非必填，如果填寫，同一個模型的各個版本model_source_type 取值需保持一致，否則會報錯
|
model_type | 否 | 模型類型 | 非必填。如果填寫，同一個模型的各個版本model_type 取值需保持一致，否則會報錯 當模型來源為匯入模型時，支援取值：
當模型來源為遠程模型時，支援取值：
|
comment | 否 | 新增模型版本的注釋資訊 | 注釋內容為長度不超過1024位元組的有效字串，否則報錯。 |
匯入模型參數
參數 | 是否必填 | 說明 | 備忘 |
location | 是 | 模型檔案的OSS路徑 | 指定要匯入的模型檔案在OSSObject Storage Service的路徑資訊。僅支援OSS內網地址，例如 |
rolearn | 是 | OSS訪問認證角色 | 指定訪問儲存模型檔案的OSS路徑的RAM角色認證資訊，例如 使用前，請確保已將OSS的資料相關許可權賦予MaxCompute的訪問帳號。
|
遠程模型參數
參數 | 是否必填 | 說明 | 備忘 |
tasks | 是 | 任務類型 | 支援取值如下：
|
pai_eas_model_name | 是 | PAI EAS部署的模型名稱 | 可通過PAI EAS控制台，查看已部署模型及服務名稱，並在調用資訊頁面擷取對應方位地址和Token資訊 |
pai_eas_service_name | 是 | PAI EAS模型服務名稱 說明 若該EAS服務已加入某個服務群組，則此處需要填寫“群組名稱.服務名稱”，如group.service_name；若未加入服務群組，則僅需要填寫EAS服務名稱 | |
endpoint | 是 | PAI EAS 服務的訪問地址 例如：http://1*************70.cn-shanghai.pai-eas.aliyuncs.com 說明：目前的版本僅支援EAS公網調用地址，在AI Function調用前，需將該地址設定為可用的MaxCompute外部網路地址，配置方案見：通過專案管理編輯外部網路地址 | |
apikey | 是 | PAI EAS 服務Token | |
pai_eas_sync_mode | 是 | 控制服務處理請求的模式 | 僅支援true，表示同步模式 |
pai_eas_sync_request_timeout | 否 | 同步請求的逾時時間 | 單位為毫秒，預設值為5000，範圍5000-1800000。 |
使用樣本
樣本1：為已建立的遠程模型PAI_EAS_Qwen25_Omni_3B增加v2版本，指定模型可接受的INPUT輸入參數（STRING類型圖片URL），用於執行圖生文任務，完整樣本請參考使用MaxCompute遠程模型自動產生電商選品描述。
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：必填。指定已有模型版本名稱，將其設定為模型的預設版本(DEFAULT_VERSION)，若不存在則報錯。
使用樣本
-- 查看模型的預設版本資訊，此時模型的預設版本為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