Oracle Database CLI 參照

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

作業備註

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

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

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

  • Oracle Database 會維護 /opt/oracle/dcs/log/ 目錄中 dcscli.log 和 dcs-agent.log 檔案中 dbcli 命令輸出的日誌。

  • 資料庫 CLI 命令與大多數參數均區分大小寫，且應依圖所示加以輸入。參數有幾個不區分大小寫 (如參數描述中所示)，而且可以輸入大寫或小寫。

語法

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

dbcli command [parameters]

其中：

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

本主題的其餘部分包含有關指令的語法和其他詳細資訊。

CLI 更新指令

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

cliadm 更新 -dbcli

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

附註：

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

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

dbcli 清單 - autoLogCleanPolicy

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-c --components (選用) 元件。可能的值包括 gi、資料庫以及 dcs。請使用逗號區隔值。範例：gi,dcs
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

Parameter - 參數 完整名稱 描述
-bt --backupType

(選擇性) 備份類型。可能的值為 Regular-L0、Regular-L1、Longterm 以及 ArchiveLog。Regular-L0 和 Regular L1 對應增量 L0 和 L1 備份。長期對應於完整備份。ArchiveLog 對應存檔重做日誌備份。預設值為 Regular-L1。值無效。若省略，將使用預設值。

-c --component

(選用) 元件。可能的值為資料庫和 TdeWallet。預設值是「資料庫」。值 TdeWallet 可備份 TDE 公事包。值無效。若省略，將使用預設值。

請注意，TDE 公事包會在下列情況下自動備份：
  • 資料庫是使用物件儲存備份組態所建立。
  • 已更新具有物件儲存備份組態的資料庫。
  • 物件儲存備份組態已更新。
  • 會建立 Longterm 類型的備份。
  • 會輪換資料庫的 TDE 金鑰。
  • 資料庫已備份，而且還沒有 TDE 公事包備份。
-h -- 說明 (可選擇) 顯示使用指令的說明。
-i --dbid 要備份的資料庫 ID。使用 dbcli list-databases 命令取得資料庫的 ID。
-in --dbName 要備份的資料庫名稱。使用 dbcli list-databases 命令取得資料庫的名稱。
-j --json (選擇性) 顯示 JSON 輸出。
-k --keepDays

(選擇性) 指定必須保留備份或複製的時間。備份在此時間過後，不論備份保留原則設定值為何。僅限「長期」備份類型。

-t --tag

(長期備份類型為必要) 指定備份集的使用者指定標記名稱，並將此標記套用至命令產生的輸出檔案。此值無效。有效字元數：1 到 30。這些字元僅限於目標檔案系統上檔案名稱中有效的字元。例如，ASM 不支援在內部使用的檔案名稱中使用連字號 (-) 字元，因此每週增量不是 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]

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

Parameter - 參數 完整名稱 描述
-f -- 頻率 頻率 (分鐘).
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

Parameter - 參數 完整名稱 描述
-c --container

Oracle Cloud Infrastructure Object Storage 服務中現有儲存桶的名稱。您可以使用主控台或物件儲存 API 建立儲存桶。如需詳細資訊，請參閱管理儲存桶。

您也必須指定 --backupdestination objectstore 和 --objectstoreswiftId 參數。

-cr

- 無 -cr

-- 交叉檢查

-- 無交叉檢查

(選擇性) 指示是否啟用交叉檢查作業。此作業會決定磁碟或媒體管理目錄中的檔案是否對應至 RMAN 儲存區域中的資料。如果省略，則會使用預設設定 (預設會啟用交叉檢查)。

-d -- 備份目的地

備份目的地為下列其中一項 (這些值不區分大小寫)：

磁碟 - 本機「快速復原區域」。

OBJECTSTORE - Oracle Cloud Infrastructure Object Storage 服務。您也必須指定 --container 和 --objectstoreswiftId 參數。

NONE - 停用備份。
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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 -- 復原視窗

維護備份和存檔重做日誌的天數。間隔一律以目前時間結束，然後在指定的天數內往回延伸。

若為 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-backupconfigs

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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 描述備份組態

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-i -- 備份組態 備份組態 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]

參數

Parameter - 參數 完整名稱 描述
-c --container

Oracle Cloud Infrastructure Object Storage 服務中現有儲存桶的名稱。您可以使用主控台或物件儲存 API 建立儲存桶。如需詳細資訊，請參閱管理儲存桶。

您也必須指定 --backupdestination objectstore 和 --objectstoreswiftId 參數。

-cr

- 無 -cr

-- 交叉檢查

-- 無交叉檢查

(選擇性) 指示是否啟用交叉檢查作業。此作業會判斷媒體管理目錄中磁碟的檔案是否對應 RMAN 儲存區域中的資料。如果省略，則會使用預設設定 (預設會啟用交叉檢查)。

-h -- 說明 (可選擇) 顯示使用指令的說明。
-i -- 備份組態 要更新之備份組態的 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 -- 物件存放區工作班次名稱

包含 Oracle Cloud Infrastructure Object Storage 服務端點和證明資料的物件存放區名稱。使用 dbcli list-objectstoreswifts 命令取得物件存放區 ID。使用 dbcli create-objectstoreswift 命令建立物件存放區。

您也必須指定 --backupdestination objectstore 和 --container 參數。

-w -- 復原視窗

新的磁碟復原視窗。

若為 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]

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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，然後重試命令。

附註：

2 節點 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]

參數

Parameter - 參數 完整名稱 描述
-d --dbhomes (可選擇) 僅列出資料庫本位目錄元件的已安裝和可用的修正程式版本。
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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 register-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]

參數

Parameter - 參數 完整名稱 描述
-f --sourcedbname 來源資料庫名稱。
-h -- 說明 (可選擇) 顯示使用指令的說明。
-j --json (選擇性) 顯示 JSON 輸出。
-m -- 系統密碼 (選擇性) SYS 的密碼。
-n -- 資料庫名稱 資料庫名稱。
-p -- 密碼 (選擇性) 來源 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]

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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 list-databases

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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 modify-database

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

語法

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

參數

Parameter - 參數 完整名稱 描述
- 小時 --destdbhomeid 目的地資料庫本位目錄 ID。
-h -- 說明 (可選擇) 顯示使用指令的說明。
-i -- 資料庫 ID 資料庫 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]

參數

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

dbcli 註冊資料庫

使用 dbcli register-database 命令註冊已移轉至 Oracle Cloud Infrastructure 的資料庫。此命令會將資料庫註冊到 dcs-agent，以便由 dcs-agent 堆疊管理。

附註：

2 節點 RAC 資料庫系統上無法使用 dbcli register-database 命令。

語法

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 - 參數 完整名稱 描述
-bi -- 備份組態 定義備份組態 ID。使用 dbcli list-backupconfigs 命令取得 ID。
-c -- 資料庫類別 定義資料庫類別。選項包括 OLTP、DSS 或 IMDB。預設值為 OLTP。對於 Enterprise Editions，支援全部三個類別。對於 Standard Edition，僅支援 OLTP。

-co

-no-co

--db 主控台

-- 無資料庫主控台

(選擇性) 指示是否啟用「資料庫主控台」。如果省略，則不會啟用主控台。

-h -- 說明 (可選擇) 顯示使用指令的說明。
-j --json (選擇性) 顯示 JSON 輸出。
-o -- 主機名稱 (選擇性) 定義資料庫主機名稱。預設值為 Local host name。
-p -- 系統密碼

定義 SYS 的強式密碼。請指定沒有密碼的 -p。系統將會提示您輸入密碼。

如果您必須在指令中提供密碼 (例如在指令碼中)，請使用 -hp <password> 而不是 -p。

-s -- dbshape 定義用於資料庫的資料庫大小範本。例如，odb1、odb2 和 odb3。
-sn --servicename 定義用來建立 EZCONNECT 字串以連線至資料庫的資料庫服務名稱。連線字串格式為 hostname:port/servicename。
-t --dbtype (選用) 將「資料庫類型」定義為單一節點 (SI)。預設值為 SI。
-tp --tdeWalletPassword

(選擇性) TDE 公事包的密碼。若已移轉的資料庫啟用 TDE，則為必要。

範例

下列命令會使用指定的資料庫類別、服務名稱和資料庫大小樣板來註冊資料庫。

