# Usar o driver do Aurora DSQL para SQLTools
<a name="accessing-vscode"></a>

 O driver do Aurora DSQL para SQLTools é uma extensão do Visual Studio Code para o Amazon Aurora DSQL que se integra ao SQLTools. Ele permite que os desenvolvedores se conectem e consultem bancos de dados do Aurora DSQL diretamente do VS Code. O driver está disponível para instalação no [Visual Studio Marketplace](https://marketplace.visualstudio.com) e no [Open VSX Registry](https://open-vsx.org/). O Kiro, o Cursor e outros IDEs baseados no VSCode podem usar o [Open VSX Registry](https://open-vsx.org/) para instalar o driver seguindo o procedimento de instalação padrão descrito na respectiva página. 

## Recursos
<a name="features"></a>
+  Autenticação automática do IAM 
+  Operações de banco de dados padrão, como procurar esquemas e tabelas e executar consultas SQL. 

## Instalação
<a name="installation"></a>

1.  Abra a visualização “Extensões”. 

1.  Pesquise “Driver do Aurora DSQL para SQLTools”. 

1.  Clique em “Instalar”. 

 **Observação:** 

 Se a [extensão do SQLTools](https://vscode-sqltools.mteixeira.dev) ainda não tiver sido instalada, ela será instalada automaticamente. 

## Autenticação
<a name="authentication"></a>

 No Aurora DSQL, todas as conexões usam a **autenticação baseada no IAM** com tokens de tempo limitado. O driver manipula automaticamente a autenticação do Aurora DSQL usando o [conector do Aurora DSQL para node-postgres](https://github.com/awslabs/aurora-dsql-connectors/tree/main/node/node-postgres). 

 Para acessar mais informações sobre autenticação no Aurora DSQL, consulte o [guia do usuário](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/authentication-authorization.html). 

## Crie uma conexão do Aurora DSQL.
<a name="create-an-aurora-dsql-connection"></a>

### Pré-requisitos
<a name="prerequisites"></a>
+  Credenciais da AWS configuradas (por meio da AWS CLI, de variáveis de ambiente ou perfis do IAM). 

### Steps
<a name="steps"></a>

1.  Clique no ícone do SQLTools na barra lateral à esquerda. 

1.  No painel do SQLTools, passe o mouse sobre CONEXÕES e clique no ícone “Adicionar nova conexão”. 

1.  Na guia “Configurações do SQLTools”, selecione “Driver do Aurora DSQL” na lista. 

1.  Preencha os parâmetros de conexão. 
   +  Região da AWS 
     +  Opcional: a região será analisada no endpoint do cluster do Aurora DSQL. 
     +  Obrigatório quando somente um ID de cluster é especificado no campo “Cluster do DSQL”. 
   +  Perfil da AWS 
     +  Usado para geração de tokens. 
     +  Se nenhum perfil for especificado, será o usado o padrão. 

1.  Clique no link “Testar conexão” para testá-la. 

1.  Clique em “Salvar conexão”.