Criar um pool de instâncias (versão prévia): Instância Gerenciada de SQL do Azure

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

1. Pesquise por pools de instâncias no portal do Azure e selecione o serviço Pools de instâncias para abrir a página Pools de instâncias.

   

2. Na página Pools de instância, selecione + Criar para abrir a página Criar pool de Instâncias Gerenciadas de SQL do Azure:

   

3. Em Criar pool de Instâncias Gerenciadas 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 de criar seu pool de instâncias, é possível criar uma instância no pool usando o portal do Azure. Também é possível mover uma instância existente para o pool usando o PowerShell ou a CLI do Azure.

Para criar seu pool de instâncias, 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

Para criar seu pool de instâncias, 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>

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

1. Acesse a página SQL do Azure no portal do Azure.

2. Na página SQL do Azure, selecione + Criar para abrir a página Selecionar opção de implantação do SQL.

3. No bloco Instâncias gerenciadas de SQL, escolha Instância única como o tipo de recurso e selecione Criar para abrir a página Criar Instância Gerenciada de SQL do Azure.

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.

   

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, consulte 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.

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

Crie uma nova instância 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

Para criar uma nova instância em seu pool com a CLI do Azure, forneça o nome do pool no parâmetro --instance-pool-name quando 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

Para mover uma instância 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 ''

Para mover uma instância para um pool com a CLI do Azure, forneça o nome do pool 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 <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>

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.

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

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

New-AzSqlInstanceDatabase @databaseParams

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>

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

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

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

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>

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

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

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

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>

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:

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.

Prepare seu ambiente para a CLI do Azure.

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no 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 obter mais informações, 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 ver outras opções de entrada, confira Conectar-se com 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 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: