Ubah versi model - MaxCompute

Topik ini menjelaskan cara mengubah model MaxCompute dan versinya.

Ikhtisar fitur

Tipe	Fitur	Role	Titik masuk
Tambahkan versi model	Tambahkan versi baru ke model MaxCompute yang sudah ada.	Pengguna yang memiliki izin ALTER pada model tersebut.	Jalankan perintah dalam topik ini di platform berikut: Gunakan klien MaxCompute Terhubung menggunakan analisis SQL Terhubung menggunakan Cloud Shell (odpscmd) Terhubung menggunakan DataWorks
Hapus versi model	Hapus versi tertentu dari model MaxCompute yang sudah ada.
Tetapkan versi model default	Ubah versi default dari model MaxCompute yang sudah ada.

Lingkup

Sebelum mengubah model atau versi model, pastikan objek model MaxCompute telah dibuat di Proyek. Untuk informasi selengkapnya, lihat Buat dan hapus model.

Model publik MaxCompute berada di proyek publik di bawah akun sistem MaxCompute. Anda tidak dapat mengubah informasi versi model publik. Untuk daftar model publik dan informasi cara menggunakannya, lihat Model MaxCompute.

Tambahkan versi model

Anda dapat menambahkan versi baru ke model MaxCompute yang sudah ada.

Format perintah

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>];

Deskripsi parameter

Parameter umum

Parameter	Wajib	Deskripsi	Catatan
model_name	Ya	Nama model	Nama model yang sudah ada yang akan diubah. Jika model tidak ada, error akan dilaporkan.
version_name	Ya	Nama versi model baru.	Nama tidak membedakan huruf besar/kecil. Hanya boleh berisi huruf (a-z, A-Z), angka, dan garis bawah (_). Disarankan untuk memulai nama dengan huruf. Panjang nama maksimal 256 byte. Anda tidak dapat menetapkan nama versi menjadi default_version.
input_col_name	Tidak	Nama kolom input versi model.	Nama kolom tidak membedakan huruf besar/kecil. Hanya boleh berisi huruf (a-z, A-Z), angka, garis bawah (_), atau karakter Tionghoa. Disarankan untuk memulai nama dengan huruf. Panjang nama maksimal 128 byte. Jika tidak, error akan dilaporkan. Anda dapat menentukan nama kolom input dan jumlah kolom yang berbeda untuk versi berbeda dari model yang sama. Catatan: Parameter ini wajib jika tipe sumber model adalah model impor.
input_date_type	Tidak	Tipe data kolom input untuk versi model.	Mendukung berbagai tipe data, seperti BIGINT, DOUBLE, STRING, dan BINARY. Untuk informasi selengkapnya, lihat Versi tipe data. Anda dapat menentukan tipe kolom input yang berbeda untuk versi berbeda dari model yang sama. Catatan: Parameter ini wajib jika tipe sumber model adalah model impor.
model_source_type	Tidak	Tipe sumber model.	Parameter ini opsional. Jika Anda menentukan parameter ini, nilai model_source_type harus sama untuk semua versi model. Jika tidak, error akan dilaporkan. IMPORT: model impor REMOTE: model remote
model_type	Tidak	Tipe model.	Parameter ini opsional. Jika Anda menentukan parameter ini, nilai model_type harus sama untuk semua versi model. Jika tidak, error akan dilaporkan. Jika sumber model adalah model impor, nilai yang valid adalah: BOOSTED_TREE_REGRESSOR: model regresi XGBoost BOOSTED_TREE_CLASSIFIER: model klasifikasi XGBoost Jika sumber model adalah model remote, nilai yang valid adalah: LLM: large language model MLLM: multimodal large language model
comment	Tidak	Komentar untuk versi model baru.	Komentar harus berupa string yang valid dengan panjang maksimal 1024 byte. Jika tidak, error akan dilaporkan.

Parameter model impor

Parameter

Wajib

Deskripsi

Catatan

location

Jalur OSS file model.

Menentukan jalur file model yang akan diimpor dari Object Storage Service (OSS). Hanya mendukung titik akhir jaringan internal OSS. Contoh: LOCATION = 'oss://oss-cn-shanghai-internal.aliyuncs.com/test-mode-bucket/'

rolearn

Peran RAM untuk autentikasi akses OSS.

Menentukan informasi autentikasi Peran RAM yang digunakan untuk mengakses file model di jalur OSS. Contoh: ROLEARN = 'acs:ram::139******728:role/aliyunodpsdefaultrole'.

Sebelum menggunakan parameter ini, pastikan izin yang diperlukan untuk data OSS telah diberikan kepada akun akses MaxCompute.

