一起MySQL時間戳精度引發的血案
寫在前面
最近工作中遇到兩例mysql時間戳相關的問題,一個是mysql-connector-java和msyql的精度不一致導致資料查不到;另一例是應用伺服器時區錯誤導致資料查詢不到。通過這篇文章,希望能夠解答關於mysql中時間戳的幾個問題:
- mysql中的DATETIME精度為什麼只支援到秒?
- mysql中的DATETIME型別跟時區有關嗎?
- mysql設計表的時候,表示時間的欄位改如何選擇?
案例分析 DATETIME的精度問題
前段時間,將負責的應用的mysql-connector-java的版本從5.1.16升級到5.1.30,在做功能迴歸的時候發現,使用了類似上面的SQL的用例的執行時資料會有遺漏,導致功能有問題。
考慮到我負責的應用中,有個功能需要用到類似下面這種SQL,即使用時間戳作為查詢的條件,查詢在某個時間戳之後的所有資料。
經過排查發現:mysql-connector-java在5.1.23之前會將秒後面的精度丟棄再傳給MySQL服務端,正好我們使用的mysql版本中DATETIME的精度是秒;在我將mysql-connector-java升級到5.1.30後,從java應用通過mysql-connector-java將時間戳傳到MySQL服務端的時候,就不會將毫秒數丟棄了,從mysql-connector-java的角度看是修復了一個BUG,但是對於我的應用來說卻是觸發了一個BUG。
如果你面對這個問題,你會怎麼修復呢?
我們當時想了三種方案:
- 將mybatis的Mapper介面中的時間戳引數的型別,從java.util.Date改成java.sql.Date;
在傳入Mapper介面之前,將傳入的時間戳按秒取正,程式碼如下
在查詢之前,將傳入的時間戳減1秒;
經過驗證,方案1會,java.util.Date轉過去的java.sql.Date物件會將日期之後的精度全部丟掉,從而導致查詢出更多不必要的資料;方案3是可以的,就是可能會查出多一兩條資料;方案2也是可以的,相當於從程式碼上對mysql-connector-java的特性做了補償。最終我選擇的是方案2。
案例復現
利用homebrew安裝MySQL,版本是8.0.15,裝好後建一個表,用來存放使用者資訊,SQL如下:
使用spirngboot + mybatis作為開發框架,定義一個使用者實體,程式碼如下所示:
定義該實體對應的Mapper,程式碼如下:
設定連線mysql相關的配置,程式碼如下:
編寫測試程式碼,先插入一條資料,然後用時間戳作為查詢條件去查詢,程式碼如下:
執行單測,如我們的設想,確實是沒有查詢出資料來,結果如下:
然後修改程式碼,利用上面的程式碼將查詢的時間戳按秒取正,程式碼如下:
再次執行單測,如我們的設想,這次可以查詢出資料來了。
不過,這裡有個小插曲,我在最開始設計表的時候,使用的SQL語句是下面這樣的,
聰明如你一定發現了,這裡的datetime已經支援小數點後更小的時間精度了,最多支援6位即最多可以支援到微妙級別。這個特性是什麼時候引入的呢,我去查閱了[MySQL的官方文件][9],發現這個特性是在mysql 5.6.4之後開始支援的。
知識點總結
經過了前面的實際案例分析和案例復現,想必讀者已經對mysql中DATETIME這個型別有了一定的認識,接下來跟我一起看下,我們從這個案例中可以總結出哪些經驗。
- mysql-connector-java的版本和mysql的版本需要配套使用,例如5.6.4之前的版本,就最好不要使用mysql-connector-java的5.1.23之前的版本,否則就可能會遇到我們這次遇到的問題。
- MySQL中用來表示時間的欄位型別有:DATE、DATETIME、TIMESTAMP,它們之間有相同點,各自也有自己的特性,我總結了一個表格,如下所示:
- DATETIME型別在MySQL中是以“YYYYMMDDHHMMSS”格式的整數存放的,與時區無關,使用8個位元組的空間;
- TIMESTAMP型別可以儲存的時間範圍要小很多,顯示的值依賴時區,MySQL的伺服器、作業系統以及客戶端連線都有時區的設定。
- 一般情況下推薦使用DATETIME作為時間戳欄位,不推薦使用bigint型別來儲存時間。
- 在開發中,應該儘量避免使用時間戳作為查詢條件,如果必須要用,則需要充分考慮MySQL的精度和查詢引數的精度等問題。
參考資料
- https://dev.mysql.com/doc/refman/8.0/en/datetime.html
- 《高效能MySQL》
***
本號(javaadu)專注於後端技術、JVM問題排查和優化、Java面試題、個人成長和自我管理等主題,為讀者提供一線開發者的工作和成長經驗,期待你能在這裡有所收穫。