Cómo crear una base de datos PostgreSQL y conectar

1. Requisitos previos

Para seguir este tutorial, necesitarás:

• Plan Standard o superior: El alojamiento de bases de datos en Square Cloud es un recurso disponible a partir del plan Standard.
• Acceso al Dashboard: Tus credenciales de acceso a la plataforma Square Cloud.

2. Creando la instancia de base de datos

1. Accede al Dashboard de Square Cloud.
2. Accede a la página de Bases de datos y selecciona la opción Crear bases de datos.
3. Dale un nombre a tu instancia.
4. Elige PostgreSQL en la lista de bases de datos disponibles.
5. Selecciona la RAM deseada y confirma la creación.
6. Tras la inicialización, tendrás acceso a las credenciales fundamentales en una URL: Host, Port, User y Password.

Consejo: Para facilitar, Square Cloud ya inicia una database dentro de la instancia con el nombre "squarecloud", pero puedes crear la tuya propia dentro de la instancia.

3. Entendiendo los certificados SSL

Square Cloud exige conexiones cifradas para garantizar la seguridad de los datos. A diferencia de las conexiones locales, aquí necesitarás certificados específicos proporcionados por la plataforma.

En la pestaña de configuraciones de tu base de datos, encontrarás las siguientes opciones de descarga:

• certificate.pem: Es un archivo combinado que contiene la clave privada (key) y el certificado (cert). Para la mayoría de los drivers de conexión, este es el único archivo necesario.
• client-key.key y client-cert.crt: Disponibles por separado para sistemas o drivers que exigen archivos individuales para la clave y para el certificado.

Atención: Algunos ORMs y drivers pueden requerir un certificado .p12 como PrismaORM v6 y la CLI; si es el caso, descarga el certificate.pem y genera el p12.

4. Configuración técnica de la conexión

Para PostgreSQL, la conexión segura se establece apuntando los parámetros de SSL al archivo de certificado. El secreto técnico aquí es que, al utilizar el mismo certificate.pem, este sirve tanto para validar el servidor como para identificar al cliente:

• sslcert: Ruta al certificate.pem
• sslrootcert: Ruta al certificate.pem

Ejemplo de connection string (URI)

Si te conectas vía string de conexión directa, el formato será:

postgresql://squarecloud:{password}@square-cloud-db-{id}.squareweb.app:{port}/{dbname}?sslmode=verify-ca&sslkey=./certificate.pem&sslcert=./certificate.pem&sslrootcert=./certificate.pem

Ejemplos de datos separados

Si tu conexión es por los datos separados, basta con seguir los ejemplos a continuación:

• Ejemplo Python:

import psycopg2

conn = psycopg2.connect(
    host="square-cloud-db-{id}.squareweb.app",
    port=7072,
    user="squarecloud",
    password="password",
    database="squarecloud",
    sslmode="verify-ca",
    sslrootcert="ca-certificate.crt",
    sslkey="private-key.key",
    sslcert="certificate.pem"
)

• Ejemplo JavaScript:

import { Client } from "pg";
import fs from "fs";

const client = new Client({
  host: "square-cloud-db-{id}.squareweb.app",
  port: 7072,
  user: "squarecloud",
  password: "password",
  database: "squarecloud",
  ssl: {
    rejectUnauthorized: true,
    ca: fs.readFileSync("ca-certificate.crt").toString(),
    key: fs.readFileSync("private-key.key").toString(),
    cert: fs.readFileSync("certificate.pem").toString(),
  },
});

async connect(){
  try {
    await client.connect();
    console.log("Conectado ao banco!");
  } catch (err) {
    console.error("Erro ao conectar:", err);
  }
};
connect();

5. Buenas prácticas y seguridad

• Archivo .gitignore: Nunca envíes tus archivos .pem, .key o .crt a repositorios públicos (GitHub/GitLab). Añádelos a tu .gitignore.

Extra

Para una mejor visualización, mira nuestro vídeo tutorial: https://www.youtube.com/watch?v=YipIaaqYtBI

Actualizado el: 13/06/2026