Configurar o SQL Server habilitado pelo Azure Arc

Aplica-se a:SQL Server

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

Pré-requisitos

• Você tem uma função de Colaborador em pelo menos uma das subscrições do Azure que a sua organização criou. Saiba como criar uma nova subscrição de faturação.

• Você tem uma função de colaborador para o grupo de recursos no qual a instância do SQL Server será registada. Para obter detalhes, consulte Grupos de recursos gerenciados do Azure.

• Os provedores de recursos Microsoft.AzureArcData e Microsoft.HybridCompute estão registados em cada subscrição que utiliza para a faturação a pagamento conforme o uso do SQL Server.

Registrar provedores de recursos

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

Portal do Azure

1. Selecione Subscrições.
2. Escolha a sua subscrição.
3. Em Configurações, selecione Provedores de recursos.
4. Procure Microsoft.AzureArcData e Microsoft.HybridComputee, em seguida, selecione Registar.

Azure PowerShell

Executar:

Register-AzResourceProvider -ProviderNamespace Microsoft.AzureArcData

Azure CLI

Executar:

az provider register --namespace 'Microsoft.AzureArcData'

Modificar a configuração do SQL Server

Você pode usar o portal do Azure, o Azure PowerShell ou a CLI do Azure para alterar todas ou algumas definições de configuração em um servidor habilitado para Azure Arc específico 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 PowerShell. Ele é publicado como um exemplo de SQL Server de código aberto e inclui instruções passo a passo.

Recomendamos que você execute o script do Azure Cloud Shell porque:

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

Para obter detalhes, consulte Executando o script usando o Cloud Shell.

Portal do Azure

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

• Abra o painel Visão geral do SQL Server habilitado para Azure Arc e selecione Configuração do SQL Server.

  

• Abra o painel Visão geral do SQL Server habilitado para Azure Arc e selecione Propriedades. No SQL Server configuração, selecione a configuração que precisa modificar:

  • Tipo de licença
  • subscrição ESU
  • Correção automatizada

  

Configurar o tipo de propriedade da licença

Escolha um dos tipos de licença. Para obter descrições, consulte Tipos de licença.

Usar uma licença de núcleo físico

Marque a caixa de seleção Usar licença de núcleo físico se estiver a configurar uma máquina virtual (VM) e estiver a utilizar o benefício de virtualização ilimitada para licenciar o software SQL Server ou para a sua subscrição SQL. Ele define a propriedade de configuração do host UsePhysicalCoreLicense como True. Se essa caixa de seleção estiver marcada, a licença de núcleo físico (p-core) terá precedência e os custos de software do SQL Server serão anulados.

Importante

Se a licença p-core estiver configurada com um plano de faturamento pagamento conforme o uso, o valor do tipo de licença selecionado deverá ser pagamento conforme o uso. Essa seleção não aciona cobranças adicionais no nível da VM, mas garante licenciamento e cobrança ininterruptos se a licença p-core for desativada ou excluída.

Subscrever Atualizações de Segurança Alargadas

Pode subscrever Atualizações de Segurança Estendidas (ESUs) para a máquina anfitriã individual. Para se qualificar para uma assinatura ESU, o host deve ter o tipo de Licença configurado como Pay-as-you-go ou Licença com Software Assurance. Essa opção permite que você se inscreva usando vCPUs (v-cores) quando o host é uma máquina virtual ou usando núcleos físicos quando o host é um servidor físico executado sem usar máquinas virtuais.

Selecione Subscrever Atualizações de Segurança Alargadas. Ele define a propriedade de configuração do host EnableExtendedSecurityUpdates como True. A subscrição é ativada depois de selecionar Guardar.

Para obter mais informações sobre as opções de licenciamento ESU, consulte Subscrever Atualizações de Segurança Prolongadas num ambiente de produção.

Observação

Ao contrário da licença ESU p-core, quando você está assinando ESUs para um host, você não precisa definir o número de núcleos faturáveis para cada máquina. A Extensão do Azure para SQL Server deteta o tamanho do host, o tipo de host (virtual ou físico) e a edição do SQL Server. A prorrogação fatura de acordo com esses parâmetros.

Depois de ativar os ESUs, não se pode alterar o valor do Tipo de Licença do host para Licença somente até que a assinatura ESU seja anulada.

Usar uma licença ESU de núcleo físico

Marque a caixa de seleção licença ESU de núcleo físico se estiver a configurar uma máquina virtual e usar o benefício de virtualização ilimitada para habilitar a assinatura ESU. Define UseEsuPhysicalCoreLicense para true.

