Freigeben über

Arbeiten mit Hyperscale-Pools für elastische Datenbanken mithilfe von Befehlszeilentools

Gilt für:Azure SQL-Datenbank

In diesem Artikel erfahren Sie, wie Sie Datenbanken mithilfe von Befehlszeilentools wie der Azure CLI und PowerShell erstellen, skalieren und in einen Hyperscale-Elastic-Pool verschieben. Zusätzlich zu diesen Methoden können Sie für die meisten Vorgänge immer das Azure-Portal verwenden.

Voraussetzungen

Um mit Ihrem Hyperscale-Elasticitätspool zu arbeiten, sollten Sie Folgendes haben:

Erstellen Sie einen neuen Hyperscale-Elastic-Pool

Sie können die Azure CLI oder Azure PowerShell verwenden, um einen Pool für elastische Hyperscale-Datenbanken zu erstellen.

Verwenden Sie den Befehl az sql elastic-pool create, um einen Pool für elastische Hyperscale-Datenbanken zu erstellen.

Im folgenden Beispiel wird ein Hyperscale-elastischer Pool mit vier vCores und zwei sekundären Pool-Replikaten erstellt:

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

Das folgende Beispiel erstellt einen zonenredundanten Hyperscale-Elastic-Pool mit vier vCores und einem sekundären Poolreplikat:

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

Skalierung eines Hyperscale-Elastic-Pools

Sie können die Azure CLI oder Azure PowerShell verwenden, um einen vorhandenen Pool für elastische Hyperscale-Datenbanken hochzuskalieren.

Verwenden Sie den Befehl az sql elastic-pool update, um einen vorhandenen Pool für elastische Hyperscale-Datenbanken hochzuskalieren.

Das folgende Beispiel erhöht einen vorhandenen Hyperscale-elastischen Pool auf 8 vCores und legt die minimalen und maximalen Werte pro Datenbank auf jeweils 0 und 2 fest.

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

Hoch- oder Herunterskalieren eines elastischen Hyperscale-Pools

Verwenden Sie die Azure CLI oder Azure PowerShell, um sekundäre Poolreplikate für einen vorhandenen Pool für elastische Hyperscale-Datenbanken hinzuzufügen oder zu entfernen – dies wird auch als Aufskalieren bzw. Abskalieren bezeichnet.

Verwenden Sie den Befehl az sql elastic-pool update, um einen Hyperscale-elastischen Pool durch das Hinzufügen eines sekundären Poolreplikats horizontal zu skalieren oder durch das Entfernen solcher Replikate horizontal zu reduzieren.

Das folgende Beispiel skaliert einen vorhandenen Hyperscale elastischen Pool auf, sodass vier sekundäre Poolreplikate genutzt werden.

# 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

Das folgende Beispiel skaliert innerhalb eines vorhandenen Hyperscale elastischen Pools, um ein sekundäres Poolreplikat zu verwenden:

# 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

Vorhandene Datenbank in einen Hyperscale-elastischen Pool verschieben

Sie können die Azure CLI oder Azure PowerShell verwenden, um eine vorhandene Datenbank in Azure SQL-Datenbank in einen vorhandenen Pool für elastische Hyperscale-Datenbanken zu verschieben.

Verwenden Sie den Befehl az sql db update, um eine vorhandene Datenbank in einen vorhandenen Pool für elastische Hyperscale-Datenbanken zu verschieben.

Das folgende Beispiel verschiebt die Datenbank my_existing_db in den vorhandenen Pool für elastische Hyperscale-Datenbanken 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"

Upgrade eines bestehenden elastischen Pools von Gen5 auf die Hardware der Premium-Serie

Sie können die Azure CLI oder Azure PowerShell einsetzen, um einen vorhandenen elastischen Pool von Gen5 auf Premium-Serie Hardware zu aktualisieren.

Aktuell über Azure CLI nicht verfügbar. Verwenden Sie Azure PowerShell oder das Azure-Portal stattdessen.

Konvertieren einer vorhandenen General-Purpose-Datenbank in einen zonenredundanten Hyperscale-Elastic-Pool.

Sie können die Azure CLI oder Azure PowerShell verwenden, um eine bestehende Allzweckdatenbank in einen zonenredundanten Hyperscale-Pool für elastische Datenbanken zu konvertieren.

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

Verwenden Sie die REST-API 2021-11-01 (oder höher), um mit sekundären Replikaten von Hyperscale-Elastic-Pools zu arbeiten.

Das folgende Beispiel erweitert einen vorhandenen elastischen Hyperscale-Pool, um vier sekundäre Replikate zu verwenden.

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

Zugehöriger Inhalt

  • Last updated on