帮助中心Appearance
数据镜像
适用版本：DASS5（当前版本）
前提：已登录 DASSConsole；已知目标实时库的 IP 与端口，且网络可达
【说明】：提供两个麦杰实时库之间的测点同步服务。通过配置镜像，可以把数据库 A 中指定的库 / 节点 / 测点同步到数据库 B，同步内容包括静态点表信息和动态实时值。典型场景：把 DASS 内置边缘实时库的数据同步到中心数据库。
【入口】：数据上传 → 数据镜像
页面工具栏提供 6 个按钮：
| 按钮 | 作用 |
|---|---|
| 新建镜像 | 新建一个镜像配置 |
| 导入镜像 | 从文件导入镜像配置 |
| 刷新 | 重新拉取当前镜像配置 |
| 数据预览 | 预览将要生成的镜像文件内容，用于校验配置是否正确 |
| 帮助 | 弹出说明：计算点数据来源、同步依据的区别 |
| 应用 | 按当前配置生成镜像文件并重启 openPlant，使配置生效 |
【注意】镜像配置修改后必须点【应用】才生效。真机提示原文是「镜像配置发生修改，请点击应用生效(建议镜像配置全部配置完成后点击)」——建议全部配置完成后再点一次，不要边改边点，因为每次应用都会重启 openPlant。
镜像卡片显示：镜像名称、目的IP、目的端口、同步依据、连接状态，以及【编辑】【删除】按钮。
下方节点列表的表头为：源节点（PN）、目的节点（TN）、计算点来源（XF）、操作。
功能概述
数据镜像提供两个麦杰实时库之间的测点同步服务：把数据库 A 中指定的库 / 节点 / 测点同步到数据库 B，同步内容包括静态点表信息与动态实时值。
典型拓扑：把 DASS 内置边缘实时库的数据同步到中心数据库，让中心侧拥有与现场一致的测点表与实时值。
核心价值：不必在上层重复建点，按需把部分节点/测点镜像过去即可完成数据汇聚。
使用场景
- 边缘 → 中心的数据汇聚（最常见的用法）；
- 只把部分节点/测点同步到上级库（不是整库搬）；
- 跨库冗余：关键数据在第二处实时库留一份。
前置条件
- 已登录；已知目标实时库的 IP 与端口，且网络可达；
- 源库与目标库均为麦杰实时库（镜像只在这两者之间工作）；
- 授权余量充足（目标库能容纳镜像过去的测点）；
- 镜像名称满足约束：长度 1～60，仅数字 / 字母 / 下划线（V3.5.4 起）；
- 已明确镜像规则（隔离器、过滤字段）。
新建镜像
【操作】：
步骤1. 点击【新建镜像】。
步骤2. 在【新增镜像】窗口中填写镜像信息。
| 配置项 | 说明 | 示例 |
|---|---|---|
| 镜像名称 | 自定义镜像名称 | user |
| 目的IP | 目标实时库的 IP | 127.0.0.1 |
| 目的端口 | 目标实时库的端口 | 8200 |
| 同步依据 | 见下表 | 点名同步 |
| 网络隔离器状态 | 目标库前面的网络隔离设备状态；无隔离设备时选【无网络隔离器】 | 无网络隔离器 |
| 过滤字段 | 勾选不参与同步的字段（别名、描述、量纲、量程上下限、死区、比例系数、报警类等共 21 项） | — |
同步依据的两种取值：
| 取值 | 含义 |
|---|---|
| 点名同步 | 若目标端无该 PN 的测点，则创建新测点（ID 自动分配）；若目标端已存在该 PN，则将该点覆盖 |
| ID 同步 | 在目标库下创建与源端同 ID、同点名的测点；若目标端已存在该 ID，则将该点覆盖 |
步骤3. 建议先点击【测试实时库连接】确认网络与端口可达：
- 成功 → 提示「测试连接成功」；
- 失败 → 提示「连接测试失败，请检查网络及接口返回信息」。
确认信息无误后点击【确定】。
【注意】【测试实时库连接】只是连通性检查，不是提交前的强制步骤——不点它也能直接【确定】。但填错 IP / 端口要等同步失败才发现，所以建议先测一次。
步骤4. 返回页面即可看到新建的镜像，连接状态显示【已连接】。可对其进行编辑或删除。
镜像应用
【说明】：每次编辑配置后，都需点击【应用】生成镜像文件并重启 openPlant。
【操作】：
步骤1. 点击【应用】按钮，确认弹框提示「此操作会重启数据库，是否确认」后，点击【确定】。
步骤2. 点击【数据预览】检查镜像文件是否正确：
- 预览信息与镜像配置相同 → 应用成功；
- 预览内缺少相应信息 → 应用失败，此时再次点击【应用】并检查预览。
若始终无法应用成功，请联系工程师。
编辑镜像
【说明】：编辑镜像配置。
【操作】：
步骤1. 点击【编辑】按钮，进入编辑镜像页面（独立页面，非弹窗）。
步骤2. 修改需要调整的内容（例如镜像名称），修改后先点击【测试实时库连接】，确认连通后点击【确定】。
返回页面可看到信息已更新，且连接状态显示【已连接】。
删除镜像
【说明】：根据个人需求删除镜像。
【操作】：
步骤1. 点击【删除】按钮，确认弹框提示「此操作将删除该镜像，请谨慎操作！」后，点击【确定】。
步骤2. 点击【应用】按钮，并重启数据库，删除完成。
新增节点
【说明】：添加新的节点，扩大数据的规模和范围。
【操作】：
步骤1. 点击【新增节点】按钮。
步骤2. 填写配置信息后点击【保存】。
| 配置项 | 说明 |
|---|---|
| 配置方式 | 两种：库对库、节点对节点 |
| 源节点 | 源端要同步的库 / 节点 |
| 目的节点 | 目标端接收同步的库 / 节点 |
| 计算点数据来源 | 计算点数据的取用方式，可选 目的端计算 或 源端计算；两者区别见工具栏【帮助】 |
编辑节点
【操作】：
步骤1. 在节点列表中，选择要编辑的节点，点击【编辑】按钮。
步骤2. 修改节点信息，修改完成后点击【保存】按钮即可。
删除节点
【操作】：
步骤1. 在节点列表中，选择要删除的节点，点击【删除】按钮。
步骤2. 确认弹框提示「此操作将删除该源节点，请谨慎操作！」后，点击【确定】即可。
帮助说明（工具栏【帮助】的内容）
计算点数据来源
- 源端：计算点 PT 从 calc → DAS，公式里面的点名保持不变；
XF=0：计算点 PT 保持不变，计算公式里面的点名根据映射规则调整。
同步依据
分为测点名称同步（推荐）和 ID 同步。
当目的端存在与源端数据库 ID 相同、但点名不一致时，源端该 ID 的测点不做镜像。
参数说明
| 项 | 取值 / 约束 | 说明 |
|---|---|---|
| 镜像名称 | 长度 1～60，数字 / 字母 / 下划线 | V3.5.4 起增加该约束 |
| 源 / 目标实时库 | IP + 端口 | 目标库需网络可达；镜像链接已不再包含用户名/密码字段（V3.5.4 起删除） |
| 节点 / 测点 | 按库 → 节点 → 测点选择 | 决定同步范围 |
| 镜像规则 | 隔离器、过滤字段 | 控制"哪些数据要同步、怎么过滤" |
| 同步内容 | 静态点表 + 动态实时值 | 两者同时同步 |
注意事项
✅ 允许：新建 / 应用 / 编辑 / 删除镜像；新增 / 编辑 / 删除节点。
❌ 禁止 / 需谨慎：
- ⚠️ 警告 删除镜像会停止该链路同步，目标库数据随之停更；
- ⚠️ 注意 新建/改完镜像后需要应用才生效；
- ⚠️ 注意 镜像会持续写入目标库，确认目标库归属与容量后再开；
- ⚠️ 注意 双机热备场景下，库到库镜像中计算点的数据来源为目的计算（V5.2.1 起），排障时别按源点位判断。
示例
把边缘库中的一个节点镜像到中心数据库：
- 「数据上传 → 数据镜像」→【新建镜像】；
- 填写镜像名称（如
mirror_center，数字/字母/下划线）； - 选择源库与目标实时库（填 IP + 端口）；
- 选择要同步的节点 / 测点，按需设置隔离器与过滤字段；
- 保存后点【应用】；
- 验证：目标库中能看到同名点表与持续变化的实时值。
常见问题及解决方法
| 现象 | 原因 | 处置 |
|---|---|---|
| 镜像建了但目标库没数据 | 未点【应用】/ 目标库不可达 | 应用镜像；确认 IP/端口连通 |
| 导入镜像后节点重复 | 历史缺陷 | 升级到 V5.4.0 及以上（已修复） |
| 双机热备时备机实时库停止 | 历史缺陷 | 升级到 V5.2.1 及以上（已修复） |
| 计算点在镜像侧数值不对 | 数据来源为目的计算（设计如此） | 按目的计算口径核对 |
相关命令/接口
见**《DASS5 接口与二次开发手册》** → 「4.3 采集服务」的 4.3.14 服务/上传服务树（/config/transfer/tree）；数据镜像的配置接口未完整收录。
安全声明
⚠️ 注意 镜像是跨库写入：开始前确认目标库归属与容量，避免把数据写进不该写的库；停止镜像前先确认上级系统是否依赖该数据。