Azure Cosmos DB belirli bir noktaya geri yükleme özelliği için kaynak modeli

Makale
08/15/2024

ŞUNLAR IÇIN GEÇERLIDIR: NoSQL MongoDB Gremlin Masa

Bu makalede Azure Cosmos DB belirli bir noktaya geri yükleme özelliği için kaynak modeli açıklanır. Sürekli yedeklemeyi destekleyen parametreleri ve geri yüklenebilen kaynakları açıklar. Bu özellik SQL için Azure Cosmos DB API'sinde, Gremlin için Azure Cosmos DB API'sinde, Tablo API'sinde ve MongoDB için Azure Cosmos DB API'sinde desteklenir.

Veritabanı hesabının kaynak modeli

Veritabanı hesabının kaynak modeli, yeni geri yükleme senaryolarını desteklemek için birkaç ek özellik ile güncelleştirilir. Bu özellikler , CreateModeve RestoreParametersşeklindedirBackupPolicy.

BackupPolicy

parametresinin altında adlı Type hesap düzeyi yedekleme ilkesindeki backuppolicy yeni bir özellik, sürekli yedekleme ve belirli bir noktaya geri yüklemeyi etkinleştirir. Bu mod sürekli yedekleme olarak adlandırılır. Hesabı oluştururken veya bir hesabı düzenli olarak sürekli moda geçirirken bu modu ayarlayabilirsiniz. Sürekli mod etkinleştirildikten sonra, bu hesapta oluşturulan tüm kapsayıcılar ve veritabanlarında varsayılan olarak belirli bir noktaya geri yükleme ve sürekli yedekleme etkinleştirilir. Sürekli yedekleme katmanı veya Continuous30Daysolarak Continuous7Days ayarlanabilir. Varsayılan olarak, katman sağlanmazsa Continuous30Days hesaba uygulanır.

Not

Şu anda belirli bir noktaya geri yükleme özelliği NoSQL için Azure Cosmos DB, MongoDB IÇIN API, Tablo ve Gremlin hesapları için kullanılabilir. Sürekli modda bir hesap oluşturduktan sonra düzenli moda geçemezsiniz. Katman Continuous7Days önizleme aşamasındadır.

CreateMode

Bu özellik, hesabın nasıl oluşturulduğunu gösterir. Olası değerler Varsayılan ve Geri Yükle'dir. Geri yükleme gerçekleştirmek için bu değeri Geri Yükle olarak ayarlayın ve özelliğinde RestoreParameters uygun değerleri sağlayın.

publicNetworkAccess

Hesabı genel ağ erişimi olmadan geri yüklemek için bu özelliğin 'Devre Dışı' olarak ayarlanması gerekir. Bu özellik sağlanmazsa, hesabın geri yüklenmesi publicNetworkAccess olarak Enableddevam eder.

RestoreParameters

Kaynak RestoreParameters , hesap kimliği, geri yükleme zamanı ve geri yüklenmesi gereken kaynaklar dahil olmak üzere geri yükleme işlemi ayrıntılarını içerir.

Özellik Adı	Açıklama
`restoreMode`	Geri yükleme modu olmalıdır `PointInTime`.
`restoreSource`	Geri yüklemenin başlatılacağı kaynak hesabın instanceId değeri.
`restoreTimestampInUtc`	Hesabı geri yüklemek için UTC saatinde belirli bir noktaya gelin.
`databasesToRestore`	Hangi veritabanlarının `DatabaseRestoreResource` ve kapsayıcıların geri yükleneceğini belirten nesnelerin listesi. Her kaynak tek bir veritabanını ve bu veritabanının altındaki tüm koleksiyonları temsil eder. Daha fazla bilgi için bkz . Geri yüklenebilen SQL kaynakları. Bu değer boşsa, hesabın tamamı geri yüklenir.
`gremlinDatabasesToRestore`	Hangi veritabanlarının ve grafiklerin `GremlinDatabaseRestoreResource` geri yükleneceğini belirten nesnelerin listesi. Her kaynak tek bir veritabanını ve bu veritabanının altındaki tüm grafikleri temsil eder. Daha fazla bilgi için bkz . Geri yüklenebilen Gremlin kaynakları. Bu değer boşsa, hesabın tamamı geri yüklenir.
`restoreWithTtlDisabled`	geri yükleme tamamlandıktan sonra geri yüklenen hesapta Yaşam Süresi'ni devre dışı bırakmak için boole bayrağı değerleri (true/false). (önizleme)
`tablesToRestore`	Hangi tabloların `TableRestoreResource` geri yükleneceğini belirten nesnelerin listesi. Her kaynak, bu veritabanının altındaki bir tabloyu temsil eder. Daha fazla bilgi için bkz . Geri yüklenebilen Tablo kaynakları. Bu değer boşsa, hesabın tamamı geri yüklenir.

