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

Ein Azure-Abonnement. Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen.
Einen logischen Server in Azure, der in einer Ressourcengruppe bereitgestellt ist. Die Beispiele in diesem Artikel verwenden den Namen my-example-rg für die Ressourcengruppe und my-example-sql-svr für den logischen Server.
Die neueste Version von Azure PowerShell (Az.Sql.3.11.0 oder höher ) oder der Azure CLI (Az-Version 2.40.0 oder höher)

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.

Azure-Befehlszeilenschnittstelle
PowerShell

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

Verwenden Sie das Cmdlet New-AzSqlElasticPool, um einen Pool für elastische Hyperscale-Datenbanken zu erstellen.

Im folgende Beispiel wird ein Pool für elastische Hyperscale-Datenbanken mit vier virtuellen Kernen und zwei sekundären Poolreplikaten erstellt:

New-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool" -Edition "Hyperscale" -VCore 4 -ComputeGeneration Gen5 -HighAvailabilityReplicaCount 2

Im folgende Beispiel wird ein zonenredundanter Pool für elastische Hyperscale-Datenbanken mit vier virtuellen Kernen und einem sekundären Poolreplikat erstellt:

New-AzSqlElasticPool -ResourceGroupName "myresourcegroup" -ServerName "mylogicalserver" -ElasticPoolName "zr-hs-ep" -Edition Hyperscale -ComputeGeneration Gen5 -VCore 4 -HighAvailabilityReplicaCount 1 -ZoneRedundant

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.

Azure-Befehlszeilenschnittstelle
PowerShell

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

Verwenden Sie das Cmdlet Set-AzSqlElasticPool, 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:

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool" -VCore 8 -DatabaseVCoreMin 0 -DatabaseVCoreMax 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.

Azure-Befehlszeilenschnittstelle
PowerShell

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

Verwenden Sie das Cmdlet Set-AzSqlElasticPool, 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:

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool"  -HighAvailabilityReplicaCount 4

Das folgende Beispiel skaliert einen vorhandenen Pool für elastische Hyperscale-Datenbanken ab, sodass nur ein sekundäres Poolreplikat verwendet wird:

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool"  -HighAvailabilityReplicaCount 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.

Azure-Befehlszeilenschnittstelle
PowerShell

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"

Verwenden Sie das Cmdlet Set-AzSqlDatabase, 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:

Set-AzSqlDatabase -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -DatabaseName "my_existing_db" -ElasticPoolName "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.

Azure-Befehlszeilenschnittstelle
PowerShell

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

Verwenden Sie das Cmdlet Set-AzSqlElasticPool, um einen vorhandenen Pool für elastische Hyperscale-Datenbanken hochzuskalieren.

Im folgenden Beispiel wurde ein Upgrade eines vorhandenen Hyperscale-Pools für elastische Datenbanken my_hs_pool auf Hardware der Premium-Serie vorgenommen:

Set-AzSqlElasticPool -ResourceGroupName "my-example-rg" -ServerName "my-example-sql-svr" -ElasticPoolName "my_hs_pool" -ComputeGeneration "PRMS"

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.

Azure-Befehlszeilenschnittstelle
PowerShell

az sql db update --resource-group "myresourcegroup" --server "mylogicalserver" --name "gp_zrs_standalone_db" --elastic-pool "zr-hs-ep" --backup-storage-redundancy Zone

Set-AzSqlDatabase -ResourceGroupName "myResourceGroup" -ServerName "mylogicalserver" -DatabaseName gp1 -ElasticPoolName "my-ZR-Hyperscale-EP" -BackupStorageRedundancy 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
  }
}

Feedback

War diese Seite hilfreich?

Last updated on 2024-09-12