az sql mi-arc

Riferimento

Nota

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 mi-arc . Altre informazioni sulle estensioni.

Gestire le istanze gestite di SQL abilitate per Azure Arc.

Comandi

Nome	Descrizione	Tipo	Stato
az sql mi-arc config	Comandi di configurazione.	Estensione	Disponibilità generale
az sql mi-arc config add	Aggiunge un valore per un percorso JSON in un file di configurazione.	Estensione	Disponibilità generale
az sql mi-arc config init	Inizializzare i file CRD e di specifica per un'istanza gestita di SQL.	Estensione	Disponibilità generale
az sql mi-arc config patch	Applicare patch a un file di configurazione basato su un file di patch JSON.	Estensione	Disponibilità generale
az sql mi-arc config remove	Rimuove un valore per un percorso JSON in un file di configurazione.	Estensione	Disponibilità generale
az sql mi-arc config replace	Sostituisce un valore per un percorso JSON in un file di configurazione.	Estensione	Disponibilità generale
az sql mi-arc create	Crea un'istanza gestita di SQL.	Estensione	Disponibilità generale
az sql mi-arc delete	Elimina un'istanza gestita di SQL.	Estensione	Disponibilità generale
az sql mi-arc edit	Deprecato, usare l'aggiornamento tramite modifica.	Estensione	Deprecato
az sql mi-arc endpoint	Visualizzare e gestire gli endpoint SQL.	Estensione	Disponibilità generale
az sql mi-arc endpoint list	Elencare gli endpoint SQL.	Estensione	Disponibilità generale
az sql mi-arc get-mirroring-cert	Recuperare il certificato dell'endpoint del mirroring del gruppo di disponibilità da sql mi e archiviare in un file.	Estensione	Disponibilità generale
az sql mi-arc list	Elenca le istanze gestite di SQL.	Estensione	Disponibilità generale
az sql mi-arc reprovision-replica	Eseguire nuovamente il provisioning di una replica in un'istanza gestita di SQL.	Estensione	Disponibilità generale
az sql mi-arc show	Visualizza i dettagli di un'istanza gestita di SQL.	Estensione	Disponibilità generale
az sql mi-arc update	Aggiornare la configurazione di un'istanza gestita di SQL.	Estensione	Disponibilità generale
az sql mi-arc upgrade	Aggiornare l'istanza gestita di SQL.	Estensione	Disponibilità generale

az sql mi-arc create

Crea un'istanza gestita di SQL.

Per impostare la password dell'istanza gestita di SQL, impostare la variabile di ambiente AZDATA_PASSWORD.

az sql mi-arc create --name
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--collation]
                     [--cores-limit]
                     [--cores-request]
                     [--custom-location]
                     [--dev]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--language]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-external-endpoint]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--primary-dns-name]
                     [--primary-port-number]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--secondary-dns-name]
                     [--secondary-port-number]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--service-type {LoadBalancer, NodePort}]
                     [--storage-annotations]
                     [--storage-class-backups]
                     [--storage-class-data]
                     [--storage-class-datalogs]
                     [--storage-class-logs]
                     [--storage-class-orchestrator-logs]
                     [--storage-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]
                     [--volume-size-backups]
                     [--volume-size-data]
                     [--volume-size-datalogs]
                     [--volume-size-logs]
                     [--volume-size-orchestrator-logs]

Esempio

Creare un'istanza gestita di SQL tramite l'API Kubernetes.

az sql mi-arc create -n sqlmi1 --k8s-namespace arc --use-k8s

Creare un'istanza gestita di SQL con 3 repliche nello scenario a disponibilità elevata tramite l'API Kubernetes.

az sql mi-arc create -n sqlmi2 --replicas 3 --k8s-namespace arc --use-k8s

Creare un'istanza gestita di SQL tramite Azure Resource Manager (ARM).

az sql mi-arc create --name sqlmi3 --resource-group rg-name --custom-location arc-cl

