Tutorial: Melakukan penyerapan file berbasis manifes

  • Artikel

Penyerapan manifes menyediakan kemampuan untuk menyerap manifes ke dalam instans Azure Data Manager for Energy.

Dalam tutorial ini, Anda akan mempelajari cara:

  • Serap manifes sampel ke dalam instans Azure Data Manager for Energy dengan menggunakan Postman.
  • Cari rekaman metadata penyimpanan yang dibuat selama penyerapan manifes 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 manifes berisi beberapa 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 manifes sampel dengan menggunakan Postman

Untuk menyerap manifes sampel 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 Tag Hukum: Buat tag hukum yang akan ditambahkan ke data manifes untuk tujuan kepatuhan data.

  3. Dapatkan URL Yang Ditandatangani untuk mengunggah file: Dapatkan jalur URL yang ditandatangani tempat file manifes akan diunggah.

  4. Unggah file: Unduh sampel Wellbore.csv ke komputer lokal Anda. Ini bisa berupa jenis file apa pun, termasuk CSV, LAS, atau JSON. Pilih file ini di Postman dengan mengklik tombol Pilih File .

    Screenshot of uploading a manifest file.

  5. Unggah Metadata File: Unggah informasi metadata file, seperti lokasi file dan bidang terkait lainnya.

  6. Dapatkan Metadata File: Panggil untuk memvalidasi apakah metadata berhasil dibuat.

  7. Menyerap data Master, Referensi, dan Komponen Produk Kerja (WPC): Menyerap metadata manifes master, referensi, dan komponen produk kerja (WPC).

  8. Dapatkan status Alur Kerja Penyerapan Manifes: Alur kerja dimulai dan dalam status berjalan . Terus kueri hingga status berubah menjadi selesai (biasanya 20 hingga 30 detik).

Cari data yang diserap dengan menggunakan Postman

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

  1. Cari Produk Kerja: Panggil layanan pencarian untuk mengambil rekaman metadata produk kerja.
  2. Komponen Produk Kerja Pencarian: Panggil layanan pencarian untuk mengambil catatan metadata WPC.
  3. Cari Himpunan Data: Panggil layanan pencarian untuk mengambil rekaman metadata himpunan data.
  4. Cari Data master: Panggil layanan pencarian untuk mengambil rekaman metadata master.
  5. Cari Data Referensi: Panggil layanan pencarian untuk mengambil rekaman metadata referensi.

Langkah selanjutnya

Melanjutkan ke tutorial berikutnya:

Tutorial: Menggunakan sdutil untuk memuat data ke Seismic Store

Untuk informasi selengkapnya tentang penyerapan manifes, lihat Panduan Mulai Cepat Pemuatan Data Operator OSDU.