Compartir a través de

Inicio rápido: Ingesta de datos mediante canalizaciones de Azure Synapse (versión preliminar)

Importante

El Explorador de datos de Azure Synapse Analytics (versión preliminar) se retirará el 7 de octubre de 2025. Después de esta fecha, se eliminarán las cargas de trabajo que se ejecutan en el Explorador de datos de Synapse y se perderán los datos de la aplicación asociados. Se recomienda migrar a Eventhouse en Microsoft Fabric.

El programa Microsoft Cloud Migration Factory (CMF) está diseñado para ayudar a los clientes a migrar a Fabric. El programa ofrece recursos de teclado prácticos sin costo alguno al cliente. Estos recursos se asignan durante un período de 6 a 8 semanas, con un ámbito predefinido y acordado. Las nominaciones de clientes se aceptan por parte del equipo de la cuenta de Microsoft o directamente enviando una solicitud de ayuda al equipo de CMF.

En este inicio rápido, aprenderá a cargar datos de un origen de datos en un grupo del Explorador de datos de Azure Synapse.

Prerrequisitos

  • Una suscripción de Azure. Cree una cuenta de Azure gratuita.

  • Creación de un grupo de Data Explorer mediante Synapse Studio o Azure Portal

  • Cree una base de datos de Data Explorer.

    1. En Synapse Studio, en el panel izquierdo, seleccione Datos.

    2. Seleccione + (Agregar un recurso nuevo) >Grupo de explorador de datos, y use la siguiente información:

      Configuración Valor sugerido Descripción
      Nombre de la piscina contosodataexplorer Nombre del grupo de Data Explorer que se usará.
      Nombre TestDatabase El nombre de la base de datos debe ser único dentro del clúster.
      Período de retención predeterminado 365 El intervalo de tiempo (en días) para el que se garantiza que los datos se mantengan disponibles para consultarlos. El intervalo de tiempo se mide desde el momento en que se ingieren los datos.
      Período de caché predeterminado 31 El intervalo de tiempo (en días) durante el que los datos consultados con frecuencia se van a mantener disponibles en el almacenamiento SSD o en la RAM, en lugar de en el almacenamiento a largo plazo.

    3. Seleccione Crear para crear la base de datos. La creación normalmente tarda menos de un minuto.

  • Creación de una tabla

    1. En Synapse Studio, en el panel izquierdo, seleccione Desarrollar.
    2. En Scripts de KQL, seleccione + (Agregar un recurso nuevo) >Script de KQL. En el panel derecho, puede asignar un nombre al script.
    3. En el menú Conectarse a, seleccione contosodataexplorer.
    4. En el menú Use database (Usar base de datos), seleccione TestDatabase.
    5. Pegue el siguiente comando y seleccione Ejecutar para crear la tabla.
    .create table StormEvents (StartTime: datetime, EndTime: datetime, EpisodeId: int, EventId: int, State: string, EventType: string, InjuriesDirect: int, InjuriesIndirect: int, DeathsDirect: int, DeathsIndirect: int, DamageProperty: int, DamageCrops: int, Source: string, BeginLocation: string, EndLocation: string, BeginLat: real, BeginLon: real, EndLat: real, EndLon: real, EpisodeNarrative: string, EventNarrative: string, StormSummary: dynamic)

    Sugerencia

    Compruebe que la tabla se creó correctamente. En el panel izquierdo, seleccione Datos, elija contosodataexplorer en el menú Más y seleccione Actualizar. En contosodataexplorer, expanda Tablas y asegúrese de que la tabla StormEvents aparece en la lista.

  • Obtenga los puntos de conexión de consulta e ingesta de datos. Necesitará el punto de conexión de consulta para configurar el servicio vinculado.

    1. En Synapse Studio, en el panel izquierdo, seleccione Administrar>Grupos exploradores de datos.

    2. Seleccione el grupo de Data Explorer que desea usar para ver sus detalles.

      Captura de pantalla de la pantalla Grupos de Data Explorer, en la que se muestra la lista de grupos existentes.

    3. Anote los puntos de conexión de ingesta de datos y consulta. Utilice el punto de conexión de consulta como clúster al configurar las conexiones con el grupo explorador de datos. Al configurar los SDK para la ingesta de datos, use el punto de conexión de ingesta de datos.

      Captura de pantalla del panel de propiedades de los grupos de Data Explorer, en la que se muestran las direcciones URI de ingesta de datos y consulta.

Creación de un servicio vinculado

