מחיקת מסמכים ושדות

מחיקת מסמכים ושדות

בדוגמאות הבאות מוסבר איך למחוק מסמכים, שדות ואוספים.

מחיקת מסמכים

כדי למחוק מסמך, משתמשים בשיטות delete() הבאות שספציפיות לשפה:

גרסה 9 לאינטרנט

משתמשים בשיטה deleteDoc():

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

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

גרסה 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 ובמטרות של קליפים של אפליקציות.

do {
  try await db.collection("cities").document("DC").delete()
  print("Document successfully removed!")
} catch {
  print("Error removing document: \(error)")
}
ViewController.swift

Objective-C

משתמשים בשיטה deleteDocumentWithCompletion::

הערה: המוצר הזה לא זמין ב-watchOS ובמטרות של קליפים של אפליקציות.

[[[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
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():

// 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():

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

Python
(Async)

משתמשים בשיטה delete():

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():

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

המשך

משתמשים בשיטה 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("An error has occurred: %s", err)
	}

	return err
}
save_data_delete_doc.go

PHP

משתמשים בשיטה delete():

$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():

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

Ruby

משתמשים בשיטה delete():

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

אזהרה: מחיקת מסמך לא מוחקת את אוספי המשנה שלו!

כשמוחקים מסמך, Firestore לא מוחק באופן אוטומטי את המסמכים בקולקציות המשנה שלו. עדיין אפשר לגשת למסמכים של אוסף המשנה באמצעות הפניה. לדוגמה, אתם יכולים לגשת למסמך בנתיב /mycoll/mydoc/mysubcoll/mysubdoc גם אם תמחקו את מסמך האב בנתיב /mycoll/mydoc.

מסמכי אב שלא קיימים מופיעים במסוף, אבל הם לא מופיעים בתוצאות של שאילתות ובצילומים.

אם רוצים למחוק מסמך ואת כל המסמכים שנמצאים בתיקיות המשנה שלו, צריך לעשות זאת באופן ידני. מידע נוסף זמין במאמר מחיקת אוספים.

מחיקת שדות

כדי למחוק שדות ספציפיים ממסמך, משתמשים בשיטות FieldValue.delete() הספציפיות לשפה הבאה כשמעדכנים מסמך:

גרסה 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

גרסה 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 ובמטרות של קליפים של אפליקציות.

do {

  try await db.collection("cities").document("BJ").updateData([
    "capital": FieldValue.delete(),
  ])
  print("Document successfully updated")
} catch {
  print("Error updating document: \(error)")
}
ViewController.swift

Objective-C

משתמשים בשיטה fieldValueForDelete::

הערה: המוצר הזה לא זמין ב-watchOS ובמטרות של קליפים של אפליקציות.

[[[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
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():

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:

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

Python
(Async)

משתמשים בשיטה firestore.DELETE_FIELD:

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():

// 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

המשך

משתמשים בשיטה 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 occurred: %s", err)
	}

	// ...
	return err
}
save_data_delete_field.go

PHP

משתמשים בשיטה FieldValue::deleteField():

$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:

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:

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

מחיקת אוספים

כדי למחוק אוסף שלם או אוסף משנה ב-Firestore, צריך לאחזר (לקרוא) את כל המסמכים באוסף או באוסף המשנה ולמחוק אותם. התהליך הזה כרוך בעלויות של קריאה ומחיקה. אם יש לכם אוספים גדולים יותר, כדאי למחוק את המסמכים במנות קטנות יותר כדי להימנע משגיאות של חוסר זיכרון. חוזרים על התהליך עד שמוחקים את כל האוסף או אוסף המשנה.

מחיקת אוסף מחייבת תיאום של מספר בלתי מוגבל של בקשות מחיקה נפרדות. אם אתם צריכים למחוק אוספים שלמים, עליכם לעשות זאת רק מסביבת שרת מהימנה. אפשר למחוק אוסף מלקוח לנייד או לאינטרנט, אבל פעולה כזו עלולה לפגוע באבטחה ובביצועים.

קטעי הקוד הבאים פשוטים לשם הבהרה, והם לא כוללים טיפול בשגיאות, אבטחה, מחיקה של אוספי משנה או אופטימיזציה של הביצועים. כדי לקבל מידע נוסף על גישה מומלצת למחיקה של אוספים בסביבת ייצור, אפשר לעיין במאמר בנושא מחיקה של אוספים ואוספי משנה.

אינטרנט

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

Swift

הערה: המוצר הזה לא זמין ב-watchOS ובמטרות של קליפים של אפליקציות.

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

Objective-C

הערה: המוצר הזה לא זמין ב-watchOS ובמטרות של קליפים של אפליקציות.

// 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

import com.google.api.core.ApiFuture;
import com.google.cloud.firestore.CollectionReference;
import com.google.cloud.firestore.Firestore;
import com.google.cloud.firestore.FirestoreOptions;

public class DeleteCollection {

  /**
   * Delete a collection and all its subcollections.
   *
   * @param projectId The Google Cloud project ID
   * @param collectionName The name of the collection to delete
   */
  public static void deleteCollection(String projectId, String collectionName) throws Exception {
    FirestoreOptions firestoreOptions =
        FirestoreOptions.getDefaultInstance().toBuilder().setProjectId(projectId).build();
    try (Firestore db = firestoreOptions.getService()) {
      CollectionReference collection = db.collection(collectionName);

      ApiFuture<Void> future = db.recursiveDelete(collection);

      future.get();
      System.out.println("Collection and all its subcollections deleted successfully.");
    }
  }

  public static void main(String[] args) throws Exception {
    String projectId = "example-project-id";
    String collectionName = "example-collection-name";

    deleteCollection(projectId, collectionName);
  }
}
DeleteCollection.java

Python

def delete_collection(coll_ref):

    print(f"Recursively deleting collection: {coll_ref}")
    db.recursive_delete(coll_ref)
snippets.py

Python
(Async)

async def delete_collection(coll_ref):

    await db.recursive_delete(coll_ref)
snippets.py

C++‎

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

Node.js

async function deleteCollection(db, collectionPath) {
  const collectionRef = db.collection(collectionPath);
  return await db.recursiveDelete(collectionRef);
}
index.js

המשך

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, "Deleted collection \"%s\"", 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([
        '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#‎

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

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
end
delete_data.rb

מחיקת נתונים באמצעות כללי מדיניות של TTL

מדיניות TTL מציינת שדה מסוים כזמן התפוגה של מסמכים בקבוצת אוספים מסוימת. פעולות מחיקה של TTL נכללות בעלויות של מחיקת מסמכים.

מידע על הגדרת TTL מופיע במאמר ניהול שמירת נתונים באמצעות מדיניות TTL.

משימות של מחיקה בכמות גדולה

‫Firestore תומך בכמה כלים למחיקה בכמות גדולה. כדאי לבחור כלי לפי מספר המסמכים שצריך למחוק ורמת ההתאמה האישית שנדרשת.

הערה: מחיקה של מספר גדול של מסמכים יכולה להשפיע על זמן האחזור. אם הבעיה נובעת ממספר גדול מדי של מחיקות שבוצעו לאחרונה, היא אמורה להיפתר אוטומטית אחרי זמן מה. אם הבעיה לא נפתרת, פנו לתמיכה.

למשימות קטנות יותר של אלפי מסמכים, אפשר להשתמש במסוף או ב-Firebase CLI. במשימות גדולות יותר, יכול להיות שהכלים האלה יתחילו לפעול מעבר לזמן הקצוב לתפוגה, ותצטרכו להפעיל אותם כמה פעמים.

המסוף

אתם יכולים למחוק מסמכים ואוספים מהדף Firestore במסוף. מחיקת מסמך מהמסוף מוחקת את כל הנתונים המקוננים במסמך הזה, כולל כל אוספי המשנה.

Firebase CLI

אפשר גם להשתמש ב-Firebase CLI כדי למחוק מסמכים ואוספים. כדי למחוק נתונים, משתמשים בפקודה הבאה:

הערה: מחיקת נתונים באמצעות Firebase CLI כרוכה בעלויות קריאה ומחיקה. מידע נוסף על תמחור

firebase firestore:delete  --database=DATABASE_ID PATH

מחליפים את DATABASE_ID במזהה מסד הנתונים ואת PATH בנתיב למסמך או לאוסף.

למחיקה של כמות גדולה של מסמכים (מיליונים), אפשר להשתמש באחת מהאפשרויות הבאות:

מחיקה בכמות גדולה מנוהלת

ב-Firestore אפשר למחוק כמות גדולה של נתונים מקבוצה אחת או יותר של אוספים. מידע נוסף מופיע במאמר מחיקת נתונים בכמות גדולה.

מחבר Dataflow

אפשר להשתמש ב-Dataflow כדי לבצע פעולות בכמות גדולה במסד הנתונים. האפשרות הזו היא הכי גמישה להגדרה, אבל היא גם דורשת יותר הגדרות מאפשרויות אחרות למחיקה בכמות גדולה. בפוסט בבלוג בנושא מבוא ל-Dataflow עם מחבר Firestore יש דוגמה למחיקה של כל המסמכים בקבוצת אוספים.