Cloud Firestore ডেটা মডেল

Cloud Firestore হল NoSQL, ডকুমেন্ট-ওরিয়েন্টেড ডেটাবেস। SQL ডেটাবেসের মতো, এতে কোনও টেবিল বা সারি নেই। পরিবর্তে, আপনি ডকুমেন্টে ডেটা স্টোর করেন, যা কালেকশনে সাজানো থাকে।

প্রতিটি ডকুমেন্টে কী-ভ্যালু পেয়ারের একটি সেট থাকে। Cloud Firestore ছোট ডকুমেন্টের বিশাল সংগ্রহ স্টোর করার জন্য অপ্টিমাইজ করা হয়েছে।

সব ডকুমেন্ট অবশ্যই কালেকশনে সেভ করতে হবে। ডকুমেন্টে সাবকালেকশন এবং নেস্ট করা অবজেক্ট থাকতে পারে, যার দুটিতেই স্ট্রিংয়ের মতো প্রিমিটিভ ফিল্ড বা তালিকার মতো জটিল অবজেক্ট থাকতে পারে।

Cloud Firestore-এ কালেকশন ও ডকুমেন্ট অন্তর্নিহিতভাবে তৈরি করা হয়। কোনও সংগ্রহের মধ্যে থাকা ডকুমেন্টে ডেটা অ্যাসাইন করুন। কালেকশন বা ডকুমেন্ট, এর মধ্যে কোনও একটি না থাকলে, Cloud Firestore সেটি তৈরি করে।

ডকুমেন্ট

Cloud Firestore-এ, স্টোরেজের ইউনিট হল ডকুমেন্ট। ডকুমেন্ট হল একটি লাইটওয়েট রেকর্ড যাতে ফিল্ড থাকে, যা ভ্যালুর সাথে ম্যাপ করে। প্রতিটি ডকুমেন্ট নাম দিয়ে শনাক্ত করা হয়।

alovelace ব্যবহারকারীর প্রতিনিধিত্বকারী ডকুমেন্টটি দেখতে এইরকম হতে পারে:

• class alovelace

  first : "Ada"
last : "Lovelace"
born : 1815
  

ডকুমেন্টে জটিল, নেস্টেড অবজেক্টকে ম্যাপ বলা হয়। যেমন, আপনি উপরের উদাহরণ থেকে ব্যবহারকারীর নাম ম্যাপের সাহায্যে এইভাবে সাজাতে পারেন:

• class alovelace

  name :
    first : "Ada"
    last : "Lovelace"
born : 1815
  

আপনি লক্ষ্য করতে পারেন যে ডকুমেন্টগুলি JSON-এর মতো দেখতে। আসলে, তারা মূলত তাই। কিছু পার্থক্য আছে (যেমন, ডকুমেন্ট অতিরিক্ত ডেটার ধরন সাপোর্ট করে এবং ডকুমেন্ট সাইজের সীমা পর্যন্ত সীমাবদ্ধ), তবে সাধারণভাবে, আপনি ডকুমেন্টকে লাইটওয়েট JSON রেকর্ড হিসেবে বিবেচনা করতে পারেন।

সংগ্রহ

ডকুমেন্ট কালেকশনে থাকে, যা আসলে ডকুমেন্টের কন্টেনার। যেমন, আপনার বিভিন্ন ব্যবহারকারীর জন্য একটি users সংগ্রহ থাকতে পারে, যার প্রতিটি একটি ডকুমেন্ট দ্বারা উপস্থাপিত হয়:

• collections_bookmark জন ব্যবহারকারী

  • class alovelace

    first : "Ada"
last : "Lovelace"
born : 1815
    

  • class aturing

    first : "Alan"
last : "Turing"
born : 1912
    

Cloud Firestore-এ কোনও স্কিমা নেই, তাই প্রতিটি ডকুমেন্টে আপনি কোন কোন ফিল্ড রাখবেন এবং সেইসব ফিল্ডে কোন ধরনের ডেটা স্টোর করবেন তা সম্পূর্ণ আপনার উপর নির্ভর করে। একই সংগ্রহের মধ্যে থাকা ডকুমেন্টে বিভিন্ন ফিল্ড থাকতে পারে অথবা সেইসব ফিল্ডে বিভিন্ন ধরনের ডেটা স্টোর করা থাকতে পারে। তবে, একাধিক ডকুমেন্ট জুড়ে একই ফিল্ড এবং ডেটার ধরন ব্যবহার করা একটি ভালো আইডিয়া, যাতে আপনি আরও সহজে ডকুমেন্ট কোয়েরি করতে পারেন।

কালেকশনে শুধু ডকুমেন্ট থাকে, অন্য কিছু নয়। এতে সরাসরি ভ্যালু সহ র ফিল্ড থাকতে পারে না এবং এতে অন্যান্য কালেকশন থাকতে পারে না। (Cloud Firestore-এ আরও জটিল ডেটা কীভাবে স্ট্রাকচার করতে হয় তার ব্যাখ্যা পেতে হায়ারার্কিক্যাল ডেটা দেখুন।)

একটি সংগ্রহের মধ্যে থাকা ডকুমেন্টের নাম অনন্য হয়। আপনি নিজের কী প্রদান করতে পারেন, যেমন ব্যবহারকারীর আইডি অথবা Cloud Firestore-কে আপনার জন্য অটোমেটিক র‍্যান্ডম আইডি তৈরি করতে দিতে পারেন।

আপনাকে সংগ্রহ "তৈরি" বা "মুছতে" হবে না। আপনি কোনও কালেকশনে প্রথম ডকুমেন্ট তৈরি করার পরে, কালেকশনটি তৈরি হয়। আপনি যদি কোনও সংগ্রহের সব ডকুমেন্ট মুছে দেন, তাহলে সেটি আর থাকবে না।

রেফারেন্স

Cloud Firestore-এর প্রতিটি ডকুমেন্ট ডেটাবেসের মধ্যে তার লোকেশন দ্বারা অনন্যভাবে শনাক্ত করা হয়। আগের উদাহরণে users সংগ্রহের মধ্যে alovelace ডকুমেন্ট দেখানো হয়েছে। আপনার কোডে এই লোকেশন উল্লেখ করতে, আপনি এটির জন্য একটি রেফারেন্স তৈরি করতে পারেন।

import { doc } from "firebase/firestore";

const alovelaceDocumentRef = doc(db, 'users', 'alovelace');
doc_reference.js

var alovelaceDocumentRef = db.collection('users').doc('alovelace');
test.firestore.js

let alovelaceDocumentRef = db.collection("users").document("alovelace")
ViewController.swift

FIRDocumentReference *alovelaceDocumentRef =
    [[self.db collectionWithPath:@"users"] documentWithPath:@"alovelace"];
ViewController.m

val alovelaceDocumentRef = db.collection("users").document("alovelace")
DocSnippets.kt

DocumentReference alovelaceDocumentRef = db.collection("users").document("alovelace");
DocSnippets.java

final alovelaceDocumentRef = db.collection("users").doc("alovelace");
firestore.dart

// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.collection("users").document("alovelace");
References.java

a_lovelace_ref = db.collection("users").document("alovelace")
snippets.py

a_lovelace_ref = db.collection("users").document("alovelace")
snippets.py

DocumentReference alovelace_document_reference =
    db->Collection("users").Document("alovelace");
snippets.cpp

const alovelaceDocumentRef = db.collection('users').doc('alovelace');
index.js

import (
	"cloud.google.com/go/firestore"
)

func createDocReference(client *firestore.Client) {

	alovelaceRef := client.Collection("users").Doc("alovelace")

	_ = alovelaceRef
}
retrieve_data_reference_document.go

$document = $db->collection('samples/php/users')->document('alovelace');
data_reference_document.php

DocumentReference documentRef = db.Collection("users").Document("alovelace");

DocumentReference documentRef = db.Collection("users").Document("alovelace");
Program.cs

document_ref = firestore.col("users").doc("alovelace")
data_model.rb

রেফারেন্স হল একটি লাইটওয়েট অবজেক্ট যা আপনার ডেটাবেসের একটি লোকেশনকে পয়েন্ট করে। সেখানে ডেটা থাকুক বা না থাকুক, আপনি রেফারেন্স তৈরি করতে পারবেন এবং রেফারেন্স তৈরি করার সময় কোনও নেটওয়ার্ক অপারেশন পারফর্ম করা হয় না।

এছাড়াও, আপনি কালেকশন-এর রেফারেন্স তৈরি করতে পারবেন:

import { collection } from "firebase/firestore";

const usersCollectionRef = collection(db, 'users');
collection_reference.js

var usersCollectionRef = db.collection('users');
test.firestore.js

let usersCollectionRef = db.collection("users")
ViewController.swift

FIRCollectionReference *usersCollectionRef = [self.db collectionWithPath:@"users"];
ViewController.m

val usersCollectionRef = db.collection("users")
DocSnippets.kt

CollectionReference usersCollectionRef = db.collection("users");
DocSnippets.java

final usersCollectionRef = db.collection("users");
firestore.dart

// Reference to the collection "users"
CollectionReference collection = db.collection("users");
References.java

users_ref = db.collection("users")
snippets.py

users_ref = db.collection("users")
snippets.py

CollectionReference users_collection_reference = db->Collection("users");
snippets.cpp

const usersCollectionRef = db.collection('users');
index.js

import (
	"cloud.google.com/go/firestore"
)

func createCollectionReference(client *firestore.Client) {
	usersRef := client.Collection("users")

	_ = usersRef
}
retrieve_data_reference_collection.go

$collection = $db->collection('samples/php/users');
data_reference_collection.php

CollectionReference collectionRef = db.Collection("users");

CollectionReference collectionRef = db.Collection("users");
Program.cs

collection_ref = firestore.col "users"
data_model.rb

সুবিধার জন্য, আপনি একটি ডকুমেন্ট বা সংগ্রহের পাথকে স্ট্রিং হিসেবে উল্লেখ করে রেফারেন্স তৈরি করতে পারেন, যেখানে পাথের উপাদানগুলি ফরওয়ার্ড স্ল্যাশ (/) দ্বারা আলাদা করা হয়। উদাহরণস্বরূপ, alovelace ডকুমেন্টের রেফারেন্স তৈরি করতে:

import { doc } from "firebase/firestore"; 

const alovelaceDocumentRef = doc(db, 'users/alovelace');
doc_reference_alternative.js

var alovelaceDocumentRef = db.doc('users/alovelace');
test.firestore.js

let aLovelaceDocumentReference = db.document("users/alovelace")
ViewController.swift

FIRDocumentReference *aLovelaceDocumentReference =
    [self.db documentWithPath:@"users/alovelace"];
ViewController.m

val alovelaceDocumentRef = db.document("users/alovelace")
DocSnippets.kt

DocumentReference alovelaceDocumentRef = db.document("users/alovelace");
DocSnippets.java

final aLovelaceDocRef = db.doc("users/alovelace");
firestore.dart

// Reference to a document with id "alovelace" in the collection "users"
DocumentReference document = db.document("users/alovelace");
References.java

a_lovelace_ref = db.document("users/alovelace")
snippets.py

a_lovelace_ref = db.document("users/alovelace")
snippets.py

DocumentReference alovelace_document = db->Document("users/alovelace");
snippets.cpp

const alovelaceDocumentRef = db.doc('users/alovelace');
index.js

import (
	"cloud.google.com/go/firestore"
)

func createDocReferenceFromString(client *firestore.Client) {
	// Reference to a document with id "alovelace" in the collection "users"
	alovelaceRef := client.Doc("users/alovelace")

	_ = alovelaceRef
}
retrieve_data_reference_document_path.go

$document = $db->document('users/alovelace');
data_reference_document_path.php

DocumentReference documentRef = db.Document("users/alovelace");

DocumentReference documentRef = db.Document("users/alovelace");
Program.cs

document_path_ref = firestore.doc "users/alovelace"
data_model.rb

হায়ারার্কিক্যাল ডেটা

Cloud Firestore-এ কীভাবে হায়ারার্কিক্যাল ডেটা স্ট্রাকচার কাজ করে তা বুঝতে, মেসেজ এবং চ্যাট রুম সহ একটি উদাহরণ চ্যাট অ্যাপ বিবেচনা করুন।

বিভিন্ন চ্যাট রুম স্টোর করার জন্য আপনি rooms নামে একটি সংগ্রহ তৈরি করতে পারেন:

• collections_bookmarkটি রুম

  • class roomA

    name : "my chat room"
    

  • class roomB

    ...
    

এখন আপনার চ্যাট রুম আছে, আপনার মেসেজ কীভাবে স্টোর করবেন তা ঠিক করুন। আপনি হয়ত চ্যাট রুমের ডকুমেন্টে সেগুলি স্টোর করতে চাইবেন না। Cloud Firestore-এ ডকুমেন্ট হালকা হওয়া উচিত এবং চ্যাট রুমে অনেক মেসেজ থাকতে পারে। তবে, আপনি নিজের চ্যাট রুমের ডকুমেন্টের মধ্যে অতিরিক্ত কালেকশন তৈরি করতে পারবেন, সাবকালেকশন হিসেবে।

সাবকালেকশন

এই পরিস্থিতিতে মেসেজ স্টোর করার সবচেয়ে ভালো উপায় হল সাবকালেকশন ব্যবহার করা। সাবকালেকশন হল নির্দিষ্ট ডকুমেন্টের সাথে সম্পর্কিত কালেকশন।

আপনার rooms কালেকশনে প্রতিটি রুম ডকুমেন্টের জন্য আপনি messages নামে একটি সাবকালেকশন তৈরি করতে পারেন:

• collections_bookmarkটি রুম

  • class roomA

    name : "my chat room"
    

    • collections_bookmark মেসেজ

      • class message1

        from : "alex"
msg : "Hello World!"
        

      • class message2

        ...
        

  • class roomB

    ...
    

এই উদাহরণে, আপনি নিম্নলিখিত কোড ব্যবহার করে সাবকালেকশনে একটি মেসেজের রেফারেন্স তৈরি করবেন:

import { doc } from "firebase/firestore"; 

const messageRef = doc(db, "rooms", "roomA", "messages", "message1");
subcollection_reference.js

var messageRef = db.collection('rooms').doc('roomA')
                .collection('messages').doc('message1');
test.firestore.js

let messageRef = db
  .collection("rooms").document("roomA")
  .collection("messages").document("message1")
ViewController.swift

FIRDocumentReference *messageRef =
    [[[[self.db collectionWithPath:@"rooms"] documentWithPath:@"roomA"]
    collectionWithPath:@"messages"] documentWithPath:@"message1"];
ViewController.m

val messageRef = db
    .collection("rooms").document("roomA")
    .collection("messages").document("message1")
DocSnippets.kt

DocumentReference messageRef = db
        .collection("rooms").document("roomA")
        .collection("messages").document("message1");
DocSnippets.java

final messageRef = db
    .collection("rooms")
    .doc("roomA")
    .collection("messages")
    .doc("message1");
firestore.dart

// Reference to a document in subcollection "messages"
DocumentReference document =
    db.collection("rooms").document("roomA").collection("messages").document("message1");
References.java

room_a_ref = db.collection("rooms").document("roomA")
message_ref = room_a_ref.collection("messages").document("message1")
snippets.py

room_a_ref = db.collection("rooms").document("roomA")
message_ref = room_a_ref.collection("messages").document("message1")
snippets.py

DocumentReference message_reference = db->Collection("rooms")
    .Document("roomA")
    .Collection("messages")
    .Document("message1");
snippets.cpp

const messageRef = db.collection('rooms').doc('roomA')
  .collection('messages').doc('message1');
index.js

import (
	"cloud.google.com/go/firestore"
)

func createSubcollectionReference(client *firestore.Client) {
	messageRef := client.Collection("rooms").Doc("roomA").
		Collection("messages").Doc("message1")

	_ = messageRef
}
retrieve_data_reference_subcollection.go

$document = $db
    ->collection('rooms')
    ->document('roomA')
    ->collection('messages')
    ->document('message1');
data_reference_subcollection.php

DocumentReference documentRef = db
	.Collection("Rooms").Document("RoomA")
	.Collection("Messages").Document("Message1");

DocumentReference documentRef = db
    .Collection("Rooms").Document("RoomA")
    .Collection("Messages").Document("Message1");
Program.cs

message_ref = firestore.col("rooms").doc("roomA").col("messages").doc("message1")
data_model.rb

কালেকশন ও ডকুমেন্টের অল্টারনেটিং প্যাটার্ন লক্ষ্য করুন। আপনার সংগ্রহ এবং ডকুমেন্টকে সবসময় এই প্যাটার্ন অনুসরণ করতে হবে। আপনি কোনও কালেকশনে অন্য কোনও কালেকশন বা কোনও ডকুমেন্টে অন্য কোনও ডকুমেন্ট রেফারেন্স হিসেবে ব্যবহার করতে পারবেন না।

সাবকালেকশন আপনাকে ডেটা হায়ারার্কি অনুযায়ী স্ট্রাকচার করতে দেয়, যার ফলে ডেটা অ্যাক্সেস করা সহজ হয়। roomA-এ সব মেসেজ পেতে, আপনি messages সাবকালেকশনের জন্য একটি কালেকশন রেফারেন্স তৈরি করতে পারেন এবং অন্য যেকোনও কালেকশন রেফারেন্সের মতো এটির সাথে ইন্টার‍্যাক্ট করতে পারেন।

সাবকালেকশনের ডকুমেন্টে সাবকালেকশনও থাকতে পারে, যা আপনাকে আরও নেস্ট ডেটা করার অনুমতি দেয়। আপনি সর্বাধিক ১০০ লেভেল পর্যন্ত ডেটা নেস্ট করতে পারবেন।