En Azure Synapse Analytics, un servicio vinculado es donde se define la información de conexión a otros servicios. En esta sección, creará un servicio vinculado para Azure Data Explorer.

  1. En Synapse Studio, en el panel izquierdo, seleccione Administrar>servicios vinculados.

  2. Seleccione + Nuevo.

    Captura de pantalla de la pantalla Servicios vinculados, en la que se muestra la lista de servicios existentes y se resalta el botón Agregar nuevo.

  3. Seleccione el servicio Azure Data Explorer en la galería y, a continuación, seleccione Continuar.

    Captura de pantalla del nuevo panel Servicios vinculados, en la que se muestra la lista de servicios disponibles y se resalta el nuevo servicio Azure Data Explorer.

  4. En la página New Linked Services (Nuevos servicios vinculados), use la siguiente información:

    Configuración Valor sugerido Descripción
    Nombre contosodataexplorerlinkedservice Nombre del nuevo servicio vinculado de Azure Data Explorer.
    Método de autenticación Identidad administrada Método de autenticación para el nuevo servicio.
    Método de selección de cuenta Escribir manualmente Método para especificar el extremo de la consulta.
    Punto final https://contosodataexplorer.contosoanalytics.dev.kusto.windows.net Punto de conexión de consulta que anotó anteriormente.
    Base de datos TestDatabase Base de datos en la que desea ingerir datos.

    Captura de pantalla del nuevo panel de detalles de servicios vinculados, en la que se muestran los campos que deben completarse para el nuevo servicio.

  5. Seleccione Probar conexión para validar la configuración y, después, seleccione Crear.

Creación de una canalización para ingerir datos

Una canalización contiene el flujo lógico para una ejecución de un conjunto de actividades. En esta sección, creará una canalización que contiene una actividad de copia que ingiere datos desde un origen de su elección en un grupo del Explorador de datos.

  1. En Synapse Studio, en el panel izquierdo, seleccione Integrar.

  2. Seleccione +>Pipeline. En el panel derecho, puede asignar un nombre a la canalización.

    Captura de pantalla que muestra la selección para crear una nueva tubería.

  3. En Actividades>Move & transform (Mover y transformar), arrastre Copiar datos en el lienzo de la canalización.

  4. Seleccione la actividad de copia y vaya a la pestaña Origen . Seleccione o cree un nuevo conjunto de datos de origen como origen desde el que copiar datos.

  5. Haga clic en la pestaña Receptor. Seleccione Nuevo para crear un conjunto de datos de receptor.

    Captura de pantalla de la actividad de copia de canalización, en la que se muestra la selección para crear un nuevo receptor.

  6. Seleccione el conjunto de datos de Azure Data Explorer en la galería y, a continuación, seleccione Continuar.

  7. En el panel Establecer propiedades , use la siguiente información y, a continuación, seleccione Aceptar.

    Configuración Valor sugerido Descripción
    Nombre AzureDataExplorerTable Nombre de la nueva canalización.
    Servicio vinculado contosodataexplorerlinkedservice El servicio vinculado que creó anteriormente.
    Tabla StormEvents La tabla que creaste anteriormente.

    Recorte de pantalla del panel de propiedades del conjunto de actividades de copia de la canalización, en el que se muestran los campos que deben completarse para el nuevo receptor.

  8. Para validar la canalización, seleccione Validar en la barra de herramientas. Verá el resultado de la salida de validación de canalización en el lado derecho de la página.

Depuración y publicación de la canalización

Una vez que haya terminado de configurar la canalización, puede ejecutar una depuración antes de publicar los artefactos para verificar que todo esté correcto.

  1. Seleccione Depurar en la barra de herramientas. Verá el estado de ejecución de la canalización en la pestaña Output (Salida) en la parte inferior de la ventana.

  2. Una vez que la ejecución de la canalización se realiza correctamente, en la barra de herramientas superior, seleccione Publicar todo. Esta acción publica entidades (conjuntos de datos y canalizaciones) que creó en el servicio Synapse Analytics.

  3. Espere a que aparezca el mensaje Successfully published (Publicado correctamente). Para ver los mensajes de notificación, seleccione el botón de campana en la parte superior derecha.

Activación y supervisión de la canalización

En esta sección, desencadenará manualmente la canalización publicada en el paso anterior.

  1. Seleccione Add Trigger (Agregar desencadenador) en la barra de herramientas y, después, seleccione Trigger Now (Desencadenar ahora). En la página Pipeline Run (Ejecución de la canalización), seleccione OK (Aceptar).

  2. Vaya a la pestaña Supervisar que se encuentra en la barra lateral izquierda. Verá una ejecución de canalización que se desencadena de forma manual.

  3. Cuando la ejecución de la canalización se complete correctamente, seleccione el vínculo en la columna Nombre de canalización para ver los detalles de ejecución de la actividad o para volver a ejecutar la canalización. En este ejemplo, solo hay una actividad, así que solo verá una entrada en la lista.

  4. Para más información sobre la operación de copia, seleccione el vínculo Details (Detalles) (icono de gafas) en la columna Activity name (Nombre de actividad). Puede supervisar detalles como el volumen de datos copiados desde el origen al receptor, el rendimiento de los datos, los pasos de ejecución con su duración correspondiente y las configuraciones que se utilizan.

  5. Para volver a la vista de ejecuciones de canalización, seleccione el vínculo Todas las ejecuciones de la canalización. Seleccione Refresh (Actualizar) para actualizar la lista.

  6. Compruebe que los datos están escritos correctamente en el grupo de Data Explorer.

Pasos siguientes