Condividi tramite

azdata bdc config

  • Articolo

Si applica: all'interfaccia della riga di comando di Azure Data (azdata)

L'articolo seguente fornisce informazioni di riferimento sui comandi sql dello strumento azdata. Per altre informazioni su altri comandi azdata, vedere Informazioni di riferimento su azdata.

Comandi

Comando Descrizione
azdata bdc config init Inizializza un profilo di configurazione del cluster Big Data che è possibile usare con bdc create.
azdata bdc config list Elenca i profili di configurazione disponibili.
azdata bdc config show Visualizza la configurazione corrente del cluster Big Data o la configurazione di un file locale specificato dall'utente, ad esempio custom/bdc.json.
azdata bdc config add Aggiunge un valore per un percorso JSON in un file di configurazione.
azdata bdc config remove Rimuove un valore per un percorso JSON in un file di configurazione.
azdata bdc config replace Sostituisce un valore per un percorso JSON in un file di configurazione.
azdata bdc config patch Applica una patch a un file di configurazione in base a un file di patch JSON.

azdata bdc config init

Inizializza un profilo di configurazione del cluster Big Data che è possibile usare con bdc create. È possibile indicare l'origine specifica del profilo di configurazione negli argomenti.

azdata bdc config init [--path -p] 
                       [--source -s]  
                       
[--force -f]  
                       
[--accept-eula -a]

Esempi

Esperienza guidata di inizializzazione della configurazione del cluster Big Data: si riceveranno le indicazioni relative ai valori necessari.

azdata bdc config init

Inizializzazione della configurazione del cluster Big Data con argomenti: viene creato un profilo di configurazione aks-dev-test in ./custom.

azdata bdc config init --source aks-dev-test --target custom

Parametri facoltativi

--path -p

Percorso del file in cui si vuole inserire il profilo di configurazione. Il valore predefinito è <cwd>/custom.

--source -s

Origine del profilo di configurazione: ['kubeadm-dev-test', 'kubeadm-prod', 'openshift-prod', 'aks-dev-test-ha', 'aks-dev-test', 'aro-dev-test', 'openshift-dev-test', 'aro-dev-test-ha']

--force -f

Forza la sovrascrittura del file di destinazione.

--accept-eula -a

Indica se accettare le condizioni di licenza: [yes/no]. Se non si vuole usare questo argomento, è possibile impostare la variabile di ambiente ACCEPT_EULA su "yes". Le condizioni di licenza di questo prodotto sono disponibili in https://aka.ms/eula-azdata-en.

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

--output -o

Formato di output. Valori consentiti: json, jsonc, table, tsv. Valore predefinito: json.

--query -q

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

--verbose

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

azdata bdc config list

Elenca i profili di configurazione disponibili da usare in bdc config init

azdata bdc config list [--config-profile -c] 
                       [--type -t]  
                       
[--accept-eula -a]

Esempi

Mostrare tutti i nomi dei profili di configurazione disponibili.

azdata bdc config list

Mostrare il codice JSON di un profilo di configurazione specifico.

azdata bdc config list --config-profile aks-dev-test

Parametri facoltativi

--config-profile -c

Profilo di configurazione predefinito: ['kubeadm-dev-test', 'kubeadm-prod', 'openshift-prod', 'aks-dev-test-ha', 'aks-dev-test', 'aro-dev-test', 'openshift-dev-test', 'aro-dev-test-ha']

--type -t

Tipo di configurazione che si vuole visualizzare.

--accept-eula -a

Indica se accettare le condizioni di licenza: [yes/no]. Se non si vuole usare questo argomento, è possibile impostare la variabile di ambiente ACCEPT_EULA su "yes". Le condizioni di licenza di questo prodotto sono disponibili in https://aka.ms/eula-azdata-en.

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

--output -o

Formato di output. Valori consentiti: json, jsonc, table, tsv. Valore predefinito: json.

--query -q

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

--verbose

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

azdata bdc config show

Visualizza la configurazione corrente del cluster Big Data o la configurazione di un file locale specificato dall'utente, ad esempio custom/bdc.json. Il comando può accettare anche un percorso JSON se si vuole ottenere solo una sezione. È anche possibile specificare un file di destinazione per l'output. Se non si specifica un file di destinazione, l'output verrà inviato nel terminale.

azdata bdc config show [--config-file -c] 
                       [--target -t]  
                       
[--json-path -j]  
                       
[--force -f]

Esempi

Mostrare la configurazione del cluster Big Data nella console

azdata bdc config show

