- 最新动态
- 功能总览
-
服务公告
- 漏洞公告
-
产品公告
- 【通知】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
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
避免hideIndex导致游标失效
失效场景
在 DDS 中,某些索引操作可能导致游标失效,DDS这些行为和社区版MongoDB行为一致。以下是几个常见的例子及其解释:
hideIndex导致游标失效
原因:
hideIndex操作改变了索引的元数据,从而使现有游标失效。
示例代码:
(function() { "use strict"; let collName = "test_coll"; let coll = db.getCollection(collName); coll.drop(); // 创建索引,并插入数据, coll.createIndex({x: 1}, {background: false}); for (var i = 0; i < 1000; ++i) { coll.insert({x: i}); } // 获取游标 let cursor = coll.find({x: {$gte: 1}}); // 使用游标,但是游标并没有使用完 for (var i = 0; i < 101; ++i) { let doc = cursor.next(); print(tojson(doc)); } // 在游标使用完之前隐藏索引 coll.hideIndex("x_1"); // 遍历游标 cursor.forEach((doc) => { // 游标会报错: // "errmsg" : "definition of index 'x_1' changed" // "codeName" : "QueryPlanKilled" print(tojson(doc)); }); })();
结果:
游标失效,可能抛出错误。
2024-12-24T16:26:42.445+0800 E QUERY [js] Error: getMore command failed: { "ok" : 0, "errmsg" : "definition of index 'x_1' changed", "code" : 175, "codeName" : "QueryPlanKilled" } :
dropIndex 导致游标失效
原因:
删除索引后,DDS需要重新计算查询计划,从而使现有游标失效。
示例代码:
(function() { "use strict"; let collName = "test_coll"; let coll = db.getCollection(collName); coll.drop(); // 创建索引,并插入数据, coll.createIndex({x: 1}, {background: false}); for (var i = 0; i < 1000; ++i) { coll.insert({x: i}); } // 获取游标 let cursor = coll.find({x: {$gte: 1}}); // 使用游标,但是游标并没有使用完 for (var i = 0; i < 101; ++i) { let doc = cursor.next(); print(tojson(doc)); } // 在游标使用完之前删除索引 coll.dropIndex("x_1"); // 遍历游标 cursor.forEach((doc) => { // 游标会报错: // "errmsg" : "index 'x_1' dropped", // "codeName" : "QueryPlanKilled" print(tojson(doc)); }); })();
结果:
游标失效,因为删除索引会导致查询计划需要重新计算。
2024-12-25T10:34:29.948+0800 E QUERY [js] Error: getMore command failed: { "ok" : 0, "errmsg" : "index 'x_1' dropped", "code" : 175, "codeName" : "QueryPlanKilled" }
renameCollection导致游标失效
原因:
修改集合结构renameCollection也会导致游标失效。
示例代码:
(function() { "use strict"; let collName = "test_coll"; let coll = db.getCollection(collName); coll.drop(); // 创建索引,并插入数据, coll.createIndex({x: 1}, {background: false}); for (var i = 0; i < 1000; ++i) { coll.insert({x: i}); } // 获取游标 let cursor = coll.find({x: {$gte: 1}}); // 使用游标,但是游标并没有使用完 for (var i = 0; i < 101; ++i) { let doc = cursor.next(); print(tojson(doc)); } // 在游标使用完之前重命名集合 coll.renameCollection("test_coll_reaname"); // 遍历游标 cursor.forEach((doc) => { // 游标会报错: // "errmsg" : "collection dropped between getMore calls", // "codeName" : "OperationFailed" print(tojson(doc)); }); })();
结果:
游标失效,因为集合的名称改变,游标失去了上下文。
2024-12-25T10:39:28.624+0800 E QUERY [js] Error: getMore command failed: { "ok" : 0, "errmsg" : "collection dropped between getMore calls", "code" : 96, "codeName" : "OperationFailed" } :
dropCollection导致游标失效
原因:
删除集合游标失去了上下文,会导致游标失效。
示例代码:
(function() { "use strict"; let collName = "test_coll"; let coll = db.getCollection(collName); coll.drop(); // 创建索引,并插入数据, coll.createIndex({x: 1}, {background: false}); for (var i = 0; i < 1000; ++i) { coll.insert({x: i}); } // 获取游标 let cursor = coll.find({x: {$gte: 1}}); // 使用游标,但是游标并没有使用完 for (var i = 0; i < 101; ++i) { let doc = cursor.next(); print(tojson(doc)); } // 在游标使用完之前删除集合 coll.drop(); // 遍历游标 cursor.forEach((doc) => { // 游标会报错: // "errmsg" : "collection dropped between getMore calls", // "codeName" : "OperationFailed" print(tojson(doc)); }); })();
结果:
游标失效,因为集合已经被删除,游标失去了上下文。
2024-12-25T10:40:33.737+0800 E QUERY [js] Error: getMore command failed: { "ok" : 0, "errmsg" : "collection dropped between getMore calls", "code" : 96, "codeName" : "OperationFailed" } :
解决方法
- 在索引操作之前处理游标: 确保在 hideIndex 或 dropIndex 之前使用完游标。
- 重新获取游标: 如果索引发生变化,重新执行查询以获取新的游标。
- 提前计划: 避免在长时间查询中执行索引操作。
示例代码:
(function() { "use strict"; let collName = "test_coll"; let coll = db.getCollection(collName); coll.drop(); // 创建索引,并插入数据, coll.createIndex({x: 1}, {background: false}); for (var i = 0; i < 1000; ++i) { coll.insert({x: i}); } // 获取游标 let cursor = coll.find({x: {$gte: 1}}); // 使用游标,但是游标并没有使用完 for (var i = 0; i < 101; ++i) { let doc = cursor.next(); print(tojson(doc)); } // 在游标使用完之前隐藏索引 coll.hideIndex("x_1"); // 遍历游标 // cursor.forEach((doc) => { // 游标会报错: // "errmsg" : "definition of index 'x_1' changed" // "codeName" : "QueryPlanKilled" // print(tojson(doc)); // }); // 重新获取游标 cursor = coll.find({x: {$gte: 1}}); cursor.forEach((doc) => { print(tojson(doc)); }); })();