Oracle-Datenbank-CLI-Referenz

Die Datenbank-CLI (dbcli) ist eine für Base Database Service verfügbare Befehlszeilenschnittstelle. Nachdem Sie eine Verbindung zum DB-System im Base Database-Service hergestellt haben, können Sie mit dbcli Aufgaben ausführen, wie das Erstellen von Oracle-Datenbank-Homes und -Datenbanken.

Verwendungshinweise

  • Die Befehle der Datenbank-CLI müssen als Root-Benutzer ausgeführt werden.

  • dbcli befindet sich im Verzeichnis /opt/oracle/dcs/bin/.

    Dieses Verzeichnis ist im Pfad für die Umgebung des Root-Benutzers enthalten.

  • Oracle Database speichert Logs der dbcli-Befehlsausgabe in den Dateien dcscli.log und dcs-agent.log im Verzeichnis /opt/oracle/dcs/log/.

  • Bei den Datenbank-CLI-Befehlen und den meisten Parametern muss zwischen Groß- und Kleinschreibung unterschieden werden. Geben Sie sie daher genauso wie dargestellt ein. Bei einigen Parametern wird die Groß-/Kleinschreibung nicht beachtet, wie in den Parameterbeschreibungen angegeben. Diese können in Groß- oder Kleinbuchstaben eingegeben werden.

Syntax

Die Datenbank-CLI-Befehle verwenden die folgende Syntax:

dbcli command [parameters]

Hierbei gilt:

  • command ist eine Verb-Objekt-Kombination wie create-database.
  • parameters enthalten zusätzliche Optionen für den Befehl. Den meisten Parameternamen sind zwei Bindestriche vorangestellt. Beispiel: --help. Vor abgekürzten Parameternamen steht ein Bindestrich. Beispiel: -h.
  • Vom Benutzer angegebene Parameterwerte werden als roter Text in spitzen Klammern angezeigt: Beispiel: <db_home_id>. Lassen Sie die spitzen Klammern bei der Angabe dieser Werte weg.
  • Der Hilfeparameter ist bei jedem Befehl verfügbar.

Der Rest dieses Themas enthält Syntax und weitere Details zu den Befehlen.

CLI-Aktualisierungsbefehl

Manchmal werden neue Befehle zur Datenbank-CLI hinzugefügt, und andere Befehle werden aktualisiert, um neue Features zu unterstützen. Mit dem folgenden Befehl können Sie die Datenbank-CLI aktualisieren:

cliadm update-dbcli

Verwenden Sie den Befehl cliadm update-dbcli, um die Datenbank-CLI mit neuen und aktualisierten Befehlen zu aktualisieren.

Hinweis:

Führen Sie auf RAC-DB-Systemen den Befehl cliadm update-dbcli auf jedem Knoten im Cluster aus.

Syntax

