একটি লেখার ব্যাচ, একটি একক পারমাণবিক একক হিসাবে একাধিক লেখা সম্পাদন করতে ব্যবহৃত হয়।
writeBatch() কল করে একটি WriteBatch অবজেক্ট অর্জন করা যেতে পারে . এটি লেখার ব্যাচে রাইট যোগ করার পদ্ধতি প্রদান করে। WriteBatch.commit() বলা না হওয়া পর্যন্ত কোনো লেখাই প্রতিশ্রুতিবদ্ধ (বা স্থানীয়ভাবে দৃশ্যমান) হবে না।
স্বাক্ষর:
export declare class WriteBatch
পদ্ধতি
| পদ্ধতি | সংশোধক | বর্ণনা |
|---|---|---|
| প্রতিশ্রুতিবদ্ধ() | এই লেখার ব্যাচের সমস্ত লেখাকে একক পারমাণবিক একক হিসাবে কমিট করে। এই লেখাগুলির ফলাফল শুধুমাত্র নথিতে প্রতিফলিত হবে যা প্রত্যাবর্তিত প্রতিশ্রুতি সমাধানের পরে ঘটে। ক্লায়েন্ট অফলাইন হলে, লিখতে ব্যর্থ হয়। আপনি যদি ক্লায়েন্ট অনলাইন না হওয়া পর্যন্ত স্থানীয় পরিবর্তন বা বাফার লেখা দেখতে চান, তাহলে সম্পূর্ণ Firestore SDK ব্যবহার করুন। | |
| মুছুন(দস্তাবেজ রেফ) | প্রদত্ত ডকুমেন্ট রেফারেন্স দ্বারা উল্লেখিত নথিটি মুছে দেয় . | |
| সেট (ডকুমেন্ট রেফ, ডেটা) | প্রদত্ত ডকুমেন্ট রেফারেন্স দ্বারা উল্লেখিত নথিতে লেখে . যদি নথিটি এখনও বিদ্যমান না থাকে তবে এটি তৈরি করা হবে। | |
| সেট (ডকুমেন্ট রেফ, ডেটা, বিকল্প) | প্রদত্ত ডকুমেন্ট রেফারেন্স দ্বারা উল্লেখিত নথিতে লেখে . যদি নথিটি এখনও বিদ্যমান না থাকে তবে এটি তৈরি করা হবে। আপনি যদি merge বা mergeFields প্রদান করেন, প্রদত্ত ডেটা একটি বিদ্যমান নথিতে মার্জ করা যেতে পারে। | |
| আপডেট (ডকুমেন্ট রেফ, ডেটা) | প্রদত্ত ডকুমেন্ট রেফারেন্স দ্বারা উল্লেখ করা নথিতে ক্ষেত্রগুলি আপডেট করে৷ . বিদ্যমান নেই এমন একটি নথিতে প্রয়োগ করা হলে আপডেটটি ব্যর্থ হবে। | |
| আপডেট (দস্তাবেজ রেফ, ক্ষেত্র, মান, আরও ক্ষেত্র এবং মান) | এই ডকুমেন্ট রেফারেন্স দ্বারা উল্লেখ করা নথিতে ক্ষেত্রগুলি আপডেট করে৷ . বিদ্যমান নেই এমন একটি নথিতে প্রয়োগ করা হলে আপডেটটি ব্যর্থ হবে। নেস্টেড ক্ষেত্রগুলিকে ডট-সপারেটেড ফিল্ড পাথ স্ট্রিং প্রদান করে বা FieldPath অবজেক্ট প্রদান করে আপডেট করা যেতে পারে। |
WriteBatch.commit()
এই লেখার ব্যাচের সমস্ত লেখাকে একক পারমাণবিক একক হিসাবে কমিট করে।
এই লেখাগুলির ফলাফল শুধুমাত্র নথিতে প্রতিফলিত হবে যা প্রত্যাবর্তিত প্রতিশ্রুতি সমাধানের পরে ঘটে। ক্লায়েন্ট অফলাইন হলে, লিখতে ব্যর্থ হয়। আপনি যদি ক্লায়েন্ট অনলাইন না হওয়া পর্যন্ত স্থানীয় পরিবর্তন বা বাফার লেখা দেখতে চান, তাহলে সম্পূর্ণ Firestore SDK ব্যবহার করুন।
স্বাক্ষর:
commit(): Promise;
রিটার্ন:
প্রতিশ্রুতি
ব্যাচের সমস্ত লেখা সফলভাবে একটি পারমাণবিক ইউনিট হিসাবে ব্যাকএন্ডে লেখা হয়ে গেলে একটি Promise সমাধান করা হয়েছে (মনে রাখবেন যে আপনি অফলাইনে থাকাকালীন এটি সমাধান হবে না)।
WriteBatch.delete()
প্রদত্ত ডকুমেন্ট রেফারেন্স দ্বারা উল্লেখিত নথিটি মুছে দেয় .
স্বাক্ষর:
delete(documentRef: DocumentReference): WriteBatch;
পরামিতি
| প্যারামিটার | টাইপ | বর্ণনা |
|---|---|---|
| ডকুমেন্ট রেফ | ডকুমেন্ট রেফারেন্স | মুছে ফেলা নথির একটি রেফারেন্স. |
রিটার্ন:
এই WriteBatch উদাহরণ. চেইনিং পদ্ধতি কলের জন্য ব্যবহৃত হয়।
WriteBatch.set()
প্রদত্ত ডকুমেন্ট রেফারেন্স দ্বারা উল্লেখিত নথিতে লেখে . যদি নথিটি এখনও বিদ্যমান না থাকে তবে এটি তৈরি করা হবে।
স্বাক্ষর:
set(documentRef: DocumentReference, data: WithFieldValue): WriteBatch;
পরামিতি
| প্যারামিটার | টাইপ | বর্ণনা |
|---|---|---|
| ডকুমেন্ট রেফ | ডকুমেন্ট রেফারেন্স | নথির একটি রেফারেন্স সেট করতে হবে। |
| তথ্য | ফিল্ড ভ্যালু সহ | নথির জন্য ক্ষেত্র এবং মানগুলির একটি বস্তু। |
রিটার্ন:
এই WriteBatch উদাহরণ. চেইনিং পদ্ধতি কলের জন্য ব্যবহৃত হয়।
WriteBatch.set()
প্রদত্ত ডকুমেন্ট রেফারেন্স দ্বারা উল্লেখিত নথিতে লেখে . যদি নথিটি এখনও বিদ্যমান না থাকে তবে এটি তৈরি করা হবে। যদি আপনি merge বা mergeFields প্রদান করেন , প্রদত্ত ডেটা একটি বিদ্যমান নথিতে মার্জ করা যেতে পারে।
স্বাক্ষর:
set(documentRef: DocumentReference, data: PartialWithFieldValue, options: SetOptions): WriteBatch;
পরামিতি
| প্যারামিটার | টাইপ | বর্ণনা |
|---|---|---|
| ডকুমেন্ট রেফ | ডকুমেন্ট রেফারেন্স | নথির একটি রেফারেন্স সেট করতে হবে। |
| তথ্য | PartialWithFieldValue | নথির জন্য ক্ষেত্র এবং মানগুলির একটি বস্তু। |
| বিকল্প | সেট অপশন | সেট আচরণ কনফিগার করার জন্য একটি বস্তু। |
রিটার্ন:
এই WriteBatch উদাহরণ. চেইনিং পদ্ধতি কলের জন্য ব্যবহৃত হয়।
ব্যতিক্রম
ত্রুটি - যদি প্রদত্ত ইনপুট একটি বৈধ Firestore নথি না হয়।
WriteBatch.update()
প্রদত্ত ডকুমেন্ট রেফারেন্স দ্বারা উল্লেখ করা নথিতে ক্ষেত্রগুলি আপডেট করে৷ . বিদ্যমান নেই এমন একটি নথিতে প্রয়োগ করা হলে আপডেটটি ব্যর্থ হবে।
স্বাক্ষর:
update(documentRef: DocumentReference, data: UpdateData): WriteBatch;
পরামিতি
| প্যারামিটার | টাইপ | বর্ণনা |
|---|---|---|
| ডকুমেন্ট রেফ | ডকুমেন্ট রেফারেন্স | আপডেট করা নথির একটি রেফারেন্স। |
| তথ্য | আপডেট ডেটা | দস্তাবেজ আপডেট করার জন্য ক্ষেত্র এবং মান ধারণকারী একটি বস্তু। নথির মধ্যে নেস্টেড ক্ষেত্র উল্লেখ করার জন্য ক্ষেত্রগুলিতে বিন্দু থাকতে পারে। |
রিটার্ন:
এই WriteBatch উদাহরণ. চেইনিং পদ্ধতি কলের জন্য ব্যবহৃত হয়।
ব্যতিক্রম
ত্রুটি - যদি প্রদত্ত ইনপুট বৈধ না হয় Firestore ডেটা৷
WriteBatch.update()
এই ডকুমেন্ট রেফারেন্স দ্বারা উল্লেখ করা নথিতে ক্ষেত্রগুলি আপডেট করে৷ . বিদ্যমান নেই এমন একটি নথিতে প্রয়োগ করা হলে আপডেটটি ব্যর্থ হবে।
নেস্টেড ক্ষেত্রগুলিকে ডট-সপারেটেড ফিল্ড পাথ স্ট্রিং প্রদান করে বা FieldPath অবজেক্ট প্রদান করে আপডেট করা যেতে পারে।
স্বাক্ষর:
update(documentRef: DocumentReference, field: string | FieldPath, value: unknown, ...moreFieldsAndValues: unknown[]): WriteBatch;
পরামিতি
| প্যারামিটার | টাইপ | বর্ণনা |
|---|---|---|
| ডকুমেন্ট রেফ | ডকুমেন্ট রেফারেন্স | আপডেট করা নথির একটি রেফারেন্স। |
| ক্ষেত্র | স্ট্রিং | ফিল্ডপাথ | আপডেট করার জন্য প্রথম ক্ষেত্র। |
| মান | অজানা | প্রথম মান. |
| আরও ক্ষেত্র এবং মান | অজানা[] | অতিরিক্ত কী মান জোড়া। |
রিটার্ন:
এই WriteBatch উদাহরণ. চেইনিং পদ্ধতি কলের জন্য ব্যবহৃত হয়।
ব্যতিক্রম
ত্রুটি - যদি প্রদত্ত ইনপুট বৈধ না হয় Firestore ডেটা৷