Compartir a través de


Obtención de datos de Eventstream

En este artículo, aprenderá a obtener datos de una secuencia de eventos existente en una tabla nueva o existente.

Puede ingerir datos de flujos predeterminados o derivados. Para crear una secuencia derivada, agregue una serie de operaciones de flujo a la secuencia de eventos, como Filtrar o Administrar campos. Para más información, consulte Conceptos de Eventstream.

Para obtener datos de una nueva secuencia de eventos, consulte Obtener datos de una nueva secuencia de eventos.

Advertencia

  • No se admite la ingesta desde una secuencia de eventos mediante un vínculo privado .
  • La vista previa de datos de una secuencia de eventos con eventos de ejemplo grandes (10 MB o más) no se admite en el Asistente para obtener datos. Use eventos de ejemplo pequeños (aproximadamente 1 MB cada uno) para configurar la conexión de datos.

Prerrequisitos

Paso 1: Origen

Para obtener datos de una secuencia de eventos, seleccione la secuencia de eventos como origen de datos. Seleccione una secuencia de eventos de las maneras siguientes:

En la cinta de opciones de la base de datos KQL, elija entre:

  • En la opción Obtener datos de la cinta de opciones, seleccione el icono Eventstream .

  • En el menú desplegable Obtener datos, seleccione Eventstream>Existing Eventstream (Secuencia de eventos existente).

  • En el menú desplegable Obtener datos, seleccione centro de datos en tiempo real para seleccionar un flujo de eventos de la lista.

Paso 2: Configurar

  1. Seleccione una tabla de destino. Para ingerir datos en una nueva tabla, seleccione + Nueva tabla y escriba un nombre de tabla.

    Nota

    Los nombres de tabla pueden tener hasta 1,024 caracteres, entre los que se incluyen espacios, alfanuméricos, guiones y caracteres de subrayado. No se admiten caracteres especiales.

  2. En Configurar el origen de datos, complete la configuración con la información de la tabla siguiente:

    • Al seleccionar Eventstream como origen, especifique la Workspace, Eventstream y Stream predeterminado o derivado.

    Importante

    La característica para obtener datos de flujos derivados está en versión preliminar.

    Captura de pantalla de la pestaña configurar con una nueva tabla especificada y una secuencia de eventos seleccionada.

    • Al seleccionar Real-Time hub como origen, eliges una secuencia predeterminada o derivada de la lista, y Workspace, Eventstream y Stream se rellenan automáticamente y no requieren configuración.

    Captura de pantalla de la pestaña de configuración con la nueva tabla introducida y con los ajustes del origen de datos configurados como solo lectura.

    Valor Descripción
    Área de trabajo Ubicación del área de trabajo de eventstream. Seleccione un área de trabajo en la lista desplegable.
    Flujo de eventos Nombre de la secuencia de eventos. Seleccione una secuencia de eventos en la lista desplegable.
    Flujo Nombre de la secuencia predeterminada o derivada. Seleccione un flujo en la lista desplegable.
    * Para las secuencias predeterminadas, el formato de nombre de secuencia es Eventstream-stream.
    * Para las secuencias derivadas, el nombre se definió cuando se creó la secuencia.
    Procesar evento antes de la ingesta en Eventstream Esta opción permite configurar el procesamiento de datos antes de ingerir datos en la tabla de destino. Si está seleccionado, continuará el proceso de ingesta de datos en Eventstream. Para más información, vea Procesar evento antes de la ingesta en Eventstream.
    Nombre de la conexión de datos Nombre que se usa para hacer referencia y administrar la conexión de datos en el área de trabajo. El nombre de la conexión de datos se rellena automáticamente y puede editar el nombre para simplificar la administración de la conexión de datos en el área de trabajo. El nombre solo puede contener caracteres alfanuméricos, guiones y puntos, y tener hasta 40 caracteres de longitud.
  3. Seleccione Next (Siguiente) para continuar.


Procesar evento antes de la ingesta en Eventstream

El evento Process, antes de la ingesta en la opción Eventstream, le permite procesar los datos antes de que se ingresen en la tabla de destino. Con esta opción, el proceso de obtención de datos continúa sin problemas en Eventstream, con la tabla de destino y los detalles del origen de datos rellenados automáticamente.

Para procesar el evento antes de la ingesta en Eventstream:

  1. En la pestaña Configurar, seleccione Procesar evento antes de la ingesta en Eventstream.

  2. En el cuadro de diálogo Eventos de proceso en Eventstream, seleccione Continuar en Eventstream.

    Importante

    Al seleccionar Continuar en Eventstream finaliza el proceso de obtención de datos en Real-Time Intelligence y continúa en Eventstream con la tabla de destino y los detalles del origen de datos rellenados automáticamente.

    Captura de pantalla de los eventos de proceso en el cuadro de diálogo Eventstream.

  3. En Eventstream, seleccione el nodo de destino Base de datos KQL y, en el panel Base de datos KQL, compruebe que Procesamiento de eventos antes de la ingesta está seleccionado y que los detalles del destino sean correctos.

    Captura de pantalla de los eventos de proceso en la página Eventstream.

  4. Seleccione Abrir procesador de eventos para configurar el procesamiento de datos y, a continuación, seleccione Guardar. Para obtener más información, consulte Procesar datos de eventos con el editor de procesadores de eventos.

  5. De nuevo en el panel de base de datos KQL , selecciona Agregar para completar la configuración del nodo de destino de la base de datos KQL .

  6. Compruebe que los datos se ingieren en la tabla de destino.

Nota

El proceso Procesar evento antes de la ingesta en Eventstream está completo, y los pasos restantes de este artículo no son necesarios.

Paso 3: Inspeccionar

La pestaña Inspeccionar muestra una vista previa de los datos.

Seleccione Finalizar para completar el proceso de ingesta.

Captura de pantalla de la pestaña inspeccionar.

Opcional:

  • Use la lista desplegable tipo de archivo para explorar opciones avanzadas en función del tipo de datos.

  • Utiliza la lista desplegable Table_mapping para definir un nuevo mapeo.

  • Seleccione </> para abrir el visor de comandos para ver y copiar los comandos automáticos generados a partir de las entradas. También puede abrir los comandos en un conjunto de consultas.

  • Seleccione el icono de lápiz para editar columnas.

Editar columnas

Nota

  • En el caso de formatos tabulares (CSV, TSV, PSV), no se puede asignar una columna dos veces. Para asignar a una columna existente, elimine primero la nueva columna.
  • No se puede cambiar un tipo de columna existente. Si intenta asignar a una columna con otro formato, puede acabar con columnas vacías.

Los cambios que puede realizar en una tabla dependen de los parámetros siguientes:

  • El tipo de tabla es nuevo o existente
  • El tipo de mapeo es nuevo o existente
Tipo de tabla Tipo de mapeo Ajustes disponibles
Nueva tabla Nuevo mapeo Cambio del nombre de columna, cambio del tipo de datos, cambio del origen de datos, la transformaciones de asignación, adición de columna, eliminación de columna
Tabla existente Nuevo mapeo Agregar columna (en la que puede cambiar el tipo de datos, cambiar el nombre y actualizar)
Tabla existente Asignación existente ninguno

Captura de pantalla de las columnas abiertas para su edición.

Transformaciones de mapeo

Algunas de las asignaciones de formato de datos (Parquet, JSON y Avro) admiten transformaciones sencillas en el momento de la ingesta. Para aplicar transformaciones de asignación, cree o actualice una columna en la ventana Editar columnas.

Las transformaciones de asignación se pueden realizar en una columna de tipo string o datetime, con un origen con un tipo de datos int o long. Para obtener más información, consulte la lista completa de transformaciones de asignación admitidas.

Opciones avanzadas basadas en el tipo de datos

Tabular (CSV, TSV y PSV)::

  • Si está ingiriendo formatos tabulares en una tabla existente, puede seleccionar Mapeo_de_tabla>Usar asignación existente. Los datos tabulares no siempre incluyen los nombres de columna usados para asignar datos de origen a las columnas existentes. Cuando se activa esta opción, el mapeo se realiza por orden, y el esquema de la tabla permanece igual. Si esta opción está desactivada, se crean nuevas columnas para los datos entrantes, independientemente de la estructura de datos.

JSON:

  • Seleccione Niveles anidados para determinar la división de columnas de datos JSON, de 1 a 100.

Paso 4: Resumen

En la ventana Resumen , todos los pasos se marcan como completados cuando la ingesta de datos finaliza correctamente. Seleccione una tarjeta para explorar los datos, eliminar los datos ingeridos o crear un panel con métricas clave. Seleccione Cerrar para cerrar la ventana.

Captura de pantalla de la página de resumen que muestra la ingesta correcta de datos.