Anda dapat klik di sini untuk menyelesaikan otorisasi satu klik. Secara default, izin AliyunODPSDefaultRole diberikan.
Buat role kustom. Untuk informasi selengkapnya, lihat Otorisasi dalam mode STS untuk OSS.

Parameter model remote

Parameter	Wajib	Deskripsi	Catatan
tasks	Ya	Tipe task.	Nilai yang valid: text-generation chat sentence-embedding
pai_eas_model_name	Ya	Nama model yang dideploy di PAI EAS.	Anda dapat melihat model dan nama layanan yang dideploy di Konsol PAI EAS serta mendapatkan informasi titik akhir dan token yang sesuai di halaman informasi pemanggilan.
pai_eas_service_name	Ya	Nama layanan model PAI EAS. Catatan Jika layanan EAS ditambahkan ke kelompok layanan, Anda harus menentukan nama layanan dalam format `GroupName.ServiceName`, misalnya `group.service_name`. Jika layanan tidak ditambahkan ke kelompok layanan, cukup tentukan nama layanan EAS saja.
endpoint	Ya	Titik akhir layanan PAI EAS. Contoh: http://1*************70.cn-shanghai.pai-eas.aliyuncs.com Catatan: Versi saat ini hanya mendukung titik akhir publik EAS. Sebelum memanggil fungsi AI, Anda harus menambahkan titik akhir ke daftar alamat jaringan eksternal yang diizinkan untuk MaxCompute. Untuk informasi konfigurasi, lihat Edit alamat jaringan eksternal melalui manajemen proyek.
apikey	Ya	Token layanan PAI EAS.
pai_eas_sync_mode	Ya	Mode pemrosesan permintaan oleh layanan.	Hanya `true` yang didukung, yang menunjukkan mode sinkron.
pai_eas_sync_request_timeout	Tidak	Periode timeout untuk permintaan sinkron.	Unit: milidetik. Nilai default: 5000. Rentang nilai: 5000 hingga 1800000.

Contoh

Contoh 1: Tambahkan versi bernama v2 ke model remote PAI_EAS_Qwen25_Omni_3B yang sudah ada. Parameter INPUT ditentukan sebagai URL citra bertipe string, sehingga model dapat melakukan task gambar-ke-teks. Untuk contoh lengkap, lihat Gunakan model remote MaxCompute untuk menghasilkan deskripsi produk E-dagang secara otomatis.

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";

Contoh 2: Tambahkan versi bernama v2 ke model test_xgboost_classifier yang sudah ada.

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';

Tetapkan versi model default

Anda dapat menetapkan versi default dari model MaxCompute yang sudah ada.

Format perintah

ALTER MODEL <model_name> SET DEFAULT_VERSION <version_name>;

Deskripsi parameter

model_name: Wajib. Nama model yang sudah ada. Error akan dikembalikan jika model tidak ada.
version_name: Wajib. Nama versi model yang sudah ada yang ingin Anda tetapkan sebagai versi default. Error akan dikembalikan jika versi yang ditentukan tidak ada.

Contoh

-- Lihat informasi versi default model. Versi default adalah v1, dan kolom parameter input yang didukung bertipe 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

-- Ubah versi default model menjadi v2.
ALTER MODEL PAI_EAS_Qwen25_Omni_3B SET DEFAULT_VERSION v2;

-- Lihat informasi versi default model. Versi default diubah menjadi v2, dan kolom parameter input yang didukung bertipe 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     |                                                     |
+------------------------------------------------------------------------------------+

Hapus versi model

Anda dapat menghapus versi tertentu dari model MaxCompute yang sudah ada.

Catatan

Anda tidak dapat menghapus versi default model. Untuk menghapus versi default saat ini, Anda harus terlebih dahulu menetapkan versi lain sebagai default.

Format perintah

ALTER MODEL <model_name> DROP VERSION <version_name>;

Deskripsi parameter

model_name: Wajib. Nama model yang sudah ada. Error akan dikembalikan jika model tidak ada.
version_name: Wajib. Nama versi model yang ingin Anda hapus. Error akan dikembalikan jika versi tidak ada.

Contoh

-- Jika versi default model saat ini adalah v2, error akan dilaporkan saat Anda mencoba menghapus versi ini.
ALTER MODEL PAI_EAS_Qwen25_Omni_3B DROP VERSION v2;
-- Error berikut dikembalikan: FAILED: ODPS-0110061: Failed to run ddltask - The default version of the model cannot be dropped

-- Contoh yang benar: Pertama, ubah versi default model menjadi v1, lalu hapus versi v2.
ALTER MODEL PAI_EAS_Qwen25_Omni_3B SET DEFAULT_VERSION v1;
-- OK

ALTER MODEL PAI_EAS_Qwen25_Omni_3B DROP VERSION v2;
-- OK