インスタンスプール (プレビュー) を作成する - Azure SQL Managed Instance

[アーティクル]
05/30/2024

この記事では、Azure portal、PowerShell または Azure CLI を使用して Azure SQL Managed Instance 用インスタンスプールを作成する方法および、PowerShell または Azure CLI を使用してプール間でインスタンスを移動する方法を説明します。

インスタンスプールを使用すると、共有リソースを持つ複数のインスタンスを 1 つの仮想マシンにデプロイできます。これにより、より小規模でコンピューティング負荷の少ないワークロードを大規模な SQL Managed Instance に統合することなく、複数の SQL Server インスタンスを移行するための便利でコスト効率の高いインフラストラクチャが提供されます。

Note

現在、Azure SQL Managed Instance 用インスタンスプールはプレビュー段階にあります。

前提条件

インスタンスプールを作成するには、次が必要です。

適切なサイズのサブネット範囲を持つ既存の仮想ネットワーク。
PowerShell の現在のバージョンまたは最新バージョンの Azure CLI の最新の Az.SQL モジュール。
インスタンスとプールのプロパティを確認しました。

サブネットサイズの考慮事項

インスタンスプールを使用する場合は、サブネットのサイズを慎重に計画してください。サブネットのサイズ設定ガイドラインについては、「必要なサブネットサイズと範囲の決定」を参照してください。

複数の General Purpose インスタンスを含む 1 つのインスタンスプールで必要な IP アドレスの数を計算する場合は、次の式を使用します。

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

# of MIs は、プロビジョニングする予定の可能性のあるインスタンスの最大数を指します。プール内のインスタンスの最大数は 40 です。

インスタンスプールを作成する

インスタンスプールは、Azure portal、PowerShell、または Azure CLI を使用して作成できます。次の点について検討してください。

現在利用できるのは、Standard シリーズ (Gen5) またはプレミアムシリーズのハードウェアの General Purpose サービスレベルのみです。
プール名に使用できるのは、小文字、数字、ハイフンのみで、先頭をハイフンにすることはできません。
Azure ハイブリッド特典は、インスタンスプールレベルで適用されます。プールの作成時にライセンスの種類を設定し、プールの作成後にライセンスの種類を更新できます。

重要

インスタンスプールのデプロイは長期の操作であり、4.5 時間かかりる場合があります。

Azure Portal でインスタンスプールを作成するには、次の手順を実行します。

Azure portal でインスタンスプールを検索し、インスタンスプール サービスを選択して [インスタンスプール] ページを開きます。
[インスタンスプール] ページで [+ 作成] を選択し、[Azure SQL Managed Instance プールの作成] ページを開きます。
[Azure SQL Managed Instance プールの作成] で次のことを行います。
1. [基本] タブで、プロジェクトとインスタンスの詳細を入力します。
2. [コンピューティング + ストレージ] で [インスタンスプールの構成] を使用して [コンピューティング + ストレージ] ページを開き、プールで使用するサービスレベル、コンピューティングハードウェア、SQL Server ライセンスを選択します。 [適用] を選択してコンピューティング設定を保存し、[Azure SQL Managed Instance プールの作成] ページに戻ります。
3. 既存の仮想ネットワークを選択するか、[ネットワーク] タブで新しい仮想ネットワークを構成します。
4. (省略可能) [追加設定] タブで、プールの既定以外のメンテナンス期間を構成します。
5. [確認と作成] タブで構成を確認し、[作成] を選択してインスタンスプールを作成します。
プールのデプロイは [通知] から監視できます。

インスタンスプールが作成されたら、Azure portal を使用してプールに新しいインスタンスを作成するか、PowerShell または Azure CLI を使用して既存のインスタンスをプールに移動します。

インスタンスプールを作成するには、New-AzSqlInstancePool を使用します。

次の点について検討してください。

