Oracle Database CLI 参考

数据库 CLI (dbcli) 是可用于基本数据库服务的命令行界面。在基本数据库服务中连接到数据库系统后，可以使用 dbcli 执行创建 Oracle 数据库主目录和数据库等任务。

操作注释

• 数据库 CLI 命令必须以 root 用户身份运行。

• dbcli 位于 /opt/oracle/dcs/bin/ 目录中。

  此目录包含在 root 用户环境的路径中。

• 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> 。指定这些值时，请省略尖括号。
• 每个命令都提供帮助参数。

本主题的其余部分包含有关命令的语法和其他详细信息。

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 输出。

自动清除策略命令

以下命令可用于管理日志自动清洗（清除）的策略。

• 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、database 和 dcs。用逗号分隔多个值。示例：gi,dcs
-f	--freeSpaceBelowPercentage	（可选）当空闲磁盘空间低于总分区大小的指定百分比时清除日志。有效范围：20-50。默认值：20。
-h	--help	（可选）显示有关使用命令的帮助。
-j	--json	（可选）显示 JSON 输出。
-o	--olderthan	（可选）时间间隔的数量部分。默认值：30。清除早于指定时间间隔（-o 和 -u）的日志。
-u	--olderThanUnit	（可选）时间间隔的单位部分。可能值：Day、Hour 或 Minute。默认值：日。清除早于指定时间间隔（-o 和 -u）的日志。
-uMB	--usageOverMB	（可选）当日志使用量超过指定的兆字节数 (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、database 和 dcs。用逗号分隔多个值。示例：gi,dcs
-h	--help	（可选）显示有关使用命令的帮助。
-j	--json	（可选）显示 JSON 输出。

备份命令

以下命令可用于备份数据库：

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

注：您可以使用控制台或 API 来管理将数据库系统备份到对象存储的过程，而不是使用 dbcli。但是，如果您从使用 dbcli 切换到使用托管备份，则会创建新的备份配置并将其与数据库关联，并且您使用 dbcli 创建的备份将无法从托管备份接口访问。有关托管备份的信息，请参见 Back Up and Recovery in Base Database Service 。

在使用 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 对应于归档重做日志备份。默认值为 Regular-L1。值不区分大小写。如果省略，则使用默认值。
-c	--component	（可选）组件。可能的值为 Database 和 TdeWallet。默认值为“数据库”。值 TdeWallet 将备份 TDE 钱包。值不区分大小写。如果省略，则使用默认值。 请注意，在以下情况下会自动备份 TDE 钱包： 数据库是使用对象存储备份配置创建的。 将更新具有对象存储备份配置的数据库。 对象存储备份配置已更新。 创建 "Longterm" 类型的备份。 将轮换数据库的 TDE 密钥。 数据库已备份，但尚不存在 TDE wallet 备份。
-h	--help	（可选）显示有关使用命令的帮助。
-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]

参数：

参数	全名	说明
-h	--help	（可选）显示有关使用命令的帮助。
-i	--dbId	（可选）数据库资源标识。
-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	（可选）数据库资源标识。
-in	--dbName	（可选）数据库资源名称。
-j	--json	（可选）显示 JSON 输出。
-t	--backupType	备份类型。

Backupconfig 命令

备份配置确定数据库备份的备份目标和恢复窗口。您可以创建备份配置，然后使用 dbcli update-database 命令将其与数据库关联。

注：如果使用这些命令进行更改，则使用控制台配置的备份可能会变得不可用。对于使用控制台配置的备份，请仅使用具有支持指导的这些命令。

注：您可以使用控制台或 API 来管理将数据库系统中的数据库备份到对象存储，而不是使用 dbcli。有关托管备份的信息，请参见 Back Up and Recovery in Base Database Service 。

数据库与备份配置关联后，可以使用 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- 本地快速恢复区。 OBJECTSTORE — 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-backupconfigs

使用 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 describe-component

您的数据库系统可能不包括此较新的命令。如果运行该命令时遇到问题，请使用 CLI Update Command 命令更新数据库 CLI，然后重试该命令。

注：dbcli describe-component 命令在双节点 RAC 数据库系统上不可用。不支持从对象存储为双节点系统打补丁。

使用 dbcli describe-component 命令可显示数据库系统中服务器、存储和/或数据库主目录组件的已安装和可用补丁程序版本。

此命令需要有效的对象存储身份证明配置。如果配置缺失或无效，该命令将失败并显示错误：Failed to connect to the object store. Please provide valid details.

有关更新 CLI、创建身份证明配置和应用补丁程序的更多信息，请参见 Update a DB System 。

语法：

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 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 wallet 的密码。
-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 Wallet 备份位置。TDE wallet 应以 tar.gz 格式备份。
-r	--recoveryTimeStamp	（恢复类型为 PITR 时是必需的）恢复时间戳，格式为 mm/dd/yyyy hh:mi:ss。默认值：[ ]
-s	--scn	（恢复类型为 SCN 时为必需）SCN。
-t	--recoverytype	（提供备份报告时必需）恢复类型。可能的值包括 Latest、PITR 和 SCN。
-tp	--tdeWalletPassword	（可选）TDE wallet 密码。

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，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 create-dbhome

使用 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 describe-dbhome

使用 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 输出。

示例：

以下输出是使用 display 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 列表 - 主目录

使用 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 包补丁程序应用于数据库主目录。有关应用补丁程序的更多信息，请参见 Update a DB System 。

语法：

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	（可选）在多节点高可用性 (High Availability，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-dbstor

使用 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 describe-dborage

使用 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 describe-job

使用 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 列表作业

使用 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 describe-latestpatch

注：您的数据库系统可能不包括此较新的命令。如果运行该命令时遇到问题，请使用 CLI Update 命令更新数据库 CLI，然后重试该命令。dbcli describe-latestpatch 命令在双节点 RAC 数据库系统上不可用。不支持从对象存储为双节点系统打补丁。

使用 dbcli describe-latestpatch 命令可显示适用于数据库系统且在 Oracle Cloud Infrastructure Object Storage 中可用的最新补丁程序。

此命令需要有效的对象存储身份证明配置。如果配置缺失或无效，该命令将失败并显示错误：Failed to connect to the object store. Please provide valid details。

有关更新 CLI、创建身份证明配置和应用补丁程序的更多信息，请参见 Update a DB System 。

语法：

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、database 和 dcs。用逗号分隔多个值。
-h	--help	（可选）显示有关使用命令的帮助。
-j	--json	（可选）显示 JSON 输出。
-o	--olderThan	（可选）时间间隔的数量部分。默认值：30。清除早于指定时间间隔（-o 和 -u）的日志。
-u	--unit	（可选）时间间隔的单位部分。可能值：Day、Hour 或 Minute。默认值：日。清除早于指定时间间隔（-o 和 -u）的日志。

dbcli describe-logCleanJob

使用 dbcli describe-logCleanJob 命令可显示日志清洗作业的摘要。

语法：

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

参数：

参数	全名	说明
-h	--help	（可选）显示有关使用命令的帮助。
-i	--jobid	要显示其汇总的日志清洗作业的 ID。
-j	--json	（可选）显示 JSON 输出。

dbcli list-logClean 作业

使用 dbcli list-logCleanJobs 命令列出日志清洗作业。

语法：

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

参数：

参数	全名	说明
-h	--help	（可选）显示有关使用命令的帮助。
-j	--json	（可选）显示 JSON 输出。

Netsecurity 命令

可以使用以下命令管理数据库系统上的网络加密：

• dbcli describe-netsecurity
• dbcli update-netsecurity

dbcli describe-netsecurity

使用 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 update-net 安全

使用 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（拒绝）- 即使客户机需要，也不要启用数据加密或数据完整性。 ACCEPTED- 如果需要或客户机请求，启用数据加密或数据完整性。 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> 是租户的对象存储名称空间。

参数：

参数	全名	说明
-e	--endpointurl	以下端点 URL。 https://swiftobjectstorage.<region_name>.oraclecloud.com/v1
-h	--help	（可选）显示有关使用命令的帮助。
-j	--json	（可选）显示 JSON 输出。
-n	--name	要创建的对象存储的名称。
-p	--swiftpassword	使用控制台或 IAM API 生成的验证令牌。有关生成用于 Swift 的验证令牌的信息，请参见 Managing User Credentials 。 这不是 Oracle Cloud Infrastructure 用户的密码。 指定要提示的 -p（无口令）。 在引号中指定 -hp "<password> 以在命令中提供口令（auth 标记）。
-t	--tenantname	租户的对象存储名称空间。
-u	--username	Oracle Cloud Infrastructure 用户帐户的用户名，例如：-u [e-mail] 这是用于登录控制台的用户名。 用户名必须具有对对象存储的租户级别访问权限。这样做的一个简单方法是将用户名添加到 Administrators 组中。但是，这允许访问所有云服务。管理员可以创建仅允许租户级访问对象存储的策略。以下是此类策略的示例。 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 describe-objectstoreswift

使用 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 列表待定作业

使用 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 create-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 describe-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 list-scheduledExecutions

使用 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 update-server

注：您的数据库系统可能不包括此较新的命令。如果运行该命令时遇到问题，请使用 CLI Update 命令更新数据库 CLI，然后重试该命令。

使用 dbcli update-server 命令向数据库系统中的服务器组件应用修补程序。有关应用补丁程序的更多信息，请参见 Update a DB System 。

语法：

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

参数：

参数	全名	说明
-h	--help	（可选）显示有关使用命令的帮助。
-j	--json	（可选）显示 JSON 输出。
-l	--local	（可选）在多节点高可用性 (High Availability，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 Wallet 备份报告。使用 dbcli list-databases 命令获取数据库资源 ID。
-in	--dbResname	（可选）显示指定数据库资源名称的 TDE Wallet 备份报告。使用 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 wallet 中的 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 管理 wallet 密码。指定不带口令的 -p。系统将提示您输入口令。 如果必须在命令中（例如在脚本中）提供口令，请使用 -hp <password> 而非 -p。
-n	--pdbNames	定义要轮换（更新的）的 PDB 名称。
-r -no-r	--rootDatabase --no-rootDatabase	指示是否轮换根数据库的密钥（如果是容器数据库）。
-t	-tagName	定义用于备份 wallet 的 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 恢复 -tewallet

使用 dbcli recover-tdewallet 命令恢复 TDE wallet。

语法：

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

参数：

参数	全名	说明
-h	--help	（可选）显示有关使用命令的帮助。
-in	--dbName	数据库名称。
-j	--json	（可选）显示 JSON 输出。
-l	--tdeWalletBackuplocation	（可选）TDE Wallet 备份位置。TDE wallet 应 b 以 tar.gz 格式备份。
-tp	--tdeWalletPassword	定义 TDE 管理 wallet 密码。