dbcli register-database -c OLTP -s odb1 -sn crmdb.example.com -p
輸出：
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 更新資料庫

使用 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]

參數

Parameter - 參數 完整名稱 描述
-bi -- 備份組態 定義備份組態 ID。使用 dbcli list-backupconfigs 命令取得 ID。
-bin --backupconfigname 定義備份組態名稱以供日後使用。使用 dbcli list-backupconfigs 命令取得名稱。
-id -- 資料庫 ID

(選擇性)。指定 DBID，這是建立資料庫時計算的唯一 32 位元識別號碼。RMAN 會在連線到目標資料庫時顯示 DBID。您可以查詢 V$DATABASE 視觀表或 RC_DATABASE 和 RC_DATABASE_INCARNATION 復原目錄視觀表來取得 DBID。
-in --dbName

定義要更新的資料庫名稱。使用 dbcli list-databases 命令取得資料庫名稱。

-h -- 說明 (可選擇) 顯示使用指令的說明。
-i --dbid 定義要更新的資料庫 ID。使用 dbcli list-databases 命令取得資料庫 ID。
-j --json (選擇性) 顯示 JSON 輸出。
- 無 -ab 新浪微博

(選擇性) 停用指定資料庫的自動備份。

請注意，一旦停用，便無法使用 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 create-dbhome

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

語法

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

參數

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

範例

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

dbcli create-dbhome -v 12.1.0.2

dbcli description-dbhome

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

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

dbcli list-dbhomes

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

語法

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

Parameter - 參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

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

(選用) 要更新的節點號碼。使用 dbcli list-nodes 命令取得節點編號。

 -l -- 本機

(可選擇) 在多節點高可用性 (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 list-dbstorages

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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 description-dbstorage

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

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

工作命令

您可以使用下列命令來管理工作：

  • dbcli describe-job
  • dbcli list-jobs

dbcli description-job

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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-jobs

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

建立日期和時戳。

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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 description-latestpatch

附註：

  • 您的資料庫系統可能未包括此較新的命令。如果您無法執行命令，請使用 CLI Update 命令來更新資料庫 CLI，然後重試命令。
  • 2 節點 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]

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

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

dbcli 描述 -logCleanJob

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

語法

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

參數

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

dbcli 清單 - logCleanJobs

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

語法

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

參數

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

Netsecurity 命令

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

  • dbcli describe-netsecurity
  • dbcli update-netsecurity

dbcli 描述網路安全

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-H --dbHomeId 定義資料庫本位目錄 ID。使用 dbcli list-dbhomes 命令取得 dbhomeid。
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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 update-netsecurity

使用 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]

參數

Parameter - 參數 完整名稱 描述
-c -- 從屬端

指示為從屬端指定的資料加密或資料完整性組態。(--client 和 --server 互斥。)

-e -- encryptionAlgorithms 定義用於加密的演算法。指定 AES256、AES192 或 AES128。
-H --dbHomeId 定義資料庫本位目錄 ID。使用 dbcli list-dbhomes 命令取得 dbHomeId。
-h -- 說明 (可選擇) 顯示使用指令的說明。
-i --integrityAlgorithms 定義用於完整性的演算法。指定 SHA1、SHA512、SHA384 或 SHA256。對於 Oracle Database 11g，唯一接受的值是 SHA1。
-j --json (選擇性) 顯示 JSON 輸出。
-s --server 指示伺服器的指定資料加密或資料完整性組態。(--client 和 --server 互斥。)
-t --connectionType

指定如何與用戶端協商 Oracle Net Services 資料加密或資料完整性。下列值會依照安全性遞增的順序列出：

拒絕 - 即使用戶端需要，也請勿啟用資料加密或資料完整性。

接受 - 如有必要或用戶端要求，請啟用資料加密或資料完整性。

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

使用 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> 是您租用戶的物件儲存命名空間。

參數

Parameter - 參數 完整名稱 描述
-e --endpointurl

下列端點 URL。https://swiftobjectstorage.<region_name>.oraclecloud.com/v1
-h -- 說明 (可選擇) 顯示使用指令的說明。
-j --json (選擇性) 顯示 JSON 輸出。
-n --name

