# Usar o terminal interativo do PostgreSQL (psql) para acessar o Aurora DSQL
<a name="accessing-psql"></a>

## Use o AWS CloudShell para acessar o Aurora DSQL com o terminal interativo do PostgreSQL (psql).
<a name="accessing-sql-clients-psql"></a>

Use o procedimento a seguir para acessar o Aurora DSQL com o terminal interativo do PostgreSQL do AWS CloudShell. Para obter mais informações, consulte [ O que é o AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html).

**Como se conectar usando AWS CloudShell**

1. Faça login no [console do Aurora DSQL](https://console.aws.amazon.com/dsql).

1. Escolha o cluster que você deseja abrir no CloudShell. Se você ainda não criou um cluster, siga as etapas em [Etapa 1: criar um cluster do Aurora DSQL de região única](getting-started.md#getting-started-create-cluster) ou [Criar um cluster multirregional](getting-started.md#getting-started-multi-region).

1. Escolha **Conectar com o Editor de consultas** e, depois, selecione **Conectar com o CloudShell**.

1. Escolha se você deseja se conectar como administrador ou com um [perfil de banco de dados personalizado](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/authentication-authorization.html#authentication-authorization-iam-role-connect).

1. Escolha **Iniciar no CloudShell** e selecione **Executar** na caixa de diálogo do CloudShell a seguir.

## Use a CLI local para acessar o Aurora DSQL com o terminal interativo do PostgreSQL (psql).
<a name="accessing-sql-clients-psql-local"></a>

Use `psql`, um frontend baseado em terminal para o utilitário PostgreSQL, para inserir consultas interativamente, emiti-las para o PostgreSQL e visualizar os resultados da consulta.

**nota**  
Para melhorar os tempos de resposta das consultas, use o cliente PostgreSQL versão 17. Se você usar a CLI em um ambiente diferente, configure manualmente o Python versão 3.8\+ e o psql versão 14\+.

Baixe o instalador do seu sistema operacional na página [PostgreSQL Downloads](https://www.postgresql.org/download/). Para acessar mais informações sobre `psql`, consulte [Aplicações cliente do PostgreSQL](https://www.postgresql.org/docs/current/app-psql.htm) no site do *PostgreSQL*.

Se você já tem a AWS CLI instalada, use o exemplo a seguir para se conectar ao cluster.

```
# Aurora DSQL requires a valid IAM token as the password when connecting.  
# Aurora DSQL provides tools for this and here we're using Python.  
export PGPASSWORD=$(aws dsql generate-db-connect-admin-auth-token \
  --region {{us-east-1}} \
  --expires-in 3600 \
  --hostname {{your_cluster_endpoint}})  
  
# Aurora DSQL requires SSL and will reject your connection without it.  
export PGSSLMODE=require  
  
# Connect with psql, which automatically uses the values set in PGPASSWORD and PGSSLMODE.  
# Quiet mode suppresses unnecessary warnings and chatty responses but still outputs errors.  
psql --quiet \
  --username admin \
  --dbname postgres \
  --host {{your_cluster_endpoint}}
```