DataLogger是易于配置的应用程序,可将数据从OPC服务器记录到许多ODBC兼容的数据库中。DataLogger与KEPServerEX的无缝集成提供了许多实质性的独特优势,例如安装简单,高效性能以及在OPC浏览空间中轻松浏览标签。
===== 欢迎加入KEPServerEX QQ讨论群:90548143 ======
初始设置注意事项
在创建第一个DataLogger配置之前,应检查以下主题。
外部依赖/ External Dependencies
此应用程序具有外部依赖性。它要求正在使用的数据库管理系统的ODBC驱动程序安装在运行OPC服务器的PC上。 DataLogger支持以下ODBC驱动程序的ALL DB :
注意: 虽然DataLogger提供的分辨率为千分之一秒的TimeStamp值,但某些数据库无法以低于一秒的分辨率显示日期格式,某些数据库不支持毫秒级显示
支持的数据类型/ Supported Data Types
Data Type |
Description |
Boolean(布尔) |
Single bit(单位) |
Byte(字节) |
(无符号)Unsigned 8-bit value |
Char(字符型) |
(有符号)Signed 8-bit value |
Word(字) |
(无符号)Unsigned 16-bit integer |
Short(短整型) |
(有符号)Signed 16-bit integer |
BCD |
(双字节打包二进制编码的十进制)Two-byte packed binary coded decimal |
LBCD |
(四字节打包二进制编码的十进制)Four-byte packed binary coded decimal |
DWord(双字) |
(无符号32位整数)Unsigned 32-bit integer |
Long(长整型) |
(有符号的32位整数)Signed 32-bit integer |
Float(浮点型)(单精度) |
(32位浮点值)32-bit floating point value |
Double(双精度) |
(64位浮点值)64-bit floating point value |
String(字符串) |
ASCII文本字符串 |
Date(日期) |
(浮点OLE自动化日期)Floating-point OLE automation date |
注意:不支持64位整数类型,LLong和QWord。
CSV导入/导出/ CSV Import/Export 步骤描述
Data Logger插件支持在逗号分隔变量(CSV)文件中导入和导出服务器项。 未在CSV文件中定义的参数将分配适当的默认值。 要跳转到特定部分:
注意:有关指定要用作变量(逗号或分号)的字符的信息。
创建模板
创建导入CSV文件的最简单方法是创建模板。
导出数据记录器服务器项目列表
导出服务器项列表会生成一个.CSV文本文件,其中包含服务器项及其相关参数的列表。列名必须与列出的列完全相同;但是,列可以按任何顺序排列。所需列以粗体显示。
列名称 |
值 |
Item ID(物品ID) |
服务器项的完全限定名称。 字段的最大长度为256个字符。 |
Numeric ID(数字ID) |
服务器项的数字别名或标识符。 有效范围为0到2147483647.默认设置为0 |
Data Type(数据类型) |
服务器项的数据类型。 本专栏的内容仅供参考; 导入项目列表时不考虑它。 |
Deadband Type(死区类型) |
用于过滤服务器项更新的死区类型。 选项包括None,Absolute和Percent。 |
Deadband(死区) |
死区值。 该值必须是正数,实数。 |
Range Low(范围低) |
死区百分比的较低范围。 该值可以是任何实数,但必须小于高范围值。 |
Range High(范围高) |
死区百分比范围更高。 该值可以是任何实数,但必须大于低范围值。 |
DataLogger配置定义如何从OPC服务器项目中提取数据并将其记录到数据库中。 每个OPC服务器项目都有一个DataLogger配置。 在DataLogger配置中,有一个或多个日志组。 日志组是OPC服务器项目和数据库表之间的“数据管道”。 日志组定义以下内容:
一般属性(General Properties)
数据源属性(Data Source Properties)
此部分用于配置与数据库的DSN连接。
存储和转发(Store and Forward)
(Enabled)启用:此选项启用存储和转发功能。在运行时使用路径“
注意(Note):启用存储转发功能时,日志组名称只能包含有效字符。
批次标识符(Batch Identifier)
批次ID项(Batch ID Item):此可选参数指定要用作批次标识符的服务器项的ID。
注意(Note):如果输入了批次ID项,则默认情况下该项将映射到数据库列。 触发数据库事务时,项目的当前值将应用于与事务关联的所有行的列。
数据类型(Data Type):标识将由服务器生成的值的数据类型。
更新速率(Update Rate):此参数指定“批次ID项”字段中定义的服务器项的更新速率。 默认设置为1000毫秒。
内存属性(Memory Properties)
注意(Note):应将此值设置为等于或大于日志组中的日志项数,否则可能无法正确记录某些记录。
映射数字ID (Map Numeric ID)
(Map Numeric ID to VARCHAR by default)默认情况下(将数字ID映射到VARCHAR)启用后,日志组中的每个项默认将数字ID列映射到VARCHAR(64)数据类型,而不是INTEGER数据类型。
注意(Note):禁用将清除与日志组项关联的所有数字ID。
时间戳属性(Timestamp Properties)
注意(Note):DataLogger在记录中写入的时间戳表示最近的数据更改事件。
设置DSN/ Setting Up a DSN
在可以使用任何DSN与数据库的连接之前,必须对其进行配置。 配置完成后,DSN将显示在DSN字段的下拉列表中。
在“常规(General Tab)”选项卡上,单击“配置DSN(Configure DSN)”
注意(Note):正在使用的数据库管理系统的ODBC驱动程序必须安装在运行OPC服务器的PC上。
注意(Note):Win 配置 【Microsoft®ODBC数据源管理器】请网络上搜一下配置方法,这里不细聊;
===== 欢迎加入KEPServerEX QQ讨论群:90548143 ======
“数据映射”选项卡用于指定“服务器列表项”以及如何将数据记录到表中.
服务器项目列表(Server Item List)
参数说明如下:
表格选择(Table Selection)
参数说明如下:
选项说明如下:
(Note)注意:要自定义服务器项到数据库列的映射,请单击“映射字段(Map Fields)”。有关更多信息,请参阅映射项字段。
(Note)注意:使用DataLogger创建表时,表名的最大长度为256个字符。但实际上,最大值取决于所使用的数据库和ODBC驱动程序的限制。通常,最大值为64或128个字符。表名应仅包含字母和数字,因为非字母数字字符可能会导致错误。如果必须在表名中使用非字母数字字符,请参阅数据库和ODBC驱动程序规范以获取表命名限制。
表格格式(Table Format)
参数说明如下:
选项说明如下:
(Note)注意:有关窄格式和宽格式的更详细说明,请参阅窄格式与宽格式格式。
通过浏览添加服务器项(Adding a Server Item Through Browse)
Map项目字段/ Map Item Fields
“映射项字段”对话框用于将服务器项映射到数据库表中的列。它显示屏幕上半部分的服务器项目和下半部分的数据库表格列。它的工作原理取决于DataLogger是在数据库中创建新表还是表已经存在.
映射服务器项(Mapping a Server Item)
更改映射(Changing the Mapping)
修改数据库列(Modifying a Database Column)
将服务器项映射到新表时,单击“修改(Modify)”以更改列参数。 例如,要将列的默认名称从“_NAME”更改为“_Line4v88”,用户将选择该项目,然后单击“修改(Modify)”。 “修改列定义(Modify Column Definition)”对话框用于更改列名,SQL数据类型和SQL长度的自动分配的默认值。
DataLogger可以以窄格式或宽格式(Narrow Format or Wide Format)映射字段。 用户必须指定要用于登录的每个数据库表的格式。 通过“数据映射”选项卡访问该设置。
窄格式示例 ---- (Narrow Format Examples)
下面的两个表显示了使用窄格式记录的三个服务器项。 所有三个服务器项都已登录到五列。
下表显示了具有静态时间间隔(表示每x秒或分钟)的窄格式。*
静态区间数据记录的窄格式:
Name(名称) |
Numeric ID(数字ID) |
Value(值) |
Quality(质量) |
Time(时间) |
Ch_1.Dev_1.Temp |
1000000 |
38 |
192 |
2007 02 16 13:44:26.832 |
Ch_1.Dev_1.Pos |
1000001 |
22 |
192 |
2007 02 16 13:44:26.832 |
Ch_1.Dev_1.Speed |
1000002 |
103 |
192 |
2007 02 16 13:44:26.832 |
宽格式示例 --- (Wide Format Example)
下一个示例演示了宽格式。 选择宽格式时,将为每个服务器项记录四列。
这四列是:_VALUE,_NUMERICID,_TIMESTAMP和_QUALITY。
在此示例中,有三个服务器项:Ch_1.Dev_1.Temp,Ch_1.Dev_1.Pos和Ch_1.Dev_1.Speed。 在宽格式中,这将导致最多十二列。 可以在“映射项字段”对话框中取消映射列,以便仅记录必要的列。 在下面的示例中,已为每个服务器项取消映射_NUMERICID列。
Ch_1.Dev_1.Temp_VALUE |
Ch_1.Dev_1.Temp_TIMESTAMP |
Ch.1.Dev_1.Temp_QUALITY |
Ch_1.Dev_1.Pos |
38 |
2007 02 16 13:44:26.832 |
192 |
22 |
===== 欢迎加入KEPServerEX QQ讨论群:90548143 ======
“触发器”选项卡用于为日志组定义一个或多个触发器。 首次显示时,“记录触发器”列表会显示一个默认触发器。 每个触发器由两个主要参数定义:何时和 如何 (when and how)
添加/修改触发器:常规/ Add/Modify Trigger: General
参数说明如下:
选项说明如下:
修改常规属性
要调用“修改触发器 - 常规(Modify Trigger - General)”对话框,请选择一个触发器,然后单击“修改 (Modify)”。 对话框中的字段与添加新触发器时显示的字段相同,只是字段值反映现有的触发器信息。
添加触发:基于时间(绝对)/ Add Trigger: Based on Time (Absolute)
添加触发器:基于条件(表达式)/ Add Trigger: Based on Condition (Expression)
启动和停止条件概述
“事件表达式”对话框用于定义表达式触发器的启动和停止条件。
请注意以下事项:
开始条件 (Start Condition)
参数说明如下:
(Note)注意:此字段中的值可能与“停止条件”(Stop Condition)选项卡上的“更新速率”中的值不同。
例如:如果条件是“项目数据设置为质量差”,则当项目质量变差时,日志组中的所有条目都会记录一次。未选中默认设置。
停止条件 (Stop Condition)
参数说明如下:
(Note)注意:此字段中的值可能与“停止条件”(Stop Condition)选项卡上的“更新速率”中的值不同。
添加触发器:记录条件/ Add Trigger: Logging Conditions
每个单元的范围如下:
(Milliseconds)毫秒:10到4294967295。
(Seconds)秒: 1到4294967。
(Minutes)分钟: 1至71582。
(Hours)小时: 1至1193。
(Days)天数: 1到49。
选项说明如下:
(Update Rate)更新率
更新速率以两种方式影响静态间隔,数据更改和触发器开始停止选择:
(Timestamp Values)时间戳值
DataLogger为日志组中的每个OPC服务器项维护两个时间戳值:
(Tip)提示:如果需要驱动程序或客户端驱动程序提供的时间戳,请使用日志组选项中任何值的“登录数据更改”。
添加触发器:摘要/ Add Trigger: Summary
查看详细信息并单击“完成 Finish”。 或者,单击“上一步 Back ”返回上一个对话框并进行更改。
_DataLogger(Root)
Tag(标签) |
Access(访问) |
Description(描述) |
_TriggeredGroupCount |
Read Only(只读) |
当前触发的日志组数。 当至少一个触发器为真时触发日志组。 |
_NonTriggeredGroupCount |
Read Only(只读) |
当前未触发的日志组数。 |
_EnabledGroupCount |
Read Only(只读) |
当前启用的日志组数,无论它们是在运行时启用还是通过_Enabled系统标记启用。 |
_DisabledGroupCount |
Read Only(只读) |
当前未启用的日志组数 |
_DataLogger.<log group name>
Tag(标签) |
Access(访问) |
Description(描述) |
_Buffering |
Read Only(只读) |
设置为True时,日志组的存储文件当前包含数据。* |
_Description |
Read Only(只读) |
配置日志组的描述。 |
_Enabled |
Read / Write(读/写) |
日志组正在评估服务器项和处理触发器。启用日志组时,可能会触发也可能不会触发 |
_Error |
Read Only(只读) |
日志组处于错误状态(例如,如果它无法连接到数据库) |
_LogDataBit |
Read / Write(读/写) |
设置为True时,将记录所有服务器项。 _LogDataBit标记自动重置为False |
_NoError |
Read Only(只读) |
日志组未处于错误状态 |
_SessionInsertionCountHi |
Read Only(只读) |
插入计数的高32位。插入次数是自上次启用日志组以来的数据插入次数 |
_SessionInsertionCountLo |
Read Only(只读) |
插入计数的低32位 |
_TimeToOpenRecordsetMS |
Read Only(只读) |
最初以毫秒为单位打开与数据库的连接所花费的时间 |
_Triggered |
Read Only(只读) |
触发日志组,即至少有一个日志组的触发器为真。触发日志组时,真实的触发器在静态间隔,数据更改和/或从开始条件转换到停止条件时插入数据,这由添加触发器中的日志记录设置确定:记录条件,添加触发器:基于条件(表达式)或添加触发:基于时间(绝对) |
*如果数据库断开连接且日志组当前直接记录到存储文件,则此标记可能为True。如果数据库最近已重新连接且日志组仍在将其内容转发到数据库的过程中,它也可能为True。
====================================================
详细说明文档请关注CSDN 【雲飛兄】 下载: https://download.csdn.net/download/qq_35616330/11957021
====================================================
欢迎加入KEPServerEX QQ讨论群:90548143