কল করা যায় এমন Cloud Function-এর মাধ্যমে ডেটা মুছে ফেলা

ডেটা মুছে ফেলার জন্য কীভাবে কল করা যায় এমন Cloud Function ব্যবহার করতে হয় তা এই পৃষ্ঠায় বর্ণনা করা হয়েছে। আপনি এই ফাংশনটি ডিপ্লয় করার পরে, ডকুমেন্ট এবং সংগ্রহ বারবার মুছে ফেলার জন্য আপনার মোবাইল অ্যাপ বা ওয়েবসাইট থেকে সরাসরি এটি কল করতে পারবেন। যেমন, আপনি এই সমাধান ব্যবহার করে বাছাই করা ব্যবহারকারীদের সম্পূর্ণ সংগ্রহ মুছে ফেলার ক্ষমতা দিতে পারেন।

কালেকশন মুছে দেওয়ার অন্যান্য উপায় সম্পর্কে জানতে, ডেটা মুছে দিন বিকল্প দেখুন।

সমাধান: কল করা যায় এমন Cloud Function-এর মাধ্যমে ডেটা মুছে ফেলা

সীমিত রিসোর্স সহ মোবাইল অ্যাপ থেকে সম্পূর্ণ সংগ্রহ মুছে ফেলা কঠিন হতে পারে নিম্নলিখিত কারণে বাস্তবায়ন করা:

  • এমন কোনও অপারেশন নেই যা কোনও কালেকশনকে অটোমেটিক মুছে দেয়।
  • কোনও ডকুমেন্ট মুছে দিলে, তার সাব-কালেকশনে থাকা ডকুমেন্ট মুছে যায় না।
  • আপনার ডকুমেন্টে ডাইনামিক সাবকালেকশন থাকলে, কোনও নির্দিষ্ট পাথের জন্য কোন ডেটা মুছতে হবে তা জানা কঠিন হতে পারে।
  • ৫০০টির বেশি ডকুমেন্টের সংগ্রহ মুছে ফেলার জন্য একাধিক ব্যাচড রাইট অপারেশন বা শত শত একক মুছে ফেলার প্রয়োজন হয়।
  • অনেক অ্যাপে, ব্যবহারকারীদের সম্পূর্ণ সংগ্রহ মুছে ফেলার অনুমতি দেওয়া উপযুক্ত নয়।

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

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

Cloud Function

নিচের Cloud Function একটি কালেকশন ও তার সব ডিসেন্ডেন্ট মুছে দেয়।

আপনার ক্লাউড ফাংশনের জন্য নিজের রিকার্সিভ ডিলিট লজিক প্রয়োগ করার পরিবর্তে, আপনি Firebase কমান্ড লাইন ইন্টারফেস (CLI)-এ firestore:delete কমান্ডের সুবিধা নিতে পারেন। আপনি firebase-tools প্যাকেজ ব্যবহার করে আপনার Node.js অ্যাপ্লিকেশনে Firebase CLI-এর যেকোনও ফাংশন ইমপোর্ট করতে পারবেন।

Firebase CLI, Cloud Firestore REST API ব্যবহার করে নির্দিষ্ট পাথের অধীনে থাকা সব ডকুমেন্ট খুঁজে বের করে এবং সেগুলি আলাদা আলাদাভাবে মুছে দেয়। এই ইমপ্লিমেন্টেশনের জন্য আপনার অ্যাপের নির্দিষ্ট ডেটা হায়ারার্কি সম্পর্কে কোনও জ্ঞানের প্রয়োজন নেই এবং এমনকি "অনাথ" ডকুমেন্টগুলি খুঁজে বের করবে এবং মুছে ফেলবে যেগুলির আর কোনও প্যারেন্ট নেই।

Node.js

/**
 * Initiate a recursive delete of documents at a given path.
 * 
 * The calling user must be authenticated and have the custom "admin" attribute
 * set to true on the auth token.
 * 
 * This delete is NOT an atomic operation and it's possible
 * that it may fail after only deleting some documents.
 * 
 * @param {string} data.path the document or collection path to delete.
 */
exports.recursiveDelete = functions
  .runWith({
    timeoutSeconds: 540,
    memory: '2GB'
  })
  .https.onCall(async (data, context) => {
    // Only allow admin users to execute this function.
    if (!(context.auth && context.auth.token && context.auth.token.admin)) {
      throw new functions.https.HttpsError(
        'permission-denied',
        'Must be an administrative user to initiate delete.'
      );
    }

    const path = data.path;
    console.log(
      `User ${context.auth.uid} has requested to delete path ${path}`
    );

    // Run a recursive delete on the given document or collection path.
    // The 'token' must be set in the functions config, and can be generated
    // at the command line by running 'firebase login:ci'.
    await firebase_tools.firestore
      .delete(path, {
        project: process.env.GCLOUD_PROJECT,
        recursive: true,
        force: true,
        token: functions.config().fb.token
      });

    return {
      path: path 
    };
  });

ক্লায়েন্ট ইনভোকেশন

