. . . . . . . . . . . . . . . . . 403 9.4 错误码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405 9.4.1 SQL 错误码 . . . . . . . . . . . . . . . . . . . . . . 其他异常 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 9.4.2 服务器错误码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 414 10 开发者手册 415 10.1 运行模式 . 511 13.6.1 其他如果 SQL 在 ShardingSphere 中执行不正确，该如何调试？ . . . . . . . . . 511 13.6.2 其他阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . . . . 511 13.6.3 其他使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . . 511

. . . . . . . . . . . . . . . . . 384 9.4 错误码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385 9.4.1 SQL 错误码 . . . . . . . . . . . . . . . . . . . . . . 其他异常 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 9.4.2 服务器错误码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394 10 开发者手册 395 10.1 运行模式 . 490 13.6.1 其他如果 SQL 在 ShardingSphere 中执行不正确，该如何调试？ . . . . . . . . . 490 13.6.2 其他阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . . . . 490 13.6.3 其他使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . . 490

. . . . . . . . . . . . . . . . . 431 9.4 错误码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433 9.4.1 SQL 错误码 . . . . . . . . . . . . . . . . . . . . . . 其他异常 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440 9.4.2 服务器错误码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440 10 开发者手册 441 10.1 运行模式 . 537 13.6.1 其他如果 SQL 在 ShardingSphere 中执行不正确，该如何调试？ . . . . . . . . . 537 13.6.2 其他阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . . . . 538 13.6.3 其他使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . . 538

也可以作为一个单独的引用。如果不唯一，有两个或两个以上的相同名称（比 如“com.foo.selectAllThings ”和“com.bar.selectAllThings”），那么使用时就会收到错误报告说短名称是不唯一的，这种情况下 就必须使用完全限定名。 对于像 BlogMapper 这样的映射器类（Mapper class）来说，还有另一招来处理。它们的映射的语句可以不需要用 XML 来做，取而 种方式，你 可以很轻松的在基于注解和 XML 的语句映射方式间自由移植和切换。 范围（ 范围（Scope）和生命周期 ）和生命周期 理解我们目前已经讨论过的不同范围和生命周期类是至关重要的，因为错误的使用会导致非常严重的并发问题。 提示 提示 提示 提示 对象生命周期和依赖注入框架 对象生命周期和依赖注入框架 依赖注入框架可以创建线程安全的、基于事务的 SqlSession 和映射器（mapper）并将它们直接注入到你的 HttpSession。如果你现在正在使用一种 Web 框架，要考虑 SqlSession 放在一个和 HTTP 请求对象相似的范围中。换句话说，每次收到的 HTTP 请求，就可以打开一个 SqlSession，返回一个 响应，就关闭它。这个关闭操作是很重要的，你应该把这个关闭操作放到 finally 块中以确保每次都能执行关闭。下面的示例就是一个 确保 SqlSession 关闭的标准模式： SqlSession session

. . . . . . . . . . . . . . . . . 268 4.4 错误码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 4.4.1 SQL 错误码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269 4.4.2 服务器错误码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 5 开发者手册 272 5.1 运行模式 . . . . . . . . . . . . . . . . . . . . . . . . . . . 426 8.6.1 其他如果 SQL 在 ShardingSphere 中执行不正确，该如何调试？ . . . . . . . . . 426 8.6.2 其他阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . . . . 427 8.6.3 其他使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . . 427

284 7.1 如果 SQL 在 ShardingSphere 中执行不正确，该如何调试？ . . . . . . . . . . . . . . . . 284 7.2 阅读源码时为什么会出现编译错误?IDEA 不索引生成的代码？ . . . . . . . . . . . . . . . 284 7.3 使用 Spring 命名空间时找不到 xsd? . . . . . . . . . . INTO t_order_1 (order_id, xxx) VALUES (1, 'xxx'), (3, 'xxx'); 使用 IN 的查询与批量插入的情况相似，不过 IN 操作并不会导致数据查询结果错误。通过对 IN 查询的改 写，可以进一步的提升查询性能。如以下 SQL： SELECT * FROM t_order WHERE order_id IN (1, 2, 3); 改写为： 3.1 {}‐>unix://localhost:80: Connection refused？ 回答：在构建镜像前，请确保 docker daemon 进程已经运行。 问题 2：启动时报无法连接到数据库错误？ 回答：请确保 /${your_work_dir}/conf/config‐xxx.yaml 配置文件中指定的 PostgreSQL 数据库的 IP 可以 被 Docker 容器内部访问到。

