Làm việc với tính năng khôi phục tại một thời điểm (PITR)

Bảng điều khiển

1. Trong Bảng điều khiển Google Cloud Platform, hãy chuyển đến trang Cơ sở dữ liệu.

   Chuyển đến trang Cơ sở dữ liệu

2. Chọn cơ sở dữ liệu cần thiết trong danh sách cơ sở dữ liệu.

3. Trong trình đơn điều hướng, hãy nhấp vào Khôi phục sau thảm hoạ.

4. Nhấp vào Chỉnh sửa để chỉnh sửa chế độ cài đặt.

5. Chọn hộp kiểm Bật tính năng khôi phục tại thời điểm, sau đó nhấp vào Lưu.

Việc bật PITR sẽ làm phát sinh chi phí lưu trữ. Vui lòng xem phần Giá để biết thêm thông tin.

Để tắt PITR, hãy bỏ đánh dấu hộp Bật tính năng khôi phục tại một thời điểm cụ thể trên trang Khôi phục sau thảm hoạ trong Bảng điều khiển của GCP.

Google Cloud

Bật PITR trong quá trình tạo cơ sở dữ liệu bằng lệnh gcloud firestore databases create như sau:

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

Thay thế các giá trị như sau:

• Location – vị trí bạn muốn tạo cơ sở dữ liệu.
• DATABASE_ID – đặt thành mã nhận dạng cơ sở dữ liệu hoặc (mặc định).
• TYPE – được đặt thành Firestore-native.

Bạn có thể tắt PITR bằng lệnh gcloud firestore databases update như sau:

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

Thay thế các giá trị như sau:

• DATABASE_ID – đặt thành mã nhận dạng cơ sở dữ liệu hoặc (mặc định).

Bảng điều khiển

1. Trong Bảng điều khiển Google Cloud Platform, hãy chuyển đến trang Cơ sở dữ liệu.

   Chuyển đến trang Cơ sở dữ liệu

2. Chọn cơ sở dữ liệu cần thiết trong danh sách cơ sở dữ liệu.

3. Trong trình đơn điều hướng, hãy nhấp vào Khôi phục sau thảm hoạ.

4. Trong phần Cài đặt, hãy lưu ý về Khoảng thời gian lưu giữ và Thời gian phiên bản sớm nhất.

   • Khoảng thời gian lưu giữ: khoảng thời gian mà Cloud Firestore lưu giữ tất cả các phiên bản dữ liệu cho cơ sở dữ liệu. Giá trị là 1 giờ khi PITR bị tắt và 7 ngày khi PITR được bật.
   • Thời gian phiên bản sớm nhất: dấu thời gian sớm nhất mà tại đó các phiên bản cũ của dữ liệu có thể được đọc trong cửa sổ PITR. Giá trị này được Cloud Firestore liên tục cập nhật và sẽ trở thành lỗi thời ngay khi được truy vấn. Nếu bạn đang sử dụng giá trị này để khôi phục dữ liệu, hãy nhớ tính đến thời gian từ thời điểm giá trị được truy vấn đến thời điểm bạn bắt đầu khôi phục.
   • Khôi phục tại một thời điểm: hiển thị Enabled, nếu PITR được bật. Nếu PITR bị tắt, bạn sẽ thấy Disabled.

Google Cloud

Chạy lệnh gcloud Firestore}} mô tả cơ sở dữ liệu như sau:

gcloud firestore databases describe --database=DATABASE_ID

Thay thế DATABASE_ID bằng mã cơ sở dữ liệu hoặc default.

Sau đây là kết quả:

    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

ở đâu,

• earliestVersionTime – dấu thời gian của dữ liệu PITR sớm nhất được lưu trữ.
• pointInTimeRecoveryEnablement: hiển thị POINT_IN_TIME_RECOVERY_ENABLED nếu PITR được bật. Nếu PITR bị tắt, bạn sẽ thấy POINT_IN_TIME_RECOVERY_DISABLED hoặc trường pointInTimeRecoveryEnablement có thể không hiển thị.
• versionRetentionPeriod – khoảng thời gian lưu giữ dữ liệu PITR (tính bằng mili giây). Giá trị có thể là một giờ khi PITR được tắt hoặc bảy ngày nếu PITR được bật.

Thư viện ứng dụng

  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)}
  )

API REST

Việc đọc PITR được hỗ trợ trong tất cả phương thức đọc của Cloud Firestore, đó là get, list, batchGet, listCollectionIds, listDocuments, runQuery, runBottomQuery và partitionQuery.

Để đọc bằng các phương thức REST, hãy thử một trong các phương án sau:

1. Trong yêu cầu về phương thức đọc, hãy chuyển giá trị readTime dưới dạng dấu thời gian PITR được hỗ trợ trong phương thức readOptions. Dấu thời gian PITR có thể là dấu thời gian chính xác một phần triệu giây trong giờ vừa qua hoặc là dấu thời gian cả phút vượt quá giờ vừa qua, nhưng không được sớm hơn earliestVersionTime.

2. Dùng tham số readTime cùng với phương thức BeginTransaction trong giao dịch ReadOnly cho nhiều lần đọc PITR.

Tia Apache

Sử dụng trình kết nối Cloud FirestoreIO Apache Beam để đọc hoặc ghi tài liệu trong cơ sở dữ liệu Cloud Firestore ở quy mô lớn bằng Dataflow.

Số lần đọc PITR được hỗ trợ trong phương thức đọc sau đây của trình kết nối Cloud FirestoreIO. Các phương thức đọc này hỗ trợ phương thức withReadTime(@Nullable Instant readTime) mà bạn có thể dùng cho các lượt đọc 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())
  ...

Để xem danh sách đầy đủ các ví dụ về readTime trong quy trình Dataflow, hãy xem Kho lưu trữ GitHub.