Share via

Tutorial: Realizar la ingesta del analizador de CSV

  • Artículo

La ingesta del analizador de valores separados por comas (CSV) proporciona la capacidad de ingerir archivos CSV en una instancia de Azure Data Manager for Energy.

En este tutorial, aprenderá a:

  • Ingesta de un archivo CSV de datos de Wellbore de ejemplo en una instancia de Azure Data Manager for Energy mediante Postman.
  • Búsqueda de registros de metadatos de almacenamiento creados durante la ingesta de CSV mediante Postman.

Requisitos previos

Antes de comenzar este tutorial, complete los siguientes requisitos previos.

Obtener detalles para la instancia de Azure Data Manager for Energy

  • Necesita una instancia de Azure Data Manager for Energy. Si aún no tiene una, créela siguiendo los pasos de Inicio rápido: Creación de instancias de Azure Data Manager for Energy.

  • Para este tutorial, necesitará los parámetros siguientes:

    Parámetro Valor que se usará Ejemplo Dónde encontrar este valor
    CLIENT_ID Id. de aplicación (cliente) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Este id. de cliente o aplicación se usa al registrar la aplicación con la plataforma de identidad de Microsoft. Consulte Registrar una aplicación.
    CLIENT_SECRET Secretos de cliente _fl****************** El secreto de cliente, a veces denominado contraseña de aplicación, es un valor de cadena que la aplicación puede usar en lugar de un certificado a fin de identificarse. Consulte Agregar un secreto de cliente.
    TENANT_ID Id. de directorio (inquilino) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Mantenga el puntero sobre el nombre de la cuenta en Azure Portal para obtener el directorio o el id. de inquilino. También puede buscar y seleccionar Microsoft Entra ID>Propiedades>Id. del inquilino en Azure Portal.
    SCOPE Id. de aplicación (cliente) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Este valor es el mismo que el id. del cliente o la aplicación que se mencionó anteriormente.
    refresh_token Valor del token de actualización 0.ATcA01-XWHdJ0ES-qDevC6r........... Siga Cómo generar un token de autenticación para crear un token de actualización y guardarlo. Necesitará este token de actualización más adelante para generar un token de usuario.
    DNS URI <instance>.energy.Azure.com Busque este valor en la página de información general de la instancia de Azure Data Manager for Energy.
    data-partition-id Particiones de datos <instance>-<data-partition-name> Busque este valor en la página de información general de la instancia de Azure Data Manager for Energy.

Siga la guía de Administración de usuarios para agregar los derechos adecuados para el usuario que ejecuta este tutorial.

Configuración de Postman y ejecución de solicitudes

  1. Descargue e instale la aplicación de escritorio Postman.

  2. Importe los archivos siguientes en Postman:

    Para importar la colección y las variables de entorno de Postman, siga los pasos en Importar datos a Postman.

  3. Actualice CURRENT VALUE para el entorno de Postman con la información que ha obtenido en los detalles de la instancia de Azure Data Manager for Energy.

  4. La colección de Postman para la ingesta del analizador CSV contiene 10 solicitudes que debe ejecutar secuencialmente.

    Asegúrese de elegir el entorno de flujo de trabajo de ingesta antes de desencadenar la colección de Postman.

    Screenshot of the Postman environment.

  5. Desencadene cada solicitud seleccionando el botón Enviar.

    En cada solicitud, Postman valida el código de respuesta de la API real en el código de respuesta esperado. Si hay algún error de coincidencia, la sección de prueba indica errores.

Ejemplo de una solicitud de Postman correcta:

Screenshot of a successful Postman call.

Ejemplo de una solicitud de Postman errónea:

Screenshot of a failed Postman call.

Ingesta de datos de wellbore mediante Postman

Para ingerir un archivo CSV de datos de wellbore de ejemplo en la instancia de Azure Data Manager for Energy mediante la colección de Postman, complete los pasos siguientes:

  1. Obtener un token de acceso de usuario: genere el token de usuario, que se usará para autenticar más llamadas API.

  2. Crear un esquema: genere un esquema que se adapte a las columnas presentes en el archivo CSV.

  3. Obtener los detalles del esquema: obtenga el esquema que creó en el paso anterior y valídelo.

  4. Crear una etiqueta legal: cree una etiqueta legal que se agregará a los datos de CSV con fines de cumplimiento de datos.

  5. Obtenga una dirección URL firmada para cargar un archivo CSV: obtenga la ruta de acceso de dirección URL firmada en la que se cargará el archivo CSV.

  6. Cargar un archivo CSV: descargue el ejemplo de Wellbore.csv en el equipo local y, a continuación, seleccione este archivo en Postman. Para ello, haga clic en el botón Seleccionar archivo.

    Screenshot of uploading a CSV file.

  7. Cargar los metadatos del archivo CSV: cargue la información de los metadatos del archivo, como la ubicación del archivo y otros campos pertinentes.

  8. Crear un flujo de trabajo de ingesta del analizador CSV: cree el grafo acíclico dirigido (DAG) para el flujo de trabajo de ingesta del analizador CSV.

  9. Desencadenar un flujo de trabajo de ingesta del analizador CSV: desencadene el DAG para el flujo de trabajo de ingesta del analizador CSV.

  10. Buscar el estado de flujo de trabajo de ingesta del analizador CSV ingerido: obtenga el estado de la ejecución del DAG del analizador CSV.

Busque datos de wellbore ingeridos mediante Postman

Para buscar los registros de metadatos de almacenamiento creados durante la ingesta de CSV mediante la colección de Postman, complete el paso siguiente:

  • Busque los registros CSV ingeridos: busque los registros CSV que se crearon anteriormente.

    Screenshot of searching ingested CSV records.

Paso siguiente

Avance hasta el siguiente tutorial:

Tutorial: Realizar la ingesta de archivo basada en un manifiesto