Todos os produtos
Search
Central de documentação

MaxCompute:Configurar o MaxCompute Studio

Última atualização: Jul 20, 2026

Configure as definições do MaxCompute Studio, incluindo armazenamento de metadados, verificação de atualizações, compilação SQL e gerenciamento de contas.

Após instalar o plug-in do MaxCompute Studio, acesse File > Settings... para abrir a caixa de diálogo de configuração do MaxCompute Studio.

Itens de configuração do MaxCompute Studio

Na caixa de diálogo Settings, clique em MaxCompute Studio no painel de navegação à esquerda para visualizar as seguintes opções:

  • General Settings

    • Local meta store location: defina o caminho local para armazenar metadados dos projetos do MaxCompute. Por padrão, o MaxCompute Studio utiliza o diretório .odps.studio\meta no diretório home do usuário.

    • Table preview rows: número máximo de linhas exibidas na pré-visualização de uma tabela.

    • Local directory for jobs: caminho local usado para armazenar dados dos jobs do MaxCompute Studio. Por padrão, o MaxCompute Studio armazena esses dados no caminho local .odps.studio\job.

      Nota

      Se mantiver o valor padrão, certifique-se de que o caminho .odps.studio\job exista e que o MaxCompute Studio tenha permissão de escrita nele. Caso contrário, pode ocorrer um erro ao confirmar as configurações.

    • Python path to resolve UDF: caminho de instalação local do Python.

  • Updates Checking

    • Automatically checks for new version: quando selecionado, o MaxCompute Studio verifica atualizações automaticamente. Esta opção vem ativada por padrão.

    • Check new versions: clique para verificar atualizações manualmente. Se houver uma nova versão, clique em Install latest version para instalá-la. Em seguida, reinicie o IntelliJ IDEA para aplicar as alterações.

Itens de configuração de SDK & console

No painel de navegação à esquerda da caixa de diálogo Settings, clique em MaxCompute Studio > SDK & console para abrir a página de configuração de SDK & console.

Use a opção Installed Location para especificar o caminho de instalação do cliente local do MaxCompute. O MaxCompute Studio detecta automaticamente a versão do cliente no caminho indicado. Se a detecção falhar, o sistema exibirá uma mensagem de erro.

Nota

Se a versão do MaxCompute Studio for posterior à V2.6.1, não é necessário especificar um caminho, pois o MaxCompute Studio instala automaticamente a versão mais recente do cliente MaxCompute. Para usar uma versão específica do cliente MaxCompute, especifique o caminho manualmente.

Itens de configuração do MaxCompute SQL

No painel de navegação à esquerda da caixa de diálogo Settings, clique em MaxCompute Studio > MaxCompute SQL para abrir a página de configuração do MaxCompute SQL.

