Todos los productos
Search
Centro de documentos

MaxCompute:Develop and submit an SQL script

Última actualización: Sep 03, 2026

Escriba y ejecute scripts de SQL en MaxCompute Studio para crear tablas, insertar datos y consultar resultados.

Requisitos previos

Crear un archivo de script de SQL

  1. En la ventana de herramientas Project, haga clic con el botón derecho en scripts y seleccione New > MaxCompute SQL Script.

  2. En el cuadro de diálogo New MaxCompute SQL Script, configure los parámetros y haga clic en OK.

    • Script Name: nombre del script.

    • MaxCompute project: proyecto de destino. Haga clic en + para agregar una conexión de proyecto. Manage project connections.

  3. Escriba el script de SQL en el editor. Referencia de sintaxis: SQL overview.

    Script de ejemplo:

    CREATE TABLE table_5( 
    col1 BIGINT,
    col2 BIGINT,
    col3 BIGINT,
    ds DATETIME
    );
    INSERT INTO TABLE table_5 VALUES (1, 2, 3, DATETIME'2025-11-11 00:00:00');
    SELECT * FROM table_5 WHERE ds='${bizdate}';
    Nota
    • El modo script admite dependencias de recursos entre proyectos. Por ejemplo, un script vinculado al Proyecto A también puede acceder a table1 del Proyecto B (ProjectB.table1).

    • Es posible personalizar el editor de scripts de SQL. Descripción general.

Enviar un script de SQL

Antes de enviar un script, configure los siguientes ajustes en la barra de herramientas situada encima del editor:

  • Modo del editor:

    • Statement mode: divide el script por ; y envía cada sentencia de forma individual.

    • Script mode: envía todo el script en una sola solicitud para optimizarlo de manera integral. Esta es la opción recomendada.

  • Sistema de tipos: determina la compatibilidad de SQL.

    • Legacy type system: sistema de tipos original de MaxCompute.

    • MaxCompute type system: sistema de tipos introducido en MaxCompute 2.0.

    • Hive compatible type system: sistema de tipos compatible con Hive en MaxCompute 2.0.

  • Modo de ejecución:

    • Default: modo de ejecución estable.

    • MaxQA: utiliza la función de aceleración de consultas MaxQA.

    • MaxCompute Query Acceleration: habilita las funciones más recientes de MCQA.

    • Rerun When Acceleration Fails: vuelve a ejecutar automáticamente el trabajo si falla la aceleración de consultas.

  1. Haga clic en el icono Run de la barra de herramientas o de la barra lateral para ejecutar el script.

    Nota

    Si el script contiene una variable como ${bizdate}, aparecerá un cuadro de diálogo que solicitará su valor. Por ejemplo, introduzca 2017-11-11 00:00:00 para consultar datos en la partición de destino.

  2. Revise el costo estimado en el cuadro de diálogo Confirmation y haga clic en OK.

    El cuadro de diálogo muestra métricas de estimación de costos: Inputs (tamaño de los datos de entrada en bytes), UDF Count (cantidad de UDF) y Complexity. Seleccione Do not show this dialog again para omitir este mensaje en el futuro.

    Nota
    • Haga clic en el icono Refresh de la barra de herramientas para actualizar los metadatos (tablas y UDF). Utilice esta opción si MaxCompute Studio indica que una tabla o función no existe cuando sí está presente en el servidor.

    • El script se compila localmente con base en los metadatos del proyecto que se encuentran en la ventana Project Explorer. Si la compilación es exitosa, el script se envía al servidor.

    • Los registros de ejecución se muestran durante el proceso. Cuando el trabajo inicia en el servidor, la pestaña de detalles del trabajo se abre automáticamente.

    • Para mostrar el costo estimado, seleccione la casilla Show SQL cost confirm dialog when script submitted en MaxCompute SQL configuration options.

  3. Consulte los resultados de la ejecución en la pestaña Result de la consola.

    En el modo sentencia, el resultado de cada instrucción se muestra por separado.

    La pestaña Result presenta la salida de cada sentencia (como INSERT INTO TABLE... y SELECT * FROM...) en secciones distintas que incluyen el código SQL correspondiente y los datos devueltos.