Todos os produtos
Search
Central de documentação

MaxCompute:Desenvolver e enviar um script SQL

Última atualização: Jun 26, 2026

Escreva e execute scripts SQL no MaxCompute Studio para criar tabelas, inserir dados e consultar resultados.

Pré-requisitos

Criar um arquivo de script SQL

  1. Na janela de ferramentas Project, clique com o botão direito em scripts e selecione New > MaxCompute SQL Script.

  2. Na caixa de diálogo New MaxCompute SQL Script, defina os parâmetros e clique em OK.

    • Script Name: o nome do script.

    • MaxCompute project: o projeto de destino. Clique em + para adicionar uma conexão de projeto. Gerenciar conexões de projeto.

  3. Escreva o script SQL no editor. Referência de sintaxe: Visão geral do SQL.

    Script de exemplo:

    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
    • O modo de script oferece suporte a dependências de recursos entre projetos. Por exemplo, um script vinculado ao Projeto A também pode acessar table1 no Projeto B (ProjectB.table1).

    • É possível personalizar o editor de scripts SQL. Visão geral.

Enviar um script SQL

Antes de enviar um script, configure as seguintes opções na barra de ferramentas acima do editor:

  • Modo do editor:

    • Statement mode: divide o script por ; e envia cada instrução individualmente.

    • Script mode: envia todo o script em uma única solicitação para otimização holística. Recomendado.

  • Sistema de tipos: determina a compatibilidade do SQL.

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

    • MaxCompute type system: o sistema de tipos introduzido no MaxCompute 2.0.

    • Hive compatible type system: o sistema de tipos compatível com Hive no MaxCompute 2.0.

  • Modo de execução:

    • Default: o modo de execução estável.

    • MaxQA: utiliza o recurso de aceleração de consultas MaxQA.

    • MaxCompute Query Acceleration: ativa os recursos mais recentes do MCQA.

    • Rerun When Acceleration Fails: reexecuta automaticamente o job se a aceleração da consulta falhar.

  1. Clique em Run na barra de ferramentas ou na barra lateral para executar o script.

    Nota

    Se o script contiver uma variável como ${bizdate}, uma caixa de diálogo solicitará seu valor. Por exemplo, insira 2017-11-11 00:00:00 para consultar dados na partição de destino.

  2. Revise o custo estimado na caixa de diálogo Confirmation e clique em OK.

    A caixa de diálogo exibe métricas de estimativa de custo: Inputs (tamanho dos dados de entrada em bytes), UDF Count (quantidade de UDFs) e Complexity. Selecione Do not show this dialog again para ignorar prompts futuros.

    Nota
    • Clique em Refresh na barra de ferramentas para atualizar os metadados (tabelas e UDFs). Utilize esta opção caso o MaxCompute Studio informe que uma tabela ou função não existe, mesmo estando presente no servidor.

    • O script é compilado localmente com base nos metadados do projeto na janela Project Explorer. Se a compilação for bem-sucedida, o script será enviado ao servidor.

    • Os logs de execução são exibidos durante o processamento. Quando o job inicia no servidor, a aba de detalhes do job abre automaticamente.

    • Para exibir o custo estimado, marque a caixa de seleção Show SQL cost confirm dialog when script submitted nas Opções de configuração do MaxCompute SQL.

  3. Visualize os resultados da execução na aba Result do console.

    No modo de instrução, o resultado de cada comando aparece separadamente.

    A aba Result mostra a saída de cada instrução (como INSERT INTO TABLE... e SELECT * FROM...) em seções distintas, contendo o SQL correspondente e os dados retornados.