O lado direito da caixa de diálogo exibe as seguintes opções:

  • Color and Annotator

    Selecione Enable syntax coloring para aplicar realce de sintaxe ao código.

  • Code Completion

    • Selecione Enable code completion para obter sugestões automáticas durante a digitação.

    • Marque esta opção para acionar o preenchimento automático de código ao pressionar a barra de espaço.

  • Code Formatting

    • Selecione Enable code formatting para permitir a reformatatação do código SQL.

    • Selecione Enable code folding para permitir recolher e expandir blocos de código.

  • Script Submit

    • Show job detail when script submitted: quando selecionado, exibe automaticamente os detalhes do job após o envio de um script.

    • Record SQL history when script submitted: quando selecionado, salve os scripts SQL enviados no histórico.

    • Show SQL cost confirm dialog when script submitted: quando selecionado, exibe uma caixa de diálogo de confirmação de custo antes do envio do script.

    • Pin SQL execution result tab by default: quando selecionado, fixa a aba de resultados da execução SQL por padrão.

    • Ignore local compile error when submit script (opcional): ignora erros de compilação local ao enviar um script.

    • Use tunnel to download query acceleration result (opcional): usa o Tunnel para baixar os resultados da aceleração de consultas.

    • Job Name: configure como o nome padrão do job é gerado.

      • Use script file name as default: usa o nome do arquivo de script como nome padrão do job.

      • Input job name when first submit: solicita a inserção de um nome para o job no primeiro envio.

      • Input job name for every submit: solicita a inserção de um nome para o job em cada envio.

  • Compile | Submit

    Estas são as configurações globais padrão do compilador. É possível substituí-las por arquivo na barra de ferramentas do compilador SQL:

    • Compiler Mode

      • Statement Mode: neste modo, o compilador compila e envia cada instrução de um arquivo SQL como uma unidade individual.

      • Script Mode: compila e envia todo o arquivo SQL como um único script. Este modo permite que o otimizador melhore o plano de execução para obter maior eficiência geral.

    • Data type edition

      • Legacy TypeSystem: usa a edição de tipos de dados do MaxCompute V1.0.

      • MaxCompute TypeSystem: usa a edição de tipos de dados do MaxCompute V2.0.

      • Hive Compatible TypeSystem: usa a edição de tipos de dados compatível com Hive, baseada na edição de tipos de dados do MaxCompute V2.0.

    • Execution mode

      • Default: usa o mecanismo de execução padrão fornecido pelo MaxCompute.

      • UseShortQueryAcceleration: usa o compilador capaz de acelerar consultas.

      • FallbackWhenFailed: usa o compilador que reexecuta jobs caso a aceleração de consultas falhe.

  • Itens de configuração do MaxCompute Job

    No painel de navegação à esquerda da caixa de diálogo Settings, clique em MaxCompute Studio > MaxCompute Job para abrir a página de configuração do MaxCompute Job.

    O lado direito da caixa de diálogo exibe as seguintes opções:

    • Maximum jobs shown in job explorer table list: número máximo de jobs exibidos na página Job Explorer. Valor padrão: 1000.

    • Reset filter when switch MaxCompute project: ao selecionar este item, as configurações de job são redefinidas ao alternar entre projetos do MaxCompute.

    • Cache history instance in local database: ao selecionar este item, as informações históricas de instâncias são armazenadas em cache no banco de dados local.

    Itens de configuração de Accounts

    No painel de navegação à esquerda da caixa de diálogo Settings, clique em MaxCompute Studio > Accounts para abrir a página de configuração de Accounts.

    Gerencie as contas que acessam o MaxCompute nesta página. Para mais informações, consulte user authentication.

    Nota

    O MaxCompute Studio usa as contas especificadas para acessar projetos do MaxCompute e executar jobs.

    • Adicionar uma conta

      1. No painel de navegação à direita, clique em + e selecione Alibaba Cloud account by AccessKey.

      2. Na caixa de diálogo Add MaxCompute Account, configure os seguintes parâmetros:

        • Account Name: nome de exibição da conta no MaxCompute Studio. Para uma conta Alibaba Cloud como user_****@test.aliyun.com, defina este campo como user_test. Para um usuário RAM como user_ram@xxxxx.onaliyun.com pertencente à conta Alibaba Cloud user_****@test.aliyun.com, defina este campo como user_****:user_ram.

        • Using properties file: se você já configurou o cliente MaxCompute ou o MaxCompute Studio anteriormente e possui um arquivo odps_config.ini local, selecione esta opção para ler o AccessKey ID e o AccessKey Secret do arquivo de configuração. Ao escolher esta opção, faça upload do seu arquivo odps_config.ini local.

        • Using properties: insira manualmente o AccessKey ID e o AccessKey Secret. Você pode escolher esta opção ou Using properties file.

          • AccessKey ID: insira o AccessKey ID da conta Alibaba Cloud ou do usuário RAM.

          • AccessKey Secret: insira o AccessKey Secret da conta Alibaba Cloud ou do usuário RAM.

      3. Clique em OK. A nova conta aparecerá na lista da página Accounts.

      4. Remover uma conta

        Para remover uma conta do MaxCompute Studio, siga as etapas abaixo. Esta operação não afeta sua conta Alibaba Cloud ou usuário RAM.

        1. Selecione a conta que deseja remover na lista de contas.

        2. No painel de navegação à direita, clique em -.

        3. Na caixa de diálogo de confirmação exibida, clique em OK para excluir a conta.

      5. Modificar as informações de uma conta

        1. Selecione a conta cujas informações deseja modificar na lista de contas.

        2. No painel de navegação à direita, clique no ícone 修改.

        3. Na caixa de diálogo Edit MaxCompute Account, edite os seguintes detalhes da conta:

          • AccessKey ID: insira o novo AccessKey ID da conta Alibaba Cloud ou do usuário RAM.

          • AccessKey Secret: insira o novo AccessKey Secret da conta Alibaba Cloud ou do usuário RAM.

        4. Clique em OK para salvar as alterações.