原文地址：https://alphahinex.github.io/2021/11/14/mysql-connector-j-reference-configuration-properties/
description: "MySQL JDBC url 可用參數(shù)概覽"
date: 2021.11.14 10:26
categories:
- Database
tags: [MySQL]
keywords: Connector/J, MySQL, jdbcUrl, JDBC, properties
使用 JDBC 連接 MySQL 時(shí)秉宿，你是否也對(duì) JDBC URL 連接串中的參數(shù)感到很神秘果覆？
例如：
jdbc:mysql://localhost:3306/hinex?useSSL=false&serverTimezone=UTC
連接串的通用格式為：
protocol//[hosts][/database][?properties]
那么可用的 properties 都有哪些？默認(rèn)值和可用的值都有什么，又都是什么含義呢？
這就要從 Connector/J 說起了。
Connector/J
Connector/J 是 Java 連接 MySQL 的連接器钧忽，或稱驅(qū)動(dòng)。
與 MySQL 現(xiàn)在有兩個(gè)活躍版本（5.7.x 和 8.0.x）一樣纸兔，Connector/J 目前也有兩個(gè)主要版本：5.1 和 8.0惰瓜。
但并不是只能用 5.1 版本的驅(qū)動(dòng)連 5.7.x 版本的 MySQL，或 8.0 版本的驅(qū)動(dòng)連接 8.0.x 版本的 MySQL汉矿，讓我們先來看一下兩個(gè)版本驅(qū)動(dòng)的 對(duì)比：
可以看到崎坊，官方強(qiáng)烈推薦使用或升級(jí)到 8.0 的版本，并且 5.1 系列版本已到達(dá)生命周期的尾聲洲拇，一年多沒有更新過了（最新版本 5.1.49 是 2020年4月 發(fā)布的）奈揍。
What's New in Connector/J 8.0
幾個(gè)主要的改進(jìn)：
- 需要 Java 8 或以上版本
- 支持 JDBC 4.2 規(guī)范
- 連接串中的 properties 有新增曲尸、更名及移除
- 主要代碼進(jìn)行了重構(gòu)及修整，以提供更好的性能
- 包結(jié)構(gòu)發(fā)生了整體調(diào)整（
com.mysql.cj.jdbc） - 異常更新男翰，以匹配 JDBC 標(biāo)準(zhǔn)
Properties
下面選擇部分實(shí)用的屬性進(jìn)行說明另患。
普通屬性
| Name | Default Value | Since | Description |
|---|---|---|---|
| connectionAttributes | - | 5.1.25 | 用戶定義的 key:value 對(duì)，可多個(gè)蛾绎，逗號(hào)間隔昆箕，保存在 P_S.SESSION_CONNECT_ATTRS 里 |
| createDatabaseIfNotExist | false | 3.1.9 | 連接串中的數(shù)據(jù)庫不存在時(shí)，報(bào)錯(cuò)（false）還是自動(dòng)創(chuàng)建（true） |
用戶自定義攔截器
| Name | Default Value | Since | Description |
|---|---|---|---|
| connectionLifecycleInterceptors | - | 5.1.4 | 可監(jiān)控或相應(yīng)連接創(chuàng)建租冠、銷毀鹏倘、提交、回滾等操作 |
| queryInterceptors | - | 8.0.7 | 提供查詢執(zhí)行前后的攔截能力 |
| exceptionInterceptors | - | 5.1.8 | 攔截異常并提供注入用戶行為的能力 |
網(wǎng)絡(luò)調(diào)整
| Name | Default Value | Since | Description |
|---|---|---|---|
| connectTimeout/socketTimeout | 0 | 3.0.1 | 客戶端連接超時(shí)時(shí)間 |
| useCompression | false | 3.0.17 | 與服務(wù)端通信時(shí)是否啟用壓縮 |
Statement 相關(guān)
| Name | Default Value | Since | Description |
|---|---|---|---|
| allowMultiQueries | false | 3.1.1 | 是否啟用在一個(gè) statement 里執(zhí)行多個(gè)查詢顽爹；可能會(huì)返回多個(gè) ResultSet纤泵；不會(huì)影響批量 statemnt |
| defaultFetchSize | 0 | 3.1.9 | 驅(qū)動(dòng)會(huì)使用這個(gè)默認(rèn)值在所有新創(chuàng)建的 Statement 時(shí)調(diào)用 setFetchSize(n)
|
Result Set 相關(guān)
| Name | Default Value | Since | Description |
|---|---|---|---|
| maxRows | -1 | all versions | 執(zhí)行 statements 返回的最大行數(shù) |
| padCharsWithSpace | false | 5.0.6 | 是否為 CHAR 類型的列填充空格至其定義的長度 |
日期時(shí)間處理
| Name | Default Value | Since | Description |
|---|---|---|---|
| connectionTimeZone | - | 3.0.2 | 指明服務(wù)端在處理日期時(shí)間轉(zhuǎn)換時(shí)所使用的時(shí)區(qū)，即 8.0 之前版本的 serverTimeZone 參數(shù)镜粤，后者目前也可使用捏题，但后續(xù)會(huì)被棄用 |
| zeroDateTimeBehavior | EXCEPTION | 3.1.4 | 定義當(dāng) MySQL 返回全是 0 的日期時(shí)間值時(shí)的行為：EXCEPTION、ROUND 或 CONVERT_TO_NULL
|
性能調(diào)整
| Name | Default Value | Since | Description |
|---|---|---|---|
| rewriteBatchedStatements | false | 3.1.13 | 是否重寫批量插入或使用批量查詢來減少發(fā)送的語句數(shù)量 |
| useCursorFetch | false | 5.0.0 | 與 Statement.setFetchSize() 一同肉渴，告訴服務(wù)端使用游標(biāo)方式進(jìn)行數(shù)據(jù)的讀取 |
Reference
完整的 Properties 參考文檔可見：
強(qiáng)烈建議修改每個(gè)參數(shù)的默認(rèn)值之前公荧，仔細(xì)閱讀官方文檔中對(duì)此參數(shù)的描述！
