SQL 数据库命名规范

1.  概述

1.1. 基本原则

以大小写敏感编写SQL语句。

尽量使用Unicode 数据类型。

优先使用连接代替子查询或嵌套查询。

尽量使用参数化SQL查询代替语句拼接SQL查询。

禁止使用[拼音]+[英语]的方式来命名SQL对象或变量。

尽量使用存储过程代替SQL语句。

1.2. 基本规范

采用Pascal样式命名数据库对象。

大写T-SQL语言的所有关键字，谓词和系统函数。

2.  命名规范

采用Pascal样式命名数据库对象，使在开发基于数据库应用程序的时候通过ORM工具生成的数据访问代码不需要调整就符合程序开发语言（比如C#）命名规范。

2.3. 对象命名

2.3.1.  数据库

采用Pascal样式命名，命名格式为[项目英文名称]。

示例：AdventureWorks

2.3.2.  数据库文件

数据文件：[数据库名称] + _Data.mdf

日志文件：[数据库名称] + _Log.ldf

示例：AdventureWorks_Data.mdf

AdventureWorks_Log.ldf

2.3.3.  数据表

采用Pascal样式命名，命名格式为[表名]。

示例：Employee

      Product

表名以英文单数命名，主要是参考SQL Server 2005示例数据库，个人理解不采用复数是为了更好的使用ORM工具生成符合编程规范的代码（比如C#）。

示例：使用Product

而不是Products

2.3.4.  数据视图

视图名称采用Pascal样式命名，命名格式为v + [视图名称]。

示例：vEmployee

vSalesPerson

2.3.5.  数据列

列名称命名采用英文单词或缩写，英文单词只来自于具体业务定义，尽量表达清楚含义。采用Pascal样式命名，命名格式为[列名称]。

示例：AddressID

PostalCode

尽量避免使用拼音命名，如果不可避免，对于比较短的列名，采用拼音全写，如果拼音列名比较复杂，可以采用首个字用全拼，其它字用首字母大写表示。

示例：宁波 Ningbo

经营方式JingYFS

2.3.6.  存储过程

采用Pascal样式命名，命名格式为[存储过程名称]。

示例：GetUser

AddUser

2.3.7.  函数

自定义函数采用Pascal样式命名，命名格式为[函数名]，系统函数使用全部大写。

示例：SELECT ISNULL(@LastName,'Unknown last name');

GETDATE()

2.3.8.用户定义数据类型

采用Pascal样式命名，命名格式为[自定义数据类型名称]。

示例：Flag

NameStyle

2.3.9. DML触发器

DML触发器是当数据库服务器中发生数据操作语言 (DML) 事件时要执行的操作。DML 事件包括对表或视图发出的 UPDATE、INSERT 或 DELETE 语句。根据事件不同命名规则使用前缀进行区分,格式为 [u|i|d] + [表名|视图名]

示例：uEmployee

iEmployee

dEmployee

另外一种方式为，

AFTER 触发器：TR_表名_[后面插入加I,修改加U,删除加D]。

INSTEAD OF 触发器：TR_表名或视图名_OF[后面插入加I,修改加U,删除加D]

2.3.10. DDL触发器

响应各种数据定义语言 (DDL) 事件而激发。这些事件主要与以关键字 CREATE、ALTER 和 DROP 开头的 Transact-SQL 语句对应。执行 DDL 式操作的系统存储过程也可以激发 DDL 触发器。

采用Camel样式命名，命名单词能够描述DDL触发器功能。

示例：

CREATE TRIGGER safety

ON DATABASE

FOR DROP_TABLE, ALTER_TABLE

AS

   PRINT 'You must disable Trigger "safety" to drop or alter tables!'

ROLLBACK ;

2.3.11.主键、外键关系和索引

主键: PK_[表名称]_[主键]；如果是组合主键，使用PK_[表名]_[主键1]_[主键2]。

示例：PK_Store_CustomerID

PK_StoreContact_CustomerID_ContactID

外键关系：FK_[从表名称]_[主表名称]_[外键列名称]。

示例：FK_StoreContact_Store_CustomerID

聚集索引：PK_[表名称]_[主键]；如果是组合主键，使用PK_[表名]_[主键1]_[主键2]。

