Consulter un modèle - MaxCompute - Centre de documentation Alibaba Cloud

Prérequis

Avant de commencer, assurez-vous qu'un objet modèle existe dans le projet. Pour plus d'informations, consultez la rubrique Créer et supprimer un modèle.

Clients pris en charge

Vous pouvez exécuter toutes les commandes présentées dans cette rubrique depuis :

Opérations récapitulatives

Opération

Commande

Autorisation requise

Lister tous les modèles du projet

SHOW MODELS

List

Lister toutes les versions d'un modèle

SHOW VERSIONS FOR MODEL

—

Afficher les métadonnées d'un modèle et de ses versions

DESC MODEL

Describe

Lister les modèles

La commande SHOW MODELS répertorie tous les modèles créés par l'utilisateur dans le projet actuel. Les modèles publics ne sont pas inclus. Pour consulter les modèles publics, accédez à la console.

Syntaxe

SHOW MODELS;

Sortie

Colonne

Description

ModelName

Nom du modèle

Owner

Compte Alibaba Cloud propriétaire du modèle

SourceType

Méthode d'ajout du modèle : REMOTE (endpoint PAI EAS) ou IMPORT (importé depuis un fichier)

ModelType

Type de modèle, par exemple LLM, MLLM ou BOOSTED_TREE_CLASSIFIER

DefaultVersion

Version utilisée lorsqu'aucune version n'est spécifiée

CreateTime

Date de création du modèle

LastModifiedTime

Date de dernière mise à jour du modèle

Comment

Description facultative du modèle

Exemple

SHOW MODELS;

Sortie attendue :

+-------------------------+------------------------------+------------+-------------------------+----------------+---------------------+---------------------+-----------------------------------+
| ModelName               | Owner                        | SourceType | ModelType               | DefaultVersion | CreateTime          | LastModifiedTime    | Comment                           |
+-------------------------+------------------------------+------------+-------------------------+----------------+---------------------+---------------------+-----------------------------------+
| pai_eas_qwen25_omni_3b  | ALIYUN$odps_********_com | REMOTE     | MLLM                    | v1             | 2025-10-09 18:32:48 | 2025-10-09 18:32:48 | PAI EAS remote model binary input |
| test_xgboost_classifier | ALIYUN$odps_********_com | IMPORT     | BOOSTED_TREE_CLASSIFIER | v1             | 2025-10-09 18:41:29 | 2025-10-09 18:41:29 | Import XGBoost model v1           |
+-------------------------+------------------------------+------------+-------------------------+----------------+---------------------+---------------------+-----------------------------------+

Lister les versions d'un modèle

La commande SHOW VERSIONS FOR MODEL liste toutes les versions d'un modèle spécifié.

Syntaxe

SHOW VERSIONS FOR MODEL <model_name>;

Paramètres

Paramètre

Obligatoire

Description

model_name

Oui

Nom du modèle

Sortie

Une liste de noms de versions, une par ligne (par exemple, v1, v2).

Remarques d'utilisation

Consultation des versions d'un modèle public

Pour interroger les modèles publics du projet BIGDATA_PUBLIC_MODELSET , vous devez effectuer deux étapes supplémentaires :

Activez l'accès aux modèles publics :
```
SET odps.sql.using.public.model=true;
```
Spécifiez le projet (et le schéma, si la syntaxe de schéma au niveau du locataire est activée) dans le nom du modèle :
```
-- If tenant-level schema syntax is enabled for the project:
SHOW VERSIONS FOR MODEL bigdata_public_modelset.default.<model_name>;

-- If tenant-level schema syntax is not enabled:
SHOW VERSIONS FOR MODEL bigdata_public_modelset.<model_name>;
```
Pour plus d'informations sur la syntaxe de schéma au niveau du locataire, consultez la rubrique Opérations de schéma. Pour obtenir la liste des modèles publics disponibles, consultez la section Types de modèles.

Exemples

Lister les versions d'un modèle créé par l'utilisateur :

SHOW VERSIONS FOR MODEL PAI_EAS_Qwen25_Omni_3B;
-- Returns:
-- v1
-- v2

Lister les versions d'un modèle public :

-- If tenant-level schema syntax is enabled:
SET odps.sql.using.public.model=true;
SET odps.namespace.schema=true;
SHOW VERSIONS FOR MODEL bigdata_public_modelset.default.Qwen3-0.6B-GGUF;

-- If tenant-level schema syntax is not enabled:
SET odps.sql.using.public.model=true;
SET odps.namespace.schema=false;
SHOW VERSIONS FOR MODEL bigdata_public_modelset.Qwen3-0.6B-GGUF;
-- Returns: v1

Afficher les détails d'un modèle

La commande DESC MODEL renvoie les métadonnées d'un modèle et d'une version spécifique. La sortie inclut les informations au niveau du modèle, les informations au niveau de la version et le schéma d'entrée du modèle.

Syntaxe

DESC MODEL <model_name> [WITH VERSION <version_name>];

Paramètres

Paramètre

Obligatoire

Description

model_name

Oui

Nom du modèle

version_name

Non

Version à inspecter. Par défaut, utilise la DEFAULT_VERSION du modèle si aucune version n'est spécifiée. Pour modifier la version par défaut, utilisez la commande ALTER MODEL .. SET DEFAULT_VERSION ... Pour plus d'informations, consultez la rubrique Modifier une version de modèle.

Les mêmes exigences d'accès aux modèles publics s'appliquent ici que pour la commande SHOW VERSIONS FOR MODEL . Exécutez SET odps.sql.using.public.model=true; et qualifiez le nom du modèle avec son projet et son schéma avant d'exécuter DESC MODEL sur un modèle public.

Sortie

Section Model Information

Champ

Description

Owner

Compte Alibaba Cloud propriétaire du modèle

Project

Projet auquel appartient le modèle

Model Name

Nom du modèle

Model Type

Type de modèle : LLM, MLLM, BOOSTED_TREE_CLASSIFIER, etc.

Source Type

REMOTE ou IMPORT

Default Version

Version utilisée lorsqu'aucune version n'est spécifiée

CreateTime

Date de création du modèle

LastModifiedTime

Date de dernière mise à jour du modèle

Comment

Description facultative

Section Version Information

Champ

Description

Owner

Compte propriétaire de cette version

Project

Projet auquel appartient le modèle

Model Name

Nom du modèle

Model Type

Type de modèle

Source Type

REMOTE ou IMPORT

Version Name

Identifiant de la version

Path

Chemin du fichier (pour les modèles IMPORT)

CreateTime

Date de création de cette version

LastModifiedTime

Date de dernière mise à jour de cette version

Pour les modèles REMOTE, la section Version Information inclut également :

Champ

Description

APIKEY

Clé API pour l'endpoint PAI EAS

ENDPOINT

URL du service PAI EAS

PAI_EAS_MODEL_NAME

Nom du modèle dans PAI EAS

PAI_EAS_SERVICE_NAME

Nom du service PAI EAS

PAI_EAS_SYNC_MODE

Indique si le service utilise le mode synchrone

REMOTE_SERVICE_TYPE

Type de service distant, par exemple PAI-EAS

Section Input

Répertorie les colonnes d'entrée du modèle, leurs types de données et les commentaires associés.

Exemples

Exemple 1 : Afficher une version spécifique d'un modèle distant créé par l'utilisateur

DESC MODEL PAI_EAS_Qwen25_Omni_3B WITH VERSION v1;

Sortie attendue :

+------------------------------------------------------------------------------------+
|                  Model Information                                                 |
+------------------------------------------------------------------------------------+
| Owner:                    ALIYUN$odps_********_com                             |
| Project:                  ****_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-09 18:32:48                                      |
| Comment:                  PAI EAS remote model binary input                        |
+------------------------------------------------------------------------------------+
|                Version Information                                                 |
+------------------------------------------------------------------------------------+
| Owner:                    ALIYUN$odps_********_com                             |
| 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:                   ZjA5NGR*********jMzMmU0OTZmZTQ1MT*********UyNjBhMmEzYw== |
| ENDPOINT:                 http://1126123********.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     |                                                     |
+------------------------------------------------------------------------------------+

Exemple 2 : Afficher la version par défaut d'un modèle public

-- If tenant-level schema syntax is enabled:
SET odps.sql.using.public.model=true;
SET odps.namespace.schema=true;
DESC MODEL bigdata_public_modelset.default.Qwen3-4B-GGUF;

-- If tenant-level schema syntax is not enabled:
SET odps.sql.using.public.model=true;
SET odps.namespace.schema=false;
DESC MODEL bigdata_public_modelset.Qwen3-4B-GGUF;

Sortie attendue :

+------------------------------------------------------------------------------------+
|                  Model Information                                                 |
+------------------------------------------------------------------------------------+
| Owner:                    ALIYUN$*********************                             |
| Project:                  bigdata_public_modelset                                  |
| Model Name:               Qwen3-4B-GGUF                                            |
| Model Type:               LLM                                                      |
| Source Type:              IMPORT                                                   |
| Default Version:          v1                                                       |
| CreateTime:               2025-09-25 23:38:35                                      |
| LastModifiedTime:         2025-09-25 23:38:35                                      |
| Comment:                  MaxCompute Public LLM Model Qwen3-4B-GGUF with 4-bit mixed quantization and K-means clustering (Q4_K_M), using default settings {"max_tokens": 500, "temperature": 0.6, "top_p": 0.95}. Source:https://huggingface.co/unsloth/Qwen3-4B-GGUF |
+------------------------------------------------------------------------------------+
|                Version Information                                                 |
+------------------------------------------------------------------------------------+
| Owner:                    ALIYUN$*********************                             |
| Project:                  bigdata_public_modelset                                  |
| Model Name:               Qwen3-4B-GGUF                                            |
| Model Type:               LLM                                                      |
| Source Type:              IMPORT                                                   |
| Version Name:             v1                                                       |
| Path:                                                                              |
| CreateTime:               2025-09-25 23:38:35                                      |
| LastModifiedTime:         2025-09-25 23:38:35                                      |
+------------------------------------------------------------------------------------+
| Input           | Type       | Comment                                             |
+------------------------------------------------------------------------------------+
| prompt          | string     |                                                     |
| settings        | string     |                                                     |
+------------------------------------------------------------------------------------+

Étapes suivantes

Modifier une version de modèle — Modifiez la version par défaut ou mettez à jour les propriétés du modèle.
Types de modèles — Parcourez les modèles publics disponibles dans le projet BIGDATA_PUBLIC_MODELSET.
Opérations de schéma — Découvrez comment la syntaxe de schéma au niveau du locataire affecte la qualification des noms de modèles.