通過數據存儲的時序數據存儲規則功能,可將指定的自定義Topic數據流轉到時序數據存儲空間進行存儲。本文介紹如何通過配置時序存儲規則,將自定義Topic數據存儲到時序存儲空間中。
前提條件
使用場景
如果需要存儲自定義Topic數據用于查詢,必須先創建時序數據存儲規則。創建規則后,如果需要將其他自定義Topic數據寫入時序存儲,可以在控制臺中修改時序數據存儲規則,或者調用WriteDevicesHotStorageData。
如果需要長時間存儲自定義Topic數據、降低存儲成本、進一步處理自定義Topic數據例如數據分析、數據報表、數據API,可以開啟數據備份,會自動在離線存儲中創建相應的自定義存儲表,表名稱的格式為
時序存儲規則${規則ID}-隨機ID
。關閉后再打開數據備份,會繼續寫入已創建的自定義存儲表。
創建時序數據存儲規則
每個實例下最多創建1000個時序數據存儲規則。
登錄物聯網平臺控制臺。
在實例概覽頁面,找到對應的企業版實例,單擊實例進入實例詳情頁面。
在左側導航欄,選擇數據服務 > 數據存儲。
在時序存儲頁簽下的存儲規則頁簽,單擊創建規則。
在配置向導頁面,完成以下操作。
步驟一:配置基本信息
輸入規則名稱和規則描述。
參數
描述
規則名稱
輸入規則名稱。支持中文、英文字母、日文、數字、下劃線(_)和短劃線(-),長度為1~30個字符,一個中文或日文占2個字符。
規則描述
規則描述信息。
單擊下一步。如果單擊取消,規則也已創建成功,可在存儲規則列表查看已添加的存儲規則,再配置數據源Topic和數據處理腳本。具體操作,請參見查看和更新時序數據存儲規則。
步驟二:添加數據源Topic
每個規則下最多添加1,000個Topic。
在添加數據源Topic向導頁面,單擊添加Topic。
在彈出的對話框中,根據頁面提示,選擇產品、設備和自定義Topic。Topic支持以下通配符:
全部設備(+)
:指定產品下所有設備。user/#
:指定設備的所有自定義Topic。
單擊確定。
添加自定義Topic成功后,數據源Topic列表顯示已添加的Topic信息。
重要已添加自定義Topic不支持修改,您可先刪除,然后重新添加。
(可選)重復以上步驟,可添加多個數據源Topic。
單擊下一步。如果單擊取消,可在規則詳情頁面,查看已添加的數據源Topic列表。具體操作,請參見查看和更新時序數據存儲規則。
步驟三:編輯數據處理腳本
在編輯數據處理腳本向導頁面的編輯腳本輸入框中輸入腳本,該腳本會解析自定義Topic數據,然后將解析結果存儲到時序存儲中。
重要同一時序數據存儲規則下,同一字段Key和Value的數據類型必須保持不變。若發生改變(例如:int32類型改為text類型),則新數據的寫入會失敗,且無法再查詢歷史存儲數據。
單擊頁面下方的保存,完成腳本編輯。
單擊頁面下方的調試。此時也會自動保存腳本草稿。
在右側調試面板,根據頁面提示,選擇產品和設備,輸入Topic和Payload數據,單擊調試,驗證腳本。
輸入的Topic和Payload數據,與腳本解析邏輯相符即可。腳本編輯方法和示例,請參見腳本語法。
運行結果中會顯示腳本中聲明的變量值和執行的數據存儲函數。
單擊調試面板的關閉。
(可選)單擊頁面下方的發布。此時還可以編輯、重新調試或發布腳本。
單擊完成并發布。此時會關閉配置向導頁面,完成規則的所有的配置。
返回時序存儲>規則存儲頁簽,單擊規則對應的啟動。規則啟動后,設備上報的自定義Topic數據即可按照解析腳本進行存儲。
查看和更新時序數據存儲規則
在時序存儲頁簽下的存儲規則頁簽下, 找到對應的存儲規則,單擊對應操作列的查看。
在規則詳情頁面,查看規則信息,包括規則ID、創建時間、數據源Topic數量及列表、數據處理腳本信息等。
按照以下操作步驟,查看和更新規則。
編輯規則基本信息
單擊右上角編輯。
在編輯規則對話框,修改規則名稱和規則描述。
更新數據源Topic
在數據源Topic頁簽:
單擊添加Topic,參考上文步驟二:添加數據源Topic,新增更多數據源Topic。
在Topic列表中,單擊目標Topic操作列的刪除,會從數據源Topic列表刪除對應Topic。
更新數據處理腳本
單擊數據處理腳本頁簽。
在編輯腳本輸入框上方,單擊編輯草稿。
在編輯腳本輸入框中,修改腳本。
依次單擊頁面下方保存、調試和發布,完成腳本更新。
可選操作
在時序存儲>規則存儲頁簽: