Delen via

Zelfstudie: Op manifest gebaseerde bestandsopname uitvoeren

  • Artikel

Manifestopname biedt de mogelijkheid om manifesten op te nemen in een Azure Data Manager for Energy-exemplaar.

In deze zelfstudie leert u het volgende:

  • Gebruik Postman om voorbeeldmanifesten op te nemen in een Azure Data Manager for Energy-exemplaar.
  • Zoek naar records voor opslagmetagegevens die zijn gemaakt tijdens de manifestopname met behulp van Postman.

Vereisten

Voordat u aan deze zelfstudie begint, moet u de volgende vereisten voltooien.

Meer informatie over het Azure Data Manager for Energy-exemplaar

  • U hebt een Azure Data Manager for Energy-exemplaar nodig. Als u er nog geen hebt, maakt u er een door de stappen in quickstart te volgen: Een Azure Data Manager for Energy-exemplaar maken.

  • Voor deze zelfstudie hebt u de volgende parameters nodig:

    Parameter Te gebruiken waarde Opmerking Waar vind ik deze waarde?
    CLIENT_ID Client-id van toepassing 00001111-aaaa-2222-bbbb-3333cccc4444 U gebruikt deze app of client-id bij het registreren van de toepassing bij het Microsoft Identity Platform. Zie Een toepassing registreren.
    CLIENT_SECRET Clientgeheimen _fl****************** Een clientgeheim wordt ook wel een toepassingswachtwoord genoemd, een tekenreekswaarde die uw app kan gebruiken in plaats van een certificaat om zichzelf te identificeren. Zie Een clientgeheim toevoegen.
    TENANT_ID Id van directory (tenant) 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Beweeg de muisaanwijzer over de accountnaam in Azure Portal om de map- of tenant-id op te halen. U kunt ook tenant-id's voor Microsoft Entra-id's>> zoeken en selecteren in De Azure-portal.
    SCOPE Client-id van toepassing 00001111-aaaa-2222-bbbb-3333cccc4444 Deze waarde is hetzelfde als de app- of client-id die eerder is vermeld.
    refresh_token Tokenwaarde vernieuwen 0.ATcA01-XWHdJ0ES-qDevC6r........... Volg Hoe u een verificatietoken genereert om een vernieuwingstoken te maken en op te slaan. U hebt dit vernieuwingstoken later nodig om een gebruikerstoken te genereren.
    DNS URI <instance>.energy.Azure.com Zoek deze waarde op de overzichtspagina van het Exemplaar van Azure Data Manager for Energy.
    data-partition-id Gegevenspartities <instance>-<data-partition-name> Zoek deze waarde op de overzichtspagina van het Exemplaar van Azure Data Manager for Energy.

Volg de handleiding Gebruikers beheren om de juiste rechten toe te voegen voor de gebruiker die deze zelfstudie uitvoert.

Postman instellen en aanvragen uitvoeren

  1. Download en installeer de Postman-bureaublad-app .

  2. Importeer de volgende bestanden in Postman:

    Als u de Postman-verzameling en -omgevingsvariabelen wilt importeren, volgt u de stappen in het importeren van gegevens in Postman.

  3. Werk DE HUIDIGE WAARDE voor de Postman-omgeving bij met de informatie die u hebt verkregen in de details van het Azure Data Manager for Energy-exemplaar.

  4. De Postman-verzameling voor manifestopname bevat meerdere aanvragen die u opeenvolgend moet uitvoeren.

    Zorg ervoor dat u Ingestion Workflow Environment kiest voordat u de Postman-verzameling activeert.

    Screenshot of the Postman environment.

  5. Activeer elke aanvraag door de knop Verzenden te selecteren.

    Bij elke aanvraag valideert Postman de werkelijke API-antwoordcode op basis van de verwachte antwoordcode. Als er sprake is van een onjuiste overeenkomst, geeft de testsectie fouten aan.

Hier volgt een voorbeeld van een geslaagde Postman-aanvraag:

Screenshot of a successful Postman call.

Hier volgt een voorbeeld van een mislukte Postman-aanvraag:

Screenshot of a failed Postman call.

Voorbeeldmanifesten opnemen met Behulp van Postman

Voer de volgende stappen uit om voorbeeldmanifesten op te nemen in het Exemplaar van Azure Data Manager for Energy met behulp van de Postman-verzameling:

  1. Een token voor gebruikerstoegang ophalen: genereer het gebruikerstoken, dat wordt gebruikt om verdere API-aanroepen te verifiëren.

  2. Een juridische tag maken: maak een juridische tag die wordt toegevoegd aan de manifestgegevens voor gegevensnalevingsdoeleinden.

  3. Haal een ondertekende URL op voor het uploaden van een bestand: Haal het ondertekende URL-pad op waarnaar het manifestbestand wordt geüpload.

  4. Een bestand uploaden: download het Wellbore.csv voorbeeld naar uw lokale computer. Dit kan elk bestandstype zijn, waaronder CSV, LAS of JSON. Selecteer dit bestand in Postman door op de knop Bestand selecteren te klikken.

    Screenshot of uploading a manifest file.

  5. Bestandsmetagegevens uploaden: upload de metagegevensgegevens van het bestand, zoals bestandslocatie en andere relevante velden.

  6. Haal de bestandsmetagegevens op: aanroep om te controleren of de metagegevens zijn gemaakt.

  7. WPC-gegevens (Master, Reference and Work Product Component) opnemen: neem de metagegevens van het WPC-manifest (Master, Reference and Work Product Component) op.

  8. Werkstroomstatus manifestopname ophalen: de werkstroom wordt gestart en heeft de status Actief . Blijf query's uitvoeren totdat de status is voltooid (meestal 20 tot 30 seconden).

Zoeken naar opgenomen gegevens met behulp van Postman

Voer de volgende stappen uit om te zoeken naar records voor opslagmetagegevens die zijn gemaakt tijdens de manifestopname met behulp van de Postman-verzameling:

  1. Zoekwerkproducten: roep de zoekservice aan om de metagegevensrecords van het werkproduct op te halen.
  2. Zoekwerkproductonderdelen: roep de zoekservice aan om de WPC-metagegevensrecords op te halen.
  3. Gegevensset zoeken: roep de zoekservice aan om de metagegevensrecords van de gegevensset op te halen.
  4. Zoek naar hoofdgegevens: roep de zoekservice aan om de hoofdmetagegevensrecords op te halen.
  5. Zoek naar referentiegegevens: roep de zoekservice aan om de referentiemetagegevensrecords op te halen.

Volgende stap

Ga door naar de volgende zelfstudie:

Zelfstudie: Sdutil gebruiken om gegevens te laden in Seismic Store

Zie de handleiding OsDU Operator Data Loading Quick Start voor meer informatie over manifestopname.