גיבוי ושחזור של נתונים

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

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

מידע על גיבויים

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

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

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

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

עלויות

כשמשתמשים בגיבויים, מחויבים על הפעולות הבאות:

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

פרטים נוספים ותעריפים מדויקים מופיעים בדף תמחור.

לפני שמתחילים

כדי להשתמש בתכונה הזו צריך מינוי לתוכנית התמחור Blaze.

התפקידים הנדרשים

כדי לקבל את ההרשאות שנדרשות לניהול גיבויים ולוחות זמנים של גיבויים, צריך לבקש מהאדמין להקצות לכם תפקיד אחד או יותר מהתפקידים הבאים בניהול זהויות וגישה (IAM):

  • roles/datastore.owner: גישה מלאה למסד הנתונים Cloud Firestore
  • ‫roles/datastore.backupsAdmin: גישת קריאה וכתיבה לגיבויים
  • ‫roles/datastore.backupsViewer: גישת קריאה לגיבויים
  • ‫roles/datastore.backupSchedulesAdmin: גישת קריאה וכתיבה ללוחות זמנים של גיבויים
  • roles/datastore.backupSchedulesViewer: גישת קריאה ללוחות זמנים של גיבויים
  • ‫roles/datastore.restoreAdmin: הרשאות להפעלת פעולות שחזור

יצירה וניהול של לוחות זמנים לגיבוי

בדוגמאות הבאות מוסבר איך להגדיר לוח זמנים לגיבוי. לכל מסד נתונים אפשר להגדיר עד לוח זמנים אחד לגיבוי יומי ועד לוח זמנים אחד לגיבוי שבועי. אי אפשר להגדיר כמה לוחות זמנים שבועיים לגיבוי לימים שונים בשבוע.

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

יצירת תזמון לגיבוי

כדי ליצור תזמון לגיבוי, משתמשים באחד מהכלים הבאים.

יצירת לוח זמנים לגיבוי יומי

מסוף Google Cloud

  1. נכנסים לדף Databases במסוף Google Cloud.

    כניסה לדף Databases

  2. ברשימת מסדי הנתונים, מוצאים את השורה של מסד הנתונים. בעמודה גיבויים מתוזמנים, לוחצים על הצגת הגיבויים או על עריכת ההגדרות, בהתאם לשאלה אם קיים לוח זמנים לגיבוי.
  3. לוחצים על עריכה כדי לערוך את ההגדרות של שחזור אחרי אסון.
  4. מסמנים את תיבת הסימון יומי, מגדירים את תקופת השמירה ולוחצים על שמירה.
gcloud
כדי ליצור תזמון לגיבוי של מסד נתונים, משתמשים בפקודה gcloud firestore backups schedules create. כדי ליצור תזמון גיבוי יומי, מגדירים את האפשרות --recurrence ל-daily: 
gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

מחליפים את מה שכתוב בשדות הבאים:

  • ‫DATABASE_ID: המזהה של מסד הנתונים שרוצים לגבות. ההגדרה היא '(default)' עבור מסד הנתונים שמוגדר כברירת מחדל.
  • ‫RETENTION_PERIOD: מגדירים ערך של עד 14 שבועות (14w).
Firebase CLI
כדי ליצור תזמון לגיבוי של מסד נתונים, משתמשים בפקודה firebase firestore:databases:backups:schedules. כדי ליצור תזמון גיבוי יומי, מגדירים את האפשרות --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 שבועות).

יצירת לוח זמנים שבועי לגיבוי

מסוף Google Cloud

  1. נכנסים לדף Databases במסוף Google Cloud.

    כניסה לדף Databases

  2. ברשימת מסדי הנתונים, מוצאים את השורה של מסד הנתונים. בעמודה גיבויים מתוזמנים, לוחצים על הצגת הגיבויים או על עריכת ההגדרות, בהתאם לשאלה אם קיים לוח זמנים לגיבוי.
  3. לוחצים על עריכה כדי לערוך את ההגדרות של שחזור אחרי אסון.
  4. מסמנים את התיבה שבועי, בוחרים יום לגיבוי, מגדירים את תקופת השמירה ולוחצים על שמירה.
gcloud
כדי ליצור לוח זמנים שבועי לגיבוי, מגדירים את הדגל --recurrence לערך weekly: 
gcloud 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 ליום שבת

הצגת רשימה של לוחות זמנים לגיבוי

כדי להציג את כל לוחות הזמנים של הגיבויים של מסד נתונים, משתמשים באחת מהשיטות הבאות:

מסוף Google Cloud

  1. נכנסים לדף Databases במסוף Google Cloud.

    כניסה לדף Databases

  2. ברשימת מסדי הנתונים, מוצאים את השורה של מסד הנתונים. בעמודה גיבויים מתוזמנים, לוחצים על הצגת הגיבויים או על עריכת ההגדרות, בהתאם לשאלה אם קיים לוח זמנים לגיבוי.
  3. ייפתח הדף שחזור אחרי אסון. בדף הזה מתוארים לוחות זמנים לגיבוי ומוצגים הגיבויים הזמינים.
gcloud
משתמשים בפקודה gcloud firestore backups schedules list.
‫
gcloud 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)' למסד הנתונים שמוגדר כברירת מחדל.

תיאור של לוח הזמנים של הגיבוי

כדי לאחזר מידע על לוח זמנים לגיבוי, משתמשים באחת מהשיטות הבאות:

מסוף Google Cloud

  1. נכנסים לדף Databases במסוף Google Cloud.

    כניסה לדף Databases

  2. ברשימת מסדי הנתונים, מוצאים את השורה של מסד הנתונים. בעמודה גיבויים מתוזמנים, לוחצים על הצגת הגיבויים או על עריכת ההגדרות, בהתאם לשאלה אם קיים לוח זמנים לגיבוי.
  3. ייפתח הדף שחזור אחרי אסון. בדף הזה מתוארים לוחות זמנים לגיבוי ומוצגים הגיבויים הזמינים.
gcloud
משתמשים בפקודה gcloud firestore backups schedules describe: 
gcloud firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID
מחליפים את מה שכתוב בשדות הבאים:
  • ‫DATABASE_ID: המזהה של מסד הנתונים שרוצים לגבות. ההגדרה היא '(default)' עבור מסד הנתונים שמוגדר כברירת מחדל.
  • ‫BACKUP_SCHEDULE_ID: המזהה של לוח זמנים לגיבוי. אפשר לראות את המזהה של כל תזמון גיבוי כשמציגים את רשימת כל תזמוני הגיבוי.

עדכון לוח זמנים של גיבוי

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

מסוף Google Cloud

  1. נכנסים לדף Databases במסוף Google Cloud.

    כניסה לדף Databases

  2. ברשימת מסדי הנתונים, מוצאים את השורה של מסד הנתונים. בעמודה גיבויים מתוזמנים לוחצים על הצגת גיבויים או על עריכת ההגדרות.
  3. לוחצים על עריכה כדי לערוך את ההגדרות של שחזור אחרי אסון.
  4. עורכים את ההגדרות של לוח הזמנים לגיבוי ולוחצים על שמירה.
gcloud
משתמשים בפקודה gcloud firestore backups schedules update: 
gcloud 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).

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

מחיקת לוח זמנים לגיבוי

כדי למחוק תזמון גיבוי, משתמשים באחת מהשיטות הבאות:

מסוף Google Cloud

  1. נכנסים לדף Databases במסוף Google Cloud.

    כניסה לדף Databases

  2. ברשימת מסדי הנתונים, מוצאים את השורה של מסד הנתונים. בעמודה גיבויים מתוזמנים, לוחצים על הצגת הגיבויים או על עריכת ההגדרות, בהתאם לשאלה אם קיים לוח זמנים לגיבוי.
  3. לוחצים על עריכה כדי לערוך את ההגדרות של שחזור אחרי אסון.
  4. עורכים את ההגדרות של לוח הזמנים לגיבוי ולוחצים על שמירה.
gcloud
משתמשים בפקודה gcloud firestore backups schedules delete: 
gcloud 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
מחליפים את מה שכתוב בשדות הבאים:

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

ניהול הגיבויים

הצגת רשימת הגיבויים

כדי לראות רשימה של הגיבויים הזמינים, משתמשים באחת מהשיטות הבאות:

מסוף Google Cloud

  1. נכנסים לדף Databases במסוף Google Cloud.

    כניסה לדף Databases

  2. ברשימת מסדי הנתונים, מוצאים את השורה של מסד הנתונים. בעמודה גיבויים מתוזמנים, לוחצים על הצגת הגיבויים או על עריכת ההגדרות, בהתאם לשאלה אם קיים לוח זמנים לגיבוי.
  3. לוחצים על עריכה כדי לערוך את ההגדרות של שחזור אחרי אסון.
  4. עורכים את ההגדרות של לוח הזמנים לגיבוי ולוחצים על שמירה.
gcloud
משתמשים בפקודה gcloud firestore backups list:
‫
gcloud firestore backups list \
--format="table(name, database, state)"
הדגל --format="table(name, database, state)" מעצב את הפלט לפורמט קריא יותר. כדי להציג רק את הגיבויים ממיקום ספציפי, משתמשים בדגל --location:
‫
gcloud 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מיקום.

תיאור של גיבוי

כדי לראות פרטים על גיבוי, משתמשים באחת מהשיטות הבאות:

