Mysql JDBC Url参数说明useUnicode=true&characterEncoding=UTF-8

Posted 2020-08-06 mracalele

MySQL的 JDBC URL 格式 for  Connector/J 如下例：

jdbc:mysql://[host][,failoverhost...][:port]/[database] »
[?propertyName1][=propertyValue1][&propertyName2][=propertyValue2]...

jdbc:mysql://[host:port],[host:port].../[database] »
[?propertyName1][=propertyValue1][&propertyName2][=propertyValue2]...

实例：
jdbc:mysql://localhost:3306/sakila?profileSQL=true

 

现只列举几个重要的参数，如下表所示：

参数名称                    参数说明                                                                                                                         缺省值     最低版本要求
user                      数据库用户名（用于连接数据库）                                                                                                                  所有版本
password                   用户密码（用于连接数据库）                                                                                                                     所有版本
useUnicode              是否使用Unicode字符集，如果参数characterEncoding设置为gb2312或gbk，本参数值必须设置为true                                                   false     1.1g
characterEncoding       当useUnicode设置为true时，指定字符编码。比如可设置为gb2312或gbk                                                                           false     1.1g
autoReconnect                当数据库连接异常中断时，是否自动重新连接？                                                                                           false     1.1
autoReconnectForPools     是否使用针对数据库连接池的重连策略                                                                                                     false     3.1.3
failOverReadOnly         自动重连成功后，连接是否设置为只读？                                                                                                    true     3.0.12
maxReconnects           autoReconnect设置为true时，重试连接的次数                                                                                                 3     1.1
initialTimeout        autoReconnect设置为true时，两次重连之间的时间间隔，单位：秒                                                                                    2     1.1
connectTimeout       和数据库服务器建立socket连接时的超时，单位：毫秒。 0表示永不超时，适用于JDK 1.4及更高版本                                                            0     3.0.1
socketTimeout          socket操作（读写）超时，单位：毫秒。 0表示永不超时                                                                                            0     3.0.1

 对应中文环境，通常mysql连接URL可以设置为：
jdbc:mysql://localhost:3306/test?user=root&password=&useUnicode=true&characterEncoding=gbk&autoReconnect=true&failOverReadOnly=false

在使用数据库连接池的情况下，最好设置如下两个参数：
autoReconnect=true&failOverReadOnly=false

需要注意的是，在xml配置文件中，url中的&符号需要转义成&。比如在tomcat的server.xml中配置数据库连接池时，mysql jdbc url样例如下：
jdbc:mysql://localhost:3306/test?user=root&password=&useUnicode=true&characterEncoding=gbk
&autoReconnect=true&failOverReadOnly=false

 

mysql sql语句别名不生效问题： useOldAliasMetadataBehavior

实例：

 

 

jdbc:mysql://localhost/openemm?useUnicode=yes&characterEncoding=UTF-8&useOldAliasMetadataBehavior=true

其中：dbc: mysql://localhost/openemm?这个代表数据库链接地址，

useUnicode=yes&characterEncoding=UTF-8这个代表允许用户自己设定数据库编码，而且设置成UTF-8
  useOldAliasMetadataBehavior=true这个代表数据库里面允许有别名