Apache ShardingSphere-JDBC 数据源配置详解

Apache ShardingSphere-JDBC 数据源配置详解

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-JDBC 中，数据源配置是构建分片、读写分离等功能的基础。数据源配置定义了应用程序如何连接到后端数据库实例，包括数据库连接信息、连接池参数等关键内容。

数据源配置的核心概念

支持范围

ShardingSphere-JDBC 具有出色的兼容性，支持：

1. 所有标准 JDBC 驱动的数据库
2. 主流数据库连接池（HikariCP、Druid、Tomcat JDBC 等）
3. 多种数据库类型（MySQL、PostgreSQL、Oracle 等）

配置结构

数据源配置采用 YAML 格式，主要包含以下部分：

dataSources:
  数据源名称1:
    连接参数...
  数据源名称2:
    连接参数...

详细参数解析

基础参数

1. dataSourceClassName：数据源实现类的全限定名，如 com.zaxxer.hikari.HikariDataSource
2. driverClassName：JDBC 驱动类名，如 com.mysql.jdbc.Driver
3. jdbcUrl：数据库连接 URL，格式取决于具体数据库
4. username：数据库用户名
5. password：数据库密码

连接池特有参数

不同连接池可能有不同的参数命名约定，例如：

• HikariCP 使用 jdbcUrl
• Druid 使用 url
• Tomcat JDBC Pool 使用 url

实际配置示例

基本配置

dataSources:
  primary_db:
    dataSourceClassName: com.zaxxer.hikari.HikariDataSource
    driverClassName: com.mysql.jdbc.Driver
    jdbcUrl: jdbc:mysql://localhost:3306/primary_db
    username: db_user
    password: db_password
    maximumPoolSize: 20
    connectionTimeout: 30000

多数据源配置

dataSources:
  order_db_0:
    dataSourceClassName: com.zaxxer.hikari.HikariDataSource
    driverClassName: com.mysql.jdbc.Driver
    jdbcUrl: jdbc:mysql://192.168.0.1:3306/order_db_0
    username: order_user
    password: order_pwd
    maxLifetime: 1800000

  order_db_1:
    dataSourceClassName: com.zaxxer.hikari.HikariDataSource
    driverClassName: com.mysql.jdbc.Driver
    jdbcUrl: jdbc:mysql://192.168.0.2:3306/order_db_1
    username: order_user
    password: order_pwd
    maxLifetime: 1800000

  user_db:
    dataSourceClassName: com.alibaba.druid.pool.DruidDataSource
    driverClassName: com.mysql.jdbc.Driver
    url: jdbc:mysql://192.168.0.3:3306/user_db
    username: user_admin
    password: user_pwd
    initialSize: 5
    maxActive: 20

最佳实践建议

1. 连接池选择：根据应用场景选择合适的连接池，高并发推荐 HikariCP，需要监控选 Druid
2. 参数调优：根据实际负载调整连接池大小、超时等参数
3. 命名规范：数据源名称应具有描述性，便于后续维护
4. 安全考虑：密码建议使用配置中心管理，而非明文写在配置文件中
5. 多环境配置：不同环境（开发、测试、生产）使用不同的数据源配置

常见问题解答

Q：为什么我的 Druid 配置不生效？

A：Druid 使用 url 而非 jdbcUrl，这是 Druid 的特定配置方式，不是 ShardingSphere 的限制。

Q：可以混合使用不同的连接池吗？

A：可以，ShardingSphere 支持在同一配置中使用不同连接池的数据源。

Q：如何监控数据源状态？

A：可以通过各自连接池的监控功能，或结合 ShardingSphere 的治理模块实现。

通过合理配置数据源，可以为 ShardingSphere-JDBC 的分片、读写分离等高级功能奠定坚实基础。建议在实际使用前充分测试数据源配置，确保连接参数和连接池参数符合应用需求。

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