مثالهای زیر نحوه حذف اسناد، فیلدها و مجموعهها را نشان میدهند.
اسناد را حذف کنید
برای حذف یک سند، از متدهای delete()
مخصوص زبان زیر استفاده کنید:
Web
از متد deleteDoc()
استفاده کنید:
import { doc, deleteDoc } from "firebase/firestore"; await deleteDoc(doc(db, "cities", "DC"));
Web
از متد delete()
استفاده کنید:
db.collection("cities").doc("DC").delete().then(() => { console.log("Document successfully deleted!"); }).catch((error) => { console.error("Error removing document: ", error); });
سویفت
از متد delete()
استفاده کنید:
do { try await db.collection("cities").document("DC").delete() print("Document successfully removed!") } catch { print("Error removing document: \(error)") }
هدف-C
از روش deleteDocumentWithCompletion:
استفاده کنید:
[[[self.db collectionWithPath:@"cities"] documentWithPath:@"DC"] deleteDocumentWithCompletion:^(NSError * _Nullable error) { if (error != nil) { NSLog(@"Error removing document: %@", error); } else { NSLog(@"Document successfully removed!"); } }];
Kotlin+KTX
از متد delete()
استفاده کنید:
db.collection("cities").document("DC") .delete() .addOnSuccessListener { Log.d(TAG, "DocumentSnapshot successfully deleted!") } .addOnFailureListener { e -> Log.w(TAG, "Error deleting document", e) }
Java
از متد delete()
استفاده کنید:
db.collection("cities").document("DC") .delete() .addOnSuccessListener(new OnSuccessListener<Void>() { @Override public void onSuccess(Void aVoid) { Log.d(TAG, "DocumentSnapshot successfully deleted!"); } }) .addOnFailureListener(new OnFailureListener() { @Override public void onFailure(@NonNull Exception e) { Log.w(TAG, "Error deleting document", e); } });
Dart
از متد delete()
استفاده کنید:
db.collection("cities").doc("DC").delete().then( (doc) => print("Document deleted"), onError: (e) => print("Error updating document $e"), );
جاوا
از متد delete()
استفاده کنید:
پایتون
از متد delete()
استفاده کنید:
Python
از متد delete()
استفاده کنید:
C++
از متد Delete()
استفاده کنید:
db->Collection("cities").Document("DC").Delete().OnCompletion( [](const Future<void>& future) { if (future.error() == Error::kErrorOk) { std::cout << "DocumentSnapshot successfully deleted!" << std::endl; } else { std::cout << "Error deleting document: " << future.error_message() << std::endl; } });
Node.js
از متد delete()
استفاده کنید:
برو
از متد Delete()
استفاده کنید:
PHP
از متد delete()
استفاده کنید:
وحدت
از متد DeleteAsync()
استفاده کنید:
DocumentReference cityRef = db.Collection("cities").Document("DC"); cityRef.DeleteAsync();
سی شارپ
از متد DeleteAsync()
استفاده کنید:
روبی
از متد delete()
استفاده کنید:
هنگامی که یک سند را حذف می کنید، Cloud Firestore به طور خودکار اسناد موجود در زیر مجموعه های خود را حذف نمی کند. همچنان می توانید با مراجعه به اسناد زیر مجموعه دسترسی داشته باشید. برای مثال، میتوانید در مسیر /mycoll/mydoc/mysubcoll/mysubdoc
به سند دسترسی داشته باشید، حتی اگر سند اجداد را در /mycoll/mydoc
حذف کنید.
اسناد اجدادی که وجود ندارند در کنسول ظاهر می شوند ، اما در نتایج پرس و جو و عکس های فوری ظاهر نمی شوند.
اگر می خواهید یک سند و تمام اسناد موجود در زیر مجموعه های آن را حذف کنید، باید این کار را به صورت دستی انجام دهید. برای اطلاعات بیشتر، به حذف مجموعه ها مراجعه کنید.
حذف فیلدها
برای حذف فیلدهای خاص از یک سند، هنگام به روز رسانی یک سند، از روش های FieldValue.delete()
مخصوص زبان زیر استفاده کنید:
Web
از متد deleteField()
استفاده کنید:
import { doc, updateDoc, deleteField } from "firebase/firestore"; const cityRef = doc(db, 'cities', 'BJ'); // Remove the 'capital' field from the document await updateDoc(cityRef, { capital: deleteField() });
Web
از متد FieldValue.delete()
استفاده کنید:
var cityRef = db.collection('cities').doc('BJ'); // Remove the 'capital' field from the document var removeCapital = cityRef.update({ capital: firebase.firestore.FieldValue.delete() });
سویفت
از متد FieldValue.delete()
استفاده کنید:
do { try await db.collection("cities").document("BJ").updateData([ "capital": FieldValue.delete(), ]) print("Document successfully updated") } catch { print("Error updating document: \(error)") }
هدف-C
از روش fieldValueForDelete:
استفاده کنید:
[[[self.db collectionWithPath:@"cities"] documentWithPath:@"BJ"] updateData:@{ @"capital": [FIRFieldValue fieldValueForDelete] } completion:^(NSError * _Nullable error) { if (error != nil) { NSLog(@"Error updating document: %@", error); } else { NSLog(@"Document successfully updated"); } }];
Kotlin+KTX
از متد FieldValue.delete()
استفاده کنید:
val docRef = db.collection("cities").document("BJ") // Remove the 'capital' field from the document val updates = hashMapOf<String, Any>( "capital" to FieldValue.delete(), ) docRef.update(updates).addOnCompleteListener { }
Java
از متد FieldValue.delete()
استفاده کنید:
DocumentReference docRef = db.collection("cities").document("BJ"); // Remove the 'capital' field from the document Map<String,Object> updates = new HashMap<>(); updates.put("capital", FieldValue.delete()); docRef.update(updates).addOnCompleteListener(new OnCompleteListener<Void>() { // ... // ...
Dart
از متد FieldValue.delete()
استفاده کنید:
final docRef = db.collection("cities").doc("BJ"); // Remove the 'capital' field from the document final updates = <String, dynamic>{ "capital": FieldValue.delete(), }; docRef.update(updates);
جاوا
از متد FieldValue.delete()
استفاده کنید:
پایتون
از روش firestore.DELETE_FIELD
استفاده کنید:
Python
از روش firestore.DELETE_FIELD
استفاده کنید:
C++
از متد FieldValue::Delete()
استفاده کنید:
DocumentReference doc_ref = db->Collection("cities").Document("BJ"); doc_ref.Update({{"capital", FieldValue::Delete()}}) .OnCompletion([](const Future<void>& future) { /*...*/ });
Node.js
از متد FieldValue.delete()
استفاده کنید:
برو
از روش firestore.Delete
استفاده کنید:
PHP
از متد FieldValue::deleteField()
استفاده کنید:
وحدت
از روش FieldValue.Delete
استفاده کنید:
DocumentReference cityRef = db.Collection("cities").Document("BJ"); Dictionary<string, object> updates = new Dictionary<string, object> { { "Capital", FieldValue.Delete } };
سی شارپ
از روش FieldValue.Delete
استفاده کنید:
روبی
از روش firestore.field_delete
استفاده کنید:
حذف مجموعه ها
برای حذف کل مجموعه یا زیرمجموعه در Cloud Firestore ، تمام اسناد موجود در مجموعه یا زیر مجموعه را بازیابی (خواندن) کرده و آنها را حذف کنید. این فرآیند هم هزینه های خواندن و هم حذف را به همراه دارد. اگر مجموعه های بزرگتری دارید، ممکن است بخواهید اسناد را در دسته های کوچکتر حذف کنید تا از خطاهای خارج از حافظه جلوگیری کنید. این فرآیند را تا زمانی که کل مجموعه یا زیر مجموعه را حذف نکنید، تکرار کنید.
حذف یک مجموعه مستلزم هماهنگی تعداد نامحدودی از درخواست های حذف فردی است. اگر نیاز به حذف کل مجموعه دارید، این کار را فقط از یک محیط سرور قابل اعتماد انجام دهید. در حالی که امکان حذف مجموعه از یک سرویس گیرنده موبایل/وب وجود دارد، انجام این کار پیامدهای امنیتی و عملکردی منفی دارد.
تکههای زیر تا حدودی ساده شدهاند و با مدیریت خطا، امنیت، حذف زیر مجموعهها یا به حداکثر رساندن عملکرد سروکار ندارند. برای کسب اطلاعات بیشتر درباره یک رویکرد توصیه شده برای حذف مجموعهها در تولید، به حذف مجموعهها و زیر مجموعهها مراجعه کنید.
وب
// Deleting collections from a Web client is not recommended.
سویفت
// Deleting collections from an Apple client is not recommended.
هدف-C
// Deleting collections from an Apple client is not recommended.
Kotlin+KTX
// Deleting collections from an Android client is not recommended.
Java
// Deleting collections from an Android client is not recommended.
Dart
حذف مجموعه ها از مشتری توصیه نمی شود.
جاوا
پایتون
Python
C++
// This is not supported. Delete data using CLI as discussed below.
Node.js
برو
PHP
وحدت
// This is not supported. Delete data using CLI as discussed below.
سی شارپ
روبی
با Firebase CLI داده ها را حذف کنید
همچنین می توانید از Firebase CLI برای حذف اسناد و مجموعه ها استفاده کنید. برای حذف اطلاعات از دستور زیر استفاده کنید:
firebase firestore:delete [options] <<path>>
اطلاعات را با کنسول حذف کنید
میتوانید اسناد و مجموعهها را از صفحه Cloud Firestore در کنسول حذف کنید . با حذف یک سند از کنسول، تمام داده های تودرتو در آن سند، از جمله هر مجموعه فرعی، حذف می شود.
حذف داده ها با خط مشی های TTL
یک خط مشی TTL یک فیلد معین را به عنوان زمان انقضای اسناد در یک گروه مجموعه معین تعیین می کند. عملیات حذف TTL در هزینه های حذف سند شما حساب می شود.
برای اطلاعات در مورد تنظیم TTL، به مدیریت حفظ داده با خطمشیهای TTL مراجعه کنید.
برای اطلاعات بیشتر در مورد کدهای خطا و نحوه حل مشکلات تاخیر هنگام حذف داده ها، صفحه عیب یابی را بررسی کنید.
داده ها را با Dataflow حذف کنید
Dataflow یک ابزار عالی برای عملیات انبوه در پایگاه داده Firestore شما است. رابط Firestore برای پست وبلاگ معرفی Dataflow مثالی از حذف تمام اسناد در یک گروه مجموعه دارد.
از حذف انبوه مدیریت شده استفاده کنید
Cloud Firestore از حذف انبوه یک یا چند گروه مجموعه پشتیبانی می کند. برای اطلاعات بیشتر، به حذف انبوه داده ها مراجعه کنید.