Creare un'istanza gestita di SQL con l'autenticazione di Active Directory tramite l'API Kubernetes.

az sql mi-arc create --name contososqlmi --k8s-namespace arc --ad-connector-name arcadc --ad-account-name arcuser --keytab-secret arcuser-keytab-secret --primary-dns-name contososqlmi-primary.contoso.local --primary-port-number 8143 --use-k8s

Parametri necessari

--name -n

Nome dell'istanza gestita di SQL.

Parametri facoltativi

--ad-account-name

Nome dell'account Active Directory per questa Istanza gestita di SQL abilitata per Arc. Questo account deve essere creato prima della distribuzione di questa istanza.

--ad-connector-name

Nome del Connessione or di Active Directory. Questo parametro indica una finalità da distribuire con il supporto di ACTIVE Directory.

--ad-encryption-types

Elenco delimitato da virgole dei tipi di crittografia di Active Directory supportati. Deve essere un subset dei valori seguenti: RC4, AES128, AES256.

--admin-login-secret

Nome del segreto Kubernetes per generare tale host o ospiterà le credenziali dell'account di accesso dell'amministratore utente.

--agent-enabled

Abilitare SQL Server Agent per l'istanza di . L'impostazione predefinita corrisponde alla disabilitazione. I valori consentiti sono 'true' o 'false'.

--annotations

Elenco delimitato da virgole di annotazioni dell'istanza gestita di SQL.

--cert-private-key-file

Percorso del file contenente una chiave privata del certificato con formattazione PEM da usare per SQL Server.

--cert-public-key-file

Percorso del file contenente una chiave pubblica del certificato con formattazione PEM da usare per SQL Server.

--collation

Regole di confronto di SQL Server per l'istanza di .

--cores-limit -c

Limite di core dell'istanza gestita come numero intero.

--cores-request

Richiesta di core dell'istanza gestita come numero intero.

--custom-location

Percorso personalizzato per questa istanza.

--dev

Se specificato, viene considerata un'istanza di sviluppo e non verrà fatturata.

--k8s-namespace -k

Spazio dei nomi in cui deve essere distribuita l'istanza gestita di SQL. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--keytab-secret

Nome del segreto Kubernetes che contiene il file keytab per questo Istanza gestita di SQL abilitato per Arc.

--labels

Elenco delimitato da virgole di etichette dell'istanza gestita di SQL.

--language

Impostazioni locali di SQL Server per qualsiasi identificatore di lingua supportato (LCID) per l'istanza.

--license-type -l

Il tipo di licenza da applicare per questa istanza gestita I valori consentiti sono: BasePrice, LicenseIncluded, DisasterRecovery.Default è LicenseIncluded. Il tipo di licenza può essere modificato.

--memory-limit -m

Limite della capacità dell'istanza gestita come numero intero seguito da Gi (gigabyte). Esempio: 4Gi.

--memory-request

Richiesta per la capacità dell'istanza gestita come numero intero seguito da Gi (gigabyte). Esempio: 4Gi.

--no-external-endpoint

Se specificato, non verrà creato alcun servizio esterno. In caso contrario, verrà creato un servizio esterno usando lo stesso tipo di servizio del controller dati.

--no-wait

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

valore predefinito: False

--orchestrator-replicas

Numero di repliche dell'agente di orchestrazione a disponibilità elevata. Il valore deve essere compreso tra 1 e 3.

--path

Percorso del file azext_arcdata per il file JSON dell'istanza gestita di SQL.

--primary-dns-name

Nome DNS del servizio primario esposto agli utenti finali per la connessione a questa Istanza gestita di SQL abilitata per Arc(ad esempio sqlinstancename.contoso.com).

--primary-port-number

Numero di porta in cui il servizio primario viene esposto agli utenti finali ,ad esempio 31433.

--readable-secondaries

Numero di repliche da rendere leggibili. Si applica solo al livello Business Critical. Il valore deve essere compreso tra 0 e il numero di repliche meno 1.

