Ringkasan kueri dengan filter rentang dan ketidaksetaraan di beberapa kolom

Cloud Firestore mendukung penggunaan filter rentang dan ketidaksetaraan di beberapa kolom dalam satu kueri. Anda sekarang dapat memiliki kondisi rentang dan ketidaksetaraan di beberapa kolom dan menyederhanakan pengembangan aplikasi dengan mendelegasikan implementasi logika pasca-pemfilteran ke Cloud Firestore.

Filter rentang dan ketidaksetaraan di beberapa kolom

Kueri berikut menampilkan semua pengguna yang usianya lebih dari 35 tahun dan tingginya antara 60 dan 70 tahun menggunakan filter rentang pada usia dan tinggi.

Modular web versi 9

  const q = query(
      collection(db, "users"),
      where('age', '>', 35),
      where('height', '>', 60),
      where('height', '<', 70)
    );

Swift

 let query = db.collection("users")
   .whereField("age", isGreaterThan: 35)
   .whereField("height", isGreaterThan: 60)
   .whereField("height", isLessThan: 70)

Objective-C

 FIRQuery *query = 
  [[[[self.db collectionWithPath:@"users"]
 queryWhereField:@"age" isGreaterThan:@35]
    queryWhereField:@"height" isGreaterThan:@60] 
        queryWhereField:@"height" isLessThan:@70];

Java Android

 Query query = db.collection("users")
  .whereGreaterThan("age", 35)
  .whereGreaterThan("height", 60)
  .whereLessThan("height", 70);

Kotlin+KTX Android

 val query = db.collection("users")
  .whereGreaterThan("age", 35)
  .whereGreaterThan("height", 60)
  .whereLessThan("height", 70)

Java

  db.collection("users")
    .whereGreaterThan("age", 35)
    .whereGreaterThan("height", 60)
    .whereLessThan("height", 70);

Node.js

db.collection("users")
  .where('age', '>', 35),
  .where('height', '>', 60),
  .where('height', '<', 70)

Pertimbangan pengindeksan

Sebelum mulai menjalankan kueri, pastikan Anda telah membaca kueri dan model data Cloud Firestore.

Di Cloud Firestore, klausa ORDER BY dari kueri menentukan indeks mana yang dapat digunakan untuk menyajikan kueri. Misalnya, kueri ORDER BY a ASC, b ASC memerlukan indeks komposit pada kolom a ASC, b ASC.

Untuk mengoptimalkan performa dan biaya kueri Cloud Firestore, Anda harus mengoptimalkan urutan kolom dalam indeks. Untuk melakukannya, pastikan bahwa indeks diurutkan dari kiri ke kanan sehingga kueri disaring ke set data yang mencegah pemindaian entri indeks yang tidak relevan.

Misalkan Anda ingin menelusuri kumpulan karyawan dan menemukan karyawan yang gajinya lebih dari 100.000 dan jumlah tahun pengalamannya lebih besar dari 0. Berdasarkan pemahaman Anda terhadap set data, Anda tahu bahwa batasan gaji lebih selektif daripada batasan pengalaman. Indeks ideal yang dapat mengurangi jumlah pemindaian indeks adalah (salary [...], experience [...]). Dengan demikian, kueri yang akan cepat dan hemat biaya akan mengurutkan salary sebelum experience dan terlihat seperti berikut:

Java

db.collection("employees")
  .whereGreaterThan("salary", 100000)
  .whereGreaterThan("experience", 0)
  .orderBy("salary")
  .orderBy("experience");

Node.js

db.collection("employees")
  .where("salary", ">", 100000)
  .where("experience", ">", 0)
  .orderBy("salary")
  .orderBy("experience");

Python

db.collection("employees")
  .where("salary", ">", 100000)
  .where("experience", ">", 0)
  .order_by("salary")
  .order_by("experience");

Praktik terbaik untuk mengoptimalkan indeks

Saat mengoptimalkan indeks, perhatikan praktik terbaik berikut.

Mengurutkan kolom indeks berdasarkan kesetaraan diikuti dengan sebagian besar kolom rentang atau ketidaksetaraan selektif

