smart_admin.set_db_backup (Transact-SQL)

Configure les paramètres de la Sauvegarde managée SQL Server sur Windows Azure pour la base de données spécifiée.

Utilisez cette procédure stockée pour activer et configurer les paramètres de la Sauvegarde managée SQL Server sur Windows Azure pour une base de données spécifique.

Conventions de la syntaxe Transact-SQL

Syntaxe

EXEC smart_admin.sp_set_db_backup  
     [@database_name = ] 'database name'
    ,[@enable_backup = ] { 0 | 1}
    ,[@storage_url = ] 'storage url'
    ,[@retention_days = ] 'retention_period_in_days'
    ,[@credential_name = ] 'sql_credential_name'
    ,[@encryption_algorithm] 'name of the encryption algorithm'
    ,[@encryptor_type] {'CERTIFICATE' | 'ASYMMETRIC_KEY'}
    ,[@encryptor_name] 'name of the certificate or asymmetric key'

Arguments

• @database\_name
  Nom de la base de données. Le paramètre @database\_name est SYSNAME. Ce paramètre est obligatoire.

• @enable\_backup
  Activez ou désactivez la Sauvegarde managée SQL Server sur Windows Azure pour la base de données spécifiée. Le paramètre @enable\_backup est BIT. C'est un paramètre requis lorsque vous configurez la Sauvegarde managée SQL Server sur Windows Azure pour la première fois pour la base de données. Lorsqu'il est utilisé pour modifier les paramètres de configuration de la Sauvegarde managée SQL Server sur Windows Azure, ce paramètre est facultatif. S'il n'est pas spécifié, les valeurs de configuration existantes sont retenues.

• @storage\_url
  URL du compte du stockage Windows Azure. Par exemple : « https://www.blob.core.windows. net/mystorageaccount ». Le conteneur ne doit pas être inclus ici. Le paramètre @storage\_url est NVARCHAR(1024). C'est un paramètre requis lorsque vous configurez la Sauvegarde managée SQL Server sur Windows Azure pour la première fois. Lorsqu'il est utilisé pour modifier les paramètres de configuration de la Sauvegarde managée SQL Server sur Windows Azure, ce paramètre est facultatif. S'il n'est pas spécifié, les valeurs de configuration existantes sont retenues.

• @retention\_days
  Période de rétention en jours des fichiers de sauvegarde. Le paramètre @storage\_url est INT. C'est un paramètre requis lorsque vous configurez la Sauvegarde managée SQL Server sur Windows Azure pour la première fois. Lorsqu'il est utilisé pour modifier les paramètres de configuration de la Sauvegarde managée SQL Server sur Windows 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 identifier le compte de stockage Windows Azure. Le paramètre @credentail\_name est SYSNAME. C'est un paramètre requis lorsque vous configurez la Sauvegarde managée SQL Server sur Windows Azure pour la première fois pour la base de données. Lorsqu'il est utilisé pour modifier les paramètres de configuration de la Sauvegarde managée SQL Server sur Windows Azure, ce paramètre est facultatif. S'il n'est pas spécifié, les valeurs de configuration existantes sont retenues.

• @encryption\_algorithm
  Nom de l'algorithme de chiffrement à utiliser pour chiffrer le fichier de sauvegarde pendant l'opération de sauvegarde. Le paramètre @encryption\_algorithm est SYSNAME. C'est un paramètre requis lorsque vous configurez la Sauvegarde managée SQL Server sur Windows Azure pour la première fois pour la base de données. Spécifiez NO_ENCRYPTION si vous ne souhaitez pas chiffrer le fichier de sauvegarde. Si vous modifiez les paramètres de configuration de la Sauvegarde managée SQL Server sur Windows Azure, ce paramètre est facultatif. S'il n'est pas spécifié, les valeurs de configuration existantes sont retenues. Les valeurs autorisées pour ce paramètre sont :

  • AES_128

  • AES_192

  • AES_256

  • TRIPLE_DES_3KEY

  • NO_ENCRYPTION

  Pour plus d'informations sur les algorithmes de chiffrement, consultez Choisir un algorithme de chiffrement.

• @encryptor\_type
  Type de chiffreur utilisé pour le chiffrement. Le paramètre @encryptor\_type est NVARCHAR(32). Vous pouvez utiliser un certificat ou une clé asymétrique comme type de chiffreur. Ce paramètre est facultatif si vous spécifiez NO_ENCRYPTION pour le paramètre @encryption\_algorithm.

• @encryptor\_name
  Nom d'un certificat ou d'une clé asymétrique qui existe, utilisé pour chiffrer la sauvegarde. Le paramètre @encryptor\_name est SYSNAME. Si vous utilisez une clé asymétrique, elle doit résider dans le fournisseur de gestion de clés extensible (EKM).

  Pour plus d'informations, consultez Gestion de clés extensible (EKM).

Valeurs des codes de retour

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

Sécurité

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 procédure stockée sp_delete_backuphistory.

Exemples

L'exemple suivant active et configure la Sauvegarde managée SQL Server sur Windows Azure pour la base de données « TestDB ».

Use msdb;
GO
EXEC smart_admin.sp_set_db_backup 
                @database_name='TestDB' 
                ,@enable_backup=1
                ,@storage_url = 'https://mystorageaccount.blob.core.windows.net/' 
                ,@retention_days=30 
                ,@credential_name='MyCredential'
                ,@encryption_algorithm ='AES_128'
                ,@encryptor_type= 'ServerCertificate'
                ,@encryptor_name='MyBackupCert';
GO 

Voir aussi

Concepts

Sauvegarde managée SQL Server sur Windows Azure - Paramètres de rétention et de stockage

Configuration de la sauvegarde managée de SQL Server sur Windows Azure pour les groupes de disponibilité