In un file di configurazione locale ottenere un valore alla fine di un percorso di chiave JSON semplice.

azdata bdc config show --config-file custom-config/bdc.json --json-path "metadata.name" --target section.json

In un file di configurazione locale, ottiene le risorse all'interno di un servizio

azdata bdc config show --config-file custom-config/bdc.json --json-path "$.spec.services.sql.resources" --target section.json

Parametri facoltativi

--config-file -c

Percorso del file di configurazione del cluster Big Data se non si vuole applicare la configurazione del cluster a cui si è attualmente connessi, ad esempio custom/bdc.json

--target -t

File di output in cui archiviare il risultato. Valore predefinito: indirizzamento a StdOut.

--json-path -j

Percorso di chiave JSON che conduce alla sezione o al valore desiderato della configurazione, ad esempio key1.key2.key3. Usa il linguaggio di query jsonpath https://jsonpath.com/, ad esempio: -j '$.spec.pools[?(@.spec.type == "Master")]..endpoints'

--force -f

Forza la sovrascrittura del file di destinazione.

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

--output -o

Formato di output. Valori consentiti: json, jsonc, table, tsv. Valore predefinito: json.

--query -q

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

--verbose

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

azdata bdc config add

Aggiunge il valore nel percorso JSON nel file di configurazione. Tutti gli esempi seguenti si riferiscono alla shell Bash. Se si usa un'altra riga di comando, potrebbe essere necessario usare le notazioni di escape in modo appropriato. In alternativa, è possibile usare la funzionalità del file di patch.

azdata bdc config add --path -p 
                      --json-values -j

Esempi

Esempio 1 - Aggiungere lo spazio di archiviazione del piano di controllo.

azdata bdc config add --path custom/control.json --json-values "spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}"

Parametri necessari

--path -p

Percorso del file di configurazione del cluster Big Data per la configurazione che si vuole impostare, ad esempio custom/bdc.json.

--json-values -j

Elenco di coppie chiave/valore di percorsi JSON dei valori: key1.subkey1=value1,key2.subkey2=value2. È possibile specificare valori JSON inline, ad esempio: key='{"kind":"cluster","name":"test-cluster"}' oppure fornire un percorso di file, ad esempio key=./values.json. L'operazione di aggiunta NON supporta le istruzioni condizionali. Se il valore inline specificato è esso stesso una coppia chiave/valore con caratteri '=' e ',' usare caratteri di escape per tali caratteri. Ad esempio, key1="key2=val2,key3=val3". Per esempi relativi all'aspetto del percorso, vedere http://jsonpatch.com/. Se si vuole accedere a una matrice, è necessario indicare l'indice, ad esempio key.0=value.

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

--output -o

Formato di output. Valori consentiti: json, jsonc, table, tsv. Valore predefinito: json.

--query -q

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

--verbose

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

azdata bdc config remove

Rimuove il valore nel percorso JSON nel file di configurazione. Tutti gli esempi seguenti si riferiscono alla shell Bash. Se si usa un'altra riga di comando, potrebbe essere necessario usare le notazioni di escape in modo appropriato. In alternativa, è possibile usare la funzionalità del file di patch.

azdata bdc config remove --path -p 
                         --json-path -j

Esempi

Esempio 1 - Rimuovere lo spazio di archiviazione del piano di controllo.

azdata bdc config remove --path custom/control.json --json-path ".spec.storage"

Parametri necessari

--path -p

Percorso del file di configurazione del cluster Big Data per la configurazione che si vuole impostare, ad esempio custom/bdc.json.

--json-path -j

Elenco di percorsi JSON basati sulla libreria jsonpatch che indica i valori da rimuovere, ad esempio: key1.subkey1,key2.subkey2. L'operazione di rimozione NON supporta le istruzioni condizionali. Per esempi relativi all'aspetto del percorso, vedere http://jsonpatch.com/. Se si vuole accedere a una matrice, è necessario indicare l'indice, ad esempio key.0=value.

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

--output -o

Formato di output. Valori consentiti: json, jsonc, table, tsv. Valore predefinito: json.

--query -q

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

--verbose

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

azdata bdc config replace

Sostituisce il valore nel percorso JSON nel file di configurazione. Tutti gli esempi seguenti si riferiscono alla shell Bash. Se si usa un'altra riga di comando, potrebbe essere necessario usare le notazioni di escape in modo appropriato. In alternativa, è possibile usare la funzionalità del file di patch.

azdata bdc config replace --path -p 
                          --json-values -j

Esempi

