azdata bdc config

Artigo
05/30/2023

Aplica-se a: CLI de Dados do Azure (azdata)

O artigo a seguir fornece referência para os comandos sql na ferramenta azdata. Para obter mais informações sobre outros comandos de azdata, confira referência de azdata

Comandos

Comando	Descrição
azdata bdc config init	Inicializa um perfil de configuração de cluster de Big Data que pode ser usado com o comando bdc create.
azdata bdc config list	Lista opções de perfil de configuração disponíveis.
azdata bdc config show	Mostra a configuração atual do BDC ou a configuração de um arquivo local que você especificar, ou seja, custom/bdc.json.
azdata bdc config add	Adicionar um valor para um caminho json em um arquivo de configuração.
azdata bdc config remove	Remover um valor para um caminho json em um arquivo de configuração.
azdata bdc config replace	Substituir um valor para um caminho json em um arquivo de configuração.
azdata bdc config patch	Corrigir um arquivo de configuração baseado em um arquivo de patch json.

azdata bdc config init

Inicializa um perfil de configuração de cluster de Big Data que pode ser usado com o comando bdc create. A origem específica do perfil de configuração pode ser especificada nos argumentos.

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

Exemplos

Experiência de inicialização da configuração de BDC orientada – você receberá prompts para obter os valores necessários.

azdata bdc config init

Inicialização da configuração de BDC com argumentos, cria um perfil de configuração de aks-dev-test em./custom.

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

Parâmetros opcionais

`--path -p`

Caminho do arquivo em que você deseja que o perfil de configuração seja colocado; o padrão é <cwd>/custom.

`--source -s`

Origem do perfil de configuração: ['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`

Forçar substituição do arquivo de destino.

`--accept-eula -a`

Você aceita os termos de licença? [sim/não]. Se não quiser usar esse argumento, você poderá definir a variável de ambiente ACCEPT_EULA como 'sim'. Os termos de licença desse produto podem ser exibidos em https://aka.ms/eula-azdata-en.

Argumentos globais

`--debug`

Aumente o detalhamento do log para mostrar todos os logs de depuração.

`--help -h`

Mostrar esta mensagem de ajuda e sair.

`--output -o`

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

`--query -q`

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

`--verbose`

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

azdata bdc config list

Lista opções de perfil de configuração disponíveis para uso em bdc config init

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

Exemplos

Mostra todos os nomes de perfis de configuração disponíveis.

azdata bdc config list

Mostra o json de um perfil de configuração específico.

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

Parâmetros opcionais

`--config-profile -c`

Perfil de configuração padrão: ['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`

O tipo de configuração que você gostaria de ver.

`--accept-eula -a`

Argumentos globais

`--debug`

Aumente o detalhamento do log para mostrar todos os logs de depuração.

`--help -h`

Mostrar esta mensagem de ajuda e sair.

`--output -o`

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

`--query -q`

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

`--verbose`

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

azdata bdc config show

Mostra a configuração atual do BDC ou a configuração de um arquivo local que você especificar, ou seja, custom/bdc.json. O comando também poderá usar um caminho json se você quiser obter apenas uma seção. Você também pode especificar um arquivo de destino para a saída. Se um arquivo de destino não for especificado, ele será apenas uma saída para o terminal.

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

Exemplos

Mostrar a configuração do BDC no console

azdata bdc config show

Em um arquivo de configuração local, obtenha um valor no final de um caminho de chave json simples.

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

Em um arquivo de configuração local, obtém os recursos dentro de um serviço

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

Parâmetros opcionais

`--config-file -c`

Caminho do arquivo de configuração do cluster de Big Data se você não quiser a configuração do cluster ao qual está conectado no momento, ou seja, custom/bdc.json

`--target -t`

Arquivo de saída no qual armazenar o resultado. Padrão: direcionado para stdout.

`--json-path -j`

O caminho de chave json que leva à seção ou ao valor desejado da configuração, ou seja, key1.key2.key3. Usa a linguagem de consulta jsonpath, https://jsonpath.com/, por exemplo: -j '$.spec.pools[?(@.spec.type == "Master")]..endpoints'

`--force -f`

Forçar substituição do arquivo de destino.

Argumentos globais

`--debug`

Aumente o detalhamento do log para mostrar todos os logs de depuração.

`--help -h`

Mostrar esta mensagem de ajuda e sair.

`--output -o`

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

`--query -q`

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

`--verbose`

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

azdata bdc config add

Adiciona o valor no caminho json no arquivo de configuração. Todos os exemplos abaixo são fornecidos em Bash. Se estiver usando outra linha de comando, lembre-se de que talvez seja necessário efetuar o escape das aspas. Como alternativa, você pode usar a funcionalidade de arquivo de patch.

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

Exemplos

Exemplo 1 – Adicionar armazenamento de plano de controle.

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

Parâmetros obrigatórios

`--path -p`

Caminho do arquivo de configuração do cluster de Big Data da configuração que você gostaria de definir, ou seja, custom/bdc.json

`--json-values -j`

Uma lista de pares chave-valor de caminhos json para valores: key1.subkey1=value1,key2.subkey2=value2. Você pode fornecer valores json embutidos como: key='{"kind":"cluster","name":"test-cluster"}' ou fornecer um caminho de arquivo, como key=./values.json. Adicionar NÃO dá suporte a condicionais. Se o valor embutido que você está fornecendo for um par chave-valor em si com '=' e ',', escape esses caracteres. Por exemplo, key1="key2=val2,key3=val3". Confira http://jsonpatch.com/ para obter exemplos de como deve ser a aparência de seu caminho. Se quiser acessar uma matriz, você deverá fazer isso indicando o índice, como key.0=value

Argumentos globais

`--debug`

Aumente o detalhamento do log para mostrar todos os logs de depuração.

`--help -h`

Mostrar esta mensagem de ajuda e sair.

`--output -o`

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

`--query -q`

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

`--verbose`

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

azdata bdc config remove

Remove o valor no caminho json no arquivo de configuração. Todos os exemplos abaixo são fornecidos em Bash. Se estiver usando outra linha de comando, lembre-se de que talvez seja necessário efetuar o escape das aspas. Como alternativa, você pode usar a funcionalidade de arquivo de patch.

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

Exemplos

Exemplo 1 – Remover armazenamento de plano de controle.

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

Parâmetros obrigatórios

`--path -p`

Caminho do arquivo de configuração do cluster de Big Data da configuração que você gostaria de definir, ou seja, custom/bdc.json

`--json-path -j`

Uma lista de caminhos json com base na biblioteca jsonpatch que indica os valores que você gostaria de remover, como: key1.subkey1,key2.subkey2. Remover NÃO dá suporte a condicionais. Confira http://jsonpatch.com/ para obter exemplos de como deve ser a aparência de seu caminho. Se quiser acessar uma matriz, você deverá fazer isso indicando o índice, como key.0=value

Argumentos globais

`--debug`

Aumente o detalhamento do log para mostrar todos os logs de depuração.

`--help -h`

Mostrar esta mensagem de ajuda e sair.

`--output -o`

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

`--query -q`

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

`--verbose`

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

azdata bdc config replace

Substitui o valor no caminho json no arquivo de configuração. Todos os exemplos abaixo são fornecidos em Bash. Se estiver usando outra linha de comando, lembre-se de que talvez seja necessário efetuar o escape das aspas. Como alternativa, você pode usar a funcionalidade de arquivo de patch.

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

Exemplos

Exemplo 1 – Substituir a porta de um único ponto de extremidade (ponto de extremidade do controlador).

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

Exemplo 2 – Substituir armazenamento de plano de controle.

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

Ex 3 – Substituir storage-0 resource spec, incluindo réplicas.

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

Parâmetros obrigatórios

`--path -p`

Caminho do arquivo de configuração do cluster de Big Data da configuração que você gostaria de definir, ou seja, custom/bdc.json

`--json-values -j`

Uma lista de pares chave-valor de caminhos json para valores: key1.subkey1=value1,key2.subkey2=value2. Você pode fornecer valores json embutidos como: key='{"kind":"cluster","name":"test-cluster"}' ou fornecer um caminho de arquivo, como key=./values.json. Substituir dá suporte a condicionais por meio da biblioteca jsonpath. Para usar isso, inicie o caminho com um $. Isso permitirá que você faça uma condicional, como -j $.key1.key2[?(@.key3=='someValue'].key4=value. Se o valor embutido que você está fornecendo for um par chave-valor em si com '=' e ',', escape esses caracteres. Por exemplo, key1="key2=val2,key3=val3". Veja exemplos abaixo. Para obter ajuda adicional, confira: https://jsonpath.com/

Argumentos globais

`--debug`

Aumente o detalhamento do log para mostrar todos os logs de depuração.

`--help -h`

Mostrar esta mensagem de ajuda e sair.

`--output -o`

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

`--query -q`

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

`--verbose`

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

azdata bdc config patch

Corrige o arquivo de configuração de acordo com o arquivo de patch fornecido. Confira http://jsonpatch.com/ para ter uma melhor compreensão de como os caminhos devem ser compostos. A operação de substituição pode usar condicionais em seu caminho devido à biblioteca de jsonpath https://jsonpath.com/. Todos os arquivos json de patch devem começar com uma chave de "patch" que tem uma matriz de patches com suas operações (adicionar, substituir, remover), caminho e valor correspondentes. A operação "remove" não requer um valor, apenas um caminho. Veja os exemplos abaixo.

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

Exemplos

Exemplo 1 – Substituir a porta de um único ponto de extremidade (ponto de extremidade do controlador) por um arquivo de 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}]}

