Mengoptimalkan kueri dengan filter rentang dan ketidaksetaraan di beberapa kolom

Halaman ini memberikan contoh strategi pengindeksan yang dapat Anda gunakan untuk kueri dengan filter rentang dan ketidaksetaraan di beberapa kolom untuk menciptakan pengalaman kueri yang efisien.

Sebelum mengoptimalkan kueri, baca konsep terkait.

Mengoptimalkan kueri dengan Query Explain

Untuk menentukan apakah kueri dan indeks sudah optimal, Anda dapat menggunakan Query Explain untuk mendapatkan ringkasan paket kueri dan statistik eksekusi kueri:

Java

Query q = db.collection("employees").whereGreaterThan("salary",
100000).whereGreaterThan("experience", 0);

ExplainResults<QuerySnapshot> explainResults = q.explain(ExplainOptions.builder().analyze(true).build()).get();
ExplainMetrics metrics = explainResults.getMetrics();

PlanSummary planSummary = metrics.getPlanSummary();
ExecutionStats executionStats = metrics.getExecutionStats();

System.out.println(planSummary.getIndexesUsed());
System.out.println(stats.getResultsReturned());
System.out.println(stats.getExecutionDuration());
System.out.println(stats.getReadOperations());
System.out.println(stats.getDebugStats());

Node.js

let q = db.collection("employees")
      .where("salary", ">", 100000)
      .where("experience", ">",0);

let options = { analyze : 'true' };
let explainResults = await q.explain(options);

let planSummary = explainResults.metrics.planSummary;
let stats = explainResults.metrics.executionStats;

console.log(planSummary);
console.log(stats);

Contoh berikut menunjukkan bagaimana penggunaan pengurutan indeks yang benar mengurangi jumlah entri indeks yang dipindai Cloud Firestore.

Kueri sederhana

Dengan contoh sebelumnya dari kumpulan karyawan, kueri sederhana yang berjalan dengan indeks (experience ASC, salary ASC) adalah sebagai berikut:

Java

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

Kueri memindai 95.000 entri indeks hanya untuk menampilkan lima dokumen. Karena predikat kueri tidak terpenuhi, sejumlah besar entri indeks dibaca, tetapi difilter.

// Output query planning info
{
    "indexesUsed": [
        {
            "properties": "(experience ASC, salary ASC, __name__ ASC)",
            "query_scope": "Collection"
        }
    ],

    // Output Query Execution Stats
    "resultsReturned": "5",
    "executionDuration": "2.5s",
    "readOperations": "100",
    "debugStats": {
        "index_entries_scanned": "95000",
        "documents_scanned": "5",
        "billing_details": {
            "documents_billable": "5",
            "index_entries_billable": "95000",
            "small_ops": "0",
            "min_query_cost": "0"
        }
    }
}

Anda dapat menyimpulkan dari keahlian domain bahwa sebagian besar karyawan akan memiliki setidaknya beberapa pengalaman tetapi hanya sedikit yang akan memiliki gaji lebih dari 100.000. Dengan insight ini, Anda dapat melihat bahwa batasan salary lebih selektif daripada batasan experience. Untuk memengaruhi indeks yang digunakan Cloud Firestore untuk menjalankan kueri, tentukan klausa orderBy yang mengurutkan batasan salary sebelum batasan experience.

Java

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

Saat Anda secara eksplisit menggunakan klausa orderBy() untuk menambahkan predikat, Cloud Firestore akan menggunakan indeks (salary ASC, experience ASC) untuk menjalankan kueri. Karena selektivitas filter rentang pertama lebih tinggi dalam kueri ini dibandingkan dengan kueri sebelumnya, kueri berjalan lebih cepat dan lebih hemat biaya.

// Output query planning info
{
    "indexesUsed": [
        {
            "properties": "(salary ASC, experience ASC, __name__ ASC)",
            "query_scope": "Collection"
        }
    ],

    // Output Query Execution Stats
    "resultsReturned": "5",
    "executionDuration": "0.2s",
    "readOperations": "6",
    "debugStats": {
        "index_entries_scanned": "1000",
        "documents_scanned": "5",
        "billing_details": {
            "documents_billable": "5",
            "index_entries_billable": "1000",
            "small_ops": "0",
            "min_query_cost": "0"
        }
    }
}

Langkah berikutnya