הדוגמאות הבאות מדגימות כיצד למחוק מסמכים, שדות ואוספים.
מחק מסמכים
כדי למחוק מסמך, השתמש בשיטות delete()
הספציפיות לשפה הבאות:
Web modular API
השתמש בשיטת deleteDoc()
:
import { doc, deleteDoc } from "firebase/firestore"; await deleteDoc(doc(db, "cities", "DC"));
Web namespaced API
השתמש בשיטת delete()
:
db.collection("cities").doc("DC").delete().then(() => { console.log("Document successfully deleted!"); }).catch((error) => { console.error("Error removing document: ", error); });
מָהִיר
השתמש בשיטת delete()
:
db.collection("cities").document("DC").delete() { err in if let err = err { print("Error removing document: \(err)") } else { print("Document successfully removed!") } }
Objective-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"), );
Java
השתמש בשיטת 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();
C#
השתמש בשיטת DeleteAsync()
:
אוֹדֶם
השתמש בשיטת delete()
:
כאשר אתה מוחק מסמך, Cloud Firestore לא מוחק אוטומטית את המסמכים בתוך אוספי המשנה שלו. אתה עדיין יכול לגשת למסמכי איסוף המשנה על ידי הפניה. לדוגמה, אתה יכול לגשת למסמך ב-path /mycoll/mydoc/mysubcoll/mysubdoc
גם אם תמחק את מסמך האב ב- /mycoll/mydoc
.
מסמכים קדומים שאינם קיימים מופיעים במסוף , אך הם אינם מופיעים בתוצאות שאילתות ובתצלומי מצב.
אם ברצונך למחוק מסמך ואת כל המסמכים שבתת-האוספים שלו, עליך לעשות זאת באופן ידני. למידע נוסף, ראה מחיקת אוספים .
מחק שדות
כדי למחוק שדות ספציפיים ממסמך, השתמש בשיטות FieldValue.delete()
הספציפיות לשפה הבאות בעת עדכון מסמך:
Web modular API
השתמש בשיטת 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 namespaced API
השתמש בשיטת 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()
:
db.collection("cities").document("BJ").updateData([ "capital": FieldValue.delete(), ]) { err in if let err = err { print("Error updating document: \(err)") } else { print("Document successfully updated") } }
Objective-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);
Java
השתמש בשיטת 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 } };
C#
השתמש בשיטת 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.
Objective-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
לא מומלץ למחוק אוספים מהלקוח.
Java
פִּיתוֹן
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.
C#
אוֹדֶם
מחק נתונים עם Firebase CLI
אתה יכול גם להשתמש ב- Firebase CLI כדי למחוק מסמכים ואוספים. השתמש בפקודה הבאה כדי למחוק נתונים:
firebase firestore:delete [options] <<path>>
מחק נתונים באמצעות המסוף
אתה יכול למחוק מסמכים ואוספים מדף Cloud Firestore במסוף . מחיקת מסמך מהמסוף מוחקת את כל הנתונים המקוננים במסמך זה, כולל אוספי משנה כלשהם.
מחק נתונים עם מדיניות TTL
מדיניות TTL מציינת שדה נתון כזמן התפוגה של מסמכים בקבוצת איסוף נתונה. פעולות מחיקת TTL נחשבות לעלויות מחיקת המסמכים שלך.
למידע על הגדרת TTL, ראה ניהול שמירת נתונים עם מדיניות TTL .
למידע נוסף על קודי שגיאה וכיצד לפתור בעיות אחזור בעת מחיקת נתונים, עיין בדף פתרון הבעיות .
מחק נתונים עם Dataflow
Dataflow הוא כלי נהדר לפעולות בכמות גדולה במסד הנתונים שלך ב-Firestore. פוסט הבלוג המבוא של Firestore for Dataflow כולל דוגמה למחיקת כל המסמכים בקבוצת איסוף.