کار با بازیابی نقطه در زمان (PITR)

کنسول

1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

   به پایگاه داده ها بروید

2. پایگاه داده مورد نیاز را از لیست پایگاه های داده انتخاب کنید.

3. در منوی پیمایش، روی Disaster Recovery کلیک کنید.

4. برای ویرایش تنظیمات روی Edit کلیک کنید.

5. کادر بررسی فعال کردن بازیابی نقطه در زمان را انتخاب کنید و سپس روی ذخیره کلیک کنید.

فعال کردن PITR هزینه های ذخیره سازی را به همراه خواهد داشت. برای اطلاعات بیشتر به قیمت مراجعه کنید.

برای غیرفعال کردن PITR، کادر بررسی فعال کردن بازیابی نقطه در زمان را از صفحه Disaster Recovery در کنسول Google Cloud پاک کنید.

gcloud

PITR را در حین ایجاد پایگاه داده با دستور gcloud firestore databases create به شرح زیر فعال کنید:

gcloud firestore databases create\
  --location=LOCATION\
  [--database=DATABASE_ID; default="(default)"]\
  [--type=TYPE; default="firestore-native"]\
  --enable-pitr

مقادیر را به صورت زیر جایگزین کنید:

• LOCATION - مکانی که می خواهید پایگاه داده خود را در آن ایجاد کنید.
• DATABASE_ID - روی شناسه پایگاه داده یا (پیش‌فرض) تنظیم کنید.
• TYPE - روی firestore-native تنظیم شده است.

می‌توانید PITR را با استفاده از دستور gcloud firestore databases update به صورت زیر غیرفعال کنید:

gcloud firestore databases update\
  [--database=DATABASE_ID; default="(default)"]\
  --no-enable-pitr

مقادیر را به صورت زیر جایگزین کنید:

• DATABASE_ID - روی شناسه پایگاه داده یا (پیش‌فرض) تنظیم کنید.

کنسول

1. در کنسول Google Cloud، به صفحه پایگاه داده بروید.

   به پایگاه داده ها بروید

2. پایگاه داده مورد نیاز را از لیست پایگاه های داده انتخاب کنید.

3. در منوی پیمایش، روی Disaster Recovery کلیک کنید.

4. در بخش تنظیمات ، دوره نگهداری و زمان اولیه نسخه را یادداشت کنید.

   • دوره نگهداری : دوره ای که در آن Cloud Firestore تمام نسخه های داده ها را برای پایگاه داده حفظ می کند. زمانی که PITR غیرفعال است، مقدار یک ساعت و زمانی که PITR فعال است، هفت روز است.
   • Earliest version time : اولین مهر زمانی که در آن می توان نسخه های قدیمی داده ها را در پنجره PITR خواند. این مقدار به طور مداوم توسط Cloud Firestore به روز می شود و در لحظه ای که پرس و جو می شود بیات می شود. اگر از این مقدار برای بازیابی داده‌ها استفاده می‌کنید، مطمئن شوید که زمان از لحظه درخواست مقدار تا لحظه شروع بازیابی را در نظر بگیرید.
   • بازیابی نقطه در زمان : در صورت فعال بودن PITR، Enabled نشان می دهد. اگر PITR غیرفعال باشد، Disabled مشاهده خواهید کرد.

gcloud

دستور توصیف پایگاه داده gcloud firestore را به صورت زیر اجرا کنید:

gcloud firestore databases describe --database=DATABASE_ID

DATABASE_ID با شناسه پایگاه داده یا '(default)' جایگزین کنید.

در اینجا خروجی است:

    appEngineIntegrationMode: ENABLED
    concurrencyMode: PESSIMISTIC
    createTime: '2021-03-24T17:02:35.234Z'
    deleteProtectionState: DELETE_PROTECTION_DISABLED
    earliestVersionTime: '2023-06-12T16:17:25.222474Z'
    etag: IIDayqOevv8CMNTvyNK4uv8C
    keyPrefix: s
    locationId: nam5
    name: projects/PROJECT_ID/databases/DATABASE_ID
    pointInTimeRecoveryEnablement: POINT_IN_TIME_RECOVERY_DISABLED
    type: FIRESTORE_NATIVE
    uid: 5230c382-dcd2-468f-8cb3-2a1acfde2b32
    updateTime: '2021-11-17T17:48:22.171180Z'
    versionRetentionPeriod: 3600s

کجا،

• earliestVersionTime : مهر زمانی از اولین داده های PITR ذخیره شده.
• pointInTimeRecoveryEnablement : در صورت فعال بودن PITR، POINT_IN_TIME_RECOVERY_ENABLED را نشان می دهد. اگر PITR غیرفعال باشد، یا POINT_IN_TIME_RECOVERY_DISABLED خواهید دید یا ممکن است قسمت pointInTimeRecoveryEnablement نمایش داده نشود.
• versionRetentionPeriod : دوره زمانی که داده‌های PITR در میلی‌ثانیه نگهداری می‌شوند. زمانی که PITR غیرفعال است، مقدار می تواند یک ساعت یا اگر PITR فعال است، هفت روز باشد.

کتابخانه های مشتری

  Firestore firestore = …

  TransactionOptions options =
          TransactionOptions.createReadOnlyOptionsBuilder()
              .setReadTime(
                  com.google.protobuf.Timestamp.newBuilder()
                      .setSeconds(1684098540L)
                      .setNanos(0))
              .build();

  ApiFuture<Void> futureTransaction = firestore.runTransaction(
              transaction -> {
                // Does a snapshot read document lookup
                final DocumentSnapshot documentResult =
                    transaction.get(documentReference).get();

                // Executes a snapshot read query
                final QuerySnapshot queryResult =
                  transaction.get(query).get();
              },
              options);

  // Blocks on transaction to complete
  futureTransaction.get();

  const documentSnapshot = await firestore.runTransaction(
    updateFunction => updateFunction.get(documentRef),
    {readOnly: true, readTime: new Firestore.Timestamp(1684098540, 0)}
);

  const querySnapshot = await firestore.runTransaction(
    updateFunction => updateFunction.get(query),
    {readOnly: true, readTime: new Firestore.Timestamp(1684098540, 0)}
  )

REST API

خواندن‌های PITR در تمام روش‌های خواندن Cloud Firestore پشتیبانی می‌شوند که عبارتند از get , list , batchGet , listCollectionIds , listDocuments , runQuery , runAggregationQuery و partitionQuery .

برای انجام خواندن با استفاده از روش‌های REST، یکی از گزینه‌های زیر را امتحان کنید:

1. در درخواست روش خواندن، مقدار readTime را به عنوان مهر زمانی PITR پشتیبانی شده در روش readOptions ارسال کنید. یک مهر زمانی PITR می‌تواند مهر زمانی دقیق میکروثانیه در یک ساعت گذشته یا یک مهر زمانی کامل دقیقه‌ای بیشتر از ساعت گذشته باشد، اما نه زودتر از earliestVersionTime .

2. از پارامتر readTime همراه با روش BeginTransaction به عنوان بخشی از یک تراکنش ReadOnly برای چندین خواندن PITR استفاده کنید.

پرتو آپاچی

از رابط Cloud Firestore IO Apache Beam برای خواندن یا نوشتن اسناد در پایگاه داده Cloud Firestore در مقیاس بزرگ با Dataflow استفاده کنید.

خواندن‌های PITR در روش خواندن زیر کانکتور Cloud Firestore IO پشتیبانی می‌شوند. این روش‌های خواندن از متد withReadTime(@Nullable Instant readTime) پشتیبانی می‌کنند که می‌توانید برای خواندن PITR استفاده کنید:

• FirestoreV1.BatchGetDocuments
• FirestoreV1.ListCollectionIds
• FirestoreV1.ListDocuments
• FirestoreV1.PartitionQuery

• FirestoreV1.RunQuery

  Instant readTime = Instant.ofEpochSecond(1684098540L);

  PCollection<Document> documents =
      pipeline
          .apply(Create.of(collectionId))
          .apply(
              new FilterDocumentsQuery(
                  firestoreOptions.getProjectId(), firestoreOptions.getDatabaseId()))
          .apply(FirestoreIO.v1().read().runQuery().withReadTime(readTime).withRpcQosOptions(rpcQosOptions).build())
  ...

برای لیست کاملی از نمونه های readTime در خط لوله Dataflow، به مخزن Github مراجعه کنید.