Cloud Firestore একটি কালেকশন বা কালেকশন গ্রুপ থেকে কোন ডকুমেন্টগুলো পুনরুদ্ধার করতে চান তা নির্দিষ্ট করার জন্য শক্তিশালী কোয়েরি কার্যকারিতা প্রদান করে। এই কোয়েরিগুলো get() অথবা addSnapshotListener() এর সাথেও ব্যবহার করা যেতে পারে, যেমনটি "ডেটা পান" এবং "রিয়েলটাইম আপডেট পান" অংশে বর্ণনা করা হয়েছে।
উদাহরণ ডেটা
শুরু করার জন্য, শহরগুলো সম্পর্কে কিছু ডেটা লিখুন, যাতে আমরা তা পুনরায় পড়ার বিভিন্ন উপায় দেখতে পারি:
Web
import { collection, doc, setDoc } from "firebase/firestore"; const citiesRef = collection(db, "cities"); await setDoc(doc(citiesRef, "SF"), { name: "San Francisco", state: "CA", country: "USA", capital: false, population: 860000, regions: ["west_coast", "norcal"] }); await setDoc(doc(citiesRef, "LA"), { name: "Los Angeles", state: "CA", country: "USA", capital: false, population: 3900000, regions: ["west_coast", "socal"] }); await setDoc(doc(citiesRef, "DC"), { name: "Washington, D.C.", state: null, country: "USA", capital: true, population: 680000, regions: ["east_coast"] }); await setDoc(doc(citiesRef, "TOK"), { name: "Tokyo", state: null, country: "Japan", capital: true, population: 9000000, regions: ["kanto", "honshu"] }); await setDoc(doc(citiesRef, "BJ"), { name: "Beijing", state: null, country: "China", capital: true, population: 21500000, regions: ["jingjinji", "hebei"] });
Web
var citiesRef = db.collection("cities"); citiesRef.doc("SF").set({ name: "San Francisco", state: "CA", country: "USA", capital: false, population: 860000, regions: ["west_coast", "norcal"] }); citiesRef.doc("LA").set({ name: "Los Angeles", state: "CA", country: "USA", capital: false, population: 3900000, regions: ["west_coast", "socal"] }); citiesRef.doc("DC").set({ name: "Washington, D.C.", state: null, country: "USA", capital: true, population: 680000, regions: ["east_coast"] }); citiesRef.doc("TOK").set({ name: "Tokyo", state: null, country: "Japan", capital: true, population: 9000000, regions: ["kanto", "honshu"] }); citiesRef.doc("BJ").set({ name: "Beijing", state: null, country: "China", capital: true, population: 21500000, regions: ["jingjinji", "hebei"] });
সুইফট
let citiesRef = db.collection("cities") citiesRef.document("SF").setData([ "name": "San Francisco", "state": "CA", "country": "USA", "capital": false, "population": 860000, "regions": ["west_coast", "norcal"] ]) citiesRef.document("LA").setData([ "name": "Los Angeles", "state": "CA", "country": "USA", "capital": false, "population": 3900000, "regions": ["west_coast", "socal"] ]) citiesRef.document("DC").setData([ "name": "Washington D.C.", "country": "USA", "capital": true, "population": 680000, "regions": ["east_coast"] ]) citiesRef.document("TOK").setData([ "name": "Tokyo", "country": "Japan", "capital": true, "population": 9000000, "regions": ["kanto", "honshu"] ]) citiesRef.document("BJ").setData([ "name": "Beijing", "country": "China", "capital": true, "population": 21500000, "regions": ["jingjinji", "hebei"] ])
উদ্দেশ্য-সি
FIRCollectionReference *citiesRef = [self.db collectionWithPath:@"cities"]; [[citiesRef documentWithPath:@"SF"] setData:@{ @"name": @"San Francisco", @"state": @"CA", @"country": @"USA", @"capital": @(NO), @"population": @860000, @"regions": @[@"west_coast", @"norcal"] }]; [[citiesRef documentWithPath:@"LA"] setData:@{ @"name": @"Los Angeles", @"state": @"CA", @"country": @"USA", @"capital": @(NO), @"population": @3900000, @"regions": @[@"west_coast", @"socal"] }]; [[citiesRef documentWithPath:@"DC"] setData:@{ @"name": @"Washington D.C.", @"country": @"USA", @"capital": @(YES), @"population": @680000, @"regions": @[@"east_coast"] }]; [[citiesRef documentWithPath:@"TOK"] setData:@{ @"name": @"Tokyo", @"country": @"Japan", @"capital": @(YES), @"population": @9000000, @"regions": @[@"kanto", @"honshu"] }]; [[citiesRef documentWithPath:@"BJ"] setData:@{ @"name": @"Beijing", @"country": @"China", @"capital": @(YES), @"population": @21500000, @"regions": @[@"jingjinji", @"hebei"] }];
Kotlin
val cities = db.collection("cities") val data1 = hashMapOf( "name" to "San Francisco", "state" to "CA", "country" to "USA", "capital" to false, "population" to 860000, "regions" to listOf("west_coast", "norcal"), ) cities.document("SF").set(data1) val data2 = hashMapOf( "name" to "Los Angeles", "state" to "CA", "country" to "USA", "capital" to false, "population" to 3900000, "regions" to listOf("west_coast", "socal"), ) cities.document("LA").set(data2) val data3 = hashMapOf( "name" to "Washington D.C.", "state" to null, "country" to "USA", "capital" to true, "population" to 680000, "regions" to listOf("east_coast"), ) cities.document("DC").set(data3) val data4 = hashMapOf( "name" to "Tokyo", "state" to null, "country" to "Japan", "capital" to true, "population" to 9000000, "regions" to listOf("kanto", "honshu"), ) cities.document("TOK").set(data4) val data5 = hashMapOf( "name" to "Beijing", "state" to null, "country" to "China", "capital" to true, "population" to 21500000, "regions" to listOf("jingjinji", "hebei"), ) cities.document("BJ").set(data5)
Java
CollectionReference cities = db.collection("cities"); Map<String, Object> data1 = new HashMap<>(); data1.put("name", "San Francisco"); data1.put("state", "CA"); data1.put("country", "USA"); data1.put("capital", false); data1.put("population", 860000); data1.put("regions", Arrays.asList("west_coast", "norcal")); cities.document("SF").set(data1); Map<String, Object> data2 = new HashMap<>(); data2.put("name", "Los Angeles"); data2.put("state", "CA"); data2.put("country", "USA"); data2.put("capital", false); data2.put("population", 3900000); data2.put("regions", Arrays.asList("west_coast", "socal")); cities.document("LA").set(data2); Map<String, Object> data3 = new HashMap<>(); data3.put("name", "Washington D.C."); data3.put("state", null); data3.put("country", "USA"); data3.put("capital", true); data3.put("population", 680000); data3.put("regions", Arrays.asList("east_coast")); cities.document("DC").set(data3); Map<String, Object> data4 = new HashMap<>(); data4.put("name", "Tokyo"); data4.put("state", null); data4.put("country", "Japan"); data4.put("capital", true); data4.put("population", 9000000); data4.put("regions", Arrays.asList("kanto", "honshu")); cities.document("TOK").set(data4); Map<String, Object> data5 = new HashMap<>(); data5.put("name", "Beijing"); data5.put("state", null); data5.put("country", "China"); data5.put("capital", true); data5.put("population", 21500000); data5.put("regions", Arrays.asList("jingjinji", "hebei")); cities.document("BJ").set(data5);
Dart
final cities = db.collection("cities"); final data1 = <String, dynamic>{ "name": "San Francisco", "state": "CA", "country": "USA", "capital": false, "population": 860000, "regions": ["west_coast", "norcal"] }; cities.doc("SF").set(data1); final data2 = <String, dynamic>{ "name": "Los Angeles", "state": "CA", "country": "USA", "capital": false, "population": 3900000, "regions": ["west_coast", "socal"], }; cities.doc("LA").set(data2); final data3 = <String, dynamic>{ "name": "Washington D.C.", "state": null, "country": "USA", "capital": true, "population": 680000, "regions": ["east_coast"] }; cities.doc("DC").set(data3); final data4 = <String, dynamic>{ "name": "Tokyo", "state": null, "country": "Japan", "capital": true, "population": 9000000, "regions": ["kanto", "honshu"] }; cities.doc("TOK").set(data4); final data5 = <String, dynamic>{ "name": "Beijing", "state": null, "country": "China", "capital": true, "population": 21500000, "regions": ["jingjinji", "hebei"], }; cities.doc("BJ").set(data5);
জাভা
পাইথন
class City: def __init__(self, name, state, country, capital=False, population=0, regions=[]): self.name = name self.state = state self.country = country self.capital = capital self.population = population self.regions = regions @staticmethod def from_dict(source): # ... def to_dict(self): # ... def __repr__(self): return f"City(\ name={self.name}, \ country={self.country}, \ population={self.population}, \ capital={self.capital}, \ regions={self.regions}\ )"
cities_ref = db.collection("cities") cities_ref.document("BJ").set( City("Beijing", None, "China", True, 21500000, ["hebei"]).to_dict() ) cities_ref.document("SF").set( City( "San Francisco", "CA", "USA", False, 860000, ["west_coast", "norcal"] ).to_dict() ) cities_ref.document("LA").set( City( "Los Angeles", "CA", "USA", False, 3900000, ["west_coast", "socal"] ).to_dict() ) cities_ref.document("DC").set( City("Washington D.C.", None, "USA", True, 680000, ["east_coast"]).to_dict() ) cities_ref.document("TOK").set( City("Tokyo", None, "Japan", True, 9000000, ["kanto", "honshu"]).to_dict() )
Python
class City: def __init__(self, name, state, country, capital=False, population=0, regions=[]): self.name = name self.state = state self.country = country self.capital = capital self.population = population self.regions = regions @staticmethod def from_dict(source): # ... def to_dict(self): # ... def __repr__(self): return f"City(\ name={self.name}, \ country={self.country}, \ population={self.population}, \ capital={self.capital}, \ regions={self.regions}\ )"
cities_ref = db.collection("cities") await cities_ref.document("BJ").set( City("Beijing", None, "China", True, 21500000, ["hebei"]).to_dict() ) await cities_ref.document("SF").set( City( "San Francisco", "CA", "USA", False, 860000, ["west_coast", "norcal"] ).to_dict() ) await cities_ref.document("LA").set( City( "Los Angeles", "CA", "USA", False, 3900000, ["west_coast", "socal"] ).to_dict() ) await cities_ref.document("DC").set( City("Washington D.C.", None, "USA", True, 680000, ["east_coast"]).to_dict() ) await cities_ref.document("TOK").set( City("Tokyo", None, "Japan", True, 9000000, ["kanto", "honshu"]).to_dict() )
সি++
CollectionReference cities = db->Collection("cities"); cities.Document("SF").Set({ {"name", FieldValue::String("San Francisco")}, {"state", FieldValue::String("CA")}, {"country", FieldValue::String("USA")}, {"capital", FieldValue::Boolean(false)}, {"population", FieldValue::Integer(860000)}, {"regions", FieldValue::Array({FieldValue::String("west_coast"), FieldValue::String("norcal")})}, }); cities.Document("LA").Set({ {"name", FieldValue::String("Los Angeles")}, {"state", FieldValue::String("CA")}, {"country", FieldValue::String("USA")}, {"capital", FieldValue::Boolean(false)}, {"population", FieldValue::Integer(3900000)}, {"regions", FieldValue::Array({FieldValue::String("west_coast"), FieldValue::String("socal")})}, }); cities.Document("DC").Set({ {"name", FieldValue::String("Washington D.C.")}, {"state", FieldValue::Null()}, {"country", FieldValue::String("USA")}, {"capital", FieldValue::Boolean(true)}, {"population", FieldValue::Integer(680000)}, {"regions", FieldValue::Array({FieldValue::String("east_coast")})}, }); cities.Document("TOK").Set({ {"name", FieldValue::String("Tokyo")}, {"state", FieldValue::Null()}, {"country", FieldValue::String("Japan")}, {"capital", FieldValue::Boolean(true)}, {"population", FieldValue::Integer(9000000)}, {"regions", FieldValue::Array({FieldValue::String("kanto"), FieldValue::String("honshu")})}, }); cities.Document("BJ").Set({ {"name", FieldValue::String("Beijing")}, {"state", FieldValue::Null()}, {"country", FieldValue::String("China")}, {"capital", FieldValue::Boolean(true)}, {"population", FieldValue::Integer(21500000)}, {"regions", FieldValue::Array({FieldValue::String("jingjinji"), FieldValue::String("hebei")})}, });
নোড.জেএস
যান
পিএইচপি
ঐক্য
CollectionReference citiesRef = db.Collection("cities"); citiesRef.Document("SF").SetAsync(new Dictionary<string, object>(){ { "Name", "San Francisco" }, { "State", "CA" }, { "Country", "USA" }, { "Capital", false }, { "Population", 860000 }, { "Regions", new ArrayList{"west_coast", "norcal"} } }); citiesRef.Document("LA").SetAsync(new Dictionary<string, object>(){ { "Name", "Los Angeles" }, { "State", "CA" }, { "Country", "USA" }, { "Capital", false }, { "Population", 3900000 }, { "Regions", new ArrayList{"west_coast", "socal"} } }); citiesRef.Document("DC").SetAsync(new Dictionary<string, object>(){ { "Name", "Washington D.C." }, { "State", null }, { "Country", "USA" }, { "Capital", true }, { "Population", 680000 }, { "Regions", new ArrayList{"east_coast"} } }); citiesRef.Document("TOK").SetAsync(new Dictionary<string, object>(){ { "Name", "Tokyo" }, { "State", null }, { "Country", "Japan" }, { "Capital", true }, { "Population", 9000000 }, { "Regions", new ArrayList{"kanto", "honshu"} } }); citiesRef.Document("BJ").SetAsync(new Dictionary<string, object>(){ { "Name", "Beijing" }, { "State", null }, { "Country", "China" }, { "Capital", true }, { "Population", 21500000 }, { "Regions", new ArrayList{"jingjinji", "hebei"} } });
সি#
রুবি
সহজ প্রশ্ন
নিম্নলিখিত কোয়েরিটি CA রাজ্যের সমস্ত শহর ফেরত দেয়:
Web
// Create a reference to the cities collection import { collection, query, where } from "firebase/firestore"; const citiesRef = collection(db, "cities"); // Create a query against the collection. const q = query(citiesRef, where("state", "==", "CA"));
Web
// Create a reference to the cities collection var citiesRef = db.collection("cities"); // Create a query against the collection. var query = citiesRef.where("state", "==", "CA");
সুইফট
// Create a reference to the cities collection let citiesRef = db.collection("cities") // Create a query against the collection. let query = citiesRef.whereField("state", isEqualTo: "CA")
উদ্দেশ্য-সি
// Create a reference to the cities collection FIRCollectionReference *citiesRef = [self.db collectionWithPath:@"cities"]; // Create a query against the collection. FIRQuery *query = [citiesRef queryWhereField:@"state" isEqualTo:@"CA"];
Kotlin
// Create a reference to the cities collection val citiesRef = db.collection("cities") // Create a query against the collection. val query = citiesRef.whereEqualTo("state", "CA")
Java
// Create a reference to the cities collection CollectionReference citiesRef = db.collection("cities"); // Create a query against the collection. Query query = citiesRef.whereEqualTo("state", "CA");
Dart
// Create a reference to the cities collection final citiesRef = db.collection("cities"); // Create a query against the collection. final query = citiesRef.where("state", isEqualTo: "CA");
জাভা
পাইথন
Python
সি++
CollectionReference cities_ref = db->Collection("cities"); // Create a query against the collection. Query query_ca = cities_ref.WhereEqualTo("state", FieldValue::String("CA"));
নোড.জেএস
যান
পিএইচপি
ঐক্য
CollectionReference citiesRef = db.Collection("cities"); Query query = citiesRef.WhereEqualTo("State", "CA"); query.GetSnapshotAsync().ContinueWithOnMainThread((querySnapshotTask) => { foreach (DocumentSnapshot documentSnapshot in querySnapshotTask.Result.Documents) { Debug.Log(String.Format("Document {0} returned by query State=CA", documentSnapshot.Id)); } });
সি#
রুবি
নিম্নলিখিত কোয়েরিটি সমস্ত রাজধানী শহরগুলো ফেরত দেয়:
Web
import { collection, query, where } from "firebase/firestore"; const citiesRef = collection(db, "cities"); const q = query(citiesRef, where("capital", "==", true));
Web
var citiesRef = db.collection("cities"); var query = citiesRef.where("capital", "==", true);
সুইফট
let capitalCities = db.collection("cities").whereField("capital", isEqualTo: true)
উদ্দেশ্য-সি
FIRQuery *capitalCities = [[self.db collectionWithPath:@"cities"] queryWhereField:@"capital" isEqualTo:@YES];
Kotlin
val capitalCities = db.collection("cities").whereEqualTo("capital", true)
Java
Query capitalCities = db.collection("cities").whereEqualTo("capital", true);
Dart
final capitalcities = db.collection("cities").where("capital", isEqualTo: true);
জাভা
পাইথন
Python
সি++
Query capital_cities = db->Collection("cities").WhereEqualTo( "capital", FieldValue::Boolean(true));
নোড.জেএস
যান
পিএইচপি
ঐক্য
CollectionReference citiesRef = db.Collection("cities"); Query query = citiesRef.WhereEqualTo("Capital", true); query.GetSnapshotAsync().ContinueWithOnMainThread((querySnapshotTask) => { foreach (DocumentSnapshot documentSnapshot in querySnapshotTask.Result.Documents) { Debug.Log(String.Format("Document {0} returned by query Capital=true", documentSnapshot.Id)); } });
সি#
রুবি
একটি কোয়েরি চালান
কোয়েরি অবজেক্ট তৈরি করার পর, ফলাফল পুনরুদ্ধার করতে get() ফাংশনটি ব্যবহার করুন:
Web
import { collection, query, where, getDocs } from "firebase/firestore"; const q = query(collection(db, "cities"), where("capital", "==", true)); const querySnapshot = await getDocs(q); querySnapshot.forEach((doc) => { // doc.data() is never undefined for query doc snapshots console.log(doc.id, " => ", doc.data()); });
Web
db.collection("cities").where("capital", "==", true) .get() .then((querySnapshot) => { querySnapshot.forEach((doc) => { // doc.data() is never undefined for query doc snapshots console.log(doc.id, " => ", doc.data()); }); }) .catch((error) => { console.log("Error getting documents: ", error); });
সুইফট
do { let querySnapshot = try await db.collection("cities").whereField("capital", isEqualTo: true) .getDocuments() for document in querySnapshot.documents { print("\(document.documentID) => \(document.data())") } } catch { print("Error getting documents: \(error)") }
উদ্দেশ্য-সি
[[[self.db collectionWithPath:@"cities"] queryWhereField:@"capital" isEqualTo:@(YES)] getDocumentsWithCompletion:^(FIRQuerySnapshot *snapshot, NSError *error) { if (error != nil) { NSLog(@"Error getting documents: %@", error); } else { for (FIRDocumentSnapshot *document in snapshot.documents) { NSLog(@"%@ => %@", document.documentID, document.data); } } }];
Kotlin
db.collection("cities") .whereEqualTo("capital", true) .get() .addOnSuccessListener { documents -> for (document in documents) { Log.d(TAG, "${document.id} => ${document.data}") } } .addOnFailureListener { exception -> Log.w(TAG, "Error getting documents: ", exception) }
Java
db.collection("cities") .whereEqualTo("capital", true) .get() .addOnCompleteListener(new OnCompleteListener<QuerySnapshot>() { @Override public void onComplete(@NonNull Task<QuerySnapshot> task) { if (task.isSuccessful()) { for (QueryDocumentSnapshot document : task.getResult()) { Log.d(TAG, document.getId() + " => " + document.getData()); } } else { Log.d(TAG, "Error getting documents: ", task.getException()); } } });
Dart
db.collection("cities").where("capital", isEqualTo: true).get().then( (querySnapshot) { print("Successfully completed"); for (var docSnapshot in querySnapshot.docs) { print('${docSnapshot.id} => ${docSnapshot.data()}'); } }, onError: (e) => print("Error completing: $e"), );
জাভা
পাইথন
Python
সি++
db->Collection("cities") .WhereEqualTo("capital", FieldValue::Boolean(true)) .Get() .OnCompletion([](const Future<QuerySnapshot>& future) { if (future.error() == Error::kErrorOk) { for (const DocumentSnapshot& document : future.result()->documents()) { std::cout << document << std::endl; } } else { std::cout << "Error getting documents: " << future.error_message() << std::endl; } });
নোড.জেএস
যান
পিএইচপি
পিএইচপি
Cloud Firestore ক্লায়েন্ট ইনস্টল এবং তৈরি করার বিষয়ে আরও জানতে, Cloud Firestore ক্লায়েন্ট লাইব্রেরি দেখুন।
ঐক্য
Query capitalQuery = db.Collection("cities").WhereEqualTo("Capital", true); capitalQuery.GetSnapshotAsync().ContinueWithOnMainThread(task => { QuerySnapshot capitalQuerySnapshot = task.Result; foreach (DocumentSnapshot documentSnapshot in capitalQuerySnapshot.Documents) { Debug.Log(String.Format("Document data for {0} document:", documentSnapshot.Id)); Dictionary<string, object> city = documentSnapshot.ToDictionary(); foreach (KeyValuePair<string, object> pair in city) { Debug.Log(String.Format("{0}: {1}", pair.Key, pair.Value)); } // Newline to separate entries Debug.Log(""); }; });
সি#
রুবি
কোয়েরির ফলাফল পুনরুদ্ধার করার বিষয়ে আরও তথ্যের জন্য 'Get Data' দেখুন। আপনি বর্তমান ফলাফল পেতে এবং ভবিষ্যতের আপডেটের জন্য অপেক্ষা করতে একটি কোয়েরিতে লিসেনারও যোগ করতে পারেন।
কোয়েরি অপারেটর
` where() ` মেথডটি তিনটি প্যারামিটার গ্রহণ করে: ফিল্টার করার জন্য একটি ফিল্ড, একটি তুলনা অপারেটর এবং একটি ভ্যালু। কোর অপারেশনগুলো নিম্নলিখিত তুলনা অপারেটরগুলোকে সমর্থন করে:
-
<কম -
<=কম বা সমান -
==সমান - এর চেয়ে
> -
>=এর চেয়ে বড় বা সমান -
!=সমান নয় -
array-contains -
array-contains-any -
in -
not-in
উদাহরণস্বরূপ:
Web
const stateQuery = query(citiesRef, where("state", "==", "CA")); const populationQuery = query(citiesRef, where("population", "<", 100000)); const nameQuery = query(citiesRef, where("name", ">=", "San Francisco"));
Web
const stateQuery = citiesRef.where("state", "==", "CA"); const populationQuery = citiesRef.where("population", "<", 100000); const nameQuery = citiesRef.where("name", ">=", "San Francisco");
সুইফট
let stateQuery = citiesRef.whereField("state", isEqualTo: "CA") let populationQuery = citiesRef.whereField("population", isLessThan: 100000) let nameQuery = citiesRef.whereField("name", isGreaterThanOrEqualTo: "San Francisco")
উদ্দেশ্য-সি
FIRQuery *stateQuery = [citiesRef queryWhereField:@"state" isEqualTo:@"CA"]; FIRQuery *populationQuery = [citiesRef queryWhereField:@"population" isLessThan:@100000]; FIRQuery *nameQuery = [citiesRef queryWhereField:@"name" isGreaterThanOrEqualTo:@"San Francisco"];
Kotlin
val stateQuery = citiesRef.whereEqualTo("state", "CA") val populationQuery = citiesRef.whereLessThan("population", 100000) val nameQuery = citiesRef.whereGreaterThanOrEqualTo("name", "San Francisco")
Java
Query stateQuery = citiesRef.whereEqualTo("state", "CA"); Query populationQuery = citiesRef.whereLessThan("population", 100000); Query nameQuery = citiesRef.whereGreaterThanOrEqualTo("name", "San Francisco");
Dart
final citiesRef = db.collection("cities"); final stateQuery = citiesRef.where("state", isEqualTo: "CA"); final populationQuery = citiesRef.where("population", isLessThan: 100000); final nameQuery = citiesRef.where("name", isEqualTo: "San Francisco");
জাভা
পাইথন
Python
সি++
cities_ref.WhereEqualTo("state", FieldValue::String("CA")); cities_ref.WhereLessThan("population", FieldValue::Integer(100000)); cities_ref.WhereGreaterThanOrEqualTo("name", FieldValue::String("San Francisco"));
নোড.জেএস
যান
পিএইচপি
ঐক্য
Query stateQuery = citiesRef.WhereEqualTo("State", "CA"); Query populationQuery = citiesRef.WhereGreaterThan("Population", 1000000); Query nameQuery = citiesRef.WhereGreaterThanOrEqualTo("Name", "San Francisco");
সি#
রুবি
সমান নয় ( != )
যেসব ডকুমেন্টে প্রদত্ত ফিল্ডটি বিদ্যমান কিন্তু তুলনামূলক মানের সাথে মেলে না, সেগুলো ফেরত পেতে নট ইকুয়াল ( != ) অপারেটরটি ব্যবহার করুন। উদাহরণস্বরূপ:
Web
const notCapitalQuery = query(citiesRef, where("capital", "!=", false));
Web
citiesRef.where("capital", "!=", false);
সুইফট
let notEqualQuery = citiesRef.whereField("capital", isNotEqualTo: false)
উদ্দেশ্য-সি
query = [citiesRef queryWhereField:@"capital" isNotEqualTo:@NO];
Kotlin
val notCapitalQuery = citiesRef.whereNotEqualTo("capital", false)
Java
Query notCapitalQuery = citiesRef.whereNotEqualTo("capital", false);
Dart
final citiesRef = db.collection("cities"); final notCapitals = citiesRef.where("capital", isNotEqualTo: true);
জাভা
পাইথন
// Snippet not yet available
সি++
cities_ref.WhereNotEqualTo("capital", FieldValue::Boolean(false));
নোড.জেএস
যান
// Snippet not yet availableপিএইচপি
ঐক্য
Query query = citiesRef.WhereNotEqualTo("capital", false); Query query = citiesRef.WhereNotEqualTo("capital", false);
সি#
// Snippet not yet availableরুবি
এই কোয়েরিটি এমন প্রতিটি city ডকুমেন্ট ফেরত দেয় যেখানে ' capital ফিল্ডের মান false বা null ছাড়া অন্য কিছু। এর মধ্যে city ডকুমেন্টও অন্তর্ভুক্ত যেখানে ' capital ' ফিল্ডের মান true অথবা null ছাড়া অন্য কোনো নন-বুলিয়ান মান।
এই কোয়েরিটি city ডকুমেন্ট ফেরত দেয় না যেখানে ' capital ফিল্ডটি বিদ্যমান নেই। নট-ইকুয়াল ( != ) এবং not-in কোয়েরিগুলো সেইসব ডকুমেন্ট বাদ দেয় যেখানে প্রদত্ত ফিল্ডটি বিদ্যমান নেই ।
একটি ফিল্ড তখনই বিদ্যমান থাকে যখন সেটিকে যেকোনো মানে সেট করা হয়, যার মধ্যে একটি খালি স্ট্রিং ( "" ), null , এবং NaN (সংখ্যা নয়) অন্তর্ভুক্ত। উল্লেখ্য যে, null ফিল্ড মান != ক্লজের সাথে মেলে না, কারণ x != null এর মান undefined ।
স্ট্যান্ডার্ড সংস্করণের সীমাবদ্ধতা
!= কোয়েরির ক্ষেত্রে নিম্নলিখিত সীমাবদ্ধতাগুলো লক্ষ্য করুন। এই সীমাবদ্ধতাগুলো শুধুমাত্র স্ট্যান্ডার্ড সংস্করণের জন্য প্রযোজ্য:
- শুধুমাত্র সেইসব ডকুমেন্টই কোয়েরিটির সাথে মিলতে পারবে, যেগুলিতে প্রদত্ত ফিল্ডটি বিদ্যমান।
- একটি যৌগিক কোয়েরিতে
not-inএবং!=একসাথে ব্যবহার করা যায় না।
অ্যারে সদস্যপদ
আপনি অ্যারের মানগুলোর ওপর ভিত্তি করে ফিল্টার করতে array-contains অপারেটরটি ব্যবহার করতে পারেন। উদাহরণস্বরূপ:
Web
import { query, where } from "firebase/firestore"; const q = query(citiesRef, where("regions", "array-contains", "west_coast"));
Web
citiesRef.where("regions", "array-contains", "west_coast");
সুইফট
citiesRef .whereField("regions", arrayContains: "west_coast")
উদ্দেশ্য-সি
[citiesRef queryWhereField:@"state" arrayContains:@"west_coast"];
Kotlin
val citiesRef = db.collection("cities") citiesRef.whereArrayContains("regions", "west_coast")
Java
CollectionReference citiesRef = db.collection("cities"); citiesRef.whereArrayContains("regions", "west_coast");
Dart
final citiesRef = db.collection("cities"); final westCoastcities = citiesRef.where("regions", arrayContains: "west_coast");
জাভা
পাইথন
Python
সি++
CollectionReference cities_ref = db->Collection("cities"); cities_ref.WhereArrayContains("region", FieldValue::String("west_coast"));
নোড.জেএস
যান
পিএইচপি
ঐক্য
CollectionReference citiesRef = db.Collection("cities"); Query arrayContainsQuery = citiesRef.WhereArrayContains("region", "west_coast");
সি#
রুবি
এই কোয়েরিটি এমন প্রতিটি city ডকুমেন্ট ফেরত দেয়, যেখানে regions ফিল্ডটি একটি অ্যারে এবং সেই অ্যারেতে west_coast ' অন্তর্ভুক্ত রয়েছে। যদি অ্যারেটিতে আপনার কোয়েরির মানটি একাধিকবার থাকে, তবে ডকুমেন্টটি ফলাফলে কেবল একবারই অন্তর্ভুক্ত করা হয়।
আপনি প্রতিটি ডিসজাংশন ( or গ্রুপ)-এ সর্বাধিক একটি array-contains ক্লজ ব্যবহার করতে পারেন। আপনি একই ডিসজাংশনে array-contains এবং array-contains-any একত্রিত করতে পারবেন না।
in , not-in , এবং array-contains-any
লজিক্যাল OR ব্যবহার করে একই ফিল্ডে ৩০টি পর্যন্ত ইকুয়ালিটি ( == ) ক্লজ একত্রিত করতে in অপারেটরটি ব্যবহার করুন। একটি in কোয়েরি সেইসব ডকুমেন্ট রিটার্ন করে, যেখানে প্রদত্ত ফিল্ডটি তুলনার মানগুলোর যেকোনো একটির সাথে মেলে। উদাহরণস্বরূপ:
Web
import { query, where } from "firebase/firestore"; const q = query(citiesRef, where('country', 'in', ['USA', 'Japan']));
Web
citiesRef.where('country', 'in', ['USA', 'Japan']);
সুইফট
let citiesRef = db.collection("cities") citiesRef.whereField("country", in: ["USA", "Japan"])
উদ্দেশ্য-সি
FIRCollectionReference *citiesRef = [self.db collectionWithPath:@"cities"]; [citiesRef queryWhereField:@"country" in:@[@"USA", @"Japan"]];
Kotlin
val citiesRef = db.collection("cities") citiesRef.whereIn("country", listOf("USA", "Japan"))
Java
CollectionReference citiesRef = db.collection("cities"); citiesRef.whereIn("country", Arrays.asList("USA", "Japan"));
Dart
final citiesRef = db.collection("cities"); final cities = citiesRef.where("country", whereIn: ["USA", "Japan"]);
জাভা
পাইথন
Python
সি++
CollectionReference cities_ref = db->Collection("cities"); cities_ref.WhereIn("country", std::vector<FieldValue> { FieldValue::String("USA"), FieldValue::String("Japan") });
নোড.জেএস
যান
পিএইচপি
ঐক্য
CollectionReference citiesRef = db.Collection("cities"); ListcountriesList = new List<object>() {"USA", "Japan"}; Query whereInQuery = citiesRef.WhereIn("country", countriesList);
সি#
রুবি
এই কোয়েরিটি এমন প্রতিটি city ডকুমেন্ট ফেরত দেয়, যেখানে country ফিল্ডটি USA বা Japan হিসেবে সেট করা আছে। উদাহরণ ডেটা অনুযায়ী, এর মধ্যে SF , LA , DC , এবং TOK ডকুমেন্টগুলো অন্তর্ভুক্ত।
not-in
একই ফিল্ডে লজিক্যাল AND ব্যবহার করে সর্বোচ্চ ১০টি অসমান ( != ) ক্লজ একত্রিত করতে not-in অপারেটরটি ব্যবহার করুন। একটি not-in কোয়েরি সেইসব ডকুমেন্ট ফেরত দেয় যেখানে প্রদত্ত ফিল্ডটি বিদ্যমান, null নয়, এবং তুলনার জন্য দেওয়া কোনো মানের সাথে মেলে না। উদাহরণস্বরূপ:
Web
import { query, where } from "firebase/firestore"; const q = query(citiesRef, where('country', 'not-in', ['USA', 'Japan']));
Web
citiesRef.where('country', 'not-in', ['USA', 'Japan']);
সুইফট
citiesRef.whereField("country", notIn: ["USA", "Japan"])
উদ্দেশ্য-সি
[citiesRef queryWhereField:@"country" notIn:@[@"USA", @"Japan"]];
Kotlin
citiesRef.whereNotIn("country", listOf("USA", "Japan"))
Java
citiesRef.whereNotIn("country", Arrays.asList("USA", "Japan"));
Dart
final citiesRef = db.collection("cities"); final cities = citiesRef.where("country", whereNotIn: ["USA", "Japan"]);
জাভা
পাইথন
// Snippet not yet available
সি++
cities_ref.WhereNotIn("country", std::vector<FieldValue> { FieldValue::String("USA"), FieldValue::String("Japan") });
নোড.জেএস
যান
// Snippet not yet availableপিএইচপি
ঐক্য
Query query = citiesRef.WhereNotIn(new FieldPath("country"), new List<string>{"USA", "Japan"}); Query query = citiesRef.WhereNotIn("country", new List<object>(){"USA", "Japan"});
সি#
// Snippet not yet availableরুবি
এই কোয়েরিটি এমন প্রতিটি city ডকুমেন্ট ফেরত দেয় যেখানে country ফিল্ডটি বিদ্যমান এবং সেটির মান USA , Japan বা null সেট করা নেই। উদাহরণ ডেটা অনুযায়ী, এর মধ্যে London এবং Hong Kong ডকুমেন্টগুলো অন্তর্ভুক্ত।
not-in কোয়েরি সেইসব ডকুমেন্ট বাদ দেয় যেখানে প্রদত্ত ফিল্ডটি বিদ্যমান নেই। একটি ফিল্ড তখনই বিদ্যমান থাকে যখন সেটির মান যেকোনো কিছু দিয়ে সেট করা থাকে, যার মধ্যে রয়েছে একটি খালি স্ট্রিং ( "" ), null ), এবং NaN (NaN) (যা কোনো সংখ্যা নয়)। উল্লেখ্য যে, x != null মান হয় undefined )। তুলনার মানগুলোর মধ্যে একটি হিসেবে null (null) থাকলে, একটি not-in কোয়েরি কোনো ডকুমেন্টের সাথেই মেলে না।
array-contains-any
একই ফিল্ডে লজিক্যাল OR ব্যবহার করে ৩০টি পর্যন্ত array-contains ক্লজ একত্রিত করতে array-contains-any অপারেটরটি ব্যবহার করুন। একটি array-contains-any কোয়েরি সেইসব ডকুমেন্ট রিটার্ন করে, যেখানে প্রদত্ত ফিল্ডটি একটি অ্যারে এবং সেই অ্যারেতে এক বা একাধিক তুলনামূলক মান থাকে:
Web
import { query, where } from "firebase/firestore"; const q = query(citiesRef, where('regions', 'array-contains-any', [['west_coast'], ['east_coast']]));
Web
citiesRef.where('regions', 'array-contains-any', [['west_coast'], ['east_coast']]);
সুইফট
let citiesRef = db.collection("cities") citiesRef.whereField("regions", arrayContainsAny: ["west_coast", "east_coast"])
উদ্দেশ্য-সি
FIRCollectionReference *citiesRef = [self.db collectionWithPath:@"cities"]; [citiesRef queryWhereField:@"regions" arrayContainsAny:@[@"west_coast", @"east_coast"]];
Kotlin
val citiesRef = db.collection("cities") citiesRef.whereArrayContainsAny("regions", listOf("west_coast", "east_coast"))
Java
CollectionReference citiesRef = db.collection("cities"); citiesRef.whereArrayContainsAny("regions", Arrays.asList("west_coast", "east_coast"));
Dart
final citiesRef = db.collection("cities"); final cities = citiesRef .where("regions", arrayContainsAny: ["west_coast", "east_coast"]);
জাভা
পাইথন
Python
সি++
CollectionReference cities_ref = db->Collection("cities"); cities_ref.WhereArrayContainsAny("region", std::vector<FieldValue> { FieldValue::String("west_coast"), FieldValue::String("east_coast") });
নোড.জেএস
যান
পিএইচপি
ঐক্য
Query query = citiesRef.WhereArrayContainsAny( "regions", new List<object>() { new List<object>(){"west_coast"}, new List<object>(){"east_coast"}});
সি#
রুবি
এই কোয়েরিটি এমন প্রতিটি শহরের ডকুমেন্ট ফেরত দেয়, যেখানে regions ' ফিল্ডটি একটি অ্যারে এবং তাতে west_coast বা east_coast রয়েছে। উদাহরণ ডেটা অনুসারে, এর মধ্যে SF , LA , এবং DC ডকুমেন্টগুলো অন্তর্ভুক্ত।
array-contains-any থেকে প্রাপ্ত ফলাফল থেকে ডুপ্লিকেটগুলো বাদ দেওয়া হয়। এমনকি যদি কোনো ডকুমেন্টের অ্যারে ফিল্ড একাধিক তুলনামূলক মানের সাথে মিলে যায়, তবুও ফলাফল সেটে সেই ডকুমেন্টটি শুধুমাত্র একবারই অন্তর্ভুক্ত থাকে।
array-contains-any সর্বদা অ্যারে ডেটা টাইপ অনুসারে ফিল্টার করে। উদাহরণস্বরূপ, উপরের কোয়েরিটি এমন কোনো শহরের ডকুমেন্ট ফেরত দেবে না, যেখানে ` regions ফিল্ডটি অ্যারের পরিবর্তে west_coast স্ট্রিংটি।
আপনি in জন্য একটি অ্যারে ভ্যালুকে তুলনার মান হিসেবে ব্যবহার করতে পারেন, কিন্তু array-contains-any মতো নয়, এই ক্লজটি অ্যারের দৈর্ঘ্য, ক্রম এবং ভ্যালুগুলোর হুবহু মিল খুঁজে বের করে। উদাহরণস্বরূপ:
Web
import { query, where } from "firebase/firestore"; const q = query(citiesRef, where('regions', 'in', [['west_coast'], ['east_coast']]));
Web
citiesRef.where('regions', 'in', [['west_coast'], ['east_coast']]);
সুইফট
citiesRef.whereField("regions", in: [["west_coast"], ["east_coast"]])
উদ্দেশ্য-সি
[citiesRef queryWhereField:@"regions" in:@[@[@"west_coast"], @[@"east_coast"]]];
Kotlin
citiesRef.whereIn("regions", listOf(arrayOf("west_coast"), arrayOf("east_coast")))
Java
citiesRef.whereIn("regions", Arrays.asList(new String[]{"west_coast"}, new String[]{"east_coast"}));
Dart
final citiesRef = db.collection("cities"); final cities = citiesRef.where("regions", whereIn: [ ["west_coast"], ["east_coast"] ]);
জাভা
পাইথন
Python
সি++
cities_ref.WhereIn("region", std::vector<FieldValue> { FieldValue::String("west_coast"), FieldValue::String("east_coast") });
নোড.জেএস
যান
পিএইচপি
ঐক্য
Query query = citiesRef.WhereIn(new FieldPath("regions"), new List<string>{"west_coast", "east_coast"});
সি#
রুবি
এই কোয়েরিটি এমন প্রতিটি শহরের ডকুমেন্ট ফেরত দেয়, যেখানে ' regions ' ফিল্ডটি একটি অ্যারে এবং সেই অ্যারেতে west_coast অথবা east_coast এর মধ্যে ঠিক একটি উপাদান রয়েছে। উদাহরণ ডেটা থেকে, শুধুমাত্র DC ডকুমেন্টটিই তার regions ফিল্ডের মান ["east_coast"] হওয়ায় এই শর্ত পূরণ করে। কিন্তু SF ডকুমেন্টটি মেলে না, কারণ এর regions ফিল্ডের মান হলো ["west_coast", "norcal"] ।
স্ট্যান্ডার্ড সংস্করণের সীমাবদ্ধতা
in , not-in , এবং array-contains-any এর জন্য নিম্নলিখিত সীমাবদ্ধতাগুলো লক্ষ্য করুন। এই সীমাবদ্ধতাগুলো শুধুমাত্র স্ট্যান্ডার্ড সংস্করণের জন্য প্রযোজ্য:
- Cloud Firestore `
or,in, এবংarray-contains-anyঅপারেটরগুলোর মাধ্যমে লজিক্যালORকোয়েরি সমর্থন করে। কোয়েরির ডিসজাঙ্কটিভ নরমাল ফর্মের উপর ভিত্তি করে এই কোয়েরিগুলো ৩০টি ডিসজাংশনে সীমাবদ্ধ। এই সীমাটি নির্দিষ্ট এবং পরিবর্তনযোগ্য নয়। - আপনি প্রতিটি ডিসজাংশন (
orগ্রুপ)-এ সর্বাধিক একটিarray-containsক্লজ ব্যবহার করতে পারেন। আপনি একই ডিসজাংশনেarray-containsএবংarray-contains-anyএকত্রিত করতে পারবেন না। - আপনি
not-inএবং not equals!=একসাথে ব্যবহার করতে পারবেন না। -
not-inসর্বোচ্চ ১০টি তুলনা মান সমর্থন করে।
যৌগিক ( AND ) কোয়েরি
আপনি একাধিক সমতা অপারেটর ( == বা array-contains ) পরপর ব্যবহার করে লজিক্যাল AND মাধ্যমে সীমাবদ্ধতাগুলো একত্রিত করতে পারেন। তবে, সমতা অপারেটরগুলোর সাথে অসমতা অপারেটর < , <= , > , এবং != একত্রিত করতে হলে আপনাকে অবশ্যই একটি যৌগিক সূচক তৈরি করতে হবে।
Web
import { query, where } from "firebase/firestore"; const q1 = query(citiesRef, where("state", "==", "CO"), where("name", "==", "Denver")); const q2 = query(citiesRef, where("state", "==", "CA"), where("population", "<", 1000000));
Web
const q1 = citiesRef.where("state", "==", "CO").where("name", "==", "Denver"); const q2 = citiesRef.where("state", "==", "CA").where("population", "<", 1000000);
সুইফট
citiesRef .whereField("state", isEqualTo: "CO") .whereField("name", isEqualTo: "Denver") citiesRef .whereField("state", isEqualTo: "CA") .whereField("population", isLessThan: 1000000)
উদ্দেশ্য-সি
[[citiesRef queryWhereField:@"state" isEqualTo:@"CO"] queryWhereField:@"name" isGreaterThanOrEqualTo:@"Denver"]; [[citiesRef queryWhereField:@"state" isEqualTo:@"CA"] queryWhereField:@"population" isLessThan:@1000000];
Kotlin
citiesRef.whereEqualTo("state", "CO").whereEqualTo("name", "Denver") citiesRef.whereEqualTo("state", "CA").whereLessThan("population", 1000000)
Java
citiesRef.whereEqualTo("state", "CO").whereEqualTo("name", "Denver"); citiesRef.whereEqualTo("state", "CA").whereLessThan("population", 1000000);
Dart
final citiesRef = db.collection("cities"); citiesRef .where("state", isEqualTo: "CO") .where("name", isEqualTo: "Denver"); citiesRef .where("state", isEqualTo: "CA") .where("population", isLessThan: 1000000);
জাভা
পাইথন
Python
সি++
cities_ref.WhereEqualTo("state", FieldValue::String("CO")) .WhereEqualTo("name", FieldValue::String("Denver")); cities_ref.WhereEqualTo("state", FieldValue::String("CA")) .WhereLessThan("population", FieldValue::Integer(1000000));
নোড.জেএস
যান
পিএইচপি
ঐক্য
Query chainedQuery = citiesRef .WhereEqualTo("State", "CA") .WhereEqualTo("Name", "San Francisco");
সি#
রুবি
OR প্রশ্ন
আপনি লজিক্যাল OR ব্যবহার করে সীমাবদ্ধতাগুলোকে একত্রিত করতে পারেন। উদাহরণস্বরূপ:
Web
const q = query(citiesRef, or(where('capital', '==', true), where('population', '>=', 1000000) ) );
Web
উপলব্ধ নয়।
সুইফট
let query = db.collection("cities").whereFilter(Filter.orFilter([ Filter.whereField("capital", isEqualTo: true), Filter.whereField("population", isGreaterThanOrEqualTo: 1000000); ]))
উদ্দেশ্য-সি
FIRCollectionReference *collection = [self.db collectionWithPath:@"cities"]; FIRQuery *query = [collection queryWhereFilter:[FIRFilter orFilterWithFilters:@[ [FIRFilter filterWhereField:@"capital" isEqualTo:@YES], [FIRFilter filterWhereField:@"population" isGreaterThanOrEqualTo:@1000000] ]]];
Kotlin
val query = collection.where(Filter.or( Filter.equalTo("capital", true), Filter.greaterThanOrEqualTo("population", 1000000) ))
Java
Query query = collection.where(Filter.or( Filter.equalTo("capital", true), Filter.greaterThanOrEqualTo("population", 1000000) ));
Dart
var query = db.collection("cities").where( Filter.or( Filter("capital", isEqualTo: true), Filter("population", isGreaterThan: 1000000), ), );
জাভা
স্নিপেটটি উপলব্ধ নয়।
পাইথন
Python
স্নিপেটটি উপলব্ধ নয়।
সি++
স্নিপেটটি উপলব্ধ নয়।
নোড.জেএস
const bigCities = await citiesRef .where( Filter.or( Filter.where('capital', '==', true), Filter.where('population', '>=', 1000000) ) ) .get();
যান
পিএইচপি
স্নিপেটটি উপলব্ধ নয়।
ঐক্য
Query query = citiesRef.Where(Filter.Or( Filter.EqualTo("State", "CA"), Filter.GreaterThanOrEqualTo("population", 1000000) )); query.GetSnapshotAsync().ContinueWithOnMainThread((querySnapshotTask) => { foreach (DocumentSnapshot documentSnapshot in querySnapshotTask.Result.Documents) { Debug.Log(String.Format("Document {0} returned by query State=CA or population >= {1}", documentSnapshot.Id, 1000000)); } });
সি#
স্নিপেটটি উপলব্ধ নয়।
রুবি
স্নিপেটটি উপলব্ধ নয়।
Cloud Firestore OR কোয়েরি সম্পাদনের জন্য আপনার কম্পোজিট ইনডেক্স ব্যবহার করে। যদি আপনার ইনডেক্সগুলো কোয়েরিটি সমর্থন না করে, তবে Cloud Firestore আপনার ডাটাবেসের জন্য অতিরিক্ত ইনডেক্সের পরামর্শ দেয় ।
আপনি OR এবং AND অপারেশনের সংমিশ্রণের উপর ফিল্টার করতে OR কোয়েরির সাথে কম্পাউন্ড কোয়েরি একত্রিত করতে পারেন। উদাহরণস্বরূপ:
Web
const q = query(collection(db, "cities"), and( where('state', '==', 'CA'), or( where('capital', '==', true), where('population', '>=', 1000000) ) ));
Web
উপলব্ধ নয়।
সুইফট
let query = db.collection("cities").whereFilter(Filter.andFilter([ Filter.whereField("state", isEqualTo: "CA"), Filter.orFilter([ Filter.whereField("capital", isEqualTo: true), Filter.whereField("population", isGreaterOrEqualTo: 1000000) ]) ]))
উদ্দেশ্য-সি
FIRCollectionReference *collection = [self.db collectionWithPath:@"cities"]; FIRQuery *query = [collection queryWhereFilter:[FIRFilter andFilterWithFilters:@[ [FIRFilter filterWhereField:@"state" isEqualTo:@"CA"], [FIRFilter orFilterWithFilters:@[ [FIRFilter filterWhereField:@"capital" isEqualTo:@YES], [FIRFilter filterWhereField:@"population" isGreaterThanOrEqualTo:@1000000] ]] ]]];
Kotlin
val query = collection.where(Filter.and( Filter.equalTo("state", "CA"), Filter.or( Filter.equalTo("capital", true), Filter.greaterThanOrEqualTo("population", 1000000) ) ))
Java
Query query = collection.where(Filter.and( Filter.equalTo("state", "CA"), Filter.or( Filter.equalTo("capital", true), Filter.greaterThanOrEqualTo("population", 1000000) ) ));
Dart
var query = db.collection("cities").where( Filter.and( Filter("state", isEqualTo: "CA"), Filter.or( Filter("capital", isEqualTo: true), Filter("population", isGreaterThan: 1000000), ), ), );
জাভা
স্নিপেটটি উপলব্ধ নয়।
পাইথন
স্নিপেটটি উপলব্ধ নয়।
Python
স্নিপেটটি উপলব্ধ নয়।
সি++
স্নিপেটটি উপলব্ধ নয়।
নোড.জেএস
const bigCitiesInCalifornia = await citiesRef .where('state', '==', 'CA') .where( Filter.or( Filter.where('capital', '==', true), Filter.where('population', '>=', 1000000) ) ) .get();
যান
স্নিপেটটি উপলব্ধ নয়।
পিএইচপি
স্নিপেটটি উপলব্ধ নয়।
ঐক্য
Query query = citiesRef.Where(Filter.And( Filter.EqualTo("state", "CA"), Filter.Or( Filter.EqualTo("capital", true), Filter.GreaterThanOrEqualTo("population", 1000000) ) ));
সি#
স্নিপেটটি উপলব্ধ নয়।
রুবি
স্নিপেটটি উপলব্ধ নয়।
স্ট্যান্ডার্ড সংস্করণের সীমাবদ্ধতা
কোয়েরি or অনুসন্ধানের জন্য নিম্নলিখিত সীমাবদ্ধতাগুলি লক্ষ্য করুন। এই সীমাবদ্ধতাগুলি শুধুমাত্র স্ট্যান্ডার্ড সংস্করণের জন্য প্রযোজ্য:
Cloud Firestore একটি কোয়েরিকে তার ডিসজাঙ্কটিভ নরমাল ফর্মের উপর ভিত্তি করে সর্বোচ্চ ৩০টি ডিসজাংশনে সীমাবদ্ধ করে। এই সীমাটি স্থির এবং এটি পরিবর্তন করা যায় না। একাধিক
ORগ্রুপেরANDঅপারেশন করার সময় এই সীমায় পৌঁছানোর সম্ভাবনা বেশি থাকে।একই কোয়েরিতে আপনি
not-inসাথেin,array-contains-any, বাorএকসাথে ব্যবহার করতে পারবেন না।
সীমাবদ্ধতাগুলির সম্পূর্ণ বিবরণের জন্য, কোয়েরি সীমাবদ্ধতা দেখুন।
সংগ্রহ গোষ্ঠী কোয়েরি
একটি কালেকশন গ্রুপে একই আইডিযুক্ত সমস্ত কালেকশন অন্তর্ভুক্ত থাকে। ডিফল্টরূপে, কোয়েরিগুলো আপনার ডাটাবেসের একটিমাত্র কালেকশন থেকে ফলাফল সংগ্রহ করে। একটিমাত্র কালেকশনের পরিবর্তে একটি কালেকশন গ্রুপ থেকে ডকুমেন্ট সংগ্রহ করতে কালেকশন গ্রুপ কোয়েরি ব্যবহার করুন।
উদাহরণস্বরূপ, আপনি প্রতিটি শহরে একটি ল্যান্ডমার্ক সাব-কালেকশন যোগ করে একটি landmarks কালেকশন গ্রুপ তৈরি করতে পারেন:
Web
import { collection, addDoc } from "firebase/firestore"; const citiesRef = collection(db, 'cities'); await Promise.all([ addDoc(collection(citiesRef, 'SF', 'landmarks'), { name: 'Golden Gate Bridge', type: 'bridge' }), addDoc(collection(citiesRef, 'SF', 'landmarks'), { name: 'Legion of Honor', type: 'museum' }), addDoc(collection(citiesRef, 'LA', 'landmarks'), { name: 'Griffith Park', type: 'park' }), addDoc(collection(citiesRef, 'LA', 'landmarks'), { name: 'The Getty', type: 'museum' }), addDoc(collection(citiesRef, 'DC', 'landmarks'), { name: 'Lincoln Memorial', type: 'memorial' }), addDoc(collection(citiesRef, 'DC', 'landmarks'), { name: 'National Air and Space Museum', type: 'museum' }), addDoc(collection(citiesRef, 'TOK', 'landmarks'), { name: 'Ueno Park', type: 'park' }), addDoc(collection(citiesRef, 'TOK', 'landmarks'), { name: 'National Museum of Nature and Science', type: 'museum' }), addDoc(collection(citiesRef, 'BJ', 'landmarks'), { name: 'Jingshan Park', type: 'park' }), addDoc(collection(citiesRef, 'BJ', 'landmarks'), { name: 'Beijing Ancient Observatory', type: 'museum' }) ]);
Web
var citiesRef = db.collection('cities'); var landmarks = Promise.all([ citiesRef.doc('SF').collection('landmarks').doc().set({ name: 'Golden Gate Bridge', type: 'bridge' }), citiesRef.doc('SF').collection('landmarks').doc().set({ name: 'Legion of Honor', type: 'museum' }), citiesRef.doc('LA').collection('landmarks').doc().set({ name: 'Griffith Park', type: 'park' }), citiesRef.doc('LA').collection('landmarks').doc().set({ name: 'The Getty', type: 'museum' }), citiesRef.doc('DC').collection('landmarks').doc().set({ name: 'Lincoln Memorial', type: 'memorial' }), citiesRef.doc('DC').collection('landmarks').doc().set({ name: 'National Air and Space Museum', type: 'museum' }), citiesRef.doc('TOK').collection('landmarks').doc().set({ name: 'Ueno Park', type: 'park' }), citiesRef.doc('TOK').collection('landmarks').doc().set({ name: 'National Museum of Nature and Science', type: 'museum' }), citiesRef.doc('BJ').collection('landmarks').doc().set({ name: 'Jingshan Park', type: 'park' }), citiesRef.doc('BJ').collection('landmarks').doc().set({ name: 'Beijing Ancient Observatory', type: 'museum' }) ]);
সুইফট
let citiesRef = db.collection("cities") var data = ["name": "Golden Gate Bridge", "type": "bridge"] citiesRef.document("SF").collection("landmarks").addDocument(data: data) data = ["name": "Legion of Honor", "type": "museum"] citiesRef.document("SF").collection("landmarks").addDocument(data: data) data = ["name": "Griffith Park", "type": "park"] citiesRef.document("LA").collection("landmarks").addDocument(data: data) data = ["name": "The Getty", "type": "museum"] citiesRef.document("LA").collection("landmarks").addDocument(data: data) data = ["name": "Lincoln Memorial", "type": "memorial"] citiesRef.document("DC").collection("landmarks").addDocument(data: data) data = ["name": "National Air and Space Museum", "type": "museum"] citiesRef.document("DC").collection("landmarks").addDocument(data: data) data = ["name": "Ueno Park", "type": "park"] citiesRef.document("TOK").collection("landmarks").addDocument(data: data) data = ["name": "National Museum of Nature and Science", "type": "museum"] citiesRef.document("TOK").collection("landmarks").addDocument(data: data) data = ["name": "Jingshan Park", "type": "park"] citiesRef.document("BJ").collection("landmarks").addDocument(data: data) data = ["name": "Beijing Ancient Observatory", "type": "museum"] citiesRef.document("BJ").collection("landmarks").addDocument(data: data)
উদ্দেশ্য-সি
FIRCollectionReference *citiesRef = [self.db collectionWithPath:@"cities"]; NSDictionary *data = @{@"name": @"Golden Gate Bridge", @"type": @"bridge"}; [[[citiesRef documentWithPath:@"SF"] collectionWithPath:@"landmarks"] addDocumentWithData:data]; data = @{@"name": @"Legion of Honor", @"type": @"museum"}; [[[citiesRef documentWithPath:@"SF"] collectionWithPath:@"landmarks"] addDocumentWithData:data]; data = @{@"name": @"Griffith Park", @"type": @"park"}; [[[citiesRef documentWithPath:@"LA"] collectionWithPath:@"landmarks"] addDocumentWithData:data]; data = @{@"name": @"The Getty", @"type": @"museum"}; [[[citiesRef documentWithPath:@"LA"] collectionWithPath:@"landmarks"] addDocumentWithData:data]; data = @{@"name": @"Lincoln Memorial", @"type": @"memorial"}; [[[citiesRef documentWithPath:@"DC"] collectionWithPath:@"landmarks"] addDocumentWithData:data]; data = @{@"name": @"National Air and Space Museum", @"type": @"museum"}; [[[citiesRef documentWithPath:@"DC"] collectionWithPath:@"landmarks"] addDocumentWithData:data]; data = @{@"name": @"Ueno Park", @"type": @"park"}; [[[citiesRef documentWithPath:@"TOK"] collectionWithPath:@"landmarks"] addDocumentWithData:data]; data = @{@"name": @"National Museum of Nature and Science", @"type": @"museum"}; [[[citiesRef documentWithPath:@"TOK"] collectionWithPath:@"landmarks"] addDocumentWithData:data]; data = @{@"name": @"Jingshan Park", @"type": @"park"}; [[[citiesRef documentWithPath:@"BJ"] collectionWithPath:@"landmarks"] addDocumentWithData:data]; data = @{@"name": @"Beijing Ancient Observatory", @"type": @"museum"}; [[[citiesRef documentWithPath:@"BJ"] collectionWithPath:@"landmarks"] addDocumentWithData:data];
Kotlin
val citiesRef = db.collection("cities") val ggbData = mapOf( "name" to "Golden Gate Bridge", "type" to "bridge", ) citiesRef.document("SF").collection("landmarks").add(ggbData) val lohData = mapOf( "name" to "Legion of Honor", "type" to "museum", ) citiesRef.document("SF").collection("landmarks").add(lohData) val gpData = mapOf( "name" to "Griffth Park", "type" to "park", ) citiesRef.document("LA").collection("landmarks").add(gpData) val tgData = mapOf( "name" to "The Getty", "type" to "museum", ) citiesRef.document("LA").collection("landmarks").add(tgData) val lmData = mapOf( "name" to "Lincoln Memorial", "type" to "memorial", ) citiesRef.document("DC").collection("landmarks").add(lmData) val nasaData = mapOf( "name" to "National Air and Space Museum", "type" to "museum", ) citiesRef.document("DC").collection("landmarks").add(nasaData) val upData = mapOf( "name" to "Ueno Park", "type" to "park", ) citiesRef.document("TOK").collection("landmarks").add(upData) val nmData = mapOf( "name" to "National Musuem of Nature and Science", "type" to "museum", ) citiesRef.document("TOK").collection("landmarks").add(nmData) val jpData = mapOf( "name" to "Jingshan Park", "type" to "park", ) citiesRef.document("BJ").collection("landmarks").add(jpData) val baoData = mapOf( "name" to "Beijing Ancient Observatory", "type" to "musuem", ) citiesRef.document("BJ").collection("landmarks").add(baoData)
Java
CollectionReference citiesRef = db.collection("cities"); Map<String, Object> ggbData = new HashMap<>(); ggbData.put("name", "Golden Gate Bridge"); ggbData.put("type", "bridge"); citiesRef.document("SF").collection("landmarks").add(ggbData); Map<String, Object> lohData = new HashMap<>(); lohData.put("name", "Legion of Honor"); lohData.put("type", "museum"); citiesRef.document("SF").collection("landmarks").add(lohData); Map<String, Object> gpData = new HashMap<>(); gpData.put("name", "Griffith Park"); gpData.put("type", "park"); citiesRef.document("LA").collection("landmarks").add(gpData); Map<String, Object> tgData = new HashMap<>(); tgData.put("name", "The Getty"); tgData.put("type", "museum"); citiesRef.document("LA").collection("landmarks").add(tgData); Map<String, Object> lmData = new HashMap<>(); lmData.put("name", "Lincoln Memorial"); lmData.put("type", "memorial"); citiesRef.document("DC").collection("landmarks").add(lmData); Map<String, Object> nasaData = new HashMap<>(); nasaData.put("name", "National Air and Space Museum"); nasaData.put("type", "museum"); citiesRef.document("DC").collection("landmarks").add(nasaData); Map<String, Object> upData = new HashMap<>(); upData.put("name", "Ueno Park"); upData.put("type", "park"); citiesRef.document("TOK").collection("landmarks").add(upData); Map<String, Object> nmData = new HashMap<>(); nmData.put("name", "National Museum of Nature and Science"); nmData.put("type", "museum"); citiesRef.document("TOK").collection("landmarks").add(nmData); Map<String, Object> jpData = new HashMap<>(); jpData.put("name", "Jingshan Park"); jpData.put("type", "park"); citiesRef.document("BJ").collection("landmarks").add(jpData); Map<String, Object> baoData = new HashMap<>(); baoData.put("name", "Beijing Ancient Observatory"); baoData.put("type", "museum"); citiesRef.document("BJ").collection("landmarks").add(baoData);
Dart
final citiesRef = db.collection("cities"); final ggbData = {"name": "Golden Gate Bridge", "type": "bridge"}; citiesRef.doc("SF").collection("landmarks").add(ggbData); final lohData = {"name": "Legion of Honor", "type": "museum"}; citiesRef.doc("SF").collection("landmarks").add(lohData); final gpData = {"name": "Griffth Park", "type": "park"}; citiesRef.doc("LA").collection("landmarks").add(gpData); final tgData = {"name": "The Getty", "type": "museum"}; citiesRef.doc("LA").collection("landmarks").add(tgData); final lmData = {"name": "Lincoln Memorial", "type": "memorial"}; citiesRef.doc("DC").collection("landmarks").add(lmData); final nasaData = { "name": "National Air and Space Museum", "type": "museum" }; citiesRef.doc("DC").collection("landmarks").add(nasaData); final upData = {"name": "Ueno Park", "type": "park"}; citiesRef.doc("TOK").collection("landmarks").add(upData); final nmData = { "name": "National Musuem of Nature and Science", "type": "museum" }; citiesRef.doc("TOK").collection("landmarks").add(nmData); final jpData = {"name": "Jingshan Park", "type": "park"}; citiesRef.doc("BJ").collection("landmarks").add(jpData); final baoData = {"name": "Beijing Ancient Observatory", "type": "musuem"}; citiesRef.doc("BJ").collection("landmarks").add(baoData);
জাভা
পাইথন
Python
সি++
// Get a new write batch WriteBatch batch = db->batch(); DocumentReference sf_ref = db->Collection("cities").Document("SF"); batch.Set(sf_ref,{{"name", FieldValue::String("Golden Gate Bridge")}, {"type", FieldValue::String("bridge")}}); batch.Set(sf_ref,{{"name", FieldValue::String("Legion of Honor")}, {"type", FieldValue::String("museum")}}); DocumentReference la_ref = db->Collection("cities").Document("LA"); batch.Set(la_ref,{{"name", FieldValue::String("Griffith Park")}, {"type", FieldValue::String("park")}}); batch.Set(la_ref,{{"name", FieldValue::String("The Getty")}, {"type", FieldValue::String("museum")}}); DocumentReference dc_ref = db->Collection("cities").Document("DC"); batch.Set(dc_ref,{{"name", FieldValue::String("Lincoln Memorial")}, {"type", FieldValue::String("memorial")}}); batch.Set(dc_ref,{{"name", FieldValue::String("National Air and Space Museum")}, {"type", FieldValue::String("museum")}}); DocumentReference tok_ref = db->Collection("cities").Document("TOK"); batch.Set(tok_ref,{{"name", FieldValue::String("Ueno Park")}, {"type", FieldValue::String("park")}}); batch.Set(tok_ref,{{"name", FieldValue::String("National Museum of Nature and Science")}, {"type", FieldValue::String("museum")}}); DocumentReference bj_ref = db->Collection("cities").Document("BJ"); batch.Set(bj_ref,{{"name", FieldValue::String("Jingshan Park")}, {"type", FieldValue::String("park")}}); batch.Set(bj_ref,{{"name", FieldValue::String("Beijing Ancient Observatory")}, {"type", FieldValue::String("museum")}}); // Commit the batch batch.Commit().OnCompletion([](const Future<void>& future) { if (future.error() == Error::kErrorOk) { std::cout << "Write batch success!" << std::endl; } else { std::cout << "Write batch failure: " << future.error_message() << std::endl; } });
নোড.জেএস
যান
পিএইচপি
ঐক্য
List<Task<DocumentReference>> futures = new List<Task<DocumentReference>>(){ citiesRef .Document("SF") .Collection("landmarks") .AddAsync( new Dictionary<string, object>() { {"name", "Golden Gate Bridge"}, {"type", "bridge"}, } ), citiesRef .Document("SF") .Collection("landmarks") .AddAsync( new Dictionary<string, object>() { {"name", "Legion of Honor"}, {"type", "museum"}, } ), citiesRef .Document("LA") .Collection("landmarks") .AddAsync( new Dictionary<string, object>() { {"name", "Griffith Park"}, {"type", "park"}, } ), citiesRef .Document("LA") .Collection("landmarks") .AddAsync( new Dictionary<string, object>() { {"name", "The Getty"}, {"type", "museum"}, } ), citiesRef .Document("DC") .Collection("landmarks") .AddAsync( new Dictionary<string, object>() { {"name", "Lincoln Memorial"}, {"type", "memorial"}, } ), citiesRef .Document("DC") .Collection("landmarks") .AddAsync( new Dictionary<string, object>() { {"name", "National Air and Space Museum"}, {"type", "museum"}, } ), citiesRef .Document("TOK") .Collection("landmarks") .AddAsync( new Dictionary<string, object>() { {"name", "Ueno Park"}, {"type", "park"}, } ), citiesRef .Document("TOK") .Collection("landmarks") .AddAsync( new Dictionary<string, object>() { {"name", "National Museum of Nature and Science"}, {"type", "museum"}, } ), citiesRef .Document("BJ") .Collection("landmarks") .AddAsync( new Dictionary<string, object>() { {"name", "Jingshan Park"}, {"type", "park"}, } ), citiesRef .Document("BJ") .Collection("landmarks") .AddAsync( new Dictionary<string, object>() { {"name", "Beijing Ancient Observatory"}, {"type", "museum"}, } )}; DocumentReference[] landmarks = Task.WhenAll(futures).Result;
সি#
রুবি
আমরা পূর্বে বর্ণিত সরল এবং যৌগিক কোয়েরি ব্যবহার করে একটি নির্দিষ্ট শহরের landmarks সাবকালেকশন থেকে তথ্য নিতে পারি, কিন্তু আপনি হয়তো একবারে প্রতিটি শহরের landmarks সাবকালেকশন থেকে ফলাফল পেতে চাইতে পারেন।
landmarks কালেকশন গ্রুপটি ‘ landmarks আইডিযুক্ত সমস্ত কালেকশন নিয়ে গঠিত, এবং আপনি একটি কালেকশন গ্রুপ কোয়েরি ব্যবহার করে এটি কোয়েরি করতে পারেন। উদাহরণস্বরূপ, এই কালেকশন গ্রুপ কোয়েরিটি সমস্ত শহর জুড়ে সমস্ত museum ল্যান্ডমার্ক পুনরুদ্ধার করে:
Web
import { collectionGroup, query, where, getDocs } from "firebase/firestore"; const museums = query(collectionGroup(db, 'landmarks'), where('type', '==', 'museum')); const querySnapshot = await getDocs(museums); querySnapshot.forEach((doc) => { console.log(doc.id, ' => ', doc.data()); });
Web
var museums = db.collectionGroup('landmarks').where('type', '==', 'museum'); museums.get().then((querySnapshot) => { querySnapshot.forEach((doc) => { console.log(doc.id, ' => ', doc.data()); }); });
সুইফট
db.collectionGroup("landmarks").whereField("type", isEqualTo: "museum").getDocuments { (snapshot, error) in // ... }
উদ্দেশ্য-সি
[[[self.db collectionGroupWithID:@"landmarks"] queryWhereField:@"type" isEqualTo:@"museum"] getDocumentsWithCompletion:^(FIRQuerySnapshot *snapshot, NSError *error) { // ... }];
Kotlin
db.collectionGroup("landmarks").whereEqualTo("type", "museum").get() .addOnSuccessListener { queryDocumentSnapshots -> // ... }
Java
db.collectionGroup("landmarks").whereEqualTo("type", "museum").get() .addOnSuccessListener(new OnSuccessListener<QuerySnapshot>() { @Override public void onSuccess(QuerySnapshot queryDocumentSnapshots) { // ... } });
Dart
db .collectionGroup("landmarks") .where("type", isEqualTo: "museum") .get() .then( (res) => print("Successfully completed"), onError: (e) => print("Error completing: $e"), );
জাভা
পাইথন
Python
সি++
db->CollectionGroup("landmarks") .WhereEqualTo("type", FieldValue::String("museum")).Get() .OnCompletion([](const firebase::Future<QuerySnapshot>& future) { if (future.error() == Error::kErrorOk) { for (const DocumentSnapshot& document : future.result()->documents()) { std::cout << document << std::endl; } } else { std::cout << "Error getting documents: " << future.error_message() << std::endl; } });
নোড.জেএস
যান
পিএইচপি
ঐক্য
Query museums = db.CollectionGroup("landmarks").WhereEqualTo("type", "museum"); museums.GetSnapshotAsync().ContinueWithOnMainThread((querySnapshotTask) => { foreach (DocumentSnapshot documentSnapshot in querySnapshotTask.Result.Documents) { Debug.Log(String.Format("Document {0} returned by query State=CA", documentSnapshot.Id)); } });
সি#
রুবি
কালেকশন গ্রুপ কোয়েরি ব্যবহার করার আগে, আপনাকে অবশ্যই এমন একটি ইনডেক্স তৈরি করতে হবে যা আপনার কালেকশন গ্রুপ কোয়েরিকে সমর্থন করে। আপনি এরর মেসেজ, কনসোল, অথবা Firebase CLI-এর মাধ্যমে একটি ইনডেক্স তৈরি করতে পারেন ।
ওয়েব এবং মোবাইল এসডিকে-গুলোর জন্য, আপনাকে এমন নিয়মও তৈরি করতে হবে যা আপনার কালেকশন গ্রুপ কোয়েরিগুলোকে অনুমোদন দেয় ।
আপনার কোয়েরির পারফরম্যান্স ব্যাখ্যা করুন
Cloud Firestore আপনাকে ব্যাকএন্ডে আপনার কোয়েরিগুলোর পারফরম্যান্স পরিমাপ করতে এবং এর বিনিময়ে ব্যাকএন্ড কোয়েরি সম্পাদনের বিস্তারিত পারফরম্যান্স পরিসংখ্যান পেতে সাহায্য করে।
কোয়েরি এক্সপ্লেইন-এর ফলাফল আপনাকে বুঝতে সাহায্য করে যে আপনার কোয়েরিগুলো কীভাবে সম্পাদিত হচ্ছে, এবং এর মাধ্যমে আপনি অদক্ষতা ও সম্ভাব্য সার্ভার-সাইড প্রতিবন্ধকতার অবস্থান দেখতে পারেন।
আরও তথ্যের জন্য, Query Explain-এর নির্দেশিকাটি দেখুন।
স্ট্যান্ডার্ড সংস্করণের কোয়েরি সীমাবদ্ধতা
নিম্নলিখিত তালিকাটি Cloud Firestore কোয়েরির সীমাবদ্ধতাগুলো সংক্ষেপে তুলে ধরে। এই সীমাবদ্ধতাগুলো শুধুমাত্র স্ট্যান্ডার্ড সংস্করণের জন্য প্রযোজ্য:
- Cloud Firestore `
or,in, এবংarray-contains-anyঅপারেটরগুলোর মাধ্যমে লজিক্যালORকোয়েরি সমর্থন করে। কোয়েরির ডিসজাঙ্কটিভ নরমাল ফর্মের উপর ভিত্তি করে এই কোয়েরিগুলো ৩০টি ডিসজাংশনে সীমাবদ্ধ। এই সীমাটি নির্দিষ্ট এবং পরিবর্তনযোগ্য নয়। - আপনি প্রতিটি ডিসজাংশন (
orগ্রুপ)-এ সর্বাধিক একটিarray-containsক্লজ ব্যবহার করতে পারেন। আপনি একই ডিসজাংশনেarray-containsএবংarray-contains-anyএকত্রিত করতে পারবেন না। - একই কোয়েরিতে আপনি
not-inসাথেin,array-contains-any, বাorএকসাথে ব্যবহার করতে পারবেন না। - প্রতিটি কোয়েরিতে শুধুমাত্র একটি
not-inবা!=ব্যবহারের অনুমতি আছে। -
not-inসর্বোচ্চ ১০টি তুলনা মান সমর্থন করে। - একটি কোয়েরিতে ফিল্টার, সর্ট অর্ডার এবং প্যারেন্ট ডকুমেন্ট পাথের (সাবকালেকশনের জন্য ১, রুট কালেকশনের জন্য ০) যোগফল ১০০-এর বেশি হতে পারে না। এটি কোয়েরিটির ডিসজাঙ্কটিভ নরমাল ফর্মের উপর ভিত্তি করে গণনা করা হয়।
- কোনো ফিল্ডে অসমতা ফিল্টার ব্যবহার করা হলে, কোয়েরিটি সেই ফিল্ড অনুসারে সাজানো হয় এবং সেই ফিল্ডটির অস্তিত্ব যাচাই করে ।
OR কোয়েরির উপর সীমাবদ্ধতা
একটি কোয়েরি যাতে অতিরিক্ত গণনা-ব্যয়বহুল না হয়ে পড়ে, সেজন্য Cloud Firestore স্ট্যান্ডার্ড এডিশন আপনি কতগুলো AND এবং OR ক্লজ একত্রিত করতে পারবেন তার উপর একটি সীমা নির্ধারণ করে দেয়। এই সীমাটি প্রয়োগ করার জন্য, Cloud Firestore সেইসব কোয়েরিকে ডিসজাঙ্কটিভ নরমাল ফর্মে (যা OR of AND নামেও পরিচিত) রূপান্তর করে, যেগুলো লজিক্যাল OR অপারেশন ( or , in , এবং array-contains-any ) সম্পাদন করে। Cloud Firestore একটি কোয়েরিকে ডিসজাঙ্কটিভ নরমাল ফর্মে সর্বোচ্চ ৩০টি ডিসজাংশনের মধ্যে সীমাবদ্ধ রাখে। এই সীমাটি নির্দিষ্ট এবং এটি পরিবর্তন করা যায় না।
বিযুক্তিমূলক স্বাভাবিক রূপ
Cloud Firestore দুটি নিয়ম প্রয়োগ করে কোয়েরিগুলোকে ডিসজাঙ্কটিভ নরমাল ফর্মে রূপান্তর করে:
সমতল করুন
প্রদত্ত শর্ত
A,BএবংC:A and (B and C) => A and B and Cপ্রদত্ত শর্ত
A,B,CএবংD:-
A and (B or C) => (A and B) or (A and C) -
(A or B) and (C or D) => (A and C) or (A and D) or (B and C) or (B and D)
-
in এবং array-contains-any কোয়েরিতে এই নিয়মগুলো প্রয়োগ করার সময় মনে রাখবেন যে, এই অপারেটরগুলো হলো OR এর সংক্ষিপ্ত রূপ। উদাহরণস্বরূপ, a in [1,2] হলো a = 1 OR a = 2 এর সংক্ষিপ্ত রূপ।
নিম্নলিখিত উদাহরণগুলিতে বিভিন্ন কোয়েরির জন্য ডিসজাংশনের সংখ্যা দেখানো হয়েছে:
| প্রশ্ন | বিযুক্তির সংখ্যা |
|---|---|
query(collectionRef, where("a", "==", 1))
| ১ |
query(collectionRef, or( where("a", "==", 1), where("b", "==", 2) ))
| ২ |
query(collectionRef,
or( and( where("a", "==", 1), where("c", "==", 3) ),
and( where("a", "==", 1), where("d", "==", 4) ),
and( where("b", "==", 2), where("c", "==", 3) ),
and( where("b", "==", 2), where("d", "==", 4) )
)
)
| ৪ |
query(collectionRef,
and( or( where("a", "==", 1), where("b", "==", 2) ),
or( where("c", "==", 3), where("d", "==", 4) )
)
)
| ৪ এই কোয়েরিটির ডিসজাঙ্কটিভ নরমাল ফর্ম উপরের কোয়েরিটির সমান। |
query(collectionRef, where("a", "in", [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]) )
| ১০ |
query(collectionRef,
and( where("a", "in", [1, 2, 3, 4, 5]),
where("b", "in", [1, 2, 3, 4, 5, 6, 7, 8, 9, 10])
)
)
| ৫০ এই কোয়েরিটি একটি ত্রুটি দেখাচ্ছে, কারণ এটি ৩০টি ডিসজাংশনের সীমা অতিক্রম করেছে। |
query(collectionRef,
or( where("a", "in", [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]),
where("b", "in", [1, 2, 3, 4, 5, 6, 7, 8, 9, 10])
)
)
| ২০ |
query(collectionRef,
and( where("a", "in", [1, 2, 3, 4, 5]),
or( where("b", "==", 2),
where("c", "==", 3)
)
)
)
| ১০ |
orderBy এবং অস্তিত্ব
যখন আপনি কোনো নির্দিষ্ট ফিল্ড অনুযায়ী কোয়েরি সাজান, তখন কোয়েরিটি কেবল সেই ডকুমেন্টগুলোই ফেরত দিতে পারে যেখানে অর্ডার-বাই ফিল্ডটি বিদ্যমান থাকে।
উদাহরণস্বরূপ, নিম্নলিখিত কোয়েরিটি এমন কোনো ডকুমেন্ট ফেরত দেবে না যেখানে population ফিল্ডটি সেট করা নেই, এমনকি যদি সেগুলি কোয়েরির ফিল্টারগুলির অন্যান্য শর্ত পূরণ করেও।
জাভা
db.collection("cities").whereEqualTo("country", “USA”).orderBy(“population”);
অসমতার ক্ষেত্রেও একই ধরনের প্রভাব প্রযোজ্য। কোনো ফিল্ডে অসমতা ফিল্টার ব্যবহার করে করা কোয়েরি সেই ফিল্ড অনুযায়ী অর্ডারিংও বোঝায়। নিম্নলিখিত কোয়েরিটি এমন কোনো ডকুমেন্ট ফেরত দেয় না যেখানে population ফিল্ড নেই, এমনকি যদি সেই ডকুমেন্টে country = USA থাকে। এর একটি বিকল্প সমাধান হিসেবে, আপনি প্রতিটি অর্ডারিংয়ের জন্য আলাদা কোয়েরি চালাতে পারেন অথবা যে ফিল্ডগুলো অনুযায়ী অর্ডার করছেন, সেগুলোর সবকটির জন্য একটি মান নির্ধারণ করে দিতে পারেন।
জাভা
db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000));
উপরের কোয়েরিটিতে অসমতার উপর একটি অন্তর্নিহিত অর্ডার-বাই অন্তর্ভুক্ত রয়েছে এবং এটি নিম্নলিখিতটির সমতুল্য:
জাভা
db.collection(“cities”).where(or(“country”, USA”), greaterThan(“population”, 250000)).orderBy(“population”);
এরপর কী?
- কোয়েরির ফলাফলে ডেটা কীভাবে সাজাতে ও সীমিত করতে হয় তা শিখুন।
- যখন আপনি শুধু ফলাফল গণনা করতে চান, তখন রিডগুলো সেভ করুন।