Se você marcar a caixa de seleção, a licença p-core terá precedência e as cobranças ESU do SQL Server no nível da VM serão anuladas.

Cancelar assinatura de atualizações de segurança estendidas

Você pode cancelar as Atualizações de Segurança Estendidas habilitadas pelo Azure Arc a qualquer momento. O cancelamento interrompe imediatamente a aplicação das tarifas ESU. Selecione Cancelar assinatura de Atualizações de Segurança Estendidas. A subscrição termina depois de selecionar Guardar.

Adicionar à lista de instâncias excluídas

Você pode excluir determinadas instâncias das operações de integração em escala orientadas por políticas 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 opções de integração em escala, consulte Opções alternativas de implantação para SQL Server habilitadas pelo Azure Arc.

Observação

Não é possível excluir instâncias do SQL Server que utilizem o sistema de cobrança "pay-as-you-go".

Salvar a configuração atualizada

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

Azure PowerShell

O comando a seguir define o tipo de licença como pay-as-you-go (PAYG), que habilita a assinatura ESU e adiciona duas instâncias à lista de exclusão.

# 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
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"

Se você tiver várias instâncias do SQL Server qualificadas para ESUs, poderá cancelar em massa usando o script para modificar o tipo de licença. Você pode usar esse script para definir a configuração ESU para uma destas opções:

• Todas as máquinas habilitadas para o Azure Arc em um grupo de recursos específico
• Uma assinatura do Azure
• Todas as subscrições do Azure às quais a sua conta do Azure tem acesso

O script preserva todas as configurações existentes. Ele é publicado como um exemplo de SQL Server de código aberto e inclui instruções passo a passo.

CLI do Azure

O comando a seguir define o tipo de licença como pay-as-you-go:

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}}'

Advertência

O comando update substitui todas as configurações. Por exemplo, se suas configurações de extensão tiverem uma lista de instâncias excluídas do SQL Server, você deverá especificar a lista de exclusão completa com o comando update.

Se você já tiver uma versão mais antiga da extensão do Azure instalada, certifique-se de atualizá-la primeiro e, em seguida, use um dos métodos de modificação para definir o tipo de licença correto. Para obter detalhes, consulte Atualização de extensão automática para servidores habilitados para Azure Arc.

Importante

O benefício de virtualização ilimitada para o software SQL Server ou uma assinatura ESU do SQL Server não é suportado na infraestrutura da lista de provedores . Se você estiver executando o SQL Server na VM de um provedor listado e selecionar essa opção, sua intenção será ignorada e você será cobrado pelos v-cores da VM.

Assine as Atualizações de Segurança Alargadas em grande escala com o uso do Azure Policy

Você pode ativar a assinatura ESU em várias máquinas com Azure Arc ativado usando uma definição de Política Azure chamada Subscrever instâncias do SQL Server com Azure Arc ativado elegíveis para Atualizações de Segurança Estendidas.

Quando atribui esta definição de política a um âmbito da sua escolha, ela habilita ESUs em todas as máquinas configuradas com o Azure Arc que têm a Extensão Azure para SQL Server instalada. Se qualquer uma dessas máquinas tiver uma instância qualificada do SQL Server, a assinatura ESU será ativada imediatamente.

Use as seguintes etapas para ativar essa política:

1. No portal do Azure, vá para de Política do Azure e selecione Definições.

2. Pesquise Inscrever instâncias qualificadas do SQL Servers habilitadas para Arc para Atualizações de Segurança Estendidas e clique com o botão direito do mouse na política.

3. Selecione Atribuir Política.

4. Selecione uma assinatura e, opcionalmente, um grupo de recursos como escopo.

5. Verifique se a imposição da política está definida como Ativado.

6. Na guia Parâmetros, defina o valor de Habilitar atualizações de segurança estendidas como True.

7. Na guia Remediação:

   1. Selecione Criar tarefa de correção para aplicar esta política aos recursos existentes. Se você não selecionar essa opção, a política será aplicada apenas aos recursos recém-criados.
   2. Selecione Criar uma Identidade Gerenciada, e em seguida, selecione identidade gerenciada atribuída ao sistema (recomendado) ou identidade gerenciada atribuída ao usuário, que tenha Extensão do Azure para Implementação do SQL Server e permissões de Leitor.
   3. Selecione a localização da identidade.

8. Selecione Revisão + Criar.

9. Selecione Criar.

