# 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](https://dbeaver.com/docs/dbeaver/Database-driver-Aurora-DSQL/) 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](https://dbeaver.io/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](https://github.com/awslabs/aurora-dsql-dbeaver-plugin).
O [plug-in do Aurora DSQL para DBeaver](https://github.com/awslabs/aurora-dsql-dbeaver-plugin) foi projetado com base no [conector do Aurora DSQL para JDBC](https://github.com/awslabs/aurora-dsql-jdbc-connector) 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**.
1. Clique em **Adicionar** para adicionar um novo repositório.
1. Insira:
+ **Nome**: `Aurora DSQL Plugin`
+ **Local**: `https://awslabs.github.io/aurora-dsql-dbeaver-plugin/update-site/`.
1. Marque **Conector do Aurora DSQL para JDBC**.
1. Clique em **Próximo**, aceite a licença e conclua a instalação
1. Reinicie o DBeaver quando solicitado.
### Crie uma conexão do Aurora DSQL.
1. Clique em **Nova conexão de banco de dados**.
1. Selecione **Aurora DSQL**.
1. 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®ion=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.
1. Clique em **Testar conexão** para verificar se a conexão do Aurora DSQL está funcionando.
1. 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”.
1. 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:
+ Tentar realizar uma conexão sem o driver:
**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.