资产或设备实体批量导入

正文来自原稿（无配图）。批量创建资产/设备可用 REST API 或 CSV。

方式一：自定义 Java + EasyExcel 调接口

用程序读 Excel（如阿里 EasyExcel），循环调用 ThingsBoard REST 创建实体。

创建资产示例：

项	值
Method	POST
URL	http://<host>:8080/api/asset
Header	X-Authorization: Bearer <JWT>
Body	见下

{
  "name": "test444",
  "assetProfileId": {
    "entityType": "ASSET_PROFILE",
    "id": "<ASSET_PROFILE_UUID>"
  },
  "label": "test444",
  "additionalInfo": {
    "description": "test444"
  }
}

JWT 用租户管理员登录后从接口/浏览器拿到，勿把长期 Token 写进仓库；程序里登录换票或读环境变量。

创建设备接口一般为 POST /api/device，字段换成 deviceProfileId 等，写法类似。

方式二：指定格式的 CSV 导入

按平台要求的 CSV 列导入（示例）：

name,type,size,price
test111,椅子,123,58
test222,椅子,124,60

具体列名、入口以你使用的 TB 版本「批量导入 / Bulk import」界面为准；属性列需与实体属性定义一致。

---

补充（辅）

方式	适用
EasyExcel + API	字段复杂、要和业务库对账、可控重试
CSV	运营一次性导入、列简单
注意	Profile Id 必须先存在；名称唯一；大批量注意限流与事务

也可用官方「导入实体」向导（若版本提供），与 CSV 同源思路。

相关文章

• ThingsBoard 租户
• 接入 Wiota 网关与 DTU（规则链自动创建设备另一路径）
• 专栏导读