LicenseType には、Azure ハイブリッド特典の BasePrice を使用します。または、Azure ハイブリッド特典割引に使用できる SQL Server ライセンスがない場合は、LicenseIncluded を使用します。
Get-AzLocation | select displayname, location を使用して、インスタンスプールが使用可能なリージョンの一覧を取得します。

次のサンプルスクリプトを実行して、Standard シリーズ (Gen5) ハードウェアに 8 個の仮想コアを持つ新しいインスタンスプールを作成します。

$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

インスタンスプールを作成するには、az sql instance-pool create を使用します。

次の点について検討してください。

--license-type の場合、Azure ハイブリッド特典の BasePrice を使用し、Azure ハイブリッド特典割引に使用できる SQL Server ライセンスがない場合は、LicenseIncluded を使用します。

次のサンプルスクリプトを実行して、Standard シリーズ (Gen5) ハードウェアに 8 個の仮想コアを持つ新しいインスタンスプールを作成します。

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

プール内に新しいインスタンスを作成する

プールが作成されたら、Azure portal、PowerShell または Azure CLI を使用して、プール内に新しいインスタンスを作成できます。

次の点について検討してください。

新しいインスタンスのライセンスの種類を指定し、プールのライセンスの種類と一致させる必要があります。

Azure portal を使用してプール内に新しいインスタンスを作成するには、次の手順を実行します。

Azure portal の [Azure SQL] ページに移動します。
[Azure SQL] ページで [+ 作成] を選び、[SQL デプロイオプションの選択] を開きます。
[SQL マネージドインスタンス] タイルで、リソースの種類にはドロップダウンから [単一インスタンス] を選択し、[作成] を選択して [Azure SQL Managed Instance の作成] ページを開きます。
[Azure SQL Managed Instance の作成] ページの [基本] タブで、以下を実行します。
1. 既存のインスタンスプールを含むリソースグループを選択します。
2. インスタンスプール内に新しいインスタンスを作成するには、[マネージドインスタンスの詳細] の [インスタンスプールに所属] で [はい] を選択します。
3. [インスタンスプール] ドロップダウンリストからプールを選択します。
[Azure SQL Managed Instance の作成] ページで残りの詳細を入力し、プール内にインスタンスを作成します。詳細については、「Azure SQL Managed Instance の作成」を確認してください。
[確認と作成] を選択して新しいインスタンスの設定をレビューしたら、[作成] を選択して選択したプール内にインスタンスをデプロイします。

PowerShell でプールパラメーターを識別するには、Get-AzSqlInstancePool を使用し、New-AzSqlInstance を使用して特定のプール内にインスタンスを作成します。

次のサンプルスクリプトを実行して、プールに新しいインスタンスを作成します。

$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

Azure CLI でプールに新しいインスタンスを作成するには、az sql mi create を使用してインスタンスを作成するときに、--instance-pool-name パラメーターにプール名を指定します。

#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

既存のインスタンスを移動する

次の場合は、PowerShell または Azure CLI を使用して、プールとの間で既存のインスタンスを移動できます。

プールと同じリソースグループにあります。
プールと同じ仮想ネットワークとサブネット上にあります。
これは、インスタンスプールのリソース制限に適合します。

既存のインスタンスがプールに移動されると、プールレベルの設定がインスタンスレベルの設定よりも優先されます。たとえば、インスタンスは、プールレベルで設定されたライセンスの種類とメンテナンス期間を継承します。インスタンスがプールから移動されると、そのインスタンスはプールから継承した設定を保持します。唯一の例外は、インスタンスがインスタンスプールから削除されたときに既定で "LicenseIncluded" に戻るライセンスの種類で、インスタンスがプールから移動された後、Azure ハイブリッド特典とハイブリッドフェールオーバー権限の特典を手動で構成する必要があります。

現在、Azure portal を使用したプール内の既存のインスタンスの移動はサポートされていません。

PowerShell
Azure CLI

PowerShell でインスタンスをプールに移動するには、Set-AzSqlInstance を使用するときにプール名を指定します。

$instance01 | Set-AzSqlInstance -InstancePoolName $instancePoolName

