. 56 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 密文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 查询辅助列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 明文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 4.8.5 使用规范 . . . . . . . . . . . . . . 8.22 [其他] 阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . . . 310 7.8.23 [其他] 使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . 310 7.8.24 [其他] Oracle 数据库使用 Timestamp 类型的 Order By 语句抛出异常提示“Order by value must

. 56 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 密文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 查询辅助列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 明文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 4.8.5 使用规范 . . . . . . . . . . . . . . 8.22 [其他] 阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . . . 306 7.8.23 [其他] 使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . 306 7.8.24 [其他] Oracle 数据库使用 Timestamp 类型的 Order By 语句抛出异常提示“Order by value must

. 57 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 密文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 查询辅助列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 明文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 4.7.5 使用规范 . . . . . . . . . . . . . . . . . 59 影子算法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60 列影子算法 DML 语句支持度列表 . . . . . . . . . . . . . . . . . . . . . . . . . . 60 5 用户手册 62 5.1 ShardingSphere‐JDBC

. 57 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 密文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 查询辅助列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 明文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 4.8.5 使用规范 . . . . . . . . . . . . . . 8.22 [其他] 阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . . . 321 7.8.23 [其他] 使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . 321 7.8.24 [其他] Oracle 数据库使用 Timestamp 类型的 Order By 语句抛出异常提示“Order by value must

. 41 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 密文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 查询辅助列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 明文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 3.8.7 使用限制 . . . . . . . . . . . . . . . . 44 基于 Hint 的影子算法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 iv 基于列的影子算法 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 3.10 可观察性 . . . . .

. 43 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 密文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 查询辅助列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 模糊查询列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 8.7.7 使用限制 . . . . . . . . . . . . . . . . 45 8.8.6 核心概念 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 8.8.7 使用限制 .

. 43 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 密文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 查询辅助列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 模糊查询列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 8.7.7 使用限制 . . . . . . . . . . . . . . . . 45 8.8.6 核心概念 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 8.8.7 使用限制 .

. 43 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 密文列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 查询辅助列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 模糊查询列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 8.7.7 使用限制 . . . . . . . . . . . . . . . . 45 8.8.6 核心概念 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 逻辑列 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 8.8.7 使用限制 .

ClassCastException: Integer can not cast to Long? . . . . . . . . . . . . 286 7.9 使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . . . . . . . . . 286 7.10 Oracle 数据库使用 Timestamp 类型的 Order By 语句抛出异常提示“Order by 认分布 式主键生成器会等待时钟同步到最后一次主键生成的时间后再继续工作。最大容忍的时钟回拨毫秒数的 默认值为 0，可通过属性设置。 强制分片路由 实现动机 通过解析 SQL 语句提取分片键列与值并进行分片是 Apache ShardingSphere 对 SQL 零侵入的实现方式。 若 SQL 语句中没有分片条件，则无法进行分片，需要全路由。 在一些应用场景中，分片条件并不存在于 S 改写为在真实数据库中可以正确执行的 SQL。它包括正确性改写和优化改写两部分。 正确性改写 在包含分表的场景中，需要将分表配置中的逻辑表名称改写为路由之后所获取的真实表名称。仅分库则 不需要表名称的改写。除此之外，还包括补列和分页信息修正等内容。 标识符改写 需要改写的标识符包括表名称、索引名称以及 Schema 名称。 表名称改写是指将找到逻辑表在原始 SQL 中的位置，并将其改写为真实表的过程。表名称改写是一个典

false true multipleResultSetsEnabled 是否允许单一语句 返回多结果集（需 要兼容驱动）。 true | false true useColumnLabel 使用列标签代替列 名。不同的驱动在 这方面会有不同的 表现， 具体可参考 相关驱动文档或通 过测试这两种不同 的模式来观察所用 驱动的结果。 true | false true useGeneratedKeys PDFmyURL SqlSession 的不同 调用将不会共享数 据。 jdbcTypeForNull 当没有为参数提供 特定的 JDBC 类型 时，为空值指定 JDBC 类型。 某些 驱动需要指定列的 JDBC 类型，多数情 况直接用一般类型 即可，比如 NULL、 VARCHAR 或 OTHER。 JdbcType enumeration. Most common are: NULL, VARCHAR selectKey 子元素设置它的键值，默认： unset 。如果希望得到多个生成的列，也可以是逗号分 隔的属性名称列表。 keyColumn （仅对 insert 和 update 有用）通过生成的键值设置表中的列名，这个设置仅在某些数据库（像 PostgreSQL）是必须的，当主键列不是表中的第一列的时候需要设置。如果希望得到多个生成的列，也可以是 逗号分隔的属性名称列表。 databaseId 如果配置了