次の方法で共有


コマンド ライン ツールを使った Hyperscale Elastic Poolの操作

適用対象: Azure SQL データベース

この記事では、Azure CLI や PowerShell などのコマンド ライン ツールを使って、データベースの作成、スケーリング、Hyperscale Elastic Poolへの移動を行う方法について説明します。 これらの方法に加えて、ほとんどの操作で常に Azure portal を使用できます。

前提条件

Hyperscale Elastic Poolを操作するには、以下が必要です。

新しい 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
  }
}