استخدام ميزة الاسترداد في الوقت المناسب (PITR)

وحدة التحكم

1. في وحدة تحكّم Google Cloud Platform، انتقِل إلى صفحة قواعد البيانات.

   الانتقال إلى Databases (قواعد البيانات)

2. حدد قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على التعافي من الكوارث.

4. انقر على تعديل لتعديل الإعدادات.

5. ضع علامة في مربّع الاختيار تفعيل الاسترداد في الوقت المناسب، ثم انقر على حفظ.

سيؤدي تفعيل PITR إلى تحمُّل تكاليف تخزين. اطّلِع على الأسعار لمزيد من المعلومات.

لإيقاف PITR، عليك إزالة العلامة من مربّع الاختيار تفعيل الاسترداد في الوقت المناسب من صفحة "الاسترداد من الكوارث" في "وحدة تحكُّم Google Cloud Platform".

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 - تم ضبطه على أنّه أصلي في متجر النار.

يمكنك إيقاف PITR باستخدام الأمر gcloud firestore databases update على النحو التالي:

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

استبدل القيم كما يلي:

• DATABASE_ID: يتم ضبطها على معرّف قاعدة البيانات أو (الخيار التلقائي).

وحدة التحكم

1. في وحدة تحكّم Google Cloud Platform، انتقِل إلى صفحة قواعد البيانات.

   الانتقال إلى Databases (قواعد البيانات)

2. حدد قاعدة البيانات المطلوبة من قائمة قواعد البيانات.

3. في قائمة التنقّل، انقر على التعافي من الكوارث.

4. في قسم الإعدادات، لاحظ فترة الاحتفاظ بالبيانات والوقت الأقدم للإصدار.

   • فترة الاحتفاظ بالبيانات: الفترة التي تحتفظ فيها Cloud Firestore جميع إصدارات البيانات الخاصة بقاعدة البيانات. القيمة هي ساعة واحدة عندما يكون PITR وسبعة أيام عندما يتم تمكين PITR.
   • أقرب وقت للإصدار: أقدم طابع زمني يتم فيه عرض الإصدارات الأقدم من يمكن قراءة البيانات في نافذة PITR. يتم تعديل هذه القيمة باستمرار. بواسطة Cloud Firestore وتصبح قديمة عند الاستعلام عنها. إذا كنت تستخدم هذه القيمة لاسترداد البيانات، فتأكد من حساب الوقت من اللحظة التي يتم الاستعلام فيها عن القيمة عن اللحظة التي تبدأ فيها الاسترداد.
   • الاسترداد في الوقت المناسب: يعرض هذا المقياس Enabled، في حال كان PITR. مفعّلة. إذا تم إيقاف PITR، سترى Disabled

gcloud

شغِّل الأمر gcloud firestore datas descriptions (وصف قواعد بيانات 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/(default)
    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: يعرض POINT_IN_TIME_RECOVERY_ENABLED، إذا كان PITR. مفعّلة. في حال إيقاف 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

تتوافق قراءات PITR مع كل طرق القراءة في Cloud Firestore، وهي get وlist وbatchGet، listCollectionIds، listDocuments، runQuery وrunAggregationQuery و partitionQuery.

لإجراء قراءة باستخدام طرق REST، جرِّب أحد الخيارات التالية:

1. في طلب طريقة القراءة، اضبط القيمة readTime كطابع زمني PITR متوافق في الطريقة readOptions. يمكن أن يكون الطابع الزمني لـ PITR إما طابعًا زمنيًا للدقة بالميكرو ثانية خلال الساعة الماضية أو طابعًا زمنيًا لدقيقة كاملة بعد الساعة الماضية، ولكن ليس قبل earliestVersionTime.

2. استخدِم المَعلمة readTime مع طريقة BeginTransaction كجزء من معاملة ReadOnly لعدد من عمليات PITR.

شعاع Apache

يمكنك استخدام موصل شعاع Apache في Cloud FirestoreIO لقراءة المستندات أو كتابتها في قاعدة بيانات Cloud Firestore على نطاق واسع باستخدام Dataflow.

تتوافق قراءات PITR مع طريقة القراءة التالية موصِّل Cloud FirestoreIO تدعم طرق القراءة هذه طريقة 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.