Verileri yedekleme ve geri yükleme

Bu sayfada, Cloud Firestore planlı yedekleme özelliğinin nasıl kullanılacağı açıklanmaktadır. Verilerinizi uygulama düzeyinde veri bozulmasına veya yanlışlıkla veri silinmesine karşı korumak için yedeklemeleri kullanın.

Yedekleme, yedekleme programlarını yapılandırarak belirtilen veritabanının günlük veya haftalık yedeklerini almanıza olanak tanır. Ardından, verileri yeni bir veritabanına geri yüklemek için bu yedekleri kullanabilirsiniz.

Yedeklemeler hakkında

Yedek, veritabanının belirli bir zamandaki tutarlı bir kopyasıdır. Yedek, o andaki tüm veri ve dizin yapılandırmalarını içerir. Yedekler, veritabanı geçerlilik süresi politikaları içermez. Yedek, kaynak veritabanıyla aynı konumda bulunur.

Yedeklerin yapılandırılabilir bir saklama süresi vardır ve yedekler, saklama süresi sona erene veya yedeklemeyi silene kadar saklanır. Kaynak veritabanı silindiğinde, ilgili yedeklemeler otomatik olarak silinmez.

Cloud Firestore, bir veritabanıyla ilgili yedekler ve yedek programlarıyla ilgili meta verileri depolar. Cloud Firestore, veritabanının tüm yedeklerinin süresi dolana veya silinene kadar bu meta verileri saklar.

Yedek oluşturmak veya saklamak, canlı veritabanınızdaki okuma veya yazma işlemlerinin performansını etkilemez.

Maliyetler

Yedekleme hizmetlerini kullandığınızda aşağıdakiler için ücret ödersiniz:

• Her bir yedeklemenin kullandığı depolama alanı miktarı.
• Geri yükleme işlemi için yedeğin boyutuna göre ücretlendirilirsiniz.

Daha fazla bilgi ve tam ücretler için Fiyatlandırma sayfasına bakın.

Başlamadan önce

Gerekli roller

Yedeklemeleri ve yedekleme planlarını yönetmek için gereken izinleri almak üzere yöneticinizden aşağıdaki Kimlik ve Erişim Yönetimi rollerinden birini veya daha fazlasını vermelerini isteyin:

• roles/datastore.owner: Cloud Firestore veritabanına tam erişim

• Aşağıdaki roller de kullanılabilir ancak Google Cloud Console'da gösterilmez. Aşağıdaki rolleri atamak için Google Cloud CLI simgesini kullanın:

  • roles/datastore.backupsAdmin: Yedeklere okuma ve yazma erişimi
  • roles/datastore.backupsViewer: Yedeklemelere okuma erişimi
  • roles/datastore.backupSchedulesAdmin: Yedekleme planlarına okuma ve yazma erişimi
  • roles/datastore.backupSchedulesViewer: Yedekleme planlarına okuma erişimi
  • roles/datastore.restoreAdmin: Geri yükleme işlemlerini başlatma izinleri

Yedekleme planları oluşturma ve yönetme

Aşağıdaki örneklerde, yedek programın nasıl oluşturulacağı gösterilmektedir. Her veritabanı için en fazla bir günlük yedekleme programı ve en fazla bir haftalık yedekleme programı yapılandırabilirsiniz. Haftanın farklı günleri için birden fazla haftalık yedekleme programı yapılandıramazsınız.

Yedeklemenin tam saatini yapılandıramazsınız. Yedeklemeler her gün farklı zamanlarda alınır. Haftalık yedekleme planları için yedekleme yapılacak günü yapılandırabilirsiniz.

Yedekleme planı oluştur

Bir veritabanı için yedekleme planı oluşturmak üzere gcloud firestore backups schedules create veya firebase firestore:databases:backups:schedules komutunu kullanın.

Günlük yedekleme programı oluştur

gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=daily \
--retention=RETENTION_PERIOD

firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'DAILY' \
--retention RETENTION_PERIOD

resource "google_firestore_backup_schedule" "daily-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  daily_recurrence {}
}

Haftalık yedekleme programı oluşturma

gcloud firestore backups schedules create \
--database='DATABASE_ID' \
--recurrence=weekly \
--retention=RETENTION_PERIOD \
--day-of-week=DAY

firebase firestore:backups:schedules:create \
--database 'DATABASE_ID' \
--recurrence 'WEEKLY' \
--retention RETENTION_PERIOD
--day-of-week DAY

resource "google_firestore_backup_schedule" "weekly-backup" {
  project  = PROJECT_ID
  database = DATABASE_ID

  retention = RETENTION_PERIOD_SECONDS

  weekly_recurrence {
    day = DAY
  }
}

Yedekleme programlarını listeleyin

Bir veritabanının tüm yedekleme planlarını listelemek için aşağıdaki yöntemlerden birini kullanın:

gcloud firestore backups schedules list \
--database='DATABASE_ID'

firebase firestore:backups:schedules:list \
--database 'DATABASE_ID'

Yedekleme planını açıklama

Yedekleme planıyla ilgili bilgileri almak için aşağıdaki yöntemlerden birini kullanın:

gcloud firestore backups schedules describe \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

Yedekleme planını güncelleme

Yedekleme planının saklama süresini güncellemek için aşağıdaki yöntemlerden birini kullanın:

gcloud firestore backups schedules update \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID \
--retention=RETENTION_PERIOD

firebase firestore:backups:schedules:update \
BACKUP_SCHEDULE \
--retention RETENTION_PERIOD

Bir yedekleme planının saklama süresini güncelleyebilirsiniz ancak yinelenme durumunu güncelleyemezsiniz. Farklı bir yineleme içeren bir yedekleme planına ihtiyacınız varsa artık gerekmeyen eski yedekleme planını silin ve istediğiniz yinelemeyi içeren yeni bir yedekleme planı oluşturun.

Yedekleme programını silme

Yedekleme planını silmek için aşağıdaki yöntemlerden birini kullanın:

gcloud firestore backups schedules delete \
--database='DATABASE_ID' \
--backup-schedule=BACKUP_SCHEDULE_ID

firebase firestore:backups:schedules:delete \
BACKUP_SCHEDULE

Bir yedekleme planını sildiğinizde, bu plan tarafından oluşturulmuş yedeklemelerin silinmediğini unutmayın. Yedeklemenin saklama süresi dolduktan sonra süresinin dolmasını bekleyebilir veya manuel olarak silmek için yedeklemeyi silme bölümüne göz atın.

Yedekleri yönet

Yedekleri listeleme

Mevcut yedeklemeleri listelemek için aşağıdaki yöntemlerden birini kullanın:

gcloud firestore backups list \
--format="table(name, database, state)"

gcloud firestore backups list \
--location=LOCATION \
--format="table(name, database, state)"

firebase firestore:backups:list

firebase firestore:backups:list \
--location=LOCATION

Yedeklemeyi açıklayın

Bir yedeklemeyle ilgili ayrıntıları görüntülemek için aşağıdaki yöntemlerden birini kullanın:

gcloud firestore backups describe \
--location=LOCATION \
--backup=BACKUP_ID

firebase firestore:backups:get BACKUP

Yedeği sil

gcloud firestore backups delete \
--location=LOCATION \
--backup=BACKUP_ID

firebase firestore:backups:delete \
BACKUP

Veritabanı yedeğinden veri geri yükleme

Geri yükleme işlemi, verileri yedekten yeni bir Cloud Firestore veritabanına yazar.

Geri yükleme işlemini başlatmak için aşağıdaki yöntemlerden birini kullanın:

gcloud firestore databases restore \
--source-backup=projects/PROJECT_ID/locations/LOCATION/backups/BACKUP_ID \
--destination-database='DATABASE_ID'

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
  ...

gcloud firestore operations list --database=DATABASE_ID

gcloud firestore operations describe OPERATION_NAME

firebase firestore:databases:restore \
--backup 'BACKUP' \
--database 'DATABASE_ID'