MaxCompute:Gerencie conexões de projeto

Pré-requisitos

Você já instalou o MaxCompute Studio com sucesso.

Etapa 1: Crie um projeto do MaxCompute Studio

1. Inicie o IntelliJ IDEA. No menu principal, selecione File > New > Project.

2. No painel de navegação à esquerda da caixa de diálogo New Project, selecione MaxCompute Studio e clique em Next.

3. Insira um Project name e clique em Finish para crie o projeto.

   Nota

   Se já houver um projeto aberto, o sistema perguntará se você deseja abrir o novo projeto na janela atual. Clique em This Window para fechar o projeto existente e abrir o novo.

Etapa 2: Crie uma conexão de projeto do MaxCompute

1. No menu principal, selecione View > Tool Windows > Project Explorer.

2. No canto superior esquerdo, clique em + e selecione Add project from accessId/Key.

3. Na caixa de diálogo Add MaxCompute project, configure os parâmetros na aba Connection.

   Os parâmetros a configure são Properties File, AK Account, AccessKey ID (obrigatório), AccessKey Secret (obrigatório), Project Name (obrigatório) e Endpoint (obrigatório).

   Nota

   • Clique em no ícone no canto inferior esquerdo da caixa de diálogo para acessar a documentação online.

   • Caso ocorra um erro de tempo limite, clique em na aba Setting e modifique os parâmetros de sincronização de dados:

     • sync one table timeout(s): Tempo limite para sincronização de tabelas. Padrão: 5s.

     • sync one function timeout(s): Tempo limite para sincronização de funções definidas pelo usuário (UDF). Padrão: 30s.

   • Preencher automaticamente os parâmetros a partir de um arquivo de configuração.

     Parâmetro	Descrição
     Properties File	Faça upload do arquivo de configuração odps_config.ini do cliente MaxCompute (odpscmd). Para mais detalhes, consulte Instalar e configure o cliente MaxCompute. Esse arquivo inicializa os parâmetros AccessKey ID, AccessKey Secret, Project Name e Endpoint.
     AK Account	Conta da Alibaba Cloud usada para conectar ao projeto MaxCompute. Clique em + à direita e selecione uma conta existente na página Accounts. Nota Se nenhuma conta estiver listada, na página Accounts, clique em + > Aliyun Account By AccessKey para adicionar uma conta automaticamente via arquivo de configuração ou manualmente. Para mais informações sobre como configure contas, consulte Opções de configuração de contas.

   • Configure os parâmetros manualmente.

     Parâmetro	Descrição
     AccessKey ID	AccessKey ID usado para conectar ao projeto MaxCompute.
     AccessKey Secret	AccessKey Secret usado para conectar ao projeto MaxCompute.
     Project Name	Nome do projeto MaxCompute de destino. Nota Este parâmetro especifica o nome de um projeto MaxCompute existente, não de um workspace do DataWorks. Faça login no console do MaxCompute e acesse a página Workspace > Projects para visualize os nomes dos seus projetos MaxCompute ou crie um novo projeto.
     Endpoint	O endpoint da região onde o projeto MaxCompute está localizado. Ao conectar-se fora da rede interna da Alibaba Cloud (por exemplo, do seu computador local), use obrigatoriamente um endpoint público.

4. Após concluir a configuração, clique em OK. O painel Project Explorer à esquerda exibirá as informações do projeto MaxCompute, incluindo tabelas, visualizações, funções definidas pelo usuário (UDFs) e recursos.

Etapa 3: Modifique uma conexão de projeto do MaxCompute

1. No painel Project Explorer, clique em com o botão direito no projeto MaxCompute que deseja modifique e selecione Modify project properties.

2. Na caixa de diálogo Modify MaxCompute project, altere a configuração do projeto.

Próximas etapas

Após conectar-se ao projeto MaxCompute, você pode:

• Gerencie e visualize os dados e recursos do projeto. Para mais informações, consulte Gerencie dados e recursos.

• Desenvolver programas SQL no MaxCompute Studio. Para mais informações, consulte Desenvolver programas SQL.

• Desenvolver programas Java no MaxCompute Studio. Para mais informações, consulte Desenvolver programas Java.

• Desenvolver programas Python no MaxCompute Studio. Para mais informações, consulte Desenvolver programas Python.

Solução de problemas

Os seguintes erros comuns podem ocorrer após configure os parâmetros na aba Connection e clique em OK:

• Erro: Test connection fail: ODPS-0420111: Project not found - '<project_name>'. ou Test connection fail:ODPS-0130013:Authorization exception - Authorization Failed [4002], You don't exist in project <project_name>. Context ID:<context ID>. --->Tips: Principal:ALIYUN$<account_name> | RAM$[<account_name>:]<RAM_user_name>;.

  • Possíveis causas:

    • O projeto de destino não existe ou o nome do projeto está incorreto.

    • A conta da Alibaba Cloud ou o usuário RAM associado ao AccessKey ID não foi adicionado ao projeto de destino.

  • Soluções:

    • Faça login no console do MaxCompute. Na página Workspace > Projects, obtenha o nome correto do projeto MaxCompute e modifique o parâmetro Project Name.

    • Se outros usuários precisarem se conectar ao projeto, o proprietário do projeto deverá adicioná-los. Para mais informações, consulte Adicionar uma conta da Alibaba Cloud (nível de projeto) ou Adicionar um usuário RAM (nível de projeto).

• Erro: Test connection fail: connect timed out, the possible reason is that the endpoint '<endpoint>' is wrong, please check your endpoint.

  • Possível causa: Valor incorreto inserido no parâmetro Endpoint. Por exemplo, você está se conectando do seu computador local pela internet pública, mas especificou um endpoint de rede interna.

  • Solução: Consulte a documentação de Endpoints e selecione um endpoint compatível com a região do seu projeto e seu ambiente de rede.

• Erro: Test connection fail: The specified project or table name is not valid or missing. .

  • Possível causa: Endpoints destinam-se aos serviços do MaxCompute, enquanto tunnel endpoints são exclusivos para os serviços do MaxCompute Tunnel. Provavelmente você especificou um tunnel endpoint no parâmetro Endpoint.

  • Solução: Consulte a documentação de Endpoints. Selecione um endpoint compatível com a região do seu projeto e seu ambiente de rede. Não utilize um tunnel endpoint.