ShardingSphere-JDBC 内置算法：元数据存储配置详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00957/article/details/148362704

ShardingSphere-JDBC 内置算法：元数据存储配置详解

shardingsphere 项目地址: https://gitcode.com/gh_mirrors/shard/shardingsphere

元数据存储的重要性

在分布式数据库中间件ShardingSphere-JDBC中，元数据存储是系统运行的核心组件之一。它负责保存分片规则、数据源配置、全局序列号等关键信息，直接影响着系统的稳定性和可靠性。

元数据存储的两种模式

ShardingSphere-JDBC支持两种运行模式，每种模式对应不同的元数据存储方式：

1. 单机模式(Standalone)

单机模式下，元数据存储在本地数据库中，适合开发和测试环境使用。主要特点包括：

配置简单，无需额外组件
数据存储在本地，性能较高
不支持多实例共享配置

2. 集群模式(Cluster)

集群模式下，元数据存储在分布式协调服务中，适合生产环境使用。主要特点包括：

支持多实例共享同一份配置
提供高可用性保证
需要额外的协调服务组件

单机模式存储配置详解

单机模式下，ShardingSphere-JDBC支持多种数据库作为元数据存储后端：

支持的数据库类型

| 数据库类型 | 依赖项 | 特点 | 适用场景 | |------------|--------|------|----------| | H2 | 内置 | 默认选项，简单易用 | 开发测试环境 | | MySQL | com.mysql:mysql-connector-j | 性能稳定 | 生产环境替代方案 | | EmbeddedDerby | org.apache.derby:derby | 嵌入式运行 | 需要嵌入式数据库的场景 | | DerbyNetworkServer | org.apache.derby:derbyclient | 独立服务运行 | 需要独立数据库服务的场景 | | HSQLDB | org.hsqldb:hsqldb | 内存数据库 | 快速测试场景 |

配置参数说明

mode:
  type: Standalone
  repository:
    type: JDBC
    props:
      provider: H2  # 数据库类型
      jdbc_url: jdbc:h2:mem:config  # JDBC连接URL
      username: sa  # 用户名
      password:   # 密码(可选)

关键参数详解：

provider：指定元数据存储的数据库类型
jdbc_url：数据库连接字符串，不同数据库格式不同
username/password：数据库认证信息

各数据库特殊配置

MySQL配置示例：

props:
  provider: MySQL
  jdbc_url: jdbc:mysql://localhost:3306/sharding_metadata
  username: root
  password: secure_password

EmbeddedDerby配置示例：

props:
  provider: EmbeddedDerby
  jdbc_url: jdbc:derby:memory:config;create=true

HSQLDB内存模式示例：

props:
  provider: HSQLDB
  jdbc_url: jdbc:hsqldb:mem:config
  username: SA

集群模式存储配置详解

集群模式下，ShardingSphere-JDBC支持多种分布式协调服务作为元数据存储后端：

ZooKeeper配置

mode:
  type: Cluster
  repository:
    type: ZooKeeper
    props:
      namespace: governance_ds  # 命名空间
      server-lists: localhost:2181  # 服务器列表
      retryIntervalMilliseconds: 500  # 重试间隔
      timeToLiveSeconds: 60  # 临时数据存活时间
      maxRetries: 3  # 最大重试次数
      operationTimeoutMilliseconds: 500  # 操作超时时间

关键参数说明：

namespace：用于隔离不同环境的命名空间
server-lists：ZooKeeper集群地址，多个用逗号分隔
retryIntervalMilliseconds：连接失败后的重试间隔
timeToLiveSeconds：临时节点的存活时间
digest：可选参数，用于ZooKeeper认证

Etcd配置

mode:
  type: Cluster
  repository:
    type: Etcd
    props:
      timeToLiveSeconds: 30  # 临时数据存活时间
      connectionTimeout: 30  # 连接超时时间(秒)

关键参数说明：

timeToLiveSeconds：键值对的存活时间
connectionTimeout：建立连接的超时时间

配置建议与最佳实践

开发环境：建议使用H2或HSQLDB内存模式，简单快捷
测试环境：可以使用EmbeddedDerby或MySQL
生产环境：强烈建议使用集群模式，配合ZooKeeper或Etcd
安全考虑：
- 为生产环境配置适当的用户名/密码
- 定期备份元数据
- 限制元数据存储服务的访问权限
性能调优：
- 根据集群规模调整ZooKeeper的超时参数
- 监控元数据存储的性能指标

常见问题解决方案

H2数据库兼容性问题：
- 解决方案：在生产环境使用MySQL或其他数据库替代
Derby版本兼容性问题：
- 确保JDK版本≥19
- 检查Derby依赖版本一致性
ZooKeeper连接不稳定：
- 适当增加retryIntervalMilliseconds和maxRetries
- 检查网络状况和ZooKeeper服务状态