MongoDB ডেটার ধরন ও ড্রাইভার যা কাজ করে

নিচের সারণীতে 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"
অবজেক্ট
{
"a": 1.23
}
map_value {
fields {
key: "a"
value {
double_value: 1.23
}
}
}
Array
[
1.23,
"a"
]
array_value {
values {
double_value: 1.23
}
values {
string_value: "a"
}
}
বাইনারি (সাবটাইপ জিরো) 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 {
seconds: 1779470400
nanos: 0
}
Cloud Firestore টাইমস্ট্যাম্প ভ্যালু মাইক্রোসেকেন্ড প্রিসিশনে স্টোর করা হয়, তবে BSON-এ কনভার্ট করার সময় মিলিসেকেন্ড প্রিসিশনের বাইরে যেকোনও কিছু হারিয়ে যায়।

Cloud Firestore API-তে ম্যাপ হিসেবে দেখানো BSON-এর ধরন

এই BSON টাইপগুলি Cloud Firestore map_value-এ র‍্যাপ করা থাকে এবং টাইপ বোঝানোর জন্য বিশেষ কী থাকে।

BSON-এর ধরন BSON Cloud Firestore Proto নোট
৩২-বিট ইন্টিজার 123
map_value {
fields {
key: "__int__"
value {
integer_value: 123
}
}
}
বাইনারি (নন-জিরো সাবটাইপ) BinData(1, 'AQIDBA==')
map_value {
fields {
key: "__binary__"
value {
bytes_value: "<subtype + data>"
}
}
}
ডেটার আগে সাবটাইপ বাইট যোগ করা হয়েছে।
ObjectId ObjectId('67eea9446dc71ec469e9496a')
map_value {
fields {
key: "__oid__"
value {
string_value:
"67eea9446dc71ec469e9496a"
}
}
}
ছোট হাতের হেক্স স্ট্রিং।
টাইমস্ট্যাম্প (ইন্টার্নাল) Timestamp(123, 1)
map_value {
fields {
key: "__request_timestamp__"
value {
map_value {
fields {
key: "seconds"
value {
integer_value: 123
}
}
fields {
key: "increment"
value {
integer_value: 1
}
}
}
}
}
}
MongoDB ইন্টার্নাল টাইমস্ট্যাম্প।
রেগুলার এক্সপ্রেশন RegExp('.*', 'im')
map_value {
fields {
key: "__regex__"
value {
map_value {
fields {
key: "pattern"
value {
string_value: ".*"
}
}
fields {
key: "options"
value {
string_value: "im"
}
}
}
}
}
}
Min Key MinKey()
map_value {
fields {
key: "__min__"
value {
null_value: NULL_VALUE
}
}
}
Max Key MaxKey()
map_value {
fields {
key: "__max__"
value {
null_value: NULL_VALUE
}
}
}
Decimal128 Decimal128('4E7')
map_value {
fields {
key: "__decimal128__"
value {
string_value: "4E7"
}
}
}

Cloud Firestore ধরন BSON-এ নেটিভভাবে নেই

BSON-এ কনভার্ট করা হলে, এই Cloud Firestore ধরনের ডেটা বিশেষভাবে স্ট্রাকচার করা ম্যাপ হিসেবে দেখানো হয়।

Cloud Firestore ধরন BSON Cloud Firestore Proto
GeoPoint
{
"__fs_geopoint__": {
"latitude": 37.42,
"longitude": -122.08
}
}
geo_point_value {
latitude: 37.42
longitude: -122.08
}
ভেক্টর
{
"__fs_vector__": [
1.0,
2.0
]
}
map_value {
fields {
key: "__type__"
value {
string_value: "__vector__"
}
}
fields {
key: "value"
value {
array_value {
...
}
}
}
}
ডকুমেন্ট রেফারেন্স
{
"__fs_ref__": "projects/.../documents/col/doc"
}
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
}
    

এর পরে কী করতে হবে