此页面由 Cloud Translation API 翻译。

删除数据

以下示例演示了如何删除文档、字段和集合。

删除文档

要删除文档，请使用以下特定于语言的 delete() 方法：

Web 版本 9

请使用 deleteDoc() 方法：

import { doc, deleteDoc } from "firebase/firestore";

await deleteDoc(doc(db, "cities", "DC"));delete_document.js

Web 版本 8

请使用 delete() 方法：

db.collection("cities").doc("DC").delete().then(() => {
    console.log("Document successfully deleted!");
}).catch((error) => {
    console.error("Error removing document: ", error);
});test.firestore.js

Swift

请使用 delete() 方法：

注意：此产品不适用于 watchOS 和 App Clip 目标。

db.collection("cities").document("DC").delete() { err in
    if let err = err {
        print("Error removing document: \(err)")
    } else {
        print("Document successfully removed!")
    }
}ViewController.swift

Objective-C

请使用 deleteDocumentWithCompletion: 方法：

注意：此产品不适用于 watchOS 和 App Clip 目标。

[[[self.db collectionWithPath:@"cities"] documentWithPath:@"DC"]
    deleteDocumentWithCompletion:^(NSError * _Nullable error) {
      if (error != nil) {
        NSLog(@"Error removing document: %@", error);
      } else {
        NSLog(@"Document successfully removed!");
      }
}];ViewController.m

Kotlin+KTX
Android

请使用 delete() 方法：

db.collection("cities").document("DC")
        .delete()
        .addOnSuccessListener { Log.d(TAG, "DocumentSnapshot successfully deleted!") }
        .addOnFailureListener { e -> Log.w(TAG, "Error deleting document", e) }DocSnippets.kt

Java
Android

请使用 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);
            }
        });DocSnippets.java

Dart

请使用 delete() 方法：

db.collection("cities").doc("DC").delete().then(
      (doc) => print("Document deleted"),
      onError: (e) => print("Error updating document $e"),
    );firestore.dart

Java

请使用 delete() 方法：

samples/snippets/src/main/java/com/example/firestore/snippets/ManageDataSnippets.java

// asynchronously delete a document
ApiFuture<WriteResult> writeResult = db.collection("cities").document("DC").delete();
// ...
System.out.println("Update time : " + writeResult.get().getUpdateTime());ManageDataSnippets.java

Python

请使用 delete() 方法：

firestore/cloud-client/snippets.py

db.collection(u'cities').document(u'DC').delete()snippets.py

Python
（异步）

请使用 delete() 方法：

firestore/cloud-async-client/snippets.py

await db.collection("cities").document("DC").delete()snippets.py

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;
      }
    });snippets.cpp

Node.js

请使用 delete() 方法：

firestore/main/index.js

const res = await db.collection('cities').doc('DC').delete();index.js

Go

请使用 Delete() 方法：

firestore/save.go

_, err := client.Collection("cities").Doc("DC").Delete(ctx)
if err != nil {
	// Handle any errors in an appropriate way, such as returning them.
	log.Printf("An error has occurred: %s", err)
}save.go

PHP

请使用 delete() 方法：

firestore/src/data_delete_doc.php

反馈

$db->collection('samples/php/cities')->document('DC')->delete();data_delete_doc.php

Unity

请使用 DeleteAsync() 方法：

DocumentReference cityRef = db.Collection("cities").Document("DC");
cityRef.DeleteAsync();

C#

请使用 DeleteAsync() 方法：

firestore/api/DeleteData/Program.cs

反馈

DocumentReference cityRef = db.Collection("cities").Document("DC");
await cityRef.DeleteAsync();Program.cs

Ruby

请使用 delete() 方法：

google-cloud-firestore/samples/delete_data.rb

city_ref = firestore.doc "#{collection_path}/DC"
city_ref.deletedelete_data.rb

删除文档时，Firestore 不会自动删除其子集合中的文档。您仍然可以通过引用访问子集合文档。例如，即使您删除位于 /mycoll/mydoc 的祖先文档，也可以访问路径为 /mycoll/mydoc/mysubcoll/mysubdoc 的文档。

不存在的祖先文档会显示在控制台中，但不会显示在查询结果和快照中。

如果要删除某个文档及其子集合中的所有文档，您必须手动操作。如需了解详情，请参阅删除集合。

删除字段

如需从文档中删除特定字段，请在更新文档时使用以下特定于语言的 FieldValue.delete() 方法：

Web 版本 9

请使用 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()
});update_delete_field.js

Web 版本 8

请使用 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()
});test.firestore.js

Swift

请使用 FieldValue.delete() 方法：

注意：此产品不适用于 watchOS 和 App Clip 目标。

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")
    }
}ViewController.swift

Objective-C

请使用 fieldValueForDelete: 方法：

注意：此产品不适用于 watchOS 和 App Clip 目标。

[[[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");
  }
}];ViewController.m

Kotlin+KTX
Android

请使用 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 { }DocSnippets.kt

Java
Android

请使用 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>() {
    // ...
    // ...DocSnippets.java

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);firestore.dart

Java

请使用 FieldValue.delete() 方法：

samples/snippets/src/main/java/com/example/firestore/snippets/ManageDataSnippets.java

DocumentReference docRef = db.collection("cities").document("BJ");
Map<String, Object> updates = new HashMap<>();
updates.put("capital", FieldValue.delete());
// Update and delete the "capital" field in the document
ApiFuture<WriteResult> writeResult = docRef.update(updates);
System.out.println("Update time : " + writeResult.get());ManageDataSnippets.java

Python

请使用 firestore.DELETE_FIELD 方法：

firestore/cloud-client/snippets.py

city_ref = db.collection(u'cities').document(u'BJ')
city_ref.update({
    u'capital': firestore.DELETE_FIELD
})snippets.py

Python
（异步）

请使用 firestore.DELETE_FIELD 方法：

firestore/cloud-async-client/snippets.py

city_ref = db.collection("cities").document("BJ")
await city_ref.update({"capital": firestore.DELETE_FIELD})snippets.py

C++

请使用 FieldValue::Delete() 方法：

DocumentReference doc_ref = db->Collection("cities").Document("BJ");
doc_ref.Update({{"capital", FieldValue::Delete()}})
    .OnCompletion([](const Future<void>& future) { /*...*/ });snippets.cpp

Node.js

请使用 FieldValue.delete() 方法：

firestore/main/index.js

// Create a document reference
const cityRef = db.collection('cities').doc('BJ');

// Remove the 'capital' field from the document
const res = await cityRef.update({
  capital: FieldValue.delete()
});index.js

Go

请使用 firestore.Delete 方法：

firestore/save.go

_, err := client.Collection("cities").Doc("BJ").Update(ctx, []firestore.Update{
	{
		Path:  "capital",
		Value: firestore.Delete,
	},
})
if err != nil {
	// Handle any errors in an appropriate way, such as returning them.
	log.Printf("An error has occurred: %s", err)
}save.go

PHP

请使用 FieldValue::deleteField() 方法：

firestore/src/data_delete_field.php

反馈

$cityRef = $db->collection('samples/php/cities')->document('BJ');
$cityRef->update([
    ['path' => 'capital', 'value' => FieldValue::deleteField()]
]);data_delete_field.php

Unity

请使用 FieldValue.Delete 方法：

DocumentReference cityRef = db.Collection("cities").Document("BJ");
Dictionary<string, object> updates = new Dictionary<string, object>
{
    { "Capital", FieldValue.Delete }
};

C#

请使用 FieldValue.Delete 方法：

firestore/api/DeleteData/Program.cs

反馈

DocumentReference cityRef = db.Collection("cities").Document("BJ");
Dictionary<string, object> updates = new Dictionary<string, object>
{
    { "Capital", FieldValue.Delete }
};
await cityRef.UpdateAsync(updates);Program.cs

Ruby

请使用 firestore.field_delete 方法：

