笔记179 数据库命名规则
笔记179 数据库命名规则
1 --数据库命名规则 2 3 1 设计规范: 4 1.1 采用有意义的字段名 5 尽可能地把字段描述的清楚些。当然,也别做过头了,比如CustomerShippingAddressStreetLine1 虽然很富有说明性,但没人愿意键入这么长的名字,具体尺度就在你的把握中。 6 每个单词的首个字母要求用大写,不要用下划线来连接每个单词!!! 7 1.2 遵守3NF 标准3NF 规定: 8 A. 表内的每一个值都只能被表达一次。 9 B. 表内的每一行都应该被唯一的标识(有唯一键)。 10 C. 表内不应该存储依赖于其他键的非键信息。 11 1.3 小心保留词 12 要保证你的字段名没有和保留词、数据库系统或者常用访问方法冲突,比如,写的一个ODBC 连接程序里有个表,其中就用了DESC 作为说明字段名。后果可想而知!DESC 是DESCENDING 缩写后的保留词。表里的一个SELECT *语句倒是能用,但我得到的却是一大堆毫无用处的信息。 13 1.4 保持字段名和类型的一致性 14 在命名字段并为其指定数据类型的时候一定要保证一致性。假如字段在某个表中叫做“AgreeMentNumber”,你就别在另一个表里把名字改成“ref1”。假如数据类型在一个表里是整数,那在另一个表里可就别变成字符型了。记住,你干完自己的活了,其他人还要用你的数据库呢。 15 16 2 命名规则: 17 2.1 数据库(Database)的定义 18 数据库名称 = 数据库内容标识(首字大写) 19 2.2 表(Table)的定义 20 命名应尽量反映存储的数据内容。 21 表名前缀:以该表及与该表相关联的一系列表的内容而得到一个代表统一的标识 22 表名称 = 表内容标识(首字大写) 23 2.3 字段(Field)的定义 24 字段是数据库中的用途最广泛的,它的类型非常多,所以必须加类型前缀来标示它的类型。 25 字段名称 = 字段内容标识(首字大写) 26 2.4 视图名 27 视图的名称 = "vw" + 视图内容标识(首字大写) 28 如 vwUserPerm 29 2.5 触发器名 30 触发类型触发标识 31 ----------------------------------- 32 Insert i 33 Delete d 34 Update u 35 触发名= "tr" + 触发标识 + 相应的表名 36 如:triClient,trdClient。 37 2.6 存储过程名 38 存储过程功能存储过程功能前缀 39 ---------------------------------------- 40 添加a 41 更新u 42 删除d 43 查询或其它o 44 存储过程名称 = 存储过程内容标识(首字大写) 45 2.7 变量名 46 每个单词的首个字母为大写,如@EmployeeName。 47 2.8 命名中其他注意事项 48 禁止使用中文命名!!!!! 49 命名都不得超过30个字符的系统限制,变量名的长度限制为29(不包括标识字符@)。 50 命名都采用英文字符,每个单词的首个字母要大写 51 2.9 SQL语句的编写规范 52 数据库中存储过程和触发器中涉及大量的SQL语句,对SQL语句的编写规范如下: 53 关键字大写:在SQL语句的编写中,凡是SQL语句的关键字一律大写,如:SELECT、ORDER BY、 GROUP BY、 FROM、WHERE、 UPDATE、 INSERT INTO、 SET、 BEGIN、 END ...... 54 2.10 Rule 55 ru+Rule标识 56 2.11 主键 57 pk+表名+主键标识 58 2.12 外键 59 fk+表名+主表名+外键标识 60 2.13 索引 61 idx+字段标识 62 2.14 Default 63 df+Default标识 64 65 3 编程结构和描述 66 SQL SERVER系统中,一个批处理是从客户传给服务器的一个完整的包,可以包含若干条SQL语句。批处理中的语句是作为一组去进行语法分析、编译和执行的。触发器、存储过程等数据对象则是将批处理永久化的方法。 67 3.1 注释 68 注释可以包含在批处理中。在触发器、存储过程中包含描述性注释将大大增加文本的可读性和可维护性。本规范建议: 69 a) 注释以英文为主。 70 实际应用中,发现以中文注释的SQL语句版本在英文环境中不可用。为避免后续版本执行过程中发生某些异常错误,建议使用英文注释。 71 b) 注释尽可能详细、全面。 72 创建每一数据对象前,应具体描述该对象的功能和用途。 73 传入参数的含义应该有所说明。如果取值范围确定,也应该一并说明。取值有特定含义的变量(如boolean类型变量),应给出每个值的含义。 74 c) 注释语法包含两种情况:单行注释、多行注释 75 单行注释:注释前有两个连字符(--),最后以行尾序列(CR-LF)结束。一般,对变量、条件子句可以采用该类注释。 76 多行注释:符号/*和*/之间的内容为注释内容。对某项完整的操作建议使用该类注释。 77 d) 4、注释简洁,同时应描述清晰。 78 3.2 函数注释: 79 编写函数文本--如触发器、存储过程以及其他数据对象--时,必须为每个函数增加适当注释。该注释以多行注释为主,主要结构如下: 80 81 /******************************************************************************************* 82 * 存储过程:读取用户所分配的操作模块及具体权限 83 * 编 制 者 :saiko 84 * 修 改 人 : 85 * 编制日期:2004.11.27 86 * 输入参数:共有2个参数 87 * @cUserNo:用户编号 88 * @cUserPassword:验证密码 89 * 输出参数:@eResult 1. 成功= 销售@0001 2. 失败 =Null 3.与 @eResult 无关 输出是记录集 90 * 调用例子:declare @eResult varchar(50)exec uChkUserPerm '0755' ,'123456', '销售' 91 * 说 明: 92 * 93 ******************************************************************************************/ 94 CREATE PROCEDURE spoxxx 95 3.3 条件执行语句if…else ,goto,begin…end ,while,case,continue,break 96 条件语句块(statenemt block,以 begin…end为边界)仅在if子句的条件为真时才被执行。为提高代码的可读性,建议嵌套不多于5层。还有,当嵌套层次太多时,应该考虑是否可以使用case语句。 97 3.4 重复执行while和跳转语句goto 98 需要多次执行的语句,可以使用while结构。其中,控制while循环的条件在任何处理开始之前需要先执行一次。循环体中的保留字break无条件的退出while循环,然后继续处理后续语句;保留字continue重新计算while条件,如果条件为真,则从循环开始处重新执行各语句。 99 使用跳转语句goto和标签label也可以方便地实现循环和其他更灵活的操作。SQL SERVER仅具有单通道语法分析器,因此不能解析对尚未创建的对象所做的前向参考。换言之,跳转到某标签的后续语句应该是可执行的(如不存在可能尚未创建的数据对象)。 100 3.5 书写格式 101 数据库服务器端的触发器和存储过程是一类特殊的文本,为方便开发和维护,提高代码的易读性和可维护性。规范建议按照分级缩进格式编写该文本。 102 顺序执行的各命令位于同一级;条件语句块(statenemt block,以 begin…end为边界)位于下一级,类推。 103 SQL语句是该文本的主体。为适应某些比较复杂的用户需求,SQL语句可能比较庞大。为方便阅读和维护,规范建议按照SQL语句中系统保留字的关键程度再划分为三级。具体分级请参照下表。其中,非系统保留字(如字段名、数据表名、标点符号)相对本级保留字再缩进一级。多个连续的非保留字可以分行书写,也可以写在同一行。当WHERE包含的条件子句比较复杂时,应该每行只写一个条件分句,并为重要的条件子句填写单行注释。 104 在保证基本缩进格式的前提下,可以通过对齐某些重要关键字(如条件关键字AND、OR,符号 = 、 <> 等)来进一步提高文本的易读性和可维护性。 105 关于缩进量 106 相邻两级的缩进量为10个空格。这也是ISQL编辑器默认的文本缩进量。另外,在ISQL编辑器中,一个TAB键也相当于10个空格。 107 注:按照功能,四类SQL语句(SELECT、INSERT、UPDATE、DELETE)的关键字可以划分为三类:主关键字、次关键字、一般关键字。如下表所示: 108 主关键字次关键字一般关键字 109 SELECT INSERT (INTO)UPDATE DELETE FROM WHERE VALUES INSERT…SELECT…FROM语句中的SELECT和FROM AND OR BETWEENIN LIKE 110 3.6 字体 111 系统保留字应大写,包括系统公共变量等。其他字符(如用户自定义变量、用户自定义数据对象名)小写。 112 需要特殊强调的部分可以大写。 113 一条完整注释语句的首字符应大写。对某变量、某条件子句的注释可以全部使用小写。 114 通过下一节中生成表r_a的删除触发器的实例可以部分说明对象命名、注释、基本书写格式和字符大小写方面的一些注意事项。 115 116 4 触发器编程规范 117 4.1 范例 118 下面通过一个例子,说明触发器编程中应遵守的规范: 119 /* delete related r_a according to deleted table */ 120 CREATE TRIGGER r_a_d ON r_a 121 FOR DELETE 122 AS 123 IF @@ROWCOUNT = 0 -no rows deleted 124 RETURN 125 /* delete r_b table related to deleted table */ 126 DELETE r_b 127 FROM r_b b, deleted d 128 WHERE b.id=d.id 129 IF @@ERROR != 0 130 BEGIN 131 RAISERROR("Error occurred deleting related records", 16, 1) 132 ROLLBACK TRAN 133 END 134 RETURN 135 5 数据库设计规范 136 A. 表命名规则 137 数据库中不论是表名还是字段名,都一律用英文,不准出现其它语言;且保留原来的字段名,保留它们的规范; 138 139 为了不增加数据库当中的表名的长度,一般不允许出现如Form或者Table的字样,如:记录表:应为Record,而不是RecordTable 140 141 数据库当中的表名的命名,一般不准出现空格,假如有几个单词出现的话,每个单词之间不允许留有空格,用 “_” 隔开如人事信息表:应为Human_Info,而不是Human Info;每个单词的第一个字母必须大写;如果太长,为了不增加编程的难度可采用缩写的方式,每个单词可取三到四个字母表示,也可根据实际情况,实际习惯进行缩写 142 143 B. 列命名规则 144 表中的字段名的命名方式与表名的命名方式一致, 首字母必须大写; 145 C. 数据库对象命名规则 146 命名规则为 :对象类型 + 变量的含义 147 数据库对象命名可归纳如下: 148 对象 前缀 示例 149 表 无 Sales_Reps 150 列 无 AuthorId 151 视 图 [View] vw vwContractAuthors 152 存储过程 无 TerminatedReps_Remove 153 规 则 [Rules] rl rlZipCheck 154 默 认 [Default] df dfStandardQuanity 155 用户自定义数据类型 dt dtAddressLine 156 用户自定义函数 fn fnParser 157 索引(聚集) ic icAuthorFullName 158 索引(非聚集) in inClientStateCity 159 主键(聚集) pc pcCustomerId 160 主键(非聚集) pk pnSstateLookupId 161 外 键 [Foreign Key] fk fkRepCompanyId 162 触发器 [Trigger] tr trStoreDelete 163 游标 [Cursor] cr crTables 164 165 6 特殊规则 166 在字段的类型上面,为了不因为系统的设置而造成编程上面的问题,所以只要是日期类型,一般都用字符型来代替,其长度不应该小于10位,而且存储格式统一,如2002-07-15 。 167 168 为了避免在以后的编程以及字体差异方面带来不利,因此只要是能下拉的字段一般都指定统一的编码,可以取用数字型来代替,但必须注明每个数字代表的意思;如性别字段:可以采用数字代替的方式,1:代表男,0:代表女;而且要在字段后面的备注栏中填写清楚。 169 170 修改记录表 171 修改人员 备注 修改日期 172 张美彬 文档建立 2012-02-07 173 174 175 176 177