活动

天翼云最新优惠活动,涵盖免费试用,产品折扣等,助您降本增效!
热门活动
  • 618智算钜惠季 爆款云主机2核4G限时秒杀,88元/年起!
  • 免费体验DeepSeek,上天翼云息壤 NEW 新老用户均可免费体验2500万Tokens,限时两周
  • 云上钜惠 HOT 爆款云主机全场特惠,更有万元锦鲤券等你来领!
  • 算力套餐 HOT 让算力触手可及
  • 天翼云脑AOne NEW 连接、保护、办公,All-in-One!
  • 中小企业应用上云专场 产品组合下单即享折上9折起,助力企业快速上云
  • 息壤高校钜惠活动 NEW 天翼云息壤杯高校AI大赛,数款产品享受线上订购超值特惠
  • 天翼云电脑专场 HOT 移动办公新选择,爆款4核8G畅享1年3.5折起,快来抢购!
  • 天翼云奖励推广计划 加入成为云推官,推荐新用户注册下单得现金奖励
免费活动
  • 免费试用中心 HOT 多款云产品免费试用,快来开启云上之旅
  • 天翼云用户体验官 NEW 您的洞察,重塑科技边界

智算服务

打造统一的产品能力,实现算网调度、训练推理、技术架构、资源管理一体化智算服务
智算云(DeepSeek专区)
科研助手
  • 算力商城
  • 应用商城
  • 开发机
  • 并行计算
算力互联调度平台
  • 应用市场
  • 算力市场
  • 算力调度推荐
一站式智算服务平台
  • 模型广场
  • 体验中心
  • 服务接入
智算一体机
  • 智算一体机
大模型
  • DeepSeek-R1-昇腾版(671B)
  • DeepSeek-R1-英伟达版(671B)
  • DeepSeek-V3-昇腾版(671B)
  • DeepSeek-R1-Distill-Llama-70B
  • DeepSeek-R1-Distill-Qwen-32B
  • Qwen2-72B-Instruct
  • StableDiffusion-V2.1
  • TeleChat-12B

应用商城

天翼云精选行业优秀合作伙伴及千余款商品,提供一站式云上应用服务
进入甄选商城进入云市场创新解决方案
办公协同
  • WPS云文档
  • 安全邮箱
  • EMM手机管家
  • 智能商业平台
财务管理
  • 工资条
  • 税务风控云
企业应用
  • 翼信息化运维服务
  • 翼视频云归档解决方案
工业能源
  • 智慧工厂_生产流程管理解决方案
  • 智慧工地
建站工具
  • SSL证书
  • 新域名服务
网络工具
  • 翼云加速
灾备迁移
  • 云管家2.0
  • 翼备份
资源管理
  • 全栈混合云敏捷版(软件)
  • 全栈混合云敏捷版(一体机)
行业应用
  • 翼电子教室
  • 翼智慧显示一体化解决方案

合作伙伴

天翼云携手合作伙伴,共创云上生态,合作共赢
天翼云生态合作中心
  • 天翼云生态合作中心
天翼云渠道合作伙伴
  • 天翼云代理渠道合作伙伴
天翼云服务合作伙伴
  • 天翼云集成商交付能力认证
天翼云应用合作伙伴
  • 天翼云云市场合作伙伴
  • 天翼云甄选商城合作伙伴
天翼云技术合作伙伴
  • 天翼云OpenAPI中心
  • 天翼云EasyCoding平台
天翼云培训认证
  • 天翼云学堂
  • 天翼云市场商学院
天翼云合作计划
  • 云汇计划
天翼云东升计划
  • 适配中心
  • 东升计划
  • 适配互认证

开发者

开发者相关功能入口汇聚
技术社区
  • 专栏文章
  • 互动问答
  • 技术视频
资源与工具
  • OpenAPI中心
开放能力
  • EasyCoding敏捷开发平台
培训与认证
  • 天翼云学堂
  • 天翼云认证
魔乐社区
  • 魔乐社区

支持与服务

为您提供全方位支持与服务,全流程技术保障,助您轻松上云,安全无忧
文档与工具
  • 文档中心
  • 新手上云
  • 自助服务
  • OpenAPI中心
