コマンド ライン ツールを使った Hyperscale Elastic Poolの操作
適用対象: 
Azure SQL データベース
この記事では、Azure CLI や PowerShell などのコマンド ライン ツールを使って、データベースの作成、スケーリング、Hyperscale Elastic Poolへの移動を行う方法について説明します。 これらの方法に加えて、ほとんどの操作で常に Azure portal を使用できます。
前提条件
Hyperscale Elastic Poolを操作するには、以下が必要です。
- Azure サブスクリプション。 Azure サブスクリプションをお持ちでない場合は、無料アカウントを作成してください。
- リソース グループにデプロイされた Azure の論理サーバー。 この記事の例では、リソース グループに
my-example-rg、論理サーバーにmy-example-sql-svrという名前を使います。 - 最新バージョンの Azure PowerShell Az.Sql.3.11.0 以降または Azure CLI Az バージョン 2.40.0 以降
新しい Hyperscale Elastic Poolを作成する
Azure CLI または Azure PowerShell を使って、Hyperscale Elastic Poolを作成できます。
az sql elastic-pool create コマンドを使って Hyperscale Elastic Poolを作成します。
次の例では、4 つの仮想コアと 2 つのセカンダリ プール レプリカを持つ Hyperscale Elastic Poolを作成します。
az sql elastic-pool create --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_hs_pool" --edition "Hyperscale" --capacity 4 --family Gen5 --ha-replicas 2
次の例では、4 つの仮想コアおよび 1 つのセカンダリ プール レプリカを持つゾーン冗長 Hyperscale Elastic Poolを作成します。
az sql elastic-pool create --resource-group "myresourcegroup" --server "mylogicalserver" --name "zr-hs-ep" --family Gen5 --edition Hyperscale --capacity 4 --ha-replicas 1 --zone-redundant
Hyperscale Elastic Poolをスケールアップする
Azure CLI または Azure PowerShell を使って、既存の Hyperscale Elastic Poolをスケールアップできます。
az sql elastic-pool update コマンドを使って、既存の Hyperscale Elastic Poolをスケールアップします。
次の例では、既存の Hyperscale Elastic Poolを 8 つの仮想コアにスケールアップし、DB ごとの最小値と最大値をそれぞれ 0 と 2 に設定します。
az sql elastic-pool update --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_hs_pool" --capacity 8 --db-min-capacity 0 --db-max-capacity 2
Hyperscale Elastic Poolをスケールアウト (またはスケールイン) する
Azure CLI または Azure PowerShell を使って、既存の Hyperscale Elastic Poolのセカンダリ プール レプリカを追加または削除します (スケールアウトまたはスケールインとも呼ばれます)。
az sql elastic-pool update コマンドを使って、セカンダリ プール レプリカを追加することで既存の Hyperscale Elastic Poolをスケールアウトするか、セカンダリ プール レプリカを削除することでElastic Poolをスケールインします。
次の例では、4 つのセカンダリ プール レプリカを使うように既存の Hyperscale Elastic Poolをスケールアウトします。
# use the --ha-replicas (--read-replicas can also be used) parameter to specify the new number of high-availability replicas:
az sql elastic-pool update --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_hs_pool" --ha-replicas 4
次の例では、1 つのセカンダリ プール レプリカを使うように既存の Hyperscale Elastic Poolをスケールインします。
# use the --ha-replicas (--read-replicas can also be used) parameter to specify the new number of high-availability replicas:
az sql elastic-pool update --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_hs_pool" --ha-replicas 1
既存のデータベースを Hyperscale Elastic Poolに移動する
Azure CLI または Azure PowerShell を使って、Azure SQL Database の既存のデータベースを既存の Hyperscale Elastic Poolに移動できます。
az sql db update コマンドを使って、既存のデータベースを既存の Hyperscale Elastic Poolに移動します。
次の例では、データベース my_existing_db を既存の Hyperscale Elastic Pool my_hs_pool に移動します。
az sql db update --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_existing_db" --elastic-pool "my_hs_pool"
既存の Elastic Poolを Gen5 から Premium シリーズ ハードウェアにアップグレードする
Azure CLI または Azure PowerShell を使用して、既存のElastic Poolを Gen5 から Premium シリーズのハードウェアにアップグレードできます。
現在、Azure CLI では使用できません。 Azure PowerShell または Azure portal を使用してください。
既存の General Purpose データベースをゾーン冗長 Hyperscale Elastic Pool に変換
Azure CLI または Azure PowerShell を使用し、既存の General Purpose データベース をゾーン冗長 Hyperscale Elastic Pool に変換できます。
az sql db update --resource-group "myresourcegroup" --server "mylogicalserver" --name "gp_zrs_standalone_db" --elastic-pool "zr-hs-ep" --backup-storage-redundancy Zone
REST API
2021-11-01 REST API (またはそれ以降) を使って、Hyperscale Elastic Poolのセカンダリ レプリカを操作します。
次の例では、4 つのセカンダリ レプリカを使うように既存の Hyperscale Elastic Poolをスケールアウトします。
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}?api-version=2021-11-01-preview
{
"properties": {
"highAvailabilityReplicaCount": 4
}
}