Azure Cosmos DB hesabını düzenli yedekleme modundan sürekli yedekleme moduna geçirme

Düzenli mod yedekleme ilkesine sahip Azure Cosmos DB hesapları Azure portalı, Azure CLI, Azure PowerShell veya Bicep şablonları kullanılarak sürekli moda geçirilebilir. Düzenli moddan sürekli moda geçiş tek yönlüdür ve geri alınamaz. Düzenli moddan sürekli moda geçtikten sonra, sürekli modun avantajlarından yararlanırsınız.

Sürekli moda geçiş için önemli nedenler:

• Azure portalı, CLI veya PowerShell kullanarak verileri kendiniz geri yükleyin.
• Son 30 gün veya 7 günlük süre içinde belirli bir saniyeye geri yükleyin.
• Yedeklerin parçalar veya bölüm anahtarı aralıkları arasında tutarlı olduğundan emin olun.
• Silme veya değişiklik yaptıktan sonra kapsayıcıyı, veritabanını veya tam hesabı geri yükleyin.
• Kapsayıcı, veritabanı veya hesap üzerindeki olayları seçin ve geri yükleme işleminin ne zaman başlatileceğini seçin.

Not

Geçiş tek yönlüdür ve geri alınamaz. Düzenli moddan sürekli moda geçiş yaptıktan sonra geri geçiş yapamazsınız.

Bir hesabı yalnızca bu koşullar doğruysa sürekli yedekleme moduna geçirebilirsiniz. Ayrıca, geçirmeden önce belirli bir noktaya geri yükleme sınırlamalarını denetleyin:

• Hesap NoSQL, Tablo, Gremlin veya MongoDB için API'dir.
• Hesapta hiçbir zaman kapsayıcı için Azure Synapse Link devre dışı bırakılmamış.

Hesap müşteri tarafından yönetilen anahtarlar kullanıyorsa, Key Vault erişim ilkesinde yönetilen bir kimlik (sistem tarafından atanan veya kullanıcı tarafından atanan) bildirin ve bunu hesapta varsayılan kimlik olarak ayarlayın.

Önemli

Hesabınızı sürekli yedekleme moduna geçirdikten sonra, maliyet düzenli yedekleme moduna göre değişebilir. 30 gün ile yedi gün arasındaki seçim yedekleme maliyetini de etkiler. Ayrıntılar için bkz. sürekli yedekleme modu fiyatlandırması.

Önkoşullar

• Azure Cosmos DB hesabı
• Geçirilmekte Microsoft.DocumentDB/databaseAccounts/write olan hesabın rol tabanlı erişim denetimi izni
• Azure CLI veya Azure PowerShell'in en son sürümü

Portalı kullanarak geçiş

Hesabınızı düzenli aralıklarla yedeklemeden sürekli yedekleme moduna geçirmek için aşağıdaki adımları kullanın:

Azure CLI

1. Azure CLI'da oturum açın.

   az login
   

2. Hesabı continuous30days veya continuous7days katmanına geçirin.

   az cosmosdb update \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --backup-policy-type "Continuous"
   

   az cosmosdb update \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
       --backup-policy-type "Continuous" \
       --continuous-tier "Continuous7Days"
   

   Not

   Katman değeri sağlamazsanız varsayılan değer olur continuous30days.

3. Geçiş başarıyla tamamlandıktan sonra, backupPolicy özelliği type değerine sahip olan Continuous nesnesi çıkışta gösterilir.

   {
     ...
     "backupPolicy": {
       "continuousModeProperties": {
         "tier": "Continuous7Days"
       },
       "migrationState": null,
       "type": "Continuous"
     },
     ...
   }
   

Azure portalı

1. Azure Portal’ında oturum açın.

2. Azure Cosmos DB hesabınıza gidin ve Yedekleme ve Geri Yükleme bölmesini açın. Yedekleme İlkeleri sekmesini seçin ve değişiklikte seçeneğini belirleyin. Hedef sürekli modu seçtikten sonra Kaydet'i seçin.

1. Geçiş işlemi devam ederken açılan pencerede Yedekleme ilkesi ayarlarını güncelleştirme gösterilir. Bu bildirimi seçerseniz, hesaba genel bakışta hesap düzeyinde Güncelleştirme ve Yedekleme İçin Geçiş ilkesi görebilirsiniz. Geçiş tamamlandığında yedekleme ilkesi , Sürekli modun seçilen katmanına geçer. Geçiş süresi, hesabınızdaki verilerin boyutuna bağlıdır.

Azure PowerShell

1. Azure PowerShell'de oturum açın.

   Connect-AzAccount
   

2. Hesabınızı continuous30days veya continuous7days gün katmanıyla, düzenli aralıklardan sürekli yedekleme moduna geçirin.

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
       BackupPolicyType = "Continuous"
   }
   Update-AzCosmosDBAccount @parameters
   

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
       BackupPolicyType = "Continuous"
       ContinuousTier = "Continuous7Days"
   }
   Update-AzCosmosDBAccount @parameters
   

   Not

   Katman değeri sağlamazsanız varsayılan değer olur continuous30days.

Geçiş durumunu denetleyin

Mevcut geçişin durumunu denetlemek için Azure CLI'yi kullanın.

Azure CLI

1. Azure Cosmos DB hesabının özelliklerini almak için aşağıdaki komutu çalıştırın.

   az cosmosdb show \
       --resource-group "<resource-group-name>" \
       --name "<account-name>" \
   

2. Nesnenin status ve targetType özelliklerini backupPolicy denetleyin. Durum, geçiş başladıktan sonra olmalıdır InProgress .

   {
     ...
     "backupPolicy": {
       ...
       "migrationState": {
         "status": "InProgress",
         "targetType": "Continuous"
       },
       "type": "Periodic"
     },
     ...
   }
   

3. Geçiş tamamlandığında yedekleme türü olarak değişir Continuous ve seçilen katmanı içerir. Eğer bir katman sağlanmazsa, katman olarak Continuous30Days ayarlanır. Durumu denetlemek için aynı az cosmosdb show komutu yeniden çalıştırın.

   {
     ...
     "backupPolicy": {
       "continuousModeProperties": {
         "tier": "Continuous7Days"
       },
       "migrationState": null,
       "type": "Continuous"
     },
     ...
   }
   

Azure portalı

Mevcut değil

Azure PowerShell

1. Azure Cosmos DB hesabının özelliklerini almak için aşağıdaki komutu çalıştırın.

   $parameters = @{
       ResourceGroupName = "<resource-group-name>"
       Name = "<account-name>"
   }
   Get-AzCosmosDBAccount @parameters
   

2. Nesnenin status ve targetType özelliklerini backupPolicy denetleyin. Durum, geçiş başladıktan sonra olmalıdır InProgress .

   {
     ...
     "backupPolicy": {
       ...
       "migrationState": {
         "status": "InProgress",
         "targetType": "Continuous"
       },
       "type": "Periodic"
     },
     ...
   }
   

3. Geçiş tamamlandığında yedekleme türü olarak değişir Continuous ve seçilen katmanı içerir. Eğer bir katman sağlanmazsa, katman olarak Continuous30Days ayarlanır. Durumu denetlemek için aynı Get-AzCosmosDBAccount komutu yeniden çalıştırın.

   {
     ...
     "backupPolicy": {
       "continuousModeProperties": {
         "tier": "Continuous7Days"
       },
       "migrationState": null,
       "type": "Continuous"
     },
     ...
   }
   

Sürekli Mod katmanlarını değiştirme

Azure PowerShell, Azure CLI veya Azure portalında ve Continous7Days arasında Continuous30Days geçiş yapabilirsiniz.

Azure CLI

Aşağıdaki Azure CLI komutu, mevcut bir hesabın Continous7Days'a dönüştürülmesini gösterir.

az cosmosdb update \
    --resource-group "<resource-group-name>" \
    --name "<account-name>" \
    --backup-policy-type "Continuous" \
    --continuous-tier "Continuous7Days"

Azure portalı

Verilen Azure Cosmos DB hesabının portalında Belirli Bir Noktaya Geri Yükleme bölmesi'ni seçin, Sürekli (30 gün) veya Sürekli (7 gün) seçeneğini göstermek için Yedekleme ilkesi modunun yanındaki değişiklik bağlantısını seçin. Gerekli hedefi seçin ve Kaydet'i seçin.

Azure PowerShell

Aşağıdaki Azure PowerShell komutu, mevcut bir hesabı Continous7Daysolarak değiştirme işlemini gösterir:

$parameters = @{
    ResourceGroupName = "<resource-group-name>"
    Name = "<account-name>"
    BackupPolicyType = "Continuous"
    ContinuousTier = "Continuous7Days"
}
Update-AzCosmosDBAccount @parameters

Arm şablonunu, Azure CLI ve Azure PowerShell kullanımına benzer bir yöntemde de kullanabilirsiniz.

Not

30 günlük katmandan 7 günlük katmana geçtiğinizde, yedi günden eski verileri geri yükleme özelliğini hemen kaybedersiniz. 7 günlük katmandan 30 günlük katmana geçtiğinizde, yeni yedeklemeler birikene kadar yalnızca son yedi gündeki verileri geri yükleyebilirsiniz. Azure PowerShell veya Azure CLI kullanarak en erken kullanılabilir geri yükleme süresini de kontrol edebilirsiniz. Katman değiştirmeden yapılan tüm fiyat değişiklikleri hemen geçerli olur.

Bicep kullanarak sürekli yedeklemeye geçiş

Bicep şablonu ve Azure Resource Manager kullanarak sürekli yedekleme moduna geçmek için şablonunuzun backupPolicy bölümünü bulun ve özelliğini güncelleştirin type .

1. Yedekleme ilkesi olan Periodic bu örnek şablonu göz önünde bulundurun:

   resource azureCosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2025-04-15' = {
     name: '<account-name>'
     properties: {
       // Other required properties omitted for brevity
       backupPolicy: {
         type: 'Periodic'
         periodicModeProperties: {
           backupIntervalInMinutes: 240 // 4 hours
           backupRetentionIntervalInHours: 48 // 2 days
         }
       }
     }
   }
   

2. Örnek şablonu 7 günlük katmanda yedekleme modunu kullanacak Continuous şekilde güncelleştirin:

   resource azureCosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2025-04-15' = {
     name: '<account-name>'
     properties: {
       // Other required properties omitted for brevity
       backupPolicy: {
         type: 'Continuous'
         continuousModeProperties: {
           tier: 'Continuous7Days'
         }
       }
     }
   }
   

3. Şablonu Azure PowerShell veya CLI kullanarak dağıtın. Aşağıdaki örnekte, cli komutuyla şablonun nasıl dağıtılacağı gösterilmektedir:

   az deployment group create \
       --resource-group "<resource-group-name>" \
       --template-file "<template-file-path>"
   

İlgili içerik

• Sürekli yedekleme geçişi hakkında sık sorulan sorular
• Belirli bir noktaya geri yükleme ile sürekli yedekleme moduna giriş.
• Sürekli yedekleme modu kaynak modeli.
• Bir hesabı yedekten geri yükleme