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

Les exemples suivants utilisent le flux gRPC :

  • Un atelier SIG a mis en place un client gRPC personnalisé qui utilise Python pour envoyer des données structurées vers Velocity au moyen du 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 au moyen du flux gRPC.

Remarques sur l’utilisation

Tenez compte des points suivants lorsque vous utilisez le flux gRPC :

  • Le flux gRPC, y compris la spécification de la structure et des champs clés, est configuré par un utilisateur Velocity. 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 sur la page des détails de flux. Ces paramètres sont requis lors de la création d'un client gRPC.
  • Définissez le paramètre 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, il est nécessaire de créer un client gRPC 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 client et le 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

Les paramètres du flux gRPC sont présentés ci-après :

ParamètreDescriptionType de données

Type d’authentification

Indique si les messages entrants seront authentifiés. Les options sont les suivantes :

  • None (Aucune) : 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 dans les en-têtes de requête sous la forme suivante : Authorization: Bearer <your_token>.

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

Considérations et limitations

Les flux gRPC qui utilisent le type d’authentification ArcGIS peuvent être partagés en écriture avec d’autres utilisateurs et groupes. Lorsqu’un flux gRPC est partagé en écriture, les utilisateurs et les groupes avec lesquels il est partagé peuvent y écrire des données. Ne partagez pas un flux avec activation des privilèges en écriture si vous ne souhaitez pas que d’autres utilisateurs et groupes puissent y écrire des données. Vous pouvez activer et désactiver les privilèges en écriture sur la page des détails du flux, dans Velocity. Pour plus d’informations, reportez-vous à la rubrique Partager des flux.