สำรองและกู้คืนข้อมูล

หน้านี้จะอธิบายวิธีใช้ฟีเจอร์การสำรองข้อมูลตามกำหนดการของ 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 ประเภท google_firestore_database ได้ด้วย
  • RETENTION_PERIOD_SECONDS: ตั้งเป็นค่าเป็นวินาที ตามด้วย "s" ค่าสูงสุดคือ 8467200s (14 สัปดาห์)

สร้างกำหนดการสำรองข้อมูลรายสัปดาห์

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 ประเภท google_firestore_database ได้ด้วย
  • RETENTION_PERIOD_SECONDS: ตั้งเป็นค่าเป็นวินาที ตามด้วย "s" ค่าสูงสุดคือ 8467200s (14 สัปดาห์)
  • DAY: วันของสัปดาห์ที่จะทำข้อมูลสำรอง ตั้งค่าเป็น
    • SUNDAY สำหรับวันอาทิตย์
    • MONDAY สำหรับวันจันทร์
    • TUESDAY สำหรับวันอังคาร
    • WEDNESDAY สำหรับวันพุธ
    • THURSDAY สำหรับวันพฤหัสบดี
    • FRIDAY สำหรับวันศุกร์
    • SATURDAY สำหรับวันเสาร์

แสดงรายการกำหนดเวลาการสำรองข้อมูล

หากต้องการแสดงรายการกำหนดการสำรองข้อมูลทั้งหมดสำหรับฐานข้อมูล ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้

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
แทนที่รายการต่อไปนี้

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

จัดการข้อมูลสำรอง

สร้างรายการข้อมูลสำรอง

หากต้องการแสดงรายการข้อมูลสำรองที่มีอยู่ ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้

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
แทนที่รายการต่อไปนี้
Firebase CLI
ใช้คำสั่ง firebase firestore:backups:get
firebase firestore:backups:get BACKUP
แทนที่รายการต่อไปนี้

ลบข้อมูลสำรอง

หากต้องการลบข้อมูลสำรอง ให้ใช้วิธีใดวิธีหนึ่งต่อไปนี้ คำเตือน: คุณไม่สามารถกู้คืนข้อมูลสำรองที่ลบไปแล้ว
gcloud
ใช้คำสั่ง gcloud alpha firestore backups delete
gcloud alpha firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID
แทนที่รายการต่อไปนี้
Firebase CLI
ใช้คำสั่ง firebase firestore:backups:delete
firebase firestore:backups:delete \
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: รหัสฐานข้อมูลสำหรับฐานข้อมูลใหม่ คุณจะใช้รหัสฐานข้อมูลที่ใช้งานอยู่แล้วไม่ได้