阿裏巴巴Java 開發手冊編程規約之MySQL 數據庫
(一)建表規約
1. 【強制】表達是與否概念的字段,必須使用 is_xxx 的方式命名,數據類型是 unsigned tinyint
(1 表示是, 0 表示否) 。
說明: 任何字段如果為非負數,必須是 unsigned。
正例: 表達邏輯刪除的字段名 is_deleted, 1 表示刪除, 0 表示未刪除。
2. 【強制】表名、字段名必須使用小寫字母或數字, 禁止出現數字開頭,禁止兩個下劃線中間只
出現數字。數據庫字段名的修改代價很大,因為無法進行預發布,所以字段名稱需要慎重考慮。
正例: getter_admin, task_config, level3_name
反例: GetterAdmin, taskConfig, level_3_name
3. 【強制】表名不使用復數名詞。
說明: 表名應該僅僅表示表裏面的實體內容,不應該表示實體數量,對應於 DO 類名也是單數
形式,符合表達習慣。
4. 【強制】禁用保留字,如 desc、 range、 match、 delayed 等, 請參考 MySQL 官方保留字。
5. 【強制】 主鍵索引名為 pk_字段名; 唯一索引名為 uk_字段名; 普通索引名則為 idx_字段名。
說明: pk_ 即 primary key; uk_ 即 unique key; idx_ 即 index 的簡稱。
6. 【強制】小數類型為 decimal,禁止使用 float 和 double。
說明: float 和 double 在存儲的時候,存在精度損失的問題,很可能在值的比較時,得到不
正確的結果。如果存儲的數據範圍超過 decimal 的範圍,建議將數據拆成整數和小數分開存儲。
7. 【強制】如果存儲的字符串長度幾乎相等,使用 char 定長字符串類型。
8. 【強制】 varchar 是可變長字符串,不預先分配存儲空間,長度不要超過 5000,如果存儲長
度大於此值,定義字段類型為 text,獨立出來一張表,用主鍵來對應,避免影響其它字段索
引效率。
9. 【強制】表必備三字段: id, gmt_create, gmt_modified。
說明: 其中 id 必為主鍵,類型為 unsigned bigint、單表時自增、步長為 1。 gmt_create,
gmt_modified 的類型均為 date_time 類型。
10. 【推薦】表的命名最好是加上“業務名稱_表的作用”。
正例: tiger_task / tiger_reader / mpp_config
11. 【推薦】庫名與應用名稱盡量一致。
12. 【推薦】如果修改字段含義或對字段表示的狀態追加時,需要及時更新字段註釋 。
13. 【推薦】字段允許適當冗余,以提高查詢性能,但必須考慮數據一致。冗余字段應遵循:
1) 不是頻繁修改的字段。
2) 不是 varchar 超長字段,更不能是 text 字段。
正例: 商品類目名稱使用頻率高, 字段長度短,名稱基本一成不變, 可在相關聯的表中冗余存
儲類目名稱,避免關聯查詢。
14. 【推薦】單表行數超過 500 萬行或者單表容量超過 2GB,才推薦進行分庫分表。
說明: 如果預計三年後的數據量根本達不到這個級別,請不要在創建表時就分庫分表。
15. 【參考】合適的字符存儲長度,不但節約數據庫表空間、節約索引存儲,更重要的是提升檢
索速度。
阿裏巴巴Java 開發手冊編程規約之MySQL 數據庫