managed_backup.sp_backup_config_advanced (Transact-SQL)

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores

Configura definições avançadas para backup gerido do SQL Server para Microsoft Azure.

Transact-SQL convenções de sintaxe

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'

O nome da base de dados para habilitar backup gerido numa base de dados específica.

Se @database_name estiver definido para NULL, as definições são aplicadas ao nível da instância (aplica-se a todas as novas bases de dados criadas na instância).

[ @encryption_algorithm = ] N'encryption_algorithm'

O nome do algoritmo de encriptação usado durante o backup para encriptar o ficheiro de backup. @encryption_algorithm é sysname. É um parâmetro obrigatório ao configurar o backup gerido do SQL Server para o Microsoft Azure pela primeira vez para a base de dados. Especifique NO_ENCRYPTION se não pretende encriptar o ficheiro de backup. Quando altera o backup gerido do SQL Server para as definições de configuração do Microsoft Azure, este parâmetro é opcional. Se o parâmetro não for especificado, os valores de configuração existentes são mantidos. Os valores permitidos para este parâmetro são:

  • AES_128
  • AES_192
  • AES_256
  • TRIPLE_DES_3KEY
  • NO_ENCRYPTION

Para obter mais informações sobre algoritmos de criptografia, consulte Escolher um algoritmo de criptografia.

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

O tipo de encriptador, que pode ser ou CERTIFICATE .ASYMMETRIC_KEY @encryptor_type é Nvarchar(32). Este parâmetro é opcional se especificar NO_ENCRYPTION para o parâmetro @encryption_algorithm .

[ @encryptor_name = ] N'encryptor_name'

O nome de um certificado existente ou chave assimétrica para usar para encriptar a cópia de segurança. @encryptor_name é sysname. Se usar uma chave assimétrica, deve ser configurada com Gestão Extensível de Chaves (EKM). Este parâmetro é opcional se especificar NO_ENCRYPTION para o parâmetro @encryption_algorithm .

Para obter mais informações, consulte Gerenciamento extensível de chaves (EKM).

[ @local_cache_path = ] N'local_cache_path'

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Permissions

Requer a pertença ao papel de base de dados db_backupoperator , com ALTERAR QUAISQUER CREDENTIAL permissões, e permissões EXECUTE no sp_delete_backuphistory procedimento armazenado.

Examples

O exemplo seguinte define opções avançadas de configuração para backup gerido do SQL Server para o Microsoft Azure para a instância do SQL Server.

USE msdb;
GO

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

Conteúdo relacionado

  • Last updated on