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 Allgemein verfügbar
az sql db replica delete-link

Beenden Sie die Datenreplikation zwischen zwei Datenbankreplikaten dauerhaft.

Core Allgemein verfügbar
az sql db replica list-links

Auflisten der Replikate einer Datenbank und ihres Replikationsstatus.

Core Allgemein verfügbar
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 Allgemein verfügbar

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]
                         [--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 des 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 Partnerclient-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ü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

Nicht auf den Abschluss lang andauernder Vorgänge warten

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 ihrem Verbindungszeichenfolge festgelegt ist, möglicherweise an ein readonly sekundäres Replikat weitergeleitet. Diese Eigenschaft ist nur für Premium- und Unternehmenskritisch-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

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.

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

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

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

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

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
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.

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

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

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

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

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

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.