使用 OSIPI

OSIPI 传输可用于向 OSIPI Data Archive 产品发送标签数据（点数据）。此数据可从本地节点中的设备驱动程序获取，也可通过 TR50 从远程节点发送出去。此功能可通过 OSIPI 分析工具，为设备制造商和最终用户收集用于分析的操作数据。 

先决条件

以下是前提条件

  • 已安装并配置 OSIPI Data Archive 产品 
  • 熟悉以下 OSIPI 工具：
    • PI 系统管理工具
    • PI SQL Commander 
  • 已将 OSIPI JDBC 驱动程序产品与 Windows 企业网关产品安装在同一节点上。
  • 已为 OSIPI 传输安装了有效许可证。

支持的配置

OSIPI JDBC 驱动程序产品可与 OSIPI Data Archive 安装在同一节点上，也可安装在通过 OSIPI 数据存取服务器 (DAS) 组件对 OSIPI Data Archive 进行网络访问的远程节点上。只有采用了将 OSIPI JDBC 驱动程序与 OSIPI Data Archive 安装在同一节点上的配置后，才会对 OSIPI 传输进行验证。 

启用 OSIPI 传输类型

启用 OSIPI 传输支持的步骤如下：

  1. 找到位于 OSIPI JDBC 驱动程序安装文件夹的 OSIPI JDBC 驱动程序。驱动程序的名称为 PIJDBCDriver.jar。
  2. 将此文件复制到企业网关节点的 staging/systems/jar 文件夹。
  3. 启用 OSIPI 传输功能，此时需要适用于目标节点且有效的企业专业版或企业高级版许可证。有关更多信息，请参见许可证。
  4. 重启企业网关。
    MySQL 传输支持中，启用 MySQL 支持的步骤与此类似。请参阅该页面，获取有关启用 JDBC 驱动程序的分步说明。完成上述步骤后，可以在 DB Type（数据库类型）下拉列表中看到 OSIPI 传输。

定义 OSIPI 传输 

创建数据库传输时，您需要输入或选择的 OSIPI 特定参数如下所示：

序号 参数 定义
1 DB Name（数据库名称） OSIPI Data Archive 服务器的主机名。
2 DB Type（数据库类型） 选择 OSIPI。
3 Host（主机） OSIPI Data Archive 服务器的 IP 地址或主机名。
4 Port（端口） 输入 JDBC 驱动程序在访问 OSIPI DAS 时使用的端口号。
5 User（用户） 数据库用户的用户 ID。
6 Password（密码） 与此帐号相关联的密码。
7 Extended Attributes（扩展静态属性） 如果在连接 OSIPI 数据库时发生问题，则需要定义 Extended Attributes（扩展静态属性）。定义 Extended Attributes（扩展静态属性）：
  1. 单击 Extended Attributes（扩展静态属性）
  2. 单击 Add（添加）
  3. 添加 Property（属性）：ProtocolOrder
  4. 输入 Value（值）：NetTcp:<port_number>, Https/Soap:<port_number>
  5. 在 Type（类型）下拉列表中选择 string（字符串）
  6. 单击 Add（添加）
  7. 单击 OK（确定）

有关创建数据库传输的更多信息，请参见创建数据库传输。

定义 OSI 传输映射 

对 OSIPI Data Archive 的 piarchive 架构中的 picomp 或 picomp2 界面表执行 SQL 插入后，标签数据将被插入 OSIPI Data Archive。表的选择取决于在 OSIPI Data Archive Points 数据库中配置的标签数据类型。 

支持的 SQL 操作、数据类型和功能

OSIPI 传输使用 JDBC 驱动程序与 OSIPI Data Archive 进行交互。以下可从 Action（动作）选择列表中选择的 SQL 操作或不被 OSIPI Data Archive 支持，或会在执行时导致错误。 

  • Batch Insert（批量插入）
  • Select with Delete（选择并删除）
  • Select with Update（选择并更新）
  • Stored Procedure（存储过程）

主要用例是向 picomp 或 picomp2 表插入数据。可使用上面未列出的其他 SQL 操作与 OSIPI Data Archive 进行交互，但是在使用这些操作时产品支持将受到限制。 

不支持以下 OSIPI Data Archive 数据类型

  • Blob
  • Timestamp（时间戳）

不支持 DB 传输的逻辑工作单元功能和相应的 OSIPI 传输的逻辑工作单元触发器动作。

需要为将要使用的每个标签数据类型创建传输映射。有关定义传输映射的详细步骤，请参见数据库传输映射。

整数数据传输映射

本节将介绍需要为 Int16 和 Int32 PI 整数数据类型映射的界面表和传输映射字段。  定义传输映射时，需要选择 piarchive 架构和 picomp2 表。 

需要映射的字段如下所述：

列 描述
tag OSIPI Data Archive Points 数据库中定义的标签名称。
time 与此标签数据相关联的时间戳。
value 数据的整数值。

浮点型数据传输映射

本节将介绍需要为 Float16、Float32、Float64 OSIPI 浮点型数据类型映射的界面表和传输映射字段。定义传输映射时，需要选择 piarchive 架构和 picomp 表。

需要映射的字段如下所述：

列 描述
tag OSIPI Data Archive Points 数据库中定义的标签名称。
time 与此标签数据相关联的时间戳。
value 数据的浮点值。
如果使用 Float32 标签，请确保将输入变量数据类型设置为 Float8。

布尔型数据传输映射

本节将介绍需要为数字 OSIPI 数据类型映射的界面表和传输映射字段，其将转换为布尔型数据类型。定义传输映射时，需要选择 piarchive 架构和 picomp 表。 

需要映射的字段如下所述： 

列 描述
tag OSIPI Data Archive Points 数据库中定义的标签名称
time 与此标签数据相关联的时间戳
status 这是一个负整数值，表示布尔型状态的编码值。您需要与 OSIPI Data Archive 管理员一起确定需要为布尔值 True 或 False 提供的负值。

字符串数据传输映射

本节将介绍需要为 OSIPI 字符串数据类型映射的界面表和传输映射字段，其将转换为布尔型数据类型。定义传输映射时，需要选择 piarchive 架构和 picomp 表。 

需要映射的字段如下所述：

列 描述
tag OSIPI Data Archive Points 数据库中定义的标签名称。
time 与此标签数据相关联的时间戳。
svalue 数据的字符串值。

定义引用传输映射的触发器

下图示例中的触发器引用了为 OSIPI 传输定义的传输映射。