az sql elastic-pool

  • Referenz

Verwalten von Pools für elastische Datenbanken

Befehle

Name Beschreibung Typ Status
az sql elastic-pool create

Erstellen eines Pools für elastische Datenbanken

 Core Allgemein verfügbar
az sql elastic-pool delete

Löscht einen Pool für elastische Datenbanken.

 Core Allgemein verfügbar
az sql elastic-pool list

Ruft alle elastischen Pools in einem Server ab.

 Core Allgemein verfügbar
az sql elastic-pool list-dbs

Ruft eine Liste der Datenbanken in einem elastischen Pool ab.

 Core Allgemein verfügbar
az sql elastic-pool list-editions

Auflisten der für das aktive Abonnement verfügbaren elastischen Pooleditionen.

 Core Allgemein verfügbar
az sql elastic-pool op

Verwalten von Vorgängen in einem Pool für elastische Datenbanken

 Core Allgemein verfügbar
az sql elastic-pool op cancel

Bricht den asynchronen Vorgang im elastischen Pool ab.

 Core Allgemein verfügbar
az sql elastic-pool op list

Ruft eine Liste der Vorgänge ab, die für den elastischen Pool ausgeführt werden.

 Core Allgemein verfügbar
az sql elastic-pool show

Ruft einen Pool für elastische Datenbanken ab

 Core Allgemein verfügbar
az sql elastic-pool update

Aktualisieren Sie einen elastischen Pool.

 Core Allgemein verfügbar

az sql elastic-pool create

Bearbeiten

Erstellen eines Pools für elastische Datenbanken

az sql elastic-pool create --name
                           --resource-group
                           --server
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--ha-replicas]
                           [--license-type {BasePrice, LicenseIncluded}]
                           [--maint-config-id]
                           [--max-size]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--tags]
                           [--zone-redundant {false, true}]

Beispiele

Erstellen eines elastischen Pools mit aktivierter Zonenredundanz

az sql elastic-pool create -g mygroup -s myserver -n mypool -z

Erstellen eines elastischen Pools mit zonenredundanz explizit deaktivierter Zonenredundanz

az sql elastic-pool create -g mygroup -s myserver -n mypool -z false

Erstellen Sie einen Standard 100 DTU-Elastischen Pool.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Standard -c 100

Erstellen Sie einen elastischen Pool mit GeneralPurpose Edition, Gen4-Hardware und 1 vcore.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e GeneralPurpose -f Gen4 -c 1

Erstellen Sie einen elastischen Pool mit Hyperscale Edition, Gen5-Hardware, 4 vcore und 2 Hochverfügbarkeitsreplikaten.

az sql elastic-pool create -g mygroup -s myserver -n mydb -e Hyperscale -f Gen5 -c 4 --ha-replicas 2

Erstellen Sie einen elastischen Pool mit VBS-Enklave.

az sql elastic-pool create -g mygroup -s myserver -n mydb --preferred-enclave-type VBS

Erforderliche Parameter

--name -n

Der Name des elastischen Pools.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--server -s

Name des Azure SQL Server. Sie können die Standardeinstellung mithilfe von az configure --defaults sql-server=<name>.

Optionale Parameter

--capacity --dtu -c

Die Kapazitätskomponente der Sku in ganzzahliger Anzahl von DTUs oder vcores.

--db-dtu-max --db-max-capacity --db-max-dtu

Die maximale Kapazität (in DTUs oder vcores) kann jede Datenbank verbrauchen.

--db-dtu-min --db-min-capacity --db-min-dtu

Die Minumkapazität (in DTUs oder vcores) jeder Datenbank ist garantiert.

--edition --tier -e

Die Edition-Komponente der SKU. Zulässige Werte sind: Basic, Standard, Premium, GeneralPurpose, BusinessCritical.

--family -f

Die Berechnungsgenerierungskomponente der SKU (nur für Vcore-Skus). Zulässige Werte sind: Gen4, Gen5.

--ha-replicas --read-replicas

Die Anzahl der Replikate mit hoher Verfügbarkeit, die für die Datenbank bereitgestellt werden sollen. Nur für Hyperscale-Edition festgelegt.

--license-type

Der Lizenztyp, der für diesen elastischen Pool gilt.

Zulässige Werte: BasePrice, LicenseIncluded
--maint-config-id -m

Die konfigurations-ID oder der Name für diese Ressource Standard tenance angegeben.

--max-size --storage

Die maximale Speichergröße. Wenn keine Einheit angegeben ist, werden standardmäßig Bytes (B) verwendet.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--preferred-enclave-type

Der bevorzugte Enklavetyp für den Azure SQL Elastic Pool. Zulässige Werte sind: Default, VBS.

Zulässige Werte: Default, VBS
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--zone-redundant -z

Gibt an, ob Zonenredundanz aktiviert werden soll. Der Standardwert ist true, wenn kein Wert angegeben wird.

Zulässige Werte: false, true
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql elastic-pool delete

Bearbeiten

Löscht einen Pool für elastische Datenbanken.

az sql elastic-pool delete [--ids]
                           [--name]
                           [--no-wait]
                           [--resource-group]
                           [--server]
                           [--subscription]

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name des elastischen Pools.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--server -s

Name des Azure SQL Server. Sie können die Standardeinstellung mithilfe von az configure --defaults sql-server=<name>.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql elastic-pool list

Bearbeiten

Ruft alle elastischen Pools in einem Server ab.

az sql elastic-pool list [--ids]
                         [--resource-group]
                         [--server]
                         [--skip]
                         [--subscription]

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--server -s

Name des Azure SQL Server. Sie können die Standardeinstellung mithilfe von az configure --defaults sql-server=<name>.

--skip

Die Anzahl der elemente in der Auflistung, die übersprungen werden sollen. Der Standardwert ist None.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql elastic-pool list-dbs

Bearbeiten

Ruft eine Liste der Datenbanken in einem elastischen Pool ab.

az sql elastic-pool list-dbs [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name des elastischen Pools.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--server -s

Name des Azure SQL Server. Sie können die Standardeinstellung mithilfe von az configure --defaults sql-server=<name>.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql elastic-pool list-editions

Bearbeiten

Auflisten der für das aktive Abonnement verfügbaren elastischen Pooleditionen.

Umfasst auch verfügbare DTU-Einstellungen, Speicherlimits und datenbankbezogene Einstellungen für den Pool. Zum Verringern der Ausführlichkeit sind zusätzliche Speicherlimits und datenbankbezogene Einstellungen standardmäßig ausgeblendet.

az sql elastic-pool list-editions --location
                                  [--available]
                                  [--dtu]
                                  [--edition]
                                  [--show-details {db-max-dtu, db-max-size, db-min-dtu, max-size}]
                                  [--vcores]

Beispiele

Zeigen Sie alle elastischen Pooleditionen und DTU-Beschränkungen des Pools in der Region West AN.

az sql elastic-pool list-editions -l westus -o table

Alle DTU-Beschränkungen des Pools für Standard edition in der Region West US anzeigen.

az sql elastic-pool list-editions -l westus --edition Standard -o table

Zeigen Sie die verfügbaren maximalen Größen für elastische Pools mit mindestens 100 DTUs in der Region West an.

az sql elastic-pool list-editions -l westus --dtu 100 --show-details max-size -o table

Anzeigen der verfügbaren Datenbankeinstellungen für standard 100 DTU-elastische Pools in der Region West-USA.

az sql elastic-pool list-editions -l westus --edition Standard --dtu 100 -o table --show-details db-min-dtu db-max-dtu db-max-size

Erforderliche Parameter

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

Optionale Parameter

--available -a

Wenn angegeben, zeigen Sie nur Ergebnisse an, die in der angegebenen Region verfügbar sind.

Standardwert: False
--dtu

Die Anzahl der dtUs, nach der gesucht werden soll. Wenn nicht angegeben, werden alle DTU-Größen angezeigt.

--edition --tier -e

Edition, nach der gesucht werden soll. Wenn nicht angegeben, werden alle Editionen angezeigt.

--show-details -d

Liste der zusätzlichen Details, die in die Ausgabe aufgenommen werden sollen.

Zulässige Werte: db-max-dtu, db-max-size, db-min-dtu, max-size
--vcores

Anzahl der zu suchden Vcores. Wenn nicht angegeben, werden alle vcore-Größen angezeigt.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql elastic-pool show

Bearbeiten

Ruft einen Pool für elastische Datenbanken ab

az sql elastic-pool show [--ids]
                         [--name]
                         [--resource-group]
                         [--server]
                         [--subscription]

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name des elastischen Pools.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--server -s

Name des Azure SQL Server. Sie können die Standardeinstellung mithilfe von az configure --defaults sql-server=<name>.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az sql elastic-pool update

Bearbeiten

Aktualisieren Sie einen elastischen Pool.

az sql elastic-pool update [--add]
                           [--capacity]
                           [--db-dtu-max]
                           [--db-dtu-min]
                           [--edition]
                           [--family]
                           [--force-string]
                           [--ha-replicas]
                           [--ids]
                           [--maint-config-id]
                           [--max-size]
                           [--name]
                           [--no-wait]
                           [--preferred-enclave-type {Default, VBS}]
                           [--remove]
                           [--resource-group]
                           [--server]
                           [--set]
                           [--subscription]
                           [--zone-redundant {false, true}]

Beispiele

Aktualisieren des elastischen Pools mit aktivierter Zonenredundanz

az sql elastic-pool update -g mygroup -s myserver -n mypool -z

Aktualisieren des elastischen Pools mit explizit deaktivierter Zonenredundanz

az sql elastic-pool update -g mygroup -s myserver -n mypool -z false

Aktualisieren des elastischen Pools mit 2 Replikaten mit hoher Verfügbarkeit

az sql elastic-pool update -g mygroup -s myserver -n mypool --ha-replicas 2

Aktualisieren des elastischen Pools mit VBS-Enklave

az sql elastic-pool update -g mygroup -s myserver -n mypool --preferred-enclave-type VBS

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []
--capacity --dtu -c

Die Kapazitätskomponente der Sku in ganzzahliger Anzahl von DTUs oder vcores.

--db-dtu-max --db-max-capacity --db-max-dtu

Die maximale Kapazität (in DTUs oder vcores) kann jede Datenbank verbrauchen.

--db-dtu-min --db-min-capacity --db-min-dtu

Die Minumkapazität (in DTUs oder vcores) jeder Datenbank ist garantiert.

--edition --tier -e

Die Edition-Komponente der SKU. Zulässige Werte sind: Basic, Standard, Premium, GeneralPurpose, BusinessCritical.

--family -f

Die Berechnungsgenerierungskomponente der SKU (nur für Vcore-Skus). Zulässige Werte sind: Gen4, Gen5.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False
--ha-replicas --read-replicas

Die Anzahl der Replikate mit hoher Verfügbarkeit, die für die Datenbank bereitgestellt werden sollen. Nur für Hyperscale-Edition festgelegt.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--maint-config-id -m

Die konfigurations-ID oder der Name für diese Ressource Standard tenance angegeben.

--max-size --storage

Die maximale Speichergröße. Wenn keine Einheit angegeben ist, werden standardmäßig Bytes (B) verwendet.

--name -n

Der Name des elastischen Pools.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--preferred-enclave-type

Typ der Enklave, die für den elastischen Pool konfiguriert werden soll.

Zulässige Werte: Default, VBS
--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--server -s

Name des Azure SQL Server. Sie können die Standardeinstellung mithilfe von az configure --defaults sql-server=<name>.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--zone-redundant -z

Gibt an, ob Zonenredundanz aktiviert werden soll. Der Standardwert ist true, wenn kein Wert angegeben wird.

Zulässige Werte: false, true
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.