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 :
Un projet MaxCompute disposant de l'autorisation CreateModel pour créer des modèles, ou de l'autorisation Drop sur un modèle spécifique pour le supprimer.
Un accès à l'un des points d'entrée suivants : MaxCompute client, SQL analysis, Cloud Shell (odpscmd) ou DataWorks.
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_modeldans 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_TYPEetMODEL_TYPEne 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';
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.