华为云国际站代理商配置 GaussDB 读写分离权重，核心是通过数据库代理（Proxy） 或DDM 中间件实现主 / 只读节点读请求按比例分流，支持国际站控制台、API/SDK、DDM 三种方式，需先满足前置条件，再按步骤调整并验证，代理商还可叠加增值服务保障落地效果。
一、前置条件（代理商必核）
- 已开通 GaussDB 实例（主备版 / 分布式），并创建 1 个及以上只读节点（跨 AZ / 跨 Region 均可）。
- 已启用数据库代理（Proxy），或搭配 DDM 分布式数据库中间件（适配分布式场景）。
- 代理商账号 / 子账号已获得
gaussdb:proxy:modifyWeight等权限，可通过 IAM 授权配置。 - 确认代理版本：Proxy/DDM 内核 3.1.0 + 需手动开启读写分离开关；低于 3.1.0 默认开启。
- 跨境场景需提前完成跨 Region 网络打通、数据同步延迟控制（建议 < 10ms），避免读一致性问题。
二、三种配置方式（代理商操作指南）
方式 1：国际站控制台（可视化，适合快速调整）
- 登录华为云国际站控制台，进入 "GaussDB> 实例管理"，选择目标实例。
- 进入 "数据库代理" 页，开启 "读写分离"（3.1.0 + 版本），选择 "读写分离权重配置"。
- 在权重配置页，为主节点和各只读节点设置权重（范围 0-100，总和建议 100，便于计算比例）。
- 示例：主节点权重 20、只读节点 A 权重 80 → 主节点承担 20% 读请求，只读节点承担 80% 读请求。
- 确认配置并提交，系统实时生效，无需重启实例。
- 验证：在 "代理监控" 查看主 / 只读节点读请求占比，确认分流符合预期。
方式 2：API/SDK（自动化，适合批量 / 跨境批量运维）
-
准备认证信息：获取国际站
project_id、instance_id、proxy_id及 AK/SK。 -
调用 Proxy 权重设置 API（PUT 请求），示例接口： plaintext
PUT /v3/{project_id}/instances/{instance_id}/proxy/{proxy_id}/weight -
请求体参数（JSON）： json
{ "weight": { "primary_weight": 20, "read_replicas": [{"replica_id": "xxx", "weight": 80}] } } -
调用 SDK（Java/Python 等）封装请求，实现批量调整多实例权重，适配跨境多 Region 部署。
-
验证：通过 API 查询权重配置，或在监控面板核对流量分配。
方式 3：DDM 中间件（分布式场景，适合复杂负载）
- 登录国际站 DDM 控制台，进入目标实例 "读写分离" 配置页。
- 开启读写分离开关（3.1.0 + 版本），为主节点和只读节点设置权重（0-100）。
- 支持 "同步" 功能：将第一个实例权重同步到其他实例（需只读节点数量一致）。
- 规则：含 Hint 或事务内写操作的 SELECT 语句默认走主节点，需提前告知客户。
- 验证：在 DDM "SQL 审计" 查看语句路由，确认读请求按权重分流。
三、权重配置核心规则与跨境优化
| 规则 / 场景 | 关键说明 | 代理商优化动作 |
|---|---|---|
| 权重计算逻辑 | 节点读请求占比 = 节点权重 / 所有节点权重总和 | 建议权重总和设为 100，简化比例核算 |
| 主节点权重 0 | 主节点不承担读请求，所有读请求分流至只读节点（适合读密集、主节点压力大场景） | 跨境电商大促前临时调整，主节点专注写操作 |
| 只读节点权重 0 | 该节点不承担读请求（适合节点维护、同步延迟高时临时下线） | 跨境灾备演练时，临时将故障节点权重设 0 |
| 跨境延迟适配 | 同步延迟 > 100ms 时，可降低该只读节点权重（如从 80 降至 30） | 配置延迟告警，自动触发权重动态调整 |
| 混合负载优化 | 复杂查询路由列存只读节点，权重设高；简单查询路由行存只读节点，权重均衡 | 协助客户配置 SQL 代价阈值，实现负载自动分流 |
四、代理商增值保障动作
- 跨境方案定制：根据客户业务（如跨境电商大促、游戏全球同服），推荐主 / 只读节点权重配比（如大促时主节点权重 10、只读节点权重 90）。
- 实时监控与调优：提供 7×24 跨境监控，当读延迟突增时，协助快速调整权重，保障业务无感知。
- 故障演练：定期开展权重调整 + 故障倒换演练，确保 RPO=0、RTO<10 秒，符合跨境 SLA 要求。
- 成本优化：结合国际站优惠，建议非峰值时段降低只读节点权重或缩容，降低 TCO。
五、常见问题与排障
- 配置后未分流：检查读写分离开关是否开启（3.1.0+），权重总和是否合理，Proxy 是否正常运行。
- 读数据不一致：跨境场景下，建议将同步延迟高的只读节点权重调低，或启用最终一致性策略。
- 权限不足：通过 IAM 为代理商账号授予
gaussdb:proxy:modifyWeight权限，或联系华为云国际站客服协助授权。