Configurar o SQL Server habilitado pelo Azure Arc

Artigo
10/16/2024

Aplica-se: 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 terão efeito apenas se uma ou mais instâncias do SQL Server estiverem instaladas. No portal do Azure, a painel Visão geral do SQL Server habilitado pelo Azure Arc reflete como a configuração do SQL Server afeta uma instância específica.

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. Para obter mais detalhes, confira Grupos de recursos gerenciados do Azure.
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 seguintes métodos:

Selecione Assinaturas.
Escolha sua assinatura.
Em Configurações, selecione Provedores de recursos.
Pesquise Microsoft.AzureArcData e Microsoft.HybridCompute e depois selecione Registrar.

Correr:

Register-AzResourceProvider -ProviderNamespace Microsoft.AzureArcData

Execute:

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 configurações em um servidor específico habilitado para o Azure 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.

Recomendamos executar 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.

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. Em Configuração do SQL Server, selecione a configuração que deve ser modificada:
- Tipo de licença
- Assinatura do ESU
- Aplicação de patch automatizada

Definir a propriedade de tipo de licença

Escolha um dos tipos de licença. Para obter descrições, confira 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 configurando uma máquina virtual (VM) e estiver utilizando o benefício de virtualização ilimitada para licenciar o software SQL Server ou sua assinatura SQL. Ele define a propriedade de configuração do host UsePhysicalCoreLicense como True. Se esta caixa de seleção estiver marcada, a licença de núcleo físico (p-core) tem precedência e os custos de software do SQL Server são anulados.

Importante

Quando a licença de núcleo físico está configurada com um plano de cobrança pré-pago, o valor de Tipo de licença selecionado deve ser Pagamento conforme o uso. Essa marcação não desencadeia cobranças adicionais no nível da VM, mas garante o licenciamento e a cobrança ininterruptos em um caso de desativação ou exclusão da licença de núcleo físico.

Você pode assinar as ESUs (Atualizações de segurança estendidas) para o host individual. Para se qualificar para uma assinatura de ESU, o Tipo de licença deve ser definido como Pagamento conforme o uso ou Licença com Software Assurance. Essa opção permite a assinatura usando vCPUs (v-cores) quando o host é uma máquina virtual ou núcleos físicos quando o host é um servidor físico em execução sem usar máquinas virtuais.

Selecione Assinar Atualizações de Segurança Estendidas. Ele define a propriedade de configuração do host EnabelExtendedSecurityUpdates como True. A assinatura é ativada depois que você selecionar Salvar.

Para obter mais informações sobre as opções de licenciamento ESU, confira Assinar atualizações de segurança estendidas em um ambiente de produção.

Observação

Ao contrário da licença de ESU de núcleo físico, ao assinar a ESU para um host, não é necessário definir o número de núcleos faturáveis para cada máquina. A extensão do Azure para SQL Server detecta o tamanho do host, o tipo do host (virtual ou físico) e a edição do SQL Server. As contas de extensão de acordo com esses parâmetros.

Depois de habilitar as ESUs, não poderá alterar o valor Tipo de Licença do host para Somente licença até que a assinatura ESU seja cancelada.

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

Marque a caixa de seleção Usar licença ESU de núcleo físico se estiver configurando uma máquina virtual e estiver utilizando o benefício de virtualização ilimitada ao habilitar a assinatura ESU. Ela define UseEsuPhysicalCoreLicense como true.

Se você marcar a caixa de seleção, a licença de núcleo físico tem precedência e as cobranças de ESU do SQL Server em nível de VM são anuladas.

Cancelar a 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 os encargos da ESU. Selecione Cancelar assinatura de Atualizações de Segurança Estendidas. A assinatura termina depois que você seleciona Salvar.

Adicionar à lista de instâncias excluídas

Você pode excluir determinadas instâncias das operações de integração em grande escala conduzidas pelas 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 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.

Observação

Você não pode excluir instâncias do SQL Server que usam a cobrança de pagamento conforme o uso.

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.

O comando a seguir define o tipo de licença como pagamento conforme o uso (PAYG), o que habilita a assinatura de 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
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 de SQL Server elegíveis para ESUs, poderá cancelar em massa usando o script para modificar o tipo de licença. Você pode usar este script para definir a configuração ESU para uma dessas opções:

Todos os computadores habilitados para Azure Arc em um grupo de recursos específico
Uma assinatura do Azure
Todas as assinaturas do Azure às quais sua conta do Azure tem acesso

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

O comando a seguir define o tipo de licença como pagamento conforme o uso:

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

Aviso

O comando update substitui todas as configurações. Por exemplo, se as configurações de extensão tiverem uma lista de instâncias do SQL Server excluídas, especifique a lista de exclusões completa por meio do 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 mais detalhes, confira Atualização automática de extensão em servidores habilitados para o Azure Arc.

Importante

O benefício de virtualização ilimitada para software do SQL Server ou assinatura ESU de um SQL Server não é válido na infraestrutura dos provedores listados. 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 núcleos virtuais da VM.

É possível ativar a assinatura do ESU em vários computadores habilitados para Azure Arc usando uma definição do Azure Policy chamada Inscrever instâncias qualificadas de SQL Server habilitadas para Arc em Atualizações de Segurança Estendidas.

Quando você cria uma atribuição dessa definição de política a um escopo de sua escolha, ela habilita ESUs em todos os computadores habilitados para Azure Arc que têm instalada a extensão do Azure para SQL Server. Se qualquer um desses computadores tiver uma instância do SQL Server qualificada, a assinatura ESU é ativada imediatamente.

Siga estas etapas para ativar essa política:

Entre no portal do Azure, acesse o Azure Policy, e então selecione Definições.
Procure por Inscrever instâncias qualificadas do SQL Server habilitadas para Arc em Atualizações de Segurança Estendidas e clique com o botão direito do mouse na política.
Selecione Atribuir política.
Selecione uma assinatura e, opcionalmente, um grupo de recursos como escopo.
Verifique se a Imposição de política está definida como Habilitada.
Na guia Parâmetros, defina o valor de Habilitar Atualizações de Segurança Estendidas como True.
Na guia Correção:
1. Selecione Criar tarefa de correção para que essa política seja aplicada aos recursos existentes. Se você não selecionar essa opção, a política será aplicada somente aos recursos recém-criados.
2. Escolha Criar identidade gerenciada e depois escolha Identidade gerenciada atribuída pelo sistema (recomendado) ou Identidade gerenciada atribuída pelo usuário, que tem permissões de Extensão do Azure para Implantação do SQL Server. e de Leitor.
3. Selecione a localização da identidade.
Selecione Examinar + criar.
Selecione Criar.

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.

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 é indefinido

Essa 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

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 Azure 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 Azure 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 Exemplos de consultas do Resource Graph para iniciantes.

Listar instâncias do SQL Server habilitadas para Azure Arc com assinaturas ESU

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 o status da assinatura da ESU:

resources
| where type == 'microsoft.azurearcdata/sqlserverinstances'
| extend Version = properties.version
| extend Edition = properties.edition
| extend containerId = tolower(tostring (properties.containerResourceId))
| where Version in ("2012", "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"), ""), 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 do SQL Server cobrável

Essa consulta identifica as máquinas (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 do SQL Server. Ele fornece os detalhes da configuração do SQL Server, incluindo o tipo de licença, configuração de ESU, tamanho em núcleos virtuais ou físicos 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 in (
        "VMware",
        "QEMU",
        "Amazon EC2",
        "OpenStack",
        "Hetzner",
        "Mission Critical Cloud",
        "DigitalOcean",
        "UpCloud",
        "oVirt",
        "Alibaba",
        "KubeVirt",
        "Parallels",
        "XEN"
    ), 1, 0))
| extend VMbyModel = toboolean(iff(properties.detectedProperties.model in (
        "OpenStack",
        "Droplet",
        "oVirt",
        "Hypervisor",
        "Virtual",
        "BHYVE",
        "KVM"
    ), 1, 0))
| extend GoogleVM = toboolean(iff((properties.detectedProperties.manufacturer =~ "Google") and (properties.detectedProperties.model =~ "Google Compute Engine"), 1, 0))
| extend NutanixVM = toboolean(iff((properties.detectedProperties.manufacturer =~ "Nutanix") and (properties.detectedProperties.model =~ "AHV"), 1, 0))
| extend MicrosoftVM = toboolean(iff((properties.detectedProperties.manufacturer =~ "Microsoft Corporation") and (properties.detectedProperties.model =~ "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 // Join the extension
        (
        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       // Join SQL Server instances
            (
            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'
            | where sqlStatus =~ "Connected"
            | 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
            , Model = tostring(properties.detectedProperties.model)
            , Manufacturer = tostring(properties.detectedProperties.manufacturer)
            , License_Type = tostring(properties1.settings.LicenseType)
            , OS = tostring(properties.osName)
            , Uses_UV = tostring(properties1.settings.UsePhysicalCoreLicense.IsApplied)
            , Cores = tostring(billableCores)
            , Version = sqlVersion
            | project-away machineID
            | order by Edition, name asc

Gerenciar o benefício da virtualização ilimitada para o SQL Server

Para habilitar a virtualização ilimitada, o SQL Server habilitado pelo Azure Arc oferece 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 controle de acesso baseado em 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 uma licença do SQL Server

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

Selecione o Azure Arc.
Em Serviços de Dados, selecione Licenças do SQL Server.
Selecione + Criar.
Selecione Licença de núcleo físico do SQL Server.
Conclua o assistente de criação.

Correr:

$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 da licença do SQL Server (por exemplo, ativá-la posteriormente), use um dos seguintes métodos:

Selecione o Azure Arc.
Em Serviços de Dados, selecione Licenças do SQL Server.
Selecione a licença.
Em Gerenciamento, selecione Configurar.
Faça as alterações e depois selecione Aplicar.

Correr:

$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 os recursos no escopo de uma licença de núcleos físicos

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:

Selecione o Azure Arc.
Em Serviços de Dados, selecione Licenças do SQL Server.
Selecione a licença.
Em Gerenciamento, selecione Recursos no escopo.

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 essa opção:

Selecione os recursos específicos na lista.
Selecione Aplicar licença.
Leia o aviso de isenção de responsabilidade e selecione Confirmar.

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

Gerenciar o benefício da 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 oferece 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 fora de suporte. Para obter detalhes sobre o modelo de licenciamento, confira Assinar ESUs do SQL Server usando núcleos físicos 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 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:

Selecione o Azure Arc.
Em Serviços de Dados, selecione Licenças ESU do SQL Server.
Selecione + Criar.
Conclua o assistente de criação.

Correr:

$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 da licença ESU do SQL Server (por exemplo, terminar a assinatura), use um dos seguintes métodos:

Selecione o Azure Arc.
Em Serviços de Dados, selecione Licenças ESU do SQL Server.
Selecione a licença.
Em Gerenciamento, selecione Configurar.
Faça as alterações e depois selecione Aplicar.

Correr:

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

{
  "activationState": "Terminated"
}

Gerenciar recursos no escopo de uma licença ESU de núcleos físicos

Você pode gerenciar os recursos no escopo da licença ESU de um SQL Server específico usando as seguintes etapas:

Selecione o Azure Arc.
Em Serviços de Dados, selecione Licenças ESU do SQL Server.
Selecione a licença.
Em Gerenciamento, selecione Recursos no escopo.

Essa 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 de núcleos físicos que você está gerenciando. Se os recursos específicos não estiverem configurados para usar esta licença (a coluna Licença de núcleo físico aplicada exibe NÃO), você poderá alterar essa opção:

Selecione os recursos específicos na lista.
Selecione Assinar ESUs para assinar ou Cancelar assinatura de ESUs para cancelar a assinatura.
Leia o aviso de isenção de responsabilidade e selecione Confirmar.

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

Compartilhar via

Configurar o SQL Server habilitado pelo Azure Arc

Pré-requisitos

Registrar provedores de recursos

Modificar a configuração do SQL Server

Definir a propriedade de tipo de licença

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

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

Cancelar a assinatura de Atualizações de Segurança Estendidas

Adicionar à lista de instâncias excluídas

Salvar a configuração atualizada

Consultar a configuração do SQL Server

Obter a contagem por tipo de licença

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

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

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

Listar instâncias do SQL Server habilitadas para Azure Arc com assinaturas ESU

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

Gerenciar o benefício da virtualização ilimitada para o SQL Server

Pré-requisitos

Criar uma licença do SQL Server

Atualizar um recurso de licença do SQL Server

Gerenciar os recursos no escopo de uma licença de núcleos físicos

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

Gerenciar o benefício da virtualização ilimitada para uma assinatura ESU do SQL Server

Pré-requisitos

Criar um recurso de licença ESU do SQL Server

Atualizar um recurso de licença ESU do SQL Server

Gerenciar recursos no escopo de uma licença ESU de núcleos físicos

Listar servidores habilitados para Azure Arc no escopo de uma licença ESU do SQL Server

Comentários

Recursos adicionais

Compartilhar via

Configurar o SQL Server habilitado pelo Azure Arc

Pré-requisitos

Registrar provedores de recursos

Modificar a configuração do SQL Server

Definir a propriedade de tipo de licença

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

Assinar a Atualização de Segurança Estendida

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

Cancelar a assinatura de Atualizações de Segurança Estendidas

Adicionar à lista de instâncias excluídas

Salvar a configuração atualizada

Assinar as Atualizações de Segurança estendidas em escala usando o Azure Policy

Consultar a configuração do SQL Server

Obter a contagem por tipo de licença

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

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

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

Listar instâncias do SQL Server habilitadas para Azure Arc com assinaturas ESU

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

Gerenciar o benefício da virtualização ilimitada para o SQL Server

Pré-requisitos

Criar uma licença do SQL Server

Atualizar um recurso de licença do SQL Server

Gerenciar os recursos no escopo de uma licença de núcleos físicos

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

Gerenciar o benefício da virtualização ilimitada para uma assinatura ESU do SQL Server

Pré-requisitos

Criar um recurso de licença ESU do SQL Server

Atualizar um recurso de licença ESU do SQL Server

Gerenciar recursos no escopo de uma licença ESU de núcleos físicos

Listar servidores habilitados para Azure Arc no escopo de uma licença ESU do SQL Server

Conteúdo relacionado

Comentários

Recursos adicionais