az sql db replica

  • Riferimento

Gestire la replica tra database.

Comandi

Nome Descrizione Tipo Stato
az sql db replica create

Creare un database come replica secondaria leggibile di un database esistente.

 Core Disponibilità generale
az sql db replica delete-link

Arrestare in modo permanente la replica dei dati tra due repliche di database.

 Core Disponibilità generale
az sql db replica list-links

Elencare le repliche di un database e il relativo stato di replica.

 Core Disponibilità generale
az sql db replica set-primary

Impostare il database di replica primaria eseguendo il failover dal database di replica primaria corrente.

 Core Disponibilità generale

az sql db replica create

Modifica

Creare un database come replica secondaria leggibile di un database esistente.

È possibile visualizzare un elenco completo delle opzioni del livello di prestazioni eseguendo az sql db list-editions -a -o table -l LOCATION. Il database secondario deve avere la stessa edizione del database primario.

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

Esempio

Creare un database con livello di prestazioni S0 come replica secondaria di un database Standard esistente.

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

Creare un database con GeneralPurpose Edition, hardware Gen4 e 1 vcore come replica secondaria di un database GeneralPurpose esistente

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

Creare un database con archiviazione di backup con ridondanza della zona come replica secondaria di un database esistente.

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

Parametri necessari

--name -n

Nome del database SQL di Azure.

--partner-server

Nome del server in cui creare la nuova replica.

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

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

Nome della nuova replica. Se non specificato, il valore predefinito è il nome del database di origine.

--partner-resource-group

Nome del gruppo di risorse in cui creare la nuova replica. Se non specificato, il valore predefinito è il gruppo di risorse di origine.

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

Tipo di database secondario da creare. I valori consentiti includono: Geo, Named.

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

Modifica

Arrestare in modo permanente la replica dei dati tra due repliche di database.

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

Nome del server in cui si trova l'altra replica.

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

--name -n

Nome del database SQL di Azure.

--partner-resource-group

Nome del gruppo di risorse in cui si trova l'altra replica. Se non specificato, il valore predefinito è il gruppo di risorse del primo 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. È 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.

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

Modifica

Elencare le repliche di un database e il relativo stato di replica.

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

Elencare le repliche di un database e il relativo stato di replica. (generato automaticamente)

az sql db replica list-links --name MyAzureSQLDatabase --resource-group MyResourceGroup --server myserver
--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".

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

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 replica set-primary

Modifica

Impostare il database di replica primaria eseguendo il failover dal database di replica primaria corrente.

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

Esempio

Impostare il database di replica primaria eseguendo il failover dal database di replica primaria corrente. (generato automaticamente)

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

Parametri facoltativi

--allow-data-loss

Se specificato, l'operazione di failover consentirà la perdita di dati.

valore predefinito: False
--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".

--name -n

Nome del database di cui eseguire il failover.

--resource-group -g

Nome del gruppo di risorse contenente la replica secondaria che diventerà il nuovo database primario.

--server -s

Nome del server contenente la replica secondaria che diventerà la nuova replica primaria. È 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.

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.