Datenbanken mit der CLI verwalten

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

Verwendung

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.

squarecloud db create --name my-db --memory 1024 --type postgres --version 17

Ausgabe

✓ Database my-db (<dbID>) created successfully
Save the password now: it is shown only once and cannot be recovered.
  PASSWORD: <password>
  URL: <connection URL>

Das Passwort wird nur einmal angezeigt. db info zeigt es nicht erneut; wenn du es verlierst, rotiere es mit db credentials reset password.

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

`squarecloud db list`

Verwendung

squarecloud db list [--json]

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

`squarecloud db info`

Verwendung

squarecloud db info [dbID] [--json]

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

`squarecloud db update`

Verwendung

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.

squarecloud db update <dbID> --memory 2048

`squarecloud db start`

Verwendung

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`

Verwendung

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`

Verwendung

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`

Verwendung

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`

Verwendung

squarecloud db credentials certificate [dbID]

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

squarecloud db credentials certificate <dbID> > certificate.pem
# Speichert das Zertifikat in einer Datei.

`squarecloud db credentials reset`

Verwendung

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.

squarecloud db credentials reset password <dbID>

`squarecloud db delete`

Verwendung

squarecloud db delete [dbID] [-y]

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

Das Löschen einer Datenbank ist endgültig. Um eine Kopie der Daten zu behalten, führe zuerst squarecloud db snapshot create --download aus.

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`	`api.databases.create()`	Datenbank erstellen
`list`	`GET /v2/users/me`	`api.account.me()`	Bereich Datenbanken
`info`	`GET .../{database_id}`	`api.databases.get()`
`update`	`PATCH .../{database_id}`	`api.databases.update()`
`start`	`POST .../start`	`api.databases.start()`	Starten
`stop`	`POST .../stop`	`api.databases.stop()`	Stoppen
`status`	`GET .../status`	`api.databases.status()`
`status --all`	`GET /v2/databases/status`	`api.databases.statusAll()`
`metrics`	`GET .../metrics`	`api.databases.metrics()`
`credentials certificate`	`GET .../credentials/certificate`	`api.databases.certificate()`	TLS-Zertifikat herunterladen
`credentials reset`	`POST .../credentials/reset`	`api.databases.resetCredentials()`
`delete`	`DELETE .../{database_id}`	`api.databases.delete()`	Löschen

Snapshots von Datenbanken findest du unter Snapshots.

​squarecloud db create

​squarecloud db list

​squarecloud db info

​squarecloud db update

​squarecloud db start

​squarecloud db stop

​squarecloud db status

​squarecloud db metrics

​squarecloud db credentials certificate

​squarecloud db credentials reset

​squarecloud db delete

​Siehe auch

`squarecloud db create`

`squarecloud db list`

`squarecloud db info`

`squarecloud db update`

`squarecloud db start`

`squarecloud db stop`

`squarecloud db status`

`squarecloud db metrics`

`squarecloud db credentials certificate`

`squarecloud db credentials reset`

`squarecloud db delete`

Siehe auch