Esempio 1 - Sostituire la porta di un singolo endpoint (endpoint controller).

azdata bdc config replace --path custom/control.json --json-values "$.spec.endpoints[?(@.name=="Controller")].port=30080"

Esempio 2 - Sostituire lo spazio di archiviazione del piano di controllo.

azdata bdc config replace --path custom/control.json --json-values "spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}"

Esempio 3 - Sostituire le specifiche della risorsa storage-0, incluse le repliche.

azdata bdc config replace --path custom/bdc.json --json-values "$.spec.resources.storage-0.spec={"replicas": 2,"storage": {"className": "managed-premium","size": "10Gi","accessMode": "ReadWriteOnce"},"type": "Storage"}"

Parametri necessari

--path -p

Percorso del file di configurazione del cluster Big Data per la configurazione che si vuole impostare, ad esempio custom/bdc.json.

--json-values -j

Elenco di coppie chiave/valore di percorsi JSON dei valori: key1.subkey1=value1,key2.subkey2=value2. È possibile specificare valori JSON inline, ad esempio: key='{"kind":"cluster","name":"test-cluster"}' oppure fornire un percorso di file, ad esempio key=./values.json. L'operazione di sostituzione supporta le istruzioni condizionali tramite la libreria jsonpath. Per usarle, il percorso deve iniziare con $. In questo modo sarà possibile usare un'istruzione condizionale, ad esempio -j $.key1.key2[?(@.key3=='someValue'].key4=value. Se il valore inline specificato è esso stesso una coppia chiave/valore con caratteri '=' e ',' usare caratteri di escape per tali caratteri. Ad esempio, key1="key2=val2,key3=val3". Vedere gli esempi seguenti. Per altre informazioni, vedere https://jsonpath.com/

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

--output -o

Formato di output. Valori consentiti: json, jsonc, table, tsv. Valore predefinito: json.

--query -q

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

--verbose

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

azdata bdc config patch

Applica una patch al file di configurazione in base al file di patch specificato. Vedere http://jsonpatch.com/ per comprendere meglio come devono essere composti i percorsi. L'operazione di sostituzione consente di usare istruzioni condizionali nel percorso grazie alla libreria jsonpath https://jsonpath.com/. Tutti i file JSON di patch devono iniziare con una chiave "patch" che abbia una matrice di patch con le relative informazioni per operazione (add, replace, remove), percorso e valore. L'operazione "remove" non richiede un valore, ma solo un percorso. Vedere gli esempi seguenti.

azdata bdc config patch --path 
                        --patch-file -p

Esempi

Esempio 1 - Sostituire la porta di un singolo endpoint (endpoint controller) con il file di patch.

azdata bdc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=="Controller")].port","value":30080}]}

Esempio 2 - Sostituire lo spazio di archiviazione del piano di controllo con il file di patch.

azdata bdc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}

Esempio 3 - Sostituire lo spazio di archiviazione del pool, incluse le repliche (pool di archiviazione) con il file di patch.

azdata bdc config patch --path custom/bdc.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.resources.storage-0.spec","value":{"replicas": 2,"storage": {"className": "managed-premium","size": "10Gi","accessMode": "ReadWriteOnce"},"type": "Storage"}}]}

Parametri necessari

--path

Percorso del file di configurazione del cluster Big Data per la configurazione che si vuole impostare, ad esempio custom/bdc.json.

--patch-file -p

Percorso di un file JSON di patch basato sulla libreria jsonpatch: http://jsonpatch.com/. Il file JSON di patch deve iniziare con una chiave denominata "patch", il cui valore è una matrice di operazioni di patch da eseguire. Per il percorso di un'operazione di patch, è possibile usare la notazione con punto, ad esempio key1.key2, per la maggior parte delle operazioni. Se si vuole eseguire un'operazione di sostituzione e si sta sostituendo un valore in una matrice che richiede un'istruzione condizionale, usare la notazione jsonpath facendo iniziare il percorso con $. In questo modo sarà possibile usare un'istruzione condizionale, ad esempio $.key1.key2[?(@.key3=='someValue'].key4. Vedere gli esempi seguenti. Per altre informazioni sulle istruzioni condizionali, vedere https://jsonpath.com/.

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

--output -o

Formato di output. Valori consentiti: json, jsonc, table, tsv. Valore predefinito: json.

--query -q

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

--verbose

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

Passaggi successivi

Per altre informazioni su altri comandi azdata, vedere Informazioni di riferimento su azdata.

Per altre informazioni su come installare lo strumento azdata, vedere Installare azdata.