本文共 4477 字,大约阅读时间需要 14 分钟。
本节书摘来自异步社区出版社《锋利的SQL(第2版)》一书中的第1章,第1.9节,作者:张洪举 王晓文,更多章节内容可以访问云栖社区“异步社区”公众号查看。
锋利的SQL(第2版)
书写规范与语法规范是两个完全不同的概念,违反语法规范会导致程序执行错误,而违反书写规范虽然不会导致错误,但是会导致阅读困难和代码的通用性。这些书写规范是根据大多数人阅读代码时的习惯而提出的,并不是必须完全遵守的。1.在名称中仅使用字母、数字和下划线
之所以要在名称中仅使用字母、数字和下划线,因为这些字符可以被移植到任何其他编程语言中。在应用程序的数据库和宿主语言中能够使用相同的名称,会非常方便。但是,也存在一些特殊情况。例如,在SQL Server中临时表名称需要以“#”开头,而它在其他编程语言中具有特殊含义。如果必须使用临时表,则只能使用“#”。此外,参数名称也存在这种情况,它需要以“@”开头。但是,无论怎样,在名称中尽量避免使用特殊符号是一个非常正确的选择。
不要将下划线作为名称的第一个或最后一个字母,因为这看上去像少了一部分一样。
2.列名、参数和变量等标量小写
通常情况下,小写单词比大写容易阅读。曾经做过测试,阅读小写文本的速度比大写的速度快5%~10%。当名称由两个单词组合而成时,为便于阅读,应当采用大小写混合的写法。例如,下面按由易至难的方式列出了存放修改日期列的三种书写方法:ModifiedDate -- 比较容易阅读modifieddate -- 阅读难度增加MODIFIEDDATE -- 阅读最困难
但是,也有一种观点认为大小写混合的写法阅读起来比全部小写要难一些,原因是在全部小写的情况下,会把modifieddate看作一个单词,而ModifiedDate这种形式会被看作两个单词,分散注意力。总之,在列名、参数和变量中全部使用大写字母是一个非常糟糕的选择。
3.模式对象名首字母大写
模式对象包括表、视图和存储过程等,在创建这些名称时,应当将首字母大写,表示为专有名词。4.保留关键字大写
保留关键字是Transact-SQL语言语法的一部分,用于定义、操作和访问数据库。将保留关键字大写后,会起到一种突出效果,使整个语句重点突出、结构清晰。看一下下面的语句:select a, b, c from MyTable where id = 1;对比一下:SELECT a, b, c FROM MyTable WHERE id = 1;
阅读上面的两个语句,看一下能否快速找出每个子句,而下面的书写格式则阅读起来会更清晰。
SELECT a, b, c FROM MyTable WHERE id = 1;
下面列出了SQL Server的保留关键字:
ADD | ALL | ALTER | AND | ANY | AS | ASC | AUTHORIZATIONBACKUP | BEGIN | BETWEEN | BREAK | BROWSE | BULK | BYCASCADE | CASE | CHECK | CHECKPOINT | CLOSE | CLUSTERED | COALESCECOLLATE | COLUMN | COMMIT | COMPUTE | CONSTRAINT | CONTAINSCONTAINSTABLE | CONTINUE | CONVERT | CREATE | CROSS | CURRENTCURRENT_DATE | CURRENT_TIME | CURRENT_TIMESTAMP | CURRENT_USERCURSORDATABASE | DBCC | DEALLOCATE | DECLARE | DEFAULT | DELETE | DENYDESC | DISK | DISTINCT | DISTRIBUTED | DOUBLE | DROP | DUMPELSE | END | ERRLVL | ESCAPE | EXCEPT | EXEC | EXECUTE | EXISTS EXIT | EXTERNALFETCH | FILE | FILLFACTOR | FOR | FOREIGN | FREETEXT | FREETEXTTABLE FROM | FULL | FUNCTIONGOTO | GRANT | GROUPHAVING | HOLDLOCKIDENTITY | IDENTITY_INSERT | IDENTITYCOL | IF | IN | INDEX | INNER | INSERTINTERSECT | INTO | ISJOINKEY | KILLLEFT | LIKE | LINENO | LOADMERGE | NATIONAL | NOCHECK | NONCLUSTERED | NOT | NULL | NULLIFOF | OFF | OFFSETS | ON | OPEN | OPENDATASOURCE | OPENQUERY | OPENROWSETOPENXML | OPTION | OR | ORDER | OUTER | OVERPERCENT | PIVOT | PLAN | PRECISION | PRIMARY | PRINT | PROC PROCEDURE | PUBLICRAISERROR | READ | READTEXT | RECONFIGURE | REFERENCES | REPLICATIONRESTORE | RESTRICT | RETURN | REVERT | REVOKE | RIGHT | ROLLBACKROWCOUNT | ROWGUIDCOL | RULESAVE | SCHEMA | SECURITYAUDIT | SELECT | SEMANTICKEYPHRASETABLESEMANTICSIMILARITYDETAILSTABLE | SEMANTICSIMILARITYTABLESESSION_USER | SET | SETUSER | SHUTDOWN | SOME | STATISTICS | SYSTEM_USERTABLE | TABLESAMPLE | TEXTSIZE | THEN | TO | TOP | TRAN | TRANSACTION TRIGGER | TRUNCATE | TRY_CONVERT | TSEQUALUNION | UNIQUE | UNPIVOT | UPDATE | UPDATETEXT | USE | USERVALUES | VARYING | VIEWWAITFOR | WHEN | WHERE | WHILE | WITH | WITHIN GROUP | WRITETEXT
在语言标记之间放置一个空格,尽量地符合英语书写习惯,可以增强语句的可阅读性。
1.等号两边使用空格
在书写赋值语句时,应当在等号两边使用空格分隔,如SET @i = 1比SET @i=1更容易阅读。2.逗号后面使用空格
应当遵循在逗号后面使用空格的原则,因为英语中逗号和句号很容易混淆。例如:SELECT MyTable.a,MyTable1.b,MyTable2.cFROM MyTable,MyTable1,MyTable2;下面的形式会更容易阅读一些:SELECT MyTable.a, MyTable1.b, MyTable2.cFROM MyTable, MyTable1, MyTable2;
当表或列名称比较长时,下面的形式则更好一些。
SELECT EmployeeID, Title, BirthDate, MaritalStatusFROM HumanResources.Employee;
必要的缩进会使语句的层次和逻辑关系更加清晰,通常是缩进2个空格。例如,在下面的语句中,AND关键词连接了两个筛选条件,缩进后会更加突出WHERE子句。
SELECT * FROM HumanResources.EmployeeWHERE ManagerID = 16 AND EmployeeID > 100;
下面是一个左外连接的语句,首先将HumanResources.Employee和Person.Contact表中列分别放在了单独的行中,以便进行区分;然后LEFT缩进后表示与FROM后面的表进行连接,ON再次缩进表示是LEFT的连接条件。
SELECT E.EmployeeID, E.Title, P.FirstName, P.LastName, P.EmailAddressFROM HumanResources.Employee AS E LEFT OUTER JOIN Person.Contact AS P ON E.EmployeeID = P.ContactID WHERE E.ManagerID = 16 AND E.EmployeeID > 100;
还有一种观点认为,在关键词与参数之间应当使用垂直空白道的方式进行分隔,会增强可阅读性。例如:
SELECT E.EmployeeID, E.Title, P.FirstName, P.LastName, P.EmailAddress FROM HumanResources.Employee AS E LEFT OUTER JOIN Person.Contact AS P ON E.EmployeeID = P.ContactID WHERE E.ManagerID = 16 AND E.EmployeeID > 100;
又如,下面的语句使用了垂直空白道分隔,并对子查询使用了缩进。
SELECT DISTINCT CustName FROM Customers AS C WHERE NOT EXISTS (SELECT * FROM OrderHeader WHERE CustID = Customers.CustID);
存在多行Transact-SQL的情况下,相关语句之间可以直接换行书写,而对于两个步骤之间的语句应当间隔一个空行。如果需要的话,也可以加入一些适当的注释语句。例如:
USE AdventureWorks2014;GO-- 读取 Employee 表的数据SELECT *FROM HumanResources.Employee;GO
本文仅用于学习和交流目的,不代表异步社区观点。非商业转载请注明作译者、出处,并保留本文的原始链接。