检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
，配置对应的环境变量，确保本地开发环境可用。 使用MAS-DB-SDK组件需具备一定的Java后端、持久层框架集成等知识。 准备项 说明 准备操作系统 Windows系统。Windows版本要求：Windows 7及以上版本。 安装JDK 开发环境的基本配置。JDK版本要求：1
多活容灾监控准备 在使用MAS-DB-SDK进行开发前，需要先做好如下准备： 已创建MAS实例。 在实例下已创建对应的监控器。 请参考MySQL/Oracle/PostgreSQL监控管理，配置多活容灾MySQL/Oracle/PostgreSQL监控。 父主题： 约束
SDK接入配置 本章节指导用户如何获取SDK接入配置，引用SDK方法请参考开发指南。 约束与限制 “API监控”不支持获取SDK接入配置。 操作步骤 登录MAS控制台，在“多活管理”页面单击实例，进入实例控制台。 在页面顶端导航栏选择“监控列表”，单击监控所在行的“更多”>“SDK接入配置”。
多活容灾MongoDB监控准备 在使用MAS-MongoDB-SDK进行开发前，需要先做好如下准备： 已创建MAS实例。 在实例下已创建对应的监控器。 配置多活容灾MongoDB监控，请参考MongoDB监控管理。 父主题： 约束
多活容灾Redis监控准备 MAS-Redis-SDK的多活容灾能力需要MAS服务支持，SDK本身也不支持故障动态切换数据源能力，需要配合MAS实例一起使用。 在使用MAS-Redis-SDK进行开发前，需要先做好如下准备： 已创建MAS实例。 在实例下已创建对应的监控器。 请参
版本依赖 下面是MAS-DB-SDK中引入的依赖及依赖版本： 所属模块 依赖名称 依赖版本 scope devspore-datasource com.huaweicloud.devspore:devspore-mas-common latest compile net.jodah:failsafe
版本约束 MAS-Mongo-SDK对使用到的工具及相关组件的版本有所约束，如下表： 约束项 约束版本 JDK 1.8.0_262及以上版本 Maven 3.3.0及以上版本 MongoDB版本 4.4及以下版本 SDK组件依赖 见如何选择组件版本 spring-boot版本 2
版本依赖 下面是MAS-Redis-SDK中引的依赖及依赖版本： 所属模块 依赖名称 依赖版本 scope devspore-dcs com.huaweicloud.devspore:devspore-mas-common latest compile com.fasterxml
多活容灾ElasticSearch监控准备 MAS-ElasticSearch-SDK的多活容灾能力需要MAS服务支持，SDK的故障动态切换数据源能力需要配合MAS实例一起使用。 在使用MAS-ElasticSearch-SDK进行开发前，需要先做好如下准备： 已创建MAS实例。 在实例下已创建对应的监控器。 请
概述 故障注入功能是在上述模块的补充功能，可在对应服务添加故障注入配置创建带有注入故障的实例，可注入带波动的延时故障和异常故障，进行相关业务场景的模拟。 具体操作请参考Mysql配置示例和Redis配置示例。 相关配置详见配置项说明和内置注入故障。 父主题： 故障注入
不支持的接口 SDK中部分jdbc相关接口不支持，详细见SDK中com.huawei.devspore.datasource.jdbc.unsupported包。下面列出了Connection、PreparedStatement、ResultSet中的部分不支持接口，如下： Connection接口。
使用指南 在go.mod文件中引入依赖，即引入MAS-GO-SDK。 github.com/huaweicloud/devcloud-go 结合配置项说明，添加配置文件或者配置信息。 配置文件示例config_Redis.yaml props: version: v1 appId:
敏感信息加解密 配置文件中配置密文信息。可以解密的配置有devspore.dcs.redis.servers.dc1.password,devspore.dcs.redis.servers.dc1.sentinelPassword,devspore.dcs.etcd.password
serverSelectionTimeoutMS 否 Integer 服务器选择超时（以毫秒为单位）。 localThresholdMS 否 Integer 当与副本集中的多个MongoDB实例进行通信时，驱动程序只会将请求发送到响应时间小于或等于响应时间最快的服务器加上本地阈值的服务器，以毫秒为单位。 heartbeatFrequencyMS
参考故障注入Mysql配置示例。 该模块具有如下特性： 多活容灾能力。 多活容灾能力是指在同城场景下实现多活故障自动切换，由SDK和MAS服务配合完成。 读写分离。 读写分离由SDK实现，支持随机、轮询的负载均衡算法。 故障注入。 支持带注入故障的实例创建，包含延时（波动）、预设异常的故障配置。
强制路由 除了根据路由算法配置路由，SDK还支持通过注解@DynamicReadRoute指定读操作的路由。注解@DynamicReadRoute指定路由的参数：source，用于选择数据源，可以选择对应的枚举值：MongoSource.ACTIVE, MongoSource.LOCAL。
使用限制 session使用 仅支持通过以下接口获取session： com.huawei.devspore.mas.mongo.core.client.Cluster.startSession() com.huawei.devspore.mas.mongo.core.client
false redis: nearest: dc1 servers: dc1: // 和MAS服务监控页中的名称保持一致:dc1和dc2 hosts: xxx.xxx.xxx.xxx:xxxx password:
normal（普通）Redis服务，搭配MAS可实现多活容灾；同时内置故障注入功能可创建带有注入故障的实例，进行相关业务场景的模拟，配置修改请参考故障注入Redis配置示例。 该模块具有如下特性： 多活容灾能力 多活容灾能力是指在同城场景下实现多活故障自动切换，由SDK和MAS服务配合完成。 数据双写
内置注入故障 带波动的延时故障 基于延时基数和抖动幅度创建带有波动的延时故障。具体触发要结合故障注入功能是否开启、注入故障概率、延时注入开关、延时故障生效概率决定。 异常故障 内置如下异常故障，结合故障注入功能是否开启、注入故障概率、异常注入开关、异常故障生效概率决定是否触发，触发故障为对应模块随机一种异常。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
