smart_admin.set_instance_backup (Transact-SQL)

Define as configurações padrão do Backup Gerenciado do SQL Server para Windows Azure para a instância do SQL Server.

Use esse procedimento armazenado para habilitar o Backup Gerenciado do SQL Server para Windows Azure e definir as configurações padrão para uma instância do SQL Server.

Convenções da sintaxe Transact-SQL

Sintaxe

EXEC smart_admin.sp_set_instance_backup 
    [@enable_backup = ] { 0 | 1}
    ,[@storage_url = ] 'storageurl'
    ,[@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

• @enable\_backup
  Habilite ou desabilite o Backup Gerenciado do SQL Server para Windows Azure para o banco de dados especificado. O @enable\_backup é BIT. Parâmetro obrigatório durante a configuração do Backup Gerenciado do SQL Server para Windows Azure pela primeira vez na instância do SQL Server. Quando usado para alterar a configuração do Backup Gerenciado do SQL Server para Windows Azure, esse parâmetro é 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). Se não for especificado, o valor de URL de armazenamento será derivado das informações armazenadas nas credenciais do SQL.

• @retention\_days
  O período de retenção para os arquivos de backup em dias. O @storage\_url é INT. Parâmetro obrigatório durante a configuração do Backup Gerenciado do SQL Server para Windows Azure pela primeira vez na instância do SQL Server. Quando usado para alterar a configuração do Backup Gerenciado do SQL Server para Windows Azure, esse parâmetro é 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. Parâmetro obrigatório durante a configuração do Backup Gerenciado do SQL Server para Windows Azure pela primeira vez na instância do SQL Server. Quando usado para alterar a configuração do Backup Gerenciado do SQL Server para Windows Azure, esse parâmetro é opcional. Se não for especificado, os valores de configuração existentes serão retidos.

• @encryption\_algorithm
  O nome do algoritmo de criptografia usado durante o backup para criptografar o arquivo 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 da 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 estiver usando uma chave assimétrica, ela deverá ser configurada com 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 o Backup Gerenciado do SQL Server para Windows Azure para a instância do SQL Server em que é executado, define a política de retenção como 30 dias, define o destino como ‘mystorageaccount’ e a Credencial do SQL ‘MyCredential’.

Use msdb;
Go
   EXEC smart_admin.sp_set_instance_backup
                @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

O exemplo a seguir desabilita o Backup Gerenciado do SQL Server para Windows Azure para a instância do SQL Server em que é executado.

Use msdb;
Go
EXEC smart_admin.sp_set_instance_backup
                @enable_backup=0;
GO 

Consulte também

Conceitos

Backup Gerenciado do SQL Server para Windows Azure

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