Cloud DatabasesCLI
Das Plug-in für Cloud Databases-CLI bietet zusätzliche Methoden für den Zugriff auf die Funktionen von Cloud Databases-Services. Die Cloud Databases-CLI können Sie verwenden zum Verwalten und Herstellen einer Verbindung zu
- IBM Cloud® Databases for PostgreSQL
- IBM Cloud® Databases for EnterpriseDB
- IBM Cloud® Databases for Redis
- IBM Cloud® Databases for Elasticsearch
- IBM Cloud® Databases for etcd
- IBM Cloud® Messages for RabbitMQ
- IBM Cloud® Databases for MongoDB
Hinweis: Für das Plug-in für die Cloud Databases-CLI muss die IBM Cloud-CLI installiert sein.
Die IBM Cloud-CLI
Bei der IBM Cloud-CLI handelt es sich um ein allgemeines Entwicklertool, das über eine Befehlszeilenschnittstelle Zugriff auf Ihr IBM Cloud-Konto und Ihre Services bereitstellt.
Eine Einführung sowie Installationsanweisungen sind auf der Seite Einführung in die IBM Cloud-CLI verfügbar. Wenn Sie die CLI über den angegebenen cURL-Befehl installieren, erhalten Sie eine Auswahl von zusätzlichen Plug-ins und Erweiterungen für mehrere IDEs.
Sie können das eigenständige Paket einfach über die Seite Installation der eigenständigen IBM Cloud-CLI installieren.
Der Zugriff auf Services über die IBM Cloud-CLI wird über Identity and Access Management gesteuert. Um die CLI zum Anzeigen oder Verwalten eines Service (oder zum Erteilen von Berechtigungen für einen anderen Benutzer auf Ihrem Konto) verwenden zu können, müssen Sie die korrekten Berechtigungen festlegen. Weitere Informationen zum IAM-Management finden Sie im Lernprogramm Einführung in IAM.
Cloud Databases-CLI-Plug-in installieren
Nachdem Sie die IBM Cloud-CLI installiert haben, melden Sie sich an und fordern die Installation des Plug-ins für die Cloud-Datenbanken an.
ibmcloud plugin install cloud-databases
Mit ibmcloud cdb help
können Sie eine Liste von Befehlen und Nutzungsinformationen abrufen.
ibmcloud cdb help
Zeigt die Hilfe für das Plug-in an. Wenn dieser Befehl allein verwendet wird, werden die verfügbaren Befehle der höchsten Ebene angezeigt. Zusammen mit einem weiteren Befehl wird die spezifische Hilfe für diesen Befehl angezeigt.
ibmcloud cdb help [&TWBLT; Befehl>]
Befehlsoptionen
Keine befehlsspezifischen Optionen.
Beispiele Hilfe mit dem task-show-Befehl aufrufen.
ibmcloud cdb help task-show
Implementierungen und bereitstellbare Objekte
Sie können Informationen zu den implementierbaren Datenbanken und Datenbankversionen auf der Cloud Databases-Plattform abrufen. Sie erhalten außerdem eine Liste aller Cloud Databases auf Ihrem IBM Cloud-Konto.
ibmcloud cdb deployables-show
Bei den deployables
(bereitstellbare Objekte) handelt es sich um die Schablonen, die für neue Datenbankimplementierungen verfügbar sind. Dieser Befehl zeigt bereitstellbaren Datenbanktypen, insbesondere die verfügbaren Versionen
von Datenbanken, sowie ihren bevorzugten oder stabilen Status an.
ibmcloud cdb deployables-show [--stable] [--preferred] [--json]
Kurzversion - deployables
Befehlsoptionen
- `-- stable` oder `-s`
- Es werden nur stabile Versionen von Datenbanken aufgelistet.
- `--preferred` oder `-p`
- Es werden nur bevorzugte Versionen von Datenbanken aufgelistet.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Alle stabilen Versionen der verfügbaren Datenbanken anzeigen.
ibmcloud cdb deployables-show -- stable
ibmcloud cdb deployments
Kurzversion - ls
Verwenden Sie diesen Befehl, um die mit dem Konto verknüpften Implementierungen aufzulisten.
ibmcloud cdb deployments [--all] [--json]
Befehlsoptionen
- `--all` oder `-a`
- Instanzname und CRN werden angezeigt.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Alle aktuellen Implementierungen mit einem Konto auflisten.
ibmcloud cdb ls
ibmcloud cdb deployment-about
Kurzversion - about
Mit diesem Befehl können Sie Details zu der Datenbank abrufen, die in der Instanz implementiert ist, zur Version der Datenbank und zu den angewendeten Optionen. Außerdem werden die ID und die GUID für den Ressourcencontroller, Ressourcenpläne, aktueller Status, Typ und letzte bekannte Operation angezeigt.
ibmcloud cdb deployment-about &TWBLT;Implementierungsname oder CRN> [--all] [--json]
Befehlsoptionen
- `--all` oder `-a`
- Alle verfügbaren Daten aus den Datensätzen des Ressourcencontrollers werden angezeigt.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Details zu einer Implementierung mit dem Namen "RedisDBOne" auflisten.
ibmcloud cdb about RedisDBOne
Verbindungen
Sie erhalten Verbindungszeichenfolgen und Zertifikatsinformationen, die beim Herstellen einer Verbindung zu Ihrer Implementierung erforderlich sind. Verwalten Sie Verbindungen für Datenbanken mit dieser Option.
ibmcloud cdb deployment-connections
Kurzversion - cxn
Es werden Verbindungszeichenfolgen und andere Verbindungsdetails für eine Implementierung mit oder ohne eingefügte Benutzerberechtigungsnachweise angezeigt.
ibmcloud cdb deployment-connections [--user &TWBLT;Benutzer-ID>] [--password &TWBLT;Kennwort>] [--endpoint-type &TWBLT;#Endpunkttyp>] [--all] [--only] [--start] [--certroot &TWBLT;Pfad>] [--json]
Befehlsoptionen
- `--start` oder `-s`
- Eine Verbindung wird gestartet, indem Sie den generierten CLI-Befehl ausführen. Wenn ein Kennwort nicht in den Flags angegeben ist, fordert der Befehl interaktiv ein Kennwort an. Das Plug-in verwendet die Standardbefehle für die Befehlszeileninteraktion und das Verwalten des CA-Zertifikats, um eine sichere TLS-Sitzung zu gewährleisten. Standardmäßig wird die Verbindung als Administratorbenutzer der Implementierung hergestellt.
- `--user
` oder `-u` - Legt die Benutzer-ID fest, die beim Abrufen von Verbindungseinstellungen verwendet wird. Sie wird in Verbindungszeichenfolgen eingesetzt. Standardmäßig wird der Benutzer mit Administratorberechtigung für die Implementierung verwendet.
- `--password
` oder `-p` - Legt das Kennwort fest, das beim Abrufen von Verbindungseinstellungen verwendet wird. Es wird in Verbindungszeichenfolgen eingesetzt, in denen $PASSWORD als Standardwert angezeigt wird.
- `-- endpoint-type [public oder private]` oder `-e [public oder private]`
- Endpunkttyp für zurückgegebene Verbindungszeichenfolgen. Entweder 'public' oder 'private'. (Standardeinstellung: 'public'). Der Endpunkttyp wird nicht erzwungen und dient nur zu Anzeigezwecken.
- `--all` oder `-a`
- Listet alle verfügbaren Verbindungseinstellungen auf, einschließlich der Komponententeile von Verbindungszeichenfolgen.
- `--certroot
` oder `-c` - Der Pfad wird als Zertifikatsstammverzeichnis verwendet. Wenn der Pfad nicht vorhanden ist, wird er automatisch erstellt. Funktioniert mit dem Flag `--save`. Der Wert für das Stammverzeichnis des Zertifikats kann auch in der Umgebungsvariablen `$CERTROOT` festgelegt werden.
- `-- only [app oder cli]` oder `-o`
- Es werden nur die Einstellungen angezeigt, die für `App`-Verbindungen oder `CLI`-Verbindungen relevant sind.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Anzeigen, wie eine Verbindung zu einer Implementierung hergestellt werden soll.
ibmcloud cdb deployment-connections MyPSQL
(Zeigt eine Verbindungszeichenfolge und eine CLI-Befehlszeichenfolge an.)
Es wird eine Verbindung zu einer Implementierung als Administrator hergestellt.
ibmcloud cdb deployment-connections MyPSQL --start
Wenn das Plug-in ausgeführt wird, fordert es die Eingabe des Administratorkennworts an und führt dann die CLI-Befehlszeichenfolge aus. Der Befehl, der in der CLI-Befehlszeichenfolge verwendet wird, muss installiert sein.
Es werden alle Details zum Herstellen einer Verbindung zu einer Implementierung für eine bestimmte Kombination aus Benutzer und Kennwort angezeigt.
ibmcloud cdb cxn MyPSQL -a -u auser -p auserpassword
ibmcloud cdb deployment-cacert
Kurzversion - cacert
Es wird das selbst signierte Zertifikat angezeigt, das für die Überprüfung von TLS/SSL-Verbindungen zu der Implementierung verwendet wird. Das Ergebnis wird standardmäßig an die Konsole ausgegeben, kann aber auch in einer Datei gespeichert werden.
ibmcloud cdb deployment-cacert &TWBLT;Implementierungsname oder CRN> [--user &TWBLT;Benutzer-ID>] [--save] [--certroot &TWBLT;Pfad>] [--json]
Befehlsoptionen
- `--user
` oder `-u` - Standardmäßig wird der Benutzer mit Administratorberechtigung für den Abruf des Zertifikats verwendet. Mit diesem Flag kann optional ein Benutzer angegeben werden, wenn in der Implementierung Zertifikate auf Benutzerbasis unterstützt werden.
- `--save` oder `-s`
- Das decodierte Zertifikat wird im Stammverzeichnis des Zertifikats gespeichert. Der Standardwert ist $HOME/.cloud/plugins/cdb/cdbcerts/.
- `--certroot
` oder `-c` - Der Pfad wird als Stammverzeichnis des Zertifikats verwendet. Wenn der Pfad nicht vorhanden ist, wird er automatisch erstellt. Funktioniert mit dem Flag `--save`. Der Wert für das Stammverzeichnis des Zertifikats kann auch in der Umgebungsvariablen `$CERTROOT` festgelegt werden.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Zertifikat für eine Implementierung mit der Bezeichnung 'MyPostgreSQL' anzeigen.
ibmcloud cdb deployment-cacert MyPostgreSQL
Ein Zertifikat wird für dieselbe Implementierung im aktuellen Verzeichnis gespeichert.
ibmcloud cdb deployment-cacert MyPostgreSQL --save --certroot .
Hinweis: Der Dateiname basiert auf dem Zertifikatsnamen.
ibmcloud cdb deployment-kill-connections
Kurzversion - kill-connections
Es werden alle Verbindungen für eine Implementierung geschlossen. Nur für PostgreSQL verfügbar.
ibmcloud cdb deployment-kill-connections &TWBLT;Implementierungsname oder CRN> [--nowait] [--json]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zur Benutzererstellung abgeschlossen ist. Die Details der Task zur Benutzererstellung werden angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Mit diesem Befehl werden alle externen Verbindungen zu einer Implementierung mit der Bezeichnung postgresq-preproduction
beendet.
ibmcloud cdb deployment-kill-connections postgresq-preproduction
Benutzer
Das Kennwort für Benutzer in Ihrer Implementierung wird erstellt, gelöscht oder geändert.
ibmcloud cdb deployment-user-create
Kurzversion - user-create
Es wird ein Benutzer in der Implementierungsdatenbank erstellt.
ibmcloud cdb deployment-user-create &TWBLT;Implementierungsname oder CRN> &TWBLT;Neuer_Benutzername> &TWBLT;Neues_Kennwort> [--nowait] [--json]
Für Neuer_Benutzername
muss ein korrekt formatierter Benutzername für die Verwendung in der Datenbank der Implementierung verwendet werden. Für Neues_Kennwort
müssen die Kennwortregeln der Datenbank erfüllt werden
und es muss eine Länge von mindestens 10 Zeichen haben.
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zur Benutzererstellung abgeschlossen ist. Die Details der Task zur Benutzererstellung werden angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Datenbankbenutzer mit der Bezeichnung 'fred' mit dem Kennwort 'X1234Y5678' für die Implementierung 'MyPSQL' erstellen.
ibmcloud cdb deployment-user-create MyPSQL fred X1234Y5678
ibmcloud cdb deployment-user-delete
Kurzversion - user-delete
Es wird ein vorhandener Benutzer aus der angegebenen Datenbankimplementierung entfernt.
ibmcloud cdb deployment-user-delete &TWBLT;Implementierungsname oder CRN> &TWBLT;Benutzername> [--nowait] [--json]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zum Löschen des Benutzers abgeschlossen ist. Es werden die Details der Task zum Löschen des Benutzers angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Datenbankbenutzer mit dem Namen 'fred' aus der Implementierung 'MyPSQL' entfernen
ibmcloud cdb deployment-user-delete MyPSQL fred
ibmcloud cdb deployment-user-password
Kurzversion - user-password
Das Kennwort für einen genannten Benutzer in einer angegebenen Datenbankimplementierung wird geändert.
ibmcloud cdb deployment-user-password &TWBLT;Implementierungsname oder CRN> &TWBLT;Benutzername> &TWBLT;Neues_Kennwort> [--nowait] [--json]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zum Ändern des Benutzerkennworts abgeschlossen ist. Es werden die die Details der Task zum Ändern des Benutzerkennwort angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Kennwort des Benutzers 'fred' in der Datenbankimplementierung 'MyPSQL' in 'A9876B5432' ändern
ibmcloud cdb deployment-password MyPSQL fred A9876B5432
Datenbankkonfiguration
Die konfigurierbaren Einstellungen in einer Implementierung können aufgelistet oder geändert werden. Die neue Konfiguration wird in einer JSON-Datei oder einer JSON-Zeichenfolge mit Einstellungen angegeben. Die Einstellungen variieren je nach Datenbanktyp, siehe Datenbankkonfiguration ändern für PostgreSQL oder Redis.
ibmcloud cdb deployment-configuration-schema
Kurzversion - config-schema
Die aktuelle Konfiguration der angegebenen Implementierung wird abgerufen.
ibmcloud cdb deployment-configuration-schema &TWBLT;Implementierungsname oder CRN> [--description] [--json]
Befehlsoptionen
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
- `--description` oder `-d`
- Die Beschreibung der Einstellungen wird angezeigt.
Beispiele
ibmcloud cdb deployment-configuration-schema my-redis-cache
ibmcloud cdb deployment-connections
Kurzversion - configuration
Die Konfiguration der angegebenen Implementierung wird geändert.
ibmcloud cdb deployment-configuration &TWBLT;Implementierungsname oder CRN> [@JSON_FILE | JSON_STRING] [--json] [--nowait]
Befehlsoptionen
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zur Benutzererstellung abgeschlossen ist. Die Details der Task zur Skalierung werden angezeigt und der Vorgang wird beendet.
Beispiele Maximale Verbindungen zu einer PostgreSQL-Implementierung mit der Bezeichnung 'PGSettings4' in 150 ändern.
ibmcloud cdb deployment-configuration PGSettings4 '{"configuration":{"max_connections":150}}'
Skalierung
Rufen Sie die Ressourcen ab, die Ihrer Implementierung zugeordnet sind, und konfigurieren Sie sie.
ibmcloud cdb deployables-groups-show
Jede Implementierung wird aus einer bereitstellbaren Schablone erstellt. Der Befehl deployables-groups-show
zeigt die ursprüngliche oder standardmäßige Skalierungsgruppe für einen bestimmten Datenbanktyp an. Die Typnamen können
über den Befehl deployables-show
ermittelt werden.
ibmcloud cdb deployables-groups-show &TWBLT;bereitstellbarer_Typ> [--json]
Befehlsoptionen
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Einstellungen der Standardgruppe für eine PostgreSQL-Datenbankimplementierung anzeigen
ibmcloud cdb deployables-groups-show postgresql
ibmcloud cdb deployment-groups
Kurzversion - groups
Die Skalierungsgruppenwerte werden für die Mitglieder einer Implementierung angezeigt. Die Skalierungsgruppen beziehen sich auf Speicher, CPU und Platte. Die Standardgruppe hat die Bezeichnung 'member'. Für jede Gruppe werden die Anzahl der Knoten in der Gruppe angezeigt, gefolgt von
- Speicher Die Gesamtspeicherzuordnung, die Zuordnung pro Member, die Mindestzuordnung und die Zuwachsraten, mit denen die Größe des Gesamtspeicher erhöht werden werden kann.
- CPU Die Anzahl der CPUs, die der Gruppe zugeordnet sind. Der CPU-Abschnitt zeigt 0 Werte in allen Feldern an, wenn keine dedizierten CPUs konfiguriert sind. Die CPU-Gruppe wird nur angezeigt, wenn sie konfigurierbar ist.
- Platte Die gesamte Plattenzuordnung, die Zuordnung pro Member, die minimale Zuordnung und die Zuwachsraten, mit denen die Größe der gesamten Platte erhöht werden werden kann.
ibmcloud cdb deployment-groups &TWBLT;Implemenntierungsname oder CRN> [--json]
Befehlsoptionen
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Einstellungen der Skalierungsgruppe für eine Datenbankimplementierung mit der Bezeichnung 'MyRedis' anzeigen
ibmcloud cdb deployment-groups MyRedis
ibmcloud cdb deployment-groups-set
Kurzversion - groups-set
Legt die Werte für Skalierungsgruppen fest (siehe deployment-groups). Der Benutzer kann die Gesamtspeichergröße in MB oder den gesamten Plattenspeicher in MB festlegen, die beide gleichmäßig zwischen den Membern aufgeteilt sind. Die Anzahl der zugeordneten CPUs kann gegebenenfalls auch festgelegt werden.
ibmcloud cdb deployment-groups-set &TWBLT;Implementierungsname oder CRN> &TWBLT;Member-ID> [--memory &TWBLT;Speicherkapazität>] [--disk &TWBLT;Plattengröße>] [--cpu &TWBLT;Wert>] [--nowait] [--json]
Die Member-ID
ist der Name der Gruppe, für die diese Werte festgelegt werden sollen. Der Name kann über den Befehl deployment-groups
ermittelt werden. In der Regel handelt es sich um 'Member'.
Befehlsoptionen
- `--memory
` oder `-m` - Für den Gesamtspeicher der angegebenen Implementierungsgruppe wird ein Wert in MB festgelegt.
- `--disk
` oder `-d` - Für die gesamte Plattengröße der angegebenen Implementierungsgruppe wird ein Wert in MB festgelegt.
- `--cpu
` oder `-c` - Die Anzahl der dedizierten CPU-Kerne wird festgelegt.
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zur Benutzererstellung abgeschlossen ist. Die Details der Task zur Skalierung werden angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Ergebnisse als JSON.
Beispiele Eine PostgreSQL-Implementierung mit der Bezeichnung 'MyPGSQL' mit der Gruppe 'member' und einem Gesamtspeicher von 4096 MB festlegen.
ibmcloud cdb deployment-groups-set MyPGSQL member --memory 4096
Automatische Skalierung
Die Autoscaling-Konfiguration stellt die verschiedenen Bedingungen dar, mit denen die automatische Skalierung für eine Implementierung gesteuert wird.
ibmcloud cdb deployment-autoscaling
Kurzversion - autoscaling
Es werden alle Bedingungen für die automatische Skalierung für eine bestimmte Implementierung abgerufen.
ibmcloud cdb deployment-autoscaling &TWBLT;Implementierungsname oder CRN> GROUP_ID [--json]
Die automatische Skalierung kann derzeit nur für die Datenelemente in Ihrer Implementierung angewendet werden. Daher ist GROUP_ID
ein Member
.
Befehlsoptionen
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
Beispiele
ibmcloud cdb deployment-autoscaling elasticsearch-preproduction member
ibmcloud cdb deployment-autoscaling-set
Kurzversion - autoscaling-set
Die Bedingungen für die automatische Skalierung für Ihre Implementierung werden aktiviert, inaktiviert oder festgelegt.
ibmcloud cdb deployment-autoscaling-set (NAME | ID) GROUP_ID (@JSON_FILE| JSON_STRING) [-- json] [-- nowait]
Die automatische Skalierung kann derzeit nur für die Datenelemente in Ihrer Implementierung angewendet werden. Daher ist GROUP_ID
ein Member
. Die Parameter für die automatische Skalierung, die festgelegt oder nicht
festgelegt werden sollen, werden in einem JSON-Objekt definiert.
Befehlsoptionen
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
- `--nowait` oder `-n`
- Warten Sie nicht auf die Beendigung des Befehls.
Beispiele Mit diesem Befehl wird der Speicher für die automatische Skalierung festgelegt, wenn die E/A-Auslastung einen bestimmten Schwellenwert für eine Implementierung mit der Bezeichnung elasticsearch-preproduction
erreicht.
ibmcloud cdb deployment-autoscaling-set elasticsearch-preproduction member '{"autoscaling": { "memory": {"scalers": {"io_utilization": {"enabled": true, "over_period": "5m","above_percent": 90}},"rate": {"increase_percent": 10.0, "period_seconds": 300,"limit_mb_per_member": 125952,"units": "mb"}}}}'
Schreibgeschützte Replikate
Schreibgeschützte Replikate abrufen und konfigurieren. Derzeit werden schreibgeschützte Replikate nur von PostgreSQL-Implementierungen unterstützt.
ibmcloud cdb deployment-read-replicas
Kurzversion - read-replicas
Es werden alle schreibgeschützten Replikate für die angegebene Implementierung aufgelistet.
ibmcloud cdb deployment-read-replicas &TWBLT;Implementierungsname oder CRN> [--long] [--json]
Befehlsoptionen
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
- `--long` oder `-l`
- Es werden zusätzliche Felder in der Ausgabe angezeigt.
Beispiele Die schreibgeschützten Replikate für eine PostgreSQL-Implementierung mit der Bezeichnung 'MyPGSQL' auflisten.
ibmcloud cdb deployment-read-replikate MyPGSQL
ibmcloud cdb read-replica-leader
Kurzversion - rr-leader
Der Leader für die angegebene schreibgeschützte Replikatsimplementierung wird zurückgegeben.
ibmcloud cdb read-replica-leader &TWBLT;Implementierungsname oder CRN> [--long] [--json]
Befehlsoptionen
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
- `--long` oder `-l`
- Es werden zusätzliche Felder in der Ausgabe angezeigt.
Beispiele Den Leader für eine schreibgeschützte PostgreSQL-Replikaktsimplementierung mit der Bezeichnung 'MyPGSQL-replica' auflisten.
ibmcloud cdb read-replica-leader MyPGSQL-replica
ibmcloud cdb read-replica-promote
Kurzversion - rr-promote
Das schreibgeschützte Replikat wird in eine eigenständige Instanz hochgestuft.
ibmcloud cdb read-replica-promote &TWBLT;Implementierungsname oder CRN> [--json] [--nowait] [--skip-initial-backup]
Befehlsoptionen
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
- `--nowait` oder `-n`
- Warten Sie nicht auf die Beendigung des Befehls.
- `--skip-initial-backup` oder `s`
- Option zum Wiederherstellen der Instanz ohne das Erstellen einer Sicherung, sobald die Daten wiederhergestellt wurden. Ermöglicht eine frühere Verfügbarkeit der wiederhergestellten Implementierung.
Beispiele Eine schreibgeschützte PostgreSQL-Replikatsimplementierung mit der Bezeichnung 'MyPGSQL-replica' in eine eigenständige Implementierung hochstufen.
ibmcloud cdb read-replica-promote MyPGSQL-replica
ibmcloud cdb read-replica-resync
Kurzversion - rr-resync
Das schreibgeschützte Replik wird erneut synchronisiert.
ibmcloud cdb read-replica-resync &TWBLT; Implementierungsname oder CRN> [-- json] [-- nowait]
Befehlsoptionen
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
- `--nowait` oder `-n`
- Warten Sie nicht auf die Beendigung des Befehls.
Beispiele Eine schreibgeschützten PostgreSQL-Replikaktsimplementierung mit der Bezeichnung 'MyPGSQL-replica' erneut synchronisieren.
ibmcloud cdb read-replica-resync MyPGSQL-replica
Sicherungen
Die Sicherungskopien in Ihrer Implementierung werden verwaltet oder es wird eine bedarfsgesteuerte Sicherungskopie erstellt.
ibmcloud cdb deployment-backups-list
Kurzversion - backups
Es wird eine Liste der Sicherungen angezeigt, die einer Implementierung zugeordnet sind. Das Ergebnis ist eine Tabelle, die sich aus ID, Typ, Status und Erstellungsdatum einer Sicherung zusammensetzt. Die Ergebnisse werden so sortiert, dass die aktuellsten Sicherungen zuerst angezeigt werden.
ibmcloud cdb deployment-backups-list &TWBLT;Implementierungsname oder CRN> [--scheduled] [--first] [--json]
Befehlsoptionen
- `--scheduled` oder `-s`
- Es werden nur geplante Sicherungen ausgegeben.
- `--first` oder `-f`
- Es wird nur die erste (oder aktuellste) ermittelte Sicherung ausgegeben.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Die Sicherungen anzeigen, die für eine Implementierung mit der Bezeichnung 'Postgres2000' verfügbar sind
ibmcloud cdb backups Postgres2000
ibmcloud cdb backup-show
Details zu einer Sicherung werden angezeigt. Die Sicherung wird durch die CRN-ID angegeben, die mit dem Befehl deployment-backups-list
angezeigt wird.
ibmcloud cdb backup-show &TWBLT; CRN> [-- json]
Befehlsoptionen
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Details zu einer bestimmten Sicherung anzeigen.
ibmcloud cdb backup-show crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:ebcea542-8d8c-4b6e-a7d4-922ffd08eb50
ibmcloud cdb deployment-backup-now
Kurzversion - backup-now
Es wurde eine bedarfsgesteuerte Sicherung für die Implementierung eingeleitet. Der Befehl fragt die aktive Sicherung ab und wird beendet, wenn er abgeschlossen ist.
ibmcloud cdb deployment-backup-now &TWBLT;Implementierungsname oder CRN> [--nowait] [--json]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Sicherungstask abgeschlossen ist. Es werden Details der Sicherungstask angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Eine Sicherung für eine Implementierung mit der Bezeichnung 'PgTips' erstellen
ibmcloud cdb deployment-backup-now PgTips
Sicherheit
Es wird die IP-Zulassungsliste für Ihre Implementierung verwaltet.
ibmcloud cdb deployment-whitelist-list
Kurversion - wl-ls
Die aktuelle Zulassungsliste für eine Implementierung wird angezeigt.
ibmcloud cdb deployment-whitelist-list &TWBLT;Implementierungsname oder CRN> [--json]
Befehlsoptionen
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Die aktuelle Zulassungsliste für die Implementierung 'MyPSQL' auflisten
ibmcloud cdb deployment-whitelist-list MyPSQL
ibmcloud cdb deployment-whitelist-add
Kurzversion - wl-add
Fügen Sie eine IP-Adresse oder einen Bereich der aktuellen Zulassungsliste für eine Implementierung hinzu. Bei einer IP-Adresse handelt es sich um eine IPv4- oder IPv6-Adresse, während ein Bereich eine maskierte IPv4-Adresse ist, z. B. 1.2.3.0/24. Die Beschreibung ist erforderlich, damit eine lesbare Zeichenfolge vorhanden ist, mit der eine Adresse oder ein Bereich in der Zulassungsliste beschrieben wird.
ibmcloud cdb deployment-whitelist-add &TWBLT;Implementierungsname oder CRN> &TWBLT;Adresse oder Bereich in Zulassungsliste> &TWBLT;Beschreibung> [--nowait] [--json]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zum Hinzufügen der Zulassungsliste abgeschlossen ist. Die Details der Task zum Hinzufügen der Zulassungsliste werden angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Die IP-Adresse 198.51.100.1 der aktuellen Zulassungsliste für die Implementierung 'MyPSQL' hinzufügen
ibmcloud cdb deployment-whitelist-add MyPSQL 198.51.100.1 "allowlisted for testing"
Der IP-Bereich 198.51.100.0 bis 198.51.100.255 wird der aktuellen Zulassungsliste für die Implementierung 'MyPSQL' hinzugefügt.
ibmcloud cdb deployment-whitelist-add MyPSQL 198.51.100.0/24 "Testing range is now open"
ibmcloud cdb deployment-whitelist-delete
Kurversion - wl-del
Eine IP-Adresse oder ein Bereich wird aus der aktuellen Zulassungsliste für eine Implementierung entfernt. Bei einer IP-Adresse handelt es sich um eine IPv4- oder IPv6-Adresse, während ein Bereich eine maskierte IPv4-Adresse ist, z. B. 1.2.3.0/24.
ibmcloud cdb deployment-whitelist-delete &TWBLT;Implementierungsname oder CRN> &TWBLT;Adresse oder Bereich in der Zulassungsliste> [--nowait] [--json]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zum Löschen der Zulassungsliste abgeschlossen ist. Es werden die Details der Task zum Löschen der Zulassungsliste angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Die IP-Adresse 198.51.100.1 aus der aktuellen Zulassungsliste für die Implementierung 'MyPSQL' entfernen
ibmcloud cdb deployment-whitelist-delete MyPSQL 198.51.100.1 "allowlisted for testing"
Der IP-Bereich 198.51.100.0 bis 198.51.100.255 wird aus der aktuellen Zulassungsliste für die Implementierung 'MyPSQL' entfernt.
ibmcloud cdb deployment-whitelist-delete MyPSQL 198.51.100.0/24 "Testing range is now open"
Aufgaben
Tasks werden immer dann erstellt, wenn Sie eine Aktion in Ihrer Implementierung ausführen. Tasks umfassen beispielsweise Sicherungen, die Skalierung von Gruppen und das Ändern von Benutzerkennwörtern. Die meisten cdb
-Befehle rufen
die aktive Task ab und werden nach deren Abschluss beendet. Sie können dieses Verhalten mit dem Flag --nowait
ändern, das Taskinformationen zurückgibt und beendet wird. Datensätze mit erfolgreichen Tasks werden 24 - 48 Stunden
angezeigt, und die nicht erfolgreichen Tasks werden 7 - 8 Tage angezeigt. Über die Activity Tracker-Integration ist eine Protokollaufzeichnung von Tasks aus jedem beliebigen
Zeitraum verfügbar.
ibmcloud cdb deployment-tasks-list
Kurzversion - tasks
Es wird eine Liste aller Tasks angezeigt, die seit der Erstellung für eine angegebene Implementierung ausgeführt wurden. Jede Task wird mit dem zugehörigen CRN, einer lesbaren Beschreibung, der prozentualen Vollständigkeit, Status und Erstellungsdatum angezeigt.
ibmcloud cdb deployment-tasks-list &TWBLT;Implementierungsname oder CRN> [--json]
Befehlsoptionen
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Eine Liste der Tasks anzeigen, die in einer Implementierung mit der Bezeichnung 'NewRedis' ausgeführt wurden
ibmcloud cdb deployment-tasks-list NewRedis
ibmcloud cdb task-show
Kurzversion - task
Der Status einer bestimmten Task wird angezeigt. Die Task wird durch die zugehörige CRN-ID angegeben, die mit dem Befehl deployment-tasks-list
angezeigt wird. Wenn die Task ausgeführt wird, wartet der Befehl, bis die Task abgeschlossen
ist, und meldet Statusänderungen durch eine regelmäßige Abfrage.
ibmcloud cdb task-show &TWBLT;CRN> [--nowait] [--json]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task abgeschlossen ist. Es werden die die Details der Task zum Ändern des Benutzerkennwort angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Ergebnisse werden als JSON angezeigt.
Beispiele Details zu einer bestimmten Sicherungstask anzeigen.
ibmcloud cdb task-show crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:task:0faea465-de5a-4f14-a5ff-b402fefbd652
Elasticsearch
Es werden spezifische Tasks für Elasticsearch-Implementierungen ausgeführt.
ibmcloud cdb elasticsearch file-sync
Kurzversion - fs
Dateien aus dem Index ibm_file_sync
werden auf der Platte synchronisiert. Weitere Informationen finden Sie in der Dokumentation Dateien in Elasticsearch hochladen.
ibmcloud cdb elasticsearch file-sync &TWBLT;Implementierungsname oder CRN> [--json] [--nowait]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zur Benutzererstellung abgeschlossen ist. Die Details der Task zur Skalierung werden angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
Beispiele Eine Datei auf der Platte bei einer Implementierung mit der Bezeichnung 'MyElasticsearch' synchronisieren.
ibmcloud cdb elasticsearch file-sync MyElasticsearch
PostgreSQL
Es werden spezifische Tasks für PostgreSQL-Implementierungen ausgeführt.
ibmcloud cdb postgresql earliest-pitr-timestamp
Kurzversion - ept
Es wird der früheste verfügbare Zeitpunkt für die zeitpunktgesteuerte Wiederherstellung im Format ISO 8601 (UTC) zurückgegeben. Weitere Informationen finden Sie in der Dokumentation Punktuelle Wiederherstellung.
ibmcloud cdb postgresql earliest-pitr-timestamp &TWBLT;Implementierungsname oder CRN> [--json] [--nowait]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zur Benutzererstellung abgeschlossen ist. Die Details der Task zur Skalierung werden angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
Beispiele
ibmcloud cdb postgresql earliest-pitr-timestamp postgresql-preproduction
ibmcloud cdb postgresql replication-slot-create
Kurzversion - rsc
Es wird ein neuer PostgreSQL-Replikations-Slot erstellt. Weitere Informationen finden Sie in der Dokumentation zu Wal2json.
ibmcloud cdb postgresql replication-slot-create &TWBLT;Implementierungsname oder CRN> &TWBLT;Datenbankname> &TWBLT;Slot-Name> &TWBLT;Plugin-Typ> [--json] [--nowait]
Der Plug-in-Typ muss 'wal2json' sein.
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zur Benutzererstellung abgeschlossen ist. Die Details der Task zur Skalierung werden angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
Beispiele Einen Replikations-Slot für eine Implementierung mit der Bezeichnung 'MyPostgres', der Datenbank 'testdb' und dem Slot 'slot1' erstellen.
ibmcloud cdb postgresql replication-slot-create MyPostgres testdb slot1 wal2json
ibmcloud cdb postgresql replication-slot-delete
Kurzversion - rsd
Der angegebene PostgreSQL-Replikations-Slot wird gelöscht. Weitere Informationen finden Sie in der Dokumentation zu Wal2json.
ibmcloud cdb postgresql replication-slot-delete &TWBLT;Implementierungsname oder CRN> &TWBLT;Slot-Name> [--json] [--nowait]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zur Benutzererstellung abgeschlossen ist. Die Details der Task zur Skalierung werden angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
Beispiele Ein Replikations-Slot in einer Implementierung mit der Bezeichnung 'MyPostgres' und dem Slot 'slot1' löschen.
ibmcloud cdb postgresql replication-slot-delete MyPostgres slot1
EnterpriseDB
Es werden spezifische Tasks für EnterpriseDB-Implementierungen ausgeführt.
ibmcloud cdb enterprisedb earliest-pitr-timestamp
Kurzversion - ept
Es wird der früheste verfügbare Zeitpunkt für die zeitpunktgesteuerte Wiederherstellung im Format ISO 8601 (UTC) zurückgegeben. Weitere Informationen finden Sie in der Dokumentation Punktuelle Wiederherstellung.
ibmcloud cdb enterprisedb earliest-pitr-timestamp &TWBLT;Implementierungsname oder CRN> [--json] [--nowait]
Befehlsoptionen
- `--nowait` oder `-n`
- Warten Sie nicht, bis die Task zur Benutzererstellung abgeschlossen ist. Die Details der Task zur Skalierung werden angezeigt und der Vorgang wird beendet.
- `--json` oder `-j`
- Die Ergebnisse werden als JSON zurückgegeben.
Beispiele
ibmcloud cdb enterprisedb earliest-pitr-timestamp enterprisedb-preproduction