使用狀態快取建立具狀態的 WASM 圖表

狀態儲存讓運算元能在訊息處理中持久化並檢索資料,並使資料流程圖中能進行有狀態操作。 本文說明如何在 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 運算子的原始程式碼。

設定狀態存放區

  1. 打開 statestore.json 檔案以查看目前的狀態儲存設定。

  2. 你可以修改 factoryId 或 machineId 的值以進行測試。 濃縮參數參考這些鍵。

  3. 打開 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)決定哪些鍵要從狀態儲存庫擷取並加入為屬性。

  4. 確保 中 enrichKeys 列出的每個鍵都存在於 statestore.json。 如果你在 statestore.json 中新增或移除鍵,請更新 default 的值或使用 TK_CONFIGURATION_PARAMETERS 環境變數覆蓋它。

更新測試資料(可選)

你可以修改資料夾裡 data/ 的測試資料,嘗試不同的輸入值。 樣本資料包含溫度讀數。

建立並執行狀態儲存情境

如果你之前已經停止本地執行環境,請按 Ctrl+Shift+P 開啟指令面板並搜尋 Azure IoT 操作: Start Development Environment。 選擇 釋放 作為跑步模式。

  1. 按 Ctrl+Shift+P 開啟指令面板並搜尋 Azure IoT 操作: Build All Data Flow Operators。 選擇 釋放 作為建置模式。 等待建置完成。

  2. 再次按 Ctrl+Shift+P,搜尋 Azure IoT 操作: Run Application Graph。 選擇 釋放 作為跑步模式。

  3. 在你的 VS Code 工作區選擇 data 輸入資料的資料夾。 DevX 容器會啟動,執行帶有樣本輸入的圖表。

驗證狀態儲存功能

圖形執行完成後:

  1. 在 data/output/ 資料夾中查看結果。

  2. 打開產生 .txt 的檔案查看處理後的資料。 輸出訊息的user properties 部分包含從狀態儲存庫取得的factoryId 和machineId 值。

  3. 檢查 data/output/logs/host-app.log 登入資料,確認 otel-enrich 操作員是否從狀態儲存庫取得數值,並將其作為使用者屬性加入訊息中。