مثالهای زیر نحوه حذف اسناد، فیلدها و مجموعهها را نشان میدهند.
اسناد را حذف کنید
برای حذف یک سند، از متدهای delete()
مخصوص زبان زیر استفاده کنید:
از متد deleteDoc()
استفاده کنید:
import { doc, deleteDoc } from "firebase/firestore"; await deleteDoc(doc(db, "cities", "DC"));
از متد 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)") }
از روش deleteDocumentWithCompletion:
استفاده کنید:
[[[self.db collectionWithPath:@"cities"] documentWithPath:@"DC"] deleteDocumentWithCompletion:^(NSError * _Nullable error) { if (error != nil) { NSLog(@"Error removing document: %@", error); } else { NSLog(@"Document successfully removed!"); } }];
از متد delete()
استفاده کنید:
db.collection("cities").document("DC") .delete() .addOnSuccessListener { Log.d(TAG, "DocumentSnapshot successfully deleted!") } .addOnFailureListener { e -> Log.w(TAG, "Error deleting document", e) }
از متد 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); } });
از متد delete()
استفاده کنید:
db.collection("cities").doc("DC").delete().then( (doc) => print("Document deleted"), onError: (e) => print("Error updating document $e"), );
از متد delete()
استفاده کنید:
از متد delete()
استفاده کنید:
از متد delete()
استفاده کنید:
از متد 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; } });
از متد delete()
استفاده کنید:
از متد Delete()
استفاده کنید:
از متد delete()
استفاده کنید:
از متد DeleteAsync()
استفاده کنید:
DocumentReference cityRef = db.Collection("cities").Document("DC"); cityRef.DeleteAsync();
از متد DeleteAsync()
استفاده کنید:
از متد delete()
استفاده کنید:
هنگامی که یک سند را حذف می کنید، Cloud Firestore به طور خودکار اسناد موجود در زیر مجموعه های خود را حذف نمی کند. همچنان می توانید با مراجعه به اسناد زیر مجموعه دسترسی داشته باشید. برای مثال، میتوانید در مسیر /mycoll/mydoc/mysubcoll/mysubdoc
به سند دسترسی داشته باشید، حتی اگر سند اجداد را در /mycoll/mydoc
حذف کنید.
اسناد اجدادی که وجود ندارند در کنسول ظاهر می شوند ، اما در نتایج پرس و جو و عکس های فوری ظاهر نمی شوند.
اگر می خواهید یک سند و تمام اسناد موجود در زیر مجموعه های آن را حذف کنید، باید این کار را به صورت دستی انجام دهید. برای اطلاعات بیشتر، به حذف مجموعه ها مراجعه کنید.
حذف فیلدها
برای حذف فیلدهای خاص از یک سند، هنگام به روز رسانی یک سند، از روش های FieldValue.delete()
مخصوص زبان زیر استفاده کنید:
از متد 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() });
از متد 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)") }
از روش 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"); } }];
از متد 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 { }
از متد 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>() { // ... // ...
از متد 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
استفاده کنید:
از روش firestore.DELETE_FIELD
استفاده کنید:
از متد FieldValue::Delete()
استفاده کنید:
DocumentReference doc_ref = db->Collection("cities").Document("BJ"); doc_ref.Update({{"capital", FieldValue::Delete()}}) .OnCompletion([](const Future<void>& future) { /*...*/ });
از متد FieldValue.delete()
استفاده کنید:
از روش firestore.Delete
استفاده کنید:
از متد 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.
// Deleting collections from an Apple client is not recommended.
// Deleting collections from an Android client is not recommended.
// Deleting collections from an Android client is not recommended.
حذف مجموعه ها از مشتری توصیه نمی شود.
// This is not supported. Delete data using CLI as discussed below.
// 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 از حذف انبوه یک یا چند گروه مجموعه پشتیبانی می کند. برای اطلاعات بیشتر، به حذف انبوه داده ها مراجعه کنید.