एक एकत्रीकरण क्वेरी एकल सारांश मान लौटाने के लिए एकाधिक सूचकांक प्रविष्टियों से डेटा संसाधित करती है।
क्लाउड फायरस्टोर निम्नलिखित एकत्रीकरण प्रश्नों का समर्थन करता है:
-
count()
-
sum()
-
average()
क्लाउड फायरस्टोर एकत्रीकरण की गणना करता है और केवल परिणाम को आपके ऐप पर वापस भेजता है। एक पूर्ण क्वेरी निष्पादित करने और आपके ऐप में एकत्रीकरण की गणना करने की तुलना में, एकत्रीकरण क्वेरी बिल किए गए दस्तावेज़ रीड और स्थानांतरित बाइट्स दोनों पर बचत करती है।
एकत्रीकरण क्वेरीज़ मौजूदा इंडेक्स कॉन्फ़िगरेशन पर निर्भर करती हैं जो आपके क्वेरीज़ पहले से ही उपयोग करते हैं, और स्कैन की गई इंडेक्स प्रविष्टियों की संख्या के अनुपात में स्केल करते हैं। एकत्रीकरण में वस्तुओं की संख्या के साथ विलंबता बढ़ती है।
count()
एकत्रीकरण का प्रयोग करें
count()
एकत्रीकरण क्वेरी आपको संग्रह या क्वेरी में दस्तावेज़ों की संख्या निर्धारित करने देती है।
डेटा प्राप्त करने में हमारे द्वारा सेट किए गए उदाहरण डेटा का संदर्भ लें।
निम्नलिखित count()
एकत्रीकरण cities
के संग्रह में शहरों की कुल संख्या लौटाता है।
Web modular API
const coll = collection(db, "cities"); const snapshot = await getCountFromServer(coll); console.log('count: ', snapshot.data().count);
तीव्र
let query = db.collection("cities") let countQuery = query.count do { let snapshot = try await countQuery.getAggregation(source: .server) print(snapshot.count) } catch { print(error) }
उद्देश्य सी
FIRCollectionReference *query = [self.db collectionWithPath:@"cities"]; [query.count aggregationWithSource:FIRAggregateSourceServer completion:^(FIRAggregateQuerySnapshot *snapshot, NSError *error) { if (error != nil) { NSLog(@"Error fetching count: %@", error); } else { NSLog(@"Cities count: %@", snapshot.count); } }];
Java
Query query = db.collection("cities"); AggregateQuery countQuery = query.count(); countQuery.get(AggregateSource.SERVER).addOnCompleteListener(new OnCompleteListener<AggregateQuerySnapshot>() { @Override public void onComplete(@NonNull Task<AggregateQuerySnapshot> task) { if (task.isSuccessful()) { // Count fetched successfully AggregateQuerySnapshot snapshot = task.getResult(); Log.d(TAG, "Count: " + snapshot.getCount()); } else { Log.d(TAG, "Count failed: ", task.getException()); } } });
Kotlin+KTX
val query = db.collection("cities") val countQuery = query.count() countQuery.get(AggregateSource.SERVER).addOnCompleteListener { task -> if (task.isSuccessful) { // Count fetched successfully val snapshot = task.result Log.d(TAG, "Count: ${snapshot.count}") } else { Log.d(TAG, "Count failed: ", task.getException()) } }
Dart
// Returns number of documents in users collection db.collection("users").count().get().then( (res) => print(res.count), onError: (e) => print("Error completing: $e"), );
जाना
जावा
CollectionReference collection = db.collection("cities"); AggregateQuerySnapshot snapshot = collection.count().get().get(); System.out.println("Count: " + snapshot.getCount());
नोड.जे.एस
const collectionRef = db.collection('cities'); const snapshot = await collectionRef.count().get(); console.log(snapshot.data().count);
अजगर
count()
एकत्रीकरण क्वेरी पर किसी भी फ़िल्टर और किसी भी limit
खंड को ध्यान में रखता है।
Web modular API
const coll = collection(db, "cities"); const q = query(coll, where("state", "==", "CA")); const snapshot = await getCountFromServer(q); console.log('count: ', snapshot.data().count);
तीव्र
let query = db.collection("cities").whereField("state", isEqualTo: "CA") let countQuery = query.count do { let snapshot = try await countQuery.getAggregation(source: .server) print(snapshot.count) } catch { print(error) }
उद्देश्य सी
FIRQuery *query = [[self.db collectionWithPath:@"cities"] queryWhereField:@"state" isEqualTo:@"CA"]; [query.count aggregationWithSource:FIRAggregateSourceServer completion:^(FIRAggregateQuerySnapshot *snapshot, NSError *error) { if (error != nil) { NSLog(@"Error fetching count: %@", error); } else { NSLog(@"Cities count: %@", snapshot.count); } }];
Java
Query query = db.collection("cities").whereEqualTo("state", "CA"); AggregateQuery countQuery = query.count(); countQuery.get(AggregateSource.SERVER).addOnCompleteListener(new OnCompleteListener<AggregateQuerySnapshot>() { @Override public void onComplete(@NonNull Task<AggregateQuerySnapshot> task) { if (task.isSuccessful()) { // Count fetched successfully AggregateQuerySnapshot snapshot = task.getResult(); Log.d(TAG, "Count: " + snapshot.getCount()); } else { Log.d(TAG, "Count failed: ", task.getException()); } } });
Kotlin+KTX
val query = db.collection("cities").whereEqualTo("state", "CA") val countQuery = query.count() countQuery.get(AggregateSource.SERVER).addOnCompleteListener { task -> if (task.isSuccessful) { // Count fetched successfully val snapshot = task.result Log.d(TAG, "Count: ${snapshot.count}") } else { Log.d(TAG, "Count failed: ", task.getException()) } }
Dart
// This also works with collectionGroup queries. db.collection("users").where("age", isGreaterThan: 10).count().get().then( (res) => print(res.count), onError: (e) => print("Error completing: $e"), );
जाना
जावा
CollectionReference collection = db.collection("cities"); Query query = collection.whereEqualTo("state", "CA"); AggregateQuerySnapshot snapshot = query.count().get().get(); System.out.println("Count: " + snapshot.getCount());
नोड.जे.एस
const collectionRef = db.collection('cities'); const query = collectionRef.where('state', '==', 'CA'); const snapshot = await query.count().get(); console.log(snapshot.data().count);
अजगर
sum()
एकत्रीकरण का उपयोग करें
किसी दी गई क्वेरी से मेल खाने वाले संख्यात्मक मानों का कुल योग वापस करने के लिए sum()
एकत्रीकरण का उपयोग करें—उदाहरण के लिए:
Web modular API
const coll = collection(firestore, 'cities'); const snapshot = await getAggregateFromServer(coll, { totalPopulation: sum('population') }); console.log('totalPopulation: ', snapshot.data().totalPopulation);
जावा
collection = db.collection("cities"); snapshot = collection.aggregate(sum("population")).get().get(); System.out.println("Sum: " + snapshot.get(sum("population")));
नोड.जे.एस
const coll = firestore.collection('cities'); const sumAggregateQuery = coll.aggregate({ totalPopulation: AggregateField.sum('population'), }); const snapshot = await sumAggregateQuery.get(); console.log('totalPopulation: ', snapshot.data().totalPopulation);
sum()
एकत्रीकरण क्वेरी पर किसी भी फ़िल्टर और किसी भी सीमा खंड को ध्यान में रखता है - उदाहरण के लिए:
Web modular API
const coll = collection(firestore, 'cities'); const q = query(coll, where('capital', '==', true)); const snapshot = await getAggregateFromServer(q, { totalPopulation: sum('population') }); console.log('totalPopulation: ', snapshot.data().totalPopulation);
जावा
collection = db.collection("cities"); query = collection.whereEqualTo("state", "CA"); snapshot = query.aggregate(sum("population")).get().get(); System.out.println("Sum: " + snapshot.get(sum("population")));
नोड.जे.एस
const coll = firestore.collection('cities'); const q = coll.where("capital", "==", true); const sumAggregateQuery = q.aggregate({ totalPopulation: AggregateField.sum('population'), }); const snapshot = await sumAggregateQuery.get(); console.log('totalPopulation: ', snapshot.data().totalPopulation);
average()
एकत्रीकरण का उपयोग करें
किसी दी गई क्वेरी से मेल खाने वाले संख्यात्मक मानों का औसत वापस करने के लिए average()
एकत्रीकरण का उपयोग करें—उदाहरण के लिए:
Web modular API
const coll = collection(firestore, 'cities'); const snapshot = await getAggregateFromServer(coll, { averagePopulation: average('population') }); console.log('averagePopulation: ', snapshot.data().averagePopulation);
जावा
collection = db.collection("cities"); snapshot = collection.aggregate(average("population")).get().get(); System.out.println("Average: " + snapshot.get(average("population")));
नोड.जे.एस
const coll = firestore.collection('cities'); const averageAggregateQuery = coll.aggregate({ averagePopulation: AggregateField.average('population'), }); const snapshot = await averageAggregateQuery.get(); console.log('averagePopulation: ', snapshot.data().averagePopulation);
average()
एकत्रीकरण क्वेरी पर किसी भी फ़िल्टर और किसी भी सीमा खंड को ध्यान में रखता है - उदाहरण के लिए:
Web modular API
const coll = collection(firestore, 'cities'); const q = query(coll, where('capital', '==', true)); const snapshot = await getAggregateFromServer(q, { averagePopulation: average('population') }); console.log('averagePopulation: ', snapshot.data().averagePopulation);
जावा
collection = db.collection("cities"); query = collection.whereEqualTo("state", "CA"); snapshot = query.aggregate(average("population")).get().get(); System.out.println("Average: " + snapshot.get(average("population")));
नोड.जे.एस
const coll = firestore.collection('cities'); const q = coll.where("capital", "==", true); const averageAggregateQuery = q.aggregate({ averagePopulation: AggregateField.average('population'), }); const snapshot = await averageAggregateQuery.get(); console.log('averagePopulation: ', snapshot.data().averagePopulation);
एक क्वेरी में एकाधिक एकत्रीकरण की गणना करें
आप एक ही एकत्रीकरण पाइपलाइन में एकाधिक एकत्रीकरण को जोड़ सकते हैं। इससे आवश्यक सूचकांक पढ़ने की संख्या कम हो सकती है। यदि क्वेरी में एकाधिक फ़ील्ड पर एकत्रीकरण शामिल है, तो क्वेरी को एक समग्र सूचकांक की आवश्यकता हो सकती है। उस स्थिति में, क्लाउड फायरस्टोर एक इंडेक्स का सुझाव देता है।
निम्नलिखित उदाहरण एकल एकत्रीकरण क्वेरी में एकाधिक एकत्रीकरण करता है:
Web modular API
const coll = collection(firestore, 'cities'); const snapshot = await getAggregateFromServer(coll, { countOfDocs: count(), totalPopulation: sum('population'), averagePopulation: average('population') }); console.log('countOfDocs: ', snapshot.data().countOfDocs); console.log('totalPopulation: ', snapshot.data().totalPopulation); console.log('averagePopulation: ', snapshot.data().averagePopulation);
जावा
collection = db.collection("cities"); query = collection.whereEqualTo("state", "CA"); AggregateQuery aggregateQuery = query.aggregate(count(), sum("population"), average("population")); snapshot = aggregateQuery.get().get(); System.out.println("Count: " + snapshot.getCount()); System.out.println("Sum: " + snapshot.get(sum("population"))); System.out.println("Average: " + snapshot.get(average("population")));
नोड.जे.एस
const coll = firestore.collection('cities'); const aggregateQuery = coll.aggregate({ countOfDocs: AggregateField.count(), totalPopulation: AggregateField.sum('population'), averagePopulation: AggregateField.average('population') }); const snapshot = await aggregateQuery.get(); console.log('countOfDocs: ', snapshot.data().countOfDocs); console.log('totalPopulation: ', snapshot.data().totalPopulation); console.log('averagePopulation: ', snapshot.data().averagePopulation);
एकाधिक एकत्रीकरण वाली क्वेरीज़ में केवल वे दस्तावेज़ शामिल होते हैं जिनमें प्रत्येक एकत्रीकरण के सभी फ़ील्ड शामिल होते हैं। इससे प्रत्येक एकत्रीकरण को अलग-अलग निष्पादित करने से भिन्न परिणाम प्राप्त हो सकते हैं।
एकत्रीकरण प्रश्नों के लिए सुरक्षा नियम
क्लाउड फायरस्टोर सुरक्षा नियम एकत्रीकरण प्रश्नों पर उसी तरह काम करते हैं जैसे दस्तावेज़ लौटाने वाले प्रश्नों पर। दूसरे शब्दों में, यदि और केवल यदि आपके नियम ग्राहकों को कुछ संग्रह या संग्रह समूह प्रश्नों को निष्पादित करने की अनुमति देते हैं, तो ग्राहक उन प्रश्नों पर एकत्रीकरण भी कर सकते हैं। क्लाउड फायरस्टोर सुरक्षा नियम प्रश्नों के साथ कैसे इंटरैक्ट करते हैं, इसके बारे में और जानें।
व्यवहार और सीमाएँ
जब आप एकत्रीकरण प्रश्नों के साथ काम करते हैं, तो निम्नलिखित व्यवहार और सीमाओं पर ध्यान दें:
आप वास्तविक समय के श्रोताओं और ऑफ़लाइन प्रश्नों के साथ एकत्रीकरण प्रश्नों का उपयोग नहीं कर सकते। एकत्रीकरण क्वेरीज़ केवल प्रत्यक्ष सर्वर प्रतिक्रिया के माध्यम से समर्थित हैं। क्वेरीज़ को केवल क्लाउड फायरस्टोर बैकएंड द्वारा परोसा जाता है, स्थानीय कैश और किसी भी बफ़र किए गए अपडेट को छोड़ दिया जाता है। यह व्यवहार क्लाउड फायरस्टोर लेनदेन के अंदर किए गए कार्यों के समान है।
यदि कोई एकत्रीकरण 60 सेकंड के भीतर हल नहीं हो पाता है, तो यह
DEADLINE_EXCEEDED
त्रुटि देता है। प्रदर्शन आपके सूचकांक कॉन्फ़िगरेशन और डेटासेट के आकार पर निर्भर करता है।यदि ऑपरेशन 60 सेकंड की समय सीमा के भीतर पूरा नहीं किया जा सकता है, तो बड़े डेटासेट के लिए काउंटरों का उपयोग करना एक संभावित समाधान है।
एकत्रीकरण क्वेरीज़ सूचकांक प्रविष्टियों से पढ़ी जाती हैं और इसमें केवल अनुक्रमित फ़ील्ड शामिल होते हैं।
एक एकत्रीकरण क्वेरी में
OrderBy
क्लॉज जोड़ने से उन दस्तावेज़ों में एकत्रीकरण सीमित हो जाता है जहां सॉर्टिंग फ़ील्ड मौजूद है।sum()
औरaverage()
एकत्रीकरण के लिए, गैर-संख्यात्मक मानों को नजरअंदाज कर दिया जाता है।sum()
औरaverage()
एकत्रीकरण केवल पूर्णांक मानों और फ़्लोटिंग-पॉइंट संख्या मानों को ध्यान में रखते हैं।एक ही क्वेरी में कई एकत्रीकरणों को संयोजित करते समय, ध्यान दें कि
sum()
औरaverage()
गैर-संख्यात्मक मानों को अनदेखा करते हैं जबकिcount()
में गैर-संख्यात्मक मान शामिल होते हैं।यदि आप अलग-अलग फ़ील्ड पर मौजूद एकत्रीकरण को जोड़ते हैं, तो गणना में केवल वे दस्तावेज़ शामिल होते हैं जिनमें वे सभी फ़ील्ड शामिल होते हैं।
मूल्य निर्धारण
एकत्रीकरण प्रश्नों के लिए मूल्य निर्धारण क्वेरी से मेल खाने वाली सूचकांक प्रविष्टियों की संख्या पर निर्भर करता है। बड़ी संख्या में मिलान वाली प्रविष्टियों के लिए आपसे थोड़ी संख्या में पढ़ने का शुल्क लिया जाता है।
मूल्य निर्धारण की अधिक विस्तृत जानकारी देखें।