หน้านี้จะอธิบายวิธีใช้ฟีเจอร์การสำรองข้อมูลตามกำหนดการของ Cloud Firestore ใช้ข้อมูลสำรองเพื่อปกป้องข้อมูลจากความเสียหายระดับแอปพลิเคชันหรือจากการลบข้อมูลโดยไม่ตั้งใจ
การสำรองข้อมูลช่วยให้คุณกำหนดค่ากำหนดการสำรองข้อมูลเพื่อสำรองข้อมูลฐานข้อมูลที่ระบุรายวันหรือรายสัปดาห์ได้ จากนั้นคุณจะใช้ข้อมูลสำรองเหล่านี้เพื่อคืนค่า ข้อมูลไปยังฐานข้อมูลใหม่ได้
เกี่ยวกับข้อมูลสำรอง
ข้อมูลสำรองคือสำเนาที่สอดคล้องกันของฐานข้อมูลในช่วงเวลาหนึ่ง ข้อมูลสำรองจะมีข้อมูลและการกำหนดค่าดัชนีทั้งหมดในขณะนั้น ข้อมูลสำรองจะไม่มีนโยบาย Time to Live ของฐานข้อมูล ข้อมูลสำรองจะอยู่ในตำแหน่งเดียวกับฐานข้อมูลต้นทาง
ข้อมูลสำรองมีระยะเวลาการเก็บรักษาที่กำหนดค่าได้และระบบจะจัดเก็บไว้จนกว่าจะหมดระยะเวลาเก็บรักษาหรือจนกว่าคุณจะลบข้อมูลสำรอง การลบฐานข้อมูลต้นทาง จะไม่ลบข้อมูลสำรองที่เกี่ยวข้องโดยอัตโนมัติ
Cloud Firestore จะจัดเก็บข้อมูลเมตาที่เกี่ยวข้องกับการสำรองข้อมูลและกำหนดการสำรองที่เกี่ยวข้องกับฐานข้อมูล Cloud Firestore จะเก็บข้อมูลเมตานี้จนกว่าข้อมูลสำรองทั้งหมดสำหรับฐานข้อมูลจะหมดอายุหรือถูกลบ
การสร้างหรือการเก็บรักษาข้อมูลสำรองจะไม่ส่งผลต่อประสิทธิภาพของการอ่านหรือการเขียนในฐานข้อมูลแบบสด
ค่าใช้จ่าย
เมื่อใช้ข้อมูลสำรอง ระบบจะเรียกเก็บเงินสำหรับสิ่งต่อไปนี้
- ปริมาณพื้นที่เก็บข้อมูลที่ใช้โดยข้อมูลสำรองแต่ละรายการ
- ในการดำเนินการกู้คืน ระบบจะเรียกเก็บเงินตามขนาดของข้อมูลสำรอง
ดูรายละเอียดเพิ่มเติมและราคาที่แน่นอนได้ในหน้าราคา
ก่อนเริ่มต้น
ฟีเจอร์นี้ต้องใช้แพ็กเกจราคา Blazeบทบาทที่จำเป็น
หากต้องการรับสิทธิ์ที่คุณจำเป็นต้องใช้ในการจัดการการสำรองข้อมูลและกำหนดเวลาการสำรองข้อมูล โปรดขอให้ผู้ดูแลระบบมอบบทบาท Identity and Access Management ต่อไปนี้อย่างน้อย 1 บทบาท
roles/datastore.owner
: สิทธิ์เข้าถึงฐานข้อมูล Cloud Firestore โดยสมบูรณ์บทบาทต่อไปนี้ก็พร้อมใช้งานเช่นกันแต่ไม่แสดงในคอนโซล Google Cloud Platform ใช้ Google Cloud CLI เพื่อมอบหมายบทบาทต่อไปนี้
roles/datastore.backupsAdmin
: สิทธิ์อ่านและเขียนข้อมูลสำรองroles/datastore.backupsViewer
: สิทธิ์การอ่านข้อมูลสำรองroles/datastore.backupSchedulesAdmin
: สิทธิ์อ่านและเขียนกำหนดการสำรองroles/datastore.backupSchedulesViewer
: สิทธิ์การอ่านกำหนดการสำรองข้อมูลroles/datastore.restoreAdmin
: สิทธิ์เพื่อเริ่มดำเนินการกู้คืน
สร้างและจัดการกำหนดการสำรองข้อมูล
ตัวอย่างด้านล่างแสดงวิธีตั้งกำหนดการสำรองข้อมูล สำหรับฐานข้อมูลแต่ละรายการ คุณกำหนดค่ากำหนดการสำรองข้อมูลได้สูงสุด 1 รายการต่อวัน และกำหนดเวลาการสำรองข้อมูลรายสัปดาห์ได้สูงสุด 1 รายการ คุณไม่สามารถกำหนดค่ากำหนดการสำรองข้อมูลรายสัปดาห์หลายรายการสำหรับวันต่างๆ ในสัปดาห์ได้
คุณไม่สามารถกำหนดค่าเวลาที่แน่นอนของวันสำรองข้อมูลได้ การสำรองข้อมูลจะใช้เวลา ต่างกันในแต่ละวัน สำหรับกำหนดเวลาการสำรองข้อมูลรายสัปดาห์ คุณสามารถกำหนดค่าวันในสัปดาห์สำหรับการสำรองข้อมูลได้
สร้างกำหนดการสํารองข้อมูล
หากต้องการสร้างกำหนดการสำรองข้อมูลสำหรับฐานข้อมูล ให้ใช้คำสั่ง gcloud alpha firestore backups schedules create
หรือคำสั่ง firebase firestore:databases:backups:schedules
สร้างกำหนดการสํารองข้อมูลรายวัน
gcloud
หากต้องการสร้างกำหนดเวลาการสำรองข้อมูลรายวัน ให้ตั้งค่าสถานะ--recurrence
เป็น daily
ดังนี้
gcloud alpha firestore backups schedules create \ --database='DATABASE_ID' \ --recurrence=daily \ --retention=RETENTION_PERIOD
แทนที่ค่าต่อไปนี้
- DATABASE_ID: รหัสของฐานข้อมูลที่จะสำรองข้อมูล ตั้งค่าเป็น
'(default)'
สำหรับฐานข้อมูลเริ่มต้น - RETENTION_PERIOD: ตั้งค่านี้เป็นค่าไม่เกิน 14 สัปดาห์ (
14w
)
Firebase CLI
หากต้องการสร้างกำหนดเวลาการสำรองข้อมูลรายวัน ให้ตั้งค่าสถานะ--recurrence
เป็น DAILY
ดังนี้
firebase firestore:backups:schedules:create \ --database 'DATABASE_ID' \ --recurrence 'DAILY' \ --retention RETENTION_PERIOD
แทนที่ค่าต่อไปนี้
- DATABASE_ID: รหัสของฐานข้อมูลที่จะสำรองข้อมูล ตั้งค่าเป็น
'(default)'
สำหรับฐานข้อมูลเริ่มต้น - RETENTION_PERIOD: ตั้งค่านี้เป็นค่าไม่เกิน 14 สัปดาห์ (
14w
)
Terraform
หากต้องการสร้างกำหนดเวลาการสำรองข้อมูลรายวัน ให้สร้างทรัพยากรgoogle_firestore_backup_schedule
resource "google_firestore_backup_schedule" "daily-backup" { project = PROJECT_ID database = DATABASE_ID retention = RETENTION_PERIOD_SECONDS daily_recurrence {} }
แทนที่ค่าต่อไปนี้
- PROJECT_ID: รหัสของโปรเจ็กต์
- DATABASE_ID: รหัสของฐานข้อมูลที่จะสำรองข้อมูล ตั้งค่าเป็น
'(default)'
สำหรับฐานข้อมูลเริ่มต้น
คุณยังใช้การอ้างอิงทรัพยากรกับทรัพยากร Terraform ประเภท - RETENTION_PERIOD_SECONDS: ตั้งเป็นค่าเป็นวินาที ตามด้วย "s" ค่าสูงสุดคือ
8467200s
(14 สัปดาห์)
google_firestore_database
ได้ด้วย
สร้างกำหนดการสำรองข้อมูลรายสัปดาห์
gcloud
หากต้องการสร้างกำหนดการสำรองข้อมูลรายสัปดาห์ ให้กำหนดค่า--recurrence
เป็น weekly
gcloud alpha firestore backups schedules create \ --database='DATABASE_ID' \ --recurrence=weekly \ --retention=RETENTION_PERIOD \ --day-of-week=DAYแทนที่รายการต่อไปนี้
- DATABASE_ID: รหัสของฐานข้อมูลที่จะสำรองข้อมูล ตั้งค่าเป็น
'(default)'
สำหรับฐานข้อมูลเริ่มต้น - RETENTION_PERIOD: ตั้งค่านี้เป็นค่าไม่เกิน 14 สัปดาห์ (
14w
) - DAY: วันของสัปดาห์ที่จะทำข้อมูลสำรอง ตั้งค่าเป็น
SUN
สำหรับวันอาทิตย์MON
สำหรับวันจันทร์TUE
สำหรับวันอังคารWED
สำหรับวันพุธTHU
สำหรับวันพฤหัสบดีFRI
สำหรับวันศุกร์SAT
สำหรับวันเสาร์
Firebase CLI
หากต้องการสร้างกำหนดการสำรองข้อมูลรายสัปดาห์ ให้กำหนดค่า--recurrence
เป็น WEEKLY
firebase firestore:backups:schedules:create \ --database 'DATABASE_ID' \ --recurrence 'WEEKLY' \ --retention RETENTION_PERIOD --day-of-week DAYแทนที่รายการต่อไปนี้
- DATABASE_ID: รหัสของฐานข้อมูลที่จะสำรองข้อมูล ตั้งค่าเป็น
'(default)'
สำหรับฐานข้อมูลเริ่มต้น - RETENTION_PERIOD: ตั้งค่านี้เป็นค่าไม่เกิน 14 สัปดาห์ (
14w
) - DAY: วันของสัปดาห์ที่จะทำข้อมูลสำรอง ตั้งค่าเป็น
SUNDAY
สำหรับวันอาทิตย์MONDAY
สำหรับวันจันทร์TUESDAY
สำหรับวันอังคารWEDNESDAY
สำหรับวันพุธTHURSDAY
สำหรับวันพฤหัสบดีFRIDAY
สำหรับวันศุกร์SATURDAY
สำหรับวันเสาร์
Terraform
หากต้องการสร้างกำหนดเวลาการสำรองข้อมูลรายสัปดาห์ ให้สร้างทรัพยากรgoogle_firestore_backup_schedule
resource "google_firestore_backup_schedule" "weekly-backup" { project = PROJECT_ID database = DATABASE_ID retention = RETENTION_PERIOD_SECONDS weekly_recurrence { day = DAY } }
แทนที่ค่าต่อไปนี้
- PROJECT_ID: รหัสของโปรเจ็กต์
- DATABASE_ID: รหัสของฐานข้อมูลที่จะสำรองข้อมูล ตั้งค่าเป็น
'(default)'
สำหรับฐานข้อมูลเริ่มต้น
คุณยังใช้การอ้างอิงทรัพยากรกับทรัพยากร Terraform ประเภท - RETENTION_PERIOD_SECONDS: ตั้งเป็นค่าเป็นวินาที ตามด้วย "s" ค่าสูงสุดคือ
8467200s
(14 สัปดาห์) - DAY: วันของสัปดาห์ที่จะทำข้อมูลสำรอง ตั้งค่าเป็น
SUNDAY
สำหรับวันอาทิตย์MONDAY
สำหรับวันจันทร์TUESDAY
สำหรับวันอังคารWEDNESDAY
สำหรับวันพุธTHURSDAY
สำหรับวันพฤหัสบดีFRIDAY
สำหรับวันศุกร์SATURDAY
สำหรับวันเสาร์
google_firestore_database
ได้ด้วย
แสดงรายการกำหนดเวลาการสำรองข้อมูล
หากต้องการแสดงรายการกำหนดการสำรองข้อมูลทั้งหมดสำหรับฐานข้อมูล ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
gcloud
ใช้คำสั่งgcloud alpha firestore backups schedules list
gcloud alpha firestore backups schedules list \ --database='DATABASE_ID'แทนที่ DATABASE_ID ด้วยรหัสของฐานข้อมูล ใช้
'(default)'
เป็นฐานข้อมูลเริ่มต้น
Firebase CLI
ใช้คำสั่งfirebase firestore:backups:schedules:list
firebase firestore:backups:schedules:list \ --database 'DATABASE_ID'แทนที่ DATABASE_ID ด้วยรหัสของฐานข้อมูล ใช้
'(default)'
เป็นฐานข้อมูลเริ่มต้น
อธิบายกำหนดการสำรองข้อมูล
หากต้องการเรียกข้อมูลเกี่ยวกับกำหนดการสำรอง ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
gcloud
ใช้คำสั่งgcloud alpha firestore backups schedules describe
gcloud alpha firestore backups schedules describe \ --database='DATABASE_ID' \ --backup-schedule=BACKUP_SCHEDULE_IDแทนที่รายการต่อไปนี้
- DATABASE_ID: รหัสของฐานข้อมูลที่จะสำรองข้อมูล ตั้งค่าเป็น
'(default)'
สำหรับฐานข้อมูลเริ่มต้น - BACKUP_SCHEDULE_ID: รหัสของกำหนดการสำรอง คุณจะดูรหัสของกำหนดการสำรองข้อมูลแต่ละรายการได้เมื่อระบุกำหนดเวลาการสำรองข้อมูลทั้งหมด
อัปเดตกําหนดการสํารองข้อมูล
หากต้องการอัปเดตระยะเวลาเก็บรักษาของกำหนดการสำรองข้อมูล ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
gcloud
ใช้คำสั่งgcloud alpha firestore backups schedules update
gcloud alpha firestore backups schedules update \ --database='DATABASE_ID' \ --backup-schedule=BACKUP_SCHEDULE_ID \ --retention=RETENTION_PERIODแทนที่รายการต่อไปนี้
- DATABASE_ID: รหัสของฐานข้อมูลที่จะสำรองข้อมูล ตั้งค่าเป็น
'(default)'
สำหรับฐานข้อมูลเริ่มต้น - BACKUP_SCHEDULE_ID: รหัสของกำหนดการสำรอง คุณจะดูรหัสของกำหนดการสำรองข้อมูลแต่ละรายการได้เมื่อระบุกำหนดเวลาการสำรองข้อมูลทั้งหมด
- RETENTION_PERIOD: ตั้งค่านี้เป็นค่าไม่เกิน 14 สัปดาห์ (
14w
)
Firebase CLI
ใช้คำสั่งfirebase firestore:backups:schedules:update
firebase firestore:backups:schedules:update \ BACKUP_SCHEDULE \ --retention RETENTION_PERIODแทนที่รายการต่อไปนี้
- BACKUP_SCHEDULE: ชื่อทรัพยากรแบบเต็มของกำหนดการสำรองข้อมูล คุณจะดูชื่อของกำหนดการสำรองข้อมูลแต่ละรายการได้เมื่อระบุกำหนดเวลาการสำรองข้อมูลทั้งหมด
- RETENTION_PERIOD: ตั้งค่านี้เป็นค่าไม่เกิน 14 สัปดาห์ (
14w
)
คุณอัปเดตระยะเวลาเก็บรักษาของกำหนดการสำรองข้อมูลได้ แต่จะอัปเดตระยะเวลาเก็บรักษาของกำหนดการซ้ำไม่ได้ หากจำเป็นต้องใช้กำหนดการสำรองข้อมูลด้วยการเกิดซ้ำแบบอื่น ให้ลบกำหนดการสำรองเก่าหากไม่จำเป็นต้องใช้แล้ว แล้วสร้างกำหนดการสำรองข้อมูลใหม่ด้วยการเกิดซ้ำตามต้องการ
ลบกำหนดการสำรองข้อมูล
หากต้องการลบกำหนดเวลาการสำรองข้อมูล ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
gcloud
ใช้คำสั่งgcloud alpha firestore backups schedules delete
gcloud alpha firestore backups schedules delete \ --database='DATABASE_ID' \ --backup-schedule=BACKUP_SCHEDULE_IDแทนที่รายการต่อไปนี้
- DATABASE_ID: รหัสของฐานข้อมูลที่จะสำรองข้อมูล ตั้งค่าเป็น
'(default)'
สำหรับฐานข้อมูลเริ่มต้น - BACKUP_SCHEDULE_ID: รหัสของกำหนดการสำรอง คุณจะดูรหัสของกำหนดการสำรองข้อมูลแต่ละรายการได้เมื่อระบุกำหนดเวลาการสำรองข้อมูลทั้งหมด
Firebase CLI
ใช้คำสั่งfirebase firestore:backups:schedules:delete
firebase firestore:backups:schedules:delete \ BACKUP_SCHEDULEแทนที่รายการต่อไปนี้
- BACKUP_SCHEDULE: ชื่อทรัพยากรแบบเต็มของกำหนดการสำรองข้อมูล คุณจะดูชื่อของกำหนดการสำรองข้อมูลแต่ละรายการได้เมื่อระบุกำหนดเวลาการสำรองข้อมูลทั้งหมด
โปรดทราบว่าการลบกำหนดการสำรองจะไม่ลบข้อมูลสำรองที่กำหนดการนี้สร้างไว้แล้ว คุณอาจรอให้ข้อมูลสำรองหมดอายุหลังจากระยะเวลาเก็บรักษา หรือลบข้อมูลสำรองด้วยตนเองก็ได้ โปรดดูที่ลบข้อมูลสำรอง
จัดการข้อมูลสำรอง
สร้างรายการข้อมูลสำรอง
หากต้องการแสดงรายการข้อมูลสำรองที่มีอยู่ ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
gcloud
ใช้คำสั่งgcloud alpha firestore backups list
gcloud alpha firestore backups list \ --format="table(name, database, state)"แฟล็ก
--format="table(name, database, state)"
จะจัดรูปแบบเอาต์พุตเป็นรูปแบบที่อ่านง่ายขึ้น
หากต้องการแสดงเฉพาะข้อมูลสำรองจากตำแหน่งที่เจาะจง ให้ใช้แฟล็ก --location
ดังนี้
gcloud alpha firestore backups list \ --location=LOCATION \ --format="table(name, database, state)"แทนที่
LOCATION
ด้วยชื่อของตำแหน่ง Cloud Firestore
Firebase CLI
ใช้คำสั่งfirebase firestore:backups:list
ดังนี้
firebase firestore:backups:listหากต้องการแสดงเฉพาะข้อมูลสำรองจากตำแหน่งที่เจาะจง ให้ใช้แฟล็ก
--location
ดังนี้
firebase firestore:backups:list \ --location=LOCATIONแทนที่
LOCATION
ด้วยชื่อตำแหน่ง Cloud Firestore
อธิบายข้อมูลสำรอง
หากต้องการดูรายละเอียดเกี่ยวกับข้อมูลสำรอง ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
gcloud
ใช้คำสั่งgcloud alpha firestore backups describe
gcloud alpha firestore backups describe \ --location=LOCATION \ --backup=BACKUP_IDแทนที่รายการต่อไปนี้
- LOCATION: ตำแหน่งของฐานข้อมูล
- BACKUP_ID: รหัสของข้อมูลสำรอง คุณจะดูรหัสของข้อมูลสำรองแต่ละรายการได้เมื่อแสดงรายการข้อมูลสำรองทั้งหมด
Firebase CLI
ใช้คำสั่งfirebase firestore:backups:get
firebase firestore:backups:get BACKUPแทนที่รายการต่อไปนี้
- BACKUP: ชื่อทรัพยากรแบบเต็มของข้อมูลสำรอง คุณจะดูชื่อของข้อมูลสำรองแต่ละรายการได้เมื่อแสดงรายการข้อมูลสำรองทั้งหมด
ลบข้อมูลสำรอง
gcloud
ใช้คำสั่งgcloud alpha firestore backups delete
gcloud alpha firestore backups delete \ --location=LOCATION \ --backup=BACKUP_IDแทนที่รายการต่อไปนี้
- LOCATION: ตำแหน่งของฐานข้อมูล
- BACKUP_ID: รหัสของข้อมูลสำรอง คุณจะดูรหัสของข้อมูลสำรองแต่ละรายการได้เมื่อแสดงรายการข้อมูลสำรองทั้งหมด
Firebase CLI
ใช้คำสั่งfirebase firestore:backups:delete
firebase firestore:backups:delete \ BACKUPแทนที่รายการต่อไปนี้
- BACKUP: ชื่อทรัพยากรแบบเต็มของข้อมูลสำรอง คุณจะดูชื่อของข้อมูลสำรองแต่ละรายการได้ เมื่อคุณแสดงรายการข้อมูลสำรองทั้งหมด
กู้คืนข้อมูลจากฐานข้อมูลสำรอง
การดำเนินการกู้คืนจะเขียนข้อมูลจากข้อมูลสำรองไปยังฐานข้อมูล Cloud Firestore ใหม่
หากต้องการเริ่มการดำเนินการกู้คืน ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้
gcloud
ใช้คำสั่งgcloud alpha firestore databases restore
gcloud alpha firestore databases restore \ --source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \ --destination-database='DATABASE_ID'แทนที่รายการต่อไปนี้
- PROJECT_ID: รหัสโปรเจ็กต์
- LOCATION: ตำแหน่งของข้อมูลสำรองฐานข้อมูลและตำแหน่งของฐานข้อมูลใหม่ที่สร้างขึ้นสำหรับข้อมูลที่กู้คืน
- BACKUP_ID: รหัสของข้อมูลสำรอง คุณจะดูรหัสของข้อมูลสำรองแต่ละรายการได้เมื่อแสดงรายการข้อมูลสำรองทั้งหมด
- DATABASE_ID: รหัสฐานข้อมูลสำหรับฐานข้อมูลใหม่ คุณจะใช้รหัสฐานข้อมูลที่ใช้งานอยู่แล้วไม่ได้
metadata
, name
และ response
metadata: '@type': type.googleapis.com/google.firestore.admin.v1.RestoreDatabaseMetadata backup: projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID database: projects/PROJECT_ID/databases/DATABASE_ID operationState: PROCESSING progressPercentage: completedWork: '20' estimatedWork: '100' startTime: '2023-12-06T14:20:17.398325Z' name: projects/PROJECT_ID/databases/DATABASE_ID/operations/operation_uuid response: '@type': type.googleapis.com/google.firestore.admin.v1.Database createTime: '2023-12-06T14:20:17.398325Z' name: projects/PROJECT_ID/databases/DATABASE_ID ...ช่อง
metadata
จะมีคอมโพเนนต์ progressPercentage
ซึ่งให้รายละเอียดเกี่ยวกับความคืบหน้าโดยประมาณในการกู้คืนจนถึงขณะนี้ และ operationState
ที่ระบุสถานะโดยรวมของการกู้คืน
หากต้องการดึงข้อมูลนี้อีกครั้ง ให้ใช้ gcloud firestore operations list
:
gcloud firestore operations list --database=DATABASE_IDหรือใช้ช่อง
name
จากเอาต์พุตที่อธิบายไว้ข้างต้น โดยใช้ gcloud firestore operations describe
:
gcloud firestore operations describe OPERATION_NAME
Firebase CLI
ใช้คำสั่งfirebase firestore:databases:restore
firebase firestore:databases:restore \ --backup 'BACKUP' \ --database 'DATABASE_ID'แทนที่รายการต่อไปนี้
- BACKUP: ชื่อทรัพยากรแบบเต็มของข้อมูลสำรอง คุณจะดูชื่อของข้อมูลสำรองแต่ละรายการได้เมื่อแสดงรายการข้อมูลสำรองทั้งหมด
- DATABASE_ID: รหัสฐานข้อมูลสำหรับฐานข้อมูลใหม่ คุณจะใช้รหัสฐานข้อมูลที่ใช้งานอยู่แล้วไม่ได้