নিচের সারণীতে Cloud Firestore-এর জন্য কাজ করে এমন MongoDB ডেটার ধরন, ড্রাইভার এবং থার্ড-পার্টি টুল তালিকাভুক্ত করা হয়েছে।
ডেটার ধরন
| BSON-এর ধরন | কাজ করে |
|---|---|
| ৩২-বিট পূর্ণসংখ্যা | হ্যাঁ |
| ৬৪-বিট পূর্ণসংখ্যা | হ্যাঁ |
| অ্যারে | হ্যাঁ |
| বাইনারি ডেটা | হ্যাঁ |
| Boolean | হ্যাঁ |
| তারিখ | হ্যাঁ |
| DBPointer | না |
| Decimal128 | হ্যাঁ |
| দুইটি | হ্যাঁ |
| জাভাস্ক্রিপ্ট | না |
| জাভাস্ক্রিপ্ট (স্কোপ সহ) | না |
| MaxKey | হ্যাঁ |
| MinKey | হ্যাঁ |
| ফাঁকা | হ্যাঁ |
| অবজেক্ট: | হ্যাঁ |
| ObjectId | হ্যাঁ |
| রেগুলার এক্সপ্রেশন | হ্যাঁ |
| স্ট্রিং | হ্যাঁ |
| প্রতীক | না |
| টাইমস্ট্যাম্প | হ্যাঁ |
| অনির্দিষ্ট | না |
ডকুমেন্ট _id
ডকুমেন্টের টপ-লেভেল _id ফিল্ডটি অবশ্যই নিম্নলিখিত ধরনের মধ্যে একটি হতে হবে:
- ObjectId
- স্ট্রিং
- ৬৪-বিট পূর্ণসংখ্যা
- ৩২-বিট পূর্ণসংখ্যা
- দুইটি
- Binary
- অবজেক্ট:
- Boolean
_id-এর মোট সাইজ ১৫০০ বাইটের বেশি হলে চলবে না।
অবজেক্ট-টাইপ করা আইডির মধ্যে প্রতিটি ভ্যালু অবশ্যই একটি সমর্থিত আইডি টাইপ বা ভ্যালুর অ্যারে হতে হবে, যার প্রতিটি একটি সমর্থিত আইডি টাইপ।
অন্যান্য ধরনের BSON কাজ করে না।
ভাষা ও MongoDB ড্রাইভার
Cloud Firestore-এ নিম্নলিখিত ড্রাইভার ভার্সন কাজ করে:
| ভাষা | ড্রাইভার ভার্সন |
|---|---|
| জাভা | 5.x |
| Node.js | 6.x 5.x |
| Python | ৪.x ৩.x (x ≥ ১২) |
| Go | ২.x |
| C# | ৩.x |
| Ruby | 2.x (x ≥ 16) |
OIDC যাচাইকরণ সংক্রান্ত সহায়তা
Go, C# এবং Ruby ড্রাইভার, সব কাজ করে এমন ড্রাইভার ভার্সনের জন্য Google Cloud থেকে OpenID Connect (OIDC) যাচাইকরণ সমর্থন করে।
Java, Node.js এবং Python ড্রাইভার Google Cloud থেকে OIDC যাচাইকরণকে সাপোর্ট করে, যা নিম্নলিখিত ড্রাইভার ভার্সন থেকে শুরু হয়:
- Java: ৪.১০
- Node.js: 6.7
- Python: ৪.৭
তৃতীয় পক্ষের টুল
এই বিভাগে বর্ণনা করা থার্ড-পার্টি টুল Cloud Firestore-এ কাজ করে।
| টুল | বিবরণ | Notes |
|---|---|---|
| mongoimport | MongoDB Database Tools | বাল্ক ডেটা লোডিং দেখুন |
| mongoexport | MongoDB Database Tools | |
| mongodump | MongoDB Database Tools | |
| mongorestore | MongoDB Database Tools | বাল্ক ডেটা লোডিং দেখুন |
| mongosh | MongoDB Shell | |
| Mongoose | MongoDB অবজেক্ট মডেলিং টুল | |
| MongoDB Compass | ডেটা এক্সপ্লোর করার জন্য GUI টুল |
BSON এবং Cloud Firestore ধরনের কম্প্যাটিবিলিটি
এই বিভাগে MongoDB BSON টাইপ ও Cloud Firestore ভ্যালুর মধ্যে ম্যাপিংয়ের সারসংক্ষেপ দেখানো হয়েছে। BSON একটি বাইনারি ফর্ম্যাট এবং Cloud Firestore API প্রোটোকল বাফার ব্যবহার করে, কিছু ধরনের ম্যাপ সরাসরি, অন্যদের বিশেষ ম্যাপ উপস্থাপনা প্রয়োজন।
ম্যাপিং ওভারভিউ
নিম্নলিখিত সারণীগুলি দেখায় যে কীভাবে BSON ডেটা টাইপ Cloud Firestore প্রোটোকল বাফার উপস্থাপনার সাথে সামঞ্জস্যপূর্ণ।
সরাসরি ম্যাপিং
এই ধরনের ডেটা দুটি সিস্টেমেই সরাসরি সমতুল্য।
| BSON-এর ধরন | BSON | Cloud Firestore Proto | নোট |
|---|---|---|---|
| ডবল | 1.23 |
double_value: 1.23 |
|
| স্ট্রিং | "hello" |
string_value: "hello" |
|
| অবজেক্ট | { |
map_value { |
|
| Array | [ |
array_value { |
|
| বাইনারি (সাবটাইপ জিরো) | BinData(0, 'SGVsbG8=') |
bytes_value: "Hello" |
|
| বুলিয়ান | true |
boolean_value: true |
|
| Null | null |
null_value: NULL_VALUE |
|
| 64-বিট ইন্টিজার | Long('1234567890') |
integer_value: 1234567890 |
|
| তারিখ | ISODate('2026-05-22T04:00:00Z') |
timestamp_value { |
Cloud Firestore টাইমস্ট্যাম্প ভ্যালু মাইক্রোসেকেন্ড প্রিসিশনে স্টোর করা হয়, তবে BSON-এ কনভার্ট করার সময় মিলিসেকেন্ড প্রিসিশনের বাইরে যেকোনও কিছু হারিয়ে যায়। |
Cloud Firestore API-তে ম্যাপ হিসেবে দেখানো BSON-এর ধরন
এই BSON টাইপগুলি Cloud Firestore map_value-এ র্যাপ করা থাকে এবং
টাইপ বোঝানোর জন্য বিশেষ কী থাকে।
| BSON-এর ধরন | BSON | Cloud Firestore Proto | নোট |
|---|---|---|---|
| ৩২-বিট ইন্টিজার | 123 |
map_value { |
|
| বাইনারি (নন-জিরো সাবটাইপ) | BinData(1, 'AQIDBA==') |
map_value { |
ডেটার আগে সাবটাইপ বাইট যোগ করা হয়েছে। |
| ObjectId | ObjectId('67eea9446dc71ec469e9496a') |
map_value { |
ছোট হাতের হেক্স স্ট্রিং। |
| টাইমস্ট্যাম্প (ইন্টার্নাল) | Timestamp(123, 1) |
map_value { |
MongoDB ইন্টার্নাল টাইমস্ট্যাম্প। |
| রেগুলার এক্সপ্রেশন | RegExp('.*', 'im') |
map_value { |
|
| Min Key | MinKey() |
map_value { |
|
| Max Key | MaxKey() |
map_value { |
|
| Decimal128 | Decimal128('4E7') |
map_value { |
Cloud Firestore ধরন BSON-এ নেটিভভাবে নেই
BSON-এ কনভার্ট করা হলে, এই Cloud Firestore ধরনের ডেটা বিশেষভাবে স্ট্রাকচার করা ম্যাপ হিসেবে দেখানো হয়।
| Cloud Firestore ধরন | BSON | Cloud Firestore Proto |
|---|---|---|
| GeoPoint | { |
geo_point_value { |
| ভেক্টর | { |
map_value { |
| ডকুমেন্ট রেফারেন্স | { |
reference_value: "projects/.../documents/col/doc" |
ফিল্ডের নাম
MongoDB থেকে ফিল্ডের নাম যা __.*__-এর সাথে মেলে তা Cloud Firestore-এ স্টোর করার সময় r: অন্তর্ভুক্ত করে এড়িয়ে যাওয়া হয়। যেমন, একটি BSON ফিল্ড
__foo__, Cloud Firestore-এ __r:foo__ হয়ে যায়।
ক্লায়েন্ট SDK-তে BSON ডেটার ধরন
Cloud Firestore ক্লায়েন্ট SDK ব্যবহার করার সময়, আপনি বিশেষ SDK ক্লাস ব্যবহার করে ১২৮-বিট ডেসিমেল, রেগুলার এক্সপ্রেশন ও BSON টাইমস্ট্যাম্পের মতো BSON ডেটার ধরন দেখাতে পারবেন।
Node.js
const { RegexValue, Decimal128Value, BsonTimestamp } = require('@google-cloud/firestore'); // Setting fields with BSON data types const res = await db.collection('foo').doc('bar').set({ regex: new RegexValue('myRegexPattern', 'i'), decimal: new Decimal128Value('0.73e-7'), bsonTimestamp: new BsonTimestamp(1732754912, 500), });
জাভা
import com.google.cloud.firestore.BsonTimestamp; import com.google.cloud.firestore.Decimal128Value; import com.google.cloud.firestore.RegexValue; import java.util.HashMap; import java.util.Map; Map<String, Object> data = new HashMap<>(); data.put("regex", new RegexValue("myRegexPattern", "i")); data.put("decimal", new Decimal128Value("0.73e-7")); data.put("bson_timestamp", new BsonTimestamp(1732754912, 500)); db.collection("foo").doc("bar").set(data);
Java
import com.google.firebase.firestore.BsonTimestamp; import com.google.firebase.firestore.Decimal128Value; import com.google.firebase.firestore.RegexValue; import java.util.HashMap; import java.util.Map; Map<String, Object> data = new HashMap<>(); data.put("regex", new RegexValue("myRegexPattern", "i")); data.put("decimal", new Decimal128Value("0.73e-7")); data.put("bson_timestamp", new BsonTimestamp(1732754912, 500)); db.collection("foo").doc("bar").set(data);
Go
import ( "context" "cloud.google.com/go/firestore" ) func writeBsonTypes(ctx context.Context, client *firestore.Client) error { _, err := client.Collection("foo").Doc("bar").Set(ctx, map[string]interface{}{ "regex": firestore.RegexValue{Pattern: "myRegexPattern", Options: "i"}, "decimal": firestore.Decimal128Value{Value: "0.73e-7"}, "bson_timestamp": firestore.BsonTimestamp{Seconds: 1732754912, Increment: 500}, }) return err }
এর পরে কী করতে হবে
- কুইকস্টার্ট: ডেটাবেস তৈরি করুন এবং এতে কানেক্ট করুন রান করুন।
- আচরণগত পার্থক্য সম্পর্কে জানুন।
- MongoDB ভার্সনের উপর নির্ভর করে কাজ করে এমন ফিচারের ব্রেকডাউন দেখতে,