示例：PK_Store_CustomerID

PK_StoreContact_CustomerID_ContactID

唯一非聚集索引:AK_[表名称]_[列名称]。

示例：AK_Store_rowguid

不唯一非聚集索引：PK_[表名称]_[列名称]。

示例：IX_Store_SalesPersonID

主 XML索引：PXML_[表名称]_[Xml类型列名称]。

示例：PXML_Store_Demographics

2.4. 参数命名

2.4.1.  数据列参数

命名格式为 @ + [列名称]。

示例：@EmployeeID

2.4.2.  非数据列参数

在参数无法跟列名称进行关联时，使用能够反映该参数功能的英文单词或单词组合, 采用Pascal样式命名。

示例：@ErrorID

      @Flag

2.5. 常见命名

2.5.1.  常用字段命名

这里的常用字段是指在建表时频繁使用的表名或列名，下表对常用字段进行建议性定义,

列名称数据类型说明

CreatedDatedatetime纪录创建日期，一般使用GETDATE()自动生成

ModifiedDatedatetime纪录最后修改日期，首次使用GETDATE()

DeletedDatedatetime记录删除（标记删除）日期

StartDatedatetime开始日期

EndDatedatetime结束日期

StartTimedatetime开始时间

EndTimedatetime结束时间

rowguiduniqueidentifier唯一标识行的ROWGUIDCOL号，用于支持合并复制

ID              int使用ID代替Id或id。一般为自增长主键列

ParentIDint父ID

Status          int状态

3.  SQL编写

3.1. 大小写

大写T-SQL 语言的所有关键字，谓词和系统函数。变量名称及游标名称使用Pascal样式。数据类型定义使用全部小写。

示例：DECLARE @LastNamenvarchar(32);

3.2. 使用“;”

使用“;”作为 Transact-SQL 语句终止符。虽然分号不是必需的，但使用它是一种好的习惯。

示例：

USE AdventureWorks;

GO

DECLARE @find varchar(30);

SET @find = 'Man%';

SELECT LastName, FirstName, Phone

FROM Person.Contact

WHERE LastName LIKE @find;

3.3. 存储格式

尽量采用Unicode数据存储格式，提高可移植性和兼容性，实际应用中尽量使用nchar、nvarchar、ntext代替char、varchar、text。

3.4. 类型选择

如果字符具有明确的长度，使用nchar代替nvarchar；char代替varchar。

在只有两个可能数值时，使用bit代替int或smallint。

在SQL Server 2005中，使用nvarchar(MAX)代替ntext；varchar(MAX)代替text；varbinary(MAX)代替image。

在特殊的数据表结构中可考虑xml数据类型，达到事半工倍的效果。

3.5. 默认值

在建立数据表时，尽量使用默认值代替NULL值。比如设置CreatedDate列默认值为GETDATE()。在可行的情况下设置字段为不允许空。

3.6. 字段长度

始终指定字符数据类型的长度，并确保允许用户可能需要的最大字符数，避免超出最大长度时出现字符丢失现象。对于字符型数据，建议采用2的n次方来定义数据长度。

示例：nvarchar(32)

varchar(64)

3.7. 使用“'”

在 T-SQL 代码中为字符常量使用单引号,避免使用双引号。

3.8. 语句缩进

一个嵌套代码块中的语句使用四个空格的缩进。使用Microsoft SQL Server Management Studio ,选择“工具”菜单，打开“选项”菜单，在选项对话框中选择文本编辑器->纯文本->制表符,选中“插入空格单选框”,设置“制表符大小”为4，缩进大小为“4”。

3.9. 语句换行

建议SQL代码每行以关键字或“'”开头。

示例：

SELECT [ShiftID]

,[Name]

,[StartTime]

,[EndTime]

,[ModifiedDate]

  FROM [AdventureWorks].[HumanResources].[Shift]

3.10.   语句分割

使用一个（而不是两个）空行分隔 T-SQL 代码的逻辑块。

3.11.   使用“*”

尽量避免在任何代码中使用“SELECT *”。

3.12.   表名别名

表名别名要简短，但意义要尽量明确。通常使用大写的表名作为别名，使用 AS 关键字指定表或字段的别名。

3.13.   类型转换

