Tous les produits
Search
Centre de documentation

MaxCompute:Create and delete models

Dernière mise à jour :Aug 10, 2026

Utilisez CREATE MODEL pour enregistrer un modèle importé ou distant dans un projet MaxCompute, et DROP MODEL pour supprimer un modèle ainsi que toutes ses versions.

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

Création d'un modèle

MaxCompute prend en charge deux sources de modèles :

  • Modèle importé : fichier de modèle XGBoost stocké dans Object Storage Service (OSS) et importé dans MaxCompute.

  • Modèle distant : grand modèle de langage (LLM) ou grand modèle de langage multimodal (MLLM) déployé dans PAI EAS et référencé depuis MaxCompute.

Pour obtenir un aperçu des types et des versions de modèles, consultez la section Types de modèles.

Notes d'utilisation

  • Les modèles publics appartiennent à des projets publics gérés par le compte système MaxCompute. Ils sont disponibles directement pour l'inférence sans nécessiter de création. Pour consulter la liste des modèles publics et les instructions d'utilisation, rendez-vous sur la page Modèles MaxCompute.

  • Les modèles entraînés en interne ne peuvent être créés qu'en exécutant to_odps_model dans MaxFrame. La création via SQL n'est pas prise en charge. Pour plus de détails, consultez la documentation relative à to_odps_model.

  • Les paramètres MODEL_SOURCE_TYPE et MODEL_TYPE ne peuvent pas être modifiés après la création du modèle.

  • La version spécifiée lors de la création devient la version par défaut (DEFAULT_VERSION) du modèle.

  • Le commentaire du modèle spécifié lors de la création est également appliqué à la première version.

Syntaxe

Modèle importé

CREATE MODEL [ IF NOT EXISTS ] <model_name> WITH VERSION <version_name>
INPUT(<input_col_name> <input_data_type>, ... )
OPTIONS(
    MODEL_SOURCE_TYPE = 'IMPORT',
    MODEL_TYPE = '<model_type>',
    LOCATION = '<location>',
    ROLEARN = '<rolearn>'
)
[COMMENT <model_comment>];

Modèle distant

