Condividi tramite

az sql instance-failover-group-arc

Note

Questo riferimento fa parte dell'estensione arcdata per l'interfaccia della riga di comando di Azure (versione 2.3.1 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az sql instance-failover-group-arc. Altre informazioni sulle estensioni.

Gestire i gruppi di failover dell'istanza gestita di SQL abilitata per Arc.

Comandi

Nome Descrizione Tipo Status
az sql instance-failover-group-arc create

Creare una risorsa del gruppo di failover.

 Extension GA
az sql instance-failover-group-arc delete

Eliminare un gruppo di failover abilitato per Arc Istanza gestita di SQL.

 Extension GA
az sql instance-failover-group-arc list

Elencare tutti i gruppi di failover.

 Extension GA
az sql instance-failover-group-arc show

Visualizzare i dettagli di una risorsa del gruppo di failover.

 Extension GA
az sql instance-failover-group-arc update

Aggiornare una risorsa del gruppo di failover.

 Extension GA

az sql instance-failover-group-arc create

Creare una risorsa del gruppo di failover.

Creare una risorsa del gruppo di failover con abilitazione di Arc Istanza gestita di SQL per configurare un gruppo di disponibilità distribuito.

az sql instance-failover-group-arc create --mi
                                          --name
                                          --partner-mi
                                          [--k8s-namespace]
                                          [--no-wait]
                                          [--partner-mirroring-cert-file]
                                          [--partner-mirroring-url]
                                          [--partner-resource-group]
                                          [--partner-sync-mode {async, sync}]
                                          [--primary-mirroring-url]
                                          [--resource-group]
                                          [--role {primary, secondary}]
                                          [--shared-name]
                                          [--use-k8s]

Esempio

Usare l'API Kubernetes per creare una risorsa del gruppo di failover tra l'istanza gestita di SQL primaria sqlmi1 e l'istanza gestita di SQL partner sqlmi2. Sono necessari l'endpoint del mirroring del partner e il file di certificato.

az sql instance-failover-group-arc create --name fogcr --shared-name sharedname1 --mi sqlmi1 --role primary --partner-mi sqlmi2 --partner-mirroring-url 10.20.5.20:970 --partner-mirroring-cert-file ./sqlmi2.cer --use-k8s

Usare Azure Resource Manager (ARM) per creare una risorsa del gruppo di failover.

az sql instance-failover-group-arc create --name fogcr  --mi sqlmi1 --resource-group primary-rg-name  --partner-mi sqlmi2 --partner-resource-group partner-rg-name --partner-sync-mode async

Usare ARM per creare un gruppo di failover con URL di mirroring personalizzati.

az sql instance-failover-group-arc create --name fogcr  --mi sqlmi1 --resource-group primary-rg-name  --partner-mi sqlmi2 --partner-resource-group partner-rg-name --partner-sync-mode async --primary-mirroring-url 21.10.6.30:6603 --partner-mirroring-url 10.20.5.20:970

Parametri necessari

--mi

Nome dell'istanza gestita di SQL primaria.

--name -n

Nome della risorsa del gruppo di failover.

--partner-mi

Nome dell'istanza gestita di SQL partner o dell'istanza remota di SQL. Quando si usano argomenti di destinazione arm, si riferisce al nome dell'istanza di Ripristino di emergenza.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--k8s-namespace -k

Spazio dei nomi in cui deve essere distribuito il gruppo di failover. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--partner-mirroring-cert-file -f

Nome file del certificato pubblico dell'endpoint di mirroring per l'istanza gestita di SQL partner o il gruppo di disponibilità nell'istanza remota di SQL. È supportato solo il formato PEM.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--partner-mirroring-url -u

URL dell'endpoint di mirroring dell'istanza gestita di SQL partner.

--partner-resource-group

Gruppo di risorse di Azure dell'istanza gestita di SQL abilitata per il ripristino di emergenza di Arc.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--partner-sync-mode -m

Modalità di sincronizzazione partner dell'istanza gestita di SQL abilitata per Arc.

Proprietà Valore
Valori accettati: async, sync
--primary-mirroring-url

URL dell'endpoint di mirroring dell'istanza gestita di SQL primaria.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--resource-group -g

Gruppo di risorse di Azure dell'istanza gestita di SQL abilitata per Arc primaria.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--role

Ruolo richiesto del gruppo di failover. Il ruolo può essere modificato.

Proprietà Valore
Valori accettati: primary, secondary
--shared-name

Nome condiviso del gruppo di failover per questa istanza gestita di SQL. Sia l'istanza gestita di SQL primaria che il partner devono usare lo stesso nome condiviso.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--use-k8s

Creare il gruppo di failover dell'istanza gestita di SQL abilitata per Arc usando le API Kubernetes locali.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az sql instance-failover-group-arc delete

Eliminare un gruppo di failover abilitato per Arc Istanza gestita di SQL.

az sql instance-failover-group-arc delete --name
                                          [--k8s-namespace]
                                          [--mi]
                                          [--resource-group]
                                          [--use-k8s]

Esempio

Eliminare una risorsa del gruppo di failover usando l'API Kubernetes.

az sql instance-failover-group-arc delete --name fogcr --use-k8s

Eliminare una risorsa del gruppo di failover usando Azure Resource Manager.

az sql instance-failover-group-arc delete --name fogcr --mi sqlmi1 -g rg-name

Parametri necessari

--name -n

Nome della risorsa del gruppo di failover da eliminare.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--k8s-namespace -k

Spazio dei nomi in cui viene distribuito il gruppo di failover. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--mi

Nome dell'istanza gestita di SQL abilitata per Arc primaria.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--resource-group -g

Gruppo di risorse di Azure dell'istanza gestita di SQL abilitata per Arc primaria.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az sql instance-failover-group-arc list

Elencare tutti i gruppi di failover.

az sql instance-failover-group-arc list [--k8s-namespace]
                                        [--mi]
                                        [--resource-group]
                                        [--use-k8s]

Esempio

Elencare tutti i gruppi di failover in uno spazio dei nomi usando l'API Kubernetes.

az sql instance-failover-group-arc list --k8s-namespace arcdata --use-k8s

Elencare tutti i gruppi di failover eseguendo query su Azure Resource Manager (ARM).

az sql instance-failover-group-arc list --mi sqlmi1 -g rg-name

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--k8s-namespace -k

Spazio dei nomi in cui vengono distribuiti i gruppi di failover. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--mi

Nome dell'istanza gestita di SQL abilitata per Arc.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--resource-group -g

Gruppo di risorse di Azure dell'istanza gestita di SQL abilitata per Arc.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az sql instance-failover-group-arc show

Visualizzare i dettagli di una risorsa del gruppo di failover.

az sql instance-failover-group-arc show --name
                                        [--k8s-namespace]
                                        [--mi]
                                        [--resource-group]
                                        [--use-k8s]

Esempio

Visualizzare i dettagli di un gruppo di failover usando l'API Kubernetes.

az sql instance-failover-group-arc show --name fogcr --use-k8s

Visualizzare i dettagli di un gruppo di failover eseguendo query su Azure Resource Manager (ARM).

az sql instance-failover-group-arc show --name fogcr1 --mi sqlmi1 -g rg-name

Parametri necessari

--name -n

Nome della risorsa del gruppo di failover.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--k8s-namespace -k

Spazio dei nomi in cui viene distribuito il gruppo di failover. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--mi

Nome dell'istanza gestita di SQL abilitata per Arc primaria.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--resource-group -g

Gruppo di risorse di Azure dell'istanza gestita di SQL abilitata per Arc primaria.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az sql instance-failover-group-arc update

Aggiornare una risorsa del gruppo di failover.

Aggiornare una risorsa del gruppo di failover con abilitazione di Arc Istanza gestita di SQL per modificare il ruolo del gruppo di disponibilità distribuito.

az sql instance-failover-group-arc update --name
                                          [--k8s-namespace]
                                          [--mi]
                                          [--no-wait]
                                          [--partner-sync-mode {async, sync}]
                                          [--resource-group]
                                          [--role {force-primary-allow-data-loss, force-secondary, secondary}]
                                          [--use-k8s]

Esempio

Aggiornare una risorsa del gruppo di failover al ruolo secondario dal ruolo primario usando l'API Kubernetes.

az sql instance-failover-group-arc update --name fogcr --role secondary --use-k8s

Aggiornare una risorsa del gruppo di failover usando Azure Resource Manager.

az sql instance-failover-group-arc update --name fogcr  --role secondary --mi sqlmi1 --resource-group rg-name

Parametri necessari

--name -n

Nome della risorsa del gruppo di failover.

Parametri facoltativi

I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.

--k8s-namespace -k

Spazio dei nomi in cui esiste il gruppo di failover. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--mi

Nome dell'istanza gestita di SQL abilitata per Arc da aggiornare.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--partner-sync-mode -m

Modalità di sincronizzazione partner dell'istanza gestita di SQL.

Proprietà Valore
Valori accettati: async, sync
--resource-group -g

Gruppo di risorse di Azure dell'istanza gestita di SQL abilitata per Arc primaria.

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--role

Ruolo richiesto del gruppo di failover.

Proprietà Valore
Valori accettati: force-primary-allow-data-loss, force-secondary, secondary
--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False