使用版本thingsboard V3.3

寫(xiě)在前面：

個(gè)人記錄自己在學(xué)習(xí)和使用thingsboard平臺(tái)使遇到的問(wèn)題、注意事項(xiàng)和心得體會(huì)。非專(zhuān)業(yè)，僅供大家參考。
此為第四篇，實(shí)體與關(guān)系。

實(shí)體概述

以下摘自官方文檔翻譯版本：

• ThingsBoard 提供用戶(hù)界面和 REST API 來(lái)配置和管理 IoT 應(yīng)用程序中的多個(gè)實(shí)體類(lèi)型及其關(guān)系。支持的實(shí)體是：

  • 租戶(hù)- 您可以將租戶(hù)視為一個(gè)單獨(dú)的商業(yè)實(shí)體：它是擁有或生產(chǎn)設(shè)備和資產(chǎn)的個(gè)人或組織；租戶(hù)可能有多個(gè)租戶(hù)管理員用戶(hù)和數(shù)百萬(wàn)的客戶(hù)、設(shè)備和資產(chǎn)；
  • 客戶(hù)——客戶(hù)也是一個(gè)獨(dú)立的商業(yè)實(shí)體：購(gòu)買(mǎi)或使用租戶(hù)設(shè)備和/或資產(chǎn)的個(gè)人或組織；客戶(hù)可能有多個(gè)用戶(hù)和數(shù)百萬(wàn)的設(shè)備和/或資產(chǎn)；
  • 用戶(hù)- 用戶(hù)能夠?yàn)g覽儀表板和管理實(shí)體；
  • 設(shè)備- 可以產(chǎn)生遙測(cè)數(shù)據(jù)和處理 RPC 命令的基本物聯(lián)網(wǎng)實(shí)體。例如，傳感器、執(zhí)行器、開(kāi)關(guān)；
  • 資產(chǎn)- 可能與其他設(shè)備和資產(chǎn)相關(guān)的抽象物聯(lián)網(wǎng)實(shí)體。例如工廠(chǎng)、場(chǎng)地、車(chē)輛；
  • 實(shí)體視圖- 如果您只想與客戶(hù)共享部分設(shè)備或資產(chǎn)數(shù)據(jù)，則很有用；
  • 警報(bào)- 識(shí)別您的資產(chǎn)、設(shè)備或其他實(shí)體問(wèn)題的事件；
  • 儀表板——物聯(lián)網(wǎng)數(shù)據(jù)的可視化和通過(guò)用戶(hù)界面控制特定設(shè)備的能力；
  • 規(guī)則節(jié)點(diǎn)- 傳入消息、實(shí)體生命周期事件等的處理單元；
  • 規(guī)則鏈——定義規(guī)則引擎中的處理流程。可能包含許多規(guī)則節(jié)點(diǎn)和到其他規(guī)則鏈的鏈接；

• 每個(gè)實(shí)體支持：

  • 屬性- 與實(shí)體關(guān)聯(lián)的靜態(tài)和半靜態(tài)鍵值對(duì)。例如序列號(hào)、型號(hào)、固件版本；
  • 時(shí)間序列數(shù)據(jù)- 可用于存儲(chǔ)、查詢(xún)和可視化的時(shí)間序列數(shù)據(jù)點(diǎn)。例如溫度、濕度、電池電量；
  • 關(guān)系- 與其他實(shí)體的定向連接。例如包含、管理、擁有、生產(chǎn)。

• 一些實(shí)體支持配置文件：

  • 租戶(hù)配置文件- 包含多個(gè)租戶(hù)的通用設(shè)置：實(shí)體、API 和速率限制等。每個(gè)租戶(hù)在單個(gè)時(shí)間點(diǎn)都有一個(gè)也是唯一的配置文件。
  • 設(shè)備配置文件- 包含多個(gè)設(shè)備的通用設(shè)置：處理和傳輸配置等。每個(gè)設(shè)備在單個(gè)時(shí)間點(diǎn)都有一個(gè)也是唯一的配置文件。

關(guān)于本文

實(shí)際上實(shí)體與關(guān)系的知識(shí)點(diǎn)非常復(fù)雜，本文主要講述的是“資產(chǎn)”和“設(shè)備”的關(guān)系

關(guān)聯(lián)：

向內(nèi)和向外關(guān)聯(lián)

• 向外從（from） 和 向內(nèi)到（to），例如：我設(shè)備0101屬于設(shè)備01，則設(shè)備01向外關(guān)聯(lián)到設(shè)備0101，設(shè)備0101向內(nèi)關(guān)聯(lián)到設(shè)備01
• 實(shí)際上，設(shè)備01可以理解為開(kāi)發(fā)中的裝置，設(shè)備0101可以理解為具體的設(shè)備。
• 圖為Flinet大佬的圖示：

實(shí)際上

• 關(guān)系可以是任何關(guān)系，表示設(shè)備與設(shè)備或者設(shè)備與資產(chǎn)之間的聯(lián)系。
• 關(guān)系可以手寫(xiě)建立，選擇好關(guān)系兩邊的實(shí)體即可。

關(guān)鍵點(diǎn)：

• 在規(guī)則鏈，創(chuàng)造告警節(jié)點(diǎn)時(shí)，有這樣一個(gè)勾選：傳播（propagate）。

  • 如果設(shè)備告警了，它可以向父實(shí)體（向內(nèi)）傳遞它的告警
    • 所以可以理解為，向內(nèi)表示向上級(jí)

• thingsboard實(shí)際上很靈活，可以嵌套很多層，一層一層傳遞下去。

• 不僅在告警的時(shí)候有用，在儀表板展示的時(shí)候也會(huì)涉及到這個(gè)關(guān)系。

實(shí)操：

1. 在資產(chǎn)中添加資產(chǎn)，命名A產(chǎn)區(qū)，資產(chǎn)類(lèi)型手寫(xiě)新建為測(cè)試資產(chǎn)類(lèi)型

2. 點(diǎn)開(kāi)A產(chǎn)區(qū)的關(guān)聯(lián)關(guān)系，選擇向外關(guān)聯(lián)（即管理）管理新建的測(cè)試設(shè)備01、測(cè)試設(shè)備02

3. 在儀表板庫(kù)新建一個(gè)儀表板測(cè)試02，打開(kāi)，添加部件，選擇card組件包的Entities tables

4. 在數(shù)據(jù)源點(diǎn)擊添加，為實(shí)體新建一個(gè)別名，設(shè)置篩選器如下。此圖表示：從A產(chǎn)區(qū)篩選“從（向下）”方向找到包含關(guān)系的默認(rèn)設(shè)備。

5. 查看儀表板結(jié)果

• 至此，基本實(shí)體與關(guān)系展示結(jié)束。更多更復(fù)雜的關(guān)系具體項(xiàng)目中慢慢研究。