CREATE MODEL [ IF NOT EXISTS ] <model_name> WITH VERSION <version_name>
[INPUT(<input_col_name> <input_data_type>, ... )]
OPTIONS(
    MODEL_SOURCE_TYPE = 'REMOTE',
    MODEL_TYPE = '<model_type>',
    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 requis

Paramètre Description
model_name Nom du modèle. Non sensible à la casse. Accepte les lettres (a–z, A–Z), les chiffres et les traits de soulignement (_). Doit commencer par une lettre. Longueur maximale : 256 octets. Doit être unique au sein du même projet ou schéma.
version_name Nom de la version du modèle. Les règles de nommage sont identiques à celles de model_name. Ne peut pas être défini sur default_version. Longueur maximale : 256 octets.
MODEL_SOURCE_TYPE Source du modèle. Valeurs valides : IMPORT (modèle importé), REMOTE (modèle distant). Ne peut pas être modifié après la création.
MODEL_TYPE Type de modèle. Ne peut pas être modifié après la création. Pour les modèles importés : BOOSTED_TREE_CLASSIFIER (modèle de classification XGBoost) ou BOOSTED_TREE_REGRESSOR (modèle de régression XGBoost). Pour les modèles distants : LLM (grand modèle de langage) ou MLLM (grand modèle de langage multimodal).

Paramètres facultatifs

Paramètre Description
IF NOT EXISTS Si omis, une erreur est renvoyée lorsqu'un modèle portant le même nom existe déjà. Si spécifié, l'instruction aboutit sans erreur.
input_col_name Nom de la colonne d'entrée. Non sensible à la casse. Accepte les lettres (a–z, A–Z), les chiffres, les traits de soulignement (_) et les caractères chinois. Doit commencer par une lettre. Longueur maximale : 128 octets. Requis lorsque MODEL_SOURCE_TYPE est défini sur IMPORT.
input_data_type Type de données de la colonne d'entrée. Types pris en charge : BIGINT, DOUBLE, STRING, BINARY. Pour plus de détails, consultez la section Versions des types de données. Requis lorsque MODEL_SOURCE_TYPE est défini sur IMPORT.
COMMENT Description du modèle. Longueur maximale : 1 024 octets. Également appliqué à la première version du modèle.

Paramètres du modèle importé

Paramètre Requis Description
LOCATION Oui Chemin OSS du fichier de modèle. Seuls les points de terminaison du réseau interne OSS sont pris en charge. Exemple : oss://oss-cn-shanghai-internal.aliyuncs.com/test-mode-bucket/
ROLEARN Oui Rôle RAM utilisé pour authentifier l'accès à OSS. Exemple : acs:ram::139******728:role/aliyunodpsdefaultrole. Avant d'utiliser ce paramètre, accordez les autorisations OSS requises à MaxCompute : utilisez l'autorisation en un clic pour accorder l'autorisation par défaut AliyunODPSDefaultRole, ou créez un rôle personnalisé comme décrit dans la section Autorisation en mode STS pour OSS.

Paramètres du modèle distant

Paramètre Requis 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 modèle déployé 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 appartient à un groupe de services, utilisez le format GroupName.ServiceName (par exemple, group.service_name). Sinon, spécifiez uniquement le nom du service.
ENDPOINT Oui Point de terminaison du service PAI EAS. Exemple : http://1*************70.cn-shanghai.pai-eas.aliyuncs.com. Seuls les points de terminaison publics sont pris en charge. Ajoutez le point de terminaison aux adresses de réseau externe autorisées pour MaxCompute avant d'appeler les fonctions d'IA. Pour les étapes de configuration, consultez la section Modification des adresses de réseau externe via la gestion de projet.
APIKEY Oui Jeton d'authentification du service PAI EAS.
PAI_EAS_SYNC_MODE Oui Mode de traitement des requêtes. Seul le mode true (mode synchrone) est pris en charge.
PAI_EAS_SYNC_REQUEST_TIMEOUT Non Délai d'attente pour les requêtes synchrones. Unité : millisecondes. Valeur par défaut : 5000. Plage : 5 000 à 1 800 000.

Exemples

Exemple 1 : Création d'un modèle distant

Cet exemple enregistre le service de modèle Qwen2.5-Omni-3B déployé dans PAI EAS en tant que modèle distant. La clause INPUT spécifie que le modèle accepte des fichiers image (BINARY) pour les tâches de génération de texte à partir d'images. Pour le flux de travail complet de bout en bout, consultez la rubrique Utilisation d'un modèle distant MaxCompute pour générer automatiquement des descriptions de produits e-commerce.

CREATE MODEL PAI_EAS_Qwen25_Omni_3B WITH VERSION v1
INPUT(data BINARY, promt STRING)
OPTIONS(
    MODEL_SOURCE_TYPE = 'REMOTE',
    MODEL_TYPE = 'MLLM',
    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 = '<YOUR-API-KEY>',
    PAI_EAS_SYNC_MODE = 'true'
)
COMMENT "PAI EAS remote model binary input";

Exemple 2 : Création d'un modèle importé

Cet exemple importe un modèle de classification XGBoost entraîné depuis OSS.

CREATE MODEL test_xgboost_classifier WITH VERSION V1
INPUT (f1 int, f2 int, f3 int, f4 int)
OPTIONS(
    MODEL_SOURCE_TYPE = 'IMPORT',
    MODEL_TYPE = 'BOOSTED_TREE_CLASSIFIER',
    LOCATION = 'oss://oss-cn-shanghai-internal.aliyuncs.com/********/xgboost_classifier/',
    ROLEARN = 'acs:ram::11261230********:role/aliyunodpsdefaultrole'
)
COMMENT 'Import XGBoost model v1';
Remarque

Après avoir créé un modèle, utilisez les instructions SHOW et DESC pour afficher la liste des modèles et les détails du modèle.

Suppression d'un modèle

Notes d'utilisation

  • Les modèles publics ne peuvent pas être supprimés.

  • La suppression d'un modèle entraîne la suppression de toutes ses versions. Cette action est irréversible. Avant de supprimer un modèle, assurez-vous qu'aucune tâche d'inférence n'est en cours d'exécution sur aucune de ses versions.

Syntaxe

DROP MODEL [IF EXISTS] <model_name>;

Paramètres

Paramètre Requis Description
model_name Oui Nom du modèle à supprimer. Les modèles publics ne peuvent pas être supprimés.
IF EXISTS Non Si omis, une erreur est renvoyée lorsque le modèle n'existe pas. Si spécifié, l'instruction aboutit indépendamment de l'existence du modèle.

Exemple

DROP MODEL PAI_EAS_Qwen25_Omni_3B;

Étapes suivantes

  • Affichage des modèles : répertoriez tous les modèles d'un projet ou inspectez les détails et les versions d'un modèle spécifique.

  • Modèles MaxCompute : parcourez les modèles publics disponibles et découvrez comment les utiliser pour l'inférence.