Criar um pool de instâncias – Instância Gerenciada de SQL do Azure

Aplica-se a:Instância Gerenciada de SQL do Azure

Este artigo ensina a criar um pool de instâncias para a Instância Gerenciada de SQL do Azure usando o portal do Azure, o PowerShell ou a CLI do Azure, bem como a mover instâncias de e para o pool usando o PowerShell ou a CLI do Azure.

Os pools de instâncias possibilitam a implantação de várias instâncias gerenciadas de SQL com recursos compartilhados em uma única máquina virtual, que fornece uma infraestrutura conveniente e econômica para migrar várias instâncias do SQL Server sem precisar consolidar cargas de trabalho menores e menos intensivas em uma Instância Gerenciada de SQL maior.

Pré-requisitos

Para criar um pool de instâncias gerenciadas de SQL, você deve ter:

• Uma rede virtual existente com um intervalo de sub-redes de tamanho adequado.
• O módulo Az.SQL mais recente para a versão atual do PowerShell ou a versão mais recente da CLI do Azure.
• Propriedades de instância gerenciada de SQL e pool revisadas.

Considerações sobre tamanho de sub-rede

Planeje cuidadosamente o tamanho da sua sub-rede ao usar um pool de instâncias gerenciadas de SQL. Consulte Determinar o tamanho e o intervalo de sub-rede necessários para a Instância Gerenciada de SQL do Azure para obter diretrizes de dimensionamento de sub-rede.

Use a seguinte fórmula ao calcular o número de endereços IP exigidos por um pool de instâncias que contém diversas instâncias de uso geral:

