的 默认值为 0，可通过属性设置。 强制分片路由 实现动机 通过解析 SQL 语句提取分片键列与值并进行分片是 Apache ShardingSphere 对 SQL 零侵入的实现方式。 若 SQL 语句中没有分片条件，则无法进行分片，需要全路由。 在一些应用场景中，分片条件并不存在于 SQL，而存在于外部业务逻辑。因此需要提供一种通过外部指 定分片结果的方式，在 Apache ShardingSphere 修改资源时会发生连接池的切换，这个操作可能对进行中的业务造成影响，请 谨慎使用； • DROP RESOURCE 只会删除逻辑资源，不会删除真实的数据源； • 被规则引用的资源将无法被删除； • 若资源只被 single table rule 引用，且用户确认可以忽略该限制，则可以添加可选参数 ignore single tables 进行强制删除。 示例 ADD RESOURCE resource_0 需要改写的标识符包括表名称、索引名称以及 Schema 名称。 表名称改写是指将找到逻辑表在原始 SQL 中的位置，并将其改写为真实表的过程。表名称改写是一个典 型的需要对 SQL 进行解析的场景。从一个最简单的例子开始，若逻辑 SQL 为： SELECT order_id FROM t_order WHERE order_id=1; 假设该 SQL 配置分片键 order_id，并且 order_id=1 的情况，将路由至分片表

的 默认值为 0，可通过属性设置。 强制分片路由 实现动机 通过解析 SQL 语句提取分片键列与值并进行分片是 Apache ShardingSphere 对 SQL 零侵入的实现方式。 若 SQL 语句中没有分片条件，则无法进行分片，需要全路由。 在一些应用场景中，分片条件并不存在于 SQL，而存在于外部业务逻辑。因此需要提供一种通过外部指 定分片结果的方式，在 Apache ShardingSphere 修改资源时会发生连接池的切换，这个操作可能对进行中的业务造成影响，请 谨慎使用 • DROP RESOURCE 只会删除逻辑资源，不会删除真实的数据源 • 被规则引用的资源将无法被删除 • 若资源只被 single table rule 引用，且用户确认可以忽略该限制，则可以添加可选参数 ignore single tables 进行强制删除 5.2. ShardingSphere-Proxy 需要改写的标识符包括表名称、索引名称以及 Schema 名称。 表名称改写是指将找到逻辑表在原始 SQL 中的位置，并将其改写为真实表的过程。表名称改写是一个典 型的需要对 SQL 进行解析的场景。从一个最简单的例子开始，若逻辑 SQL 为： SELECT order_id FROM t_order WHERE order_id=1; 假设该 SQL 配置分片键 order_id，并且 order_id=1 的情况，将路由至分片表

的 默认值为 0，可通过属性设置。 强制分片路由 实现动机 通过解析 SQL 语句提取分片键列与值并进行分片是 Apache ShardingSphere 对 SQL 零侵入的实现方式。 若 SQL 语句中没有分片条件，则无法进行分片，需要全路由。 在一些应用场景中，分片条件并不存在于 SQL，而存在于外部业务逻辑。因此需要提供一种通过外部指 定分片结果的方式，在 Apache ShardingSphere 修改资源时会发生连接池的切换，这个操作可能对进行中的业务造成影响，请 谨慎使用； • DROP RESOURCE 只会删除逻辑资源，不会删除真实的数据源； • 被规则引用的资源将无法被删除； • 若资源只被 single table rule 引用，且用户确认可以忽略该限制，则可以添加可选参数 ignore single tables 进行强制删除。 示例 ADD RESOURCE resource_0 需要改写的标识符包括表名称、索引名称以及 Schema 名称。 表名称改写是指将找到逻辑表在原始 SQL 中的位置，并将其改写为真实表的过程。表名称改写是一个典 型的需要对 SQL 进行解析的场景。从一个最简单的例子开始，若逻辑 SQL 为： SELECT order_id FROM t_order WHERE order_id=1; 假设该 SQL 配置分片键 order_id，并且 order_id=1 的情况，将路由至分片表

的 默认值为 0，可通过属性设置。 强制分片路由 实现动机 通过解析 SQL 语句提取分片键列与值并进行分片是 Apache ShardingSphere 对 SQL 零侵入的实现方式。 若 SQL 语句中没有分片条件，则无法进行分片，需要全路由。 在一些应用场景中，分片条件并不存在于 SQL，而存在于外部业务逻辑。因此需要提供一种通过外部指 定分片结果的方式，在 Apache ShardingSphere 需要改写的标识符包括表名称、索引名称以及 Schema 名称。 表名称改写是指将找到逻辑表在原始 SQL 中的位置，并将其改写为真实表的过程。表名称改写是一个典 型的需要对 SQL 进行解析的场景。从一个最简单的例子开始，若逻辑 SQL 为： SELECT order_id FROM t_order WHERE order_id=1; 假设该 SQL 配置分片键 order_id，并且 order_id=1 的情况，将路由至分片表 数据，但该数据并未能通过查询的 SQL 返回。这种情况主要是针对 GROUP BY 和 ORDER BY。结果归并 时，需要根据 GROUP BY 和 ORDER BY 的字段项进行分组和排序，但如果原始 SQL 的选择项中若并未包 含分组项或排序项，则需要对原始 SQL 进行改写。先看一下原始 SQL 中带有结果归并所需信息的场景： SELECT order_id, user_id FROM t_order ORDER

行过程中服务器宕机，失效转移允许将该次未完成的任务在另一作业节点上补偿执行。 5.3.1 概念 失效转移是当前执行作业的临时补偿执行机制，在下次作业运行时，会通过重分片对当前作业分配进行 调整。举例说明，若作业以每小时为间隔执行，每次执行耗时 30 分钟。如下如图所示。 图中表示作业分别于 12:00，13:00 和 14:00 执行。图中显示的当前时间点为 13:00 的作业执行中。 如果作业的其中一个分片服务器在 执行时长超过其运行间隔，错过任务重执行能够 保证作业在完成上次的任务后继续执行逾期的作业。 5.4.1 概念 错过任务重执行功能可以使逾期未执行的作业在之前作业执行完成之后立即执行。举例说明，若作业以 每小时为间隔执行，每次执行耗时 30 分钟。如下如图所示。 图中表示作业分别于 12:00，13:00 和 14:00 执行。图中显示的当前时间点为 13:00 的作业执行中。 如果 12：00 行的常规监听器和分布式场景中仅单一节点执行的分布式监听器。本章节将详细介绍他们的使用方式。 在作业依赖（DAG）功能开发完成之后，可能会考虑删除作业监听器功能。 监听器开发 常规监听器 若作业处理作业服务器的文件，处理完成后删除文件，可考虑使用每个节点均执行清理任务。此类型任 务实现简单，且无需考虑全局分布式任务是否完成，应尽量使用此类型监听器。 public class MyJobListener

的 默认值为 0，可通过属性设置。 强制分片路由 实现动机 通过解析 SQL 语句提取分片键列与值并进行分片是 Apache ShardingSphere 对 SQL 零侵入的实现方式。 若 SQL 语句中没有分片条件，则无法进行分片，需要全路由。 在一些应用场景中，分片条件并不存在于 SQL，而存在于外部业务逻辑。因此需要提供一种通过外部指 定分片结果的方式，在 Apache ShardingSphere . load-balance-algorithm-type= # 从库负载均衡算法类型，可选值：ROUND_ROBIN，RANDOM。若`load- balance-algorithm-class-name`存在则忽略该配置 spring.shardingsphere.props.sql.show= # 是否开启 SQL 显示，默认值: . load-balance-algorithm-type= # 从库负载均衡算法类型，可选值：ROUND_ROBIN，RANDOM。若`load- balance-algorithm-class-name`存在则忽略该配置 sharding.jdbc.config.config.map.key1= # 用户自定义配置 sharding

利用本地 缓存机制（Local Cache）防止循环 引用（circular references）和加 速重复嵌套查询。 默认值为 SESSION，这种情 况下会缓存一个会 话中执行的所有查 询。 若设置值为 STATEMENT，本 地会话仅用在语句 执行上，对相同 SESSION | STATEMENT SESSION Save web pages as PDF manually or automatically 发送到数据库的侦测查询，用来检验连接是否处在正常工作秩序中并准备接受请求。默认是“NO PING QUERY SET”，这会导致多数数据库驱动失败时带有一个恰当的错误消息。 poolPingEnabled – 是否启用侦测查询。若开启，也必须使用一个可执行的 SQL 语句设置 poolPingQuery 属性（最好是一个非常快 的 SQL），默认值：false。 poolPingConnectionsNotUsedFor one click with http://pdfmyurl.com! 这条语句提供了一个可选的文本查找类型的功能。如果没有传入“title”，那么所有处于“ACTIVE”状态的BLOG都会返回；反之若传入 了“title”，那么就会把模糊查找“title”内容的BLOG结果返回（就这个例子而言，细心的读者会发现其中的参数值是可以包含一些掩码 或通配符的）。 如果想可选地通过“title”和“au

