Oracle Database CLI 參照

資料庫 CLI (dbcli) 是適用於「基準資料庫服務」的命令行介面。在基準資料庫服務中連線至資料庫系統之後，您可以使用 dbcli 來執行建立 Oracle 資料庫本位目錄和資料庫等作業。

作業備註

• 資料庫 CLI 命令必須以 root 使用者身分執行。

• dbcli 位於 /opt/oracle/dcs/bin/ 目錄中。

  此目錄包含在根使用者環境的路徑中。

• Oracle Database 會將 dbcli 命令輸出的日誌保留在 /opt/oracle/dcs/log/ 目錄的 dcscli.log 和 dcs-agent.log 檔案中。
• 資料庫 CLI 命令與大多數參數均有大小寫之分，請依照所示輸入。幾個參數不區分大小寫 (如參數描述中所示)，而且可以用大寫或小寫來輸入。

語法

資料庫 CLI 命令使用下列語法：

dbcli command [parameters]

其中：

• command 是動詞物件組合，例如 list-databases。
• parameters 包含指令的其他選項。大多數的參數名稱前面會有兩個虛線，例如 --help。縮寫的參數名稱前面會有一個破折號，例如 -h。
• 使用者指定的參數值會以紅色文字顯示在角括號內，例如 \<db_home_id> 。指定這些值時省略角括號。
• 每個指令都可以使用 help 參數。

此主題的其餘部分包含命令的語法和其他詳細資訊。

CLI 更新指令

有時會新增命令至資料庫 CLI，而其他命令會更新以支援新功能。您可以使用下列命令來更新資料庫 CLI：

cliadm update-dbcli

使用 cliadm update-dbcli 命令，使用最新和更新的命令來更新資料庫 CLI。

注意：在 RAC 資料庫系統上，在叢集中的每個節點上執行 cliadm update-dbcli 命令。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會更新 dbcli：

cliadm update-dbcli

輸出：

{
  "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"
}

代理程式命令

您可以使用下列命令來管理代理程式：

• dbcli ping-agent

dbcli ping 代理

使用 dbcli ping-agent 命令來測試代理程式的連線能力。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

Autologcleanpolicy 命令

下列命令可用來管理自動清除 (整個清除) 日誌的原則。

• dbcli create-autoLogCleanPolicy
• dbcli list-autoLogCleanPolicy

dbcli create-autoLogCleanPolicy

使用 dbcli create-autoLogCleanPolicy 命令建立自動清除 (整個清除) 日誌的原則。

語法：

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

參數：

參數	完整名稱	說明
-c	--components	(選用) 要清除的元件。可能的值為 gi、資料庫和 dcs。請使用逗號區隔值。範例：gi,dcs
-f	--freeSpaceBelowPercentage	(選擇性) 可用磁碟空間低於指定的分割區總大小百分比時，清除記錄。有效範圍：20-50。預設值：20。
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。
-o	--olderthan	(選擇性) 時間間隔的「數量」部分。預設值：30。清除超過指定時間間隔 (-o 和 -u) 的日誌。
-u	--olderThanUnit	(選用) 時間間隔的單位部分。可能的值：天、小時或分鐘。預設：天。清除超過指定時間間隔 (-o 和 -u) 的日誌。
-uMB	--usageOverMB	(選擇性) 當日誌使用量超過指定的 MegaBytes 數目 (MB) 時，永久清除日誌。有效範圍：分割區大小總計的 10% 到 50%。
-uPer	--usageOverPercentage	(選擇性) 當日誌使用量超過指定百分比的分割區大小總計時，永久清除日誌。有效範圍：10-50。

dbcli list-autoLogCleanPolicy

使用 dbcli list-autoLogCleanPolicy 命令列出自動清除日誌的原則。

語法：

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

參數：

參數	完整名稱	說明
-c	--components	(選用) 元件。可能的值為 gi、資料庫和 dcs。請使用逗號區隔值。範例：gi,dcs
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

備份命令

您可以使用下列命令來備份資料庫：

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

注意：您可以使用主控台或 API 來管理資料庫系統備份至物件儲存的資料庫，而不是使用 dbcli。不過，如果您從使用 dbcli 切換為使用受管理的備份，則會建立新的備份組態並與您的資料庫建立關聯，而使用 dbcli 建立的備份將無法從受管理的備份介面存取。如需有關受管理備份的資訊，請參閱備份與復原基準資料庫服務。

在您可以使用 dbcli create-backup 命令備份資料庫之前，必須先：

1. 使用 dbcli create-backupconfig 命令建立備份組態。
2. 使用 dbcli update-database 命令建立備份組態與資料庫的關聯。

資料庫與備份組態關聯後，您可以在 cron 工作中使用 dbcli create-backup 命令自動執行備份。您可以使用 cron 公用程式 (例如 CronMaker) 來協助建立表示式。如需詳細資訊，請參閱 CronMaker 。

dbcli 建立備份