要建立的物件存放區名稱。

-p -- 切換密碼

您使用主控台或 IAM API 產生的認證權杖。如需有關產生用於 Swift 之認證記號的資訊，請參閱管理使用者證明資料。

這不是 Oracle Cloud Infrastructure 使用者的密碼。

指定要提示的 -p (沒有密碼)。

請以引號指定 -hp "<password>，以在指令中提供密碼 (認證記號)。

-t -- 用戶名稱 您租用戶的物件儲存命名空間。
-u --username Oracle Cloud Infrastructure 使用者帳戶的使用者名稱，例如：-u djones@example.com

這是您用來登入主控台的使用者名稱。

使用者名稱必須具備物件儲存的租用戶層級存取權。要這樣做的最快的方法是，將使用者名稱新增至「管理員」群組。不過，這允許存取所有的雲端服務。管理員可以改為建立只允許租用戶層級存取物件儲存的原則。以下是此種原則的範例。 

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 djones@example.com -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 description-objectstoreswift

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-i -- 物件店家工作班次識別碼 物件儲存 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: 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

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

語法

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

參數

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

範例

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

dbcli list-objectstoreswifts
輸出：
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 命令

dbcli list-pendingjobs

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

語法

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

參數

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

Rmanbackupreport 命令

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

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

dbcli create-rmanbackupreport

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-i --dbid (選擇性) 資料庫資源 ID。
-in -- 資料庫名稱 (選擇性) 資料庫資源名稱。
-j --json (選擇性) 顯示 JSON 輸出。
-rn -- 報表名稱 RMAN 備份報表名稱。字元數上限：30。使用特殊字元時，以單引號換行名稱。
-w -- 報表類型 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]

參數

Parameter - 參數 完整名稱 描述
-d --dbid (選擇性) 資料庫資源 ID。
-dn -- 資料庫名稱 (選擇性) 資料庫資源名稱。
-h -- 說明 (可選擇) 顯示使用指令的說明。
-i -- 報表 ID (選用) RMAN 備份報告 ID
-in -- 報表名稱 (選擇性) RMAN 備份報表名稱
-j --json (選擇性) 顯示 JSON 輸出。
-n --numofday (選擇性) 建立後的天數 (由「資料庫 ID/ 資料庫名稱」提供)

dbcli description-rmanbackupreport

使用 dbcli describe-rmanbackupreport 命令

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

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

dbcli 清單排程

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

語法

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

參數

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

dbcli update-schedule

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

語法

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

參數

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

排定執行命令

dbcli 清單 - scheduledExecutions

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

語法

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

參數

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

伺服器命令

dbcli 更新伺服器

附註：

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

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

語法

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

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-j --json (選擇性) 顯示 JSON 輸出。
-l -- 本機

(可選擇) 在多節點高可用性 (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]

參數

Parameter - 參數 完整名稱 描述
-b -- 用料表 (選用) 顯示 BOM 資訊。

-d

--details

 (選擇性) 顯示資料庫系統的其他資訊，包括 dcs CLI 和代理程式版本資訊。
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

Parameter - 參數 完整名稱 描述
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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]

參數

Parameter - 參數 完整名稱 描述
-all --allPdbNames

(選擇性) 用以輪換 (更新) 所有 PDB 名稱的旗標。若要更新所有 (而非指定的 PDB 名稱)，請改用此參數來取代 -n。預設值：false。

-i --databaseId

定義要更新索引鍵的資料庫 ID。
-p --password

定義 TDE 管理公事包密碼。請指定沒有密碼的 -p。系統將會提示您輸入密碼。

如果您必須在指令中提供密碼 (例如在指令碼中)，請使用 -hp <password> 而不是 -p。

-n --pdbNames 定義要輪換 (更新) 的 PDB 名稱。

-r

-no-r

--rootDatabase

-- 無 rootDatabase

 指示根資料庫 (若為容器資料庫) 是否輪換金鑰。
-t -tagName 定義用來備份公事包的 TagName。預設值為 OdaRotateKey。
-h -- 說明 (可選擇) 顯示使用指令的說明。
-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 復原錢包

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

語法

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

參數

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

定義 TDE 管理公事包密碼。