Cloud Databases CLI

Das Plug-in für Cloud Databases-CLI bietet zusätzliche Methoden für den Zugriff auf die Funktionen von Cloud Databases-Services. Sie können die Cloud Databases CLI verwenden, um die folgenden Dienste zu verwalten und eine Verbindung zu ihnen herzustellen:

Für das Cloud Databases CLI-Plugin muss IBM Cloud CLI installiert sein.

Das Cloud Databases CLI-Plugin (cdb) unterstützt nur Instanzen der Generation 1. Informationen zum Verwalten von Gen 2-Instanzen finden Sie in der Cloud Databases Gen 2-CLI-Referenz.

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 und Installationsanweisungen finden Sie auf der Seite IBM Cloud CLI Getting Started. 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.

Installieren Sie das eigenständige Paket von der Seite Installation des eigenständigen IBM Cloud CLI.

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

Sobald Sie die IBM Cloud CLI haben, melden Sie sich an und installieren Sie das Cloud Databases Plug-in mit einem Befehl wie diesem:

ibmcloud plugin install cloud-databases

Eine Liste der Befehle und Informationen zur Verwendung finden Sie mit einem Befehl wie dem folgenden:

ibmcloud cdb help

ibmcloud cdb help

Der Befehl ibmcloud cdb help allein zeigt die verfügbaren Befehle der obersten Ebene an. Wenn er von einem anderen Befehl gefolgt wird, zeigt er die spezifische Hilfe für diesen Befehl an.

ibmcloud cdb help [<command>]

Befehlsoptionen

Keine befehlsspezifischen Optionen.

Beispiele

Hilfe zum Befehl task-show erhalten.

ibmcloud cdb help task-show

Erste Schritte - Erstellen einer Instanz

Sie können eine Instanz mit dem folgenden Befehl erstellen:

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> -g <RESOURCE_GROUP> -p '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<endpoint>"

Befehlsoptionen

Legen Sie die Ressourcengruppe fest, wenn Sie eine andere Gruppe anstelle der Standardgruppe verwenden möchten. Sie können dieses Kennzeichen auch weglassen.

Beispiele

Erstellen Sie eine Instanz von MongoDB.

ibmcloud resource service-instance-create test-database databases-for-mongodb standard us-south -p '{"members_host_flavor": "multitenant", "members_memory_allocation_mb": "12288"}' --service-endpoints="private"

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] [--output, -o FORMAT]

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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Alle verfügbaren stabilen Versionen von 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] [--output json]

Befehlsoptionen

  • --all oder -a Instanzname und CRN werden angezeigt.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Alle aktuellen Einsätze mit einem Konto auflisten.

ibmcloud cdb ls

ibmcloud cdb deployment-about

Kurzversion - about

Verwenden Sie diesen Befehl, um Details darüber zu erhalten, welche Datenbank in der Instanz eingesetzt wird, welche Version und welche Optionen angewendet werden. 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 <deployment name or CRN> [--all] [--output, -o FORMAT]

Befehlsoptionen

  • --all oder -a Alle verfügbaren Daten aus den Datensätzen des Ressourcencontrollers werden angezeigt.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Auflistung der Details einer Bereitstellung namens "RedisDBOne".

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 <userid>] [--password <password>] [--endpoint-type <endpoint type>] [--all] [--only] [--start] [--certroot <path>] [--output, -o FORMAT]

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 <userid> 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 <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 or private] oder -e [public or private] Endpunkttyp für zurückgegebene Verbindungszeichenfolgen. Entweder "öffentlich" oder "privat". (Standard: "öffentlich"). 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 <path> 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 or cli] oder -o Es werden nur die Einstellungen angezeigt, die für app-Verbindungen oder cli-Verbindungen relevant sind.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --endpoint-type oder -e Endpunkttyp für zurückgegebene Verbindungsstrings, entweder public oder private. Die Voreinstellung ist public. Da der Standardwert public ist, werden keine public Endpunkte gefunden und Sie erhalten eine Fehlermeldung: {"errors":"not_found"}. Verwenden Sie das Kennzeichen -e private, um private Endpunkte zu verwenden.

Beispiele

Zeigen Sie an, wie Sie eine Verbindung zu einer Einrichtung herstellen.

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 <deployment name or CRN> [--user <userid>] [--save] [--certroot <path>] [--output, -o FORMAT]

Befehlsoptionen

  • --user <userid> 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 <path> 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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Zeigen Sie das Zertifikat für eine Bereitstellung namens MyPostgreSQL an.

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 <deployment name or CRN> [--nowait] [--output, -o FORMAT]

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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Mit diesem Befehl werden alle externen Verbindungen zu einer Bereitstellung namens postgresq-preproduction beendet.

ibmcloud cdb deployment-kill-connections postgresq-preproduction

Funktionalität

Mithilfe der Capability-Befehle können Sie feststellen, welche Funktionen für Ihre Datenbanken und Backups verfügbar sind und unterstützt werden.

ibmcloud cdb capability

capability-show

Dieser Befehl stellt fest, ob eine Fähigkeit für einen bestimmten Datenbanktyp unterstützt wird.

Kurzversion - cs

ibmcloud cdb capability-show CAPABILITY_ID TYPE VERSION PLATFORM LOCATION TARGET_PLATFORM TARGET_LOCATION [--output, -o FORMAT] [--api-version]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --api-version oder -v Für die Anfrage verwendete API-Version.
  • --hostflavor Host Flavor für Gruppenfähigkeit.

Optionen der Fähigkeits-ID

  • autoscaling
  • encryption
  • endpoints
  • groups
  • locations
  • point_in_time_recovery
  • remotes
  • restores
  • versions

Beispiele

ibmcloud cdb capability-show 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e database 3.2.1 IBMCloud us-south

ibmcloud cdb capability-show groups postgresql 15 classic eu-gb classic us-south --hostflavor multitenant

ibmcloud cdb capability-show groups postgresql 15 classic eu-gb classic us-south --hostflavor b3c.4x16.encrypted

backup-capability-show

Mit diesem Befehl wird festgestellt, ob ein Datenbanktyp aus einer bestimmten Instanz wiederhergestellt werden kann.

Kurzversion - bcs

ibmcloud cdb discover-capability-information-from-backup (BACKUP_ID) (CAPABILITY_ID) (TARGET_PLATFORM) (TARGET_LOCATION) [--output, -o FORMAT] [--api-version] [--nowait]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --api-version oder -v Für die Anfrage verwendete API-Version.

Optionen der Fähigkeits-ID

  • restores

Beispiele

  ibmcloud cdb discover-capability-information-from-backup f7d318b6-6d4e-4d2a-9be4-7c1efbc94a52 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e IBMCloud us-south --output, -o FORMAT --api-version 2021-09-30 --nowait

deployment-capability-show

Dieser Befehl stellt fest, ob ein bestimmter Einsatz oder eine bestimmte Formation eine bestimmte Fähigkeit unterstützt.

Kurzversion - dcs

ibmcloud cdb deployment-capability-show (NAME|ID) (CAPABILITY_ID) [--target-platform] [--target-location] [--output, -o FORMAT] [--api-version] [--nowait]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --api-version oder -v Für die Anfrage verwendete API-Version.
  • --target-platform oder -p Zielplattform für die Anfrage
  • --target-location oder -l Zielort der Anfrage

Optionen der Fähigkeits-ID

  • autoscaling
  • encryption
  • endpoints
  • groups
  • locations
  • point_in_time_recovery
  • remotes
  • versions

Beispiele

ibmcloud cdb deployment-capability-show my-deployment 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e --target-location us-south --output, -o FORMAT --api-version 2021-09-30 --nowait

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 <deployment name or CRN> <newusername> <newpassword> [--nowait] [--output, -o FORMAT]

Für newusername muss ein korrekt formatierter Benutzername für die Verwendung in der Datenbank der Implementierung verwendet werden. Für newpassword 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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Erstellen Sie einen Datenbankbenutzer namens "fred" mit dem Kennwort "X1234Y5678" auf "MyPSQL".

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 <deployment name or CRN> <username> [--nowait] [--output, -o FORMAT]

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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Entfernen Sie den Datenbankbenutzer mit dem Namen "fred" aus der Bereitstellung "MyPSQL".

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 <deployment name or CRN> <username> <newpassword> [--nowait] [--output, -o FORMAT]

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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Ändern Sie das Passwort des Benutzers "fred" auf der Datenbankimplementierung "MyPSQL" in "A9876B5432".