使用 dbcli create-backup 命令來建立資料庫備份。

語法：

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]

參數：

參數	完整名稱	說明
-bt	--backupType	(選用) 備份類型。可能的值包括 Regular-L0、Regular-L1、Longterm 以及 ArchiveLog。Regular-L0 和 Regular L1 會對應增量 L0 和 L1 備份。長期對應至完整備份。ArchiveLog 對應於存檔重做日誌備份。預設值為「一般 - L1」。這些值不區分大小寫。如果省略，則會使用預設值。
-c	--component	(選用) 元件。可能的值為 Database 和 TdeWallet。預設值為「資料庫」。TdeWallet 值可備份 TDE 公事包。值不區分大小寫。如果省略，則會使用預設值。 請注意，在下列情況下，TDE 公事包會自動備份： 系統會以物件儲存備份組態來建立資料庫。 會更新一個具有物件儲存備份組態的資料庫。 物件儲存備份組態已更新。 系統會建立 Longterm 類型的備份。 資料庫的 TDE 金鑰會被循環。 資料庫已備份，而且還沒有 TDE 公事包備份。
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbid	要備份之資料庫的 ID。使用 dbcli list-databases 命令取得資料庫的 ID。
-in	--dbName	要備份的資料庫名稱。使用 dbcli list-databases 命令取得資料庫的名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。
-k	--keepDays	(選擇性) 指定必須保留備份或複製的時間。在此時間之後，不論備份保留原則設定值為何，備份都會過時。僅適用於長期備份類型。
-t	--tag	(用於長期備份類型) 指定備份集的使用者指定標記名稱，並將此標記套用至指令產生的輸出檔案。此值不區分大小寫。有效的字元數：1 到 30。這些字元僅限於目標檔案系統上檔案名稱中有效的字元。例如，ASM 不支援在其內部使用的檔案名稱中使用連字號 (-) 字元，因此 weekly-incremental 不是 ASM 磁碟群組中備份的有效標記名稱。TAG 參數中的環境變數無效。

範例：

下列命令會使用資料庫 ID 建立指定資料庫的備份。

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

下列命令會使用資料庫名稱 ("mydb") 建立指定資料庫的備份。

dbcli create-backup -in mydb

dbcli getstatus-backup

使用 dbcli getstatus-backup 命令來顯示備份的狀態。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbId	(選用) 資料庫資源 ID。
-in	--dbName	(選用) 資料庫資源名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。
-l	--isLatestBackupReport	(選擇性) 最新備份報表。預設值： true。
-t	--backupType	備份類型。

dbcli 排程備份

使用 dbcli schedule-backup 命令來排定資料庫備份。

語法：

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

參數：

參數	完整名稱	說明
-f	--frequency	頻率 (分鐘).
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbId	(選用) 資料庫資源 ID。
-in	--dbName	(選用) 資料庫資源名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。
-t	--backupType	備份類型。

Backupconfig 命令

備份組態決定資料庫備份的備份目的地和復原時段。您可以建立備份組態，然後使用 dbcli update-database 命令將它與資料庫建立關聯。

注意： 如果您使用這些命令進行變更，使用主控台設定的備份可能會變成無法使用。若為使用主控台設定的備份，請只使用這些命令與支援指南。

注意：您可以使用主控台或 API 來管理將資料庫系統中的資料庫備份至物件儲存，而不是使用 dbcli。如需有關受管理備份的資訊，請參閱備份與復原基準資料庫服務。

資料庫與備份組態關聯後，您可以在 cron 工作中使用 dbcli create-backup 命令自動執行備份。您可以使用 cron 公用程式 (例如 CronMaker) 來協助建立表示式。如需詳細資訊，請參閱 CronMaker 。

您可以使用下列命令來管理備份組態：

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

dbcli create-backupconfig

使用 dbcli create-backupconfig 命令建立定義備份目的地和復原時段的備份組態。

語法：

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]

參數：

參數	完整名稱	說明
-c	--container	Oracle Cloud Infrastructure Object Storage 服務中現有儲存桶的名稱。您可以使用主控台或物件儲存 API 建立儲存桶。如需詳細資訊，請參閱管理儲存桶。 您還必須指定 --backupdestination objectstore 和 --objectstoreswiftId 參數。
-cr -no-cr	--crosscheck --no-crosscheck	(選擇性) 指示是否啟用交叉檢查作業。這項作業會判斷磁碟或媒體管理目錄中的檔案是否對應至 RMAN 儲存區域中的資料。如果省略，會使用預設設定 (預設會啟用交叉檢查)。
-d	--backupdestination	備份目的地為下列其中之一 (這些值不區分大小寫)： DISK - 本機「快速復原區域」。 物件儲存 - Oracle Cloud Infrastructure Object Storage 服務。您還必須指定 --container 和 --objectstoreswiftId 參數。 NONE - 停用備份。
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。
-n	--name	備份組態的名稱。
-o	--objectstoreswiftId	包含 Oracle Cloud Infrastructure Object Storage 服務端點和證明資料的物件存放區 ID。使用 dbcli list-objectstoreswifts 命令取得物件存放區 ID。使用 dbcli create-objectstoreswift 命令來建立物件存放區。 您還必須指定 --backupdestination objectstore 和 --container 參數。
-on	--objectstoreswiftName	包含 Oracle Cloud Infrastructure Object Storage 服務端點和證明資料的物件存放區名稱。 使用 dbcli list-objectstoreswifts 命令取得物件存放區 ID。使用 dbcli create-objectstoreswift 命令來建立物件存放區。 您還必須指定 --backupdestination objectstore 和 --container 參數。
-w	--recoverywindow	備份與存檔重做日誌的維護天數。間隔一律以目前時間結束，並以指定的天數延後。 如果是 DISK 備份目的地，請指定 1 到 14 天。 如果是 OBJECTSTORE 備份目的地，請指定 1 到 30 天。

範例：

下列指令會建立名為 'dbbkcfg1' 的備份組態：

dbcli create-backupconfig -d Disk -w 7 -n dbbkcfg1

輸出：

{
  "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-backupconfig

使用 dbcli list-backupconfigs 命令列出資料庫系統中的所有備份組態。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會列出備份組態：

dbcli list-backupconfigs

輸出：

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

dbcli describe-backupconfig

您可以使用 dbcli describe-backupconfig 命令來顯示特定備份組態的詳細資訊。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--backupconfigid	備份組態 ID。使用 dbcli list-backupconfigs 命令取得 ID。
-in	--backupconfigname	備份組態的名稱。使用 dbcli list-backupconfigs 命令取得名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會顯示備份組態的詳細資訊：

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

輸出：

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

使用 dbcli update-backupconfig 命令來更新現有的備份組態。

語法：

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]

參數：

參數	完整名稱	說明
-c	--container	Oracle Cloud Infrastructure Object Storage 服務中現有儲存桶的名稱。您可以使用主控台或物件儲存 API 建立儲存桶。如需詳細資訊，請參閱管理儲存桶。 您還必須指定 --backupdestination objectstore 和 --objectstoreswiftId 參數。
-cr -no-cr	--crosscheck --no-crosscheck	(選擇性) 指示是否啟用交叉檢查作業。這項作業會判斷媒體管理目錄中磁碟上的檔案是否對應 RMAN 儲存區域中的資料。如果省略，會使用預設設定 (預設會啟用交叉檢查)。
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--backupconfigid	要更新之備份組態的 ID。使用 dbcli list-backupconfigs 命令取得 ID。
-in	--backupconfigname	要更新的備份組態名稱。使用 dbcli list-backupconfigs 命令取得名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。
-o	--objectstoreswiftId	包含 Oracle Cloud Infrastructure Object Storage 服務端點和證明資料的物件存放區 ID。使用 dbcli list-objectstoreswifts 命令取得物件存放區 ID。使用 dbcli create-objectstoreswift 命令來建立物件存放區。 您還必須指定 --backupdestination objectstore 和 --container 參數。
-on	--objectstoreswiftname	包含 Oracle Cloud Infrastructure Object Storage 服務端點和證明資料的物件存放區名稱。使用 dbcli list-objectstoreswifts 命令取得物件存放區 ID。使用 dbcli create-objectstoreswift 命令來建立物件存放區。 您還必須指定 --backupdestination objectstore 和 --container 參數。
-w	--recoverywindow	新的磁碟復原時段。 如果是 DISK 備份目的地，請指定 1 到 14 天。 如果是 OBJECTSTORE 備份目的地，請指定 1 到 30 天。

範例：

下列命令會更新備份組態的復原時段：

dbcli update-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282d -w 5

輸出：

{
  "jobId" : "0e849291-e1e1-4c7a-8dd2-62b522b9b807",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1468153731699,
  "description" : "update backup config: dbbkcfg1",
  "updatedTime" : 1468153731700
}

dbcli delete-backupconfig

使用 dbcli delete-backupconfig 命令來刪除備份組態。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--id	要刪除的備份組態 ID。使用 dbcli list-backupconfigs 命令取得 ID。
-in	--backupconfigname	要刪除的備份組態名稱。使用 dbcli list-backupconfigs 命令取得名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會刪除指定的備份組態：

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

元件命令

dbcli 描述元件

您的資料庫系統可能未包括此較新的命令。如果無法執行命令，請使用 CLI Update Command 命令來更新資料庫 CLI，然後重試命令。

注意：雙節點 RAC 資料庫系統上無法使用 dbcli describe-component 命令。不支援從物件儲存修正雙節點系統。

您可以使用 dbcli describe-component 命令來顯示資料庫系統中伺服器、儲存體和 (或) 資料庫本位目錄元件的已安裝和可用修正程式版本。

此命令需要有效的物件儲存證明資料組態。如果組態遺失或無效，命令會因下列錯誤而失敗：Failed to connect to the object store. Please provide valid details.

