Los siguientes ejemplos muestran cómo eliminar documentos, campos y colecciones.
Eliminar documentos
Para eliminar un documento, utilice los siguientes métodos delete()
específicos del idioma:
Web version 9
Utilice el método deleteDoc()
:
import { doc, deleteDoc } from "firebase/firestore"; await deleteDoc(doc(db, "cities", "DC"));
Web version 8
Utilice el método delete()
:
db.collection("cities").doc("DC").delete().then(() => { console.log("Document successfully deleted!"); }).catch((error) => { console.error("Error removing document: ", error); });
Rápido
Utilice el método delete()
:
db.collection("cities").document("DC").delete() { err in if let err = err { print("Error removing document: \(err)") } else { print("Document successfully removed!") } }
C objetivo
Utilice el método 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
Utilice el método delete()
:
db.collection("cities").document("DC") .delete() .addOnSuccessListener { Log.d(TAG, "DocumentSnapshot successfully deleted!") } .addOnFailureListener { e -> Log.w(TAG, "Error deleting document", e) }
Java
Utilice el método 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
Utilice el método delete()
:
db.collection("cities").doc("DC").delete().then( (doc) => print("Document deleted"), onError: (e) => print("Error updating document $e"), );
Java
Utilice el método delete()
:
Pitón
Utilice el método delete()
:
Python
Utilice el método delete()
:
C++
Utilice el método 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; } });
Nodo.js
Utilice el método delete()
:
Vamos
Utilice el método Delete()
:
PHP
Utilice el método delete()
:
Unidad
Utilice el método DeleteAsync()
:
DocumentReference cityRef = db.Collection("cities").Document("DC"); cityRef.DeleteAsync();
C#
Utilice el método DeleteAsync()
:
Rubí
Utilice el método delete()
:
Cuando elimina un documento, Cloud Firestore no elimina automáticamente los documentos dentro de sus subcolecciones. Todavía puede acceder a los documentos de la subcolección por referencia. Por ejemplo, puede acceder al documento en la ruta /mycoll/mydoc/mysubcoll/mysubdoc
incluso si elimina el documento principal en /mycoll/mydoc
.
Los documentos ancestros inexistentes aparecen en la consola , pero no aparecen en los resultados de la consulta ni en las instantáneas.
Si desea eliminar un documento y todos los documentos dentro de sus subcolecciones, debe hacerlo manualmente. Para obtener más información, consulte Eliminar colecciones .
Eliminar campos
Para eliminar campos específicos de un documento, utilice los siguientes métodos FieldValue.delete()
específicos del idioma cuando actualice un documento:
Web version 9
Utilice el método 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 version 8
Utilice el método 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() });
Rápido
Utilice el método 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") } }
C objetivo
Utilice el método 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
Utilice el método 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
Utilice el método 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
Utilice el método 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
Utilice el método FieldValue.delete()
:
Pitón
Usa el método firestore.DELETE_FIELD
:
Python
Usa el método firestore.DELETE_FIELD
:
C++
Utilice el FieldValue::Delete()
:
DocumentReference doc_ref = db->Collection("cities").Document("BJ"); doc_ref.Update({{"capital", FieldValue::Delete()}}) .OnCompletion([](const Future<void>& future) { /*...*/ });
Nodo.js
Utilice el método FieldValue.delete()
:
Vamos
Usa el método firestore.Delete
:
PHP
Utilice el FieldValue::deleteField()
:
Unidad
Utilice el método FieldValue.Delete
:
DocumentReference cityRef = db.Collection("cities").Document("BJ"); Dictionary<string, object> updates = new Dictionary<string, object> { { "Capital", FieldValue.Delete } };
C#
Utilice el método FieldValue.Delete
:
Rubí
Usa el método firestore.field_delete
:
Eliminar colecciones
Para eliminar una colección o subcolección completa en Cloud Firestore, recupere todos los documentos dentro de la colección o subcolección y elimínelos. Si tiene colecciones más grandes, es posible que desee eliminar los documentos en lotes más pequeños para evitar errores de falta de memoria. Repita el proceso hasta que haya eliminado toda la colección o subcolección.
La eliminación de una colección requiere la coordinación de un número ilimitado de solicitudes de eliminación individuales. Si necesita eliminar colecciones completas, hágalo solo desde un entorno de servidor confiable. Si bien es posible eliminar una colección de un cliente móvil/web, hacerlo tiene implicaciones negativas de seguridad y rendimiento.
Los fragmentos a continuación están algo simplificados y no se ocupan del manejo de errores, la seguridad, la eliminación de subcolecciones o la maximización del rendimiento. Para obtener más información sobre un enfoque recomendado para eliminar colecciones en producción, consulte Eliminación de colecciones y subcolecciones .
Web
// Deleting collections from a Web client is not recommended.
Rápido
// Deleting collections from an Apple client is not recommended.
C objetivo
// 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
No se recomienda eliminar colecciones del cliente.
Java
Pitón
Python
C++
// This is not supported. Delete data using CLI as discussed below.
Nodo.js
Vamos
PHP
Unidad
// This is not supported. Delete data using CLI as discussed below.
C#
Rubí
Eliminar datos con Firebase CLI
También puede usar Firebase CLI para eliminar documentos y colecciones. Utilice el siguiente comando para eliminar datos:
firebase firestore:delete [options] <<path>>
Eliminar datos con la consola
Puede eliminar documentos y colecciones desde la página de Cloud Firestore en la consola . Al eliminar un documento de la consola, se eliminan todos los datos anidados en ese documento, incluidas las subcolecciones.