gRPC

Le type de flux gRPC dans ArcGIS Velocity crée une extrémité de chemin gRPC intégré qui peut être utilisé pour envoyer de manière programmée des données depuis des clients et des applications gRPC vers Velocity, soit sous forme de requêtes discrètes, soit sous forme de flux continu. gRPC est un cadre d'appel de procédure à distance à code source ouvert utilisé pour connecter des applications et des services distribués.

Exemples

• Un atelier SIG a mis en place un client gRPC personnalisé qui utilise Python pour envoyer des données structurées vers Velocity en utilisant le type de flux gRPC.
• Une organisation disposant de plusieurs applications de collecte de données, écrites dans différents langages, souhaite rendre ses données disponibles à des fins d'analyse géospatiale. Les clients gRPC personnalisés sont conçus pour envoyer des données depuis leurs différentes applications vers Velocity à l'aide du type de flux gRPC.

Remarques sur l'utilisation

• Le flux gRPC est configuré par un utilisateur Velocity, y compris la spécification de la structure et des champs clés. Une fois le flux créé, les paramètres gRPC endpoint header path key (Clé du chemin vers l'en-tête de point d'extrémité gRPC), gRPC endpoint header path (chemin vers l'en-tête de point d'extrémité gRPC), et gRPC endpoint URL (URL de point d’extrémité gRPC) sont disponibles dans la page des détails de flux. Ces paramètres sont requis lors de la création d'un client gRPC.
• Définissez le Authentication type (Type d’authentification) sur ArcGIS pour utiliser l’authentification OAuth2.0. Chaque message entrant doit comporter un jeton valide pour le propriétaire du flux. Les messages sans jeton valide sont rejetés.
• Les données provenant d'un client gRPC doivent être constituées comme un objet structuré tel que défini par le fichier velocity_grpc.proto.
• Le type de flux gRPC prend en charge les appels synchrones et asynchrones.
• Le type de flux gRPC prend en charge le client-streaming RPC (RPC à flux client) (plusieurs requêtes avec une seule réponse) et unary RPC (RPC unaire) (requête unique avec réponse unique).
• Outre la configuration des paramètres de connexion des flux, un client gRPC devra être créé pour envoyer des entités à Velocity. La structure gRPC prend en charge de nombreux langages de développement. Le référentiel Github realtime-grpc-feed contient des ressources essentielles telles que le fichier velocity_grpc.proto utilisé pour définir le contrat entre le cleitn et service de flux gRPC, la documentation du développeur et les implémentations de référence qui illustrent comment créer un client gRPC.
• Pour plus d'informations sur les fonctionnalités gRPC et les stratégies de développement des clients, consultez la page Web gRPC.

Paramètres

Paramètre	Description	Type de données
Type d'authentification	Indique si les messages entrants seront authentifiés. Les options sont les suivantes : None (Aucun) : aucune authentification n'est effectuée. ArcGIS : chaque message entrant doit comporter un jeton valide pour le propriétaire du flux. Les messages sans jeton valide sont rejetés. Le jeton doit figurer comme suit dans les en-têtes de demande : Autorisation : titulaire <votre jeton>	Chaîne
Clé du chemin vers l’en-tête de point d’extrémité gRPC	Clé identifiant le flux pour le routage des messages. La clé est utilisée avec le chemin de l'en-tête pour acheminer les messages vers le flux. Ce paramètre est généré et alimenté par Velocity après la publication du flux.	Chaîne
Chemin vers l’en-tête de point d’extrémité gRPC	Chemin identifiant le flux pour le routage des messages. Ce paramètre est généré et alimenté par Velocity après la publication du flux.	Chaîne
URL de point d’extrémité gRPC	L'URL complète pour envoyer des messages comme défini dans le canal client gRPC. Ce paramètre est généré et alimenté par Velocity après la publication du flux.	Chaîne