Halaman ini menyediakan ringkasan umum pemetaan data dan berbagai cara untuk melakukan pemetaan data di Integrasi Apigee.
Data perusahaan mungkin berada dalam berbagai sumber dan format, sehingga sangat sulit untuk mengintegrasikannya ke dalam model data atau pipeline data terpadu. Pemetaan data adalah proses ekstraksi dan standardisasi data dari berbagai sumber untuk membangun hubungan antara sumber tersebut dan kolom data target terkait di tujuan. Beberapa contoh penggunaan pemetaan data dalam suatu integrasi meliputi:
- Mengekstrak kolom dari struktur data yang kompleks seperti JSON.
- Memetakan sumber data ke skema target.
- Mengubah data dengan menerapkan fungsi transformasi.
- Menghasilkan nilai output dan menyimpan/menggunakannya sebagai variabel integrasi.
Integrasi Apigee memungkinkan Anda melakukan pemetaan data menggunakan tugas berikut:
Tugas Skrip Transformer Data
Tugas Skrip Transformer Data adalah fitur pemetaan data berbasis mesin template yang tersedia di Integrasi Apigee. Solusi ini menggunakan bahasa konfigurasi Jsonnet Google untuk membuat dan mengedit template Jsonnet yang menentukan hubungan pemetaan untuk variabel integrasi sumber dan target tertentu dalam integrasi Anda.
Dengan menggunakan editor Skrip Transformer Data dan fungsi Transformer Data yang didukung, Anda dapat menulis logika pemetaan data kustom, melakukan penetapan variabel, dan menambahkan atau mengubah variabel integrasi.
Gambar berikut menampilkan contoh tata letak editor Skrip Transformer Data:
Untuk mengetahui informasi tentang cara menambahkan dan mengonfigurasi tugas Skrip Transformer Data, lihat tugas Skrip Transformer Data.
Tugas Pemetaan Data
Tugas Pemetaan Data adalah fitur tanpa kode sedikit di Apigee Integration yang menyediakan kanvas pemetaan visual (editor Pemetaan Data) untuk melakukan penetapan dan pemetaan data dalam integrasi Anda. Selain itu, Anda juga dapat menggunakan fungsi pemetaan yang didukung untuk mengubah data menjadi variabel/format penting agar dapat diakses oleh tugas atau pemicu lain dalam integrasi Anda.
Dengan tugas Pemetaan Data, Anda dapat:
- Gunakan Editor Pemetaan Data untuk memvisualisasikan dan menentukan pemetaan variabel untuk variabel tunggal atau bertingkat.
- Ubah variabel dari satu jenis data ke jenis data lainnya. Tugas Pemetaan Data memungkinkan Anda menerapkan beberapa fungsi pemetaan (termasuk fungsi bertingkat) untuk mengubah data variabel.
Editor dan tata letak Pemetaan Data
Editor Pemetaan Data menyediakan kanvas visual yang berisi elemen integrasi berikut:
- Panel Variables: Menampilkan berbagai jenis variabel yang tersedia untuk integrasi:
- Input. Variabel input integrasi.
- Output. Variabel output integrasi.
- Variabel Lokal. Variabel yang ada dalam cakupan integrasi.
Jika tidak ada variabel yang tercantum, klik Add + untuk mengonfigurasi variabel baru.
Klik (Luaskan) untuk meluaskan setiap variabel dan melihat subkolom yang tersedia dari variabel tersebut. Untuk menelusuri variabel apa pun atau subkolomnya dari daftar variabel yang tersedia, klik (Variabel penelusuran).Untuk informasi selengkapnya tentang variabel dalam Integrasi Apigee, lihat Menggunakan variabel dalam Integrasi Apigee.
- Kolom Input: Menampilkan baris pemetaan input yang berisi sumber input pemetaan data. Sumber dapat berupa nilai literal, fungsi dasar, atau variabel input, dengan fungsi pemetaan. Klik Variabel atau Nilai di baris pemetaan input untuk menambahkan sumber.
- Kolom Output: Menampilkan baris pemetaan output yang berisi variabel target terkait untuk baris pemetaan input masing-masing. Variabel target dapat digunakan untuk pemetaan dalam baris input berikutnya. Untuk menetapkan variabel output, Anda dapat membuat variabel baru atau langsung menarik lalu melepas variabel output yang ada dari kolom Variabel.
Memetakan fungsi
Tugas Pemetaan Data menyediakan berbagai fungsi pemetaan standar untuk mengubah dan menstandarkan data pemetaan dalam integrasi Anda. Fungsi pemetaan dapat memiliki satu atau beberapa parameter input, di mana setiap parameter dapat menyimpan nilai literal, variabel, atau fungsi dasar dengan fungsi pemetaan yang diterapkan. Anda dapat menggunakan beberapa fungsi pemetaan untuk satu sumber input, yang membentuk ekspresi transformasi pemetaan.
Jenis data akhir dari sumber input didasarkan pada jenis nilai yang ditampilkan dari ekspresi transformasi yang ditentukan dalam baris input pemetaan data masing-masing. Editor Pemetaan Data menampilkan error validasi di bawah baris input pemetaan data masing-masing jika jenis nilai yang ditampilkan dari sumber input tidak cocok dengan jenis nilai yang ditampilkan dari variabel target pemetaan output yang sesuai.
Mentransformasi ekspresi
Ekspresi transformasi adalah kombinasi dari beberapa fungsi pemetaan yang dirantai bersama dalam deret atau dalam struktur bertingkat. Dengan menggunakan editor Pemetaan Data, Anda dapat dengan mudah menyisipkan, mengubah, atau menghapus fungsi atau parameter fungsi dalam ekspresi transformasi yang ditentukan. Jika ekspresi transformasi yang ditentukan tidak valid, Editor Pemetaan Data akan menampilkan error validasi di samping fungsi atau parameter fungsi masing-masing yang menyebabkan error dalam ekspresi. Untuk melihat pesan error lengkap, tahan kursor ke ikon error validasi .
Gambar berikut menampilkan contoh pemetaan dengan error validasi di editor Pemetaan Data:
Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi pemetaan dalam tugas Pemetaan Data, lihat Menambahkan pemetaan.
Untuk informasi tentang fungsi pemetaan standar yang didukung di Integrasi Apigee, lihat Jenis data dan fungsi pemetaan yang didukung.
Urutan pemetaan
Pemetaan yang ditentukan di Editor Pemetaan Data dijalankan secara berurutan dari atas ke bawah. Misalnya, pada gambar sebelumnya,Num1 dipetakan ke Num1ToInt di baris pertama, sehingga Num1ToInt tersedia untuk pemetaan di baris berikutnya.