managed_backup.sp_backup_config_advanced (Transact-SQL)

  • Articolo

Si applica a: SQL Server 2016 (13.x) e versioni successive

Configura le impostazioni avanzate per il backup gestito di SQL Server in Microsoft Azure.

Convenzioni di sintassi Transact-SQL

Sintassi

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

Argomenti

[ @database_name = ] 'database_name'

Nome del database per l'abilitazione del backup gestito in un database specifico.

Se @database_name è impostato su NULL, le impostazioni vengono applicate a livello di istanza (si applica a tutti i nuovi database creati nell'istanza).

[ @encryption_algorithm ] = 'nome dell'algoritmo di crittografia'

Nome dell'algoritmo di crittografia utilizzato durante il backup per crittografare il file di backup. @encryption_algorithm è sysname. È un parametro obbligatorio quando si configura backup gestito di SQL Server in Microsoft Azure per la prima volta per il database. Specificare NO_ENCRYPTION se non si vuole crittografare il file di backup. Quando si modificano le impostazioni di configurazione di Backup gestito di SQL Server in Microsoft Azure, questo parametro è facoltativo. Se il parametro non viene specificato, i valori di configurazione esistenti vengono mantenuti. I valori consentiti per questo parametro sono:

  • AES_128
  • AES_192
  • AES_256
  • TRIPLE_DES_3KEY
  • NO_ENCRYPTION

Per altre informazioni sugli algoritmi di crittografia, vedere Choose an Encryption Algorithm.

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

Tipo di encryptor, che può essere CERTIFICATE o ASYMMETRIC_KEY. @encryptor_type è nvarchar(32).@encryptor_type is nvarchar(32). Questo parametro è facoltativo se si specifica NO_ENCRYPTION per il parametro @encryption_algorithm .

[ @encryptor_name = ] 'nome del certificato o della chiave asimmetrica'

Nome di un certificato o una chiave asimmetrica esistente da utilizzare per crittografare il backup. @encryptor_name è sysname. Se si usa una chiave asimmetrica, deve essere configurata con Extensible Key Management (EKM). Questo parametro è facoltativo se si specifica NO_ENCRYPTION per il parametro @encryption_algorithm .

Per altre informazioni, vedere Extensible Key Management (EKM).

[ @local_cache_path = ] 'NOT AVAILABLE'

Questo parametro non è ancora supportato.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Autorizzazioni

Richiede l'appartenenza al ruolo del database db_backupoperator , con autorizzazioni ALTER ANY CREDENTIAL e autorizzazioni EXECUTE per la sp_delete_backuphistory stored procedure.

Esempi

Nell'esempio seguente vengono impostate le opzioni di configurazione avanzate per Il backup gestito di SQL Server in Microsoft Azure per l'istanza di SQL Server.

USE msdb;
GO

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

Contenuto correlato