Örnek kaynak

Aşağıdaki JSON, sürekli yedeklemenin etkinleştirildiği örnek bir veritabanı hesabı kaynağıdır:

{
  "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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "restoreTimestampInUtc": "2020-06-11T22:05:09Z",
      "databasesToRestore": [
        {
          "databaseName": "db1",
          "collectionNames": [
            "collection1",
            "collection2"
          ]
        },
        {
          "databaseName": "db2",
          "collectionNames": [
            "collection3",
            "collection4"
          ]
        }
      ]
    },
    "backupPolicy": {
      "type": "Continuous"
      ...
    }
  }
}

Geri yüklenebilen kaynaklar

Kaynaklar hakkındaki kritik bilgileri keşfetmenize yardımcı olmak için bir dizi yeni kaynak ve API kullanılabilir; bunlar şunlardır:

Kaynakların geri yüklenebileceği yer
Kaynakların geri yüklenebileceği konumlar
Bu kaynaklarda anahtar işlemlerinin gerçekleştirildiği zaman damgaları.

Not

Bu kaynakları listelemek için kullanılan tüm API'ler aşağıdaki izinleri gerektirir:

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

Geri yüklenebilen veritabanı hesabı

Bu kaynak, geri yüklenebilen bir veritabanı hesabı örneği içeriyor. Veritabanı hesabı silinmiş veya canlı bir hesap olabilir. Geri yüklemek istediğiniz kaynak veritabanı hesabını bulmanıza olanak tanıyan bilgiler içerir.

Özellik Adı	Açıklama
`ID`	Kaynağın benzersiz tanımlayıcısı.
`accountName`	Genel veritabanı hesabı adı.
`creationTime`	Hesabın oluşturulduğu veya geçirildiği UTC saati.
`deletionTime`	Hesabın silindiği UTC saati. Hesap canlıysa bu değer boş olur.
`apiType`	Azure Cosmos DB hesabının API türü.
`restorableLocations`	Hesabın bulunduğu konumların listesi.
`restorableLocations: locationName`	Bölgesel hesabın bölge adı.
`restorableLocations: regionalDatabaseAccountInstanceId`	Bölgesel hesabın GUID değeri.
`restorableLocations: creationTime`	Bölgesel hesabın oluşturulduğu UTC saati r geçişi.
`restorableLocations: deletionTime`	Bölgesel hesabın silindiği UTC saati. Bölgesel hesap canlıysa bu değer boş olur.
`OldestRestorableTimeStamp`	Geri yüklemenin gerçekleştirilebileceği en erken UTC saati. 30 günlük katman için bu süre, yedi günlük katman için şu andan itibaren en fazla 30 gün olabilir, bu süre bundan yedi güne kadar sürebilir.

Geri yüklenebilen tüm hesapların listesini almak için, konuma göre Geri Yüklenebilen Veritabanı Hesapları listesi veya Geri Yüklenebilen Veritabanı Hesapları listesi makalelerine bakın.

Geri yüklenebilen SQL veritabanı

