文档中心

云数据库 MySQL 版

管理连接终端

创建连接终端

本文介绍创建连接终端的操作步骤。

前提条件

已创建实例且实例处于运行中状态。具体操作，请参见创建实例。

注意事项

代理终端依赖于 MySQL 实例的数据库代理功能，在实例的数据库代理功能未开启时，不支持创建代理终端。

由于双节点实例的只读节点不具备高可用能力，为保证业务的稳定性，建议为每个连接终端至少关联两个只读节点，以免因唯一只读节点发生故障而影响连接终端可用性。对于未开启数据库代理的实例，也建议您开启实例的数据库的代理功能并为连接终端关联至少两个只读节点。

多节点实例在创建时会自动创建三个连接终端，除此以外，还支持创建三个读写直连终端。

双节点实例在创建代理终端或直连终端时，仅支持选择主节点或只读节点。

操作步骤

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

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

说明

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

在左侧导航栏单击实例列表。

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

在连接管理页签下方的实例拓扑区域，单击+添加终端，进入创建连接终端页面。

说明

也可以单击终端列表区域的+添加终端。

在创建终端页面，完成以下设置后单击确定。

配置项	适用的终端类型	说明
终端类型	-	设置连接终端的类型，可选择代理终端或直连终端。代理终端：通过此终端的连接将经过代理，可使用代理相关的特性和功能，如读写分离、负载均衡、空闲连接回收和 Multi-Statements 等功能。直连终端：通过此终端连接数据库的连接将直连到对应节点，不能使用代理相关特性。说明关于代理终端和直连终端功能差异的详细信息，请参见关于连接终端。代理终端依赖于 MySQL 实例的数据库代理功能，在实例的数据库代理功能未开启时，不支持创建代理终端。关于如何开启实例数据库代理功能的详细信息，请参见开启数据库代理。
读写模式	代理终端和直连终端	选择连接终端的读写模式。可选择读写或只读。
连接池	代理终端	选择连接终端的连接池模式。可选择事务级连接池或直连模式。关于连接池模式的详细信息，请参见关于连接池模式。
空闲连接回收	代理终端	选择是否开启空闲连接回收功能。开启后，将被自动断开处于空闲状态的时长超过 wait_timeout 设定的通过代理的连接，从而减少资源占用。关闭后，不会自动断开处于空闲状态的时长超过 wait_timeout 设定的通过代理的连接，可能会消耗更多系统资源。空闲连接回收功能依赖 MySQL 的 session tracker 机制，如果设置相关参数 session_track_state_change 为OFF，并设置 session_track_system_variables 为空，该功能将会失效。如开启空闲连接回收功能后关闭了实例的数据库代理功能，空闲连接回收功能将不生效，并且不会在编辑连接终端页面显示。重新开启实例的数据库代理功能后，空闲连接回收功能将自动恢复。
终端名称	代理终端和直连终端	设置连接终端的名称。终端名称的规则如下：不能为空。不能以数字、中划线（-）开头。长度为 1~64 个字符。只能包含中文、字母、数字、下划线（_）和中划线（-）。
关联节点	代理终端和直连终端	为连接终端关联节点。不同类型连接终端关联节点的规则不同：对于代理终端，在读写模式下可只关联主节点，也可以关联主节点和最多 10 个只读节点；在只读模式下只能关联只读节点，可关联最少 1 个、最多 10 个只读节点。对于直连终端，在读写模式下只能关联主节点，在只读模式下只能关联 1 个只读节点。
自动添加新节点	代理终端	选择是否开启自动添加新节点功能。开启后，若实例有新增节点，该连接终端会自动关联新增的节点。
连接保持	代理终端	选择是否为终端开启连接保持功能。关于连接保持功能的详细信息，请参见开启或关闭连接保持。
读写分离	代理终端	选择是否开启读写分离功能。开启后，可配置将读请求转发至只读节点，降低主节点的读压力。说明仅读写模式的连接终端支持读写分离功能。
一致性级别	代理终端	根据业务场景选择以下级别：最终一致性（默认值）。会话一致性。全局一致性。说明仅终端类型为代理终端、读写模式为读写的终端支持设置一致性级别。最终一致性、会话一致性和全局一致性的适用场景，请参见一致性介绍。
一致性读超时	代理终端	设置代理等待只读节点追平目标数据位点的最长时间，默认值为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 的整数倍。说明请尽量按节点规格比例设置权重，防止节点压力不均造成资源浪费。
主节点路由	代理终端	选择是否开启连接终端的主节点路由功能。开启时，主节点将与只读节点一同参与评估，由连接数最少的节点承接新的读请求；关闭时，可分离的读请求则不会调度到主节点。说明该功能仅在内核小版本为 20241215 及以上的实例中提供。如有需要，您可手动升级实例的内核小版本。更多详细信息，请参见手动升级实例内核小版本。该功能仅在连接终端的读写分离功能开启、连接终端同时关联了主节点和只读节点、读请求调度策略为连接数调度时支持。
只读延迟阈值	代理终端	设置连接终端的只读延迟阈值。延迟时间超过此阈值的只读节点将不会被分配读请求。取值范围是 1~3600，单位为秒，步长为 1。说明仅读写终端支持该设置。
事务拆分	代理终端	设置是否开启连接终端的事务拆分功能。更多关于事务拆分功能的详细信息，请参见开启或关闭事务拆分。
转发规则	代理终端	为终端设置 SQL 转发规则。更多关于 SQL 转发规则的设置信息，请参见配置 SQL 转发规则。

说明

单击确定后，实例状态变为网络变更中。待创建连接终端完成后，实例状态变为运行中。

API	说明
CreateDBEndpoint	调用 CreateDBEndpoint 接口创建 Endpoint。