Ajouter une source d’application personnalisée à un Eventstream

  • Article

Cet article vous montre comment ajouter une source d’application personnalisée à un Eventstream.

Prérequis

Pour commencer, vous devez remplir les conditions préalables suivantes :

  • Accédez à un espace de travail Premium avec les autorisations Contributeur ou supérieures où se trouve votre flux d’événements.

Remarque

  • Le nombre maximal de sources et de destinations pour un flux d’événements est de 11.
  • La conservation des données d’événement dans un flux d’événements est de 1 jour, avec la possibilité de l’étendre et de la rendre configurable à l’avenir.

Ajouter une application personnalisée en tant que source

Si vous souhaitez connecter votre propre application à un flux d’événements, vous pouvez ajouter une source d’application personnalisée. Ensuite, envoyez des données au flux d’événements avec votre propre application avec le point de terminaison de connexion exposé dans l’application personnalisée. Pour ajouter une source d’application personnalisée, procédez comme suit :

  1. Sélectionnez Nouvelle source dans le ruban ou « + » dans le canevas de l’éditeur principal, puis Application personnalisée.

  2. Entrez un nom de source pour l’application personnalisée, puis sélectionnez Ajouter.

    Capture d’écran de la configuration de la source d’application personnalisée.

  3. Une fois que vous avez créé la source de l’application personnalisée, vous pouvez basculer et voir les informations suivantes dans l’onglet Détails dans le volet inférieur :

    Capture d’écran de la source d’application personnalisée.

    • De base : affiche le nom, la description, le type et l’état de votre application personnalisée.
    • Clés : affiche la chaîne de connexion de votre application personnalisée, que vous pouvez copier et coller dans votre application.
    • Exemple de code : affiche l’exemple de code, auquel vous pouvez faire référence ou que vous pouvez copier pour envoyer (push) les données d’événement vers cet eventstream ou extraire (pull) les données d’événement de cet eventstream.

    Pour chaque onglet (De base / Clés / Exemple de code), vous pouvez également changer trois onglets de protocole : Eventhub, **AMQP et Kafka pour accéder à diverses informations de formats de protocole :

    La chaîne de connexion est une chaîne de connexion compatible avec le hub d’événements et vous pouvez l’utiliser dans votre application pour recevoir des événements de votre eventstream. La chaîne de connexion a plusieurs formats de protocole, que vous pouvez basculer et sélectionner sous l’onglet Clés. La chaîne de connexion ressemble à l’exemple suivant dans le format Event Hubs :

    Endpoint=sb://eventstream-xxxxxxxx.servicebus.windows.net/;SharedAccessKeyName=key_xxxxxxxx;SharedAccessKey=xxxxxxxx;EntityPath=es_xxxxxxxx

    Le format Event Hub est le format par défaut de la chaîne de connexion, et il est compatible avec le Kit de développement logiciel (SDK) Azure Event Hubs. Vous pouvez utiliser ce format pour vous connecter à Eventstream à l’aide du protocole Event Hubs.

    Capture d’écran des détails de l’application personnalisée.

    Les deux autres formats de protocole sont AMQP et Kafka, que vous pouvez sélectionner en cliquant sur les onglets correspondants dans l’onglet Clés.

    Le format AMQP est compatible avec le protocole AMQP 1.0, qui est un protocole de messagerie standard qui prend en charge l’interopérabilité entre différentes plateformes et langues. Vous pouvez utiliser ce format pour vous connecter à Eventstream à l’aide du protocole AMQP.

    Le format Kafka est compatible avec le protocole Apache Kafka, qui est une plateforme de diffusion en continu distribuée populaire qui prend en charge le traitement des données à débit élevé et à faible latence. Vous pouvez utiliser ce format pour vous connecter à Eventstream à l’aide du protocole Kafka.

    Vous pouvez choisir le format de protocole adapté aux besoins et préférences de votre application, puis copier et coller la chaîne de connexion dans votre application. Vous pouvez également copier l’exemple de code que nous fournissons dans l’onglet Exemple de code ou y faire référence. Celui-ci montre comment envoyer ou recevoir des événements à l’aide de différents protocoles.

Contenu connexe

Pour savoir comment ajouter d’autres sources à un Eventstream, consultez les articles suivants :

Pour ajouter une destination à un Eventstream, consultez les articles suivants :