データ プロセッサを使用して gRPC エンドポイントにデータを送信する
重要
Azure Arc によって有効にされる Azure IoT Operations Preview は、 現在プレビュー段階です。 運用環境ではこのプレビュー ソフトウェアを使わないでください。
一般公開リリースが利用可能になった場合は、新しい Azure IoT Operations インストールをデプロイする必要があります。プレビュー インストールをアップグレードすることはできません。
ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用される法律条項については、「Microsoft Azure プレビューの追加使用条件」を参照してください。
gRPC の変換先を使用して、さらなるプロセスとして処理済みのクリーンなデータを gRPC エンドポイントに書き込みます。
変換先ステージから gRPC エンドポイントにデータを送信する場合:
- 現時点では、このステージは Unary RPC 型のみをサポートしています。
- 使用できるのは Protobuf 形式のみです。 gRPC 呼び出しステージでは Protobuf を使用する必要があります。
- このステージはパイプラインの変換先であるため、応答は破棄されます。
前提条件
変換先パイプライン ステージを構成して使用するには、以下が必要です。
- オプションのデータ プロセッサ コンポーネントを含むデータ プロセッサのデプロイされたインスタンス。
- データ プロセッサ インスタンスからアクセスできる gRPC サーバー。
- 記述子を生成する
protocツール。
変換先ステージを構成する
gRPC 変換先ステージの JSON 構成で、ステージの詳細を定義します。 ステージを作成するには、フォーム ベースの UI を使用するか、[詳細設定] タブで次の JSON 構成を指定します。
| 名前 | 種類 | 内容 | 必要 | Default | 例 |
|---|---|---|---|---|---|
| 名前 | string | データ プロセッサ UI に表示する名前。 | はい | - | MLCall2 |
| 説明 | string | 変換先ステージのわかりやすい説明。 | いいえ | Call ML endpoint 2 |
|
| サーバー アドレス | String | gRPC サーバー アドレス | はい | - | https://localhost:1313 |
| RPC 名 | string | 呼び出す RPC 名 | はい | - | GetInsights |
| 記述子1 | String | base 64 でエンコードされた記述子 | はい | - | CuIFChxnb29nb |
| 認証 | string | 使用する認証の種類。 None/Metadata. |
はい | None |
None |
| メタデータ キー | string | Authentication が Metadata に設定されている場合に使用するメタデータ キー。 |
いいえ | authorization |
authorization |
| Secret | string | Authentication が Metadata に設定されている場合に使用するシークレットの参照。 |
いいえ | - | mysecret |
| 再試行 | 再試行 | 使用する再試行ポリシー。 | いいえ | default |
fixed |
| API 要求 > 本文のパス | Path | シリアル化して要求本文として設定する必要があるデータ プロセッサ メッセージの部分へのパス。 要求本文を送信する必要がない場合は、空のままにします。 | いいえ | - | .payload.gRPCRequest |
| API 要求 > メタデータ > キー2 | 静的/動的フィールド | 要求で設定するメタデータ キー。 | いいえ | 静的/動的フィールド | |
| API 要求 > メタデータ > 値2 | 静的/動的フィールド | 要求で設定するメタデータ値。 | いいえ | 静的/動的フィールド |
1記述子: 要求本文をシリアル化するには、.proto ファイルの base 64 でエンコードされた記述子が必要です。
次のコマンドを使用して記述子を生成し、<proto-file> を .proto ファイルの名前に置き換えます:
protoc --descriptor_set_out=/dev/stdout --include_imports <proto-file> | base64 | tr '\n' ' ' | sed 's/[[:space:]]//g'
構成内で前述のコマンドからの出力を descriptor として使用します。
2API 要求 > メタデータ: メタデータ配列の各要素はキーと値のペアです。 キーや値は、受信メッセージの内容に基づいて動的に設定するか、または静的文字列として設定できます。