2.3.4 任务管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2.3.5 相关文档 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3 概念 10 3.1 接入端 %SHARDINGSPHERE_PROXY_HOME%/bin/start.sh 2.3.4 任务管理 通过相应的 DistSQL 接口管理迁移任务。 详情请参见使用手册。 2.3.5 相关文档 • 功能 # 弹性伸缩：核心概念、使用规范 • 用户手册 # 弹性伸缩：运行部署、使用手册 • RAL# 弹性伸缩：弹性伸缩的 DistSQL • 开发者手册 # 弹性伸缩：SPI 接口及实现类 otherProperties); 5.1.2 YAML 配置 简介 YAML 提供通过配置文件的方式与 ShardingSphere‐JDBC 交互。配合治理模块一同使用时，持久化在配 置中心的配置均为 YAML 格式。 YAML 配置是最常见的配置方式，可以省略编程的复杂度，简化用户配置。 使用步骤 引入 Maven 依赖 org.apache.shardingsphere

更多使用细节请参见使用示例。 4.1.1 YAML 配置 简介 YAML 提供通过配置文件的方式与 ShardingSphere‐JDBC 交互。配合治理模块一同使用时，持久化在配 置中心的配置均为 YAML 格式。 YAML 配置是最常见的配置方式，可以省略编程的复杂度，简化用户配置。 49 Apache ShardingSphere document, v5.2.0 使用步骤 引入 Maven 依赖 ShardingSphere 面向可插拔的一部分。本章节是 ShardingSphere‐JDBC 的 YAML 规则配 置参考手册。 数据分片 背景信息 数据分片 YAML 配置方式具有非凡的可读性，通过 YAML 格式，能够快速地理解分片规则之间的依赖关 系，ShardingSphere 会根据 YAML 配置，自动完成 ShardingSphereDataSource 对象的创建，减少用户 不必要的编码工作。 databases-tables.yaml")); 相关参考 • 核心特性：数据分片 • 开发者指南：数据分片 读写分离 背景信息 读写分离 YAML 配置方式可读性高，通过 YAML 格式，能够快速地理解读写分片规则之间的依赖关系， ShardingSphere 会根据 YAML 配置，自动完成 ShardingSphereDataSource 对象的创建，减少用户不必 要的编码工作。

更多使用细节请参见使用示例。 9.1.1 YAML 配置 简介 YAML 提供通过配置文件的方式与 ShardingSphere‐JDBC 交互。配合治理模块一同使用时，持久化在配 置中心的配置均为 YAML 格式。 说明：YAML 配置文件支持配置内容超过 3MB。 YAML 配置是最常见的配置方式，可以省略编程的复杂度，简化用户配置。 51 Apache ShardingSphere document ShardingSphere 面向可插拔的一部分。本章节是 ShardingSphere‐JDBC 的 YAML 规则配 置参考手册。 数据分片 背景信息 数据分片 YAML 配置方式具有非凡的可读性，通过 YAML 格式，能够快速地理解分片规则之间的依赖关 系，ShardingSphere 会根据 YAML 配置，自动完成 ShardingSphereDataSource 对象的创建，减少用户 不必要的编码工作。 g- databases-tables.yaml")); 相关参考 • 核心特性：数据分片 • 开发者指南：数据分片 广播表 广播表 YAML 配置方式具有非凡的可读性，通过 YAML 格式，能够快速地理解广播表配置，ShardingSphere 会根据 YAML 配置，自动完成 ShardingSphereDataSource 对象的创建，减少用户不必要的编码工作。 参数解释 rules:

4 4. 任务管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2.3.5 5. 相关文档 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3 概念 10 3.1 接入端 . %SHARDINGSPHERE_PROXY_HOME%/bin/start.sh 2.3.4 4. 任务管理 通过相应的 DistSQL 接口管理迁移任务。 详情请参见使用手册。 2.3.5 5. 相关文档 • 功能 # 弹性伸缩：核心概念、使用规范 • 用户手册 # 弹性伸缩：运行部署、使用手册 • RAL# 弹性伸缩：弹性伸缩的 DistSQL • 开发者手册 # 弹性伸缩：SPI 接口及实现类 ShardingSphere 的特点之一。在使用 ShardingSphere‐Proxy 时，开发者虽然可以像使用数据库一样操作数据，但却需要通过 YAML 文件（或注册中心）配置资源和 规则。然而，YAML 格式的展现形式，以及注册中心动态修改带来的操作习惯变更，对于运维工程师并不 友好。 DistSQL 让用户可以像操作数据库一样操作 Apache ShardingSphere，使其从面向开发人员的框架和中间

otherProperties); 5.1.2 YAML 配置 简介 YAML 提供通过配置文件的方式与 ShardingSphere‐JDBC 交互。配合治理模块一同使用时，持久化在配 置中心的配置均为 YAML 格式。 YAML 配置是最常见的配置方式，可以省略编程的复杂度，简化用户配置。 使用步骤 引入 Maven 依赖 org.apache.shardingsphere shardingsphere.driver.ShardingSphereDriver URL 配置说明 • 以 jdbc:shardingsphere: 为前缀 • 配置文件：xxx.yaml，配置文件格式与 YAML 配置一致 • 配置文件加载规则： – 无前缀表示从绝对路径加载配置文件 – classpath: 前缀表示从类路径中加载配置文件 5.1.4 Spring Boot Starter ng 分片的结束时间范围，时间戳格 式：yyyy‐MM‐dd HH:mm:ss sh arding‐ seconds lo ng 单一分片所能承载的最大时间， 单位：秒，允许分片键的时间戳 格式的秒带有时间精度，但秒后 的时间精度会被自动抹去 标准分片算法 Apache ShardingSphere 内置的标准分片算法实现类包括： 行表达式分片算法 使用 Groovy 的表达式，提供对

2.3.4 任务管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2.3.5 相关文档 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 3 概念 10 3.1 接入端 %SHARDINGSPHERE_PROXY_HOME%/bin/start.sh 2.3.4 任务管理 通过相应的 DistSQL 接口管理迁移任务。 详情请参见使用手册。 2.3.5 相关文档 • 功能 # 弹性伸缩：核心概念、使用规范 • 用户手册 # 弹性伸缩：运行部署、使用手册 • RAL# 弹性伸缩：弹性伸缩的 DistSQL • 开发者手册 # 弹性伸缩：SPI 接口及实现类 otherProperties); 5.1.2 YAML 配置 简介 YAML 提供通过配置文件的方式与 ShardingSphere‐JDBC 交互。配合治理模块一同使用时，持久化在配 置中心的配置均为 YAML 格式。 YAML 配置是最常见的配置方式，可以省略编程的复杂度，简化用户配置。 使用步骤 引入 Maven 依赖 org.apache.shardingsphere

更多使用细节请参见使用示例。 9.1.1 YAML 配置 简介 YAML 提供通过配置文件的方式与 ShardingSphere‐JDBC 交互。配合治理模块一同使用时，持久化在配 置中心的配置均为 YAML 格式。 说明：YAML 配置文件支持配置内容超过 3MB。 YAML 配置是最常见的配置方式，可以省略编程的复杂度，简化用户配置。 51 Apache ShardingSphere document ShardingSphere 面向可插拔的一部分。本章节是 ShardingSphere‐JDBC 的 YAML 规则配 置参考手册。 数据分片 背景信息 数据分片 YAML 配置方式具有非凡的可读性，通过 YAML 格式，能够快速地理解分片规则之间的依赖关 系，ShardingSphere 会根据 YAML 配置，自动完成 ShardingSphereDataSource 对象的创建，减少用户 不必要的编码工作。 g- databases-tables.yaml")); 相关参考 • 核心特性：数据分片 • 开发者指南：数据分片 广播表 广播表 YAML 配置方式具有非凡的可读性，通过 YAML 格式，能够快速地理解广播表配置，ShardingSphere 会根据 YAML 配置，自动完成 ShardingSphereDataSource 对象的创建，减少用户不必要的编码工作。 参数解释 rules:

支持多种方言的 SQL 解析 数据库 支持状态 MySQL 支持，完善 PostgreSQL 支持，完善 SQLServer 支持 Oracle 支持 SQL92 支持 • 提供 SQL 格式化功能（开发中） • 提供 SQL 模板化功能（开发中） API 使用 引入 Maven 依赖 org.apache.shardingsphere SQLVisitorEngine(databaseType, "STATEMENT "); SQLStatement sqlStatement = sqlVisitorEngine.visit(tree); • SQL 格式化 /** * databaseType type:String 可能指 MySQL * useCache type:boolean 是否使用缓存 * @return String */ 提供熔断数据库访问程序对数据库的访问和禁用从库的访问的编排治理能力。治理模块仍然有大量 未完成的功能（比如流控等）。 注册中心数据结构 在定义的命名空间下，rules 、props 和 metadata 节点以 YAML 格式存储配置，可通过修改节点来实 现对于配置的动态管理。states 存储数据库访问对象运行节点，用于区分不同数据库访问实例。 namespace ├──rules # 全局规则配置 ├──props

更多使用细节请参见使用示例。 9.1.1 YAML 配置 简介 YAML 提供通过配置文件的方式与 ShardingSphere‐JDBC 交互。配合治理模块一同使用时，持久化在配 置中心的配置均为 YAML 格式。 说明：YAML 配置文件支持配置内容超过 3MB。 YAML 配置是最常见的配置方式，可以省略编程的复杂度，简化用户配置。 52 Apache ShardingSphere document ShardingSphere 面向可插拔的一部分。本章节是 ShardingSphere‐JDBC 的 YAML 规则配 置参考手册。 数据分片 背景信息 数据分片 YAML 配置方式具有非凡的可读性，通过 YAML 格式，能够快速地理解分片规则之间的依赖关 系，ShardingSphere 会根据 YAML 配置，自动完成 ShardingSphereDataSource 对象的创建，减少用户 不必要的编码工作。 g- databases-tables.yaml")); 相关参考 • 核心特性：数据分片 • 开发者指南：数据分片 广播表 广播表 YAML 配置方式具有非凡的可读性，通过 YAML 格式，能够快速地理解广播表配置，ShardingSphere 会根据 YAML 配置，自动完成 ShardingSphereDataSource 对象的创建，减少用户不必要的编码工作。 参数解释 rules:

业名称，如果修改名称将视为新的作业。作业名称节点下又包含 5 个数据子节点，分别是 config, instances, sharding, servers 和 leader。 config 节点 作业配置信息，以 YAML 格式存储。 instances 节点 作业运行实例信息，子节点是当前作业运行实例的主键。作业运行实例主键由作业运行服务器的 IP 地址 和 PID 构成。作业运行实例主键均为临时节点，当作业实例上线时注册，下线时自动清理。注册中心监 可通过属性配置 http.url,http.method,http.data 等配置待请求的 http 信息。分片信息以 Header 形式传递，key 为 shardingContext，值为 json 格式。 public class HttpJobMain { public static void main(String[] args) { new ScheduleJobBootstrap(regCenter execute() 方法执行作业。 OneOffJobBootstrap bean 的名称通过属性 jobBootstrapBeanName 配置，注入时需要指定依赖的 bean 名称。具体配置请参考配置文档。 elasticjob: jobs: myOneOffJob: jobBootstrapBeanName: myOneOffJobBean .... @RestController public