--replicas

Questa opzione specifica il numero di repliche Istanza gestita di SQL che verranno distribuite nel cluster Kubernetes a scopo di disponibilità elevata. Il valore predefinito è 1 replica per utilizzo generico, 3 repliche per Business Critical.

valori accettati: 1, 2, 3

--resource-group -g

Gruppo di risorse di Azure a cui aggiungere il Istanza gestita di SQL abilitato per Arc.

--retention-days

Periodo di conservazione dei backup, specificato in giorni. I valori consentiti sono compresi tra 0 e 35. Il valore predefinito è 7. L'impostazione del periodo di conservazione su 0 disattiva i backup automatici per tutti i database nell'istanza gestita di SQL e tutti i backup precedenti verranno eliminati.

--secondary-dns-name

Nome DNS del servizio secondario esposto agli utenti finali per connettersi a questa Istanza gestita di SQL abilitata per Arc,ad esempio sqlinstancename2.contoso.com.

--secondary-port-number

Numero di porta in cui il servizio secondario viene esposto agli utenti finali ,ad esempio 31434.

--service-annotations

Elenco delimitato da virgole di annotazioni da applicare a tutti i servizi esterni.

--service-cert-secret

Nome del segreto Kubernetes per generare tale host o ospiterà il certificato del servizio SQL.

--service-labels

Elenco delimitato da virgole di etichette da applicare a tutti i servizi esterni.

--service-type

Tipo per il servizio primario.

valori accettati: LoadBalancer, NodePort

--storage-annotations

Elenco delimitato da virgole di annotazioni da applicare a tutti i PVC.

--storage-class-backups

Classe di archiviazione con supporto per ReadWriteMany (RWX) da usare per i backup (/var/opt/mssql/backups). Se non viene specificato alcun valore, verrà usata la classe di archiviazione predefinita.

--storage-class-data -d

Classe di archiviazione da usare per i file di dati (con estensione mdf, ndf). Se non viene indicato alcun valore, non verrà specificata nessuna classe di archiviazione. Kubernetes userà quindi la classe di archiviazione predefinita.

--storage-class-datalogs

Classe di archiviazione da usare per i log di database (con estensione ldf). Se non viene indicato alcun valore, non verrà specificata nessuna classe di archiviazione. Kubernetes userà quindi la classe di archiviazione predefinita.

--storage-class-logs

Classe di archiviazione da usare per i log (/var/log). Se non viene indicato alcun valore, non verrà specificata nessuna classe di archiviazione. Kubernetes userà quindi la classe di archiviazione predefinita.

--storage-class-orchestrator-logs

Classe di archiviazione da usare per i log dell'agente di orchestrazione (/var/log). Se non viene indicato alcun valore, non verrà specificata nessuna classe di archiviazione. Kubernetes userà quindi la classe di archiviazione predefinita.

--storage-labels

Elenco delimitato da virgole di etichette da applicare a tutti i pvC.

--sync-secondary-to-commit

Numero di repliche secondarie che devono essere sincronizzate per il commit. L'impostazione di questo valore su -1 imposta il numero di repliche secondarie sincronizzate necessarie su '(# di repliche - 1) / 2', arrotondato per difetto.

valori accettati: -1, 0, 1, 2

valore predefinito: -1

--tde-mode

Modalità TDE (Transparent Data Encryption) per questa Istanza gestita di SQL abilitata per Arc. Valori consentiti: ServiceManaged, CustomerManaged o Disabled. Il valore predefinito è Disabled.

--tde-protector-private-key-file

Percorso del file contenente una chiave privata del certificato con formattazione PEM da usare per TDE.

--tde-protector-public-key-file

Percorso del file contenente una chiave pubblica del certificato con formattazione PEM da usare per TDE.

--tde-protector-secret

Nome del segreto Kubernetes che contiene il certificato di protezione TDE e la chiave privata per questa Istanza gestita di SQL abilitata per Arc. Può essere specificato solo per la modalità TDE gestita da CustomerManaged.

--tier -t

Piano tariffario per l'istanza. Valori consentiti: BusinessCritical (bc for short) o GeneralPurpose (gp per breve). Il valore predefinito è GeneralPurpose.

--time-zone

Fuso orario di SQL Server per l'istanza.

--trace-flags

Elenco delimitato da virgole di flag di traccia. Nessun flag per impostazione predefinita.

--use-k8s

Creare un'istanza gestita di SQL usando le API Kubernetes locali.

--volume-size-backups

Dimensioni del volume di archiviazione da usare per i backup come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

--volume-size-data

Dimensioni del volume di archiviazione da usare per i dati come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

--volume-size-datalogs

Dimensioni del volume di archiviazione da usare per i log di dati come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

--volume-size-logs

Dimensioni del volume di archiviazione da usare per i log come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

--volume-size-orchestrator-logs

Dimensioni del volume di archiviazione da usare per i log dell'agente di orchestrazione come numero positivo seguito da Ki (kilobyte), Mi (megabyte) o Gi (gigabyte).

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 mi-arc delete

Elimina un'istanza gestita di SQL.

az sql mi-arc delete --name
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]

Esempio

Eliminare un'istanza gestita di SQL tramite l'API Kubernetes.

az sql mi-arc delete --name sqlmi1 --k8s-namespace arc --use-k8s

Eliminare un'istanza gestita di SQL tramite Azure Resource Manager (ARM).

az sql mi-arc delete --name sqlmi1 --resource-group rg-name

Parametri necessari

--name -n

Nome dell'istanza gestita di SQL da eliminare.

Parametri facoltativi

--k8s-namespace -k

Spazio dei nomi in cui deve essere distribuita l'istanza gestita di SQL. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--no-wait

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

valore predefinito: False

--resource-group -g

Gruppo di risorse di Azure in cui è presente il Istanza gestita di SQL abilitato per Arc.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

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 mi-arc edit

Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece 'update'.

Deprecato, usare l'aggiornamento tramite modifica.

az sql mi-arc edit --name
                   [--agent-enabled]
                   [--annotations]
                   [--cores-limit]
                   [--cores-request]
                   [--custom-location]
                   [--dev]
                   [--k8s-namespace]
                   [--labels]
                   [--license-type]
                   [--location]
                   [--memory-limit]
                   [--memory-request]
                   [--no-wait]
                   [--path]
                   [--resource-group]
                   [--retention-days]
                   [--service-annotations]
                   [--service-labels]
                   [--tag-name]
                   [--tag-value]
                   [--tier]
                   [--time-zone]
                   [--trace-flags]
                   [--use-k8s]

Parametri necessari

--name -n

Nome dell'istanza gestita di SQL sottoposta a modifica. Il nome con cui viene distribuita l'istanza non può essere modificato.

Parametri facoltativi

--agent-enabled

Abilitare SQL Server Agent per l'istanza di . L'impostazione predefinita corrisponde alla disabilitazione.

--annotations

Elenco delimitato da virgole di annotazioni dell'istanza gestita di SQL.

--cores-limit -c

Limite di core dell'istanza gestita come numero intero.

--cores-request

Richiesta di core dell'istanza gestita come numero intero.

--custom-location

Percorso personalizzato per questa istanza.

--dev

Se specificato, viene considerata un'istanza di sviluppo e non verrà fatturata.

--k8s-namespace -k

Spazio dei nomi in cui deve essere distribuita l'istanza gestita di SQL. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--labels

Elenco delimitato da virgole di etichette dell'istanza gestita di SQL.

--license-type

Il tipo di licenza da aggiornare per questa istanza gestita Valori consentiti sono: BasePrice, LicenseIncluded, DisasterRecovery. Il valore predefinito è LicenseIncluded.

--location

Posizione di Azure in cui verranno archiviati i metadati sqlmi ,ad esempio eastus.

--memory-limit -m

Limite della capacità dell'istanza gestita come numero intero seguito da Gi (gigabyte). Esempio: 4Gi.

--memory-request

Richiesta per la capacità dell'istanza gestita come numero intero seguito da Gi (gigabyte). Esempio: 4Gi.

--no-wait

Se specificato, il comando non attenderà che lo stato dell'istanza sia pronto prima della restituzione.

valore predefinito: False

--path

Percorso del file azext_arcdata per il file JSON dell'istanza gestita di SQL.

--resource-group -g

Gruppo di risorse di Azure in cui è presente il Istanza gestita di SQL abilitato per Arc.

--retention-days

--service-annotations

Elenco delimitato da virgole di annotazioni da applicare a tutti i servizi esterni.

--service-labels

Elenco delimitato da virgole di etichette da applicare a tutti i servizi esterni.

--tag-name

Nome del tag dell'istanza gestita di SQL.

--tag-value

Valore del tag dell'istanza gestita di SQL.

--tier -t

Piano tariffario per l'istanza. Valori consentiti: BusinessCritical (bc for short) o GeneralPurpose (gp per breve). Il valore predefinito è GeneralPurpose.

--time-zone

Fuso orario di SQL Server per l'istanza.

--trace-flags

Elenco delimitato da virgole di flag di traccia. Nessun flag per impostazione predefinita.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

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 mi-arc get-mirroring-cert

Recuperare il certificato dell'endpoint del mirroring del gruppo di disponibilità da sql mi e archiviare in un file.

az sql mi-arc get-mirroring-cert --cert-file
                                 --name
                                 [--k8s-namespace]
                                 [--use-k8s]

Esempio

Recuperare il certificato dell'endpoint del mirroring del gruppo di disponibilità da sqlmi1 e archiviare in fileName1

az sql mi-arc get-mirroring-cert -n sqlmi1 --cert-file fileName1

Parametri necessari

--cert-file

Nome file locale per archiviare il certificato recuperato in formato PEM.

--name -n

Nome dell'istanza gestita di SQL.

Parametri facoltativi

--k8s-namespace -k

Spazio dei nomi in cui deve essere distribuita l'istanza gestita di SQL. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

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 mi-arc list

Elenca le istanze gestite di SQL.

az sql mi-arc list [--custom-location]
                   [--k8s-namespace]
                   [--resource-group]
                   [--use-k8s]

Esempio

Elenca le istanze gestite di SQL.

az sql mi-arc list --use-k8s

Parametri facoltativi

--custom-location

Percorso personalizzato in cui vengono distribuiti i Istanza gestita di SQL abilitati per Arc. Se non specificato, verranno elencate tutte le istanze del gruppo di risorse.

--k8s-namespace -k

Spazio dei nomi Kubernetes contenente le Istanza gestita di SQL abilitate per Arc. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--resource-group -g

Gruppo di risorse di Azure contenente le Istanza gestita di SQL abilitate per Arc.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

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 mi-arc reprovision-replica

Eseguire nuovamente il provisioning di una replica in un'istanza gestita di SQL.

az sql mi-arc reprovision-replica --name
                                  [--k8s-namespace]
                                  [--no-wait]
                                  [--use-k8s]

Esempio

Ex 1 - Eseguire il reprovisioning della replica 1 dell'istanza gestita di SQL sqlmi1.

az sql mi-arc reprovision-replica -n sqlmi1-1 --use-k8s --k8s-namespace namespace

Parametri necessari

--name -n

Nome della replica dell'istanza gestita di SQL di cui eseguire il provisioning.

Parametri facoltativi

--k8s-namespace -k

Spazio dei nomi in cui viene distribuita la replica dell'istanza gestita di SQL. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--no-wait

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

valore predefinito: False

--use-k8s

Eseguire di nuovo il provisioning della replica dell'istanza gestita di SQL usando le API Kubernetes locali.

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 mi-arc show

Visualizza i dettagli di un'istanza gestita di SQL.

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

Esempio