Her kaynak, SQL Veritabanı gerçekleşen oluşturma ve silme gibi bir mutasyon olayının bilgilerini içerir. Bu bilgiler, veritabanının yanlışlıkla silindiği senaryolarda ve bu olayın ne zaman gerçekleştiğini bulmanız gerekip gerekmediğini öğrenmenize yardımcı olabilir.

Özellik Adı	Açıklama
`eventTimestamp`	Veritabanının oluşturulduğu veya silindiği UTC saati.
`ownerId`	SQL veritabanının adı.
`ownerResourceId`	SQL veritabanının kaynak kimliği,
`operationType`	Bu veritabanı olayının işlem türü.
`database`	Olay sırasındaKI SQL veritabanının özellikleri,

Not

Için olası değerler operationType şunlardır:

Create: veritabanı oluşturma olayı
Delete: veritabanı silme olayı
Replace: veritabanı değiştirme olayı
SystemOperation: sistem tarafından tetiklenen veritabanı değişikliği olayı. Bu olay kullanıcı tarafından başlatılmaz

Tüm veritabanı mutasyonlarının listesini almak için Restoreable No SQL Veritabanı s - List makalesine bakın.

Geri yüklenebilen SQL kapsayıcısı

Her kaynak, SQL kapsayıcısı üzerinde gerçekleşen oluşturma ve silme gibi bir mutasyon olayının bilgilerini içerir. Bu bilgiler, kapsayıcının değiştirildiği veya silindiği senaryolarda ve olayın ne zaman gerçekleştiğini bulmanız gerektiğinde yardımcı olabilir.

Özellik Adı	Açıklama
`eventTimestamp`	Bu kapsayıcı olayının utc olarak gerçekleştiği saat.
`ownerId`	SQL kapsayıcısının adı.
`ownerResourceId`	SQL kapsayıcısının kaynak kimliği.
`operationType`	Bu kapsayıcı olayının işlem türü.
`container`	Olay sırasında SQL kapsayıcısının özellikleri.

Not

Için olası değerler operationType şunlardır:

Create: kapsayıcı oluşturma olayı
Delete: kapsayıcı silme olayı
Replace: kapsayıcı değiştirme olayı
SystemOperation: sistem tarafından tetiklenen kapsayıcı değişikliği olayı. Bu olay kullanıcı tarafından başlatılmaz

Aynı veritabanı altındaki tüm kapsayıcı mutasyonlarının listesini almak için Geri Yüklenebilen NoSQL Kapsayıcıları - Liste makalesine bakın.

Geri yüklenebilen SQL kaynakları

Her kaynak tek bir veritabanını ve bu veritabanının altındaki tüm kapsayıcıları temsil eder.

Özellik Adı	Açıklama
`databaseName`	SQL veritabanının adı.
`collectionNames`	Bu veritabanı altındaki SQL kapsayıcılarının listesi.

Verilen zaman damgası ve konumda hesapta bulunan SQL veritabanı ve kapsayıcı birleşik girişlerinin listesini almak için, Geri Yüklenebilen NoSQL Kaynakları - Liste makalesine bakın.

Geri yüklenebilen MongoDB veritabanı

Her kaynak, MongoDB Veritabanında gerçekleşen oluşturma ve silme gibi bir mutasyon olayının bilgilerini içerir. Bu bilgiler, veritabanının yanlışlıkla silindiği ve kullanıcının olayın ne zaman gerçekleştiğini bulması gereken senaryoda yardımcı olabilir.

Özellik Adı	Açıklama
`eventTimestamp`	Bu veritabanı olayının utc olarak gerçekleştiği saat.
`ownerId`	MongoDB veritabanının adı.
`ownerResourceId`	MongoDB veritabanının kaynak kimliği.
`operationType`	Bu veritabanı olayının işlem türü.

Not

Için olası değerler operationType şunlardır:

Create: veritabanı oluşturma olayı
Delete: veritabanı silme olayı
Replace: veritabanı değiştirme olayı
SystemOperation: sistem tarafından tetiklenen veritabanı değişikliği olayı. Bu olay kullanıcı tarafından başlatılmaz

