managed_backup.sp_backup_config_basic (Transact-SQL)

S’applique à : OuiSQL Server 2016 (13.x) et ultérieur

Configure les Sauvegarde managée SQL Server sur Microsoft Azure paramètres de base pour une base de données spécifique ou pour une instance de SQL Server .

Notes

Cette procédure peut être appelée seule pour créer une configuration de sauvegarde managée de base. toutefois, si vous envisagez d’ajouter des fonctionnalités avancées ou un calendrier personnalisé, commencez par configurer ces paramètres à l’aide de managed_backup. sp_backup_config_advanced (transact-SQL) et managed_backup. sp_backup_config_schedule (transact-SQL) avant d’activer la sauvegarde managée avec cette procédure.

Icône du lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

EXEC managed_backup.sp_backup_config_basic  
    [@enable_backup = ] { 0 | 1}    ,[@database_name = ] 'database_name'    ,[@container_url = ] 'Azure_Storage_blob_container  
    ,[@retention_days = ] 'retention_period_in_days'    ,[@credential_name = ] 'sql_credential_name'  

Arguments

@enable_backup
Activez ou désactivez la Sauvegarde managée SQL Server sur Microsoft Azure pour la base de données spécifiée. @enable_backupEst un bit. Paramètre requis lors de Sauvegarde managée SQL Server sur Microsoft Azure la configuration de pour la première instance de SQL Server . Si vous modifiez une configuration existante Sauvegarde managée SQL Server sur Microsoft Azure , ce paramètre est facultatif. Dans ce cas, toutes les valeurs de configuration non spécifiées conservent leurs valeurs existantes.

@database_name
Nom de la base de données pour activer la sauvegarde managée sur une base de données spécifique.

@container_url
URL indiquant l’emplacement de la sauvegarde. lorsque @credential_name a la valeur NULL, cette url est une url de signature d’accès partagé (SAS) vers un conteneur d’objets blob dans stockage Azure, et les sauvegardes utilisent la nouvelle sauvegarde pour bloquer les fonctionnalités d’objet blob. Pour plus d’informations, consultez la présentation de la technologieSAP. Lorsque @credential_name est spécifié, il s’agit d’une URL de compte de stockage, et les sauvegardes utilisent la fonctionnalité de sauvegarde déconseillée de l’objet blob de pages.

Notes

Pour l’instant, seule une URL SAS est prise en charge pour ce paramètre.

@retention_days
Période de rétention en jours des fichiers de sauvegarde. @storage_urlEst de type int. Il s’agit d’un paramètre obligatoire quand vous configurez Sauvegarde managée SQL Server sur Microsoft Azure pour la première fois sur l’instance de SQL Server . Lors de la modification de la Sauvegarde managée SQL Server sur Microsoft Azure configuration, ce paramètre est facultatif. S'il n'est pas spécifié, les valeurs de configuration existantes sont retenues.

@credential_name
nom de l’SQL informations d’identification utilisées pour l’authentification auprès du compte de stockage Azure. @credentail_name est de type sysname. Lorsque cette valeur est spécifiée, la sauvegarde est stockée dans un objet blob de pages. Si ce paramètre a la valeur NULL, la sauvegarde est stockée en tant qu’objet blob de blocs. La sauvegarde vers l’objet blob de pages est dépréciée. il est donc préférable d’utiliser la nouvelle fonctionnalité de sauvegarde des objets BLOB de blocs. Lorsqu'il est utilisé pour modifier la configuration de la Sauvegarde managée SQL Server sur Microsoft Azure, ce paramètre est facultatif. S’il n’est pas spécifié, les valeurs de configuration existantes sont conservées.

Avertissement

Le paramètre @ credential_name n’est pas pris en charge pour l’instant. Seule la sauvegarde sur un objet blob de blocs est prise en charge, ce qui requiert la valeur NULL pour ce paramètre.

Valeur du code de retour

0 (réussite) ou 1 (échec)

Sécurité

Autorisations

Requiert l’appartenance au rôle de base de données db_backupoperator , avec les autorisations ALTER ANY CREDENTIAL et Execute sur sp_delete_backuphistory procédure stockée.

Exemples

vous pouvez créer le conteneur de compte de stockage et l’URL SAS à l’aide des commandes Azure PowerShell les plus récentes. L’exemple suivant crée un nouveau conteneur, mycontainer, dans le compte de stockage mystorageaccount, puis obtient une URL SAS pour celui-ci avec des autorisations complètes.

$context = New-AzureStorageContext -StorageAccountName mystorageaccount -StorageAccountKey (Get-AzureStorageKey -StorageAccountName mystorageaccount).Primary  
New-AzureStorageContainer -Name mycontainer -Context $context  
New-AzureStorageContainerSASToken -Name mycontainer -Permission rwdl -FullUri -Context $context  

l’exemple suivant active l' Sauvegarde managée SQL Server sur Microsoft Azure instance de SQL Server sur laquelle il est exécuté, définit la stratégie de rétention sur 30 jours, définit la destination sur un conteneur nommé « mycontainer » dans un compte de stockage nommé « mystorageaccount ».

Use msdb;  
Go  
   EXEC managed_backup.sp_backup_config_basic  
                @enable_backup=1  
                ,@container_url = 'https://mystorageaccount.blob.core.windows.net/mycontainer'  
                ,@retention_days=30;   
GO  
  

L'exemple suivant désactive la Sauvegarde managée SQL Server sur Microsoft Azure pour l'instance de SQL Server sur laquelle elle est exécutée.

Use msdb;  
Go  
EXEC managed_backup.sp_backup_config_basic  
                @enable_backup=0;  
GO  
  

Voir aussi

managed_backup managed_backup.sp_backup_config_advanced (Transact-SQL)
managed_backup.sp_backup_config_schedule (Transact-SQL)