Importante
Configurar a janela de manutenção é uma operação assíncrona de longa duração, semelhante à alteração da camada de serviço do recurso SQL do Azure. O recurso está disponível durante a operação, exceto uma breve reconfiguração que acontece no final da operação e normalmente dura até 8 segundos, mesmo em caso de transações de longa duração interrompidas. Para minimizar o impacto da reconfiguração, você deve executar a operação fora do horário de pico.
Para configurar a janela de manutenção ao criar uma instância gerenciada pelo SQL, defina a janela Manutenção desejada na página Configurações adicionais.
Definir a janela de manutenção ao criar uma instância gerenciada pelo SQL
Para obter informações passo a passo sobre como criar uma nova instância gerenciada do SQL, consulte Criar uma instância gerenciada do SQL do Azure.
Os exemplos a seguir mostram como configurar a janela de manutenção usando o Azure PowerShell. Você pode instalar o Azure PowerShellou usar o Azure Cloud Shell.
Iniciar o Azure Cloud Shell
O Azure Cloud Shell é um shell interativo gratuito que você pode usar para executar as etapas neste artigo. Tem ferramentas comuns do Azure pré-instaladas e configuradas para utilização com a sua conta.
Para abrir o Cloud Shell, selecione Experimentar no canto superior direito de um bloco de código. Você também pode iniciar o Cloud Shell em uma guia separada do navegador acessando https://shell.azure.com.
Quando o Cloud Shell abrir, verifique se PowerShell está selecionado para o seu ambiente. As sessões subsequentes usarão a CLI do Azure em um ambiente do PowerShell. Selecione Copiar para copiar os blocos de código, cole-o no Cloud Shell e pressione Enter para executá-lo.
Descubra as janelas de manutenção disponíveis
Ao definir a janela de manutenção, cada região tem suas próprias opções de janela de manutenção que correspondem ao fuso horário da região.
Descubra as janelas de manutenção do SQL Managed Instance
O exemplo seguinte retorna as janelas de manutenção disponíveis para a região eastus2 usando o cmdlet Get-AzMaintenancePublicConfiguration. Para instâncias gerenciadas, defina MaintenanceScope como SQLManagedInstance.
$___location = "eastus2"
Write-Host "Available maintenance schedules in ${___location}:"
$configurations = Get-AzMaintenancePublicConfiguration
$configurations | ?{ $_.Location -eq $___location -and $_.MaintenanceScope -eq "SQLManagedInstance"}
Definir a janela de manutenção ao criar uma instância gerenciada pelo SQL
O exemplo a seguir cria uma nova instância gerenciada SQL e define a janela de manutenção usando o cmdlet New-AzSqlInstance . A janela de manutenção é definida na instância, portanto, todos os bancos de dados na instância têm o mesmo agendamento de janela de manutenção. Para -MaintenanceConfigurationId, o MaintenanceConfigName deve ser um valor válido para a região da sua instância. Para obter valores válidos para a sua região, consulte Descubra janelas de manutenção disponíveis.
New-AzSqlInstance -Name "your_mi_name" `
-ResourceGroupName "your_resource_group_name" `
-Location "your_mi_location" `
-SubnetId /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} `
-MaintenanceConfigurationId "/subscriptions/{SubID}/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_{Region}_{MaintenanceConfigName}"
Os exemplos a seguir mostram como configurar a janela de manutenção usando a CLI do Azure. Você pode instalar a CLI do Azureou usar o Shell do Azure na Cloud.
Iniciar o Azure Cloud Shell
O Azure Cloud Shell é um shell interativo gratuito que você pode usar para executar as etapas neste artigo. Tem ferramentas comuns do Azure pré-instaladas e configuradas para utilização com a sua conta.
Para abrir o Cloud Shell, selecione Experimentar no canto superior direito de um bloco de código. Você também pode iniciar o Cloud Shell em uma guia separada do navegador acessando https://shell.azure.com.
Quando Cloud Shell abrir, verifique se Bash está selecionado para o seu ambiente. As sessões subsequentes usarão a CLI do Azure em um ambiente Bash. Selecione Copiar para copiar os blocos de código, cole-o no Cloud Shell e pressione Enter para executá-lo.
Entrar no Azure
Cloud Shell é autenticado automaticamente com a conta inicial com que fez login. Use o script a seguir para entrar usando uma assinatura diferente, substituindo-<Subscription ID> pela sua ID de Assinatura do Azure. Se você não tiver uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
subscription="<subscriptionId>" # add subscription here
az account set -s $subscription # ...or use 'az login'
Para obter mais informações, consulte ativar subscrição ativa ou iniciar sessão de forma interativa
Descubra as janelas de manutenção disponíveis
Ao definir a janela de manutenção, cada região tem suas próprias opções de janela de manutenção que correspondem ao fuso horário da região.
Descubra as janelas de manutenção do SQL Managed Instance
O exemplo a seguir retorna as janelas de manutenção disponíveis para a região eastus2 usando o comando az maintenance public-configuration list . Para instâncias gerenciadas, defina maintenanceScope como SQLManagedInstance.
az maintenance public-configuration list --query "[?___location=='eastus2'&&contains(maintenanceScope,'SQLManagedInstance')]"
Definir a janela de manutenção ao criar uma instância gerenciada pelo SQL
O exemplo a seguir cria uma nova instância gerenciada pelo SQL e define a janela de manutenção usando az sql mi create. A janela de manutenção é definida na instância, portanto, todos os bancos de dados na instância têm o mesmo agendamento de janela de manutenção.
MaintenanceConfigName deve ser um valor válido para a região da sua instância. Para obter valores válidos para a sua região, consulte Descubra janelas de manutenção disponíveis. Substitua <password> por uma senha válida.
az sql mi create -g mygroup -n myinstance -l mylocation -i -u myusername -p <password> --subnet /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Network/virtualNetworks/{VNETName}/subnets/{SubnetName} -m /subscriptions/{SubID}/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_{Region}_{MaintenanceConfigName}
Quando você aplica uma seleção de janela de manutenção a uma instância gerenciada pelo SQL, uma breve reconfiguração (vários segundos) pode ser experimentada em alguns casos, pois o Azure aplica as alterações necessárias.
As etapas a seguir definem a janela de manutenção em uma instância gerenciada SQL existente usando o portal do Azure:
Definir a janela de manutenção para uma instância gerenciada SQL existente
Navegue até a instância gerenciada do SQL para a qual você deseja definir a janela de manutenção.
No menu Configurações, selecione Manutençãoe, em seguida, selecione a janela de manutenção desejada.
Definir a janela de manutenção em uma instância gerenciada SQL existente
O exemplo a seguir define a janela de manutenção em uma instância gerenciada SQL existente usando o cmdlet Set-AzSqlInstance .
É importante certificar-se de que o valor $maintenanceConfig deve ser um valor válido para a região da sua instância. Para obter valores válidos para uma região, consulte Descubra janelas de manutenção disponíveis.
Set-AzSqlInstance -Name "your_mi_name" `
-ResourceGroupName "your_resource_group_name" `
-MaintenanceConfigurationId "/subscriptions/{SubID}/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_{Region}_{MaintenanceConfigName}"
Os exemplos a seguir mostram como configurar a janela de manutenção usando a CLI do Azure. Você pode instalar a CLI do Azureou usar o Shell do Azure na Cloud.
Definir a janela de manutenção em uma instância gerenciada SQL existente
O exemplo a seguir define a janela de manutenção usando az sql mi update. A janela de manutenção é definida na instância, portanto, todos os bancos de dados na instância têm o mesmo agendamento de janela de manutenção. Para -MaintenanceConfigurationId, o MaintenanceConfigName deve ser um valor válido para a região da sua instância. Para obter valores válidos para a sua região, consulte Descubra janelas de manutenção disponíveis.
az sql mi update -g mygroup -n myinstance -m /subscriptions/{SubID}/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_{Region}_{MaintenanceConfigName}
Observação
Para exibir nomes amigáveis no portal do Azure, a Instância Gerenciada SQL do Azure depende de configurações de manutenção como um recurso. As definições de manutenção para a Instância Gerenciada SQL do Azure fazem parte das configurações de manutenção pública. Pode ocorrer uma situação para regiões do Azure recém-adicionadas nas quais a Instância Gerenciada do SQL pode ser usada na região, enquanto as configurações de manutenção pública ainda estão sendo criadas. Nesse caso, o portal do Azure não exibe os nomes amigáveis do usuário na lista suspensa e os usuários veem esses nomes de sistema:
- MI_1 O equivalente para a janela do dia da semana: das 22:00 às 06:00, hora local, de segunda a quinta-feira
- MI_2 O equivalente para a janela de fim de semana: das 22h00 às 6h00, horário local, de sexta a domingo
Instância Gerenciada SQL do Azure