ลบข้อมูลหลายรายการพร้อมกัน

ใช้บริการลบข้อมูลเป็นกลุ่มที่มีการจัดการเพื่อลบข้อมูลออกจากฐานข้อมูล ฟีเจอร์นี้รองรับการลบกลุ่มคอลเล็กชันอย่างน้อย 1 กลุ่ม

หน้านี้อธิบายวิธีลบเอกสารหลายรายการพร้อมกันโดยใช้ บริการลบแบบเป็นกลุ่มที่มีการจัดการ Firebaseบริการลบแบบเป็นกลุ่มที่มีการจัดการพร้อมให้บริการผ่านเครื่องมือบรรทัดคำสั่ง gcloud และ Cloud Firestore REST API

ข้อควรระวัง: การลบข้อมูลแบบเป็นกลุ่มจาก Firebase จะทำให้เกิดการดำเนินการลบ 1 รายการต่อเอกสารที่ลบ และการดำเนินการอ่านบางรายการตามเศษส่วนของเอกสารทั้งหมดที่อ่าน อย่างไรก็ตาม การดำเนินการเหล่านี้จะไม่ปรากฏในส่วนการใช้งานของคอนโซล โปรดทําความเข้าใจเรื่องนี้ก่อนที่จะลบหลายรายการพร้อมกันเพื่อหลีกเลี่ยงค่าใช้จ่ายที่เรียกเก็บ

ก่อนเริ่มต้น

ก่อนที่จะใช้บริการลบแบบกลุ่มที่มีการจัดการได้ คุณต้องทํางานต่อไปนี้ให้เสร็จสมบูรณ์

1. เปิดใช้ การเรียกเก็บเงินสำหรับโปรเจ็กต์ Google Cloud เฉพาะGoogle Cloud โปรเจ็กต์ที่เปิดใช้การเรียกเก็บเงินเท่านั้นที่ใช้ฟังก์ชันการลบแบบเป็นกลุ่มได้

2. ตรวจสอบว่าบัญชีของคุณมีสิทธิ์ที่จำเป็นสำหรับ Firebase หากคุณเป็นเจ้าของโปรเจ็กต์ บัญชีของคุณจะมีสิทธิ์ที่จำเป็น มิฉะนั้น บทบาทต่อไปนี้ จะให้สิทธิ์ที่จำเป็นสำหรับการดำเนินการลบแบบเป็นกลุ่ม

   • บทบาท Firebase: Owner, Cloud Datastore Owner หรือ Cloud Datastore Bulk Admin
     หมายเหตุ: บทบาท Datastore เหล่านี้ยังให้ สิทธิ์ใน Cloud Firestore ด้วย

ตั้งค่า gcloud สำหรับโปรเจ็กต์

คุณเริ่มการดำเนินการลบแบบเป็นกลุ่มได้ผ่าน Google Cloud Console หรือ gcloudเครื่องมือบรรทัดคำสั่ง หากต้องการใช้ gcloud ให้ตั้งค่าเครื่องมือบรรทัดคำสั่ง และเชื่อมต่อกับโปรเจ็กต์ด้วยวิธีใดวิธีหนึ่งต่อไปนี้

• เข้าถึง gcloud จากคอนโซล Google Cloud โดยใช้ Cloud Shell

  เริ่ม Cloud Shell

  ตรวจสอบว่าได้กำหนดค่า gcloud สำหรับโปรเจ็กต์ที่ถูกต้องแล้ว โดยทำดังนี้

  gcloud config set project [PROJECT_ID]
  

• ติดตั้งและเริ่มต้น Google Cloud SDK

ลบข้อมูลหลายรายการพร้อมกัน

การดำเนินการลบแบบเป็นกลุ่มจะค้นหาเอกสารที่เกี่ยวข้องทั้งหมดในฐานข้อมูลก่อน แล้วจึงลบเอกสารเป็นชุด คุณยังคงค้นหาหรืออ่านเอกสารเหล่านี้ได้ แต่ผลลัพธ์อาจแตกต่างกันไปตามความคืบหน้า การลบแบบเป็นกลุ่มจะไม่ลบเอกสารใดๆ ที่เพิ่มหรือแก้ไขหลังจากที่การดำเนินการเริ่มขึ้น

หมายเหตุ: หากวางแผนที่จะลบเอกสารทั้งหมดในฐานข้อมูล โปรดดูฟีเจอร์การลบฐานข้อมูลแทน

ลบกลุ่มคอลเล็กชันที่เฉพาะเจาะจงหลายกลุ่มพร้อมกัน

gcloud

หากต้องการลบกลุ่มคอลเล็กชันที่เฉพาะเจาะจงหลายกลุ่มพร้อมกัน ให้ใช้แฟล็ก --collection-ids การดำเนินการนี้จะลบเฉพาะกลุ่มคอลเล็กชันที่มีรหัสที่ระบุ

gcloud firestore bulk-delete \
--collection-ids=[COLLECTION_GROUP_ID_1_OR_KIND_1],[COLLECTION_GROUP_ID_2_OR_KIND_2],[SUBCOLLECTION_GROUP_ID_1_OR_KIND_3] \
--database=[DATABASE]

จัดการการดำเนินการลบแบบเป็นกลุ่ม

หลังจากเริ่มการดำเนินการลบแบบเป็นกลุ่มแล้ว Firebase จะกำหนดชื่อที่ไม่ซ้ำให้กับการดำเนินการ คุณสามารถใช้ชื่อการดำเนินการเพื่อลบ ยกเลิก หรือตรวจสอบสถานะของการดำเนินการได้