309 7.8.21 [其他] 如果 SQL 在 ShardingSphere 中执行不正确，该如何调试？ . . . . . . . . 309 7.8.22 [其他] 阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . . . 310 7.8.23 [其他] 使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . 310 能够将数据源和规则等元数据信息持久化，但无法将元数据同步至多个 Apache ShardingSphere 实例，无 法在集群环境中相互感知。通过某一实例更新元数据之后，会导致其他实例由于获取不到最新的元数据 而产生不一致的错误。适用于工程师在本地搭建 Apache ShardingSphere 环境。 3.2.4 集群模式 提供了多个 Apache ShardingSphere 实例之间的元数据共享和分布式场景下状态协调的能力。在真实部 的资源为其他节点提供服务。 4.2. 管控 23 Apache ShardingSphere document, v5.1.1 限流 面对超负荷的请求开启限流，以保护部分请求可以得以高质量的响应。 4.3 数据分片 4.3.1 背景 传统的将数据集中存储至单一节点的解决方案，在性能、可用性和运维成本这三方面已经难于满足海量 数据的场景。 从性能方面来说，由于关系型数据库大多采用 B+

305 7.8.21 [其他] 如果 SQL 在 ShardingSphere 中执行不正确，该如何调试？ . . . . . . . . 305 7.8.22 [其他] 阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . . . 306 7.8.23 [其他] 使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . 306 能够将数据源和规则等元数据信息持久化，但无法将元数据同步至多个 Apache ShardingSphere 实例，无 法在集群环境中相互感知。通过某一实例更新元数据之后，会导致其他实例由于获取不到最新的元数据 而产生不一致的错误。适用于工程师在本地搭建 Apache ShardingSphere 环境。 3.2.4 集群模式 提供了多个 Apache ShardingSphere 实例之间的元数据共享和分布式场景下状态协调的能力。在真实部 的资源为其他节点提供服务。 4.2. 管控 23 Apache ShardingSphere document, v5.1.0 限流 面对超负荷的请求开启限流，以保护部分请求可以得以高质量的响应。 4.3 数据分片 4.3.1 背景 传统的将数据集中存储至单一节点的解决方案，在性能、可用性和运维成本这三方面已经难于满足海量 数据的场景。 从性能方面来说，由于关系型数据库大多采用 B+

320 7.8.21 [其他] 如果 SQL 在 ShardingSphere 中执行不正确，该如何调试？ . . . . . . . . 321 7.8.22 [其他] 阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . . . 321 7.8.23 [其他] 使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . . . 321 能够将数据源和规则等元数据信息持久化，但无法将元数据同步至多个 Apache ShardingSphere 实例，无 法在集群环境中相互感知。通过某一实例更新元数据之后，会导致其他实例由于获取不到最新的元数据 而产生不一致的错误。适用于工程师在本地搭建 Apache ShardingSphere 环境。 3.2.4 集群模式 提供了多个 Apache ShardingSphere 实例之间的元数据共享和分布式场景下状态协调的能力。在真实部 Apache ShardingSphere 节点超过负载后，停止 该节点对数据库的访问，使数据库能够保证足够的资源为其他节点提供服务。 限流 面对超负荷的请求开启限流，以保护部分请求可以得以高质量的响应。 4.3 数据分片 4.3.1 背景 传统的将数据集中存储至单一节点的解决方案，在性能、可用性和运维成本这三方面已经难于满足海量 数据的场景。 从性能方面来说，由于关系型数据库大多采用 B+

7.7.18 18. [其他] 如果 SQL 在 ShardingSphere 中执行不正确，该如何调试？ . . . . . . 292 7.7.19 19. [其他] 阅读源码时为什么会出现编译错误? IDEA 不索引生成的代码？ . . . . 292 7.7.20 20. [其他] 使用 SQLSever 和 PostgreSQL 时，聚合列不加别名会抛异常？ . . . . 293 7 {}‐>unix://localhost:80: Connection refused？ 回答：在构建镜像前，请确保 docker daemon 进程已经运行。 问题 2：启动时报无法连接到数据库错误？ 回答：请确保 /${your_work_dir}/conf/config-xxx.yaml 配置文件中指定的 PostgreSQL 数据 库的 IP 可以被 Docker 容器内部访问到。 INTO t_order_1 (order_id, xxx) VALUES (1, 'xxx'), (3, 'xxx'); 使用 IN 的查询与批量插入的情况相似，不过 IN 操作并不会导致数据查询结果错误。通过对 IN 查询的改 写，可以进一步的提升查询性能。如以下 SQL： SELECT * FROM t_order WHERE order_id IN (1, 2, 3); 改写为： 7.1