Administración de la retención de las copias de seguridad a largo plazo de Azure SQL Managed Instance

Una suscripción de Azure activa.

Prepare el entorno para la CLI de Azure.

• Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Introducción a Azure Cloud Shell.

  

• Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.

  • Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Autenticación en Azure mediante la CLI de Azure.

  • En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para obtener más información sobre las extensiones, consulte Uso y administración de extensiones con la CLI de Azure.

  • Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Prepare el entorno para PowerShell.

1. En Azure Portal, seleccione la instancia administrada de SQL y, a continuación, seleccione Copias de seguridad. En la pestaña Directivas de retención , seleccione las bases de datos para las que desea establecer o modificar directivas de retención de copia de seguridad a largo plazo. Los cambios no se aplicarán a ninguna base de datos sin seleccionar.

   

2. En el panel Configurar directivas, especifique el período de retención que quiera para las copias de seguridad semanales, mensuales o anuales. Seleccione un período de retención de "0" para indicar que no se debe establecer una retención de copias de seguridad a largo plazo.

   

3. Cuando termine, seleccione Aplicar.

1. Ejecute el comando az sql midb show para obtener los detalles de la base de datos de SQL Managed Instance.

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

2. Ejecute el comando az sql midb ltr-policy set para crear una directiva de LTR. En el ejemplo siguiente se establece una directiva de retención a largo plazo durante 12 semanas para la copia de seguridad semanal.

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

   En este ejemplo se establece una directiva de retención durante 12 semanas para la copia de seguridad semanal, cinco años para la copia de seguridad anual y la semana del 15 de abril en la que se va a realizar la copia de seguridad 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 SQL 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 ver las copias de seguridad a largo plazo disponibles desde Azure Portal, siga estos pasos:

1. En Azure Portal, seleccione la instancia administrada de SQL y, a continuación, seleccione Copias de seguridad. En la pestaña Copias de seguridad disponibles, seleccione la base de datos de la que desea ver las copias de seguridad disponibles. Seleccione Administrar.

   

2. En el panel Administrar copias de seguridad, revise las copias de seguridad disponibles.

   

Para restaurar desde esta página, elija la copia de seguridad y seleccione Restaurar.

Como alternativa, para restaurar una copia de seguridad a partir de la retención a largo plazo mediante Azure Portal, siga estos pasos:

1. Inicie sesión en Azure Portal.

2. Vaya a la instancia de SQL Managed Instance de destino en la que planea restaurar la base de datos.

3. En la página Información general, elija + Nueva base de datos para abrir la página Crear instancia administrada de Azure SQL Database.

   

4. En la pestaña Aspectos básicos de la página Crear instancia administrada de Azure SQL Database, proporcione los detalles de suscripción y grupo de recursos en Detalles del proyecto. A continuación, en Detalles de la base de datos, proporcione el nuevo nombre de la base de datos que planea restaurar. Confirme que la instancia administrada de SQL correcta aparece en la lista desplegable. A continuación, seleccione Siguiente: Origen de >datos .

   

5. En la pestaña Origen de datos, elija Restauración a un momento dado en Usar datos existentes. Proporcione la suscripción, el grupo de recursos y la instancia administrada de SQL que contiene la base de datos de origen. En la lista desplegable Base de datos administrada , elija la base de datos que desea restaurar. A continuación, elija el momento en el que desea restaurar la base de datos. La instancia de origen y de destino puede ser la misma o dos instancias diferentes. Seleccione Siguiente: Configuración >adicional.

   

6. En la pestaña Configuración adicional , puede activar la casilla para heredar la directiva de retención de la base de datos de origen. Como alternativa, puede seleccionar Configurar retención para abrir la página Configurar directivas y establecer las directivas de retención deseadas para la base de datos restaurada. Cuando termine, seleccione Revisar y crear.

   

7. En Revisar y crear, cuando la validación se realice correctamente, seleccione Crear para restaurar la base de datos.

Esta acción inicia el proceso de restauración, que crea una base de datos y la rellena con datos de la base de datos original en el momento especificado. Para más información sobre el tiempo de recuperación, consulte Tiempo de recuperación.

Visualización de directivas de LTR

Ejecute el comando az sql midb ltr-policy show para ver la directiva de LTR de una base de datos única dentro de una instancia.

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

Visualización de copias de seguridad de LTR

Use el comando az sql midb ltr-backup list para ver las copias de seguridad de LTR dentro de una instancia.

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

Restauración desde copias de seguridad de LTR

Ejecute el comando az sql midb ltr-backup restore para restaurar la base de datos a partir de una copia de seguridad de LTR. Puede ejecutar az sql midb ltr-backup show para obtener backup-id.

1. Cree una variable para backup-id con el comando az sql db ltr-backup show para su 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. Restauración de la base de datos a partir de una copia de seguridad de LTR

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

Visualización de directivas de LTR

En este ejemplo se muestra cómo enumerar las directivas de LTR de una instancia para una base de datos única.

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

En este ejemplo se muestra cómo enumerar las directivas de LTR para todas las bases de datos de una instancia.

# 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
 }

Borrado de una directiva LTR

En este ejemplo se muestra cómo borrar una directiva de LTR de una base de datos.

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

Visualización de copias de seguridad de LTR

Este ejemplo muestra cómo enumerar las copias de seguridad de LTR de una instancia.

$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 SQL 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 SQL 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

Restauración desde copias de seguridad de LTR

Este ejemplo muestra cómo restaurar desde una copia de seguridad de LTR. Tenga en cuenta que esta interfaz no cambió, pero el parámetro de identificador de recurso ahora requiere el identificador de recurso de copia de seguridad 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. En Azure Portal, vaya a la instancia administrada de SQL.
2. Seleccione Copias de seguridad. A fin de ver las copias de seguridad de LTR disponibles para una base de datos concreta, seleccione Administrar en la columna Copias de seguridad de LTR disponibles. Aparece un panel con una lista de las copias de seguridad de LTR disponibles para la base de datos seleccionada.
3. En el panel Copias de seguridad de retención a largo plazo disponibles, revise las copias de seguridad disponibles. Seleccionar una copia de seguridad para eliminarla. Seleccione Eliminar.

1. Ejecute az sql midb ltr-backup list para obtener la copia de seguridad name.

2. Ejecute el comando az sql midb ltr-backup delete para quitar una copia de seguridad de LTR.

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

En este ejemplo se muestra cómo eliminar la copia de seguridad de LTR más antigua de la lista de copias de seguridad. En este ejemplo se obtiene la lista de copias de seguridad de LTR para una base de datos específica de la región de Azure en la instancia administrada de SQL indicada.

# 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