Conectar seu SQL Server ao Azure Arc em um servidor já habilitado pelo Azure Arc

Aplica-se ao:SQL Server

Este artigo explica como conectar sua instância do SQL Server ao Azure Arc em um servidor habilitado para Arc. Por exemplo, você precisa usar esse método para conectar uma instância do SQL Server ao Azure Arc neste momento na região da Virgínia do Governo dos EUA, porque a conexão automática não está disponível atualmente nessa região. Para esse caso, siga as etapas em Conectar.

Se o servidor físico ou virtual ainda não estiver conectado ao Azure, siga as etapas em Conectar seu SQL Server ao Azure Arc.

Importante

O Azure Arc instala automaticamente a extensão do Azure para SQL Server quando um servidor conectado ao Azure Arc possui o SQL Server instalado. Todos os recursos de instância do SQL Server são criados automaticamente no Azure, fornecendo uma plataforma de gerenciamento centralizada a todas as instâncias do SQL Server.

Para conectar automaticamente suas instâncias do SQL Server, consulte Conectar automaticamente seu SQL Server ao Azure Arc.

Use o método descrito neste artigo se o servidor já estiver conectado ao Azure, mas a extensão do Azure para SQL Server não for implantada automaticamente.

Uma tag ArcSQLServerExtensionDeployment = Disabled será criada no recurso de máquina do Arc se a extensão for implantada por esse método.

Pré-requisitos

Verifique se Microsoft.AzureArcData está registrado em cada assinatura. Examine as instruções em Registrar provedores de recursos.

Examine todos os pré-requisitos em Pré-requisitos – SQL Server habilitado pelo Azure Arc.

Se o computador com SQL Server já estiver conectado ao Azure Arc, para conectar as instâncias do SQL Server, instale a Extensão do Azure para SQL Server. A extensão está na guia de extensão do recurso "Servidor – Azure Arc" como Extensão do Azure para SQL Server.

Importante

O recurso do Azure com o tipo SQL Server - Azure Arc representando a instância do SQL Server instalada na máquina usa a mesma região e grupo de recursos que os recursos do Azure para os servidores habilitados para Arc.

Conectar

Para instalar a extensão do Azure para SQL Server, use as seguintes etapas:

Abra o recurso Azure Arc > Servidores.
Pesquise o servidor conectado com a instância do SQL Server que você deseja conectar ao Azure.
Em Extensões, selecione + Adicionar.
Selecione Azure extension for SQL Server e Avançar.
Especifique a edição do SQL Server e o tipo de licença que você está usando neste computador. Alguns recursos do SQL Server habilitados para Arc só estão disponíveis para instâncias do SQL Server com Software Assurance (Pago) ou com pagamento conforme o uso do Azure. Para obter mais informações, examine Configurar o SQL Server habilitado pelo Azure Arc.
Especifique as instâncias do SQL Server que você deseja excluir do registro (se houver diversas instâncias a ignorar, separe-as com espaços) e selecione Examinar + criar.
Selecione Criar.

Para instalar a extensão do Azure para SQL Server, execute:

$Settings = @{ SqlManagement = @{ IsEnabled = $true }; ExcludedSqlInstances = @(<Comma separated names of SQL Server instances, eg: "MSSQLSERVER01","MSSQLSERVER">); LicenseType="<License Type>"}

New-AzConnectedMachineExtension -Name "WindowsAgent.SqlServer" -ResourceGroupName {your resource group name} -MachineName {your machine name} -Location {azure region} -Publisher "Microsoft.AzureData" -Settings $Settings -ExtensionType "WindowsAgent.SqlServer"

Para instalar a extensão do Azure para SQL Server do Sistema Operacional Windows, execute:

az connectedmachine extension create --machine-name "{your machine name}" --location "{azure region}" --name "WindowsAgent.SqlServer" --resource-group "{your resource group name}" --type "WindowsAgent.SqlServer" --publisher "Microsoft.AzureData" --settings "{\"SqlManagement\":{\"IsEnabled\":true}, \"LicenseType\":\"<License Type>\", \"ExcludedSqlInstances\":[]}"

Para instalar a extensão do Azure para SQL Server do Sistema Operacional Linux, execute:

settings="{\"SqlManagement\":{\"IsEnabled\":true},\"LicenseType\":\"<License Type>\"}"
az connectedmachine extension create --machine-name "{your machine name}" --location "{azure region}" --name "LinuxAgent.SqlServer" --resource-group "{your resource group name}" --type "LinuxAgent.SqlServer" --publisher "Microsoft.AzureData" --settings $settings

Os possíveis tipos de licenciamento que você pode definir são:

PAYG
Paid
LicenseOnly

A extensão do Azure para SQL Server para Linux está disponível em versão preliminar.

Depois de instalada, a extensão do Azure para SQL Server reconhece todas as instâncias do SQL Server instaladas e as conecta com o Azure Arc.

A extensão é executada continuamente para detectar alterações na configuração do SQL Server. Por exemplo, se uma nova instância do SQL Server for instalada no computador, a extensão a detectará e registrará automaticamente no Azure Arc. Confira Gerenciamento de extensão de máquina virtual para obter instruções sobre como instalar e desinstalar extensões para o agente do computador conectado do Azure usando o portal do Azure, Azure PowerShell ou CLI do Azure.

Validar os recursos do SQL Server habilitados para Arc

Acesse Azure Arc > SQL Server e abra o recurso do SQL Server habilitado para Arc recém-registrado a ser validado.

Atualizar a extensão

Para determinar a versão da extensão atual, examine as notas de versão.

Para verificar a versão da extensão, use o seguinte comando do PowerShell:

azcmagent version

Para simplificar as atualizações de extensão, habilite as atualizações automáticas. Você também pode atualizar manualmente a extensão usando o portal do Azure, o PowerShell e a CLI do Azure.

Para atualizar a extensão no portal do Azure, siga estas etapas:

No portal do Azure, acesse Computadores – Azure Arc.
Selecione o nome do computador em que o SQL Server está instalado para abrir o painel Visão Geral do servidor.
Em Configurações, selecione Extensões.
Marque a caixa da WindowsAgent.SqlServer extensão e selecione Atualizar no menu de navegação.
Selecione Sim na caixa de diálogo de confirmação da extensão Atualizar para concluir a atualização.

Para atualizar a extensão usando o PowerShell, primeiro instale o Az.ConnectedMachine módulo com o seguinte comando (caso ainda não tenha feito isso):

Install-Module -Name Az.ConnectedMachine

Em seguida, use o seguinte comando para atualizar a extensão:

# Variables 
$Subscription_Id = "<SubscriptionId>" 
$ResourceGroup = "<ResourceGroup>" 
$MachineName = "<MachineName>" 
$ExtensionName = "WindowsAgent.SqlServer" 
$Publisher = "Microsoft.AzureData" 
$TargetVersion = "<LatestVersion>"  # Example: 1.1.3211.337 

# Upgrade the extension 
Set-AzContext -Subscription $SubscriptionId 

$params = @{
  ResourceGroupName = $ResourceGroup
  MachineName = $MachineName
  Name = $ExtensionName
  Publisher = $Publisher
  Type = $ExtensionName
  TypeHandlerVersion = $TargetVersion
}

Update-AzConnectedMachineExtension @params

Para atualizar a extensão usando a CLI do Azure, primeiro instale a connectedmachine extensão com o seguinte comando (caso ainda não tenha feito isso):

az extension add --name connectedmachine

Em seguida, use o seguinte comando para atualizar a extensão:

# Variables 
Subscription_Id="<SubscriptionId>" 
Resource_Group="<ResourceGroup>" 
Machine_Name="<ArcEnabledServerName>" 
Extension_Name="WindowsAgent.SqlServer" 
Publisher="Microsoft.AzureData" 
Target_Version="<LatestVersion>"  # Example: 1.1.3211.337 

# Upgrade the extension 

az account set --subscription $Subscription_Id 
az connectedmachine extension update \ 
    --resource-group $Resource_Group \ 
    --machine-name $Machine_Name \ 
    --name $Extension_Name \ 
    --publisher $Publisher \ 
    --type $Extension_Name \ 
    --type-handler-version $Target_Version

Para obter mais informações sobre como atualizar a extensão do Azure para SQL Server, consulte Extensão de Atualização.

Comentários

Esta página foi útil?

Last updated on 2025-12-17