Firestore - Tugas Batch Get

Pengumuman: Application Integration kini tersedia untuk project Google Cloud Anda. Anda kini dapat menggunakan Apigee Integration dan Application Integration dalam project Google Cloud yang sama. Pelajari lebih lanjut

Tugas Firestore - Batch Get dapat Anda gunakan untuk mengirim satu permintaan batch ke Cloud Firestore untuk mengambil atau mengambil konten dari beberapa dokumen Firestore. Dokumen yang diambil mungkin tidak dalam urutan yang sama dengan yang diminta.

Firestore adalah database dokumen NoSQL yang dibangun untuk penskalaan otomatis, performa tinggi, dan kemudahan pengembangan aplikasi.

Sebelum memulai

Pastikan Anda melakukan tugas berikut di project Google Cloud sebelum mengonfigurasi tugas Firestore - Batch Get:

1. Aktifkan Cloud Firestore API (firestore.googleapis.com).

   Mengaktifkan Cloud Firestore API

2. Buat profil autentikasi. Apigee Integration menggunakan profil autentikasi untuk terhubung ke endpoint autentikasi untuk tugas Firestore - Batch Get.

   Untuk mengetahui informasi tentang cara memberikan peran atau izin tambahan ke akun layanan, lihat Memberikan, mengubah, dan mencabut akses.

Mengonfigurasi tugas Firestore - Batch Get

1. Di UI Apigee, pilih Organisasi Apigee Anda.
2. Klik Develop > Integrasi.
3. Pilih integrasi yang ada atau buat integrasi baru dengan mengklik Buat Integrasi.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi dalam dialog Create Integration.
   2. Pilih Region untuk integrasi dari daftar wilayah yang didukung.
   3. Klik Create.

   Tindakan ini akan membuka integrasi di desainer integrasi.

4. Di menu navigasi desainer integrasi, klik +Tambahkan tugas/pemicu > Tasks untuk melihat daftar tugas yang tersedia.
5. Klik dan tempatkan elemen Firestore - Batch Get di desainer integrasi.
6. Klik elemen Firestore - Batch Get pada desainer untuk melihat panel konfigurasi tugas Firestore - Batch Get.
7. Buka Authentication, lalu pilih profil autentikasi yang sudah ada dan ingin Anda gunakan.

   Opsional. Jika Anda belum membuat profil autentikasi sebelum mengonfigurasi tugas, klik + New authentication profile, lalu ikuti langkah-langkah seperti yang disebutkan dalam Membuat profil autentikasi baru.

8. Buka Input Tugas, dan konfigurasikan kolom input yang ditampilkan menggunakan tabel Parameter input tugas berikut.

   Perubahan pada kolom input disimpan secara otomatis.

Parameter input tugas

Tabel berikut menjelaskan parameter input tugas Firestore - Batch Get:

Properti	Jenis data	Deskripsi
Wilayah	String	Lokasi database Firestore. Misalnya, us-central1.
ProjectsId	String	ID Project Google Cloud Anda.
DatabasesId	String	ID database Firestore.
Permintaan	JSON	Lihat struktur JSON permintaan.

Output tugas

Tugas Firestore - Batch Get akan menampilkan data dokumen dalam format berenkode base64. Anda harus mendekode nilai berenkode base64 untuk mendapatkan string output.

Tips: Anda dapat mengenkode atau mendekode data base64 menggunakan perintah base64 di Linux atau macOS, atau perintah Base64.exe di Windows. Bahasa pemrograman dan skrip biasanya menyertakan library untuk encoding base64. Untuk contoh command line, lihat Mendekode base64 dalam dokumentasi Cloud Text-to-Speech.

Strategi penanganan error

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

Langkah selanjutnya

1. Tambahkan kondisi edge dan edge.
2. Uji dan publikasikan integrasi Anda.
3. Konfigurasi pemicu.
4. Tambahkan tugas Pemetaan Data.
5. Lihat semua tugas untuk layanan Google Cloud.