smart_admin.set_db_backup (Transact-SQL)

Configurar os parâmetros do Backup Gerenciado do SQL Server para Windows Azure para o banco de dados especificado.

Use este procedimento armazenado para habilitar e configurar os parâmetros do Backup Gerenciado do SQL Server para Windows Azure para um banco de dados específico.

Convenções da sintaxe Transact-SQL

Sintaxe

EXEC smart_admin.sp_set_db_backup  
     [@database_name = ] 'database name'
    ,[@enable_backup = ] { 0 | 1}
    ,[@storage_url = ] 'storage url'
    ,[@retention_days = ] 'retention_period_in_days'
    ,[@credential_name = ] 'sql_credential_name'
    ,[@encryption_algorithm] 'name of the encryption algorithm'
    ,[@encryptor_type] {'CERTIFICATE' | 'ASYMMETRIC_KEY'}
    ,[@encryptor_name] 'name of the certificate or asymmetric key'

Argumentos

• @database\_name
  Nome do banco de dados. O @database\_name é SYSNAME. Esse é um parâmetro necessário.

• @enable\_backup
  Habilite ou desabilite o Backup Gerenciado do SQL Server para Windows Azure para o banco de dados especificado. O @enable\_backup é BIT. É um parâmetro obrigatório ao configurar o Backup Gerenciado do SQL Server para Windows Azure pela primeira vez para o banco de dados. Quando for usado para modificar os parâmetros de configuração do Backup Gerenciado do SQL Server para Windows Azure, esse parâmetro será opcional. Se não for especificado, os valores de configuração existentes serão retidos.

• @storage\_url
  A URL da conta do Windows Azure Storage. Por exemplo: 'https://www.blob.core.windows. net/mystorageaccount'. O contêiner não deve ser incluído nela. O @storage\_url é NVARCHAR(1024). É um parâmetro obrigatório ao configurar o Backup Gerenciado do SQL Server para Windows Azure pela primeira vez. Quando for usado para modificar os parâmetros de configuração do Backup Gerenciado do SQL Server para Windows Azure, esse parâmetro será opcional. Se não for especificado, os valores de configuração existentes serão retidos.

• @retention\_days
  O período de retenção para os arquivos de backup em dias. O @storage\_url é INT. É um parâmetro obrigatório ao configurar o Backup Gerenciado do SQL Server para Windows Azure pela primeira vez. Quando for usado para modificar os parâmetros de configuração do Backup Gerenciado do SQL Server para Windows Azure, esse parâmetro será opcional. Se não for especificado, os valores de configuração existentes serão retidos.

• @credential\_name
  O nome da credencial de SQL usado para realizar a autenticação na conta de armazenamento do Windows Azure. O @credentail\_name é SYSNAME. É um parâmetro obrigatório ao configurar o Backup Gerenciado do SQL Server para Windows Azure pela primeira vez para o banco de dados. Quando for usado para modificar os parâmetros de configuração do Backup Gerenciado do SQL Server para Windows Azure, esse parâmetro será opcional. Se não for especificado, os valores de configuração existentes serão retidos.

• @encryption\_algorithm
  O nome do algoritmo de criptografia a ser usado para criptografar o arquivo de backup durante a operação de backup. O @encryption\_algorithm é SYSNAME. É um parâmetro obrigatório ao configurar o Backup Gerenciado do SQL Server para Windows Azure pela primeira vez para o banco de dados. Especifique NO_ENCRYPTION se você não quiser criptografar o arquivo de backup. Ao alterar os parâmetros de configuração do Backup Gerenciado do SQL Server para Windows Azure, esse parâmetro será opcional – se o parâmetro não for especificado, os valores de configuração existentes serão retidos. 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
  O tipo de criptografador usado para criptografia. O @encryptor\_type é NVARCHAR(32). Você pode usar um certificado de chave assimétrica como o tipo do criptografador. Esse parâmetro é opcional se você especificar NO_ENCRYPTION para o parâmetro @encryption\_algorithm.

• @encryptor\_name
  O nome de um certificado existente ou chave assimétrica a ser usado para criptografar o backup. O @encryptor\_name é SYSNAME. Se você estiver usando uma chave assimétrica, ela deverá residir no provedor EKM (gerenciamento de chave extensível).

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

Valor do código de retorno

0 (êxito) ou 1 (falha)

Segurança

Permissões

Exige associação à função de banco de dados db_backupoperator, com permissões ALTER ANY CREDENTIAL e permissões EXECUTE no procedimento armazenado sp_delete_backuphistory.

Exemplos

O exemplo a seguir habilita e configura o Backup Gerenciado do SQL Server para Windows Azure para o banco de dados ‘TestDB’.

Use msdb;
GO
EXEC smart_admin.sp_set_db_backup 
                @database_name='TestDB' 
                ,@enable_backup=1
                ,@storage_url = 'https://mystorageaccount.blob.core.windows.net/' 
                ,@retention_days=30 
                ,@credential_name='MyCredential'
                ,@encryption_algorithm ='AES_128'
                ,@encryptor_type= 'ServerCertificate'
                ,@encryptor_name='MyBackupCert';
GO 

Consulte também

Conceitos

Backup gerenciado do SQL Server no Windows Azure - Configurações de retenção e armazenamento

Configurando o Backup Gerenciado do SQL Server para Windows Azure para Grupos de Disponibilidade