הדוגמאות הבאות מדגימות כיצד למחוק מסמכים, שדות ואוספים.
כדי למחוק מסמך, השתמש בשיטות 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 לא מוחק אוטומטית את המסמכים בתוך אוספי המשנה שלו. אתה עדיין יכול לגשת למסמכי איסוף המשנה על ידי הפניה. לדוגמה, אתה יכול לגשת למסמך ב-path /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 firestore:delete [options] <<path>>
אתה יכול למחוק מסמכים ואוספים מדף Cloud Firestore במסוף . מחיקת מסמך מהמסוף מוחקת את כל הנתונים המקוננים במסמך זה, כולל אוספי משנה כלשהם.
מדיניות TTL מציינת שדה נתון כזמן התפוגה של מסמכים בקבוצת איסוף נתונה. פעולות מחיקת TTL נחשבות לעלויות מחיקת המסמכים שלך.
למידע על הגדרת TTL, ראה ניהול שמירת נתונים עם מדיניות TTL .
למידע נוסף על קודי שגיאה וכיצד לפתור בעיות אחזור בעת מחיקת נתונים, עיין בדף פתרון הבעיות .
Dataflow הוא כלי נהדר לפעולות בכמות גדולה במסד הנתונים שלך ב-Firestore. פוסט הבלוג המבוא של Firestore for Dataflow כולל דוגמה למחיקת כל המסמכים בקבוצת איסוף.