managed_backup.sp_backup_config_advanced (Transact-SQL)

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 relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @database_name = ] N'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 = ] N'encryption_algorithm'

Nome dell'algoritmo di crittografia utilizzato durante il backup per crittografare il file di backup. @encryption_algorithm è sysname. Si tratta di un parametro obbligatorio quando si configura il 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 modifica il backup gestito di SQL Server in impostazioni di configurazione di 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 Scegliere un algoritmo di crittografia.

[ @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 = ] N'encryptor_name'

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 = ] N'local_cache_path'

Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Autorizzazioni

Richiede l'appartenenza al ruolo db_backupoperator database, con ALTERARE QUALSIASI CREDENTIAL permesso, e permessi EXECUTE sulla sp_delete_backuphistory procedura memorizzata.

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

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

Contenuto correlato

  • Last updated on