如需有關更新 CLI、建立證明資料組態以及套用修正程式的詳細資訊，請參閱更新資料庫系統。

語法：

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

參數：

參數	完整名稱	說明
-d	--dbhomes	(選擇性) 列出僅適用於資料庫本位目錄元件的已安裝和可用的修正程式版本。
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。
-s	--server	(選擇性) 列出僅適用於伺服器元件的已安裝和可用的修正程式版本。

範例：

以下命令顯示物件存放區中目前的元件版本和可用的修正程式版本：

dbcli describe-component

輸出：

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

資料庫命令

下列指令可用於管理資料庫：

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

dbcli 複製資料庫

使用 dbcli clone-database 命令複製資料庫。

語法：

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

參數：

參數	完整名稱	說明
-f	--sourcedbname	來源資料庫名稱。
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。
-m	--syspassword	(選擇性) SYS 密碼。
-n	--dbname	資料庫名稱。
-p	--tdepassword	(選擇性) 來源 TDE 公事包的密碼。
-s	--dbshape	(選擇性) 資料庫資源配置。範例：odb1、odb2。
-t	--dbtype	(選擇性) 資料庫類型：SI
-u	--databaseUniqueName	資料庫唯一名稱。

dbcli 描述資料庫

使用 dbcli describe-database 命令來顯示資料庫詳細資訊。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbid	要顯示的資料庫 ID。使用 dbcli list-databases 命令取得資料庫 ID。
-in	--dbName	要顯示之資料庫的名稱。使用 dbcli list-databases 命令取得資料庫名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會顯示名稱為 b727bf80-c99e-4846-ac1f-28a81a725df6 之資料庫的資訊：

dbcli describe-dbhome -i b727bf80-c99e-4846-ac1f-28a81a725df6

輸出：

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 清單資料庫

使用 dbcli list-databases 命令列出資料庫系統上的所有資料庫。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會顯示資料庫清單：

dbcli  list-databases

輸出：

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

下列命令會顯示資料庫的 JSON 輸出：

dbcli list-databases -j

輸出：

