ส่วนขยายลบข้อมูลผู้ใช้ (delete-user-data) ช่วยให้คุณลบข้อมูลของผู้ใช้ได้เมื่อมีการลบผู้ใช้ออกจากโปรเจ็กต์ Firebase คุณสามารถกำหนดค่าส่วนขยายนี้เพื่อลบข้อมูลผู้ใช้ออกจาก Cloud Firestore, Realtime Database หรือ Cloud Storage อย่างใดอย่างหนึ่งหรือทั้งหมดได้ การเรียกใช้ส่วนขยายแต่ละครั้งเพื่อลบข้อมูลจะเชื่อมโยงกับ UserId ของผู้ใช้
ส่วนขยายนี้มีประโยชน์ในการเคารพความเป็นส่วนตัวของผู้ใช้และปฏิบัติตามข้อกำหนดด้านการปฏิบัติตามข้อกำหนด อย่างไรก็ตาม การใช้ส่วนขยายนี้ไม่ได้เป็นการรับประกันว่าจะเป็นไปตามกฎระเบียบของรัฐบาลและอุตสาหกรรม
ข้อกำหนดเบื้องต้น
คุณต้องใช้การตรวจสอบสิทธิ์ Firebase เพื่อจัดการผู้ใช้
ส่วนขยายนี้จะลบข้อมูลจาก Cloud Firestore, Realtime Database และ Cloud Storage เท่านั้น หากจัดเก็บข้อมูลผู้ใช้ไว้ที่อื่น คุณควรลบข้อมูลผู้ใช้จากแหล่งที่มาเหล่านั้นด้วยเมื่อลบผู้ใช้
ติดตั้งส่วนขยาย
หากต้องการติดตั้งส่วนขยาย ให้ทำตามขั้นตอนในหน้าติดตั้งส่วนขยาย Firebase โดยสรุป ให้ทำอย่างใดอย่างหนึ่งต่อไปนี้
คอนโซล Firebase: คลิกปุ่มต่อไปนี้
CLI: เรียกใช้คำสั่งต่อไปนี้
firebase ext:install firebase/delete-user-data --project=projectId-or-alias
ในระหว่างการติดตั้งส่วนขยาย ระบบจะแจ้งให้คุณระบุพารามิเตอร์การกำหนดค่าจำนวนหนึ่ง ดังนี้
ตำแหน่ง Cloud Functions:
เลือกตำแหน่งที่คุณต้องการติดตั้งใช้งานฟังก์ชันที่สร้างขึ้นสำหรับส่วนขยายนี้ โดยปกติแล้ว คุณต้องการให้ตำแหน่งอยู่ใกล้กับฐานข้อมูล หากต้องการความช่วยเหลือในการเลือกสถานที่ตั้ง โปรดดูคู่มือการเลือกสถานที่ตั้ง
เส้นทาง Cloud Firestore:
เส้นทางใดในอินสแตนซ์ Cloud Firestore ที่มีข้อมูลผู้ใช้ ปล่อยว่างไว้หากไม่ได้ใช้ Cloud Firestore ป้อนเส้นทางแบบเต็มโดยคั่นด้วยคอมมา คุณสามารถแสดงรหัสผู้ใช้ของผู้ใช้ที่ถูกลบด้วย
{UID}ตัวอย่างเช่น หากคุณมีคอลเล็กชันusersและadminsและแต่ละคอลเล็กชันมีเอกสารที่มีรหัสผู้ใช้เป็นรหัสเอกสาร คุณจะป้อนusers/{UID},admins/{UID}ได้โหมดการลบของ Cloud Firestore:
(ใช้ได้เฉพาะในกรณีที่คุณใช้พารามิเตอร์
Cloud Firestore paths) คุณต้องการลบเอกสาร Cloud Firestore อย่างไร หากต้องการลบเอกสารในคอลเล็กชันย่อยด้วย ให้ตั้งค่าพารามิเตอร์นี้เป็นrecursiveอินสแตนซ์ Realtime Database:
คุณต้องการลบข้อมูลผู้ใช้จากอินสแตนซ์ Realtime Database ใด
ตำแหน่งของ Realtime Database:
(ใช้ได้เฉพาะในกรณีที่คุณระบุพารามิเตอร์
Realtime Database instance) คุณต้องการลบข้อมูลผู้ใช้จากตำแหน่ง Realtime Database ใดเส้นทาง Realtime Database:
เส้นทางใดในอินสแตนซ์ Realtime Database ที่มีข้อมูลผู้ใช้ ปล่อยว่างไว้หากไม่ได้ใช้ Realtime Database ป้อนเส้นทางแบบเต็มโดยคั่นด้วยคอมมา คุณสามารถแสดงรหัสผู้ใช้ของผู้ใช้ที่ถูกลบด้วย
{UID}ตัวอย่างเช่นusers/{UID},admins/{UID}เส้นทาง Cloud Storage:
คุณจัดเก็บข้อมูลผู้ใช้ไว้ที่ใดใน Google Cloud Storage ปล่อยว่างไว้หากไม่ได้ใช้ Cloud Storage ป้อนเส้นทางแบบเต็มไปยังไฟล์หรือไดเรกทอรีในที่เก็บข้อมูล Storage โดยคั่นด้วยคอมมา ใช้
{UID}เพื่อแสดงรหัสผู้ใช้ของผู้ใช้ที่ถูกลบ และใช้{DEFAULT}เพื่อแสดงที่เก็บข้อมูลเริ่มต้นตัวอย่างต่อไปนี้
- หากต้องการลบไฟล์ทั้งหมดในที่เก็บข้อมูลเริ่มต้นที่มีรูปแบบการตั้งชื่อไฟล์
{UID}-pic.pngให้ป้อน{DEFAULT}/{UID}-pic.png - หากต้องการลบไฟล์ทั้งหมดในที่เก็บข้อมูลอื่นที่ชื่อ
my-app-logsซึ่งมีรูปแบบการตั้งชื่อไฟล์เป็น{UID}-logs.txtด้วย ให้ป้อน{DEFAULT}/{UID}-pic.png,my-app-logs/{UID}-logs.txt - หากต้องการลบไดเรกทอรีที่ติดป้ายกำกับรหัสผู้ใช้และไฟล์ทั้งหมดในไดเรกทอรีนั้น (เช่น
media/{UID}) ด้วย ให้ป้อน{DEFAULT}/{UID}-pic.png,my-app-logs/{UID}-logs.txt,{DEFAULT}/media/{UID}
- หากต้องการลบไฟล์ทั้งหมดในที่เก็บข้อมูลเริ่มต้นที่มีรูปแบบการตั้งชื่อไฟล์
ค้นหาข้อมูลที่จะลบ
ส่วนขยายนี้มีกลไก 2-3 อย่างที่ใช้ในการค้นหาข้อมูลเพื่อลบ คุณต้องกำหนดค่ากลไกเหล่านี้อย่างชัดเจนเพื่อให้ส่วนขยายลบข้อมูลได้ ส่วนขยายจะลบเฉพาะข้อมูลที่กำหนดค่าอย่างชัดเจนให้ลบตามกลไกที่ระบุไว้
โปรดทราบถึงความแตกต่างด้านพฤติกรรมต่อไปนี้ระหว่างแต่ละบริการ
- Cloud Firestore: ลักษณะการทำงานเริ่มต้นคือการลบเอกสารแบบตื้น (ระบบจะไม่ลบคอลเล็กชันย่อย) หากต้องการลบคอลเล็กชันย่อยทั้งหมดของเอกสารแบบเรียกซ้ำ ให้ตั้งค่าตัวเลือก "โหมดการลบของ Cloud Firestore" เป็น "เรียกซ้ำ"
- Realtime Database: ระบบจะลบข้อมูลทั้งหมดในโหนดที่ระบุ
- พื้นที่เก็บข้อมูล: หากระบุเส้นทางไดเรกทอรี ระบบจะลบไฟล์และไดเรกทอรีย่อยทั้งหมด
ตามเส้นทาง
เมื่อกำหนดค่าเส้นทาง Cloud Firestore, ฐานข้อมูลเรียลไทม์ และ Cloud Storage คุณจะกำหนดUIDตัวแปรในเส้นทางที่จะแทนที่ด้วย UID ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ได้ เมื่อลบผู้ใช้ ส่วนขยายจะลบข้อมูลทั้งหมดที่คีย์ใน UID นั้นที่เส้นทางที่ระบุ เช่น
- เส้นทาง Cloud Firestore:
users/{UID},admins/{UID} - เส้นทาง Realtime Database:
likes/{UID} - เส้นทาง Cloud Storage:
{DEFAULT}/uploads/{UID},{DEFAULT}/avatars/{UID}.jpeg
การค้นหาอัตโนมัติ (Cloud Firestore)
หากต้องการให้ส่วนขยายค้นหาเอกสาร Firestore ที่จะลบโดยอัตโนมัติ ให้ตั้งค่าพารามิเตอร์การกำหนดค่า "เปิดใช้การค้นหาอัตโนมัติ" เป็น "ใช่"
การค้นหาอัตโนมัติจะทำงานโดยการข้ามฐานข้อมูลโดยอัตโนมัติเพื่อค้นหาคอลเล็กชันและเอกสารที่ควรลบตามการกำหนดค่าของคุณ ส่วนขยายจะระบุคอลเล็กชันและเอกสารเหล่านั้นด้วยวิธีการต่อไปนี้
- ก่อนอื่น ส่วนขยายจะค้นหาคอลเล็กชันรูททั้งหมดในฐานข้อมูล หากรหัสของคอลเล็กชันตรงกับ UID ของผู้ใช้ ระบบจะลบคอลเล็กชันทั้งหมด (การลบจะเป็นแบบเรียกซ้ำหรือแบบตื้น ขึ้นอยู่กับการกำหนดค่าของส่วนขยายสำหรับ "โหมดการลบ Cloud Firestore")
- ประการที่สอง หากรหัสคอลเล็กชันไม่ตรงกัน ส่วนขยายจะพยายามระบุและลบเอกสารหากรหัสเอกสารตรงกับ UID ของผู้ใช้
- สุดท้าย ให้ดำเนินการต่อไปนี้สำหรับเอกสารแต่ละฉบับ ก. หากระดับการค้นหาปัจจุบัน (ดูด้านล่าง) น้อยกว่าหรือเท่ากับระดับการค้นหาที่กำหนดค่าไว้ ระบบจะทำกระบวนการนี้ซ้ำสำหรับคอลเล็กชันย่อยทั้งหมดของเอกสารปัจจุบัน ข. หากมีการกำหนดค่าช่องค้นหา ส่วนขยายจะตรวจสอบว่าช่องที่ระบุตรงกับ UID ของผู้ใช้หรือไม่ หากพบเอกสารที่ตรงกัน ระบบจะลบเอกสารนั้น
ความลึกของการค้นหา
ส่วนขยายมีค่าความลึกในการค้นหาที่กำหนดค่าได้ (ค่าเริ่มต้นคือ 3) การข้ามจะดำเนินการก็ต่อเมื่อความลึกของการค้นหาปัจจุบันน้อยกว่าหรือเท่ากับความลึกของการค้นหาที่กำหนดค่าไว้ ความลึกของการค้นหาปัจจุบันจะอิงตามความลึกของคอลเล็กชันปัจจุบันหรือคอลเล็กชันหลักของเอกสาร เช่น
/users = 1
/users/<document-id> = 1
/users/<document-id>/comments = 2
/users/<document-id>/comments/<document-id> = 2
ส่วนขยายนี้จะไม่ลบ UID ที่จัดเก็บไว้ในอาร์เรย์หรือแผนที่โดยอัตโนมัติ และจะไม่ค้นหาข้อมูลที่คีย์ด้วยรหัสผู้ใช้ซึ่งจัดเก็บไว้ในคอลเล็กชันย่อยที่ซ้อนกันอย่างลึกเกินกว่าระดับที่ระบุไว้ข้างต้น