Tutorial: Realizar la ingesta del analizador de CSV

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:

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)	00001111-aaaa-2222-bbbb-3333cccc4444	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)	00001111-aaaa-2222-bbbb-3333cccc4444	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:

   • Colección de Postman de flujo de trabajo CSV
   • Entorno de Postman de flujo de trabajo CSV

   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.

   

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:

Ejemplo de una solicitud de Postman errónea:

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.

   

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.

  

Paso siguiente

Avance hasta el siguiente tutorial: