首批通过分布式安全可靠测评,为关键业务系统打造
添加访问地址
更新时间:2026-06-04 19:02:52
本页面为您介绍添加访问地址的操作步骤。
概念介绍
主地址:其读写模式为可读可写,默认读主,提供强一致读写。创建租户时,主地址自动创建,且主地址代理部署的可用区默认与主可用区一致。
只读地址:只能执行查询操作,会把查询 SQL 请求按照设置的流量策略发送给对应的副本查询,数据一致性策略是最终一致性。
读写分离地址:可读可写,写请求发到全功能副本的主副本,事务外的读请求发到备副本,降低主副本压力,保证数据最终一致性。
直连地址:直连地址跳过数据库代理直接连接数据库,提供高性能、低时延访问,适用于对响应速度要求极高的业务。支持读写,请求直达主副本。
说明
- 线上生产环境推荐使用主地址、只读地址、读写分离地址。
- 直连地址目前仅针对白名单用户开放。如需开通此服务,请联系 OceanBase 技术支持。
注意事项
访问地址的使用限制如下:
备实例的租户不支持添加访问地址。
单机房或双机房部署模式的代理层支持一个主地址,最多可添加一个只读或读写分离地址。
多机房部署模式的代理层支持一个主地址,最多可添加两个只读或读写分离地址。若需要更多地址,需联系 OceanBase 技术支持人员申请更大规格的代理资源。
若后续选择购买额外的只读副本,那么每当该集群下新增购买一个只读副本实例时,可创建的访问地址数量相应增加一个。有关只读副本的相关介绍,详见 只读副本。
直连地址的使用限制如下:
仅支持数据库版本为 V4.2.1 及之后,Unit 数为 1 的租户创建直连地址。
每个租户仅支持创建一个直连地址。
目前只支持 AWS 渠道实例,使用私网模式访问。
读写分离地址的版本要求如下:
若 OceanBase 集群为 3.x 版本,其数据库代理必须为 V3.2.9~V4.0 之间的版本,才支持开通读写分离地址。
若 OceanBase 集群为 4.x 版本,其数据库代理必须为 V4.1 及以上的版本,才支持开通读写分离地址。
前提条件
在添加访问地址前,请您进行如下检查,满足下述情况时,才可进行添加访问地址的操作。
当前集群的云服务商为腾讯云、华为云或阿里云。
已完成云厂商主账号主账号的注册。
当前集群已创建私网连接地址或者对等连接地址。具体操作,请参见 连接数据库概述。
操作步骤
登录 OB Cloud 云数据库控制台。
在左侧导航栏中,单击 实例列表。
在实例列表中找到目标集群实例,单击集群名称进入集群实例工作台。
在左侧导航栏单击 租户管理。
在租户列表中单击目标租户名进入租户工作台。
单击部署关系图右侧的 添加访问地址。

根据实际需要设置访问地址配置。
基础设置。
参数 说明 选择要创建的网络类型 按需选择私网连接地址或者对等连接地址。 地址类型 选择要添加的地址类型: - 只读:对某个副本进行只读的操作,与主地址进行访问隔离,实现读写分离的访问能力。
- 读写分离:支持自动的读写分离,写请求自动转发给主副本,读请求根据设置转发给备副本或只读副本。
- 直连:直连地址跳过数据库代理直接连接数据库,提供高性能、低时延访问,适用于对响应速度要求极高的业务。支持读写,请求直达主副本。
读流量可访问副本 - 按副本类型:流量将发送给您所选择类型的副本,如果这个类型的副本有多个,会按照设置的流量均衡策略发送给这些副本。
- 按副本:流量将发送给您选择的副本。
说明
当前仅阿里云,且 ODP 版本在 V4.3.1 及以上时,支持按副本进行选择。
均衡策略 - 同可用区优先:优先访问跟 ODP 在同一个可用区的副本。仅当 读流量可访问副本 选择 按副本类型 时可配置。
- 自动均衡:ODP在只读地址、读写分离地址的场景下,读流量会在备副本上自动均衡。
- 自定义权重:可自定义选择的副本访问流量权重。仅当 读流量可访问副本 选择 按副本 时可配置。
容灾策略 - 按照副本类型设置的时候,如果所选择类型的副本不可用,读流量将自动查主副本。
- 按照副本设置的时候,如果设置了容灾副本,当选择的指定副本都不可用的时候,流量会发送给选择的容灾副本(多副本之间流量自动均衡访问)。
一致性级别 最终一致性。只读可用区与主可用区之间存在数据复制延迟,可能会导致查询结果与主可用区存在一定时间差(具体的访问结果由复制的延迟决定),但最终数据会保持一致。 
数据库代理配置
说明
当前版本仅 AWS 实例支持进行数据库代理配置。
配置项 说明 代理集群规格类型 支持选择共享规格和独享规格。 - 共享规格:数据库代理服务实例与其他客户共享计算资源,适用于流量较为固定且平均的业务。
- 独享规格:数据库代理服务实例单独占用计算资源,适用于较大访问流量的业务。计费说明,请参见 数据库代理计费说明。
代理集群部署方案 支持选择单可用区部署、双可用区双活部署和双可用区主备部署。 - 单可用区部署:所有节点部署在同一可用区,均承载流量。
- 双可用区双活部署:节点分布在两个不同可用区,均承载流量。
- 双可用区主备部署:ODP 节点部署在两个不同可用区,其中一个可用区节点承载流量,另一个节点作为冷备节点。使用双可用区主备部署时,请将代理集群主可用区选取在与客户端相同的可用区。来自备可用区的请求可能会在代理集群或数据库集群进行部署模式变更时由于触发了此可用区的下线而断联。
说明
双可用区主备部署仅支持在独享规格中进行设置。
代理集群节点数 代理集群节点数。 节点可用区 选择节点可用区。 说明
主地址代理可用区与租户主可用区不一致,会发生跨机房流量转发,可能会增加 SQL 的响应耗时。
节点规格 选择目标规格大小,共享规格和独享规格拥有不同的大小限制和步长。 
基础设置完成后,根据选择的网络类型进行对应操作。
私网连接地址:根据不同的云厂商类型,完成终端节点服务、终端节点的创建和连接操作。
对等连接地址:在对等连接配置完成后,选择目标对等连接 ID,单击 创建对等连接地址。
相关操作
查看访问地址

访问地址或直连地址添加完成后,可以在租户工作台的部署关系图区域查看地址信息。
将鼠标悬停在主地址、访问地址或直连地址卡片上,可以查看地址的基本信息。
将鼠标悬停在目标地址上,会出现对应的操作按钮,可以对地址进行复制、编辑、删除。
单击最大连接数处右侧的 去修改,可以修改对应地址的最大连接数。详细操作,请参见 修改数据库代理最大连接数。
说明
当前仅阿里云渠道的实例支持修改最大连接数。
编辑访问地址
访问租户工作台。
在部署关系图区域中,单击目标访问地址右上角的编辑按钮。

在编辑访问地址的页面中,按需修改配置。

单击 确定。
删除访问地址
访问租户工作台。
在部署关系图区域中,单击目标访问地址右上角的删除按钮。

检查确认删除配置的风险,单击 确认。
