1. 【強制】表達是與否概念的字段,必須使用is\_xxx的方式命名,數據類型是unsigned tinyint
( 1表示是,0表示否)。
說明:任何字段如果為非負數,必須是unsigned。
正例:表達邏輯刪除的字段名is\_deleted,1 表示刪除,0 表示未刪除。
1. 【強制】表名、字段名必須使用小寫字母或數字,禁止出現數字開頭,禁止兩個下劃線中間只出現數字。數據庫字段名的修改代價很大,因為無法進行預發布,所以字段名稱需要慎重考慮。
說明:MySQL 在 Windows 下不區分大小寫,但在 Linux 下默認是區分大小寫。因此,數據庫名、表名、字段名,都不允許出現任何大寫字母,避免節外生枝。
正例:aliyun\_admin,rdc\_config,level3\_name 反例:AliyunAdmin,rdcConfig,level\_3\_name
1. 【強制】表名不使用復數名詞。
說明:表名應該僅僅表示表里面的實體內容,不應該表示實體數量,對應于DO類名也是單數形式,符合表達習慣。
1. 【強制】禁用保留字,如desc、range、match、delayed等,請參考MySQL官方保留字。
2. 【強制】主鍵索引名為pk\_字段名;唯一索引名為uk\_字段名;普通索引名則為idx\_字段名。
說明:pk\_ 即primary key;uk\_ 即 unique key;idx\_ 即index的簡稱。
1. 【強制】小數類型為decimal,禁止使用float和double。
說明:float和double在存儲的時候,存在精度損失的問題,很可能在值的比較時,得到不
正確的結果。如果存儲的數據范圍超過decimal的范圍,建議將數據拆成整數和小數分開存儲。
1. 【強制】如果存儲的字符串長度幾乎相等,使用char定長字符串類型。
2. 【強制】varchar是可變長字符串,不預先分配存儲空間,長度不要超過5000,如果存儲長度大于此值,定義字段類型為text,獨立出來一張表,用主鍵來對應,避免影響其它字段索引效率。
3. 【強制】表必備三字段:id, gmt\_create, gmt\_modified。
說明:其中id必為主鍵,類型為unsigned bigint、單表時自增、步長為 1。gmt\_create, gmt\_modified的類型均為date\_time類型,前者現在時表示主動創建,后者過去分詞表示被動更新。
1. 【推薦】表的命名最好是加上“業務名稱\_表的作用”。
正例:alipay\_task / force\_project / trade\_config
1. 【推薦】庫名與應用名稱盡量一致。
2. 【推薦】如果修改字段含義或對字段表示的狀態追加時,需要及時更新字段注釋。
3. 【推薦】字段允許適當冗余,以提高查詢性能,但必須考慮數據一致。冗余字段應遵循:
1) 不是頻繁修改的字段。
2) 不是varchar超長字段,更不能是text字段。
正例:商品類目名稱使用頻率高,字段長度短,名稱基本一成不變,可在相關聯的表中冗余存儲類目名稱,避免關聯查詢。
1. 【推薦】單表行數超過500萬行或者單表容量超過2GB,才推薦進行分庫分表。
說明:如果預計三年后的數據量根本達不到這個級別,請不要在創建表時就分庫分表。
1. 【參考】合適的字符存儲長度,不但節約數據庫表空間、節約索引存儲,更重要的是提升檢索速度。
正例:如下表,其中無符號值可以避免誤存負數,且擴大了表示范圍。
對象
年齡區間
類型
字節
表示范圍
人
150歲之內
unsigned tinyint
1
無符號值:0到255
龜
數百歲
unsigned smallint
2
無符號值:0到65535
恐龍化石
數千萬年
unsigned int
4
無符號值:0到約42.9億
太陽
約50億年
unsigned bigint
8
無符號值:0到約10的19次方
- 一、編程規約????1
- (一) 命名風格????1
- (二) 常量定義????3
- (三) 代碼格式????4
- (四) OOP規約????6
- (五) 集合處理????9
- (六) 并發處理????12
- (七) 控制語句????14
- (八) 注釋規約????16
- (九) 其它????17
- 二、異常日志????18
- (一) 異常處理????18
- (二) 日志規約????19
- 三、單元測試????21
- 四、安全規約????23
- 五、MySQL數據庫????24
- (一) 建表規約????24
- (二) 索引規約????25
- (三) SQL語句????27
- (四) ORM映射????28
- 六、工程結構????30
- (一) 應用分層????30
- (二) 二方庫依賴????31
- (三) 服務器????32
- 附1:版本歷史????34
- 附2:本手冊專有名詞????35