Oktatóanyag: CSV-elemzőbetöltés végrehajtása

A vesszővel tagolt értékeket (CSV) elemzőbetöltés lehetővé teszi CSV-fájlok betöltését egy Azure Data Manager for Energy-példányba.

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

  • AdatCSV-mintafájl betöltése egy Azure Data Manager for Energy-példányba a Postman használatával.
  • Keresse meg a CsV-betöltés során létrehozott tárolási metaadat-rekordokat a Postman használatával.

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 CSV-elemzőbetöltés Postman-gyűjteménye 10 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.

Adatok betöltése a Postman használatával

Ha a Postman-gyűjtemény használatával be szeretne tölteni egy minta adatCSV-fájlt az Azure Data Manager for Energy-példányba, hajtsa végre az alábbi 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. Séma létrehozása: Hozzon létre egy sémát, amely megfelel a CSV-fájlban található oszlopoknak.

  3. Séma részleteinek lekérése: Kérje le az előző lépésben létrehozott sémát, és ellenőrizze azt.

  4. Jogi címke létrehozása: Hozzon létre egy jogi címkét, amely adatmegfelelőségi célokból hozzáadódik a CSV-adatokhoz.

  5. Aláírt URL-cím lekérése CSV-fájl feltöltéséhez: Kérje le azt az aláírt URL-címet, amelyre a CSV-fájlt fel fogja tölteni.

  6. CSV-fájl feltöltése: Töltse le a Wellbore.csv mintát a helyi gépére, majd a Fájl kiválasztása gombra kattintva válassza ki ezt a fájlt a Postmanben.

    Screenshot of uploading a CSV file.

  7. CSV-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.

  8. CSV-elemzési feldolgozási munkafolyamat létrehozása: Hozza létre az irányított aciklikus gráfot (DAG) a CSV-elemző betöltési munkafolyamathoz.

  9. CSV-elemzési feldolgozási munkafolyamat aktiválása: Aktiválja a CSV-elemző betöltési munkafolyamat dagát.

  10. Betöltési CSV-elemző betöltési munkafolyamat állapotának keresése: A CSV-elemző DAG-futtatásának állapotának lekérése.

Betöltéses wellbore-adatok keresése a Postman használatával

Ha a Postman-gyűjtemény használatával szeretné megkeresni a CSV-betöltés során létrehozott tárolási metaadat-rekordokat, hajtsa végre a következő lépést:

  • Betöltött CSV-rekordok keresése: Keresse meg a korábban létrehozott CSV-rekordokat.

    Screenshot of searching ingested CSV records.

Következő lépés

Folytassa a következő oktatóanyaggal: