Conectarse
Copia la URL de conexión desde la página de la base de datos en el dashboard. Tiene esta forma, con el usuariosquarecloud y la base de datos squarecloud creados para ti:
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.
- Node.js
- Python
- mysql CLI
'%'.
Los ORM y las herramientas gráficas (Prisma, MySQL Workbench, DBeaver, HeidiSQL) se tratan en errores de conexión a bases de datos.
Conexiones
Cada base de datos acepta hasta 256 conexiones simultáneas; a partir de ahí, las nuevas fallan conToo 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 usuariosquarecloud@'%' 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 INFILEySELECT ... INTO OUTFILE; FLUSH PRIVILEGES, que respondeERROR 1227. No hace falta:GRANT,CREATE USERyALTER USERse aplican de inmediato;SHOW ENGINE INNODB STATUS;- la replicación.
Importar un dump
Los dumps sacados de otro servidor suelen llevarDEFINER=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:
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_sizemantiene 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):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_packetes 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 tablamysql.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:
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, falla cuando tu propioLOCK 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
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.

