跳到主要内容

导入/导出

功能概述

导入导出功能用于在不同环境或系统之间迁移和共享 TDengine IDMP 的数据和依赖的 TDengine TSDB 的数据,确保数据的一致性和完整性。目前的功能是只能全量导入和导出,可选择资源正在开发过程中,会在近期推出。

支持的资源类型

  • 元素 (Elements)
  • 面板 (Panels)
  • 分析(Analyses)
  • 仪表板 (Dashboards)
  • 通知规则 (Notify Rules)
  • 元素模板 (Element Templates)
  • 属性模板 (Attribute Templates)
  • 面板模板 (Panel Templates)
  • 分析模板(Analysis Templates)
  • 仪表板模板 (Dashboard Templates)
  • 通知规则模板 (Notify Rule Templates)
  • 事件模板 (Event Templates)
  • 枚举集 (Enumeration Sets)
  • 分类 (Categories)
  • 计量单位 (UOM)

主页面

在整个页面右上角的头像的弹出菜单中,点击“管理后台”,进入到“管理后台”页面。然后点击“导入/导出”按钮,进入“导入/导出”主页面。

导出功能

点击“导入/导出”主页面的导出图标按钮打开导出页面。

操作步骤

  1. 选择元素:在树形选择器中选择需要导出的元素。支持多选,默认选中第一层所有元素。
  2. 选择其他资源(开发中):可选择元素模板、事件模板、枚举集、分类、计量单位等资源。
  3. 确认导出:点击"确认"按钮后自动下载 ZIP 压缩包。

导出文件结构

导出的 ZIP 文件包含:

export_时间戳.zip
├── metadata.json # 元数据文件,包含所有资源定义
└── taosgen.yaml # TaosGen 配置文件(数据引用配置,可选)

metadata.json示例:

{
"elementTemplates": [...],
"panelTemplateMap": {...},
"dashboardTemplateMap": {...},
"eventTemplates": [...],
"eventTemplateAttrs": {...},
"enums": [...],
"categories": [...],
"uomClass": [...],
"uomMap": {...},
"elements": {...},
"panels": {...},
"dashboards": {...}
}

taosgen.yaml 配置文件:

  • 连接信息:TDengine 数据库连接参数
  • 数据库配置:目标数据库设置
  • 表结构定义:超级表和子表配置
  • 字段映射:列定义和数据类型

查看更多关于 Taosgen 配置

导入功能

访问路径

点击“导入/导出”主页面的导入图标按钮打开导出页面。

操作步骤

1. 上传 JSON 文件(必填)

点击"选择 JSON 文件"按钮,选择导出的 JSON 文件,支持格式:.json

2. 上传 TaosGen 配置(可选)

如需导入数据,需提供 TaosGen 配置文件,支持格式:.yaml, .yml

3. 选择连接(必填)

从下拉列表选择目标 TDengine 连接。

4. 选择联系点(必填)

选择通知联系点以接收分析、告警等任务的通知。

5. 提交导入

点击"确认"。

导入流程与依赖处理

系统按以下顺序自动处理资源依赖关系:

graph TD
A[上传文件] --> B[验证文件格式]
B --> C[解析资源依赖]
C --> D[导入 UOM 单位]
C --> E[导入枚举类型]
C --> F[导入分类]
D --> G[完成所有任务]
E --> G
F --> G
G --> H[导入元素模板]
G --> I[导入事件模板]
H --> J[完成所有任务]
I --> J
J --> K[导入分析模板]
J --> L[导入面板模板]
K --> M[导入仪表板模板]
L --> M
M --> N[导入元素和属性]
N --> P[导入仪表板和面板]
P --> Q[完成]

任务管理

任务列表

任务列表显示所有导入记录。

列名说明
创建时间任务创建的时间戳
状态任务执行状态(执行中、执行成功、执行失败)
名称任务名称(自动生成)
原因失败时的错误原因
操作下载结果文件(对于上传的任务,点击"下载"按钮可下载包含详细结果的 ZIP 文件)

未来规划

  • 支持资源按照选择来导出(元素模板、事件模板、分析模板、面板模板等)。
  • 支持冲突处理策略(覆盖、跳过、重命名)。
  • 支持在导入页面可以选择部分导入。
  • 支持新版本 taosGen,增加数据回放功能。