ชื่อการดำเนินการจะมีคำนำหน้าเป็น projects/[PROJECT_ID]/databases/[DATABASE_ID]/operations/ เช่น

projects/my-project/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg

อย่างไรก็ตาม คุณสามารถละเว้นคำนำหน้าเมื่อระบุชื่อการดำเนินการสำหรับคำสั่ง describe, cancel และ delete ได้

แสดงรายการการดำเนินการลบแบบกลุ่มทั้งหมด

gcloud

ใช้คำสั่ง operations list เพื่อดูการดำเนินการทั้งหมดที่กำลังทำงานอยู่และการดำเนินการที่เพิ่งเสร็จสมบูรณ์ ซึ่งรวมถึงการดำเนินการลบแบบกลุ่ม

gcloud firestore operations list

ตรวจสอบสถานะการดำเนินการ

gcloud

ใช้คำสั่ง operations describe เพื่อแสดงสถานะของการดำเนินการลบแบบเป็นกลุ่ม

gcloud firestore operations describe [OPERATION_NAME]

ประเมินเวลาที่ใช้ดำเนินการให้เสร็จสมบูรณ์

คำขอสถานะของการดำเนินการที่ใช้เวลานานจะแสดงผลเมตริก workEstimated และ workCompleted ระบบจะแสดงเมตริกแต่ละรายการเหล่านี้ทั้งใน จำนวนไบต์และจำนวนเอกสาร

• workEstimated แสดงจำนวนไบต์และเอกสารทั้งหมดโดยประมาณที่การดำเนินการจะประมวลผล Firebase อาจละเว้นเมตริกนี้หากไม่สามารถประมาณค่าได้

• workCompleted แสดงจำนวนไบต์และเอกสารที่ลบไปแล้ว หลังจากดำเนินการเสร็จสมบูรณ์ ค่าจะแสดงจำนวนไบต์และเอกสารทั้งหมดที่ประมวลผลจริง ซึ่งอาจมากกว่าค่าของ workEstimated

นำ workCompleted มาหารด้วย workEstimated เพื่อดูความคืบหน้าโดยประมาณ การประมาณนี้อาจไม่ถูกต้องเนื่องจากขึ้นอยู่กับการรวบรวมสถิติที่ล่าช้า

ยกเลิกการดำเนินการ

gcloud

ใช้คำสั่ง operations cancel เพื่อหยุดการดำเนินการที่กำลังดำเนินการอยู่

gcloud firestore operations cancel [OPERATION_NAME]

การยกเลิกการดำเนินการที่กำลังทำงานอยู่จะไม่ยกเลิกการดำเนินการ การดำเนินการลบแบบเป็นกลุ่มที่ยกเลิกแล้วจะไม่กู้คืนเอกสารที่ลบไปแล้ว

ลบการดำเนินการ

ใช้คำสั่ง gcloud firestore operations delete เพื่อนำการดำเนินการที่เสร็จสมบูรณ์แล้วออกจากรายการการดำเนินการล่าสุด หากต้องการยกเลิกการดำเนินการที่กำลังทำงานอยู่ ให้ใช้การดำเนินการยกเลิกก่อนหน้านี้

gcloud firestore operations delete [OPERATION_NAME]

การเรียกเก็บเงินและการกำหนดราคาสำหรับการดำเนินการลบแบบเป็นกลุ่ม

คุณต้องเปิดใช้การเรียกเก็บเงินสำหรับโปรเจ็กต์ Google Cloud ก่อนจึงจะใช้บริการลบแบบกลุ่มที่จัดการได้

โปรดทราบว่า Firebase จะเรียกเก็บเงินตามงานที่ทำจริง หากมีการยกเลิกหรือดำเนินการไม่สำเร็จเนื่องจากข้อผิดพลาดของผู้ใช้ ระบบจะเรียกเก็บเงินจากคุณตาม ความคืบหน้าที่ดำเนินการ Firebase จะไม่เรียกเก็บเงินสำหรับการอ่านหรือลบเอกสารที่ไม่ได้ถูกลบในที่สุด เช่น เอกสารที่ได้รับการแก้ไขหลังจากเริ่มดำเนินการลบ ระบบจะระบุแหล่งที่มาของค่าใช้จ่ายใน วันที่ดำเนินการเสร็จสมบูรณ์

การดำเนินการลบแบบเป็นกลุ่มจะไม่ทริกเกอร์การแจ้งเตือนGoogle Cloudงบประมาณจนกว่าจะเสร็จสมบูรณ์ ในทำนองเดียวกัน การอ่านและการลบที่ดำเนินการระหว่างการดำเนินการลบแบบเป็นกลุ่มจะนำไปใช้กับการใช้งานระดับฟรีหลังจากที่การดำเนินการเสร็จสมบูรณ์ การดำเนินการลบแบบกลุ่ม จะไม่ส่งผลต่อการใช้งานที่แสดงในส่วนการใช้งานของคอนโซล

ดูค่าใช้จ่ายในการลบแบบเป็นกลุ่ม

การดำเนินการลบแบบเป็นกลุ่มจะใช้goog-firestoremanaged:bulkdelete ป้ายกำกับกับการดำเนินการที่เรียกเก็บเงิน ในหน้ารายงานการเรียกเก็บเงินใน Cloud คุณสามารถใช้ป้ายกำกับนี้เพื่อดูค่าใช้จ่ายที่เกี่ยวข้องกับการดำเนินการลบแบบเป็นกลุ่ม