Visualizar um modelo - MaxCompute: Central de Documentação do Alibaba Cloud

Pré-requisitos

Antes de começar, verifique se existe um objeto de modelo no projeto. Para mais informações, consulte Criar e excluir um modelo.

Clientes compatíveis

Execute todos os comandos deste tópico nos seguintes ambientes:

Visão geral das operações

Operação	Comando	Permissão necessária
Listar todos os modelos do projeto	`SHOW MODELS`	List
Listar todas as versões de um modelo	`SHOW VERSIONS FOR MODEL`	—
Visualizar metadados de um modelo e suas versões	`DESC MODEL`	Describe

Listar modelos

O comando SHOW MODELS lista todos os modelos criados pelo usuário no projeto atual. Modelos públicos não estão incluídos. Para visualizar modelos públicos, acesse o console.

Sintaxe

SHOW MODELS;

Saída

Coluna	Descrição
ModelName	Nome do modelo
Owner	Conta Alibaba Cloud proprietária do modelo
SourceType	Método de adição do modelo: `REMOTE` (endpoint PAI EAS) ou `IMPORT` (importado de um arquivo)
ModelType	Tipo do modelo, como `LLM`, `MLLM` ou `BOOSTED_TREE_CLASSIFIER`
DefaultVersion	Versão usada quando nenhuma versão é especificada
CreateTime	Data de criação do modelo
LastModifiedTime	Data da última atualização do modelo
Comment	Descrição opcional do modelo

Exemplo

SHOW MODELS;

Saída esperada:

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

Listar versões de modelo

Use SHOW VERSIONS FOR MODEL para listar todas as versões de um modelo específico.

Sintaxe

SHOW VERSIONS FOR MODEL <model_name>;

Parâmetros

Parâmetro	Obrigatório	Descrição
`model_name`	Sim	Nome do modelo

Saída

Uma lista de nomes de versão, um por linha (por exemplo, v1, v2).

Notas de uso

Visualização de versões de um modelo público

Modelos públicos no projeto BIGDATA_PUBLIC_MODELSET exigem duas etapas adicionais antes da consulta:

Ative o acesso a modelos públicos:
```
SET odps.sql.using.public.model=true;
```
Especifique o projeto (e o schema, se a sintaxe de schema no nível de tenant estiver ativada) no nome do modelo:
```
-- 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>;
```
Para mais informações sobre a sintaxe de schema no nível de tenant, consulte Operações de schema. Para obter uma lista de modelos públicos disponíveis, veja Tipos de modelo.

Exemplos

Listar versões de um modelo criado pelo usuário:

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

Listar versões de um modelo público:

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

Visualizar detalhes do modelo

O comando DESC MODEL retorna metadados de um modelo e de uma versão específica. A saída inclui informações no nível do modelo, informações no nível da versão e o schema de entrada do modelo.

Sintaxe

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

Parâmetros

Parâmetro	Obrigatório	Descrição
`model_name`	Sim	Nome do modelo
`version_name`	Não	Versão a ser inspecionada. O padrão é a `DEFAULT_VERSION` do modelo caso não seja especificada. Para alterar a versão padrão, use `ALTER MODEL .. SET DEFAULT_VERSION ..`. Para mais informações, consulte Modificar uma versão de modelo.

Os mesmos requisitos de acesso a modelos públicos aplicam-se aqui, assim como no comando SHOW VERSIONS FOR MODEL . Execute SET odps.sql.using.public.model=true; e qualifique o nome do modelo com seu projeto e schema antes de executar DESC MODEL em um modelo público.

Saída

Seção Model Information

Campo	Descrição
Owner	Conta Alibaba Cloud proprietária do modelo
Project	Projeto ao qual o modelo pertence
Model Name	Nome do modelo
Model Type	Tipo do modelo: `LLM`, `MLLM`, `BOOSTED_TREE_CLASSIFIER`, etc.
Source Type	`REMOTE` ou `IMPORT`
Default Version	Versão usada quando nenhuma versão é especificada
CreateTime	Data de criação do modelo
LastModifiedTime	Data da última atualização do modelo
Comment	Descrição opcional

Seção Version Information

Campo	Descrição
Owner	Conta proprietária desta versão
Project	Projeto ao qual o modelo pertence
Model Name	Nome do modelo
Model Type	Tipo do modelo
Source Type	`REMOTE` ou `IMPORT`
Version Name	Identificador da versão
Path	Caminho do arquivo (para modelos `IMPORT`)
CreateTime	Data de criação desta versão
LastModifiedTime	Data da última atualização desta versão

Para modelos REMOTE, a seção Version Information também inclui:

Campo	Descrição
APIKEY	Chave de API para o endpoint PAI EAS
ENDPOINT	URL do serviço PAI EAS
PAI_EAS_MODEL_NAME	Nome do modelo no PAI EAS
PAI_EAS_SERVICE_NAME	Nome do serviço PAI EAS
PAI_EAS_SYNC_MODE	Indica se o serviço usa modo síncrono
REMOTE_SERVICE_TYPE	Tipo de serviço remoto, como `PAI-EAS`

Seção Input

Lista as colunas de entrada do modelo, seus tipos de dados e comentários.

Exemplos

Exemplo 1: Visualizar uma versão específica de um modelo remoto criado pelo usuário

DESC MODEL PAI_EAS_Qwen25_Omni_3B WITH VERSION v1;

Saída esperada:

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

Exemplo 2: Visualizar a versão padrão de um modelo público

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

Saída esperada:

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

Próximos passos

Modificar uma versão de modelo — Altere a versão padrão ou atualize as propriedades do modelo.
Tipos de modelo — Navegue pelos modelos públicos disponíveis no projeto BIGDATA_PUBLIC_MODELSET.
Operações de schema — Entenda como a sintaxe de schema no nível de tenant afeta a qualificação do nome do modelo.