google-cloud-firestore/samples/delete_data.rb

city_ref = firestore.doc "#{collection_path}/BJ"
city_ref.update({ capital: firestore.field_delete })delete_data.rb

删除集合

如需删除 Firestore 中的整个集合或子集合，请检索该集合或子集合中的所有文档并将其删除。如果您的集合较大，可能需要分批删除文档，以免发生内存不足的错误。重复这一过程，直到删除整个集合或子集合。

为删除集合，您需要协调不定数量的单独的删除请求。如果您需要删除整个集合，请仅从可信的服务器环境中执行此操作。虽然可以从移动/Web 客户端删除集合，但这样做会对安全和性能产生负面影响。

下面的代码段已经过简化，不涉及错误处理、安全、删除子集合或性能最大化。如需详细了解在生产环境中删除集合的一种推荐方法，请参阅删除集合与子集合。

Web

// Deleting collections from a Web client is not recommended.

Swift

注意：此产品不适用于 watchOS 和 App Clip 目标。

// Deleting collections from an Apple client is not recommended.

Objective-C

注意：此产品不适用于 watchOS 和 App Clip 目标。

// Deleting collections from an Apple client is not recommended.

Kotlin+KTX
Android

// Deleting collections from an Android client is not recommended.

Java
Android

// Deleting collections from an Android client is not recommended.

Dart

不建议从客户端删除集合。

Java

samples/snippets/src/main/java/com/example/firestore/snippets/ManageDataSnippets.java

/**
 * Delete a collection in batches to avoid out-of-memory errors. Batch size may be tuned based on
 * document size (atmost 1MB) and application requirements.
 */
void deleteCollection(CollectionReference collection, int batchSize) {
  try {
    // retrieve a small batch of documents to avoid out-of-memory errors
    ApiFuture<QuerySnapshot> future = collection.limit(batchSize).get();
    int deleted = 0;
    // future.get() blocks on document retrieval
    List<QueryDocumentSnapshot> documents = future.get().getDocuments();
    for (QueryDocumentSnapshot document : documents) {
      document.getReference().delete();
      ++deleted;
    }
    if (deleted >= batchSize) {
      // retrieve and delete another batch
      deleteCollection(collection, batchSize);
    }
  } catch (Exception e) {
    System.err.println("Error deleting collection : " + e.getMessage());
  }
}ManageDataSnippets.java

Python

firestore/cloud-client/snippets.py

def delete_collection(coll_ref, batch_size):
    docs = coll_ref.list_documents(page_size=batch_size)
    deleted = 0

    for doc in docs:
        print(f'Deleting doc {doc.id} => {doc.get().to_dict()}')
        doc.delete()
        deleted = deleted + 1

    if deleted >= batch_size:
        return delete_collection(coll_ref, batch_size)snippets.py

Python
（异步）

firestore/cloud-async-client/snippets.py

async def delete_collection(coll_ref, batch_size):
    docs = coll_ref.limit(batch_size).stream()
    deleted = 0

    async for doc in docs:
        print(f"Deleting doc {doc.id} => {doc.to_dict()}")
        await doc.reference.delete()
        deleted = deleted + 1

    if deleted >= batch_size:
        return delete_collection(coll_ref, batch_size)
snippets.py

C++

// This is not supported. Delete data using CLI as discussed below.

Node.js

firestore/main/index.js

async function deleteCollection(db, collectionPath, batchSize) {
  const collectionRef = db.collection(collectionPath);
  const query = collectionRef.orderBy('__name__').limit(batchSize);

  return new Promise((resolve, reject) => {
    deleteQueryBatch(db, query, resolve).catch(reject);
  });
}

async function deleteQueryBatch(db, query, resolve) {
  const snapshot = await query.get();

  const batchSize = snapshot.size;
  if (batchSize === 0) {
    // When there are no documents left, we are done
    resolve();
    return;
  }

  // Delete documents in a batch
  const batch = db.batch();
  snapshot.docs.forEach((doc) => {
    batch.delete(doc.ref);
  });
  await batch.commit();

  // Recurse on the next process tick, to avoid
  // exploding the stack.
  process.nextTick(() => {
    deleteQueryBatch(db, query, resolve);
  });
}
index.js

