עבודה עם התאוששות בנקודת זמן (PITR)

לְנַחֵם

1. ב-Google Cloud Platform Console, עבור לדף מסדי נתונים .

   עבור אל מסדי נתונים

2. בחר את מסד הנתונים הנדרש מרשימת מסדי הנתונים.

3. בתפריט הניווט, לחץ על התאוששות מאסון .

4. לחץ על ערוך כדי לערוך את ההגדרות.

5. בחר בתיבת הסימון אפשר שחזור נקודת זמן ולאחר מכן לחץ על שמור .

הפעלת PITR תגרור עלויות אחסון. ראה תמחור למידע נוסף.

כדי להשבית את PITR, נקה את תיבת הסימון אפשר שחזור נקודת זמן מדף התאוששות מאסון במסוף GCP.

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 Platform Console, עבור לדף מסדי נתונים .

   עבור אל מסדי נתונים

2. בחר את מסד הנתונים הנדרש מרשימת מסדי הנתונים.

3. בתפריט הניווט, לחץ על התאוששות מאסון .

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

   • תקופת שמירה : התקופה שבה Cloud Firestore שומרת את כל גרסאות הנתונים עבור מסד הנתונים. הערך הוא שעה אחת כאשר PITR מושבת ושבעה ימים כאשר PITR מופעל.
   • זמן הגרסה המוקדמת ביותר : חותמת הזמן המוקדמת ביותר שבה ניתן לקרוא גרסאות ישנות יותר של הנתונים בחלון PITR. ערך זה מתעדכן באופן רציף על ידי Cloud Firestore והופך מיושן ברגע שהוא נשאלת. אם אתה משתמש בערך זה כדי לשחזר נתונים, הקפד לקחת בחשבון את הזמן מהרגע שבו הערך נשאל ועד לרגע שבו אתה מתחיל את השחזור.
   • שחזור נקודת זמן : מציג Enabled , אם PITR מופעל. אם PITR מושבת, תראה Disabled .

gcloud

הפעל את הפקודה של gcloud firestore describe כדלקמן:

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 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 FirestoreIO Apache Beam כדי לקרוא או לכתוב מסמכים במסד נתונים של 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 .