Freigeben über

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

  • Artikel

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 einen Pool für elastische Hyperscale-Datenbanken verschieben. Zusätzlich zu diesen Methoden können Sie für die meisten Vorgänge immer das Azure-Portal verwenden.

Voraussetzungen

Für die Arbeit mit Ihrem Pool für elastische Hyperscale-Datenbanken sollten Sie über Folgendes verfügen:

Erstellen eines neuen Pools für elastische Hyperscale-Datenbanken

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 Pool für elastische Hyperscale-Datenbanken mit vier virtuellen Kernen und zwei sekundären Poolreplikaten 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-Pool für elastische Datenbanken 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

Hochskalieren eines Pools für elastische Hyperscale-Datenbanken

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 skaliert einen vorhandenen Pool für elastische Hyperscale-Datenbanken auf acht virtuelle Kerne hoch und legt die Min- und Max-Werte pro Datenbank auf 0 bzw. 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

Auf- oder Abskalieren eines Pools für elastische Hyperscale-Datenbanken

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 Pool für elastische Hyperscale-Datenbanken durch Hinzufügen eines sekundären Poolreplikats aufzuskalieren oder durch Entfernen solcher Replikate abzuskalieren.

Das folgende Beispiel skaliert einen vorhandenen Pool für elastische Hyperscale-Datenbanken auf, sodass vier sekundäre Poolreplikate verwendet 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 einen vorhandenen Pool für elastische Hyperscale-Datenbanken ab, sodass nur ein sekundäres Poolreplikat verwendet wird:

# 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

Verschieben einer vorhandenen Datenbank in einen Pool für elastische Hyperscale-Datenbanken

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 vorhandenen elastischen Pools von Gen5 auf die Hardware der Premium-Serie

Sie können die Azure CLI oder Azure PowerShell einsetzen, um einen vorhandenen Pool für elastische Datenbanken von Gen5 auf Premium-Hardware zu aktualisieren.

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

Konvertieren einer vorhandenen Allzweckdatenbank in einen zonenredundanten Hyperscale-Pool für elastische Datenbanken

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 für Pools für elastische Hyperscale-Datenbanken zu arbeiten.

Das folgende Beispiel skaliert einen vorhandenen Pool für elastische Hyperscale-Datenbanken auf, sodass vier sekundäre Replikate verwendet werden:

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