[ {
  "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 修改資料庫

使用 dbcli modify-database 命令來修改資料庫。

語法：

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

參數：

參數	完整名稱	說明
-dh	--destdbhomeid	目的地資料庫本位目錄 ID。
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--databaseid	資料庫 ID。
-j	--json	(選擇性) 顯示 JSON 輸出。

dbcli 復原資料庫

使用 dbcli recover-database 命令來復原資料庫。

語法：

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]

參數：

參數	完整名稱	說明
-br	--backupReport	(選擇性) 備份報表的 JSON 輸入。
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbid	(選用) 資料庫資源 ID。
-in	--dbName	(選擇性) 資料庫名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。
-l	--tdeWalletLocation	(選擇性) TDE 公事夾備份位置。TDE 公事包應以 tar.gz 格式備份。
-r	--recoveryTimeStamp	(復原類型為 PITR 時需要) 以 mm/dd/yyyy hh:mi:ss 格式復原時戳。預設：[ ]
-s	--scn	(復原類型為 SCN 時為必要) SCN。
-t	--recoverytype	(提供備份報表時為必要項目) 復原類型。可能的值為最新、PITR 和 SCN。
-tp	--tdeWalletPassword	(選用) TDE 公事包 密碼。

dbcli 更新資料庫

使用 dbcli update-database 命令，將備份組態與資料庫建立關聯。

語法：

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

參數：

參數	完整名稱	說明
-bi	--backupconfigid	定義備份組態 ID。使用 dbcli list-backupconfigs 命令取得 ID。
-bin	--backupconfigname	定義供日後使用的備份組態名稱。使用 dbcli list-backupconfigs 命令取得名稱。
-id	--databaseid	(選用。) 指定 DBID，這是建立資料庫時所計算的唯一 32 位元識別碼。RMAN 會在連線到目標資料庫時顯示 DBID。您可以查詢 V$DATABASE 視觀表或 RC_DATABASE 和 RC_DATABASE_INCARNATION 復原目錄視觀表來取得 DBID。
-in	--dbName	定義要更新的資料庫名稱。使用 dbcli list-databases 命令取得資料庫名稱。
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbid	定義要更新的資料庫 ID。使用 dbcli list-databases 命令取得資料庫 ID。
-j	--json	(選擇性) 顯示 JSON 輸出。
-no-ab	--noautobackup	(選擇性) 停用指定資料庫的自動備份。 請注意，停用之後，便無法使用 CLI 重新啟用自動備份。若要重新啟用自動備份，請使用主控台。

範例：

下列命令會建立備份組態檔與資料庫的關聯：

dbcli update-database -bi 78a2a5f0-72b1-448f-bd86-cf41b30b64ee -i 71ec8335-113a-46e3-b81f-235f4d1b6fde

輸出：

{
  "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 命令

您可以使用下列命令來管理資料庫本位目錄：

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

dbcli 建立資料庫本位目錄

使用 dbcli create-dbhome 命令來建立 Oracle Database 本位目錄。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。
-v	--version	定義資料庫本位目錄版本。

範例：

下列命令會建立 Oracle Database 本位目錄版本 12.1.0.2：

dbcli create-dbhome -v 12.1.0.2

dbcli 描述資料庫本位目錄

使用 dbcli describe-dbhome 命令來顯示「Oracle Database 本位目錄」詳細資訊。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbhomeid	識別資料庫本位目錄 ID。使用 dbcli list-dbhomes 命令取得 ID。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列輸出為使用顯示 Oracle Database 本位目錄詳細資訊命令的範例。

dbcli describe-dbhome -i 52850389-228d-4397-bbe6-102fda65922b

輸出：

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

使用 dbcli delete-dbhome 命令從資料庫系統刪除資料庫本位目錄。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbhomeid	指定要刪除的資料庫本位目錄 ID。使用 dbcli list-dbhomes 命令取得 ID。
-j	--json	(選擇性) 顯示 JSON 輸出。

dbcli list-dbhomes

您可以使用 dbcli list-dbhomes 命令來顯示 Oracle 本位目錄的清單。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會顯示 Oracle 本位目錄的清單。

dbcli  list-dbhomes

輸出：

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

注意： 您的資料庫系統可能未包括此較新的命令。如果無法執行命令，請使用 CLI Update 命令來更新資料庫 CLI，然後重試命令。

使用 dbcli update-dbhome 命令，將 DBBP 組合修正程式套用至資料庫本位目錄。如需有關套用修補程式的詳細資訊，請參閱更新資料庫系統。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbhomeid	資料庫本位目錄的 ID。使用 dbcli list-dbhomes 命令取得 ID。
-j	--json	(選擇性) 顯示 JSON 輸出。
-n	--node	(選用) 要更新的節點編號。使用 dbcli list-nodes 命令取得節點編號。
-l	--local	(選用) 在多節點高可用性 (HA) 系統的本機節點上執行作業。在單一節點系統上執行作業不需要此參數。
-p	--precheck	(選擇性) 執行前置檢查作業來檢查先決條件。

範例：

下列命令會更新資料庫本位目錄，並顯示更新工作的輸出：

dbcli update-dbhome -i e1877dac-a69a-40a1-b65a-d5e190e671e6

輸出：

{
  "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

輸出：

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 指令

您可以使用下列命令來管理資料庫儲存：

• dbcli list-dbstorages
• dbcli describe-dbstorage

dbcli 清單資料庫儲存

使用 dbcli list-dbstorages 命令列出資料庫系統中的資料庫儲存體。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令顯示資料庫儲存的詳細資訊：

dbcli list-dbstorages

輸出：

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

dbcli 描述資料庫儲存

您可以使用 dbcli describe-dbstorage 命令來顯示特定資料庫儲存體資源的詳細資訊。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--id	定義資料庫儲存 ID。使用 dbcli list-dbstorages 命令取得資料庫儲存 ID。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會顯示 105a2db2-625a-45ba-8bdd-ee46da0fd83a 的資料庫儲存詳細資訊：

dbcli describe-dbstorage -i 105a2db2-625a-45ba-8bdd-ee46da0fd83a

輸出：

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 命令

dbcli list-dgconfigs

使用 dbcli list-dgconfigs 命令列出 DG 組態。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

工作命令

下列指令可用於管理工作：

• dbcli describe-job
• dbcli list-jobs

dbcli 描述工作

使用 dbcli describe-job 命令來顯示特定工作的詳細資訊。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--jobid	指定職務。使用 dbcli list-jobs 命令取得 jobid。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會顯示指定之工作 ID 的相關詳細資訊：

dbcli describe-job -i 74731897-fb6b-4379-9a37-246912025c17

輸出：

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- 工作

使用 dbcli list-jobs 命令顯示工作清單，包括工作 ID、狀態和工作

建立的日期與時間戳記。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會顯示工作清單：

dbcli list-jobs

輸出：

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 命令

dbcli 描述 - 最新修正

注意： 您的資料庫系統可能未包括此較新的命令。如果無法執行命令，請使用 CLI Update 命令來更新資料庫 CLI，然後重試命令。雙節點 RAC 資料庫系統不提供 dbcli describe-latestpatch 命令。不支援從物件儲存修正雙節點系統。

使用 dbcli describe-latestpatch 命令顯示適用於資料庫系統的最新修正程式，並可在 Oracle Cloud Infrastructure Object Storage 中取得。

此命令需要有效的物件儲存證明資料組態。如果組態遺失或無效，命令會因發生錯誤而失敗：Failed to connect to the object store. Please provide valid details。

如需有關更新 CLI、建立證明資料組態以及套用修正程式的詳細資訊，請參閱更新資料庫系統。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會顯示物件存放區中可用的修正程式：

dbcli describe-latestpatch

輸出：

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 命令

下列命令可供管理日誌清除工作：

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

dbcli create-logCleanJob

使用 dbcli create-logCleanJob 命令來建立日誌清除工作。

語法：

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

參數：

參數	完整名稱	說明
-c	--components	(選用) 元件。可能的值為 gi、資料庫和 dcs。以逗號分隔多個值。
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。
-o	--olderThan	(選擇性) 時間間隔的「數量」部分。預設值：30。清除超過指定時間間隔 (-o 和 -u) 的日誌。
-u	--unit	(選用) 時間間隔的單位部分。可能的值：天、小時或分鐘。預設：天。清除超過指定時間間隔 (-o 和 -u) 的日誌。

dbcli 描述 -logCleanJob

使用 dbcli describe-logCleanJob 命令來顯示日誌清除工作的摘要。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--jobid	要顯示摘要的日誌清除工作 ID。
-j	--json	(選擇性) 顯示 JSON 輸出。

dbcli list-logCleanJobs

使用 dbcli list-logCleanJobs 命令列出日誌清除工作。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

Netsecurity 命令

下列命令可用來管理資料庫系統上的網路加密：

• dbcli describe-netsecurity
• dbcli update-netsecurity

dbcli 描述網路安全

使用 dbcli describe-netsecurity 命令可顯示資料庫本位目錄目前的網路加密設定。

語法：

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

參數：

參數	完整名稱	說明
-H	--dbHomeId	定義資料庫本位目錄 ID。使用 dbcli list-dbhomes 命令取得 dbhomeid。
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會顯示指定之資料庫本位目錄的加密設定：

dbcli describe-netsecurity -H 16c96a9c-f579-4a4c-a645-8d4d22d6889d

輸出：

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 更新網路安全

使用 dbcli update-netsecurity 命令更新資料庫系統上的 Oracle Net 安全組態。

語法：

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]

參數：

參數	完整名稱	說明
-c	--client	指示指定的資料加密或資料完整性組態是用於從屬端。(--client 和 --server 互斥。)
-e	- encryptionAlgorithms	定義要用於加密的演算法。請指定 AES256、AES192 或 AES128。
-H	--dbHomeId	定義資料庫本位目錄 ID。使用 dbcli list-dbhomes 命令取得 dbHomeId。
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--integrityAlgorithms	定義要用於完整性的演算法。指定 SHA1、SHA512、SHA384 或 SHA256。對於 Oracle Database 11g，唯一接受的值是 SHA1。
-j	--json	(選擇性) 顯示 JSON 輸出。
-s	--server	指示指定的資料加密或資料完整性組態是用於伺服器。(--client 和 --server 互斥。)
-t	--connectionType	指定如何與用戶端交涉 Oracle Net Services 資料加密或資料完整性。下列是依增加安全性的順序列出： REJECTED - 即使從屬端有需要，也請勿啟用資料加密或資料完整性。 已接受 - 視需要或由用戶端要求來啟用資料加密或資料完整性。 REQUESTED - 如果用戶端允許資料加密或資料完整性，則啟用此功能。 REQUIRED - 啟用資料加密或資料完整性，或排除連線。

範例：

下列命令會將連線類型更新為 ACCEPTED：

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

Objectstoreswift 命令

您可以使用 dbcli create-backup 命令，將資料庫備份至 Oracle Cloud Infrastructure Object Storage 服務中現有的儲存桶，但首先您必須：

1. 使用 dbcli create-objectstoreswift 命令，在資料庫系統上建立物件存放區，其中包含可存取物件儲存的端點和證明資料。
2. 使用 dbcli create-backupconfig 命令建立參考物件存放區 ID 和儲存桶名稱的備份組態。
3. 使用 dbcli update-database 命令建立備份組態與資料庫的關聯。

您可以使用下列命令來管理物件存放區。

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

dbcli 建立物件存放區提升

使用 dbcli create-objectstoreswift 命令來建立物件存放區。

語法：

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]

其中 <object_storage_namespace> 是您租用戶的物件儲存命名空間。

參數：

參數	完整名稱	說明
-e	--endpointurl	下列端點 URL。 https://swiftobjectstorage.<region_name>.oraclecloud.com/v1
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。
-n	--name	要建立之物件存放區的名稱。
-p	--swiftpassword	您使用主控台或 IAM API 產生的認證權杖。如需有關產生用於 Swift 之認證權杖的資訊，請參閱管理使用者證明資料。 這不是 Oracle Cloud Infrastructure 使用者的密碼。 指定要提示的 -p (不含密碼)。 在引號中指定 -hp "<password>，以在命令中提供密碼 (驗證記號)。
-t	--tenantname	您租用戶的物件儲存命名空間。
-u	--username	Oracle Cloud Infrastructure 使用者帳戶的使用者名稱，例如：-u [e-mail] 這是您用來登入主控台的使用者名稱。 使用者名稱必須要有物件儲存的租用戶層次存取權。若要這樣做，簡單的方法是將使用者名稱新增至「管理員」群組。不過，這允許存取所有雲端服務。管理員可以改為建立只允許物件儲存之租用戶層級存取的原則。以下為此類原則的範例。 Allow group DBAdmins to manage buckets in tenancy Allow group DBAdmins to manage objects in tenancy 如需有關將使用者新增至群組的詳細資訊，請參閱管理群組。如需有關原則的詳細資訊，請參閱原則入門。

範例：

下列命令會建立物件存放區並提示輸入 Swift 密碼：

dbcli create-objectstoreswift -n r2swift -t MyObjectStorageNamespace -u [e-mail] -e https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 -p

輸出：

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 描述物件存放區提升

使用 dbcli describe-objectstoreswift 命令來顯示物件存放區的相關詳細資訊。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--objectstoreswiftid	物件存放區 ID。使用 dbcli list-objectstoreswifts 命令取得 ID。
-in	--objectstoreswiftName	物件存放區名稱。使用 dbcli list-objectstoreswifts 命令取得名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會顯示物件存放區的相關詳細資訊：

dbcli describe-objectstoreswift -i 910e9e2d-25b4-49b4-b88e-ff0332f7df87

輸出：

Object Store details
----------------------------------------------------------------
                     ID: 910e9e2d-25b4-49b4-b88e-ff0332f7df87
                   Name: objstrswift15
               UserName: [e-mail]
             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

使用 dbcli list-objectstoreswifts 命令列出資料庫系統上的物件存放區。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會列出資料庫系統上的物件存放區：

dbcli list-objectstoreswifts

輸出：

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

Pendingjob 命令

dbcli list-pendingjobs

使用 dbcli list-pendingjobs 命令來顯示擱置中工作的清單。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

Rmanbackupreport 命令

您可以使用下列命令來管理 RMAN 備份報表：

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

dbcli 建立 -rmanbackupreport

使用 dbcli create-rmanbackupreport 命令來建立 RMAN 備份報表。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbid	(選用) 資料庫資源 ID。
-in	--dbname	(選用) 資料庫資源姓名。
-j	--json	(選擇性) 顯示 JSON 輸出。
-rn	--rptname	RMAN 備份報表名稱。字元數上限：30。使用特殊字元時，在單引號中換行名稱。
-w	--reporttype	RMAN 備份報表類型。可能的值：摘要或詳細資訊。

dbcli delete-rmanbackupreport

使用 dbcli delete-rmanbackupreport 命令來刪除 RMAN 備份報表。

語法：

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

參數：

參數	完整名稱	說明
-d	--dbid	(選用) 資料庫資源 ID。
-dn	--dbname	(選用) 資料庫資源姓名。
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--reportid	(選用) RMAN 備份報告 ID
-in	--rptname	(選擇性) RMAN 備份報表名稱
-j	--json	(選擇性) 顯示 JSON 輸出。
-n	--numofday	(選擇性) 自建立後的天數 (以資料庫 ID/ 資料庫名稱提供)

dbcli 描述 -rmanbackupreport

使用 dbcli describe-rmanbackupreport 指令來

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--id	(選用) RMAN 備份報告 ID
-in	--name	(選擇性) RMAN 備份報表名稱
-j	--json	(選擇性) 顯示 JSON 輸出。

dbcli list-rmanbackupreports

使用 dbcli list-rmanbackupreports 指令來

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbid	(選用) 資料庫資源 ID。
-in	--dbName	(選用) 資料庫資源姓名。
-j	--json	(選擇性) 顯示 JSON 輸出。

排程命令

下列指令可用來管理明細表：

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

dbcli 描述 - 排程

使用 dbcli describe-schedule 命令描述排程。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--scheduleid	排程 ID。
-j	--json	(選擇性) 顯示 JSON 輸出。

dbcli 清單排程

使用 dbcli list-schedules 指令列出排程。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

dbcli 更新排程

使用 dbcli update-schedule 命令來更新排程。

語法：

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

參數：

參數	完整名稱	說明
-d	--disable	(選擇性) 停用排程。
-e	--enable	(選用) 啟用排程。
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--scheduleid	排程 ID。
-j	--json	(選擇性) 顯示 JSON 輸出。
-t	--description	(選用) 說明
-x	--cronExpression	(選擇性) Cron 表示式。使用 cronmaker.com 產生有效的 cron 表示式。

Scheduledexecution 命令

dbcli 清單 - 排程執行

使用 dbcli list-scheduledExecutions 命令列出排定的執行項目。

語法：

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

參數：

參數	完整名稱	說明
-e	--executionid	(選用) 執行 ID。
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--scheduleid	(選用) 排程 ID。
-j	--json	(選擇性) 顯示 JSON 輸出。

伺服器指令

dbcli 更新伺服器

注意： 您的資料庫系統可能未包括此較新的命令。如果無法執行命令，請使用 CLI Update 命令來更新資料庫 CLI，然後重試命令。

使用 dbcli update-server 命令，將修正程式套用至資料庫系統中的伺服器元件。如需有關套用修補程式的詳細資訊，請參閱更新資料庫系統。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。
-l	--local	(選用) 在多節點高可用性 (HA) 系統的本機節點上執行作業。在單一節點系統上執行作業不需要此參數。
-n	--node	(選用) 要更新的節點編號。使用 dbcli list-nodes 命令取得節點編號。
-p	--precheck	(選擇性) 執行前置檢查作業來檢查先決條件。
-v	--version	(選用) 要更新的版本。

範例：

下列命令會更新伺服器，並顯示更新工作的輸出：

dbcli update-server

輸出：

{
  "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

輸出：

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

下列命令只會更新伺服器的節點 0，並進行前置檢查：

dbcli update-server -n 0 -p

輸出：

{
  "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"
}

系統指令

dbcli 描述系統

使用 dbcli describe-system 指令來顯示有關系統的詳細資訊。在雙節點 RAC 資料庫系統上，此命令會提供本機節點的相關資訊。

語法：

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

參數：

參數	完整名稱	說明
-b	--bom	(選用) 顯示 BOM 資訊。
-d	--details	(選擇性) 顯示資料庫系統的其他資訊，包括 dcs CLI 和代理程式版本資訊。
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

TDE 命令

下列命令可用於管理 TDE 相關項目 (備份報表、金鑰以及公事包)：

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

dbcli list-tdebackupreports

使用 dbcli list-tdebackupreports 命令列出 TDE 公事包的備份報表。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-i	--dbResid	(選擇性) 顯示指定之資料庫資源 ID 的 TDE 公事包備份報表。使用 dbcli list-databases 命令取得資料庫資源 ID。
-in	--dbResname	(選擇性) 顯示指定之資料庫資源名稱的 TDE 公事包備份報表。使用 dbcli list-databases 命令取得資料庫資源名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令會列出 TDE 公事包的備份報表：

dbcli list-tdebackupreports

輸出：

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

使用 dbcli update-tdekey 命令更新 TDE 公事包內的 TDE 加密金鑰。您可以更新可插拔資料庫 (如果指定 -pdbNames) 和 (或) 容器資料庫 (如果指定 -rootDatabase) 的加密金鑰。

語法：

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

參數：

參數	完整名稱	說明
-all	--allPdbNames	(選擇性) 用以旋轉 (更新) 所有 PDB 名稱的旗標。若要更新所有 PDB 名稱，請使用此參數而非 -n。預設值：false。
-i	--databaseId	定義要更新關鍵碼的資料庫 ID。
-p	--password	定義 TDE 管理公事包密碼。指定不含密碼的 -p。系統會提示您輸入密碼。 如果您必須在命令中提供密碼 (例如在命令檔中)，請使用 -hp <password> 而非 -p。
-n	--pdbNames	定義要輪換 (更新) 的 PDB 名稱。
-r -no-r	--rootDatabase --no-rootDatabase	指示如果根資料庫是容器資料庫，是否要輪換其索引鍵。
-t	-tagName	定義用於備份公事包的 TagName。預設為 OdaRotateKey。
-h	--help	(選擇性) 顯示使用指令的說明。
-j	--json	(選擇性) 顯示 JSON 輸出。

範例：

下列命令只會更新 pdb1 和 pdb2 的金鑰：

dbcli update-tdekey -dbid ee3eaab6-a45b-4e61-a218-c4ba665503d9 -p -n pdb1,pdb2

輸出：

TDE Admin wallet password:
{
  "jobId" : "08e5edb1-42e1-4d16-a47f-783c0afa4778",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467876407035,
  "description" : "TDE update",
  "updatedTime" : 1467876407035
}

下列命令會更新 pdb1、pdb2 以及容器資料庫：

dbcli update-tdekey -dbid ee3eaab6-a45b-4e61-a218-c4ba665503d9 -p -n pdb1,pdb2 -r

輸出：

TDE Admin wallet password:
{
  "jobId" : "c72385f0-cd81-42df-a8e8-3a1e7cab1278",
  "status" : "Created",
  "message" : null,
  "reports" : [ ],
  "createTimestamp" : 1467876433783,
  "description" : "TDE update",
  "updatedTime" : 1467876433783
}

dbcli Recovery-tdewallet

使用 dbcli recover-tdewallet 命令復原 TDE 公事包。

語法：

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

參數：

參數	完整名稱	說明
-h	--help	(選擇性) 顯示使用指令的說明。
-in	--dbName	資料庫名稱。
-j	--json	(選擇性) 顯示 JSON 輸出。
-l	--tdeWalletBackuplocation	(選擇性) TDE 公事夾備份位置。TDE 公事包應以 tar.gz 格式備份。
-tp	--tdeWalletPassword	定義 TDE 管理公事包密碼。