在Sharding-Proxy以及Sharding-JDBC 1.5.0版本之后提供了sql.show的配置，可以将解析上下文和改写后的SQL以及最终路由至的数据源的细节信息全部打印至info日志。 sql.show配置默认关闭，如果需要请通过配置开启。

2. 阅读源码时为什么会出现编译错误?

回答：

ShardingSphere使用lombok实现极简代码。关于更多使用和安装细节，请参考lombok官网。

sharding-orchestration-reg模块需要先执行mvn install命令，根据protobuf文件生成gRPC相关的java文件。

3. 使用Spring命名空间时找不到xsd?

回答：

Spring命名空间使用规范并未强制要求将xsd文件部署至公网地址，但考虑到部分用户的需求，我们也将相关xsd文件部署至ShardingSphere官网。

实际上sharding-jdbc-spring-namespace的jar包中META-INF\spring.schemas配置了xsd文件的位置：META-INF\namespace\sharding.xsd和META-INF\namespace\master-slave.xsd，只需确保jar包中该文件存在即可。

4. Cloud not resolve placeholder … in string value …异常的解决方法?

回答：

行表达式标识符可以使用${...}或$->{...}，但前者与Spring本身的属性文件占位符冲突，因此在Spring环境中使用行表达式标识符建议使用$->{...}。

5. inline表达式返回结果为何出现浮点数？

回答：

Java的整数相除结果是整数，但是对于inline表达式中的Groovy语法则不同，整数相除结果是浮点数。 想获得除法整数结果需要将A/B改为A.intdiv(B)。

6. 如果只有部分数据库分库分表，是否需要将不分库分表的表也配置在分片规则中？

回答：

是的。因为ShardingSphere是将多个数据源合并为一个统一的逻辑数据源。因此即使不分库分表的部分，不配置分片规则ShardingSphere即无法精确的断定应该路由至哪个数据源。 但是ShardingSphere提供了两种变通的方式，有助于简化配置。

方法1：配置default-data-source，凡是在默认数据源中的表可以无需配置在分片规则中，ShardingSphere将在找不到分片数据源的情况下将表路由至默认数据源。

方法2：将不参与分库分表的数据源独立于ShardingSphere之外，在应用中使用多个数据源分别处理分片和不分片的情况。

7. ShardingSphere除了支持自带的分布式自增主键之外，还能否支持原生的自增主键？

回答：是的，可以支持。但原生自增主键有使用限制，即不能将原生自增主键同时作为分片键使用。

由于ShardingSphere并不知晓数据库的表结构，而原生自增主键是不包含在原始SQL中内的，因此ShardingSphere无法将该字段解析为分片字段。如自增主键非分片键，则无需关注，可正常返回；若自增主键同时作为分片键使用，ShardingSphere无法解析其分片值，导致SQL路由至多张表，从而影响应用的正确性。

而原生自增主键返回的前提条件是INSERT SQL必须最终路由至一张表，因此，面对返回多表的INSERT SQL，自增主键则会返回零。

回答：

必须确保数据库表中该字段和分片算法该字段类型一致，如：数据库中该字段类型为int(11)，泛型所对应的分片类型应为Integer，如果需要配置为Long类型，请确保数据库中该字段类型为bigint。

9. 使用SQLSever和PostgreSQL时，聚合列不加别名会抛异常？

SQLServer和PostgreSQL获取不加别名的聚合列会改名。例如，如下SQL：

SQLServer获取到的列为空字符串和(2)，PostgreSQL获取到的列为空sum和sum(2)。这将导致ShardingSphere在结果归并时无法找到相应的列而出错。

正确的SQL写法应为：

  1. SELECT SUM(num) AS sum_num, SUM(num2) AS sum_num2 FROM tablexxx;

10. Oracle数据库使用Timestamp类型的Order By语句抛出异常提示“Order by value must implements Comparable”?

回答：

针对上面问题解决方式有两种： 1.配置启动JVM参数“-oracle.jdbc.J2EE13Compliant=true” 2.通过代码在项目初始化时设置System.getProperties().setProperty(“oracle.jdbc.J2EE13Compliant”, “true”);

原因如下:

com.dangdang.ddframe.rdb.sharding.merger.orderby.OrderByValue#getOrderValues()方法如下:

使用了resultSet.getObject(int index)方法，针对TimeStamp oracle会根据oracle.jdbc.J2EE13Compliant属性判断返回java.sql.TimeStamp还是自定义oralce.sql.TIMESTAMP 详见ojdbc源码oracle.jdbc.driver.TimestampAccessor#getObject(int var1)方法：

  1.     Object getObject(int var1) throws SQLException {
  2.         Object var2 = null;
  3.         if(this.rowSpaceIndicator == null) {
  4.             DatabaseError.throwSqlException(21);
  7.         if(this.rowSpaceIndicator[this.indicatorIndex + var1] != -1) {
  8.             if(this.externalType != 0) {
  9.                 switch(this.externalType) {
  10.                 case 93:
  11.                     return this.getTimestamp(var1);
  12.                 default:
  13.                     DatabaseError.throwSqlException(4);
  14.                     return null;
  15.                 }
  16.             }
  18.             if(this.statement.connection.j2ee13Compliant) {
  19.                 var2 = this.getTimestamp(var1);
  20.                 var2 = this.getTIMESTAMP(var1);
  21.             }
  24.         return var2;
  25.     }

11. 使用Proxool时分库结果不正确？

回答：

使用Proxool配置多个数据源时，应该为每个数据源设置alias，因为Proxool在获取连接时会判断连接池中是否包含已存在的alias，不配置alias会造成每次都只从一个数据源中获取连接。

以下是Proxool源码中ProxoolDataSource类getConnection方法的关键代码：

更多关于alias使用方法请参考。

PS：sourceforge网站需要翻墙访问。

12. ShardingSphere提供的默认分布式自增主键策略为什么是不连续的，且尾数大多为偶数？

回答：

ShardingSphere采用snowflake算法作为默认的分布式自增主键策略，用于保证分布式的情况下可以无中心化的生成不重复的自增序列。因此自增主键可以保证递增，但无法保证连续。

而snowflake算法的最后4位是在同一毫秒内的访问递增值。因此，如果毫秒内并发度不高，最后4位为零的几率则很大。因此并发度不高的应用生成偶数主键的几率会更高。

在3.1.0版本中，尾数大多为偶数的问题已彻底解决，参见：

13. Windows环境下，通过Git克隆ShardingSphere源码时为什么提示文件名过长，如何解决？

回答：

为保证源码的可读性，ShardingSphere编码规范要求类、方法和变量的命名要做到顾名思义，避免使用缩写，因此可能导致部分源码文件命名较长。由于Windows版本的Git是使用msys编译的，它使用了旧版本的Windows Api，限制文件名不能超过260个字符。

解决方案如下：

  1. git config --global core.longpaths true

如果是Windows 10，还需要通过注册表或组策略，解除操作系统的文件名长度限制（需要重启）：

参考资料： https://ourcodeworld.com/articles/read/109/how-to-solve-filename-too-long-error-in-git-powershell-and-github-application-for-windows

14. Windows环境下，运行Sharding-Proxy，找不到或无法加载主类 org.apache.shardingshpere.shardingproxy.Bootstrap，如何解决？

回答：

某些解压缩工具在解压Sharding-Proxy二进制包时可能将文件名截断，导致找不到某些类。

解决方案：

打开cmd.exe并执行下面的命令：

回答：

ShardingSphere中很多功能实现类的加载方式是通过SPI注入的方式完成的，如分布式主键，注册中心等；这些功能通过配置中type类型来寻找对应的SPI实现，因此必须在配置文件中指定类型。

16. 为什么我实现了ShardingKeyGenerator接口，也配置了Type，但是自定义的分布式主键依然不生效？

回答：

Service Provider Interface (SPI)是一种为了被第三方实现或扩展的API，除了实现接口外，还需要在META-INF/services中创建对应文件来指定SPI的实现类，JVM才会加载这些服务。

具体的SPI使用方式，请大家自行搜索。

与分布式主键ShardingKeyGenerator接口相同，其他ShardingSphere的也需要用相同的方式注入才能生效。

17. JPA 和 数据脱敏无法一起使用，如何解决？

回答：

由于数据脱敏的DDL尚未开发完成，因此对于自动生成DDL语句的JPA与数据脱敏一起使用时，会导致JPA的实体类(Entity)无法同时满足DDL和DML的情况。

解决方案如下：

  1. 以需要脱敏的逻辑列名编写JPA的实体类(Entity)。
  2. 关闭JPA的auto-ddl，如 auto-ddl=none。
  3. 手动建表，建表时应使用数据脱敏配置的cipherColumn,plainColumn和assistedQueryColumn代替逻辑列。

18. 服务启动时如何加快metadata加载速度？

回答：

  1. 升级到4.0.1以上的版本，以提高default dataSource的table metadata的加载速度。
  2. 参照你采用的连接池，将配置项max.connections.size.per.query（默认值为1）调高（版本 >= 3.0.0.M3）。

19. 如何在inline分表策略时，允许执行范围查询操作（BETWEEN AND、>、<、>=、<=）？

回答：

  1. 需要使用4.1.0以上版本。
  2. 将配置项allow.range.query.with.inline.sharding设置为true即可（默认为false）。
  3. 需要注意的是，此时所有的范围查询将会使用广播的方式查询每一个分表。

20. 为什么配置了某个数据连接池的spring-boot-starter（比如druid）和sharding-jdbc-spring-boot-starter时，系统启动会报错？

回答：

  1. 因为数据连接池的starter（比如druid）可能会先加载并且其创建一个默认数据源，这将会使得sharding-jdbc创建数据源时发生冲突。
  2. 解决办法为，去掉数据连接池的starter即可，sharing-jdbc自己会创建数据连接池。

21. 在使用sharing-proxy的时候，如何动态在sharding-ui上添加新的logic schema？

回答：

  1. 4.1.0之前的版本不支持动态添加或删除logic schema的功能，例如一个proxy启动的时候有2个logic schema，就会一直持有这2个schema，只能感知这两个schema内部的表和rule的变更事件。
  2. 4.1.0版本支持在sharding-ui或直接在zookeeper上增加新的logic schema，删除logic schema的功能计划在5.0.0版本支持。
  1. sharding-proxy可以看做是一个mysql server，所以首选支持mysql命令连接和操作。