Condividi tramite

az sql db ltr-backup

  • Anteprima
  • Riferimento

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire i backup di conservazione a lungo termine del database SQL.

Comandi

Nome Descrizione Tipo Status
az sql db ltr-backup delete

Eliminare un backup di conservazione a lungo termine.

 Core Anteprima
az sql db ltr-backup list

Elencare i backup di conservazione a lungo termine per un percorso, un server o un database.

 Core Anteprima
az sql db ltr-backup restore

Ripristinare un backup di conservazione a lungo termine in un nuovo database.

 Core Anteprima
az sql db ltr-backup show

Ottenere un backup di conservazione a lungo termine per un database.

 Core Anteprima
az sql db ltr-backup wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione del database.

 Core Anteprima

az sql db ltr-backup delete

Modifica
Anteprima

Il gruppo di comandi 'sql db ltr-backup' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare un backup di conservazione a lungo termine.

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

Esempio

Eliminare il backup della conservazione a lungo termine per il database.

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

Parametri necessari

--database -d

Nome del database SQL di Azure. Se specificato (insieme al nome del server), recupera tutti i backup richiesti nel database.

--location -l

Percorso dei backup desiderati.

--name -n

Nome del backup con conservazione a lungo termine. Usare 'az sql db ltr-backup show' o 'az sql db ltr-backup list' per il nome del backup.

--server -s

Nome di Azure SQL Server. Se specificato, recupera tutti i backup richiesti nel server.

Parametri facoltativi

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az sql db ltr-backup list

Modifica
Anteprima

Il gruppo di comandi 'sql db ltr-backup' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare i backup di conservazione a lungo termine per un percorso, un server o un database.

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

Esempio

Elencare i backup di conservazione a lungo termine per un database.

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

Elencare i backup di conservazione a lungo termine per un server (elencare solo i backup di conservazione a lungo termine più recenti, che appartengono ai database in tempo reale).

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

Elencare i backup di conservazione a lungo termine per un server (con l'argomento gruppo di risorse).

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

Elencare i backup di conservazione a lungo termine per un percorso (elencare solo i backup di conservazione a lungo termine più recenti, che appartengono a database in tempo reale).

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

Elencare i backup di conservazione a lungo termine per un percorso (con l'argomento gruppo di risorse).

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

Parametri necessari

--location -l

Percorso dei backup desiderati.

Parametri facoltativi

--database -d

Nome del database SQL di Azure. Se specificato (insieme al nome del server), recupera tutti i backup richiesti nel database.

--database-state --state

'All', 'Live' o 'Deleted'. Recupererà i backup solo dai database con stato specificato. Se non viene fornito alcuno stato, il valore predefinito è 'All'.

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

Se true, restituirà solo il backup più recente per ogni database.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--server -s

Nome di Azure SQL Server. Se specificato, recupera tutti i backup richiesti nel server.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az sql db ltr-backup restore

Modifica
Anteprima

Il gruppo di comandi 'sql db ltr-backup' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ripristinare un backup di conservazione a lungo termine in un nuovo database.

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

Esempio

Ripristinare il backup con conservazione a lungo termine.

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"

Parametri necessari

--backup-id

ID risorsa del backup di conservazione a lungo termine da ripristinare. Usare 'az sql db ltr-backup show' o 'az sql db ltr-backup list' per l'ID di backup.

--dest-database

Nome del database che verrà creato come destinazione di ripristino.

--dest-resource-group

Nome del gruppo di risorse del server in cui ripristinare il database.

--dest-server

Nome del server in cui ripristinare il database.

Parametri facoltativi

--assign-identity -i

Assegnare l'identità per il database.

Valori accettati: false, true
--auto-pause-delay

Tempo in minuti dopo il quale il database viene sospeso automaticamente. Il valore -1 indica che la sospensione automatica è disabilitata.

--availability-zone

Zona di disponibilità.

--backup-storage-redundancy --bsr

Ridondanza dell'archiviazione di backup usata per archiviare i backup. I valori consentiti includono: Local, Zone, Geo, GeoZone.

--capacity -c

Componente della capacità dello SKU in numero intero di DTU o vcore.

--compute-model

Modello di calcolo del database.

Valori accettati: Provisioned, Serverless
--edition --tier -e

Componente dell'edizione dello SKU. I valori consentiti includono: Basic, Standard, Premium, GeneralPurpose, BusinessCritical, Hyperscale.

--elastic-pool

Nome o ID risorsa del pool elastico in cui creare il database.

--encryption-protector

Specifica la chiave dell'insieme di credenziali delle chiavi di Azure da usare come chiave di protezione della crittografia del database.

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

Specifica il flag di rotazione automatica della chiave di protezione della crittografia del database. Può essere true, false o null.

Valori accettati: false, true
--family -f

Componente di generazione di calcolo dello SKU (solo per sku vcore). I valori consentiti includono: Gen4, Gen5.

--federated-client-id

ID client federato per il database SQL. Viene usato per lo scenario cmk tra tenant.

--ha-replicas --read-replicas

Numero di repliche a disponibilità elevata di cui effettuare il provisioning per il database. Solo impostabile per l'edizione Hyperscale.

--keys

Elenco di chiavi AKV per il database SQL.

--license-type

Tipo di licenza da applicare per questo database.LicenseIncluded se è necessaria una licenza o BasePricese si ha una licenza e si è idonei per Azure HybridBenefit.

Valori accettati: BasePrice, LicenseIncluded
--min-capacity

Capacità minima allocata dal database, se non sospesa.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--preferred-enclave-type

Specifica il tipo di enclave per questa risorsa.

Valori accettati: Default, VBS
--read-scale

Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nel stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura. Questa proprietà è impostata solo per i database Premium e Business Critical.

Valori accettati: Disabled, Enabled
--service-level-objective --service-objective

Obiettivo di servizio per il nuovo database. Ad esempio: Basic, S0, P1, GP_Gen4_1, GP_S_Gen5_8, BC_Gen5_2, HS_Gen5_32.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

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

Elenco di identità assegnate dall'utente per il database SQL.

--zone-redundant -z

Specifica se abilitare la ridondanza della zona. Il valore predefinito è true se non viene specificato alcun valore.

Valori accettati: false, true
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az sql db ltr-backup show

Modifica
Anteprima

Il gruppo di comandi 'sql db ltr-backup' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere un backup di conservazione a lungo termine per un database.

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

Esempio

Visualizzare il backup della conservazione a lungo termine per un database.

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

Parametri necessari

--database -d

Nome del database SQL di Azure. Se specificato (insieme al nome del server), recupera tutti i backup richiesti nel database.

--location -l

Percorso dei backup desiderati.

--name -n

Nome del backup con conservazione a lungo termine. Usare 'az sql db ltr-backup show' o 'az sql db ltr-backup list' per il nome del backup.

--server -s

Nome di Azure SQL Server. Se specificato, recupera tutti i backup richiesti nel server.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az sql db ltr-backup wait

Modifica
Anteprima

Il gruppo di comandi 'sql db ltr-backup' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione del database.

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

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--exists

Attendere che la risorsa esista.

Valore predefinito: False
--expand

Risorse figlio da includere nella risposta. Il valore predefinito è Nessuno.

--filter

Espressione di filtro OData che filtra gli elementi nella raccolta. Il valore predefinito è Nessuno.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--name -n

Nome del database SQL di Azure.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--server -s

Nome di Azure SQL Server. È possibile configurare l'impostazione predefinita usando az configure --defaults sql-server=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.