Compartir vía

Tutorial: Realización de la ingesta de archivos basada en manifiesto

  • Artículo

La ingesta del manifiesto proporciona la capacidad de ingerir manifiestos en una instancia de Azure Data Manager for Energy.

En este tutorial, aprenderá a:

  • Ingesta de manifiestos 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 manifiestos mediante Postman.

Requisitos previos

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

Obtención de detalles para la instancia de Azure Data Manager for Energy

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

  • Para este tutorial, necesitarás 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. Consulta 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 puedes 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........... Sigue los pasos de Cómo generar un token de autenticación para crear un token de actualización y guardarlo. Necesitarás este token de actualización más adelante para generar un token de usuario.
    DNS URI <instance>.energy.Azure.com Busca 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> Busca este valor en la página de información general de la instancia de Azure Data Manager for Energy.

Sigue 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 a Postman:

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

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

  4. La colección de Postman para la ingesta de manifiestos contiene varias solicitudes que debes ejecutar secuencialmente.

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

    Screenshot of the Postman environment.

  5. Desencadena 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 manifiestos de ejemplo mediante Postman

Para ingerir manifiestos de ejemplo en la instancia de Azure Data Manager for Energy mediante la colección Postman, completa los pasos siguientes:

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

  2. Crear una etiqueta legal: crea una etiqueta legal que se agregará a los datos de manifiesto con fines de cumplimiento de datos.

  3. Obtener una dirección URL firmada para cargar un archivo: obtén la ruta de acceso de dirección URL firmada en la que se cargará el archivo de manifiesto.

  4. Cargar un archivo: descarga el ejemplo de Wellbore.csv en el equipo local. Podría ser cualquier tipo de archivo, incluido CSV, LAS o JSON. Selecciona este archivo en Postman haciendo clic en el botón Seleccionar archivo.

    Screenshot of uploading a manifest file.

  5. Cargar los metadatos del archivo: carga la información de los metadatos del archivo, como la ubicación del archivo y otros campos pertinentes.

  6. Obtener los metadatos del archivo: llama para validar si los metadatos se crearon correctamente.

  7. Ingerir los datos maestros, de referencias y de componentes de producto de trabajo (WPC): ingiere los metadatos de manifiesto del componente maestro, de referencia y de producto de trabajo (WPC).

  8. Obtener el estado del flujo de trabajo de ingesta de manifiestos: el flujo de trabajo se inicia y está en estado de ejecución. Sigue consultando hasta que el estado cambie a finalizado (normalmente entre 20 y 30 segundos).

Búsqueda de datos ingeridos mediante Postman

Para buscar registros de metadatos de almacenamiento creados durante la ingesta de manifiestos mediante la colección Postman, completa los pasos siguientes:

  1. Buscar productos de trabajo: llama al servicio de búsqueda para recuperar los registros de metadatos del producto de trabajo.
  2. Buscar componentes del producto de trabajo: llama al servicio de búsqueda para recuperar los registros de metadatos de WPC.
  3. Buscar un conjunto de datos: llama al servicio de búsqueda para recuperar los registros de metadatos del conjunto de datos.
  4. Buscar datos maestros: llama al servicio de búsqueda para recuperar los registros de metadatos maestros.
  5. Buscar datos de referencia: llama al servicio de búsqueda para recuperar los registros de metadatos de referencia.

Paso siguiente

Avance hasta el siguiente tutorial:

Tutorial: Uso de sdutil para cargar datos en Seismic Store

Para saber más sobre la ingesta de manifiestos, consulta la Guía de inicio rápido de carga de datos del operador OSDU.