。 该文档 xdoc 格式的源码文件可通过项目的 Git 代码库 来获取。Fork 该源码库，做出更新，然后提交一个 pull request 吧。 你将成为本文档的最佳作者，MyBatis 的用户定会过来查阅的。 当前的国际化版本 当前的国际化版本 MyBatis 的其他语言版本： English Español 日本語 한국어 简体中文 你想使用本地语言来了解MyBatis吗？那就将它翻译成你的母语并提供给我们吧！ BlogMapper.selectBlog", 101); } finally { session.close(); } 诚然这种方式能够正常工作，并且对于使用旧版本 MyBatis 的用户来说也比较熟悉，不过现在有了一种更直白的方式。使用对于给定 语句能够合理描述参数和返回值的接口（比如说BlogMapper.class），你现在不但可以执行更清晰和类型安全的代码，而且还不用担 心易错的字符串字面值以及强制类型转换。 pages as PDF manually or automatically with PDFmyURL url – 这是数据库的 JDBC URL 地址。 username – 登录数据库的用户名。 password – 登录数据库的密码。 defaultTransactionIsolationLevel – 默认的连接事务隔离级别。 作为可选项，你也可以传递属性给数据库驱动。要这样做，属性的前缀为“driver

. . . . 62 ShardingSphere‐Proxy 中使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64 5 用户手册 66 5.1 ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143 5.2.2 YAML 配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 权限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145 属性配置 . . 方言以及数据库存储的灵活适配，快速的连接应用与多模式的异构 数据库； • 增量：获取数据库的访问流量，并提供流量重定向（数据分片、读写分离、影子库）、流量变形（数 据加密、数据脱敏）、流量鉴权（安全、审计、权限）、流量治理（熔断、限流）以及流量分析（服 务质量分析、可观察性）等透明化增量功能； • 可插拔：项目采用微内核 + 三层可插拔模型，使内核、功能组件以及生态对接完全能够灵活的方式 进行插拔式

. . . . 61 ShardingSphere‐Proxy 中使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63 5 用户手册 65 5.1 ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140 5.2.2 YAML 配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 权限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142 属性配置 . . 方言以及数据库存储的灵活适配，快速的连接应用与多模式的异构 数据库； • 增量：获取数据库的访问流量，并提供流量重定向（数据分片、读写分离、影子库）、流量变形（数 据加密、数据脱敏）、流量鉴权（安全、审计、权限）、流量治理（熔断、限流）以及流量分析（服 务质量分析、可观察性）等透明化增量功能； • 可插拔：项目采用微内核 + 三层可插拔模型，使内核、功能组件以及生态对接完全能够灵活的方式 进行插拔式

. . . . 63 ShardingSphere‐Proxy 中使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66 5 用户手册 67 5.1 ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146 5.2.2 YAML 配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149 权限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150 属性配置 . . 区分同一日志中的 database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198 区分同一日志中的 database 和用户 . . . . . . . . . . . . . . . . . . . . . . . . . . 199 拆分为不同的日志文件 . . . . . . . . . . . . . . .

. . . . . . . . . 60 列影子算法 DML 语句支持度列表 . . . . . . . . . . . . . . . . . . . . . . . . . . 60 5 用户手册 62 5.1 ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 数据源配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 权限配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200 属性配置 . . . 方言以及数据库存储的灵活适配，快速的连接应用与多模式的异构 数据库； • 增量：获取数据库的访问流量，并提供流量重定向（数据分片、读写分离、影子库）、流量变形（数 据加密、数据脱敏）、流量鉴权（安全、审计、权限）、流量治理（熔断、限流）以及流量分析（服 务质量分析、可观察性）等透明化增量功能； • 可插拔：项目采用微内核 + 三层可插拔模型，使内核、功能组件以及生态对接完全能够灵活的方式 进行插拔式

51 8.11.6 使用限制 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 9 用户手册 52 9.1 ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 安全稳定 基于成熟数据库底座之上提供增量能力，兼顾安全性及稳定性。 • 弹性扩展 具备计算、存储平滑在线扩展能力，可满足业务多变的需求。 • 开放生态 通过多层次（内核、功能、生态）插件化能力，为用户提供可定制满足自身特殊需求的独有系统。 1.3. 产品优势 2 2 设计哲学 ShardingSphere 采用 Database Plus 设计哲学，该理念致力于构建数据库上层的标准和生态，在生态中 式可通过可插拔的方式更换。主要包 括查询优化器、分布式事务引擎、分布式执行引擎、权限引擎和调度引擎等。 2.3.2 L2 功能层 用于提供增量能力，其所有组件均是可选的，可以包含零至多个组件。组件之间完全隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据加密、影子库等。用户自定义 功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动内核代码。

50 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 9 用户手册 51 9.1 ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 安全稳定 基于成熟数据库底座之上提供增量能力，兼顾安全性及稳定性。 • 弹性扩展 具备计算、存储平滑在线扩展能力，可满足业务多变的需求。 • 开放生态 通过多层次（内核、功能、生态）插件化能力，为用户提供可定制满足自身特殊需求的独有系统。 1.3. 产品优势 2 2 设计哲学 ShardingSphere 采用 Database Plus 设计哲学，该理念致力于构建数据库上层的标准和生态，在生态中 式可通过可插拔的方式更换。主要包 括查询优化器、分布式事务引擎、分布式执行引擎、权限引擎和调度引擎等。 2.3.2 L2 功能层 用于提供增量能力，其所有组件均是可选的，可以包含零至多个组件。组件之间完全隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据加密、影子库等。用户自定义 功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动内核代码。

50 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50 9 用户手册 51 9.1 ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 安全稳定 基于成熟数据库底座之上提供增量能力，兼顾安全性及稳定性。 • 弹性扩展 具备计算、存储平滑在线扩展能力，可满足业务多变的需求。 • 开放生态 通过多层次（内核、功能、生态）插件化能力，为用户提供可定制满足自身特殊需求的独有系统。 1.3. 产品优势 2 2 设计哲学 ShardingSphere 采用 Database Plus 设计哲学，该理念致力于构建数据库上层的标准和生态，在生态中 式可通过可插拔的方式更换。主要包 括查询优化器、分布式事务引擎、分布式执行引擎、权限引擎和调度引擎等。 2.3.2 L2 功能层 用于提供增量能力，其所有组件均是可选的，可以包含零至多个组件。组件之间完全隔离，互无感知，多 组件可通过叠加的方式相互配合使用。主要包括数据分片、读写分离、数据加密、影子库等。用户自定义 功能可完全面向 Apache ShardingSphere 定义的顶层接口进行定制化扩展，而无需改动内核代码。

48 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 4 用户手册 49 4.1 ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171 4.2.2 YAML 配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178 权限 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179 属性配置 . . 安全稳定 基于成熟数据库底座之上提供增量能力，兼顾安全性及稳定性。 • 弹性扩展 具备计算、存储平滑在线扩展能力，可满足业务多变的需求。 • 开放生态 通过多层次（内核、功能、生态）插件化能力，为用户提供可定制满足自身特殊需求的独有系统。 1.1. 什么是 ShardingSphere 2 Apache ShardingSphere document, v5.2.0 1.1.4 线路规划

128 附录 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151 4 用户手册 153 4.1 ShardingSphere‐JDBC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 数据源配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256 v 权限配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257 属性配置 . . . 详情参见使用手册。 2.3. ShardingSphere-Scaling(Alpha) 7 3 概念 & 功能 本章节阐述 Apache ShardingSphere 相关的概念与功能，更多使用细节请阅读用户手册。 3.1 数据分片 3.1.1 背景 传统的将数据集中存储至单一数据节点的解决方案，在性能、可用性和运维成本这三方面已经难于满足 互联网的海量数据场景。 从性能方面来说，由于关系型数据库大多采用