Partilhar via

az sql mi-arc config

Note

Esta referência faz parte da extensão arcdata para o CLI do Azure (versão 2.3.1 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az sql mi-arc config. Saiba mais sobre extensões.

Comandos de configuração.

Comandos

Name Description Tipo Status
az sql mi-arc config add

Adicione um valor para um caminho json em um arquivo de configuração.

 Extension disponibilidade geral
az sql mi-arc config init

Inicialize os ficheiros CRD e de especificação para uma instância gerida por SQL.

 Extension disponibilidade geral
az sql mi-arc config patch

Corrige um ficheiro de configuração com base num ficheiro de patch json.

 Extension disponibilidade geral
az sql mi-arc config remove

Remova um valor para um caminho json em um arquivo de configuração.

 Extension disponibilidade geral
az sql mi-arc config replace

Substitua um valor para um caminho json em um arquivo de configuração.

 Extension disponibilidade geral

az sql mi-arc config add

Adicione um valor para um caminho json em um arquivo de configuração.

Adiciona o valor no caminho json no ficheiro de configuração. Todos os exemplos abaixo são dados em Bash. Se usar outra linha de comandos, pode ser necessário evitar as aspas adequadamente. Como alternativa, você pode usar a funcionalidade de arquivo de patch.

az sql mi-arc config add --json-values
                         --path
                         [--acquire-policy-token]
                         [--change-reference]

Exemplos

Ex 1 - Adicionar armazenamento.

az sql mi-arc config add --path custom/spec.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

Parâmetros Obrigatórios

--json-values -j

Uma lista de pares-chave-valor de caminhos json para valores: key1.subkey1=value1,key2.subkey2=value2. Pode fornecer valores json inline, tais como: key='{"kind":"cluster","name":"test-cluster"}' ou fornecer um caminho de ficheiro, como key=./values.json. O comando add NÃO suporta condicionais. Se o valor inline que estás a fornecer for um valor-chave, emparelha-se com = e , , por favor, evita esses caracteres. Por exemplo: key1=\"key2\=val2\,key3\=val3\". Por favor, veja http://jsonpatch.com/ para exemplos de como seu caminho deve parecer. Se quiser aceder a um array, deve fazê-lo indicando o índice, como key.0=value.

--path -p

Caminho para a especificação de recurso personalizada, ou seja, custom/spec.json.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az sql mi-arc config init

Inicialize os ficheiros CRD e de especificação para uma instância gerida por SQL.

az sql mi-arc config init --path
                          [--acquire-policy-token]
                          [--change-reference]

Exemplos

Inicialize os ficheiros CRD e de especificação para uma instância gerida por SQL.

az sql mi-arc config init --path ./template

Parâmetros Obrigatórios

--path -p

Um caminho onde o CRD e a especificação para a instância gerenciada SQL devem ser gravados.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az sql mi-arc config patch

Corrige um ficheiro de configuração com base num ficheiro de patch json.

Corrige o ficheiro de configuração de acordo com o ficheiro de patch indicado. Consulte http://jsonpatch.com/ para compreender melhor como os percursos devem ser elaborados. A operação de substituição pode usar condicionais em seu caminho devido à biblioteca jsonpath https://jsonpath.com/. Todos os ficheiros json de patch devem começar com uma chave de patch que tenha um array de patches com o seu correspondente op (adicionar, substituir, remover), path e value. O remove autor original não precisa de um valor, apenas de um caminho. Veja os exemplos abaixo.

az sql mi-arc config patch --patch-file
                           --path
                           [--acquire-policy-token]
                           [--change-reference]

Exemplos

Ex 1 - Substitua a porta de um único ponto de extremidade pelo arquivo de patch.

az sql mi-arc config patch --path custom/spec.json --patch ./patch.json

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

Ex 2 - Substitua o armazenamento pelo arquivo de patch.

az sql mi-arc config patch --path custom/spec.json --patch ./patch.json

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

Parâmetros Obrigatórios

--patch-file

Caminho para um arquivo json de patch baseado na biblioteca jsonpatch: http://jsonpatch.com/. Deve iniciar o seu ficheiro patch json com uma chave chamada patch, cujo valor é um array de operações de patch que pretende realizar. Para o percurso de uma operação de patch, pode usar notação de pontos, como key1.key2 na maioria das operações. Se você gostaria de fazer uma operação de substituição e está substituindo um valor em uma matriz que requer uma condicional, use a notação jsonpath iniciando seu caminho com um $. Isto permitirá que faça um condicional como $.key1.key2[?(@.key3=="someValue"].key4. Veja os exemplos abaixo. Para ajuda adicional com condicionais, veja: https://jsonpath.com/.

--path -p

Caminho para a especificação de recurso personalizada, ou custom/spec.jsonseja, .

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az sql mi-arc config remove

Remova um valor para um caminho json em um arquivo de configuração.

Remova o valor no caminho json no ficheiro de configuração. Todos os exemplos abaixo são dados em Bash. Se usar outra linha de comandos, pode ser necessário evitar as aspas adequadamente. Como alternativa, você pode usar a funcionalidade de arquivo de patch.

az sql mi-arc config remove --json-path
                            --path
                            [--acquire-policy-token]
                            [--change-reference]

Exemplos

Ex 1 - Retirar arrumos.

az sql mi-arc config remove --path custom/spec.json --json-path '.spec.storage'

Parâmetros Obrigatórios

--json-path -j

Uma lista de caminhos json baseada na biblioteca jsonpatch que indica quais os valores que gostaria de serem removidos, tais como: key1.subkey1,key2.subkey2. O comando remove NÃO suporta condicionais. Por favor, veja http://jsonpatch.com/ para exemplos de como seu caminho deve parecer. Se quiser aceder a um array, deve fazê-lo indicando o índice, como key.0=value.

--path -p

Caminho para a especificação de recurso personalizada, ou custom/spec.jsonseja, .

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az sql mi-arc config replace

Substitua um valor para um caminho json em um arquivo de configuração.

Substitua o valor no caminho json no ficheiro de configuração. Todos os exemplos abaixo são dados em Bash. Se usar outra linha de comandos, pode ser necessário evitar as aspas adequadamente. Como alternativa, você pode usar a funcionalidade de arquivo de patch.

az sql mi-arc config replace --json-values
                             --path
                             [--acquire-policy-token]
                             [--change-reference]

Exemplos

Ex 1 - Substitua a porta de um único ponto de extremidade.

az sql mi-arc config replace --path custom/spec.json --json-values '$.spec.endpoints[?(@.name=="Controller")].port=30080'

Ex 2 - Substitua o armazenamento.

az sql mi-arc config replace --path custom/spec.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

Parâmetros Obrigatórios

--json-values -j

Uma lista de pares-chave-valor de caminhos json para valores: key1.subkey1=value1,key2.subkey2=value2. Pode fornecer valores json inline, tais como: key={"kind":"cluster","name":"test-cluster"} ou fornecer um caminho de ficheiro, como key=./values.json. O comando replace suporta condicionais através da biblioteca jsonpath. Para usar isso, comece seu caminho com um $. Isto permitirá que faça um condicional como -j $.key1.key2[?(@.key3=="someValue"].key4=value. Se o valor inline que estás a fornecer for um valor-chave, emparelha-se com = e , , por favor, evita esses caracteres. Por exemplo, key1=\"key2\=val2\,key3\=val3\". Você pode ver exemplos abaixo. Para ajuda adicional, veja: https://jsonpath.com/.

--path -p

Caminho para a especificação de recurso personalizada, ou custom/spec.jsonseja, .

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False