Visualizzare i dettagli di un Istanza gestita di SQL usando l'API Kubernetes.

az sql mi-arc show --name sqlmi1 --k8s-namespace arc --use-k8s

Visualizzare i dettagli di un Istanza gestita di SQL eseguendo query su Azure Resource Manager (ARM).

az sql mi-arc show --name sqlmi1 --resource-group rg-name

Parametri necessari

--name -n

Nome dell'istanza gestita di SQL da visualizzare.

Parametri facoltativi

--k8s-namespace -k

Spazio dei nomi in cui deve essere distribuita l'istanza gestita di SQL. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--path -p

Percorso in cui deve essere scritta la specifica completa per l'istanza gestita di SQL. Se omesso, la specifica verrà scritta nell'output standard.

--resource-group -g

Gruppo di risorse di Azure in cui è presente il Istanza gestita di SQL abilitato per Arc.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

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 mi-arc update

Aggiornare la configurazione di un'istanza gestita di SQL.

az sql mi-arc update --name
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--cores-limit]
                     [--cores-request]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--preferred-primary-replica]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]

Esempio

Aggiornare la configurazione di un'istanza gestita di SQL.

az sql mi-arc update --path ./spec.json -n sqlmi1 --use-k8s

Parametri necessari

--name -n

Nome dell'istanza gestita di SQL sottoposta a modifica. Il nome con cui viene distribuita l'istanza non può essere modificato.

Parametri facoltativi

--ad-encryption-types

Elenco delimitato da virgole dei tipi di crittografia di Active Directory supportati. Deve essere un subset dei valori seguenti: RC4, AES128, AES256.

--agent-enabled

Abilitare SQL Server Agent per l'istanza di . L'impostazione predefinita corrisponde alla disabilitazione.

--annotations

Elenco delimitato da virgole di annotazioni dell'istanza gestita di SQL.

--cert-private-key-file

Percorso del file contenente una chiave privata del certificato con formattazione PEM da usare per SQL Server.

--cert-public-key-file

Percorso del file contenente una chiave pubblica del certificato con formattazione PEM da usare per SQL Server.

--cores-limit -c

Limite di core dell'istanza gestita come numero intero.

--cores-request

Richiesta di core dell'istanza gestita come numero intero.

--k8s-namespace -k

Spazio dei nomi in cui deve essere distribuita l'istanza gestita di SQL. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--keytab-secret

Nome del segreto Kubernetes che contiene il file keytab per questo Istanza gestita di SQL abilitato per Arc.

--labels

Elenco delimitato da virgole di etichette dell'istanza gestita di SQL.

--license-type -l

--memory-limit -m

Limite della capacità dell'istanza gestita come numero intero seguito da Gi (gigabyte). Esempio: 4Gi.

--memory-request

Richiesta per la capacità dell'istanza gestita come numero intero seguito da Gi (gigabyte). Esempio: 4Gi.

--no-wait

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

valore predefinito: False

--orchestrator-replicas

Numero di repliche dell'agente di orchestrazione a disponibilità elevata. Il valore deve essere compreso tra 1 e 3.

--path

Percorso del file azext_arcdata per il file JSON dell'istanza gestita di SQL.

--preferred-primary-replica

Replica primaria preferita da aggiornare.

--readable-secondaries

Numero di repliche da rendere leggibili. Si applica solo al livello Business Critical. Il valore deve essere compreso tra 0 e il numero di repliche meno 1.

--replicas

Questa opzione specifica il numero di repliche Istanza gestita di SQL che verranno distribuite nel cluster Kubernetes a scopo di disponibilità elevata.

valori accettati: 1, 2, 3

--resource-group -g

Gruppo di risorse di Azure in cui è presente il Istanza gestita di SQL abilitato per Arc.

--retention-days

--service-annotations

Elenco delimitato da virgole di annotazioni da applicare a tutti i servizi esterni.

--service-cert-secret

Nome del segreto Kubernetes per generare tale host o ospiterà il certificato del servizio SQL.

--service-labels

Elenco delimitato da virgole di etichette da applicare a tutti i servizi esterni.

--sync-secondary-to-commit

valori accettati: -1, 0, 1, 2

--tde-mode

Modalità TDE (Transparent Data Encryption) per questa Istanza gestita di SQL abilitata per Arc. Valori consentiti: ServiceManaged, CustomerManaged o Disabled. Il valore predefinito è Disabled.

--tde-protector-private-key-file

Percorso del file contenente una chiave privata del certificato con formattazione PEM da usare per TDE.

--tde-protector-public-key-file

Percorso del file contenente una chiave pubblica del certificato con formattazione PEM da usare per TDE.

--tde-protector-secret

--tier -t

Piano tariffario per l'istanza. Valori consentiti: BusinessCritical (bc for short) o GeneralPurpose (gp per breve). Il valore predefinito è GeneralPurpose.

--time-zone

Fuso orario di SQL Server per l'istanza.

--trace-flags

Elenco delimitato da virgole di flag di traccia. Nessun flag per impostazione predefinita.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

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 mi-arc upgrade

Aggiornare l'istanza gestita di SQL.

Aggiornare l'istanza gestita di SQL alla versione desiderata specificata. Se la versione desiderata non è specificata, verrà usata la versione del controller dati.

az sql mi-arc upgrade [--desired-version]
                      [--dry-run]
                      [--field-filter]
                      [--force]
                      [--k8s-namespace]
                      [--label-filter]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

Esempio

Aggiornare l'istanza gestita di SQL.

az sql mi-arc upgrade -n sqlmi1 -k arc --desired-version v1.1.0 --use-k8s

Parametri facoltativi

--desired-version -v

Versione valida più recente a cui eseguire l'aggiornamento. Facoltativo, se non viene specificata alcuna versione, verrà usata la versione del titolare del trattamento dei dati. Specificare 'auto' per eseguire automaticamente l'aggiornamento alla versione valida più recente. Altre informazioni sugli aggiornamenti automatici sono disponibili in: https://aka.ms/arc-sqlmi-auto-upgrade.

--dry-run -d

Indica quale istanza verrà aggiornata ma non aggiorna effettivamente le istanze.

--field-filter -f

Filtrare per selezionare le istanze da aggiornare in base alle proprietà delle risorse.

--force

Esegue l'override di tutti i criteri che possono essere applicati all'istanza e tenta di eseguire l'aggiornamento.

valore predefinito: False

--k8s-namespace -k

Spazio dei nomi in cui deve essere distribuita l'istanza gestita di SQL. Se non viene specificato alcuno spazio dei nomi, verrà usato lo spazio dei nomi definito in kubeconfig.

--label-filter -l

Filtra per selezionare l'istanza da aggiornare in base alle etichette.

--name -n

Nome dell'istanza gestita di SQL.

--no-wait

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

valore predefinito: False

--resource-group -g

Gruppo di risorse di Azure in cui è presente il Istanza gestita di SQL abilitato per Arc di destinazione.

--target

Deprecato

L'opzione '-target' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--desired-version'.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

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

Comandi

az sql mi-arc create

Esempio

Parametri necessari

Parametri facoltativi

az sql mi-arc delete

Esempio

Parametri necessari

Parametri facoltativi

az sql mi-arc edit

Parametri necessari

Parametri facoltativi

az sql mi-arc get-mirroring-cert

Esempio

Parametri necessari

Parametri facoltativi

az sql mi-arc list

Esempio

Parametri facoltativi

az sql mi-arc reprovision-replica

Esempio

Parametri necessari

Parametri facoltativi

az sql mi-arc show

Esempio

Parametri necessari

Parametri facoltativi

az sql mi-arc update

Esempio

Parametri necessari

Parametri facoltativi

az sql mi-arc upgrade

Esempio

Parametri facoltativi

Commenti e suggerimenti

Risorse aggiuntive