managed_backup.sp_backup_config_advanced (Transact-SQL)

  • Artigo

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

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

Convenções de sintaxe de Transact-SQL

Sintaxe

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'

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

Se @database_name for 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 [ ] = 'nome do algoritmo de criptografia'

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 o backup gerenciado do SQL Server para as definições de configuração do 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, consulte Choose an Encryption Algorithm.

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

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

@encryptor_name [ = ] 'nome do certificado ou chave assimétrica'

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 Gerenciamento Extensível de Chaves (EKM). Esse parâmetro é 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ÃO DISPONÍVEL'

Esse parâmetro ainda não é suportado.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Permissões

Requer associação à função de banco de dados db_backupoperator , com permissões ALTER ANY CREDENTIAL 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

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

Conteúdo relacionado