Oracle Database CLI 参考
运营附注
-
数据库 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是动词对象组合，例如create-database。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]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --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-agent
使用 dbcli ping-agent 命令测试代理的可访问性。
语法
dbcli ping-agent [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
Autologcleanpolicy 命令
以下命令可用于管理日志的自动清洗（清除）策略。
dbcli create-autoLogCleanPolicydbcli 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 | -- 组件 | （可选）要清除的组件。可能的值包括 gi、数据库和 dcs。用逗号分隔多个值。示例：gi,dcs |
| -f | --freeSpaceBelowPercentage | （可选）当空闲磁盘空间低于总分区大小的指定百分比时清除日志。有效范围：20-50。默认值： 20。 |
| - 小时 | --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]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| -c | -- 组件 | （可选）组件。可能的值包括 gi、数据库和 dcs。用逗号分隔多个值。示例：gi,dcs |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
备份命令
可使用以下命令备份数据库：
dbcli create-backupdbcli getstatus-backupdbcli schedule-backup
注意：
您可以使用控制台或 API 来管理将数据库系统备份到对象存储的数据库，而不使用 dbcli。但是，如果从使用 dbcli 切换到使用托管备份，则会创建新的备份配置并与数据库关联，并且无法从托管备份接口访问使用 dbcli 创建的备份。有关托管备份的信息，请参见 Back Up and Recovery in Base Database Service。
在使用 dbcli create-backup 命令备份数据库之前，您需要：
- 使用
dbcli create-backupconfig命令创建备份配置。 - 使用
dbcli update-database命令将备份配置与数据库关联。
将数据库与备份配置关联后，可以在 cron 作业中使用 dbcli create-backup 命令自动运行备份。可以使用 cron 实用程序（如 CronMaker）帮助构建表达式。有关详细信息，请参阅 CronMaker 。
dbcli create-backup
使用 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 |
（可选）备份类型。可能的值包括常规 L0、常规 L1、长期和 ArchiveLog。常规 L0 和常规 L1 对应于增量 L0 和 L1 备份。长期对应于完全备份。ArchiveLog 对应于归档重做日志备份。默认值为“常规 L1”。值不敏感。如果忽略，将使用默认值。 |
| -c | --component |
（可选）组件。可能的值包括“数据库”和“TdeWallet”。默认值为“数据库”。值 TdeWallet 备份 TDE wallet。值不敏感。如果忽略，将使用默认值。 请注意，在以下情况下会自动备份 TDE wallet：
|
| - 小时 | --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 mydbdbcli getstatus-backup
使用 dbcli getstatus-backup 命令可显示备份的状态。
语法
dbcli getstatus-backup
-t <backup_type>
[i <id>]
[-in <name>]
[-l] [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --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]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| -f | --f 频率 | 频率 (以分钟为单位)。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --dbId | （可选）数据库资源 ID。 |
| -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-backupconfigdbcli list-backupconfigsdbcli describe-backupconfigdbcli update-backupconfigdbcli 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 | -- 容器 |
Oracle Cloud Infrastructure Object Storage 服务中现有存储桶的名称。您可以使用控制台或对象存储 API 创建存储桶。有关详细信息，请参阅管理存储桶。 还必须指定 |
|
-cr - 无贷记 |
-- 交叉检验 -- 无交叉检验 |
（可选）指示是否启用交叉检查操作。此操作确定磁盘或介质管理目录中的文件是否与 RMAN 系统信息库中的数据相对应。如果省略，则使用默认设置（默认情况下启用交叉检查）。 |
| -d | --backupdestination |
备份目标为以下值之一（这些值不区分大小写）： DISK - 本地快速恢复区。 OBJECTSTORE - Oracle Cloud Infrastructure Object Storage 服务。此外，还必须指定 NONE - 禁用备份。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -n | --name | 备份配置的名称。 |
| -o | --objectstoreswiftId |
包含 Oracle Cloud Infrastructure Object Storage 服务的端点和身份证明的对象存储的 ID。使用 还必须指定 |
| -on | --objectstoreswiftName |
包含 Oracle Cloud Infrastructure Object Storage 服务的端点和身份证明的对象存储的名称。 使用 还必须指定 |
| - 周 | -- 恢复窗口 |
维护备份和归档重做日志的天数。间隔始终以当前时间结束，并在指定天数内向后延长时间。 对于 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 (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令列出了备份配置：
dbcli list-backupconfigsID Name RecoveryWindow BackupDestination CreateTime
---------------------------------------- -------------------- ------------------ ----------------- -----------------------------
ccdd56fe-a40b-4e82-b38d-5f76c265282d dbbkcfg1 7 Disk July 10, 2016 12:24:08 PM UTCdbcli describe-backupconfig
使用 dbcli describe-backupconfig 命令可显示有关特定备份配置的详细信息。
语法
dbcli describe-backupconfig -i <id> -in <name> [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --backupconfigid | 备份配置 ID。使用 dbcli list-backupconfigs 命令获取 ID。
|
| -in | --backupconfigname | 备份配置名称。使用 dbcli list-backupconfigs 命令获取名称。
|
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令显示有关备份配置的详细信息：
dbcli describe-backupconfig -i ccdd56fe-a40b-4e82-b38d-5f76c265282dBackup 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 UTCdbcli 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 | -- 容器 |
Oracle Cloud Infrastructure Object Storage 服务中现有存储桶的名称。您可以使用控制台或对象存储 API 创建存储桶。有关详细信息，请参阅管理存储桶。 还必须指定 |
|
-cr - 无贷记 |
-- 交叉检验 -- 无交叉检验 |
（可选）指示是否启用交叉检查操作。此操作确定介质管理目录中磁盘上的文件是否与 RMAN 系统信息库中的数据相对应。如果省略，则使用默认设置（默认情况下启用交叉检查）。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --backupconfigid | 要更新的备份配置的 ID。使用 dbcli list-backupconfigs 命令获取 ID。
|
| -in | --backupconfigname | 要更新的备份配置的名称。使用 dbcli list-backupconfigs 命令获取名称。
|
| -J | --json | （可选）显示 JSON 输出。 |
| -o | --objectstoreswiftId |
包含 Oracle Cloud Infrastructure Object Storage 服务的端点和身份证明的对象存储的 ID。使用 还必须指定 |
| -on | --objectstoreswiftname |
包含 Oracle Cloud Infrastructure Object Storage 服务的端点和身份证明的对象存储的名称。使用 还必须指定 |
| - 周 | -- 恢复窗口 |
新的磁盘恢复窗口。 对于 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 (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --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、创建身份证明配置和应用补丁程序的更多信息，请参见更新数据库系统。
语法
dbcli describe-component
[-s <server_group>]
[-d <db_group>]
[-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| -d | --dbhomes | （可选）仅列出数据库主目录组件的已安装和可用修补程序版本。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -s | --server | （可选）仅列出服务器组件的已安装和可用修补程序版本。 |
范例
以下命令用于显示对象存储中的当前组件版本和可用修补程序版本：
dbcli describe-componentSystem 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-databasedbcli describe-databasedbcli list-databasesdbcli modify-databasedbcli recover-databasedbcli register-databasedbcli 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 | -- 来源名称 | 源数据库名称。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -m | --syspassword | （可选）SYS 的口令。 |
| -n | -- 数据库名称 | 数据库名称。 |
| -p | --tdepassword | （可选）源 TDE wallet 的密码。 |
| -s | --dbshape | （可选）数据库配置。示例：odb1、odb2。 |
| -t | --dbtype | （可选）数据库类型：SI |
| -u | --databaseUniqueName | 数据库的唯一名称。 |
dbcli describe-database
使用 dbcli describe-database 命令可显示数据库详细信息。
语法
dbcli describe-database
-i <db_id>
-in <db_name>
[-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --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-28a81a725df6DB 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 AMdbcli 列表数据库
使用 dbcli list-databases 命令列出数据库系统上的所有数据库。
语法
dbcli list-databases [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令显示数据库列表：
dbcli list-databasesID 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]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --destdbhomeid | 目标数据库主目录 ID。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -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 输入。 |
| - 小时 | --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 | -- 恢复类型 | （提供备份报告时必需）恢复类型。可能的值包括“最新”、“PITR”和“SCN”。 |
| -tp | --tdeWalletPassword | （可选）TDE wallet 密码。 |
dbcli 注册数据库
使用 dbcli register-database 命令注册已迁移到 Oracle Cloud Infrastructure 的数据库。该命令将数据库注册到 dcs-agent，以便它可以由 dcs-agent 堆栈进行管理。
注意：
dbcli register-database 命令在双节点 RAC 数据库系统上不可用。
语法
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 | --backupconfigid | 定义备份配置 ID。使用 dbcli list-backupconfigs 命令获取 ID。
|
| -c | --db 类 | 定义数据库类。选项包括 OLTP、DSS 或 IMDB。默认值为 OLTP。对于企业版，支持所有三个类。对于标准版，仅支持 OLTP。 |
|
-co - 不接受 |
--dbconsole --no-dbconsole |
（可选）指示是否启用数据库控制台。如果省略，则不启用控制台。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -o | -- 主机名 | （可选）定义数据库主机名。默认值为 Local host name。
|
| -p | --syspassword |
为 SYS 定义强口令。请指定不带口令的 如果必须在命令（例如在脚本中）中提供口令，请使用 |
| -s | --dbshape | 定义要用于数据库的数据库大小调整模板。例如，odb1、odb2 和 odb3。 |
| -sn | --servicename | 定义用于构建 EZCONNECT 字符串以连接到数据库的数据库服务名称。连接字符串格式为 hostname:port/servicename。
|
| -t | --dbtype | （可选）将数据库类型定义为单节点 (SI)。默认值为 SI。 |
| -tp | --tdeWalletPassword |
（可选）TDE wallet 的密码。如果在迁移的数据库上启用了 TDE，则为必需字段。 |
范例
以下命令使用指定的数据库类、服务名称和数据库大小调整模板注册数据库。
dbcli register-database -c OLTP -s odb1 -sn crmdb.example.com -pPassword for SYS:
{
"jobId" : "317b430f-ad5f-42ae-bb07-13f053d266e2",
"status" : "Created",
"message" : null,
"reports" : [ ],
"createTimestamp" : "August 08, 2016 05:55:49 AM EDT",
"description" : "Database service registration with db service name: crmdb.example.com",
"updatedTime" : "August 08, 2016 05:55:49 AM EDT"
}dbcli update-database
使用 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 | --backupconfigid | 定义备份配置 ID。使用 dbcli list-backupconfigs 命令获取 ID。
|
| -bin | --backupconfigname | 定义备份配置名称以供将来使用。使用 dbcli list-backupconfigs 命令获取名称。
|
| -id | -- 数据库 ID |
(可选。)指定 DBID，DBID 是创建数据库时计算的唯一 32 位标识号。RMAN 在连接到目标数据库时显示 DBID。可以通过查询 V$DATABASE 视图或 RC_DATABASE 和 RC_DATABASE_INCARNATION 恢复目录视图来获取 DBID。 |
| -in | --dbName |
定义要更新的数据库名称。使用 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --dbid | 定义要更新的数据库 ID。使用 dbcli list-databases 命令获取数据库 ID。
|
| -J | --json | （可选）显示 JSON 输出。 |
| 不行 | -- 自动备份 |
（可选）禁用指定数据库的自动备份。 请注意，一旦禁用，就无法使用 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-dbhomedbcli describe-dbhomedbcli delete-dbhomedbcli list-dbhomesdbcli update-dbhome
dbcli create-dbhome
使用 dbcli create-dbhome 命令创建 Oracle Database 主目录。
语法
dbcli create-dbhome -v <version> [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -v | --version | 定义数据库主目录版本。 |
范例
以下命令创建 Oracle Database 主目录版本 12.1.0.2：
dbcli create-dbhome -v 12.1.0.2dbcli describe-dbhome
使用 dbcli describe-dbhome 命令可显示 Oracle Database 主目录详细信息。
语法
dbcli describe-dbhome -i <db_home_id> [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --dbhomeid | 标识数据库主目录 ID。使用 dbcli list-dbhomes 命令获取 ID。
|
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下输出是使用 display Oracle Database Home details 命令的示例。
dbcli describe-dbhome -i 52850389-228d-4397-bbe6-102fda65922bDB 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 UTCdbcli delete-dbhome
使用 dbcli delete-dbhome 命令从数据库系统中删除数据库主目录。
语法
dbcli delete-dbhome -i <db_home_id> [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --dbhomeid | 标识要删除的数据库主目录 ID。使用 dbcli list-dbhomes 命令获取 ID。
|
| -J | --json | （可选）显示 JSON 输出。 |
dbcli list-dbhomes
使用 dbcli list-dbhomes 命令可显示 Oracle 主目录的列表。
语法
dbcli list-dbhomes [-h] [-j]Parameter (参数)
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令显示 Oracle 主目录的列表。
dbcli list-dbhomesID 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 (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --dbhomeid | 数据库主页的 ID。使用 dbcli list-dbhomes 命令获取 ID。
|
| -J | --json | （可选）显示 JSON 输出。 |
| -n | -- 节点 |
（可选）要更新的节点编号。使用 |
| -l | -- 本地 |
（可选）在多节点高可用性 (high availability，HA) 系统的本地节点上执行操作。在单节点系统上执行操作不需要此参数。 |
| -p | -- 预检查 |
（可选）运行预检查操作以检查先决条件。 |
范例
以下命令更新数据库主目录并显示更新作业的输出：
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-bbd123469beaJob 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-dbstoragesdbcli describe-dbstorage
dbcli list-dbstorages
使用 dbcli list-dbstorages 命令列出数据库系统中的数据库存储。
语法
dbcli list-dbstorages [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令显示有关数据库存储的详细信息：
dbcli list-dbstoragesID Type DBUnique Name Status
---------------------------------------- ------ -------------------- ----------
afb4a1ce-d54d-4993-a149-0f28c9fb33a4 Acfs db1_2e56b3a9b815 Configured
d81e8013-4551-4d10-880b-d1a796bca1bc Acfs db11xp Configureddbcli describe-dbstorage
使用 dbcli describe-dbstorage 命令可显示有关特定数据库存储资源的详细信息。
语法
dbcli describe-dbstorage -i <db_storage_id> [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --id | 定义数据库存储 ID。使用 dbcli list-dbstorages 命令获取数据库存储 ID。
|
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令显示 105a2db2-625a-45ba-8bdd-ee46da0fd83a 的数据库存储详细信息：
dbcli describe-dbstorage -i 105a2db2-625a-45ba-8bdd-ee46da0fd83aDBStorage 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 UTCDgconfig 命令
dbcli list-dgconfigs
使用 dbcli list-dgconfigs 命令列出 DG 配置。
语法
dbcli list-dgconfigs [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
作业命令
可使用以下命令管理作业：
dbcli describe-jobdbcli list-jobs
dbcli describe-job
使用 dbcli describe-job 命令可显示有关特定作业的详细信息。
语法
dbcli describe-job -i <job_id> [-h] [-j] 参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --jobid | 标识作业。使用 dbcli list-jobs 命令获取 jobid。
|
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令显示有关指定作业 ID 的详细信息：
dbcli describe-job -i 74731897-fb6b-4379-9a37-246912025c17Job 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 Successdbcli list- 作业
使用 dbcli list-jobs 命令可显示作业列表，包括作业 ID、状态和作业
创建的日期和时间戳。
语法
dbcli list-jobs [-h] [-j] 参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令显示作业列表：
dbcli list-jobsID 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 SuccessLatestpatch 命令
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、创建身份证明配置和应用补丁程序的更多信息，请参见更新数据库系统。
语法
dbcli describe-latestpatch [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令显示对象存储中可用的修补程序：
dbcli describe-latestpatchcomponentType 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-logCleanJobdbcli describe-logCleanJobdbcli 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 | -- 组件 | （可选）组件。可能的值包括 gi、数据库和 dcs。用逗号分隔多个值。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -o | --olderThan | （可选）时间间隔的数量部分。默认值： 30。清除早于指定时间间隔（-o 和 -u）的日志。
|
| -u | -- 单位 | （可选）时间间隔的单位部分。可能值：日、小时或分钟。默认值：日。清除早于指定时间间隔（-o 和 -u）的日志。
|
dbcli describe-logCleanJob
使用 dbcli describe-logCleanJob 命令可显示日志清洗作业的摘要。
语法
dbcli describe-logCleanJob
-i <job_id>
[-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --jobid | 要显示其摘要的日志清洗作业的 ID。 |
| -J | --json | （可选）显示 JSON 输出。 |
dbcli list-logCleanJobs
使用 dbcli list-logCleanJobs 命令列出日志清洗作业。
语法
dbcli list-logCleanJobs [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
Netsecurity 命令
以下命令可用于管理数据库系统上的网络加密：
dbcli describe-netsecuritydbcli update-netsecurity
dbcli describe-netsecurity
使用 dbcli describe-netsecurity 命令可显示数据库主目录的当前网络加密设置。
语法
dbcli describe-netsecurity -H <db_home_id> [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| -H | --dbHomeId | 定义数据库主目录 ID。使用 dbcli list-dbhomes 命令获取 dbhomeid。
|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令显示指定数据库主目录的加密设置：
dbcli describe-netsecurity -H 16c96a9c-f579-4a4c-a645-8d4d22d6889dNetSecurity 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: Requireddbcli 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 | -- 客户端 |
指示指定的数据加密或数据完整性配置用于客户机。（ |
| -e | -- encryptionAlgorithms | 定义要用于加密的算法。指定 AES256、AES192 或 AES128。 |
| -H | --dbHomeId | 定义数据库主目录 ID。使用 dbcli list-dbhomes 命令获取 dbHomeId。
|
| - 小时 | --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 ACCEPTEDObjectstoreswift 命令
您可以使用 dbcli create-backup 命令将数据库备份到 Oracle Cloud Infrastructure Object Storage 服务中的现有存储桶，但首先需要：
- 使用
dbcli create-objectstoreswift命令在数据库系统上创建对象存储，其中包含用于访问对象存储的端点和身份证明。 - 使用
dbcli create-backupconfig命令创建引用对象存储 ID 和存储桶名称的备份配置。 - 使用
dbcli update-database命令将备份配置与数据库关联。
可使用以下命令管理对象存储。
dbcli create-objectstoreswiftdbcli describe-objectstoreswiftdbcli 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。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -n | --name |
要创建的对象存储的名称。 |
| -p | --swift 密码 |
使用控制台或 IAM API 生成的验证令牌。有关生成用于 Swift 的验证令牌的信息，请参见 Managing User Credentials 。 这不是 Oracle Cloud Infrastructure 用户的密码。 指定要提示的 在引号中指定 |
| -t | -- 租户名称 | 租户的对象存储名称空间。 |
| -u | -- 用户名 | Oracle Cloud Infrastructure 用户账户的名称，例如：-u djones@example.com
这是用于登录到控制台的用户名。 用户名必须具有对对象存储的租户级访问权限。这样做的简单方法是将用户名添加到 "Administrators"（管理员）组。但是，这允许访问所有云服务。管理员可以创建策略来只允许租户级访问对象存储。下面是此类策略的一个示例。 Allow group DBAdmins to manage buckets in tenancy Allow group DBAdmins to manage objects in tenancy 有关将用户添加到组的更多信息，请参见 Managing Groups 。有关策略的详细信息，请参阅策略入门。 |
范例
以下命令创建对象存储并提示输入 Swift 密码：
dbcli create-objectstoreswift -n r2swift -t MyObjectStorageNamespace -u djones@example.com -e https://swiftobjectstorage.<region_name>.oraclecloud.com/v1 -pPassword 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]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --objectsoreswiftid | 对象存储 ID。使用 dbcli list-objectstoreswifts 命令获取 ID。
|
| -in | --objectstoreswiftName | 对象存储名称。使用 dbcli list-objectstoreswifts 命令获取名称。
|
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令显示有关对象存储的详细信息：
dbcli describe-objectstoreswift -i 910e9e2d-25b4-49b4-b88e-ff0332f7df87Object 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 UTCdbcli list-objectstoreswifts
使用 dbcli list-objectstoreswifts 命令列出数据库系统上的对象存储。
语法
dbcli list-objectstoreswifts [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令列出数据库系统上存储的对象：
dbcli list-objectstoreswiftsID 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 UTCPendingjob 命令
dbcli list-pendingjobs
使用 dbcli list-pendingjobs 命令可显示待处理作业的列表。
语法
dbcli list-pendingjobs [-h] [-j] 参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
Rmanbackupreport 命令
以下命令可用于管理 RMAN 备份报告：
dbcli create-rmanbackupreportdbcli delete-rmanbackupreportdbcli describe-rmanbackupreportdbcli 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 (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --dbid | （可选）数据库资源 ID。 |
| -in | -- 数据库名称 | （可选）数据库资源名称。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -rn | --rptname | RMAN 备份报告名称。最大字符数：30。使用特殊字符时，用单引号将名称换行。 |
| - 周 | -- 报表类型 | 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 | -- 数据库名称 | （可选）数据库资源名称。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | -- 报表标识 | （可选）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]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --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]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --dbid | （可选）数据库资源 ID。 |
| -in | --dbName | （可选）数据库资源名称。 |
| -J | --json | （可选）显示 JSON 输出。 |
调度命令
可使用以下命令管理调度：
dbcli describe-scheduledbcli list-schedulesdbcli update-schedule
dbcli describe-scdule
使用 dbcli describe-schedule 命令描述调度表。
语法
dbcli describe-schedule -i <id> [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --scheduleid | 计划 ID。 |
| -J | --json | （可选）显示 JSON 输出。 |
dbcli 列表调度
使用 dbcli list-schedules 命令列出调度。
语法
dbcli list-schedules [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -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 | -- 启用 | （可选）启用计划。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --scheduleid | 计划 ID。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -t | -- 描述 | （可选）描述 |
| -x | --cronExpression | （可选）Cron 表达式。使用 cronmaker.com 生成有效的 cron 表达式。 |
Scheduledexecution 命令
dbcli list-scheduledExecutions
使用 dbcli list-scheduledExecutions 命令列出调度的执行。
语法
dbcli list-scheduledExecutions
[-e <execution_id>]
[-i <schedule_id>]
[-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| -e | --executionid | （可选）执行 ID。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --scheduleid | （可选）计划 ID。 |
| -J | --json | （可选）显示 JSON 输出。 |
服务器命令
dbcli update-server
注意：
您的数据库系统可能不包括此较新的命令。如果运行该命令时遇到问题，请使用CLI Update 命令更新数据库 CLI，然后重试该命令。
使用 dbcli update-server 命令为数据库系统中的服务器组件应用补丁程序。有关应用补丁程序的详细信息，请参阅更新数据库系统。
语法
dbcli update-server
[-n <number>]
[--local]
[--precheck]
[-v]
[-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -l | -- 本地 |
（可选）在多节点高可用性 (high availability，HA) 系统的本地节点上执行操作。在单节点系统上执行操作不需要此参数。 |
| -n | -- 节点 |
（可选）要更新的节点编号。使用 |
| -p | -- 预检查 |
（可选）运行预检查操作以检查先决条件。 |
| -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-9b820ddf6ed8Job 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 describe-system
使用 dbcli describe-system 命令可显示有关系统的详细信息。在双节点 RAC 数据库系统上，该命令提供有关本地节点的信息。
语法
dbcli describe-system [-b] [-d] [-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| -b | -- 炸弹 | （可选）显示 BOM 信息。 |
|
-d |
-- 详细信息 |
（可选）显示有关数据库系统的其他信息，包括 dcs CLI 和代理版本信息。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
TDE 命令
以下命令可用于管理与 TDE 相关的项（备份报告、密钥和钱包）：
dbcli list-tdebackupreportsdbcli update-tdekeydbcli recover-tdewallet
dbcli list-tdebackupreports
使用 dbcli list-tdebackupreports 命令列出 TDE Wallet 的备份报告。
语法
dbcli list-tdebackupreports
[-i <db_id>]
[-in <db_name>]
[-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -i | --dbResid | （可选）显示指定数据库资源 ID 的 TDE Wallet 备份报告。使用 dbcli list-databases 命令获取数据库资源 ID。
|
| -in | --dbResname | （可选）显示指定数据库资源名称的 TDE Wallet 备份报告。使用 dbcli list-databases 命令获取数据库资源名称。
|
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令列出 TDE Wallet 的备份报告：
dbcli list-tdebackupreportsDbResID 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.gzdbcli 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]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 所有 | --allPdbNames |
（可选）用于轮换（更新）所有 PDB 名称的标志。要全部更新而不是更新指定的 PDB 名称，请使用此参数，而不是 |
| -i | --databaseId |
定义要为其更新密钥的数据库 ID。 |
| -p | --password |
定义 TDE 管理 wallet 密码。请指定不带口令的 如果必须在命令（例如在脚本中）中提供口令，请使用 |
| -n | --pdbNames | 定义要轮换（更新）的 PDB 名称。 |
|
-r -no-r |
--rootDatabase -- 无 -rootDatabase |
指示是否轮换根数据库的密钥（如果它是容器数据库）。 |
| -t | -tagName | 定义用于备份 wallet 的 TagName。默认值为 OdaRotateKey。 |
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -J | --json | （可选）显示 JSON 输出。 |
范例
以下命令仅更新 pdb1 和 pdb2 的密钥：
dbcli update-tdekey -dbid ee3eaab6-a45b-4e61-a218-c4ba665503d9 -p -n pdb1,pdb2TDE 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 -rTDE Admin wallet password:
{
"jobId" : "c72385f0-cd81-42df-a8e8-3a1e7cab1278",
"status" : "Created",
"message" : null,
"reports" : [ ],
"createTimestamp" : 1467876433783,
"description" : "TDE update",
"updatedTime" : 1467876433783
}dbcli 恢复 -tdewallet
使用 dbcli recover-tdewallet 命令恢复 TDE wallet。
语法
dbcli recover-tdewallet
-in <db_name>
-tp <password>
[-l <location>]
[-h] [-j]参数
| Parameter (参数) | 全名 | 说明 |
|---|---|---|
| - 小时 | --help | （可选）显示有关使用命令的帮助。 |
| -in | --dbName | 数据库名称。 |
| -J | --json | （可选）显示 JSON 输出。 |
| -l | --tdeWalletBackuplocation | （可选）TDE wallet 备份位置。TDE wallet 应以 tar.gz 格式备份。 |
| -tp | --tdeWalletPassword |
定义 TDE 管理 wallet 密码。 |