数据库编码规范.docx
《数据库编码规范.docx》由会员分享,可在线阅读,更多相关《数据库编码规范.docx(15页珍藏版)》请在冰豆网上搜索。
数据库编码规范
数据库编码规范
V1.0
目录
1)目的3
2)范围3
3)术语3
4)设计概要3
5)命名规范(逻辑对象)4
6)数据库对象命名6
7)脚本注释8
8)数据库操作原则9
9)常用字段命名(参考)9
1)目的
为了统一公司软件开发的设计过程中关于数据库设计时的命名规范和具体工作时的编程规范,便于交流和维护,特制定此规范。
2)范围
本规范适用于开发组全体人员,作用于软件项目开发的数据库设计、维护阶段。
3)术语
数据库对象:
在数据库软件开发中,数据库服务器端涉及的对象包括物理结构和逻辑结构的对象。
物理结构对象:
是指设备管理元素,包括数据文件和事务日志文件的名称、大小、目录规划、所在的服务器计算极名称、镜像等,应该有具体的配置规划。
一般对数据库服务器物理设备的管理规程,在整个项目/产品的概要设计阶段予以规划。
逻辑结构对象:
是指数据库对象的管理元素,包括数据库名称、表空间、表、字段/域、视图、索引、触发器、存储过程、函数、数据类型、数据库安全性相关的设计、数据库配置有关的设计以及数据库中其他特性处理相关的设计等。
4)设计概要
⏹设计环境
数据库:
ORACLE9i、MSSQLSERVER2000等
操作系统:
LINUX7.1以上版本,显示图形操作界面;
RedHat9以上版本
WINDOWS2000SERVER以上
⏹设计使用工具
使用PowerDesigner做为数据库的设计工具,要求为主要字段做详尽说明。
对于SQLServer尽量使用企业管理器对数据库进行设计,并且要求对表,字段编写详细的说明(这些将作为扩展属性存入SQLServer中)
通过PowerDesigner定制word格式报表,并导出word文档,作为数据字典保存。
(PowerDesignerv10才具有定制导出word格式报表的功能)。
对于SQLServer一旦在企业管理器进行数据库设计时加入扩展属性,就可以通过编写简单的工具将数据字典导出。
编写数据库建数据库、建数据库对象、初始化数据脚本文件
⏹设计原则
采用多数据文件
禁止使用过大的数据文件,unix系统不大于2GB,window系统不超过500MB
oracle数据库中必须将索引建立在索引表空间里。
基本信息表在建立时就分配足够的存储空间,禁止其自动扩展功能
大文本字列、blob列要独立出一张表,此表只有id和blob(或大文本)列
为每一个数据库创建独立的管理员用户,使用该用户进行设计,尽量不要使用sa或者系统管理员身份进行数据库设计。
⏹设计的更新
在设计阶段,由数据库管理员或指定的项目组其一成员进行维护。
运行阶段,由数据库管理员进行维护。
如对表结构进行修改,应先在数据字典文档进行修改,最后在数据库中进行修改。
如果修改的是数据库字典表,必须由数据库管理员进行。
编写更新的SQL代码,如果使用PowerDesigner,禁止由PowerDesigner直接连数据库进行数据库操作(如果是更改表或者字段的说明性文字可以通过数据库管理器图形界面进行修改)
修改数据库要通过SQL,禁止其它方式对数据进行修改
修改数据库的SQL要添加说明后保存备查
⏹命名总体原则
设定的前缀一律用小写字母
标识名称命名全部小写
整个命名的全长不得超过30个字母
全部使用字母和下划线'_',不能使用中文和其他字符,有特别情况允许使用末尾数字编号。
例如:
t_Finace1,t_Finace2...
命名名称来自于业务,全部采用英文单词
英文单词过长可以采用通用的缩写,尽量表达出业务的含义
如需要两个以上的英文单词做标识名称,单词之间要用下划线'_'连接
名称全是由名词组成的,名词由大范围到小范围排序取名
完成某功能的名称,如函数和过程,以动宾形式取名
5)命名规范(逻辑对象)
a)数据库结构命名
数据库命名
数据库的命名要求使用与数据库意义相关联的英文字母,即<业务系统名称>。
例如:
chinacare数据库的命名为ccnet;
客户资料数据库的命名为Customer_Info。
数据库日志设计命名
数据库日志的的命名以<数据库名>_<日志名>.log格式命名。
其中,<日志名>为有意义的数据库日志名称。
例如:
ccnet_logredo.log
b)数据库配置设计命名
数据库配置设计方案是以文件形式保存的,其内容是关于特定数据库的配置项目的具体值。
数据库配置文件的命名以:
<数据库类型简写〉_<应用系统标志>_cfg.ini格式命名。
其中,数据库类型简写见附件1《数据库类型简写》,cfq表示该文件是数据库配置文件。
例如:
ORA_ccnet_cfg.ini
c)数据库复制与存储设计命名
数据库复制与存储设计方案是以文件形式保存的,其内容是关于特定数据库之间的复制策略的具体细节。
数据库复制与存储设计文件的命名以:
<数据库类型简写>_<应用系统标志>_rep.txt格式命名。
其中,数据库类型简写见附件1《数据库类型简写》,rep表示该文件是数据库复制与存储文件。
d)数据库连接设计命名
数据库连接设计方案是以文件形式保存的,其内容是关于特定分布式数据库之间的连接设计的具体细节。
数据库连接设计文件的命名以:
<数据库类型简写>_<应用系统标志>_dbl.sql格式命名。
其中,数据库类型简写见附件1《数据库类型简写》,dbl表示该文件是数据库连接设计文件。
e)表空间、数据文件命名(主要针对Oracle)
索引表空间:
表空间命名格式:
ts<系统标识>_i
数据库文件命名格式:
ts<系统标识>_i[n].dbf
临时表空间:
表空间命名格式:
ts<系统标识>_t
数据库文件命名格式:
ts<系统标识>_t[n].dbf
回滚表空间:
表空间命名格式:
ts<系统标识>_r
数据库文件命名格式:
ts<系统标识>_r[n].dbf
数据表空间:
表空间命名格式:
ts<系统标识>_d
数据库文件命名格式:
ts<系统标识>_d[n].dbf
注:
表空间名不超过8位,n可取00-99或0-9,根据系统数据量确定。
6)数据库对象命名
a)表
表的命名必须以"t_"(Table缩写)开头,格式为:
t_[系统标识]_<数据表类型标识>_<表标识>。
其中,[]表示可选项,依据实际情况而增加;<表标识>要求与表意义相关联的英文字母,例如:
t_Customers。
数据表大致分为:
业务数据表、基本编码表、辅助编码表、系统信息表、累计数据表、结算数据表、决策数据表;
基本编码表用base标志
累计数据表用count标志
系统信息表用info标志...
例如:
t_trade_base_trade_code,t_trade_info_help...
b)字段/域
根据业务要求进行命名,不需设定固定的前缀。
c)索引
针对数据库表中一个或多个字段建立的索引的命名格式应以"idx_"开头,索引列名间用_隔开,即为idx_ColumnName1_ColumnName2_…
其中,ColumnName1是数据库表中(第一个)索引字段的名称或名称简写;ColumnName2是数据库表中(第二个)索引字段的名称或名称简写;索引名的总长必需符合数据库的规定。
例:
idx_cert_number(表示在字段cert_number上创建索引)
为了避免重名索引出现,可选命名方式为idx_<表名>_<递增号>作为索引的命名,但是要求在数据字典中进行详细说明
d)视图
视图的命名必须以"v_"(View缩写)开头,格式为:
v_<视图类型>_[系统标识]_<视图标识>。
其中,视图类型参见"表的分类说明";[系统标识_]是可选项,依据情况而增加;<视图标识>应与视图意义相关联的英文字母。
例:
v_user_detail_info
e)存储过程
存储过程的命名必须符合sp_[系统标识]_<存储过程标识>格式。
其中,sp表示是存储过程;[系统标识]为可选项,依据情况而增加;<存储过程标识>是与存储过程意义相关联的英文字母,例如:
USP_Query_Write_to_Disk。
例:
sp_check_user_auth(以动宾方式取名)
f)触发器
触发器的的命名必须符合tr_<表名>_格式。
其中,tr表示是触发器;是与触发器意义相关联的英文字母。
例:
tr_user_info_iu(表示对user_info表进行插入、更新的触发器)
g)函数
函数的命名必须符合fn_[系统标识]_<函数标识>格式。
其中,fn表示是函数,[系统标识]为可选项,依情况而定;<函数标识>是与函数意义相关联的英文字母。
例:
fn_create_id(以动宾方式取名)
h)自定义数据类型
自定义数据类型的命名格式为:
ud_<自定义数据类型标识>_<数据类型>
i)Default(缺省)
Default(缺省)的命名格式一般为:
df_;对于非绑定的默认可取系统默认的名字
j)Check、Constraint(约束)
约束的命名格式一般为:
ck_<表名>_;一些约束可直接放在生成表的语句中。
例:
ck_flag参见第8.1点实例,约束字段flag只能取字符'0'到'9':
constraintck_flagCHECK(flagbetween'0'and'9')
k)Rule(规则)
规则的命名格式一般为:
rl_;对于非绑定规则(约束)可取系统默认的名字。
l)主键
主键的命名格式为pk_<表名>_<主键标识>。
例:
pk_user_info_userid(表user_info以字段userid创建主键)
m)外键
外键的命名格式为fk_<表名>_<主表名>_<外键标识>。
可选命名方式为fk_<表名>_<递增号>作为索引的命名,但是要求在数据字典中进行详细说明
例:
fk_user_info_department_deptid(在表user_info的字段department_id上创建外键,参照主表department)
n)同义词(ORACLE)
同义词的命名格式为:
sy_<同义词标识>
例:
sy_user_info(为所有权属于ben的表user_info的公共同义词)
7)脚本注释
7.1存储过程或触发器
a)每一个存储过程或触发器都要在最前面写注释,注释如下
/*
writer:
createdate:
ver:
Depiction:
remark:
*/
另外,过程中声明的重要变量要有注释,例如:
@iActionFlagint=0/*0=>Checkout,1=>GetLatest,2=>UndoCheckOut*/
b)如果只对存储过程或触发器进行部分修改时须添加以下注释:
/*rewriter:
add(rewriter):
date:
<格式:
YYYY-MM-DD>start1:
修改描述:
*/
/*原代码内容*/(修改时)
/*rewriter:
date:
<格式:
YYYY-MM-DD>end1:
*/
/*rewriter:
add(rewriter):
date:
<格式:
YYYY-MM-DD>start2:
*/
新代码内容
/*rewriter:
date:
<格式:
YYYY-MM-DD>end2:
*/
c)如果对存储过程或触发器有较大的修改,可增加修改内容的注释。
/*LogId:
rewriter:
rewritedate:
<格式:
YYYY-MM-DD>
Depiction:
*/
7.2自定义函数
a)每一个自定义函数都要在其前面写注释,注释如下
/*
functionname:
xxxx
Depiction:
<对此函数的描述>
param(a,b)
a功能或描述....
b功能或描述
output:
xx=0表示.....x=1表示......
writer:
createdate:
<创建日期,格式:
YYYY-MM-DD>
ver:
remark:
*/
另外,函数中声明的重要变量要有注释,例如:
@iActionFlagint=0/*0=>Checkout,1=>GetLatest,2=>UndoCheckOut*/
b)如果只对函数进行部分修改时须添加以下注释:
/*rewriter:
add(rewriter):
date:
<格式:
YYYY-MM-DD>start1:
修改描述:
*/
/*原代码内容*/(修改时)
/*rewriter:
date:
<格式:
YYYY-MM-DD>end1:
*/
/*rewriter:
add(rewriter):
date:
<格式:
YYYY-MM-DD>start2:
*/
新代码内容
/*rewriter:
date:
<格式:
YYYY-MM-DD>end2:
*/
c)如果对函数有较大的修改,可增加修改内容的注释。
/*Logid:
rewriter:
rewritedate:
<修改日期,格式:
YYYY-MM-DD>
Depiction:
*/
8)数据库操作原则
8.1建立、删除、修改库表操作
在开发环境中,对于自己的库表可任意进行修改、删除操作;但需保留相应的建表语句和说明,与建表人建表时间。
8.2添加、删除、修改表数据
在开发环境中,开发人员所开发模块独自使用的库表,可自由操作表中数据;
对其他模块关联的库表,应取得其他模块的开发人员同意后再执行操作;
系统的信息表、字典表的修改应向数据库的管理员提出操作需求,由数据库的管理员执行操作。
9)常用字段命名(参考)
9.1系统信息常用字段
字段名称
字段代码
ORACLE
SQLSERVER
值
说明
用户标识
user_id
char(8)
char(8)
用于登录应用系统的标识,填写数字
一般做主键,要填满长度
用户名称
user_name
varchar2(20)
varchar(20)
用户标识对应的名称
组标识
grp_id
char(4)
char(4)
用户所属的组标识,填写数字
一般做主键,要填满长度
组名称
grp_name
varchar2(50)
varchar(50)
组标识对应名称
组权限标识
grp_auth_id
char
(2)
char
(2)
由低到高,从00到99
要填满长度
组权限名称
grp_auth_name
varchar2(50)
varchar(50)
组权限标识对应名称
密码
password
varchar2(30)
varchar(30)
9.2客户个人信息常用字段
字段名称
字段代码
ORACLE
SQLSERVER
值
说明
客户标识
customer_id
char(?
)
char(?
)
业务系统使用的客户标识,一般做主键,不用可变长类型
要填满长度
客户姓名
customer_name
varchar2(50)
varchar(50)
部门标识
dept_id
char(?
)
char(?
)
一般做主键,不用可变长类型
要填满长度
部门名称
dept_name
varchar2(50)
varchar(50)
性别
sex
char
(1)
char
(1)
F/M
婚姻状况
marriagestatus
varchar2(50)
varchar(50)
没有标识的,直接在字段中填写具体值
出生日期
birthday
date
smalldatetime
身高
hight
number(5,2)
dec(5,2)
单位为厘米
体重
weight
number(5,2)
dec(5,2)
单位为公斤
民族
nationality
varchar2(20)
varchar(20)
联系电话
phone
varchar2(50)
varchar(50)
家庭电话
home_phone
varchar2(50)
varchar(50)
办公电话1
office_phone1
varchar2(50)
varchar(50)
办公电话2
office_phone2
varchar2(50)
varchar(50)
区号
zone
varchar2(20)
varchar(20)
传真号码
office_fax
varchar2(50)
varchar(50)
移动电话
mobil_phone
varchar2(50)
varchar(50)
电子信箱
email
varchar2(50)
varchar(50)
邮政编码
post_code
varchar2(20)
varchar(20)
国籍
country
varchar2(50)
varchar(50)
居住省
province
varchar2(20)
varchar(20)
居住市
city
varchar2(20)
varchar(20)
家庭住址
home_addr
varchar2(80)
varchar(80)
办公地点
office_addr
varchar2(80)
varchar(80)
证件号码
cert_number
varchar2(50)
varchar(50)
证件名称
cert_name
varchar2(20)
varchar(20)
职业标识
occupation_id
char(4)
char(4)
要填满长度
职业名称
occupation
varchar2(50)
varchar(50)
教育程度
education
varchar2(20)
varchar(20)
9.3铺助信息常用字段
字段名称
字段代码
ORACLE
SQLSERVER
值
说明
记录状态标识
flag
char
(1)
char
(1)
A/D…
A:
有效;D:
删除;S:
暂停…
记录序号
id
number
int
9.4业务信息常用字段
字段名称
字段代码
ORACLE
SQLSERVER
值
说明
业务发生日期
oper_date
date
smalldate
开始日期
begin_date
date
smalldate
结束日期
end_date
date
smalldate
操作日期
curr_date
date
smalldate
操作员编号
user_id
char(4)
char(4)
即为系统信息中的用户标识
发生额
money
number(7,2)
dec(7,2)
余额
balance
number(10,2)
dec(10,2)
描述
description
varchar2(50)
varchar(50)
附件1:
数据库类型简写
编号
数据库
类型简写
1
SYBASE
SYB
2
ORACLE
ORA
3
DB2
DB2
4
SQLSERVER
SQL