Model sumber daya untuk fitur pemulihan titik waktu Azure Cosmos DB

Artikel
03/21/2024

BERLAKU UNTUK: NoSQL MongoDB Gremlin Meja

Artikel ini menjelaskan model sumber daya untuk fitur pemulihan titik waktu Azure Cosmos DB. Ini menjelaskan parameter yang mendukung pencadangan dan sumber daya berkelanjutan yang dapat dipulihkan. Fitur ini didukung di Azure Cosmos DB API untuk SQL, Azure Cosmos DB API untuk Gremlin, Table API, dan API Azure Cosmos DB untuk MongoDB.

Model sumber daya akun database

Model sumber daya akun database diperbarui dengan beberapa properti tambahan untuk mendukung skenario pemulihan baru. Properti tersebut adalah BackupPolicy, CreateMode, dan RestoreParameters.

BackupPolicy

Properti baru dalam kebijakan pencadangan tingkat akun yang dinamai Type berdasarkan backuppolicy parameter memungkinkan pencadangan berkelanjutan dan pemulihan titik-waktu-tertentu. Mode ini disebut sebagai pencadangan berkelanjutan. Anda dapat mengatur mode ini saat membuat akun atau saat memigrasikan akun dari mode periodik ke mode berkelanjutan. Setelah mode berkelanjutan diaktifkan, semua kontainer dan basis data yang dibuat dalam akun ini akan memiliki pemulihan titik-waktu-tertentu dan pencadangan berkelanjutan yang diaktifkan secara default. Tingkat pencadangan berkelanjutan dapat diatur ke Continuous7Days atau Continuous30Days. Secara default, jika tidak ada tingkatan yang disediakan, Continuous30Days diterapkan pada akun.

Catatan

Saat ini fitur pemulihan point-in-time tersedia untuk akun Azure Cosmos DB for NoSQL, API untuk MongoDB, Table, dan Gremlin. Setelah membuat akun dengan mode berkelanjutan, Anda tidak dapat mengubahnya ke mode berkala. Tingkatan Continuous7Days dalam pratinjau.

CreateMode

Properti ini menunjukkan cara akun dibuat. Nilai yang mungkin adalah Default dan Pemulihan. Untuk melakukan pemulihan, atur nilai ini ke Pemulihan dan berikan nilai yang sesuai dalam properti RestoreParameters.

publicNetworkAccess

Properti ini perlu diatur ke 'Dinonaktifkan' untuk memulihkan akun tanpa akses jaringan publik. Jika properti ini tidak disediakan, pemulihan akun akan dilanjutkan dengan publicNetworkAccess sebagai Enabled.

RestoreParameters

Sumber daya RestoreParameters berisi rincian operasi pemulihan termasuk ID akun, waktu untuk memulihkan, dan sumber daya yang perlu dipulihkan.

Nama Properti	Deskripsi
`restoreMode`	Mode pemulihan harus `PointInTime`.
`restoreSource`	InstanceId dari akun sumber tempat pemulihan akan dimulai.
`restoreTimestampInUtc`	Titik waktu di UTC untuk memulihkan akun.
`databasesToRestore`	Daftar objek `DatabaseRestoreResource` untuk menentukan database dan kontainer mana yang harus dipulihkan. Setiap sumber daya mewakili satu database dan semua koleksi di bawah database itu. Untuk informasi selengkapnya, lihat sumber daya SQL yang dapat dipulihkan. Jika nilai ini kosong, maka seluruh akun akan dipulihkan.
`gremlinDatabasesToRestore`	Daftar objek `GremlinDatabaseRestoreResource` untuk menentukan database dan kontainer mana yang harus dipulihkan. Setiap sumber daya mewakili satu database dan semua grafik pada database tersebut. Untuk informasi selengkapnya, lihat sumber daya Gremlin yang dapat dipulihkan. Jika nilai ini kosong, maka seluruh akun akan dipulihkan.
`restoreWithTtlDisabled`	nilai bendera boolean (benar/salah) untuk menonaktifkan Time-To-Live di akun yang dipulihkan setelah menyelesaikan pemulihan. (pratinjau)
`tablesToRestore`	Daftar objek `TableRestoreResource` untuk menentukan tabel mana yang harus dipulihkan. Setiap sumber daya menampilkan tabel di bawah database itu. Untuk informasi selengkapnya, lihat sumber daya Tabel yang dapat dipulihkan. Jika nilai ini kosong, maka seluruh akun akan dipulihkan.

Sampel sumber daya

JSON berikut adalah contoh sumber daya akun database dengan pencadangan berkelanjutan diaktifkan:

{
  "location": "westus",
  "properties": {
    "databaseAccountOfferType": "Standard",
    "locations": [
      {
        "failoverPriority": "0",
        "locationName": "southcentralus",
        "isZoneRedundant": "false"
      }
    ],
    "createMode": "Restore",
    "publicNetworkAccess":"Disabled",
    "restoreParameters": {
      "restoreMode": "PointInTime",
      "restoreWithTtlDisabled" : "true",
      "restoreSource": "/subscriptions/subid/providers/Microsoft.DocumentDB/locations/westus/restorableDatabaseAccounts/1a97b4bb-f6a0-430e-ade1-638d781830cc",
      "restoreTimestampInUtc": "2020-06-11T22:05:09Z",
      "databasesToRestore": [
        {
          "databaseName": "db1",
          "collectionNames": [
            "collection1",
            "collection2"
          ]
        },
        {
          "databaseName": "db2",
          "collectionNames": [
            "collection3",
            "collection4"
          ]
        }
      ]
    },
    "backupPolicy": {
      "type": "Continuous"
      ...
    }
  }
}

Sumber daya yang dapat dipulihkan

Set sumber daya baru dan API telah tersedia untuk membantu Anda menemukan informasi penting tentang sumber daya, mencakup:

Tempat sumber daya dapat dipulihkan
Lokasi tempat sumber daya dapat dipulihkan
Tanda waktu ketika operasi kunci dilakukan pada sumber daya ini.

Catatan

Semua API yang digunakan untuk menghitung sumber daya ini memerlukan izin berikut:

