managed_backup.sp_backup_config_advanced (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server 2016 (13.x) und höhere Versionen

Konfiguriert erweiterte Einstellungen für die verwaltete SQL Server-Sicherung in Microsoft Azure.

Syntax

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'
[ ; ]

Argumente

[ @database_name = ] 'database_name'

Der Datenbankname zum Aktivieren der verwalteten Sicherung für eine bestimmte Datenbank.

Wenn @database_name festgelegt NULList, werden die Einstellungen auf Instanzebene angewendet (gilt für alle neuen Datenbanken, die auf der Instanz erstellt wurden).

[ @encryption_algorithm ] = 'Name des Verschlüsselungsalgorithmus'

Der Name des Verschlüsselungsalgorithmus, der bei der Sicherung zum Verschlüsseln der Sicherungsdatei verwendet wird. @encryption_algorithm ist "sysname". Es ist ein erforderlicher Parameter beim erstmaligen Konfigurieren der verwalteten SQL Server-Sicherung in Microsoft Azure für die Datenbank. Geben Sie an NO_ENCRYPTION , ob Sie die Sicherungsdatei nicht verschlüsseln möchten. Wenn Sie die verwaltete SQL Server-Sicherung in Microsoft Azure-Konfigurationseinstellungen ändern, ist dieser Parameter optional. Wenn der Parameter nicht angegeben ist, werden die vorhandenen Konfigurationswerte beibehalten. Zulässige Werte für diesen Parameter:

AES_128
AES_192
AES_256
TRIPLE_DES_3KEY
NO_ENCRYPTION

Weitere Informationen zur Verschlüsselung von Algorithmen finden Sie unter Wählen Sie einen Verschlüsselungsalgorithmus.

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

Der Verschlüsselungstyp, der entweder CERTIFICATE oder ASYMMETRIC_KEY. @encryptor_type ist nvarchar(32). Dieser Parameter ist optional, wenn Sie für den parameter @encryption_algorithm angebenNO_ENCRYPTION.

[ @encryptor_name = ] 'Name des Zertifikats oder asymmetrischen Schlüssels'

Der Name eines vorhandenen Zertifikats oder asymmetrischen Schlüssels, mit dem die Sicherung verschlüsselt wird. @encryptor_name ist "sysname". Bei Verwendung eines asymmetrischen Schlüssels muss er mit extensible Key Management (EKM) konfiguriert werden. Dieser Parameter ist optional, wenn Sie für den parameter @encryption_algorithm angebenNO_ENCRYPTION.

Weitere Informationen finden Sie unter Erweiterbare Schlüsselverwaltung (Extensible Key Management, EKM).

[ @local_cache_path = ] 'NICHT VERFÜGBAR'

Dieser Parameter wird noch nicht unterstützt.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Berechtigungen

Erfordert die Mitgliedschaft in der db_backupoperator-Datenbankrolle mit ALTER ANY CREDENTIAL-Berechtigungen und EXECUTE-Berechtigungen für die sp_delete_backuphistory gespeicherte Prozedur.

Beispiele

Im folgenden Beispiel werden erweiterte Konfigurationsoptionen für die verwaltete SQL Server-Sicherung auf Microsoft Azure für die Sql Server-Instanz festgelegt.

USE msdb;
GO

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

Freigeben über