44
1. 引言
引言是对这份数据库设计说明书的概览,是为了帮助阅读者了解这份文档是如何编写的,并且应该如何阅读、理解和解释这份文档。
1.1 编写目的
说明这份数据库设计说明书是为哪份软件产品编写的,开发这个软件产品意义、作用以及最终要达到的意图。通过这份数据库设计说明书详尽准确地描述了该软件产品的数据库结构。如果这份数据库设计说明书只与整个系统的某一部分有关系,那么只定义数据库设计说明书中说明的那个部分或子系统。
1.2 项目来源
具体说明本软件开发项目的全部风险承担者,以及各自在本阶段所需要承担的主要风险,首要风险承担者包括:
● 任务提出者; ● 软件开发者; ● 产品使用者。
1.3 文档约定
描述编写文档时所采用的各种排版约定。排版约定应该包括: ● 命名方法; ● 提示方式; ● 通配符号: ● 等等。
1.4 预期读者和阅读建议
列举本数据库设计说明书所针对的各种不同的预期读者,例如,可能包括: ● 开发人员; ● 项目经理; ● 测试人员; ● 文档编写人员。 并且描述了文档中,其余部分的内容及其组织结构,并且针对每一类读者提出最适合的文档阅读建议。
1.5 参考资料
列举编写需求规格说明书时所用到的参考文献及资料,可能包括;
45
● 本项目的合同书;
● 上级机关有关本项目的批文; ● 本项目已经批准的计划任务书; ● 用户界面风格指导;
● 开发本项目时所要用到的标准; ● 系统规格需求说明; ● 使用实例文档;
● 属于本项目的其它已发表文件;
● 本数据库设计说明书中所引用的文件、资料; ● 相关软件产品数据库设计说明书; ● 等等。
为了方便读者查阅,所有参考资料应该按一定顺序排列。如果可能,每份资料都应该给出:
● 标题名称;
● 作者或者合同签约者; ● 文件编号或者版本号; ● 发表日期或者签约日期; ● 出版单位或者资料来源。
2. 数据库命名规则
完整并且清楚的说明本数据库的命名规则,在《南京市交通局信息化数据库建设规范》中已经给出了一个完整的数据库命名规则,开发者应遵守执行,如果本数据库的命名规则与该规范不完全一致,应作出解释。
3. 数据库设计说明
3.1 数据库逻辑设计
数据库设计人员根据《软件需求分析报告》,创建与数据库相关的实体关系图(E-R图)。如采用面对对象的分析和设计方法,则此处的实体相当于类。
在此处,应给出逻辑设计的完整的E-R图。
3.2 数据库物理设计
在此处应给出完整的数据库物理结构E-R图。开发者应根据逻辑设计的结果,进行数据库的物理设计,并对表结构进行规范化处理(第一范式,第二范式,第三范式)。
46
3.3 数据库分布
数据库分布采用一张表格进行描述,其格式如下:
数据库 数据库 管理系统 编号 名称 其中:
● 数据库编号
给出本系统中指定数据库的顺序编号。
若本系统中只有一个数据库,则本项内容不需要描述,本表内容也只有一行。 说明: 在一个系统中可能安装若干个相同的或者不同的数据库管理系统, 一个数据库管理系统也可能安装一个或者多个数据库。 ● 数据库管理系统名称
给出本系统中指定数据库管理系统的商品名称。
若本系统中只有一种数据库管理系统,则本项内容不需要描述。 ● 数据库管理系统版本号
给出本系统中指定数据库管理系统的版本号。
若本系统中只有一个版本的数据库管理系统,则本项内容不需要描述。 ● 数据库英文名称
给出本数据库的英文名称,该名称是在应用软件中实际使用的名称,必须符合《南京市交通局信息化数据库建设规范》中相关命名规范。 ● 数据库中文名称
给出本数据库的中文名称,该名称是本数据库英文名称的说明。 ● 数据库安装物理位置
给出本数据库安装的实际位置,必须描述清楚该位置是在那个物理设备的哪一 个逻辑存储设备上,以及存储文件的名称。
数据库 管理系统 版本号 数据库 英文名称 数据库 中文名称 数据库 安装 物理位置 3.4 基表设计
每个基表采用一张表格进行描述,其格式如下: 数据库编号: 基表编号: 基表英文名称: 基表中文名称: 字段编号 说明: 其中 ● 数据库编号
含义同上。 ● 基表编号
47
英文字段名 中文字段名 字段类型 备注
给出本基表的顺序编号。 ● 基表英文名称
给出本基表的英文名称,该名称是在应用软件中实际使用的名称,必须符合命 名规范。 ● 基表中文名称
给出本基表的中文名称,该名称是本基表英文名称的说明。 ● 字段编号
该基表中,各个字段的顺序编号。 ● 英文字段名
该基表中,各个字段的英文名称,该名称必须符合《南京市交通局信息化数据库建设规范》中相关命名规范。 ● 中文字段名
该基表中,各个字段的中文名称,该名称是英文字段名的说明。 ● 字段类型
该基表中,各个字段的类型;如果需要,在说明类型时,还需要说明字段长度。 ● 备注
该基表中,各个字段有关的限制性说明,需要描述的内容可能包括: ? 值域; ? 缺省值; ? 空字段限制;
? 显示格式与小数位数; ? 有效性规则与约束; ? 标题; ? 等等 ● 说明
说明一些有关本表的、必须描述清楚的问题,需要描述的内容可能包括: ? 主关键字;
? 索引、排序方式和类型; ? 触发器; ? 数据复制; ? 等等
3.5 视图设计
每个视图采用一张表格进行描述,其格式如下: 数据库编号: 视图编号: 视图英文名称: 视图中文名称: 相关基表和视图: 字段编号 英文字段名 中文字段名 字段类型 字段源 备注 48