Apache ShardingSphere Proxy 属性配置详解

Apache ShardingSphere Proxy 属性配置详解

shardingsphere Distributed SQL transaction & query engine for data sharding, scaling, encryption, and more - on any database. 项目地址: https://gitcode.com/gh_mirrors/sh/shardingsphere

概述

Apache ShardingSphere Proxy 作为一款数据库中间件，提供了丰富的系统属性配置选项，这些配置直接影响着 Proxy 的运行行为和性能表现。本文将深入解析这些配置参数的含义、使用场景以及最佳实践，帮助用户根据实际需求进行合理配置。

核心配置参数解析

日志相关配置

1. 系统日志级别 (system-log-level)

   • 作用：控制 ShardingSphere 系统日志的输出级别
   • 可选值：DEBUG、INFO、WARN、ERROR
   • 建议：生产环境推荐使用 INFO 级别，排查问题时可以临时调整为 DEBUG

2. SQL 打印 (sql-show)

   • 作用：是否在日志中输出执行的 SQL 语句
   • 优势：方便开发者查看实际执行的 SQL 和路由结果
   • 注意：开启后会增加日志量，生产环境慎用

3. SQL 简单模式 (sql-simple)

   • 作用：简化 SQL 日志输出格式
   • 适用场景：当只需要查看 SQL 语句本身而不需要详细解析信息时

线程池与连接配置

1. 内核执行线程数 (kernel-executor-size)

   • 作用：设置任务处理线程池的大小
   • 特点：每个数据源使用独立线程池
   • 默认值：无限制（infinite）
   • 建议：根据服务器CPU核心数和并发量合理设置

2. 每查询最大连接数 (max-connections-size-per-query)

   • 作用：控制单个查询在每个数据库实例上能使用的最大连接数
   • 影响：值越大并行度越高，但资源消耗也越大
   • 默认值：1（串行执行）

Proxy 特有配置

1. 前端刷新阈值 (proxy-frontend-flush-threshold)

   • 作用：设置传输数据条数的IO刷新阈值
   • 原理：累积到指定数量的数据记录后才会触发网络IO操作
   • 调优：增大该值可减少网络IO次数，但会增加内存使用

2. 后端查询获取大小 (proxy-backend-query-fetch-size)

   • 作用：控制每次从数据库获取的数据行数
   • 特殊值：-1表示使用JDBC驱动的最小值
   • 注意：增大该值会提高查询效率但增加内存压力

3. 前端最大连接数 (proxy-frontend-max-connections)

   • 作用：限制可连接到Proxy的客户端数量
   • 默认值：0（无限制）
   • 建议：生产环境应根据服务器资源设置合理上限

网络与安全配置

1. 默认端口 (proxy-default-port)

   • 作用：设置Proxy的默认监听端口
   • 常用值：MySQL协议通常使用3307，PostgreSQL使用5433

2. SSL/TLS配置

   • 启用SSL (proxy-frontend-ssl-enabled)：是否启用前端连接加密
   • SSL版本 (proxy-frontend-ssl-version)：指定使用的协议版本
   • 加密套件 (proxy-frontend-ssl-cipher)：指定支持的加密算法

动态配置与静态配置

ShardingSphere Proxy 的配置分为两类：

1. 动态生效配置：修改后立即生效，无需重启

   • 如：sql-show、max-connections-size-per-query等

2. 静态配置：需要重启Proxy才能生效

   • 如：kernel-executor-size、proxy-default-port等

最佳实践建议

1. 生产环境配置建议：

   • 关闭sql-show或仅在需要时开启
   • 设置合理的前端最大连接数
   • 根据业务特点调整每查询最大连接数

2. 性能调优方向：

   • 增大proxy-frontend-flush-threshold可提升吞吐量
   • 适当增加proxy-backend-query-fetch-size可减少网络往返

3. 安全建议：

   • 生产环境建议启用SSL/TLS加密
   • 使用较新的TLS协议版本（如TLSv1.3）

配置示例参考

props:
  system-log-level: INFO
  sql-show: false
  kernel-executor-size: 16
  max-connections-size-per-query: 5
  proxy-frontend-flush-threshold: 256
  proxy-backend-query-fetch-size: -1
  proxy-frontend-max-connections: 200
  proxy-default-port: 3307
  proxy-frontend-ssl-enabled: true
  proxy-frontend-ssl-version: "TLSv1.2,TLSv1.3"

通过合理配置这些参数，可以显著提升 ShardingSphere Proxy 的性能、稳定性和安全性，使其更好地适应不同的业务场景和性能需求。

shardingsphere Distributed SQL transaction & query engine for data sharding, scaling, encryption, and more - on any database. 项目地址: https://gitcode.com/gh_mirrors/sh/shardingsphere