66 lines
3.0 KiB
Markdown
66 lines
3.0 KiB
Markdown
---
|
||
title: "PI"
|
||
sidebar_label: "PI"
|
||
---
|
||
|
||
本节讲述如何通过 Explorer 界面创建数据迁移任务, 从 PI 系统迁移数据到当前 TDengine 集群。
|
||
|
||
## 功能概述
|
||
|
||
PI 系统是一套用于数据收集、查找、分析、传递和可视化的软件产品，可以作为管理实时数据和事件的企业级系统的基础架构。
|
||
|
||
taosX 可以通过 PI 连接器插件从 PI 系统中提取实时数据。
|
||
|
||
有两类 PI 任务： 实时同步任务和历史数据迁移任务，在任务下拉列表的名称分别对应 “PI” 和 “PI backfill”。
|
||
|
||
## 创建任务
|
||
|
||
### 1. 新增数据源
|
||
|
||
在数据写入页面中，点击 **+新增数据源** 按钮，进入新增数据源页面。
|
||
|
||
|
||
|
||
### 2. 配置基本信息
|
||
|
||
在 **名称** 中输入任务名称，如：“test”；
|
||
|
||
在 **类型** 下拉列表中选择 **PI** 或 **PI backfill**。
|
||
|
||
如果 taosX 服务运行在 PI 系统所在或可直连的服务器上（依赖 PI AF SDK），**代理** 是不必须的，否则，需要配置 **代理** ：在下拉框中选择指定的代理，也可以先点击右侧的 **+创建新的代理** 按钮创建一个新的代理 ，跟随提示进行代理的配置。即：taosX 或其代理需要部署在可直接连接 PI 系统的主机上。
|
||
|
||
在 **目标数据库** 下拉列表中选择一个目标数据库，也可以先点击右侧的 **+创建数据库** 按钮创建一个新的数据库。
|
||
|
||
|
||
|
||
### 3. 配置连接信息
|
||
|
||
PI 连接器支持两种连接方式：
|
||
|
||
1. **PI Data Archive Only**: 不使用 AF 模式。此模式下直接填写 **PI 服务名**（服务器地址，通常使用主机名）。
|
||
|
||
|
||
2. **PI Data Archive and Asset Framework (AF) Server**: 使用 AF SDK。此模式下除配置服务名外，还需要配置PI 系统(AF Server) 名称 (hostname) 和 AF 数据库名。
|
||
|
||
|
||
|
||
点击 **连通性检查** 按钮，检查数据源是否可用。
|
||
|
||
### 4. 配置数据模型
|
||
|
||
这一部分，我们用一个 csv 文件配置 PI 的数据模型到 TDengine 的数据模型的映射规则。这里所说的映射规则包含 3 方面内容：
|
||
|
||
1. 定义源数据范围，即哪些点或哪些模板需要同步到 TDengine。
|
||
2. 定义过滤规则，即符合什么条件的数据才需要同步到 TDengine。
|
||
3. 定义转换规则，即对原始数据做什么样的变换后再写入 TDengine。
|
||
|
||
如果您不知道具体怎么操作，可以点击“下载默认配置”按钮，下载得到的 csv 文件有详细的使用说明。
|
||
|
||
### 5. 其他配置
|
||
|
||
其余的配置，比较重要的是：
|
||
|
||
1. 对于 PI 任务，配置“重启补偿时间”，如果任务意外中断，重启时配置这个参数非常有用，它会让 taosX 自动 backfill 一段时间的数据。
|
||
2. 对于 PI backfill 任务，需要配置 backfill 的开始和结束时间。
|
||
|
||
高级配置部分可以配置连接器日志的级别、批次大小、和批次延迟。用于 Debug 和 性能优化。 |