Cómo Desplegar tu Primera Base de Datos Gestionada

Introducción

Este tutorial te lleva de cero a una base de datos en vivo y conectada en pocos minutos: crea la instancia desde el dashboard, obtén su cadena de conexión, y conéctate a ella desde tu propio código.

Requisitos previos

Cuenta de Square Cloud: Crea tu cuenta a través de la página de registro.
Plan Standard o superior activo: Las bases de datos gestionadas requieren un plan Standard o superior activo. Consulta los planes disponibles y elige el que mejor se adapte a tu carga de trabajo.

Paso 1: Elige un motor

Square Cloud ofrece cuatro motores de bases de datos gestionadas, ya configurados para conectarse y empezar a usar:

Motor	Versión
PostgreSQL	17.x.x
MongoDB	8.x.x
MySQL	9.x.x
Redis	7.4.x

Este tutorial usa PostgreSQL, pero el mismo flujo del dashboard aplica a todos los motores anteriores.

Paso 2: Crea la base de datos

Crea una nueva instancia de base de datos

Ve a la página de Databases y haz clic en el botón “Crear base de datos”.

Configura tu instancia de base de datos

Selecciona PostgreSQL (o el motor que elegiste en el Paso 1) y completa la información requerida, como el nombre de la base de datos y la RAM.

Finaliza la creación de tu instancia

Haz clic en el botón “Crear” y espera a que se cree la base de datos.

Paso 3: Obtén la cadena de conexión

Una vez que tu base de datos esté lista, ábrela desde la página de Databases. Los detalles de conexión (host, puerto, usuario, contraseña y URL de conexión) se muestran en el dashboard de la base de datos, junto con el certificado TLS que necesitarás para conectarte.

Las bases de datos de Square Cloud solo aceptan conexiones SSL/TLS. Consulta cómo me conecto a mi base de datos para ver cómo distintos clientes usan el certificado.

Paso 4: Conéctate desde tu código

Con la cadena de conexión en mano, conéctate usando el cliente de PostgreSQL de tu lenguaje.

Node.js
Python

Instala el paquete pg:

npm install pg

Conéctate y verifica con una consulta simple:

index.js

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

const cert = fs.readFileSync("certificate.pem").toString();

const client = new Client({
  connectionString: process.env.DATABASE_URL, // postgresql://user:password@host:port/dbname
  ssl: { ca: cert, cert: cert, key: cert },
});

await client.connect();
const result = await client.query("SELECT 1");
console.log("Connected! Result:", result.rows[0]);
await client.end();

Instala psycopg2:

pip install psycopg2-binary

Conéctate y verifica con una consulta simple:

main.py

import os
import psycopg2

conn = psycopg2.connect(
    os.environ["DATABASE_URL"],  # postgresql://user:password@host:port/dbname
    sslmode="verify-ca",
    sslrootcert="certificate.pem",
    sslcert="certificate.pem",
    sslkey="certificate.pem",
)
cur = conn.cursor()
cur.execute("SELECT 1")
print("Connected! Result:", cur.fetchone())
cur.close()
conn.close()

Si la consulta devuelve un resultado en lugar de lanzar un error de conexión, tu aplicación está hablando con la base de datos correctamente.

Nunca hardcodees la cadena de conexión en tu código fuente. Configúrala como una variable de entorno (DATABASE_URL) a través de tu archivo de configuración o el dashboard, para que las credenciales nunca terminen en tu repositorio.

Tu base de datos está en vivo

Ahora tienes una base de datos gestionada corriendo y accesible desde tu código. A partir de aquí:

Despliega una aplicación para usarla

Aloja en Square Cloud la aplicación que se conecta a esta base de datos.

Snapshots

Crea y restaura snapshots de bases de datos desde la CLI.

Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema — la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot.

Tutoriales

Bots

Proyectos listos

Bases de datos

APIs

Sitios web

Guías de migración

Cómo Desplegar tu Primera Base de Datos Gestionada

Introducción

Requisitos previos

Paso 1: Elige un motor

Paso 2: Crea la base de datos

Paso 3: Obtén la cadena de conexión

Paso 4: Conéctate desde tu código

Tu base de datos está en vivo

Despliega una aplicación para usarla

Snapshots

Contáctanos

​Introducción

​Requisitos previos

​Paso 1: Elige un motor

​Paso 2: Crea la base de datos

​Paso 3: Obtén la cadena de conexión

​Paso 4: Conéctate desde tu código

​Tu base de datos está en vivo

Despliega una aplicación para usarla

Snapshots

​Contáctanos

Introducción

Requisitos previos

Paso 1: Elige un motor

Paso 2: Crea la base de datos

Paso 3: Obtén la cadena de conexión

Paso 4: Conéctate desde tu código

Tu base de datos está en vivo

Contáctanos