Tugas For Each Parallel

Dengan tugas For Each Parallel, Anda dapat menjalankan integrasi lain (sub-integrasi) dari integrasi utama. Seperti yang ditunjukkan oleh 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. Gunakan tugas ini untuk menjalankan sub-integrasi sebagai dependensi integrasi utama.

Sebelum memulai

  • Pastikan Anda telah melampirkan akun layanan yang dikelola pengguna ke integrasi Anda. Jika integrasi Anda tidak memiliki akun layanan yang dikelola pengguna yang dikonfigurasi, maka secara default akun layanan default (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) akan digunakan untuk autentikasi.
  • Pastikan akun layanan Anda memiliki peran IAM Application Integration Invoker. Untuk mengetahui informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Mengonfigurasi tugas For Each Parallel

Untuk mengonfigurasi tugas For Each Parallel:

  1. Di konsol Google Cloud , buka halaman Application Integration.

    Buka Application Integration

  2. Di menu navigasi, klik Integrasi.

    Halaman Integrasi akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

  3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

    Jika Anda membuat integrasi baru:

    1. Masukkan nama dan deskripsi di panel Buat Integrasi.
    2. Pilih region untuk integrasi.
    3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
    4. Klik Buat. Integrasi yang baru dibuat akan terbuka di editor integrasi.

  4. Di menu navigasi editor integrasi, klik Tugas untuk melihat daftar tugas dan konektor yang tersedia.
  5. Klik dan tempatkan elemen tugas For Each Parallel di editor integrasi.
  6. Klik elemen tugas For Each Parallel di perancang untuk membuka panel konfigurasi tugas For Each Parallel.
  7. Konfigurasi kolom yang ditampilkan menggunakan Properti konfigurasi untuk tugas seperti yang dijelaskan dalam tabel di bawah.

    Semua perubahan pada properti akan disimpan secara otomatis.

Properti konfigurasi

Bagian ini menjelaskan properti konfigurasi tugas For Each Parallel.

Properti input

Nama Properti Nama Parameter Data type Deskripsi
Pemilihan Array List to iterate Array jenis string, bilangan bulat, ganda, 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 yang diulang ke sub-integrasi dengan menetapkan kolom Tempat memetakan elemen array individual.

Anda juga dapat meneruskan nilai tambahan dari integrasi utama ke sub-integrasi di kolom Petakan ke input sub-integrasi tambahan.

Detail Sub-integrasi API Trigger ID String ID pemicu sub-integrasi yang dipublikasikan untuk dijalankan.

Nilai ini tersedia di kolom ID Pemicu dari 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 hilir.

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 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 A dan integrasi B memiliki ID Pemicu API yang sama, integrasi A dan B dijalankan untuk setiap item di Daftar yang akan diiterasi.

Catatan: Jika Anda memilih opsi ini, respons dari sub-integrasi tidak akan tersedia di integrasi utama. Jika Anda ingin menggunakan respons sub-integrasi, pilih opsi Jalankan satu integrasi.

Run a single integration T/A Hanya menjalankan integrasi yang ditentukan di kolom Nama integrasi. 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.
  • Integration variable to map from: Nama variabel dalam integrasi saat ini yang akan diteruskan ke variabel input sub-integrasi.
  • Input sub-integrasi yang akan dipetakan: Nama variabel input sub-integrasi yang akan dipetakan.

Kolom ini mengambil nilai dalam bentuk pasangan nilai kunci, dengan kunci adalah variabel dalam integrasi utama, dan nilai adalah variabel input yang sesuai dalam sub-integrasi.

Misalnya, pertimbangkan integrasi utama Anda memiliki variabel productID, yang ingin Anda petakan ke variabel sub-integrasi subIntProductID; Anda harus memilih productID dari kolom Variabel integrasi yang akan dipetakan dari dan memasukkan subIntProductID di kolom Input sub-integrasi yang akan dipetakan ke.

Collect values from sub-integration output(s) String Jika strategi eksekusi bersifat sinkron (SYNC) dan satu sub-integrasi (Jalankan satu integrasi) dipilih, output sub-integrasi dapat dikumpulkan ke dalam variabel array di integrasi saat ini.
  • Output sub-integrasi yang akan dikumpulkan: Nama variabel output sub-integrasi yang akan digabungkan.
  • Variabel integrasi yang akan dikumpulkan: Nama variabel dalam integrasi saat ini untuk mengumpulkan output gabungan.
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 kohor berjalan sepenuhnya sebelum kohor sub-integrasi berikutnya berjalan.

Ignore failures Boolean

Anda dapat menentukan salah satu nilai berikut:

  • Benar: Tugas mengabaikan kegagalan sub-integrasi dan menjalankan semua eksekusi.
  • Salah (False): Tugas gagal karena kegagalan sub-integrasi dan mengakhiri semua eksekusi.

Praktik terbaik

Sebaiknya lakukan praktik terbaik berikut saat menggunakan tugas For Each Parallel:

  • Tetapkan ukuran kohor berdasarkan batasan kuota yang diberlakukan oleh sub-integrasi Anda.
  • Gunakan strategi eksekusi SYNC saat Anda ingin mengumpulkan output sub-integrasi untuk digunakan nanti.
  • Gunakan strategi eksekusi ASYNC jika sub-integrasi Anda mungkin berjalan lebih dari 2 menit.

Untuk mengetahui informasi tentang batas penggunaan yang berlaku untuk tugas For Each Parallel, lihat Batas penggunaan.

Pertimbangan

Secara umum, jangan gunakan strategi eksekusi SYNC jika sub-integrasi Anda memerlukan waktu lebih dari 2 menit untuk dijalankan atau Anda berencana menggunakan tugas ini bersama dengan tugas asinkron alami seperti tugas Persetujuan.

Strategi penanganan error

Strategi penanganan error untuk tugas menentukan tindakan yang harus dilakukan jika tugas gagal karena error sementara. Untuk mengetahui informasi tentang cara menggunakan strategi penanganan error, dan untuk mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah berikutnya