一致性级别
更新时间：2026-08-13
本文介绍如何通过 GaiaDB 管理控制台配置一致性级别。
GaiaDB 提供最终一致性、会话一致性和全局一致性三种一致性级别。您可以根据业务对数据一致性和性能的要求，选择合适的一致性策略。
| 一致性级别 | 功能介绍 | 适用场景 |
|---|---|---|
| 最终一致性 | 读请求优先路由至只读实例，不保证立即读取到最新写入的数据。当主从数据同步完成后，数据最终保持一致。 | 适用于对数据实时一致性要求不高、希望充分利用只读实例分担读压力的场景。 |
| 会话一致性 | 保证同一会话内的读请求能够读取到该会话之前成功写入的数据，不同会话之间不保证实时一致。相比全局一致性，对性能影响更小。 | 推荐大多数业务场景使用。 保证同一客户端在完成写操作后，后续读请求能够读取到本次写入的数据，同时兼顾一致性和系统性能。 |
| 全局一致性 | 保证所有读请求都能够读取到数据库最新已提交的数据，实现全局一致的数据视图。 | 适用于对数据一致性要求极高的场景，建议在读多写少且一致性要求极高的业务中使用。 |
注意事项
- 开启会话一致性后，仅在会话发生写操作后的首次读请求进行一致性检查，后续读请求复用一致性状态，因此对整体性能影响较小。未发生写操作的会话不会产生额外开销。
- 开启全局一致性后，系统将优先保证所有读请求获取最新数据。当主从复制延迟较高时，部分读请求可能由读写集群地址处理，从而增加主节点负载，并导致请求响应时间增加。
设置一致性级别
- 登录 GaiaDB管理控制台。
- 在控制台页面左上角，选择实例所在地域。
- 找到目标 GaiaDB 集群，点击 集群名称，进入GaiaDB 集群详情页。
- 在基本信息页，选择目标的集群地址（代理实例），点击 修改配置。
- 在 一致性设置 选择 一致性级别并按需配置如下参数。
| 参数 | 说明 |
|---|---|
| 一致性级别 | 配置读请求的一致性保证级别，可选择最终一致性、会话一致性或全局一致性。 |
| 全局（会话）一致性读超时时间 | 等待只读节点追上主节点数据进度的最长时间，单位为毫秒。取值范围：0～300000 ms。 |
| 全局（会话）一致性读超时策略 | 当只读节点在超时时间内仍未满足一致性要求时的处理策略： 发送请求到主节点：将读请求转发至主节点执行，保证一致性。 SQL 报错：直接返回错误，由业务自行处理。 |
- 确认配置后，点击 确定 即可完成一致性设置。
评价此篇文章