Aşağıdaki örnekler belgelerin, alanların ve koleksiyonların nasıl silineceğini gösterir.
Dokümanları sil
Doküman silmek için aşağıdaki dile özgü delete()
yöntemlerini kullanın:
Web
deleteDoc()
yöntemini kullanın:
import { doc, deleteDoc } from "firebase/firestore"; await deleteDoc(doc(db, "cities", "DC"));
Web
delete()
yöntemini kullanın:
db.collection("cities").doc("DC").delete().then(() => { console.log("Document successfully deleted!"); }).catch((error) => { console.error("Error removing document: ", error); });
Swift
delete()
yöntemini kullanın:
do { try await db.collection("cities").document("DC").delete() print("Document successfully removed!") } catch { print("Error removing document: \(error)") }
Objective-C
deleteDocumentWithCompletion:
yöntemini kullanın:
[[[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()
yöntemini kullanın:
db.collection("cities").document("DC") .delete() .addOnSuccessListener { Log.d(TAG, "DocumentSnapshot successfully deleted!") } .addOnFailureListener { e -> Log.w(TAG, "Error deleting document", e) }
Java
delete()
yöntemini kullanın:
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()
yöntemini kullanın:
db.collection("cities").doc("DC").delete().then( (doc) => print("Document deleted"), onError: (e) => print("Error updating document $e"), );
Java
delete()
yöntemini kullanın:
Python
delete()
yöntemini kullanın:
Python
delete()
yöntemini kullanın:
C++
Delete()
yöntemini kullanın:
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()
yöntemini kullanın:
Go
Delete()
yöntemini kullanın:
PHP
delete()
yöntemini kullanın:
Unity
DeleteAsync()
yöntemini kullanın:
DocumentReference cityRef = db.Collection("cities").Document("DC"); cityRef.DeleteAsync();
C#
DeleteAsync()
yöntemini kullanın:
Ruby
delete()
yöntemini kullanın:
Bir belge sildiğinizde Cloud Firestore, alt koleksiyonlarındaki dokümanları otomatik olarak silmez. Alt koleksiyon dokümanlarına referans olarak erişmeye devam edebilirsiniz.
Örneğin, /mycoll/mydoc
adresindeki üst öğe dokümanını silseniz bile /mycoll/mydoc/mysubcoll/mysubdoc
yolundaki dokümana erişebilirsiniz.
Var olmayan üst öğe belgeleri konsolda görünür ancak sorgu sonuçlarında ve anlık görüntülerde görünmez.
Bir dokümanı ve alt koleksiyonlarındaki tüm dokümanları silmek istiyorsanız bu işlemi manuel olarak yapmanız gerekir. Daha fazla bilgi edinmek için Koleksiyonları Silme bölümünü inceleyin.
Alanları sil
Bir dokümandaki belirli alanları silmek için dokümanı güncellerken aşağıdaki dile özgü FieldValue.delete()
yöntemlerini kullanın:
Web
deleteField()
yöntemini kullanın:
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()
yöntemini kullanın:
var cityRef = db.collection('cities').doc('BJ'); // Remove the 'capital' field from the document var removeCapital = cityRef.update({ capital: firebase.firestore.FieldValue.delete() });
Swift
FieldValue.delete()
yöntemini kullanın:
do { try await db.collection("cities").document("BJ").updateData([ "capital": FieldValue.delete(), ]) print("Document successfully updated") } catch { print("Error updating document: \(error)") }
Objective-C
fieldValueForDelete:
yöntemini kullanın:
[[[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()
yöntemini kullanın:
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()
yöntemini kullanın:
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()
yöntemini kullanın:
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()
yöntemini kullanın:
Python
firestore.DELETE_FIELD
yöntemini kullanın:
Python
firestore.DELETE_FIELD
yöntemini kullanın:
C++
FieldValue::Delete()
yöntemini kullanın:
DocumentReference doc_ref = db->Collection("cities").Document("BJ"); doc_ref.Update({{"capital", FieldValue::Delete()}}) .OnCompletion([](const Future<void>& future) { /*...*/ });
Node.js
FieldValue.delete()
yöntemini kullanın:
Go
firestore.Delete
yöntemini kullanın:
PHP
FieldValue::deleteField()
yöntemini kullanın:
Unity
FieldValue.Delete
yöntemini kullanın:
DocumentReference cityRef = db.Collection("cities").Document("BJ"); Dictionary<string, object> updates = new Dictionary<string, object> { { "Capital", FieldValue.Delete } };
C#
FieldValue.Delete
yöntemini kullanın:
Ruby
firestore.field_delete
yöntemini kullanın:
Koleksiyonları silin
Cloud Firestore'daki bir koleksiyonun veya alt koleksiyonun tamamını silmek için koleksiyon veya alt koleksiyondaki tüm belgeleri alın (okuyun) ve silin. Bu işlem hem okuma hem de silme maliyetlerine tabidir. Daha büyük koleksiyonlarınız varsa bellek dışı hataları önlemek için dokümanları daha küçük gruplar halinde silmek isteyebilirsiniz. Koleksiyonun veya alt koleksiyonun tamamını silene kadar bu işlemi tekrarlayın.
Bir koleksiyonun silinmesi için sınırsız sayıda tek tek silme isteğini koordine etmeniz gerekir. Koleksiyonların tamamını silmeniz gerekiyorsa bu işlemi yalnızca güvenilir bir sunucu ortamından yapın. Koleksiyonları mobil/web istemcisinden silmek mümkün olsa da bu işlem güvenlik ve performans olumsuz yönde etkilenir.
Aşağıdaki snippet'ler biraz basitleştirilmiştir ve hata işleme, güvenlik, alt koleksiyonları silme veya performansı en üst düzeye çıkarma ile ilgilenmez. Üretimde koleksiyonları silme konusunda önerilen bir yaklaşım hakkında daha fazla bilgi edinmek için Koleksiyonları ve Alt Koleksiyonları Silme bölümünü inceleyin.
Web
// Deleting collections from a Web client is not recommended.
Swift
// 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
Koleksiyonların istemciden silinmesi önerilmez.
Java
Python
Python
C++
// This is not supported. Delete data using CLI as discussed below.
Node.js
Go
PHP
Unity
// This is not supported. Delete data using CLI as discussed below.
C#
Ruby
Firebase CLI ile veri silme
Belgeleri ve koleksiyonları silmek için Firebase CLI'yı da kullanabilirsiniz. Verileri silmek için aşağıdaki komutu kullanın:
firebase firestore:delete [options] <<path>>
Verileri konsolla silme
Konsoldaki Cloud Firestore sayfasından belge ve koleksiyonları silebilirsiniz. Bir belge konsoldan silindiğinde, tüm alt koleksiyonlar da dahil olmak üzere söz konusu belgedeki iç içe yerleştirilmiş tüm veriler silinir.
TTL politikalarıyla veri silme
TTL politikası, belirli bir alanı belirli bir koleksiyon grubundaki dokümanların geçerlilik süresi olarak belirler. TTL silme işlemleri, belge silme maliyetlerinize dahil edilir.
TTL'yi ayarlama hakkında bilgi edinmek için TTL politikalarıyla veri saklamayı yönetme başlıklı makaleyi inceleyin.
Hata kodları ve veriler silinirken karşılaşılan gecikme sorunlarının nasıl çözüleceği hakkında daha fazla bilgi için sorun giderme sayfasına göz atın.
Dataflow ile veri silme
Dataflow, Firestore veritabanınızdaki toplu işlemler için mükemmel bir araçtır. Dataflow'un giriş blog yayını için Firestore bağlayıcısı, bir koleksiyon grubundaki tüm belgelerin silinmesiyle ilgili bir örnek içeriyor.