文档数据库服务 DDS
文档数据库服务 DDS
- 最新动态
- 功能总览
-
服务公告
- 漏洞公告
-
产品公告
- 【通知】2024年11月5日起文档数据库服务DDS5.0版本集群开放公测
- 【通知】2024年10月11日起文档数据库服务DDS副本集5.0版本开始转商计费
- 【通知】华为云文档数据库服务DDS3.4版本计划于2024年10月11日停售
- 【通知】2024年07月24日起文档数据库服务DDS5.0版本开放公测
- 【通知】2023年02月15日起文档数据库服务上线x86架构增强Ⅱ型副本集和集群shard的1:8系列规格
- 【通知】文档数据库服务DDS4.4邀请公测
- 【停售公告】华为云文档数据库服务DDS单节点规格计划于2023年07月15日停售内部通知
- 【通知】2023年10月8日起文档数据库服务DDS4.4版本开始转商计费
- 版本说明
- 产品发布说明
- 产品介绍
- 计费说明
- 快速入门
- 开发指南
-
用户指南
- 购买实例
- 连接实例
- 数据迁移
- 性能调优
- 权限管理
- 实例生命周期管理
- 变更实例
- 数据备份
- 数据恢复
- 参数模板管理
- 连接管理
- 数据库使用
- 数据安全性
- 监控与告警
- 审计
- 日志管理
- 任务中心
- 智能DBA助手
- SQL自动查杀
- 跨可用区容灾
- 标签管理
- 配额管理
- DDS使用规范建议
- 最佳实践
- 安全白皮书
- 性能白皮书
-
API参考
- 使用前必读
- API概览
- 如何调用API
- 快速入门
-
API v3(推荐)
- 查询API版本
- 查询数据库版本信息
- 查询数据库规格
- 查询数据库磁盘类型
-
实例管理
- 创建实例
- 重启实例
- 删除实例
- 查询实例列表和详情
- 扩容实例存储容量
- 扩容集群实例的节点数量
- 变更实例规格
- 切换副本集实例的主备节点
- 切换SSL开关
- 修改实例名称
- 修改实例备注
- 修改数据库端口
- 变更实例安全组
- 绑定弹性公网IP
- 解绑弹性公网IP
- 修改实例内网地址
- 创建集群的Shard/Config IP
- 副本集跨网段访问配置
- 查询实例可迁移到的可用区
- 实例可用区迁移
- 设置实例回收站策略
- 扩容副本集实例的节点数量
- 实例新增只读节点
- 数据库补丁升级
- 开启/关闭秒级监控
- 查询秒级监控配置
- 设置可维护时间段
- 查询实例回收站策略
- 查询回收站实例列表
- 检查弱密码
- 查询数据库补丁升级预估时长
- 查询实例磁盘信息
- 获取SSL证书下载地址
- 查询数据库复制集名称
- 修改数据库复制集名称
- 删除实例的节点
- 删除实例的只读节点
- 查询副本集跨网段访问配置
- 查询LTS日志配置信息
- 关联LTS日志流
- 解除关联LTS日志流
- 设置磁盘自动扩容策略
- 查询磁盘自动扩容策略
- 批量数据库补丁升级
- 连接管理
- 备份与恢复
- 参数配置
- 获取日志信息
- 标签管理
- 管理数据库和用户
- 配额管理
- 数据库运维
- 任务管理
- API v3(即将下线)
- 应用示例
- 权限策略和授权项
- 附录
- SDK参考
- 场景代码示例
- 常见问题
-
故障排除
- 概述
- DDS实例节点故障处理机制
- 连接失败,提示:network error while attempting to run command ‘isMaster’
- 连接失败,提示:No route to host以及connection attempt failed
- 连接失败,提示:Authentication failed
- 连接失败,提示:couldn't connect to server
- 连接失败,提示:cannot list multiple servers in URL without ‘replicaSet’ option
- Java驱动连接实例失败,提示:Timeout while receiving message
- 连接失败,提示:exception: login failed 以及 U_STRINGPREP_PROHIBITED_ERROR
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
通过命令管理时间漫游快照
自2024年9月30日起,4.2、4.4版本的文档数据库实例开始支持时间漫游特性。您可以在指定时间点下发snasphot命令创建一个时间漫游快照,该命令会将当前时刻所有用户库的数据进行快照。创建快照完成后,对于文档数据库的find/getmore操作,您可以指定一个readAt参数,来读取相应时间漫游快照的数据。这个特性的用途有:
- 对历史数据做报表,省去了用户自己按时间分库分表的麻烦;
- 在不影响业务读写的情况下,对数据做Point in Time的备份。
该特性使用户可以在一个数据库实例,甚至同一个表空间上,管理多个历史时态的数据。
使用须知
- 当前只有最新版本的4.2、4.4文档数据库实例支持该能力,如果您的实例版本较低,请参考文档《补丁升级》;
- 时间漫游快照为持久化快照,实例重启后依然保留;
- 对于同一实例您最多可以创建8个时间漫游快照,快照名称支持字符0~9、a~z、A~Z 和 _ ,例如:"Snapshot_2024_09_30_15_18";
- 因为时间漫游快照是针对当前时刻所有用户库的数据快照,因此下发命令的数据库账户至少应该具备{role: "dbAdminAnyDatabase"}权限,创建数据库账户请参考文档《创建用户》;
- 时间漫游快照命令只能在主节点(集群中则为mongos节点)下发,同时会以oplog的形式同步到备节点,所以如果想要有效避免主备倒换可能发生的回滚,那么应该将writeConcern设置为majority来创建、删除时间漫游快照;
- 请确保在时间漫游快照生效期间,不要对相关集合进行元数据变更(包括删除、重命名集合,创建、删除索引等),对于元数据的操作会使得对应集合的快照失效,但其他集合的快照不受影响;
- 读取时间漫游快照过程中请勿删除对应快照;
- 创建时间漫游快照本身并不会占用额外的磁盘空间,但这个动作会使得快照相关的数据不参与存储引擎的compact,因此在创建时间漫游快照后如果有新的写入动作,请及时关注实例的磁盘占用情况。存储引擎相关说明请参考文档《DDS 4.2及其以上版本切RocksDB存储引擎相关问题Q&A》;
- 因为时间漫游快照的相关数据不参与存储引擎compact,因此如果创建较多时间漫游快照,那么会对实例的写入性能造成5~10%左右的影响;
- 在集群实例上使用时间漫游快照时,需关闭均衡器Balancer,管理均衡器请参考文档《如何管理均衡器Balancer》。
前提条件
成功连接文档数据库实例,详情请参见《连接实例》通过内网和公网连接实例。
创建时间漫游快照
- 在dds副本集的主节点,或者dds集群的mongos节点命令行中,切换至用户库。
use test //可以是任意用户库,不影响最终快照结果
- 执行如下命令,创建时间漫游快照。
db.runCommand({snapshot: 1, op: "create", name: "s1"}) //创建名为s1的时间漫游快照 db.runCommand({snapshot: 1, op: "create"}) //如果未指定name参数,那么默认使用stable作为快照名称
查看时间漫游快照
- 在dds副本集的主节点,或者dds集群的mongos节点命令行中,切换至用户库。
use test //可以是任意用户库,不影响最终命令结果
- 执行如下命令,查看当前时间漫游快照。
db.runCommand({snapshot: 1, op: "list"}) // {snapshot: 1, op: "list"} // {snapshot: 1, op: "list"} 执行结果 { "snapshotList" : [ "s1", "stable" ], "ok" : 1, "operationTime" : Timestamp(1727683917, 1), "$clusterTime" : { "clusterTime" : Timestamp(1727683917, 1), "signature" : { "hash" : BinData(0,"AAAAAAAAAAAAAAAAAAAAAAAAAAA="), "keyId" : NumberLong(0) } } }
删除时间漫游快照
- 在dds副本集的主节点,或者dds集群的mongos节点命令行中,切换至用户库。
use test //可以是任意用户库,不影响最终命令结果
- 执行如下命令,删除已有时间漫游快照。
db.runCommand({snapshot:1, op:"delete", name:"s1"}) //删除名为s1的时间漫游快照 db.runCommand({snapshot:1, op:"delete"}) //如果未指定name参数,默认删除名为stable的时间漫游快照 db.runCommand({snapshot:1, op:"delete", name:"*"}) //指定name参数为*,删除所有时间漫游快照
find/getMore方式读取时间漫游快照
- 进入dds副本集主节点,或者dds集群mongos节点的命令行界面;
- 通过find命令读取时间漫游快照(注:因为需要指定readAt参数,find命令需要以runCommand形式下发,详细请参见find。
PRIMARY> use test PRIMARY> db.foo.insert({a:1, c:1}) PRIMARY> db.foo.insert({a:2, c:2}) //创建名为s1的时间漫游快照 PRIMARY> db.runCommand({snapshot:1, op:"create", name:"s1"}) //创建快照后修改文档{a:1, c:1}->{a:1, c:3} PRIMARY> db.foo.update({a:1}, {$set:{c:3}}) //在名称为s1的时间漫游快照上,执行find命令查询满足条件{a:1}的文档 PRIMARY> db.runCommand({find:"foo", filter:{a:1}, readAt:"s1"}) { "cursor" : { "firstBatch" : [ { "_id" : ObjectId("5dd75662b9c50d4bdca52721"), "a" : 1, "c" : 1 }, ], "id" : NumberLong(0), "ns" : "test.foo" }, "ok" : 1 }
在find命令中,指定readAt : s1,表示从s1这个快照中读取数据,指定filter: {a:1},表示过滤所有满足a=1的文档。如上所示,在s1快照创建之后,我们更新 {a:1, c:1}->{a:1, c:3}的这个操作是不会影响快照数据的。
- 通过getMore命令读取时间漫游快照(getMore命令格式请参见getMore)。
PRIMARY> use test PRIMARY> db.foo.insert({a:1, c:1}) PRIMARY> db.foo.insert({a:2, c:2}) //创建名为s1的时间漫游快照 PRIMARY> db.runCommand({snapshot:1, op:"create", name:"s1"}) //创建快照后修改文档{a:1, c:1}->{a:1, c:3} PRIMARY> db.foo.update({a:1}, {$set:{c:3}}) //在名称为s1的时间漫游快照上,执行find命令查询所有a<=2的文档,并将batchSize设为0 PRIMARY> db.runCommand({getMore: NumberLong("47677869455"), collection:"foo"}) { "cursor" : { "nextBatch" : [ { "_id" : ObjectId("5dd75662b9c50d4bdca52721"), "a" : 1, "c" : 1 }, { "_id" : ObjectId("5dd75687b9c50d4bdca52723"), "a" : 2, "c" : 2 } ], "id" : NumberLong(0), "ns" : "test.foo" }, "ok" : 1 }
在getmore命令中,通过指定find命令的readAt : s1,表示从s1这个快照中读取数据,指定filter: {a: {$lte: 2}},表示过滤所有满足a<=2的文档。如上所示,在s1快照创建之后,我们更新 {a:1, c:1}->{a:1, c:3}的这个操作是不会影响快照数据的。
父主题: 数据库使用