跳到內容
返回官網

歷史資料匯出

歷史匯出在背景產生檔案,適合儲存原始明細或交給其他工具分析,無需讓瀏覽器一直等待查詢完成。

  1. 選擇點位和時間範圍;共享點位需指定來源裝置。
  2. 檢視磁碟容量預估,再建立匯出任務。
  3. 在任務清單檢視排隊、執行、完成或失敗狀態;不再需要時可以取消。
  4. 完成後取得短期下載憑證,下載 CSV 或 ZIP 檔案。

任務受時間跨度、檔案大小、並行和磁碟餘量限制。空間不足時會拒絕或停止匯出,具體限制以裝置設定為準。

  • 支援擷取、聚合和共享歷史值;不重複選擇同一裝置的同一點位。
  • CSV 保留空值標識,區分“沒有資料”與空字串。
  • 下載憑證有有效期,過期後重新取得;不要公開分享憑證。
  • 匯出的是指定範圍內仍保留的資料,已被保留策略清理的歷史無法補回。
操作 介面
容量預估 GET /ems-data/export/disk-space
建立 / 查詢任務清單 POST /ems-data/export/tasks / GET /ems-data/export/tasks
查詢 / 取消單個任務 GET /ems-data/export/tasks/:taskId / DELETE /ems-data/export/tasks/:taskId
取得下載憑證 POST /ems-data/export/tasks/:taskId/download-ticket

建立任務傳入 format(CSV 或 CSV_ZIP)、dataKeys、startTime 和 endTime。只有任務成功後才能下載,已受理不表示檔案已產生。

臨時分析用 歷史查詢,持續儲存用 週期歸檔,遷移設定用 備份與恢復。Agent 呼叫方式見 匯出 Skill。