Gerenciar a retenção de backup de longo prazo da Instância Gerenciada SQL do Azure

Uma subscrição ativa do Azure.

Prepare seu ambiente para a CLI do Azure.

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Prepare seu ambiente para o PowerShell.

Para Get-AzSqlInstanceDatabaseLongTermRetentionBackup e Restore-AzSqlInstanceDatabase, você precisa ser membro de uma das seguintes funções:

• Função de Proprietário da Subscrição ou
• Função de Colaborador da Instância Gerenciada SQL ou
• Função personalizada com as seguintes permissões:
  • Microsoft.Sql/locations/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionManagedInstanceBackups/read
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/read

Para Remove-AzSqlInstanceDatabaseLongTermRetentionBackupo , você precisa ser membro de uma das seguintes funções:

• Função de Proprietário da Subscrição ou
• Função personalizada com a seguinte permissão:
  • Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/delete

1. No portal do Azure, selecione sua instância gerenciada e, em seguida, selecione Backups. Na guia Políticas de retenção, selecione o(s) banco(s) de dados no qual você deseja definir ou modificar políticas de retenção de backup de longo prazo. As alterações não se aplicarão a nenhum banco de dados deixado desmarcado.

   

2. No painel Configurar políticas, especifique o período de retenção desejado para backups semanais, mensais ou anuais. Escolha um período de retenção de '0' para indicar que nenhuma retenção de backup de longo prazo deve ser definida.

   

3. Quando terminar, selecione Aplicar.

1. Execute o comando az sql midb show para obter os detalhes do banco de dados da Instância Gerenciada SQL.

   az sql midb show /
   --resource-group mygroup /
   --managed-instance myinstance /
   --name mymanageddb /
   --subscription mysubscription
   

2. Execute o comando az sql midb ltr-policy set para criar uma política LTR. O exemplo a seguir define uma política de retenção de longo prazo por 12 semanas para o backup semanal.

   az sql midb ltr-policy set /
   --resource-group mygroup /
   --managed-instance myinstance /
   --name mymanageddb /
   --weekly-retention "P12W"
   

   Este exemplo define uma política de retenção de 12 semanas para o backup semanal, 5 anos para o backup anual e a semana de 15 de abril para fazer o backup LTR anual.

   az sql midb ltr-policy set /
   --resource-group mygroup /
   --managed-instance myinstance /
   --name mymanageddb /
   --weekly-retention "P12W" /
   --yearly-retention "P5Y" /
   --week-of-year 16
   

# get the Managed Instance
$subId = "<subscriptionId>"
$instanceName = "<instanceName>"
$resourceGroup = "<resourceGroupName>"
$dbName = "<databaseName>"

Connect-AzAccount

Select-AzSubscription -SubscriptionId $subId

$instance = Get-AzSqlInstance -Name $instanceName -ResourceGroupName $resourceGroup

# create LTR policy with WeeklyRetention = 12 weeks. MonthlyRetention and YearlyRetention = 0 by default.
$LTRPolicy = @{
    InstanceName = $instanceName 
    DatabaseName = $dbName 
    ResourceGroupName = $resourceGroup 
    WeeklyRetention = 'P12W'
}
Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRPolicy

# create LTR policy with WeeklyRetention = 12 weeks, YearlyRetention = 5 years and WeekOfYear = 16 (week of April 15). MonthlyRetention = 0 by default.
$LTRPolicy = @{
    InstanceName = $instanceName 
    DatabaseName = $dbName 
    ResourceGroupName = $resourceGroup 
    WeeklyRetention = 'P12W' 
    YearlyRetention = 'P5Y' 
    WeekOfYear = '16'
}
Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRPolicy

Para exibir backups de longo prazo disponíveis no portal do Azure, siga estas etapas:

1. No portal do Azure, selecione sua instância gerenciada e, em seguida, selecione Backups. Na guia Backups disponíveis, selecione o banco de dados para o qual você deseja ver os backups disponíveis. Selecione Gerir.

   

2. No painel Gerenciar backups, revise os backups disponíveis.

   

Você também pode restaurar a partir desta página escolhendo o backup e selecionando Restaurar.

Como alternativa, para restaurar um backup da retenção de longo prazo usando o portal do Azure, siga estas etapas:

1. Inicie sessão no portal do Azure.

2. Vá para a Instância Gerenciada SQL de destino para a qual você planeja restaurar seu banco de dados.

3. Na página Visão geral, escolha + Novo banco de dados para abrir a página Criar Banco de Dados Gerenciado SQL do Azure.

   

4. Na guia Noções básicas da página Criar Banco de Dados Gerenciado SQL do Azure, forneça detalhes da assinatura e do grupo de recursos em Detalhes do projeto. Em seguida, em Detalhes do banco de dados, forneça o novo nome do banco de dados que você planeja restaurar. Confirme se a instância gerenciada correta está listada na lista suspensa. Em seguida, selecione Next: Data source >

   

5. Na guia Fonte de dados , escolha Restauração point-in-time em Usar dados existentes. Forneça a assinatura, o grupo de recursos e a instância gerenciada que contém o banco de dados de origem. Na lista suspensa Banco de dados gerenciado, escolha o banco de dados que deseja restaurar e, em seguida, escolha o ponto no tempo a partir do qual deseja restaurar o banco de dados. A instância de origem e de destino pode ser a mesma ou duas instâncias diferentes. Selecione Seguinte : Configurações adicionais >

   

6. Na guia Configurações adicionais, você pode marcar a caixa para herdar a política de retenção do banco de dados de origem ou, alternativamente, selecionar Configurar retenção para abrir a página Configurar políticas e definir as políticas de retenção desejadas para o banco de dados restaurado. Quando terminar, selecione Rever + criar.

   

7. Em Rever + criar, quando a validação for bem-sucedida, selecione Criar para restaurar a base de dados.

Essa ação inicia o processo de restauração, que cria um novo banco de dados e o preenche com dados do banco de dados original no point-in-time especificado. Para obter mais informações sobre o processo de recuperação, consulte Tempo de recuperação.

Ver políticas de LTR

Execute o comando az sql midb ltr-policy show para exibir a política LTR para um único banco de dados em uma instância.

az sql midb ltr-policy show \
    --resource-group mygroup \
    --managed-instance myinstance \
    --name mymanageddb

Ver backups LTR

Use o comando az sql midb ltr-backup list para exibir os backups LTR em uma instância.

az sql midb ltr-backup list \
    --resource-group mygroup \
    --location eastus2 \
    --managed-instance myinstance

Restaurar a partir de backups LTR

Execute o comando az sql midb ltr-backup restore para restaurar seu banco de dados a partir de um backup LTR. Você pode executar az sql midb ltr-backup show para obter o backup-id.

1. Crie uma variável para o backup-id comando with the para az sql db ltr-backup show uso futuro.

    get_backup_id=$(az sql midb ltr-backup show
       --location eastus2 \
       --managed-instance myinstance \
       --database mydb \
       --name "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000" \
       --query 'id' \
       --output tsv)
   

2. Restaure seu banco de dados a partir de um backup LTR

   az sql midb ltr-backup restore \
       --dest-database targetmidb \
       --dest-mi myinstance \
       --dest-resource-group mygroup \
       --backup-id $get_backup_id
   

Ver políticas de LTR

Este exemplo mostra como listar as políticas LTR em uma instância para um único banco de dados.

# gets the current version of LTR policy for a database
$LTRPolicy = @{
    InstanceName = $instanceName 
    DatabaseName = $dbName 
    ResourceGroupName = $resourceGroup
}
Get-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRPolicy 

Este exemplo mostra como listar as políticas LTR para todos os bancos de dados em uma instância.

# gets the current version of LTR policy for all of the databases on an instance

$Databases = Get-AzSqlInstanceDatabase -ResourceGroupName $resourceGroup -InstanceName $instanceName

$LTRParams = @{
    InstanceName = $instanceName
    ResourceGroupName = $resourceGroup
}

foreach($database in $Databases.Name){
    Get-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRParams  -DatabaseName $database
 }

Limpar uma política de LTR

Este exemplo mostra como limpar uma política LTR de um banco de dados.

# remove the LTR policy from a database
$LTRPolicy = @{
    InstanceName = $instanceName 
    DatabaseName = $dbName 
    ResourceGroupName = $resourceGroup 
    RemovePolicy = $true
}
Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRPolicy

Ver backups LTR

Este exemplo mostra como listar os backups LTR em uma instância.

$instance = Get-AzSqlInstance -Name $instanceName -ResourceGroupName $resourceGroup

# get the list of all LTR backups in a specific Azure region
# backups are grouped by the logical database id, within each group they are ordered by the timestamp, the earliest backup first
Get-AzSqlInstanceDatabaseLongTermRetentionBackup -Location $instance.Location

# get the list of LTR backups from the Azure region under the given managed instance
$LTRBackupParam = @{
    Location = $instance.Location 
    InstanceName = $instanceName
}
Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam

# get the LTR backups for a specific database from the Azure region under the given managed instance
$LTRBackupParam = @{
    Location = $instance.Location 
    InstanceName = $instanceName
    DatabaseName = $dbName
}
Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam

# list LTR backups only from live databases (you have option to choose All/Live/Deleted)
$LTRBackupParam = @{
    Location = $instance.Location 
    DatabaseState = 'Live'
}
Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam

# only list the latest LTR backup for each database
$LTRBackupParam = @{
    Location = $instance.Location 
    InstanceName = $instanceName
    OnlyLatestPerDatabase = $true
}
Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam 

Restaurar a partir de backups LTR

Este exemplo mostra como restaurar a partir de um backup LTR. Observe que essa interface não foi alterada, mas o parâmetro resource ID agora requer o ID do recurso de backup LTR.

# restore a specific LTR backup as an P1 database on the instance $instanceName of the resource group $resourceGroup
$LTRBackupParam = @{
    Location = $instance.Location 
    InstanceName = $instanceName
    DatabaseName = $dbname
    OnlyLatestPerDatabase = $true
}
$ltrBackup = Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam 

$RestoreLTRParam = @{
    TargetInstanceName          = $instanceName 
    TargetResourceGroupName     = $resourceGroup 
    TargetInstanceDatabaseName  = $dbName
    FromLongTermRetentionBackup = $true
    ResourceId                  = $ltrBackup.ResourceId 
}
Restore-AzSqlInstanceDatabase @RestoreLTRParam

1. No portal do Azure, navegue até a instância gerenciada do SQL.
2. Selecione Backups. Para exibir os backups LTR disponíveis para um banco de dados específico, selecione Gerenciar na coluna Backups LTR disponíveis. Um painel é exibido com uma lista dos backups LTR disponíveis para o banco de dados selecionado.
3. No painel Backups LTR disponíveis exibido, revise os backups disponíveis. Selecione um backup para excluir. Selecione Eliminar.

1. Execute az sql midb ltr-backup list para obter o backup name.

2. Execute o comando az sql midb ltr-backup delete para remover um backup LTR.

   az sql midb ltr-backup delete \
       --location eastus2 \
       --managed-instance myinstance \
       --database mymanageddb \
       --name "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"
   

Este exemplo mostra como excluir o backup LTR mais antigo da lista de backups. Este exemplo obtém a lista de backups LTR para um banco de dados específico da região do Azure sob a instância gerenciada SQL fornecida.

# remove the earliest backup
# get the LTR backups for a specific database from the Azure region under the given SQL managed instance
$LTRBackupParam = @{
    Location = $instance.Location 
    InstanceName = $instanceName
    DatabaseName = $dbName
}
$ltrBackups = Get-AzSqlInstanceDatabaseLongTermRetentionBackup @LTRBackupParam
$ltrBackup = $ltrBackups[0]
Remove-AzSqlInstanceDatabaseLongTermRetentionBackup -ResourceId $ltrBackup.ResourceId