managed_backup.sp_backup_config_basic (Transact-SQL)

S’applique à : SQL Server 2016 (13.x) et versions ultérieures

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

Notes

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 d’abord ces paramètres à l’aide de managed_backup.sp_backup_config_advanced (Transact-SQL) et de managed_backup.sp_backup_config_schedule (Transact-SQL) avant d’activer la sauvegarde managée avec cette procédure.

Topic link iconConventions 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 SQL Server sauvegarde managée sur Microsoft Azure pour la base de données spécifiée. Il @enable_backup s’agit du BIT. Paramètre requis lors de la configuration de SQL Server Sauvegarde managée sur Microsoft Azure pour la première instance de SQL Server. Si vous modifiez une SQL Server sauvegarde managée existante vers la configuration de 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 l’activation de la sauvegarde managée sur une base de données spécifique.

@container_url
URL qui indique l’emplacement de la sauvegarde. Lorsqu’elle @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 Understanding SAS. Quand @credential_name elle est spécifiée, il s’agit d’une URL de compte de stockage et les sauvegardes utilisent la sauvegarde déconseillée pour la fonctionnalité d’objet blob de pages.

Notes

Seule une URL SAP est prise en charge pour ce paramètre à ce stade.

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

@credential_name
Nom des informations d’identification SQL utilisées pour s’authentifier auprès du compte de stockage Azure. @credentail_nameest SYSNAME. Quand elle est spécifiée, la sauvegarde est stockée dans un objet blob de pages. Si ce paramètre est NULL, la sauvegarde est stockée en tant qu’objet blob de blocs. La sauvegarde sur l’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 configuration SQL Server Managed Backup vers Microsoft Azure, ce paramètre est facultatif. Si elle n’est pas spécifiée, les valeurs de configuration existantes sont conservées.

Avertissement

Le paramètre @credential_name n’est pas pris en charge pour le moment. Seule la sauvegarde dans l’objet blob de blocs est prise en charge, ce qui nécessite que ce paramètre soit NULL.

Valeur du code de retour

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

Sécurité

Autorisations

Nécessite l’appartenance à db_backupoperator rôle de base de données, avec les autorisations ALTER ANY CREDENTIAL et les autorisations EXECUTE sur sp_delete_backuphistory procédure stockée.

Exemples

Vous pouvez créer à la fois le conteneur de compte de stockage et l’URL SAP à l’aide des commandes Azure PowerShell les plus récentes. L’exemple suivant crée un conteneur, mycontainer, dans le compte de stockage mystorageaccount, puis obtient une URL SAS pour celle-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 SQL Server Sauvegarde managée sur Microsoft Azure pour l’instance de SQL Server 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 SQL Server Sauvegarde managée sur Microsoft Azure pour l’instance de SQL Server il est exécuté.

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

Voir aussi

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