> ## 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 auf Square Cloud: Verbindung, Berechtigungen und Limits

> Verwaltetes MySQL auf Square Cloud: Connection String, Pflicht-TLS, caching_sha2_password, Benutzerrechte, Dumps mit DEFINER importieren, Buffer Pool, Slow Query Log und häufige Fehler.

Eine verwaltete MySQL-Instanz, die nur TLS-Verbindungen akzeptiert, mit einem Benutzer, der seine eigenen Datenbanken, Benutzer, Routinen und Events verwalten kann. Was für alle Engines gilt (Limits, Snapshots, Insights), steht in der [Datenbank-Übersicht](https://docs.squarecloud.app/de/services/databases.md).

## Verbinden

Kopiere die Verbindungs-URL von der Seite der Datenbank im Dashboard. Sie hat diese Form, mit dem Benutzer `squarecloud` und der Datenbank `squarecloud`, die für dich angelegt werden:

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

MySQL verlangt **SSL/TLS**; ein Client-Zertifikat ist nicht nötig. Verwende `ssl-mode=REQUIRED` oder `VERIFY_CA` mit der `.pem` aus **Verbindung** → **SSL/TLS-Zertifikat** als CA, um auch den Server zu prüfen.

Der Server akzeptiert nur die Authentifizierung `caching_sha2_password`. Ältere Treiber, die sie nicht beherrschen, wie das npm-Paket `mysql`, scheitern bei der Anmeldung: Verwende `mysql2` unter Node.js oder einen aktuellen Connector.

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

Der Server löst keine Hostnamen auf: Wenn du Benutzer anlegst, ist ihr Host-Teil eine IP-Adresse oder `'%'`.

ORMs und GUI-Tools (Prisma, MySQL Workbench, DBeaver, HeidiSQL) werden unter [Datenbankverbindungsfehler](https://docs.squarecloud.app/de/platform/troubleshooting/database-connection-errors.md) behandelt.

## Verbindungen

Jede Datenbank akzeptiert bis zu 256 gleichzeitige Verbindungen; darüber hinaus schlagen neue mit `Too many connections` fehl. Erstelle beim Start **einen Pool pro Prozess** und verwende ihn wieder, so bemessen, dass alle Apps, Worker und Shards zusammen unter dem Limit bleiben. Der Tab **Insights** zeigt, wer die offenen Verbindungen hält.

## Dein Benutzer und seine Berechtigungen

Der Benutzer `squarecloud@'%'` hat alle Privilegien, mit `GRANT OPTION`, außer den administrativen. Du kannst Datenbanken, Benutzer und Grants, Routinen, Trigger und Events erstellen und globale Variablen mit `SET GLOBAL` und `SET PERSIST` ändern.

Was die administrativen Privilegien erlauben würden, ist nicht verfügbar:

* serverseitige Dateien: `LOAD DATA INFILE` und `SELECT ... INTO OUTFILE`;
* `FLUSH PRIVILEGES`, das mit `ERROR 1227` antwortet. Es ist nicht nötig: `GRANT`, `CREATE USER` und `ALTER USER` greifen sofort;
* `SHOW ENGINE INNODB STATUS`;
* Replikation.

## Einen Dump importieren

Dumps von einem anderen Server enthalten oft `DEFINER=root@localhost` (oder ein anderes administratives Konto) bei Views, Routinen, Triggern und Events. Ihr Import schlägt mit `ERROR 1227 (42000): Access denied; you need (at least one of) the ... privilege(s)` fehl. Entferne die Klauseln vor dem Import oder setze sie auf deinen eigenen Benutzer:

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

## Konfiguration

* **Kein Binary Log.** Replikation, Change Data Capture (Debezium und Ähnliches) und Point-in-Time-Recovery sind nicht verfügbar.
* **Buffer Pool:** `innodb_buffer_pool_size` behält den MySQL-Standardwert von **128 MB**; er wächst nicht mit dem RAM der Datenbank. Du kannst ihn innerhalb des zugewiesenen RAM erhöhen und dabei Platz für Verbindungen und den Server selbst lassen (etwa die Hälfte des RAM ist ein sicherer Anfang):
  ```sql theme={"system"}
  SET PERSIST innodb_buffer_pool_size = 536870912; -- 512 MB
  ```
  Ein persistierter Wert geht verloren, wenn die Datenbank aus einem Snapshot wiederhergestellt oder aktualisiert wird: Setze ihn danach erneut.
* **`max_allowed_packet`** beträgt 64 MB, die größte einzelne Anweisung oder Zeile, die der Server annimmt.
* Der Rest der Serverkonfiguration ist auf jeder Datenbank gleich.

## Langsame Abfragen

Der Tab **Insights** listet Anweisungen nach mittlerer Zeit auf (jede Anweisung mit einer Ausführung ab 100 ms). Für das rohe Slow Query Log schalte es ein: Es wird mit derselben Schwelle von 100 ms in die Tabelle `mysql.slow_log` geschrieben, läuft nie ab und belegt Speicherplatz der Datenbank, also leere es, wenn du fertig bist:

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

Ein MySQL-Snapshot enthält deine Schemas, Routinen, Trigger, Events und Benutzer, exportiert in einer einzigen Transaktion: konsistent für InnoDB-Tabellen, nicht garantiert für MyISAM. Neben den [allgemeinen Fällen](https://docs.squarecloud.app/de/services/databases.md#snapshots-und-wiederherstellung) schlägt er fehl, wenn dein eigenes `LOCK TABLES` ihn länger als 5 Minuten blockiert. Der Export ist reiner SQL-Text, daher passt eine Datenbank nahe an ihren 10 GB Speicherplatz eventuell nicht in einen Snapshot.

## Häufige Fehler

| Meldung | Bedeutung | Was zu tun ist |
| :- | :- | :- |
| `Connections using insecure transport are prohibited while --require_secure_transport=ON` | Der Client hat sich ohne SSL/TLS verbunden. | Aktiviere SSL/TLS (`ssl-mode=REQUIRED`). |
| `ER_NOT_SUPPORTED_AUTH_MODE` | Dem Treiber fehlt `caching_sha2_password`. | Wechsle zu `mysql2` oder einem aktuellen Connector. |
| `Too many connections` | Alle 256 Verbindungen sind belegt. | Nutze einen gemeinsamen Pool pro Prozess; siehe [Verbindungen](#verbindungen). |
| `ERROR 1227 (42000): Access denied; you need ... privilege(s)` | Die Anweisung erfordert ein administratives Privileg, oder ein Dump enthält `DEFINER=root`. | Lass `FLUSH PRIVILEGES` weg; entferne die `DEFINER`-Klauseln. |
| `Got a packet bigger than 'max_allowed_packet' bytes` | Eine Anweisung oder Zeile ist größer als 64 MB. | Teile sie in kleinere Inserts auf. |
| `The table '...' is full` | Die 10 GB Speicherplatz sind voll: Schreibvorgänge schlagen fehl. | Lösche Daten; siehe [Speicherplatz voll](https://docs.squarecloud.app/de/platform/troubleshooting/database-performance.md#der-speicherplatz-ist-voll). |

Nach einem erzwungenen Stopp führt MySQL beim nächsten Start seine Crash-Recovery aus, die bei großen Datenbanken länger dauert: Warte, bis sie abgeschlossen ist.

## Kontaktiere uns

Falls du weiterhin **technische Schwierigkeiten** hast, steht dir unser **spezialisiertes Support-Team** zur Verfügung. [**Kontaktiere uns**](https://squarecloud.app/de/support) und wir helfen dir gerne, jedes Problem zu lösen: die Qualität unseres Supports ist ein wichtiger Grund, warum Entwickler Square Cloud mit [**4,9/5 bei 402 Bewertungen**](https://www.trustpilot.com/review/squarecloud.app) auf Google und Trustpilot bewerten.


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