homework-jianmu/docs/zh/06-advanced/05-data-in/03-pi.md

66 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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