2012SQL代码编写指导规范.docVIP

项目： 规范 文号： COD-STA-03 版本： V1.1 编写者： 许飞云 时间： 2005-11-4 SQL代码编写指导规范 版本变更说明： 时间 版本 作者/修改人 变更原因 2005-11-4 V1.0 许飞云 初版发布 2007-3-5 V1.1 刘莉 添加5.4 约定规则 目 录 1 简介 2 1.1 目标 2 1.2 范围 2 1.3 基本依据 2 1.4 使用约定 2 1.4.1 规则 2 1.4.2 建议 2 1.5 术语和缩略语 2 1.6 参考 3 2 通用规则 3 3 配置约定 3 4 格式约定 3 5 命名约定 4 5.1 一般规则 4 5.2 命名规则 4 5.3 常用规则 5 5.4 约定规则 6 5.4.1 表名采用前缀+表名的方式，前缀定义如下: 6 6 注释 7 6.1 SQL代码注释 7 6.2 对象注释 7 7 嵌入式代码 8 1 简介 开发小组在进行 SQL 编程时常常会忽略所谓的编码标准，但这些标准却是开发小组顺利开展工作的关键工具。这里介绍的编码标准是经整理出来的开发成果。它们当然还没有得到普遍接受，而且不可否认，有些标准带有主观色彩。整理出此规范实际上更多的是为了提高大家的意识，而不是吹捧每个人是 SQL 编写方面的仲裁者：最重要的是要建立某些合理的编码标准并遵循这些标准。您在这篇文章中会发现有关 SQL 编程的一系列不同的编码标准、技巧和提示。它们并未以任何特定的优先级或重要性顺序列出。 1.1 目标 本主题提供SQL编程语言的命名指南。希望能对下述情况有积极的作用： 避免Errors/Bugs ，特别是难以查询的Errors/Bugs 规范不良的编码习惯 提高程序的可读性、可维护性和可移值性 1.2 范围 规范只针对 SQL Server数据库中的SQL编程语言本文档主要依据一位具有超过 25 年经验的数据库管理员和应用程序开发员 Brian Walker 提出的开发成果。 同时也可参考MSDN文档中相应的规范。规则 本文档表明没有特别的理由必须要遵守的要求。违反规则的编码人员必须至少同有经验的同事商量并取得违反规则的理由共识后才能实施。必须对违反规则的代码进行注解。 建议 正常情况下优先考虑，如果有违反建议的编码，应该同有经验的同事商量并取得违反建议的理由共识后才能实施，推荐对违反建议的代码进行注解。 术语 全称 含义 部份命令 备注 SQL Structrued Query Language 结构化查询语言 DDL Data Definition Language 数据定义语言 CREATE, ALTER, DROP, DECLARE DM L Data Manipulation Language 数据操纵语言 SELECT, DELETE, UPDATE, INSERT DCL Data Control Language 数据控制语言 GRANT, REVOKE, COMMIT, ROLLBACK 1.6 参考 MSDN-命名指南 Sql Server 2000 联机帮助为方便开发小组成员编写出高质量的SQL代码，需要开发小组各成员按照统一的标准配置适合快速、高效开发的使用环境。这里，将会列出一些较为适用的参数配置约定，需要开发小组成员统一执行该约定： 项目 推荐方案 备注 1 SQL代码编辑工具 查询分析器 SQL Server 自带 2 缩进符 使用4个空格字符 需要配置编辑器 说明： 可以使用Tab键进行缩进处理，建议在配置选项中，将默认的制表符，更改为四个空格字符，这样不管用什么程序查看SQL代码，都能保证是一致的格式 4 格式约定 表面上，SQL 代码的格式似乎并不重要，但一致的格式可以使您的同事（不论是同一小组的成员还是更大范围的项目开发团队的成员）更轻松地浏览和理解您的SQL代码。为SQL 语句定义一个结构，遵循一目了然的结构将使您可以更轻松地查找和确认语句的不同部分。统一的格式还使您可以更轻松地在复杂的SQL 语句中增、删代码段，也使调试工作变得更容易。 下面是 SELECT 语句的格式示例，来说明SQL代码中的部份适用的格式： SELECT C.Name , E.NameLast , E.NameFirst , E.Number , ISNULL(I.Description,NA) AS Description FROM tblCompany AS C JOIN tblEmploy