Compartir a través de

Adición de un punto de conexión personalizado o un origen de aplicación personalizado a una secuencia de eventos

Si desea conectar su propia aplicación con una secuencia de eventos, puede agregar un punto de conexión personalizado o una aplicación personalizada como origen. A continuación, puede enviar eventos en tiempo real a la secuencia de eventos desde su propia aplicación con el punto de conexión expuesto en el punto de conexión personalizado o en la aplicación personalizada. Además, con el protocolo Apache Kafka disponible como opción para puntos de conexión personalizados o aplicaciones personalizadas, puede enviar eventos en tiempo real mediante el protocolo Apache Kafka.

En este artículo se muestra cómo agregar un origen de punto de conexión personalizado o un origen de aplicación personalizado a una secuencia de eventos en secuencias de eventos de Microsoft Fabric.

Nota:

Las funcionalidades mejoradas se habilitan de manera predeterminada al crear flujos de eventos ahora. Si tienes flujos de eventos creados con funcionalidades estándar, esos flujos de eventos seguirán funcionando. Todavía puedes editarlos y usarlos como de costumbre. Se recomienda crear un flujo de eventos para reemplazar los flujos de eventos estándar a fin de que puedas aprovechar las funcionalidades adicionales y las ventajas de los flujos de eventos mejorados.

Requisitos previos

Antes de empezar, asegúrese de que tiene acceso al área de trabajo donde se encuentra la secuencia de eventos. El área de trabajo debe estar en modo de prueba o capacidad de Fabric.

  • Se requieren permisos de colaborador o superior para editar la secuencia de eventos para agregar un origen de punto de conexión personalizado.
  • Si desea usar la autenticación de Entra ID para conectar su aplicación, necesita permisos de miembro o más altos.

Si usa la autenticación Entra ID, también debe asegurarse de que la identidad administrada del punto de conexión personalizado tenga los permisos necesarios. Para ello, configure los valores necesarios en el portal de administración:

  1. Seleccione Configuración (icono de engranaje) en la esquina superior derecha.

  2. Seleccione Portal de administración en la sección Gobernanza e información .

    Captura de pantalla que muestra la selección del vínculo del portal de administración en la sección Gobernanza e información.

  3. Active la siguiente configuración de inquilino para conceder al principal de servicio acceso a las API de Fabric para crear espacios de trabajo, conexiones o canalizaciones de implementación.

    • En la página Configuración del inquilino, en la sección Configuración del desarrollador, expanda la opción El principal de servicio puede usar la API de Fabric.
    • Cambie a Habilitado.
    • Se aplica a toda la organización.
    • Selecciona Aplicar.

    Captura de pantalla que muestra la configuración del desarrollador.

  4. Habilite esta opción para acceder a todas las demás API (habilitadas de forma predeterminada para los nuevos inquilinos):

    • Todavía en la página Configuración del arrendatario, expanda la opción Permitir que los principales de servicio creen y usen perfiles.
    • Cambie a Habilitado.
    • Se aplica a toda la organización.
    • Selecciona Aplicar.

Nota:

Una secuencia de eventos puede admitir hasta 11 orígenes y destinos combinados cuando se usan los siguientes tipos:

  • Orígenes: Azure Event Hubs, IoT Hub y puntos de conexión personalizados.
  • Destinos: puntos de conexión personalizados y Eventhouse con ingesta directa.

Los orígenes o destinos no incluidos en la lista anterior y los destinos no anexados a la secuencia predeterminada no cuentan hacia este límite.

Adición de datos de punto de conexión personalizados como origen

  1. Para agregar un origen de punto de conexión personalizado, en la página de introducción, seleccione Usar punto de conexión personalizado. O bien, si ya tiene una secuencia de eventos publicada y quiere agregar datos de punto de conexión personalizados como origen, cambie al modo de edición. En la cinta de opciones, seleccione Agregar origen>punto de conexión personalizado.

    Captura de pantalla de la opción para usar un punto de conexión personalizado.

  2. En el cuadro de diálogo Punto de conexión personalizado, escriba un nombre para el origen personalizado en Nombre de origeny, a continuación, seleccione Agregar.

    Captura de pantalla del cuadro de diálogo para agregar un punto de conexión personalizado.

  3. Después de crear el origen del punto de conexión personalizado, se agrega a su secuencia de eventos en el lienzo en modo de edición. Para implementar los datos recién agregados desde el origen de la aplicación personalizada, seleccione Publicar.

    Captura de pantalla que muestra la secuencia de eventos en modo de edición, con el botón Publicar resaltado.

Nota:

Una secuencia de eventos puede admitir hasta 11 orígenes y destinos combinados cuando se usan los siguientes tipos:

  • Orígenes: Azure Event Hubs, IoT Hub y puntos de conexión personalizados.
  • Destinos: puntos de conexión personalizados y Eventhouse con ingesta directa.

Los orígenes o destinos no incluidos en la lista anterior y los destinos no anexados a la secuencia predeterminada no cuentan hacia este límite.

Obtención de detalles del punto de conexión en el panel Detalles

Después de crear un origen de punto de conexión personalizado, sus datos están disponibles para la visualización en la vista dinámica.

Captura de pantalla que muestra la secuencia de eventos en la vista en directo.

El panel Detalles tiene tres pestañas de protocolo: Centro de eventos, AMQP y Kafka. Cada pestaña de protocolo tiene tres páginas: Básica y Autenticación de clave SAS. Estas páginas ofrecen los detalles del punto de conexión con el protocolo correspondiente para conectarse.

Básico muestra el nombre, el tipo y el estado del punto de conexión personalizado.

Captura de pantalla que muestra información básica en el panel Detalles de la vista en directo de la secuencia de eventos.

La página Autenticación de clave SAS proporciona información sobre las claves de conexión y también un vínculo al código de ejemplo, con las claves correspondientes incrustadas, que puede usar para transmitir los eventos a la secuencia de eventos. La información de la página Claves varía según el protocolo.

Centro de eventos

La página Autenticación de clave SAS de la pestaña Centro de eventos contiene información relacionada con la cadena de conexión de un centro de eventos. La información incluye Nombre del centro de eventos, Nombre de clave de acceso compartido, Clave principal, Clave secundaria, Clave principal de cadena de conexión, Clave secundaria de cadena de conexión.

Captura de pantalla que muestra información clave en el panel Detalles de la secuencia de eventos.

El formato del centro de eventos es el valor predeterminado para la cadena de conexión y funciona con el SDK de Azure Event Hubs. Este formato le permite conectarse a la secuencia de eventos a través del protocolo Event Hubs.

En el ejemplo siguiente se muestra el aspecto de la cadena de conexión en formato de centro de eventos:

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

Si selecciona el botón Mostrar código de ejemplo, verá el código Java listo para usar que incluye la información necesaria sobre las claves de conexión en el centro de eventos. Copie y péguelo en la aplicación para su uso.

Captura de pantalla que muestra el código de ejemplo en el panel Detalles de la vista en directo de eventstream.

Protocolo de Enrutamiento de Mensajes Avanzado (AMQP)

El formato AMQP es compatible con el protocolo AMQP 1.0, que es un protocolo de mensajería estándar que admite la interoperabilidad entre varias plataformas y lenguajes. Puede usar este formato para conectarse a la secuencia de eventos mediante el protocolo AMQP.

Captura de pantalla que muestra las claves AMQP en el panel Detalles de la vista en directo de la secuencia de eventos.

Al seleccionar el botón Mostrar código de ejemplo, verá el código Java listo para usar con información de clave de conexión en formato AMQP.

Captura de pantalla que muestra el código de ejemplo de AMQP en el panel Detalles de la vista en vivo de eventstream.

Kafka

El formato Kafka es compatible con el protocolo Apache Kafka, que es una plataforma de streaming distribuida popular que admite el procesamiento de datos de alto rendimiento y baja latencia. Puede usar la información de autenticación de clave SAS del formato del protocolo Kafka para conectarse a la secuencia de eventos y transmitir los eventos.

Captura de pantalla que muestra las claves de Kafka en el panel Detalles de la vista en directo de la secuencia de eventos.

Al seleccionar el botón Mostrar código de ejemplo, verá el código Java listo para usar, incluidas las claves de conexión necesarias en formato Kafka. Cópielo para su uso.

Captura de pantalla que muestra el código de ejemplo de Kafka en el panel Detalles de la vista en directo de eventstream.

Para obtener una guía clara sobre el uso del punto de conexión personalizado con el protocolo Kafka, consulte este tutorial. Proporciona pasos detallados para transmitir y consumir eventos mediante el punto de conexión personalizado con el protocolo Kafka.

Nota:

  • Puede elegir el formato de protocolo que se adapte a sus necesidades y preferencias de la aplicación y, a continuación, copiar y pegar la cadena de conexión en la aplicación. También puede hacer referencia a o copiar el código de ejemplo, que muestra cómo enviar o recibir eventos mediante varios protocolos.
  • Para salir de la vista de código de ejemplo, seleccione Ocultar código de ejemplo.

Contenido relacionado

Para obtener una lista de orígenes admitidos, consulta Incorporación de un origen del evento en un flujo de eventos.

Requisitos previos

  • Acceso a un área de trabajo en el modo de licencia de capacidad de Fabric (o) el modo de licencia de prueba con los permisos Colaborador o superior.
  • Si no tiene una secuencia de eventos, crear una secuencia de eventos.

Adición de una aplicación personalizada como origen