ibmcloud cdb deployment-password MyPSQL fred A9876B5432

Datenbankkonfiguration

Auflisten oder Ändern konfigurierbarer Einstellungen für eine Bereitstellung. Die neue Konfiguration wird in einer JSON-Datei oder einer JSON-Zeichenfolge mit Einstellungen angegeben. Die Einstellungen variieren je nach Datenbanktyp, siehe Ändern der Datenbankkonfiguration für PostgreSQL oder für Redis.

ibmcloud cdb deployment-configuration-schema

Kurzversion - config-schema

Ruft die Standardkonfiguration des angegebenen Einsatzes ab.

ibmcloud cdb deployment-configuration-schema <deployment name or CRN> [--description] [--output, -o FORMAT]

Die ibmcloud cdb deployment-configuration-schema zeigt die Standardkonfiguration. Um einen aktuellen Konfigurationswert zu überprüfen, fragen Sie die Konfiguration direkt aus Ihrer Datenbank ab.

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --description oder -d Die Beschreibung der Einstellungen wird angezeigt.

Beispiele

ibmcloud cdb deployment-configuration-schema my-redis-cache

ibmcloud cdb deployment-configuration

Kurzversion - configuration

Die Konfiguration der angegebenen Implementierung wird geändert.

ibmcloud cdb deployment-configuration <deployment name or CRN> [@JSON_FILE | JSON_STRING] [--output, -o FORMAT] [--nowait]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --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

Ändern Sie die max_connections für eine PostgreSQL Bereitstellung namens " PGSettings4 " auf 150.

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 <deployable type> [--output, -o FORMAT]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Zeigen Sie die Standardgruppeneinstellungen für eine PostgreSQL Datenbankbereitstellung an.

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 wird die Anzahl der Knoten in der Gruppe angezeigt, gefolgt von:

  • Speicher- Die Gesamtspeicherzuweisung, die Zuweisung pro Mitglied, die Mindestzuweisung und die Inkremente, um die der Gesamtspeicher variiert 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.
  • Festplatte- Die gesamte Festplattenzuweisung, die Zuweisung pro Mitglied, die Mindestzuweisung und die Schritte, um die die gesamte Festplatte verändert werden kann.
ibmcloud cdb deployment-groups <deployment name or CRN> [--output, -o FORMAT]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Zeigen Sie die Skalierungsgruppeneinstellungen für eine Datenbankbereitstellung namens "MyRedis" an.

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 <deployment name or CRN> <memberid> [--memory <memory size>] [--disk <disk size>] [--cpu <value>] [--hostflavor <val>] [--nowait] [--output, -o FORMAT]

Die memberid 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 <memory size> oder -m Für den Gesamtspeicher der angegebenen Implementierungsgruppe wird ein Wert in MB festgelegt.
  • --disk <disk size> oder -d Für die gesamte Plattengröße der angegebenen Implementierungsgruppe wird ein Wert in MB festgelegt.
  • --cpu <value> oder -c Die Anzahl der dedizierten CPU-Kerne wird festgelegt.
  • --hostflavor <val> Legen Sie die Hosting-Variante der Datenbank fest: Wählen Sie aus multitenant für Shared Compute oder aus den individuellen Größenauswahlen für Isolated Compute.
  • --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.
  • --output oder -o FORMAT Ergebnisse als JSON.

Beispiele

Legen Sie eine PostgreSQL Bereitstellung mit dem Namen "MyPGSQL" mit einer "Mitglied"-Gruppe fest, die einen Gesamtspeicher von 4096 MB haben soll.

ibmcloud cdb deployment-groups-set MyPGSQL member --memory 4096

Regionen

Listet alle Regionen auf, in denen Bereitstellungen aus der aktuellen Region bereitgestellt werden können.

ibmcloud cdb regions [--output, -o FORMAT] [--api-version]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • api-version value Für die Anfrage verwendete API-Version.

Beispiele

Gibt eine JSON-Datei mit allen Regionen zurück, in denen Bereitstellungen aus der aktuellen Region bereitgestellt werden können.

ibmcloud cdb regions --output, -o FORMAT

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 <deployment name or CRN> GROUP_ID [--output, -o FORMAT]

Die automatische Skalierung kann derzeit nur für die Datenelemente in Ihrer Implementierung angewendet werden. Daher ist GROUP_ID ein member.

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

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) [--output, -o FORMAT] [--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

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --nowait oder -n Warten Sie nicht auf die Beendigung des Befehls.

Beispiele

Mit diesem Befehl wird der Speicher automatisch skaliert, wenn die E/A-Auslastung einen bestimmten Schwellenwert für eine Bereitstellung namens 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 <deployment name or CRN> [--long] [--output, -o FORMAT]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --long oder -l Es werden zusätzliche Felder in der Ausgabe angezeigt.

Beispiele

Listen Sie die schreibgeschützten Replikate für eine PostgreSQL Bereitstellung namens "MyPGSQL" auf.

ibmcloud cdb deployment-read-replicas 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 <deployment name or CRN> [--long] [--output, -o FORMAT]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --long oder -l Es werden zusätzliche Felder in der Ausgabe angezeigt.

Beispiele

Führen Sie den Leader für eine PostgreSQL Nur-Lese-Replikatbereitstellung mit dem Namen "MyPGSQL-replica" auf.

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 <deployment name or CRN> [--output, -o FORMAT] [--nowait] [--skip-initial-backup]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --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

Versetzt eine PostgreSQL Nur-Lese-Replikat-Bereitstellung namens "MyPGSQL-replica" in eine eigenständige Bereitstellung.

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 <deployment name or CRN> [--output, -o FORMAT] [--nowait]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • --nowait oder -n Warten Sie nicht auf die Beendigung des Befehls.

Beispiele

Synchronisiert eine PostgreSQL Nur-Lese-Replikat-Bereitstellung mit dem Namen "MyPGSQL-replica" neu.

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 <deployment name or CRN> [--scheduled] [--first] [--output, -o FORMAT]

Befehlsoptionen

  • --scheduled oder -s Es werden nur geplante Sicherungen ausgegeben.
  • --first oder -f Es wird nur die erste (oder aktuellste) ermittelte Sicherung ausgegeben.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Anzeige der Sicherungen, die für eine Einrichtung mit dem Namen " 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 <CRN> [--output, -o FORMAT]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Details eines bestimmten Backups 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

Initiiert ein On-Demand-Backup für die Bereitstellung. Der Befehl fragt die aktive Sicherung ab und wird beendet, wenn er abgeschlossen ist.

ibmcloud cdb deployment-backup-now <deployment name or CRN> [--nowait] [--output, -o FORMAT]

Befehlsoptionen

  • --nowait oder -n Warten Sie nicht, bis die Sicherungstask abgeschlossen ist. Es werden Details der Sicherungstask angezeigt und der Vorgang wird beendet.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Erstellen Sie ein Backup einer Bereitstellung mit dem Namen "PgTips".

ibmcloud cdb deployment-backup-now PgTips

Sicherheit

Es wird die IP-Zulassungsliste für Ihre Implementierung verwaltet.

ibmcloud cdb deployment-allowlist-list

Kurzversion - wl-ls

Die aktuelle Zulassungsliste für eine Implementierung wird angezeigt.

ibmcloud cdb deployment-allowlist-list <deployment name or CRN> [--output, -o FORMAT]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Auflistung der aktuellen Zulassungsliste für die Bereitstellung "MyPSQL".

ibmcloud cdb deployment-whitelist-list MyPSQL

ibmcloud cdb deployment-allowlist-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-allowlist-add <deployment name or CRN> <allowlist address or range> <description> [--nowait] [--output, -o FORMAT]

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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Fügen Sie die IP-Adresse 198.51.100.1 zur aktuellen Zulassungsliste für die Bereitstellung "MyPSQL" hinzu.

ibmcloud cdb deployment-whitelist-add MyPSQL 198.51.100.1 "allowlisted for testing"

Fügen Sie den IP-Bereich 198.51.100.0 bis 198.51.100.255 zur aktuellen Zulassungsliste für die Bereitstellung "MyPSQL" hinzu.

ibmcloud cdb deployment-whitelist-add MyPSQL 198.51.100.0/24 "Testing range is now open"

ibmcloud cdb deployment-allowlist-delete

Kurzversion - 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-allowlist-delete <deployment name or CRN> <allowlist address or range> [--nowait] [--output, -o FORMAT]

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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Entfernen Sie die IP-Adresse 198.51.100.1 aus der aktuellen Zulassungsliste für die Bereitstellung "MyPSQL".

ibmcloud cdb deployment-whitelist-delete MyPSQL 198.51.100.1 "allowlisted for testing"

Entfernen Sie den IP-Bereich 198.51.100.0 bis 198.51.100.255 aus der aktuellen Zulassungsliste für die Bereitstellung von "MyPSQL".

ibmcloud cdb deployment-whitelist-delete MyPSQL 198.51.100.0/24 "Testing range is now open"

Tasks

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 <deployment name or CRN> [--output, -o FORMAT]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Zeigen Sie eine Liste der Aufgaben an, die für eine Bereitstellung namens "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 <CRN> [--nowait] [--output, -o FORMAT]

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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Details zu einem bestimmten Sicherungsauftrag 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 <deployment name or CRN> [--output, -o FORMAT] [--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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Synchronisieren Sie eine Datei auf der Festplatte einer Einrichtung namens "MyElasticsearch".

ibmcloud cdb elasticsearch file-sync MyElasticsearch

ibmcloud cdb elasticsearch user-list

Kurzversion - ul

Listet alle Benutzer aus dem datenbankinternen Berechtigungsnachweisspeicher auf. Weitere Informationen finden Sie unter Abrufen und Aktualisieren von Benutzerkennwörtern.

ibmcloud cdb elasticsearch user-list (NAME|ID) (ADMIN_PASSWORD) [--output, -o FORMAT] [-c DIRECTORY] [--api-version]

Befehlsoptionen

  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • -c DIRECTORY Wurzelzertifikat
  • --api-version Für die Anfrage verwendete API-Version.

Beispiele

Der Befehl user-list gibt verschiedene Optionen für die Benutzerliste Ihres Kontos aus.

ibmcloud cdb elasticsearch user-list

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 <deployment name or CRN> [--output, -o FORMAT] [--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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

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 <deployment name or CRN> <databasename> <slotname> <plugintype> [--output, -o FORMAT] [--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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Erstellen Sie einen Replikationsslot auf einer Bereitstellung mit dem Namen "MyPostgres", Datenbank mit dem Namen "testdb" und einem Slot mit dem Namen " slot1 ".

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 <deployment name or CRN> <slotname> [--output, -o FORMAT] [--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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.

Beispiele

Löscht einen Replikationsslot in einer Einrichtung mit dem Namen "MyPostgres" und einem Slot mit dem Namen " slot1 ".

ibmcloud cdb postgresql replication-slot-delete MyPostgres slot1

MongoDB Unternehmen

Durchführung von Aufgaben, die speziell für MongoDB Enterprise-Bereitstellungen gelten.

ibmcloud cdb mongodbee 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 unter Point in Time Recovery.

ibmcloud cdb mongodb-enterprise earliest-pitr-timestamp <deployment name or CRN> [--output, -o FORMAT] [--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.
  • --output oder -o FORMAT Geben Sie ein Ausgabeformat an. Es wird nur JSON unterstützt.
  • api-version value Für die Anfrage verwendete API-Version.

Beispiele

ibmcloud cdb mongodb earliest-pitr-timestamp (NAME|ID)

Redis

Durchführung spezifischer Aufgaben für die Bereitstellung von Redis.

ibmcloud cdb redis user-set

Bearbeiten Sie die Rollen der Benutzer von Redis. Weitere Informationen finden Sie unter Redis RBAC verwalten.

ibmcloud cdb redis user-set <"roles">

Beispiele

ibmcloud cdb redis user-set "-all +@read"