managed_backup.sp_backup_config_advanced (Transact-SQL)

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

Define as configurações avançadas para o backup gerenciado do SQL Server no Microsoft Azure.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@database_name [ = ] N'database_name'

O nome do banco de dados para habilitar o backup gerenciado em um banco de dados específico.

Se @database_name estiver definido como NULL, as configurações serão aplicadas no nível da instância (aplica-se a todos os novos bancos de dados criados na instância).

[ @encryption_algorithm = ] N'encryption_algorithm'

O nome do algoritmo de criptografia usado durante o backup para criptografar o arquivo de backup. @encryption_algorithm é sysname. É um parâmetro necessário ao configurar o backup gerenciado do SQL Server no Microsoft Azure pela primeira vez para o banco de dados. Especifique NO_ENCRYPTION se você não deseja criptografar o arquivo de backup. Quando você altera as definições de configuração do backup gerenciado do SQL Server para o Microsoft Azure, esse parâmetro é opcional. Se o parâmetro não for especificado, os valores de configuração existentes serã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, confira Escolher um algoritmo de criptografia.

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

O tipo de criptografador, que pode ser ou CERTIFICATEASYMMETRIC_KEY. @encryptor_type é nvarchar(32). Esse parâmetro será opcional se você especificar NO_ENCRYPTION para o parâmetro @encryption_algorithm .

[ @encryptor_name = ] N'encryptor_name'

O nome de um certificado existente ou chave assimétrica a ser usado para criptografar o backup. @encryptor_name é sysname. Se estiver usando uma chave assimétrica, ela deverá ser configurada com o EKM (Gerenciamento Extensível de Chaves). Esse parâmetro será opcional se você especificar NO_ENCRYPTION para o parâmetro @encryption_algorithm .

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

[ @local_cache_path = ] N'local_cache_path'

Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Permissões

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

Exemplos

O exemplo a seguir define opções de configuração avançadas para o backup gerenciado do SQL Server no 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