Si desea conectar su propia aplicación con un eventstream, puede agregar un origen de aplicación personalizado. A continuación, envíe datos a la secuencia de eventos desde su propia aplicación con el punto de conexión expuesto en la aplicación personalizada.

Para agregar un origen de aplicación personalizado:

  1. Seleccione Nuevo origen en la cinta o el signo más (+ ) en el lienzo principal del editor y después seleccione Aplicación personalizada.

  2. En el panel Aplicación personalizada escriba un nombre de origen para la aplicación personalizada y, a continuación, seleccione Agregar.

    Captura de pantalla que muestra el panel para configurar una aplicación personalizada como origen.

Obtención de detalles del punto de conexión en el panel Detalles para enviar eventos

Después de crear correctamente la aplicación personalizada como origen, puede ver la información en el panelDetalles.

El panel Detalles tiene tres pestañas de protocolo: Centro de eventos, AMQP y Kafka. Cada pestaña de protocolo contiene tres páginas: Basic, SAS Key Authentication y Entra ID Authentication. Estas páginas proporcionan información de punto de conexión específica del protocolo seleccionado. Captura de pantalla que muestra un origen de aplicación personalizado.

  • En la página Básico se muestra el nombre, el tipo y el estado del punto de conexión personalizado.

Captura de pantalla que muestra información básica para una aplicación personalizada en el panel Detalles de una secuencia de eventos.

  • La autenticación de clave SAS y la autenticación de id. entra son dos métodos de autenticación compatibles para conectarse a la aplicación:
    • La autenticación de clave SAS proporciona la información necesaria para generar y consumir datos de Eventstream mediante claves de firma de acceso compartido (SAS).
    • Entra ID Authentication permite que una entidad de seguridad (como un usuario o una entidad de servicio) consuma datos de Eventstream mediante la autenticación de Microsoft Entra ID.

Para conocer los pasos para usar Entra ID Authentication, consulte Habilitación de Entra ID Authentication para una aplicación en Eventstream.
En la sección siguiente se describe cómo conectarse a un destino de punto de conexión personalizado mediante la autenticación de clave SAS.

Centro de eventos

La página Claves de la pestaña Centro de eventos contiene información relacionada con la cadena de conexión de un centro de eventos. La información incluye Nombre del centro de eventos, Nombre de clave de acceso compartido, Clave principaly Clave principal de cadena de conexión.

Captura de pantalla que muestra información clave en el panel Detalles de la secuencia de eventos.

El formato del centro de eventos es el valor predeterminado para la cadena de conexión y funciona con el SDK de Azure Event Hubs. Este formato le permite conectarse a la secuencia de eventos a través del protocolo Event Hubs.

En el ejemplo siguiente se muestra el aspecto de la cadena de conexión en formato de centro de eventos:

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

Seleccione el botón Mostrar código de ejemplo en la página centro de eventos para preparar el código que incluye la información necesaria sobre las claves de conexión en el centro de eventos. Simplemente copie y péguelo en la aplicación para su uso.

Captura de pantalla que muestra el código de ejemplo en el panel Detalles de la secuencia de eventos.

Kafka

El formato Kafka es compatible con el protocolo Apache Kafka, que es una plataforma de streaming distribuida popular que admite el procesamiento de datos de alto rendimiento y baja latencia. Puede usar la información de claves y código de ejemplo del formato del protocolo Kafka para conectarse a la secuencia de eventos y transmitir los eventos.

Captura de pantalla que muestra las claves de Kafka en el panel Detalles de la secuencia de eventos.

Seleccione el botón Mostrar código de ejemplo en la página de Kafka para preparar el código, incluidas las claves de conexión necesarias en formato Kafka. Simplemente cópielo para su uso.

Captura de pantalla que muestra el código de ejemplo de Kafka en el panel Detalles de la secuencia de eventos.

AMQP

El formato AMQP es compatible con el protocolo AMQP 1.0, que es un protocolo de mensajería estándar que admite la interoperabilidad entre varias plataformas y lenguajes. Puede usar este formato para conectarse a la secuencia de eventos mediante el protocolo AMQP.

Captura de pantalla que muestra las claves AMQP en el panel Detalles de la secuencia de eventos.

Seleccione el botón Mostrar código de ejemplo en la página AMQP para prepararse para usar código con información de clave de conexión en formato AMQP.

Captura de pantalla que muestra el código de ejemplo de AMQP en el panel Detalles de la secuencia de eventos.

Puede elegir el formato de protocolo que se adapte a sus necesidades y preferencias de la aplicación y, a continuación, copiar y pegar la cadena de conexión en la aplicación. También puede hacer referencia a o copiar el código de ejemplo en la página Código de ejemplo, que muestra cómo enviar o recibir eventos mediante varios protocolos.

Contenido relacionado

Para obtener información sobre cómo agregar otros orígenes a Eventstream, consulte los siguientes artículos: