Envoyer des données à un point de terminaison gRPC avec Azure IoT Data Processor Preview
Important
Opérations Azure IoT (préversion) – activé parc Azure Arc est actuellement en PRÉVERSION. Vous ne devez pas utiliser ce logiciel en préversion dans des environnements de production.
Pour connaître les conditions juridiques qui s’appliquent aux fonctionnalités Azure en version bêta, en préversion ou plus généralement non encore en disponibilité générale, consultez l’Avenant aux conditions d’utilisation des préversions de Microsoft Azure.
Utilisez la destination gRPC pour écrire des données traitées et propres dans un point de terminaison gRPC pour un traitement plus approfondi.
Lorsque vous envoyez des données à un point de terminaison gRPC à partir d’une étape de destination :
- Actuellement, la phase prend uniquement en charge le type RPC unaire.
- Vous ne pouvez utiliser que le format Protobuf . Vous devez utiliser le Protobuf avec l’étape d’appel de gRPC.
- Étant donné que cette étape est une destination de pipeline, la réponse est ignorée.
Prérequis
Pour configurer et utiliser un index de pipeline de destination, vous avez besoin des éléments suivants :
- Une instance déployée d’Azure IoT Data Processor (préversion) qui inclut le composant Data Processor facultatif.
- Un serveur gRPC accessible à partir de l’instance du processeur de données.
- L’outil
protoc
permettant de générer le descripteur.
Configuration de l’étape de destination
La configuration gRPC de l’étape de destination JSON définit les détails de l’étape. Pour créer l’index, vous pouvez interagir avec l’interface utilisateur basée sur le formulaire ou fournir la configuration JSON sous l’onglet Avancé :
Nom | Type | Description | Obligatoire | Par défaut | Exemple |
---|---|---|---|---|---|
Nom | chaîne | Nom à afficher dans l’interface utilisateur du processeur de données. | Oui | - | MLCall2 |
Description | string | Description conviviale de l’index de destination. | Non | Call ML endpoint 2 |
|
Server address | Chaîne | Adresse du serveur gRPC | Oui | - | https://localhost:1313 |
Nom RPC | string | Nom RPC à appeler | Oui | - | GetInsights |
Descripteur1 | Chaîne | Descripteur codé en base 64 | Oui | - | CuIFChxnb29nb |
Authentification | string | Type d’authentification à utiliser. None /Metadata . |
Oui | None |
None |
Clé de métadonnées | string | Clé de métadonnées à utiliser lorsque Authentication est défini sur Metadata . |
Non | authorization |
authorization |
Secret | string | La référence secrète à utiliser lorsque Authentication est défini sur Metadata . |
Non | - | mysecret |
Réessayer | Réessayer | La stratégie de nouvelles tentatives à utiliser. | Non | default |
fixed |
Requête API > Chemin du corps | Chemin d’accès | Chemin d’accès à la partie du message du processeur de données qui doit être sérialisé et défini comme corps de la requête. Laissez vide si vous n’avez pas besoin d’envoyer un corps de la demande. | Non | - | .payload.gRPCRequest |
Requête API > Métadonnées > Clé2 | Champ statique/dynamique | Clé de métadonnées à définir dans la requête. | Non | Champ statique/dynamique | |
Requête API > Métadonnées > Valeur2 | Champ statique/dynamique | Valeur des métadonnées à définir dans la requête. | Non | Champ statique/dynamique |
1Descripteur : pour sérialiser le corps de la demande, vous avez besoin d’un descripteur encodé en base 64 du fichier .proto.
Utilisez la commande suivante pour générer le descripteur, remplacez <proto-file>
par le nom de votre fichier .proto :
protoc --descriptor_set_out=/dev/stdout --include_imports <proto-file> | base64 | tr '\n' ' ' | sed 's/[[:space:]]//g'
Utilisez la sortie de la commande précédente comme descriptor
dans la configuration.
2Requête API > Métadonnées : chaque élément du tableau de métadonnées est une paire clé-valeur. Vous pouvez définir dynamiquement la clé ou la valeur en fonction du contenu du message entrant ou sous forme de chaîne statique.
Contenu connexe
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour