Lihat konektor yang didukung untuk Application Integration.
Untuk setiap tugas Paralel
Tugas Untuk Setiap Paralel memungkinkan Anda menjalankan integrasi lain (sub-integrasi) dari integrasi utama Anda. Sesuai dengan nama tugas, sub-integrasi berjalan secara paralel.
Tugas ini menggunakan ID Pemicu API sebagai handle untuk mengidentifikasi integrasi yang akan dijalankan.
Misalnya, jika Anda menentukan ID Pemicu API sebagai api_trigger/APITriggerX
, tugas akan menjalankan semua sub-integrasi yang memiliki ID pemicu api_trigger/APITriggerX
.
Setelah menjalankan sub-integrasi, Anda juga dapat membaca respons sub-integrasi dalam integrasi utama Anda. Gunakan tugas ini untuk menjalankan sub-integrasi sebagai dependensi dari integrasi utama.
Sebelum memulai
- Pastikan Anda telah melampirkan akun layanan yang dikelola pengguna ke integrasi. Jika integrasi Anda belum mengonfigurasi akun layanan yang dikelola pengguna, akun layanan default (
service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com
) akan digunakan untuk autentikasi secara default. - Pastikan akun layanan Anda memiliki peran IAM Application Integration Invoker. Untuk informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.
Mengonfigurasi tugas Untuk Setiap Paralel
Untuk mengonfigurasi tugas For Every Parallel:
- Di konsol Google Cloud, buka halaman Application Integration.
- Di menu navigasi, klik Integrasi.
Halaman Integrations akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.
- Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.
Jika Anda membuat integrasi baru:
- Masukkan nama dan deskripsi di panel Create Integration.
- Pilih region untuk integrasi.
- Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary di toolbar integrasi.
- Klik Create.
Tindakan ini akan membuka integrasi di editor integrasi.
- Di menu navigasi editor integrasi, klik Tasks untuk melihat daftar tugas yang tersedia.
- Klik dan tempatkan elemen tugas For Every Parallel di editor integrasi.
- Klik elemen tugas For Every Parallel pada desainer untuk membuka panel konfigurasi tugas For Every Parallel.
- Konfigurasikan kolom yang ditampilkan menggunakan Properti konfigurasi untuk tugas
seperti yang dijelaskan dalam tabel di bawah.
Semua perubahan pada properti disimpan secara otomatis.
Properti konfigurasi
Bagian ini menjelaskan properti konfigurasi tugas Untuk Tiap Paralel.
Properti input
Nama Properti | Nama Parameter | Data type | Deskripsi |
Pilihan Array | List to iterate
|
Array jenis string, integer, double, atau JSON. | Daftar nilai yang harus dijalankan oleh sub-integrasi.
Thread sub-integrasi terpisah berjalan untuk setiap nilai dalam daftar, dan semua
thread berjalan secara paralel.
Anda dapat meneruskan nilai iterasi ke sub-integrasi dengan menetapkan kolom Tempat memetakan setiap elemen array. Anda juga dapat meneruskan nilai tambahan dari integrasi utama ke sub-integrasi di kolom Peta ke input sub-integrasi tambahan. |
Detail Sub-integrasi | API Trigger ID
|
String | ID pemicu dari sub-integrasi yang dipublikasikan untuk dijalankan.
Nilai ini tersedia di kolom ID Pemicu pada Pemicu API dalam sub-integrasi. |
Execution strategy
|
T/A |
SYNC: Menjalankan sub-integrasi dalam mode sinkron. Dalam mode ini, integrasi utama menunggu hingga sub-integrasi selesai sebelum melanjutkan tugas downstream. ASYNC: Menjalankan sub-integrasi dalam mode asinkron. Dalam mode ini, integrasi utama tidak menunggu hingga sub-integrasi selesai. Segera setelah memanggil sub-integrasi, integrasi utama akan menjalankan tugas downstream. |
|
Run all integrations with this API Trigger ID |
T/A | Menjalankan semua integrasi yang memiliki ID Pemicu API yang sama.
Misalnya, jika integrasi Catatan: Jika Anda memilih opsi ini, respons dari sub-integrasi tidak akan tersedia dalam integrasi utama. Jika Anda ingin menggunakan respons sub-integrasi, pilih opsi Run a single integration. |
|
Run a single integration |
T/A | Hanya menjalankan integrasi yang ditentukan dalam kolom Integration name. Anda dapat menggunakan respons dari sub-integrasi dengan mengonfigurasi bagian Kumpulkan nilai dari output sub-integrasi.
|
|
Pada setiap eksekusi | Where to map individual array elements |
String | Nama variabel input sub-integrasi tempat elemen array harus dipetakan. Elemen array dapat dipetakan langsung ke variabel input sub-integrasi. Jika satu sub-integrasi dipilih, Anda dapat memilih variabel input sub-integrasi dari daftar dropdown. |
Map to additional sub-integration input(s) |
String | Opsi pemetaan sub-integrasi tambahan.
Kolom ini menggunakan nilai dalam bentuk key-value pair, dengan kunci adalah variabel dalam integrasi utama, dan nilainya adalah variabel input yang sesuai dalam sub-integrasi.
Misalnya, anggaplah integrasi utama Anda memiliki variabel |
|
Collect values from sub-integration output(s) |
String | Jika strategi eksekusi bersifat sinkron (SYNC) dan satu sub-integrasi (Jalankan integrasi tunggal) dipilih, output sub-integrasi dapat dikumpulkan ke dalam variabel array dalam integrasi saat ini.
| |
Setelan Eksekusi | Integrations to execute at a time (parallel)
|
Bilangan bulat | Jumlah maksimum eksekusi paralel yang diizinkan untuk sub-integrasi. Nilai defaultnya adalah
50 (maksimum 10000 ).
Semua sub-integrasi dalam sebuah kelompok berjalan sepenuhnya sebelum kelompok sub-integrasi berikutnya dijalankan. |
Ignore failures
|
Boolean |
Anda dapat menentukan salah satu nilai berikut:
|
Praktik terbaik
Sebaiknya gunakan praktik terbaik berikut saat menggunakan tugas Untuk Tiap Paralel:
- Tetapkan ukuran kelompok Anda berdasarkan batasan kuota yang diberlakukan oleh sub-integrasi Anda.
- Gunakan strategi eksekusi SYNC jika Anda ingin mengumpulkan output sub-integrasi untuk digunakan nanti.
- Gunakan strategi eksekusi ASYNC jika sub-integrasi mungkin berjalan lebih dari 2 menit.
Guna mengetahui informasi tentang batas penggunaan yang berlaku untuk tugas Untuk Setiap Paralel, lihat Batas penggunaan.
Pertimbangan
Secara umum, jangan gunakan strategi eksekusi SYNC jika sub-integrasi membutuhkan waktu lebih dari 2 menit untuk dijalankan atau Anda berencana menggunakan tugas ini bersamaan dengan tugas asinkron alami seperti tugas Persetujuan.
Strategi penanganan error
Strategi penanganan error untuk tugas menentukan tindakan yang akan diambil jika tugas gagal karena error sementara. Untuk mendapatkan informasi tentang cara menggunakan strategi penanganan error, dan mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.