组件尚未完全 支持在构建 Native Image 时使用 javaagent，你需要关注尚未关闭的 https://github.com/oracle/graal/is sues/1065 。 若用户期望在 ShardingSphere Proxy Native 下使用这类 Java Agent，则需要关注 https://github.com/o racle/graal/pull/8077 时，导出当前使用的逻辑库；如果也未使用逻辑库则提示 No database selected； • 未指定 filePath 时，会将导出的信息通过结果集输出； • 指定 filePath 时，会自动创建文件，若文件已存在，会被覆盖。 示例 • 导出当前逻辑库的配置信息 mysql> EXPORT DATABASE CONFIGURATION; +--------------------------- ShardingSphere document 操作步骤 使用需要使用 行表达式的属性时，如在 数据分片功能中，在 actualDataNodes 属性下指明特定的 SPI 实现的 Type Name 即可。 若 行表达式不指明 SPI 的 Type Name，默认将使用 GROOVY 的 SPI 实现。 配置示例 rules: - !SHARDING tables: t_order: actualDataNodes:

修改资源时会发生连接池的切换，此操作可能对进行中的业务造成影响，请谨 慎使用； • DROP RESOURCE 只会删除逻辑资源，不会删除真实的数据源； • 被规则引用的资源将无法被删除； • 若资源只被 single table rule 引用，且用户确认可以忽略该限制，则可以添加可选参数 ignore single tables 进行强制删除。 示例 ADD RESOURCE resource_0 需要改写的标识符包括表名称、索引名称以及 Schema 名称。 表名称改写是指将找到逻辑表在原始 SQL 中的位置，并将其改写为真实表的过程。表名称改写是一个典 型的需要对 SQL 进行解析的场景。从一个最简单的例子开始，若逻辑 SQL 为： SELECT order_id FROM t_order WHERE order_id=1; 假设该 SQL 配置分片键 order_id，并且 order_id=1 的情况，将路由至分片表 数据，但该数据并未能通过查询的 SQL 返回。这种情况主要是针对 GROUP BY 和 ORDER BY。结果归并 时，需要根据 GROUP BY 和 ORDER BY 的字段项进行分组和排序，但如果原始 SQL 的选择项中若并未包 含分组项或排序项，则需要对原始 SQL 进行改写。先看一下原始 SQL 中带有结果归并所需信息的场景： SELECT order_id, user_id FROM t_order ORDER

ShardingSphere document 操作步骤 使用需要使用 行表达式的属性时，如在 数据分片功能中，在 actualDataNodes 属性下指明特定的 SPI 实现的 Type Name 即可。 若 行表达式不指明 SPI 的 Type Name，默认将使用 GROOVY 的 SPI 实现。 配置示例 rules: - !SHARDING tables: t_order: actualDataNodes: 需要改写的标识符包括表名称、索引名称以及 Schema 名称。 表名称改写是指将找到逻辑表在原始 SQL 中的位置，并将其改写为真实表的过程。表名称改写是一个典 型的需要对 SQL 进行解析的场景。从一个最简单的例子开始，若逻辑 SQL 为： SELECT order_id FROM t_order WHERE order_id=1; 假设该 SQL 配置分片键 order_id，并且 order_id=1 的情况，将路由至分片表 数据，但该数据并未能通过查询的 SQL 返回。这种情况主要是针对 GROUP BY 和 ORDER BY。结果归并 时，需要根据 GROUP BY 和 ORDER BY 的字段项进行分组和排序，但如果原始 SQL 的选择项中若并未包 含分组项或排序项，则需要对原始 SQL 进行改写。先看一下原始 SQL 中带有结果归并所需信息的场景： SELECT order_id, user_id FROM t_order ORDER