17第十七章档案数据库与用户数据库管理.doc

第十七章 EpSynall档案数据库与用户数据库管理 本章要点： 介绍EpSynall档案数据库的使用 介绍EpSynall用户数据库与EpSynall系统 的接口 介绍访问用户数据库的后台语言实现 17.1 档案数据库 所谓档案数据库，是EpSynall为用户提供的用户数据库自定义和自管理用户数据库功能。用户可以在开发环境中自行定义管理自己所需数据表的结构，并且用户可以将档案数据库每张表的每个字段与实时数据库中的某个变量点关联，这样有关表的记录操作的输入和输出便可以直接通过对有关变量的引用来完成；实现这个过程，直接调用EpSynall系统提供的函数在运行过程中完成。基本步骤如下： 1、用户需要在开发环境中为需要管理的数据库建立若干张与其字段对应的数据库表，这些表是建在EpSynall历史数据源下属的数据库中。 2、用户需要在‘实时数据库’下的某一管理单元下建立与这些数据表中各字段相对应的变量点。 3、同时，用户还可以为每个数据表关联三个变量： ( 一个为本次数据库操作的状态变量，这是一个“内存整型”变量，取值含义如下： 0—操作失败，原因见“操作错误码”变量 1—操作成功 2—操作进行中 ( 另一个为本次数据库操作操作错误码变量，这是一个“内存消息型”变量，保存本次操作的错误码，就是数据表操作失败的原因。 ( 第三个变量为SQL表达式运算结果变量，这是一个取值为“8字节浮点类型”的遥测量，保存最近一次SQL表达式运算的结果。 4、用户在运行系统中可以进行的操作如下； 创建表 删除表 插入/修改记录； 取得满足条件的记录的字段的值 修改满足条件的记录的字段的值 对表进行SQL表达式运算 查询数据库并将其显示在表格（Grid）控件中 下面将一一介绍这些步骤的具体实现过程。 17.1.1 创建数据表 在EpSynall管理区选择‘档案数据库’，点击右键菜单中的“新建”，弹出‘档案数据库定义’对话框。 表名：输入管理用户数据的数据表名称。 操作状态变量：下拉列表中列出了实时数据库中所有的‘内存整型’变量，从中选择一个关联数据库操作状态的变量（成功、失败或者其他），这个变量用户必须事先在实时数据库下已经建立。 操作错误信息变量：下拉列表中列出了实时数据库中所有的‘内存消息型’变量，从中选择一个关联数据库操作错误原因的变量（解释操作失败原因），这个变量用户必须事先在实时数据库下已经建立。 SQL计算结果变量：下拉列表中列出了实时数据库中所有的‘遥测型’变量，从中选择一个关联SQL语句计算结果的变量，这个变量用户必须事先在实时数据库下已经建立。 当前字段： 字段名：设置在此表中各个字段的名称。 关键字段：选中，表示当前字段为关键字段，关键字段表示在用户进行查询或者其他数据库操作时，此字段专门用作查询条件。 缺省值：设置此字段的缺省默认值。 字段关联变量：下拉列表中列出了实时数据库下所有的5遥变量，在此选出与当前字段相关联的变量名称，这样，用户可以通过变量值的改变来改变数据表中字段的值。 添加：当创建某一字段时，添加按钮变为可用状态，当用户设置好字段后，点击添加按钮，则此字段显示在‘字段列表’中。 修改：在‘字段列表’中选择某一已经建好的字段，修改此字段的某一属性值，此时添加按钮变为‘修改’，点击修改，修改后的字段属性显示在字段列表中。 删除：在‘字段列表’中选择某一已经建好的字段，点击删除，此字段从‘字段列表’中删除。 下面就是一个建好的数据表bbb： 2、创建好数据表后，点击‘确定’，数据表结构创建成功，这样在‘档案数据库’结点下会出现一个以此数据表名称为标识的结点。 3、在档案数据库下创建的数据表，只是确定了其结构，要将数据表真正建立在数据源下，需要调用系统提供的函数，具体使用方法参见下面的说明。 4、在开发环境中设置的各字段缺省值，如果这些字段没有关联变量，那么这缺省值将会在建立数据表时作为一条记录同时插入表中。 函数： （1）BOOL CreateTable(char *szTableName); 功能：在EpSynall历史数据库中创建一张名称为“szTableName”的表，该表的结构在组态系统的“档案数据库”中定义； 参数说明：szTableName 要在历史数据库中的创建的表的名称。 （2）BOOL DeleteTable(char *szTableName); 功能：在EpSynall数据库中删除名称为“szTableName”的表，该表的结构在组态系统的“档案数据库”中定义； 参数说明： szTableName 要删除在历史数据库中的表的名称。 用户可以参照上面的表的结构，在档案数据库下创建一张表bbb，其数据表操作状态关联的3个变量可以创建在‘其他管理单元’下的