Todos os produtos
Search

Este produto

    MaxCompute:Conectar o DBeaver ao MaxCompute

    Central de documentação

    MaxCompute:Conectar o DBeaver ao MaxCompute

    Última atualização: Jul 13, 2026

    Use a ferramenta de gerenciamento de banco de dados DBeaver para acessar projetos do MaxCompute e gerenciar dados. Este tópico descreve como se conectar a um projeto com o driver JDBC do MaxCompute.

    Informações básicas

    O DBeaver é uma ferramenta de banco de dados gratuita e multiplataforma para desenvolvedores, administradores de banco de dados, analistas e qualquer pessoa que trabalhe com bancos de dados. Para mais informações, consulte DBeaver.

    Pré-requisitos

    Antes de começar, verifique se você tem os seguintes itens:

    • Um projeto do MaxCompute criado.

      Para mais informações, consulte Criar um projeto do MaxCompute.

    • Um par de AccessKey (AccessKey ID e AccessKey Secret) com permissões para acessar seu projeto do MaxCompute.

      Para mais informações, consulte Criar um par de AccessKey.

    • O pacote JAR jar-with-dependencies baixado, contendo todas as dependências.

      Clique em odps-jdbc-3.9.0.jar para baixar o arquivo ou obtenha a versão mais recente do pacote JAR do MaxCompute no GitHub ou no repositório Maven. Os exemplos deste tópico usam a v3.9.0 do driver JDBC do MaxCompute.

    • O DBeaver baixado e instalado.

      Para mais detalhes sobre a instalação, consulte Instalar. Os exemplos deste tópico usam o DBeaver Community Edition 24.3.1.

    Etapa 1: Conectar o DBeaver ao MaxCompute

    1. Inicie o DBeaver.

    2. Selecione o tipo de banco de dados para conexão.

      Na barra de menu superior, clique no ícone de nova conexão 新建. Na caixa de diálogo Select your database, selecione SQL > SQLite e clique em Next. A caixa de diálogo Generic JDBC Connection Settings será aberta.

    3. Edite as configurações do driver.

      1. Na aba Main da caixa de diálogo Generic JDBC Connection Settings, clique em Edit Driver Settings.

      2. Defina o nome da classe e o modelo de URL.

        Na caixa de diálogo Edit Driver 'SQLite', na aba Settings, defina Class Name como com.aliyun.odps.jdbc.OdpsDriver e URL Template como jdbc:odps:{file}.

      3. Adicione o pacote JAR do driver JDBC.

        Na aba Libraries da caixa de diálogo Edit Driver 'SQLite', clique em Add File para adicionar o pacote JAR do driver JDBC do MaxCompute odps-jdbc-3.9.0-jar-with-dependencies.jar à biblioteca do driver.

      4. Clique em OK.

    4. Insira a URL JDBC.

      Na aba Main da caixa de diálogo Generic JDBC Connection Settings, configure a JDBC URL.

      Parâmetro

      Descrição

      Connection Method

      Selecione URL.

      JDBC URL

      A URL para conexão com o projeto do MaxCompute.

      • Exemplo: jdbc:odps:https://service.cn-hangzhou.maxcompute.aliyun.com/api?project=test&accessId=xx&accessKey=xx.

      • Formato: jdbc:odps:<maxCompute_endpoint>?project=<maxCompute_project_name>&accessId=<accessId>&accessKey=<accessKey>[&interactiveMode={true|false}]. Não inclua os sinais de menor e maior que (<>) na URL.

        • <maxCompute_endpoint>: Obrigatório. O endpoint da região onde seu projeto do MaxCompute está localizado. Para mais informações, consulte Endpoints.

        • <maxCompute_project_name>: Obrigatório. O nome do projeto do MaxCompute ao qual se conectar.

        • accessId: Obrigatório. O AccessKey ID com permissões para acessar o projeto do MaxCompute. Você pode obter seu AccessKey ID na página AccessKey Management.

        • accessKey: Obrigatório. O AccessKey Secret correspondente ao AccessKey ID.

        • interactiveMode: Opcional. Especifica se o recurso Query Acceleration deve ser ativado.

          Para ativar o Query Acceleration, adicione &interactiveMode=true ao final da URL. Para mais informações, consulte Query Acceleration.

    5. Clique em Test Connection. Uma conexão bem-sucedida é indicada pelo status Connected na caixa de diálogo Connection Test. Clique em OK para fechar esta caixa de diálogo e, em seguida, clique em Finish para concluir a configuração.

    Etapa 2: Consultar e analisar dados

    Após conectar o DBeaver ao MaxCompute, a nova conexão aparece no painel de navegação à esquerda. Use SQL para gerenciar seu projeto do MaxCompute. As seções a seguir descrevem operações comuns. Para uma lista completa de recursos, consulte a documentação do DBeaver.

    • Visualizar todas as tabelas

      Visualize informações sobre todas as tabelas na conexão do MaxCompute criada.

      No painel Database Navigator à esquerda, expanda o nó da conexão do MaxCompute, expanda o nome do banco de dados, expanda default e, em seguida, expanda Tables para exibir a lista de tabelas. Também é possível inserir uma palavra-chave na caixa de pesquisa na parte superior para filtrar tabelas por nome.

    • Visualizar o esquema da tabela

      Na conexão do MaxCompute, clique com o botão direito do mouse em uma tabela e selecione View Table.

      Por exemplo, a tabela sale_detail possui as cinco colunas a seguir: shop_name (STRING), customer_id (STRING), total_price (DOUBLE), sale_date (STRING) e region (STRING).

    • Visualizar dados da tabela

      • Na conexão do MaxCompute, clique em SQL Editor > New SQL Editor. No editor, insira e execute uma consulta SQL para a tabela desejada a fim de visualizar seus dados.

        Por exemplo, insira a consulta SELECT * FROM pyodps_ml_100k_lens;.

      • Caso a alternância de sintaxe de esquema não esteja ativada para seu projeto, visualize os dados clicando com o botão direito do mouse na tabela desejada sob a conexão do MaxCompute, selecionando View Table e clicando na aba Data. Para mais informações, consulte Alternância de sintaxe de esquema.

    Perguntas frequentes

    O que fazer se eu receber o erro "Internal error connecting to SQLite" ou falhar ao conectar ao MaxCompute usando o DBeaver?

    Cenário 1: O erro "Internal error connecting to SQLite" é relatado

    Esse erro geralmente é causado por um problema de configuração do cliente DBeaver ou pela ausência de um driver, não sendo um problema do service MaxCompute. Para resolver essa questão, execute as etapas a seguir:

    1. Verifique se o driver sqlite-jdbc está instalado no cliente DBeaver. Se o driver estiver ausente, baixe-o e instale-o.

    2. Siga as instruções na seção "Etapa 1: Conectar o DBeaver ao MaxCompute" deste tópico para verificar o nome da classe do driver, o modelo de URL e a configuração do pacote JAR.

    Cenário 2: O DBeaver falha ao conectar ao MaxCompute sem uma mensagem de erro específica ou com outros erros de compatibilidade

    A falha na conexão pode ser causada por incompatibilidade de versão do DBeaver. Recomendamos o uso do DBeaver Community Edition 24.3.1, versão indicada neste tópico. Evite utilizar versões muito recentes, como a 26.x, ou versões cuja compatibilidade não tenha sido verificada.