Teilen über

az sql db replica

  • Referenz

Verwalten der Replikation zwischen Datenbanken.

Befehle

Name Beschreibung Typ Status
az sql db replica create

Erstellen Sie eine Datenbank als lesbares sekundäres Replikat einer vorhandenen Datenbank.

 Kern GA
az sql db replica delete-link

Beenden Sie die Datenreplikation zwischen zwei Datenbankreplikaten dauerhaft.

 Kern GA
az sql db replica list-links

Auflisten der Replikate einer Datenbank und ihres Replikationsstatus.

 Kern GA
az sql db replica set-primary

Legen Sie die primäre Replikatdatenbank fest, indem Sie einen Fehler aus der aktuellen primären Replikatdatenbank ausführen.

 Kern GA

az sql db replica create

Bearbeiten

Erstellen Sie eine Datenbank als lesbares sekundäres Replikat einer vorhandenen Datenbank.

Eine vollständige Liste der Optionen auf Leistungsebene kann durch Ausführen angezeigt az sql db list-editions -a -o table -l LOCATIONwerden. Die sekundäre Datenbank muss dieselbe Edition wie die primäre Datenbank aufweisen.

az sql db replica create --name
                         --partner-server
                         --resource-group
                         --server
                         [--assign-identity {false, true}]
                         [--auto-pause-delay]
                         [--availability-zone]
                         [--backup-storage-redundancy]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--elastic-pool]
                         [--encryption-protector]
                         [--encryption-protector-auto-rotation {false, true}]
                         [--family]
                         [--federated-client-id]
                         [--ha-replicas]
                         [--keys]
                         [--license-type {BasePrice, LicenseIncluded}]
                         [--min-capacity]
                         [--no-wait]
                         [--partner-database]
                         [--partner-resource-group]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective]
                         [--tags]
                         [--umi]
                         [--zone-redundant {false, true}]

Beispiele

Erstellen Sie eine Datenbank mit S0-Leistungsstufe als sekundäres Replikat einer vorhandenen Standarddatenbank.

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --service-objective S0

Erstellen einer Datenbank mit GeneralPurpose Edition, Gen4-Hardware und 1 vcore als sekundäres Replikat einer vorhandenen GeneralPurpose-Datenbank

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb -f Gen4 -c 1

Erstellen Sie eine Datenbank mit zonenredundantem Sicherungsspeicher als sekundäres Replikat einer vorhandenen Datenbank.

az sql db replica create -g mygroup -s myserver -n originalDb --partner-server newDb --backup-storage-redundancy Zone

Erforderliche Parameter

--name -n

Name der Azure SQL-Datenbank.

--partner-server

Name des Servers, in dem das neue Replikat erstellt werden soll.

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

--assign-identity -i

Zuweisen der Identität für die Datenbank.

Zulässige Werte: false, true
--auto-pause-delay

Die Zeit in Minuten, nach der die Datenbank automatisch angehalten wird. Ein Wert von -1 bedeutet, dass die automatische Pause deaktiviert ist.

--availability-zone

Verfügbarkeitszone.

--backup-storage-redundancy --bsr

Sicherungsspeicherredundanz, die zum Speichern von Sicherungen verwendet wird. Zulässige Werte sind: Lokal, Zone, Geo, GeoZone.

--capacity -c

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

--compute-model

Das Berechnungsmodell der Datenbank.

Zulässige Werte: Provisioned, Serverless
--elastic-pool

Der Name oder die Ressourcen-ID des elastischen Pools, in dem die Datenbank erstellt werden soll.

--encryption-protector

Gibt den Azure Key Vault-Schlüssel an, der als Datenbankverschlüsselungsschutzschlüssel verwendet werden soll.

--encryption-protector-auto-rotation --epauto

Gibt das Automatische Drehungskennzeichnung für die Datenbankverschlüsselungsschutztaste an. Dies kann entweder "true", "false" oder "null" sein.

Zulässige Werte: false, true
--family -f

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

--federated-client-id

Die Verbundclient-ID für die SQL-Datenbank. Sie wird für das mandantenübergreifende CMK-Szenario verwendet.

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

--keys

Die Liste der AKV-Schlüssel für die SQL-Datenbank.

--license-type

Der lizenztyp, der für diese Datenbank gilt. LicenseIncluded, wenn Sie eine Lizenz benötigen, oder BasePrice, wenn Sie über eine Lizenz verfügen und für azure HybridBenefit berechtigt sind.

Zulässige Werte: BasePrice, LicenseIncluded
--min-capacity

Minimale Kapazität, die die Datenbank immer zugewiesen hat, wenn sie nicht angehalten wird.

--no-wait

Warten Sie nicht, bis der lange ausgeführte Vorgang abgeschlossen ist.

Standardwert: False
--partner-database

Name des neuen Replikats. Wenn nicht angegeben, wird standardmäßig der Quelldatenbankname verwendet.

--partner-resource-group

Name der Ressourcengruppe, in der das neue Replikat erstellt werden soll. Wenn nicht angegeben, wird standardmäßig die Ursprungsressourcengruppe verwendet.

--preferred-enclave-type

Gibt den Typ der Enklave für diese Ressource an.

Zulässige Werte: Default, VBS
--read-scale

Wenn diese Option aktiviert ist, werden Verbindungen, für die die Anwendungsabsicht in ihrer Verbindungszeichenfolge festgelegt ist, möglicherweise an ein readonly sekundäres Replikat weitergeleitet. Diese Eigenschaft ist nur für Premium- und Business Critical-Datenbanken festgelegt.

Zulässige Werte: Disabled, Enabled
--secondary-type

Typ der zu erstellenden sekundären Datei. Zulässige Werte sind: Geo, Named.

--service-level-objective --service-objective

Das Dienstziel für die neue Datenbank. Beispiel: Basic, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

--tags

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

--umi --user-assigned-identity-id

Die Liste der vom Benutzer zugewiesenen Identitäten für die SQL-Datenbank.

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Bearbeiten

Beenden Sie die Datenreplikation zwischen zwei Datenbankreplikaten dauerhaft.

az sql db replica delete-link --partner-server
                              [--ids]
                              [--name]
                              [--partner-resource-group]
                              [--resource-group]
                              [--server]
                              [--subscription]
                              [--yes]
--partner-server

Der Name des Servers, in dem sich das andere Replikat befindet.

--ids

Mindestens eine 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

Name der Azure SQL-Datenbank.

--partner-resource-group

Name der Ressourcengruppe, in der sich das andere Replikat befindet. Wenn nicht angegeben, wird standardmäßig die Ressourcengruppe der ersten Datenbank verwendet.

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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--yes -y

Zur Bestätigung nicht auffordern.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Bearbeiten

Auflisten der Replikate einer Datenbank und ihres Replikationsstatus.

az sql db replica list-links [--ids]
                             [--name]
                             [--resource-group]
                             [--server]
                             [--subscription]

Auflisten der Replikate einer Datenbank und ihres Replikationsstatus. (automatisch generiert)

az sql db replica list-links --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver
--ids

Mindestens eine 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

Name der Azure SQL-Datenbank.

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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az sql db replica set-primary

Bearbeiten

Legen Sie die primäre Replikatdatenbank fest, indem Sie einen Fehler aus der aktuellen primären Replikatdatenbank ausführen.

az sql db replica set-primary [--allow-data-loss]
                              [--ids]
                              [--name]
                              [--resource-group]
                              [--server]
                              [--subscription]

Beispiele

Legen Sie die primäre Replikatdatenbank fest, indem Sie einen Fehler aus der aktuellen primären Replikatdatenbank ausführen. (automatisch generiert)

az sql db replica set-primary --allow-data-loss --name MyDatabase --resource-group MyResourceGroup --server myserver --subscription MySubscription

Optionale Parameter

--allow-data-loss

Wenn angegeben, ermöglicht der Failovervorgang Datenverlust.

Standardwert: False
--ids

Mindestens eine 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 der Datenbank, die nicht ausgeführt werden soll.

--resource-group -g

Name der Ressourcengruppe, die das sekundäre Replikat enthält, das zum neuen primären Replikat wird.

--server -s

Name des Servers, der das sekundäre Replikat enthält, das zum neuen primären Replikat wird. Sie können die Standardeinstellung mithilfe von az configure --defaults sql-server=<name>.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.