Oktatóanyag: Jegyzékalapú fájlbetöltés végrehajtása

A jegyzékbetöltés lehetővé teszi a jegyzékek betöltését egy Azure Data Manager for Energy-példányba.

Ebben az oktatóanyagban az alábbiakkal fog megismerkedni:

  • Mintajegyzékek betöltése egy Azure Data Manager for Energy-példányba a Postman használatával.
  • Keressen a Postman használatával a jegyzékbetöltés során létrehozott tárolási metaadat-rekordokra.

Előfeltételek

Az oktatóanyag megkezdése előtt végezze el az alábbi előfeltételeket.

Az Azure Data Manager for Energy-példány részleteinek lekérése

  • Szüksége van egy Azure Data Manager for Energy-példányra. Ha még nincs ilyenje, hozzon létre egyet a gyorsútmutató lépéseit követve: Azure Data Manager for Energy-példány létrehozása.

  • Ebben az oktatóanyagban a következő paraméterekre van szüksége:

    Paraméter Használandó érték Példa Az érték megkeresésének helye
    CLIENT_ID Alkalmazás (ügyfél) azonosítója 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Ezt az alkalmazást vagy ügyfél-azonosítót akkor használja, amikor regisztrálja az alkalmazást a Microsoft Identitásplatform. Lásd: Alkalmazás regisztrálása.
    CLIENT_SECRET Ügyfél titkos kódja _fl****************** Az alkalmazásjelszónak is nevezett ügyfélkód egy sztringérték, amelyet az alkalmazás a tanúsítvány helyett használhat magára az identitásra. Lásd: Titkos ügyfélkód hozzáadása.
    TENANT_ID Címtár (bérlő) azonosítója 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Vigye az egérmutatót a fiók nevére az Azure Portalon a címtár vagy a bérlőazonosító lekéréséhez. Másik lehetőségként keresse meg és válassza ki a Microsoft Entra-azonosító>tulajdonságok>bérlőazonosítóját az Azure Portalon.
    SCOPE Alkalmazás (ügyfél) azonosítója 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Ez az érték megegyezik a korábban említett alkalmazás- vagy ügyfélazonosítóval.
    refresh_token Jogkivonat értékének frissítése 0.ATcA01-XWHdJ0ES-qDevC6r........... A frissítési jogkivonat létrehozásához és mentéséhez kövesse a hitelesítési jogkivonat létrehozását és mentését. A felhasználói jogkivonat létrehozásához később szüksége lesz erre a frissítési jogkivonatra.
    DNS URI <instance>.energy.Azure.com Ezt az értéket az Azure Data Manager for Energy-példány áttekintési oldalán találja.
    data-partition-id Adatpartíciók <instance>-<data-partition-name> Ezt az értéket az Azure Data Manager for Energy-példány áttekintési oldalán találja.

Az oktatóanyagot futtató felhasználó megfelelő jogosultságainak hozzáadásához kövesse a Felhasználók kezelése útmutatót.

A Postman beállítása és a kérések végrehajtása

  1. Töltse le és telepítse az asztali Postman alkalmazást.

  2. Importálja a következő fájlokat a Postmanbe:

    A Postman-gyűjtemény és a környezeti változók importálásához kövesse az adatok Postmanbe való importálásának lépéseit.

  3. Frissítse a Postman-környezet AKTUÁLIS ÉRTÉKÉT az Azure Data Manager for Energy-példány részleteiben beszerzett információkkal.

  4. A jegyzékbetöltés Postman-gyűjteménye több kérést tartalmaz, amelyeket egymás után kell végrehajtania.

    A Postman-gyűjtemény aktiválása előtt mindenképpen válassza a Betöltési munkafolyamat-környezet lehetőséget.

    Screenshot of the Postman environment.

  5. Az egyes kéréseket a Küldés gombra kattintva indíthatja el.

    A Postman minden kéréskor ellenőrzi a tényleges API-válaszkódot a várt válaszkóddal szemben. Ha van eltérés, a tesztszakasz hibákat jelez.

Íme egy példa egy sikeres Postman-kérésre:

Screenshot of a successful Postman call.

Íme egy példa egy sikertelen Postman-kérésre:

Screenshot of a failed Postman call.

Mintajegyzékek betöltése a Postman használatával

Ha a Postman-gyűjtemény használatával szeretné beszúrni a mintajegyzékeket az Azure Data Manager for Energy-példányba, hajtsa végre a következő lépéseket:

  1. Felhasználói hozzáférési jogkivonat beszerzése: Hozza létre a felhasználói jogkivonatot, amelyet a rendszer további API-hívások hitelesítésére használ.

  2. Jogi címke létrehozása: Jogi címke létrehozása, amely a jegyzékadatokhoz adatmegfelelőségi célokból lesz hozzáadva.

  3. Aláírt URL-cím lekérése egy fájl feltöltéséhez: Kérje le azt az aláírt URL-címet, amelyre a jegyzékfájl fel lesz töltve.

  4. Fájl feltöltése: Töltse le a Wellbore.csv mintát a helyi gépére. Bármilyen fájltípus lehet, beleértve a CSV-t, a LAS-t vagy a JSON-t is. Válassza ki ezt a fájlt a Postmanben a Fájl kiválasztása gombra kattintva.

    Screenshot of uploading a manifest file.

  5. Fájl metaadatainak feltöltése: Töltse fel a fájl metaadatait, például a fájl helyét és más releváns mezőket.

  6. Kérje le a fájl metaadatait: Hívás annak ellenőrzésére, hogy a metaadatok létrehozása sikeresen megtörtént-e.

  7. Betöltési fő-, referencia- és munkatermék-összetevő (WPC) adatai: Betölti a fő-, referencia- és munkatermék-összetevő (WPC) jegyzék metaadatait.

  8. Jegyzékbetöltési munkafolyamat állapotának lekérése: A munkafolyamat elindul, és futó állapotban van. A lekérdezést addig folytassa, amíg az állapot befejeződik (általában 20–30 másodperc).

Betöltendő adatok keresése a Postman használatával

Ha a Postman-gyűjtemény használatával szeretné megkeresni a jegyzékbetöltés során létrehozott tárolási metaadat-rekordokat, hajtsa végre az alábbi lépéseket:

  1. Keresési munkatermékek: Hívja meg a keresőszolgáltatást a munkahelyi termék metaadatrekordjainak lekéréséhez.
  2. Keresési munka termékösszetevői: Hívja meg a keresőszolgáltatást a WPC metaadatrekordjainak lekéréséhez.
  3. Adathalmaz keresése: Hívja meg a keresési szolgáltatást az adathalmaz metaadatrekordjainak lekéréséhez.
  4. Főadatok keresése: Hívja meg a keresési szolgáltatást a fő metaadatrekordok lekéréséhez.
  5. Referenciaadatok keresése: Hívja meg a keresési szolgáltatást a referencia-metaadatrekordok lekéréséhez.

Következő lépés

Folytassa a következő oktatóanyaggal:

A jegyzékbetöltéssel kapcsolatos további információkért tekintse meg az OSDU operátor adatainak betöltésére vonatkozó rövid útmutatót.