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

# MySQL en Square Cloud: conexión, permisos y límites

> MySQL gestionado en Square Cloud: cadena de conexión, TLS obligatorio, caching_sha2_password, privilegios del usuario, importar dumps con DEFINER, buffer pool, slow query log y errores comunes.

Una instancia de MySQL gestionada que solo acepta conexiones TLS, con un usuario que puede administrar sus propias bases de datos, usuarios, rutinas y eventos. Lo que comparten todos los motores (límites, snapshots, Insights) está en la [visión general de bases de datos](https://docs.squarecloud.app/es/services/databases.md).

## Conectarse

Copia la URL de conexión desde la página de la base de datos en el dashboard. Tiene esta forma, con el usuario `squarecloud` y la base de datos `squarecloud` creados para ti:

```
mysql://squarecloud:PASSWORD@HOST:PORT/squarecloud
```

MySQL exige **SSL/TLS**; no se necesita certificado de cliente. Usa `ssl-mode=REQUIRED`, o `VERIFY_CA` con el `.pem` de **Conexión** → **Certificado SSL/TLS** como CA para verificar también el servidor.

El servidor solo acepta la autenticación `caching_sha2_password`. Los drivers más antiguos que no la tienen, como el paquete `mysql` de npm, no logran iniciar sesión: usa `mysql2` en Node.js o un conector actual.

> [tab] Node.js
>
> ```javascript theme={"system"}
> import fs from "node:fs";
> import mysql from "mysql2/promise";
>
> // One pool for the whole process, created once and reused.
> export const pool = mysql.createPool({
>   uri: process.env.DATABASE_URL,
>   ssl: { ca: fs.readFileSync("certificate.pem", "utf8") },
>   connectionLimit: 10,
> });
>
> const [rows] = await pool.query("SELECT NOW()");
> ```

> [tab] Python
>
> ```python theme={"system"}
> import os
> from urllib.parse import urlparse, unquote
> import pymysql
>
> url = urlparse(os.environ["DATABASE_URL"])
> conn = pymysql.connect(
>     host=url.hostname,
>     port=url.port,
>     user=unquote(url.username),
>     password=unquote(url.password),
>     database=url.path.lstrip("/"),
>     ssl={"ca": "certificate.pem"},
> )
> ```

> [tab] mysql CLI
>
> ```bash theme={"system"}
> mysql --host=HOST --port=PORT --user=squarecloud --password \
>   --ssl-mode=VERIFY_CA --ssl-ca=certificate.pem squarecloud
> ```

El servidor no resuelve nombres de host: cuando creas usuarios, su parte de host es una dirección IP o `'%'`.

Los ORM y las herramientas gráficas (Prisma, MySQL Workbench, DBeaver, HeidiSQL) se tratan en [errores de conexión a bases de datos](https://docs.squarecloud.app/es/platform/troubleshooting/database-connection-errors.md).

## Conexiones

Cada base de datos acepta hasta 256 conexiones simultáneas; a partir de ahí, las nuevas fallan con `Too many connections`. Crea **un pool por proceso** al iniciar y reutilízalo, dimensionado para que todas las aplicaciones, workers y shards juntos queden por debajo del límite. La pestaña **Insights** muestra quién mantiene las conexiones abiertas.

## Tu usuario y permisos

El usuario `squarecloud@'%'` tiene todos los privilegios, con `GRANT OPTION`, excepto los administrativos. Puedes crear bases de datos, usuarios y permisos, rutinas, triggers y eventos, y cambiar variables globales con `SET GLOBAL` y `SET PERSIST`.

Lo que permitirían los privilegios administrativos no está disponible:

* archivos del lado del servidor: `LOAD DATA INFILE` y `SELECT ... INTO OUTFILE`;
* `FLUSH PRIVILEGES`, que responde `ERROR 1227`. No hace falta: `GRANT`, `CREATE USER` y `ALTER USER` se aplican de inmediato;
* `SHOW ENGINE INNODB STATUS`;
* la replicación.

## Importar un dump

Los dumps sacados de otro servidor suelen llevar `DEFINER=root@localhost` (u otra cuenta administrativa) en vistas, rutinas, triggers y eventos. Importarlos falla con `ERROR 1227 (42000): Access denied; you need (at least one of) the ... privilege(s)`. Elimina esas cláusulas antes de importar, o cámbialas por tu propio usuario:

```bash theme={"system"}
sed -E 's/DEFINER=`[^`]+`@`[^`]+`//g' dump.sql > dump-clean.sql
mysql --host=HOST --port=PORT --user=squarecloud --password \
  --ssl-mode=REQUIRED squarecloud < dump-clean.sql
```

## Configuración

* **Sin binary log.** La replicación, la captura de cambios (Debezium y similares) y la recuperación a un punto en el tiempo no están disponibles.
* **Buffer pool:** `innodb_buffer_pool_size` mantiene el valor por defecto de MySQL, **128 MB**; no crece con la RAM de la base de datos. Puedes aumentarlo dentro de la RAM que asignaste, dejando espacio para las conexiones y el propio servidor (cerca de la mitad de la RAM es un punto de partida seguro):
  ```sql theme={"system"}
  SET PERSIST innodb_buffer_pool_size = 536870912; -- 512 MB
  ```
  Un valor persistido se pierde cuando la base de datos se restaura desde un snapshot o se actualiza: vuelve a configurarlo después.
* **`max_allowed_packet`** es de 64 MB, la sentencia o fila más grande que acepta el servidor.
* El resto de la configuración del servidor es la misma en todas las bases de datos.

## Consultas lentas

La pestaña **Insights** lista las sentencias por tiempo medio (cualquier sentencia con una ejecución de 100 ms o más). Para el slow query log sin procesar, actívalo: se escribe en la tabla `mysql.slow_log` con el mismo umbral de 100 ms, nunca expira y usa el almacenamiento de la base de datos, así que vacíalo cuando termines:

```sql theme={"system"}
SET GLOBAL slow_query_log = ON;
SELECT start_time, query_time, sql_text FROM mysql.slow_log ORDER BY start_time DESC LIMIT 10;
TRUNCATE TABLE mysql.slow_log;
SET GLOBAL slow_query_log = OFF;
```

## Snapshots

Un snapshot de MySQL contiene tus esquemas, rutinas, triggers, eventos y usuarios, exportados en una sola transacción: consistente para las tablas InnoDB, sin garantía para MyISAM. Además de los [casos generales](https://docs.squarecloud.app/es/services/databases.md#snapshots-y-restauración), falla cuando tu propio `LOCK TABLES` lo impide durante más de 5 minutos. La exportación es texto SQL plano, así que una base de datos cerca de sus 10 GB de almacenamiento puede no caber en un snapshot.

## Errores comunes

| Mensaje | Qué significa | Qué hacer |
| :- | :- | :- |
| `Connections using insecure transport are prohibited while --require_secure_transport=ON` | El cliente se conectó sin SSL/TLS. | Activa SSL/TLS (`ssl-mode=REQUIRED`). |
| `ER_NOT_SUPPORTED_AUTH_MODE` | Al driver le falta `caching_sha2_password`. | Cambia a `mysql2` o a un conector actual. |
| `Too many connections` | Las 256 conexiones están en uso. | Usa un solo pool compartido por proceso; consulta [Conexiones](#conexiones). |
| `ERROR 1227 (42000): Access denied; you need ... privilege(s)` | La sentencia necesita un privilegio administrativo, o un dump lleva `DEFINER=root`. | Quita `FLUSH PRIVILEGES`; elimina las cláusulas `DEFINER`. |
| `Got a packet bigger than 'max_allowed_packet' bytes` | Una sentencia o fila supera los 64 MB. | Divídela en inserts más pequeños. |
| `The table '...' is full` | Los 10 GB de almacenamiento están llenos: las escrituras fallan. | Elimina datos; consulta [disco lleno](https://docs.squarecloud.app/es/platform/troubleshooting/database-performance.md#el-disco-está-lleno). |

Después de una detención forzada, MySQL ejecuta su recuperación tras fallo en el siguiente inicio, que tarda más en bases de datos grandes: espera a que termine.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.