REST Resource: projects.databases

Sumber: Basis Data

Basis Data Cloud Firestore.

Representasi JSON
{
  "name": string,
  "uid": string,
  "createTime": string,
  "updateTime": string,
  "locationId": string,
  "type": enum (DatabaseType),
  "concurrencyMode": enum (ConcurrencyMode),
  "versionRetentionPeriod": string,
  "earliestVersionTime": string,
  "pointInTimeRecoveryEnablement": enum (PointInTimeRecoveryEnablement),
  "appEngineIntegrationMode": enum (AppEngineIntegrationMode),
  "keyPrefix": string,
  "deleteProtectionState": enum (DeleteProtectionState),
  "etag": string
}
Bidang
name

string

Nama sumber daya Database. Format: projects/{project}/databases/{database}

uid

string

Hanya keluaran. UUID4 yang dihasilkan sistem untuk Database ini.

createTime

string ( Timestamp format)

Hanya keluaran. Stempel waktu saat database ini dibuat. Basis data yang dibuat sebelum tahun 2016 tidak mengisi createTime.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z" .

updateTime

string ( Timestamp format)

Hanya keluaran. Stempel waktu saat database ini diperbarui terakhir kali. Perlu diperhatikan bahwa ini hanya mencakup pembaruan pada sumber daya database dan bukan data yang terdapat dalam database.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z" .

locationId

string

Lokasi basis data. Lokasi yang tersedia tercantum di https://cloud.google.com/firestore/docs/locations .

type

enum ( DatabaseType )

Jenis basis data. Lihat https://cloud.google.com/datastore/docs/firestore-or-datastore untuk informasi tentang cara memilih.

concurrencyMode

enum ( ConcurrencyMode )

Mode kontrol konkurensi yang digunakan untuk database ini.

versionRetentionPeriod

string ( Duration format)

Hanya keluaran. Periode di mana versi data sebelumnya disimpan dalam database.

Setiap read atau query dapat menentukan readTime dalam jendela ini, dan akan membaca status database pada saat itu.

Jika fitur PITR diaktifkan, periode retensi adalah 7 hari. Jika tidak, periode retensinya adalah 1 jam.

Durasi dalam detik hingga sembilan digit pecahan, diakhiri dengan ' s '. Contoh: "3.5s" .

earliestVersionTime

string ( Timestamp format)

Hanya keluaran. Stempel waktu paling awal saat versi data yang lebih lama dapat dibaca dari database. Lihat [versionRetentionPeriod] di atas; bidang ini now - versionRetentionPeriod .

Nilai ini terus diperbarui, dan menjadi basi saat ditanyakan. Jika Anda menggunakan nilai ini untuk memulihkan data, pastikan untuk memperhitungkan waktu dari saat nilai tersebut ditanyakan hingga saat Anda memulai pemulihan.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z" .

pointInTimeRecoveryEnablement

enum ( PointInTimeRecoveryEnablement )

Apakah akan mengaktifkan fitur PITR pada database ini.

appEngineIntegrationMode

enum ( AppEngineIntegrationMode )

Mode integrasi App Engine yang akan digunakan untuk database ini.

keyPrefix

string

Hanya keluaran. KeyPrefix untuk database ini. keyPrefix ini digunakan, dikombinasikan dengan id proyek (" ~ ") untuk membuat id aplikasi yang dihasilkan dari Cloud Datastore API di runtime Google App Engine generasi pertama.

Nilai ini mungkin kosong sehingga appid yang akan digunakan untuk kunci yang dikodekan URL adalah projectId (misalnya: foo, bukan v~foo).

deleteProtectionState

enum ( DeleteProtectionState )

Status perlindungan penghapusan untuk database.

etag

string

Checksum ini dihitung oleh server berdasarkan nilai bidang lain, dan dapat dikirim pada permintaan pembaruan dan penghapusan untuk memastikan klien memiliki nilai terkini sebelum melanjutkan.

Tipe Basis Data

Jenis basis data. Lihat https://cloud.google.com/datastore/docs/firestore-or-datastore untuk informasi tentang cara memilih.

Perubahan mode hanya diperbolehkan jika database kosong.

Enum
DATABASE_TYPE_UNSPECIFIED Nilai default. Nilai ini digunakan jika tipe database dihilangkan.
FIRESTORE_NATIVE Mode Asli Firestore
DATASTORE_MODE Firestore dalam Mode Penyimpanan Data.

Mode Konkurensi

Jenis mode kontrol konkurensi untuk transaksi.

Enum
CONCURRENCY_MODE_UNSPECIFIED Tidak digunakan.
OPTIMISTIC Gunakan kontrol konkurensi optimis secara default. Mode ini tersedia untuk database Cloud Firestore.
PESSIMISTIC

Gunakan kontrol konkurensi pesimis secara default. Mode ini tersedia untuk database Cloud Firestore.

Ini adalah pengaturan default untuk Cloud Firestore.

OPTIMISTIC_WITH_ENTITY_GROUPS

Gunakan kontrol konkurensi optimis dengan grup entitas secara default.

Ini adalah satu-satunya mode yang tersedia untuk Cloud Datastore.

Mode ini juga tersedia untuk Cloud Firestore dengan Mode Datastore tetapi tidak disarankan.

Pengaktifan PointInTimeRecovery

Pengaktifan fitur Pemulihan Point In Time.

Enum
POINT_IN_TIME_RECOVERY_ENABLEMENT_UNSPECIFIED Tidak digunakan.
POINT_IN_TIME_RECOVERY_ENABLED

Pembacaan didukung pada versi data tertentu dalam 7 hari terakhir:

  • Membaca berdasarkan stempel waktu apa pun dalam satu jam terakhir
  • Membaca berdasarkan snapshot 1 menit lebih dari 1 jam dan dalam 7 hari

versionRetentionPeriod dan earliestVersionTime dapat digunakan untuk menentukan versi yang didukung.

POINT_IN_TIME_RECOVERY_DISABLED Pembacaan didukung pada versi data apa pun dalam 1 jam terakhir.

Mode Integrasi AppEngine

Jenis mode integrasi App Engine.

Enum
APP_ENGINE_INTEGRATION_MODE_UNSPECIFIED Tidak digunakan.
ENABLED Jika aplikasi App Engine ada di region yang sama dengan database ini, konfigurasi App Engine akan memengaruhi database ini. Ini termasuk menonaktifkan aplikasi & database, serta menonaktifkan penulisan ke database.
DISABLED

App Engine tidak berpengaruh pada kemampuan database ini dalam melayani permintaan.

Ini adalah pengaturan default untuk database yang dibuat dengan Firestore API.

HapusProtectionState

Status perlindungan penghapusan database.

Enum
DELETE_PROTECTION_STATE_UNSPECIFIED Nilai default. Jenis perlindungan penghapusan tidak ditentukan
DELETE_PROTECTION_DISABLED Perlindungan penghapusan dinonaktifkan
DELETE_PROTECTION_ENABLED Perlindungan penghapusan diaktifkan

Metode

create

Buat basis data.

delete

Menghapus database.

exportDocuments

Mengekspor salinan seluruh atau sebagian dokumen dari Google Cloud Firestore ke sistem penyimpanan lain, seperti Google Cloud Storage.

get

Mendapatkan informasi tentang database.

importDocuments

Mengimpor dokumen ke Google Cloud Firestore.

list

Daftar semua database dalam proyek.

patch

Memperbarui database.

restore

Membuat database baru dengan memulihkan dari cadangan yang ada.