Freigeben über


az sql db replica

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.

Core GA
az sql db replica delete-link

Beenden Sie die Datenreplikation zwischen zwei Datenbankreplikaten dauerhaft.

Core GA
az sql db replica list-links

Auflisten der Replikate einer Datenbank und ihres Replikationsstatus.

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

Core GA

az sql db replica create

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 --bsr]
                         [--capacity]
                         [--compute-model {Provisioned, Serverless}]
                         [--elastic-pool]
                         [--encryption-protector]
                         [--encryption-protector-auto-rotation --epauto {false, true}]
                         [--family]
                         [--federated-client-id]
                         [--ha-replicas --read-replicas]
                         [--keys]
                         [--license-type {BasePrice, LicenseIncluded}]
                         [--min-capacity]
                         [--no-wait]
                         [--partner-database]
                         [--partner-resource-group]
                         [--partner-sub-id]
                         [--preferred-enclave-type {Default, VBS}]
                         [--read-scale {Disabled, Enabled}]
                         [--secondary-type]
                         [--service-level-objective --service-objective]
                         [--tags]
                         [--umi --user-assigned-identity-id]
                         [--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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--assign-identity -i

Zuweisen der Identität für die Datenbank.

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

Eigenschaft Wert
Parametergruppe: Serverless offering Arguments
--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.

Eigenschaft Wert
Parametergruppe: Performance Level (components) Arguments
--compute-model

Das Berechnungsmodell der Datenbank.

Eigenschaft Wert
Parametergruppe: Serverless offering Arguments
Zulässige Werte: Provisioned, Serverless
--elastic-pool

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

Eigenschaft Wert
Parametergruppe: Performance Level Arguments
--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.

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

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

Eigenschaft Wert
Parametergruppe: Performance Level (components) Arguments
--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.

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

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

Eigenschaft Wert
Parametergruppe: Serverless offering Arguments
--no-wait

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

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

--partner-sub-id

Abonnement-ID zum Erstellen des neuen Replikats in. Wenn nicht angegeben, wird standardmäßig die Ursprungsabonnement-ID verwendet.

--preferred-enclave-type

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

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

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

Eigenschaft Wert
Parametergruppe: Performance Level Arguments
--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.

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

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

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.

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Name der Azure SQL-Datenbank.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--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.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--server -s

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--yes -y

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--verbose

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

Eigenschaft Wert
Standardwert: False

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. (autogenerated)

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Name der Azure SQL-Datenbank.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--server -s

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--verbose

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

Eigenschaft Wert
Standardwert: False

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.

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. (autogenerated)

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--allow-data-loss

Wenn angegeben, ermöglicht der Failovervorgang Datenverlust.

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Der Name der Datenbank, die nicht ausgeführt werden soll.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--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>.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--verbose

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

Eigenschaft Wert
Standardwert: False