Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 Microsoft Fabric.
Requisitos previos
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.
Permisos de colaborador o superior para editar la secuencia de eventos y agregar un punto de conexión personalizado como origen.
Permisos para la autenticación de Microsoft Entra
Si desea usar la autenticación de Microsoft Entra para conectar la aplicación, necesita permisos de miembro o superior.
También debe asegurarse de que la identidad administrada del punto de conexión personalizado tiene los permisos necesarios. Configure las opciones en el portal de administración:
En la esquina superior derecha, seleccione Configuración (icono de engranaje).
En Gobernanza e información, seleccione Portal de administración.
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 Las entidades de servicio pueden usar las API de Fabric.
- Establezca el control de alternancia en Habilitado.
- En Aplicar a, seleccione Toda la organización.
- Selecciona Aplicar.
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.
- Establezca el control de alternancia en Habilitado.
- En Aplicar a, seleccione Toda la organización.
- Selecciona Aplicar.
Adición de datos de punto de conexión personalizados como origen
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.
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.
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.
Nota:
Una secuencia de eventos puede admitir hasta 11 orígenes y destinos combinados solo cuando se usan los siguientes tipos:
- Origen: punto de conexión personalizado.
- Destinos: punto de conexión personalizado y centro de eventos con ingesta directa.
Los orígenes o destinos que no se incluyen en la lista anterior y los destinos que no se anexan a la secuencia predeterminada, no cuentan hacia este límite.
Adición de datos de punto de conexión personalizados como origen
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.
En la página Añadir origen, seleccione Activar para Asociación de Esquema y, a continuación, seleccione Añadir.
En el editor, para asociar con un nuevo esquema o un esquema existente de un registro de esquemas, seleccione Asociar esquema de eventos en la cinta de opciones.
Para usar un esquema existente, seleccione Elegir entre el registro de esquemas de eventos y siga estos pasos:
En el cuadro de diálogo Asociar un esquema de eventos , seleccione un esquema en el Registro de esquemas. El esquema de datos de eventos aparece en el panel derecho.
Seleccione Elegir para asociar el esquema de eventos al punto de conexión personalizado.
En el editor de eventstream, seleccione el icono eventstream . En el panel inferior, cambie a la pestaña Esquema asociado . Confirme que el esquema está asociado a eventstream.
Use una de las siguientes opciones para crear un esquema:
Si tiene un archivo JSON de esquema, seleccione Cargar para cargar el archivo. Para obtener un archivo de ejemplo, consulte Descarga de un esquema de eventos.
Para empezar a compilar un esquema manualmente, seleccione Agregar fila. Para cada fila, seleccione el tipo de campo, seleccione el nombre del campo y, opcionalmente, escriba una descripción.
Para compilar un esquema escribiendo código JSON, seleccione la opción Editor de código . Si aparece el mensaje Si decide usar el editor de código para crear su esquema, tenga en cuenta que no podrá cambiar al constructor de interfaz de usuario, seleccione Editar.
Escriba el código JSON en el editor.
Nota:
Una secuencia de eventos puede admitir hasta 11 orígenes y destinos combinados solo cuando se usan los siguientes tipos:
- Origen: punto de conexión personalizado.
- Destinos: punto final personalizado y centro de eventos con ingestión directa.
Los orígenes o destinos que no se incluyen en la lista anterior y los destinos que no se anexan 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.
El panel Detalles tiene tres pestañas de protocolo: Centro de eventos, AMQP y Kafka. Cada pestaña de protocolo tiene dos páginas que 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.
La autenticación de claves SAS proporciona información sobre las claves de conexión. También proporciona 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 esta página varía según el protocolo.
Centro de eventos
La pestaña Autenticación de clave SAS para el protocolo del centro de eventos contiene información relacionada con la cadena de conexión de un centro de eventos. La información incluye el nombre del centro de eventos, el nombre de la clave de acceso compartido, la clave principal, la clave secundaria, la clave principal de la cadena de conexión y la clave secundaria de la cadena de conexión.
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.
AMQP
El formato Advanced Message Queuing Protocol (AMQP) es compatible con 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.
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.
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.
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.
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.
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 cerrar la vista de código de ejemplo, seleccione Ocultar código de ejemplo.
Configuración de destinos de eventstream para usar esquemas
Actualmente, solo el centro de eventos, el punto de conexión personalizado y los destinos de flujo derivados son compatibles con las secuencias de eventos con características extendidas habilitadas. En esta sección se muestra cómo agregar y configurar un destino de centro de eventos cuando se habilitan las características extendidas (como la compatibilidad con esquemas) para la secuencia de eventos.
Configuración de un esquema para un destino de punto de conexión personalizado
Seleccione Transformar eventos o agregar destino y, a continuación, seleccione CustomEndpoint.
En el panel Punto de conexión personalizado , especifique un nombre para el destino.
En Esquema de entrada, seleccione el esquema para los eventos. Al habilitar la compatibilidad de esquemas para una secuencia de eventos, se realiza una selección en este cuadro.
Para obtener pasos detallados sobre cómo configurar un destino de punto de conexión personalizado, consulte Incorporación de un punto de conexión personalizado o un destino de aplicación personalizado a una secuencia de eventos.
Configuración de esquemas para un destino de eventhouse
Seleccione Transformar eventos o agregar destino y, a continuación, seleccione Eventhouse.
En el panel Eventhouse , configure las siguientes opciones relacionadas con el esquema:
En Esquema de entrada, seleccione uno o varios esquemas en la lista desplegable.
Nota:
Si seleccionó la opción Esquema dinámico a través de encabezados al configurar un origen de Event Hubs, es posible que haya configurado varios esquemas para el origen y los haya asignado a varias propiedades y sus valores.
En Método de creación de tablas, seleccione Una sola tabla con todos los esquemas combinados o Tablas independientes para cada esquema, en función de sus requisitos.
En Escribir datos con, seleccione una de las siguientes opciones:
- Solo datos de carga: Guarde los datos extraídos del payload en la tabla. Si hay varios esquemas de entrada, los datos se envían a varias tablas.
-
Metadatos y carga: incluya metadatos y datos de carga en una tabla única. Las columnas de ejemplo incluyen
source,subject,typeydata.
Para obtener pasos detallados sobre cómo configurar un destino de un centro de eventos, consulte Incorporación de un destino de un centro de eventos a una secuencia de eventos.
Contenido relacionado
- Para obtener una lista de orígenes admitidos, consulte Adición y administración de un origen de eventos en una secuencia de eventos.