文档中心

云数据库 veDB MySQL 版

管理连接终端

创建连接终端

本文介绍自定义只读终端和自定义读写终端的创建步骤。

功能介绍

主节点终端和默认终端在创建实例时默认创建，不需手动创建。

对于有隔离需求的业务，您可以根据业务需要将有隔离需求的业务使用对应的连接终端连接至 veDB MySQL 数据库。例如，已购买了 1 个主节点和 3 个只读节点的 veDB MySQL 实例，现有只读的业务 A 和读写业务 B 需要连接数据库。为实现只读的业务 A 和读写业务 B 之间的隔离，可以创建自定义只读终端，关联只读节点 1 和只读节点 2，使只读业务 A 通过自定义只读终端连接实例；创建自定义读写终端，关联主节点和只读节点 3，使读写业务 B 通过自定义读写终端连接实例。通过以上方式即可实现两个业务在数据库使用上的物理隔离，避免相互影响。

前提条件

已创建实例，且实例处于运行中状态。

注意事项

新创建的自定义读写终端的主节点接受读功能默认开启。如需关闭此功能，请参见编辑连接终端。

一个实例最多支持创建五个自定义连接终端。

支持创建单节点自定义连接终端，若此节点故障，该地址可能会有最多 1 小时的不可用，请勿用于生产环境。为保证业务连续性，建议关联多个节点。

切换主节点会影响自定义连接终端的节点关联情况，详情请参见切换主节点。

操作步骤

登录云数据库 veDB MySQL 版控制台。

在顶部菜单栏选择实例所属的项目和地域。

在实例列表页面，单击目标实例名称，进入实例信息页。

在实例信息页，单击连接管理页签。

在连接管理页签中，单击实例拓扑区域中的添加终端。

在创建连接终端页，根据业务需求配置以下参数项。

分类	参数	说明
终端信息	读写模式	选择连接终端的读写模式，可选模式有只读或读写。
		终端名称	自定义连接终端名称，设置规则如下：不能以数字或中划线（-）开头。只能包含中文、字母、数字、下划线（_）和中划线（-）。长度为 1~64 个字符。
		一致性级别	关于一致性级别的详细介绍请参见一致性级别。当读写模式为读写时，可选择的一致性级别有最终一致性（默认）、会话一致性、全局一致性。当读写模式为只读时，一致性级别默认为最终一致性，且不可更改。
		超时时间	延迟很大时，只读节点同步最新数据的超时时间，单位为 us，取值范围为 1us~100000000us，默认值为 10000us。说明仅当一致性级别为会话一致性或全局一致性时，支持配置该参数。
		超时策略	只读节点同步数据超时后策略，支持以下两种策略： SQL 报错：如果主从延迟过大，超过阈值，则会直接返回报错（wait replication complete timeout, please retry）。发送该请求到主节点：如果主从延迟过大，配置的超时阈值较小，会将读请求发往主节点，主节点压力增加。说明仅当一致性级别为会话一致性或全局一致性时，支持配置该参数。
		主节点接受读	选择开启或关闭主节点接受读，默认开启。当开启主节点接受读功能后，非事务读请求会按活跃请求数负载均衡的模式发送至主节点或只读节点。当关闭主节点接受读功能后，此时主节点只接受事务读请求，而非事务读请求不会发往主节点。说明仅读写终端支持配置该参数。
		事务拆分	选择开启或关闭事务拆分，默认开启。关于事务拆分的详细介绍请参见事务拆分。说明仅读写终端支持配置该参数。
		连接池	连接池默认处于关闭状态，您可依据业务场景设置连接池，支持会话级连接池和事务级连接池。关于两种连接池的工作原理介绍，请参见连接池。
关联节点	关联节点	当读写模式为读写时，必须要选择主节点，可按需选择是否关联只读节点。说明建议关联主节点和至少一个只读节点。仅关联主节点时，不支持读写分离。当读写模式为只读时，只能选择只读节点。
关联节点		自动加入新节点	选择开启或关闭自动加入新节点，默认关闭。开启后，连接终端会自动关联新创建的只读节点。

单击确定，完成创建。

API	描述
CreateDBEndpoint	调用 CreateDBEndpoint 接口为实例创建连接终端。