Modifique uma versão de modelo - MaxCompute: Central de Documentação do Alibaba Cloud

Pré-requisitos

Antes de começar, verifique se:

Já existe um objeto de modelo do MaxCompute no projeto. Consulte Crie e exclua um modelo.
Você tem a permissão ALTER no modelo.

Modelos públicos residem em projetos públicos sob a conta do sistema MaxCompute. Não é possível modifique informações de versão de modelos públicos. Para obter uma lista de modelos públicos, consulte Modelos do MaxCompute .

Plataformas compatíveis

Execute os comandos deste tópico em qualquer uma das plataformas a seguir:

Adicionar uma versão de modelo

Adicione uma nova versão a um modelo existente do MaxCompute. Cada versão pode ter suas próprias definições de colunas de entrada e configurações específicas da origem.

Sintaxe

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

Parâmetros

Parâmetros gerais

Parâmetro	Obrigatório	Descrição
`model_name`	Sim	Nome do modelo existente a modifique. O sistema retornará um erro caso o modelo não exista.
`version_name`	Sim	Nome da nova versão do modelo. Não diferencia maiúsculas de minúsculas; aceita letras (a-z, A-Z), dígitos e sublinhados (_). Deve começar com uma letra. Máximo de 256 bytes. Não pode ser `default_version`.
`input_col_name`	Não (obrigatório para modelos importados)	Nome da coluna de entrada da versão do modelo. Não diferencia maiúsculas de minúsculas; aceita letras, dígitos, sublinhados ou caracteres chineses. Deve começar com uma letra. Máximo de 128 bytes. Versões diferentes do mesmo modelo podem ter nomes e quantidades de colunas distintos.
`input_data_type`	Não (obrigatório para modelos importados)	Tipo de dados da coluna de entrada. Tipos compatíveis: BIGINT, DOUBLE, STRING, BINARY. Para a lista completa, consulte Versões de tipos de dados. Versões diferentes do mesmo modelo podem ter tipos de colunas distintos.
`model_source_type`	Não	Tipo de origem do modelo. Se especificado, deve ser igual em todas as versões do modelo. O sistema retornará um erro caso as versões apresentem valores inconsistentes. Valores válidos: `IMPORT` (modelo importado), `REMOTE` (modelo remoto).
`model_type`	Não	Tipo de modelo. Se especificado, deve ser igual em todas as versões do modelo. O sistema retornará um erro caso as versões apresentem valores inconsistentes. Para modelos importados: `BOOSTED_TREE_REGRESSOR` (regressão XGBoost), `BOOSTED_TREE_CLASSIFIER` (classificação XGBoost). Para modelos remotos: `LLM` (modelo grande de linguagem), `MLLM` (modelo grande de linguagem multimodal).
`comment`	Não	Comentário da nova versão do modelo. Máximo de 1.024 bytes.

Parâmetros de modelo importado

Use estes parâmetros quando MODEL_SOURCE_TYPE = 'IMPORT'.

Parâmetro	Obrigatório	Descrição
`location`	Sim	Caminho OSS do arquivo de modelo. Apenas endpoints de rede interna do OSS são compatíveis. Exemplo: `LOCATION = 'oss://oss-cn-shanghai-internal.aliyuncs.com/test-mode-bucket/'`
`rolearn`	Sim	ARN da função RAM para autenticar o acesso ao arquivo de modelo no OSS. Exemplo: `ROLEARN = 'acs:ram::139******728:role/aliyunodpsdefaultrole'`. Para conceder à conta de acesso do MaxCompute as permissões necessárias no OSS, use a autorização com um clique (concede a permissão AliyunODPSDefaultRole por padrão) ou crie uma função personalizada.

Parâmetros de modelo remoto

Use estes parâmetros quando MODEL_SOURCE_TYPE = 'REMOTE'.

