MySQL JDBC URL參數(轉)


MySQL的 JDBC URL格式:

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/easonjim?profileSQL=true

對應中文環境,通常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

具體的參數參考:

屬性名 

定義 

要求? 

默認值 

版本 

Connection/Authentication(連接/鑒定) 

user

連接的用戶

No 

 

全部

password 

連接時使用的密碼。

No 

 

全部

socketFactory 

驅動程序用於創建與服務器套接字連接的類的名稱。該類必須實現了接口“com.mysql.jdbc.SocketFactory”,並有公共無參量構造函數。

No 

com.mysql.jdbc.StandardSocketFactory 

3.0.3 

connectTimeout 

套接字連接的超時(單位為毫秒),0表示無超時。僅對JDK-1.4或更新版本有效。默認值為“0”。

No 

3.0.1 

socketTimeout 

網絡套接字連接的超時(默認值0表示無超時)。

No 

3.0.1 

useConfigs 

在解析URL屬性或應用用戶指定的屬性之前,加載由逗號“,”分隔的配置屬性列表。在文檔的“配置”部分中解釋了這些配置。

No 

 

3.1.5 

interactiveClient 

設置CLIENT_INTERACTIVE標志,根據INTERACTIVE_TIMEOUT而不是WAIT_TIMEOUT向MySQL通報超時連接。

No 

false 

3.1.0 

propertiesTransform 

com.mysql.jdbc.ConnectionPropertiesTransform的1個實施實例,在嘗試連接之前,驅動程序將使用它來更改傳遞給驅動的URL屬性。

No 

 

3.1.4 

useCompression 

與服務器進行通信時采用zlib壓縮(真/假)? 默認值為“假”。

No 

false 

3.0.17 

High Availability and Clustering (高可用性和簇集) 

autoReconnect 

驅 動程序是否應嘗試再次建立失效的和/或死連接? 如果允許,對於在失效或死連接上發出的查詢(屬於當前事務),驅動程序將拋出異常,但在新事務的連接上發出下一個查詢時,將嘗試再連接。不推薦使用該特 性,這是因為,當應用程序不能恰當處理SQLExceptions時,它會造成與會話狀態和數據一致性有關的副作用,設計它的目的僅用於下述情況,即,當 你無法配置應用程序來恰當處理因死連接和/或無效連接導致的SQLExceptions時。作為可選方式,可將MySQL服務器變量 “wait_timeout”設置為較高的值,而不是默認的8小時。

No 

false 

1.1 

autoReconnectForPools 

使用適合於連接池的再連接策略(默認值為“假”)。

No 

false 

3.1.3 

failOverReadOnly 

在autoReconnect模式下出現故障切換時,是否應將連接設置為“只讀”?

No 

true 

3.0.12 

reconnectAtTxEnd 

如果將autoReconnect設置為“真”,在每次事務結束后驅動程序是否應嘗試再連接?

No 

false 

3.0.10 

roundRobinLoadBalance 

啟用了autoReconnect而且failoverReadonly為“假”時,是否應按照循環方式挑選要連接的主機?

No 

false 

3.1.2 

queriesBeforeRetryMaster 

出現故障切換(使用多主機故障切換)並返回主機之前發出的查詢數。無論首先滿足了哪個條件,“queriesBeforeRetryMaster”或“secondsBeforeRetryMaster”,均會再次與主機進行連接。默認值為“50”。

No 

50 

3.0.2 

secondsBeforeRetryMaster 

出現故障切換后,在嘗試再次連接到主服務器之前,驅動程序應等待的時間? 無論首先滿足了哪個條件,“queriesBeforeRetryMaster”或“secondsBeforeRetryMaster”,均會再次與主 機進行連接。單位為秒,默認值為30。

No 

30 

3.0.2 

enableDeprecatedAutoreconnect 

自3.2版開始,自動再連接功能受到冷落,在3.3版中將刪除該功能。將該屬性設置為“真”可禁止檢查配置的特性。

No 

false 

3.2.1 

Security (安全) 

allowMultiQueries 

在一條語句中,允許使用“;”來分隔多條查詢(真/假,默認值為“假”)。

No 

false 

3.1.1 

useSSL 

與服務器進行通信時使用SSL(真/假),默認值為“假”。

No 

false 

3.0.2 

requireSSL 

要求SSL連接,useSSL=true? 默認值為“假”。

No 

false 

3.1.0 

allowUrlInLocalInfile 

驅動程序在是“LOAD DATA LOCAL INFILE”語句中否允許URL?

No 

