MaxCompute SQL analysis - edit and run SQL online - MaxCompute - Centro de documentación de Alibaba Cloud

Utilice la función de análisis SQL en la consola de MaxCompute para editar, ejecutar y analizar instrucciones SQL en línea.

Importante

Alibaba Cloud ha actualizado la función de análisis SQL en la consola de MaxCompute con compatibilidad para todas las regiones. Explore las nuevas capacidades y habilítelas en Connect using SQL analysis (new version).

El punto de entrada heredado de análisis SQL se cerrará el 31 de marzo de 2026, UTC+8. Mueva los archivos locales de su espacio de trabajo heredado a su directorio personal en la nueva interfaz de análisis SQL antes de esa fecha.

Descripción general de la función

Edite y ejecute instrucciones SQL en línea, y visualice los resultados de las consultas.
Las demostraciones integradas de conjuntos de datos públicos le permiten probar las funciones de MaxCompute de inmediato.

Escenarios

Exploración rápida: utilice conjuntos de datos públicos para explorar las capacidades principales de MaxCompute.
Pruebas ad hoc: ejecute comandos SQL temporales, como consultar datos de tablas.

Interfaz de análisis SQL

Área del editor

Módulo	Descripción
Barra de pestañas	Las pestañas de archivo le permiten abrir varios archivos a la vez. Haga doble clic en un área vacía de la barra de pestañas para crear un nuevo archivo `.sql`. Haga clic con el botón derecho en un área vacía de la barra de pestañas y seleccione Create File.
Barra de herramientas	Run: ejecuta el script SQL. Seleccione un segmento para ejecutarlo por sí solo; de lo contrario, se ejecutará todo el archivo. Stop: aparece después de hacer clic en Run. Haga clic en Stop para detener el script en ejecución. Save: guarda archivos localmente como archivos `.sql`. El almacenamiento en la nube no es compatible con la versión preliminar pública actual. Format: da formato al código SQL del archivo actual. Run Result: muestra el panel de resultados si está oculto tras ejecutar un script SQL. Cost Analysis: ejecuta una instrucción COST SQL para estimar el uso de recursos y obtener el volumen de datos escaneados y la complejidad de la consulta.
Editor	La primera línea del script debe contener código ejecutable. Si un archivo `.sql` contiene varios scripts SQL, coloque cualquier indicador (instrucciones SET) al principio. Los indicadores se aplican a todos los scripts SQL del archivo. Admite el modo de pantalla completa para la entrada, ejecución y visualización de resultados.

Panel de configuración de parámetros de ejecución

Haga clic en Run Parameters en la esquina superior derecha del editor SQL para expandir el panel de configuración.

Módulo	Descripción
Project	Seleccione el proyecto donde se ejecutará el código SQL. Obligatorio. El proyecto seleccionado debe otorgar a su cuenta el permiso `create instance`. Obligatorio en la primera ejecución. El sistema almacena en caché su última selección, la cual puede cambiar en cualquier momento. La selección se aplica a todas las pestañas de archivo abiertas.
Computing Quota	Seleccione una cuota de cómputo. Opcional. Si selecciona una cuota, esta debe otorgar a su cuenta el permiso `usage`. Si no selecciona una cuota, el sistema utiliza la cuota de cómputo predeterminada del proyecto. La selección se aplica a todas las pestañas de archivo abiertas.

Panel de resultados

Módulo	Descripción
Issue	Valida automáticamente la sintaxis y el formato de todos los archivos abiertos antes de la ejecución del script.
MetaData	Seleccione un objeto (tabla, recurso o función) desde Table Data o DataSet Manage para ver los metadatos: información básica, columnas, DDL y vista previa de datos. Requiere los data permissions adecuados para el objeto.
Result	Muestra los resultados de la ejecución del script: Lista de ejecuciones: cada ejecución de SQL crea un registro con marca de tiempo. Haga clic en un registro para ver sus detalles. Registros: registros de ejecución de cada corrida. SQL: el código SQL exacto que se ejecutó. Lista de resultados: muestra los resultados de la consulta si están disponibles. Análisis: realice análisis sencillos basados en gráficos sobre los resultados si están disponibles.
Cost Analysis	Muestra los resultados de la instrucción COST SQL ejecutada durante Cost Analysis, incluidos los registros de ejecución y la salida.

Administrador de recursos

Haga clic con el botón derecho en un área vacía del administrador de recursos para configurar los módulos visibles, como ocultar Timeline.

