文档中心

云数据库 MySQL 版

管理连接终端

编辑连接终端

云数据库 MySQL 版支持对连接终端的连接信息、终端信息、关联节点和读写分离设置进行修改。本文介绍编辑连接终端的操作步骤。

前提条件

已创建实例且实例状态为运行中。更多详情，请参见创建实例。

注意事项

多节点实例连接终端的类型、读写模式、自动添加新节点功能、读请求调度策略均不支持调整，默认终端和只读终端的自动添加新节点功能默认开启，写终端的自动添加新节点功能默认关闭，读请求调度策略默认采用轮询调度。

操作步骤

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

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

说明

如未设置实例的所属项目，本操作应选择项目为账号全部资源。

在左侧导航栏单击实例列表，进入实例列表页面。

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

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

在连接管理页的终端列表中，单击目标连接终端操作列的编辑，进入编辑连接终端页面。

在编辑连接终端页面，可以进行以下功能设置：

配置项	适用的终端类型	说明
终端类型	-	如实例的数据库代理功能已开启，则支持将已有终端的类型在代理终端和直连终端之间转换。直连终端转换为代理终端后，终端将具备代理提供的高级功能。转换过程中会出现秒级连接中断，建议提前为应用程序增加重连机制，以减少对业务的影响。代理终端转换为直连终端后，将失去代理提供的附加功能，代理相关配置不会被保留。转换过程中会出现秒级连接中断，建议提前为应用程序增加重连机制，以减少对业务的影响。说明多节点实例连接终端的类型不支持调整。
读写模式	代理终端和直连终端	选择连接终端的读写模式。可选择读写或只读。说明多节点实例连接终端的读写模式不支持调整。
连接池	代理终端	选择连接终端的连接池模式。可选择事务级连接池或直连模式。关于连接池模式的详细信息，请参见关于连接池模式。
空闲连接回收	代理终端	选择是否开启空闲连接回收功能。开启后，将被自动断开处于空闲状态的时长超过 wait_timeout 设定的通过代理的连接，从而减少资源占用。关闭后，不会自动断开处于空闲状态的时长超过 wait_timeout 设定的通过代理的连接，可能会消耗更多系统资源。空闲连接回收功能依赖 MySQL 的 session tracker 机制，如果设置相关参数 session_track_state_change 为OFF，并设置 session_track_system_variables 为空，该功能将会失效。如开启空闲连接回收功能后关闭了实例的数据库代理功能，空闲连接回收功能将不生效，并且不会在编辑连接终端页面显示。重新开启实例的数据库代理功能后，空闲连接回收功能将自动恢复。
终端名称	代理终端和直连终端	设置连接终端的名称。终端名称的规则如下：不能为空。不能以数字、中划线（-）开头。长度为 1~64 个字符。只能包含中文、字母、数字、下划线（_）和中划线（-）。
修改连接地址前缀	代理终端和直连终端	修改连接地址前缀。更多详情，请参见修改连接地址前缀。
修改端口	代理终端和直连终端	修改端口。更多详情，请参见修改连接地址端口。
开启或关闭公网解析	代理终端和直连终端	开启或关闭公网解析。更多详情，请参见开启或关闭公网解析。
开启或关闭公网访问	代理终端和直连终端	开启或关闭公网访问。更多详情，请参见开启公网访问。
关联节点	代理终端和直连终端	为连接终端关联节点。不同实例类型连接终端关联节点的规则不同：单节点实例：默认关联实例的主节点。双节点实例代理终端在读写模式下可只关联主节点，也可以关联主节点和最多 10 个只读节点；在只读模式下只能关联只读节点，可关联最少 1 个、最多 10 个只读节点。直连终端，在读写模式下只能关联主节点，在只读模式下只能关联 1 个只读节点。多节点实例默认终端会关联实例的所有节点，写终端仅关联实例的主节点，默认终端和写终端均不支持调整关联的节点。只读终端默认关联了实例的所有备节点，最少可只关联一个备节点，最多可关联实例的所有备节点。直连终端仅支持读写模式，且在读写模式下只能关联主节点。说明调整多节点实例只读终端关联的节点时，需要关闭关联所有备节点功能。备节点切主后将自动与连接终端取消关联。说明如果为连接终端增加只读节点（双节点实例）或备节点（多节点实例），新的请求将立即自动分发到新节点；如果为连接终端移除只读节点时，若该节点状态正常，MySQL 会采用热切换技术，待该节点上的所有 Query 都执行完成后，再去除关联，该过程中连接不会中断，不影响业务的正常访问。多节点实例只读终端关联的备节点被切换成主节点后，只读终端关联的备节点将减少一个。如果需要维持只读终端原有的备节点数量，需要手动添加新的备节点。建议为终端配置足够的备节点以应对业务流量。为确保只读模式下的高可用性，建议至少为只读终端关联两个备节点（多节点实例）或两个只读节点（双节点实例）。
关联所有备节点	代理终端	设置连接终端是否关联所有备节点。说明仅多节点实例的只读终端支持该配置。仅在实例有两个及更多备节点时才能关闭此功能。
自动添加新节点	代理终端	选择是否开启自动添加新节点功能。开启后，若实例有新增节点，该连接终端会自动关联新增的节点。说明多节点实例连接终端的自动添加新节点功能不支持关闭。备节点切主后将自动与连接终端取消关联。
连接保持	代理终端	选择是否为终端开启连接保持功能。关于连接保持功能的详细信息，请参见开启或关闭连接保持。
读写分离	代理终端	选择是否开启读写分离功能。开启后，可配置将读请求转发至只读节点，降低主节点的读压力。说明仅读写模式的连接终端支持读写分离功能。
一致性级别	代理终端	根据业务场景选择以下级别：最终一致性（默认值）。会话一致性。全局一致性。说明仅终端类型为代理终端、读写模式为读写的终端支持设置一致性级别。最终一致性、会话一致性和全局一致性的适用场景，请参见一致性介绍。
一致性读超时	代理终端	设置代理等待只读节点追平目标数据位点的最长时间，默认值为10 ms。取值范围为 0～60000，单位为 ms （毫秒）。取值为 0 时，表示不等待。说明仅一致性级别为会话一致性和全局一致性时，配置该参数。
超时策略	代理终端	设置只读节点在超时时间内仍未追平目标位点时，代理处理读请求的方法。取值如下：转发至主节点（默认值）：将读请求转发到主节点执行。该方法可能会增加主节点压力。返回错误：返回错误信息。建议业务具备重试能力。说明仅一致性级别为会话一致性和全局一致性时，配置该参数。
Multi-Statements 模式	代理终端	选择 Multi-Statements 模式。可选择 Strict 模式或 Loose 模式。 Strict 模式在该模式下，Multi-Statements 会发往主节点，当前连接的后续请求读写分离失效，会全部路由到主节点，需断开当前连接并重新连接才能恢复读写分离。该模式下的连接终端不会解析 Multi-Statements，性能好，适合短连接、无连接复用场景。 Loose 模式在该模式下，Multi-Statements 会发往主节点，当前连接的后续请求依旧可以读写分离。该模式下的连接终端不会解析 Multi-Statements，性能好，适合 Multi-Statements 内仅含 DML SQL，不含设置 session 变量、创建临时表、创建存储过程、执行未提交事务等操作的场景。说明仅支持在开启读写分离时调整终端的 Multi-Statements 模式。
过载保护	代理终端	选择是否开启过载保护功能。开启后，可在实例的只读节点整体异常时，开启对主节点的保护机制，以防主节点被突发流量击穿。说明开启后，需要设置过载保护时间。超过设定的保护时间后将解除对主节点的过载限制。过载保护时间取值范围为 60~7200s。如您实例的连接终端没有过载保护功能，请升级实例的内核小版本。关于如何升级实例的内核小版本，请参见手动升级实例内核小版本。过载保护功能仅在连接终端的读写分离功能开启，且关联节点中同时包含主节点和只读节点（双节点实例）或备节点（多节点实例）时生效。仅代理终端支持过载保护功能。
读请求调度策略	代理终端	选择连接终端的读请求调度策略。可选择轮询调度或连接数调度。轮询调度推荐选择项。选择此调度策略时，系统将根据权重配置，将新的连接轮询调度到关联节点，权重根据实例规格自动计算。连接数调度系统会根据节点的活跃请求量和响应时间，自动将新连接分配至负载较轻的节点。说明多节点实例仅支持轮询调度的读请求调度策略。
权重分配策略	代理终端	选择读请求调度策略为轮询调度时的权重分配策略。可选择自动分配或自定义分配。自动分配选择此分配策略时，系统将根据该连接终端所关联的节点的规格，为各节点自动分配权重。自定义分配选择自定义分配时，页面会展示该连接终端关联的节点，由您在列表中为各节点设置权重。默认权重根据节点规格自动计算。权重输入范围为 0～10000，且必须是 100 的整数倍。说明请尽量按节点规格比例设置权重，防止节点压力不均造成资源浪费。多节点实例仅支持自动分配的权重分配策略。
主节点路由	代理终端	选择是否开启连接终端的主节点路由功能。开启时，主节点将与只读节点一同参与负载的评估，并接受可分离的只读请求；关闭时，可分离的只读请求将不会调度到主节点。说明该配置仅在选择读请求调度策略为连接数调度时支持配置，并仅在读写模式的连接终端中有效。多节点实例仅支持轮询调度的读请求调度策略，因此不支持该配置。
只读延迟阈值	代理终端	设置连接终端的只读延迟阈值。延迟时间超过此阈值的只读节点将不会被分配读请求。取值范围是 1~3600，单位为秒，步长为 1。说明仅读写终端支持该设置。
事务拆分	代理终端	设置是否开启连接终端的事务拆分功能。
转发规则	代理终端	为终端设置 SQL 转发规则。更多关于 SQL 转发规则的设置信息，请参见配置 SQL 转发规则。

完成以上设置后，单击确定。

API	说明
ModifyDBEndpoint	调用 ModifyDBEndpoint 接口修改 Endpoint。