false 

3.1.4 

paranoid 

采取措施,防止在錯誤信息中泄漏敏感信息,並可可能時清除保存敏感數據的數據結構? 默認值為“假”。

No 

false 

3.0.1 

Performance Extensions (性能擴展) 

metadataCacheSize 

如果將cacheResultSetMetaData設置為“真”,對cacheResultSetMetadata的查詢次數(默認值為50)。

No 

50 

3.1.1 

prepStmtCacheSize 

如果允許預處理語句緩沖功能,應緩沖處理多少條預處理語句?

No 

25 

3.0.10 

prepStmtCacheSqlLimit 

如果允許預處理語句緩沖功能,驅動程序將執行解析緩沖處理的最大SQL是什么?

No 

256 

3.0.10 

maintainTimeStats 

驅動程序是否應維持各種內部定時器,以允許空閑時間計算,以及與服務器的連接失敗時允許提供更詳細的錯誤消息? 將該屬性設置為“假”,對於每次查詢,至少能減少兩次對System.getCurrentTimeMillis()的調用。

No 

true 

3.1.9 

blobSendChunkSize 

組塊,當通過ServerPreparedStatements發送BLOB/CLOB時使用。

No 

1048576 

3.1.9 

cacheCallableStmts 

驅動程序是否應對CallableStatements的解析過程執行緩沖處理。

No 

false 

3.1.2 

cachePrepStmts 

驅動程序是否應對客戶端預處理語句的PreparedStatements的解析過程執行緩沖處理,是否應檢查服務器端預處理語句的適用性以及服務器端預處理語句本身?

No 

false 

3.0.10 

cacheResultSetMetadata 

驅動程序是否應對用於Statements和PreparedStatements的ResultSetMetaData執行緩沖處理? 要求 JDK-1.4+,真/假,默認為“假”。

No 

false 

3.1.1 

cacheServerConfiguration 

驅動程序是否應根據每條URL對“HOW VARIABLES”和“SHOW COLLATION”的結果執行緩沖處理?

No 

false 

3.1.5 

dontTrackOpenResources 

JDBC規范要求驅動程序自動跟蹤和關閉資源,但是,如果你的應用程序不能明確調用作用在語句或結果集上的close(),可能會導致內存泄漏。將該屬性設置為“真”,可放寬該限制,對於某些應用程序,會提供更高的內存效率。

No 

false 

3.1.7 

dynamicCalendars 

需要時,驅動程序是否應檢索默認日歷,或根據連接/會話對其進行緩沖處理?

No 

false 

3.1.5 

elideSetAutoCommits 

如果使用MySQL-4.1或更高版本,當服務器的狀態與Connection.setAutoCommit(boolean)請求的狀態不匹配時,驅動程序是否僅應發出“set autocommit=n”查詢?

No 

false 

3.1.3 

holdResultsOpenOverStatementClose 

驅動程序是否應按照JDBC規范的要求關閉Statement.close()上的結果集?

No 

false 

3.1.7 

locatorFetchBufferSize 

如果將“emulateLocators”配置為“真”,當獲取關於getBinaryInputStream的BLOB數據時,緩沖區的大小應是多少?

No 

1048576 

3.2.1 

useFastIntParsing 

是否使用內部“String->Integer”轉換子程序來避免創建過多對象?

No 

true 

3.1.4 

useLocalSessionState 

驅動程序是否應引用autocommit的內部值,以及由Connection.setAutoCommit()和Connection.setTransactionIsolation()設置的事務隔離,而不是查詢數據庫?

No 

false 

3.1.7 

useNewIO 

驅動程序是否應將java.nio.* interfaces用於網絡通信(真/假),默認為“假”。

No 

false 

3.1.0 

useReadAheadInput 

從服務器讀取數據時,是否使用較新的、優化的非成組緩沖輸入流?

No 

true 

3.1.5 

Debuging/Profiling (調試/ 仿形) 

logger 

實現了com.mysql.jdbc.log.Log的類的名稱,com.mysql.jdbc.log.Log用於記錄消息(默認為“com.mysql.jdbc.log.StandardLogger”,它會將日志記錄到STDERR)。

No 

com.mysql.jdbc.log.StandardLogger 

3.1.1 

profileSQL 

跟蹤查詢以及它們對已配制記錄器的執行/獲取次數(真/假),默認為“假”。

No 

false 

3.1.0 

reportMetricsIntervalMillis 

如果允許“gatherPerfMetrics”,記錄它們的頻率是多少(單位毫秒)?

No 

30000 

3.1.2 

maxQuerySizeToLog 

調試或仿形時,控制將記錄的查詢的最大長度/大小。

No 

2048 

3.1.3 

packetDebugBufferSize 

當“enablePacketDebug”為“真”時,需要保留的最大信息包數目。

No 

20 

3.1.3 

slowQueryThresholdMillis 

如果允許“logSlowQueries”,在將查詢記錄為“慢”之前的查詢時間是多少(毫秒)?

No 

2000 

3.1.2 

useUsageAdvisor 

驅動程序是否應發出“使用情況”警告,就DBC和MySQL Connector/J的恰當和高效使用給出建議(真/假,默認為“假”)?

No 

false 

3.1.1 

autoGenerateTestcaseScript 

驅動程序是否應將正在執行的SQL(包括服務器端預處理語句)轉儲到STDERR?

No 

false 

3.1.9 

dumpQueriesOnException 

驅動程序是否應將發送至服務器的查詢內容轉儲到SQLExceptions中?

No 

false 

3.1.3 

enablePacketDebug 

允許時,將保留“packetDebugBufferSize”信息包的環形緩沖區,並當在驅動程序代碼的關鍵區域拋出異常時進行轉儲。

No 

false 

3.1.3 

explainSlowQueries 

如果允許了“logSlowQueries”,驅動程序是否應在服務器上自動發出“EXPLAIN”,並以WARN級別將結果發送給配置好的日志?

No 

false 

3.1.2 

logSlowQueries 

是否要記錄時間長於“slowQueryThresholdMillis”的查詢?

No 

false 

3.1.2 

traceProtocol 

是否應記錄跟蹤級網絡協議?

No 

false 

3.1.2 

Miscellaneous (其他) 

useUnicode 

處理字符串時,驅動程序是否應使用Unicode字符編碼? 僅應在驅動程序無法確定字符集映射,或你正在強制驅動程序使用MySQL不是固有支持的字符集時(如UTF-8)才應使用。真/假,默認為“真”。

No 

false 

1.1g 

characterEncoding 

如果“useUnicode”被設置為“真”,處理字符串時,驅動程序應使用什么字符編碼? 默認為“autodetect”。

No 

 

1.1g 

characterSetResults 

字符集,用於通知服務器以何種字符集返回結果。

No 

 

3.0.13 

connectionCollation 

如果設置了它,將通知服務器通過“set collation_connection”使用該校對。

No 

 

3.0.13 

sessionVariables 

以逗號隔開的“名稱/值”對列表,當驅動程序建立了連接后,以“SET SESSION ...”的方式將其發送給服務器。

No 

 

3.1.8 

allowNanAndInf 

驅動程序是否應在PreparedStatement.setDouble()中允許NaN或+/- INF值?

No 

false 

3.1.5 

autoDeserialize 

驅動程序是否應自動檢測並串並轉換保存在BLOB字段中的對象?

No 

false 

3.1.5 

capitalizeTypeNames 

是否將DatabaseMetaData中的類型名轉換為大寫? 通常僅在使用WebObjects時有用,真/假。默認為“假”。

No 

false 

2.0.7 

clobberStreamingResults 

這會使“流式”結果集被自動關閉,如果在所有數據尚未從服務器中讀取完之前,執行了另一查詢,正在從服務器流出的任何未完成數據均將丟失。

No 

false 

3.0.9 

continueBatchOnError 

如果一條語句失敗,驅動程序是否應繼續處理批命令? JDBC規范允許任何一種方式(默認為“真”)。

No 

true 

3.0.3 

createDatabaseIfNotExist 

如果不存在,創建URL中給定的數據庫。假定用戶具有創建數據庫的權限。

No 

false 

3.1.9 

emptyStringsConvertToZero 

驅動程序是否應允許從空字符串字段到數值“0”的轉換?

No 

true 

3.1.8 

emulateLocators 

N/A 

No 

false 

3.1.0 

emulateUnsupportedPstmts 

驅動程序是否應檢測不被服務器支持的預處理語句,並用客戶端模擬版替換它們?

No 

true 

3.1.7 

ignoreNonTxTables 

是否忽略關於回退的非事務表? 默認值為“假”。

No 

false 

3.0.9 

jdbcCompliantTruncation 

連接到支持告警的服務器時(MySQL 4.1.0和更高版本),當按照JDBC的要求截短數據時,驅動程序是否應拋出java.sql.DataTruncation異常?

No 

true 

3.1.2 

maxRows 

返回的最大行數(0,默認值表示返回所有行)。

