Tutorial: Melakukan penyerapan pengurai CSV

  • Artikel

Penyerapan pengurai nilai yang dipisahkan koma (CSV) menyediakan kemampuan untuk menyerap file CSV ke dalam instans Azure Data Manager for Energy.

Dalam tutorial ini, Anda akan mempelajari cara:

  • Menyerap sampel file CSV data wellbore ke dalam instans Azure Data Manager for Energy dengan menggunakan Postman.
  • Cari rekaman metadata penyimpanan yang dibuat selama penyerapan CSV dengan menggunakan Postman.

Prasyarat

Sebelum Anda memulai tutorial ini, selesaikan prasyarat berikut.

Mendapatkan detail untuk instans Azure Data Manager for Energy

  • Anda memerlukan instans Azure Data Manager for Energy. Jika Anda belum memilikinya, buat dengan mengikuti langkah-langkah di Mulai Cepat: Membuat instans Azure Data Manager for Energy.

  • Untuk tutorial ini, Anda memerlukan parameter berikut:

    Parameter Nilai yang akan digunakan Contoh Tempat menemukan nilai ini
    CLIENT_ID Aplikasi (ID klien) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Anda menggunakan ID aplikasi atau klien ini saat mendaftarkan aplikasi dengan platform identitas Microsoft. Lihat Mendaftarkan aplikasi.
    CLIENT_SECRET Rahasia klien _fl****************** Terkadang disebut kata sandi aplikasi, rahasia klien adalah nilai string yang dapat digunakan aplikasi Anda sebagai pengganti sertifikat untuk identitas itu sendiri. Tambahkan rahasia klien.
    TENANT_ID ID (tenant) direktori 72f988bf-86f1-41af-91ab-xxxxxxxxxxxx Arahkan mouse ke atas nama akun Anda di portal Azure untuk mendapatkan ID direktori atau penyewa. Secara bergantian, cari dan pilih ID Penyewa Properti>Microsoft Entra ID>di portal Azure.
    SCOPE Aplikasi (ID klien) 3dbbbcc2-f28f-44b6-a5ab-xxxxxxxxxxxx Nilai ini sama dengan ID aplikasi atau klien yang disebutkan sebelumnya.
    refresh_token Menyegarkan nilai token 0.ATcA01-XWHdJ0ES-qDevC6r........... Ikuti Cara membuat token autentikasi untuk membuat token refresh dan menyimpannya. Anda memerlukan token refresh ini nanti untuk menghasilkan token pengguna.
    DNS URI <instance>.energy.Azure.com Temukan nilai ini di halaman gambaran umum instans Azure Data Manager for Energy.
    data-partition-id Partisi data <instance>-<data-partition-name> Temukan nilai ini di halaman gambaran umum instans Azure Data Manager for Energy.

Ikuti panduan Kelola pengguna untuk menambahkan hak yang sesuai bagi pengguna yang menjalankan tutorial ini.

Menyiapkan Postman dan menjalankan permintaan

  1. Unduh dan instal aplikasi desktop Postman .

  2. Impor file berikut ke Postman:

    Untuk mengimpor variabel koleksi dan lingkungan Postman, ikuti langkah-langkah dalam Mengimpor data ke Postman.

  3. Perbarui NILAI SAAT INI untuk lingkungan Postman dengan informasi yang Anda peroleh dalam detail instans Azure Data Manager for Energy.

  4. Koleksi Postman untuk penyerapan pengurai CSV berisi 10 permintaan yang harus Anda jalankan secara berurutan.

    Pastikan untuk memilih Lingkungan Alur Kerja Penyerapan sebelum Anda memicu koleksi Postman.

    Screenshot of the Postman environment.

  5. Picu setiap permintaan dengan memilih tombol Kirim .

    Pada setiap permintaan, Postman memvalidasi kode respons API aktual terhadap kode respons yang diharapkan. Jika ada ketidakcocokan, bagian pengujian menunjukkan kegagalan.

Berikut adalah contoh permintaan Postman yang berhasil:

Screenshot of a successful Postman call.

Berikut adalah contoh permintaan Postman yang gagal:

Screenshot of a failed Postman call.

Menyerap data wellbore dengan menggunakan Postman

Untuk menyerap sampel file CSV data wellbore ke dalam instans Azure Data Manager for Energy dengan menggunakan koleksi Postman, selesaikan langkah-langkah berikut:

  1. Mendapatkan Token Akses Pengguna: Hasilkan token pengguna, yang akan digunakan untuk mengautentikasi panggilan API lebih lanjut.

  2. Buat Skema: Hasilkan skema yang mematuhi kolom yang ada dalam file CSV.

  3. Dapatkan detail Skema: Buat skema di langkah sebelumnya dan validasi.

  4. Buat Tag Hukum: Buat tag hukum yang akan ditambahkan ke data CSV untuk tujuan kepatuhan data.

  5. Dapatkan URL yang ditandatangani untuk mengunggah file CSV: Dapatkan jalur URL yang ditandatangani tempat file CSV akan diunggah.

  6. Unggah file CSV: Unduh sampel Wellbore.csv ke komputer lokal Anda, lalu pilih file ini di Postman dengan mengklik tombol Pilih File .

    Screenshot of uploading a CSV file.

  7. Unggah metadata file CSV: Unggah informasi metadata file, seperti lokasi file dan bidang relevan lainnya.

  8. Membuat Alur Kerja Penyerapan Pengurai CSV: Buat grafik acyclic (DAG) yang diarahkan untuk alur kerja penyerapan pengurai CSV.

  9. Memicu Alur Kerja Penyerapan Pengurai CSV: Picu DAG untuk alur kerja penyerapan pengurai CSV.

  10. Cari status Alur Kerja Penyerapan Parser CSV yang diserap: Dapatkan status eksekusi DAG pengurai CSV.

Cari data wellbore yang diserap dengan menggunakan Postman

Untuk mencari rekaman metadata penyimpanan yang dibuat selama penyerapan CSV dengan menggunakan koleksi Postman, selesaikan langkah berikut:

  • Cari rekaman CSV yang diserap: Cari rekaman CSV yang dibuat sebelumnya.

    Screenshot of searching ingested CSV records.

Langkah selanjutnya

Melanjutkan ke tutorial berikutnya:

Tutorial: Melakukan penyerapan file berbasis manifes