การค้นหาด้วยตัวกรองช่วงและความไม่เท่ากันในภาพรวมช่องหลายช่อง

Cloud Firestore รองรับการใช้ตัวกรองช่วงและตัวกรองอสมการในหลายช่องในการค้นหาครั้งเดียว คุณสามารถใช้เงื่อนไขช่วงและอสมการในหลายช่อง และลดความซับซ้อนในการพัฒนาแอปพลิเคชันด้วยการมอบหมายการใช้งานตรรกะการกรองภายหลังให้ Cloud Firestore

ตัวกรองช่วงและตัวกรองอสมการในหลายช่อง

การค้นหาต่อไปนี้ใช้ตัวกรองช่วงกับประชากรและความหนาแน่นเพื่อแสดงเมืองทั้งหมดที่มีประชากรมากกว่า 1,000,000 คน และมีความหนาแน่นของประชากรน้อยกว่า 10,000 คนต่อหน่วยพื้นที่

เวอร์ชันเว็บ 9 แบบโมดูลาร์

const q = query(
    collection(db, "cities"),
    where('population', '>', 1000000),
    where('density', '<', 10000),
  );

Swift

let query = db.collection("cities")
  .whereField("population", isGreaterThan: 1000000)
  .whereField("density", isLessThan: 10000)

Objective-C

FIRQuery *query =
 [[[[self.db collectionWithPath:@"cities"]
queryWhereField:@"population" isGreaterThan:@1000000]
   queryWhereField:@"density" isLessThan:@10000];

Java Android

Query query = db.collection("cities")
 .whereGreaterThan("population", 1000000)
 .whereLessThan("density", 10000);

Kotlin+KTX Android

val query = db.collection("cities")
 .whereGreaterThan("population", 1000000)
 .whereLessThan("density", 10000)

Go

   query := client.Collection("cities").
      Where("population", ">", 1000000).
      Where("density", "<", 10000)

Java

db.collection("cities")
  .whereGreaterThan("population", 1000000)
  .whereLessThan("density", 10000);

Node.js

db.collection("cities")
  .where('population', '>', 1000000),
  .where('density', '<', 10000)

Python

from google.cloud import firestore

db = firestore.Client()
query = db.collection("cities")
.where("population", ">", 1000000)
.where("density", "<", 10000)

PHP

$collection = $db->collection('samples/php/cities');
$chainedQuery = $collection
    ->where('population', '>', 1000000)
    ->where('density', '<', 10000);

query_filter_compound_multi_ineq.php

C#

CollectionReference citiesRef = db.Collection("cities");
Query query = citiesRef
    .WhereGreaterThan("Population", 1000000)
    .WhereLessThan("Density", 10000);
QuerySnapshot querySnapshot = await query.GetSnapshotAsync();
foreach (DocumentSnapshot documentSnapshot in querySnapshot)
{
    var name = documentSnapshot.GetValue<string>("Name");
    var population = documentSnapshot.GetValue<int>("Population");
    var density = documentSnapshot.GetValue<int>("Density");
    Console.WriteLine($"City '{name}' returned by query. Population={population}; Density={density}");
}
Program.cs

Ruby

query = cities_ref.where("population", ">", "1000000")
                  .where("density", "<", 10000)

C++

CollectionReference cities_ref = db->Collection("cities");
Query query = cities_ref.WhereGreaterThan("population", FieldValue::Integer(1000000))
                       .WhereLessThan("density", FieldValue::Integer(10000));

Unity

CollectionReference citiesRef = db.Collection("cities");
Query query = citiesRef.WhereGreaterThan("population", 1000000)
                      .WhereLessThan("density", 10000);

Dart

final citiesRef = FirebaseFirestore.instance.collection('cities')
final query = citiesRef.where("population", isGreaterThan: 1000000)
                  .where("density", isLessThan: 10000);

ข้อควรพิจารณาเกี่ยวกับการจัดทำดัชนี

อ่าน ข้อมูลเกี่ยวกับ การค้นหา และ Cloud Firestore โมเดลข้อมูล ก่อนที่จะเรียกใช้การค้นหา

ใน Cloud Firestore อนุประโยค ORDER BY ของการค้นหาจะเป็นตัวกำหนดดัชนี ที่ใช้ในการแสดงผลการค้นหา เช่น การค้นหา ORDER BY a ASC, b ASC ต้องใช้ดัชนีผสมในช่อง a ASC, b ASC

หากต้องการเพิ่มประสิทธิภาพและลดค่าใช้จ่ายในการค้นหา Cloud Firestore ให้ เพิ่มประสิทธิภาพลำดับของช่องในดัชนี โดยตรวจสอบว่าดัชนีเรียงลำดับจากซ้ายไปขวาเพื่อให้การค้นหาได้ชุดข้อมูลที่ป้องกันการสแกนรายการดัชนีที่ไม่จำเป็น

สมมติว่าคุณต้องการค้นหาคอลเล็กชันพนักงานและค้นหาพนักงานในสหรัฐอเมริกาที่มีเงินเดือนมากกว่า $100,000 และมีประสบการณ์ทำงานมากกว่า 0 ปี จากความเข้าใจในชุดข้อมูล คุณทราบว่าข้อจำกัดด้านเงินเดือนมีความเฉพาะเจาะจงมากกว่าข้อจำกัดด้านประสบการณ์ ดัชนีที่เหมาะสมที่สุดซึ่งจะช่วยลดจำนวนการสแกนดัชนีคือ (salary [...], experience [...]) ดังนั้น การค้นหาที่รวดเร็วและประหยัดค่าใช้จ่ายจะเรียงลำดับ salary ก่อน experience และมีลักษณะดังนี้

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");

แนวทางปฏิบัติแนะนำสำหรับการเพิ่มประสิทธิภาพดัชนี

เมื่อเพิ่มประสิทธิภาพดัชนี โปรดทราบแนวทางปฏิบัติแนะนำต่อไปนี้

เรียงลำดับช่องดัชนีตามความเท่ากัน ตามด้วยช่องช่วงหรือช่องอสมการที่มีความเฉพาะเจาะจงมากที่สุด

Cloud Firestore ใช้ช่องซ้ายสุดของดัชนีผสมเพื่อตอบสนองข้อจำกัดด้านความเท่ากัน และข้อจำกัดด้านช่วงหรืออสมการ (หากมี) ในช่องแรกของการค้นหา orderBy() ข้อจำกัดเหล่านี้สามารถลดจำนวนรายการดัชนีที่ Cloud Firestore สแกน Cloud Firestore ใช้ช่องที่เหลือ ของดัชนีเพื่อตอบสนองข้อจำกัดด้านช่วงหรืออสมการอื่นๆ ของการค้นหา ข้อจำกัด เหล่านี้จะไม่ลดจำนวนรายการดัชนีที่ Cloud Firestore สแกน แต่จะกรองเอกสารที่ไม่ตรงกันออกเพื่อให้จำนวนเอกสารที่ ส่งคืนไปยังไคลเอ็นต์ลดลง

ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างดัชนีที่มีประสิทธิภาพได้ที่พร็อพเพอร์ตี้ดัชนี

เรียงลำดับช่องตามความเฉพาะเจาะจงของข้อจำกัดการค้นหาจากมากไปน้อย

เพื่อให้ Cloud Firestore เลือกดัชนีที่เหมาะสมที่สุดสำหรับการค้นหา ให้ระบุอนุประโยค orderBy() ที่เรียงลำดับช่องตามความเฉพาะเจาะจงของข้อจำกัดการค้นหาจากมากไปน้อย ความเฉพาะเจาะจงที่สูงกว่าจะตรงกับเอกสารชุดย่อยที่เล็กลง ในขณะที่ความเฉพาะเจาะจงที่ต่ำกว่าจะตรงกับเอกสารชุดย่อยที่ใหญ่ขึ้น ตรวจสอบว่าคุณเลือกช่องช่วงหรือช่องอสมการที่มีความเฉพาะเจาะจงสูงกว่าก่อนช่องที่มีความเฉพาะเจาะจงต่ำกว่าในการเรียงลำดับดัชนี

คุณควรเรียงลำดับช่องตามความเฉพาะเจาะจงของข้อจำกัดการค้นหาจากมากไปน้อยเสมอ เพื่อลดจำนวนเอกสารที่ Cloud Firestore สแกนและส่งคืนผ่าน เครือข่าย หากชุดผลลัพธ์ไม่ได้อยู่ในลำดับที่ต้องการและคาดว่าชุดผลลัพธ์จะมีขนาดเล็ก คุณสามารถใช้ตรรกะฝั่งไคลเอ็นต์เพื่อเรียงลำดับใหม่ตามที่ต้องการ

ตัวอย่างเช่น สมมติว่าคุณต้องการค้นหาคอลเล็กชันพนักงานเพื่อค้นหาพนักงานในสหรัฐอเมริกาที่มีเงินเดือนมากกว่า $100,000 และเรียงลำดับผลลัพธ์ตามปีที่พนักงานมีประสบการณ์ทำงาน หากคาดว่าจะมีพนักงานเพียงไม่กี่คนที่มีเงินเดือนมากกว่า $100,000 วิธีที่มีประสิทธิภาพมากที่สุดในการเขียนการค้นหาคือ

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`

แม้ว่าการเพิ่มการเรียงลำดับใน experience ลงในการค้นหาจะให้ชุดเอกสารชุดเดียวกันและไม่จำเป็นต้องเรียงลำดับผลลัพธ์ใหม่ในไคลเอ็นต์ แต่การค้นหาอาจอ่านรายการดัชนีที่ไม่เกี่ยวข้องจำนวนมากมากกว่าการค้นหาก่อนหน้า เนื่องจาก Cloud Firestore จะเลือกดัชนีที่มีคำนำหน้าของช่องดัชนีตรงกับ อนุประโยค Order By ของการค้นหาเสมอ หากเพิ่ม experience ลงในอนุประโยค Order By แล้ว Cloud Firestore จะเลือกดัชนี (experience [...], salary [...]) เพื่อคำนวณผลการค้นหา เนื่องจากไม่มีข้อจำกัดอื่นๆ ใน experience, Cloud Firestore จะอ่านรายการดัชนีทั้งหมด ของคอลเล็กชัน employees ก่อนที่จะใช้ตัวกรอง salary เพื่อค้นหาชุดผลลัพธ์สุดท้าย ซึ่งหมายความว่าระบบจะยังคงอ่านรายการดัชนีที่ไม่ตรงตามตัวกรอง salary ซึ่งจะเพิ่มเวลาในการตอบสนองและค่าใช้จ่ายของการค้นหา

ราคา

ระบบจะเรียกเก็บเงินสำหรับการค้นหาที่มีตัวกรองช่วงและตัวกรองอสมการในหลายช่องตามจำนวนเอกสารที่อ่านและรายการดัชนีที่อ่าน

ดูข้อมูลโดยละเอียดได้ที่หน้าการกำหนดราคา

ข้อจำกัด

นอกเหนือจากข้อจำกัดในการค้นหาแล้ว โปรดทราบข้อจำกัดต่อไปนี้ก่อนที่จะ ใช้การค้นหาที่มีตัวกรองช่วงและตัวกรองอสมการในหลายช่อง

  • ระบบไม่รองรับการค้นหาที่มีตัวกรองช่วงหรือตัวกรองอสมการในช่องเอกสารและมีเฉพาะข้อจำกัดด้านความเท่ากันในคีย์เอกสาร (__name__)
  • Cloud Firestore จำกัดจำนวนช่องช่วงหรือช่องอสมการไว้ที่ 10 ช่อง เพื่อป้องกันไม่ให้การค้นหามีค่าใช้จ่ายสูงเกินไป

ขั้นตอนถัดไป