Bekerja dengan kumpulan elastis Hyperscale menggunakan alat baris perintah

Berlaku untuk:Azure SQL Database

Dalam artikel ini, pelajari cara membuat, menskalakan, dan memindahkan database ke kumpulan elastis Hyperscale menggunakan alat baris perintah seperti Azure CLI dan PowerShell. Selain metode ini, Anda selalu dapat menggunakan portal Azure untuk sebagian besar operasi.

Catatan

Kumpulan elastis untuk Hyperscale saat ini dalam pratinjau.

Prasyarat

Untuk bekerja dengan kumpulan elastis Hyperscale, Anda harus memiliki:

Membuat kumpulan elastis Hyperscale baru

Anda dapat menggunakan Azure CLI atau Azure PowerShell untuk membuat kumpulan elastis Hyperscale.

Gunakan perintah az sql elastic-pool create untuk membuat kumpulan elastis Hyperscale.

Contoh berikut membuat kumpulan elastis Hyperscale dengan empat vCore, dan dua replika kumpulan sekunder:

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

Contoh berikut membuat kumpulan elastis Hyperscale zona redundan dengan empat vCore dan satu replika kumpulan sekunder:

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

Meningkatkan skala kumpulan elastis Hyperscale

Anda dapat menggunakan Azure CLI atau Azure PowerShell untuk meningkatkan kumpulan elastis Hyperscale yang ada.

Gunakan perintah az sql elastic-pool update untuk meningkatkan kumpulan elastis Hyperscale yang ada.

Contoh berikut meningkatkan kumpulan elastis Hyperscale yang ada menjadi 8 vCore dan mengatur per-DB min dan maks ke 0 dan 2, masing-masing:

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

Peluasan skala (atau di) kumpulan elastis Hyperscale

Gunakan Azure CLI atau Azure PowerShell untuk menambahkan atau menghapus replika kumpulan sekunder untuk kumpulan elastis Hyperscale yang ada - juga dikenal sebagai penskalaan keluar atau penskalaan masuk.

Gunakan perintah az sql elastic-pool update untuk menskalakan kumpulan elastis Hyperscale yang ada dengan menambahkan replika kumpulan sekunder atau menskalakan dalam kumpulan elastis dengan menghapus replika kumpulan sekunder.

Contoh berikut menskalakan kumpulan elastis Hyperscale yang ada untuk menggunakan empat replika kumpulan sekunder:

# 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

Contoh berikut menskalakan dalam kumpulan elastis Hyperscale yang ada untuk menggunakan satu replika kumpulan sekunder:

# 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

Memindahkan database yang sudah ada ke kumpulan elastis Hyperscale

Anda dapat menggunakan Azure CLI atau Azure PowerShell untuk memindahkan database yang sudah ada di Azure SQL Database ke kumpulan elastis Hyperscale yang ada.

Gunakan perintah az sql db update untuk memindahkan database yang ada ke kumpulan elastis Hyperscale yang ada.

Contoh berikut memindahkan database my_existing_db ke kumpulan elastis my_hs_poolHyperscale yang ada :

az sql db update --resource-group "my-example-rg" --server "my-example-sql-svr" --name "my_existing_db" --elastic-pool "my_hs_pool"

Meningkatkan kumpulan elastis yang ada dari Gen5 ke perangkat keras seri premium

Anda dapat menggunakan Azure CLI atau Azure PowerShell untuk meningkatkan kumpulan elastis yang ada dari Gen5 ke perangkat keras seri premium.

Saat ini tidak tersedia melalui Azure CLI. Gunakan Azure PowerShell atau portal Azure sebagai gantinya.

Memigrasikan database Tujuan Umum yang ada ke kumpulan elastis Hyperscale zona redundan

Anda dapat menggunakan Azure CLI atau Azure PowerShell untuk memigrasikan database Tujuan Umum yang ada ke kumpulan elastis Hyperscale zona redundan.

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

Gunakan REST API 2021-11-01 (atau yang lebih baru) untuk bekerja dengan replika sekunder untuk kumpulan elastis Hyperscale.

Contoh berikut menskalakan kumpulan elastis Hyperscale yang ada untuk menggunakan empat replika sekunder:

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