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

# Datenbanken mit der CLI verwalten

> Erstelle, prüfe, skaliere, starte, stoppe und lösche Square Cloud Datenbanken mit squarecloud db und rotiere TLS-Zertifikat und Passwort.

`squarecloud db` verwaltet die MongoDB-, MySQL-, PostgreSQL- und Redis-Datenbanken deines Kontos. Der Befehl funktioniert auch als `squarecloud database`.

Datenbanken haben keine Konfigurationsdatei, daher ist `[dbID]` entweder die ID, die du übergibst, oder, wenn du sie in einem Terminal weglässt, eine Auswahlliste deiner Datenbanken. IDs findest du mit [`squarecloud db list`](#squarecloud-db-list).

## `squarecloud db create`

```bash Verwendung theme={"system"}
squarecloud db create --name <name> --memory <MB> --type <engine> --version <version> [--json]
```

| Flag | Beschreibung |
| - | - |
| `--name <name>` | Name der Datenbank, 1 bis 32 Zeichen. |
| `--memory <MB>` | Zugewiesener Arbeitsspeicher in MB. |
| `--type <engine>` | `mongo`, `mysql`, `redis` oder `postgres`. |
| `--version <version>` | Version der Engine: eine Hauptversion, etwa `17` für PostgreSQL oder `8` für MongoDB, oder eine vollständige Version. |

Alle vier Flags sind erforderlich: Fehlen sie, gibt der Befehl seine Hilfe aus. Zum Erstellen einer Datenbank ist ein Plan Standard, Pro oder Enterprise nötig.

```bash theme={"system"}
squarecloud db create --name my-db --memory 1024 --type postgres --version 17
```

```bash Ausgabe theme={"system"}
✓ Database my-db (<dbID>) created successfully
Save the password now: it is shown only once and cannot be recovered.
  PASSWORD: <password>
  URL: <connection URL>
```

<Warning>
  Das Passwort wird nur einmal angezeigt. `db info` zeigt es nicht erneut; wenn du es verlierst, rotiere es mit [`db credentials reset password`](#squarecloud-db-credentials-reset).
</Warning>

Mit `--json` gibt der Befehl die erstellte Datenbank samt Passwort und Verbindungs-URL als JSON aus.

## `squarecloud db list`

```bash Verwendung theme={"system"}
squarecloud db list [--json]
```

Gibt Name, ID, Engine, Arbeitsspeicher und Cluster jeder Datenbank deines Kontos aus.

## `squarecloud db info`

```bash Verwendung theme={"system"}
squarecloud db info [dbID] [--json]
```

Zeigt Datenbank-ID, Name, Engine, Arbeitsspeicher, Port, Cluster, Eigentümer und Erstellungsdatum.

## `squarecloud db update`

```bash Verwendung theme={"system"}
squarecloud db update [dbID] [--name <name>] [--memory <MB>]
```

| Flag | Beschreibung |
| - | - |
| `--name <name>` | Neuer Name der Datenbank. |
| `--memory <MB>` | Neuer zugewiesener Arbeitsspeicher in MB. |

Benennt die Datenbank um oder ändert ihren Arbeitsspeicher. Übergib mindestens eines der beiden Flags: Fehlen beide, gibt der Befehl seine Hilfe aus.

```bash theme={"system"}
squarecloud db update <dbID> --memory 2048
```

## `squarecloud db start`

```bash Verwendung theme={"system"}
squarecloud db start [dbID]
```

Startet eine gestoppte Datenbank. Läuft sie bereits, meldet die CLI das (`It is already running.`) und endet mit Exit-Code 0.

## `squarecloud db stop`

```bash Verwendung theme={"system"}
squarecloud db stop [dbID]
```

Stoppt eine laufende Datenbank. Ist sie bereits gestoppt, meldet die CLI das (`It is already stopped.`) und endet mit Exit-Code 0.

## `squarecloud db status`

```bash Verwendung theme={"system"}
squarecloud db status [dbID] [--all] [--raw] [--json]
```

| Flag | Beschreibung |
| - | - |
| `--all` | Zeigt alle Datenbanken statt einer: Datenbank-ID, ob sie läuft, CPU und Arbeitsspeicher. |
| `--raw` | Gibt die numerischen Rohwerte als JSON statt der Tabelle aus. |

Gibt Datenbank-ID, CPU-Auslastung, Arbeitsspeicher, Speicherplatz und Status aus.

## `squarecloud db metrics`

```bash Verwendung theme={"system"}
squarecloud db metrics [dbID] [--json]
```

Gibt die letzten 24 Stunden der CPU-Auslastung, der RAM-Nutzung und des Netzwerkverkehrs der Datenbank aus, eine Zeile pro 5-Minuten-Messpunkt.

## `squarecloud db credentials certificate`

```bash Verwendung theme={"system"}
squarecloud db credentials certificate [dbID]
```

Gibt das TLS-Zertifikat der Datenbank aus, mit dem sich Clients über TLS verbinden.

```bash theme={"system"}
squarecloud db credentials certificate <dbID> > certificate.pem
# Speichert das Zertifikat in einer Datei.
```

## `squarecloud db credentials reset`

```bash Verwendung theme={"system"}
squarecloud db credentials reset <password|certificate> [dbID] [-y]
```

| Flag | Beschreibung |
| - | - |
| `-y`, `--yes` | Überspringt die Bestätigungsabfrage. |

Rotiert nach einer `y/N`-Bestätigung das Passwort oder das TLS-Zertifikat. Das alte funktioniert sofort nicht mehr, aktualisiere daher jeden Client, der es verwendet. Ein neues Passwort wird einmal ausgegeben; nach dem Rotieren des Zertifikats holst du das neue mit `db credentials certificate`.

```bash theme={"system"}
squarecloud db credentials reset password <dbID>
```

## `squarecloud db delete`

```bash Verwendung theme={"system"}
squarecloud db delete [dbID] [-y]
```

| Flag | Beschreibung |
| - | - |
| `-y`, `--yes` | Überspringt die Bestätigungsabfrage. |

<Warning>
  Das Löschen einer Datenbank ist endgültig. Um eine Kopie der Daten zu behalten, führe zuerst [`squarecloud db snapshot create --download`](/de/cli-reference/snapshots#squarecloud-db-snapshot-create) aus.
</Warning>

Fragt vor dem Löschen `Delete the database <dbID>? This action is irreversible [y/N]`.

## Siehe auch

| Befehl | API | JavaScript SDK | VS Code |
| - | - | - | - |
| `create` | [`POST /v2/databases`](/de/api-reference/endpoint/databases/create) | [`api.databases.create()`](/de/sdks/js/databases) | [Datenbank erstellen](/de/vscode-extension/features#datenbanken) |
| `list` | [`GET /v2/users/me`](/de/api-reference/endpoint/users/me) | [`api.account.me()`](/de/sdks/js/client) | [Bereich Datenbanken](/de/vscode-extension/features#datenbanken) |
| `info` | [`GET .../{database_id}`](/de/api-reference/endpoint/databases/info) | [`api.databases.get()`](/de/sdks/js/databases) | |
| `update` | [`PATCH .../{database_id}`](/de/api-reference/endpoint/databases/edit) | [`api.databases.update()`](/de/sdks/js/databases) | |
| `start` | [`POST .../start`](/de/api-reference/endpoint/databases/start) | [`api.databases.start()`](/de/sdks/js/databases) | [Starten](/de/vscode-extension/features#datenbanken) |
| `stop` | [`POST .../stop`](/de/api-reference/endpoint/databases/stop) | [`api.databases.stop()`](/de/sdks/js/databases) | [Stoppen](/de/vscode-extension/features#datenbanken) |
| `status` | [`GET .../status`](/de/api-reference/endpoint/databases/status) | [`api.databases.status()`](/de/sdks/js/databases) | |
| `status --all` | [`GET /v2/databases/status`](/de/api-reference/endpoint/databases/status-all) | [`api.databases.statusAll()`](/de/sdks/js/databases) | |
| `metrics` | [`GET .../metrics`](/de/api-reference/endpoint/databases/metrics) | [`api.databases.metrics()`](/de/sdks/js/databases) | |
| `credentials certificate` | [`GET .../credentials/certificate`](/de/api-reference/endpoint/databases/credentials/get_certificate) | [`api.databases.certificate()`](/de/sdks/js/databases) | [TLS-Zertifikat herunterladen](/de/vscode-extension/features#datenbanken) |
| `credentials reset` | [`POST .../credentials/reset`](/de/api-reference/endpoint/databases/credentials/reset) | [`api.databases.resetCredentials()`](/de/sdks/js/databases) | |
| `delete` | [`DELETE .../{database_id}`](/de/api-reference/endpoint/databases/delete) | [`api.databases.delete()`](/de/sdks/js/databases) | [Löschen](/de/vscode-extension/features#datenbanken) |

Snapshots von Datenbanken findest du unter [Snapshots](/de/cli-reference/snapshots#squarecloud-db-snapshot-create).