מסוף Google Cloud

  1. נכנסים לדף Databases במסוף Google Cloud.

    כניסה לדף Databases

  2. ברשימת מסדי הנתונים, מוצאים את השורה של מסד הנתונים. בעמודה גיבויים מתוזמנים, לוחצים על הצגת הגיבויים או על עריכת ההגדרות, בהתאם לשאלה אם קיים לוח זמנים לגיבוי.
  3. ייפתח הדף שחזור אחרי אסון. בדף הזה מתוארים לוחות זמנים לגיבוי ומוצגים הגיבויים הזמינים.
gcloud
משתמשים בפקודה gcloud firestore backups describe: 
gcloud firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID
מחליפים את מה שכתוב בשדות הבאים:
Firebase CLI
משתמשים בפקודה firebase firestore:backups:get: 
firebase firestore:backups:get BACKUP
מחליפים את מה שכתוב בשדות הבאים:

מחיקת הגיבוי

כדי למחוק גיבוי, משתמשים באחת מהשיטות הבאות.

מסוף Google Cloud

  1. נכנסים לדף Databases במסוף Google Cloud.

    כניסה לדף Databases

  2. ברשימת מסדי הנתונים, מוצאים את השורה של מסד הנתונים. בעמודה גיבויים מתוזמנים, לוחצים על הצגת הגיבויים או על עריכת ההגדרות, בהתאם לשאלה אם קיים לוח זמנים לגיבוי. ייפתח הדף שחזור אחרי אסון. בדף הזה מתוארים לוחות זמנים לגיבוי ומוצגים הגיבויים הזמינים.
  3. בטבלה גיבויים, מחפשים את השורה של הגיבוי ובעמודה פעולות, לוחצים על הצגת פרטים נוספים(). לוחצים על מחיקה.
  4. מאשרים את הפעולה באמצעות שדה הטקסט ולוחצים על מחיקה.
gcloud
משתמשים בפקודה gcloud firestore backups delete: 
gcloud firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID
מחליפים את מה שכתוב בשדות הבאים:
Firebase CLI
משתמשים בפקודה firebase firestore:backups:delete: 
firebase firestore:backups:delete \
BACKUP
מחליפים את מה שכתוב בשדות הבאים:

שחזור נתונים מגיבוי של מסד נתונים

פעולת שחזור כותבת את הנתונים מגיבוי לCloud Firestore מסד נתונים חדש.

כדי להתחיל פעולת שחזור, משתמשים באחת מהשיטות הבאות:

מסוף Google Cloud

  1. נכנסים לדף Databases במסוף Google Cloud.

    כניסה לדף Databases

  2. ברשימת מסדי הנתונים, מוצאים את השורה של מסד הנתונים. בעמודה גיבויים מתוזמנים, לוחצים על הצגת הגיבויים או על עריכת ההגדרות, בהתאם לשאלה אם קיים לוח זמנים לגיבוי. ייפתח הדף שחזור אחרי אסון. בדף הזה מתוארים לוחות זמנים לגיבוי ומוצגים הגיבויים הזמינים.
  3. בטבלה Backups (גיבויים), מחפשים את השורה של הגיבוי ובעמודה Actions (פעולות), לוחצים על View more (). לוחצים על Restore with Cloud Shell (שחזור באמצעות Cloud Shell).

  4. החלונית Cloud Shell נפתחת עם הפקודה gcloud CLI לשחזור מהגיבוי שנבחר. מחליפים את ID_OF_NEW_DATABASE במזהה של מסד הנתונים ומריצים את הפקודה.

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

gcloud
משתמשים בפקודה gcloud firestore databases restore: 
gcloud firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID \
--tags=[KEY=VALUE]'
מחליפים את מה שכתוב בשדות הבאים:
  • ‫PROJECT_ID: מזהה הפרויקט.
  • LOCATION: המיקום של הגיבוי של מסד הנתונים והמיקום של מסד הנתונים החדש שנוצר עבור הנתונים המשוחזרים.
  • ‫BACKUP_ID: המזהה של הגיבוי. אפשר לראות את המזהה של כל גיבוי כשמציגים את רשימת כל הגיבויים.
  • ‫DATABASE_ID: מזהה מסד נתונים של מסד הנתונים החדש. אי אפשר להשתמש במזהה מסד נתונים שכבר נמצא בשימוש.
  • ‫[KEY=VALUE]: רשימה אופציונלית של צמדי תגים KEY=VALUE לקשירה. לדוגמה:
    • --tags=123/environment=production,123/costCenter=marketing
    • --tags=tagKeys/333=tagValues/444
הפלט יכלול את הרכיבים 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: מזהה מסד נתונים של מסד הנתונים החדש. אי אפשר להשתמש במזהה מסד נתונים שכבר נמצא בשימוש.