インスタンスをプールから移動するには、空のプール名を指定します。

$instance01 | Set-AzSqlInstance -InstancePoolName ''

Azure CLI でインスタンスをプールに移動するには、az sql mi update を使用してインスタンスを更新するときに、--instance-pool-name パラメーターにプール名を指定します。

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

インスタンスをプールから移動するには、az sql mi update を使用してインスタンスを更新するときに、--instance-pool-name パラメーターに空のプール名を指定します。

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

プール内のインスタンスに接続する

プライベートエンドポイントまたはパブリックエンドポイントを使用して、プール内のインスタンスに接続することができます。プライベートエンドポイントを使用するには、Azure Private Link を使用する必要があります。

パブリックエンドポイントでプール内のインスタンスに接続するには、エンドポイントを有効化した後、ネットワークセキュリティグループでパブリックエンドポイントトラフィックを許可します。

データベースの作成

プール内のインスタンスのデータベースの作成は、単一インスタンスのデータベースの作成と同じです。 Azure Portal、PowerShell、または Azure CLI を使用して新しいデータベースを作成できます。

Azure portal を使用して既存の SQL マネージドインスタンスに新しいデータベースを作成するには、次の手順を実行します。

Azure Portal で、[SQL Managed Instance] に移動します。
[概要] ウィンドウでコマンドバーから [+ 新しいデータベース] を選んで、[Azure SQL マネージドデータベースを作成する] ページを開きます。
新しいデータベースの詳細を指定します。
[確認と作成] を選択して新しいデータベース構成をレビューしたら、[作成] を選択してデータベースをデプロイします。

インスタンスの新しいデータベースを作成するには、New-AzSqlInstanceDatabase を使用します。

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

New-AzSqlInstanceDatabase @databaseParams

インスタンスの新しいデータベースを作成するには、az sql midb create を使用します。

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

PowerShell を使用して、プール内でリソースがどのように使用されているかを判断できます。

プール内のインスタンスの一覧を取得するには、Get-AzSqlInstance を使用します。

$instancePool | Get-AzSqlInstance

プールリソース配分状況を取得するには、Get-AzSqlInstancePoolUsage を使用します。

$instancePool| Get-AzSqlInstancePoolUsage

ExpandChildren パラメーターを追加して、プールとその内部のインスタンスの詳細な概要を取得できます。

$instancePool | Get-AzSqlInstancePoolUsage –ExpandChildren

インスタンス内のデータベースを一覧表示するには、Get-AzSqlInstanceDatabase を使用します。

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

$databases = Get-AzSqlInstanceDatabase @databaseParams

Note

プールにデプロイされたインスタンスとインスタンスプールあたりのデータベースの制限をチェックするには、リソースの制限を確認します。

プール内のインスタンスとリソース配分状況に関する情報を取得するには、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

インスタンスプールを更新する

PowerShell または Azure CLI を使用して、既存のインスタンスプールの設定を更新できます。

PowerShell
Azure CLI

PowerShell を使用して、インスタンスプールの制限を変更できます。

次のサンプルスクリプトでは、ライセンスの種類、仮想コアのサイズ、ハードウェアの種類を変更します。

ライセンスの種類を変更します。

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

使用可能なメンテナンス期間のスケジュールを決定することもできます。

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

その後、期間オプションを指定してメンテナンス期間を変更できます。例を次に示します。

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

$instancePool | Set-AzSqlInstancePool @instancePoolParams

プールの構成設定を更新するには、az sql instance-pool update を使用します。

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

メンテナンス期間を更新するには

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>

プールされたインスタンスを更新する

プールリソースの制限を超えていない場合は、PowerShell または Azure CLI を使用して、プール内のインスタンスのリソース構成を変更できます。

PowerShell
Azure CLI

プール内のインスタンスのリソースパラメーターを変更するには、Set-AzSqlInstance を使用します。

次のサンプルでは、仮想コアを 8 に更新し、Instance1 のストレージサイズを 512 GB に変更します。

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

