> ## 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 su Square Cloud: connessione, permessi e limiti

> MySQL gestito su Square Cloud: connection string, TLS obbligatorio, caching_sha2_password, privilegi dell'utente, importazione di dump con DEFINER, buffer pool, slow query log ed errori comuni.

Un'istanza MySQL gestita che accetta solo connessioni TLS, con un utente che può gestire i propri database, utenti, routine ed eventi. Le informazioni comuni a tutti i motori (limiti, snapshot, Insights) si trovano nella [panoramica dei database](https://docs.squarecloud.app/it/services/databases.md).

## Connettersi

Copia l'URL di connessione dalla pagina del database nella dashboard. Ha questa forma, con l'utente `squarecloud` e il database `squarecloud` creati per te:

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

MySQL richiede **SSL/TLS**; il certificato client non serve. Usa `ssl-mode=REQUIRED`, oppure `VERIFY_CA` con il `.pem` di **Connessione** → **Certificato SSL/TLS** come CA per verificare anche il server.

Il server accetta solo l'autenticazione `caching_sha2_password`. I driver più vecchi che non la supportano, come il pacchetto npm `mysql`, non riescono ad accedere: usa `mysql2` su Node.js o un connettore recente.

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

Il server non risolve i nomi host: quando crei utenti, la loro parte host è un indirizzo IP o `'%'`.

ORM e strumenti grafici (Prisma, MySQL Workbench, DBeaver, HeidiSQL) sono trattati in [errori di connessione al database](https://docs.squarecloud.app/it/platform/troubleshooting/database-connection-errors.md).

## Connessioni

Ogni database accetta fino a 256 connessioni simultanee; oltre questo limite, le nuove falliscono con `Too many connections`. Crea **un solo pool per processo** all'avvio e riutilizzalo, dimensionato in modo che tutte le app, i worker e gli shard insieme restino sotto il limite. La scheda **Insights** mostra chi tiene aperte le connessioni.

## Il tuo utente e i permessi

L'utente `squarecloud@'%'` ha tutti i privilegi, con `GRANT OPTION`, tranne quelli amministrativi. Puoi creare database, utenti e grant, routine, trigger ed eventi, e modificare le variabili globali con `SET GLOBAL` e `SET PERSIST`.

Ciò che i privilegi amministrativi consentirebbero non è disponibile:

* file lato server: `LOAD DATA INFILE` e `SELECT ... INTO OUTFILE`;
* `FLUSH PRIVILEGES`, che risponde `ERROR 1227`. Non serve: `GRANT`, `CREATE USER` e `ALTER USER` si applicano subito;
* `SHOW ENGINE INNODB STATUS`;
* la replica.

## Importare un dump

I dump presi da un altro server spesso contengono `DEFINER=root@localhost` (o un altro account amministrativo) su viste, routine, trigger ed eventi. Importarli fallisce con `ERROR 1227 (42000): Access denied; you need (at least one of) the ... privilege(s)`. Rimuovi queste clausole prima dell'importazione, oppure impostale sul tuo utente:

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

## Configurazione

* **Nessun binary log.** Replica, change data capture (Debezium e simili) e point-in-time recovery non sono disponibili.
* **Buffer pool:** `innodb_buffer_pool_size` mantiene il valore predefinito di MySQL di **128 MB**; non cresce con la RAM del database. Puoi aumentarlo entro la RAM che hai allocato, lasciando spazio per le connessioni e per il server stesso (circa metà della RAM è un punto di partenza sicuro):
  ```sql theme={"system"}
  SET PERSIST innodb_buffer_pool_size = 536870912; -- 512 MB
  ```
  Un valore persistito si perde quando il database viene ripristinato da uno snapshot o aggiornato: impostalo di nuovo dopo.
* **`max_allowed_packet`** è di 64 MB, la singola istruzione o riga più grande che il server accetta.
* Il resto della configurazione del server è lo stesso su ogni database.

## Query lente

La scheda **Insights** elenca le istruzioni per tempo medio (qualsiasi istruzione con un'esecuzione di 100 ms o più). Per lo slow query log grezzo, attivalo: viene scritto nella tabella `mysql.slow_log` con la stessa soglia di 100 ms, non scade mai e usa lo storage del database, quindi svuotalo quando hai finito:

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

## Snapshot

Uno snapshot di MySQL contiene i tuoi schemi, routine, trigger, eventi e utenti, esportati in un'unica transazione: coerente per le tabelle InnoDB, non garantito per MyISAM. Oltre ai [casi generali](https://docs.squarecloud.app/it/services/databases.md#snapshot-e-ripristino), fallisce quando un tuo `LOCK TABLES` lo blocca per più di 5 minuti. L'esportazione è testo SQL semplice, quindi un database vicino ai suoi 10 GB di storage potrebbe non stare in uno snapshot.

## Errori comuni

| Messaggio | Cosa significa | Cosa fare |
| :- | :- | :- |
| `Connections using insecure transport are prohibited while --require_secure_transport=ON` | Il client si è connesso senza SSL/TLS. | Attiva SSL/TLS (`ssl-mode=REQUIRED`). |
| `ER_NOT_SUPPORTED_AUTH_MODE` | Il driver non supporta `caching_sha2_password`. | Passa a `mysql2` o a un connettore recente. |
| `Too many connections` | Tutte le 256 connessioni sono in uso. | Usa un solo pool condiviso per processo; vedi [Connessioni](#connessioni). |
| `ERROR 1227 (42000): Access denied; you need ... privilege(s)` | L'istruzione richiede un privilegio amministrativo, oppure un dump contiene `DEFINER=root`. | Togli `FLUSH PRIVILEGES`; rimuovi le clausole `DEFINER`. |
| `Got a packet bigger than 'max_allowed_packet' bytes` | Un'istruzione o una riga supera i 64 MB. | Dividila in insert più piccoli. |
| `The table '...' is full` | I 10 GB di storage sono pieni: le scritture falliscono. | Elimina dati; vedi [disco pieno](https://docs.squarecloud.app/it/platform/troubleshooting/database-performance.md#il-disco-è-pieno). |

Dopo un arresto forzato, MySQL esegue il crash recovery all'avvio successivo, che richiede più tempo sui database grandi: attendi che finisca.

## Contattaci

Se continui a riscontrare **difficoltà tecniche**, il nostro **team di supporto specializzato** è disponibile ad assisterti. [**Contattaci**](https://squarecloud.app/it/support) e saremo felici di aiutarti a risolvere qualsiasi problema: la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud [**4,9/5 su 402 recensioni**](https://www.trustpilot.com/review/squarecloud.app) su Google e Trustpilot.


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