Módulo	Descripción
Lista de archivos	En el primer acceso, muestra No folder opened. Haga clic en Open Folder para seleccionar una carpeta local. Aparece un cuadro de diálogo de confirmación de permisos en el primer uso. Importante Debe otorgar permisos de acceso a todos los archivos cada vez que abra una carpeta local. No se almacena ningún contenido de carpetas en el servidor.
CommonDataSet Demo	Las consultas de demostración de conjuntos de datos públicos integrados se pueden ejecutar o editar temporalmente. Los archivos de demostración en línea no se pueden modificar permanentemente; actualizar la página los restablece. Guarde cualquier archivo modificado en su computadora local. Las consultas de demostración utilizan conjuntos de datos públicos con esquemas. Los scripts incluyen `set odps.namespace.schema=true;` para habilitar la sintaxis de esquema de forma predeterminada. Cada archivo de demostración contiene varios scripts SQL. El número antes de `-query` en el nombre del archivo indica la cantidad de consultas. Las demostraciones TPC-DS contienen 99 consultas por archivo en diferentes volúmenes de datos y consumen recursos de cómputo significativos; proceda con precaución.
Timeline	Registra los registros de operaciones de los archivos abiertos en el editor. Los registros se almacenan en la caché del navegador y se borran cuando usted limpia la caché.

Búsqueda

Haga clic en el icono Search en la barra lateral. El cuadro de búsqueda admite Match Case (Aa), Whole Words (ab) y Regular Expression (*). El cuadro de reemplazo admite Preserve Case (AB).

Módulo	Descripción
Search	Busque en todos los archivos del administrador de recursos; por ejemplo, encuentre archivos que contengan "FROM table_test1". Haga clic en un resultado para abrir el archivo y saltar a la coincidencia.
Replacement	Reemplaza las palabras clave encontradas con texto nuevo. Ejemplo: para reemplazar `FROM table_test1` por `FROM table_test2` en todos los archivos, introduzca `FROM table_test1` en el cuadro Search, introduzca `FROM table_test2` en el cuadro Replacement y haga clic en .

Datos de tabla

Enumera todos los objetos en los proyectos del inquilino y la región actuales: esquemas, tablas, vistas, recursos y funciones.

Ámbito de visibilidad: las cuentas de Alibaba Cloud pueden ver todos los proyectos. Los usuarios de RAM deben agregarse a un proyecto para ver su contenido.
SYSTEM_CATALOG proyecto: SYSTEM_CATALOG es un proyecto creado por el sistema para tenant-level Information Schema. Las vistas INFORMATION_SCHEMA residen bajo el esquema "INFORMATION_SCHEMA" en este proyecto y son directamente accesibles.
Permisos de visualización: ver la lista de objetos de un proyecto requiere List permission.

Las tablas con permiso SELECT muestran un icono verde .
Jerarquía de esquemas: expanda un proyecto para ver sus esquemas (si están habilitados) o las categorías de objetos directamente. Expanda una categoría para ver sus objetos.
Haga clic en un objeto para ver los detalles de sus metadatos en la pestaña MetaData del panel de resultados.

Conjuntos de datos públicos

En el editor SQL, haga clic en el icono de base de datos en la parte inferior del panel de navegación izquierdo. La entrada Public Datasets aparece en la parte superior del panel izquierdo. Expanda BIGDATA_PUBLIC_DATASET para examinar las tablas disponibles.

Muestra metadatos de tablas en public datasets proporcionados por el sistema.

Uso del análisis SQL

Los trabajos SQL requieren un proyecto. Cree uno después de activar MaxCompute.

Inicie sesión en la consola de MaxCompute y seleccione una región en la esquina superior izquierda.
Create a MaxCompute project

Los trabajos SQL requieren un proyecto. Cree uno después de activar MaxCompute.
En el panel de navegación izquierdo, elija Data Exploration > SQL Analysis.
En la página Data Exploration > SQL Analysis, cree un archivo SQL.
1. Cuando abre la página de análisis SQL por primera vez, se crea y abre de forma predeterminada un archivo SQL llamado untitled_x. Puede editar este archivo directamente.
2. Haga doble clic en un área en blanco de la barra de pestañas de archivos en el editor para crear un archivo SQL.
3. Haga clic con el botón derecho en la barra de pestañas de archivos en el editor y seleccione New File.
Después de introducir SQL en el editor SQL, haga clic en Run Configurations a la derecha y configure Project y Computing Quota.
- Project: obligatorio. El proyecto en el que se ejecutarán las instrucciones SQL. Debe tener el permiso CREATE instance para este proyecto.
- Computing Quota: opcional. Este parámetro especifica la cuota de recursos de cómputo para el trabajo. Si especifica una cuota, su cuenta debe tener el permiso USAGE para ella. Si no especifica una cuota, las instrucciones SQL se ejecutan utilizando la cuota de recursos de cómputo predeterminada configurada para el proyecto.
Haga clic en Run y espere a que se complete la consulta. En los resultados de la ejecución, puede hacer clic en el icono para realizar un análisis visual sencillo.

La interfaz de análisis SQL no admite descargas de resultados. Utilice uno de estos métodos:
- Ejecute el trabajo SQL en el cliente de MaxCompute (odpscmd) y luego use el comando Tunnel para descargar los resultados. Download instance data.
- Ejecute el trabajo SQL en un nodo ODPS SQL en DataWorks Data Development y luego use el botón Export. Export, share, and download workbooks.
Haga clic en Save para guardar el archivo SQL actual en su computadora local.