Freigeben über

az sql db ltr-backup

  • Referenz

Verwalten sie langfristige Sicherungen der SQL-Datenbank.

Befehle

Name Beschreibung Typ Status
az sql db ltr-backup delete

Löschen einer langfristigen Aufbewahrungssicherung.

 Kern GA
az sql db ltr-backup list

Listen Sie die langfristigen Aufbewahrungssicherungen für einen Speicherort, einen Server oder eine Datenbank auf.

 Kern GA
az sql db ltr-backup restore

Wiederherstellen einer langfristigen Aufbewahrungssicherung in einer neuen Datenbank.

 Kern GA
az sql db ltr-backup show

Abrufen einer langfristigen Aufbewahrungssicherung für eine Datenbank.

 Kern GA
az sql db ltr-backup wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Datenbank erfüllt ist.

 Kern GA

az sql db ltr-backup delete

Bearbeiten

Löschen einer langfristigen Aufbewahrungssicherung.

az sql db ltr-backup delete --database
                            --location
                            --name
                            --server
                            [--yes]

Beispiele

Löschen einer langfristigen Aufbewahrungssicherung für die Datenbank.

az sql db ltr-backup delete -l southeastasia -s myserver -d mydb -n "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"

Erforderliche Parameter

--database -d

Name der Azure SQL-Datenbank. Wenn angegeben (zusammen mit servername) werden alle angeforderten Sicherungen unter dieser Datenbank abgerufen.

--location -l

Der Speicherort der gewünschten Sicherungen.

--name -n

Der Name der LTR-Sicherung. Verwenden Sie "az sql db ltr-backup show" oder "az sql db ltr-backup list" für den Sicherungsnamen.

--server -s

Name des Azure SQL Server. Wenn angegeben, werden alle angeforderten Sicherungen unter diesem Server abgerufen.

Optionale Parameter

--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 Hilfenachricht anzeigen und beenden.

--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 ltr-backup list

Bearbeiten

Listen Sie die langfristigen Aufbewahrungssicherungen für einen Speicherort, einen Server oder eine Datenbank auf.

az sql db ltr-backup list --location
                          [--database]
                          [--database-state]
                          [--latest]
                          [--resource-group]
                          [--server]

Beispiele

Auflisten langfristiger Aufbewahrungssicherungen für eine Datenbank.

az sql db ltr-backup list -l southeastasia -s myserver -d mydb

Auflisten langfristiger Aufbewahrungssicherungen für einen Server (listet nur die neuesten LTR-Sicherungen auf, die zu Livedatenbanken gehören).

az sql db ltr-backup list -l southeastasia -s myserver --database-state Live --only-latest-per-database True

Auflisten langfristiger Aufbewahrungssicherungen für einen Server (mit Ressourcengruppenargument).

az sql db ltr-backup list -l southeastasia -g mygroup -s myserver

Auflisten langfristiger Aufbewahrungssicherungen für einen Speicherort (listet nur die neuesten LTR-Sicherungen auf, die zu Livedatenbanken gehören).

az sql db ltr-backup list -l southeastasia --database-state Live --only-latest-per-database True

Auflisten langfristiger Aufbewahrungssicherungen für einen Speicherort (mit Ressourcengruppenargument).

az sql db ltr-backup list -l southeastasia -g mygroup

Erforderliche Parameter

--location -l

Der Speicherort der gewünschten Sicherungen.

Optionale Parameter

--database -d

Name der Azure SQL-Datenbank. Wenn angegeben (zusammen mit servername) werden alle angeforderten Sicherungen unter dieser Datenbank abgerufen.

--database-state --state

"Alle", "Live" oder "Gelöscht". Ruft Sicherungen nur aus Datenbanken des angegebenen Zustands ab. Wenn kein Zustand vorhanden ist, wird standardmäßig "Alle" verwendet.

--latest --only-latest-per-database

Wenn true, wird nur die neueste Sicherung für jede Datenbank zurückgegeben.

--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. Wenn angegeben, werden alle angeforderten Sicherungen unter diesem Server abgerufen.

Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--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 ltr-backup restore

Bearbeiten

Wiederherstellen einer langfristigen Aufbewahrungssicherung in einer neuen Datenbank.

az sql db ltr-backup restore --backup-id
                             --dest-database
                             --dest-resource-group
                             --dest-server
                             [--assign-identity {false, true}]
                             [--auto-pause-delay]
                             [--availability-zone]
                             [--backup-storage-redundancy]
                             [--capacity]
                             [--compute-model {Provisioned, Serverless}]
                             [--edition]
                             [--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]
                             [--preferred-enclave-type {Default, VBS}]
                             [--read-scale {Disabled, Enabled}]
                             [--service-level-objective]
                             [--tags]
                             [--umi]
                             [--zone-redundant {false, true}]

Beispiele

Wiederherstellen der LTR-Sicherung.

az sql db ltr-backup restore \
--dest-database targetdb --dest-server myserver --dest-resource-group mygroup \
--backup-id "/subscriptions/6caa113c-794c-42f8-ab9d-878d8aa104dc/resourceGroups/mygroup/providers/Microsoft.Sql/locations/southeastasia/longTermRetentionServers/myserver/longTermRetentionDatabases/sourcedb/longTermRetentionBackups/3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000"

Erforderliche Parameter

--backup-id

Die Ressourcen-ID der langfristigen Aufbewahrungssicherung, die wiederhergestellt werden soll. Verwenden Sie "az sql db ltr-backup show" oder "az sql db ltr-backup list" für die Sicherungs-ID.

--dest-database

Name der Datenbank, die als Wiederherstellungsziel erstellt wird.

--dest-resource-group

Name der Ressourcengruppe des Servers, in der die Datenbank wiederhergestellt werden soll.

--dest-server

Name des Servers, auf dem die Datenbank wiederhergestellt werden soll.

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
--edition --tier -e

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

--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
--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
--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 Hilfenachricht anzeigen und beenden.

--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 ltr-backup show

Bearbeiten

Abrufen einer langfristigen Aufbewahrungssicherung für eine Datenbank.

az sql db ltr-backup show --database
                          --location
                          --name
                          --server

Beispiele

Zeigen Sie eine langfristige Aufbewahrungssicherung für eine Datenbank an.

az sql db ltr-backup show -l southeastasia -s myserver -d mydb -n "3214b3fb-fba9-43e7-96a3-09e35ffcb336;132292152080000000;Hot"

Erforderliche Parameter

--database -d

Name der Azure SQL-Datenbank. Wenn angegeben (zusammen mit servername) werden alle angeforderten Sicherungen unter dieser Datenbank abgerufen.

--location -l

Der Speicherort der gewünschten Sicherungen.

--name -n

Der Name der LTR-Sicherung. Verwenden Sie "az sql db ltr-backup show" oder "az sql db ltr-backup list" für den Sicherungsnamen.

--server -s

Name des Azure SQL Server. Wenn angegeben, werden alle angeforderten Sicherungen unter diesem Server abgerufen.

Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

--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 ltr-backup wait

Bearbeiten

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Datenbank erfüllt ist.

az sql db ltr-backup wait [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--expand]
                          [--filter]
                          [--ids]
                          [--interval]
                          [--name]
                          [--resource-group]
                          [--server]
                          [--subscription]
                          [--timeout]
                          [--updated]

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--expand

Die untergeordneten Ressourcen, die in die Antwort eingeschlossen werden sollen. Der Standardwert ist None.

--filter

Ein OData-Filterausdruck, der Elemente in der Auflistung filtert. Der Standardwert ist None.

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

--interval

Abrufintervall in Sekunden.

Standardwert: 30
--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>konfigurieren.

--subscription

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

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

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

--help -h

Diese Hilfenachricht anzeigen und beenden.

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