Mover a Instância Gerenciada de SQL do Azure entre sub-redes

Aplica-se a:Instância Gerenciada de SQL do Azure

Este artigo explica como mover a Instância Gerenciada de SQL do Azure de uma sub-rede para outra sub-rede na mesma rede virtual ou em uma rede virtual diferente. A operação é semelhante ao dimensionamento de vCores ou à alteração da camada de serviço da instância. Durante a migração, a Instância Gerenciada de SQL permanece disponível, exceto por um curto período de inatividade quando ocorre o failover, que normalmente dura até 10 segundos, mesmo que transações de longa duração sejam interrompidas.

A movimentação da instância para outra sub-rede dispara as seguintes operações de cluster virtual:

O cluster virtual cria ou redimensiona a infraestrutura subjacente na sub-rede de destino.
O cluster virtual é removido ou desfragmentado na sub-rede de origem.

Requisitos e limitações

Você deve implantar a Instância Gerenciada de SQL dentro de uma sub-rede dedicada em uma rede virtual do Azure. O tamanho da sub-rede (intervalo de sub-rede) determina quantas instâncias gerenciadas de SQL você pode implantar na sub-rede. Para implantar uma instância gerenciada de SQL ou movê-la para outra sub-rede, a sub-rede de destino deve atender a determinados requisitos de rede.

Antes de mover a instância para outra sub-rede, examine os seguintes conceitos:

Determine o tamanho e o intervalo da sub-rede necessários para a Instância Gerenciada de SQL do Azure.
Escolha entre mover a instância para uma nova sub-rede ou usar uma sub-rede existente.
Use operações de gerenciamento para implantar automaticamente novas instâncias gerenciadas, atualizar as propriedades da instância ou excluir instâncias. Você pode monitorar essas operações de gerenciamento.

Antes de iniciar a movimentação da sub-rede, verifique se a conectividade é permitida entre as subredes de origem e destino nas portas 5022 e 11000-11999. Essa verificação inclui validar todo o caminho da rede e garantir que quaisquer rotas definidas pelo usuário, appliances virtuais de rede (NVAs), firewalls ou outros dispositivos de rede não estejam bloqueando o tráfego nessas portas.

Preparação da sub-rede

Antes de mover sua instância gerenciada de SQL, confirme se a sub-rede está marcada como Pronta para Instância Gerenciada.

Na interface do usuário da rede virtual do portal do Azure, as redes virtuais que atendem aos pré-requisitos de uma instância gerenciada de SQL são categorizadas como Prontas para Instância Gerenciada. As redes virtuais que têm sub-redes com instâncias gerenciadas de SQL já implantadas neles exibem um ícone da Instância Gerenciada de SQL antes do nome da rede virtual. Sub-redes vazias e prontas para hospedar uma Instância Gerenciada de SQL exibem um ícone de sub-rede de rede virtual.

As sub-redes marcadas como Não prontas não atendem a todos os requisitos para implantação de Instância Gerenciada de SQL. Para saber por que a sub-rede não está pronta e se a sub-rede pode atender aos requisitos de rede, use o ícone de informações à direita do nome da sub-rede. Estes requisitos incluem:

delegando ao provedor de recursos Microsoft.Sql/managedInstances
anexar uma tabela de rotas
associar um grupo de segurança de rede

Se a sub-rede fizer parte de outra rede virtual, você precisará:

Emparelhamento bidirecional entre a rede virtual atual e de destino.
As sub-redes atuais e de destino usam tabelas de rotas e grupos de segurança de rede separados.

Depois de atender a esses requisitos, a sub-rede passa da categoria Não pronta para a categoria Pronta para Instância Gerenciada e pode ser usada para uma instância gerenciada de SQL.

Sub-redes que já estão em uso (sub-redes usadas para implantações de instância não podem conter outros recursos) ou sub-redes que têm uma zona DNS diferente (uma limitação de movimentação entre instâncias de sub-rede) sempre fazem parte da categoria Não pronta .

Dependendo do estado e da designação da sub-rede, os seguintes ajustes podem ser feitos na sub-rede de destino:

Pronto para a Instância Gerenciada (contém a Instância Gerenciada de SQL existente)

Nenhum ajuste é feito. Essas sub-redes já contêm instâncias gerenciadas de SQL e fazer qualquer alteração na sub-rede pode afetar as instâncias existentes.
Pronto para a Instância Gerenciada (vazia)

O fluxo de trabalho valida todas as regras necessárias no grupo de segurança de rede e na tabela de rotas e adiciona todas as regras necessárias, mas ausentes. As regras personalizadas que você adiciona à configuração de sub-rede de origem não são copiadas para a sub-rede de destino. Você deve replicar manualmente qualquer personalização da configuração de sub-rede de origem para a sub-rede de destino. Uma maneira de obter essa replicação é usando a mesma tabela de rotas e o grupo de segurança de rede para a sub-rede de origem e destino.

Limitações da sub-rede de destino

Considere as seguintes limitações ao escolher uma sub-rede de destino para uma instância existente:

