Menganalisis eksekusi kueri dengan Query Explain

Hanya berlaku untuk edisi Cloud Firestore Enterprise.

Halaman ini menjelaskan cara mengambil informasi eksekusi kueri saat Anda menjalankan kueri.

Menggunakan Query Explain

Anda dapat menggunakan Query Explain untuk memahami cara kueri Anda dijalankan. Hal ini memberikan detail yang dapat Anda gunakan untuk mengoptimalkan kueri.

Anda dapat menggunakan Query Explain melalui konsol Google Cloud atau perintah explain.

Konsol

Jalankan kueri di Editor Kueri dan buka tab Explanation:

  1. Di konsol Google Cloud, buka halaman Databases.

    Buka Databases

  2. Dari daftar database, pilih database Cloud Firestore dengan kompatibilitas MongoDB. Konsol Google Cloud membuka Firestore Explorer untuk database tersebut.
  3. Masukkan kueri di editor kueri, lalu klik Run.

  4. Klik tab Penjelasan untuk melihat output analisis kueri.

    Tab Query Explain di konsol
MongoDB API

Query Explain di MongoDB API didukung melalui perintah explain yang dapat Anda gunakan pada alat seperti Mongo Shell dan Compass.

Perintah explain didukung dengan perintah aggregate, find, distinct, dan count, misalnya:

db.collection.explain.find(...)

Anda juga dapat menggunakan metode explain(), misalnya:

db.collection.find({QUERY}).explain()
Batasan
Perhatikan batasan dan perbedaan berikut:

  • Query Explain tidak mendukung perintah yang menampilkan kursor. Misalnya, memanggil explain dengan memanggil perintah berikut secara langsung tidak didukung:

    db.collection.aggregate(..., explain: true)

  • Query Explain hanya didukung pada perintah find, aggregate, count, dan distinct.

  • Opsi Verbosity dan Comment dari Query Explain tidak didukung melalui MongoDB API. Perilakunya cocok dengan opsi executionStats. Opsi allPlansExecution dan queryPlanner diabaikan jika diberikan.

Analisis

Output Query Explain berisi dua komponen utama, yaitu Statistik Ringkasan dan Hierarki Eksekusi. Pertimbangkan kueri ini sebagai contoh:

db.order.aggregate(
 [
   { "$match": { "user_id": 1234 } },
   { "$sort": { "date_placed": 1 } }
 ]
)

Statistik Ringkasan

Bagian atas output yang dijelaskan berisi ringkasan statistik eksekusi. Gunakan statistik ini untuk menentukan apakah kueri memiliki latensi atau biaya yang tinggi. Selain itu, tab ini juga berisi statistik memori yang memberi tahu seberapa dekat kueri Anda dengan batas memori.

Billing Metrics:
read units: 1

Execution Metrics:
request peak memory usage: 4.00 KiB (4,096 B)
results returned: 1

Hierarki Eksekusi

Hierarki eksekusi menjelaskan eksekusi kueri sebagai serangkaian node. Node bawah (node daun) mengambil data dari lapisan penyimpanan yang melintasi hierarki untuk menghasilkan respons kueri.

Untuk mengetahui detail tentang setiap node eksekusi, lihat Referensi eksekusi.

Untuk mengetahui detail cara menggunakan informasi ini guna mengoptimalkan kueri Anda, lihat Mengoptimalkan eksekusi kueri.

Berikut contoh hierarki eksekusi:

• Compute
|  $out_1: map_set($record_1, "__id__", $__id___1, "__key__", $__key___1, "__row_id__", $__row_id___1, "__$0__", $__$0___2)
|  is query result: true
|
|  Execution:
|   records returned: 1
|
└── • Compute
    |  $__$0___2: UNSET
    |
    |  Execution:
    |   records returned: 1
    |
    └── • Compute
        |  $__key___1: UNSET
        |  $__row_id___1: UNSET
        |
        |  Execution:
        |   records returned: 1
        |
        └── • Compute
            |  $__id___1: _id($record_1.__key__)
            |
            |  Execution:
            |   records returned: 1
            |
            └── • MajorSort
                |  fields: [$v_5 ASC]
                |  output: [$record_1]
                |
                |  Execution:
                |   records returned: 1
                |   peak memory usage: 4.00 KiB (4,096 B)
                |
                └── • Compute
                    |  $v_5: array_get($v_4, 0L)
                    |
                    |  Execution:
                    |   records returned: 1
                    |
                    └── • Compute
                        |  $v_4: sortPaths(array($record_1.date_placed), [date_placed ASC])
                        |
                        |  Execution:
                        |   records returned: 1
                        |
                        └── • Filter
                            |  expression: $eq($user_id_1, 1,234)
                            |
                            |  Execution:
                            |   records returned: 1
                            |
                            └── • TableScan
                                   source: **/my_collection
                                   order: STABLE
                                   properties: * - { __create_time__, __update_time__ }
                                   output record: $record_1
                                   output bindings: {$user_id_1=user_id}
                                   variables: [$record_1, $user_id_1]

                                   Execution:
                                    records returned: 1
                                    records scanned: 1

Langkah berikutnya