Cloud Firestore menggunakan kolom paling kiri pada indeks komposit untuk memenuhi batasan kesetaraan dan batasan rentang atau ketidaksetaraan, jika ada, di kolom pertama dari kueri orderBy(). Batasan ini dapat mengurangi jumlah entri indeks yang dipindai Cloud Firestore. Cloud Firestore menggunakan kolom yang tersisa dari indeks untuk memenuhi batasan rentang atau ketidaksetaraan lain dari kueri. Batasan ini tidak mengurangi jumlah entri indeks yang dipindai Cloud Firestore tetapi memfilter dokumen yang tidak cocok sehingga jumlah dokumen yang ditampilkan kepada klien akan berkurang.

Untuk mengetahui informasi selengkapnya tentang cara membuat indeks yang efisien, baca definisi indeks sempurna.

Mengurutkan kolom dalam urutan menurun dari selektivitas batasan kueri

Untuk memastikan bahwa Cloud Firestore memilih indeks yang optimal untuk kueri Anda, tentukan klausa orderBy() yang mengurutkan kolom dalam urutan menurun dari selektivitas batasan kueri. Selektivitas yang lebih tinggi cocok dengan subset dokumen yang lebih kecil, sementara selektivitas yang lebih rendah sesuai dengan subset dokumen yang lebih besar. Pastikan bahwa Anda memilih kolom rentang atau ketidaksetaraan dengan selektivitas lebih tinggi sebelumnya di pengurutan indeks daripada kolom dengan selektivitas yang lebih rendah.

Untuk meminimalkan jumlah dokumen yang dipindai dan ditampilkan oleh Cloud Firestore melalui jaringan, Anda harus selalu mengurutkan kolom dalam urutan menurun dari selektivitas batasan kueri. Jika set hasil tidak dalam urutan yang diperlukan dan set hasil tersebut diharapkan kecil, Anda bisa menerapkan logika sisi klien untuk mengurutkan ulang sesuai ekspektasi pengurutan Anda.

Misalnya, Anda ingin menelusuri kumpulan karyawan untuk menemukan karyawan yang gajinya lebih dari 100.000 dan mengurutkan hasilnya berdasarkan tahun pengalaman karyawan. Jika Anda mengharapkan hanya sejumlah kecil karyawan yang akan menerima gaji lebih dari 100.000, maka cara yang paling efisien untuk menulis kueri adalah sebagai berikut:

Java

db.collection("employees")
  .whereGreaterThan("salary", 100000)
  .orderBy("salary")
  .get()
  .addOnSuccessListener(new OnSuccessListener<QuerySnapshot>() {
        @Override
        public void onSuccess(QuerySnapshot queryDocumentSnapshots) {
          // Order results by `experience`
        }
    });;

Node.js

const querySnapshot = await db.collection('employees')
                              .where("salary", ">", 100000)
                              .orderBy("salary")
                              .get();

// Order results by `experience`

Python

results = db.collection("employees")
            .where("salary", ">", 100000)
            .order_by("salary")
            .stream()

// Order results by `experience`

Meskipun menambahkan pengurutan pada experience ke kueri akan menghasilkan set dokumen yang sama dan meniadakan pengaturan ulang hasil pada klien, kueri mungkin membaca banyak entri indeks yang lebih tidak relevan daripada kueri sebelumnya. Hal ini karena Cloud Firestore selalu memilih indeks yang awalan kolom indeksnya cocok dengan urutan berdasarkan klausa kueri. Jika experience ditambahkan ke urutan berdasarkan klausa, Cloud Firestore akan memilih indeks (experience [...], salary [...]) untuk menghitung hasil kueri. Karena tidak ada batasan lain pada experience, Cloud Firestore akan membaca semua entri indeks koleksi employees sebelum menerapkan filter salary untuk menemukan set hasil akhirnya. Ini berarti entri indeks yang tidak memenuhi filter salary akan tetap dibaca, sehingga meningkatkan latensi dan biaya kueri.

Harga

Kueri dengan filter rentang dan ketidaksetaraan di beberapa kolom ditagih berdasarkan dokumen yang dibaca dan entri indeks yang dibaca.

Untuk mengetahui informasi mendetail, lihat halaman Harga.

Batasan

Selain batasan kueri, perhatikan batasan berikut sebelum menggunakan kueri dengan filter rentang dan ketidaksetaraan di beberapa kolom:

  • Kueri dengan filter rentang atau ketidaksetaraan di kolom dokumen dan hanya batasan kesetaraan pada kunci dokumen (__name__) yang tidak didukung.
  • Cloud Firestore membatasi jumlah kolom rentang atau ketidaksetaraan hingga 10. Cara ini untuk mencegah kueri menjadi terlalu mahal untuk dijalankan.

Langkah Berikutnya