华为云用户手册

URI URI格式 GET https://{Endpoint}/v3/{project_id}/configurations/{config_id}/histories URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/configurations/341bc383a3e24221a94c4ad0b4547e8apr02/histories?offset=0&limit=10

响应消息 参数说明 表4 响应Body参数 参数 参数类型 说明 histories Array of 表5-5 objects 参数模板的修改历史列表。 表5 HistoryInfo 参数 参数类型 说明 parameter_name String 参数名称 old_value String 修改前的值。 new_value String 修改后的值。 updated_at String 修改时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 响应示例 { "histories" : [ { "parameter_name" : "rateLimit.mbps", "old_value" : "500", "new_value" : "350", "updated_at" : "2022-06-07T09:25:45+0000" } ] }

请求消息 参数说明 表1 请求参数 名称 类型 IN 是否必选 描述 X-Auth-Token string header 是 从 IAM 服务获取的用户Token。请参考认证鉴权。 project_id string path 是 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id string path 是 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

URI URI格式 POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/switchover URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/9136fd2a9fcd405ea4674276ce36dae8in02/switchover

URI URI格式 POST https://{Endpoint}/v3/{project_id}/weak-password-verification URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/weak-password-verification 表1 请求参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 从IAM服务获取的用户Token。请参考认证鉴权。 project_id 是 String 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。

请求消息 参数说明 表2 请求Body参数 参数 是否必选 参数类型 描述 num 否 Integer 删除的节点数量。 node_list 否 Array of strings 指定删除节点的ID列表。 num与node_list必须有一个字段传值。 如果num与node_list同时传值时，则以node_list的值为准。 删除的节点角色不能是Primary，以及Hidden。 如果是多AZ实例，需满足删除指定节点后，每个AZ至少存在一个节点。 请求示例一： { "num" : 2 } 请求示例二： { "node_list" : [ "116ba14da34a42d28ecd83a38c218907no02", "642597740d884b9eb998338859eea6ceno02" ] }

URI URI格式 DELETE https://{Endpoint}/v3/{project_id}/instances/{instance_id}/nodes URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/e73893ef73754465a8bd2e0857bbf13ein02/nodes 表1 请求参数 名称 类型 IN 是否必选 描述 X-Auth-Token string header 是 从IAM服务获取的用户Token。请参考认证鉴权。 project_id string path 是 租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。 instance_id string path 是 实例ID，可以调用“查询实例列表和详情”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

响应消息 参数说明 表3 参数说明 名称 参数类型 说明 list List 慢日志下载链接列表。 详情请参见表4。 status String 慢日志下载链接生成状态。 FINISH，表示下载链接已经生成完成。 CREATING，表示正在生成文件，准备下载链接。 FAILED，表示存在日志文件准备失败。 count Integer 慢日志链接数量。 表4 list字段数据结构说明 名称 参数类型 说明 node_name String 节点名称。 file_name String 生成的下载文件名。 status String 当前链接的生成状态。 SUC CES S，表示下载链接已经生成完成。 EXPORTING，表示正在生成文件，准备下载链接。 FAILED，表示存在日志文件准备失败。 file_size String 文件大小，单位为 KB。 file_link String 下载链接。 说明： 下载链接在更新时间的15分钟内有效，超出时间会重新获取。 update_at Long 更新时间。 响应示例 { "list": [ { "node_name": "dds-2a78_replica_node_3", "file_name": "054bc9f81e80d2201fccc00b92ad6ec0_ca327a60b3084fa79ce072d7299b905ano02_slowlog_20201117060412", "status": "SUCCESS", "file_size": "0", "file_link": "https://rdsbucket.xxxr.obs.cn-xianhz-1.myhuaweicloud.com:443/054bc9c1f680d55c1f36c006e5a9f67b_slowlog_download_20200515080614589?AWSAccessKeyId=1BQ38TBCQHAVQXBUMUTC&Expires=1589530200&response-cache-control=no-cache%2Cno-store&Signature=Fgi4%2BLOJ9frAXyOkz5hRoW5O%2BUM%3D", "update_at": 1605593100566 } ], "status": "FINISH", "count": 1 }

URI URI格式 POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/slowlog-download URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/6ade8143870047b8999aba8f1891b48ein02/slowlog-download

