jdbc url的若干參數


參數名稱 參數說明 缺省值 最低版本要求
user 數據庫用戶名,用於連接數據庫 所有版本
password 用戶密碼(用於連接數據庫) 所有版本
useUnicode 是否使用Unicode字符集,如果參數characterEncoding設置為gb2312或gbk,本參數值必須設置為true false 1.1g
characterEncoding 當useUnicode設置為true時,指定字符編碼。比如可設置為gb2312或gbk,utf8 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
socketTimeoutsocket 操作(讀寫)超時,單位:毫秒。 0表示永不超時 0 3.0.1
socketFactory 驅動程序用於創建與服務器套接字連接的類的名稱。該類必須實現了接口“com.mysql.jdbc.SocketFactory”,並有公共無參量構造函數。 com.mysql.jdbc.StandardSocketFactory 3.0.3
connectTimeout 套接字連接的超時(單位為毫秒),0表示無超時。僅對JDK-1.4或更新版本有效。默認值為“0”。 0 3.0.1
socketTimeout 網絡套接字連接的超時(默認值0表示無超時)。 0 3.0.1
useConfigs 在解析URL屬性或應用用戶指定的屬性之前,加載由逗號“,”分隔的配置屬性列表。在文檔的“配置”部分中解釋了這些配置。 3.1.5
interactiveClient 設置CLIENT_INTERACTIVE標志,根據INTERACTIVE_TIMEOUT而不是WAIT_TIMEOUT向MySQL通報超時連接。 false 3.1.0
propertiesTransform com.mysql.jdbc.ConnectionPropertiesTransform的1個實施實例,在嘗試連接之前,驅動程序將使用它來更改傳遞給驅動的URL屬性。 3.1.4
useCompression 與服務器進行通信時采用zlib壓縮(真/假)? 默認值為“假”。 false 3.0.17
High Availability and Clustering (高可用性和簇集)
autoReconnect 驅動程序是否應嘗試再次建立失效的和/或死連接? 如果允許,對於在失效或死連接上發出的查詢(屬於當前事務),驅動程序將拋出異常,但在新事務的連接上發出下一個查詢時,將嘗試再連接。不推薦使用該特 性,這是因為,當應用程序不能恰當處理SQLExceptions時,它會造成與會話狀態和數據一致性有關的副作用,設計它的目的僅用於下述情況,即,當 你無法配置應用程序來恰當處理因死連接和/或無效連接導致的SQLExceptions時。作為可選方式,可將MySQL服務器變量“wait_timeout”設置為較高的值,而不是默認的8小時。 false 1.1
autoReconnectForPools 使用適合於連接池的再連接策略(默認值為“假”)。 false 3.1.3
failOverReadOnly 在autoReconnect模式下出現故障切換時,是否應將連接設置為“只讀”? true 3.0.12
reconnectAtTxEnd 如果將autoReconnect設置為“真”,在每次事務結束后驅動程序是否應嘗試再連接? false 3.0.10
roundRobinLoadBalance 啟用了autoReconnect而且failoverReadonly為“假”時,是否應按照循環方式挑選要連接的主機? false 3.1.2
queriesBeforeRetryMaster 出現故障切換(使用多主機故障切換)並返回主機之前發出的查詢數。無論首先滿足了哪個條件,“queriesBeforeRetryMaster”或“secondsBeforeRetryMaster”,均會再次與主機進行連接。默認值為“50”。 50 3.0.2
secondsBeforeRetryMaster 出現故障切換后,在嘗試再次連接到主服務器之前,驅動程序應等待的時間? 無論首先滿足了哪個條件,“queriesBeforeRetryMaster”或“secondsBeforeRetryMaster”,均會再次與主 機進行連接。單位為秒,默認值為30。 30 3.0.2
enableDeprecatedAutoreconnect 自3.2版開始,自動再連接功能受到冷落,在3.3版中將刪除該功能。將該屬性設置為“真”可禁止檢查配置的特性。 false 3.2.1
Security (安全)
allowMultiQueries 在一條語句中,允許使用“;”來分隔多條查詢(真/假,默認值為“假”)。 false 3.1.1
useSSL 與服務器進行通信時使用SSL(真/假),默認值為“假”。 false 3.0.2
requireSSL 要求SSL連接,useSSL=true? 默認值為“假”。 false 3.1.0
allowUrlInLocalInfile 驅動程序在是“LOAD DATA LOCAL INFILE”語句中否允許URL? false 3.1.4
paranoid 采取措施,防止在錯誤信息中泄漏敏感信息,並可可能時清除保存敏感數據的數據結構? 默認值為“假”。 false 3.0.1
Performance Extensions (性能擴展)
metadataCacheSize 如果將cacheResultSetMetaData設置為“真”,對cacheResultSetMetadata的查詢次數(默認值為50)。 50 3.1.1
prepStmtCacheSize 如果允許預處理語句緩沖功能,應緩沖處理多少條預處理語句? 25 3.0.10
prepStmtCacheSqlLimit 如果允許預處理語句緩沖功能,驅動程序將執行解析緩沖處理的最大SQL是什么? 256 3.0.10
maintainTimeStats 驅動程序是否應維持各種內部定時器,以允許空閑時間計算,以及與服務器的連接失敗時允許提供更詳細的錯誤消息? 將該屬性設置為“假”,對於每次查詢,至少能減少兩次對System.getCurrentTimeMillis()的調用。 true 3.1.9
blobSendChunkSize 組塊,當通過ServerPreparedStatements發送BLOB/CLOB時使用。 1048576 3.1.9
cacheCallableStmts 驅動程序是否應對CallableStatements的解析過程執行緩沖處理。 false 3.1.2
cachePrepStmts 驅動程序是否應對客戶端預處理語句的PreparedStatements的解析過程執行緩沖處理,是否應檢查服務器端預處理語句的適用性以及服務器端預處理語句本身? false 3.0.10
cacheResultSetMetadata 驅動程序是否應對用於Statements和PreparedStatements的ResultSetMetaData執行緩沖處理? 要求 JDK-1.4+,真/假,默認為“假”。 false 3.1.1
cacheServerConfiguration 驅動程序是否應根據每條URL對“HOW VARIABLES”和“SHOW COLLATION”的結果執行緩沖處理? false 3.1.5
dontTrackOpenResources JDBC規范要求驅動程序自動跟蹤和關閉資源,但是,如果你的應用程序不能明確調用作用在語句或結果集上的close(),可能會導致內存泄漏。將該屬性設置為“真”,可放寬該限制,對於某些應用程序,會提供更高的內存效率。 false 3.1.7
dynamicCalendars 需要時,驅動程序是否應檢索默認日歷,或根據連接/會話對其進行緩沖處理? false 3.1.5
elideSetAutoCommits 如果使用MySQL-4.1或更高版本,當服務器的狀態與Connection.setAutoCommit(boolean)請求的狀態不匹配時,驅動程序是否僅應發出“set autocommit=n”查詢? false 3.1.3
holdResultsOpenOverStatementClose 驅動程序是否應按照JDBC規范的要求關閉Statement.close()上的結果集? false 3.1.7
locatorFetchBufferSize 如果將“emulateLocators”配置為“真”,當獲取關於getBinaryInputStream的BLOB數據時,緩沖區的大小應是多少? 1048576 3.2.1
useFastIntParsing 是否使用內部“String->Integer”轉換子程序來避免創建過多對象? true 3.1.4
useLocalSessionState 驅動程序是否應引用autocommit的內部值,以及由Connection.setAutoCommit()和Connection.setTransactionIsolation()設置的事務隔離,而不是查詢數據庫? false 3.1.7
useNewIO 驅動程序是否應將java.nio.* interfaces用於網絡通信(真/假),默認為“假”。 false 3.1.0
useReadAheadInput 從服務器讀取數據時,是否使用較新的、優化的非成組緩沖輸入流? true 3.1.5
Debuging/Profiling (調試/ 仿形)
logger 實現了com.mysql.jdbc.log.Log的類的名稱,com.mysql.jdbc.log.Log用於記錄消息(默認為“com.mysql.jdbc.log.StandardLogger”,它會將日志記錄到STDERR)。 com.mysql.jdbc.log.StandardLogger 3.1.1
profileSQL 跟蹤查詢以及它們對已配制記錄器的執行/獲取次數(真/假),默認為“假”。 false 3.1.0
reportMetricsIntervalMillis 如果允許“gatherPerfMetrics”,記錄它們的頻率是多少(單位毫秒)? 30000 3.1.2
maxQuerySizeToLog 調試或仿形時,控制將記錄的查詢的最大長度/大小。 2048 3.1.3
packetDebugBufferSize 當“enablePacketDebug”為“真”時,需要保留的最大信息包數目。 20 3.1.3
slowQueryThresholdMillis 如果允許“logSlowQueries”,在將查詢記錄為“慢”之前的查詢時間是多少(毫秒)? 2000 3.1.2
useUsageAdvisor 驅動程序是否應發出“使用情況”警告,就DBC和MySQL Connector/J的恰當和高效使用給出建議(真/假,默認為“假”)? false 3.1.1
autoGenerateTestcaseScript 驅動程序是否應將正在執行的SQL(包括服務器端預處理語句)轉儲到STDERR? false 3.1.9
dumpQueriesOnException 驅動程序是否應將發送至服務器的查詢內容轉儲到SQLExceptions中? false 3.1.3
enablePacketDebug 允許時,將保留“packetDebugBufferSize”信息包的環形緩沖區,並當在驅動程序代碼的關鍵區域拋出異常時進行轉儲。 false 3.1.3
explainSlowQueries 如果允許了“logSlowQueries”,驅動程序是否應在服務器上自動發出“EXPLAIN”,並以WARN級別將結果發送給配置好的日志? false 3.1.2
logSlowQueries 是否要記錄時間長於“slowQueryThresholdMillis”的查詢? false 3.1.2
traceProtocol 是否應記錄跟蹤級網絡協議? false 3.1.2
Miscellaneous (其他)
useUnicode 處理字符串時,驅動程序是否應使用Unicode字符編碼? 僅應在驅動程序無法確定字符集映射,或你正在強制驅動程序使用MySQL不是固有支持的字符集時(如UTF-8)才應使用。真/假,默認為“真”。 false 1.1g
characterEncoding 如果“useUnicode”被設置為“真”,處理字符串時,驅動程序應使用什么字符編碼? 默認為“autodetect”。 1.1g
characterSetResults 字符集,用於通知服務器以何種字符集返回結果。 3.0.13
connectionCollation 如果設置了它,將通知服務器通過“set collation_connection”使用該校對。 3.0.13
sessionVariables 以逗號隔開的“名稱/值”對列表,當驅動程序建立了連接后,以“SET SESSION …”的方式將其發送給服務器。 3.1.8
allowNanAndInf 驅動程序是否應在PreparedStatement.setDouble()中允許NaN或+/- INF值? false 3.1.5
autoDeserialize 驅動程序是否應自動檢測並串並轉換保存在BLOB字段中的對象? false 3.1.5
capitalizeTypeNames 是否將DatabaseMetaData中的類型名轉換為大寫? 通常僅在使用WebObjects時有用,真/假。默認為“假”。 false 2.0.7
clobberStreamingResults 這會使“流式”結果集被自動關閉,如果在所有數據尚未從服務器中讀取完之前,執行了另一查詢,正在從服務器流出的任何未完成數據均將丟失。 false 3.0.9
continueBatchOnError 如果一條語句失敗,驅動程序是否應繼續處理批命令? JDBC規范允許任何一種方式(默認為“真”)。 true 3.0.3
createDatabaseIfNotExist 如果不存在,創建URL中給定的數據庫。假定用戶具有創建數據庫的權限。 false 3.1.9
emptyStringsConvertToZero 驅動程序是否應允許從空字符串字段到數值“0”的轉換? true 3.1.8
emulateLocators N/A false 3.1.0
emulateUnsupportedPstmts 驅動程序是否應檢測不被服務器支持的預處理語句,並用客戶端模擬版替換它們? true 3.1.7
ignoreNonTxTables 是否忽略關於回退的非事務表? 默認值為“假”。 false 3.0.9
jdbcCompliantTruncation 連接到支持告警的服務器時(MySQL 4.1.0和更高版本),當按照JDBC的要求截短數據時,驅動程序是否應拋出java.sql.DataTruncation異常? true 3.1.2
maxRows 返回的最大行數(0,默認值表示返回所有行)。 -1 all versions
noDatetimeStringSync 不保證ResultSet.getDatetimeType().toString().equals(ResultSet.getString()。 false 3.1.7
nullCatalogMeansCurrent 當DatabaseMetadataMethods請求“目錄”參數時,值“Null”是否意味着使用當前目錄? 它不兼容JDBC,但符合驅動程序早期版本的傳統行為。 true 3.1.8
nullNamePatternMatchesAll 接受*pattern參數的DatabaseMetaData方法是否應將null按對待“%”的相同方式處理(不兼容JDBC,但驅動程序的早期版本能接受與規范的這類偏離)。 true 3.1.8
pedantic 嚴格遵守JDBC規范。 false 3.0.0
relaxAutoCommit 如果驅動程序所連接的MySQL服務器的版本不支持事務,仍允許調用commit()、rollback()和setAutoCommit()?真/假,默認為“假”。 false 2.0.13
retainStatementAfterResultSetClose 調用ResultSet.close()后,驅動程序是否應將語句引用保存在結果集中? 在JDBC-4.0后,與JDBC不兼容。 false 3.1.11
rollbackOnPooledClose 當連接池中的邏輯連接關閉時,驅動程序是否應發出rollback()? true 3.0.15
runningCTS13 允許在Sun與JDBC兼容的testsuite 1.3版中處理缺陷。 false 3.1.7
serverTimezone 覆蓋時區的檢測/映射。當服務器的時區為映射到Java時區時使用。 3.0.2
strictFloatingPoint 僅在兼容性測試的早期版本中使用。 false 3.0.0
strictUpdates 驅動程序是否應對可更新結果集進行嚴格檢查(選擇所有的主鍵)?真/假,默認為“真”。 true 3.0.4
tinyInt1isBit 驅動程序是否應將數據類型TINYINT(1)當作BIT類型對待?創建表時,服務器會執行BIT -> TINYINT(1)操作。 true 3.0.16
transformedBitIsBoolean 如果驅動程序將TINYINT(1)轉換為不同的類型,為了與MySQL-5.0兼容,驅動程序是否應使用BOOLEAN取代BIT?這是因為MySQL-5.0具有BIT類型。 false 3.1.9
ultraDevHack 由於UltraDev已損壞,並為所有語句發出了prepareCall(),需要時,是否要為prepareCall()創建PreparedStatements? false 2.0.3
useHostsInPrivileges 在DatabaseMetaData.getColumn/TablePrivileges()中為用戶添加“@hostname”。真/假,默認為“真”。 true 3.0.2
useOldUTF8Behavior 與4.0和更早版本的服務器進行通信時,使用UTF-8。 false 3.1.6
useOnlyServerErrorMessages 對服務器返回的錯誤消息,不事先設定“標准的”SQLState錯誤消息。 true 3.0.15
useServerPrepStmts 如果服務器支持,是否使用服務器端預處理語句? 默認值為“真”。 true 3.1.0
useSqlStateCodes 使用SQL標准狀態碼取代“傳統的”X/Open/SQL狀態碼,真/假,默認為“真”。 true 3.1.3
useStreamLengthsInPrepStmts 是否采用PreparedStatement/ResultSet.setXXXStream()方法調用中的流長度參數?真/假,默認為“真”。 true 3.0.2
useTimezone 是否在客戶端和服務器時區間轉換時間/日期類型(真/假,默認為“假”)? false 3.0.2
useUnbufferedInput 不使用BufferedInputStream來從服務器讀取數據。 true 3.0.11
yearIsDateType JDBC驅動程序是否應將MySQL類型“YEAR”當作java.sql.Date或SHORT對待? true 3.1.9
zeroDateTimeBehavior 當驅動程序遇到全由0組成的DATETIME值時,應出現什么?MySQL使用它來表示無效日期。有效值是“exception”、“round”和“convertToNull”。 exception 3.1.4
轉載自https://blog.csdn.net/wfanking/article/details/95504879


免責聲明!

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



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