2 * (5 + (3 * # of MIs)) + 5

# of MIs refere-se ao número potencial máximo de instâncias que você planeja provisionar. O número máximo possível de instâncias no pool é 40.

Criar pool de instâncias

Você pode criar um pool de instâncias gerenciadas de SQL usando o portal do Azure, o PowerShell ou a CLI do Azure. Considere o seguinte:

• No momento, apenas a camada de serviço de uso geral em hardware da série padrão (Gen5) ou da série premium está disponível.
• O nome do pool pode conter apenas letras minúsculas, números e hifens e não pode começar com um hífen.
• O Benefício Híbrido do Azure é aplicado no nível do pool de instâncias. Você pode definir o tipo de licença ao criar o pool e atualizar o tipo de licença após a criação do pool.

Importante

A implantação de um pool de instâncias é uma operação demorada que pode levar até 4,5 horas.

Portal do Azure

Para criar um pool de instâncias gerenciadas de SQL no portal do Azure, siga estas etapas:

1. Vá para o Hub SQL do Azure em aka.ms/azuresqlhub. No painel da Instância Gerenciada de SQL do Azure, selecione Mostrar opções.

2. Na janela de opções da Instância Gerenciada de SQL do Azure , selecione Criar Pool de Instâncias.

   

3. Na página Criar Pool de Instância Gerenciada de SQL do Azure :

   1. Forneça os detalhes do projeto e da instância na guia Informações básicas.
   2. Use a opção Configurar pool de instâncias em Computação + armazenamento para abrir a página Computação + Armazenamento e escolha a camada de serviço, o hardware de computação e a licença do SQL Server que o pool deve usar. Use Aplicar para salvar as configurações de computação e voltar para a página Criar pool de Instâncias Gerenciadas de SQL do Azure.
   3. Selecione uma rede virtual existente ou configure uma nova na guia Rede.
   4. (Opcional) Configure uma janela de manutenção não padrão para o pool na guia Configurações adicionais.
   5. Revise sua configuração na guia Revisar + criar e selecione Criar para criar seu pool de instâncias.

   

4. Você pode monitorar a implantação do pool em Notificações.

Depois que o pool de instâncias gerenciadas do SQL for criado, você poderá criar uma nova instância no pool usando o portal do Azure ou mover uma instância existente para o pool usando o PowerShell ou a CLI do Azure.

PowerShell

Para criar o pool de instâncias gerenciadas do SQL, use New-AzSqlInstancePool.

Considere o seguinte:

• Para LicenseType, use BasePrice para o Benefício Híbrido do Azure ou LicenseIncluded se você não tiver uma licença do SQL Server que possa ser usada para o desconto do Benefício Híbrido do Azure.
• Use Get-AzLocation | select displayname, location para obter uma lista de regiões em que os pools de instâncias estão disponíveis.

Crie um novo pool de instâncias com 8 vCores em hardware de série padrão (Gen5) executando o seguinte script de exemplo:

$virtualNetwork = Get-AzVirtualNetwork -Name "<vNetName>" -ResourceGroupName "<resourceGroupName>"
$miSubnet = Get-AzVirtualNetworkSubnetConfig -Name "<miSubnetName>" -VirtualNetwork
$virtualNetwork$miSubnetConfigId = $miSubnet.Id

$parameters = @{
    ResourceGroupName = "<resource group name>"
    Name = "<instance pool name>"
    LicenseType = "LicenseIncluded"
    VCore = 8
    Edition = "GeneralPurpose"
    ComputeGeneration = "Gen5"
    Location = "<region>"
    $virtualNetwork = Get-AzVirtualNetwork -Name "<vNetName>" -ResourceGroupName "<resourceGroupName>"
    $miSubnet = Get-AzVirtualNetworkSubnetConfig -Name "<miSubnetName>" -VirtualNetwork $virtualNetwork
    $miSubnetConfigId = $miSubnet.Id
    SubnetId = $miSubnetConfigId
}

$instancePool = New-AzSqlInstancePool @parameters

CLI do Azure

Para criar seu pool de instâncias gerenciadas de SQL, use az sql instance-pool create.

Considere o seguinte:

• Para --license-type, use BasePrice para o Benefício Híbrido do Azure ou LicenseIncluded se você não tiver uma licença do SQL Server que possa ser usada para o desconto do Benefício Híbrido do Azure.

Crie um novo pool de instâncias com 8 vCores em hardware de série padrão (Gen5) executando o seguinte script de exemplo:

# Create the instance pool
az sql instance-pool create \
    --license-type LicenseIncluded \
    --location <region> \
    --name <pool name> \
    --capacity 8 \
    --tier GeneralPurpose \
    --family Gen5 \
    --resource-group <resource group name> \
    --subnet <subnet name> \
    --vnet-name <vnet name>

Crie uma nova instância no pool

Depois que o pool for criado, você poderá criar uma nova instância gerenciada de SQL no pool usando o portal do Azure, o PowerShell ou a CLI do Azure.

Considere o seguinte:

• Você deve especificar o tipo de licença para a nova instância gerenciada de SQL e ela deve corresponder ao tipo de licença do pool.

Portal do Azure

Para criar uma nova instância gerenciada de SQL dentro de um pool usando o portal do Azure, siga estas etapas:

1. Vá para o Hub SQL do Azure em aka.ms/azuresqlhub.

2. No painel da Instância Gerenciada de SQL do Azure, selecione Mostrar opções.

3. Na janela de opções da Instância Gerenciada de SQL do Azure , selecione Criar Instância Gerenciada de SQL.

   

4. Na guia Informações básicas da página Criar Instância Gerenciada de SQL do Azure:

   1. Selecione o grupo de recursos que contém o pool de instâncias existente.
   2. Escolha Sim para Pertence a um pool de instâncias? em Detalhes da instância gerenciada para criar sua instância dentro de um pool de instâncias.
   3. Selecione o pool na lista suspensa Pool de instâncias.

   

   Depois de selecionar um pool de instâncias na lista suspensa, você verá o custo de computação da instância mudar para 0 porque a computação está incluída no custo do pool.

5. Preencha os detalhes restantes na página Criar Instância Gerenciada de SQL do Azure para criar sua instância dentro do pool. Para obter detalhes, examine o Início Rápido: Criar Instância Gerenciada de SQL do Azure.

6. Selecione Revisar + criar para revisar as configurações da nova instância e use Criar para implantar a instância dentro do pool selecionado.

PowerShell

Para identificar parâmetros de pool com o PowerShell, use Get-AzSqlInstancePool e crie sua instância gerenciada de SQL dentro do pool específico com New-AzSqlInstance.

Crie uma nova instância gerenciada de SQL em seu pool executando o seguinte script de exemplo:

$adminCredential = Get-Credential
$instancePool = Get-AzSqlInstancePool -ResourceGroupName <resource group name> -Name <instance pool name>

$instance01Params = @{
    Name = $instance01
    VCore = 2
    StorageSizeInGB = 32
    AdministratorCredential = $adminCredential
}

$instance01 = $instancePool | New-AzSqlInstance @instance01Params

CLI do Azure

Para criar uma nova instância gerenciada de SQL em seu pool com a CLI do Azure, forneça o nome do pool no --instance-pool-name parâmetro ao usar az sql mi create para criar sua instância:

#obtain the subnetId of an instance pool
sqlmipoolSubnetId=$(az sql instance-pool show -g <resource group name> -n <instance pool name> --query subnetId --output tsv)

az sql mi create \
  --license-type LicenseIncluded \
  --name <Instance name> \
  --admin-user <username> \
  --admin-password <password> \
  --capacity 2 \
  --instance-pool-name <instance pool name> \
  --storage 32 \
  --resource-group <resource group name> \
  --subnet $sqlmipoolSubnetId

Mover instância existente

Você pode mover uma instância gerenciada de SQL existente para dentro e para fora de um pool usando o PowerShell ou a CLI do Azure se:

• Está no mesmo grupo de recursos que o pool.
• Está na mesma rede virtual e sub-rede que o pool.
• Ajusta-se aos limites de recursos do pool de instâncias.

Quando uma instância existente é movida para um pool, as configurações no nível do pool prevalecem sobre as configurações no nível da instância. Por exemplo, a instância herda o tipo de licença e a janela de manutenção definida no nível do pool. Quando uma instância é movida para fora do pool, ela mantém as configurações herdadas do pool. A única exceção é com o tipo de licença, cujo padrão volta para 'LicenseIncluded' quando uma instância é removida do pool de instâncias: o Benefício Híbrido do Azure e o benefício dos direitos de failover híbrido devem ser configurados manualmente depois que uma instância é movida para fora de um pool.

No momento, não há suporte para mover uma instância existente dentro de um pool usando o portal do Azure.

PowerShell

Para mover uma instância gerenciada de SQL para um pool com o PowerShell, forneça o nome do pool ao usar Set-AzSqlInstance:

$instance01 | Set-AzSqlInstance -InstancePoolName $instancePoolName

Para mover uma instância para fora de um pool, forneça um nome de pool em branco:

$instance01 | Set-AzSqlInstance -InstancePoolName ''

CLI do Azure

Para mover uma instância gerenciada de SQL para um pool com a CLI do Azure, forneça o nome do --instance-pool-name pool no parâmetro ao usar az sql mi update para atualizar sua instância:

az sql mi update \
  --name <instance name> \
  --instance-pool-name <instance pool name> \
  --resource-group <resource group name>

Para mover uma instância de um pool, forneça um nome em branco no parâmetro --instance-pool-name ao usar az sql mi update para atualizar sua instância:

az sql mi update \
  --name <instance name> \
  --instance-pool-name '' \
  --resource-group <resource group name>

Conectar-se à instância em um pool

Você pode optar por se conectar a uma instância gerenciada de SQL em um pool com um ponto de extremidade privado ou um ponto de extremidade público. Para usar um ponto de extremidade privado, você precisará usar o Link Privado do Azure para a Instância Gerenciada de SQL do Azure.

Para se conectar a uma instância em um pool com um ponto de extremidade público, é necessário habilitar o ponto de extremidade e permitir o tráfego do ponto de extremidade público no grupo de segurança de rede.

Criar um banco de dados

Criar um banco de dados para uma instância gerenciada de SQL dentro de um pool é o mesmo que criar um banco de dados para uma única instância. Você pode criar um banco de dados usando o portal do Azure, o PowerShell ou a CLI do Azure.

Portal do Azure

Para criar um banco de dados para uma instância gerenciada de SQL existente usando o portal do Azure, siga estas etapas:

1. Acesse a Instância Gerenciada de SQL no portal do Azure.
2. No painel Visão geral, selecione + Novo banco de dados na barra de comandos para abrir a página Criar banco de dados gerenciado do SQL do Azure.
3. Forneça os detalhes do novo banco de dados.
4. Selecione Revisar + criar para conferir a configuração do novo banco de dados e use Criar para implantá-lo.

PowerShell

Para criar um novo banco de dados para sua instância gerenciada de SQL, use New-AzSqlInstanceDatabase:

$databaseParams = @{
    Name = "<database name>"
    InstanceName = "<instance name>"
    ResourceGroupName = "<resource group>"
}

New-AzSqlInstanceDatabase @databaseParams

CLI do Azure

Para criar uma nova banco de dados para sua instância, use az sql midb create:

az sql midb create
   --managed-instance <Instance name> \
   --name <Database name> \
   --resource-group <Resource group name>

Obter uso do pool

Você pode determinar como os recursos estão sendo usados por recursos em um pool usando o portal do Azure, o PowerShell ou a CLI do Azure.

Portal do Azure

Para obter uma lista de instâncias dentro de um pool, use o portal do Azure para exibir a página Pools da instância. Selecione o nome do pool para exibir as instâncias dentro do pool na página Visão geral:

PowerShell

Você pode usar o PowerShell para determinar como os recursos estão sendo usados em um pool.

Para obter uma lista de instâncias em um pool, use Get-AzSqlInstance:

$instancePool | Get-AzSqlInstance

Para obter o uso de recursos do pool, use Get-AzSqlInstancePoolUsage:

$instancePool| Get-AzSqlInstancePoolUsage

Você pode adicionar o parâmetro -ExpandChildren para obter uma visão geral detalhada do pool e das instâncias dentro dele:

$instancePool | Get-AzSqlInstancePoolUsage –ExpandChildren

Para listar os bancos de dados em uma instância, use Get-AzSqlInstanceDatabase:

$databaseParams = @{
    InstanceName = $instance01Name
    ResourceGroupName = $resourceGroupName
}

$databases = Get-AzSqlInstanceDatabase @databaseParams

Observação

Para verificar os limites das instâncias implantadas em um pool e dos bancos de dados por pool de instâncias, examine os limites de recursos.

CLI do Azure

Para obter informações sobre as instâncias e o uso de recursos no pool, use az sql instance-pool show:

sqlmipoolId=$(az sql instance-pool show --name <pool name> \
--resource-group <resource group name> --query id | cut -d '"' -f 2) \
az sql mi list --resource-group <resource group name> \
--query "[?instancePoolId == '$sqlmipoolId'].{sqlmiName:name}" -o tsv

Atualizar um pool de instâncias

Você pode atualizar as configurações de um pool de instâncias existente usando o portal do Azure, o PowerShell ou a CLI do Azure.

Portal do Azure

Use o painel Computação + armazenamento em Configurações da página Pool da instância no portal do Azure para atualizar o tipo de licença, o tamanho do vCore e o tipo de hardware do pool:

Use o painel Manutenção em Configurações da página Pool da Instância no portal do Azure para atualizar a janela de manutenção do pool:

PowerShell

Você pode usar o PowerShell para fazer alterações nos limites do pool de instâncias.

O script de exemplo a seguir altera o tipo de licença, o tamanho do vCore e o tipo de hardware:

Alterar tipo de licença:

$instancePoolParams = @{
    LicenseType = "BasePrice"
    VCores = 16
    ComputeGeneration = "Gen8"
}
$instancePool | Set-AzSqlInstancePool @instancePoolParams

Você também pode determinar agendas de janela de manutenção disponíveis:

$parameters = @{
    Location = $location
    MaintenanceScope = "SQLManagedInstance"
}

$configurations = Get-AzMaintenancePublicConfiguration @parameters
$maintenanceWindowOptions = $configurations | Where-Object { $_.Location -eq $location -and $_.MaintenanceScope -eq "SQLManagedInstance" }

Então você poderá alterar a janela de manutenção especificando uma opção de janela, como:

$instancePoolParams = @{
    MaintenanceConfigurationId = $maintenanceWindowOptions[1].Id
}

$instancePool | Set-AzSqlInstancePool @instancePoolParams

CLI do Azure

Para atualizar as definições de configuração do pool, use az sql instance-pool update:

az sql instance-pool update --name <pool name> \
--resource-group <resource group> --capacity 16 \
--license-type LicenseIncluded --family Gen8IM

Para atualizar a janela de manutenção:

maintenanceWindowOptions=$(az maintenance public-configuration list \
--query "[?location==<eastus2>&&contains(maintenanceScope,'SQLManagedInstance')]")

az sql instance-pool update --name <pool name> \
--resource-group <resource group> --maint-config-id <maintenance configuration id>

Atualizar uma instância em pool

Se os limites de recursos do pool não tiverem sido excedidos, você poderá modificar as configurações de recursos de uma instância em um pool usando o PowerShell ou a CLI do Azure,

PowerShell

Para modificar parâmetros de recursos para uma instância em um pool, use Set-AzSqlInstance.

A seguinte amostra atualiza os vCores para 8 e altera o tamanho do armazenamento da Instance1 para 512 GB:

$instancePoolParams = @{
    VCore = 8
    StorageSizeInGB = 512
    InstancePoolName = $instancePoolName
}

$instance1name | Set-AzSqlInstance @instancePoolParams

CLI do Azure

Para modificar parâmetros de recursos para uma instância em um pool, use az sql mi update.

A seguinte amostra atualiza os vCores para 8 e altera o tamanho do armazenamento da Instance1 para 512 GB:

az sql mi update \
  --name Instance1 \
  --resource-group <resource group name> \
  --capacity 8 \
  --storage 512

Excluir um pool de instância

Você poderá excluir um pool de instâncias usando o PowerShell ou a CLI do Azure, depois que todas as instâncias do pool tiverem sido excluídas ou movidas para fora do pool.

PowerShell

Para eliminar um conjunto de instâncias, use Remove-AzSqlInstancePool.

O seguinte exemplo de script exclui um pool de instâncias vazio:

$params = @{
    ResourceGroupName = "<resource group name>"
    Name = "<instance pool name>"
}

Remove-AzSqlInstancePool @params

CLI do Azure

Para excluir um conjunto de instâncias, use az sql instance-pool delete.

O seguinte exemplo de script exclui um pool de instâncias vazio:

az sql instance-pool delete
  --name <pool name>
  --resource group <resource group name>

Operações de pool de instâncias

A seguinte tabela mostra as operações de pool de instâncias disponíveis:

Comando	portal do Azure	PowerShell	CLI do Azure
Criar um pool de instância	Sim	Sim	Sim
Atualizar propriedades do pool	Sim	Sim	Sim
Verificar o uso e as propriedades de uma pool	Sim	Sim	Sim
Excluir um pool de instância	Sim	Sim	Sim
Criar uma instância gerenciada em um pool	Sim	Sim	Sim
Mover uma instância gerenciada para um pool	Não	Sim	Sim
Excluir uma instância gerenciada de um pool	Sim	Sim	Sim
Mover uma instância gerenciada para fora de um pool	Não	Sim	Sim
Criar um banco de dados em instância em um pool	Sim	Sim	Sim
Excluir um banco de dados de uma Instância Gerenciada de SQL	Sim	Sim	Sim

PowerShell

Para usar o PowerShell, instale a última versão do PowerShell Core e siga as instruções para Instalar o módulo do Azure PowerShell.

Comandos do PowerShell disponíveis:

Cmdlet	Descrição
New-AzSqlInstancePool	Criar um pool de instâncias.
Get-AzSqlInstancePool	Devolve informações sobre um pool de instância.
Set-AzSqlInstancePool	Definir propriedades para um pool de instâncias.
Remove-AzSqlInstancePool	Remover um pool de instâncias.
Get-AzSqlInstancePoolUsage	Retornar informações sobre o uso do pool de instâncias.

Para operações relacionadas a instâncias dentro de pools e instâncias únicas, use os comandos de instância gerenciada padrão, mas o nome do pool de instâncias propriedade deve ser populada ao usar esses comandos para uma instância em um pool.

CLI do Azure

Prepare seu ambiente para a CLI do Azure.

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para saber mais, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

Comandos da CLI do Azure disponíveis:

Cmdlet	Descrição
az sql instance-pool criar	Criar um pool de instâncias.
az sql instance-pool mostrar	Devolve informações sobre um pool de instância.
az sql instance-pool atualizar	Definir ou atualizar propriedades de um pool de instâncias.
az sql instance-pool excluir	Remover um pool de instâncias.

Limitações

As instâncias gerenciadas de SQL em um pool têm as seguintes limitações:

• O nome do pool pode conter apenas letras minúsculas, números e hifens e não pode começar com um hífen.
• Todas as instâncias do pool usam o mesmo modelo de licenciamento. Ao especificar um modelo de licença para uma instância que seja diferente do modelo de licença do pool, o modelo de licença do pool será usado. Quando a instância é movida para fora do pool, ela muda automaticamente para uma licença completa paga (LicenseType = 'LicenseIncluded'). Ative manualmente o Benefício Híbrido do Azure ou o benefício de direitos de failover híbrido para alterar o modelo de licenciamento.
• As instâncias agrupadas devem pertencer à mesma sub-rede e grupo de recursos. Mover uma instância para dentro e para fora do pool só é possível na sub-rede do pool e do mesmo grupo de recursos.
• Não há suporte para mover um pool de instâncias para outra sub-rede.
• Somente a camada de serviço de uso geral está disponível. As camadas de serviço Uso Geral de Próxima Geração e Comercialmente Crítico não estão disponíveis.
• Há suporte apenas para o hardware da série padrão (Gen5) ou da série premium. Não há suporte para o hardware com otimização de memória da série premium.
• O número máximo possível de instâncias no pool é 40.
• Um pool de instâncias só poderá ser excluído depois que todas as instâncias do pool forem excluídas ou movidas para fora do pool.
• Você não pode usar o portal do Azure para mover instâncias para dentro e para fora do pool. Use o PowerShell ou a CLI do Azure.
• Os seguintes recursos da Instância Gerenciada de SQL não têm suporte em instâncias em um pool:
  • Grupos de failover. Os Direitos de failover não estão disponíveis para instâncias de um pool.
  • Pare e inicie uma instância.
  • Redundância de Zona.

Solicitações de suporte

Crie e gerencie solicitações de suporte para pools de instância gerenciada de SQL no portal do Azure.

Para criar uma solicitação de suporte no portal do Azure, siga estas etapas:

1. Abra a página Nova solicitação de suporte no portal do Azure.

2. Forneça as seguintes informações em Nova solicitação de suporte:

   1. Em Tipo de problema, selecione Technical.
   2. Escolha a Assinatura apropriada na lista suspensa.
   3. Em Tipo de serviço, selecione SQL Managed Instance.
   4. Em Recurso, forneça o nome da sua Instância Gerenciada de SQL, se ela existir, ou selecione Pergunta geral se não for possível implantar sua instância no pool.
   5. Em Resumo, digite instance pools.
   6. Em Tipo de problema, escolha Create, Scale, Stop, Start, or Delete Resources.
   7. Em Subtipo de problema, escolha Instance Pools.

   

3. Selecione Avançar nas páginas subsequentes até que você possa criar sua solicitação de suporte.

Para criar implantações maiores de Instância Gerenciada de SQL (com ou sem pools de instâncias), talvez seja necessário obter uma cota regional maior. Para obter mais informações, consulte o aumento da cota de solicitação. A lógica de implantação para pools de instâncias compara o consumo total de vCore no nível do pool com sua cota para determinar se você tem permissão para criar novos recursos sem aumentar ainda mais sua cota.

Conteúdo relacionado

• Comparação de recursos: Banco de Dados SQL do Azure e Instância Gerenciada de SQL do Azure
• Arquitetura de conectividade de uma Instância Gerenciada de SQL do Azure
• Início Rápido: criar Instância Gerenciada de SQL do Azure
• Migração de Instância Gerenciada de SQL usando o Serviço de Migração de Banco de Dados
• Monitorar cargas de trabalho de SQL do Azure com o observador de banco de dados (versão prévia)
• Preços da Instância Gerenciada de SQL