cliadm update-dbcli [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Mit dem folgenden Befehl wird dbcli aktualisiert:

cliadm update-dbcli
Ausgabe:
{
  "jobId" : "dc9ce73d-ed71-4473-99cd-9663b9d79bfd",
  "status" : "Created",
  "message" : "Dcs cli will be updated",
  "reports" : [ ],
  "createTimestamp" : "January 18, 2017 10:19:34 AM PST",
  "resourceList" : [ ],
  "description" : "dbcli patching",
  "updatedTime" : "January 18, 2017 10:19:34 AM PST"
}

Agent-Befehle

Der folgende Befehl ist zur Verwaltung von Agents verfügbar: 

  • dbcli ping-agent

dbcli ping-agent

Verwenden Sie den Befehl dbcli ping-agent, um die Erreichbarkeit eines Agents zu testen.

Syntax

dbcli ping-agent [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Autologcleanpolicy-Befehle

Die folgenden Befehle sind verfügbar, um Policys für das automatische Löschen (Bereinigen) von Logs zu verwalten.

  • dbcli create-autoLogCleanPolicy
  • dbcli list-autoLogCleanPolicy

dbcli create-autoLogCleanPolicy

Verwenden Sie den Befehl dbcli create-autoLogCleanPolicy, um Policys für das automatische Löschen (Bereinigen) von Logs zu erstellen.

Syntax

dbcli create-autoLogCleanPolicy 
  [-c {gi|database|dcs}] 
  [-f <number>] 
  [-o <number>] 
  [-u {Day|Hour|Minute}] 
  [-uMB <number>] 
  [-uPer <number>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-c --components (Optional) Zu löschende Komponenten. Mögliche Werte: gi, database und dcs. Trennen Sie mehrere Werte durch Kommas. Beispiel: gi,dcs
-f --freeSpaceBelowPercentage (Optional) Bereinigt Logs, wenn der freie Speicherplatz unter dem angegebenen Prozentsatz der gesamten Partitionsgröße liegt. Gültiger Bereich: 20-50. Standard: 20.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-o --olderthan (Optional) Mengenanteil des Zeitintervalls. Standard: 30. Bereinigt Logs, die älter als das angegebene Zeitintervall sind (-o und -u).
-u --olderThanUnit (Optional) Einheitsanteil des Zeitintervalls. Mögliche Werte: Day, Hour oder Minute. Standardwert: Day. Bereinigt Logs, die älter als das angegebene Zeitintervall sind (-o und -u).
-uMB --usageOverMB (Optional) Löscht Logs, wenn die Lognutzung die angegebene Anzahl an Megabyte (MB) überschreitet. Gültiger Bereich: 10 bis 50% der gesamten Partitionsgröße.
-uPer --usageOverPercentage (Optional) Bereinigt Logs, wenn die Lognutzung den angegebenen Prozentsatz der gesamten Partitionsgröße überschreitet. Gültiger Bereich: 10-50.

dbcli list-autoLogCleanPolicy

Verwenden Sie den Befehl dbcli list-autoLogCleanPolicy, um Policys für die automatische Bereinigung von Logs aufzulisten.

Syntax

dbcli list-autoLogCleanPolicy 
  [-c {gi|database|dcs}] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-c --components (Optional) Komponenten. Mögliche Werte: gi, database und dcs. Trennen Sie mehrere Werte durch Kommas. Beispiel: gi,dcs
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Backupbefehle

Die folgenden Befehle sind zum Sichern von Datenbanken verfügbar: 

  • dbcli create-backup
  • dbcli getstatus-backup
  • dbcli schedule-backup

Hinweis:

Statt dbcli können Sie die Datenbanken Ihres DB-Systems mit der Konsole oder der API in Object Storage sichern. Wenn Sie jedoch von dbcli zur Verwendung von verwalteten Backups wechseln, wird eine neue Backupkonfiguration erstellt und mit Ihrer Datenbank verknüpft. Auf die mit dbcli erstellten Backups können Sie mit den Schnittstellen für verwaltete Backups nicht zugreifen. Informationen zu verwalteten Backups finden Sie unter Backup und Recovery in Base Database Service.

Bevor Sie eine Datenbank mit dem Befehl dbcli create-backup sichern können, müssen Sie folgende Schritte ausführen:

  1. Erstellen Sie eine Backupkonfiguration mit dem Befehl dbcli create-backupconfig.
  2. Verknüpfen Sie die Backupkonfiguration über den Befehl dbcli update-database mit der Datenbank.

Nachdem eine Datenbank mit einer Backupkonfiguration verknüpft wurde, können Sie den Befehl dbcli create-backup in einem cron-Job verwenden, um Backups automatisch auszuführen. Sie können Ausdrücke mit einem Cron-Utility wie CronMaker erstellen. Weitere Informationen finden Sie unter CronMaker.

dbcli create-backup

Verwenden Sie den Befehl dbcli create-backup, um ein Backup einer Datenbank zu erstellen.

Syntax

dbcli create-backup 
  -in <db_name> 
  -i <db_id> 
  [-bt {Regular-L0|Regular-L1|Longterm|ArchiveLog}] 
  [-c {Database|TdeWallet}] 
  [-k <n>] 
  [-t <tag>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-bt --backupType

(Optional) Backuptyp. Mögliche Werte: Regular-L0, Regular-L1, Longterm und ArchiveLog. "Regular-L0" und "Regular L1" entsprechen inkrementellen Backups der Ebenen 0 und 1. "Longterm" entspricht einem vollständigen Backup. "ArchiveLog" entspricht einem Backup von archivierten Redo-Logs. Der Standardwert ist "Regular-L1". Bei den Werten wird nicht zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie keinen Wert angeben, wird der Standardwert verwendet.

-c --component

(Optional) Komponente. Mögliche Werte: Database und TdeWallet. Der Standardwert ist "Database". Mit dem Wert "TdeWallet" werden TDE-Wallets gesichert. Bei den Werten wird nicht zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie keinen Wert angeben, wird der Standardwert verwendet.

Beachten Sie, dass die TDE-Wallets in folgenden Situationen automatisch gesichert werden: 
  • Eine Datenbank wird mit einer Object Storage-Backupkonfiguration erstellt.
  • Eine Datenbank mit einer Object Storage-Backupkonfiguration wird aktualisiert.
  • Eine Object Storage-Backupkonfiguration wird aktualisiert.
  • Ein Backup des Typs "Longterm" wird erstellt.
  • Der TDE-Schlüssel für eine Datenbank wird rotiert.
  • Eine Datenbank wird gesichert, und es sind noch keine TDE-Wallet-Backups vorhanden.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbid Die ID der zu sichernden Datenbank. Verwenden Sie den Befehl dbcli list-databases, um die Datenbank-ID abzurufen.
-in --dbName Der Name der zu sichernden Datenbank. Verwenden Sie den Befehl dbcli list-databases, um den Datenbanknamen abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-k --keepDays

(Optional) Gibt die Zeit an, bis zu der das Backup oder die Kopie aufbewahrt werden muss. Nach dieser Zeit ist das Backup veraltet, unabhängig von den Einstellungen der Backupaufbewahrungs-Policy. Nur für den Backuptyp "Longterm".

-t --tag

(Erforderlich für den Backuptyp "Longterm") Gibt einen vom Benutzer angegebenen Tagnamen für ein Backupset an und wendet dieses Tag auf die vom Befehl generierten Ausgabendateien an. Bei diesem Wert wird nicht zwischen Groß- und Kleinschreibung unterschieden. Gültige Anzahl Zeichen: 1 bis 30. Die Zeichen sind auf diejenigen begrenzt, die in Dateinamen im Zieldateisystem gültig sind. Beispiel: ASM unterstützt nicht die Verwendung des Bindestrichs (-) in den intern verwendeten Dateinamen. Daher ist "weekly-incremental" kein gültiger Tagname für Backups in ASM-Datenträgergruppen. Umgebungsvariablen sind im TAG-Parameter nicht gültig.

Beispiele

Der folgende Befehl erstellt ein Backup der angegebenen Datenbank mit der Datenbank-ID.

dbcli create-backup -i 573cadb2-0cc2-4c1c-9c31-595ab8963d5b

Der folgende Befehl erstellt ein Backup der angegebenen Datenbank mit dem Datenbanknamen ("mydb").

dbcli create-backup -in mydb

dbcli getstatus-backup

Verwenden Sie den Befehl dbcli getstatus-backup, um den Status eines Backups anzuzeigen.

Syntax

dbcli getstatus-backup 
  -t <backup_type> 
  [i <id>] 
  [-in <name>] 
  [-l] [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbId (Optional) Datenbankressourcen-ID.
-in --dbName (Optional) Datenbankressourcenname.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-l --isLatestBackupReport (Optional) Letzter Backupbericht. Standard: true.
-t --backupType Backuptyp.

dbcli schedule-backup

Verwenden Sie den Befehl dbcli schedule-backup, um ein Backup einer Datenbank zu planen.

Syntax

dbcli schedule-backup 
  -t <backup_type> 
  -f <number> 
  [i <id>] 
  [-in <name>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-f --frequency Häufigkeit in Minuten.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbId (Optional) Datenbankressourcen-ID.
-in --dbName (Optional) Datenbankressourcenname.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-t --backupType Backuptyp.

Backupconfig-Befehle

Eine Backupkonfiguration bestimmt das Backupziel und das Recovery-Fenster für Datenbankbackups. Sie erstellen die Backupkonfiguration und verknüpfen sie dann über den Befehl dbcli update-database mit einer Datenbank.

Hinweis:

Mit der Konsole konfigurierte Backups können möglicherweise nicht mehr verwendet werden, wenn Sie mit diesen Befehlen Änderungen vornehmen. Verwenden Sie diese Befehle bei Backups, die mit der Konsole konfiguriert wurden, nur unter Anleitung des Supports.

Hinweis:

Statt dbcli können Sie die Datenbanken in Ihrem DB-System mit der Konsole oder der API im Object Storage sichern. Informationen zu verwalteten Backups finden Sie unter Backup und Recovery in Base Database Service.

Nachdem eine Datenbank mit einer Backupkonfiguration verknüpft wurde, können Sie den Befehl dbcli create-backup in einem cron-Job verwenden, um Backups automatisch auszuführen. Sie können Ausdrücke mit einem Cron-Utility wie CronMaker erstellen. Weitere Informationen finden Sie unter CronMaker.

Die folgenden Befehle sind zur Verwaltung von Backupkonfigurationen verfügbar:

  • dbcli create-backupconfig
  • dbcli list-backupconfigs
  • dbcli describe-backupconfig
  • dbcli update-backupconfig
  • dbcli delete-backupconfig

dbcli create-backupconfig

Verwenden Sie den Befehl dbcli create-backupconfig, um eine Backupkonfiguration zu erstellen, die das Backupziel und Recovery-Fenster definiert.

Syntax

dbcli create-backupconfig 
  -d {DISK|OBJECTSTORE|NONE} 
  -c <bucket>  
  -o <object_store_swift_id> 
  -on <object_store_swift_name> 
  -w <n> 
  -n <name> 
  [-cr|-no-cr] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-c --container

Der Name eines vorhandenen Buckets im Oracle Cloud Infrastructure Object Storage-Service. Sie können den Bucket über die Konsole oder die Object Storage-API erstellen. Weitere Informationen finden Sie unter Buckets verwalten.

Sie müssen auch --backupdestination objectstore und den Parameter --objectstoreswiftId angeben.

-cr

-no-cr

--crosscheck

--no-crosscheck

(Optional) Gibt an, ob der Crosscheck-Vorgang aktiviert werden soll. Dieser Vorgang bestimmt, ob die Dateien auf dem Datenträger oder im Medienmanagementkatalog den Daten im RMAN-Repository entsprechen. Wenn Sie den Wert nicht angeben, wird die Standardeinstellung verwendet (Crosscheck ist standardmäßig aktiviert).

-d --backupdestination

Als Backupziel kann einer der folgenden Werte angegeben werden (bei diesen Werten wird die Groß-/Kleinschreibung nicht berücksichtigt):

DISK: Der lokale Fast Recovery-Bereich.

OBJECTSTORE: Der Oracle Cloud Infrastructure Object Storage-Service. Sie müssen auch die Parameter --container und --objectstoreswiftId angeben.

NONE: Deaktiviert das Backup.

-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-n --name Der Name der Backupkonfiguration.
-o --objectstoreswiftId

Die ID des Objektspeichers, der den Endpunkt und die Zugangsdaten für den Oracle Cloud Infrastructure Object Storage-Service enthält. Mit dem Befehl dbcli list-objectstoreswifts können Sie die Objektspeicher-ID abrufen. Mit dem Befehl dbcli create-objectstoreswift können Sie einen Objektspeicher erstellen.

Sie müssen auch --backupdestination objectstore und den Parameter --container angeben.

-on --objectstoreswiftName

Der Name des Objektspeichers, der den Endpunkt und die Zugangsdaten für den Oracle Cloud Infrastructure Object Storage-Service enthält.

Mit dem Befehl dbcli list-objectstoreswifts können Sie die Objektspeicher-ID abrufen. Mit dem Befehl dbcli create-objectstoreswift können Sie einen Objektspeicher erstellen.

Sie müssen auch --backupdestination objectstore und den Parameter --container angeben.

-w --recoverywindow

Die Zeitspanne in Tagen, für die Backups und archivierte Redo-Logs beibehalten werden. Das Intervall endet immer mit dem aktuellen Datum und reicht entsprechend den angegebenen Tagen in die Vergangenheit.

Beim Backupziel DISK geben Sie 1 bis 14 Tage an.

Beim Backupziel OBJECTSTORE geben Sie 1 bis 30 Tage an.

Beispiel

Der folgende Befehl erstellt eine Backupkonfiguration mit dem Namen "dbbkcfg1":

dbcli create-backupconfig -d Disk -w 7 -n dbbkcfg1
Ausgabe:
{
  "jobId" : "4e0e6011-db53-4142-82ef-eb561658a0a9",
  "status" : "Success",
  "message" : null,
  "reports" : [ {
    "taskId" : "TaskParallel_919",
    "taskName" : "persisting backup config metadata",
    "taskResult" : "Success",
    "startTime" : "November 18, 2016 20:21:25 PM UTC",
    "endTime" : "November 18, 2016 20:21:25 PM UTC",
    "status" : "Success",
    "taskDescription" : null,
    "parentTaskId" : "TaskSequential_915",
    "jobId" : "4e0e6011-db53-4142-82ef-eb561658a0a9",
    "tags" : [ ],
    "reportLevel" : "Info",
    "updatedTime" : "November 18, 2016 20:21:25 PM UTC"
  } ],
  "createTimestamp" : "November 18, 2016 20:21:25 PM UTC",
  "description" : "create backup config:dbbkcfg1",
  "updatedTime" : "November 18, 2016 20:21:25 PM UTC"
}

dbcli list-backupconfigs

Verwenden Sie den Befehl dbcli list-backupconfigs, um alle Backupkonfigurationen im DB-System aufzulisten.

Syntax

dbcli list-backupconfigs [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt eine Backupkonfiguration an:

dbcli list-backupconfigs
Ausgabe:
ID                                       Name                 RecoveryWindow     BackupDestination CreateTime
---------------------------------------- -------------------- ------------------ ----------------- -----------------------------
ccdd56fe-a40b-4e82-b38d-5f76c265282d     dbbkcfg1             7                  Disk              July 10, 2016 12:24:08 PM UTC

dbcli describe-backupconfig

Verwenden Sie den Befehl dbcli describe-backupconfig, um Details zu einer bestimmten Backupkonfiguration anzuzeigen.

Syntax

dbcli describe-backupconfig -i <id> -in <name> [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --backupconfigid Die ID der Backupkonfiguration. Verwenden Sie den Befehl dbcli list-backupconfigs, um die ID abzurufen.
-in --backupconfigname Der Name der Backupkonfiguration. Verwenden Sie den Befehl dbcli list-backupconfigs, um den Namen abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt Details zu einer Backupkonfiguration an:

dbcli describe-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d
Ausgabe:
Backup Config details
----------------------------------------------------------------
                     ID: ccdd56fe-a40b-4e82-b38d-5f76c265282d
                   Name: dbbkcfg1
         RecoveryWindow: 7
      BackupDestination: Disk
            CreatedTime: July 10, 2016 12:24:08 PM UTC
            UpdatedTime: July 10, 2016 12:24:08 PM UTC

dbcli update-backupconfig

Verwenden Sie den Befehl dbcli update-backupconfig, um eine vorhandene Backupkonfiguration zu aktualisieren.

Syntax

dbcli update-backupconfig 
  -i <id> 
  -in <name> 
  -w <n> 
  -d {DISK|OBJECTSTORE|NONE} 
  -c <bucket> 
  -o <object_store_swift_id> 
  -on <object_store_swift_name> 
  [-cr|-no-cr] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-c --container

Der Name eines vorhandenen Buckets im Oracle Cloud Infrastructure Object Storage-Service. Sie können den Bucket über die Konsole oder die Object Storage-API erstellen. Weitere Informationen finden Sie unter Buckets verwalten.

Sie müssen auch --backupdestination objectstore und den Parameter --objectstoreswiftId angeben.

-cr

-no-cr

--crosscheck

--no-crosscheck

(Optional) Gibt an, ob der Crosscheck-Vorgang aktiviert werden soll. Dieser Vorgang bestimmt, ob die Dateien auf dem Datenträger oder im Medienmanagementkatalog den Daten im RMAN-Repository entsprechen. Wenn Sie den Wert nicht angeben, wird die Standardeinstellung verwendet (Crosscheck ist standardmäßig aktiviert).

-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --backupconfigid Die ID der Backupkonfiguration, die aktualisiert werden soll. Verwenden Sie den Befehl dbcli list-backupconfigs, um die ID abzurufen.
-in --backupconfigname Der Name der Backupkonfiguration, die aktualisiert werden soll. Verwenden Sie den Befehl dbcli list-backupconfigs, um den Namen abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-o --objectstoreswiftId

Die ID des Objektspeichers, der den Endpunkt und die Zugangsdaten für den Oracle Cloud Infrastructure Object Storage-Service enthält. Mit dem Befehl dbcli list-objectstoreswifts können Sie die Objektspeicher-ID abrufen. Mit dem Befehl dbcli create-objectstoreswift können Sie einen Objektspeicher erstellen.

Sie müssen auch --backupdestination objectstore und den Parameter --container angeben.

-on --objectstoreswiftname

Der Name des Objektspeichers, der den Endpunkt und die Zugangsdaten für den Oracle Cloud Infrastructure Object Storage-Service enthält. Mit dem Befehl dbcli list-objectstoreswifts können Sie die Objektspeicher-ID abrufen. Mit dem Befehl dbcli create-objectstoreswift können Sie einen Objektspeicher erstellen.

Sie müssen auch --backupdestination objectstore und den Parameter --container angeben.

-w --recoverywindow

Das neue Datenträger-Recovery-Fenster.

Beim Backupziel DISK geben Sie 1 bis 14 Tage an.

Beim Backupziel OBJECTSTORE geben Sie 1 bis 30 Tage an.

Beispiel

Der folgende Befehl aktualisiert das Recovery-Fenster für eine Backupkonfiguration:

dbcli update-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d -w 5
Ausgabe:
{
  "jobId" : "0e849291-e1e1-4c7a-8dd2-62b522b9b807",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1468153731699,
  "description" : "update backup config: dbbkcfg1",
  "updatedTime" : 1468153731700
}

dbcli delete-backupconfig

Verwenden Sie den Befehl dbcli delete-backupconfig, um eine Backupkonfiguration zu löschen.

Syntax

dbcli delete-backupconfig -i <id> -in <name> [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --id Die ID der Backupkonfiguration, die gelöscht werden soll. Verwenden Sie den Befehl dbcli list-backupconfigs, um die ID abzurufen.
-in --backupconfigname Der Name der Backupkonfiguration, die gelöscht werden soll. Verwenden Sie den Befehl dbcli list-backupconfigs, um den Namen abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl löscht die angegebene Backupkonfiguration:

dbcli delete-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d

Komponentenbefehl

dbcli describe-component

Ihr DB-System enthält diesen neueren Befehl möglicherweise nicht. Wenn beim Ausführen des Befehls Probleme auftreten, verwenden Sie den CLI-Aktualisierungsbefehl, um die Datenbank-CLI zu aktualisieren, und wiederholen Sie den Befehl dann.

Hinweis:

Der Befehl dbcli describe-component ist auf RAC-DB-Systemen mit 2 Knoten nicht verfügbar. Das Patching von Systemen mit 2 Knoten aus Object Storage wird nicht unterstützt.

Verwenden Sie den Befehl dbcli describe-component, um die installierten und verfügbaren Patchversionen für die Server-, Speicher- und/oder Datenbank-Home-Komponenten im DB-System anzuzeigen.

Dieser Befehl erfordert eine gültige Object Storage-Zugangsdatenkonfiguration. Wenn die Konfiguration fehlt oder ungültig ist, verläuft der Befehl mit folgendem Fehler nicht erfolgreich: Failed to connect to the object store. Please provide valid details.

Weitere Informationen zur Aktualisierung der CLI, zum Erstellen der Zugangsdatenkonfiguration und zum Einspielen von Patches finden Sie unter DB-System aktualisieren.

Syntax

dbcli describe-component 
  [-s <server_group>] 
  [-d <db_group>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-d --dbhomes (Optional) Listet die installierten und verfügbaren Patchversionen nur für die Datenbank-Home-Komponenten auf.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-s --server (Optional) Listet die installierten und verfügbaren Patchversionen nur für die Serverkomponenten auf.

Beispiel

Der folgende Befehl zeigt die aktuellen Komponentenversionen und die verfügbaren Patchversionen im Objektspeicher an:

dbcli describe-component
Ausgabe:
System Version
---------------
12.1.2.10.0

Component                                Installed Version    Available Version
---------------------------------------- -------------------- --------------------
OAK                                      12.1.2.10.0          up-to-date
GI                                       12.1.0.2.161018      up-to-date
ORADB12102_HOME1                         12.1.0.2.161018      up-to-date  
ORADB12102_HOME2, ORADB12102_HOME3       12.1.0.2.160719      12.1.0.2.161018  

Datenbankbefehle

Die folgenden Befehle sind zur Verwaltung von Datenbanken verfügbar:

  • dbcli clone-database
  • dbcli describe-database
  • dbcli list-databases
  • dbcli modify-database
  • dbcli recover-database
  • dbcli register-database
  • dbcli update-database

dbcli clone-database

Verwenden Sie den Befehl dbcli clone-database, um eine Datenbank zu klonen.

Syntax

dbcli clone-database 
  -f <name> 
  -u <name> 
  -n <name> 
  [-s <shape>] 
  [-t <type>] 
  [m <sys_password>] 
  [-p <tde_password>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-f --sourcedbname Quelldatenbankname.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-m --syspassword (Optional) Kennwort für SYS.
-n --dbname Datenbankname.
-p --tdepassword (Optional) Kennwort für das TDE-Wallet der Quelle.
-s --dbshape (Optional) Datenbankausprägung. Beispiele: odb1, odb2.
-t --dbtype (Optional) Datenbanktyp: SI
-u --databaseUniqueName Eindeutiger Datenbankname.

dbcli describe-database

Verwenden Sie den Befehl dbcli describe-database, um Datenbankdetails anzuzeigen.

Syntax

dbcli describe-database 
  -i <db_id> 
  -in <db_name> 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbid Die ID der anzuzeigenden Datenbank. Verwenden Sie den Befehl dbcli list-databases, um die Datenbank-ID abzurufen.
-in --dbName Der Name der anzuzeigenden Datenbank. Verwenden Sie den Befehl dbcli list-databases, um den Datenbanknamen abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt Informationen für eine Datenbank mit dem Namen b727bf80-c99e-4846-ac1f-28a81a725df6 an:

dbcli describe-dbhome -i b727bf80-c99e-4846-ac1f-28a81a725df6
Ausgabe:
DB Home details
----------------------------------------------------------------
                      ID: b727bf80-c99e-4846-ac1f-28a81a725df6
                    Name: OraDB12102_home1
                 Version: 12.1.0.2
           Home Location: /u01/app/orauser/product/12.1.0.2/dbhome_1
                 Created: Jun 2, 2016 10:19:23 AM

dbcli list-databases

Verwenden Sie den Befehl dbcli list-databases, um alle Datenbanken im DB-System aufzulisten.

Syntax

dbcli  list-databases [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt eine Liste der Datenbanken an:

dbcli  list-databases
Ausgabe:
ID                                       DB Name    DB Version           CDB        Class    Shape    Storage    Status
---------------------------------------- ---------- -------------------- ---------- -------- -------- ---------- ----------
80ad855a-5145-4f8f-a08f-406c5e4684ff     dbst       12.1.0.2             true       OLTP     odb2     ACFS       Configured
6f4e36ae-120b-4436-b0bf-d0c4aef9f7c9     db11tsta   11.2.0.4             false      OLTP     odb1     ACFS       Configured
d8e31790-84e6-479c-beb0-ef97207091a2     db11tstb   11.2.0.4             false      OLTP     odb1     ACFS       Configured
cce096c7-737b-447a-baa1-f4c2a330c030     pdbtst     12.1.0.2             true       OLTP     odb1     ACFS       Configured

Der folgende Befehl zeigt die JSON-Ausgabe für eine Datenbank an:

dbcli list-databases -j
Ausgabe:
[ {
  "id" : "80ad855a-5145-4f8f-a08f-406c5e4684ff",
  "name" : "dbtst",
  "dbName" : "dbtst",
  "databaseUniqueName" : "dbtst_phx1cs",
  "dbVersion" : "12.1.0.2",
  "dbHomeId" : "2efe7af7-0b70-4e9b-ba8b-71f11c6fe287",
  "instanceOnly" : false,
  "registerOnly" : false,
  "dbId" : "167525515",
  "isCdb" : true,
  "pdBName" : "pdb1",
  "pdbAdminUserName" : "pdbuser",
  "enableTDE" : true,
  "dbType" : "SI",
  "dbTargetNodeNumber" : "0",
  "dbClass" : "OLTP",
  "dbShape" : "odb2",
  "dbStorage" : "ACFS",
  "dbCharacterSet" : {
    "characterSet" : "US7ASCII",
    "nlsCharacterset" : "AL16UTF16",
    "dbTerritory" : "AMERICA",
    "dbLanguage" : "AMERICAN"
  },
  "dbConsoleEnable" : false,
  "backupConfigId" : null,
  "backupDestination" : "NONE",
  "cloudStorageContainer" : null,
  "state" : {
    "status" : "CONFIGURED"
  },
  "createTime" : "November 09, 2016 17:23:05 PM UTC",
  "updatedTime" : "November 09, 2016 18:00:47 PM UTC"
}

dbcli modify-database

Verwenden Sie den Befehl dbcli modify-database, um eine Datenbank zu ändern.

Syntax

dbcli modify-database 
  -i <db_id> 
  -dh <destination_db_home_id> 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-dh --destdbhomeid ID des Zieldatenbank-Homes.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --databaseid Datenbank-ID.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

dbcli recover-database

Verwenden Sie den Befehl dbcli recover-database, um eine Datenbank wiederherzustellen.

Syntax

dbcli recover-database 
  [-br <json>] 
  [-in <db_name>] 
  [-i <db_id>] 
  [-r <time>] 
  [-t {Latest|PITR|SCN}] 
  [-s] 
  [-l <location>] 
  [-tp <tde_password>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-br --backupReport (Optional) JSON-Eingabe für Backupbericht.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbid (Optional) Datenbankressourcen-ID.
-in --dbName (Optional) Datenbankname.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-l --tdeWalletLocation (Optional) Speicherort des TDE-Wallet-Backups. Das TDE-Wallet muss im tar.gz-Format gesichert werden.
-r --recoveryTimeStamp (Erforderlich, wenn der Recovery-Typ PITR ist) Recovery-Zeitstempel im Format mm/tt/jjjj hh:mi:ss. Standardwert: [ ]
-s --scn (Erforderlich, wenn der Recovery-Typ SCN ist) SCN.
-t --recoverytype (Erforderlich, wenn der Backupbericht bereitgestellt wird) Recovery-Typ. Mögliche Werte: Latest, PITR und SCN.
-tp --tdeWalletPassword (Optional) TDE-Wallet-Kennwort.

dbcli register-database

Verwenden Sie den Befehl dbcli register-database, um eine Datenbank zu registrieren, die zu Oracle Cloud Infrastructure migriert wurde. Der Befehl registriert die Datenbank beim DCS-Agent, damit sie vom DCS-Agent-Stack verwaltet werden kann.

Hinweis:

Der Befehl dbcli register-database ist auf RAC-DB-Systemen mit 2 Knoten nicht verfügbar.

Syntax

dbcli  register-database 
  -bi <bkup_config_id> 
  -c {OLTP|DSS|IMDB} 
  [-co|-no-co] 
  -s {odb1|odb2|...} 
  -t SI 
  [-o <db_host_name>] 
  [-tp <password>] 
  -sn <service_name> 
  -p 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-bi --backupconfigid Definiert die Backupkonfigurations-ID. Verwenden Sie den Befehl dbcli list-backupconfigs, um die ID abzurufen.
-c --dbclass Definiert die Datenbankklasse. Die Optionen sind OLTP, DSS oder IMDB. Der Standardwert ist OLTP. Bei Enterprise Editions werden alle drei Klassen unterstützt. Bei der Standard Edition wird nur OLTP unterstützt.

-co

-no-co

--dbconsole

--no-dbconsole

(Optional) Gibt an, ob die Datenbankkonsole aktiviert wird oder nicht. Wenn Sie keinen Wert angeben, wird die Konsole nicht aktiviert.

-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-o --hostname (Optional) Definiert den Datenbankhostnamen. Der Standardwert ist Local host name.
-p --syspassword

Definiert ein sicheres Kennwort für SYS. Geben Sie -p ohne Kennwort an. Anschließend werden Sie aufgefordert, das Kennwort einzugeben.

Wenn Sie das Kennwort im Befehl eingeben müssen, beispielsweise in einem Skript, verwenden Sie -hp <password> anstelle von -p.

-s --dbshape Definiert die für die Datenbank zu verwendende Datenbankskalierungsvorlage. Beispiel: odb1, odb2 und odb3.
-sn --servicename Definiert den Namen des Datenbankservice, mit dem die EZCONNECT-Zeichenfolge für die Verbindung zur Datenbank erstellt wird. Das Format der Verbindungszeichenfolge lautet hostname:port/servicename.
-t --dbtype (Optional) Definiert den Datenbanktyp als Einzelknoten (SI). Der Standardwert ist SI.
-tp --tdeWalletPassword

(Optional) Kennwort für das TDE-Wallet. Erforderlich, wenn TDE in der migrierten Datenbank aktiviert ist.

Beispiel

Der folgende Befehl registriert die Datenbank mit der angegebenen Datenbankklasse, dem angegebenen Servicenamen und der angegebenen Datenbankskalierungsvorlage.

dbcli register-database -c OLTP -s odb1 -sn crmdb.example.com -p
Ausgabe:
Password for SYS:
{
  "jobId" : "317b430f-ad5f-42ae-bb07-13f053d266e2",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "August 08, 2016 05:55:49 AM EDT",
  "description" : "Database service registration with db service name: crmdb.example.com",
  "updatedTime" : "August 08, 2016 05:55:49 AM EDT"
}

dbcli update-database

Verwenden Sie den Befehl dbcli update-database, um eine Backupkonfiguration mit einer Datenbank zu verknüpfen.

Syntax

dbcli update-database 
  -i <db_id> 
  -bi <bkup_config_id> 
  -bin <bkup_config_name>;
  [-id <id>] 
  -in <name> 
  [-no-ab] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-bi --backupconfigid Definiert die Backupkonfigurations-ID. Verwenden Sie den Befehl dbcli list-backupconfigs, um die ID abzurufen.
-bin --backupconfigname Definiert den Backupkonfigurationsnamen für den späteren Gebrauch. Verwenden Sie den Befehl dbcli list-backupconfigs, um den Namen abzurufen.
-id --databaseid

(Optional.) Gibt die DBID an. Hierbei handelt es sich um eine eindeutige 32-Bit-ID-Nummer, die beim Erstellen der Datenbank berechnet wird. RMAN zeigt die DBID beim Herstellen der Verbindung zur Zieldatenbank an. Sie können die DBID abrufen, indem Sie View V$DATABASE oder die Recovery-Katalog-Views RC_DATABASE und RC_DATABASE_INCARNATION abfragen.

-in --dbName

Definiert den Namen der zu aktualisierenden Datenbank. Verwenden Sie den Befehl dbcli list-databases, um den Datenbanknamen abzurufen.

-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbid Definiert die ID der zu aktualisierenden Datenbank. Verwenden Sie den Befehl dbcli list-databases, um die Datenbank-ID abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-no-ab --noautobackup

(Optional) Deaktiviert automatische Backups für die angegebene Datenbank.

Beachten Sie, dass automatische Backups nach der Deaktivierung nicht mit der CLI erneut aktiviert werden können. Verwenden Sie die Konsole, um automatische Backups erneut zu aktivieren.

Beispiel

Der folgende Befehl verknüpft eine Backupkonfigurationsdatei mit einer Datenbank:

dbcli update-database -bi 78a2a5f0-72b1-448f-bd86-cf41b30b64ee -i 71ec8335-113a-46e3-b81f-235f4d1b6fde
Ausgabe:
{
  "jobId" : "2b104028-a0a4-4855-b32a-b97a37f5f9c5",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467775842977,
  "description" : "update database id:71ec8335-113a-46e3-b81f-235f4d1b6fde",
  "updatedTime" : 1467775842978
}

Dbhome-Befehle

Die folgenden Befehle sind zur Verwaltung von Datenbank-Homes verfügbar:

  • dbcli create-dbhome
  • dbcli describe-dbhome
  • dbcli delete-dbhome
  • dbcli list-dbhomes
  • dbcli update-dbhome

dbcli create-dbhome

Verwenden Sie den Befehl dbcli create-dbhome, um ein Oracle Database-Home zu erstellen.

Syntax

dbcli create-dbhome -v <version> [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-v --version Definiert die Datenbank-Home-Version.

Beispiel

Der folgende Befehl erstellt ein Oracle Database-Home mit Version 12.1.0.2:

dbcli create-dbhome -v 12.1.0.2

dbcli describe-dbhome

Verwenden Sie den Befehl dbcli describe-dbhome, um Details zum Oracle Database-Home anzuzeigen.

Syntax

dbcli describe-dbhome -i <db_home_id> [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbhomeid Gibt die Datenbank-Home-ID an. Verwenden Sie den Befehl dbcli list-dbhomes, um die ID abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Die folgende Ausgabe ist ein Beispiel für die Verwendung des Befehls zum Anzeigen der Details eines Oracle Database-Homes.

dbcli describe-dbhome -i 52850389-228d-4397-bbe6-102fda65922b
Ausgabe:
DB Home details
----------------------------------------------------------------
                     ID: 52850389-228d-4397-bbe6-102fda65922b
                   Name: OraDB12102_home1
                Version: 12.1.0.2
          Home Location: /u01/app/oracle/product/12.1.0.2/dbhome_1
                Created: June 29, 2016 4:36:31 AM UTC

dbcli delete-dbhome

Verwenden Sie den Befehl dbcli delete-dbhome, um ein Datenbank-Home aus dem DB-System zu löschen.

Syntax

dbcli delete-dbhome -i <db_home_id> [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbhomeid Gibt die ID des zu löschenden Datenbank-Homes an. Verwenden Sie den Befehl dbcli list-dbhomes, um die ID abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

dbcli list-dbhomes

Verwenden Sie den Befehl dbcli list-dbhomes, um eine Liste der Oracle Home-Verzeichnisse anzuzeigen.

Syntax

dbcli list-dbhomes [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt eine Liste der Oracle Home-Verzeichnisse an.

dbcli  list-dbhomes
Ausgabe:
ID                                   Name               DB Version Home Location
------------------------------------ -----------------  ---------- ------------------------------------------
b727bf80-c99e-4846-ac1f-28a81a725df6 OraDB12102_home1	 12.1.0.2  /u01/app/orauser/product/12.1.0.2/dbhome_1 

dbcli update-dbhome

Hinweis:

Ihr DB-System enthält diesen neueren Befehl möglicherweise nicht. Wenn beim Ausführen des Befehls Probleme auftreten, verwenden Sie den CLI-Aktualisierungsbefehl, um die Datenbank-CLI zu aktualisieren, und wiederholen Sie den Befehl dann.

Verwenden Sie den Befehl dbcli update-dbhome, um den DBBP-Bundle-Patch in ein Datenbank-Home einzuspielen. Weitere Informationen zum Einspielen von Patches finden Sie unter DB-System aktualisieren.

Syntax

dbcli update-dbhome 
  -i <db_home_id> 
  -n <node> 
  [--local] 
  [--precheck] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbhomeid Die ID des Datenbank-Homes. Verwenden Sie den Befehl dbcli list-dbhomes, um die ID abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-n --node

(Optional) Nummer des zu aktualisierenden Knotens. Verwenden Sie den Befehl dbcli list-nodes, um die Knotennummer abzurufen.

 -l --local

(Optional) Führt den Vorgang auf dem lokalen Knoten eines High-Availability-(HA-)Systems mit mehreren Knoten aus. Dieser Parameter ist zum Ausführen des Vorgangs auf einem Einzelknotensystem nicht erforderlich.

 -p --precheck

(Optional) Führt Vorabprüfungen aus, um Voraussetzungen zu prüfen.

Beispiel

Die folgenden Befehle aktualisieren das Datenbank-Home und zeigen die Ausgabe des Aktualisierungsjobs an:

dbcli update-dbhome -i e1877dac-a69a-40a1-b65a-d5e190e671e6
Ausgabe:
{
  "jobId" : "493e703b-46ef-4a3f-909d-bbd123469bea",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "January 19, 2017 10:03:21 AM PST",
  "resourceList" : [ ],
  "description" : "DB Home Patching: Home Id is e1877dac-a69a-40a1-b65a-d5e190e671e6",
  "updatedTime" : "January 19, 2017 10:03:21 AM PST"
}
dbcli describe-job -i 493e703b-46ef-4a3f-909d-bbd123469bea
Ausgabe:
Job details
----------------------------------------------------------------
                     ID:  493e703b-46ef-4a3f-909d-bbd123469bea
            Description:  DB Home Patching: Home Id is e1877dac-a69a-40a1-b65a-d5e190e671e6
                 Status:  Running
                Created:  January 19, 2017 10:03:21 AM PST
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Create Patching Repository Directories   January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:21 AM PST    Success
Download latest patch metadata           January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:21 AM PST    Success
Update System version                    January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:21 AM PST    Success
Update Patching Repository               January 19, 2017 10:03:21 AM PST    January 19, 2017 10:03:31 AM PST    Success
Opatch updation                          January 19, 2017 10:03:31 AM PST    January 19, 2017 10:03:31 AM PST    Success
Patch conflict check                     January 19, 2017 10:03:31 AM PST    January 19, 2017 10:03:31 AM PST    Running   

Dbstorage-Befehle

Die folgenden Befehle sind zur Verwaltung des Datenbankspeichers verfügbar:

  • dbcli list-dbstorages
  • dbcli describe-dbstorage

dbcli list-dbstorages

Verwenden Sie den Befehl dbcli list-dbstorages, um den Datenbankspeicher im DB-System aufzulisten.

Syntax

dbcli list-dbstorages [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt Details zum Datenbankspeicher an:

dbcli list-dbstorages
Ausgabe:
ID                                       Type   DBUnique Name        Status
---------------------------------------- ------ -------------------- ----------
afb4a1ce-d54d-4993-a149-0f28c9fb33a4     Acfs   db1_2e56b3a9b815     Configured
d81e8013-4551-4d10-880b-d1a796bca1bc     Acfs   db11xp               Configured

dbcli describe-dbstorage

Verwenden Sie den Befehl dbcli describe-dbstorage, um detaillierte Informationen zu einer bestimmten Datenbankspeicherressource anzuzeigen.

Syntax

dbcli describe-dbstorage -i <db_storage_id> [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --id Definiert die Datenbankspeicher-ID. Verwenden Sie den Befehl dbcli list-dbstorages, um die Datenbankspeicher-ID abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt die Datenbankspeicherdetails für 105a2db2-625a-45ba-8bdd-ee46da0fd83a an:

dbcli describe-dbstorage -i 105a2db2-625a-45ba-8bdd-ee46da0fd83a
Ausgabe:
DBStorage details
----------------------------------------------------------------

                     ID: 105a2db2-625a-45ba-8bdd-ee46da0fd83a
                DB Name: db1
          DBUnique Name: db1
         DB Resource ID: 439e7bd7-f717-447a-8046-08b5f6493df0
           Storage Type:
          DATA Location: /u02/app/oracle/oradata/db1
          RECO Location: /u03/app/oracle/fast_recovery_area/
          REDO Location: /u03/app/oracle/redo/
                  State: ResourceState(status=Configured)
                Created: July 3, 2016 4:19:21 AM UTC
            UpdatedTime: July 3, 2016 4:41:29 AM UTC

Dgconfig-Befehle

dbcli list-dgconfigs

Verwenden Sie den Befehl dbcli list-dgconfigs, um DG-Konfigurationen anzuzeigen.

Syntax

dbcli list-dgconfigs [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Jobbefehle

Die folgenden Befehle sind zur Verwaltung von Jobs verfügbar:

  • dbcli describe-job
  • dbcli list-jobs

dbcli describe-job

Verwenden Sie den Befehl dbcli describe-job, um Details zu einem bestimmten Job anzuzeigen.

Syntax

dbcli describe-job -i <job_id> [-h] [-j] 

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --jobid Identifiziert den Job. Verwenden Sie den Befehl dbcli list-jobs, um die Job-ID abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt Details zur angegebenen Job-ID an:

dbcli describe-job -i 74731897-fb6b-4379-9a37-246912025c17
Ausgabe:
Job details
----------------------------------------------------------------
                     ID:  74731897-fb6b-4379-9a37-246912025c17
            Description:  Backup service creation with db name: dbtst
                 Status:  Success
                Created:  November 18, 2016 8:33:04 PM UTC
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Backup Validations                       November 18, 2016 8:33:04 PM UTC    November 18, 2016 8:33:13 PM UTC    Success
validate recovery window                 November 18, 2016 8:33:13 PM UTC    November 18, 2016 8:33:17 PM UTC    Success
Db cross check                           November 18, 2016 8:33:17 PM UTC    November 18, 2016 8:33:23 PM UTC    Success
Database Backup                          November 18, 2016 8:33:23 PM UTC    November 18, 2016 8:34:22 PM UTC    Success
Backup metadata                          November 18, 2016 8:34:22 PM UTC    November 18, 2016 8:34:22 PM UTC    Success

dbcli list-jobs

Verwenden Sie den Befehl dbcli list-jobs, um eine Liste der Jobs anzuzeigen, einschließlich Job-IDs, Status sowie

Erstellungsdatum und -zeitstempel der Jobs.

Syntax

dbcli list-jobs [-h] [-j] 

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt eine Liste der Jobs an:

dbcli list-jobs
Ausgabe:
ID                                       Description                                                                 Created                             Status
---------------------------------------- --------------------------------------------------------------------------- ----------------------------------- ----------
0a362dac-0339-41b5-9c9c-4d229e363eaa     Database service creation with db name: db11                                November 10, 2016 11:37:54 AM UTC   Success
9157cc78-b487-4ee9-9f46-0159f10236e4     Database service creation with db name: jhfpdb                              November 17, 2016 7:19:59 PM UTC    Success
013c408d-37ca-4f58-a053-02d4efdc42d0     create backup config:myBackupConfig                                         November 18, 2016 8:28:14 PM UTC    Success
921a54e3-c359-4aea-9efc-6ae7346cb0c2     update database id:80ad855a-5145-4f8f-a08f-406c5e4684ff                     November 18, 2016 8:32:16 PM UTC    Success
74731897-fb6b-4379-9a37-246912025c17     Backup service creation with db name: dbtst                                 November 18, 2016 8:33:04 PM UTC    Success
40a227b1-8c47-46b9-a116-48cc1476fc12     Creating a report for database 80ad855a-5145-4f8f-a08f-406c5e4684ff         November 18, 2016 8:41:39 PM UTC    Success

Latestpatch-Befehl

dbcli describe-latestpatch

Hinweis:

  • Ihr DB-System enthält diesen neueren Befehl möglicherweise nicht. Wenn beim Ausführen des Befehls Probleme auftreten, verwenden Sie den CLI-Aktualisierungsbefehl, um die Datenbank-CLI zu aktualisieren, und wiederholen Sie den Befehl dann.
  • Der Befehl dbcli describe-latestpatch ist auf RAC-DB-Systemen mit 2 Knoten nicht verfügbar. Das Patching von Systemen mit 2 Knoten aus Object Storage wird nicht unterstützt.

Verwenden Sie den Befehl dbcli describe-latestpatch, um die neuesten Patches anzuzeigen, die für das DB-System eingespielt werden können und in Oracle Cloud Infrastructure Object Storage verfügbar sind.

Dieser Befehl erfordert eine gültige Object Storage-Zugangsdatenkonfiguration. Wenn die Konfiguration fehlt oder ungültig ist, verläuft der Befehl mit folgendem Fehler nicht erfolgreich: Failed to connect to the object store. Please provide valid details.

Weitere Informationen zur Aktualisierung der CLI, zum Erstellen der Zugangsdatenkonfiguration und zum Einspielen von Patches finden Sie unter DB-System aktualisieren.

Syntax

dbcli describe-latestpatch [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt die im Objektspeicher verfügbaren Patches an:

dbcli describe-latestpatch
Ausgabe:
componentType   availableVersion
--------------- --------------------
gi              12.1.0.2.161018
db              11.2.0.4.161018
db              12.1.0.2.161018
oak             12.1.2.10.0 

Logcleanjob-Befehle

Die folgenden Befehle sind zur Verwaltung von Logbereinigungsjobs verfügbar: 

  • dbcli create-logCleanJob
  • dbcli describe-logCleanJob
  • dbcli list-logCleanJobs

dbcli create-logCleanJob

Verwenden Sie den Befehl dbcli create-logCleanJob, um einen Logbereinigungsjob zu erstellen.

Syntax

dbcli create-logCleanJob 
  [-c {gi|database|dcs}] 
  [-o <number>] 
  [u {Day|Hour|Minute}] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-c --components (Optional) Komponenten. Mögliche Werte: gi, database und dcs. Trennen Sie mehrere Werte durch Kommas.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-o --olderThan (Optional) Mengenanteil des Zeitintervalls. Standard: 30. Bereinigt Logs, die älter als das angegebene Zeitintervall sind (-o und -u).
-u --unit (Optional) Einheitsanteil des Zeitintervalls. Mögliche Werte: Day, Hour oder Minute. Standardwert: Day. Bereinigt Logs, die älter als das angegebene Zeitintervall sind (-o und -u).

dbcli describe-logCleanJob

Verwenden Sie den Befehl dbcli describe-logCleanJob, um die Übersicht für einen Logbereinigungsjob anzuzeigen.

Syntax

dbcli describe-logCleanJob 
  -i <job_id> 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --jobid ID des Logbereinigungsjobs, für den die Übersicht angezeigt werden soll.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

dbcli list-logCleanJobs

Verwenden Sie den Befehl dbcli list-logCleanJobs, um Logbereinigungsjobs aufzulisten.

Syntax

dbcli list-logCleanJobs [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Netsecurity-Befehle

Die folgenden Befehle sind zur Verwaltung der Netzwerkverschlüsselung im DB-System verfügbar:

  • dbcli describe-netsecurity
  • dbcli update-netsecurity

dbcli describe-netsecurity

Verwenden Sie den Befehl dbcli describe-netsecurity, um die aktuelle Netzwerkverschlüsselungseinstellung für ein Datenbank-Home anzuzeigen.

Syntax

dbcli describe-netsecurity -H <db_home_id> [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-H --dbHomeId Definiert die Datenbank-Home-ID. Verwenden Sie den Befehl dbcli list-dbhomes, um die DB-Home-ID abzurufen.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt die Verschlüsselungseinstellung für das angegebene Datenbank-Home an:

dbcli describe-netsecurity -H 16c96a9c-f579-4a4c-a645-8d4d22d6889d
Ausgabe:
NetSecurity Rules
----------------------------------------------------------------
         DatabaseHomeID: 16c96a9c-f579-4a4c-a645-8d4d22d6889d

                   Role: Server
   EncryptionAlgorithms: AES256 AES192 AES128
    IntegrityAlgorithms: SHA1
         ConnectionType: Required

                   Role: Client
   EncryptionAlgorithms: AES256 AES192 AES128
    IntegrityAlgorithms: SHA1
         ConnectionType: Required

dbcli update-netsecurity

Verwenden Sie den Befehl dbcli update-netsecurity, um die Oracle Net-Sicherheitskonfiguration im DB-System zu aktualisieren.

Syntax

dbcli update-netsecurity 
  {-c|-s} 
  -t {REJECTED|ACCEPTED|REQUESTED|REQUIRED} 
  -H <db_home_id> 
  -e {AES256|AES192|AES128} 
  -i {SHA1|SHA512|SHA384|SHA256} 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-c --client

Gibt an, dass die angegebene Datenverschlüsselungs- oder Datenintegritätskonfiguration für den Client gilt. (--client und --server schließen sich gegenseitig aus.)

-e -- encryptionAlgorithms Definiert den Algorithmus, der für die Verschlüsselung verwendet werden soll. Geben Sie AES256, AES192 oder AES128 an.
-H --dbHomeId Definiert die Datenbank-Home-ID. Verwenden Sie den Befehl dbcli list-dbhomes, um die DB-Home-ID abzurufen.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --integrityAlgorithms Definiert den Algorithmus, der für die Integrität verwendet werden soll. Geben Sie SHA1, SHA512, SHA384 oder SHA256 an. Für Oracle Database 11g ist der einzige zulässige Wert SHA1.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-s --server Gibt an, dass die angegebene Datenverschlüsselungs- oder Datenintegritätskonfiguration für den Server gilt. (--client und --server schließen sich gegenseitig aus.)
-t --connectionType

Gibt an, wie die Oracle Net Services-Datenverschlüsselung oder -Datenintegrität mit Clients verhandelt wird. Die folgenden Werte werden in der Reihenfolge ihrer Sicherheit aufsteigend aufgelistet:

REJECTED: Datenverschlüsselung oder Datenintegrität nicht aktivieren, auch wenn sie vom Client angefordert wird.

ACCEPTED: Datenverschlüsselung oder Datenintegrität aktivieren, wenn sie vom Client angefordert wird.

REQUESTED: Datenverschlüsselung oder Datenintegrität aktivieren, wenn der Client das zulässt.

REQUIRED: Datenverschlüsselung oder Datenintegrität aktivieren oder die Verbindung ausschließen.

Beispiel

Der folgende Befehl aktualisiert den Verbindungstyp in ACCEPTED:

dbcli update-netsecurity -H a2ffbb07-c9c0-4467-a458-bce4d3b76cd5 -t ACCEPTED

Objectstoreswift-Befehle

Sie können eine Datenbank in einem vorhandenen Bucket im Oracle Cloud Infrastructure Object Storage-Service sichern, indem Sie den Befehl dbcli create-backup verwenden. Allerdings müssen Sie zunächst die folgenden Schritte ausführen:

  1. Erstellen Sie einen Objektspeicher im DB-System, der den Endpunkt und die Zugangsdaten für den Zugriff auf Object Storage enthält. Verwenden Sie dazu den Befehl dbcli create-objectstoreswift.
  2. Erstellen Sie eine Backupkonfiguration, die auf die Objektspeicher-ID und den Bucket-Namen verweist, indem Sie den Befehl dbcli create-backupconfig verwenden.
  3. Verknüpfen Sie die Backupkonfiguration über den Befehl dbcli update-database mit der Datenbank.

Die folgenden Befehle sind zur Verwaltung von Objektspeichern verfügbar.

  • dbcli create-objectstoreswift
  • dbcli describe-objectstoreswift
  • dbcli list-objectstoreswifts

dbcli create-objectstoreswift

Mit dem Befehl dbcli create-objectstoreswift können Sie einen Objektspeicher erstellen.

Syntax

dbcli create-objectstoreswift 
  -n <object_store_name> 
  -t <object_storage_namespace> 
  -u <user_name> 
  -e https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 
  -p <password>
  [-h] [-j]

Dabei ist <object_storage_namespace> der Object Storage-Namespace Ihres Mandanten.

Parameter

Parameter Vollständiger Name Beschreibung
-e --endpointurl

Die folgende Endpunkt-URL. https://swiftobjectstorage.<region_name>.oraclecloud.com/v1

-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-n --name

Der Name für den zu erstellenden Objektspeicher.

-p --swiftpassword

Das Authentifizierungstoken, das Sie mit der Konsole oder der IAM-API generiert haben. Informationen zum Generieren eines Authentifizierungstokens für die Verwendung mit Swift finden Sie unter Benutzerzugangsdaten verwalten.

Dies ist nicht das Kennwort für den Oracle Cloud Infrastructure-Benutzer.

Geben Sie -p (ohne Kennwort) an, damit Sie zur Eingabe aufgefordert werden.

Geben Sie -hp "<Kennwort>" in Anführungszeichen an, um das Kennwort (Authentifizierungstoken) im Befehl anzugeben.

-t --tenantname Der Object Storage-Namespace Ihres Mandanten.
-u --username Der Benutzername für den Oracle Cloud Infrastructure-Benutzeraccount. Beispiel: -u djones@example.com

Das ist der Benutzername, mit dem Sie sich in der Konsole anmelden.

Der Benutzername muss Zugriff auf den Objektspeicher auf Mandantenebene haben. Dazu können Sie den Benutzernamen der Administratorengruppe hinzufügen. Dadurch wird allerdings der Zugriff auf alle Cloud-Services ermöglicht. Stattdessen kann ein Administrator eine Policy erstellen, die den Zugriff auf Mandantenebene nur auf Object Storage ermöglicht. Im Folgenden finden Sie ein Beispiel für eine derartige Policy.

Allow group DBAdmins to manage buckets in tenancy
Allow group DBAdmins to manage objects in tenancy

Weitere Informationen darüber, wie Sie einer Gruppe einen Benutzer hinzufügen, finden Sie unter Gruppen verwalten. Weitere Informationen zu Policys finden Sie unter Erste Schritte mit Policys.

Beispiel

Der folgende Befehl erstellt einen Objektspeicher und fordert zur Eingabe des Swift-Kennworts auf:

dbcli create-objectstoreswift -n r2swift -t MyObjectStorageNamespace -u djones@example.com -e https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 -p
Ausgabe:
Password for Swift:
{
  "jobId" : "c565bb71-f67b-4fab-9d6f-a34eae36feb7",
  "status" : "Created",
  "message" : "Create object store swift",
  "reports" : [ ],
  "createTimestamp" : "January 19, 2017 11:11:33 AM PST",
  "resourceList" : [ {
    "resourceId" : "8a0fe039-f5d4-426a-8707-256c612b3a30",
    "resourceType" : "ObjectStoreSwift",
    "jobId" : "c565bb71-f67b-4fab-9d6f-a34eae36feb7",
    "updatedTime" : "January 19, 2017 11:11:33 AM PST"
  } ],
  "description" : "create object store:biyanr2swift",
  "updatedTime" : "January 19, 2017 11:11:33 AM PST"
}

dbcli describe-objectstoreswift

Mit dem Befehl dbcli describe-objectstoreswift können Sie Details zu einem Objektspeicher anzeigen.

Syntax

dbcli describe-objectstoreswift 
  -i <object_store_swift_id> 
  -in <object_store_swift_name> 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --objectstoreswiftid Die Objektspeicher-ID. Verwenden Sie den Befehl dbcli list-objectstoreswifts, um die ID abzurufen.
-in --objectstoreswiftName Der Objektspeichername. Verwenden Sie den Befehl dbcli list-objectstoreswifts, um den Namen abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl zeigt Details zu einem Objektspeicher an:

dbcli describe-objectstoreswift -i 910e9e2d-25b4-49b4-b88e-ff0332f7df87
Ausgabe:
Object Store details
----------------------------------------------------------------
                     ID: 910e9e2d-25b4-49b4-b88e-ff0332f7df87
                   Name: objstrswift15
               UserName: djones@example.com
             TenantName: CompanyABC
           endpoint URL: https://swiftobjectstorage.<region_name>.oraclecloud.com/v1
            CreatedTime: November 16, 2016 11:25:34 PM UTC
            UpdatedTime: November 16, 2016 11:25:34 PM UTC

dbcli list-objectstoreswifts

Verwenden Sie den Befehl dbcli list-objectstoreswifts, um die Objektspeicher in einem DB-System aufzulisten.

Syntax

dbcli list-objectstoreswifts [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl listet die Objektspeicher im DB-System auf:

dbcli list-objectstoreswifts
Ausgabe:
ID                                       Name                 UserName              TenantName     Url                                                         createTime
---------------------------------------- -------------------- --------------------  -------------- ------ ---------------------------------------------------- -----------------------------------
2915bc6a-6866-436a-a38c-32302c7c4d8b     swiftobjstr1         djones@example.com    LargeComputers https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 November 10, 2016 8:42:18 PM UTC
910e9e2d-25b4-49b4-b88e-ff0332f7df87     objstrswift15        djones@example.com    LargeComputers https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 November 16, 2016 11:25:34 PM UTC

Pendingjob-Befehl

dbcli list-pendingjobs

Verwenden Sie den Befehl dbcli list-pendingjobs, um eine Liste der ausstehenden Jobs anzuzeigen.

Syntax

dbcli list-pendingjobs [-h] [-j] 

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Rmanbackupreport-Befehle

Die folgenden Befehle sind zur Verwaltung von RMAN-Backupberichten verfügbar: 

  • dbcli create-rmanbackupreport
  • dbcli delete-rmanbackupreport
  • dbcli describe-rmanbackupreport
  • dbcli list-rmanbackupreports

dbcli create-rmanbackupreport

Verwenden Sie den Befehl dbcli create-rmanbackupreport, um einen RMAN-Backupbericht zu erstellen.

Syntax

dbcli create-rmanbackupreport 
  -w {summary|detailed} 
  -rn <name> 
  [-i <db_id>] 
  [-in <db_name>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbid (Optional) Datenbankressourcen-ID.
-in --dbname (Optional) Datenbankressourcenname.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-rn --rptname Name des RMAN-Backupberichts. Maximale Anzahl an Zeichen: 30. Setzen Sie den Namen in einfache Anführungszeichen, wenn Sonderzeichen verwendet werden.
-w --reporttype Typ des RMAN-Backupberichts. Mögliche Werte: summary oder detailed.

dbcli delete-rmanbackupreport

Verwenden Sie den Befehl dbcli delete-rmanbackupreport, um einen RMAN-Backupbericht zu löschen.

Syntax

dbcli delete-rmanbackupreport 
  [-d <db_id>] 
  [-dn <db_name>] 
  [-n <number>] 
  [-i <rpt_id>] 
  [-in <rpt_name>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-d --dbid (Optional) Datenbankressourcen-ID.
-dn --dbname (Optional) Datenbankressourcenname.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --reportid (Optional) ID des RMAN-Backupberichts.
-in --rptname (Optional) Name des RMAN-Backupberichts.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-n --numofday (Optional) Anzahl der Tage seit Erstellung (mit Datenbank-ID/Datenbankname angegeben).

dbcli describe-rmanbackupreport

Verwenden Sie den Befehl dbcli describe-rmanbackupreport, um Details zum RMAN-Backupbericht anzuzeigen.

Syntax

dbcli describe-rmanbackupreport 
  [-i <rpt_id>] 
  [-in <rpt_name>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --id (Optional) ID des RMAN-Backupberichts.
-in --name (Optional) Name des RMAN-Backupberichts.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

dbcli list-rmanbackupreports

Verwenden Sie den Befehl dbcli list-rmanbackupreports, um RMAN-Backupberichte aufzulisten.

Syntax

dbcli list-rmanbackupreports 
  [-i <db_id>] 
  [-in <db_name>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbid (Optional) Datenbankressourcen-ID.
-in --dbName (Optional) Datenbankressourcenname.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Planbefehle

Die folgenden Befehle sind zur Verwaltung von Plänen verfügbar: 

  • dbcli describe-schedule
  • dbcli list-schedules
  • dbcli update-schedule

dbcli describe-schedule

Verwenden Sie den Befehl dbcli describe-schedule, um einen Plan zu beschreiben.

Syntax

dbcli describe-schedule -i <id> [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --scheduleid Plan-ID.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

dbcli list-schedules

Verwenden Sie den Befehl dbcli list-schedules, um Pläne aufzulisten.

Syntax

dbcli list-schedules [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

dbcli update-schedule

Verwenden Sie den Befehl dbcli update-schedule, um einen Plan zu aktualisieren.

Syntax

dbcli update-schedule 
  -i <id> 
  [-x <expression>] 
  [-t <description>] 
  [-d] 
  [-e] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-d --disable (Optional) Deaktiviert den Plan.
-e --enable (Optional) Aktiviert den Plan.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --scheduleid Plan-ID.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-t --description (Optional) Beschreibung.
-x --cronExpression (Optional) Cron-Ausdruck. Verwenden Sie cronmaker.com, um einen gültigen Cron-Ausdruck zu generieren.

Scheduledexecution-Befehl

dbcli list-scheduledExecutions

Verwenden Sie den Befehl dbcli list-scheduledExecutions, um geplante Ausführungen aufzulisten.

Syntax

dbcli list-scheduledExecutions 
  [-e <execution_id>] 
  [-i <schedule_id>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-e --executionid (Optional) Ausführungs-ID.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --scheduleid (Optional) Plan-ID.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Serverbefehl

dbcli update-server

Hinweis:

Ihr DB-System enthält diesen neueren Befehl möglicherweise nicht. Wenn beim Ausführen des Befehls Probleme auftreten, verwenden Sie den CLI-Aktualisierungsbefehl, um die Datenbank-CLI zu aktualisieren, und wiederholen Sie den Befehl dann.

Verwenden Sie den Befehl dbcli update-server, um Patches für die Serverkomponenten im DB-System einzuspielen. Weitere Informationen zum Einspielen von Patches finden Sie unter DB-System aktualisieren.

Syntax

dbcli update-server 
  [-n <number>] 
  [--local] 
  [--precheck] 
  [-v]
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-l --local

(Optional) Führt den Vorgang auf dem lokalen Knoten eines High-Availability-(HA-)Systems mit mehreren Knoten aus. Dieser Parameter ist zum Ausführen des Vorgangs auf einem Einzelknotensystem nicht erforderlich.

-n --node

(Optional) Nummer des zu aktualisierenden Knotens. Verwenden Sie den Befehl dbcli list-nodes, um die Knotennummer abzurufen.

-p --precheck

(Optional) Führt Vorabprüfungen aus, um Voraussetzungen zu prüfen.

-v --version (Optional) Zu aktualisierende Version.

Beispiele

Die folgenden Befehle aktualisieren den Server und zeigen die Ausgabe des Aktualisierungsjobs an:

dbcli update-server
Ausgabe:
{
  "jobId" : "9a02d111-e902-4e94-bc6b-9b820ddf6ed8",
  "status" : "Created",
  "reports" : [ ],
  "createTimestamp" : "January 19, 2017 09:37:11 AM PST",
  "resourceList" : [ ],
  "description" : "Server Patching",
  "updatedTime" : "January 19, 2017 09:37:11 AM PST"
}
dbcli describe-job -i 9a02d111-e902-4e94-bc6b-9b820ddf6ed8
Ausgabe:
Job details
----------------------------------------------------------------
                     ID:  9a02d111-e902-4e94-bc6b-9b820ddf6ed8
            Description:  Server Patching
                 Status:  Running
                Created:  January 19, 2017 9:37:11 AM PST
                Message:

Task Name                                Start Time                          End Time                            Status
---------------------------------------- ----------------------------------- ----------------------------------- ----------
Create Patching Repository Directories   January 19, 2017 9:37:11 AM PST     January 19, 2017 9:37:11 AM PST     Success
Download latest patch metadata           January 19, 2017 9:37:11 AM PST     January 19, 2017 9:37:11 AM PST     Success
Update System version                    January 19, 2017 9:37:11 AM PST     January 19, 2017 9:37:11 AM PST     Success
Update Patching Repository               January 19, 2017 9:37:11 AM PST     January 19, 2017 9:38:35 AM PST     Success
oda-hw-mgmt upgrade                      January 19, 2017 9:38:35 AM PST     January 19, 2017 9:38:58 AM PST     Success
Opatch updation                          January 19, 2017 9:38:58 AM PST     January 19, 2017 9:38:58 AM PST     Success
Patch conflict check                     January 19, 2017 9:38:58 AM PST     January 19, 2017 9:42:06 AM PST     Success
apply clusterware patch                  January 19, 2017 9:42:06 AM PST     January 19, 2017 10:02:32 AM PST    Success
Updating GiHome version                  January 19, 2017 10:02:32 AM PST    January 19, 2017 10:02:38 AM PST    Success    

Der folgende Befehl aktualisiert nur den Knoten 0 des Servers mit Vorabprüfung: 

dbcli update-server -n 0 -p
Ausgabe:
{
  "jobId" : "3e2a1e3c-83d3-4101-86b8-4d525f3f8c18",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : "April 26, 2019 06:07:27 AM UTC",
  "resourceList" : [ ],
  "description" : "Server Patching Prechecks",
  "updatedTime" : "April 26, 2019 06:07:27 AM UTC"
}

Systembefehl

dbcli describe-system

Verwenden Sie den Befehl dbcli describe-system, um Details zum System anzuzeigen. Auf einem RAC-DB-System mit 2 Knoten gibt der Befehl Informationen zum lokalen Knoten an.

Syntax

dbcli describe-system [-b] [-d] [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-b --bom (Optional) Zeigt BOM-Informationen an.

-d

--details

(Optional) Zeigt zusätzliche Informationen zum DB-System an, einschließlich Informationen zu DCS-CLI und Agent-Version.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

TDE-Befehle

Die folgenden Befehle sind zur Verwaltung von TDE-bezogenen Elementen (Backupberichte, Schlüssel und Wallets) verfügbar: 

  • dbcli list-tdebackupreports
  • dbcli update-tdekey
  • dbcli recover-tdewallet

dbcli list-tdebackupreports

Verwenden Sie den Befehl dbcli list-tdebackupreports, um Backupberichte für TDE-Wallets aufzulisten.

Syntax

dbcli  list-tdebackupreports 
  [-i <db_id>] 
  [-in <db_name>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-i --dbResid (Optional) Zeigt die TDE-Wallet-Backupberichte für die angegebene Datenbankressourcen-ID an. Verwenden Sie den Befehl dbcli list-databases, um die Datenbankressourcen-ID abzurufen.
-in --dbResname (Optional) Zeigt die TDE-Wallet-Backupberichte für den angegebenen Datenbankressourcennamen an. Verwenden Sie den Befehl dbcli list-databases, um den Datenbankressourcennamen abzurufen.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl listet die Backupberichte für TDE-Wallets auf:

dbcli list-tdebackupreports
Ausgabe:
DbResID 			            	OraDbId			BackupLocation
--------------------------------------- --------------------	----------------------------------------
538ca5b1-654d-4418-8ce1-f49b6c987a60	1257156075 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb5/1257156075/2017-08-17/TDEWALLET_BMC60_2017-08-17_10-58-17.0990.tar.gz
538ca5b1-9fb2-4245-b157-6e25d7c988c5 	704287483 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb1/704287483/2017-08-17/TDEWALLET_AUTO_2017-08-17_11-03-25.0953.tar.gz
538ca5b1-9fb2-4245-b157-6e25d7c988c5 	704287483 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb1/704287483/2017-08-17/TDEWALLET_BMC62_2017-08-17_11-04-41.0264.tar.gz
19714ffa-de1b-4433-9188-c0592887e609 	1157116855 		https://swiftobjectstorage.us-phoenix-1.oraclecloud.com/v1/dbaasimage/backuptest/host724007/tdewallet/Testdb7/1157116855/2017-08-17/TDEWALLET_AUTO_2017-08-17_11-57-47.0605.tar.gz

dbcli update-tdekey

Verwenden Sie den Befehl dbcli update-tdekey, um den TDE-Verschlüsselungsschlüssel im TDE-Wallet zu aktualisieren. Sie können den Verschlüsselungsschlüssel für integrierbare Datenbanken (wenn "-pdbNames" angegeben sind) und/oder die Containerdatenbank (wenn "-rootDatabase" angegeben ist) aktualisieren.

Syntax

dbcli update-tdekey 
  -i <db_id> 
  -p [-all] 
  -n <pdbname1,pdbname2> 
  [-r|-no-r] 
  -t <tag_name> 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-all --allPdbNames

(Optional) Kennzeichen zum Rotieren (Aktualisieren) aller PDB-Namen. Um anstelle von angegebenen PDB-Namen alle PDBs zu aktualisieren, verwenden Sie diesen Parameter anstelle von -n. Standardwert: false.

-i --databaseId

Definiert die Datenbank-ID, für die der Schlüssel aktualisiert werden soll.

-p --password

Definiert das Kennwort für das TDE-Admin-Wallet. Geben Sie -p ohne Kennwort an. Anschließend werden Sie aufgefordert, das Kennwort einzugeben.

Wenn Sie das Kennwort im Befehl eingeben müssen, beispielsweise in einem Skript, verwenden Sie -hp <password> anstelle von -p.

-n --pdbNames Definiert die Namen der zu rotierenden (zu aktualisierenden) PDBs.

-r

-no-r

--rootDatabase

--no-rootDatabase

Gibt an, ob der Schlüssel für die Root-Datenbank rotiert werden soll, wenn es sich um eine Containerdatenbank handelt.
-t -tagName Definiert den Tagnamen, der für das Backup des Wallet verwendet wird. Der Standardwert ist OdaRotateKey.
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-j --json (Optional) Zeigt die JSON-Ausgabe an.

Beispiel

Der folgende Befehl aktualisiert nur den Schlüssel für pdb1 und pdb2:

dbcli update-tdekey -dbid ee3eaab6-a45b-4e61-a218-c4ba665503d9 -p -n pdb1,pdb2
Ausgabe:
TDE Admin wallet password:
{
  "jobId" : "08e5edb1-42e1-4d16-a47f-783c0afa4778",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467876407035,
  "description" : "TDE update",
  "updatedTime" : 1467876407035
}

Der folgende Befehl aktualisiert pdb1, pdb2 und die Containerdatenbank:

dbcli update-tdekey -dbid ee3eaab6-a45b-4e61-a218-c4ba665503d9 -p -n pdb1,pdb2 -r
Ausgabe:
TDE Admin wallet password:
{
  "jobId" : "c72385f0-cd81-42df-a8e8-3a1e7cab1278",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467876433783,
  "description" : "TDE update",
  "updatedTime" : 1467876433783
}

dbcli recover-tdewallet

Verwenden Sie den Befehl dbcli recover-tdewallet, um ein TDE-Wallet wiederherzustellen.

Syntax

dbcli recover-tdewallet 
  -in <db_name> 
  -tp <password> 
  [-l <location>] 
  [-h] [-j]

Parameter

Parameter Vollständiger Name Beschreibung
-h --help (Optional) Zeigt Hilfe zur Verwendung des Befehls an.
-in --dbName Datenbankname.
-j --json (Optional) Zeigt die JSON-Ausgabe an.
-l --tdeWalletBackuplocation (Optional) Speicherort des TDE-Wallet-Backups. Das TDE-Wallet muss im tar.gz-Format gesichert werden.
-tp --tdeWalletPassword

Definiert das Kennwort für das TDE-Admin-Wallet.