Pular para o conteúdo principal

​
Introdução

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

  • Conta Square Cloud: Plataforma de hospedagem para seu aplicativo. Cadastre-se através da página de cadastro usando seu e-mail.
  • Plano Pago Ativo: Garante recursos dedicados e desempenho otimizado para seu aplicativo. Confira nossos planos disponíveis e escolha o mais adequado às suas necessidades.
  • 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 ou qualquer outro para criar um banco de dados.

​
Passos para conectar ao PostgreSQL com JDBC

Obtenha os detalhes de conexão do seu PostgreSQL

Obtenha seus detalhes de conexão do PostgreSQL. Para conectar sua aplicação Java ao seu banco de dados PostgreSQL, você precisa dos seguintes detalhes:
  • String de Conexão: A string de conexão para se conectar ao seu banco de dados PostgreSQL.
  • Certificado: O certificado SSL para conexões seguras, use os certificados .crt e .key.
Você pode encontrar esses detalhes no painel da Square Cloud na seção “Databases”. Clique no seu banco de dados PostgreSQL para visualizar seus detalhes de conexão e, em seguida, vá para a aba “Configuration” para encontrar a string de conexão. Se você não a copiou quando criou, precisará regenerar a senha e colá-la na URL.

Criando o pk8

O JDBC exige que o certificado de chave SSL esteja em um formato específico, um arquivo .pk8. Você pode criar este arquivo usando o OpenSSL. Para converter o arquivo .key para .pk8, você pode usar o seguinte comando OpenSSL:
openssl pkcs8 -topk8 -inform PEM -in path/to/private-key.key -outform DER -out path/to/create/private-key.pk8 -nocrypt
Substitua path/to/key.key pelos caminhos reais para o seu arquivo de chave. Salve o arquivo private-key.pk8 em uma pasta com os outros certificados necessários, por exemplo, em uma pasta chamada certs.

Atualize a DATABASE_URL

Atualize seu arquivo .env para incluir a string de conexão e a configuração SSL. No seu projeto Java ou Prisma, localize o arquivo .env e atualize a variável DATABASE_URL com sua string de conexão PostgreSQL. Certifique-se de incluir a configuração SSL na string de conexão. Ela deve se parecer com isto:
DATABASE_URL="jdbc:postgresql://host:port/database?sslrootcert=path/to/ca-certificate.crt&sslcert=path/to/client-certificate.crt&sslkey=path/to/private-key.pk8"