Tüm veritabanı mutasyonlarının listesini almak için Geri Yüklenebilen Mongodb Veritabanları - Liste makalesine bakın.

Geri yüklenebilen MongoDB koleksiyonu

Her kaynak, MongoDB Koleksiyonu'nda gerçekleşen oluşturma ve silme gibi bir mutasyon olayının bilgilerini içerir. Bu bilgiler koleksiyonun değiştirildiği veya silindiği senaryolarda yardımcı olabilir ve kullanıcının bu olayın ne zaman gerçekleştiğini bulması gerekir.

Özellik Adı	Açıklama
`eventTimestamp`	Bu koleksiyon olayının gerçekleştiği UTC saati.
`ownerId`	MongoDB koleksiyonunun adı.
`ownerResourceId`	MongoDB koleksiyonunun kaynak kimliği.
`operationType`	Bu koleksiyon olayının işlem türü.

Not

Için olası değerler operationType şunlardır:

Create: koleksiyon oluşturma olayı
Delete: koleksiyon silme olayı
Replace: koleksiyon değişikliği olayı
SystemOperation: sistem tarafından tetiklenen koleksiyon değişikliği olayı. Bu olay kullanıcı tarafından başlatılmaz

Aynı veritabanı altındaki tüm kapsayıcı mutasyonlarının listesini almak için bkz . geri yüklenebilen MongoDB kaynakları - listesi.

Geri yüklenebilen MongoDB kaynakları

Her kaynak tek bir veritabanını ve bu veritabanının altındaki tüm koleksiyonları temsil eder.

Özellik Adı	Açıklama
`databaseName`	MongoDB veritabanının adı.
`collectionNames`	Bu veritabanı altındaki MongoDB koleksiyonlarının listesi.

Verilen zaman damgası ve konumda hesapta bulunan tüm MongoDB veritabanı ve koleksiyon bileşimlerinin listesini almak için bkz . geri yüklenebilen MongoDB kaynakları - listesi.

Geri yüklenebilen Graph kaynakları

Her kaynak tek bir veritabanını ve bu veritabanının altındaki tüm grafikleri temsil eder.

Özellik Adı	Açıklama
`gremlinDatabaseName`	Graph veritabanının adı.
`graphNames`	Bu veritabanının altındaki Graf listesi.

Verilen zaman damgası ve konumda hesapta bulunan tüm Gremlin veritabanı ve graf bileşimlerinin listesini almak için Geri Yüklenebilen Graf Kaynakları - Liste makalesine bakın.

Geri yüklenebilen Graph veritabanı

Her kaynak, Graph veritabanında gerçekleşen oluşturma ve silme gibi bir mutasyon olayı hakkında bilgi içerir. Bu bilgiler, veritabanının yanlışlıkla silindiği ve kullanıcının olayın ne zaman gerçekleştiğini bulması gereken senaryoda yardımcı olabilir.

Özellik Adı	Açıklama
`eventTimestamp`	Bu veritabanı olayının utc olarak gerçekleştiği saat.
`ownerId`	Graph veritabanının adı.
`ownerResourceId`	Graph veritabanının kaynak kimliği.
`operationType`	Bu veritabanı olayının işlem türü.

Not

Için olası değerler operationType şunlardır:

Create: veritabanı oluşturma olayı
Delete: veritabanı silme olayı
Replace: veritabanı değiştirme olayı
SystemOperation: sistem tarafından tetiklenen veritabanı değişikliği olayı. Bu olay kullanıcı tarafından başlatılmaz.

Gremlin veritabanındaki tüm mutasyonların olay akışını almak için bkz . geri yüklenebilen graf veritabanları - listesi.

Geri Yüklenebilen Grafikler

Her kaynak, Graph'te gerçekleşen oluşturma ve silme gibi bir mutasyon olayının bilgilerini içerir. Bu bilgiler, grafiğin değiştirildiği veya silindiği senaryolarda ve bu olayın ne zaman gerçekleştiğini bulmanız gerektiğinde yardımcı olabilir.

