managed_backup.sp_backup_config_advanced (Transact-SQL)

  • Article

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

Configure les paramètres avancés pour la sauvegarde managée SQL Server sur Microsoft Azure.

Conventions de la syntaxe Transact-SQL

Syntaxe

EXEC managed_backup.sp_backup_config_advanced
    [ @database_name = ] 'database_name'
    , [ @encryption_algorithm = ] 'name of the encryption algorithm'
    , [ @encryptor_type = ] { 'CERTIFICATE' | 'ASYMMETRIC_KEY' }
    , [ @encryptor_name = ] 'name of the certificate or asymmetric key'
    , [ @local_cache_path = ] 'NOT AVAILABLE'
[ ; ]

Arguments

[ @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 sur NULL, les paramètres sont appliqués au niveau de l’instance (s’applique à toutes les nouvelles bases de données créées sur l’instance).

[ @encryption_algorithm ] = 'name of the encryption algorithm'

Nom de l'algorithme de chiffrement utilisé lors de la sauvegarde pour chiffrer le fichier de sauvegarde. @encryption_algorithm est sysname. 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 pour la base de données. Spécifiez si vous ne souhaitez NO_ENCRYPTION pas chiffrer le fichier de sauvegarde. Lorsque vous modifiez la sauvegarde managée SQL Server en paramètres de configuration Microsoft Azure, ce paramètre est facultatif. Si le paramètre n’est pas spécifié, les valeurs de configuration existantes sont conservées. 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 Choose an Encryption Algorithm.

[ @encryptor_type = ] { 'CERTIFICATE' | 'ASYMMETRIC_KEY' }

Type de chiffreur, qui peut être l’un ou l’autre CERTIFICATEASYMMETRIC_KEY. @encryptor_type est nvarchar(32). Ce paramètre est facultatif si vous spécifiez NO_ENCRYPTION le paramètre @encryption_algorithm .

[ @encryptor_name = ] 'nom du certificat ou de la clé asymétrique'

Nom d'un certificat ou d'une clé asymétrique qui existe, utilisé pour chiffrer la sauvegarde. @encryptor_name est sysname. Si vous utilisez une clé asymétrique, elle doit être configurée avec EKM (Extensible Key Management). Ce paramètre est facultatif si vous spécifiez NO_ENCRYPTION le paramètre @encryption_algorithm .

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

[ @local_cache_path = ] 'NON DISPONIBLE'

Ce paramètre n’est pas encore pris en charge.

Valeurs des codes de retour

0 (réussite) ou 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

L’exemple suivant définit des options de configuration avancées pour la sauvegarde managée SQL Server sur Microsoft Azure pour l’instance de SQL Server.

USE msdb;
GO

EXEC managed_backup.sp_backup_config_advanced @encryption_algorithm = 'AES_128',
    @encryptor_type = 'CERTIFICATE',
    @encryptor_name = 'MyTestDBBackupEncryptCert'
GO

Contenu connexe