定价
  • 价格计算器
  • 定价策略
基础服务
  • 售前咨询
  • 在线支持
  • 在线支持
  • 工单服务
  • 建议与反馈
  • 用户体验官
  • 服务保障
  • 客户公告
  • 会员中心
增值服务
  • 红心服务
  • 首保服务
  • 客户支持计划
  • 专家技术服务
  • 备案管家

了解天翼云

天翼云秉承央企使命,致力于成为数字经济主力军,投身科技强国伟大事业,为用户提供安全、普惠云服务
品牌介绍
  • 关于天翼云
  • 智算云
  • 天翼云4.0
  • 新闻资讯
  • 天翼云APP
基础设施
  • 全球基础设施
  • 信任中心
最佳实践
  • 精选案例
  • 超级探访
  • 云杂志
  • 分析师和白皮书
  • 天翼云·创新直播间
市场活动
  • 2025智能云生态大会
  • 2024智算云生态大会
  • 2023云生态大会
  • 2022云生态大会
  • 天翼云中国行
天翼云
  • 活动
  • 智算服务
  • 产品
  • 解决方案
  • 应用商城
  • 合作伙伴
  • 开发者
  • 支持与服务
  • 了解天翼云
      • 文档
      • 控制中心
      • 备案
      • 管理中心
      文档中心

      文档数据库服务

      文档数据库服务

        • 产品公告
        • 【下线】2025年5月30日起文档数据库服务关闭对象存储备份类型
        • 【下线】2025年5月30日起文档数据库服务陆续下线II 类型资源池实例订购入口
        • 产品动态
        • 产品介绍
        • 产品定义
        • 资源池及功能概览
        • 产品架构
        • 单节点系统架构
        • 副本集系统架构
        • 集群系统架构
        • 产品优势
        • 轻松易用
        • 高可用
        • 高可靠
        • 高安全
        • 功能特性
        • 应用场景
        • 实例说明
        • 数据库实例规格
        • 数据库引擎和版本
        • 只读节点简介
        • 基本概念
        • 与其它云服务的关系
        • 文档数据库服务与自建数据库的对比优势
        • 计费说明
        • 产品资费
        • 单节点实例
        • 副本集实例
        • 集群版实例
        • 只读从节点
        • 存储空间
        • 备份空间
        • 计费模式
        • 产品实例续费
        • 产品实例退订
        • 按需计费实例转包周期计费
        • 包周期计费实例转按需计费
        • 快速入门
        • 入门概述
        • 新建文档数据库服务实例
        • 连接文档数据库服务实例
        • 实例连接方式介绍
        • 内网连接实例
        • 设置安全组和白名单
        • 内网通过Mongo Shell连接实例
        • 内网通过Mongo Shell连接副本集实例只读节点
        • 公网连接实例
        • 绑定与解绑弹性公网IP
        • 设置安全组和白名单
        • 公网通过Mongo Shell连接实例
        • 通过程序代码连接实例
        • 从零到使用文档数据库服务步骤指引
        • 用户指南
        • 登录文档数据库服务
        • 实例管理
        • 创建实例
        • 退订实例
        • 重启实例
        • 实例配置变更
        • 配置参数变更
        • 数据库账号管理
        • 主子账号和IAM权限管理
        • 企业项目迁移
        • 修改实例名称
        • 升级内核补丁版本
        • 实例回收站
        • 实例变更
        • 实例磁盘扩容
        • 扩容集群实例的磁盘空间
        • 扩容副本集实例的磁盘空间
        • 扩容单节点实例的磁盘空间
        • 实例规格变更
        • 变更集群实例的CPU和内存规格
        • 变更副本集实例的CPU和内存规格
        • 变更单节点实例的CPU和内存规格
        • 分片集群实例添加节点
        • 添加集群实例节点
        • 扩容集群只读节点
        • 副本集实例添加节点
        • 添加副本集实例节点
        • 扩容副本集只读节点
        • 存储空间自动扩容
        • 实例的主备切换
        • 副本集主备切换
        • 分片集群主备切换
        • 设置可维护时间段
        • 开启或关闭实例释放保护
        • 备份管理
        • 数据备份方案
        • 自动备份
        • 跨区域备份
        • 手动备份
        • 增量备份
        • 下载备份
        • 查看备份结果
        • 导出备份列表
        • 删除备份
        • 恢复管理
        • 恢复方案
        • 恢复单机版实例备份
        • 恢复副本集实例备份
        • 恢复集群版实例备份
        • 查看恢复记录
        • 参数组管理
        • 什么是参数模板
        • 创建参数模板
        • 修改参数模板
        • 比较参数模板
        • 复制参数模板
        • 应用参数模板
        • 查看应用记录
        • 删除参数模板
        • 导出参数
        • 监控管理
        • 查看监控信息
        • 监控项说明
        • 告警配置
        • 告警模板
        • 告警历史
        • 事件管理
        • 计划内事件
        • 历史事件
        • 日志管理
        • 查看错误日志信息
        • 查看慢日志信息
        • 查看运行日志信息
        • 日志配置管理
        • 审计
        • 云审计
        • 账号管理
        • 创建普通账户
        • 修改普通账号权限
        • 重置账号密码
        • 删除普通账号
        • 标签管理
        • 创建标签
        • 给实例绑定标签
        • 使用标签筛选实例
        • 给实例解绑标签
        • 删除标签
        • 任务列表
        • 实例生命周期管理
        • 实例状态
        • 导出实例列表
        • 重启实例或节点
        • 删除按需实例
        • 数据库管理
        • 修改实例端口
        • 创建实例账号
        • 创建数据库
        • 磁盘加密
        • IPv6使用
        • SSL管理
        • 重置管理员用户密码
        • 编辑安全组
        • 支持与不支持的命令
        • 数据迁移
        • 迁移方案概览
        • 通过mongodump和mongorestore工具迁移数据
        • 通过DTS工具迁移DDS/MongoDB数据
        • 跨可用区容灾
        • 开通跨可用区副本集实例
        • 开通跨可用区集群实例
        • 性能调优
        • 调整参数以优化性能
        • 提升数据库的读写性能
        • 排查实例CPU使用率高问题
        • 排查磁盘使用率高问题
        • 排查内存使用率高问题
        • 排查集群实例负载不均衡问题
        • 定位慢请求的方法
        • 优化数据库查询语句的方法
        • 利用数据分片来提升性能
        • 数据库工具
        • 通过DMS登录DDS实例
        • 通过DMS打开DDS审计日志
        • 白名单管理
        • 添加白名单分组
        • 修改白名单分组
        • 删除白名单分组
        • 文档数据库服务使用建议
        • 文档数据库服务设计规范建议
        • 文档数据库服务开发建议
        • API参考
        • API使用说明
        • 最佳实践
        • 概述
        • 通过数据分片提升服务性能
        • 如何通过SQL优化来提升实例性能
        • 不要使用系统库存放业务数据
        • 常见的数据导入导出方法
        • 通过读写分离提升性能
        • 合理配置写入参数来提升数据安全
        • 连接文档数据库的方法
        • 合理分配用户权限,保证数据库安全
        • 开发指南
        • 文档数据库服务使用规范
        • 文档数据库服务基础命令规范
        • 查询命令
        • 写入/更新命令
        • 删除命令
        • 文档数据库服务开发规范
        • 文档数据库服务设计规范
        • 数据库使用
        • 如何连接数据库
        • 如何创建和管理数据库
        • 如何创建和管理集合
        • 如何创建和管理索引
        • 应用程序开发
        • 开发流程
        • 基于Java开发
        • 驱动包和运行环境
        • 基于Java连接数据库
        • 基于Java访问数据库
        • 基于Java开发完整示例
        • 基于Python开发
        • 环境依赖
        • 基于python连接数据库
        • 基于python访问数据库
        • 基于python开发完整示例
        • 数据库权限管理
        • 默认权限机制
        • 角色管理
        • 预置角色
        • 自定义角色
        • 管理角色
        • 用户管理
        • 创建用户
        • 更新用户
        • 删除用户
        • 系统集合
        • 常用操作
        • CRUD操作
        • 常见问题
        • 计费类
        • 数据库存储
        • 购买类
        • 扩容及规格变更
        • 资源冻结/释放/删除/退订
        • 创建与删除
        • 操作类
        • 数据库版本
        • 资源及磁盘管理
        • 数据库性能
        • 数据库权限
        • 数据库连接
        • 无法建立与文档数据库服务的连接
        • 如何应对因实例连接数达到最大限制而引发的连接失败问题
        • 如何检索当前连接数量并对其进行控制
        • 在ECS和文档数据库分别安置于互不连通的VPC环境中时,如何处理
        • 应用程序是否需要支持自动重连数据库
        • 如何创建并登录弹性云主机
        • 客户端安装
        • 数据库基本使用
        • 数据库迁移
        • 数据库参数
        • 备份与恢复
        • 网络安全
        • 监控和告警
        • 咨询类
        • 产品咨询
        • 故障排除
        • 概述
        • 实例节点故障处理
        • 连接报错:认证失败
        • 连接报错:连接失败或服务不可达
        • 访问实例报错:不是主节点
        • 连接报错:URL无副本集配置
        • 连接报错:Timeout
        • 性能白皮书
        • 概述
        • 测试方法
        • 副本集测试数据
        • 分片集群测试数据
        • 安全白皮书
        • 安全白皮书总览
        • 文档下载
        • 操作手册
        • 相关协议
        • 文档数据库服务等级协议
        • 天翼云文档数据库服务协议
        • 服务授权
          无相关产品

          本页目录

          帮助中心文档数据库服务开发指南文档数据库服务使用规范文档数据库服务开发规范
          文档数据库服务开发规范
          更新时间 2023-08-29 15:14:28
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          最近更新时间: 2023-08-29 15:14:28
          分享文章
          • 新浪微博
          • 微信
            扫码分享
          • 复制链接
          本页介绍了文档数据库服务开发相关规范。

          数据库连接

          在使用文档数据库服务进行应用程序开发时,为了保证数据库连接的安全性和可靠性,需要遵守一些数据库连接规范。以下是一些常用的文档数据库服务连接规范:

          • 使用URI进行连接:文档数据库服务支持使用URI(Uniform Resource Identifier)格式的连接字符串进行连接,这种格式可以简化连接参数的设置,例如:
          mongodb://username:password@hostname:port/database
          

          其中,username 和 password 是登录数据库的用户名和密码,hostname 和 port 是文档数据库服务的服务器的地址和端口号,database 是要连接的数据库名称。

          • 使用连接池:为了提高连接的效率和性能,可以使用连接池技术对文档数据库服务连接进行管理。连接池可以缓存连接对象,并在需要时重复利用,避免频繁创建和销毁连接对象。客户端连接数据库的时候,要计算业务一共有多少个客户端,每个客户端配置的连接池大小是多少,总的连接数不要超过当前实例能承受的最大连接数的80%。
          • 不要使用过期的连接:文档数据库服务连接对象具有一定的生命周期,在使用完毕后应该及时关闭连接,避免占用过多的系统资源。同时,不要使用已经过期的连接对象,应该重新创建一个新的连接对象进行操作。
          • 设置合适的超时时间:在连接文档数据库服务时,应该设置合适的超时时间,避免连接过程中出现异常或超时而导致应用程序出现问题。可以设置连接超时、读取超时、写入超时等不同类型的超时时间。
          • 避免使用过多的连接:在应用程序中,应该避免使用过多的文档数据库服务连接,以免占用过多的系统资源。可以通过使用连接池、设置连接超时等方式来优化连接的使用。
          • 使用SSL/TLS进行加密:为了提高数据库连接的安全性,可以使用SSL/TLS等加密协议对文档数据库服务连接进行加密传输,避免数据被窃取或篡改。

          可靠性

          在使用文档数据库服务时,为了保证数据的可靠性和一致性,需要遵守一些规范和最佳实践。以下是一些常见的文档数据库服务可靠性规范:

          • 使用副本集:文档数据库服务的副本集是一组自动同步的文档数据库实例,提供了数据冗余和高可用性。可以使用副本集来保证数据的可靠性和恢复性。

          • 设置write concern:文档数据库服务的write concern用于指定写入操作的确认级别,即写入数据后需要多少个文档数据库服务实例确认才算成功。对于关键业务,write concern设置为{w:n},n>0,数字越大,一致性实现更好,但性能较差 。可以根据业务需求设置不同的write concern级别,例如:

            • w: 0 表示写入操作不需要确认,不会等待文档数据库服务实例的响应.
            • w: 1 表示写入操作需要至少一个文档数据库服务实例确认,等待一个文档数据库服务实例的响应;
            • w: majority 表示写入操作需要大多数文档数据库服务实例确认,等待大多数文档数据库服务实例的响应;
            • w: n 表示写入操作需要n个文档数据库服务实例确认,等待n个文档数据库服务实例的响应。
          • 使用事务:文档数据库服务4.0及以上版本支持事务,可以使用事务来保证数据的一致性和可靠性。可以使用事务来确保多个操作的原子性,例如同时写入多个文档或修改多个文档。

          • 使用正确的索引:正确使用索引可以提高文档数据库服务查询的效率和性能,并减少数据错误和丢失的风险。

          • 备份和恢复数据:定期备份文档数据库服务数据可以保证数据的可靠性和恢复性,可以使用mongodump和mongorestore命令来备份和恢复数据。

          性能相关

          规范

          在使用文档数据库服务时,为了提高数据库系统的性能和效率,需要遵守一些性能相关规范和最佳实践。以下是一些常见的文档数据库服务性能相关规范:

          • 合适的索引设计:正确的索引设计可以提高文档数据库服务的查询性能和效率,可以根据应用程序的查询需求来选择适当的索引类型和字段。
          • 使用合适的数据模型:文档数据库服务是一种文档型数据库,可以使用嵌入式文档或引用式文档来存储数据。使用合适的数据模型可以提高查询效率和数据访问的速度。
          • 避免全表扫描:文档数据库服务在执行查询时,应该避免全表扫描,尽量使用索引来加速查询。可以使用explain命令来分析查询的性能和索引的使用情况。
          • 分布式扩展:文档数据库服务支持分布式扩展,可以使用分片技术将数据分散到多个文档数据库服务实例中,提高系统的吞吐量和性能。
          • 使用合适的数据类型:文档数据库服务支持多种数据类型,应该根据应用程序的需求来选择合适的数据类型。例如,可以使用二进制数据类型来存储大型文件,使用数组来存储具有相同属性的数据。
          • 使用合适的查询语句:在查询文档数据库服务数据库时,应该使用合适的查询语句和操作符,避免使用不必要的查询条件和操作符,以提高查询效率和性能。
          • 开发过程中对集合的每一个操作都要通过执行explain()检查其执行计划,如:
          db.students.find({age: 20}, {name: 1, _id: 0}).explain();
          
          • 合理的系统配置:为了提高文档数据库服务的性能和效率,应该合理配置文档数据库服务的系统参数和资源限制,例如内存、磁盘和CPU等。

          执行计划查看

          在文档数据库服务中,可以使用explain()方法来查看查询执行计划,了解查询语句的性能和索引使用情况。执行explain()方法后,文档数据库服务会返回一个文档,其中包含了查询执行的详细信息。

          以下是在文档数据库服务中查看执行计划的步骤:

          1. 执行查询语句:首先需要执行要查看执行计划的查询语句,例如:
          db.collection.find({field: "value"})
          
          1. 执行explain()方法:在查询语句之后加上explain()方法,例如:
          db.collection.find({field: "value"}).explain()
          
          1. 查看执行计划:执行explain()方法后,文档数据库服务会返回一个文档,其中包含了查询执行的详细信息。可以查看文档中的queryPlanner字段、executionStats字段和serverInfo字段,了解查询的执行计划、查询的性能和索引使用情况等信息。例如:
          {
              "queryPlanner" : {...},
              "executionStats" : {...},
              "serverInfo" : {...}
          }
          

          在执行计划文档中,常见的字段和属性包括:

          • queryPlanner: 查询计划器,表示文档数据库服务是如何执行查询的。
          • executionStats: 执行统计,表示查询的执行情况和性能。
          • winningPlan: 最优查询计划,表示文档数据库服务选择的最优查询计划。
          • rejectedPlans: 拒绝的查询计划,表示文档数据库服务拒绝的查询计划。
          • totalKeysExamined: 索引扫描的次数,表示查询过程中扫描的索引数量。
          • totalDocsExamined: 文档扫描的次数,表示查询过程中扫描的文档数量。
          • executionTimeMillis: 查询的执行时间,表示查询完成所需的时间。

          执行计划解析:

          • 看执行时间:executionStats.executionStages.executionTimeMillisEstimate和executionStats.executionStages.inputStage. executionTimeMillisEstimate时间越短越好。

            • executionStats.executionTimeMillis表示执行计划选择和执行的所有时间。
            • executionStats.executionStages.executionTimeMillisEstimate表示最优执行计划的执行完成时间。
            • executionStats.executionStages.inputStage. executionTimeMillisEstimate表示最优执行计划下的子阶段执行完成时间。
          • 看扫描条数:三个条目数相同为最佳。

            • executionStats. nReturned表示匹配查询条件的文档数。
            • executionStats .totalKeysExamined表示索引扫描条目数。
            • executionStats .totalDocsExamined表示文档扫描条目数。
          • 看Stage状态,性能较好的Stage状态组合如下。

            • Fetch+IDHACK
            • Fetch+ixscan
            • Limit+(Fetch+ixscan)
            • PROJECTION+ixscan

            状态说明:

            状态名称 状态名称
            COLLSCAN 全表扫描
            SORT 内存中进行排序
            IDHACK 根据_id进行查询
            TEXT 全文索引
            FETCH 索引扫描
            LIMIT 使用Limit限制返回数
            SUBPLA 未用索引的$or查询阶段
            PROJECTION 未用索引的$or查询阶段
            COUNT_SCAN 使用索引计数

          Cursor使用规则

          在文档数据库服务中,查询操作返回的结果是一个游标(Cursor),游标可以用来遍历查询结果集,可以通过Cursor对象进行一些操作。以下是一些常见的文档数据库 服务Cursor使用规则:

          • 显式关闭游标:当使用游标查询文档数据库服务的数据库时,应该显式地关闭游标对象,以释放游标占用的资源。可以使用close()方法来关闭游标对象,例如:
          cursor = db.collection.find()
          # 遍历游标
          for doc in cursor:
              print(doc)
          # 关闭游标
          cursor.close()
          
          • 使用迭代器遍历游标:可以通过Cursor对象的迭代器来遍历游标,避免一次性加载所有查询结果并占用过多的系统资源。例如:
          cursor = db.collection.find()
          # 使用迭代器遍历游标
          for doc in cursor:
              print(doc)
          
          • 限制查询结果:可以使用limit()方法来限制查询结果的数量,避免查询结果集过大而占用过多的系统资源。例如:
          cursor = db.collection.find().limit(10)
          # 遍历游标
          for doc in cursor:
              print(doc)
          
          • 跳过查询结果:可以使用skip()方法来跳过查询结果的前几条记录,以便查询后面的记录。例如:
          cursor = db.collection.find().skip(10)
          # 遍历游标
          for doc in cursor:
              print(doc)
          
          • 排序查询结果:可以使用sort()方法来对查询结果进行排序,以便按照指定的顺序返回查询结果。例如:
          cursor = db.collection.find().sort("field", 1)
          # 遍历游标
          for doc in cursor:
              print(doc)
          

          总之,在使用文档数据库服务Cursor时,需要遵守一些规则和最佳实践,以提高查询性能和效率,避免占用过多的系统资源。

          文档反馈

          建议您登录后反馈,可在建议与反馈里查看问题处理进度

          鼠标选中文档,精准反馈问题

          选中存在疑惑的内容,即可快速反馈问题,我们会跟进处理

          知道了

          上一篇 :  删除命令
          下一篇 :  文档数据库服务设计规范
          搜索 关闭
          ©2025 天翼云科技有限公司版权所有 增值电信业务经营许可证A2.B1.B2-20090001
          公司地址:北京市东城区青龙胡同甲1号、3号2幢2层205-32室
          备案 京公网安备11010802043424号 京ICP备 2021034386号
          ©2025天翼云科技有限公司版权所有
          京ICP备 2021034386号
          备案 京公网安备11010802043424号
          增值电信业务经营许可证A2.B1.B2-20090001
          用户协议 隐私政策 法律声明