Apache ShardingSphere 5.2.1 Document

• 语言: 英语
• 格式: .pdf
• 来源: shardingsphere.apache.org

摘要

文档详细介绍了Apache ShardingSphere 5.2.1的功能和配置，包括ShardingSphere-Proxy的配置手册、数据迁移解决方案、数据库协议兼容性、YAML配置方式以及分布式数据库的管理。ShardingSphere-Proxy支持通过YAML配置实现数据分片、读写分离、数据加密和影子库等功能，并与ShardingSphere-JDBC的配置保持一致。文档还提到ShardingSphere支持MySQL和PostgreSQL协议，能够自动转换SQL方言，并通过DistSQL进行配置管理。数据迁移功能自4.1.0版本起提供，适用于将单库数据迁移到分片数据库的场景，支持通过ZooKeeper进行集群模式配置。

AI总结

以下是对《Apache ShardingSphere 5.2.1 Document》文档内容的简要总结，重点突出核心观点和关键信息：

---

### **Apache ShardingSphere 5.2.1 简要总结**

#### **1. ShardingSphere-Proxy 配置**
- **规则操作**:
- 创建影子规则：通过 `CREATE SHADOW RULE` 指令定义源数据源和影子数据源，支持多种算法（如 `SIMPLE_HINT` 和 `REGEX_MATCH`）。
- 修改影子规则：通过 `ALTER SHADOW RULE` 指令更新影子数据源或表规则。
- 删除影子规则：通过 `DROP SHADOW RULE` 指令移除影子规则。
- 删除资源：通过 `DROP RESOURCE` 删除数据源。
- 删除分布式数据库：通过 `DROP DATABASE` 删除逻辑数据库。

- **功能支持**:
ShardingSphere-Proxy 支持数据分片、读写分离、数据加密和影子库的配置，通过 DistSQL 和 YAML 配置实现灵活管理。
- 配置示例：

    mode: type: Cluster
    repository:
      type: ZooKeeper
      props:
        namespace: governance_ds
        server-lists: localhost:2181

#### **2. 数据迁移**
- **背景**:
ShardingSphere 自 4.1.0 版本起支持数据迁移，可帮助用户从单数据库平滑迁移至水平分片数据库。
- **前提条件**:
- Proxy 基于 Java 开发，需 JDK 1.8 或更高版本支持。
- 数据迁移需集群模式，当前支持 ZooKeeper 作为注册中心。
- **迁移步骤**:
1. 编译 ShardingSphere-Proxy 二进制包：

     git clone --depth 1 https://github.com/apache/shardingsphere.git
     cd shardingsphere
     mvn clean install -Dmaven.javadoc.skip=true -Dcheckstyle.skip=true -Drat.skip=true -Djacoco.skip=true -DskipITs -DskipTests -Prelease

2. 解压代理包并修改 `config-sharding.yaml` 和 `server.yaml` 配置文件。
3. 启动注册中心（如 ZooKeeper）。

#### **3. 观测性（Observability）**
- **性能监控**:
支持通过 Prometheus 收集集群统计指标。
- **日志追踪**:
支持 SkyWalking、Zipkin、Jaeger 和 OpenTelemetry 等工具，提供 SQL 解析和执行追踪功能。
- **配置示例**:
- 使用 OpenTelemetry：根据 SDK 自动配置指南填写配置文件。
- 使用 SkyWalking：启用插件并配置 SkyWalking 的 APM 工具包。

#### **4. 数据库网关**
- **功能**:
支持 SQL 方言翻译，实现不同数据库间的自动转换。例如，用户可通过 MySQL 客户端连接 ShardingSphere，并发送基于 MySQL 方言的 SQL，ShardingSphere 可自动转换为 PostgreSQL 的 SQL。

#### **5. 配置手册**
- **概述**:
ShardingSphere-Proxy 的配置是与应用开发者交互的唯一模块，通过 YAML 配置和 DistSQL 指令可灵活配置功能。配置符配合 ShardingSphere-JDBC 的规则配置保持一致。
- **启动**:
- 提供二进制 Tar 包部署，需要 Java JRE 8 或更高版本支持。

#### **6. 运行模式**
- **单机模式**:
适用于本地环境，无法同步元数据至多个 ShardingSphere 实例，适合开发和测试。
- **集群模式**:
支持多实例间元数据共享和分布式协调，提供高可用性和水平扩展能力，建议在生产环境中使用。

---

通过以上总结，可以快速了解 Apache ShardingSphere 5.2.1 的核心功能、配置方法和典型应用场景。