Consultar a configuração do SQL Server

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

Obter a 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 está indefinido

Esta consulta retorna uma lista de instâncias em que o tipo de licença é null:

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

Esta consulta identifica muitos detalhes sobre cada instância, incluindo o tipo de licença, a configuração 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 para Azure Arc com instâncias do SQL Server

Esta consulta identifica servidores habilitados para Azure Arc com instâncias do SQL Server descobertas neles:

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

Essa consulta retorna servidores habilitados para Azure Arc que têm instâncias do SQL Server, mas a extensão do Azure Arc SQL Server não está instalada. Esta consulta aplica-se 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, consulte exemplos de consultas do Starter Resource Graph.

Listar instâncias do SQL Server habilitadas para Azure Arc inscritas em ESUs

O exemplo a seguir mostra como você pode exibir todas as instâncias qualificadas do SQL Server 2012 (11.x) ou do SQL Server 2014 (12.x) e seu status de assinatura ESU:

resources
| where type == 'microsoft.azurearcdata/sqlserverinstances'
| extend Version = properties.version
| extend Edition = properties.edition
| extend containerId = tolower(tostring (properties.containerResourceId))
| where Version in ("SQL Server 2012", "SQL Server 2014")
| where Edition in ("Enterprise", "Standard")
| where isnotempty(containerId)
| project containerId, SQL_instance = name, Version, Edition
| join kind=inner (
    resources
    | where type == "microsoft.hybridcompute/machines"
    | extend machineId = tolower(tostring(id))
    | project machineId, Machine_name = name
)
on $left.containerId == $right.machineId
| join kind=inner (
    resources
    | where type == "microsoft.hybridcompute/machines/extensions"
    | where properties.type in ("WindowsAgent.SqlServer","LinuxAgent.SqlServer")
    | extend machineIdHasSQLServerExtensionInstalled = tolower(iff(id contains "/extensions/WindowsAgent.SqlServer" or id contains "/extensions/LinuxAgent.SqlServer", substring(id, 0, indexof(id, "/extensions/")), ""))
    | project machineIdHasSQLServerExtensionInstalled,
     Extension_State = properties.provisioningState, 
     License_Type = properties.settings.LicenseType, 
     ESU = iff(notnull(properties.settings.enableExtendedSecurityUpdates), iff(properties.settings.enableExtendedSecurityUpdates == 'true',"ENABLED","disabled"), "disabled"),
     Extension_Version = properties.instanceView.typeHandlerVersion
)
on $left.machineId == $right.machineIdHasSQLServerExtensionInstalled
| project-away machineId, containerId, machineIdHasSQLServerExtensionInstalled

Listar servidores habilitados para Azure Arc que hospedam uma instância faturável do SQL Server

Esta consulta identifica as máquinas conectadas (virtuais ou físicas) que hospedam instâncias do SQL Server e que são faturáveis ou exigem uma licença para o software SQL Server. Ele fornece os detalhes da configuração do SQL Server, incluindo o tipo de licença, a configuração ESU, o tamanho em v-cores ou p-cores e outros parâmetros relevantes.

resources
| where type =~ 'Microsoft.HybridCompute/machines'
| extend status = tostring(properties.status)
| where status =~ 'Connected'
| extend machineID = tolower(id)
| extend VMbyManufacturer = toboolean(iff(
    properties.detectedProperties.manufacturer contains_cs "VMware" or
    properties.detectedProperties.manufacturer contains_cs "QEMU" or
    properties.detectedProperties.manufacturer contains_cs "Amazon EC2" or
    properties.detectedProperties.manufacturer contains_cs "OpenStack" or
    properties.detectedProperties.manufacturer contains_cs "Hetzner" or
    properties.detectedProperties.manufacturer contains_cs "Mission Critical Cloud" or
    properties.detectedProperties.manufacturer contains_cs "DigitalOcean" or
    properties.detectedProperties.manufacturer contains_cs "UpCloud" or
    properties.detectedProperties.manufacturer contains_cs "oVirt" or
    properties.detectedProperties.manufacturer contains_cs "Alibaba" or
    properties.detectedProperties.manufacturer contains_cs "KubeVirt" or
    properties.detectedProperties.manufacturer contains_cs "Parallels" or
    properties.detectedProperties.manufacturer contains_cs "Bochs" or
    properties.detectedProperties.manufacturer contains_cs "XEN", 1, 0))
| extend VMbyModel = toboolean(iff(
    properties.detectedProperties.model contains_cs "OpenStack" or
    properties.detectedProperties.model contains_cs "Droplet" or
    properties.detectedProperties.model contains_cs "oVirt" or
    properties.detectedProperties.model contains_cs "Hypervisor" or
    properties.detectedProperties.model contains_cs "Virtual" or
    properties.detectedProperties.model contains_cs "BHYVE" or
    properties.detectedProperties.model contains_cs "KVM", 1, 0))
| extend GoogleVM = toboolean(iff(
    properties.detectedProperties.manufacturer contains_cs "Google" and
    properties.detectedProperties.model contains_cs "Google Compute Engine", 1, 0))
| extend NutanixVM = toboolean(iff(
    properties.detectedProperties.manufacturer contains_cs "Nutanix" and
    properties.detectedProperties.model contains_cs "AHV", 1, 0))
| extend MicrosoftVM = toboolean(iff(
    properties.detectedProperties.manufacturer contains_cs "Microsoft Corporation" and
    properties.detectedProperties.model contains_cs "Virtual Machine", 1, 0))
| extend billableCores = iff(
    VMbyManufacturer or VMbyModel or GoogleVM or NutanixVM or MicrosoftVM,
    properties.detectedProperties.logicalCoreCount,
    properties.detectedProperties.coreCount)
| join kind=leftouter (
    resources
    | where type =~ 'Microsoft.HybridCompute/machines/extensions'
    | where name == 'WindowsAgent.SqlServer' or name == 'LinuxAgent.SqlServer'
    | extend extMachineID = substring(id, 0, indexof(id, '/extensions'))
    | extend extensionId = id
) on $left.id == $right.extMachineID
| join kind=inner (
    resources
    | where type =~ 'microsoft.azurearcdata/sqlserverinstances'
    | extend sqlVersion = tostring(properties.version)
    | extend sqlEdition = tostring(properties.edition)
    | extend is_Enterprise = toint(iff(sqlEdition == "Enterprise", 1, 0))
    | extend sqlStatus = tostring(properties.status)
    | extend licenseType = tostring(properties.licenseType)
    | where sqlEdition in ('Enterprise', 'Standard')
    | where licenseType !~ 'HADR'
    | extend ArcServer = tolower(tostring(properties.containerResourceId))
    | order by sqlEdition
) on $left.machineID == $right.ArcServer
| where isnotnull(extensionId)
| summarize Edition = iff(sum(is_Enterprise) > 0, "Enterprise", "Standard") by machineID, name, resourceGroup, subscriptionId, Status = tostring(properties.status), Model = tostring(properties.detectedProperties.model), Manufacturer = tostring(properties.detectedProperties.manufacturer), License_Type = tostring(properties1.settings.LicenseType), ESU = iff(notnull(properties1.settings.enableExtendedSecurityUpdates), iff(properties1.settings.enableExtendedSecurityUpdates == true, "enabled", "not enabled"), "not enabled"), OS = tostring(properties.osName), Uses_UV = tostring(properties1.settings.UsePhysicalCoreLicense.IsApplied), Cores = tostring(billableCores), Version = sqlVersion, HostType = iff(VMbyManufacturer or VMbyModel or GoogleVM or NutanixVM or MicrosoftVM, "VM", "Physical")
| summarize by name, subscriptionId, resourceGroup, Model, Manufacturer, HostType, License_Type, ESU, OS, Cores, Status
| project Name = name, Model, Manufacturer, HostType, OperatingSystem = OS, Status, HostLicenseType = License_Type, ESU, BillableCores = Cores, SubscriptionID = subscriptionId, ResourceGroup = resourceGroup
| order by Name asc

Gerencie o benefício de virtualização ilimitada para o SQL Server

Para habilitar a virtualização ilimitada, o SQL Server habilitado pelo Azure Arc dá suporte a um tipo de recurso especial: SQLServerLicense. Você pode usar esse recurso para licenciar muitas máquinas virtuais com as instâncias do SQL Server instaladas. Para obter detalhes sobre o modelo de licenciamento, consulte Licenciar instâncias do SQL Server com virtualização ilimitada.

Pré-requisitos

Sua função de RBAC (controle de acesso baseado em funções) 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 uma licença do SQL Server

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

Portal do Azure

1. Selecione Azure Arc.
2. Em Data Services, selecione licenças SQL Server.
3. Selecione +Criar.
4. Selecione a licença de núcleo físico do SQL Server .
5. Conclua o assistente de criação.

Azure PowerShell

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

Azure CLI

Executar:

$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"
}

Atualizar um recurso de licença do SQL Server

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

Portal do Azure

1. Selecione Azure Arc.
2. Em Data Services, selecione licenças SQL Server.
3. Selecione a licença.
4. Em Gerenciamento, selecione Configurar.
5. Faça as alterações e selecione Aplicar.

Azure PowerShell

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

Linha de Comandos do Azure

Executar:

$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 do activate.json para ativar a licença:

{
  "activationState": "Activated"
}

Gerenciar recursos no escopo de uma licença p-core

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 Azure Arc.
2. Em Data Services, selecione licenças SQL Server.
3. Selecione a licença.
4. Em Gerenciamento de, selecione Recursos no escopo.

Se os recursos específicos não estiverem configurados para usar essa licença (a coluna Apply physical core license exibirá NO), você poderá alterar isso:

1. Selecione os recursos específicos na lista.
2. Selecione Aplicar licença.
3. Leia a declaração de exoneração de responsabilidade e selecione Confirmar.

Azure PowerShell

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

CLI do Azure

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

Listar servidores habilitados para Azure 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

Gerencie o benefício de virtualização ilimitada para uma assinatura ESU do SQL Server

Para habilitar a virtualização ilimitada para uma assinatura ESU, o SQL Server habilitado pelo Azure Arc dá suporte a um tipo de recurso especial: SQLServerEsuLicense. Você pode usar esse recurso para habilitar uma assinatura ESU para um conjunto de hosts físicos com um número ilimitado de máquinas virtuais executando as instâncias do SQL Server sem suporte. Para obter detalhes sobre o modelo de licenciamento, consulte Subscrever às ESUs do SQL Server usando núcleos físicos e 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 um recurso de licença ESU do SQL Server

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

Portal do Azure

1. Selecione Azure Arc.
2. Em Data Services, selecione licenças ESU do SQL Server.
3. Selecione +Criar.
4. Conclua o assistente de criação.

Azure PowerShell

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

CLI do Azure

Executar:

$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/SqlServerEsuLicenses/{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": "Active",
    "scopeType": "ResourceGroup",
    "version": "2014"
}

Atualizar um recurso de licença ESU do SQL Server

Para alterar as propriedades de licença ESU do SQL Server (por exemplo, encerrar a assinatura), use um dos seguintes métodos:

Portal do Azure

1. Selecione Azure Arc.
2. Em Data Services, selecione licenças ESU do SQL Server.
3. Selecione a licença.
4. Em Gerenciamento, selecione Configurar.
5. Faça as alterações e selecione Aplicar.

Azure PowerShell

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

CLI do Azure

Executar:

$subscriptionId="<sub id>"
$apiVersion="2024-03-01-preview"
$templateFile="terminate.json"

$resourceGroupName="<rg-name>"
$uri = "https://management.azure.com/subscriptions/{0}/resourceGroups/{1}/providers/Microsoft.AzureArcData/SqlServerEsuLicenses/{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 do terminate.json para ativar a licença:

{
  "activationState": "Terminated"
}

Gerir recursos dentro do âmbito de uma licença p-core ESU

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

Portal do Azure

1. Selecione Azure Arc.
2. Em Data Services, selecione licenças ESU do SQL Server.
3. Selecione a licença.
4. Em Gerenciamento de, selecione Recursos no escopo.

Esta exibição mostra apenas as máquinas conectadas no escopo que hospedam uma instância do SQL Server fora de serviço com a versão que corresponde à versão da licença ESU p-core que você está gerenciando. Se os recursos específicos não estiverem configurados para usar essa licença (a coluna Physical core license applied exibirá NO), você poderá alterar isso:

1. Selecione os recursos específicos na lista.
2. Selecione Subscrever ESUs para subscrever, ou selecione Anular ESUs para cancelar a subscrição.
3. Leia a declaração de exoneração de responsabilidade e selecione Confirmar.

Azure PowerShell

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

CLI do Azure

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

Listar servidores habilitados para Azure Arc no escopo de uma licença ESU 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.UseEsuPhysicalCoreLicense.IsApplied
        |order by name asc

Conteúdo relacionado

• Gerenciar o licenciamento e a cobrança do SQL Server habilitados pelo Azure Arc
• Preços do SQL Server 2022
• Guia de instalação do SQL Server
• O que são atualizações de segurança estendidas para o SQL Server?
• Perguntas frequentes
• Configurar atualizações automáticas para o SQL Server habilitadas pelo Azure Arc