Use o DBeaver para acessar o Aurora DSQL - Amazon Aurora DSQL
DBeaver ProDBeaver Community EditionSolução de problemas

Use o DBeaver para acessar o Aurora DSQL

O DBeaver é um cliente SQL universal que pode ser usado para gerenciar qualquer banco de dados que tenha um driver JDBC. Ele é amplamente usado entre desenvolvedores e administradores de banco de dados por conta de seus recursos robustos de visualização, edição e gerenciamento de dados. Usando as opções de conectividade em nuvem do DBeaver, é possível conectar o DBeaver ao Aurora DSQL de forma nativa.

DBeaver Pro

Os produtos do DBeaver PRO oferecem integração nativa com o Aurora DSQL a partir da versão 25.3. Siga as instruções da documentação do DBeaver para se conectar a um cluster do Aurora DSQL.

DBeaver Community Edition

O DBeaver Community Edition é a versão gratuita e de código aberto. Acesse a página de download para ver instruções de instalação. Para se conectar ao DSQL usando o DBeaver Community Edition, é necessário instalar o plug-in do Aurora DSQL para DBeaver.

O plug-in do Aurora DSQL para DBeaver foi projetado com base no conector do Aurora DSQL para JDBC e permite a autenticação do IAM em clusters do Aurora DSQL. Ele é convenientemente instalado por meio da interface de usuário do DBeaver e elimina a necessidade de escrever código de geração de tokens ou fornecer manualmente um token válido do IAM, simplificando a autenticação e eliminando os riscos de segurança associados a senhas tradicionais geradas pelo usuário.

Recursos

  • Suporte à autenticação do IAM: conecte-se aos clusters do Aurora DSQL usando as credenciais do AWS IAM para realizar uma autenticação segura e sem senha.

  • Gerenciamento automático de drivers: instala e configura perfeitamente o conector do Aurora DSQL para JDBC.

  • Opções flexíveis de conexão: escolha entre configuração de conexão baseada em host ou no URL JDBC.

Instalação do plug-in do Aurora SQL para DBeaver

  1. Com o DBeaver aberto, acesse o menu suspenso Ajuda → Instalar novo software.

  2. Clique em Adicionar para adicionar um novo repositório.

  3. Insira:

    • Nome: Aurora DSQL Plugin

    • Local: https://awslabs.github.io/aurora-dsql-dbeaver-plugin/update-site/.

  4. Marque Conector do Aurora DSQL para JDBC.

  5. Clique em Próximo, aceite a licença e conclua a instalação

  6. Reinicie o DBeaver quando solicitado.

Crie uma conexão do Aurora DSQL.

  1. Clique em Nova conexão de banco de dados.

  2. Selecione Aurora DSQL.

  3. Em Servidor, selecione uma das seguintes opções para a configuração Conectar usando:

    • Host

      • Para habilitar as entradas de texto da interface de usuário para os seguintes campos:

        • Endpoint: endpoint de cluster do DSQL.

        • Nome de usuário: nome de usuário do DSQL (p. ex., admin).

        • Perfil da AWS: p. ex., padrão. O perfil padrão usado quando nenhum perfil específico é estipulado.

        • Região da AWS (opcional): deve corresponder à região em que o cluster do DSQL se encontra. Do contrário, a autenticação falhará.

    • URL do

      • URL JDBC neste formato: 

        jdbc:aws-dsql:postgresql://{cluster_endpoint}/{database}?user=admin&profile=default&region=us-east-1

      • Observação: nesse modo, somente a entrada de URL está habilitada. Para adicionar parâmetros à string de conexão JDBC, use o formato de parâmetros de consulta de URL começando com ? como o primeiro parâmetro e acrescente um & para os parâmetros subsequentes.

  4. Clique em Testar conexão para verificar se a conexão do Aurora DSQL está funcionando.

  5. Clique em Concluir.

Solução de problemas

Problema no Windows Trust Store

Os usuários do Windows podem encontrar problemas ao baixar o conector do Aurora DSQL para o driver JDBC por meio do Maven Central.

Causa: o Windows Trust Store pode não incluir os certificados necessários para acessar o repositório Maven Central.

Solução:

  1. Execute o DBeaver como “Administrador”.

  2. Desmarque esta configuração: Windows > Preferências > Conexões > “Usar o Windows Trust Store”.

Erro de driver ausente

Se você vir um ícone de driver ausente ou erros de conexão, o Aurora DSQL (plug-in do Community) pode não estar instalado em sua versão atual do DBeaver. Confira abaixo alguns exemplos de erros e como corrigi-los:

  • Criar uma conexão sem ter o driver instalado:

    Ícone de driver ausente no DBeaver

  • Tentar realizar uma conexão sem o driver:

    Caixa de diálogo de erro quando o driver está ausente

Causa: quando várias versões do DBeaver são instaladas, as configurações de conexão são compartilhadas, mas os drivers são instalados por aplicação.

Solução: reinstale o Aurora DSQL (plug-in do Community) seguindo as etapas de instalação acima.

Importante

Os recursos administrativos fornecidos pelo DBeaver para os bancos de dados PostgreSQL (como o Gerenciador de Sessões e o Gerenciador de Bloqueios) não se aplicam a bancos de dados do Aurora DSQL devido à respectiva arquitetura exclusiva. Embora acessíveis, essas telas não fornecem informações confiáveis sobre a integridade ou o status do banco de dados.