> ## 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 sur Square Cloud : connexion, permissions et limites

> MySQL géré sur Square Cloud : chaîne de connexion, TLS obligatoire, caching_sha2_password, privilèges de l'utilisateur, import de dumps avec DEFINER, buffer pool, slow query log et erreurs courantes.

Une instance MySQL gérée qui n'accepte que les connexions TLS, avec un utilisateur qui gère ses propres bases de données, utilisateurs, routines et événements. Les informations communes à tous les moteurs (limites, snapshots, Insights) se trouvent dans la [vue d'ensemble des bases de données](https://docs.squarecloud.app/fr/services/databases.md).

## Se connecter

Copiez l'URL de connexion depuis la page de la base de données dans le tableau de bord. Elle a cette forme, avec l'utilisateur `squarecloud` et la base de données `squarecloud` créés pour vous :

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

MySQL exige **SSL/TLS** ; aucun certificat client n'est nécessaire. Utilisez `ssl-mode=REQUIRED`, ou `VERIFY_CA` avec le `.pem` de **Connexion** → **Certificat SSL/TLS** comme CA pour vérifier aussi le serveur.

Le serveur n'accepte que l'authentification `caching_sha2_password`. Les pilotes plus anciens qui ne la prennent pas en charge, comme le paquet npm `mysql`, n'arrivent pas à s'authentifier : utilisez `mysql2` sur Node.js ou un connecteur récent.

> [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
> ```

Le serveur ne résout pas les noms d'hôte : quand vous créez des utilisateurs, leur partie hôte est une adresse IP ou `'%'`.

Les ORM et les outils graphiques (Prisma, MySQL Workbench, DBeaver, HeidiSQL) sont traités dans [les erreurs de connexion aux bases de données](https://docs.squarecloud.app/fr/platform/troubleshooting/database-connection-errors.md).

## Connexions

Chaque base de données accepte jusqu'à 256 connexions simultanées ; au-delà, les nouvelles échouent avec `Too many connections`. Créez **un seul pool par processus** au démarrage et réutilisez-le, dimensionné pour que l'ensemble des applications, workers et shards reste sous la limite. L'onglet **Insights** montre qui détient les connexions ouvertes.

## Votre utilisateur et ses permissions

L'utilisateur `squarecloud@'%'` a tous les privilèges, avec `GRANT OPTION`, sauf les privilèges administratifs. Vous pouvez créer des bases de données, des utilisateurs et des droits, des routines, des triggers et des événements, et modifier les variables globales avec `SET GLOBAL` et `SET PERSIST`.

Ce que les privilèges administratifs permettraient n'est pas disponible :

* les fichiers côté serveur : `LOAD DATA INFILE` et `SELECT ... INTO OUTFILE` ;
* `FLUSH PRIVILEGES`, qui répond `ERROR 1227`. Il n'est pas nécessaire : `GRANT`, `CREATE USER` et `ALTER USER` s'appliquent immédiatement ;
* `SHOW ENGINE INNODB STATUS` ;
* la réplication.

## Importer un dump

Les dumps réalisés sur un autre serveur portent souvent `DEFINER=root@localhost` (ou un autre compte administratif) sur les vues, routines, triggers et événements. Leur import échoue avec `ERROR 1227 (42000): Access denied; you need (at least one of) the ... privilege(s)`. Supprimez ces clauses avant l'import, ou remplacez-les par votre propre utilisateur :

```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
```

## Configuration

* **Pas de journal binaire (binary log).** La réplication, la capture des changements (Debezium et similaires) et la restauration à un instant donné (point-in-time recovery) ne sont pas disponibles.
* **Buffer pool :** `innodb_buffer_pool_size` garde la valeur par défaut de MySQL, **128 Mo** ; elle n'augmente pas avec la RAM de la base de données. Vous pouvez l'augmenter dans la limite de la RAM allouée, en laissant de la place aux connexions et au serveur lui-même (environ la moitié de la RAM est un point de départ sûr) :
  ```sql theme={"system"}
  SET PERSIST innodb_buffer_pool_size = 536870912; -- 512 MB
  ```
  Une valeur persistée est perdue quand la base de données est restaurée depuis un snapshot ou mise à niveau : redéfinissez-la ensuite.
* **`max_allowed_packet`** vaut 64 Mo, la plus grande instruction ou ligne unique que le serveur accepte.
* Le reste de la configuration du serveur est le même sur chaque base de données.

## Requêtes lentes

L'onglet **Insights** liste les instructions par temps moyen (toute instruction dont une exécution a pris 100 ms ou plus). Pour le slow query log brut, activez-le : il est écrit dans la table `mysql.slow_log` au même seuil de 100 ms, n'expire jamais et utilise le stockage de la base de données, donc videz-le quand vous avez terminé :

```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 MySQL contient vos schémas, routines, triggers, événements et utilisateurs, exportés en une seule transaction : cohérent pour les tables InnoDB, sans garantie pour MyISAM. En plus des [cas généraux](https://docs.squarecloud.app/fr/services/databases.md#snapshots-et-restauration), il échoue quand votre propre `LOCK TABLES` le bloque pendant plus de 5 minutes. L'export est du texte SQL brut, donc une base de données proche de ses 10 Go de stockage peut ne pas tenir dans un snapshot.

## Erreurs courantes

| Message | Ce que ça signifie | Que faire |
| :- | :- | :- |
| `Connections using insecure transport are prohibited while --require_secure_transport=ON` | Le client s'est connecté sans SSL/TLS. | Activez SSL/TLS (`ssl-mode=REQUIRED`). |
| `ER_NOT_SUPPORTED_AUTH_MODE` | Le pilote ne prend pas en charge `caching_sha2_password`. | Passez à `mysql2` ou à un connecteur récent. |
| `Too many connections` | Les 256 connexions sont toutes utilisées. | Utilisez un seul pool partagé par processus ; voir [Connexions](#connexions). |
| `ERROR 1227 (42000): Access denied; you need ... privilege(s)` | L'instruction exige un privilège administratif, ou un dump porte `DEFINER=root`. | Retirez `FLUSH PRIVILEGES` ; supprimez les clauses `DEFINER`. |
| `Got a packet bigger than 'max_allowed_packet' bytes` | Une instruction ou une ligne dépasse 64 Mo. | Découpez-la en insertions plus petites. |
| `The table '...' is full` | Les 10 Go de stockage sont pleins : les écritures échouent. | Supprimez des données ; voir [disque plein](https://docs.squarecloud.app/fr/platform/troubleshooting/database-performance.md#le-disque-est-plein). |

Après un arrêt forcé, MySQL exécute sa récupération après crash au démarrage suivant, ce qui prend plus de temps sur les grandes bases de données : attendez qu'elle se termine.

## Contactez-nous

Si vous rencontrez toujours des **difficultés techniques**, notre **équipe de support spécialisée** est disponible pour vous aider. [**Contactez-nous**](https://squarecloud.app/fr/support) et nous serons ravis de vous aider à résoudre tout problème. La qualité du support compte pour beaucoup dans la note que les développeurs donnent à Square Cloud, [**4,9/5 sur 402 avis**](https://www.trustpilot.com/review/squarecloud.app) sur Google et Trustpilot.


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