No 

-1 

all versions 

noDatetimeStringSync 

不保證ResultSet.getDatetimeType().toString().equals(ResultSet.getString()。

No 

false 

3.1.7 

nullCatalogMeansCurrent 

當DatabaseMetadataMethods請求“目錄”參數時,值“Null”是否意味着使用當前目錄? 它不兼容JDBC,但符合驅動程序早期版本的傳統行為。

No 

true 

3.1.8 

nullNamePatternMatchesAll 

接受*pattern參數的DatabaseMetaData方法是否應將null按對待“%”的相同方式處理(不兼容JDBC,但驅動程序的早期版本能接受與規范的這類偏離)。

No 

true 

3.1.8 

pedantic 

嚴格遵守JDBC規范。

No 

false 

3.0.0 

relaxAutoCommit 

如果驅動程序所連接的MySQL服務器的版本不支持事務,仍允許調用commit()、rollback()和setAutoCommit()?真/假,默認為“假”。

No 

false 

2.0.13 

retainStatementAfterResultSetClose 

調用ResultSet.close()后,驅動程序是否應將語句引用保存在結果集中? 在JDBC-4.0后,與JDBC不兼容。

No 

false 

3.1.11 

rollbackOnPooledClose 

當連接池中的邏輯連接關閉時,驅動程序是否應發出rollback()?

No 

true 

3.0.15 

runningCTS13 

允許在Sun與JDBC兼容的testsuite 1.3版中處理缺陷。

No 

false 

3.1.7 

serverTimezone 

覆蓋時區的檢測/映射。當服務器的時區為映射到Java時區時使用。

No 

 

3.0.2 

strictFloatingPoint 

僅在兼容性測試的早期版本中使用。

No 

false 

3.0.0 

strictUpdates 

驅動程序是否應對可更新結果集進行嚴格檢查(選擇所有的主鍵)?真/假,默認為“真”。

No 

true 

3.0.4 

tinyInt1isBit 

驅動程序是否應將數據類型TINYINT(1)當作BIT類型對待?創建表時,服務器會執行BIT -> TINYINT(1)操作。

No 

true 

3.0.16 

transformedBitIsBoolean 

如果驅動程序將TINYINT(1)轉換為不同的類型,為了與MySQL-5.0兼容,驅動程序是否應使用BOOLEAN取代BIT?這是因為MySQL-5.0具有BIT類型。

No 

false 

3.1.9 

ultraDevHack 

由於UltraDev已損壞,並為所有語句發出了prepareCall(),需要時,是否要為prepareCall()創建PreparedStatements? 

真/假,默認值為“假”。

No 

false 

2.0.3 

useHostsInPrivileges 

在DatabaseMetaData.getColumn/TablePrivileges()中為用戶添加“@hostname”。真/假,默認為“真”。

No 

true 

3.0.2 

useOldUTF8Behavior 

與4.0和更早版本的服務器進行通信時,使用UTF-8。

No 

false 

3.1.6 

useOnlyServerErrorMessages 

對服務器返回的錯誤消息,不事先設定“標准的”SQLState錯誤消息。

No 

true 

3.0.15 

useServerPrepStmts 

如果服務器支持,是否使用服務器端預處理語句? 默認值為“真”。

No 

true 

3.1.0 

useSqlStateCodes 

使用SQL標准狀態碼取代“傳統的”X/Open/SQL狀態碼,真/假,默認為“真”。

No 

true 

3.1.3 

useStreamLengthsInPrepStmts 

是否采用PreparedStatement/ResultSet.setXXXStream()方法調用中的流長度參數?真/假,默認為“真”。

No 

true 

3.0.2 

useTimezone 

是否在客戶端和服務器時區間轉換時間/日期類型(真/假,默認為“假”)?

No 

false 

3.0.2 

useUnbufferedInput 

不使用BufferedInputStream來從服務器讀取數據。

No 

true 

3.0.11 

yearIsDateType 

JDBC驅動程序是否應將MySQL類型“YEAR”當作java.sql.Date或SHORT對待?

No 

true 

3.1.9 

zeroDateTimeBehavior 

當驅動程序遇到全由0組成的DATETIME值時,應出現什么?MySQL使用它來表示無效日期。有效值是“exception”、“round”和“convertToNull”。

No 

exception 

3.1.4 

 

參考:

http://elf8848.iteye.com/blog/1684414(以上內容轉自此篇文章)

https://dev.mysql.com/doc/connector-j/5.1/en/connector-j-reference-configuration-properties.html(官方文檔)


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM