Compartir a través de


Adición de un destino de base de datos KQL a Eventstream

En este artículo se muestra cómo agregar una base de datos KQL como destino a Eventstream en la secuencia de eventos de Microsoft Fabric.

Nota:

Si quiere usar funcionalidades mejoradas que están en versión preliminar, seleccione Funcionalidades mejoradas en la parte superior. De lo contrario, seleccione Funcionalidades estándar. Para obtener información sobre las funcionalidades mejoradas que se encuentran en versión preliminar, vea Introducción a los flujos de eventos de Fabric.

Requisitos previos

  • Acceda al área de trabajo Premium de Fabric donde se encuentran sus secuencias de eventos con los permisos de Colaborador o superiores.
  • Acceso a una base de datos KQL creada en un área de trabajo Premium de Fabric en la que tiene permisos de Colaborador o superior.

Nota:

El número máximo de orígenes y destinos para una secuencia de eventos es 11.

Agregar una base de datos KQL como destino

Para agregar una base de datos KQL como destino, puede elegir entre dos modos de ingesta: Ingesta directa o Procesamiento de eventos antes de la ingesta.

Modo de ingesta directa

El modo de ingesta directa ingiere los datos del evento directamente en la base de datos KQL sin ningún procesamiento. Puede usar el modo de ingesta directa para agregar un destino de base de datos KQL a la secuencia predeterminada.

Importante

Solo puede usar la ingesta directa para la secuencia predeterminada. La ingesta directa no puede seguir procesando operadores ni secuencias derivadas. Si desea agregar un destino de base de datos KQL después de procesar operadores o secuencias derivadas, use el Procesamiento de eventos antes de la ingesta.

  1. En Modo de edición para Eventstream, seleccione Agregar destino en la cinta de opciones o seleccione la tarjeta Transformar eventos o agregar destino en el lienzo y, a continuación, seleccione Base de datos KQL.

    Captura de pantalla de la selección de la base de datos KQL en la lista desplegable Agregar destino.

  2. En la pantalla Base de datos KQL, seleccione Ingesta directa.

  3. Escriba un nombre de destino, seleccione un área de trabajo y elija una base de datos KQL del área de trabajo seleccionada.

  4. Seleccione Guardar.

    Captura de pantalla de la configuración de base de datos KQL.

  5. Conecte la nueva tarjeta de destino de la base de datos KQL a la salida de Eventstream si aún no está conectada y, a continuación, seleccione Publicar.

    Captura de pantalla de Eventstream con el botón Publicar resaltado.

  6. En la Vista en vivo, seleccione Configurar en el nodo de destino de la base de datos KQL.

    Captura de pantalla de la secuencia de eventos publicada con el botón Configurar en el destino de la base de datos KQL resaltado.

  7. La base de datos KQL se abre en la pantalla Obtener datos. Seleccione una tabla existente de la base de datos KQL o seleccione Nueva tabla para crear una nueva para enrutar e ingerir los datos.

  8. Proporcione un nombre de conexión de datos o mantenga el nombre proporcionado y, a continuación, seleccione Siguiente. Extraer datos de Eventstream puede tardar unos minutos.

    Captura de pantalla de la pantalla Obtener datos para el destino de la base de datos KQL, con el botón Siguiente resaltado.

  9. En la pantalla Inspeccionar los datos, puede hacer lo siguiente:

    • Seleccionar un formato de datos para obtener una vista preliminar de cómo se envían los datos a la base de datos KQL.
    • Seleccione Editar columnas para configurar las columnas de los datos.
    • Seleccione Opciones avanzadas para seleccionar eventos que se van a incluir o elegir las opciones de asignación.

    Captura de pantalla que muestra los formatos de datos y las opciones avanzadas en la pantalla Inspeccionar los datos.

  10. Si selecciona Editar columnas, en la pantalla Editar columnas podrá hacer lo siguiente:

    • Seleccionar Agregar columna para agregar una columna.
    • Seleccionar columnas de Origen para asignarlas.
    • Aplicar la transformación de asignación a las columnas.
    • Cambiar los valores de datos de muestra.

    Luego, seleccione Aplicar.

    Captura de la pantalla Editar columnas.

  11. Cuando haya terminado de configurar los datos, seleccione Finalizar en la pantalla Inspeccionar los datos.

  12. En la pantalla Resumen, revise los detalles y el estado de la ingesta de datos, incluida la tabla creada con el esquema definido, y la conexión entre la secuencia de eventos y la base de datos KQL. Seleccione Cerrar para finalizar la configuración de la base de datos KQL.

    Captura de la pantalla Resumen con el botón Cerrar resaltado.

Ahora puede ver el destino de la base de datos KQL en el lienzo en la Vista en vivo.

Captura de pantalla del destino de la base de datos KQL configurada en la Vista en vivo.

Procesamiento de eventos antes de la ingesta.

El modo de procesamiento de eventos antes de la ingesta procesa los datos del evento antes de ingerirlos en la base de datos KQL. Use este modo si aplica operadores como el filtrado o la agregación para procesar los datos antes de la ingesta o después de una secuencia derivada.

  1. En Modo de edición de Eventstream, pase el ratón por encima de un operador o secuencia derivada, seleccione +y, a continuación, seleccione Base de datos KQL.

    Captura de pantalla de la selección del símbolo + para la salida del operador y selección de la base de datos KQL.

  2. En la pantalla Base de datos KQL, el procesamiento de eventos antes de la ingesta ya debe estar seleccionado. Complete el resto de la información sobre la base de datos KQL y, a continuación, seleccione Guardar.

    Captura de la pantalla de configuración de la base de datos KQL para el procesamiento de eventos antes de la ingesta.

  3. Para implementar el destino de base de datos KQL recién agregado, seleccione Publicar.

    Captura de pantalla de Eventstream en modo de edición con el destino de la base de datos KQL agregado.

Una vez completados estos pasos, la secuencia de eventos con el destino de la base de datos KQL está disponible para su visualización en la Vista en vivo.

Captura de pantalla del flujo de procesamiento de eventos de base de datos KQL configurado en la Vista en vivo.

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

Requisitos previos

Para empezar, debe completar los siguientes requisitos previos:

  • Obtenga acceso a un área de trabajo Premium con los permisos Colaborador o superior donde se encuentra la secuencia de eventos.
  • Obtenga acceso a un área de trabajo Premium con los permisos Colaborador o superior donde se encuentra la base de datos KQL.

Nota:

El número máximo de orígenes y destinos para una secuencia de eventos es 11.

Agregar una base de datos KQL como destino

Para agregar una base de datos KQL como destino, debe tener una base de datos KQL creada en el área de trabajo y elegir entre dos modos de ingesta: Ingesta directa y Procesamiento de eventos antes de la ingesta.

Ingesta directa

Este modo ingiere los datos del evento directamente en la base de datos KQL sin ningún procesamiento. Puede usar este modo si desea ingerir los datos de eventos tal como están y realizar cualquier procesamiento o transformación más adelante en la base de datos KQL mediante consultas KQL.

  1. Seleccione Nuevo destino en la cinta o "+" en el lienzo principal del editor y después seleccione Base de datos KQL. Aparece la pantalla que muestra la configuración de destino de base de datos KQL.

  2. Seleccione Ingesta directa, escriba un nombre de destino, seleccione un área de trabajo, elija una base de datos KQL del área de trabajo seleccionada y luego seleccione Agregar y configurar.

    Nota:

    Solo puede seleccionar áreas de trabajo que tengan la misma capacidad de región de Fabric que la secuencia de eventos.

    Captura de pantalla de la configuración de destino en modo de extracción de la base de datos KQL.

  3. En la página Obtener datos, desplácese por las pestañas para completar la configuración:

    1. Configurar: utilice una tabla existente de la base de datos KQL o cree una nueva para enrutar e ingerir los datos. Rellene los campos obligatorios y seleccione Siguiente.

      Captura de pantalla que muestra la pestaña Destino de la pantalla Ingerir datos para crear un destino de base de datos KQL.

    2. Inspeccionar: seleccione un formato de datos y obtenga una vista previa de cómo se envían los datos a la base de datos KQL.

      Captura de pantalla que muestra el formato de datos de la pantalla Ingerir datos para crear un destino de base de datos KQL.

      También puede cambiar el nombre de la columna, el tipo de datos o la columna de actualización haciendo clic en la flecha del encabezado de tabla. Rellene los campos obligatorios y seleccione Finalizar.

      Captura de pantalla que muestra cómo cambiar la columna de la pantalla Ingerir datos para crear un destino de base de datos KQL.

      Captura de pantalla que muestra el cambio de nombre de la columna y el tipo de datos de la pantalla Ingerir datos para crear un destino de base de datos KQL.

    3. Resumen: revise el estado de la ingesta de datos, incluida la tabla creada con el esquema definido, y la conexión entre la secuencia de eventos y la base de datos KQL.

      Captura de pantalla que muestra la pestaña Resumen de la pantalla Ingerir datos para crear un destino de base de datos KQL.

  4. Después de configurar todo y seleccionar Cerrar, aparece un destino de base de datos KQL en el lienzo, conectado a la secuencia de eventos.

    Captura de pantalla que muestra el destino en modo de extracción de la nueva base de datos KQL.

Procesamiento de eventos antes de la ingesta.

Este modo procesa los datos del evento antes de ingerirlos en la base de datos KQL. Puede usar este modo si desea aplicar algún procesamiento o transformación a los datos de eventos antes de ingerirlos, como el filtrado, la agregación o la expansión. Puede diseñar la lógica de procesamiento mediante el procesador de eventos.

  1. Seleccione Procesamiento de eventos antes de la ingesta, complete la información sobre la base de datos KQL y, a continuación, seleccione Abrir procesador de eventos.

    Captura de pantalla de la configuración de destino en modo de extracción de la base de datos KQL.

  2. Diseñe el procesamiento de eventos con el procesador de eventos y, a continuación, seleccione Guardar.

    Captura de pantalla del procesador de eventos en modo de inserción.

  3. Al elegir una tabla de Kusto existente, se realiza la validación de esquemas entre el esquema actual en este eventstream y la tabla KQL de destino. Si los dos esquemas no coinciden, se muestra un mensaje de error y se le recuerda que debe abrir el procesador de eventos para ajustar el esquema en esta secuencia de eventos en consecuencia.

    Captura de pantalla de error del procesador de eventos en modo de inserción.

    Al abrir el procesador de eventos, la información detallada del error de coincidencia se mostrará en la pestaña Error de creación.

    Captura de pantalla del error de coincidencia de información del procesador de eventos en modo de inserción.

  4. Después de configurar todo y seleccionar Guardar, aparece un destino de base de datos KQL en el lienzo, conectado al evenstream y puede comprobar las métricas en Información de datos y los registros en Registros en tiempo de ejecución.

    Captura de pantalla que muestra el destino en modo de inserción de la nueva base de datos KQL.

Administrar un destino

Editar o quitar: puede editar o eliminar un destino de la secuencia de eventos a través del panel de navegación o del lienzo.

Al seleccionar Editar, el panel de edición se abre a la derecha del editor principal. Puede modificar la configuración como desee, incluida la lógica de transformación de eventos a través del editor del procesador de eventos.

Captura de pantalla que muestra dónde seleccionar las opciones de modificación y eliminación para los destinos en el lienzo.

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