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

前提条件

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

注意事项

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

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

操作步骤

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

2. 在顶部菜单栏的左上角，选择实例所属的项目和地域。

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

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

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

   说明

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

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

   配置项	适用的终端类型	说明
   终端类型	代理终端和直连终端	取决于实例的数据库代理功能是否开启，不可修改。具体如下： 数据库代理功能开启时，只能创建代理终端。 数据库代理功能未开启时，只能创建直连终端。
   读写模式	代理终端和直连终端	选择连接终端的读写模式。可选择读写或只读。
   连接池	代理终端	选择连接终端的连接池模式。可选择事务级连接池或直连模式。关于连接池模式的详细信息，请参见关于连接池模式。
   空闲连接回收	代理终端	选择是否开启空闲连接回收功能。 开启后，将被自动断开处于空闲状态的时长超过 wait_timeout 设定的通过代理的连接，从而减少资源占用。 关闭后，不会自动断开处于空闲状态的时长超过 wait_timeout 设定的通过代理的连接，可能会消耗更多系统资源。 空闲连接回收功能依赖 MySQL 的 session tracker 机制， 如果设置相关参数 session_track_state_change 为OFF，并设置 session_track_system_variables 为空，该功能将会失效。 如开启空闲连接回收功能后关闭了实例的数据库代理功能，空闲连接回收功能将不生效，并且不会在编辑连接终端页面显示。重新开启实例的数据库代理功能后，空闲连接回收功能将自动恢复。
   终端名称	代理终端和直连终端	设置连接终端的名称。终端名称的规则如下： 不能为空。 不能以数字、中划线（-）开头。 长度为在 1~64 个字符。 只能包含中文、字母、数字、下划线（_）和中划线（-）。
   关联节点	代理终端和直连终端	为连接终端关联节点。不同类型连接终端关联节点的规则不同： 对于代理终端，在读写模式下可只关联主节点，也可以关联主节点和最多 10 个只读节点；在只读模式下只能关联只读节点，可关联最少 1 个、最多 10 个只读节点。 对于直连终端，在读写模式下只能关联主节点，在只读模式下只能关联 1 个只读节点。
   自动添加新节点	代理终端	选择是否开启自动添加新节点功能。开启后，若实例有新增节点，该连接终端会自动关联新增的节点。
   读写分离	代理终端	选择是否开启读写分离功能。开启后，可配置将读请求转发至只读节点，降低主节点的读压力。
   Multi-Statements 模式	代理终端	选择 Multi-Statements 模式。可选择 Strict 模式或 Loose 模式。 Strict 模式 在该模式下，Multi-Statements 会发往主节点，当前连接的后续请求读写分离失效，会全部路由到主节点，需断开当前连接并重新连接才能恢复读写分离。该模式下的连接终端不会解析 Multi-Statements，性能好，适合短连接、无连接复用场景。 Loose 模式 在该模式下，Multi-Statements 会发往主节点，当前连接的后续请求依旧可以读写分离。该模式下的连接终端不会解析 Multi-Statements，性能好，适合 Multi-Statements 内仅含 DML SQL，不含设置 session 变量、创建临时表、创建存储过程、执行未提交事务等操作的场景。
   读请求调度策略	代理终端	选择连接终端的读请求调度策略。可选择轮询调度或负载调度。 轮询调度 推荐选择项。选择此调度策略时，系统将根据权重配置，将新的连接轮询调度到关联节点。 负载调度 选择此调度策略时，系统将新的连接调度至负载较低的关联节点上。
   权重分配策略	代理终端	选择读请求调度策略为轮询调度时的权重分配策略。可选择自动分配或自定义分配。 自动分配 选择此分配策略时，系统将根据该连接终端所关联的节点的规格，为各节点自动分配权重。 自定义分配 选择自定义分配时，页面会展示该连接终端关联的节点，由您在列表中为各节点设置权重。默认权重根据节点规格自动计算。权重输入范围为 0～10000，且必须是 100 的整数倍。 说明 请尽量按节点规格比例设置权重，防止节点压力不均造成资源浪费。
   只读延迟阈值	代理终端	设置连接终端的只读延迟阈值。延迟时间超过此阈值的只读节点将不会被分配读请求。取值范围是 1~3600，单位为秒，步长为 1。 说明 仅读写终端支持该设置。

相关 API