Modifier une version de modèle - MaxCompute - Centre de documentation Alibaba Cloud

Prérequis

Avant de commencer, assurez-vous que :

Un objet de modèle MaxCompute existe déjà dans le projet. Consultez la rubrique Créer et supprimer un modèle.
Vous disposez de l'autorisation ALTER sur le modèle.

Les modèles publics sont hébergés dans des projets publics sous le compte système MaxCompute. Vous ne pouvez pas modifier les informations de version des modèles publics. Pour obtenir la liste des modèles publics, consultez la page Modèles MaxCompute .

Plates-formes prises en charge

Exécutez les commandes présentées dans cette rubrique sur l'une des plates-formes suivantes :

Ajouter une version de modèle

Ajoutez une nouvelle version à un modèle MaxCompute existant. Chaque version peut posséder ses propres définitions de colonnes d'entrée et sa configuration spécifique à la source.

Syntaxe

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

Paramètres

Paramètres généraux

Paramètre	Obligatoire	Description
`model_name`	Oui	Nom du modèle existant à modifier. Une erreur est renvoyée si le modèle n'existe pas.
`version_name`	Oui	Nom de la nouvelle version du modèle. Insensible à la casse ; peut contenir des lettres (a-z, A-Z), des chiffres et des traits de soulignement (_). Doit commencer par une lettre. Longueur maximale de 256 octets. Ne peut pas être `default_version`.
`input_col_name`	Non (obligatoire pour les modèles importés)	Nom de la colonne d'entrée pour la version du modèle. Insensible à la casse ; peut contenir des lettres, des chiffres, des traits de soulignement ou des caractères chinois. Doit commencer par une lettre. Longueur maximale de 128 octets. Différentes versions d'un même modèle peuvent avoir des noms de colonnes et des nombres de colonnes différents.
`input_data_type`	Non (obligatoire pour les modèles importés)	Type de données de la colonne d'entrée. Types pris en charge : BIGINT, DOUBLE, STRING, BINARY. Pour la liste complète, consultez la rubrique Versions des types de données. Différentes versions d'un même modèle peuvent avoir des types de colonnes différents.
`model_source_type`	Non	Type de source du modèle. Si ce paramètre est spécifié, il doit être identique pour toutes les versions du modèle ; une erreur est renvoyée en cas d'incohérence entre les versions. Valeurs valides : `IMPORT` (modèle importé), `REMOTE` (modèle distant).
`model_type`	Non	Type de modèle. Si ce paramètre est spécifié, il doit être identique pour toutes les versions du modèle ; une erreur est renvoyée en cas d'incohérence entre les versions. Pour les modèles importés : `BOOSTED_TREE_REGRESSOR` (régression XGBoost), `BOOSTED_TREE_CLASSIFIER` (classification XGBoost). Pour les modèles distants : `LLM` (grand modèle de langage), `MLLM` (grand modèle de langage multimodal).
`comment`	Non	Commentaire pour la nouvelle version du modèle. Longueur maximale de 1 024 octets.

Paramètres des modèles importés

Utilisez ces paramètres lorsque MODEL_SOURCE_TYPE = 'IMPORT'.