Você pode mover a Instância Gerenciada de SQL para uma sub-rede que seja:
- Na mesma rede virtual que a usada atualmente, ou
- Em uma rede virtual emparelhada, se estiver movendo para uma sub-rede em outra rede virtual.
A zona DNS das instâncias na sub-rede de destino deve corresponder à zona DNS da instância que está sendo movida. Essa limitação se aplica se você pretende migrar para uma sub-rede não vazia.

Você pode preparar especialmente a sub-rede de destino para manter a zona DNS da instância gerenciada de SQL que você está movendo. Prepare a sub-rede criando uma nova instância gerenciada de SQL em uma sub-rede vazia e fornecendo o dnsZonePartner parâmetro na solicitação create. Esse parâmetro como um valor aceita a ID da Instância Gerenciada de SQL e, nesse caso, você pode usar a instância que posteriormente seria movida para a nova sub-rede.

Além dessa abordagem, não há outra maneira de ditar a zona DNS da Instância Gerenciada de SQL, pois ela é gerada aleatoriamente. Atualmente, não há como atualizar a zona DNS de uma instância gerenciada de SQL existente.

Se você quiser migrar uma Instância Gerenciada de SQL com um grupo de failover, os seguintes pré-requisitos se aplicam:

A sub-rede alvo deve permitir o mesmo tráfego de replicação exigido para o grupo de failover que a sub-rede de origem:

Abra tanto as portas de entrada quanto as de saída 5022 e o intervalo 11000-11999 no NSG (Grupo de Segurança de Rede) para conexões da outra sub-rede da instância gerenciada de SQL (aquela que contém a réplica do grupo de failover), a fim de permitir o tráfego de replicação entre as duas instâncias. Certifique-se de que o caminho completo da rede também permita esse tráfego. Uma rota definida pelo usuário, um Appliance Virtual de Rede, um firewall ou outro dispositivo intermediário ainda pode bloquear as portas mesmo quando as regras NSG estão corretas.
A sub-rede de destino não pode ter uma faixa de endereços sobreposta à da sub-rede que hospeda a réplica da instância secundária do grupo de failover.

Por exemplo, se o MI1 estiver na sub-rede S1, a instância secundária no grupo de failover será MI2 na sub-rede S2. Você deseja mover o MI1 para a sub-rede S3. A sub-rede S3 não pode ter um intervalo de endereços sobreposto com a sub-rede S2.

Para saber mais sobre como configurar a rede para grupos de failover, examine Habilitar replicação geográfica entre instâncias gerenciadas de SQL.

Etapas da operação

Mover uma instância de uma sub-rede para outra envolve muitas etapas. Dependendo de como sua instância gerenciada de SQL está configurada, a operação de movimentação pode levar de 30 minutos a 6 horas.

A seguinte tabela detalha as etapas que ocorrem durante a operação de movimentação de instância:

Nome da etapa	Descrição da etapa
Validação de solicitação	Valida os parâmetros enviados. Se uma configuração incorreta for detectada, a operação falhará com um erro.
Redimensionamento ou criação de cluster virtual	Dependendo do estado da sub-rede de destino, o cluster virtual é criado ou redimensionado.
Inicialização da nova instância	O processo de SQL é iniciado no cluster virtual implantado na sub-rede de destino.
Como propagar ou anexar arquivos de banco de dados	Dependendo do nível de serviço, o banco de dados é inicializado ou os arquivos do banco de dados são anexados.
Como preparar o failover	Depois que os dados são semeados ou os arquivos de banco de dados são reanexados, o sistema se prepara para o failover. Quando tudo estiver pronto, o sistema executará um failover com um tempo de inatividade curto, normalmente menos de 10 segundos.
Limpeza da instância SQL antiga	Remove o processo de SQL antigo do cluster virtual de origem.
Exclusão do cluster virtual	Se esta for a última instância dentro da sub-rede de origem, a etapa final excluirá o cluster virtual de maneira síncrona. Caso contrário, o cluster virtual será desfragmentado de maneira assíncrona.

Para obter uma explicação detalhada das etapas de operação, consulte Duração das operações de gerenciamento na Instância Gerenciada de SQL do Azure.

Mover a instância

Uma movimentação de instância entre sub-redes faz parte da operação de atualização da instância. Os comandos da API de atualização de instância existente, do Azure PowerShell e da CLI do Azure são aprimorados com uma propriedade de ID de sub-rede.

No portal do Azure, use o campo de sub-rede no painel Rede para mover a instância para a sub-rede de destino. Ao usar Azure PowerShell ou a CLI do Azure, forneça uma ID de sub-rede diferente no comando de atualização para mover a instância de uma sub-rede existente para a sub-rede de destino.

Para obter uma referência completa dos comandos de gerenciamento de instância, consulte a referência da API Gerenciada para a Instância Gerenciada de SQL do Azure.

Você pode escolher a sub-rede de instância no painel Rede do portal do Azure. Depois de selecionar uma sub-rede e salvar as alterações, a operação de movimentação da instância será iniciada.

