> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo Desplegar tu Primera Base de Datos Gestionada

> Tutorial paso a paso para alojar una base de datos gestionada MongoDB, PostgreSQL, MySQL o Redis en Square Cloud y conectarte a ella desde el código de tu aplicación.

## 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](https://squarecloud.app/es/signup).
* **Plan Standard o superior activo**: Las bases de datos gestionadas requieren un **plan Standard o superior activo**. Consulta los [planes disponibles](/es/platform/plans) 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

<Steps>
  <Step title="Crea una nueva instancia de base de datos">
    Ve a la página de [Databases](https://squarecloud.app/es/dashboard/databases) y haz clic en el botón "Crear base de datos".
  </Step>

  <Step title="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.
  </Step>

  <Step title="Finaliza la creación de tu instancia">
    Haz clic en el botón "Crear" y espera a que se cree la base de datos.
  </Step>
</Steps>

## 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](https://squarecloud.app/es/dashboard/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.

<Note>Las bases de datos de Square Cloud solo aceptan conexiones SSL/TLS. Consulta [cómo me conecto a mi base de datos](/es/services/databases#cómo-me-conecto-a-mi-base-de-datos) para ver cómo distintos clientes usan el certificado.</Note>

## 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.

<Tabs>
  <Tab title="Node.js">
    Instala el paquete [`pg`](https://www.npmjs.com/package/pg):

    ```bash theme={null}
    npm install pg
    ```

    Conéctate y verifica con una consulta simple:

    ```javascript index.js theme={null}
    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();
    ```
  </Tab>

  <Tab title="Python">
    Instala [`psycopg2`](https://pypi.org/project/psycopg2-binary/):

    ```bash theme={null}
    pip install psycopg2-binary
    ```

    Conéctate y verifica con una consulta simple:

    ```python main.py theme={null}
    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()
    ```
  </Tab>
</Tabs>

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.

<Warning>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](/es/getting-started/config-file) o el dashboard, para que las credenciales nunca terminen en tu repositorio.</Warning>

## 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í:

<CardGroup cols={2}>
  <Card title="Despliega una aplicación para usarla" icon="server" href="/es/tutorials/how-to-deploy-your-website">
    Aloja en Square Cloud la aplicación que se conecta a esta base de datos.
  </Card>

  <Card title="Snapshots" icon="camera" href="/es/cli-reference/commands/database/snapshot">
    Crea y restaura snapshots de bases de datos desde la CLI.
  </Card>
</CardGroup>

## Contáctanos

Si continúas enfrentando **dificultades técnicas**, nuestro **equipo de soporte especializado** está disponible para ayudarte. [**Contáctanos**](https://squarecloud.app/es/support) 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**](https://www.trustpilot.com/review/squarecloud.app) en Google y Trustpilot.