managed_backup.sp_backup_config_advanced (Transact-SQL)

Van toepassing op: SQL Server 2016 (13.x) en latere versies

Stelt geavanceerde instellingen in voor SQL Server managed backup naar Microsoft Azure.

Transact-SQL syntaxis-conventies

Syntax

managed_backup.sp_backup_config_advanced
    [ [ @database_name = ] N'database_name' ]
    [ , [ @encryption_algorithm = ] N'encryption_algorithm' ]
    [ , [ @encryptor_type = ] { 'CERTIFICATE' | 'ASYMMETRIC_KEY' } ]
    [ , [ @encryptor_name = ] N'encryptor_name' ]
    [ , [ @local_cache_path = ] N'local_cache_path' ]
[ ; ]

Arguments

[ @database_name = ] N'database_name'

De databasenaam om beheerde back-ups in een specifieke database in te schakelen.

Als @database_name is ingesteld op NULL, worden de instellingen toegepast op instantieniveau (geldt voor alle nieuwe databases die op de instantie zijn aangemaakt).

[ @encryption_algorithm = ] N'encryption_algorithm'

De naam van het encryptie-algoritme dat tijdens de back-up wordt gebruikt om het back-upbestand te versleutelen. @encryption_algorithm is sysname. Het is een vereiste parameter bij het voor het eerst voor de database een SQL Server managed backup naar Microsoft Azure configureren. Geef NO_ENCRYPTION aan als je het back-upbestand niet wilt versleutelen. Wanneer je de SQL Server managed back-up verandert naar Microsoft Azure-configuratie-instellingen, is deze parameter optioneel. Als de parameter niet wordt gespecificeerd, blijven de bestaande configuratiewaarden behouden. De toegestane waarden voor deze parameter zijn:

  • AES_128
  • AES_192
  • AES_256
  • TRIPLE_DES_3KEY (drievoudige DES met drie sleutels)
  • NO_ENCRYPTION

Zie Een versleutelingsalgoritmen kiezenvoor meer informatie over versleutelingsalgoritmen.

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

Het type encryptor, dat kan zijn of CERTIFICATEASYMMETRIC_KEY. @encryptor_type is nvarchar(32). Deze parameter is optioneel als je de @encryption_algorithm-parameter specificeertNO_ENCRYPTION.

[ @encryptor_name = ] N'encryptor_name'

De naam van een bestaand certificaat of asymmetrische sleutel om de back-up te versleutelen. @encryptor_name is sysname. Als je een asymmetrische sleutel gebruikt, moet deze worden geconfigureerd met Extensible Key Management (EKM). Deze parameter is optioneel als je de @encryption_algorithm-parameter specificeertNO_ENCRYPTION.

Zie EKM (Extensible Key Management)voor meer informatie.

[ @local_cache_path = ] N'local_cache_path'

Alleen ter informatie geïdentificeerd. Wordt niet ondersteund. Toekomstige compatibiliteit is niet gegarandeerd.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Permissions

Vereist lidmaatschap van de db_backupoperator databaserol, met ALTER ANY CREDENTIAL permissies en EXECUTE-rechten op de sp_delete_backuphistory opgeslagen procedure.

Examples

Het volgende voorbeeld stelt geavanceerde configuratieopties voor SQL Server managed back-up in Microsoft Azure voor de instantie van SQL Server.

USE msdb;
GO

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

Verwante inhoud

  • Last updated on