不要依赖任何隐式的数据类型转换，不要假定 T-SQL 会进行必要的转换。例如，把数字变量赋予字符值。相反，在为变量赋值或比较值之前，应使用适当的 CONVERT 函数使数据类型相匹配。

3.14.   数值比较

不要将空的变量值直接与比较运算符（符号）比较。如果变量可能为空，应使用 IS NULL 或 IS NOT NULL 进行比较，或者使用 ISNULL 函数。

3.15.   排序

决不要依赖 SELECT 语句会按任何特定顺序返回行，除非在 ORDER BY 子句中指定了顺序。通常，应将 ORDER BY 子句与 SELECT 语句一起使用。可预知的顺序（即使不是最方便的）比不可预知的顺序强，尤其是在开发或调试过程中。在返回行的顺序无关紧要的情况下，可以忽略 ORDER BY ，减少资源开销。

3.16.   Unicode字符串

在Unicode字符前面使用N前缀，避免引起数据的不一致。

示例：

-- Assumes the default code page is not Greek

CREATE TABLE #t1 (c1 nchar(1))

INSERT #t1 VALUES(N'Ω')

INSERT #t1 VALUES('Ω')

SELECT * FROM #t1

输出结果：

c1  

----

Ω

O

3.17.   BEGIN...END 块

在SQL代码快中尽量使用BEGIN...END 语句块，提高代码可阅读性。

3.18.   TRY块

在SQL Server 2005中对一些可能执行失败的语句尽量使用TRY块。Transact-SQL 语句组可以包含在 TRY 块中，如果 TRY 块内部发生错误，则会将控制传递给 CATCH 块中包含的另一个语句组。

示例：

BEGIN TRY

    SQL 语句组1

END TRY

BEGIN CATCH

    SQL 语句组2

END CATCH;

3.19.   TOP子句

在SQL Server 2005中加强了TOP的使用，尽量使用TOP(变量)来减少SQL拼串现象。

3.20.   TRANSACTION编写

只要在例程中使用多个数据库修改语句，包括在一个循环中多次执行一个语句，就应考虑声明显式事务。在SQL SERVER 2005 中，增加了TRY块可进行很好的应用。

实例：

    BEGIN TRY

        BEGIN TRANSACTION;

        UPDATE [HumanResources].[Employee]

        SET [Title] = @Title

,[HireDate] = @HireDate

,[CurrentFlag] = @CurrentFlag

        WHERE [EmployeeID] = @EmployeeID;

        INSERT INTO [HumanResources].[EmployeePayHistory]

            ([EmployeeID]

,[RateChangeDate]

,[Rate]

,[PayFrequency])

        VALUES (@EmployeeID, @RateChangeDate, @Rate, @PayFrequency);

        COMMIT TRANSACTION;

    END TRY

    BEGIN CATCH

        -- Rollback any active or uncommittable transactions before

        -- inserting information in the ErrorLog

        IF @@TRANCOUNT > 0

        BEGIN

            ROLLBACK TRANSACTION;

        END

        EXECUTE [dbo].[uspLogError];

    END CATCH;

3.21.   存储过程

在编写存储过程时，使用PROCEDURE 代替 PROC 简写。

示例：CREATE PROCEDURE [dbo].[存储过程名字]

4.  代码注释

4.1. 代码头部注释

在SQL代码块（sql文件或存储过程）的头部进行注释，标注创建人(Author)、创始日期(Create date)、修改信息(Modify [n])。

格式：

-- =============================================

-- Author:      <Author,,Name>

-- Create date: <Create Date,,>

-- Description: <Description,,>

-- Modify [n]:<Modifier,Date, Description >

-- =============================================

示例：

-- ================================================

-- Author:      Zhanghaifeng

-- Create date: 2006-12-25

-- Description: H2000报关单回执处理

-- Modify [1]:  郑佐, 2006-12-31, 简化逻辑判断流程

-- Modify [2]:  郑佐, 2007-01-20, 更新条件判断

-- ================================================

注：日期格式使用yyyy-MM-dd。Modify [n] n代表修改序号，从1开始，每次修改加1。

4.2. TRANSACTION注释

建议在每个事务的开头进行注释，说明该事务的功能。

-- <Modifier,Date, Description >

BEGIN TRANSACTION;