managed_backup.sp_backup_config_basic (Transact-SQL)
S’applique à : 
SQL Server 2016 (13.x) et versions ultérieures
Configure la sauvegarde managée SQL Server sur les paramètres de base de Microsoft Azure pour une base de données spécifique ou pour une instance de SQL Server.
Remarque
Cette procédure peut être appelée par elle-même pour créer une configuration de sauvegarde managée de base. Toutefois, si vous envisagez d’ajouter des fonctionnalités avancées ou une planification personnalisée, configurez ces paramètres à l’aide de managed_backup.sp_backup_config_advanced et managed_backup.sp_backup_config_schedule, avant d’activer la sauvegarde managée avec cette procédure.
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 = ] { 0 | 1 }
Activez ou désactivez la sauvegarde managée SQL Server sur Microsoft Azure pour la base de données spécifiée. @enable_backup est bit.
Paramètre obligatoire lors de la configuration de la sauvegarde managée SQL Server sur Microsoft Azure pour la première instance de SQL Server. Si vous modifiez une sauvegarde managée SQL Server existante en configuration Microsoft Azure, ce paramètre est facultatif. Dans ce cas, toutes les valeurs de configuration non spécifiées conservent leurs valeurs existantes.
Pour plus d’informations, consultez Activer la sauvegarde managée SQL Server sur Azure.
[ @database_name = ] 'database_name'
Nom de la base de données pour l’activation de la sauvegarde managée sur une base de données spécifique.
Si @database_name est défini NULLsur , les paramètres sont au niveau de l’instance (s’applique à toutes les nouvelles bases de données créées sur l’instance).
[ @container_url = ] 'Azure_Storage_blob_container'
URL qui indique l’emplacement de la sauvegarde. Lorsque @credential_name est NULL, cette URL est une URL de signature d’accès partagé (SAP) 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 Accorder un accès limité aux ressources Stockage Azure à l’aide de signatures d’accès partagé (SAP). Lorsque @credential_name est spécifié, il s’agit d’une URL de compte de stockage et les sauvegardes utilisent la sauvegarde déconseillée dans les fonctionnalités d’objet blob de pages.
Si l’URL SAS contient le jeton SAS inclus, vous devez la séparer du jeton SAS au niveau du point d’interrogation et n’inclure pas le point d’interrogation.
Par exemple, https://managedbackupstorage.blob.core.windows.net/backupcontainer?sv=2014-02-14&sr=c&sig=xM2LXVo1Erqp7LxQ%9BxqK9QC6%5Qabcd%9LKjHGnnmQWEsDf%5Q%se=2015-05-14T14%3B93%4V20X&sp=rwdl les deux valeurs suivantes sont les suivantes :
| Type | Sortie |
|---|---|
| URL du conteneur | https://managedbackupstorage.blob.core.windows.net/backupcontainer |
| Jeton SAP | sv=2014-02-14&sr=c&sig=xM2LXVo1Erqp7LxQ%9BxqK9QC6%5Qabcd%9LKjHGnnmQWEsDf%5Q%se=2015-05-14T14%3B93%4V20X&sp=rwdl |
Remarque
Seule une URL SAP est prise en charge pour ce paramètre pour l’instant.
[ @retention_days = ] retention_period_in_days
Période de rétention en jours des fichiers de sauvegarde. @retention_days est int. Il s’agit d’un paramètre obligatoire lors de la configuration de la sauvegarde managée SQL Server sur Microsoft Azure pour la première fois sur l’instance de SQL Server. Lorsque vous modifiez la sauvegarde managée SQL Server en configuration Microsoft Azure, ce paramètre est facultatif. S'il n'est pas spécifié, les valeurs de configuration existantes sont retenues.
[ @credential_name = ] 'sql_credential_name'
Nom des informations d’identification SQL utilisées pour s’authentifier auprès du compte de stockage Azure. @credential_name est sysname. Quand elle est spécifiée, la sauvegarde est stockée dans un objet blob de pages. Si ce paramètre est NULLle cas, la sauvegarde est stockée en tant qu’objet blob de blocs. La sauvegarde sur un objet blob de pages est déconseillée. Il est donc préférable d’utiliser la nouvelle fonctionnalité de sauvegarde d’objets blob de blocs. Lorsqu’il est utilisé pour modifier la sauvegarde managée SQL Server en configuration Microsoft Azure, ce paramètre est facultatif. Si ce 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 dans l’objet blob de blocs est prise en charge, ce qui nécessite que ce paramètre soit NULL.
Valeurs des codes de retour
0 (réussite) or 1 (échec).
autorisations
Nécessite l’appartenance au rôle de base de données db_backupoperator , avec les autorisations ALTER ANY CREDENTIAL et les autorisations EXECUTE sur la sp_delete_backuphistory procédure stockée.
Exemples
R. Créer un conteneur de compte de stockage et une URL SAP
Vous pouvez créer à la fois le conteneur de compte de stockage et l’URL de signature d’accès partagé (SAP) à l’aide des dernières commandes Azure PowerShell. L’exemple suivant crée un conteneur myContainer dans le mystorageaccount compte de stockage, puis obtient une URL SAP pour celle-ci avec des autorisations complètes.
Pour plus d’informations sur les signatures d’accès partagé, consultez Accorder un accès limité aux ressources du Stockage Azure à l’aide des signatures d’accès partagé (SAP). Pour obtenir un exemple de script PowerShell, consultez Créer une signature d’accès partagé.
$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
B. Activer la gestion de sauvegarde de SQL Server sur Azure
L’exemple suivant active la sauvegarde managée SQL Server sur Microsoft Azure pour l’instance de SQL Server sur laquelle elle est exécutée, définit la stratégie de rétention sur 30 jours et 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
C. Désactiver la sauvegarde managée SQL Server sur Azure
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