Configurar o SQL Server habilitado pelo Azure Arc

Aplica-se a:SQL Server

Cada servidor habilitado para o Azure Arc inclui um conjunto de propriedades que se aplicam a todas as instâncias do SQL Server instaladas nesse servidor. Você poderá configurar essas propriedades depois que a extensão do Azure para SQL Server for instalada no computador. No entanto, as propriedades só terão efeito se uma ou mais instâncias do SQL Server estiverem instaladas. No portal do Azure, a visão geral do SQL Server habilitado pelo Azure Arc reflete como a configuração do SQL Server afeta uma instância específica.

A Configuração do SQL Server do portal do Azure permite que você execute as seguintes tarefas de gerenciamento:

1. Configurar o tipo de licença do SQL Server
2. Definir a propriedade Atualizações de Segurança Estendidas
3. Adicionar à lista Excluir instâncias

Pré-requisitos

• Você tem a função Colaborador em, pelo menos, uma das assinaturas do Azure criadas pela sua organização. Saiba como criar uma assinatura para cobrança.
• Você tem a função Colaborador no grupo de recursos em que a instância do SQL Server será gerenciada. Confira Grupos de recursos gerenciados do Azure para obter detalhes.
• Os provedores de recursos Microsoft.AzureArcData e Microsoft.HybridCompute são registrados em cada assinatura usada para a cobrança de pagamento conforme o uso do SQL Server.

Registrar provedores de recursos

Para registrar os provedores de recursos, use um dos métodos abaixo:

Portal do Azure

1. Selecione Assinaturas
2. Escolha sua assinatura
3. Em Configurações, selecione Provedores de recursos
4. Procure por Microsoft.AzureArcData e Microsoft.HybridCompute, em seguida, selecione Registrar

PowerShell

Execute:

Register-AzResourceProvider -ProviderNamespace Microsoft.AzureArcData

CLI do Azure

Execute:

az provider register --namespace 'Microsoft.AzureArcData'

Modificar a configuração do SQL Server

Você pode usar o portal do Azure, o PowerShell ou a CLI para alterar todas ou algumas configurações em um servidor específico habilitado para o Arc para o estado desejado.

Para modificar a configuração do SQL Server para um escopo maior, como um grupo de recursos, uma assinatura ou várias assinaturas com um único comando, use o script modify-license-type.ps1 do PowerShell. Ele é publicado como um exemplo de código aberto do SQL Server e inclui as instruções passo a passo.

Dica

Execute o script do Azure Cloud Shell porque:

• Ele tem os módulos necessários do Azure PowerShell pré-instalados
• Ele autentica você automaticamente

Para obter detalhes, confira Executar o script usando Cloud Shell.

Portal do Azure

Há duas maneiras de configurar o host do SQL Server no portal do Azure.

• Abra a página de visão geral do servidor habilitado para o Arc e selecione Configuração do SQL Server, conforme mostrado.

  

  Ou

• Abra a página de visão geral do SQL Server habilitado para Arc e selecione Propriedades. Em Configuração do SQL Server, selecione a configuração que deve ser modificada:

  • Tipo de licença
  • Assinatura do ESU
  • Atualizações automáticas

  

Definir a propriedade Tipo de Licença

Escolha um dos tipos de licença. Confira Tipos de licença para obter descrições.

Definir a propriedade Atualizações de Segurança Estendidas

Atualizações de Segurança Estendidas (ESU) estão disponíveis para instâncias qualificadas do SQL Server que usam Licença com Software Assurance ou Pagamento conforme o uso como tipo de licença. Se o tipo de licença for somente licença, a opção de ativar a assinatura da ESU será desabilitada. Consulte Atualizações de Segurança Estendidas para o SQL Server.

Observação

• Para ativar uma assinatura da ESU, o tipo de licença deve ser definido como Pagamento conforme o uso ou Licença com Software Assurance. Se estiver definido como Somente licença, as opções de Atualizações de Segurança Estendidas serão desabilitadas.
• Se a ESU estiver habilitada, o Tipo de Licença não poderá ser alterado para LicenseOnly até que a assinatura da ESU seja cancelada.

Aplicar licença de núcleo físico

Marque esta caixa de seleção se essa for uma máquina virtual e você estiver aproveitando o benefício ilimitado de virtualização para licenciar o software SQL Server ou sua assinatura SQL. Se selecionado, o núcleo físico terá precedência e os custos de software do SQL Server ou USU associados a essa VM serão anulados.

Importante

1. O benefício UV não tem suportado para as VMs em execução na infraestrutura dos provedores listados. Se você selecionar essa opção para essa VM, esta intenção será ignorada e você será cobrado pelos núcleos virtuais da VM. Consulte Provedores listados para obter detalhes.
2. Se você estiver configurando uma VM que não está sujeita à restrição acima, verifique se o tipo de Licença selecionado corresponde ao Plano de cobrança configurado no recurso de licença do núcleo físico.

Adicionar à lista Excluir instâncias

Você pode excluir determinadas instâncias das operações de integração em grande escala conduzidas pela política do Azure ou por processos de integração automática. Para excluir instâncias específicas dessas operações, adicione os nomes das instâncias à lista Ignorar Instâncias. Para obter detalhes sobre as opções de integração em grande escala, consulte Opções alternativas de implantação para o SQL Server habilitado pelo o Azure Arc.

Cuidado

As instâncias do SQL Server que usam o Pagamento Conforme o Uso (PAYG) não podem ser excluídas.

Salvar a configuração atualizada

Depois de verificar o tipo de licença, a configuração de ESU e qualquer instância a ser excluída, selecione Salvar para aplicar as alterações.

PowerShell

O comando a seguir define o tipo de licença como "PAYG", habilita a assinatura da ESU e adiciona duas instâncias à lista de exclusões.

//Updated settings object
$Settings = @{ 
  SqlManagement = @{ IsEnabled = $true };
  ExcludedSqlInstances = @( "Foo","Bar"); 
  LicenseType="PAYG";
  enableExtendedSecurityUpdates = $True;
  esuLastUpdatedTimestamp = [DateTime]::UtcNow.ToString('yyyy-MM-ddTHH:mm:ss.fffZ')
}

// Command stays the same as before, only settings is changed above:
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"

Importante

• O comando update substitui todas as configurações. Se as configurações de extensão tiverem uma lista de instâncias de SQL Server excluídas, especifique a lista de exclusões completa com o comando update.
• Se você já tiver uma versão mais antiga da extensão do Azure instalada, atualize-a primeiro e use um dos métodos de modificação para definir o tipo de licença correto. Para obter detalhes, confira Como atualizar uma extensão de computador.

CLI do Azure

O comando a seguir definirá o tipo de licença como "PAYG":

az connectedmachine extension update --machine-name "simple-vm" -g "<resource-group>" --name "WindowsAgent.SqlServer" --type "WindowsAgent.SqlServer" --publisher "Microsoft.AzureData" --settings '{"LicenseType":"PAYG", "SqlManagement": {"IsEnabled":true}}'    

Importante

• O comando update substitui todas as configurações. Se as configurações de extensão tiverem uma lista de instâncias de SQL Server excluídas, especifique a lista de exclusões completa com o comando update.
• Se você já tiver uma versão mais antiga da extensão do Azure instalada, atualize-a primeiro e use um dos métodos de modificação para definir o tipo de licença correto. Para obter detalhes, confira Como atualizar uma extensão de computador.

Consultar a configuração do SQL Server

Você pode usar o Azure Resource Graph para consultar as configurações do SQL Server dentro de um escopo selecionado. Consulte os exemplos a seguir.

Contagem por tipo de licença

Este exemplo retorna a contagem por tipo de licença.

resources
| where type == "microsoft.hybridcompute/machines/extensions"
| where properties.type in ("WindowsAgent.SqlServer","LinuxAgent.SqlServer")
| extend licenseType = iff(properties.settings.LicenseType == '', 'Configuration needed', properties.settings.LicenseType)
| summarize count() by tostring(licenseType)

Identificar instâncias em que o tipo de licença é indefinido

Essa consulta retorna uma lista de instâncias em que o tipo de licença é nulo.

resources
| where type == "microsoft.hybridcompute/machines/extensions"
| where properties.type in ("WindowsAgent.SqlServer","LinuxAgent.SqlServer")
| where isnull(properties.settings.LicenseType)
| project ['id'], resourceGroup, subscriptionId

Listar detalhes de configuração para cada instância do SQL Server

Essa consulta identifica vários detalhes sobre cada instância, incluindo o tipo de licença, as configurações de ESU e os recursos habilitados.

resources
| where type == "microsoft.hybridcompute/machines"| where properties.detectedProperties.mssqldiscovered == "true"| extend machineIdHasSQLServerDiscovered = id
| project name, machineIdHasSQLServerDiscovered, resourceGroup, subscriptionId
| join kind= leftouter (
    resources
    | where type == "microsoft.hybridcompute/machines/extensions"    | where properties.type in ("WindowsAgent.SqlServer","LinuxAgent.SqlServer")
    | extend machineIdHasSQLServerExtensionInstalled = iff(id contains "/extensions/WindowsAgent.SqlServer" or id contains "/extensions/LinuxAgent.SqlServer", substring(id, 0, indexof(id, "/extensions/")), "")
    | project Extension_State = properties.provisioningState,
    License_Type = properties.settings.LicenseType,
    ESU = iff(notnull(properties.settings.enableExtendedSecurityUpdates), iff(properties.settings.enableExtendedSecurityUpdates == true,"enabled","disabled"), ""),
    Extension_Version = properties.instanceView.typeHandlerVersion,
    Excluded_instances = properties.ExcludedSqlInstances,
    Purview = iff(notnull(properties.settings.ExternalPolicyBasedAuthorization),"enabled",""),
    Entra = iff(notnull(properties.settings.AzureAD),"enabled",""),
    BPA = iff(notnull(properties.settings.AssessmentSettings),"enabled",""),
    machineIdHasSQLServerExtensionInstalled)on $left.machineIdHasSQLServerDiscovered == $right.machineIdHasSQLServerExtensionInstalled
| where isnotempty(machineIdHasSQLServerExtensionInstalled)
| project-away machineIdHasSQLServerDiscovered, machineIdHasSQLServerExtensionInstalled

Listar servidores habilitados pelo Arc com instâncias do SQL Server

Essa consulta identifica os servidores habilitados pelo Azure Arc com instâncias do SQL Server detectadas neles.

resources
| where type == "microsoft.hybridcompute/machines"
| where properties.detectedProperties.mssqldiscovered == "true"
//| summarize count()

Essa consulta retorna os servidores habilitados pelo Azure Arc que têm instâncias do SQL Server, mas a extensão do SQL Server do Arc não está instalada. Essa consulta se aplica apenas a servidores Windows.

resources
| where type == "microsoft.hybridcompute/machines"
| where properties.detectedProperties.mssqldiscovered == "true"
| project machineIdHasSQLServerDiscovered = id
| join kind= leftouter (
    resources
    | where type == "microsoft.hybridcompute/machines/extensions"
    | where properties.type == "WindowsAgent.SqlServer"
    | project machineIdHasSQLServerExtensionInstalled = substring(id, 0, indexof(id, "/extensions/WindowsAgent.SqlServer")))
on $left.machineIdHasSQLServerDiscovered == $right.machineIdHasSQLServerExtensionInstalled
| where isempty(machineIdHasSQLServerExtensionInstalled)
| project machineIdHasSQLServerDiscoveredButNotTheExtension = machineIdHasSQLServerDiscovered

Para obter mais exemplos de Consultas do Azure Resource Graph, confira Inicializador de Consultas do Resource Graph.

Gerenciar a virtualização ilimitada

Para habilitar a virtualização ilimitada, o SQL Server habilitado pelo Azure Arc oferece suporte a um tipo de recurso especial: SQLServerLicense. Esse recurso permite que você licencie muitas máquinas virtuais com as instâncias do SQL Server instaladas. Para obter detalhes do modelo de licenciamento, consulte Licenciando instâncias do SQL Server com virtualização ilimitada.

Pré-requisitos

Sua função RBAC inclui as seguintes permissões:

• Microsoft. AzureArcData/SqlLicenses/read
• Microsoft. AzureArcData/SqlLicenses/write
• Microsoft.Management/managementGroups/read
• Microsoft.Resources/subscriptions/read
• Microsoft.Resources/subscriptions/resourceGroups/read
• Microsoft.Support/supporttickets/write

Criar licença do SQL Server

Para criar o recurso de licença do SQL Server, use um dos métodos abaixo:

Portal do Azure

1. Selecione o Azure Arc
2. Em Serviços de Dados, selecione Licenças do SQL Server
3. Clique em +Criar
4. Selecione Licença de núcleo físico do SQL Server
5. Concluir o assistente de criação

PowerShell

As instruções não estão disponíveis no PowerShell.

CLI do Azure

Execute:

$subscriptionId="<sub id>"
$apiVersion="2024-03-01-preview"
$templateFile="sqlserverlicense.json"
 
$resourceGroupName="<rg-name>"
$uri = "https://management.azure.com/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.AzureArcData/sqlserverlicenses/{2}?api-version={3}" -f $subscriptionId, $resourceGroupName, $serverName, $apiVersion
 
az rest --method put --uri "$uri" --body "@$templateFile" --headers "Content-Type=application/json"

Aqui está um exemplo de sqlserverlicense.json que cria uma licença desativada.

"location": "westeurope",
"properties": {
    "billingPlan": "PAYG",    
    "physicalCores": 32,
    "activationState": "Deactivated",
    "scopeType": "ResourceGroup",   
    "licenseCategory": "Core"
}

Alterar propriedades de licença do SQL Server

Para alterar a propriedade de licença do SQL Server, por exemplo, ativá-la posteriormente, use um dos métodos abaixo:

Portal do Azure

1. Selecione o Azure Arc
2. Em Serviços de Dados, selecione Licenças do SQL Server
3. Clique na licença em questão
4. Selecione Configurar em Gerenciamento
5. Faça as alterações e clique em Aplicar

PowerShell

As instruções não estão disponíveis no PowerShell.

CLI do Azure

Execute:

$subscriptionId="<sub id>"
$apiVersion="2024-03-01-preview"
$templateFile="activate.json"
 
$resourceGroupName="<rg-name>"
$uri = "https://management.azure.com/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.AzureArcData/sqlserverlicenses/{2}?api-version={3}" -f $subscriptionId, $resourceGroupName, $serverName, $apiVersion
 
az rest --method patch --uri "$uri" --body "@$templateFile" --headers "Content-Type=application/json"

Aqui está o conteúdo de activate.json para ativar a licença.

{
  "activationState": "Activated"
} ```

Gerenciar recursos no escopo

Você pode gerenciar os recursos no escopo de uma licença de núcleo físico específica do SQL Server usando as seguintes etapas:

Portal do Azure

1. Selecione o Azure Arc
2. Em Serviços de Dados, selecione Licenças do SQL Server
3. Clique na licença em questão
4. Selecionar Recursos no escopo em Gerenciamento

Se os recursos específicos não estiverem configurados para usar esta licença (a coluna Aplicar licença física principal exibe "NÃO"), você poderá alterar isso:

1. Selecione o(s) recurso(s) específico na lista
2. Clique na guia Aplicar licença.
3. Leia o aviso de isenção de responsabilidade e clique em Confirmar.

PowerShell

As instruções não estão disponíveis no PowerShell.

CLI do Azure

As instruções não estão disponíveis para az.

Listar servidores habilitados para Arc no escopo da licença do SQL Server

Esta consulta lista todos os servidores habilitados para Azure Arc no escopo da licença e as propriedades relevantes de cada um.

resources
        | where type =~ 'Microsoft.HybridCompute/machines'
        | where ('${scopeType}'!= 'Subscription' or subscriptionId == '${subscription}')
        | where ('${scopeType}' != 'ResourceGroup' or (resourceGroup == '${resourceGroup.toLowerCase()}' and subscriptionId == '${subscription}'))
        | extend status = tostring(properties.status)
        | where status =~ 'Connected'
        | join kind = leftouter
        (
        resources
        | where type =~ 'Microsoft.HybridCompute/machines/extensions'
        | where name == 'WindowsAgent.SqlServer' or name == 'LinuxAgent.SqlServer'
        | extend machineId = substring(id, 0, indexof(id, '/extensions'))
        | extend extensionId = id
        )
        on $left.id == $right.machineId
        | where isnotnull(extensionId)
        | project id, name, properties.status, resourceGroup, subscriptionId, Model = properties.detectedProperties.model, Manufacturer = properties.detectedProperties.manufacturer, kind, OSE = properties.osName, License_applied = properties1.settings.UsePhysicalCoreLicense.IsApplied
        |order by name asc

Conteúdo relacionado

• Revisar licenciamento e cobrança
• Analisar os preços do SQL Server 2022
• Instalar o SQL Server 2022 usando a opção de ativação de pagamento conforme o uso
• Saiba mais sobre Atualizações de Segurança Estendidas para o SQL Server.
• Perguntas frequentes
• Configurar a atualização automática para o SQL Server habilitado para Azure Arc