Go

firestore/save.go

func deleteCollection(ctx context.Context, client *firestore.Client,
	ref *firestore.CollectionRef, batchSize int) error {

	for {
		// Get a batch of documents
		iter := ref.Limit(batchSize).Documents(ctx)
		numDeleted := 0

		// Iterate through the documents, adding
		// a delete operation for each one to a
		// WriteBatch.
		batch := client.Batch()
		for {
			doc, err := iter.Next()
			if err == iterator.Done {
				break
			}
			if err != nil {
				return err
			}

			batch.Delete(doc.Ref)
			numDeleted++
		}

		// If there are no documents to delete,
		// the process is over.
		if numDeleted == 0 {
			return nil
		}

		_, err := batch.Commit(ctx)
		if err != nil {
			return err
		}
	}
}
save.go

PHP

firestore/src/data_delete_collection.php

反馈

function data_delete_collection(string $projectId, string $collectionName, int $batchSize)
{
    // Create the Cloud Firestore client
    $db = new FirestoreClient([
        'projectId' => $projectId,
    ]);
    $collectionReference = $db->collection($collectionName);
    $documents = $collectionReference->limit($batchSize)->documents();
    while (!$documents->isEmpty()) {
        foreach ($documents as $document) {
            printf('Deleting document %s' . PHP_EOL, $document->id());
            $document->reference()->delete();
        }
        $documents = $collectionReference->limit($batchSize)->documents();
    }
}data_delete_collection.php

Unity

// This is not supported. Delete data using CLI as discussed below.

C#

firestore/api/DeleteData/Program.cs

反馈

private static async Task DeleteCollection(CollectionReference collectionReference, int batchSize)
{
    QuerySnapshot snapshot = await collectionReference.Limit(batchSize).GetSnapshotAsync();
    IReadOnlyList<DocumentSnapshot> documents = snapshot.Documents;
    while (documents.Count > 0)
    {
        foreach (DocumentSnapshot document in documents)
        {
            Console.WriteLine("Deleting document {0}", document.Id);
            await document.Reference.DeleteAsync();
        }
        snapshot = await collectionReference.Limit(batchSize).GetSnapshotAsync();
        documents = snapshot.Documents;
    }
    Console.WriteLine("Finished deleting all documents from the collection.");
}Program.cs

Ruby

google-cloud-firestore/samples/delete_data.rb

cities_ref = firestore.col collection_path
query      = cities_ref

query.get do |document_snapshot|
  puts "Deleting document #{document_snapshot.document_id}."
  document_ref = document_snapshot.ref
  document_ref.delete
enddelete_data.rb

使用 Firebase CLI 删除数据

您还可以使用 Firebase CLI 删除文档和集合。如需删除数据，请使用以下命令：

firebase firestore:delete [options] <<path>>

使用控制台删除数据

您可以从控制台的 Firestore 页面删除文档和集合。从控制台删除文档将删除该文档中的所有嵌套数据，包括所有子集合。

删除数据

删除文档

Web 版本 9

Web 版本 8

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Dart

Java

Python

Python（异步）

C++

Node.js

Go

PHP

Unity

C#

Ruby

删除字段

Web 版本 9

Web 版本 8

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Dart

Java

Python

Python（异步）

C++

Node.js

Go

PHP

Unity

C#

Ruby

删除集合

Web

Swift

Objective-C

Kotlin+KTXAndroid

JavaAndroid

Dart

Java

Python

Python（异步）

C++

Node.js

Go

PHP

Unity

C#

Ruby

使用 Firebase CLI 删除数据

使用控制台删除数据

Kotlin+KTX
Android

Java
Android

Python
（异步）

Kotlin+KTX
Android

Java
Android

Python
（异步）

Kotlin+KTX
Android

Java
Android

Python
（异步）