Gerenciar a conexão automática para SQL Servers habilitado pelo Azure Arc

Aplica-se ao:SQL Server

As instâncias do SQL Server são conectadas automaticamente ao Azure Arc quando instaladas em um servidor habilitado para Azure Arc e o recurso de servidor do Arc está em uma região com suporte. 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 obter mais informações, visite SQL Server habilitado pelo Azure Arc.

Este artigo detalha como funciona o processo simplificado de conexão do SQL Server ao Azure.

Observação

Atualmente, a configuração menos privilegiada não é aplicada por padrão.

Servidores existentes com versão 1.1.2859.223 de extensão ou superior eventualmente terão a configuração menos privilegiada aplicada. Essa extensão foi lançada em novembro de 2024. Para impedir a aplicação automática de privilégios mínimos, bloqueie as atualizações de extensão após 1.1.2859.223.

Pré-requisitos

Conclua os pré-requisitos – SQL Server habilitado pelo Azure Arc.
Para grupos de disponibilidade Always On, conclua as etapas em todos os nós.

Especifique o tipo de licença

Opcionalmente, especifique o tipo de licença de cada instância do SQL Server.

Para especificar o tipo de licença desejado, forneça a marca de valor do tipo de licença. O fluxo de trabalho de conexão automática exige essa marca. Para obter mais informações, consulte Recursos de marca, grupos de recursos e assinaturas para obter uma organização lógica.

Você pode definir valores de etiqueta na assinatura, grupo de recursos ou nível de recurso. Valores de marca definidos no nível da assinatura substituem os valores definidos no grupo de recursos e no nível do recurso. Valores de marca definidos no nível do grupo de recursos substituem os valores definidos no nível do recurso.

Adicione uma das tags e valores a seguir a sua assinatura, grupos de recursos ou recursos do servidor Arc.

Marca	Valor
`ArcSQLServerExtensionDeployment`	`Paid`
`ArcSQLServerExtensionDeployment`	`PAYG`
`ArcSQLServerExtensionDeployment`	`LicenseOnly`

Importante

Para maximizar o valor do Azure Arc para clientes do SQL Server, a Microsoft usará um processo automatizado para determinar o valor do tipo de licença se você ainda não definiu o valor padrão usando a ArcSQLServerExtensionDeployment marca. Se o seu SQL Server estiver coberto pelo Software Assurance (SA) ou pela Assinatura e Suporte e o número de licenças que você comprou for maior do que o número de licenças que você já comprometeu com o Azure para usar o Benefício Híbrido do Azure, esse processo definirá o valor do tipo de licença como Pago pelas instâncias integradas do SQL Server por ordem de chegada. Como resultado, você tem acesso automaticamente a recursos de gerenciamento valiosos fornecidos aos clientes SA.

Precedência de configuração de tipo de licença

Instalar automaticamente a Extensão do Azure para SQL Server em novos servidores conectados ao Arc

A Microsoft instala automaticamente a extensão do Azure para SQL Server em cada servidor habilitado para Arc conectado ao Azure Arc quando ele tem alguma instância do SQL Server instalada. Esse processo automatizado envolve as seguintes tarefas:

Registre o provedor de recursos Microsoft.AzureArcData se ainda não estiver registrado.
Definir o tipo de licença.
Instale a extensão do Azure para SQL Server.

Observação

O tipo de licença será definido se o valor da marca ArcSQLServerExtensionDeployment for definido.
Crie um recurso de instância do SQL Server habilitado para Arc no Azure.

Para conectar automaticamente o SQL Server habilitado pelo Azure Arc, use um dos métodos fornecidos que atendam às suas opções de implantação de requisitos para o SQL Server habilitado pelo Azure Arc.

Depois que a conexão for concluída, você poderá se beneficiar dos recursos do Azure para SQL Server. Para obter mais informações, visite Configurar o SQL Server habilitado pelo Azure Arc.

Verifique e corrija a configuração do tipo de licença

Para verificar a configuração do tipo de licença criada pelo processo de integração, execute esta consulta de gráfico de recursos.

resources
| where type == "microsoft.hybridcompute/machines"
| extend
    joinID = toupper(id)
| join kind = inner (
    resources
    | where type == "microsoft.hybridcompute/machines/extensions"
    | extend machineId = toupper(substring(id, 0, indexof(id, '/extensions')))
    | where properties.type in ("WindowsAgent.SqlServer","LinuxAgent.SqlServer")
    | extend licenseType = iff(properties.settings.LicenseType == '', 'Configuration needed', properties.settings.LicenseType)
    | project  machineId, licenseType
) on $left.joinID == $right.machineId
| project id, licenseType

O valor Configuration needed indica que o processo de integração não tinha informações suficientes para configurar o tipo de licença automaticamente. Para obter detalhes sobre como definir o valor ausente ou alterar um valor configurado automaticamente, visite Configurar o SQL Server habilitado pelo Azure Arc.

Observação

Quando o tipo de licença é Pago ou PAYG, recursos de gerenciamento adicionais estão disponíveis para instâncias cobertas pelo Software Assurance ou licenças pagas conforme o uso.

Descadastrar conexão automática

Para descadastrar a instalação automática da extensão do Azure para SQL Server, adicione a seguinte tag e valor a uma assinatura, grupo(s) de recursos ou recurso(s) do Arc Server. Se já houver servidores habilitados para Arc na assinatura ou no grupo de recursos, pode levar até 8 horas para que as alterações no valor da tag tenham efeito, pois o valor da tag é armazenado em cache.

Marca	Valor
`ArcSQLServerExtensionDeployment`	`Disabled`

Como alternativa, você pode limitar as extensões que podem ser instaladas no servidor. Você pode configurar listas de extensões que deseja permitir e bloquear no servidor. Para saber mais, confira Listas de permissões e listas de bloqueio de extensão.

Saiba como a Microsoft instala automaticamente a extensão do Azure para SQL Server

A Microsoft pode executar instalações de extensão em um servidor habilitado para Arc por meio do serviço Windows Guest Configuration Extension (ExtensionService). Quando o servidor está conectado ao Arc, o serviço Windows Guest Configuration Extension (ExtensionService) é instalado. O serviço é responsável por instalar, atualizar e excluir extensões (agentes, scripts ou outros softwares) no computador. Os serviços de configuração de convidado e extensão são executados como sistema local no Windows e como raiz no Linux. Para obter detalhes sobre os serviços de agente e as contas de serviço do Arc, confira Segurança e permissões do agente | Segurança e permissões do agente

A Microsoft pode chamar APIs para implantar a extensão do Azure para SQL Server e se conectar automaticamente ao SQL Server habilitado para Arc.

Você também pode instalar extensões usando portal do Azure, APIs do ARM (Azure Resource Manager), Azure Policy, modelos do ARM, CLI do Azure ou módulo do Azure PowerShell. Opções de implantação para o SQL Server habilitado pelo Azure Arc

Localizar instâncias do SQL Server conectadas ao Arc, mas a extensão do Azure está ausente para o SQL Server

Use a consulta de grafo do Azure a seguir para listar as IDs de máquina e assinatura que contêm Servidores Arc com SQL Server instalados, mas sem a extensão do Azure para SQL Server.

resources
| where type == "microsoft.hybridcompute/machines" and properties['detectedProperties']['mssqldiscovered'] has "true"
| extend
    joinID = toupper(id)
| join kind= inner  (
    resources
    | where type == "microsoft.hybridcompute/machines/extensions"
    | extend machineId = toupper(substring(id, 0, indexof(id, '/extensions')))
    | project machineId, name
    | summarize allExtensions = make_list(name) by machineId
    | where allExtensions !has ("SqlServer")
) on $left.joinID == $right.machineId
| project id, subscriptionId, tenantId

Atualizar a extensão

Para determinar a versão do lançamento atual da extensão, 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 Atualizar extensão.

Comentários

Esta página foi útil?

Last updated on 2025-12-17