Microsoft.DocumentDB/locations/restorableDatabaseAccounts/*/read
Microsoft.DocumentDB/locations/restorableDatabaseAccounts/read

Akun database yang dapat dipulihkan

Sumber daya ini berisi instans akun database yang dapat dipulihkan. Akun database bisa berupa akun yang dihapus atau akun live. Ini berisi informasi yang memungkinkan Anda menemukan akun database sumber yang ingin Anda pulihkan.

Nama Properti	Deskripsi
`ID`	Pengenal unik sumber daya.
`accountName`	Nama akun database global
`creationTime`	Waktu dalam UTC saat akun dibuat atau dimigrasikan.
`deletionTime`	Waktu di UTC ketika akun dihapus. Nilai ini kosong jika akun live.
`apiType`	Tipe API akun Azure Cosmos DB.
`restorableLocations`	Daftar lokasi tempat akun berada.
`restorableLocations: locationName`	Nama wilayah akun regional.
`restorableLocations: regionalDatabaseAccountInstanceId`	GUID akun regional.
`restorableLocations: creationTime`	Waktu dalam UTC saat akun regional dibuat r dimigrasikan.
`restorableLocations: deletionTime`	Waktu di UTC saat akun regional dihapus. Nilai ini kosong jika akun regional live.
`OldestRestorableTimeStamp`	Waktu paling awal dalam UTC yang pemulihannya dapat dilakukan. Untuk tingkat 30 hari, waktu ini bisa maksimal 30 hari dari sekarang, untuk tingkat tujuh hari, kali ini bisa hingga tujuh hari dari sekarang.

Untuk mendapatkan daftar semua akun yang dapat dipulihkan, lihat artikel Akun Database yang Dapat Dipulihkan - daftar atau Akun Database yang Dapat Dipulihkan- daftar menurut lokasi.

Database SQL yang dapat dipulihkan

Setiap sumber daya berisi informasi peristiwa mutasi seperti pembuatan dan penghapusan yang terjadi di Database SQL. Informasi ini dapat membantu dalam skenario di mana database dihapus secara tidak sengaja dan jika Anda perlu mencari tahu kapan peristiwa itu terjadi.

Nama Properti	Deskripsi
`eventTimestamp`	Waktu di UTC saat database dibuat atau dihapus.
`ownerId`	Nama database SQL.
`ownerResourceId`	ID sumber daya database SQL,
`operationType`	Tipe operasi peristiwa database ini.
`database`	Properti database SQL pada saat peristiwa,

Catatan

Kemungkinan nilai untuk operationType mencakup:

Create: peristiwa pembuatan database
Delete: peristiwa penghapusan database
Replace: peristiwa modifikasi database
SystemOperation: peristiwa modifikasi database yang dipicu oleh sistem. Peristiwa ini tidak dimulai oleh pengguna

Untuk mendapatkan daftar semua mutasi database, lihat artikel Pemulihan Database NoSQL - Daftar .

Kontainer SQL yang Dapat Dipulihkan

Setiap sumber daya berisi informasi peristiwa mutasi seperti pembuatan dan penghapusan yang terjadi di kontainer SQL. Informasi ini dapat membantu dalam skenario di mana kontainer dimodifikasi atau dihapus, dan jika Anda perlu mencari tahu kapan peristiwa itu terjadi.

Nama Properti	Deskripsi
`eventTimestamp`	Waktu di UTC saat peristiwa kontainer ini terjadi.
`ownerId`	Nama kontainer SQL.
`ownerResourceId`	ID sumber daya kontainer SQL.
`operationType`	Tipe operasi peristiwa kontainer ini.
`container`	Properti kontainer SQL pada saat peristiwa.

Catatan

Kemungkinan nilai untuk operationType mencakup:

Create: peristiwa pembuatan kontainer
Delete: peristiwa penghapusan kontainer
Replace: peristiwa modifikasi kontainer
SystemOperation: peristiwa modifikasi kontainer yang dipicu oleh sistem. Peristiwa ini tidak dimulai oleh pengguna

Untuk mendapatkan daftar semua mutasi kontainer di bawah database yang sama, lihat artikel Kontainer NoSQL yang Dapat Disembuhkan - Daftar .

Sumber daya SQL yang dapat dipulihkan

Setiap sumber daya mewakili satu database dan semua kontainer di bawah database itu.

Nama Properti	Deskripsi
`databaseName`	Nama database SQL.
`collectionNames`	Daftar kontainer SQL di bawah database ini.

Untuk mendapatkan daftar database SQL dan kombo kontainer yang ada di akun pada tanda waktu dan lokasi tertentu, lihat artikel Sumber Daya NoSQL yang Dapat Disembuhkan - Daftar .

Database MongoDB yang dapat dipulihkan

Setiap sumber daya berisi informasi peristiwa mutasi seperti pembuatan dan penghapusan yang terjadi pada Database MongoDB. Informasi ini dapat membantu dalam skenario di mana database secara tidak sengaja dihapus dan pengguna perlu mencari tahu kapan peristiwa itu terjadi.

Nama Properti	Deskripsi
`eventTimestamp`	Waktu di UTC saat peristiwa database ini terjadi.
`ownerId`	Nama database MongoDB.
`ownerResourceId`	ID sumber daya database MongoDB.
`operationType`	Tipe operasi peristiwa database ini.

Catatan

Kemungkinan nilai untuk operationType mencakup:

Create: peristiwa pembuatan database
Delete: peristiwa penghapusan database
Replace: peristiwa modifikasi database
SystemOperation: peristiwa modifikasi database yang dipicu oleh sistem. Peristiwa ini tidak dimulai oleh pengguna

Untuk mendapatkan daftar semua mutasi database, lihat artikel Database Mongodb yang Dapat Dipulihkan - Daftar.

Koleksi MongoDB yang dapat dipulihkan

Setiap sumber daya berisi informasi peristiwa mutasi seperti pembuatan dan penghapusan yang terjadi pada Koleksi MongoDB. Informasi ini dapat membantu dalam skenario di mana koleksi dimodifikasi atau dihapus, dan pengguna perlu mencari tahu kapan peristiwa itu terjadi.

Nama Properti	Deskripsi
`eventTimestamp`	Waktu di UTC saat peristiwa koleksi ini terjadi.
`ownerId`	Nama koleksi MongoDB.
`ownerResourceId`	ID sumber daya koleksi MongoDB.
`operationType`	Tipe operasi peristiwa koleksi ini.

Catatan

Kemungkinan nilai untuk operationType mencakup:

Create: peristiwa pembuatan koleksi
Delete: peristiwa penghapusan koleksi
Replace: peristiwa modifikasi koleksi
SystemOperation: peristiwa modifikasi koleksi yang dipicu oleh sistem. Peristiwa ini tidak dimulai oleh pengguna

Untuk mendapatkan daftar semua mutasi kontainer di bawah database yang sama, lihat artikel sumber daya MongoDB yang dapat dipulihkan - daftar.

Sumber daya MongoDB yang dapat dipulihkan

Setiap sumber daya mewakili satu database dan semua koleksi di bawah database itu.

Nama Properti	Deskripsi
`databaseName`	Nama database MongoDB.
`collectionNames`	Daftar koleksi MongoDB di bawah database ini.

Untuk mendapatkan daftar semua kombinasi database dan koleksi MongoDB yang ada di akun pada tanda waktu dan lokasi tertentu, lihat sumber daya MongoDB yang dapat dipulihkan - daftar.

Sumber daya Graph yang dapat dipulihkan

Setiap sumber daya mewakili satu database dan semua grafik pada database tersebut.

Nama Properti	Deskripsi
`gremlinDatabaseName`	Nama database Graph.
`graphNames`	Daftar Graph pada database ini.

Untuk mendapatkan daftar semua kombinasi database dan grafik Gremlin yang ada di akun pada stempel waktu dan lokasi tertentu, lihat artikel Sumber Daya Graph yang Dapat Dipulihkan - Daftar.

Database Graph yang dapat Dipulihkan

Setiap sumber daya berisi informasi peristiwa mutasi, seperti pembuatan dan penghapusan, yang terjadi pada database Graph. Informasi ini dapat membantu dalam skenario di mana database secara tidak sengaja dihapus dan pengguna perlu mencari tahu kapan peristiwa itu terjadi.

Nama Properti	Deskripsi
`eventTimestamp`	Waktu di UTC saat peristiwa database ini terjadi.
`ownerId`	Nama database Graph.
`ownerResourceId`	ID sumber daya database Graph.
`operationType`	Tipe operasi peristiwa database ini.

Catatan

Kemungkinan nilai untuk operationType mencakup:

Create: peristiwa pembuatan database
Delete: peristiwa penghapusan database
Replace: peristiwa modifikasi database
SystemOperation: peristiwa modifikasi database yang dipicu oleh sistem. Kejadian ini tidak dimulai oleh pengguna.

Untuk mendapatkan umpan peristiwa semua mutasi di database Gremlin, lihat database grafik yang dapat dipulihkan - daftar.

Grafik yang Dapat Dipulihkan

Setiap sumber daya berisi informasi peristiwa mutasi seperti pembuatan dan penghapusan yang terjadi di Graph. Informasi ini dapat membantu dalam skenario di mana grafik dimodifikasi atau dihapus, dan jika Anda perlu mencari tahu kapan peristiwa tersebut terjadi.

Nama Properti	Deskripsi
`eventTimestamp`	Waktu di UTC saat peristiwa koleksi ini terjadi.
`ownerId`	Nama koleksi Graph.
`ownerResourceId`	ID sumber daya koleksi Graph.
`operationType`	Tipe operasi peristiwa koleksi ini.

Catatan

Kemungkinan nilai untuk operationType mencakup:

Create: Peristiwa pembuatan Graph
Delete: Peristiwa penghapusan Graph
Replace: Peristiwa modifikasi Graph
SystemOperation: peristiwa modifikasi koleksi yang dipicu oleh sistem. Kejadian ini tidak dimulai oleh pengguna.

Untuk mendapatkan daftar semua mutasi kontainer pada database yang sama, lihat artikel grafik Daftar Graph yang Dapat Dipulihkan - Daftar.

Sumber daya Table yang Dapat Dipulihkan

Mencantumkan semua Table Azure Cosmos DB yang dapat dipulihkan yang tersedia untuk akun database tertentu pada waktu dan lokasi tertentu. Perhatikan BAHWA API untuk Tabel tidak menentukan database eksplisit.

Nama Properti	Deskripsi
`TableNames`	Daftar kontainer Table di bawah akun ini.

Untuk mendapatkan daftar tabel yang ada di akun pada stempel waktu dan lokasi tertentu, lihat artikel Sumber Daya Table yang Dapat Dipulihkan - Daftar.

Table yang Dapat Dipulihkan

Setiap sumber daya berisi informasi peristiwa mutasi seperti pembuatan dan penghapusan yang terjadi di Table. Informasi ini dapat membantu dalam skenario di mana tabel dimodifikasi atau dihapus, dan jika Anda perlu mencari tahu kapan peristiwa tersebut terjadi.

Nama Properti	Deskripsi
`eventTimestamp`	Waktu di UTC saat peristiwa database ini terjadi.
`ownerId`	Nama database Table.
`ownerResourceId`	ID sumber daya dari sumber daya Table.
`operationType`	Jenis operasi peristiwa Table ini.

Catatan

Kemungkinan nilai untuk operationType mencakup:

Create: Peristiwa pembuatan tabel
Delete: Peristiwa penghapusan tabel
Replace: Peristiwa modifikasi tabel
SystemOperation: peristiwa modifikasi database yang dipicu oleh sistem. Peristiwa ini tidak dimulai oleh pengguna

Untuk mendapatkan daftar semua mutasi tabel pada database yang sama, lihat artikel Table yang Dapat Dipulihkan - Daftar.

Langkah berikutnya

Sediakan pencadangan berkelanjutan menggunakan portal Azure, PowerShell, CLI, atau Azure Resource Manager.
Memulihkan akun menggunakan Portal Azure, PowerShell, CLI, atau Azure Resource Manager.
Bermigrasi ke akun dari pencadangan berkala ke cadangan berkelanjutan.
Kelola izin akses yang diperlukan untuk memulihkan data dengan mode cadangan berkelanjutan.

Bagikan melalui

Model sumber daya untuk fitur pemulihan titik waktu Azure Cosmos DB

Model sumber daya akun database

BackupPolicy

CreateMode

publicNetworkAccess

RestoreParameters

Sampel sumber daya

Sumber daya yang dapat dipulihkan

Akun database yang dapat dipulihkan

Database SQL yang dapat dipulihkan

Kontainer SQL yang Dapat Dipulihkan

Sumber daya SQL yang dapat dipulihkan

Database MongoDB yang dapat dipulihkan

Koleksi MongoDB yang dapat dipulihkan

Sumber daya MongoDB yang dapat dipulihkan

Sumber daya Graph yang dapat dipulihkan

Database Graph yang dapat Dipulihkan

Grafik yang Dapat Dipulihkan

Sumber daya Table yang Dapat Dipulihkan

Table yang Dapat Dipulihkan

Langkah berikutnya

Saran dan Komentar

Saran dan Komentar

Sumber Daya Tambahan: