Migrace účtu služby Azure Cosmos DB z režimu pravidelného zálohování do režimu průběžného zálohování

Účty Azure Cosmos DB se zásadami pravidelného zálohování v režimu je možné migrovat do průběžného režimu pomocí webu Azure Portal, Azure CLI, Azure PowerShellu nebo šablon Bicep. Migrace z pravidelného režimu do průběžného režimu je jednosměrná a není nevratná. Po migraci z pravidelného do průběžného režimu získáte výhody průběžného režimu.

Klíčové důvody migrace do průběžného režimu:

• Obnovte data sami pomocí webu Azure Portal, rozhraní příkazového řádku nebo PowerShellu.
• Obnovení na určitou sekundu během posledních 30 dnů nebo 7 dnů.
• Ujistěte se, že zálohy jsou konzistentní napříč horizontálními oddíly nebo rozsahy klíčů oddílů.
• Po odstranění nebo změnách obnovte kontejner, databázi nebo celý účet.
• Vyberte události v kontejneru, databázi nebo účtu a zvolte, kdy se má obnovení spustit.

Poznámka:

Migrace je jednosměrná a nedá se vrátit zpět. Když migrujete z pravidelného režimu do průběžného režimu, nemůžete přepnout zpět.

Účet můžete migrovat do režimu průběžného zálohování jenom v případě, že jsou tyto podmínky pravdivé. Před migrací také zkontrolujte omezení obnovení k určitému bodu v čase :

• Účet je API pro NoSQL, Table, Gremlin nebo MongoDB.
• Účet nikdy neměl pro kontejner zakázaný Azure Synapse Link.

Pokud účet používá klíče spravované zákazníkem, deklarujte spravovanou identitu (přiřazenou systémem nebo přiřazenou uživatelem) v zásadách přístupu ke službě Key Vault a nastavte ji jako výchozí identitu účtu.

Důležité

Po migraci účtu do režimu průběžného zálohování se náklady můžou změnit v porovnání s pravidelným režimem zálohování. Volba mezi 30 dny a sedmi dny také ovlivňuje náklady na zálohování. Podrobnosti najdete v tématu s cenami režimu průběžného zálohování.

Požadavky

• Účet služby Azure Cosmos DB
• Oprávnění Microsoft.DocumentDB/databaseAccounts/write řízení přístupu na základě role pro migrovaný účet
• Nejnovější verze Azure CLI nebo Azure PowerShellu

Migrace pomocí portálu

Pomocí následujících kroků můžete migrovat svůj účet z pravidelného zálohování do režimu průběžného zálohování:

Azure CLI

1. Přihlaste se k Azure CLI.

   az login
   

2. Migrujte účet do continuous30days nebo continuous7days vrstvy.

   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"
   

   Poznámka:

   Pokud nezadáte hodnotu vrstvy, výchozí hodnota je continuous30days.

3. Po úspěšném dokončení migrace výstup zobrazí backupPolicy objekt, který zahrnuje type vlastnost s hodnotou Continuous.

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

Azure Portal

1. Přihlaste se k portálu Azure.

2. Přejděte do svého účtu služby Azure Cosmos DB a otevřete podokno Zálohování a obnovení . Vyberte kartu Zásady zálohování a klikněte na změnit. Jakmile vyberete cílový průběžný režim, vyberte možnost Uložit.

1. Po dokončení migrace se v automaticky otevírané nabídce zobrazí aktualizace nastavení zásad zálohování. Pokud toto oznámení vyberete, může se zobrazit Aktualizace na úrovni účtu a Migrace pro zálohovací zásady v přehledu účtu. Po dokončení migrace se zásada zálohování přepne na zvolenou úroveň průběžného režimu. Doba migrace závisí na velikosti dat ve vašem účtu.

Azure PowerShell

1. Přihlaste se k Azure PowerShellu.

   Connect-AzAccount
   

2. Migrujte svůj účet z periodického na průběžný režim zálohování s úrovní continuous30days nebo dny continuous7days.

   $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
   

   Poznámka:

   Pokud nezadáte hodnotu vrstvy, výchozí hodnota je continuous30days.

Kontrola stavu migrace

Pomocí Azure CLI zkontrolujte stav existující migrace.

Azure CLI

1. Spuštěním následujícího příkazu získejte vlastnosti účtu služby Azure Cosmos DB.

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

2. status Zkontrolujte vlastnosti targetType a vlastnosti objektubackupPolicy. Stav by měl být InProgress po zahájení migrace.

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

3. Po dokončení migrace se typ zálohování změní na Continuous vybranou úroveň a zahrne ji. Pokud není úroveň poskytnuta, bude nastavena na Continuous30Days. Znovu spusťte stejný az cosmosdb show příkaz a zkontrolujte stav.

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

Azure Portal

Není k dispozici

Azure PowerShell

1. Spuštěním následujícího příkazu získejte vlastnosti účtu služby Azure Cosmos DB.

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

2. status Zkontrolujte vlastnosti targetType a vlastnosti objektubackupPolicy. Stav by měl být InProgress po zahájení migrace.

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

3. Po dokončení migrace se typ zálohování změní na Continuous vybranou úroveň a zahrne ji. Pokud není úroveň poskytnuta, bude nastavena na Continuous30Days. Znovu spusťte stejný Get-AzCosmosDBAccount příkaz a zkontrolujte stav.

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

Změna úrovní průběžného režimu

Mezi Azure PowerShellem, Azure CLI nebo webem Azure Portal můžete přepínat Continuous30DaysContinous7Days .

Azure CLI

Následující příkaz Azure CLI znázorňuje přepnutí existujícího účtu na Continous7Days:

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

Azure Portal

Na portálu pro daný účet služby Azure Cosmos DB zvolte Podokno obnovení v konkrétním čase, vyberte odkaz na změnu vedle režimu zásad zálohování a vyberte mezi možnostmi Průběžné (30 dní) nebo Průběžné (7 dní). Zvolte požadovaný cíl a vyberte možnost Uložit.

Azure PowerShell

Následující příkaz Azure PowerShellu znázorňuje přepnutí existujícího účtu na Continous7Days:

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

Šablonu ARM můžete použít také v metodě podobné použití Azure CLI a Azure PowerShellu.

Poznámka:

Když přepnete z 30denní na 7denní úroveň, okamžitě ztratíte možnost obnovit data starší než sedm dní. Když přejdete z 7denní na 30denní úroveň, můžete obnovit pouze data z posledních sedmi dnů, dokud se neshromáždí nové zálohy. Nejnovější dostupnou dobu obnovení můžete zkontrolovat pomocí Azure PowerShellu nebo Azure CLI. Všechny změny cen z přechodových úrovní se projeví okamžitě.

Migrace na průběžné zálohování pomocí Bicep

Pokud chcete migrovat do režimu průběžného zálohování pomocí šablony Bicep a Azure Resource Manageru, vyhledejte část backupPolicy šablony a aktualizujte type vlastnost.

1. Představte si tuto ukázkovou Periodic šablonu, která obsahuje zásady zálohování:

   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. Aktualizujte ukázkovou šablonu tak, aby používala Continuous režim zálohování na 7denní úrovni:

   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. Nasaďte šablonu pomocí Azure PowerShellu nebo rozhraní příkazového řádku. Následující příklad ukazuje, jak nasadit šablonu pomocí příkazu rozhraní příkazového řádku:

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

Související obsah

• Nejčastější dotazy k migraci průběžného zálohování
• Úvod do režimu průběžného zálohování s obnovením k určitému bodu v čase
• Model prostředků režimu průběžného zálohování
• Obnovení účtu ze zálohy