请求示例 获取慢日志下载链接，按照需要下载的文件的文件名列表或节点ID列表 { "file_name_list":["0541c9f81e80d2201fccc00b92ad6ec0_052f8a12dfed43fbb27c2020e3c3c507no02_slowlog_20201117104809"], "node_id_list":["052f8a12dfed43fbb27c2020e3c3c507no02"] }

请求消息 参数说明 表2 参数说明 名称 参数类型 是否必选 描述 file_name_list Array of strings 否 需要下载的文件的文件名列表。 node_id_list Array of strings 否 节点ID列表，取空值，表示查询实例下所有允许查询的节点。 使用请参考《DDS API参考》的“查询实例列表”响应消息表“nodes 数据结构说明”的“id”。 允许查询的节点如下： 集群下面的shard节点。 副本集、单节点下面的所有节点。

URI URI格式 POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/tags/action URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/cc6345c64cec47499182467ea0dd432ain02/tags/action

请求消息 参数说明 表2 参数说明 名称 参数类型 是否必选 描述 action String 是 操作标识。取值： create，表示添加标签。 delete，表示删除标签。 tags Array of objects 是 标签列表。详情请参见表3。 说明： 删除标签时，不对该参数做字符集校验。 表3 tags字段数据结构说明 名称 参数类型 是否必选 描述 key String 是 标签键。 key不能为空，长度1~128个半角字符。 可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及以下字符： _ . : / = + - @。 _sys_开头属于系统标签，租户不能输入。 字符集：0-9，A-Z，a-z，“_”，“-”，中文。 value String 否 标签值。 可用 UTF-8 格式表示的字母(包含中文)、数字和空格，以及以下字符： _ . : / = + - @。 可以为空（empty or null），长度0~255个半角字符。 字符集：0-9，A-Z，a-z，“_”，“.”，“-”，中文。 “action”值为“create”时，该参数必选。 “action”值为“delete”时，该参数可选。 说明： 删除标签时，如果value有值，则按照key/value匹配删除；如果value没有值，则按照key删除。

请求示例 批量添加2个标签 { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key", "value": "value3" } ] } 批量删除2个标签 { "action": "delete", "tags": [ { "key": "key1" }, { "key": "key2", "value": "value3" } ] }

响应消息 参数说明 表4 响应Body参数 参数 参数类型 说明 histories Array of 表5-5 objects 参数模板应用历史列表。 表5 ApplicableInstancesInfo 参数 参数类型 说明 instance_id String 实例ID。 instance_name String 实例名称。 applied_at String 应用时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 apply_result String 应用结果。 SUCCESS：应用成功，FAILED：应用失败，APPLYING：应用中。 failure_reason String 失败原因。 响应示例 { "histories" : [ { "instance_id" : "1967d9d9d6ef4c5ea38bd5a754f5737ein02", "instance_name" : "dds-4525", "applied_at" : "2022-06-07T09:25:45+0000", "apply_result" : "SUCCESS" } ] }

URI URI格式 GET https://{Endpoint}/v3/{project_id}/configurations/{config_id}/applied-histories URI样例 https://dds.cn-north-1.myhuaweicloud.com/v3/056538411200d4cd2f79c003c7606412/configurations/7a8d539ba30f43adaf1b16d08b1df4bdpr02/applied-histories?offset=0&limit=10

修订记录 发布日期 更新特性 2021-12-30 第四十三次正式发布，包含以下修改内容： 新增补丁升级。 2021-11-30 第四十二次正式发布，包含以下修改内容： 副本集实例支持添加副本集实例只读节点。 2021-07-30 第四十一次正式发布，包含以下修改内容： 新增修改实例备注。 新增使用浏览器直接下载。 新增按地址下载。 2021-06-30 第四十次正式发布，包含以下修改内容： 新增设置秒级监控。 支持RocksDB引擎，兼容MongoDB 4.2版本。 2021-05-30 第三十九次正式发布，包含以下修改内容： 新增设置可维护时间段。 2021-04-30 第三十八次正式发布，包含以下修改内容： 新增查看参数修改历史。 新增导出参数模板。 新增应用参数模板。 新增查看参数模板应用记录。 新增设置跨区域备份策略。 参数组更名为参数模板。 副本集实例支持可用区部署切换。 DDS实例名称支持中文。 跨网段访问配置当前最多可支持配置30个源端网段。 2021-03-30 第三十七次正式发布，包含以下内容： 新增迁移可用区。 2021-01-30 第三十六次正式发布，包含以下内容： 新增恢复集群备份到本地自建数据库。 2020-12-30 第三十五次正式发布，包含以下内容： DDS支持极速云盘。 DDS支持删除源端网段。 2020-10-30 第三十四次正式发布，包含以下内容： 资源标签支持20个配额。 2020-09-30 第三十三次正式发布，包含以下内容： 下线社区增强版。 社区版4.0实例支持鲲鹏机型。 2020-08-30 第三十二次正式发布，包含以下内容： 社区版集群实例最大支持32个mongos和32个shard。 副本集存储空间最大值调整到3000GB。 社区版实例支持恢复备份至当前实例。 2020-07-30 第三十一次正式发布，包含以下内容： 副本集实例支持跨网段配置。 2020-05-30 第三十次正式发布，包含以下内容： 提供回收站功能。 2020-04-30 第二十九次正式发布，包含以下内容： 支持购买多az社区版实例。 2020-04-15 第二十八次正式发布，包含以下内容： 副本集实例支持同VPC下跨子网访问配置。 2020-03-31 第二十七次正式发布，包含以下内容： 新增如下监控指标。 mongo044_swap_usage mongo050_top_total_time mongo051_top_read_time mongo052_top_write_time mongo053_wt_flushes_status mongo054_wt_cache_used_percent mongo055_wt_cache_dirty_percent 2020-02-14 第二十六次正式发布，包含以下内容： 副本集实例支持新增至五节点或七节点。 根据界面优化更新重启及删除实例、添加节点、扩容存储、变更规格、备份与恢复、参数组、监控相关的操作步骤。 2019-12-09 第二十五次正式发布，包含以下内容： 新增什么是参数模板。 支持删除已冻结的包周期实例。 支持添加mongos节点时选择AZ。 支持任务中心查看规格变更、添加节点、重启、恢复到新实例、恢复到指定时间点任务。 2019-11-11 第二十四次正式发布，包含以下内容： 社区版集群实例支持扩容到2000GB。 修改DDS的 云监控 指标维度。 修改支持与限制的命令。 2019-10-18 第二十三次正式发布，包含以下内容： 补充设置自动备份策略的注意事项。 新增数据迁移的注意事项。 修改标签的命名规则。 支持导出错误日志和慢日志明细。 补充连接实例相关的故障排除。 2019-09-11 第二十二次正式发布，包含以下内容： 社区版集群实例最大支持16个mongos和16个shard。 社区版实例支持审计日志功能。 社区版副本集实例支持库表级时间点恢复。 2019-08-13 第二十一次正式发布，包含以下内容： 社区版实例支持慢日志明文显示。 支持通过参数设置统计函数功能。 增强版集群实例支持恢复到指定时间点。 2019-07-07 第二十次正式发布，包含以下内容： 新增审计日志。 2019-06-13 第十九次正式发布，包含以下内容： 新增权限管理。 2019-04-19 第十八次正式发布，包含以下内容： 根据界面优化更新重启及删除实例、备份与恢复、参数组、存储、安全、标签、任务中心、监控相关操作的操作步骤。 支持手动切换副本集实例的主备节点。 新增通过mongodump和mongorestore工具迁移数据。 2019-03-25 第十七次正式发布，包含以下内容： 备份保留天数最多支持732天。 2019-02-15 第十六次正式发布，包含以下内容： 增强版集群实例支持按需计费转包周期。 新增恢复副本集备份到本地自建数据库。 界面上按需计费实例的扩容操作取消规格确认页面，文档中删除相关描述。 2019-01-07 第十五次正式发布，包含以下内容： 添加新的方式修改实例名称。 2018-11-23 第十四次正式发布，包含以下内容： DDS社区版实例支持下载错误日志和慢日志。 2018-11-02 第十三次正式发布，包含以下内容： 支持副本集实例按需计费转包周期。 支持按需计费实例批量转包周期。 支持批量续费包周期实例。 2018-09-26 第十二次正式发布，包含以下内容： 支持变更实例的CPU和内存规格时不中断业务。 对接标签管理服务。 2018-09-06 第十一次正式发布，包含以下内容： 支持集群和单节点按需计费实例转包周期。 手动备份的备份名称区分大小写字母。 支持修改参数组描述。 支持降低社区版实例的CPU和内存规格。 2018-08-03 第十次正式发布，包含以下内容： 支持下载备份文件。 2018-07-02 第九次正式发布，包含以下内容： 支持DDS社区增强版。 支持修改实例安全组。 支持任务中心。 优化自动备份策略。 支持用户删除自动备份。 副本集的存储空间上限值变更为2000GB。 2018-06-15 第八次正式发布，包含以下内容： 支持通过开关开启和关闭自动备份策略。 2018-06-01 第七次正式发布，包含以下内容： 支持兼容社区版MongoDB 3.4版本。 支持重启实例和删除实例时二次验证。 2018-05-04 第六次正式发布，包含以下内容： 支持创建“包年/包月”模式的副本集实例。 支持单节点公测。 副本集商用。 2018-04-13 第五次正式发布，包含以下内容： 创建实例页面支持设置实例名称。 支持开启和关闭公网访问。 支持查看所有shard节点的慢日志。 创建实例时磁盘存储空间范围变更。 扩容存储的最小扩容量变更。 支持为新创建的实例创建数据库账户。 支持删除添加失败的节点。 支持变更实例的CPU和内存规格。 2017-12-29 第四次正式发布，包含以下内容： 根据界面适配资料。 2017-11-08 第三次正式发布，包含以下内容： 文档数据库服务商用。 2017-08-18 第二次正式发布，包含以下内容： 根据界面优化更新购买数据库实例操作步骤。 根据界面优化更新通过SSL证书连接数据库实例的操作步骤。 2017-03-03 第一次正式发布。

参数说明 表1 DDS慢日志相关的参数说明 参数名称 说明 operationProfiling.mode 数据库profiling（分析）级别。默认值为slowOp。 off：分析器关闭，不收集任何数据。 slowOp：对于耗时超过慢查询阈值的操作，采集器采集数据。 all：采集器采集所有操作的数据。 operationProfiling.slowOpThresholdMs 慢查询的时间阈值，单位为毫秒，超过该阈值的操作将被认为是慢操作。默认值为500ms。 如无特殊需求，建议使用默认值500ms。

使用须知 回收站策略机制默认开启，且不可关闭，默认保留天数为7天，该功能免费。 如果用户同时删除100个实例，且回收站内存放有之前删除的实例，那么这100个实例可以被删除成功，但是只有部分实例能进入回收站。回收站只允许加入100个实例，超过该配额的实例将无法添加至回收站中。 修改回收站保留天数，仅对修改后新进入回收站的实例生效，对于修改前已经存在的实例，仍保持原来的回收策略，请您谨慎操作。 节点脱节状态下无法做回收备份。

支持的迁移对象范围 在使用DRS进行迁移时，不同类型的迁移任务，支持的迁移对象范围不同，详细情况可参考表2。DRS会根据用户选择，在“预检查”阶段对迁移对象进行自动检查。 表2 支持的迁移对象 类型名称 使用须知 迁移对象范围 迁移对象选择维度：支持选择表级、库级或实例级（全部迁移）。 支持的迁移对象： 相互关联的数据对象要确保同时迁移，避免迁移因关联对象缺失，导致迁移失败。常见的关联关系：视图引用集合、视图引用视图等。 副本集：目前只支持集合(包括验证器，是否是固定集合)，索引和视图的迁移。 集群：目前只支持集合（包括验证器，是否是固定集合），分片键，索引和视图的迁移。 单节点：目前只支持集合（包括验证器，是否是固定集合），索引和视图的迁移。 只支持迁移用户数据和源数据库的账号信息，不支持迁移系统库（如local、admin、config等）和系统集合，如果业务数据在系统库下，则需要先将业务数据移动到用户数据库下，可以使用renameCollection命令进行移出。 不支持视图的创建语句中有正则表达式。 不支持_id字段没有索引的集合。 不支持BinData()的第一个参数为2。 不支持范围分片的情况下maxKey当主键。 说明： 支持迁移的对象有如下限制： 源数据库的库名不能包含/\."$和空格，集合名和视图名中不能包含$字符或以system.开头。

迁移场景 全量迁移 该模式为数据库一次性迁移，适用于可中断业务的数据库迁移场景，全量迁移将非系统数据库的全部数据库对象和数据一次性迁移至目标端数据库，包括：表、视图、存储过程等。选择“全量迁移”模式，建议停止对源数据库的操作，否则迁移过程中源数据库产生的新数据不会同步到目标数据库。 全量+增量迁移 该模式为数据库持续性迁移，适用于对业务中断敏感的场景，通过全量迁移过程中完成的目标端数据库的初始化后，增量迁移阶段通过解析日志等技术，将远端和目标端数据库保持数据持续一致。选择“全量+增量”迁移模式，增量迁移可以在全量迁移完成的基础上实现数据的持续同步，无需中断业务，实现迁移过程中源业务和数据库继续对外提供访问。

数据库账号权限要求 在使用DRS进行迁移时，连接源库和目标库的数据库账号需要满足以下权限要求，才能启动实时迁移任务。不同类型的迁移任务，需要的账号权限也不同，详细可参考表3进行赋权。DRS会在“预检查”阶段对数据库账号权限进行自动检查，并给出处理建议。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请尽快修改DRS任务中的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。 表3 数据库账号权限 类型名称 全量迁移 全量+增量迁移 源数据库连接账号 副本集：连接源数据库的用户需要有admin库的readAnyDatabase权限。 单节点：连接源数据库的用户需要有admin库的readAnyDatabase权限。 集群：连接源数据库的用户需要有admin库的readAnyDatabase权限，有config库的read权限。 如果需要迁移源数据库用户和角色信息，连接源数据库和目标库数据库的用户需要有admin数据库的系统表system.users、system.roles的read权限。 副本集：连接源数据库的用户需要有admin库的readAnyDatabase权限，有local库的read权限。 单节点：连接源数据库的用户需要有admin库的readAnyDatabase权限，有local库的read权限。 集群：连接源数据库mongos节点的用户需要有admin库的readAnyDatabase权限，有config库的read权限，连接源数据库分片节点的用户需要有admin库的readAnyDatabase权限，有local库的read权限。 如果需要迁移源数据库用户和角色信息，连接源数据库和目标库数据库的用户需要有admin数据库的系统表system.users、system.roles的read权限。 目标数据库连接账号 连接目标数据库的用户需要有admin库的dbAdminAnyDatabase权限，有目标数据库的readWrite权限。 对于目标数据库是集群的实例，迁移账号还要有admin库的clusterManager权限。 用户赋权参考语句：如连接源数据库的用户需要有admin库的readAnyDatabase权限和config库的read权限。 db.grantRolesToUser("用户名",[{role:"readAnyDatabase",db:"admin"}, {role:"read",db:"config"}])

使用须知 实例状态为正常、恢复检查中、转包周期中、修改安全组中时，允许切换主备节点。 主备节点切换可能会造成1分钟的服务闪断，切换前请确认客户端具备重连机制。 新添加的备节点，需要重新配置高可用连接地址，且为保证实例性能，会有12个小时的冻结期，冻结期内的备节点不参与主备切换。 实例必须处于运行状态才可进行主备切换。 主备同步的延迟时间过长时，主备切换耗时可能很久。因此，当主备同步的延迟时间超过300s时，控制台将不允许下发主备切换。关于副本集主备同步的延迟时间，请参见副本集中主备同步存在多长时间的延迟。

支持与限制的命令 用户在连接到社区版文档数据库后，需要关注以下支持以及限制的命令。 更多信息，请参见MongoDB官方文档。 如下表所示，“√”表示当前版本支持该命令，“×”表示当前版本不支持该命令。 表1 支持与限制的命令 命令类别 命令名称 3.4 4.0 4.2 备注 Aggregates Commands aggregate √ √ √ - count √ √ √ - distinct √ √ √ - group √ √ √ - mapReduce √ √ √ 在DDS实例关联参数模板中设置参数“security.javascriptEnabled”的值为“true”后，可以使用该命令。更多信息，请参见如何使用MapReduce命令。 Geospatial Commands geoNear √ √ √ - geoSearch √ √ √ - Query and Write Operation Commands find √ √ √ - insert √ √ √ - update √ √ √ - delete √ √ √ - findAndModify √ √ √ - getMore √ √ √ - getLastError √ √ √ - resetError √ √ √ - getPrevError √ √ √ - parallelCollectionScan √ √ √ - Query Plan Cache Commands planCacheListFilters √ √ √ - planCacheSetFilter √ √ √ - planCacheClearFilters √ √ √ - planCacheListQueryShapes √ √ √ - planCacheListPlans √ √ √ - planCacheClear √ √ √ - Authentication Commands logout √ √ √ - authenticate √ √ √ - copydbgetnonce √ √ √ - getnonce √ √ √ - authSchemaUpgrade x x x 系统内部命令。 User Management Commands createUser √ √ √ - updateUser √ √ √ - dropUser √ √ √ - dropAllUsersFromDatabase √ √ √ - grantRolesToUser √ √ √ - revokeRolesFromUser √ √ √ - usersInfo √ √ √ - Role Management Commands invalidateUserCache √ √ √ - createRole √ √ √ - updateRole √ √ √ - dropRole √ √ √ - dropAllRolesFromDatabase √ √ √ - grantPrivilegesToRole √ √ √ - revokePrivilegesFromRole √ √ √ - grantRolesToRole √ √ √ - revokeRolesFromRole √ √ √ - rolesInfo √ √ √ - Replication Commands replSetElect x x x 系统内部命令。 replSetUpdatePosition x x x 系统内部命令。 appendOplogNote x x x 系统内部命令。 replSetFreeze x x x 系统内部命令。 replSetGetStatus √ √ √ - replSetInitiate x x x 系统内部命令。 replSetMaintenance x x x 系统内部命令。 replSetReconfig x x x 系统内部命令。 replSetStepDown x x x 系统内部命令。 replSetSyncFrom x x x 系统内部命令。 replSetRequestVotes x x x 系统内部命令。 replSetDeclareElectionWinner x x x 系统内部命令。 resync x x x 系统内部命令。 applyOps x x x 系统内部命令。 isMaster √ √ √ - replSetGetConfig x x x 系统内部命令。 Sharding Commands flushRouterConfig √ √ √ 高危命令。 addShard x x x 越权操作。 addShardToZone √ √ √ - balancerStart √ √ √ - balancerStatus √ √ √ - balancerStop √ √ √ - removeShardFromZone √ √ √ - updateZoneKeyRange √ √ √ - cleanupOrphaned x x x 高危命令。 checkShardingIndex x x x 系统内部命令。 enableSharding √ √ √ - listShards x x x 系统内部命令。 removeShard x x x 高危命令。 getShardMap x x x 系统内部命令。 getShardVersion √ √ √ - mergeChunks √ √ √ - setShardVersion x x x 系统内部命令。 shardCollection √ √ √ - shardingState x x x 系统内部命令。 unsetSharding x x x 系统内部命令。 split √ √ √ - splitChunk √ √ √ - splitVector √ √ √ - moveChunk √ √ √ - movePrimary √ x √ - isdbgrid √ √ √ - Administration Commands setFeatureCompatibilityVersion √ √ √ - renameCollection √ √ √ - dropDatabase √ √ √ - listCollections √ √ √ - drop √ √ √ - create √ √ √ - clone x x x 系统内部命令。 cloneCollection √ √ √ - cloneCollectionAsCapped √ √ √ - convertToCapped √ √ √ - filemd5 √ √ √ - createIndexes √ √ √ - listIndexes √ √ √ - dropIndexes √ √ √ - fsync √ √ √ - clean x x x 系统内部命令。 connPoolSync x x x 系统内部命令。 connectionStatus √ √ √ - compact x x x 高危命令。 collMod √ √ √ - reIndex √ √ √ - setParameter x x x 系统配置命令。 getParameter √ √ √ - repairDatabase x x x 高危命令。 repairCursor x x x 系统内部命令。 touch √ √ √ - shutdown x x x 高危命令。 logRotate x x x 高危命令。 killOp √ √ √ - releaseFreeMemory √ √ √ - Diagnostic Commands availableQueryOptions √ √ √ - buildInfo √ √ √ - collStats √ √ √ - connPoolStats x x x 系统内部命令。 cursorInfo x x x 系统内部命令。 dataSize √ √ √ - dbHash x x x 系统内部命令。 dbStats √ √ √ - diagLogging x x x 系统内部命令。 driverO IDT est x x x 系统内部命令。 explain √ √ √ - features √ √ √ - getCmdLineOpts x x x 系统内部命令。 getLog x x x 系统内部命令。 hostInfo x x x 系统内部命令。 isSelf x x x 系统内部命令。 listCommands √ √ √ - listDatabases √ √ √ - netstat x x x 系统内部命令。 ping √ √ √ - profile √ √ √ - serverStatus √ √ √ - shardConnPoolStats x x x 系统内部命令。 top √ √ √ - validate x x x 系统配置命令。 whatsmyuri √ √ √ - Internal Commands handshake x x x 系统内部命令。 _recvChunkAbort x x x 系统内部命令。 _recvChunkCommit x x x 系统内部命令。 _recvChunkStart x x x 系统内部命令。 _recvChunkStatus x x x 系统内部命令。 _replSetFresh x x x 系统内部命令。 mapreduce.shardedfinish x x x 系统内部命令。 _transferMods x x x 系统内部命令。 replSetHeartbeat x x x 系统内部命令。 replSetGetRBID x x x 系统内部命令。 _migrateClone x x x 系统内部命令。 replSetElect x x x 系统内部命令。 writeBacksQueued x x x 系统内部命令。 writebacklisten x x x 系统内部命令。 System Events Auditing Commands logApplicationMessage x x x 系统内部命令。 父主题： 数据库使用

自动备份说明 备份类型： 全量备份：全量备份表示对所有目标数据进行备份。全量备份总是备份所有选择的目标，即使从上次备份后数据没有变化。 增量备份：增量备份指在一次全量备份或上一次增量备份后，以后每次的备份只需备份与前一次相比增加或者被修改的数据。DDS系统自动每5-60min对上一次自动备份，或增量备份后更新的数据进行备份。 备份方式 物理备份：通过物理拷贝磁盘文件的方式进行备份。 快照备份：保留某一时间点磁盘的数据状态，快照备份方式相比物理备份来讲 ，时间更快。开启快照备份之后，会由CBR服务单独计费。 逻辑备份：通过工具读取数据逻辑导出。 DDS支持的自动备份方法如表1所示。 表1 备份方法 实例类型 备份方式 备份类型 集群 物理备份 全量备份 增量备份 副本集 物理备份 全量备份 增量备份 单节点 说明： 单节点因为资源的限制，支持的场景有限，建议仅学习时选用。 逻辑备份/快照备份 说明： 将备份方式设置为快照备份，请参见设置单节点实例备份方式。 全量备份

使用场景 文档数据库服务按照设置的自动备份策略，对数据库进行自动备份。建议您定期对数据库进行备份，当数据库故障或数据损坏时，可以通过备份恢复数据库，从而保证数据可靠性。 创建文档数据库实例时，默认开启自动备份策略。待实例创建成功后，您可以根据业务需要修改自动备份策略或关闭自动备份策略。 开启自动备份策略后，会立即自动触发一次全量备份。之后会按照自动备份策略中设置的备份时间段和备份周期进行全量备份。实例在执行备份时，会将数据从实例上拷贝并压缩后上传到OBS备份空间，按照自动备份策略中的保留天数进行存放，备份时长和实例的数据量有关，平均备份速率为60MB/s。自动备份策略开启后，副本集实例每五分钟会自动进行一次增量备份，以保证数据的可靠性。集群实例如果使用增量备份功能，则需要手动开启。

使用须知 开启或关闭SSL会导致实例重启，请谨慎操作。 在开启或关闭SSL时，文档数据库服务会进行一次重启，重启过程中每个节点会有一次约30秒的闪断，建议您安排好业务并确保应用有重连机制。 开启SSL，可以通过SSL方式连接数据库，具有更高的安全性。 目前已禁用不安全的加密算法，支持的安全加密算法对应的加密套件参考如下。 版本 支持的TLS版本 支持的加密算法套件 3.4 TLS 1.2 AES256-GCM-SHA384 AES128-GCM-SHA256 4.0 TLS 1.2 DHE-RSA-AES256-GCM-SHA384 DHE-RSA-AES128-GCM-SHA256 用户的客户端所在服务器需要支持对应的TLS版本以及对应的加密算法套件，否则会连接失败。 关闭SSL，可以采用非SSL方式连接数据库。

参数调优 数据库参数是数据库系统运行的关键配置信息，设置不合适的参数值可能会影响业务。本文列举了一些重要参数说明。更多参数的详细说明请参见MongoDB官网。 如需通过控制台界面修改参数值，请参见修改DDS实例参数。 enableMajorityReadConcern 该参数表示读取数据时，是否需要从大多数节点获取一致的数据后才返回结果。 默认值为“false”，表示读取数据时，不需要从大多数节点获取一致数据后返回结果，即从单个节点上读取数据就可以返回结果。 该参数设为true的时候，表示读取数据时，需要从大多数节点获取一致数据后才返回结果。该操作会导致LAS文件过大，进而造成CPU过高和磁盘占用大。 在DDS中，不支持设置majority级别的readConcern。对于需要majorityReadConcern的场景，可以将WriteConcern设置为majority，表示数据写入到大多数节点了，这样也就保证了大多数节点的数据一致了。然后通过读取单个节点的数据，就能保证用户读到的数据已经写入到大多数节点，而这样的数据不会发生回滚，避免了脏读的问题。 MongoDB可以通过writeConcern来定制写策略，通过readConcern来定制读策略。 当指定readConcern级别为majority时，能保证用户读到的数据已经写入到大多数节点，而这样的数据不会发生回滚，避免了脏读的问题。 failIndexKeyTooLong 默认值为“true”。 该参数不支持修改，避免过长索引Key。 net.maxIncomingConnections 该参数表示mongos或mongod可接受的最大同时连接数量。该参数依赖于实例的规格，实例规格不同对应其默认值也不同。因此，此参数在用户未设置前显示为“default”，表示该参数随内存规格变化。 security.javascriptEnabled 默认值为“false”。 该参数表示是否允许mongod上执行JavaScript脚本。为了安全考虑，默认值为“false”，表示不允许mongod上执行JavaScript脚本，mapreduce、group等命令也将无法使用。 disableJavaScriptJIT 默认值为“true”。 该参数表示是否禁用JavaScriptJIT编译技术。JavaScriptJIT编译技术实现了即时 (JIT) 编译以提高运行脚本时的性能。 “disableJavaScriptJIT”默认值为“true”，表示禁用JavaScriptJIT编译技术。如果需要启用JavaScriptJIT编译技术，可以将“disableJavaScriptJIT”的值设置为“false”。 operationProfiling.mode 默认值为“slowOp”。 该参数表示数据库分析器的级别。 该参数支持如下取值： 默认值为“slowOp”，表示对于耗时超过慢查询阈值的操作，采集器采集数据。 取值为“off”，表示分析器关闭，不收集任何数据。 取值为“all”，表示采集器采集所有操作的数据。 operationProfiling.slowOpThresholdMs 默认值为“500”，单位为ms。 该参数表示慢查询的时间阈值，单位为毫秒，超过该阈值的操作将被认为是慢操作。 如无特殊需求，建议使用默认值500ms。 maxTransactionLockRequestTimeoutMillis 默认值“5”，取值范围为5~100，单位为ms。 该参数表示事务等待获取锁的时间，超过该时间则事务回滚。 父主题： 性能调优

使用须知 对于“包年/包月”模式的数据库实例，您需要进行订单退订才可删除实例，详细操作请参见退订包周期实例。 删除实例后，该实例上的数据以及相关的自动备份将全部被清除，且不可恢复，请谨慎操作。 文档数据库服务默认保留所有手动备份，实例删除后，可用来恢复。 开启操作保护的用户，在进行敏感操作时，通过进行二次认证再次确认您的身份，进一步提高账号安全性，有效保护您安全使用云产品。关于如何开启操作保护，具体请参考《 统一身份认证 服务用户指南》中敏感操作的内容。

副本集模式启动数据库 DDS实例的物理备份默认带有原实例的副本集配置。启动时需以单节点模式启动，否则可能无法访问。 如需以副本集模式启动，请先执行5，再执行以下步骤： 通过服务器的mongo shell登录恢复后的数据库。 移除原有副本集配置。 use local db.system.replset.remove({}) 关闭数据库进程服务。 use admin db.shutdownServer() 修改“/path/to/mongo/”目录下的配置文件“mongod.conf”，添加replication相关配置。详细命令用法请参考MongoDB官方文档部署副本集。 指定新建的配置文件“mongod.conf”来启动数据库。 /usr/bin/mongod -f /path/to/mongo/mongod.conf /usr/bin/为已安装MongoDB客户端中mongod文件所在路径。 将成员加入副本集并初始化副本集。 此步骤使用 rs.initiate()命令进行操作，详细命令用法请参考MongoDB官方文档rs.initiate()命令介绍。