ফাংশন কল করতে, Firebase SDK থেকে ফাংশনের রেফারেন্স পান এবং প্রয়োজনীয় প্যারামিটার পাস করুন:

ওয়েব
/**
 * Call the 'recursiveDelete' callable function with a path to initiate
 * a server-side delete.
 */
function deleteAtPath(path) {
    var deleteFn = firebase.functions().httpsCallable('recursiveDelete');
    deleteFn({ path: path })
        .then(function(result) {
            logMessage('Delete success: ' + JSON.stringify(result));
        })
        .catch(function(err) {
            logMessage('Delete failed, see console,');
            console.warn(err);
        });
}
Swift
মনে রাখবেন: এই প্রোডাক্ট watchOS এবং অ্যাপ ক্লিপ টার্গেটে উপলভ্য নয়। 
    // Snippet not yet written
Objective-C
মনে রাখবেন: এই প্রোডাক্ট watchOS এবং অ্যাপ ক্লিপ টার্গেটে উপলভ্য নয়। 
    // Snippet not yet written

Kotlin

/**
 * Call the 'recursiveDelete' callable function with a path to initiate
 * a server-side delete.
 */
fun deleteAtPath(path: String) {
    val deleteFn = Firebase.functions.getHttpsCallable("recursiveDelete")
    deleteFn.call(hashMapOf("path" to path))
        .addOnSuccessListener {
            // Delete Success
            // ...
        }
        .addOnFailureListener {
            // Delete Failed
            // ...
        }
}

Java

/**
 * Call the 'recursiveDelete' callable function with a path to initiate
 * a server-side delete.
 */
public void deleteAtPath(String path) {
    Map<String, Object> data = new HashMap<>();
    data.put("path", path);

    HttpsCallableReference deleteFn =
            FirebaseFunctions.getInstance().getHttpsCallable("recursiveDelete");
    deleteFn.call(data)
            .addOnSuccessListener(new OnSuccessListener<HttpsCallableResult>() {
                @Override
                public void onSuccess(HttpsCallableResult httpsCallableResult) {
                    // Delete Success
                    // ...
                }
            })
            .addOnFailureListener(new OnFailureListener() {
                @Override
                public void onFailure(@NonNull Exception e) {
                    // Delete failed
                    // ...
                }
            });
}

কল করা যায় এমন ক্লাউড ফাংশনের জন্য ক্লায়েন্ট SDK ব্যবহার করে, ব্যবহারকারীর যাচাইকরণ স্ট্যাটাস এবং path প্যারামিটার রিমোট ফাংশনে নির্বিঘ্নে পাস করা হয়। ফাংশন সম্পূর্ণ হলে, ক্লায়েন্ট ফলাফল বা ব্যতিক্রম সহ একটি কলব্যাক পাবে। Android, Apple বা অন্য কোনও প্ল্যাটফর্ম থেকে কীভাবে ক্লাউড ফাংশন কল করতে হয় তা জানতে, ডকুমেন্টেশন পড়ুন।

সীমাবদ্ধতা

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

  • ধারাবাহিকতা - উপরের কোডটি একবারে একটি করে ডকুমেন্ট মুছে দেয়। মুছে দেওয়ার অপারেশন চলাকালীন আপনি কোয়েরি করলে, আপনার ফলাফলে আংশিকভাবে সম্পূর্ণ অবস্থা দেখা যেতে পারে, যেখানে শুধুমাত্র কিছু টার্গেট করা ডকুমেন্ট মুছে দেওয়া হয়েছে। এছাড়াও, মুছে ফেলার অপারেশন সফল হবে বা একইভাবে ব্যর্থ হবে তার কোনও গ্যারেন্টি নেই, তাই আংশিকভাবে মুছে ফেলার ঘটনা ম্যানেজ করার জন্য প্রস্তুত থাকুন।
  • টাইম-আউট - উপরের ফাংশনটি টাইম-আউট হওয়ার আগে সর্বাধিক ৫৪০ সেকেন্ডের জন্য চালানোর জন্য কনফিগার করা হয়েছে। ডিলিট করার কোডটি সবচেয়ে ভালো ক্ষেত্রে প্রতি সেকেন্ডে ৪০০০টি ডকুমেন্ট ডিলিট করতে পারে। আপনাকে যদি ২,০০০,০০০-এর বেশি ডকুমেন্ট মুছতে হয়, তাহলে আপনার নিজের সার্ভারে অপারেশনটি চালানোর কথা বিবেচনা করা উচিত যাতে এটি টাইম আউট না হয়ে যায়। আপনার নিজস্ব সার্ভার থেকে কীভাবে কোনও সংগ্রহ মুছবেন তার উদাহরণ দেখতে, সংগ্রহ মুছুন বিকল্প দেখুন।
  • অনেক সংখ্যক ডকুমেন্ট মুছে দিলে, Google Cloud কনসোলে ডেটা ভিউয়ার ধীরে লোড হতে পারে বা টাইমআউট সংক্রান্ত সমস্যা দেখাতে পারে।