ক্লাউড ফায়ারস্টোর ট্রিগার করে


ক্লাউড ফাংশনগুলির সাহায্যে, আপনি ক্লাউড ফায়ারস্টোরে ক্লায়েন্ট কোড আপডেট করার প্রয়োজন ছাড়াই ইভেন্টগুলি পরিচালনা করতে পারেন। আপনি ডকুমেন্ট স্ন্যাপশট ইন্টারফেসের মাধ্যমে বা অ্যাডমিন SDK-এর মাধ্যমে ক্লাউড ফায়ারস্টোর পরিবর্তন করতে পারেন।

একটি সাধারণ জীবনচক্রে, একটি ক্লাউড ফায়ারস্টোর ফাংশন নিম্নলিখিতগুলি করে:

  1. একটি নির্দিষ্ট নথিতে পরিবর্তনের জন্য অপেক্ষা করে।
  2. একটি ঘটনা ঘটলে ট্রিগার করে এবং তার কার্য সম্পাদন করে।
  3. নির্দিষ্ট নথিতে সংরক্ষিত ডেটার একটি স্ন্যাপশট ধারণ করে এমন একটি ডেটা অবজেক্ট গ্রহণ করে। ইভেন্টগুলি লিখতে বা আপডেট করার জন্য, ডেটা অবজেক্টে দুটি স্ন্যাপশট থাকে যা ট্রিগারিং ইভেন্টের আগে এবং পরে ডেটার অবস্থা উপস্থাপন করে।

ফায়ারস্টোর ইনস্ট্যান্সের অবস্থান এবং ফাংশনের অবস্থানের মধ্যে দূরত্ব উল্লেখযোগ্য নেটওয়ার্ক লেটেন্সি তৈরি করতে পারে। কর্মক্ষমতা অপ্টিমাইজ করতে, যেখানে প্রযোজ্য সেখানে ফাংশন অবস্থান নির্দিষ্ট করার কথা বিবেচনা করুন।

ক্লাউড ফায়ারস্টোর ফাংশন ট্রিগার করে

Firebase SDK-এর জন্য ক্লাউড ফাংশন নিম্নলিখিত ক্লাউড ফায়ারস্টোর ইভেন্ট ট্রিগারগুলি রপ্তানি করে যাতে আপনি নির্দিষ্ট ক্লাউড ফায়ারস্টোর ইভেন্টের সাথে আবদ্ধ হ্যান্ডলার তৈরি করতে পারেন:

Node.js

ইভেন্টের ধরণ ট্রিগার
onDocumentCreated যখন একটি নথিতে প্রথমবার লেখা হয় তখন ট্রিগার হয়৷
onDocumentUpdated ট্রিগার হয় যখন একটি ডকুমেন্ট আগে থেকেই থাকে এবং কোনো মান পরিবর্তন হয়।
onDocumentDeleted একটি নথি মুছে ফেলা হলে ট্রিগার হয়।
onDocumentWritten onDocumentCreated , onDocumentUpdated বা onDocumentDeleted ট্রিগার হলে ট্রিগার হয়।
onDocumentCreatedWithAuthContext onDocumentCreated অতিরিক্ত প্রমাণীকরণ তথ্য সহ
onDocumentWrittenWithAuthContext অতিরিক্ত প্রমাণীকরণ তথ্য সহ onDocumentWritten
onDocumentDeletedWithAuthContext onDocumentDeleted অতিরিক্ত প্রমাণীকরণ তথ্য সহ মুছে ফেলা হয়েছে
onDocumentUpdatedWithAuthContext অতিরিক্ত প্রমাণীকরণ তথ্য সহ onDocumentUpdated

পাইথন (প্রিভিউ)

ইভেন্টের ধরণ ট্রিগার
on_document_created যখন একটি নথিতে প্রথমবার লেখা হয় তখন ট্রিগার হয়৷
on_document_updated ট্রিগার হয় যখন একটি ডকুমেন্ট আগে থেকেই থাকে এবং কোনো মান পরিবর্তন হয়।
on_document_deleted একটি নথি মুছে ফেলা হলে ট্রিগার হয়।
on_document_written on_document_created , on_document_updated বা on_document_deleted ট্রিগার হলে ট্রিগার হয়।
on_document_created_with_auth_context অতিরিক্ত প্রমাণীকরণ তথ্য সহ on_document_created
on_document_updated_with_auth_context অতিরিক্ত প্রমাণীকরণ তথ্য সহ on_document_updated
on_document_deleted_with_auth_context অতিরিক্ত প্রমাণীকরণ তথ্য সহ on_document_deleted
on_document_written_with_auth_context অতিরিক্ত প্রমাণীকরণ তথ্য সহ on_document_written

ক্লাউড ফায়ারস্টোর ইভেন্টগুলি শুধুমাত্র ডকুমেন্ট পরিবর্তনের উপর ট্রিগার করে। একটি ক্লাউড ফায়ারস্টোর নথিতে একটি আপডেট যেখানে ডেটা অপরিবর্তিত থাকে (একটি নো-অপ লেখা) একটি আপডেট বা লেখার ইভেন্ট তৈরি করে না। নির্দিষ্ট ক্ষেত্রে ইভেন্ট যোগ করা সম্ভব নয়।

আপনার যদি এখনও Firebase-এর জন্য ক্লাউড ফাংশনগুলির জন্য কোনও প্রকল্প সক্রিয় না থাকে, তাহলে Firebase প্রকল্পের জন্য আপনার ক্লাউড ফাংশনগুলি কনফিগার এবং সেট আপ করতে Firebase (2nd gen) এর জন্য ক্লাউড ফাংশন দিয়ে শুরু করুন পড়ুন৷

ক্লাউড ফায়ারস্টোর-ট্রিগার করা ফাংশন লেখা

একটি ফাংশন ট্রিগার সংজ্ঞায়িত করুন

একটি ক্লাউড ফায়ারস্টোর ট্রিগার সংজ্ঞায়িত করতে, একটি নথির পথ এবং একটি ইভেন্টের ধরন নির্দিষ্ট করুন:

Node.js

import {
  onDocumentWritten,
  onDocumentCreated,
  onDocumentUpdated,
  onDocumentDeleted,
  Change,
  FirestoreEvent
} from "firebase-functions/v2/firestore";

exports.myfunction = onDocumentWritten("my-collection/{docId}", (event) => {
   /* ... */ 
});

পাইথন (প্রিভিউ)

from firebase_functions.firestore_fn import (
  on_document_created,
  on_document_deleted,
  on_document_updated,
  on_document_written,
  Event,
  Change,
  DocumentSnapshot,
)

@on_document_created(document="users/{userId}")
def myfunction(event: Event[DocumentSnapshot]) -> None:

নথির পাথগুলি একটি নির্দিষ্ট নথি বা একটি ওয়াইল্ডকার্ড প্যাটার্ন উল্লেখ করতে পারে।

একটি একক নথি উল্লেখ করুন

আপনি যদি একটি নির্দিষ্ট নথিতে কোনও পরিবর্তনের জন্য একটি ইভেন্ট ট্রিগার করতে চান তবে আপনি নিম্নলিখিত ফাংশনটি ব্যবহার করতে পারেন।

Node.js

import {
  onDocumentWritten,
  Change,
  FirestoreEvent
} from "firebase-functions/v2/firestore";

exports.myfunction = onDocumentWritten("users/marie", (event) => {
  // Your code here
});

পাইথন (প্রিভিউ)

from firebase_functions.firestore_fn import (
  on_document_written,
  Event,
  Change,
  DocumentSnapshot,
)

@on_document_written(document="users/marie")
def myfunction(event: Event[Change[DocumentSnapshot]]) -> None:

ওয়াইল্ডকার্ড ব্যবহার করে নথির একটি গ্রুপ নির্দিষ্ট করুন

আপনি যদি নথির একটি গোষ্ঠীতে একটি ট্রিগার সংযুক্ত করতে চান, যেমন একটি নির্দিষ্ট সংগ্রহের কোনো নথি, তাহলে নথি আইডির জায়গায় একটি {wildcard} ব্যবহার করুন:

Node.js

import {
  onDocumentWritten,
  Change,
  FirestoreEvent
} from "firebase-functions/v2/firestore";

exports.myfunction = onDocumentWritten("users/{userId}", (event) => {
  // If we set `/users/marie` to {name: "Marie"} then
  // event.params.userId == "marie"
  // ... and ...
  // event.data.after.data() == {name: "Marie"}
});

পাইথন (প্রিভিউ)

from firebase_functions.firestore_fn import (
  on_document_written,
  Event,
  Change,
  DocumentSnapshot,
)

@on_document_written(document="users/{userId}")
def myfunction(event: Event[Change[DocumentSnapshot]]) -> None:
  # If we set `/users/marie` to {name: "Marie"} then
  event.params["userId"] == "marie"  # True
  # ... and ...
  event.data.after.to_dict() == {"name": "Marie"}  # True

এই উদাহরণে, যখন users কোনো নথিতে কোনো ক্ষেত্র পরিবর্তন করা হয়, তখন এটি userId নামক ওয়াইল্ডকার্ডের সাথে মেলে।

যদি users মধ্যে একটি নথিতে উপসংগ্রহ থাকে এবং সেই উপসংগ্রহগুলির নথিগুলির একটিতে একটি ক্ষেত্র পরিবর্তন করা হয়, তাহলে userId ওয়াইল্ডকার্ডটি ট্রিগার হয় না

ওয়াইল্ডকার্ড ম্যাচ ডকুমেন্ট পাথ থেকে বের করে event.params এ সংরক্ষণ করা হয়। আপনি সুস্পষ্ট সংগ্রহ বা নথি আইডি প্রতিস্থাপন করতে চান যতগুলি ওয়াইল্ডকার্ড সংজ্ঞায়িত করতে পারেন, উদাহরণস্বরূপ:

Node.js

import {
  onDocumentWritten,
  Change,
  FirestoreEvent
} from "firebase-functions/v2/firestore";

exports.myfunction = onDocumentWritten("users/{userId}/{messageCollectionId}/{messageId}", (event) => {
    // If we set `/users/marie/incoming_messages/134` to {body: "Hello"} then
    // event.params.userId == "marie";
    // event.params.messageCollectionId == "incoming_messages";
    // event.params.messageId == "134";
    // ... and ...
    // event.data.after.data() == {body: "Hello"}
});

পাইথন (প্রিভিউ)

from firebase_functions.firestore_fn import (
  on_document_written,
  Event,
  Change,
  DocumentSnapshot,
)

@on_document_written(document="users/{userId}/{messageCollectionId}/{messageId}")
def myfunction(event: Event[Change[DocumentSnapshot]]) -> None:
  # If we set `/users/marie/incoming_messages/134` to {body: "Hello"} then
  event.params["userId"] == "marie"  # True
  event.params["messageCollectionId"] == "incoming_messages"  # True
  event.params["messageId"] == "134"  # True
  # ... and ...
  event.data.after.to_dict() == {"body": "Hello"}

আপনার ট্রিগার অবশ্যই একটি নথির দিকে নির্দেশ করবে, এমনকি আপনি যদি একটি ওয়াইল্ডকার্ড ব্যবহার করেন। উদাহরণস্বরূপ, users/{userId}/{messageCollectionId} বৈধ নয় কারণ {messageCollectionId} একটি সংগ্রহ। যাইহোক, users/{userId}/{messageCollectionId}/{messageId} বৈধ কারণ {messageId} সর্বদা একটি নথিতে নির্দেশ করবে৷

ইভেন্ট ট্রিগার

একটি নতুন নথি তৈরি করা হলে একটি ফাংশন ট্রিগার করুন

সংগ্রহে একটি নতুন নথি তৈরি করা হলে আপনি যে কোনো সময় ফায়ার করার জন্য একটি ফাংশন ট্রিগার করতে পারেন। এই উদাহরণ ফাংশন প্রতিবার একটি নতুন ব্যবহারকারী প্রোফাইল যোগ করা হলে ট্রিগার করে:

Node.js

import {
  onDocumentCreated,
  Change,
  FirestoreEvent
} from "firebase-functions/v2/firestore";

exports.createuser = onDocumentCreated("users/{userId}", (event) => {
    // Get an object representing the document
    // e.g. {'name': 'Marie', 'age': 66}
    const snapshot = event.data;
    if (!snapshot) {
        console.log("No data associated with the event");
        return;
    }
    const data = snapshot.data();

    // access a particular field as you would any JS property
    const name = data.name;

    // perform more operations ...
});

অতিরিক্ত প্রমাণীকরণ তথ্যের জন্য, onDocumentCreatedWithAuthContext ব্যবহার করুন।

পাইথন (প্রিভিউ)

from firebase_functions.firestore_fn import (
  on_document_created,
  Event,
  DocumentSnapshot,
)

@on_document_created(document="users/{userId}")
def myfunction(event: Event[DocumentSnapshot]) -> None:
  # Get a dictionary representing the document
  # e.g. {'name': 'Marie', 'age': 66}
  new_value = event.data.to_dict()

  # Access a particular field as you would any dictionary
  name = new_value["name"]

  # Perform more operations ...

একটি নথি আপডেট করা হলে একটি ফাংশন ট্রিগার করুন

একটি নথি আপডেট করা হলে আপনি ফায়ার করার জন্য একটি ফাংশন ট্রিগার করতে পারেন। এই উদাহরণ ফাংশন ফায়ার করে যদি একজন ব্যবহারকারী তাদের প্রোফাইল পরিবর্তন করে:

Node.js

import {
  onDocumentUpdated,
  Change,
  FirestoreEvent
} from "firebase-functions/v2/firestore";

exports.updateuser = onDocumentUpdated("users/{userId}", (event) => {
    // Get an object representing the document
    // e.g. {'name': 'Marie', 'age': 66}
    const newValue = event.data.after.data();

    // access a particular field as you would any JS property
    const name = newValue.name;

    // perform more operations ...
});

অতিরিক্ত প্রমাণীকরণ তথ্যের জন্য, onDocumentUpdatedWithAuthContext ব্যবহার করুন।

পাইথন (প্রিভিউ)

from firebase_functions.firestore_fn import (
  on_document_updated,
  Event,
  Change,
  DocumentSnapshot,
)

@on_document_updated(document="users/{userId}")
def myfunction(event: Event[Change[DocumentSnapshot]]) -> None:
  # Get a dictionary representing the document
  # e.g. {'name': 'Marie', 'age': 66}
  new_value = event.data.after.to_dict()

  # Access a particular field as you would any dictionary
  name = new_value["name"]

  # Perform more operations ...

একটি নথি মুছে ফেলা হলে একটি ফাংশন ট্রিগার

একটি নথি মুছে ফেলা হলে আপনি একটি ফাংশন ট্রিগার করতে পারেন। এই উদাহরণ ফাংশন ফায়ার করে যখন একজন ব্যবহারকারী তাদের ব্যবহারকারী প্রোফাইল মুছে দেয়:

Node.js

import {
  onDocumentDeleted,
  Change,
  FirestoreEvent
} from "firebase-functions/v2/firestore";

exports.deleteuser = onDocumentDeleted("users/{userId}", (event) => {
    // Get an object representing the document
    // e.g. {'name': 'Marie', 'age': 66}
    const snap =  event.data;
    const data =  snap.data();

    // perform more operations ...
});

অতিরিক্ত প্রমাণীকরণ তথ্যের জন্য, onDocumentDeletedWithAuthContext ব্যবহার করুন।

পাইথন (প্রিভিউ)

from firebase_functions.firestore_fn import (
  on_document_deleted,
  Event,
  DocumentSnapshot,
)

@on_document_deleted(document="users/{userId}")
def myfunction(event: Event[DocumentSnapshot|None]) -> None:
  # Perform more operations ...

একটি নথিতে সমস্ত পরিবর্তনের জন্য একটি ফাংশন ট্রিগার করুন

আপনি যদি ইভেন্টের ধরণ সম্পর্কে চিন্তা না করেন তবে আপনি "ডকুমেন্ট লিখিত" ইভেন্ট ট্রিগার ব্যবহার করে একটি ক্লাউড ফায়ারস্টোর নথিতে সমস্ত পরিবর্তন শুনতে পারেন৷ এই উদাহরণ ফাংশনটি চালু হয় যদি একজন ব্যবহারকারী তৈরি করা হয়, আপডেট করা হয় বা মুছে ফেলা হয়:

Node.js

import {
  onDocumentWritten,
  Change,
  FirestoreEvent
} from "firebase-functions/v2/firestore";

exports.modifyuser = onDocumentWritten("users/{userId}", (event) => {
    // Get an object with the current document values.
    // If the document does not exist, it was deleted
    const document =  event.data.after.data();

    // Get an object with the previous document values
    const previousValues =  event.data.before.data();

    // perform more operations ...
});

অতিরিক্ত প্রমাণীকরণ তথ্যের জন্য, onDocumentWrittenWithAuthContext ব্যবহার করুন।

পাইথন (প্রিভিউ)

from firebase_functions.firestore_fn import (
  on_document_written,
  Event,
  Change,
  DocumentSnapshot,
)

@on_document_written(document="users/{userId}")
def myfunction(event: Event[Change[DocumentSnapshot | None]]) -> None:
  # Get an object with the current document values.
  # If the document does not exist, it was deleted.
  document = (event.data.after.to_dict()
              if event.data.after is not None else None)

  # Get an object with the previous document values.
  # If the document does not exist, it was newly created.
  previous_values = (event.data.before.to_dict()
                     if event.data.before is not None else None)

  # Perform more operations ...

ডেটা পড়া এবং লেখা

যখন একটি ফাংশন ট্রিগার হয়, এটি ইভেন্ট সম্পর্কিত ডেটার একটি স্ন্যাপশট প্রদান করে। আপনি এই স্ন্যাপশটটি ইভেন্টটি ট্রিগারকারী ডকুমেন্ট থেকে পড়তে বা লিখতে বা আপনার ডাটাবেসের অন্যান্য অংশ অ্যাক্সেস করতে Firebase অ্যাডমিন SDK ব্যবহার করতে পারেন।

ইভেন্ট ডেটা

ডেটা পড়া

যখন একটি ফাংশন ট্রিগার করা হয়, আপনি আপডেট হওয়া একটি নথি থেকে ডেটা পেতে চাইতে পারেন, বা আপডেট করার আগে ডেটা পেতে পারেন৷ আপনি event.data.before ব্যবহার করে আগের ডেটা পেতে পারেন, যাতে আপডেটের আগে ডকুমেন্ট স্ন্যাপশট থাকে। একইভাবে, event.data.after আপডেটের পরে ডকুমেন্টের স্ন্যাপশট অবস্থা ধারণ করে।

Node.js

exports.updateuser2 = onDocumentUpdated("users/{userId}", (event) => {
    // Get an object with the current document values.
    // If the document does not exist, it was deleted
    const newValues =  event.data.after.data();

    // Get an object with the previous document values
    const previousValues =  event.data.before.data();
});

পাইথন (প্রিভিউ)

@on_document_updated(document="users/{userId}")
def myfunction(event: Event[Change[DocumentSnapshot]]) -> None:
  # Get an object with the current document values.
  new_value = event.data.after.to_dict()

  # Get an object with the previous document values.
  prev_value = event.data.before.to_dict()

আপনি অন্য কোন বস্তুর মত বৈশিষ্ট্য অ্যাক্সেস করতে পারেন। বিকল্পভাবে, আপনি নির্দিষ্ট ক্ষেত্র অ্যাক্সেস করতে get ফাংশন ব্যবহার করতে পারেন:

Node.js

// Fetch data using standard accessors
const age = event.data.after.data().age;
const name = event.data.after.data()['name'];

// Fetch data using built in accessor
const experience = event.data.after.data.get('experience');

পাইথন (প্রিভিউ)

# Get the value of a single document field.
age = event.data.after.get("age")

# Convert the document to a dictionary.
age = event.data.after.to_dict()["age"]

ডেটা লেখা

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

নথির রেফারেন্সে update() , set() , এবং remove() এর মত পদ্ধতি রয়েছে যাতে আপনি ফাংশনটি ট্রিগারকারী নথিটি সংশোধন করতে পারেন।

Node.js

import { onDocumentUpdated } from "firebase-functions/v2/firestore";

exports.countnamechanges = onDocumentUpdated('users/{userId}', (event) => {
  // Retrieve the current and previous value
  const data = event.data.after.data();
  const previousData = event.data.before.data();

  // We'll only update if the name has changed.
  // This is crucial to prevent infinite loops.
  if (data.name == previousData.name) {
    return null;
  }

  // Retrieve the current count of name changes
  let count = data.name_change_count;
  if (!count) {
    count = 0;
  }

  // Then return a promise of a set operation to update the count
  return data.after.ref.set({
    name_change_count: count + 1
  }, {merge: true});

});

পাইথন (প্রিভিউ)