$instance1name | Set-AzSqlInstance @instancePoolParams

プール内のインスタンスのリソースパラメーターを変更するには、az sql mi update を使用します。

次のサンプルでは、仮想コアを 8 に更新し、Instance1 のストレージサイズを 512 GB に変更します。

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

インスタンスプールを削除する

プール内のすべてのインスタンスが削除されたか、プールから移動されたら、PowerShell または Azure CLI を使用してインスタンスプールを削除できます。

PowerShell
Azure CLI

インスタンスプールを削除するには、Remove-AzSqlInstancePool を使用します。

次のサンプルスクリプトは、空のインスタンスプールを削除します。

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

Remove-AzSqlInstancePool @params

インスタンスプールを削除するには、az sql instance-pool delete を使用します。

次のサンプルスクリプトは、空のインスタンスプールを削除します。

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

インスタンスプールの操作

次の表は、使用可能なインスタンスプール操作を示しています。

command	Azure portal	PowerShell	Azure CLI
インスタンスプールを作成する	はい	イエス	はい
プールのプロパティの更新する	いいえ	イエス	はい
プールの使用とプロパティを確認する	はい	イエス	はい
インスタンスプールを削除する	はい	イエス	はい
プール内に新しいマネージドインスタンスを作成する	はい	イエス	はい
Managed Instance をプールに移動する	いいえ	イエス	はい
プールから Managed Instance を削除する	はい	イエス	はい
Managed Instance をプールから移動する	いいえ	イエス	はい
プール内のインスタンスにデータベースを作成する	はい	イエス	はい
SQL Managed Instance からデータベースを削除する	はい	イエス	はい

PowerShell
Azure CLI

Powershell を使用するには、最新バージョンの PowerShell Core をインストールし、指示に従って Azure PowerShell モジュールをインストールします。

使用可能な PowerShell コマンド

コマンドレット	説明
New-AzSqlInstancePool	インスタンスプールを作成します。
Get-AzSqlInstancePool	インスタンスプールに関する情報を返します。
Set-AzSqlInstancePool	インスタンスプールのプロパティを設定します。
Remove-AzSqlInstancePool	インスタンスプールを削除します。
Get-AzSqlInstancePoolUsage	インスタンスプールの使用状況に関する情報を返します。

プール内のインスタンスと単一インスタンスの両方に関連する操作では、標準のマネージドインスタンスコマンドを使用しますが、プール内のインスタンスでこれらのコマンドを使用する場合は、"インスタンスプール名" プロパティを設定する必要があります。

Azure CLI の環境を準備します。

Azure Cloud Shell で Bash 環境を使用します。詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。
CLI リファレンスコマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。
- ローカルインストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。認証プロセスを完了するには、ターミナルに表示される手順に従います。その他のサインインオプションについては、Azure CLI でのサインインに関するページを参照してください。
- 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。
- az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。最新バージョンにアップグレードするには、az upgrade を実行します。

使用可能な Azure CLI コマンド:

コマンドレット	説明
az sql instance-pool create	インスタンスプールを作成します。
az sql instance-pool show	インスタンスプールに関する情報を返します。
az sql instance-pool update	インスタンスプールのプロパティを設定または更新します。
az sql instance-pool delete	インスタンスプールを削除します。

制限事項

パブリックプレビュー中、プール内のインスタンスには次の制限があります。