Paramètre	Obligatoire	Description
`location`	Oui	Chemin OSS du fichier de modèle. Seuls les endpoints de réseau interne OSS sont pris en charge. Exemple : `LOCATION = 'oss://oss-cn-shanghai-internal.aliyuncs.com/test-mode-bucket/'`
`rolearn`	Oui	ARN du rôle RAM pour authentifier l'accès au fichier de modèle dans OSS. Exemple : `ROLEARN = 'acs:ram::139******728:role/aliyunodpsdefaultrole'`. Pour accorder au compte d'accès MaxCompute les autorisations OSS requises, utilisez autorisation en un clic (accorde par défaut l'autorisation AliyunODPSDefaultRole) ou créez un rôle personnalisé.

Paramètres des modèles distants

Utilisez ces paramètres lorsque MODEL_SOURCE_TYPE = 'REMOTE'.

Paramètre	Obligatoire	Description
`tasks`	Oui	Type de tâche. Valeurs valides : `text-generation`, `chat`, `sentence-embedding`.
`pai_eas_model_name`	Oui	Nom du modèle déployé dans PAI EAS. Consultez le nom du modèle et le nom du service dans la console PAI EAS.
`pai_eas_service_name`	Oui	Nom du service de modèle PAI EAS. Si le service EAS appartient à un groupe de services, utilisez le format `GroupName.ServiceName` (par exemple, `group.service_name`). Sinon, spécifiez uniquement le nom du service EAS.
`endpoint`	Oui	Endpoint du service PAI EAS. Exemple : `http://1**************70.cn-shanghai.pai-eas.aliyuncs.com`. Seuls les endpoints publics sont actuellement pris en charge. Avant d'appeler la fonction d'IA, ajoutez l'endpoint aux adresses de réseau externe autorisées pour MaxCompute. Consultez la rubrique Modifier les adresses de réseau externe via la gestion de projet.
`apikey`	Oui	Jeton du service PAI EAS. Consultez le jeton sur la page d'informations d'invocation dans la console PAI EAS.
`pai_eas_sync_mode`	Oui	Mode de traitement des requêtes. Seule la valeur `true` (mode synchrone) est prise en charge.
`pai_eas_sync_request_timeout`	Non	Délai d'expiration des requêtes synchrones, en millisecondes. Valeur par défaut : 5000. Plage : 5000–1800000.

Exemples

Exemple 1 : Ajoutez la version v2 au modèle distant PAI_EAS_Qwen25_Omni_3B. L'entrée est une URL d'image de type chaîne, ce qui permet au modèle d'effectuer des tâches image-vers-texte. Pour un exemple complet de bout en bout, consultez la rubrique Utiliser un modèle distant MaxCompute pour générer automatiquement des descriptions de produits 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";

Exemple 2 : Ajoutez la version V2 au modèle importé 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';

Définir la version par défaut du modèle

Modifiez la version que MaxCompute considère comme la version par défaut d'un modèle.

Syntaxe

ALTER MODEL <model_name> SET DEFAULT_VERSION <version_name>;

Paramètres

Paramètre	Obligatoire	Description
`model_name`	Oui	Nom d'un modèle existant. Une erreur est renvoyée si le modèle n'existe pas.
`version_name`	Oui	Nom d'une version de modèle existante à définir comme version par défaut. Une erreur est renvoyée si la version n'existe pas.

Exemple

L'exemple suivant vérifie la version par défaut actuelle de PAI_EAS_Qwen25_Omni_3B (v1), la remplace par v2, puis vérifie la modification.

-- 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     |                                                     |
+------------------------------------------------------------------------------------+

Supprimer une version de modèle

Supprimez une version spécifique d'un modèle MaxCompute existant.

Remarque

Vous ne pouvez pas supprimer la version par défaut d'un modèle. Pour supprimer la version par défaut actuelle, vous devez d'abord définir une autre version comme version par défaut à l'aide de ALTER MODEL <model_name> SET DEFAULT_VERSION <version_name>, puis supprimer l'ancienne version.

Syntaxe

ALTER MODEL <model_name> DROP VERSION <version_name>;

Paramètres

Paramètre	Obligatoire	Description
`model_name`	Oui	Nom d'un modèle existant. Une erreur est renvoyée si le modèle n'existe pas.
`version_name`	Oui	Nom de la version du modèle à supprimer. Une erreur est renvoyée si la version n'existe pas.

Exemple

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

Étapes suivantes

Modèles MaxCompute — Parcourez les modèles publics disponibles dans MaxCompute
Créer et supprimer un modèle — Créez un nouvel objet de modèle ou supprimez un modèle existant
Utiliser un modèle distant MaxCompute pour générer automatiquement des descriptions de produits e-commerce — Exemple de bout en bout utilisant des versions de modèles distants