华为云用户手册

恢复方案 DDS支持多种数据恢复方案，您可以根据业务需要选择合适的恢复方法。 支持版本号没有说明的，默认支持全部版本：3.2、3.4、4.0、4.2和4.4版本。 表1 恢复方案 恢复类型 支持的实例类型和版本 使用场景 恢复备份到新实例 集群 副本集 单节点 使用已有的自动备份文件或手动备份文件恢复实例数据到新建实例。 恢复备份到当前实例 集群 副本集 单节点 使用已有的自动备份文件或手动备份文件恢复实例数据到当前实例。 恢复实例备份到指定时间点 集群（4.0及以上版本） 副本集（4.0及以上版本） 适用于实例级数据恢复场景，将数据还原至某个指定的时间点。 恢复库表到指定时间点 副本集（4.0及以上版本） 集群（4.0及以上版本） 适用于库表级数据恢复场景，将数据还原至某个指定的时间点。 恢复备份数据到本地自建数据库 集群（3.4、4.0版本支持） 副本集（3.4、4.0版本支持） 单节点（3.4、4.0版本支持） 您可以将DDS的备份文件下载到本地，将数据恢复至本地自建数据库。 通过mongorestore工具恢复数据 集群 副本集 单节点 您可以通过MongoDB客户端自带的备份恢复工具恢复数据。 通过mongoimport工具恢复数据 集群 副本集 单节点 您可以通过MongoDB客户端自带的备份恢复工具恢复数据。 父主题： 数据恢复

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

使用须知 账户需要有足够的余额，才可进行扩容。 对于集群实例，仅支持对shard节点进行磁盘扩容，dds mongos节点、config节点和只读节点不能进行磁盘扩容。 选择磁盘加密的实例，新扩容的磁盘空间依然会使用原加密密钥进行加密。 实例处于以下状态时不可扩容： 创建中 规格变更中 节点扩容中 删除节点 小版本升级 磁盘扩容期间，服务不中断。DDS服务只支持扩容磁盘存储空间大小，不支持变更存储类型。

使用须知 该方法仅适用于集群实例。 目前仅支持3.4和4.0版本，4.2及以上版本暂不支持通过该方式在本地进行恢复。 操作步骤中的目录，IP地址和端口信息，可按照实际恢复环境配置。 configsvr节点备份文件有一个，shardsrv的备份文件有多个，依据实际shardsvr数量而定。 备份文件下载完成后，需要解压（需要安装lz4解压工具）。参考命令：lz4 -d $1 | tar -xC $2 $1：下载下来的备份文件。 $2：备份文件解压至的目标路径。 如果需要完成数据库、集合级别的数据迁移，请参见通过mongodump和mongorestore工具迁移数据。

配置文件说明 configsvr副本集的单节点配置文件及三个节点的配置文件 /compile/mongodb/mongodb-src-4.0.3/restoreconfig/single_40303.yaml /compile/mongodb/mongodb-src-4.0.3/restoreconfig/configsvr_40303.yaml /compile/mongodb/mongodb-src-4.0.3/restoreconfig/configsvr_40304.yaml /compile/mongodb/mongodb-src-4.0.3/restoreconfig/configsvr_40305.yaml shardsvr1副本集的单节点配置文件及三个节点的配置文件 /compile/mongodb/mongodb-src-4.0.3/restoreconfig/single_40306.yaml /compile/mongodb/mongodb-src-4.0.3/restoreconfig/shardsvr_40306.yaml /compile/mongodb/mongodb-src-4.0.3/restoreconfig/shardsvr_40307.yaml /compile/mongodb/mongodb-src-4.0.3/restoreconfig/shardsvr_40308.yaml shardsvr2副本集的单节点配置文件及三个节点的配置文件 /compile/mongodb/mongodb-src-4.0.3/restoreconfig/single_40309.yaml /compile/mongodb/mongodb-src-4.0.3/restoreconfig/shardsvr_40309.yaml /compile/mongodb/mongodb-src-4.0.3/restoreconfig/shardsvr_40310.yaml /compile/mongodb/mongodb-src-4.0.3/restoreconfig/shardsvr_40311.yaml dds mongos节点的配置文件 /compile/mongodb/mongodb-src-4.0.3/restoreconfig/mongos_40301.yaml /compile/mongodb/mongodb-src-4.0.3/restoreconfig/mongos_40302.yaml

