Share via


managed_backup.sp_backup_config_advanced (Transact-SQL)

Se aplica a: SQL Server 2016 (13.x) y versiones posteriores

Configura opciones avanzadas para la copia de seguridad administrada de SQL Server en Microsoft Azure.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @database_name = ] 'database_name'

Nombre de la base de datos para habilitar la copia de seguridad administrada en una base de datos específica.

Si @database_name se establece en NULL, la configuración se aplica en el nivel de instancia (se aplica a todas las bases de datos nuevas creadas en la instancia).

[ @encryption_algorithm ] = 'nombre del algoritmo de cifrado'

El nombre del algoritmo de cifrado utilizado durante la copia de seguridad para cifrar el archivo de copia de seguridad. @encryption_algorithm es sysname. Es un parámetro necesario al configurar la copia de seguridad administrada de SQL Server en Microsoft Azure por primera vez para la base de datos. Especifique NO_ENCRYPTION si no desea cifrar el archivo de copia de seguridad. Al cambiar la copia de seguridad administrada de SQL Server a la configuración de Microsoft Azure, este parámetro es opcional. Si no se especifica el parámetro , se conservan los valores de configuración existentes. Los valores permitidos para este parámetro son:

  • AES_128
  • AES_192
  • AES_256
  • TRIPLE_DES_3KEY
  • NO_ENCRYPTION

Para obtener más información sobre algoritmos de cifrado, vea Choose an Encryption Algorithm.

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

Tipo de cifrado, que puede ser CERTIFICATE o ASYMMETRIC_KEY. @encryptor_type es nvarchar(32). Este parámetro es opcional si especifica NO_ENCRYPTION para el parámetro @encryption_algorithm .

[ @encryptor_name = ] 'name of the certificate or asymmetric key'

Nombre de un certificado existente o clave asimétrica que se usa para cifrar la copia de seguridad. @encryptor_name es sysname. Si usa una clave asimétrica, debe configurarse con Administración extensible de claves (EKM). Este parámetro es opcional si especifica NO_ENCRYPTION para el parámetro @encryption_algorithm .

Para más información, vea Administración extensible de claves (EKM).

[ @local_cache_path = ] 'NOT AVAILABLE'

Este parámetro aún no se admite.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Permisos

Requiere la pertenencia al rol de base de datos db_backupoperator , con permisos ALTER ANY CREDENTIAL y permisos EXECUTE en el sp_delete_backuphistory procedimiento almacenado.

Ejemplos

En el ejemplo siguiente se establecen opciones de configuración avanzadas para la copia de seguridad administrada de SQL Server en Microsoft Azure para la instancia de SQL Server.

USE msdb;
GO

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