数据库教程:MySQL jdbc-url链接参数详情

Mysql jdbc-url链接配置详情在需要通过mysql存储数据并且通过JDBC方式去操作数据的项目中,都需要配置jdbc-url链接地址,该地址并不是简单的一个链接,还有一些有特定含义的参数描述。例如:jdbc:mysql://[ip]:[port]/[dbname]?user=root&password=123456&useUnicode=true&charaterEncoding=UTF-8&autoReconnect=false&autoReconn


Mysql jdbc-url链接配置详情

在需要通过mysql存储数据并且通过JDBC方式去操作数据的项目中,都需要配置jdbc-url链接地址,该地址并不是简单的一个链接,还有一些有特定含义的参数描述。
例如:
jdbc:mysql://[ip]:[port]/[dbname]?user=root&password=123456&useUnicode=true&charaterEncoding=UTF-8&autoReconnect=false&autoReconnectForPools=false&failOverReadOnly=true&maxReconnects=3&initialTimeout=2&connectTimeout=0&scoketTimeout=0

Mysql_JDBC_URL链接参数表

属性名 定义 默认值
user 链接的用户
password 链接时使用的密码
socketFactory 驱动程序用于创建与服务器套接字链接的类名称,该类必须实现了接口”com.mysql.jdbc.SocketFactory”,并有公共无参构造函数 com.mysql.jdbc.StandardScoket
connectTimeout 套接字链接的超时(ms),0表示无超时。仅对jdk1.4后版本有效 0
socketTimeout 网络套接字链接的超时(默认值0表示无超时) 0
useConfigs 在解析URL属性或应用用户指定的属性之前,加载逗号”,”分隔的配置属性列表,在文档的配置部分解释了这些配置
interactiveClient 设置CLIENT_INTERACTIVE标志,根据INTERACTIVE_TIMEOUT而不是WAIT_TIMEOUT向MySQL通报超时链接 false
propertiesTransform com.mysql.jdbc.ConnectionPropertiesTransform的一个实例,在尝试链接之前,驱动程序将使用它来更改传递给驱动的URL属性
useCompression 与服务器进行通信时采用zlib压缩 false
高可用和簇集
autoReconnect 驱动程序是否应尝试再次建立失效的或死链接,如果允许,对于在失效或死链接上发出的查询(当前事务),驱动程序将抛出异常,但在新事务的链接上发出下一个查询时,将尝试再链接,不推荐用该特性,因为当应用程序不能恰当处理SQLExceptions时,它会造成与会话状态和数据一致性的有关副作用,设计的目的是当无法配置应用程序其阿达出来因死链接或无效链接导致的SQLExceptions时,作为可选方式,可将MySQL服务器的wait_timeout设置为较高的值,而不是默认的8小时 false
autoReconnectForPools 使用适合链接池的在链接策略 false
failOverOnly 在autoReconnect模式下出现故障切换时,是否应将链接设置为“只读” true
reconnectAtTxEnd 如果将autoReconnect设置为true,在每次事务结束后驱动程序是否应尝试再链接 false
roundRobinLoadBalance 启用了autoReconnect而且failoverReadonly为false时,是否应按照循环方式挑选要链接的主机 false
queriesBeforeRetryMaster 出现故障切换并返回主机之前发出的查询数,无论首先满足了那个条件,“queriesBeforeRetryMaster”或“secondsBeforeRetryMaster”,均会再次与主机进行链接 50
secondsBeforeRetryMaster 出现故障切换后,在尝试再次链接到主服务器之前,驱动程序应等待时间,无论首先满足了那个条件,“queriesBeforeRetryMaster”或“secondsBeforeRetryMaster”,均会再次与主机进行链接,单位为秒 30
安全
allowMultiQueries 在一条语句中,允许使用“;”来分隔多条查询 fasle
useSSL 在与服务器进行通信时使用SSL false
requireSSL 要求SSL链接 false
allowUrlInLocalInfile 驱动程序在“LOAD DATA LOCAL INFILE”语句中是否允许URL false
paranoid 采取措施,防止在错误信息汇总泄露敏感信息,并可能清楚保存敏感数据的数据结构 false
性能扩展
metadataCacheSize 如果将cacheResultSetMetaData设置true,对cacheResultSetMetadata的查询次数 50
prepStmtCacheSize 如果允许预处理语句缓冲功能,应缓冲处理多少条预处理语句 25
prepStmtCacheSqlLimit 如果允许预处理语句缓冲功能,驱动程序将执行解析缓冲处理的最大SQL是什么 256
maintainTimeStats 驱动程序是否应维持各种内部定时器,以允许空闲时间计算,以及与服务器的连接失败时允许提供更详细的错误消息? 将该属性设置为“假”,对于每次查询,至少能减少两次对System.getCurrentTimeMillis()的调用。 true
blobSendChunkSize 组块,当通过ServerPreparedStatements发送BLOB/CLOB时使用。 1048576
cacheCallableStmts 驱动程序是否应对CallableStatements的解析过程执行缓冲处理 false
cachePrepStmts 驱动程序是否应对CallableStatements的解析过程执行缓冲处理。 false
cachePrepStmts 驱动程序是否应对客户端预处理语句的PreparedStatements的解析过程执行缓冲处理,是否应检查服务器端预处理语句的适用性以及服务器端预处理语句本身 false
cacheResultSetMetadata 驱动程序是否应对用于Statements和PreparedStatements的ResultSetMetaData执行缓冲处理? 要求 JDK-1.4+,真/假,默认为“假” false
cacheServerConfiguration 驱动程序是否应根据每条URL对“HOW VARIABLES”和“SHOW COLLATION”的结果执行缓冲处理 False
dontTrackOpenResources JDBC规范要求驱动程序自动跟踪和关闭资源,但是,如果你的应用程序不能明确调用作用在语句或结果集上的close(),可能会导致内存泄漏。将该属性设置为“真”,可放宽该限制,对于某些应用程序,会提供更高的内存效率 false
dynamicCalendars 需要时,驱动程序是否应检索默认日历,或根据连接/会话对其进行缓冲处理 false
elideSetAutoCommits 如果使用MySQL-4.1或更高版本,当服务器的状态与Connection.setAutoCommit(boolean)请求的状态不匹配时,驱动程序是否仅应发出“set autocommit=n”查询 false
holdResultsOpenOverStatementClose 驱动程序是否应按照JDBC规范的要求关闭Statement.close()上的结果集 false
locatorFetchBufferSize 如果将“emulateLocators”配置为“真”,当获取关于getBinaryInputStream的BLOB数据时,缓冲区的大小应是多少 1048576
useFastIntParsing 是否使用内部“String->Integer”转换子程序来避免创建过多对象 True
useLocalSessionState 驱动程序是否应引用autocommit的内部值,以及由Connection.setAutoCommit()和Connection.setTransactionIsolation()设置的事务隔离,而不是查询数据库 false
useNewIO 驱动程序是否应将java.nio.* interfaces用于网络通信(真/假),默认为“假” false
useReadAheadInput 从服务器读取数据时,是否使用较新的、优化的非成组缓冲输入流 true
调试/仿形
logger 实现了com.mysql.jdbc.log.Log的类的名称,com.mysql.jdbc.log.Log用于记录消息(默认为“com.mysql.jdbc.log.StandardLogger”,它会将日志记录到STDERR) com.mysql.jdbc.log.StandardLogger
profileSQL 跟踪查询以及它们对已配制记录器的执行/获取次数(真/假),默认为“假” false
reportMetricsIntervalMillis 如果允许“gatherPerfMetrics”,记录它们的频率是多少(单位毫秒) 30000
maxQuerySizeToLog 调试或仿形时,控制将记录的查询的最大长度/大小 2048
packetDebugBufferSize 当“enablePacketDebug”为“真”时,需要保留的最大信息包数目 20
slowQueryThresholdMillis 如果允许“logSlowQueries”,在将查询记录为“慢”之前的查询时间是多少(毫秒) 2000
useUsageAdvisor 驱动程序是否应发出“使用情况”警告,就DBC和MySQL Connector/J的恰当和高效使用给出建议(真/假,默认为“假”) fale
autoGenerateTestcaseScript 驱动程序是否应将正在执行的SQL(包括服务器端预处理语句)转储到STDERR false
dumpQueriesOnException 驱动程序是否应将发送至服务器的查询内容转储到SQLExceptions中 false
enablePacketDebug 允许时,将保留“packetDebugBufferSize”信息包的环形缓冲区,并当在驱动程序代码的关键区域抛出异常时进行转储 false
explainSlowQueries 如果允许了“logSlowQueries”,驱动程序是否应在服务器上自动发出“EXPLAIN”,并以WARN级别将结果发送给配置好的日志 false
logSlowQueries 是否要记录时间长于“slowQueryThresholdMillis”的查询 false
traceProtocol 是否应记录跟踪级网络协议 false
其他
useUnicode 处理字符串时,驱动程序是否应使用Unicode字符编码? 仅应在驱动程序无法确定字符集映射,或你正在强制驱动程序使用MySQL不是固有支持的字符集时(如UTF-8)才应使用。真/假,默认为“真”。 false
characterEncoding 如果“useUnicode”被设置为“真”,处理字符串时,驱动程序应使用什么字符编码? 默认为“autodetect”。
characterSetResults 字符集,用于通知服务器以何种字符集返回结果。
connectionCollation 如果设置了它,将通知服务器通过“set collation_connection”使用该校对。
sessionVariables 以逗号隔开的“名称/值”对列表,当驱动程序建立了连接后,以“SET SESSION …”的方式将其发送给服务器。
allowNanAndInf 驱动程序是否应在PreparedStatement.setDouble()中允许NaN或+/- INF值? false
autoDeserialize 驱动程序是否应自动检测并串并转换保存在BLOB字段中的对象? false
capitalizeTypeNames 是否将DatabaseMetaData中的类型名转换为大写? 通常仅在使用WebObjects时有用,真/假。默认为“假”。 false
clobberStreamingResults 这会使“流式”结果集被自动关闭,如果在所有数据尚未从服务器中读取完之前,执行了另一查询,正在从服务器流出的任何未完成数据均将丢失。 false
continueBatchOnError 如果一条语句失败,驱动程序是否应继续处理批命令? JDBC规范允许任何一种方式(默认为“真”)。 true
createDatabaseIfNotExist 如果不存在,创建URL中给定的数据库。假定用户具有创建数据库的权限。 false
emptyStringsConvertToZero 驱动程序是否应允许从空字符串字段到数值“0”的转换? true
emulateLocators N/A false
emulateUnsupportedPstmts 驱动程序是否应检测不被服务器支持的预处理语句,并用客户端模拟版替换它们? true
ignoreNonTxTables 是否忽略关于回退的非事务表? 默认值为“假”。 false
jdbcCompliantTruncation 连接到支持告警的服务器时(MySQL 4.1.0和更高版本),当按照JDBC的要求截短数据时,驱动程序是否应抛出java.sql.DataTruncation异常? true
maxRows 返回的最大行数(0,默认值表示返回所有行)。
noDatetimeStringSync 不保证ResultSet.getDatetimeType().toString().equals(ResultSet.getString()。 false
nullCatalogMeansCurrent 当DatabaseMetadataMethods请求“目录”参数时,值“Null”是否意味着使用当前目录? 它不兼容JDBC,但符合驱动程序早期版本的传统行为。 true
nullNamePatternMatchesAll 接受*pattern参数的DatabaseMetaData方法是否应将null按对待“%”的相同方式处理(不兼容JDBC,但驱动程序的早期版本能接受与规范的这类偏离)。 true
pedantic 严格遵守JDBC规范。 false
relaxAutoCommit 如果驱动程序所连接的MySQL服务器的版本不支持事务,仍允许调用commit()、rollback()和setAutoCommit()?真/假,默认为“假”。 false
retainStatementAfterResultSetClose 调用ResultSet.close()后,驱动程序是否应将语句引用保存在结果集中? 在JDBC-4.0后,与JDBC不兼容。 false
rollbackOnPooledClose 当连接池中的逻辑连接关闭时,驱动程序是否应发出rollback()? true
runningCTS13 允许在Sun与JDBC兼容的testsuite 1.3版中处理缺陷。 false
serverTimezone 覆盖时区的检测/映射。当服务器的时区为映射到Java时区时使用。
strictFloatingPoint 仅在兼容性测试的早期版本中使用。 false
strictUpdates 驱动程序是否应对可更新结果集进行严格检查(选择所有的主键)?真/假,默认为“真”。 true
tinyInt1isBit 驱动程序是否应将数据类型TINYINT(1)当作BIT类型对待?创建表时,服务器会执行BIT -> TINYINT(1)操作。 true
transformedBitIsBoolean 如果驱动程序将TINYINT(1)转换为不同的类型,为了与MySQL-5.0兼容,驱动程序是否应使用BOOLEAN取代BIT?这是因为MySQL-5.0具有BIT类型。 false
ultraDevHack 由于UltraDev已损坏,并为所有语句发出了prepareCall(),需要时,是否要为prepareCall()创建PreparedStatements? false
useHostsInPrivileges 在DatabaseMetaData.getColumn/TablePrivileges()中为用户添加“@hostname”。真/假,默认为“真”。 true
useOldUTF8Behavior 与4.0和更早版本的服务器进行通信时,使用UTF-8。 false
useOnlyServerErrorMessages 对服务器返回的错误消息,不事先设定“标准的”SQLState错误消息。 true
useServerPrepStmts 如果服务器支持,是否使用服务器端预处理语句? 默认值为“真”。 true
useSqlStateCodes 使用SQL标准状态码取代“传统的”X/Open/SQL状态码,真/假,默认为“真”。 true
useStreamLengthsInPrepStmts 是否采用PreparedStatement/ResultSet.setXXXStream()方法调用中的流长度参数?真/假,默认为“真”。 true
useTimezone 是否在客户端和服务器时区间转换时间/日期类型(真/假,默认为“假”)? false
useUnbufferedInput 不使用BufferedInputStream来从服务器读取数据。 true
yearIsDateType JDBC驱动程序是否应将MySQL类型“YEAR”当作java.sql.Date或SHORT对待? true
zeroDateTimeBehavior 当驱动程序遇到全由0组成的DATETIME值时,应出现什么?MySQL使用它来表示无效日期。有效值是“exception”、“round”和“convertToNull”。 exception

重要几个参数

属性名 定义 默认值
user 数据库用户名(用于连接数据库)
password 用户密码(用于连接数据库)
useUnicode 是否使用Unicode字符集,如果参数characterEncoding设置为gb2312或gbk,本参数值必须设置为true false
characterEncoding 当useUnicode设置为true时,指定字符编码。比如可设置为gb2312或gbk false
autoReconnect 当数据库连接异常中断时,是否自动重新连接 false
autoReconnectForPools 是否使用针对数据库连接池的重连策略 false
failOverReadOnly 自动重连成功后,连接是否设置为只读 true
maxReconnects autoReconnect设置为true时,重试连接的次数 3
initialTimeout autoReconnect设置为true时,两次重连之间的时间间隔,单位:秒 2
connectTimeout 和数据库服务器建立socket连接时的超时,单位:毫秒。 0表示永不超时,适用于JDK 1.4及更高版本 0
socketTimeout socket操作(读写)超时,单位:毫秒。 0表示永不超时 0

需要了解更多数据库技术:MySQL jdbc-url链接参数详情,都可以关注数据库技术分享栏目—计算机技术网(www.ctvol.com)!

本文来自网络收集,不代表计算机技术网立场,如涉及侵权请联系管理员删除。

ctvol管理联系方式QQ:251552304

本文章地址:https://www.ctvol.com/dtteaching/816428.html

(0)
上一篇 2021年9月15日
下一篇 2021年9月15日

精彩推荐