configsvr的三个节点的数据目录和日志目录 /compile/cluster-restore/cfg1/data/db /compile/cluster-restore/cfg1/log /compile/cluster-restore/cfg2/data/db /compile/cluster-restore/cfg2/log /compile/cluster-restore/cfg3/data/db /compile/cluster-restore/cfg3/log

shardsvr2的三个节点的数据目录和日志目录 /compile/cluster-restore/shd21/data/db /compile/cluster-restore/shd21/log /compile/cluster-restore/shd22/data/db /compile/cluster-restore/shd22/log /compile/cluster-restore/shd23/data/db /compile/cluster-restore/shd23/log

shardsvr1的三个节点的数据目录和日志目录 /compile/cluster-restore/shd11/data/db /compile/cluster-restore/shd11/log /compile/cluster-restore/shd12/data/db /compile/cluster-restore/shd12/log /compile/cluster-restore/shd13/data/db /compile/cluster-restore/shd13/log

恢复dds mongos节点 准备dds mongos节点的配置文件和目录。 rm -rf /compile/cluster-restore/mgs* mkdir -p /compile/cluster-restore/mgs1/log mkdir -p /compile/cluster-restore/mgs2/log 配置文件（restoreconfig/mongos_40301.yaml）。 net: bindIp: 127.0.0.1 port: 40301 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/mgs1/mongos.pid} sharding: {configDB: 'config/127.0.0.1:40303,127.0.0.1:40304,127.0.0.1:40305'} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/mgs1/log/mongos.log} 配置文件（restoreconfig/mongos_40302.yaml）。 net: bindIp: 127.0.0.1 port: 40302 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/mgs2/mongos.pid} sharding: {configDB: 'config/127.0.0.1:40303,127.0.0.1:40304,127.0.0.1:40305'} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/mgs2/log/mongos.log} 启动mongo节点。 ./mongos -f restoreconfig/mongos_40301.yaml ./mongos -f restoreconfig/mongos_40302.yaml 父主题： 恢复集群备份到本地自建数据库

