# 连接参数参考 info参数连接的所有属性名称对大小写敏感。常用的属性如[表1]所示。 表1info参数的连接属性 | 属性名称 | 属性说明 | 属性值 | |:---|:---|:---| | PGDBNAME | 表示数据库名称（url中无需配置该参数，自动从Properties文件中解析）。 | 属性类型：String | | PGHOST | 主机IP地址（url中无需配置该参数，自动从Properties文件中解析），同时支持IPv4和IPv6。 | 属性类型：String | | PGPORT | 主机端口号（url中无需配置该参数，自动从Properties文件中解析）。 | 属性类型：Integer | | user | 表示创建连接的数据库用户。 | 属性类型：String | | password | 表示数据库用户的密码。 | 属性类型：String | | driverInfoMode | 控制驱动描述信息的输出模式。 | 属性类型：String 取值范围：postgresql、gaussdb。 - postgresql：表示输出postgresql相关的驱动描述信息。 - gaussdb：表示输出gaussdb相关的驱动描述信息。 默认值：postgresql | | enable_ce | 表示密态等值查询的能力。 | 属性类型：Integer 取值范围： - 1：表示JDBC支持密态等值查询基本能力。 - 其他值：表示不支持密态等值查询基本能力。 默认值：该属性不设置则为空，表示不支持密态等值查询。 | | refreshClientEncryption | 指定密态数据库是否支持客户端缓存刷新。 | 属性类型：String 取值范围： - 1或NULL：表示密态数据库支持客户端缓存刷新。 - 其他字符串：表示密态数据库不支持客户端缓存刷新。 默认值：NULL | | loggerLevel | 指定日志记录级别。 | 属性类型：String 取值范围：目前支持4种级别（不区分大小写）：OFF、INFO、DEBUG、TRACE。 - OFF：表示关闭日志。 - INFO、DEBUG和TRACE：表示记录的日志信息详细程度不同。 默认值：该属性不设置则为空，与设置为INFO等效。 | | loggerFile | 用于指定日志输出路径（目录和文件名）。一般要求明确指定日志目录和文件名。 若只指定文件名，未指定目录则日志生成在客户端运行程序目录；若不配置或配置的路径不存在，则日志会默认通过流输出。此参数已废弃，不再生效，如需使用可通过java.util.logging属性文件或系统属性进行配置。 | 属性类型：String | | logger | 表示JDBC Driver要使用的日志输出框架。JDBC Driver支持对接用户应用程序使用的日志输出框架。目前支持的第三方日志输出框架只有基于Slf4j-API的日志框架。具体使用方式请参见[日志管理](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0074.html#ZH-CN_TOPIC_0000002200578598)。 | 属性类型：String 取值范围：Slf4JLogger、JdkLogger - 如果缺省，则JDBC Driver使用JdkLogger。 - 采用基于Slf4j-API第三方日志框架。 | | allowEncodingChanges | 设置该参数值为true进行字符集类型更改，配合参数characterEncoding设置字符集，二者使用"\&"分隔。例：allowEncodingChanges=true\&characterEncoding=UTF8。 | 属性类型：Boolean 取值范围： - true：表示更改字符集类型。 - false：表示不更改字符集类型。 默认值：false | | characterEncoding | 需要配合allowEncodingChanges使用，allowEncodingChanges为false的情况下，characterEncoding仅允许设置为UTF8；allowEncodingChanges为true的情况下，characterEncoding可在取值范围内进行设置。 | 属性类型：String 取值范围：UTF8、GBK、LATIN1、GB18030 说明： 当连接到字符集为GB18030_2022的数据库时，characterEncoding设置为GB18030_2022不生效，会默认使用UTF8，需要设置为GB18030才能正常解析服务端的GB18030_2022字符。 默认值：UTF8 | | currentSchema | 设置当前连接的schema，在search-path（搜索路径）中指定要设置的schema。如果schema名包含除字母、数字、下划线之外的特殊字符，需要在schema名上加引号，注意加引号后schema名大小写敏感。如需配置多个schema，要用逗号","进行分隔。 例如：currentSchema=schema_a,"schema-b","schema/c" | 属性类型：String 缺省：如果未设置，则默认schema为连接使用的用户名。 | | loadBalanceHosts | 指定是否使用负载均衡功能。 须知： 集中式场景下，如果使用此参数需要保证业务中没有写操作。 | 属性类型：Boolean 取值范围： - true：表示使用洗牌算法从候选主机中随机选择一个主机建立连接。 - false：表示顺序连接url中指定的多个主机。 默认值：false | | hostRecheckSeconds | JDBC尝试连接主机后会保存主机状态：连接成功或连接失败。在hostRecheckSeconds时间内保持可信，超过则状态失效。 | 属性类型：Integer 属性单位：s 取值范围：0 \~ 2147483647 默认值：10 | | ssl | 表示以SSL方式连接数据库。包括NonValidatingFactory通道和使用证书的2种SSL连接方式。 | 属性类型：Boolean 取值范围： - true：表示以SSL方式连接数据库。 - false：表示不以SSL方式连接数据库。 默认值：该属性不设置则为空，与false等效。 | | sslmode | SSL认证方式。 | 属性类型：String 取值范围：disable、allow、prefer、require、verify-ca、verify-full。 - disable：不使用SSL安全连接。 - allow：如果数据库服务器要求使用，则可以使用SSL安全加密连接，但不验证数据库服务器的真实性。 - prefer：如果数据库支持，那么首选使用SSL连接，但不验证数据库服务器的真实性。 - require：只尝试SSL连接，不会检查服务器证书是否由受信任的CA签发，且不会检查服务器主机名与证书中的主机名是否一致。 - verify-ca：只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书。 - verify-full：只尝试SSL连接，并且验证服务器是否具有由可信任的证书机构签发的证书，以及验证服务器主机名是否与证书中的一致。 默认值：该属性不设置则为空，与require等效。 | | sslcert | 提供客户端证书文件的完整路径。证书类型为End Entity。 | 属性类型：String 默认值：该属性不设置则为空，读取用户根目录。 | | sslkey | 提供密钥文件的完整路径，使用时需将该密钥转换为DER格式。 ``` openssl pkcs8 -topk8 -outform DER -in client.key -out client.key.pk8 -nocrypt ``` | 属性类型：String 默认值：该属性不设置则为空，读取用户根目录。 | | sslrootcert | SSL根证书的文件名。根证书的类型为CA。 | 属性类型：String 默认值：该属性不设置则为空，读取用户根目录。 | | sslpassword | SSL密码，提供给ConsoleCallbackHandler使用。 | 属性类型：String | | sslpasswordcallback | SSL密码提供者的类名。 | 属性类型：String 默认值：com.huawei.opengauss.jdbc.ssl.jdbc4.LibPQFactory.ConsoleCallbackHandler | | sslfactory | 指定SSLSocketFactory在建立SSL连接时用的类名。 | 属性类型：String 默认值：该属性不设置则为空。 | | sslprivatekeyfactory | 指定实现私钥解密方法的接口com.huawei.opengauss.jdbc.ssl.PrivateKeyFactory的实现类的完整限定类名。如果不提供，首先尝试默认的jdk私钥解密算法，如果无法解密，则使用com.huawei.opengauss.jdbc.ssl.BouncyCastlePrivateKeyFactory，用户需要提供bcpkix-jdk15on.jar包，版本建议1.65以上。 | 属性类型：String 默认值：该属性不设置则为空，会尝试使用默认的jdk私钥解密算法进行解密。 | | sslfactoryarg | 此值是sslfactory类的构造函数的可选参数（不推荐使用）。 | 属性类型：String 默认值：该属性不设置则为空。 | | sslhostnameverifier | 主机名验证程序的类名。接口实现javax.net.ssl.HostnameVerifier，默认使用com.huawei.opengauss.jdbc.ssl.PGjdbcHostnameVerifier。 | 属性类型：String 默认值：该属性不设置则为空，默认使用com.huawei.opengauss.jdbc.ssl.PGjdbcHostnameVerifier。 | | loginTimeout | 指建立数据库连接的等待时间。当url配置多IP时，若获取连接花费的时间超过此值，则连接失败，不再尝试后续IP。 loginTimeout时间包括[connectTimeout]和[socketTimeoutInConnecting]，计算方式为：loginTimeout=(connectTimeout+连接认证时间+初始化语句执行时间)\*节点数量。 须知： - 此参数设置后对于多IP而言，时间是尝试连接IP的时间，可能会出现因为设置的值较小导致后面的IP无法连接的问题。例如设置了三个IP，如果loginTimeout为5s，但前两个IP建立连接总共用了5s，第三个IP会无法进行连接。 - 当CPU、内存、I/O负载中的任意一项接近100%时，会出现连接慢的现象，可能会导致连接时间超过阈值的问题，可通过以下方式进行问题排查： - 登录连接慢的物理机或通过管理工具查询资源负载：可通过top命令等确认CPU使用率；通过free命令确认内存使用情况；通过iostat命令确认I/O负载；此外还可以通过cm_agent中的监控日志，以及数据库运维平台中的监测记录进行检查。 - 针对短时间内大量慢查询导致的峰值负载场景，可通过\[数据库服务器的端口号+1\]端口连接，查询pg_stat_activity视图；针对慢查询，可以使用系统函数[•pg_terminate_backend(pid int)](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0380.html#ZH-CN_TOPIC_0000002200578778__zh-cn_topic_0000002235221473_zh-cn_topic_0283137194_zh-cn_topic_0237121991_zh-cn_topic_0059778344_lfc9fd61cf56440e089d1023ffc80ffcc)进行查杀会话。 - 针对业务量长期超负载情况（即无明显慢查询，或慢查询查杀后但新的查询依然会变成慢查询），应考虑降低业务负载、增加数据库资源的方式进行优化。 | 属性类型：Integer 属性单位：s（秒） 取值范围：0 \~ 2147483647。0表示已禁用，timeout不生效。 默认值：0 建议：配置后每次建立连接都会开启一个异步线程，在连接数较多的情况可能会导致客户端压力增大，可以根据业务酌情调整此参数，建议调整为max(connectTimeout, socketTimeoutInConnecting) \* 节点数，防止在网络异常情况且第n个IP为主的情况下无法连接。 | | connectTimeout | 用于连接服务器操作系统的超时值。如果连接到服务器操作系统花费的时间超过此值，则连接断开。当url配置多IP时，表示连接单个IP的超时时间。 | 属性类型：Integer 属性单位：s（秒） 取值范围：0 \~ 2147483647。0表示已禁用，timeout不生效。 默认值：0 | | socketTimeout | 用于socket读取操作的超时值。如果从服务器读取数据流所花费的时间超过此值，则连接关闭。如果不配置该参数，在数据库进程异常情况下，会导致客户端出现长时间等待，建议根据业务可以接受的SQL执行时间进行配置。 | 属性类型：Integer 属性单位：s（秒） 取值范围：0 \~ 2147483647。0表示已禁用，timeout不生效。 默认值：0 | | socketTimeoutInConnecting | 用于控制建立连接阶段socket读取操作的超时值。在建立连接阶段，如果从服务器读取数据流超过此阈值，则尝试查找下一个节点建立连接。 | 属性类型：Integer 属性单位：s（秒） 取值范围：0 \~ 2147483647。0表示已禁用，timeout不生效。 默认值：5 | | statementTimeout | 用于控制connection中statement执行时间的超时值。如果statement执行时间超过此值，则取消该statement执行。 | 属性类型：Integer 属性单位：ms（毫秒） 取值范围：0 \~ 2147483647。0表示已禁用，timeout不生效。 默认值：0 | | cancelSignalTimeout | 发送取消命令的消息本身可能会阻塞，用于控制取消命令的"connect超时"和"socket超时"。如果取消命令超过指定时间未响应，会中断该连接，减少占用客户端资源。 | 属性类型：Integer 属性单位：s（秒） 取值范围：0 \~ 2147483647。0表示已禁用，timeout不生效。 默认值：10 | | tcpKeepAlive | TCP保活探测功能的控制开关。 | 属性类型：Boolean 取值范围： - true：表示启用TCP保活探测功能。 - false：表示禁用TCP保活探测功能。 默认值：false | | logUnclosedConnections | 客户端可能由于未调用Connection对象的close()方法而泄漏Connection对象。最终这些对象将被回收，并且调用finalize()方法。 | 属性类型：Boolean 取值范围： - true：表示如果用户没有调用close()方法，finalize()方法将关闭Connection对象。 - false：表示如果用户没有调用close()方法，将不会关闭Connection对象。 默认值：false | | assumeMinServerVersion | 该参数设置要连接的服务器版本。 如assumeMinServerVersion高于或者等于9.0，可以在建立连接时减少相关包的发送，客户端不会发送请求将float精度设置为3（即维持原来设置的float精度2）。 | 属性类型：String 默认值：该属性不设置则为空。 | | ApplicationName | 表示正在连接的JDBC驱动名称。在数据库主节点上查询PG_STAT_ACTIVITY系统视图可以看到正在连接的客户端信息，application_name字段表示JDBC驱动名称。 | 属性类型：String 默认值：PostgreSQL JDBC Driver | | connectionExtraInfo | 表示驱动是否将当前驱动的部署路径、进程属主用户、url连接配置信息上报到数据库。 | 属性类型：Boolean 取值范围： - true：表示JDBC驱动会将当前驱动的部署路径、进程属主用户、url连接配置信息上报到数据库中，记录在connection_info参数里，同时可以在PG_STAT_ACTIVITY和PGXC_STAT_ACTIVITY中查询到。 - false：表示JDBC驱动不会将当前驱动的部署路径、进程属主用户、url连接配置信息上报到数据库中。 默认值：false | | autosave | 如果查询失败，指定驱动程序应该执行的操作。 | 属性类型：String 取值范围：always、never、conservative。 - always：表示JDBC驱动程序在每次查询之前设置一个保存点，并在失败时回滚到该保存点。 - never：表示无保存点。 - conservative：表示每次查询都会设置保存点，但是只会在"statement XXX无效"等情况下回滚并重试。 默认值：never | | protocolVersion | 连接协议版本号。 | 属性类型：Integer 取值范围：目前仅支持1和3。 - 1：表示连接V1服务端。 - 3：表示连接V5服务端。 默认值：该属性不设置则为空，与设置为3等效。 | | prepareThreshold | 该值决定PreparedStatement对象在执行多少次以后使用服务端已经解析好的statement。 说明： 不建议通过JDBC，并且使用prepareStatement方法执行涉及密码的语句（例如：CREATE USER user_name WITH PASSWORD '\*\*\*\*\*\*\*\*'；），原因是执行达到prepareThreshold指定次数时，数据库将SQL语句进行缓存，基于安全因素不会将密码进行缓存，该prepareStatement方法再次执行时会报错"Password must contain at least 8 characters."。 | 属性类型：Integer 取值范围：0 \~ 2147483647 默认值：5。意味着在执行同一个PreparedStatement对象时，在第五次及以上执行时不再向服务端发送parse消息对statement进行解析，而使用之前在服务端已经解析好的statement。 | | preparedStatementCacheQueries | 确定每个连接中缓存PreparedStatement对象所生成query的最大数量。 | 属性类型：Integer 取值范围：0 \~ 2147483647。0表示禁用缓存。 默认值：256。若在prepareStatement()调用中使用超过256个不同的查询，则最近最少使用的查询缓存将被丢弃。 建议：根据业务需要进行调整。配合prepareThreshold使用。 | | preparedStatementCacheSizeMiB | 确定每个连接中缓存PreparedStatement对象所生成query的最大值。 | 属性类型：Integer 属性单位：MB 取值范围：0 \~ 2147483647。0表示禁用缓存。 默认值：5。若缓存了超过5MB的query，则最近最少使用的查询缓存将被丢弃。 | | databaseMetadataCacheFields | 指定每个连接可缓存的字段的最大个数。 | 属性类型：Integer 取值范围：0 \~ 2147483647。0表示禁用缓存。 默认值：65536 | | databaseMetadataCacheFieldsMiB | 指定每个连接可缓存的字段的最大值。 | 属性类型：Integer 属性单位：MB 取值范围：0 \~ 2147483647。0表示禁用缓存。 默认值：5 | | stringtype | 指定调用java.sql.PreparedStatement#setString方法时传给数据库的参数类型。 | 属性类型：String 取值范围：unspecified、varchar。 - varchar：表示参数将作为varchar类型发送给服务器。 - unspecified：表示参数将不指定类型发送到服务器，服务器将尝试推断适当的类型。 默认值：varchar | | batchMode | 表示是否使用batch模式连接。 说明： 配置batchMode=on时，执行批量插入/批量修改操作，每一列的数据类型以第一条数据指定的类型为准，若数据类型混用可能会导致报错或者插入的数据异常。 | 属性类型：String 取值范围： - on：表示开启batch模式，可以提升批量更新的性能。设置batchMode=on执行成功的返回结果为\[count, 0, 0...0\]，数组第一个元素为批量影响的总条数。 - off：表示关闭batch模式。设置batchMode=off执行成功的返回结果为\[1, 1, 1...1\]，数组各元素对应单次修改的影响条数。 默认值：on 建议：如果本身业务框架（例如hibernate）在批量更新时会检测返回值，可以通过调整此参数来解决。 | | fetchsize | 设置数据库连接所创建statement的默认fetchsize。 确定一次fetch在ResultSet中读取的行数，与defaultRowFetchSize功能等价。如果fetchsize和defaultRowFetchSize同时设置，以fetchsize为准。 | 属性类型：Integer 取值范围：0 \~ 2147483647 默认值：0。表示一次从数据库获取所有结果。 建议：用户根据自身的业务查询数据数量和客户端机器内存情况来配置此参数，设置fetchsize时要关闭自动提交模式（autocommit=false），否则会导致fetchsize无法生效。 | | defaultRowFetchSize | 确定一次fetch在ResultSet中读取的行数。限制每次访问数据库时读取的行数可以避免不必要的内存消耗，从而避免OutOfMemoryException。 | 属性类型：Integer 取值范围：0 \~ 2147483647 默认值：0。表示一次从数据库获取所有结果。 | | reWriteBatchedInserts | 表示批量插入时，是否重写SQL语句。使用该参数时，要求设置batchMode=off。 | 属性类型：Boolean 取值范围： - true：表示批量插入时，可将N条插入语句合并为一条：INSERT INTO TABLE_NAME VALUES (values1, ..., valuesN), ..., (values1, ..., valuesN); - false：表示批量插入时，不重写SQL语句。 默认值：false | | unknownLength | 某些GaussDB类型（例如TEXT）没有明确定义的长度，当通过ResultSetMetaData.getColumnDisplaySize和ResultSetMetaData.getPrecision等函数返回关于这些类型的数据时，此参数指定未知长度类型的长度。 | 属性类型：Integer 取值范围：0 \~ 2147483647 默认值：2147483647 | | uppercaseAttributeName | 该属性开启后会将获取元数据的接口的查询结果转为大写。主要适用场景为数据库中存储元数据全为小写，但要使用大写的元数据作为出参和入参。 涉及到的接口请参见：[6.3.4.3-java.sql.DatabaseMetaData](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0084.html#ZH-CN_TOPIC_0000002200418490)、[6.3.4.7-java.sql.ResultSetMetaData](https://support.huaweicloud.com/centralized-devg-v3-gaussdb/gaussdb-42-0088.html#ZH-CN_TOPIC_0000002200418494)。 说明： uppercaseAttributeName参数开启后，如果数据库中有小写、大写和大小写混合的元数据，只能查询出小写部分的元数据，并以大写的形式输出，使用前请务必确认元数据的存储是否全为小写以避免数据出错。 | 属性类型：Boolean 取值范围： - true表示将获取元数据的接口的查询结果转为大写。 - false表示以内核GUC参数uppercase_attribute_name配置为准。 默认值：false | | binaryTransfer | 是否启用二进制格式发送和接收数据。 | 属性类型：Boolean 取值范围： - true：表示启用。 - false：表示不启用。 默认值：false | | binaryTransferEnable | 启用二进制传输的类型列表。以逗号分隔，例如：binaryTransferEnable=Integer4_ARRAY,Integer8_ARRAY。 OID名称和编号二选一。比如：OID名称为BLOB，编号为88，可以进行如下配置：binaryTransferEnable=BLOB 或 binaryTransferEnable=88。 | 属性类型：String 默认值：该属性不设置则为空。 | | binaryTransferDisable | 禁用二进制传输的类型列表。以逗号分隔，OID名称和编号二选一。如果binaryTransferDisable与binaryTransferEnable有相同的value，则会禁用。 | 属性类型：String 默认值：该属性不设置则为空。 | | blobMode | 设置setBinaryStream()方法为不同类型的数据赋值。建议从A、B迁移的系统将该值设定为on，从PG迁移的系统设定为off。 | 属性类型：String 取值范围： - on：表示为blob类型数据赋值。 - off：表示为bytea类型数据赋值。 默认值：on | | socketFactory | 创建与服务器socket连接的类的名称。该类必须实现接口"javax.net.SocketFactory"，并定义无参或单String参数的构造函数。 | 属性类型：String | | socketFactoryArg | 此值是上面提供的socketFactory类的构造函数的可选参数，不推荐使用。 | 属性类型：String | | receiveBufferSize | 该值用于设置连接流上的SO_RCVBUF。 | 属性类型：Integer 属性单位：字节 取值范围：-1 \~ 2147483647 默认值：-1。表示不设置缓冲区大小。 | | sendBufferSize | 该值用于设置连接流上的SO_SNDBUF。 | 属性类型：Integer 属性单位：字节 取值范围：-1 \~ 2147483647 默认值：-1。表示不设置缓冲区大小。 | | preferQueryMode | 指定执行查询的模式。 | 属性类型：String 取值范围：simple、extended、 extendedForPrepared、extendedCacheEverything。 - simple：表示只发送Q消息，仅支持文本模式，不支持parse与bind； - extended：表示支持parse、bind和execute； - extendedForPrepared：表示只有Prepared Statement对象使用扩展查询，Statement对象只使用简单查询； - extendedCacheEverything：表示会缓存每个Statement对象所生成的query。 默认值：extended | | targetServerType | 指定要连接的服务器类型。该参数识别主备数据节点是通过查询url连接串中，数据节点是否允许写操作来实现的。 | 属性类型：String 取值范围：any、master、slave、preferSlave、clusterMainNode。 - master表示依次尝试连接url中配置的IP，直到能够连接到数据库实例中的主节点，如果找不到将抛出异常。 - slave表示依次尝试连接url中配置的IP，直到能够连接到数据库实例中的备节点，如果找不到将抛出异常。 - preferSlave表示尝试连接到url中的备数据节点（如果有可用节点），否则连接到主数据节点。 - any表示尝试连接到url中的任何一个数据节点。 - clusterMainNode表示尝试连接到url中的主节点或首备节点（容灾主节点），如果找不到将抛出异常。 默认值：any 查询语句：SELECT local_role, db_state FROM pg_stat_get_stream_replications(); 建议：有写操作的业务建议配置master，以保证主备切换后能正常连接主节点，但是要注意在主备倒换过程中备机没有完全升主的时候无法正常建立连接，导致业务语句无法正常执行。 | | priorityServers | 指定url上配置的前n个节点作为主数据库实例被优先连接。应用于流式容灾场景。 例如：jdbc:opengauss://host1:port1,host2:port2,host3:port3,host4:port4/database?priorityServers=2。即表示host1与host2为主数据库实例节点，host3与host4为容灾数据库实例节点。 | 属性类型：Integer 取值范围：大于0且小于url上配置的DN数量。 默认值：NULL | | forceTargetServerSlave | 此值用于控制是否开启强制连接备机功能，并在数据库实例发生主备切换时，禁止已存在的连接在升主备机上继续使用。 | 属性类型：Boolean 取值范围： - false表示不开启强制连接备机功能。 - true表示开启强制连接备机功能。 默认值：false | | traceInterfaceClass | 获取traceId方法接口com.huawei.opengauss.jdbc.log.Tracer的实现类的完整限定类名。 | 属性类型：String 默认值：NULL | | use_boolean | 设置extended模式下setBoolean()方法绑定的oid类型。 | 属性类型：Boolean 取值范围： - false：表示绑定int2类型。 - true：表示绑定bool类型。 默认值：false | | allowReadOnly | 设置是否允许连接开启只读模式。 | 属性类型：Boolean 取值范围： - true：允许设置只读模式。 - false：不允许设置只读模式，此时调用connection.setReadOnly(true)不生效，仍可以修改数据。 默认值：true | | TLSCiphersSupperted | 设置支持的TLS加密套件。 | 属性类型：String 默认值：TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,TLS_DHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 | | stripTrailingZeros | 设置是否去除numeric类型小数点后的0，仅对ResultSet.getObject(int columnIndex)生效。 | 属性类型：Boolean 取值范围： - true：表示去除numeric类型小数点后的0。 - false：表示不去除numeric类型小数点后的0。 默认值：false | | enableTimeZone | 指定是否启用客户端时区设置。 | 属性类型：Boolean 取值范围： - true：表示启用客户端时区设置（获取JVM时区指定数据库时区）。 - false：表示不启用客户端时区设置（使用数据库时区）。 默认值：true | | oracleCompatible | 用户控制驱动接口的A兼容特性。 | 属性类型：String 取值范围： - true：表示开启驱动侧所有的A兼容特性。 - false：表示关闭驱动侧所有的A兼容特性。 - "tag1,tag2,tag3"：配置一个或多个tag，tag之间用逗号隔开，表示开启驱动侧部分的A兼容特性，每个tag对应一个A兼容特性。 当前支持的tag有： - getProcedureColumns：DatabaseMetaData#getProcedureColumns接口的行为兼容A行为。 - batchInsertAffectedRows：reWriteBatchedInserts开启后，执行批量插入接口Statement#executeBatch的返回结果兼容A行为。 默认值：false | | printSqlInLog | 指定异常信息或日志中是否输出SQL语句。 | 属性类型：Boolean 取值范围： - true：表示启用。 - false：表示禁用。 默认值：true | | setFloat | 表示调用setFloat或者setObject指定类型为float时，传递给内核的Oid是否为float4的Oid。 | 属性类型：Boolean 取值范围： true：表示传递给内核的Oid为float4。 false：表示传递给内核的Oid为float8。 默认值：false | JDBC驱动支持数据库DDL操作修改表结构后正常执行。 jdbc.version_num仅用来在建立连接时向内核传递JDBC版本号，不做其他用途，请勿使用。jdbc.version_num从503.1版本开始支持（此前使用jdbc.version参数完成该功能，后续废弃），jdbc.version_num使用规范如下： | jdbc.version_num | 版本 | 范围 | 使用规则 | 内核判断 | **备注** | |:---|:---|:---|:---|:---|:---| | 502xx | 505.2 | 50200-50299 | 版本内必须先使用最小可用值 | \>=502xx最新设置值 | 相关兼容性改动必须同步合入更高版本分支 | | 501xx | 505.1 | 50100-50199 | 版本内必须先使用最小可用值 | \>=501xx最新设置值 | 相关兼容性改动必须同步合入更高版本分支 | | 500xx | 505.0 | 50000-50099 | 版本内必须先使用最小可用值 | \>=500xx最新设置值 | 相关兼容性改动必须同步合入更高版本分支 | | 301xx | 503.1 | 30100-30199 | 版本内必须先使用最小可用值 | \>=301xx最新设置值 | 相关兼容性改动必须同步合入更高版本分支 | | 300xx | 503.0 | 30000-30099 | 版本内必须先使用最小可用值 | \>=300xx最新设置值 | 相关兼容性改动必须同步合入更高版本分支 |