

# Utilizar um cliente PostgreSQL para se conectar ao seu cluster de banco de dados
<a name="babelfish-connect-PostgreSQL"></a>

Você pode utilizar um cliente PostgreSQL para se conectar ao Babelfish na porta do PostgreSQL. A partir da versão 5.1.0, o servidor do Babelfish impõe a criptografia de conexão de ponta a ponta por padrão. Atualize sua aplicação para que ela funcione com o novo certificado SSL/TLS. Para ter mais informações sobre certificados SSL/TLS, consulte [Como proteger dados do Aurora PostgreSQL com SSL/TLS](AuroraPostgreSQL.Security.md#AuroraPostgreSQL.Security.SSL).

## Utilizar o psql para se conectar ao cluster de banco de dados
<a name="babelfish-connect-psql"></a>

Você pode baixar o cliente PostgreSQL no site do [PostgreSQL](https://www.postgresql.org/download/). Siga as instruções específicas da versão de seu sistema operacional para instalar o psql.

Você pode consultar um cluster de bancos de dados Aurora PostgreSQL compatível com o Babelfish com o cliente de linha de comando `psql`. Ao conectar-se, utilize a porta do PostgreSQL (por padrão, a porta 5432). Normalmente, você não precisa especificar o número da porta, a menos que o tenha alterado do padrão. Utilize o comando a seguir para se conectar ao Babelfish a partir do cliente `psql`:

```
psql -h bfish-db.cluster-123456789012.aws-region.rds.amazonaws.com
-p 5432 -U postgres -d babelfish_db
```

Os parâmetros são os seguintes:
+ `-h`: o nome do host do cluster de banco de dados (endpoint do cluster) que você deseja acessar.
+ `-p`: o número da porta do PostgreSQL utilizado para conexão com sua instância de banco de dados.
+ `-d`: o banco de dados que você deseja acessar. O padrão é `babelfish_db`.
+ `-U`: a conta de usuário de banco de dados que você deseja acessar. (O exemplo mostra o nome de usuário principal padrão.)

Ao executar um comando SQL no cliente psql, você encerra o comando com um ponto-e-vírgula. Por exemplo, o comando SQL a seguir consulta a [visualização do sistema pg\$1tables](https://www.postgresql.org/docs/current/view-pg-tables.html) para retornar informações sobre cada tabela do banco de dados.

`SELECT * FROM pg_tables;`

O cliente psql também tem um conjunto de metacomandos integrados. Um *metacomando* é um atalho que ajusta a formatação ou fornece um atalho que retorna metadados em um formato fácil de utilizar. Por exemplo, o metacomando a seguir retorna informações semelhantes ao comando SQL anterior:

`\d`

Metacomandos não precisam ser encerrados com um ponto e vírgula (;).

Para sair do cliente psql, insira `\q`.

Para ter mais informações sobre como utilizar o cliente psql para consultar um cluster do Aurora PostgreSQL, consulte a [documentação do PostgreSQL](https://www.postgresql.org/docs/14/app-psql.html).

## Utilizar o pgAdmin para se conectar ao cluster de banco de dados
<a name="babelfish-connect-pgadmin"></a>

Você pode utilizar o cliente pgAdmin para acessar seus dados no dialeto do PostgreSQL nativo. 

**Para se conectar ao cluster com o cliente pgAdmin**

1. Baixe e instale o cliente pgAdmin acessando o [site do pgAdmin](https://www.pgadmin.org/).

1. Abra o cliente e autentique-se no pgAdmin.

1. Abra o menu contexto (clique com o botão direito do mouse) para **Servers** (Servidores) e depois escolha **Create** (Criar), **Server** (Servidor).  
![\[\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/pgAdmin1.png)

1. Insira informações na caixa de diálogo **Create - Server** (Criar - Servidor). 

   Na guia **Connection** (Conexão), adicione o endereço do cluster do Aurora PostgreSQL para **Host** e o número da porta do PostgreSQL (por padrão, 5432) para **Port** (Porta). Forneça detalhes de autenticação e escolha **Save** (Salvar).  
![\[\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/pgAdmin2.png)

Após a conexão, será possível utilizar a funcionalidade do pgAdmin para monitorar e gerenciar o cluster do Aurora PostgreSQL na porta do PostgreSQL.

![\[\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/pgAdmin3.png)


Para saber mais, consulte a página da web [pgAdmin](https://www.pgadmin.org/).