操作步骤 准备单节点配置文件和目录，以单节点方式启动进程。 配置文件如下（restoreconfig/single_40309.yaml）。 net: bindIp: 127.0.0.1 port: 40309 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/shd21/mongod.pid} storage: dbPath: /compile/cluster-restore/shd21/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/shd21/log/mongod.log} 准备数据，将解压后的shardsvr2文件拷贝到单节点dbPath目录下。 cp -aR /compile/download/backups/cac1efc8e65e42ecad8953352321bfeein02_92b196d2401041a7af869a2a3cab7079no02/* /compile/cluster-restore/shd21/data/db/ 启动进程。 ./mongod -f restoreconfig/single_40309.yaml 连接单节点，执行配置命令。 连接命令：./mongo --host 127.0.0.1 --port 40309 执行如下命令，修改副本集配置信息。 var cf=db.getSiblingDB('local').system.replset.findOne(); cf['members'][0]['host']='127.0.0.1:40309'; cf['members'][1]['host']='127.0.0.1:40310'; cf['members'][2]['host']='127.0.0.1:40311'; cf['members'][0]['hidden']=false; cf['members'][1]['hidden']=false; cf['members'][2]['hidden']=false; cf['members'][0]['priority']=1; cf['members'][1]['priority']=1; cf['members'][2]['priority']=1; db.getSiblingDB('local').system.replset.remove({}); db.getSiblingDB('local').system.replset.insert(cf) 执行如下命令，清理内置账号。 db.getSiblingDB('admin').dropAllUsers(); db.getSiblingDB('admin').dropAllRoles(); 执行如下命令，更新configsvr信息。 var vs = db.getSiblingDB('admin').system.version.find(); while (vs.hasNext()) { var curr = vs.next(); if (curr.hasOwnProperty('configsvrConnectionString')) { db.getSiblingDB('admin').system.version.update({'_id' : curr._id}, {$set: {'configsvrConnectionString': 'config/127.0.0.1:40303,127.0.0.1:40304,127.0.0.1:40305'}}); } } 执行如下命令，关闭单节点进程。 db.getSiblingDB('admin').shutdownServer(); 搭建shardsvr2副本集。 准备副本集配置文件和目录，将shardsvr2节点的dbPath文件拷贝到其他两个节点目录下。 cp -aR /compile/cluster-restore/shd21/data/db/ /compile/cluster-restore/shd22/data/db/ cp -aR /compile/cluster-restore/shd21/data/db/ /compile/cluster-restore/shd23/data/db/ 修改shardsvr2-1节点配置文件，增加副本集配置属性（restoreconfig/shardsvr_40309.yaml）。 --- replication.replSetName 的值，参考该章节中的shard的_id信息。 net: bindIp: 127.0.0.1 port: 40309 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/shd21/mongod.pid} replication: {replSetName: shard_2} sharding: {archiveMovedChunks: false, clusterRole: shardsvr} storage: dbPath: /compile/cluster-restore/shd21/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/shd21/log/mongod.log} 启动进程。 ./mongod -f restoreconfig/shardsvr_40309.yaml 修改shardsvr2-2节点配置文件，增加副本集配置属性（restoreconfig/shardsvr_40310.yaml）。 --- replication.replSetName 的值，参考该章节中的shard的_id信息。 net: bindIp: 127.0.0.1 port: 40310 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/shd22/mongod.pid} replication: {replSetName: shard_2} sharding: {archiveMovedChunks: false, clusterRole: shardsvr} storage: dbPath: /compile/cluster-restore/shd22/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/shd22/log/mongod.log} 启动进程。 ./mongod -f restoreconfig/shardsvr_40310.yaml 修改shardsvr2-3节点配置文件，增加副本集配置属性（restoreconfig/shardsvr_40311.yaml）。 --- replication.replSetName 的值，参考该章节中的shard的_id信息。 net: bindIp: 127.0.0.1 port: 40311 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/shd23/mongod.pid} replication: {replSetName: shard_2} sharding: {archiveMovedChunks: false, clusterRole: shardsvr} storage: dbPath: /compile/cluster-restore/shd23/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/shd23/log/mongod.log} 启动进程。 ./mongod -f restoreconfig/shardsvr_40311.yaml 等待选主成功。 ./mongo --host 127.0.0.1 --port 40309 执行命令rs.status()，查看是否已存在主节点Primary。

准备目录 rm -rf /compile/cluster-restore/shd2* mkdir -p /compile/cluster-restore/shd21/data/db mkdir -p /compile/cluster-restore/shd21/log mkdir -p /compile/cluster-restore/shd22/data/db mkdir -p /compile/cluster-restore/shd22/log mkdir -p /compile/cluster-restore/shd23/data/db mkdir -p /compile/cluster-restore/shd23/log

操作步骤 准备单节点配置文件和目录，以单节点方式启动进程。 配置文件如下（restoreconfig/single_40306.yaml）。 net: bindIp: 127.0.0.1 port: 40306 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/shd11/mongod.pid} storage: dbPath: /compile/cluster-restore/shd11/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/shd11/log/mongod.log} 准备数据，将解压后的shardsvr1文件拷贝到单节点dbPath目录下。 cp -aR /compile/download/backups/cac1efc8e65e42ecad8953352321bfeein02_6cfa6167d4114d7c8cec5b47f9a78dc5no02/* /compile/cluster-restore/shd11/data/db/ 启动进程。 ./mongod -f restoreconfig/single_40306.yaml 连接单节点，执行配置命令。 连接命令：./mongo --host 127.0.0.1 --port 40306 执行如下命令，修改副本集配置信息。 var cf=db.getSiblingDB('local').system.replset.findOne(); cf['members'][0]['host']='127.0.0.1:40306'; cf['members'][1]['host']='127.0.0.1:40307'; cf['members'][2]['host']='127.0.0.1:40308'; cf['members'][0]['hidden']=false; cf['members'][1]['hidden']=false; cf['members'][2]['hidden']=false; cf['members'][0]['priority']=1; cf['members'][1]['priority']=1; cf['members'][2]['priority']=1; db.getSiblingDB('local').system.replset.remove({}); db.getSiblingDB('local').system.replset.insert(cf) 执行如下命令，清理内置账号。 db.getSiblingDB('admin').dropAllUsers(); db.getSiblingDB('admin').dropAllRoles(); 执行如下命令，更新configsvr信息。 连接命令：./mongo --host 127.0.0.1 --port 40306 var vs = db.getSiblingDB('admin').system.version.find(); while (vs.hasNext()) { var curr = vs.next(); if (curr.hasOwnProperty('configsvrConnectionString')) { db.getSiblingDB('admin').system.version.update({'_id' : curr._id}, {$set: {'configsvrConnectionString': 'config/127.0.0.1:40303,127.0.0.1:40304,127.0.0.1:40305'}}); } } 执行如下命令，关闭单节点进程。 db.getSiblingDB('admin').shutdownServer(); 搭建shardsvr1副本集。 准备副本集配置文件和目录，将shardsvr1节点的dbPath文件拷贝到其他两个节点目录下。 cp -aR /compile/cluster-restore/shd11/data/db/ /compile/cluster-restore/shd12/data/db/ cp -aR /compile/cluster-restore/shd11/data/db/ /compile/cluster-restore/shd13/data/db/ 修改shardsvr1-1节点配置文件，增加副本集配置属性（restoreconfig/shardsvr_40306.yaml）。 --- replication.replSetName 的值，参考该章节中的shard的_id信息。 net: bindIp: 127.0.0.1 port: 40306 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/shd11/mongod.pid} replication: {replSetName: shard_1} sharding: {archiveMovedChunks: false, clusterRole: shardsvr} storage: dbPath: /compile/cluster-restore/shd11/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/shd11/log/mongod.log} 启动进程。 ./mongod -f restoreconfig/shardsvr_40306.yaml 修改shardsvr1-2节点配置文件，增加副本集配置属性（restoreconfig/shardsvr_40307.yaml）。 --- replication.replSetName 的值，参考该章节中的shard的_id信息。 net: bindIp: 127.0.0.1 port: 40307 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/shd12/mongod.pid} replication: {replSetName: shard_1} sharding: {archiveMovedChunks: false, clusterRole: shardsvr} storage: dbPath: /compile/cluster-restore/shd12/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/shd12/log/mongod.log} 启动进程。 ./mongod -f restoreconfig/shardsvr_40307.yaml 修改shardsvr1-3节点配置文件，增加副本集配置属性（restoreconfig/shardsvr_40308.yaml）。 --- replication.replSetName 的值，参考该章节中的shard的_id信息。 net: bindIp: 127.0.0.1 port: 40308 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/shd13/mongod.pid} replication: {replSetName: shard_1} sharding: {archiveMovedChunks: false, clusterRole: shardsvr} storage: dbPath: /compile/cluster-restore/shd13/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/shd13/log/mongod.log} 启动进程。 ./mongod -f restoreconfig/shardsvr_40308.yaml 等待选主成功。 ./mongo --host 127.0.0.1 --port 40306 执行命令rs.status()，查看是否已存在主节点Primary。

准备目录 rm -rf /compile/cluster-restore/shd1* mkdir -p /compile/cluster-restore/shd11/data/db mkdir -p /compile/cluster-restore/shd11/log mkdir -p /compile/cluster-restore/shd12/data/db mkdir -p /compile/cluster-restore/shd12/log mkdir -p /compile/cluster-restore/shd13/data/db mkdir -p /compile/cluster-restore/shd13/log

准备目录 rm -rf /compile/cluster-restore/cfg* mkdir -p /compile/cluster-restore/cfg1/data/db mkdir -p /compile/cluster-restore/cfg1/log mkdir -p /compile/cluster-restore/cfg2/data/db mkdir -p /compile/cluster-restore/cfg2/log mkdir -p /compile/cluster-restore/cfg3/data/db mkdir -p /compile/cluster-restore/cfg3/log

操作步骤 准备单节点配置文件和数据目录，以单节点方式启动进程。 配置文件如下（restoreconfig/single_40303.yaml）。 net: bindIp: 127.0.0.1 port: 40303 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/cfg1/configsvr.pid} storage: dbPath: /compile/cluster-restore/cfg1/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/cfg1/log/configsingle.log} 准备数据，将解压后的configsvr文件拷贝到单节点dbPath目录下。 cp -aR /compile/download/backups/cac1efc8e65e42ecad8953352321bfeein02_41c8a32fb10245899708dea453a8c5c9no02/* /compile/cluster-restore/cfg1/data/db/ 启动进程。 ./mongod -f restoreconfig/single_40303.yaml 连接单节点，执行配置命令。 连接命令：./mongo --host 127.0.0.1 --port 40303 执行如下命令，修改副本集配置信息。 var cf=db.getSiblingDB('local').system.replset.findOne(); cf['members'][0]['host']='127.0.0.1:40303'; cf['members'][1]['host']='127.0.0.1:40304'; cf['members'][2]['host']='127.0.0.1:40305'; cf['members'][0]['hidden']=false; cf['members'][1]['hidden']=false; cf['members'][2]['hidden']=false; cf['members'][0]['priority']=1; cf['members'][1]['priority']=1; cf['members'][2]['priority']=1; db.getSiblingDB('local').system.replset.remove({}); db.getSiblingDB('local').system.replset.insert(cf) 执行如下命令，清理内置账号。 db.getSiblingDB('admin').dropAllUsers(); db.getSiblingDB('admin').dropAllRoles(); 执行如下命令，更新dds mongos和shard信息。 db.getSiblingDB('config').mongos.remove({}); 先查询config.shards表中的多个shard的_id信息，用于下面语句的_id的查询条件。逐个更新每条记录。 db.getSiblingDB('config').shards.update({'_id' : 'shard_1'},{$set: {'host': 'shard_1/127.0.0.1:40306,127.0.0.1:40307,127.0.0.1:40308'}}) db.getSiblingDB('config').shards.update({'_id' : 'shard_2'},{$set: {'host': 'shard_2/127.0.0.1:40309,127.0.0.1:40310,127.0.0.1:40311'}}) db.getSiblingDB('config').mongos.find({}); db.getSiblingDB('config').shards.find({}); 执行如下命令，关闭单节点进程。 db.getSiblingDB('admin').shutdownServer(); 搭建configsvr副本集。 准备副本集配置文件和目录，将configsvr1节点的dbPath文件拷贝到其他两个节点目录下。 cp -aR /compile/cluster-restore/cfg1/data/db/ /compile/cluster-restore/cfg2/data/db/ cp -aR /compile/cluster-restore/cfg1/data/db/ /compile/cluster-restore/cfg3/data/db/ 修改configsvr-1节点配置文件，增加副本集配置属性（restoreconfig/configsvr_40303.yaml）。 net: bindIp: 127.0.0.1 port: 40303 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/cfg1/configsvr.pid} replication: {replSetName: config} sharding: {archiveMovedChunks: false, clusterRole: configsvr} storage: dbPath: /compile/cluster-restore/cfg1/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/cfg1/log/configsvr.log} 启动进程。 ./mongod -f restoreconfig/configsvr_40303.yaml 修改configsvr-2节点配置文件，增加副本集配置属性（restoreconfig/configsvr_40304.yaml）。 net: bindIp: 127.0.0.1 port: 40304 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/cfg2/configsvr.pid} replication: {replSetName: config} sharding: {archiveMovedChunks: false, clusterRole: configsvr} storage: dbPath: /compile/cluster-restore/cfg2/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/cfg2/log/configsvr.log} 启动进程 ./mongod -f restoreconfig/configsvr_40304.yaml 修改configsvr-3节点配置文件，增加副本集配置属性（restoreconfig/configsvr_40305.yaml）。 net: bindIp: 127.0.0.1 port: 40305 unixDomainSocket: {enabled: false} processManagement: {fork: true, pidFilePath: /compile/cluster-restore/cfg3/configsvr.pid} replication: {replSetName: config} sharding: {archiveMovedChunks: false, clusterRole: configsvr} storage: dbPath: /compile/cluster-restore/cfg3/data/db/ directoryPerDB: true engine: wiredTiger wiredTiger: collectionConfig: {blockCompressor: snappy} engineConfig: {directoryForIndexes: true, journalCompressor: snappy} indexConfig: {prefixCompression: true} systemLog: {destination: file, logAppend: true, logRotate: reopen, path: /compile/cluster-restore/cfg3/log/configsvr.log} 启动进程。 ./mongod -f restoreconfig/configsvr_40305.yaml 等待选主成功。 ./mongo --host 127.0.0.1 --port 40303 执行命令rs.status()，查看是否已存在主节点Primary。

参数模板注意事项 系统提供的默认参数模板不允许修改，只可单击参数模板名称进行查看。如果出现参数设置不合理导致数据库无法启动，可参考默认参数模板重新配置。 对于某些运行参数修改，您需在实例列表中，查看实例状态，如果显示“参数模板变更，等待重启”，则需重启关联的实例使之生效。 在数据库参数模板内设置参数不恰当可能会产生意外的不利影响，包括性能降低和系统不稳定。修改数据库参数时应始终保持谨慎，且修改数据库参数模板前要备份数据。将参数模板更改应用于生产数据库实例前，您应当在测试数据库实例上试用这些参数模板设置更改。

参数模板类型 创建数据库实例时可以指定数据库参数模板为默认参数模板或已有参数模板。实例创建成功后也可以变更实例关联的参数模板。 默认参数模板 默认组包含针对运行的数据库实例进行优化的引擎默认值和数据库服务系统默认值。 自定义参数模板 如果希望数据库实例以客户自定义的引擎配置值运行，可轻松地创建一个新数据库参数模板，修改所需参数并应用到数据库实例，用以使用新数据库参数模板。 数据库参数模板与实例建立关联后，如果修改了参数模板中的参数，那么使用该参数模板的所有实例，都将获得该参数模板中对应参数的更新。

使用须知 开启或关闭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方式连接数据库。

使用须知 文档数据库服务的审计日志功能默认是关闭的，您可以根据业务需要开启审计日志，开启后系统记录读写操作的审计信息。根据业务模型的不同，会造成不同的性能影响，开启后若出现性能瓶颈，需要考虑临时关闭审计日志或者进行规格扩容。 开启审计日志会收取一定费用，收费详情请参见产品价格详情。 文档数据库服务会去检测已生成的审计日志，若审计日志超过用户自定义的保留天数，则将其删除。建议审计日志保存180天以上，用于审计回溯和问题分析等场景。 审计策略修改后，文档数据库服务将按照新的策略执行审计，原审计日志的保留天数以修改后审计策略的保留天数为准。 审计日志不建议删除，如需删除，请先确保审计日志删除后仍然符合您所在地或者企业的安全合规要求，建议删除前下载日志文件在本地备份。审计日志删除后不可恢复，请谨慎操作。 您可以通过文档数据库服务查看、下载和删除DDS实例审计日志，详情请参见通过文档数据库服务查看审计日志；也可以按照日志配置管理配置后，在LTS服务查看DDS实例审计日志的详细信息，包括搜索日志、日志可视化、下载日志和查看实时日志等功能，详情请参见通过 云日志 服务查看审计日志。 审计日志默认每小时生成一次，如果日志大小超过最大限制10MB，则会额外生成新的审计日志。 客户数据需要使用UTF-8编码格式，对于非UTF-8格式数据，对应语句的审计结果可能会有缺失、遗漏或乱码等非预期现象。 文档数据库服务使用的 对象存储服务 上的审计日志文件，对用户不可见，它们只对后台管理系统可见。

事件样例 如下提供了查询副本集状态信息的样例，详细的字段解释可参考事件结构。 { "atype": "query", "ts": { "$date": "2025-02-27T12:35:40.512+0000" }, "local": { "ip": "192.168.30.90", "port": 8635 }, "remote": { "ip": "192.168.26.20", "port": 43818 }, "users": [ { "user": "rwuser", "db": "admin" } ], "roles": [ { "role": "root", "db": "admin" } ], "param": { "command": "query", "ns": "test.a", "args": { "find": "a", "filter": { }, "lsid": { "id": { "$binary": "7kwKmFh9TxGStjtn5Urt2w==", "$type": "04" } }, "$clusterTime": { "clusterTime": { "$timestamp": { "t": 1740659738, "i": 2 } }, "signature": { "hash": { "$binary": "t2eFI3gB9ZruNYf5Y0FIgAZRCr4=", "$type": "00" }, "keyId": { "$numberLong": "7472645695153897501" } } }, "$db": "test" } }, "result": 0 "sessionId": "1641365", "username": "rwuser", "clientname": "MongoDB Shell", "affectRows": "0", "startTime": "1740659740512716", "endTime": "1740659740513937", "docsExamined": "0", "keysExamined": "0", "returnNum": "0", "success": true }

策略语法 给用户组选择策略时，单击策略下方的，可以查看策略的详细内容，以“DDS Administrator”为例，说明RBAC策略的语法。 图2 DDS Administrator策略 { "Version": "1.0", "Statement": [ { "Effect": "Allow", "Action": [ "DDS:DDS:*" ], "Resource": [ "DDS:*:*:instanceName:dds-*" ], } ], "Depends": [ { "catalog": "BASE", "display_name": "Server Administrator" }, { "catalog": "BASE", "display_name": "Tenant Guest" } ] } 表1 参数说明 参数 含义 值 Version 策略的版本 固定为“1.0”。 Statement Action 定义对DDS的具体操作。 格式为：服务名:资源类型:操作 "DDS:DDS:*"，表示对DDS的所有操作，其中DDS为服务名称；“*”为通配符，表示对DDS资源可以执行所有操作。 Effect 定义Action中所包含的具体操作是否允许执行。 Allow：允许执行。 Deny：不允许执行。 Resource 定义资源粒度的鉴权 非必传，“DDS:*:*:instanceName:dds-*”表示对所有dds-开头的实例拥有配置的action权限，如果没有配置，那么默认拥有所有实例的权限 Depends catalog 依赖的策略的所属服务。 服务名称 例如：BASE display_name 依赖的策略的名称。 权限名称 例如：Server Administrator

DDS自定义策略样例 示例1：授权用户创建文档数据库实例 { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "dds:instance:create" ] } ] } 示例2：拒绝用户删除文档数据库实例 拒绝策略需要同时配合其他策略使用，否则没有实际作用。用户被授予的策略中，一个授权项的作用如果同时存在Allow和Deny，则遵循Deny优先原则。 如果您给用户授予DDS FullAccess的系统策略，但不希望用户拥有DDS FullAccess中定义的删除文档数据库实例权限，您可以创建一条拒绝删除文档数据库实例的自定义策略，然后同时将DDS FullAccess和拒绝策略授予用户，根据Deny优先原则，则用户可以对DDS执行除了删除文档数据库实例外的所有操作。拒绝策略示例如下： { "Version": "1.1", "Statement": [ { "Effect": "Deny" "Action": [ "dds:instance:deleteInstance" ], } ] } 示例3：多个授权项策略 一个自定义策略中可以包含多个授权项，且除了可以包含本服务的授权项外，还可以包含其他服务的授权项，可以包含的其他服务必须跟本服务同属性，即都是项目级服务或都是全局级服务。多个授权语句策略描述如下： { "Version": "1.1", "Statement": [ { "Action": [ "dds:instance:create", "dds:instance:modify", "dds:instance:deleteInstance", "vpc:publicIps:list", "vpc:publicIps:update" ], "Effect": "Allow" } ] } 实例4：授权资源策略 一个自定义策略可以设置资源策略，表示在当前的action下面，拥有哪些资源的操作权限，目前支持实例名称的配置，可以用*来表示通配符。授权资源策略的描述如下: { "Version": "1.1", "Statement": [ { "Effect": "Allow", "Action": [ "dds:instance:list" ] }, { "Effect": "Allow", "Action": [ "dds:instance:modify" ], "Resource": [ "DDS:*:*:instanceName:dds-*" ] } ] }

账户密码等级设置 文档数据库服务在控制台侧管理员密码的安全策略： 密码长度为8～32个字符。 密码必须为英文大小写字母、数字、特殊字符~!@#%^*-_=+?()$的组合。 文档数据库对在客户端新创的数据库用户，设置了密码安全策略： 密码长度为8～32个字符。 密码为英文大小写字母、数字、特殊字符~@#%-_!*+=^?的组合。 创建实例数据库以及设置密码时，安全起见，为用户提供了密码复杂度校验，如果不满足要求，请根据提示信息调整密码复杂度。

账户说明 为了给文档数据库实例提供管理服务，您在创建数据库实例时，文档数据库服务会自动为实例创建根账户root（或admin）、监控账户monitor和备份账户backup，这些账户属于华为云实例管理平台，您不能操作或者使用。如果试图删掉、重命名、修改这些账户的密码和权限，会导致出错。 对于数据库管理员账户rwuser，以及您所创建的账户，允许修改账户的密码。 默认账户rwuser以及通过rwuser创建的账户，对系统库admin和config权限受限，无法进行正常操作。对自身创建的库表，具有充分的操作权限。 MongoDB的User一般是在某个固定的认证库下创建的。连接数据库时，需要通过参数--authenticationDatabase来明确指定对应的认证库。 DDS实例中，默认的rwuser用户的认证库，是admin。 账户密码连续5次输入错误，账户会被锁定10s。

创建账户 选择admin数据库。 use admin 以user1账户为例，创建数据库账户。 db.createUser({user: "user1", pwd: "****", passwordDigestor:"server", roles:[{role: "root", db: "admin"}]}) “server”是指在服务端加密密码，为固定值，无需修改。 “****”是新密码，长度8～32位，且必须为英文大小写字母、数字以及特殊字符~@#%-_!*+=^?的组合。 “roles”限制了该账户所具有的权限。若指定一个空数组，表示该账户不具有任何权限。 查看创建结果。 显示如下信息，说明创建成功。 Successfully added user: { "user" : "user1", "passwordDigestor" : "server", "roles" : [ { "role" : "root", "db" : "admin" } ] }

支持的迁移对象范围 在使用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权限。 集群：连接源数据库dds 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"}])

使用须知 mongodump和mongorestore工具仅支持全量数据迁移。为保障数据一致性，迁移操作开始前请停止源数据库的相关业务，并停止数据写入。 建议您尽量选择在业务低峰期迁移数据，避免在迁移过程中对业务造成影响。 不支持迁移系统库admin和local。 mongodump导出文件为BSON二进制文件，mongorestore使用mongodump导出的二进制备份文件将数据还原到实例中。 确保源库中系统库admin和local没有创建业务集合，如果已经有业务集合，必须在迁移前将这些业务集合从admin和local库中迁移出来。 导入数据之前，确保源端有必要的索引，即在迁移前删除不需要的索引，创建好必要的索引。 如果选择迁移分片集群，必须在目标库创建好要分片的集合，并配置数据分片。同时，迁移前必须要创建好索引。 如果使用mongodump工具备份失败（示例：备份进度至97%时报错），建议您尝试增大备份失败虚拟机的磁盘空间，预留部分冗余空间，再重新执行备份。 客户侧使用的是rwuser账号，仅支持操作客户业务库表。所以，在使用时建议指定库和表，仅对业务数据执行导入导出。不指定库表，全量进行导入导出，可能会遇到权限不足的问题。 如果需要恢复备份到本地自建数据库，请参见恢复备份到本地自建数据库。

前提条件 准备弹性云服务器或可访问DDS的设备。 通过内网连接文档数据库实例，需要创建并登录弹性云服务器，请参见购买弹性云服务器和登录弹性云服务器。 通过公网地址连接文档数据库实例，需具备以下条件。 为实例中的节点绑定公网地址，如何绑定公网地址，请参见《文档数据库服务快速入门》通过公网连接实例下“绑定弹性公网IP”的内容。 保证本地设备可以访问文档数据库绑定的公网地址。 在已准备的弹性云服务器或可访问DDS的设备上，安装数据迁移工具。 安装数据迁移工具，请参见安装MongoDB迁移工具。 MongoDB客户端版本须和实例相匹配，若版本不匹配则会有兼容性问题出现。