@on_document_updated(document="users/{userId}")
def myfunction(event: Event[Change[DocumentSnapshot]]) -> None:
  # Get the current and previous document values.
  new_value = event.data.after
  prev_value = event.data.before

  # We'll only update if the name has changed.
  # This is crucial to prevent infinite loops.
  if new_value.get("name") == prev_value.get("name"):
      return

  # Retrieve the current count of name changes
  count = new_value.to_dict().get("name_change_count", 0)

  # Update the count
  new_value.reference.update({"name_change_count": count + 1})

ব্যবহারকারীর প্রমাণীকরণ তথ্য অ্যাক্সেস করুন

আপনি যদি নিম্নলিখিত ইভেন্টের ধরনগুলির মধ্যে একটি ব্যবহার করেন, আপনি ইভেন্টটি ট্রিগারকারী প্রধান সম্পর্কে ব্যবহারকারীর প্রমাণীকরণ তথ্য অ্যাক্সেস করতে পারেন। এই তথ্য বেস ইভেন্টে ফিরে তথ্য ছাড়াও.

Node.js

  • onDocumentCreatedWithAuthContext
  • onDocumentWrittenWithAuthContext
  • onDocumentDeletedWithAuthContext
  • onDocumentUpdatedWithAuthContext

পাইথন (প্রিভিউ)

  • on_document_created_with_auth_context
  • on_document_updated_with_auth_context
  • on_document_deleted_with_auth_context
  • on_document_written_with_auth_context

প্রমাণীকরণ প্রসঙ্গে উপলব্ধ ডেটা সম্পর্কে তথ্যের জন্য, প্রমাণীকরণ প্রসঙ্গ দেখুন। নিম্নলিখিত উদাহরণ প্রমাণীকরণ তথ্য পুনরুদ্ধার কিভাবে প্রদর্শন করে:

Node.js

import { onDocumentWrittenWithAuthContext } from "firebase-functions/v2/firestore"

exports.syncUser = onDocumentWrittenWithAuthContext("users/{userId}", (event) => {
    const snapshot = event.data.after;
    if (!snapshot) {
        console.log("No data associated with the event");
        return;
    }
    const data = snapshot.data();

    // retrieve auth context from event
    const { authType, authId } = event;

    let verified = false;
    if (authType === "system") {
      // system-generated users are automatically verified
      verified = true;
    } else if (authType === "unknown" || authType === "unauthenticated") {
      // admin users from a specific domain are verified
      if (authId.endsWith("@example.com")) {
        verified = true;
      }
    }

    return data.after.ref.set({
        created_by: authId,
        verified,
    }, {merge: true}); 
}); 

পাইথন (প্রিভিউ)

@on_document_updated_with_auth_context(document="users/{userId}")
def myfunction(event: Event[Change[DocumentSnapshot]]) -> None:

  # Get the current and previous document values.
  new_value = event.data.after
  prev_value = event.data.before

  # Get the auth context from the event
  user_auth_type = event.auth_type
  user_auth_id = event.auth_id

ট্রিগার ইভেন্টের বাইরের ডেটা

ক্লাউড ফাংশন একটি বিশ্বস্ত পরিবেশে সঞ্চালিত হয়। তারা আপনার প্রকল্পে একটি পরিষেবা অ্যাকাউন্ট হিসাবে অনুমোদিত, এবং আপনি Firebase অ্যাডমিন SDK ব্যবহার করে পড়া এবং লিখতে পারেন:

Node.js

const { initializeApp } = require('firebase-admin/app');
const { getFirestore, Timestamp, FieldValue } = require('firebase-admin/firestore');

initializeApp();
const db = getFirestore();

exports.writetofirestore = onDocumentWritten("some/doc", (event) => {
    db.doc('some/otherdoc').set({ ... });
  });

  exports.writetofirestore = onDocumentWritten('users/{userId}', (event) => {
    db.doc('some/otherdoc').set({
      // Update otherdoc
    });
  });

পাইথন (প্রিভিউ)

from firebase_admin import firestore, initialize_app
import google.cloud.firestore

initialize_app()

@on_document_written(document="some/doc")
def myfunction(event: Event[Change[DocumentSnapshot | None]]) -> None:
  firestore_client: google.cloud.firestore.Client = firestore.client()
  firestore_client.document("another/doc").set({
      # ...
  })

সীমাবদ্ধতা

ক্লাউড ফাংশনগুলির জন্য ক্লাউড ফায়ারস্টোর ট্রিগারগুলির জন্য নিম্নলিখিত সীমাবদ্ধতাগুলি নোট করুন:

  • অর্ডার নিশ্চিত করা হয় না. দ্রুত পরিবর্তনগুলি একটি অপ্রত্যাশিত ক্রমে ফাংশন আহ্বানকে ট্রিগার করতে পারে।
  • ইভেন্টগুলি অন্তত একবার বিতরণ করা হয়, কিন্তু একটি একক ইভেন্ট একাধিক ফাংশন আহ্বানের ফলে হতে পারে। ঠিক-একবার মেকানিক্সের উপর নির্ভর করে এড়িয়ে চলুন এবং অদম্য ফাংশন লিখুন।
  • ডেটাস্টোর মোডে ক্লাউড ফায়ারস্টোরের জন্য ক্লাউড ফাংশন (২য় প্রজন্ম) প্রয়োজন। ক্লাউড ফাংশন (1ম প্রজন্ম) ডেটাস্টোর মোড সমর্থন করে না।
  • ক্লাউড ফাংশন (1ম প্রজন্ম) শুধুমাত্র "(ডিফল্ট)" ডাটাবেসের সাথে কাজ করে এবং ক্লাউড ফায়ারস্টোর নামের ডেটাবেস সমর্থন করে না। নামকৃত ডাটাবেসের জন্য ইভেন্ট কনফিগার করতে দয়া করে ক্লাউড ফাংশন (২য় জেনার) ব্যবহার করুন।
  • একটি ট্রিগার একটি একক ডাটাবেসের সাথে যুক্ত। আপনি একাধিক ডাটাবেসের সাথে মেলে এমন একটি ট্রিগার তৈরি করতে পারবেন না।
  • একটি ডাটাবেস মুছে দিলে সেই ডাটাবেসের জন্য কোনো ট্রিগার স্বয়ংক্রিয়ভাবে মুছে যায় না। ট্রিগারটি ইভেন্টগুলি সরবরাহ করা বন্ধ করে তবে আপনি ট্রিগারটি মুছে না দেওয়া পর্যন্ত বিদ্যমান থাকবে৷
  • যদি একটি মিলে যাওয়া ইভেন্ট সর্বোচ্চ অনুরোধের আকারকে অতিক্রম করে, তাহলে ইভেন্টটি ক্লাউড ফাংশনে (প্রথম প্রজন্ম) বিতরণ করা যাবে না।
    • অনুরোধের আকারের কারণে ইভেন্টগুলি বিতরণ করা হয়নি প্ল্যাটফর্ম লগগুলিতে লগ ইন করা হয় এবং প্রকল্পের জন্য লগ ব্যবহারের জন্য গণনা করা হয়৷
    • আপনি লগ এক্সপ্লোরার-এ এই লগগুলি খুঁজে পেতে পারেন error তীব্রতার "প্রথম প্রজন্মের সীমা অতিক্রম করার কারণে ইভেন্টটি ক্লাউড ফাংশনে বিতরণ করতে পারে না..."। আপনি functionName ক্ষেত্রের অধীনে ফাংশনের নাম খুঁজে পেতে পারেন। receiveTimestamp ক্ষেত্রটি এখন থেকে এক ঘন্টার মধ্যে থাকলে, আপনি টাইমস্ট্যাম্পের আগে এবং পরে একটি স্ন্যাপশট সহ প্রশ্নে থাকা নথিটি পড়ে প্রকৃত ইভেন্ট বিষয়বস্তু অনুমান করতে পারেন।
    • এই ধরনের ক্যাডেন্স এড়াতে, আপনি করতে পারেন:
      • মাইগ্রেট করুন এবং ক্লাউড ফাংশনে আপগ্রেড করুন (২য় প্রজন্ম)
      • ডকুমেন্টটি ছোট করুন
      • প্রশ্নে থাকা ক্লাউড ফাংশনগুলি মুছুন
    • আপনি বর্জন ব্যবহার করে নিজেই লগিং বন্ধ করতে পারেন তবে মনে রাখবেন যে আপত্তিকর ঘটনাগুলি এখনও বিতরণ করা হবে না৷