managed_backup.sp_backup_config_basic (Transact-SQL)

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

Configura o backup gerido do SQL Server para as definições básicas do Microsoft Azure para uma base de dados específica ou para uma instância do SQL Server.

Transact-SQL convenções de sintaxe

Syntax

managed_backup.sp_backup_config_basic
    [ [ @database_name = ] N'database_name' ]
    [ , [ @enable_backup = ] { 0 | 1 } ]
    [ , [ @container_url = ] N'container_url' ]
    [ , [ @retention_days = ] retention_days ]
    [ , [ @credential_name = ] 'sql_credential_name' ]
[ ; ]

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 estão ao nível da instância (aplica-se a todas as novas bases de dados criadas na instância).

@enable_backup [ = ] { 0 | 1 }

Ative ou desative o backup gerido do SQL Server para o Microsoft Azure para a base de dados especificada. @enable_backupé mordido.

Parâmetro necessário ao configurar o backup gerido do SQL Server para o Microsoft Azure na primeira instância do SQL Server. Se estiver a alterar um backup gerido do SQL Server existente para uma configuração do Microsoft Azure, este parâmetro é opcional. Nesse caso, quaisquer valores de configuração não especificados mantêm os seus valores existentes.

Para mais informações, consulte Habilitar backup gerido do SQL Server para o Azure.

[ @container_url = ] N'container_url'

Um URL que indica a localização do backup. Quando @credential_name é NULL, este URL é uma URL de assinatura de acesso partilhada (SAS) para um contentor de blob em Armazenamento do Azure, e os backups usam o novo backup para bloquear funcionalidades de blob. Para mais informações, consulte Conceder acesso limitado a recursos do Armazenamento do Azure usando assinaturas de acesso partilhado (SAS). Quando @credential_name é especificado, então este é um URL de conta de armazenamento, e os backups usam a funcionalidade obsoleta de backup para page blob.

Se o URL SAS tiver o token SAS incluído, deve separá-lo do token SAS no ponto de interrogação e não incluir o ponto de interrogação.

Por exemplo, https://managedbackupstorage.blob.core.windows.net/backupcontainer?sv=2014-02-14&sr=c&sig=xM2LXVo1Erqp7LxQ%9BxqK9QC6%5Qabcd%9LKjHGnnmQWEsDf%5Q%se=2015-05-14T14%3B93%4V20X&sp=rwdl resulta nos seguintes dois valores:

[ @retention_days = ] retention_days

O período de retenção dos ficheiros de backup em dias. @retention_days é inteligência. Este é um parâmetro obrigatório ao configurar o backup gerido do SQL Server para o Microsoft Azure pela primeira vez na instância do SQL Server. Quando muda a configuração de backup gerido do SQL Server para Microsoft Azure, este parâmetro é opcional. Se não especificados, os valores de configuração existentes são mantidos.

[ @credential_name = ] 'sql_credential_name'

O nome da credencial SQL usada para autenticar a conta de armazenamento do Azure. @credential_name é sysname. Quando especificado, o backup é armazenado num blob de página. Se este parâmetro for NULL, a cópia de segurança é armazenada como um blob de blocos. Fazer backup para o blob de página está obsoleto, por isso é preferível usar a nova funcionalidade de backup de blob de bloco. Quando usado para alterar o backup gerido do SQL Server para a configuração do Microsoft Azure, este parâmetro é opcional. Se não for especificado, os valores de configuração existentes são mantidos.

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

A. Criar contentor de conta de armazenamento e URL SAS

Pode criar tanto o contentor da conta de armazenamento como o URL da assinatura de acesso partilhado (SAS) usando os comandos mais recentes do Azure PowerShell. O exemplo seguinte cria um novo contentor myContainer na mystorageaccount conta de armazenamento e depois obtém um URL SAS para ele com permissões completas.

Para mais informações sobre assinaturas de acesso partilhado, consulte Conceder acesso limitado a recursos de Armazenamento do Azure usando assinaturas de acesso partilhado (SAS). Para um exemplo de script PowerShell, veja Criar uma Assinatura de Acesso Partilhada.

$context = New-AzureStorageContext -StorageAccountName mystorageaccount -StorageAccountKey (Get-AzureStorageKey -StorageAccountName mystorageaccount).Primary
New-AzureStorageContainer -Name myContainer -Context $context
New-AzureStorageContainerSASToken -Name myContainer -Permission rwdl -FullUri -Context $context

B. Ativar o SQL Server Managed Backup para o Azure

O exemplo seguinte permite o backup gerido do SQL Server para o Microsoft Azure para a instância do SQL Server onde é executado, define a política de retenção para 30 dias e define o destino para um contentor nomeado myContainer numa conta de armazenamento chamada mystorageaccount.

USE msdb;
GO

EXECUTE managed_backup.sp_backup_config_basic
    @enable_backup = 1,
    @container_url = 'https://mystorageaccount.blob.core.windows.net/myContainer',
    @retention_days = 30;
GO

C. Desativar o Backup Gerido do SQL Server para o Azure

O exemplo seguinte desativa o backup gerido do SQL Server para o Microsoft Azure para a instância do SQL Server onde é executado.

USE msdb;
GO

EXECUTE managed_backup.sp_backup_config_basic @enable_backup = 0;
GO

Conteúdo relacionado

• managed_backup.sp_backup_config_advanced (Transact-SQL)
• managed_backup.sp_backup_config_schedule (Transact-SQL)