Parâmetro	Obrigatório	Descrição
`tasks`	Sim	Tipo de tarefa. Valores válidos: `text-generation`, `chat`, `sentence-embedding`.
`pai_eas_model_name`	Sim	Nome do modelo implantado no PAI EAS. Visualize o nome do modelo e o nome do serviço no console do PAI EAS.
`pai_eas_service_name`	Sim	Nome do serviço de modelo do PAI EAS. Se o serviço EAS pertencer a um grupo de serviços, use o formato `GroupName.ServiceName` (por exemplo, `group.service_name`). Caso contrário, especifique apenas o nome do serviço EAS.
`endpoint`	Sim	Endpoint do serviço PAI EAS. Exemplo: `http://1**************70.cn-shanghai.pai-eas.aliyuncs.com`. Atualmente, apenas endpoints públicos são compatíveis. Antes de chamar a função de IA, adicione o endpoint aos endereços de rede externa permitidos para o MaxCompute. Consulte Edite endereços de rede externa pelo gerenciamento de projetos.
`apikey`	Sim	Token do serviço PAI EAS. Visualize o token na página de informações de invocação no console do PAI EAS.
`pai_eas_sync_mode`	Sim	Modo de processamento de solicitações. Apenas `true` é compatível (modo síncrono).
`pai_eas_sync_request_timeout`	Não	Tempo limite para solicitações síncronas, em milissegundos. Padrão: 5000. Intervalo: 5000–1800000.

Exemplos

Exemplo 1: Adicione a versão v2 ao modelo remoto PAI_EAS_Qwen25_Omni_3B. A entrada é uma url de imagem do tipo string, permitindo que o modelo execute tarefas de conversão de imagem para texto. Para um exemplo completo de ponta a ponta, consulte Usar um modelo remoto do MaxCompute para gerar automaticamente descrições de produtos de e-commerce.

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

Exemplo 2: Adicione a versão V2 ao modelo importado test_xgboost_classifier.

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

Defina a versão padrão do modelo

Altere a versão que o MaxCompute considera como padrão para um modelo.

Sintaxe

ALTER MODEL <model_name> SET DEFAULT_VERSION <version_name>;

Parâmetros

Parâmetro	Obrigatório	Descrição
`model_name`	Sim	Nome de um modelo existente. O sistema retornará um erro caso o modelo não exista.
`version_name`	Sim	Nome de uma versão existente do modelo a defina como padrão. O sistema retornará um erro caso a versão não exista.

Exemplo

O exemplo a seguir verifica a versão padrão atual de PAI_EAS_Qwen25_Omni_3B (v1), altera para v2 e confirma a mudança.

-- Check the current default version. Default version is v1, with BINARY input.
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     |                                                     |
+------------------------------------------------------------------------------------+

-- Change the default version to v2.
ALTER MODEL PAI_EAS_Qwen25_Omni_3B SET DEFAULT_VERSION v2;
-- OK

-- Verify: default version is now v2, with STRING input.
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     |                                                     |
+------------------------------------------------------------------------------------+

Exclua uma versão de modelo

Remova uma versão específica de um modelo existente do MaxCompute.

Nota

Não é possível exclua a versão padrão de um modelo. Para exclua a versão padrão atual, primeiro defina outra versão como padrão usando ALTER MODEL <model_name> SET DEFAULT_VERSION <version_name> e, em seguida, exclua a versão antiga.

Sintaxe

ALTER MODEL <model_name> DROP VERSION <version_name>;

Parâmetros

Parâmetro	Obrigatório	Descrição
`model_name`	Sim	Nome de um modelo existente. O sistema retornará um erro caso o modelo não exista.
`version_name`	Sim	Nome da versão do modelo a exclua. O sistema retornará um erro caso a versão não exista.

Exemplo

-- Attempting to delete v2 while it is the default version returns an error.
ALTER MODEL PAI_EAS_Qwen25_Omni_3B DROP VERSION v2;
-- Error: ODPS-0110061: Failed to run ddltask - The default version of the model cannot be dropped

-- First set another version as the default, then delete v2.
ALTER MODEL PAI_EAS_Qwen25_Omni_3B SET DEFAULT_VERSION v1;
-- OK

ALTER MODEL PAI_EAS_Qwen25_Omni_3B DROP VERSION v2;
-- OK

Próximos passos

Modelos do MaxCompute — navegue pelos modelos públicos disponíveis no MaxCompute
Crie e exclua um modelo — crie um novo objeto de modelo ou exclua um existente
Usar um modelo remoto do MaxCompute para gerar automaticamente descrições de produtos de e-commerce — exemplo de ponta a ponta usando versões de modelos remotos