Odeslání dat do koncového bodu gRPC pomocí Azure IoT Data Processor Preview
Důležité
Azure IoT Operations Preview – Služba Azure Arc je aktuálně ve verzi PREVIEW. Tento software ve verzi Preview byste neměli používat v produkčních prostředích.
Právní podmínky, které platí pro funkce Azure, které jsou ve verzi beta, verzi Preview nebo které zatím nejsou veřejně dostupné, najdete v Dodatečných podmínkách použití pro Microsoft Azure verze Preview.
K zápisu zpracovaných a čistých dat do koncového bodu gRPC pro další zpracování použijte cíl gRPC .
Při odesílání dat do koncového bodu gRPC z cílové fáze:
- V současné době fáze podporuje pouze unární typ RPC.
- Formát Protobuf můžete použít pouze. Je nutné použít Protobuf s fází volání gRPC.
- Vzhledem k tomu, že tato fáze je cílem kanálu, odpověď se zahodí.
Požadavky
Pokud chcete nakonfigurovat a použít cílovou fázi kanálu, potřebujete:
- Nasazená instance procesoru dat Azure IoT Preview, která zahrnuje volitelnou komponentu Zpracovatel dat.
- Server gRPC, který je přístupný z instance zpracovatele dat.
- Nástroj
protoc
pro vygenerování popisovače.
Konfigurace cílové fáze
Konfigurace JSON cílové fáze gRPC definuje podrobnosti fáze. Pokud chcete vytvořit fázi, můžete pracovat s uživatelským rozhraním založeným na formuláři nebo zadat konfiguraci JSON na kartě Upřesnit :
Name | Typ | Popis | Požaduje se | Výchozí | Příklad |
---|---|---|---|---|---|
Název | string | Název, který se má zobrazit v uživatelském rozhraní zpracovatele dat. | Ano | - | MLCall2 |
Popis | string | Uživatelsky přívětivý popis cílové fáze. | No | Call ML endpoint 2 |
|
Server address | String | Adresa serveru gRPC | Ano | - | https://localhost:1313 |
Název RPC | string | Název RPC pro volání | Ano | - | GetInsights |
Popisovač1 | String | Základní popisovač s kódováním 64 | Ano | - | CuIFChxnb29nb |
Ověřování | string | Typ ověřování, který se má použít. None /Metadata . |
Ano | None |
None |
Klíč metadat | string | Klíč metadat, který se má použít, pokud Authentication je nastaven na Metadata hodnotu . |
No | authorization |
authorization |
Tajný | string | Odkaz na tajný kód, který se má použít, pokud Authentication je nastaven na Metadata hodnotu . |
No | - | mysecret |
Zkusit znovu | Opakovat | Zásady opakování, které se mají použít. | No | default |
fixed |
Cesta textu požadavku > rozhraní API | Cesta | Cesta k části zprávy zpracovatele dat, která by měla být serializována a nastavena jako text požadavku. Pokud nepotřebujete posílat text požadavku, nechejte prázdný. | No | - | .payload.gRPCRequest |
Klíčmetadat > požadavku > rozhraní API 2 | Statické nebo dynamické pole | Klíč metadat, který se má nastavit v požadavku. | No | Statické nebo dynamické pole | |
Hodnotametadat > požadavku > rozhraní API 2 | Statické nebo dynamické pole | Hodnota metadat, která se mají nastavit v požadavku. | No | Statické nebo dynamické pole |
1Popisovač: K serializaci textu požadavku potřebujete základní 64 kódovaný popisovač souboru .proto.
Pomocí následujícího příkazu vygenerujte popisovač, nahraďte <proto-file>
názvem souboru .proto:
protoc --descriptor_set_out=/dev/stdout --include_imports <proto-file> | base64 | tr '\n' ' ' | sed 's/[[:space:]]//g'
Jako výstup v konfiguraci použijte výstup z předchozího příkazu descriptor
.
2Metadata požadavku > rozhraní API: Každý prvek v poli metadat je pár klíč-hodnota. Klíč nebo hodnotu můžete dynamicky nastavit na základě obsahu příchozí zprávy nebo jako statický řetězec.