Pular para o conteúdo principal

Introdução

  • Este tutorial irá guiá-lo pelos passos para conectar o Prisma ao seu banco de dados PostgreSQL hospedado na Square Cloud.
  • Primeiro, você precisa ter um plano pago ativo em sua conta. Você pode ver nossos planos e adquirir um de acordo com sua necessidade aqui.
  • Em seguida, você precisará de um banco de dados PostgreSQL hospedado na Square Cloud. Se ainda não criou um, você pode criá-lo aqui.

Pré-requisitos

  • Antes de começar, certifique-se de ter criado um banco de dados na Square Cloud e de estar conectado a ele usando um cliente de gerenciamento, como o DBeaver, ou outro de sua preferência para criar o esquema.
  • Você também precisará ter o Prisma configurado no seu projeto. Se ainda não fez isso, siga a documentação oficial do Prisma aqui.

Conectando o prisma ao postgreSQL

Para conectar o Prisma ao PostgreSQL, você precisará das informações de conexão: URL e certificados.

URL do banco de dados

A URL do banco de dados, disponível nas configurações de conexão, fornece usuário, senha, host e porta para sua conexão. O Prisma pode exigir que você especifique o nome do banco de dados na URL:
postgresql://username:password@host:port/dbname
Se você ainda não tiver criado um banco de dados específico, pode usar squarecloud como nome do banco:
postgresql://username:password@host:port/squarecloud

Certificados

1

Obtendo os certificados base

Nas configurações de conexão do banco, faça o download de certificate.pem. Com esse arquivo, faça duas cópias: em uma remova a parte da chave e na outra remova a parte do certificado. Nomeie-os como key.pem e cert.pem para identificar claramente.
2

Criando client-identity.p12

Com os dois arquivos .pem (key e cert), você criará o arquivo .p12. Para isso, é necessário ter o OpenSSL instalado ou usá-lo via Git Bash. Para converter os arquivos .pem em .p12, use o comando OpenSSL abaixo:
openssl pkcs12 -export -out path/to/create/client-identity.p12 -inkey path/to/key.pem -in path/to/cert.pem
Substitua path/to/key.pem e path/to/cert.pem pelos caminhos reais dos seus arquivos. Você será solicitado a definir uma senha de exportação — lembre-se dessa senha, pois será necessária posteriormente. Salve client-identity.p12 em uma pasta dentro da pasta prisma, por exemplo prisma/certs.
3

Configurando o certificado

Atualize seu arquivo .env para incluir a string de conexão com a configuração SSL. No seu projeto Prisma, localize o arquivo .env e atualize a variável DATABASE_URL com a string de conexão do PostgreSQL. Certifique-se de incluir a configuração SSL na string de conexão, por exemplo:
DATABASE_URL="postgresql://username:password@host:port/database?sslidentity=./certs/client-identity.p12&sslpassword=your_export_password"