プール名に使用できるのは、小文字、数字、ハイフンのみで、先頭をハイフンにすることはできません。
プール内のすべてのインスタンスは、同じライセンスモデルを使用します。プールのライセンスモデルとは異なるインスタンスのライセンスモデルを指定すると、プールのライセンスモデルが使用されます。インスタンスがプールから移動されると、完全な有料ライセンス (LicenseType = 'LicenseIncluded') に自動的に切り替わります。ライセンスモデルを変更するには、Azure ハイブリッド特典またはハイブリッドフェールオーバー権限の特典を手動でアクティブ化します。
プールされたインスタンスは、同じサブネットとリソースグループに属している必要があります。プールとの間でのインスタンスの移動は、プールのサブネットと同じリソースグループ内でのみ可能です。
General Purpose サービスレベルのみが、Standard シリーズ (Gen5) またはプレミアムシリーズのハードウェアで使用できます。 Next-gen General Purpose、Business Critical サービスレベルとプレミアムシリーズのメモリ最適化ハードウェアは使用できません。
プール内のインスタンスの最大数は 40 です。
インスタンスプールは、プール内のすべてのインスタンスが削除されるか、プールから移動された後にのみ削除できます。
Azure portal で次のことを行うことはできません。
- インスタンスプールを構成します。 PowerShell または Azure CLI を使用してください。
- プール内外にインスタンスを移動します。 PowerShell または Azure CLI を使用してください。
インスタンスがプール内にある場合、次の SQL Managed Instance 機能はサポートされません。
- フェールオーバーグループ。フェールオーバー権限は、プール内のインスタンスでは使用できません。
- 開始、停止。
- ゾーン冗長性。
- 予約容量インスタンスの価格については、提供されていません。

サポートリクエスト

Azure portal でインスタンスプールのサポート要求を作成および管理します。

Azure portal で新しいサポートリクエストを作成するには、次の手順に従います。

Azure portal で [新規サポートリクエスト] ページを開きます。
[新規サポートリクエスト] に次の情報を入力します。
1. [問題の種類] には Technical を選択します。
2. ドロップダウンリストから適切なサブスクリプションを選択します。
3. [サービスの種類] には SQL Managed Instance を選択します。
4. [リソース] で、SQL Managed Instance が存在する場合は名前を指定します。または、プール内にインスタンスをデプロイできない場合は [一般的な質問] を選択します。
5. [概要] に instance pools と入力します。
6. [問題の種類] で Create, Scale, Stop, Start, or Delete Resources を選択します。
7. [問題のサブタイプ] で Instance Pools を選択します。
サポートリクエストを [作成] できるようになるまで、続きのページで [次へ] を選択します。

インスタンスプールの有無にかかわらず、より大きな SQL Managed Instance のデプロイを作成するには、より大きなリージョンクォータを取得することが必要な場合があります。詳細については、「Azure SQL Database のクォータの増加を要求する」を参照してください。インスタンスプールのデプロイロジックによって "プールレベルでの" 仮想コアの合計消費量がご利用のクォータと比較され、そのクォータをさらに増やすことなく新しいリソースの作成を許可するかどうかが決定されます。

次の方法で共有

インスタンスプール (プレビュー) を作成する - Azure SQL Managed Instance

前提条件

サブネットサイズの考慮事項

インスタンスプールを作成する

プール内に新しいインスタンスを作成する

既存のインスタンスを移動する

プール内のインスタンスに接続する

データベースの作成

プールの使用状況を取得する

インスタンスプールを更新する

プールされたインスタンスを更新する

インスタンスプールを削除する

インスタンスプールの操作

制限事項

サポートリクエスト

フィードバック

フィードバック

その他のリソース

次の方法で共有

インスタンス プール (プレビュー) を作成する - Azure SQL Managed Instance

前提条件

サブネット サイズの考慮事項

インスタンス プールを作成する

プール内に新しいインスタンスを作成する

既存のインスタンスを移動する

プール内のインスタンスに接続する

データベースの作成

プールの使用状況を取得する

インスタンス プールを更新する

プールされたインスタンスを更新する

インスタンス プールを削除する

インスタンス プールの操作

制限事項

サポート リクエスト

関連するコンテンツ

フィードバック

フィードバック

その他のリソース

インスタンスプール (プレビュー) を作成する - Azure SQL Managed Instance

サブネットサイズの考慮事項

インスタンスプールを作成する

インスタンスプールを更新する

インスタンスプールを削除する

インスタンスプールの操作

サポートリクエスト