Özellik Adı	Açıklama
`eventTimestamp`	Bu koleksiyon olayının gerçekleştiği UTC saati.
`ownerId`	Graph koleksiyonunun adı.
`ownerResourceId`	Graph koleksiyonunun kaynak kimliği.
`operationType`	Bu koleksiyon olayının işlem türü.

Not

Için olası değerler operationType şunlardır:

Create: Graf oluşturma olayı
Delete: Graf silme olayı
Replace: Graf değişikliği olayı
SystemOperation: sistem tarafından tetiklenen koleksiyon değişikliği olayı. Bu olay kullanıcı tarafından başlatılmaz.

Aynı veritabanı altındaki tüm kapsayıcı mutasyonlarının listesini almak için graf Geri Yüklenebilen Grafikler - Liste makalesine bakın.

Geri yüklenebilen Tablo kaynakları

Belirli bir zaman ve konumda belirli bir veritabanı hesabı için kullanılabilen tüm geri yüklenebilen Azure Cosmos DB Tablolarını listeler. Tablo API'sinin açık bir veritabanı belirtmediği unutmayın.

Özellik Adı	Açıklama
`TableNames`	Bu hesabın altındaki Tablo kapsayıcılarının listesi.

Verilen zaman damgası ve konumda hesapta bulunan tabloların listesini almak için, Geri Yüklenebilen Tablo Kaynakları - Liste makalesine bakın.

Geri Yüklenebilen Tablo

Her kaynak, Tablo'da gerçekleşen oluşturma ve silme gibi bir mutasyon olayının bilgilerini içerir. Bu bilgiler, tablonun değiştirildiği veya silindiği senaryolarda ve olayın ne zaman gerçekleştiğini bulmanız gerektiğinde yardımcı olabilir.

Özellik Adı	Açıklama
`eventTimestamp`	Bu veritabanı olayının utc olarak gerçekleştiği saat.
`ownerId`	Tablo veritabanının adı.
`ownerResourceId`	Tablo kaynağının kaynak kimliği.
`operationType`	Bu Tablo olayının işlem türü.

Not

Için olası değerler operationType şunlardır:

Create: Tablo oluşturma olayı
Delete: Tablo silme olayı
Replace: Tablo değiştirme olayı
SystemOperation: sistem tarafından tetiklenen veritabanı değişikliği olayı. Bu olay kullanıcı tarafından başlatılmaz

Aynı veritabanı altındaki tüm tablo mutasyonlarının listesini almak için Geri Yüklenebilen Tablo - Liste makalesine bakın.

Sonraki adımlar

Azure portalı, PowerShell , CLI veya Azure Resource Manager'ı kullanarak sürekli yedekleme sağlayın.
Azure portalı, PowerShell , CLI veya Azure Resource Manager kullanarak hesabı geri yükleyin.
Düzenli yedeklemeden sürekli yedeklemeye bir hesaba geçiş.
Sürekli yedekleme moduyla verileri geri yüklemek için gereken izinleri yönetin.

Aracılığıyla paylaş

Azure Cosmos DB belirli bir noktaya geri yükleme özelliği için kaynak modeli

Veritabanı hesabının kaynak modeli

BackupPolicy

CreateMode

publicNetworkAccess

RestoreParameters

Örnek kaynak

Geri yüklenebilen kaynaklar

Geri yüklenebilen veritabanı hesabı

Geri yüklenebilen SQL veritabanı

Geri yüklenebilen SQL kapsayıcısı

Geri yüklenebilen SQL kaynakları

Geri yüklenebilen MongoDB veritabanı

Geri yüklenebilen MongoDB koleksiyonu

Geri yüklenebilen MongoDB kaynakları

Geri yüklenebilen Graph kaynakları

Geri yüklenebilen Graph veritabanı

Geri Yüklenebilen Grafikler

Geri yüklenebilen Tablo kaynakları

Geri Yüklenebilen Tablo

Sonraki adımlar

Geri Bildirim

Ek kaynaklar