文档数据库服务 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
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
连接数据库
前提条件
连接代码
- SSL开启
// 构建认证凭证 // 认证用的用户名和密码直接写到代码中有很大的安全风险,建议在配置文件或者环境变量中存放(密码应密文存放、使用时解密),确保安全; // 本示例以用户名和密码保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量(环境变量名称请根据自身情况进行设置)EXAMPLE_USERNAME_ENV和EXAMPLE_PASSWORD_ENV。 username = System.getenv("EXAMPLE_USERNAME_ENV") password = System.getenv("EXAMPLE_PASSWORD_ENV") credential := options.Credential{ AuthMechanism: "SCRAM-SHA-1", AuthSource: "admin", Username: username, Password: password, } // 高可用 URI, 注意 SetDirect 设为 false highProxyUri := "mongodb://host1:8635,host2:8635/?ssl=true" clientOpts := options.Client().ApplyURI(highProxyUri) clientOpts = clientOpts.SetTLSConfig(&tls.Config { InsecureSkipVerify: true, }).SetDirect(false).SetAuth(credential) // 直连的 URI,注意 SetDirect 设为 true //directUri := "mongodb://host:8635/?ssl=true" //clientOpts := options.Client().ApplyURI(highProxyUri) //clientOpts = clientOpts.SetTLSConfig(&tls.Config { // InsecureSkipVerify: true, //}).SetDirect(true).SetAuth(credential) // 连接实例 ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second) defer cancel() client, err := mongo.Connect(ctx, clientOpts) if err != nil { fmt.Println("mongo实例连接失败:", err) return } // Ping 主节点 ctx, cancel = context.WithTimeout(context.Background(), 2*time.Second) defer cancel()err = client.Ping(ctx, readpref.Primary()) if err != nil {fmt.Println("ping 主节点失败:",err) return } // 选择数据库和集合 collection := client.Database("test").Collection("numbers") // 插入单条数据 ctx, cancel = context.WithTimeout(context.Background(), 5*time.Second) defer cancel() oneRes, err := collection.InsertOne(ctx, bson.D{{"name", "e"}, {"value", 2.718}}) if err != nil{fmt.Println("插入单条记录失败:",err) return }else { fmt.Println(oneRes) } // 批量插入 ctx, cancel = context.WithTimeout(context.Background(), 100*time.Second) defer cancel() docs := make([]interface{}, 100) for i := 0; i < 100; i++{ docs[i] = bson.D{{"name", "name"+strconv.Itoa(i)}, {"value", i}} } manyRes, err := collection.InsertMany(ctx, docs) if err != nil { fmt.Println("批量插入失败:",err) return }else { fmt.Println(manyRes) }
- SSL关闭
// 高可用连接 readPreference 取值 primary(默认)-只读主节点,primaryPreferred-主节点优先,如主节点不可用,则读从节点 // secondary-只读从节点,如从节点不可用会报错,secondaryPreferred-从节点优先,如从节点不可用,则读主节点 // 认证用的用户名和密码直接写到代码中有很大的安全风险,建议在配置文件或者环境变量中存放(密码应密文存放、使用时解密),确保安全; // 本示例以用户名和密码保存在环境变量中为例,运行本示例前请先在本地环境中设置环境变量(环境变量名称请根据自身情况进行设置)EXAMPLE_USERNAME_ENV和EXAMPLE_PASSWORD_ENV。 username = System.getenv("EXAMPLE_USERNAME_ENV") password = System.getenv("EXAMPLE_PASSWORD_ENV") highProxyUri := fmt.Sprintf("mongodb://%v:%v@host1:8635,host2:8635/?authSource=admin&replicaSet=replica&readPreference=secondaryPreferred",username,password) ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second) defer cancel() clientOpts := options.Client().ApplyURI(highProxyUri) client, err := mongo.Connect(ctx, clientOpts) // Ping 主节点 ctx, cancel = context.WithTimeout(context.Background(), 2*time.Second) defer cancel()err = client.Ping(ctx, readpref.Primary()) if err != nil { fmt.Println("ping 主节点失败:",err) return } // 选择数据库和集合 collection := client.Database("test").Collection("numbers") // 插入单条数据 ctx, cancel = context.WithTimeout(context.Background(), 5*time.Second) defer cancel() res, err := collection.InsertOne(ctx, bson.D{{"name", "e"}, {"value", 2.718}}) if err != nil{ fmt.Println("插入单条记录失败:",err) return }else { fmt.Println(res) }
父主题: 基于Golang开发