A operação de movimentação primeiro prepara a sub-rede de destino para implantação, o que pode levar vários minutos. Depois que a sub-rede estiver pronta, a operação de gerenciamento de movimentação de instância será iniciada e aparecerá no portal do Azure.

Você pode monitorar as operações de movimentação de instância do painel Visão geral do portal do Azure. Selecione a notificação para abrir outro painel que contém informações sobre a etapa atual, as etapas totais e um botão para cancelar a operação.

Use o comando Set-AzSqlInstance do Azure PowerShell para mover uma instância depois de criar sua sub-rede na mesma rede virtual que a sub-rede de destino. Para usar uma sub-rede existente, forneça esse nome de sub-rede no comando do PowerShell.

Os comandos do PowerShell de exemplo nesta seção preparam a sub-rede de destino para a implantação de instância e movem a instância gerenciada de SQL.

Use o seguinte comando do PowerShell para especificar seus parâmetros:

### PART 1 - DEFINE PARAMETERS

#Generating basic parameters
$currentSubscriptionID = 'subscription-id'
$sqlMIResourceGroupName = 'resource-group-name-of-sql-mi'
$sqlMIName = 'sql-mi-name'
$sqlMIResourceVnetName = 'vnet-name-of-sql-mi'
$destinationSubnetName = 'name-of-the-destination-subnet-for-sql-mi'

Ignore este comando se sua sub-rede já tiver instâncias implantadas nela. Se você estiver usando uma nova sub-rede, use o seguinte comando do Azure PowerShell para prepará-la:

### PART 2 - PREPARE DESTINATION SUBNET

#Loading the url of script used for preparing the subnet for SQL MI deployment
$scriptUrlBase = 'https://raw.githubusercontent.com/Microsoft/sql-server-samples/master/samples/manage/azure-sql-db-managed-instance/delegate-subnet'

#Generating destination subnet parameters
$parameters = @{
    subscriptionId = $currentSubscriptionID
    resourceGroupName = $sqlMIResourceGroupName
    virtualNetworkName = $sqlMIResourceVnetName
    subnetName = $destinationSubnetName
}

#Initiating subnet preparation script
Invoke-Command -ScriptBlock ([Scriptblock]::Create((Invoke-WebRequest ($scriptUrlBase + '/delegateSubnet.ps1?t=' + [DateTime]::Now.Ticks)).Content)) -ArgumentList $parameters

Observação

Para saber mais sobre o script que prepara a sub-rede, confira Configurar uma rede virtual existente para a Instância Gerenciada de SQL do Azure.

O seguinte comando do Azure PowerShell move a instância para a sub-rede de origem:

### PART 3 - MOVE INSTANCE TO THE NEW SUBNET

Set-AzSqlInstance -Name $sqlMIName -ResourceGroupName $sqlMIResourceGroupName `
    -SubnetId "/subscriptions/$currentSubscriptionID/resourceGroups/$sqlMIResourceGroupName/providers/Microsoft.Network/virtualNetworks/$sqlMIResourceVnetName/subnets/$destinationSubnetName"

O seguinte comando do Azure PowerShell move a instância e também oferece um modo de monitorar o progresso:

### PART 3 EXTENDED - MOVE INSTANCE AND MONITOR PROGRESS

# Extend the Set-AzSqlInstance command with -AsJob -Force parameters to be able to monitor the progress or proceed with script execution as moving the instance to another subnet is long running operation
Set-AzSqlInstance -Name $sqlMIName -ResourceGroupName $sqlMIResourceGroupName `
    -SubnetId "/subscriptions/$currentSubscriptionID/resourceGroups/$sqlMIResourceGroupName/providers/Microsoft.Network/virtualNetworks/$sqlMIResourceVnetName/subnets/$destinationSubnetName" -AsJob -Force

$operationProgress = Get-AzSqlInstanceOperation -ManagedInstanceName $sqlMIName -ResourceGroupName $sqlMIResourceGroupName
#checking the operation step status
Write-Host "Checking the ongoing step" -ForegroundColor Yellow
$operationProgress.OperationSteps.StepsList

Use o comando az sql mi update da CLI do Azure para mover a instância para outra sub-rede.

Forneça o destino especificando a ID da sub-rede como a propriedade --subnet ou especificando o nome da rede virtual como a propriedade --vnet-name e o nome da sub-rede como a propriedade --subnet.

O exemplo a seguir move a instância gerenciada de SQL para outra sub-rede especificando a ID da sub-rede:

az sql mi update -g myResourceGroup -n mySqlManagedInstance --subnet /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVirtualNetworkName/subnets/destinationSubnetName

O exemplo a seguir move a instância gerenciada de SQL para outra sub-rede especificando o nome da rede virtual e o nome da sub-rede:

az sql mi update -g myResourceGroup -n mySqlManagedInstance --vnet-name myVirtualNetworkName --subnet destinationSubnetName

Use o seguinte comando para monitorar o progresso da operação de gerenciamento:

az sql mi op list -g myResourceGroup --mi mySqlManagedInstance

Comentários

Esta página foi útil?

Last updated on 2026-07-14