狀態儲存讓運算元能在訊息處理中持久化並檢索資料,並使資料流程圖中能進行有狀態操作。 本文說明如何在 Azure IoT 操作 本地開發環境中,與 WASM 運算元一起使用狀態儲存。
在完成本文步驟前,先建立本地開發環境,並在本地建置並執行圖形應用程式。 欲了解更多資訊,請參閱 建構 WASM 模組以了解資料流程。
先決條件
完成 Build WASM 資料流程模組中列出的先決條件。
開啟狀態儲存範例工作區
如果你還沒克隆過 Explore IoT Operations 的儲存庫,請克隆。
開啟 explore-iot-operations/samples/wasm/statestore-scenario 資料夾。 此資料夾包含以下資源:
-
graph.dataflow.yaml- 包含已啟用狀態儲存運算子的資料流程圖配置。 -
statestore.json- 具有鍵值對的狀態儲存配置。 -
data/- 取樣輸入資料進行測試。 -
operators/- otel-enrich 和 filter 運算子的原始程式碼。
設定狀態存放區
打開
statestore.json檔案以查看目前的狀態儲存設定。你可以修改
factoryId或machineId的值以進行測試。 濃縮參數參考這些鍵。打開
graph.dataflow.yaml並檢視豐富化配置。 本檔案的重要部分如下摘要所示:moduleConfigurations: - name: module-otel-enrich/map parameters: enrichKeys: name: enrichKeys description: Comma separated list of DSS keys which will be fetched and added as attributes default: factoryId,machineId operations: - operationType: "source" name: "source" - operationType: "map" name: "module-otel-enrich/map" module: "otel-enrich" - operationType: "sink" name: "sink"enrichKeys參數的預設值(factoryId,machineId)決定哪些鍵要從狀態儲存庫擷取並加入為屬性。確保 中
enrichKeys列出的每個鍵都存在於statestore.json。 如果你在statestore.json中新增或移除鍵,請更新default的值或使用TK_CONFIGURATION_PARAMETERS環境變數覆蓋它。
更新測試資料(可選)
你可以修改資料夾裡 data/ 的測試資料,嘗試不同的輸入值。 樣本資料包含溫度讀數。
建立並執行狀態儲存情境
如果你之前已經停止本地執行環境,請按 Ctrl+Shift+P 開啟指令面板並搜尋 Azure IoT 操作: Start Development Environment。 選擇 釋放 作為跑步模式。
按
Ctrl+Shift+P開啟指令面板並搜尋 Azure IoT 操作: Build All Data Flow Operators。 選擇 釋放 作為建置模式。 等待建置完成。再次按
Ctrl+Shift+P,搜尋 Azure IoT 操作: Run Application Graph。 選擇 釋放 作為跑步模式。在你的 VS Code 工作區選擇
data輸入資料的資料夾。 DevX 容器會啟動,執行帶有樣本輸入的圖表。
驗證狀態儲存功能
圖形執行完成後:
在
data/output/資料夾中查看結果。打開產生
.txt的檔案查看處理後的資料。 輸出訊息的user properties部分包含從狀態儲存庫取得的factoryId和machineId值。檢查
data/output/logs/host-app.log登入資料,確認otel-enrich操作員是否從狀態儲存庫取得數值,並將其作為使用者屬性加入訊息中。