ドキュメントとフィールドを削除する

次の例は、ドキュメント、フィールド、コレクションを削除する方法を示しています。

ドキュメントを削除する

ドキュメントを削除するには、次の言語固有の delete() メソッドを使用します。

Web バージョン 9

deleteDoc() メソッドを使用します。

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

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

Web バージョン 8

delete() メソッドを使用します。

db.collection("cities").doc("DC">).delete().then(() = {
    console.log("Document successfully delet>ed!");
}).catch((error) = {
    console.error("Erro
r removing docume
nt: ", error);
});test.firestore.js
Swift

delete() メソッドを使用します。

注: このプロダクトは、watchOS と App Clip の各ターゲットでは利用できません。
do {
  try await db.collection("cities").document("DC").delete()
  print("Document successfully removed!")
} catch {
  print("Er
ror removing documen
t: \(error)")
}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 s
uccessfully remo
ved!");
      }
}];ViewController.m
Kotlin
Android

delete() メソッドを使用します。

db.collection("cities").document("DC")
    .delete()
    .addOnSuccessListener { Log.d(TAG, "DocumentSnapshot successfully deleted!") }
 >   .addOnFailureListener { e - Log.w(TAG, &
quot;Error del
eting document", e) }DocSnippets.kt
Java
Android

delete() メソッドを使用します。

db.collection("cities").document("DC")
        .delete()
        .addOnSuccessListener(n<ew O>nSuccessListenerVoid() {
            @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 docum
ent", e);
 
           }
        });DocSnippets.java

Dart

delete() メソッドを使用します。

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

delete() メソッドを使用します。

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

delete() メソッドを使用します。

db.collection("cities").document(&quo
t;DC")
.delete()snippets.py
Python
（非同期）

delete() メソッドを使用します。

await db.collection("cities").document(&quo
t;DC")
.delete()snippets.py
C++

Delete() メソッドを使用します。

db->Collection("cities").Document("DC").Delete().OnCompletion(<
   >& [](const Futurevoid future) {
      if (future.error() == Error::kErrorOk) <<{
        std::cout  "DocumentSnapsho<<t successfully deleted!"  std::endl;
   <<   } else {
        std::cout<<  "Error deleting document: "  f<<uture.error_message()
     
            
  std::endl;
      }
    });snippets.cpp
Node.js

delete() メソッドを使用します。

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

Delete() メソッドを使用します。


import (
	"context"
	"log"

	"cloud.google.com/go/firestore"
)

func deleteDoc(ctx context.Context, client *firestore.Client) error {
	_, err := client.Collection("cities").Doc("DC").Delete(ctx)
	if err != nil {
		// Handle any errors in an appropriate way, such as returning them.
		log.Printf(&q
uot;An error has occurr
ed: %s", err)
	}

	return err
}
save_data_delete_doc.go
PHP

delete() メソッドを使用します。

$db->collection('samples/php/citie>s')-documen>t('DC
')-delete();dat
a_delete_doc.php
Unity

DeleteAsync() メソッドを使用します。

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

DeleteAsync() メソッドを使用します。

DocumentReference cityRef = db.Collection("cities").Document("DC");
await ci
tyRef.Dele
teAsync();Program.cs
Ruby

delete() メソッドを使用します。

city_ref = firestore.doc "#{collection_path}/DC"
city_
ref.deletedele
te_data.rb

ドキュメントを削除しても、Firestore がそのドキュメントのサブコレクションに含まれるドキュメントを自動的に削除することはありません。サブコレクションのドキュメントには参照により引き続きアクセスできます。たとえば、パス /mycoll/mydoc/mysubcoll/mysubdoc にあるドキュメントには、/mycoll/mydoc の祖先ドキュメントを削除してもアクセスできます。

存在しない祖先ドキュメントはコンソールには表示されますが、クエリの結果やスナップショットには表示されません。

ドキュメントと、そのドキュメントのサブコレクション内のすべてのドキュメントを削除するには、手動での操作が必要です。詳しくは、コレクションを削除するをご覧ください。

フィールドを削除する

特定のフィールドをドキュメントから削除するには、ドキュメントを更新するときに次の言語固有の 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: delet
eField()
});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.delet
e()
});test.firestore.js
Swift

FieldValue.delete() メソッドを使用します。

注: このプロダクトは、watchOS と App Clip の各ターゲットでは利用できません。
do {

  try await db.collection("cities").document("BJ").updateData([
    "capital": FieldValue.delete(),
  ])
  print("Document successfully updated")
} catch {
  prin
t("Error updati
ng document: \(error)")
}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(@&
quot;Document su
ccessfully updated");
  }
}];ViewController.m
Kotlin
Android

FieldValue.delete() メソッドを使用します。

val docRef = db.collection("cities").document("BJ")

// Remove the 'capital' field from the docu<ment
val up>dates = hashMapOfString, Any(
    "capital" to FieldValue.delete(),
)

docRef.upd
ate(updates).a
ddOnCompleteListener { }DocSnippets.kt
Java
Android

FieldValue.delete() メソッドを使用します。

DocumentReference docRef = db.collection("cities").document("BJ");

// Remove the 'capital'< field from t>he document
MapString,<>Object updates = new HashMap();
updates.put("capital", FieldValue.delete());

docRef.update(updates).addOnC<ompl>eteListener(new OnComplete
ListenerVoid() {

    // ...
    // ...DocSnippets.java

Dart

FieldValue.delete() メソッドを使用します。

final docRef = db.collection("cities").doc("BJ");

// Remove the 'capital' field from t<he document
fin>al updates = String, dynamic{
  "capital": FieldValue
.delete(),
};


docRef.update(updates);firestore.dart
Java

FieldValue.delete() メソッドを使用します。

DocumentReference docRef = db.collection("cities").document(<"BJ">);
MapString, Object u<>pdates = new HashMap();
updates.put("capital", FieldValue.delete());
// Update and delete the "capit<al" fi>eld in the document
ApiFutureWriteResult writeResult = docRef.update(updates);
System.out.printl
n("Update time : &
quot; + writeResult.get());ManageDataSnippets.java
Python

firestore.DELETE_FIELD メソッドを使用します。

city_ref = db.collection("cities").document("BJ")
city_ref.update({"capital&q
uot;: fires
tore.DELETE_FIELD})snippets.py
Python
（非同期）

firestore.DELETE_FIELD メソッドを使用します。

city_ref = db.collection("cities").document("BJ")
await city_ref.update({"capital&q
uot;: fires
tore.DELETE_FIELD})snippets.py
C++

FieldValue::Delete() メソッドを使用します。

DocumentReference doc_ref = db->Collection("cities").Document("BJ&quo{{"capital", FieldValue::Delete()}t;);
doc_ref.Update(})
    .OnComple<tion>&([](const Futurevoid f
uture) { /*.
..*/ });snippets.cpp
Node.js

FieldValue.delete() メソッドを使用します。

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

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

firestore.Delete メソッドを使用します。


import (
	"context"
	"log"

	"cloud.google.com/go/firestore"
)

func deleteField(ctx context.Context, client *firestore.Client) error {
	_, 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 occurr
ed: %s", err)
	}

	// ...
	return err
}
save_data_delete_field.go
PHP

FieldValue::deleteField() メソッドを使用します。

$cityRef = $db->collection('samples/php/citie>s')-document('BJ&>#39;);
$cityRef-update>([
    ['path'>; = 'capital', 'val
ue' = FieldValue:
:deleteField()]
]);data_delete_field.php
Unity

FieldValue.Delete メソッドを使用します。

DocumentReference cityRef = db.Collection("cities").Document("B<J");
Dict>ionarystring, object upda<tes = new Dict>ionarystring, object
{
    { "Capital", FieldValue.Delete }
};
C#

FieldValue.Delete メソッドを使用します。

DocumentReference cityRef = db.Collection("cities").Document("B<J");
Dict>ionarystring, object upda<tes = new Dict>ionarystring, object
{
    { "Capital", FieldValue.Delete }
};
await
 cityRef.U
pdateAsync(updates);Program.cs
Ruby

firestore.field_delete メソッドを使用します。

city_ref = firestore.doc "#{collection_path}/BJ"
city_ref.update({ capital: firestore.field
_delete })dele
te_data.rb

コレクションを削除する

Firestore でコレクション全体またはサブコレクションを削除するには、コレクションまたはサブコレクション内のすべてのドキュメントを取得して（読み取って）、削除します。このプロセスでは、読み取りコストと削除コストの両方が発生します。大きなコレクションがある場合は、メモリ不足エラーを避けるため、小さなバッチに分けてドキュメントを削除することをおすすめします。コレクション全体またはサブコレクションが削除されるまで、このプロセスを繰り返します。

コレクションを削除するには、数に制約のない個別の削除リクエストを用意する必要があります。コレクション全体を削除する必要がある場合は、信頼できるサーバー環境からのみ実行してください。モバイル / ウェブ クライアントからコレクションを削除することも可能ですが、その場合セキュリティとパフォーマンスに悪影響を与えます。

以下のスニペットは少し単純化されていて、エラー処理、セキュリティ、サブコレクションの削除、またはパフォーマンスの最大化については扱っていません。本番環境でコレクションを削除するために推奨される方法については、コレクションとサブコレクションを削除するをご覧ください。

ウェブ 
// 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
Android
// Deleting collections from an Android client is not recommended.
Java
Android
// Deleting collections from an Android client is not recommended.

Dart

クライアントからコレクションを削除することはおすすめしません。

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(
));
  }
}
ManageDataSni
ppets.java
Python
def delete_collection(coll_ref, batch_size):
    if batch_size == 0:
        return

    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

    i>f deleted = batch_size:
        return delete_collection(coll_ref, ba
tch_size)
s
nippets.py
Python
（非同期）
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

    i>f deleted = batch_size:
        return delete_collection(coll_ref, ba
tch_size)
s
nippets.py
C++
// This is not supported. Delete data using CLI as discussed below.
Node.js
async function deleteCollection(db, collectionPath, batchSize) {
  const collectionRef = db.collection(collectionPath);
  const query = collectionRef.orderBy('__name__').limit(batchSize);

  return new Promise((resolve, r>eject) = {
    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.nextT>ick(() = {
    deleteQueryBatch(db, query, resolve);

  });
}

index.js
Go

import (
	"context"
	"fmt"
	"io"

	"cloud.google.com/go/firestore"
	"google.golang.org/api/iterator"
)

func deleteCollection(w io.Writer, projectID, collectionName string,
	batchSize int) error {

	// Instantiate a client
	ctx := context.Background()
	client, err := firestore.NewClient(ctx, projectID)
	if err != nil {
		return err
	}

	col := client.Collection(collectionName)
	bulkwriter := client.BulkWriter(ctx)

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

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

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

		// If there are no documents to delete,
		// the process is over.
		if numDeleted == 0 {
			bulkwriter.End()
			break
		}

		bulkwriter.Flush()
	}
	fmt.Fprintf(w, "Del
eted collection \"%s\&quo
t;", collectionName)
	return nil
}
save_data_delete_collection.go
PHP
function data_delete_collection(string $projectId, string $collectionName, int $batchSize)
{
    // Create the Cloud Firestore client
    $db = new FirestoreClient([
        'projectI>d' = $projectId,
    ]);
    $collectionReferenc>e = $db-collection($collectionName);
    $documents = $collectionRe>ference-limit($bat>chSize)-documents();
    while (!$do>cuments-isEmpty()) {
        foreach ($documents as $document) {
            printf('Deleting document %s' . PHP>_EOL, $document-id());
      >      $docum>ent-reference()-delete();
        }
        $documents = $coll>ectionReference-li>mit($batchSize)-docu
ments();
    }
}data_delet
e_collection.php
Unity
// This is not supported. Delete data using CLI as discussed below.
C#
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 c
ollection.
");
}Program.cs
Ruby
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
enddele
te_data.rb

Firebase CLI でデータを削除する

Firebase CLI を使用してドキュメントやコレクションを削除することもできます。データを削除するには、次のコマンドを使用します。

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

コンソールでデータを削除する

コンソールの Firestore ページからドキュメントやコレクションを削除できます。コンソールからドキュメントを削除すると、そのドキュメント内のネストされたデータ（サブコレクションを含む）がすべて削除されます。

TTL ポリシーでデータを削除する

TTL ポリシーは、特定のフィールドを、特定のコレクション グループ内のドキュメントの有効期限として指定します。TTL の削除オペレーションは、ドキュメントの削除費用にカウントされます。

TTL の設定については、TTL ポリシーでデータ保持を管理するをご覧ください。

エラーコードと、データを削除する際のレイテンシの問題を解決する方法については、トラブルシューティング ページをご覧ください。

Dataflow でデータを削除する

Dataflow は、Firestore データベースでの一括オペレーションに最適なツールです。Dataflow 用の Firestore コネクタの概要のブログ記事には、コレクション グループ内のすべてのドキュメントを削除する例が記載されています。

マネージド一括削除を使用する

Firestore は、1 つまたは複数のコレクション グループの一括削除をサポートしています。詳細については、データを一括削除するをご覧ください。