Exemplo 2 – Substituir armazenamento de plano de controle por um arquivo de 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"}}]}

Exemplo 3 – Substituir o armazenamento do pool, incluindo réplicas (pool de armazenamento) por um arquivo de 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"}}]}

Parâmetros obrigatórios

`--path`

Caminho do arquivo de configuração do cluster de Big Data da configuração que você gostaria de definir, ou seja, custom/bdc.json

`--patch-file -p`

Caminho para um arquivo json de patch que se baseia na biblioteca de jsonpatch: http://jsonpatch.com/. Você deve iniciar o arquivo json de patch com uma chave chamada "patch", cujo valor é uma matriz de operações de patch que você pretende fazer. Para o caminho de uma operação de patch, você pode usar a notação de ponto, como key1.key2, para a maioria das operações. Se você quiser fazer uma operação de substituição e estiver substituindo um valor em uma matriz que requer uma condicional, use a notação de jsonpath iniciando o caminho com um $. Isso permitirá que você faça uma condicional, como $.key1.key2[?(@.key3=='someValue'].key4. Veja os exemplos abaixo. Para obter ajuda adicional com os condicionais, confira https://jsonpath.com/.

Argumentos globais

`--debug`

Aumente o detalhamento do log para mostrar todos os logs de depuração.

`--help -h`

Mostrar esta mensagem de ajuda e sair.

`--output -o`

Formato de saída. Valores permitidos: json, jsonc, table, tsv. Padrão: json.

`--query -q`

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

`--verbose`

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

Próximas etapas

Para obter mais informações sobre outros comandos de azdata, confira referência de azdata.

Para saber mais sobre como instalar a ferramenta azdata, confira Instalar azdata.

Partilhar via

azdata bdc config

Comandos

azdata bdc config init

Exemplos

Parâmetros opcionais

--path -p

--source -s

--force -f

--accept-eula -a

Argumentos globais

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config list

Exemplos

Parâmetros opcionais

--config-profile -c

--type -t

--accept-eula -a

Argumentos globais

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config show

Exemplos

Parâmetros opcionais

--config-file -c

--target -t

--json-path -j

--force -f

Argumentos globais

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config add

Exemplos

Parâmetros obrigatórios

--path -p

--json-values -j

Argumentos globais

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config remove

Exemplos

Parâmetros obrigatórios

--path -p

--json-path -j

Argumentos globais

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config replace

Exemplos

Parâmetros obrigatórios

--path -p

--json-values -j

Argumentos globais

--debug

--help -h

--output -o

--query -q

--verbose

azdata bdc config patch

Exemplos

Parâmetros obrigatórios

--path

--patch-file -p

Argumentos globais

`--path -p`

`--source -s`

`--force -f`

`--accept-eula -a`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--config-profile -c`

`--type -t`

`--accept-eula -a`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--config-file -c`

`--target -t`

`--json-path -j`

`--force -f`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--path -p`

`--json-values -j`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--path -p`

`--json-path -j`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--path -p`

`--json-values -j`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`

`--path`

`--patch-file -p`

`--debug`

`--help -h`

`--output -o`

`--query -q`

`--verbose`