Créer un pool d'instances (Aperçu) : Azure SQL Managed Instance

Pour créer un pool d'instances dans le portail Azure, procédez comme suit :

1. Recherchez des pools d’instances dans le Portail Azure et sélectionnez le service Pools d’instances pour ouvrir la page Pools d’instances :

   

2. Sur la page Pools d'instances, sélectionnez + Créer pour ouvrir la page Créer un pool Azure SQL Managed Instance :

   

3. Dans Créer un pool Azure SQL Managed Instance :

   1. Fournissez les détails du projet et de l'instance dans l'onglet Bases.
   2. Utilisez Configurer le pool d’instances sous Calcul + stockage pour ouvrir la page Calcul + Stockage, puis choisissez le niveau de service, le matériel de calcul et la licence SQL Server que vous souhaitez utiliser pour le pool. Utilisez Appliquer pour enregistrer vos paramètres de calcul et revenir à la page Créer un pool Azure SQL Managed Instance.
   3. Sélectionnez un réseau virtuel existant ou configurez un nouveau réseau virtuel sous l’onglet Mise en réseau.
   4. (Facultatif) Configurez une fenêtre de maintenance non par défaut pour le pool sous l’onglet Paramètres supplémentaires.
   5. Passez en revue votre configuration sous l’onglet Vérifier + créer, puis sélectionnez Créer pour créer votre pool d’instances.

   

4. Vous pouvez surveiller le déploiement du pool depuis Notifications.

Une fois votre pool d’instances créé, vous pouvez créer une instance dans le pool à l’aide du Portail Azure, ou vous pouvez déplacer une instance existante dans le pool à l’aide de PowerShell ou d’Azure CLI.

Pour créer votre pool d'instances, utilisez New-AzSqlInstancePool.

Tenez compte des éléments suivants :

• Pour LicenseType, utilisez BasePrice pour Azure Hybrid Benefit ou LicenseIncluded si vous n'avez pas de licence SQL Server qui peut être utilisée pour la remise Azure Hybrid Benefit.
• Utilisez Get-AzLocation | select displayname, location pour obtenir une liste des régions où des pools d'instances sont disponibles.

Créez un nouveau pool d'instances avec 8 vCores sur du matériel de série standard (Gen5) en exécutant l'exemple de script suivant :

$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

pour créer votre pool d'instances, utilisez az sql instance-pool create.

Tenez compte des éléments suivants :

• Pour --license-type, utilisez BasePrice pour Azure Hybrid Benefit ou LicenseIncluded si vous n'avez pas de licence SQL Server qui peut être utilisée pour la remise Azure Hybrid Benefit.

Créez un nouveau pool d'instances avec 8 vCores sur du matériel de série standard (Gen5) en exécutant l'exemple de script suivant :

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

Pour créer une nouvelle instance dans un pool à l'aide du portail Azure, procédez comme suit :

1. Accédez à la page Azure SQL dans le portail Azure.

2. Dans la page Azure SQL, sélectionnez +Créer pour ouvrir la page Sélectionner l’option de déploiement SQL.

3. Dans la vignette SQL Managed Instances, sélectionnez Instance unique en tant que type de ressource, puis sélectionnez Créer pour ouvrir la page Créer Azure SQL Managed Instance.

4. Dans l’onglet Bases de la page Créer Create Azure SQL Managed Instance :

   1. Sélectionnez le groupe de ressources qui contient votre pool d’instances existant.
   2. Choisissez Oui pour Appartenir à un pool d’instances ? sous Détails de Managed Instance pour créer votre nouvelle instance à l’intérieur d’un pool d’instances.
   3. Sélectionnez le pool dans la liste déroulante Pool d'instances.

   

5. Remplissez les détails restants sur la page Créer Azure SQL Managed Instance, pour créer votre instance dans le pool. Pour plus d’informations, passez en revue Créer Azure SQL Managed Instance.

6. Sélectionnez Vérifier + créer pour passer en revue les paramètres de votre nouvelle instance, puis utilisez Créer pour déployer votre instance dans le pool sélectionné.

Pour identifier les paramètres du pool avec PowerShell, utilisez Get-AzSqlInstancePool, puis créez votre instance dans le pool spécifique avec New-AzSqlInstance.

Créez une nouvelle instance dans votre pool en exécutant l'exemple de script suivant :

$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

Pour créer une instance dans votre pool avec l’Azure CLI, indiquez le nom du pool dans le paramètre --instance-pool-name lorsque vous utilisez az sql mi create pour créer votre instance :

#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

Pour déplacer une instance dans un pool avec PowerShell, indiquez le nom du pool lorsque vous utilisez Set-AzSqlInstance :

$instance01 | Set-AzSqlInstance -InstancePoolName $instancePoolName

Pour déplacer une instance hors d'un pool, fournissez un nom de pool vide :

$instance01 | Set-AzSqlInstance -InstancePoolName ''

Pour déplacer une instance dans un pool avec Azure CLI, indiquez le nom du pool dans le paramètre --instance-pool-name lorsque vous utilisez az sql mi update pour mettre à jour votre instance :

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

Pour déplacer une instance hors d'un pool, fournissez un nom vide dans le paramètre --instance-pool-name lorsque vous utilisez az sql mi update pour mettre à jour votre instance :

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

Pour créer une nouvelle base de données pour un SQL managed instance existant en utilisant le portail Azure, procédez comme suit :

1. Accédez à votre SQL Managed Instance dans le portail Azure.
2. Dans le volet Vue d'ensemble, choisissez + Nouvelle base de données depuis la barre de commandes pour ouvrir la page Créer une base de données Azure SQL gérée.
3. Fournissez les détails pour la nouvelle base de données.
4. Sélectionnez Vérifier + créer pour passer en revue votre nouvelle configuration de base de données, puis utilisez Créer pour déployer votre base de données.

Pour créer une nouvelle base de données pour votre instance, utilisez New-AzSqlInstanceDatabase :

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

New-AzSqlInstanceDatabase @databaseParams

Pour créer une nouvelle base de données pour votre instance, utilisez az sql midb create :

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

Vous pouvez utiliser PowerShell pour déterminer comment les ressources sont utilisées à l'intérieur d'un pool.

Pour obtenir la liste des instances à l'intérieur d'un pool, utilisez Get-AzSqlInstance :

$instancePool | Get-AzSqlInstance

Pour obtenir l'utilisation des ressources du pool, utilisez Get-AzSqlInstancePoolUsage :

$instancePool| Get-AzSqlInstancePoolUsage

Vous pouvez ajouter le paramètre -ExpandChildren pour obtenir une vue d'ensemble détaillée du pool et des instances qu'il contient :

$instancePool | Get-AzSqlInstancePoolUsage –ExpandChildren

Pour répertorier les bases de données d'une instance, utilisez Get-AzSqlInstanceDatabase :

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

$databases = Get-AzSqlInstanceDatabase @databaseParams

Pour obtenir des informations sur les instances et sur l'utilisation des ressources dans le pool, utilisez 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

Vous pouvez utiliser PowerShell pour modifier les limites du pool d'instances.

L'exemple de script suivant modifie le type de licence, la taille vCore et le type de matériel :

Changer de type de licence :

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

Vous pouvez également déterminer les planifications de fenêtre de maintenance disponibles :

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

Vous pouvez ensuite modifier la fenêtre de maintenance en spécifiant une option de fenêtre, par exemple :

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

$instancePool | Set-AzSqlInstancePool @instancePoolParams

Pour mettre à jour les paramètres de configuration de votre pool, utilisez az sql instance-pool update :

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

Pour mettre à jour la fenêtre de maintenance :

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>

Pour modifier les paramètres de ressource d'une instance à l'intérieur d'un pool, utilisez Set-AzSqlInstance.

L'exemple suivant met à jour les vCores sur 8 et remplace la taille de stockage par 512 Go pour Instance1 :

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

$instance1name | Set-AzSqlInstance @instancePoolParams

Pour modifier les paramètres de ressource d'une instance à l'intérieur d'un pool, utilisez az sql mi update.

L'exemple suivant met à jour les vCores sur 8 et remplace la taille de stockage par 512 Go pour Instance1 :

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

Pour supprimer un pool d'instances, utilisez Remove-AzSqlInstancePool.

L'exemple de script suivant supprime un pool d'instances vide :

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

Remove-AzSqlInstancePool @params

Pour supprimer un pool d'instances, utilisez az sql instance-pool delete.

L'exemple de script suivant supprime un pool d'instances vide :

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

Pour utiliser PowerShell, installez la dernière version de PowerShell Core et suivez les instructions pour installer le module Azure PowerShell.

Commandes PowerShell disponibles :

Pour les opérations liées aux instances à la fois dans les pools et les instances uniques, utilisez les commandes de l’instance managée standard, mais la propriété de nom du pool d’instances doit être remplie lors de l’utilisation de ces commandes pour une instance d’un pool.

Préparez votre environnement pour l’interface Azure CLI.

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.

  

• Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.

  • Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.

  • Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.

  • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Commandes Azure CLI disponibles :