Como Conectar ao PostgreSQL com JDBC na Square Cloud

Este tutorial guiará você pelas etapas para se conectar a um banco de dados PostgreSQL usando JDBC (Java Database Connectivity). O JDBC é uma API Java que permite conectar e executar consultas em bancos de dados.

Pré-requisitos

Antes de começar, certifique-se de ter criado um banco de dados na Square Cloud e conectado a algum cliente de gerenciamento, como o DBeaver, para efetuar a criação da sua estrutura de dados.

Passos para conectar ao PostgreSQL com JDBC

1. Obtenha os detalhes de conexão do seu PostgreSQL

Para conectar sua aplicação Java ao banco de dados PostgreSQL, você precisa obter suas credenciais de acesso:

• String de Conexão: A URL utilizada para se conectar ao seu banco de dados PostgreSQL.
• Certificado: Os arquivos de certificado SSL para garantir conexões seguras. Você precisará dos arquivos .crt e .key.

No painel, abra Banco de dados, clique no seu PostgreSQL e vá em Configurações > Conexão: lá estão a URL de conexão, o botão Redefinir senha e o download do certificado (.pem, .crt ou .key).
Nota: Se você não copiou a senha no momento em que criou o banco, precisará regenerar a senha no painel e colá-la na URL.

2. Crie o arquivo .pk8

O driver JDBC exige que o certificado de chave SSL esteja em um formato específico: um arquivo .pk8. Você pode criar este arquivo utilizando o utilitário OpenSSL.

Para converter o arquivo .key baixado do painel para o formato .pk8, execute o seguinte comando no seu terminal:

openssl pkcs8 -topk8 -inform PEM -in caminho/para/private-key.key -outform DER -out caminho/de/saida/private-key.pk8 -nocrypt

Lembre-se de substituir caminho/para/private-key.key e caminho/de/saida/private-key.pk8 pelos caminhos reais do seu sistema. Salve o arquivo private-key.pk8 gerado em uma pasta junto com os outros certificados necessários (por exemplo, em uma pasta chamada certs).

3. Atualize a DATABASE_URL

O Java não lê .env sozinho. Defina DATABASE_URL em Configurações > Variáveis de Ambiente da aplicação, leia-a com System.getenv("DATABASE_URL") e inclua a pasta certs no zip do deploy. O JDBC não aceita usuario:senha@host: passe usuário e senha como parâmetros. O .crt baixado serve como raiz e como certificado do cliente, e a chave .key convertida vira o .pk8. A estrutura final deve se parecer com isto:

DATABASE_URL="jdbc:postgresql://HOST:PORT/DATABASE?user=squarecloud&password=SENHA&sslmode=require&sslrootcert=certs/ca-certificate.crt&sslcert=certs/ca-certificate.crt&sslkey=certs/private-key.pk8"

Atualizado em: 04/10/2026