az sql mi-arc

Note

Questo riferimento fa parte dell'estensione arcdata per il 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 Azure Arc istanze gestite di SQL abilitate.

Comandi

Nome Descrizione Tipo Status
az sql mi-arc config

Comandi di configurazione.

Extension GA
az sql mi-arc config add

Aggiungere un valore per un percorso JSON in un file di configurazione.

Extension GA
az sql mi-arc config init

Inizializzare i file CRD e di specifica per un'istanza gestita di SQL.

Extension GA
az sql mi-arc config patch

Applicare patch a un file di configurazione basato su un file di patch JSON.

Extension GA
az sql mi-arc config remove

Rimuovere un valore per un percorso JSON in un file di configurazione.

Extension GA
az sql mi-arc config replace

Sostituire un valore per un percorso JSON in un file di configurazione.

Extension GA
az sql mi-arc create

Crea un'istanza gestita di SQL.

Extension GA
az sql mi-arc delete

Elimina un'istanza gestita di SQL.

Extension GA
az sql mi-arc endpoint

Visualizzare e gestire gli endpoint SQL.

Extension GA
az sql mi-arc endpoint list

Elencare gli endpoint SQL.

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

Extension GA
az sql mi-arc list

Elenca le istanze gestite di SQL.

Extension GA
az sql mi-arc reprovision-replica

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

Extension GA
az sql mi-arc show

Visualizza i dettagli di un'istanza gestita di SQL.

Extension GA
az sql mi-arc update

Aggiornare la configurazione di un'istanza gestita di SQL.

Extension GA
az sql mi-arc upgrade

Aggiornare l'istanza gestita di SQL.

Extension GA

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
                     [--acquire-policy-token]
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--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]
                     [--private-key-file]
                     [--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 autenticazione 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

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

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--ad-account-name

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

--ad-connector-name

Nome del connettore 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 supportati Active Directory. 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.

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

Abilitare SQL Server agente per l'istanza di . Predefinito è disabilitato. I valori consentiti sono 'true' o 'false'.

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

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

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--cert-private-key-file

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

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--cert-public-key-file

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

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

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--collation

Regole di confronto SQL Server per l'istanza di .

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--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.

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

Se viene specificato, viene considerato un'istanza di sviluppo e non verrà addebitato alcun costo.

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

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

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

--labels

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

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

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

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--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 titolare del trattamento dei dati.

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

--private-key-file

File di chiave privata generato da openSSL da usare come ID istanza.

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

Proprietà Valore
Valori accettati: 1, 2, 3
--resource-group -g

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

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--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 la connessione 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.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--service-cert-secret

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

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

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

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

Tipo per il servizio primario.

Proprietà Valore
Valori accettati: LoadBalancer, NodePort
--storage-annotations

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

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--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 (.mdf, ndf). Se non viene specificato alcun valore, non verrà specificata alcuna classe di archiviazione, che comporterà Kubernetes usando la classe di archiviazione predefinita.

--storage-class-datalogs

Classe di archiviazione da usare per i log del database (con estensione ldf). Se non viene specificato alcun valore, non verrà specificata alcuna classe di archiviazione, che comporterà Kubernetes usando la classe di archiviazione predefinita.

--storage-class-logs

Classe di archiviazione da usare per i log (/var/log). Se non viene specificato alcun valore, non verrà specificata alcuna classe di archiviazione, che comporterà Kubernetes usando 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 specificato alcun valore, non verrà specificata alcuna classe di archiviazione, che comporterà Kubernetes usando la classe di archiviazione predefinita.

--storage-labels

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

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--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.

Proprietà Valore
Valore predefinito: -1
Valori accettati: -1, 0, 1, 2
--tde-mode

Modalità Transparent Data Encryption (TDE) 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.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

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

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--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

Il SQL Server fuso orario per l'istanza di .

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

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--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

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

Elimina un'istanza gestita di SQL.

az sql mi-arc delete --name
                     [--acquire-policy-token]
                     [--change-reference]
                     [--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

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

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--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.

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
--resource-group -g

Gruppo di risorse Azure in cui è presente il Istanza gestita di SQL abilitato 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 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
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--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

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

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--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.

Proprietà Valore
Gruppo di parametri: Kubernetes API – 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 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

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

--custom-location

Percorso personalizzato in cui vengono distribuite le istanze gestite di SQL abilitate per Arc. Se non specificato, verranno elencate tutte le istanze del gruppo di risorse.

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

Spazio dei nomi Kubernetes contenente le istanze gestite di SQL abilitate per Arc. 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
--resource-group -g

Gruppo di risorse Azure contenente le istanze gestite di SQL abilitate 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 mi-arc reprovision-replica

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

az sql mi-arc reprovision-replica --name
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--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

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

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--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.

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
--use-k8s

Eseguire di nuovo il provisioning della replica dell'istanza gestita di SQL 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 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 una query 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

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 distribuita l'istanza gestita di SQL. 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
--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 Azure in cui è presente il Istanza gestita di SQL abilitato 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 mi-arc update

Aggiornare la configurazione di un'istanza gestita di SQL.

az sql mi-arc update --name
                     [--acquire-policy-token]
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--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 da modificare. Il nome con cui viene distribuita l'istanza non può essere modificato.

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.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--ad-encryption-types

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

--agent-enabled

Abilitare SQL Server agente per l'istanza di . Predefinito è disabilitato.

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

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--cert-public-key-file

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

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

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--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.

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

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

--labels

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

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

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
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.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--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.

Proprietà Valore
Valori accettati: 1, 2, 3
--resource-group -g

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

Proprietà Valore
Gruppo di parametri: Azure Resource Manager – targeted Arguments
--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.

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

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

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

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

Proprietà Valore
Valori accettati: -1, 0, 1, 2
--tde-mode

Modalità Transparent Data Encryption (TDE) 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.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--tde-protector-public-key-file

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

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--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

Il SQL Server fuso orario per l'istanza di .

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

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 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 [--acquire-policy-token]
                      [--change-reference]
                      [--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

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

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--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.

Proprietà Valore
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.

Proprietà Valore
Gruppo di parametri: Kubernetes API – targeted Arguments
--label-filter -l

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

--name -n

Nome dell'istanza gestita di SQL.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--resource-group -g

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

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

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

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.

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