共用方式為

使用 Azure IoT 數據處理器預覽將數據傳送至 gRPC 端點

  • 發行項

重要

已啟用 Azure Arc 的 Azure IoT 操作預覽版目前為預覽狀態。 請勿在生產環境使用此預覽版軟體。

請參閱 Microsoft Azure 預覽版增補使用規定，以了解適用於 Azure 功能 (搶鮮版 (Beta)、預覽版，或尚未正式發行的版本) 的法律條款。

使用 gRPC 目的地將已處理和清除的資料寫入 gRPC 端點，以便進一步處理。

當您從目的地階段將資料傳送至 gRPC 端點時：

  • 目前，階段僅支援一元 RPC 類型。
  • 您只能使用 Protobuf 格式。 您必須使用 Protobuf 搭配 gRPC 呼叫階段。
  • 因為這個階段是管線目的地，所以會捨棄回應。

必要條件

若要設定及使用目的地管線階段，您需要：

  • 已部署的 Azure IoT 數據處理者預覽實例，其中包含選擇性的數據處理者元件。
  • 可從資料處理器執行個體存取的 gRPC 伺服器。
  • 產生描述項的 protoc 工具。

設定目的地階段

gRPC 目的地階段 JSON 組態會定義階段的詳細資料。 若要編寫階段，可透過與表單架構使用者介面互動，或在 [進階] 索引標籤上提供 JSON 設定：

名稱 類型​​ 描述 是必要欄位 預設 範例
名稱 字串 用於顯示在資料處理器使用者介面中的名稱。 Yes - MLCall2
描述 string 目的地階段的使用者易記描述。 No Call ML endpoint 2
Server address String gRPC 伺服器位址 Yes - https://localhost:1313
RPC 名稱 string 要呼叫的 RPC 名稱 Yes - GetInsights
描述項1 String Base 64 編碼描述項 Yes - CuIFChxnb29nb
驗證 string 要使用的驗證類型。 None/Metadata. Yes None None
中繼資料索引鍵 string 當 Authentication 設定為 Metadata 時要使用的中繼資料索引鍵。 No authorization authorization
祕密 string 當 Authentication 設定為 Metadata 時使用的祕密參考。 No - mysecret
重試 重試 要使用的重試原則。 No default fixed
API 要求 > 本文路徑 路徑 應該序列化並設定為要求本文之資料處理器訊息部分的路徑。 如果不須傳送要求本文，請保持空白。 No - .payload.gRPCRequest
API 要求 > 中繼資料 > 金鑰2 靜態/動態欄位 在要求中設定的中繼資料金鑰。 No 靜態/動態欄位
API 要求 > 中繼資料 > 值2 靜態/動態欄位 在要求中設定的中繼資料值。 No 靜態/動態欄位

1描述元：若要串行化要求主體，您需要 .proto 檔案的Base 64編碼描述元。

使用下列命令來產生描述項，以 .proto 檔案的名稱取代 <proto-file>：

protoc --descriptor_set_out=/dev/stdout --include_imports <proto-file> | base64 | tr '\n' ' ' | sed 's/[[:space:]]//g'

使用上一個指令的輸出作為組態中的 descriptor。

2API 要求 > 元數據：元數據陣列中的每個元素都是索引鍵值組。 您可以根據傳入訊息的內容動態設定為索引鍵或值，或設定為靜態字串。

相關內容