Tài nguyên: Cơ sở dữ liệu
Cơ sở dữ liệu Cloud Firestore.
Biểu diễn JSON |
---|
{ "name": string, "uid": string, "createTime": string, "updateTime": string, "deleteTime": string, "locationId": string, "type": enum ( |
Trường | |
---|---|
name |
Tên tài nguyên của Cơ sở dữ liệu. Định dạng: |
uid |
Chỉ có đầu ra. UUID4 do hệ thống tạo cho Cơ sở dữ liệu này. |
createTime |
Chỉ có đầu ra. Dấu thời gian mà cơ sở dữ liệu này được tạo. Các cơ sở dữ liệu được tạo trước năm 2016 không điền sẵn createTime. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
updateTime |
Chỉ có đầu ra. Dấu thời gian mà cơ sở dữ liệu này được cập nhật gần đây nhất. Lưu ý rằng phương án này chỉ áp dụng cho các bản cập nhật cho tài nguyên cơ sở dữ liệu chứ không bao gồm dữ liệu trong cơ sở dữ liệu. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
deleteTime |
Chỉ có đầu ra. Dấu thời gian mà cơ sở dữ liệu này đã bị xoá. Chỉ thiết lập nếu cơ sở dữ liệu đã bị xoá. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
locationId |
Vị trí của cơ sở dữ liệu. Các địa điểm hiện có được liệt kê tại https://cloud.google.com/firestore/docs/locations. |
type |
Loại cơ sở dữ liệu. Hãy truy cập vào https://cloud.google.com/datastore/docs/firestore-or-datastore để biết thông tin về cách chọn. |
concurrencyMode |
Chế độ kiểm soát đồng thời dùng cho cơ sở dữ liệu này. |
versionRetentionPeriod |
Chỉ có đầu ra. Khoảng thời gian mà các phiên bản dữ liệu trước đây được lưu giữ trong cơ sở dữ liệu. Mọi Nếu bạn bật tính năng PITR, khoảng thời gian lưu giữ là 7 ngày. Nếu không, khoảng thời gian lưu giữ sẽ là 1 giờ. Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng " |
earliestVersionTime |
Chỉ có đầu ra. Dấu thời gian sớm nhất mà tại đó các phiên bản cũ hơn của dữ liệu có thể được đọc từ cơ sở dữ liệu. Hãy xem [versionservingPeriod] ở trên; trường này được điền bằng Giá trị này được cập nhật liên tục và trở nên lỗi thời vào thời điểm 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 điểm từ thời điểm giá trị được truy vấn đến thời điểm bạn bắt đầu quá trình khôi phục. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
pointInTimeRecoveryEnablement |
Liệu có bật tính năng PITR trên cơ sở dữ liệu này hay không. |
appEngineIntegrationMode |
Chế độ tích hợp App Engine để dùng cho cơ sở dữ liệu này. |
keyPrefix |
Chỉ có đầu ra. keyPrefix cho cơ sở dữ liệu này. KeyPrefix này được sử dụng kết hợp với mã dự án (" Giá trị này có thể trống, trong trường hợp đó, appid để sử dụng cho các khoá được mã hoá URL là projectId (ví dụ: foo thay vì v~foo). |
deleteProtectionState |
Trạng thái bảo vệ chống xoá của cơ sở dữ liệu. |
cmekConfig |
Không bắt buộc. Sự hiện diện cho biết rằng CMEK đã được bật cho cơ sở dữ liệu này. |
previousId |
Chỉ có đầu ra. Mã cơ sở dữ liệu trước đây của tài nguyên cơ sở dữ liệu. Trường này chỉ được điền sẵn cho các cơ sở dữ liệu đã bị xoá. |
etag |
Giá trị tổng kiểm này được máy chủ tính toán dựa trên giá trị của các trường khác và có thể được gửi khi có yêu cầu cập nhật và xoá để đảm bảo máy khách có giá trị đã cập nhật trước khi tiếp tục. |
Loại cơ sở dữ liệu
Loại cơ sở dữ liệu. Hãy truy cập vào https://cloud.google.com/datastore/docs/firestore-or-datastore để biết thông tin về cách chọn.
Chỉ cho phép thay đổi chế độ nếu cơ sở dữ liệu trống.
Enum | |
---|---|
DATABASE_TYPE_UNSPECIFIED |
Giá trị mặc định. Giá trị này được dùng nếu loại cơ sở dữ liệu bị bỏ qua. |
FIRESTORE_NATIVE |
Chế độ gốc trên Firestore |
DATASTORE_MODE |
Firestore ở Chế độ Datastore. |
Chế độ đồng thời
Loại chế độ kiểm soát đồng thời cho các giao dịch.
Enum | |
---|---|
CONCURRENCY_MODE_UNSPECIFIED |
Không được sử dụng. |
OPTIMISTIC |
Sử dụng chế độ kiểm soát đồng thời tối ưu theo mặc định. Chế độ này dành cho cơ sở dữ liệu Cloud Firestore. |
PESSIMISTIC |
Sử dụng chế độ kiểm soát đồng thời bi quan theo mặc định. Chế độ này dành cho cơ sở dữ liệu Cloud Firestore. Đây là chế độ cài đặt mặc định cho Cloud Firestore. |
OPTIMISTIC_WITH_ENTITY_GROUPS |
Sử dụng chế độ kiểm soát đồng thời lạc quan với các nhóm thực thể theo mặc định. Đây là chế độ duy nhất hiện có cho Cloud Datastore. Bạn cũng có thể sử dụng chế độ này cho Cloud Firestore ở Chế độ kho dữ liệu nhưng không nên dùng. |
PointInTimeRecoveryEnablement
Bật tính năng Khôi phục thời điểm.
Enum | |
---|---|
POINT_IN_TIME_RECOVERY_ENABLEMENT_UNSPECIFIED |
Không được sử dụng. |
POINT_IN_TIME_RECOVERY_ENABLED |
Hoạt động đọc được hỗ trợ trên những phiên bản dữ liệu đã chọn trong vòng 7 ngày qua:
Bạn có thể sử dụng |
POINT_IN_TIME_RECOVERY_DISABLED |
Hỗ trợ đọc dữ liệu trên mọi phiên bản dữ liệu trong vòng 1 giờ qua. |
AppEngineIntegrationMode
Loại chế độ tích hợp App Engine.
Enum | |
---|---|
APP_ENGINE_INTEGRATION_MODE_UNSPECIFIED |
Không được sử dụng. |
ENABLED |
Nếu một ứng dụng App Engine tồn tại trong cùng khu vực với cơ sở dữ liệu này, thì cấu hình của App Engine sẽ ảnh hưởng đến cơ sở dữ liệu này. Điều này bao gồm việc vô hiệu hoá ứng dụng và cơ sở dữ liệu, cũng như vô hiệu hoá hoạt động ghi vào cơ sở dữ liệu. |
DISABLED |
App Engine không ảnh hưởng đến khả năng phân phát các yêu cầu của cơ sở dữ liệu này. Đây là chế độ cài đặt mặc định cho cơ sở dữ liệu được tạo bằng API Firestore. |
DeleteProtectionState
Trạng thái bảo vệ xoá của cơ sở dữ liệu.
Enum | |
---|---|
DELETE_PROTECTION_STATE_UNSPECIFIED |
Giá trị mặc định. Chưa chỉ định loại bảo vệ |
DELETE_PROTECTION_DISABLED |
Tính năng xoá tính năng bảo vệ đã bị tắt |
DELETE_PROTECTION_ENABLED |
Tính năng xoá bảo vệ đã bật |
Cấu hình Cmek
Cấu hình CMEK (Khoá mã hoá do khách hàng quản lý) cho cơ sở dữ liệu Firestore. Nếu không có, thì cơ sở dữ liệu sẽ được bảo vệ bằng khoá mã hoá mặc định của Google.
Biểu diễn JSON |
---|
{ "kmsKeyName": string, "activeKeyVersion": [ string ] } |
Trường | |
---|---|
kmsKeyName |
Bắt buộc. Bạn chỉ được phép sử dụng các khoá có cùng vị trí với cơ sở dữ liệu này để mã hoá. Đối với vùng đa vùng nam5 của Firestore, thuộc tính này tương ứng với vùng đa vùng Hoa Kỳ của Cloud KMS. Đối với đa vùng eur3 của Firestore, tỷ lệ này tương ứng với Cloud KMS đa vùng châu Âu. Hãy tham khảo tại https://cloud.google.com/km/docs/locations để biết thêm thông tin. Định dạng hợp lệ là |
activeKeyVersion[] |
Chỉ có đầu ra. Các phiên bản khoá KMS đang được sử dụng. Trong quá trình xoay vòng khoá, có thể có nhiều phiên bản khoá đang được sử dụng. Định dạng hợp lệ là |
Phương thức |
|
---|---|
|
Tạo cơ sở dữ liệu. |
|
Xoá cơ sở dữ liệu. |
|
Xuất bản sao của tất cả hoặc một nhóm nhỏ tài liệu từ Google Cloud Firestore sang một hệ thống lưu trữ khác, chẳng hạn như Google Cloud Storage. |
|
Lấy thông tin về cơ sở dữ liệu. |
|
Nhập tài liệu vào Google Cloud Firestore. |
|
Liệt kê tất cả cơ sở dữ liệu trong dự án. |
|
Cập nhật cơ sở dữ liệu. |
|
Tạo cơ sở dữ liệu mới bằng cách khôi phục từ bản sao lưu hiện có. |