Creare un pool di istanze (anteprima) - Istanza gestita di SQL di Azure

Seguire questa procedura per creare un pool di istanze nel portale di Azure:

1. Cercare pool di istanze nel portale di Azure e selezionare il servizio Pool di istanze per aprire la pagina Pool di istanze:

   

2. Nella pagina pool di istanze, selezionare + Crea per aprire la pagina Crea Istanza gestita di SQL di Azure:

   

3. Su Creare un'istanza gestita di SQL di Azure:

   1. Nella scheda Dati principali specificare i dettagli di Progetto e Istanza.
   2. Usare Configura pool di istanze in Calcolo e archiviazione per aprire la paginaCalcolo e Archiviazione e scegliere il livello di servizio, l'hardware di calcolo e la licenza di SQL Server che si vuole usare per il pool. Usare Applica per salvare le impostazioni di calcolo e tornare alla pagina Crea pool Istanza gestita di SQL di Azure.
   3. Selezionare una rete virtuale esistente o configurare una nuova rete virtuale nella scheda Rete.
   4. (Facoltativo) Configurare una finestra di manutenzione non predefinita per il pool nella scheda Impostazioni aggiuntive.
   5. Esaminare la configurazione nella scheda Rivedi e crea e quindi selezionare Crea per creare il pool di istanze.

   

4. È possibile monitorare la distribuzione del pool da Notifiche.

Dopo aver creato il pool di istanze, è possibile creare una nuova istanza nel pool usando il portale di Azure oppure spostare un'istanza esistente nel pool usando PowerShell o l'interfaccia della riga di comando di Azure.

Per creare il pool di istanze, usare New-AzSqlInstancePool.

Considerare quanto segue:

• Per LicenseType, usare BasePrice per il Vantaggio Azure Hybrid o LicenseIncluded se non si dispone di una licenza di SQL Server che può essere usata per lo sconto Vantaggio Azure Hybrid.
• Usare Get-AzLocation | select displayname, location per ottenere un elenco di aree in cui sono disponibili pool di istanze.

Creare un nuovo pool di istanze con 8 vCore su hardware serie standard (Gen5) eseguendo lo script di esempio seguente:

$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

Per creare il pool di istanze, usare az sql instance-pool create.

Considerare quanto segue:

• Per --license-type, usare BasePrice per il Vantaggio Azure Hybrid o LicenseIncluded se non si dispone di una licenza di SQL Server che può essere usata per lo sconto Vantaggio Azure Hybrid.

Creare un nuovo pool di istanze con 8 vCore su hardware serie standard (Gen5) eseguendo lo script di esempio seguente:

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

Per creare una nuova istanza all’interno di un pool tramite il portale di Azure, seguire questa procedura:

1. Passare alla pagina Azure SQL nel portale di Azure.

2. Nella pagina Azure SQL, selezionare + Crea per aprire Selezionare l'opzione di distribuzione SQL.

3. Nel riquadro Istanze gestite di SQL selezionare Istanza singola come tipo di risorsa e quindi selezionare Crea per aprire la pagina Crea istanza gestita di SQL di Azure.

4. Nella scheda Dati generali della pagina Crea Istanza gestita di SQL di Azure:

   1. Selezionare il gruppo di risorse che contiene il pool di istanze esistente.
   2. Scegliere Sì per Appartiene a un pool di istanze? in Dettagli istanza gestita per creare la nuova istanza all'interno di un pool di istanze.
   3. Selezionare il pool dall'elenco a discesa pool di istanze.

   

5. Inserire i dettagli rimanenti nella pagina Crea Istanza gestita di SQL di Azure per creare la propria istanza all’interno del pool. Per informazioni dettagliate, vedere Creare Istanza gestita di SQL.

6. Selezionare Rivedi e crea per rivedere le impostazioni per la nuova istanza e quindi usare Crea per distribuire l'istanza all'interno del pool selezionato.

Per identificare i parametri del pool con PowerShell, usare Get-AzSqlInstancePool e quindi creare l'istanza all'interno del pool specifico con New-AzSqlInstance.

Creare una nuova istanza nel pool eseguendo lo script di esempio seguente:

$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

Per creare una nuova istanza nel pool con l’interfaccia della riga di comando di Azure, specificare il nome del pool nel parametro --instance-pool-name quando si usa az sql mi create per creare l'istanza:

#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

Per spostare un'istanza in un pool con PowerShell, specificare il nome del pool quando si usa Set-AzSqlInstance:

$instance01 | Set-AzSqlInstance -InstancePoolName $instancePoolName

Per spostare un'istanza da un pool, specificare un nome di pool vuoto :

$instance01 | Set-AzSqlInstance -InstancePoolName ''

Per spostare un'istanza in un pool con l’interfaccia della riga di comando di Azure, specificare il nome del pool nel parametro --instance-pool-name quando si usa az sql mi update per aggiornare l'istanza:

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

Per spostare un'istanza da un pool, specificare un nome vuoto nel parametro --instance-pool-name quando si usa az sql mi update per aggiornare l'istanza:

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

Per creare un nuovo database per un’istanza gestita di SQL esistente tramite il portale di Azure, seguire questa procedura:

1. Passare a Istanza gestita di SQL nel portale di Azure.
2. Nella pagina Panoramica scegliere + Nuovo database dalla barra di comando per aprire la pagina Crea database gestito di Azure SQL.
3. Specificare i dettagli per il nuovo database.
4. Selezionare Rivedi e crea per esaminare la nuova configurazione del database e quindi usare Crea per distribuire il database.

Per creare un nuovo database per l'istanza, usare New-AzSqlInstanceDatabase:

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

New-AzSqlInstanceDatabase @databaseParams

Per creare un nuovo database per l'istanza, usare az sql midb create:

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

È possibile usare PowerShell per determinare come vengono usate le risorse all'interno di un pool.

Per ottenere un elenco di istanze all'interno di un pool, usare Get-AzSqlInstance:

$instancePool | Get-AzSqlInstance

Per ottenere l'utilizzo delle risorse del pool, usare Get-AzSqlInstancePoolUsage:

$instancePool| Get-AzSqlInstancePoolUsage

È possibile aggiungere il parametro -ExpandChildren per ottenere una panoramica dettagliata del pool e delle istanze al suo interno:

$instancePool | Get-AzSqlInstancePoolUsage –ExpandChildren

Per elencare i database in un'istanza, usare Get-AzSqlInstanceDatabase:

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

$databases = Get-AzSqlInstanceDatabase @databaseParams

Per ottenere informazioni sulle istanze e sull'utilizzo delle risorse nel pool, usare 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

È possibile usare PowerShell per apportare modifiche ai limiti del pool di istanze.

Lo script di esempio seguente modifica il tipo di licenza, le dimensioni vCore e il tipo di hardware:

Cambiare tipo di licenza:

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

È anche possibile determinare le pianificazioni della finestra di manutenzione disponibili:

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

È quindi possibile modificare la finestra di manutenzione specificando un'opzione di finestra, ad esempio:

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

$instancePool | Set-AzSqlInstancePool @instancePoolParams

Per aggiornare le impostazioni di configurazione per il pool, usare az sql instance-pool update:

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

Per aggiornare la finestra di manutenzione:

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>

Per modificare i parametri delle risorse per un'istanza all'interno di un pool, usare Set-AzSqlInstance.

Il seguente campione aggiorna i vCore a 8 e modifica le dimensioni di archiviazione a 512 GB per Instance1:

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

$instance1name | Set-AzSqlInstance @instancePoolParams

Per modificare i parametri delle risorse per un'istanza all'interno di un pool, usare az sql mi update.

Il seguente campione aggiorna i vCore a 8 e modifica le dimensioni di archiviazione a 512 GB per Instance1:

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

Per eliminare un pool di istanze, usare Remove-AzSqlInstancePool.

Lo script di esempio seguente elimina un pool di istanze vuoto:

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

Remove-AzSqlInstancePool @params

Per eliminare un pool di istanze, usare az sql instance-pool delete.

Lo script di esempio seguente elimina un pool di istanze vuoto:

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

Per usare PowerShell, installare l’ultima versione di PowerShell Core e seguire le istruzioni per installare il modulo Azure PowerShell.

Comandi di PowerShell disponibili:

Per le operazioni correlate alle istanze sia all'interno di pool che singole, usare i comandi per istanze gestite standard. La proprietà instance pool name deve essere popolata quando si usano questi comandi per un'istanza in un pool.

Preparare l'ambiente per l'interfaccia della riga di comando di Azure.

• Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido su Bash in Azure Cloud Shell.

  

• Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.

  • Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere tramite l'interfaccia della riga di comando di Azure.

  • Quando richiesto, al primo utilizzo installare l'estensione dell'interfaccia della riga di comando di Azure. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.

  • Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

Comandi disponibili dell’interfaccia della riga di comando di Azure: