(+351) 21 24 10006  ·  info@bconcepts.pt
Carnaxide, Lisboa

Como automatizar backups de Azure SQL Database com Automation Runbook

João Barros 07 de November de 2026 4 min de leitura

Este tutorial mostra como automatizar backups de uma Azure SQL Database usando Azure Automation Runbook. É útil para garantir cópias regulares (.bacpac) fora da base de dados, integrar com Blob Storage e aplicar retenção automática.

Pré-requisitos

  • Conta Azure com permissões para criar recursos (Automation, Storage, Managed Identity).
  • Uma Azure SQL Database existente e um Storage Account com um contentor para backups.
  • Az PowerShell instalado localmente ou utilização do Cloud Shell.

Passo 1: Criar um Automation Account

Criar um Automation Account serve para executar Runbooks que realizam o processo de exportação. O Automation fornece agendamento, logging e integração com Managed Identity.

# Exemplo PowerShell (Cloud Shell)
$rg = 'rg-backup'
$location = 'westeurope'
$aaName = 'aa-sql-backup'
New-AzAutomationAccount -ResourceGroupName $rg -Name $aaName -Location $location

Passo 2: Ativar Managed Identity no Automation Account

O Runbook deve autenticar-se na Azure SQL Database e no Storage sem segredos; para isso usamos a Managed Identity do Automation Account e atribuímos permissões adequadas.

# Atribuir identidade gerida e permissões ao Automation Account
$aa = Get-AzAutomationAccount -ResourceGroupName $rg -Name $aaName
# Ativar System Assigned Identity (na maioria dos casos já disponível via portal; via CLI/PS pode requerer rota alternativa)

Passo 3: Conceder permissões ao Storage e à SQL

Conceder à Managed Identity acesso de escrita ao contentor do Storage e permissões mínimas na SQL (dbmanager ou usar autenticação SQL para export). Para exportar .bacpac via REST/PowerShell geralmente exportamos usando credenciais SQL; outra opção é criar credenciais na SQL para AD.

# Exemplo para Storage: Atribuir role Storage Blob Data Contributor
$sp = (Get-AzAutomationAccount -ResourceGroupName $rg -Name $aaName).Identity.PrincipalId
$storage = Get-AzStorageAccount -ResourceGroupName $rg -Name 'stbackups'
New-AzRoleAssignment -ObjectId $sp -RoleDefinitionName 'Storage Blob Data Contributor' -Scope $storage.Id

# Para SQL: garantir login SQL com permissão para exportar
# (aqui assumimos utilização de SQL auth nas credenciais do Runbook)

Passo 4: Criar o Runbook PowerShell para exportar a database

Escrever um Runbook PowerShell que exporta a Azure SQL Database para um .bacpac no Storage Account. O exemplo abaixo usa a API REST de exportação (Export bacpac) via cmdlets Az.Sql.

param(
  [string]$ResourceGroup = 'rg-backup',
  [string]$ServerName = 'sqlserver-demo',
  [string]$DatabaseName = 'db-demo',
  [string]$StorageAccountName = 'stbackups',
  [string]$ContainerName = 'backups',
  [string]$StorageKey = '',        # Se usar Managed Identity pode criar URL SAS em vez de key
  [string]$SqlAdmin = 'sqladmin',
  [string]$SqlPassword = ''
)

# Autenticar (no Automation use Run As ou Managed Identity conforme configurado)
Connect-AzAccount -Identity

$storageAccount = Get-AzStorageAccount -ResourceGroupName $ResourceGroup -Name $StorageAccountName
$storageUri = "https://$($StorageAccountName).blob.core.windows.net/$ContainerName/$(Get-Date -Format 'yyyyMMdd-HHmmss')-$DatabaseName.bacpac"

$exportRequest = New-AzSqlDatabaseExport -ResourceGroupName $ResourceGroup -ServerName $ServerName -DatabaseName $DatabaseName \
  -StorageKeytype 'StorageAccessKey' -StorageKey $StorageKey -StorageUri $storageUri -AdministratorLogin $SqlAdmin -AdministratorLoginPassword (ConvertTo-SecureString $SqlPassword -AsPlainText -Force)

# Opcional: aguardar conclusão
$job = $exportRequest
while ($true) {
  $status = Get-AzSqlDatabaseImportExportStatus -OperationStatusLink $job.OperationStatusLink
  Write-Output "Export status: $($status.Status)"
  if ($status.Status -in @('Succeeded','Failed','Cancelled')) { break }
  Start-Sleep -Seconds 15
}

Passo 5: Agendar o Runbook

Publicar o Runbook e criar um agendamento no Automation Account para correr diariamente ou conforme a retenção desejada.

# Exemplo resumido via PowerShell
$rb = New-AzAutomationRunbook -ResourceGroupName $rg -AutomationAccountName $aaName -Name 'Export-Sql-Database' -Type PowerShell -ScriptText (Get-Content -Raw './Export-Sql.ps1')
Publish-AzAutomationRunbook -ResourceGroupName $rg -AutomationAccountName $aaName -Name $rb.Name
# Criar schedule diário às 02:00
$sched = New-AzAutomationSchedule -AutomationAccountName $aaName -ResourceGroupName $rg -Name 'Daily-02' -StartTime (Get-Date).Date.AddDays(1).AddHours(2) -Frequency Day -Interval 1
Register-AzAutomationScheduledRunbook -AutomationAccountName $aaName -ResourceGroupName $rg -Name $rb.Name -ScheduleName $sched.Name

Verificar o resultado

Confirmar que os .bacpac aparecem no contentor do Storage e que o Runbook completou com sucesso. Verifique os jobs em Automation > Jobs e o contentor no Storage Account. Se houver erros, consulte a saída do job para mensagens comuns: credenciais inválidas, permissões do Storage, ou tempo de espera da exportação.

Conclusão

Agora tem um processo automatizado de backup (export .bacpac) para uma Azure SQL Database usando Azure Automation Runbook. Próximos passos: implementar retenção automática (remover ficheiros antigos), usar SAS em vez de StorageKey, ou integrar com Azure Logic Apps para alertas. Dica: teste o restore do .bacpac numa instância de desenvolvimento para validar o backup.