Compartilhar via

az sql mi-arc config

Note

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

Comandos de configuração.

Comandos

Nome Description Tipo Status
az sql mi-arc config add

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

 Extension GA
az sql mi-arc config init

Inicialize o CRD e os arquivos de especificação para uma instância gerenciada de SQL.

 Extension GA
az sql mi-arc config patch

Corrija um arquivo de configuração com base em um arquivo de patch json.

 Extension GA
az sql mi-arc config remove

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

 Extension GA
az sql mi-arc config replace

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

 Extension GA

az sql mi-arc config add

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

Adicione o valor no caminho json no arquivo de configuração. Todos os exemplos abaixo são dados no Bash. Se estiver usando outra linha de comando, talvez seja necessário escapar 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 Exigidos

--json-values -j

Uma lista de pares de valores de chave 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. O comando add não dá suporte a condicionales. Se o valor embutido que você está fornecendo for um par de valor de chave com = ele mesmo e , escape desses caracteres. Por exemplo: key1=\"key2\=val2\,key3\=val3\". Consulte http://jsonpatch.com/ para obter exemplos de como seu caminho deve ser. Se você quiser acessar uma matriz, deverá fazer isso indicando o índice, como key.0=value.

--path -p

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az sql mi-arc config init

Inicialize o CRD e os arquivos de especificação para uma instância gerenciada de SQL.

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

Exemplos

Inicialize o CRD e os arquivos de especificação para uma instância gerenciada de SQL.

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

Parâmetros Exigidos

--path -p

Um caminho em que a CRD e a especificação da instância gerenciada de SQL devem ser gravadas.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az sql mi-arc config patch

Corrija um arquivo de configuração com base em um arquivo de patch json.

Corrija o arquivo de configuração de acordo com o arquivo de patch especificado. Consulte http://jsonpatch.com/ uma melhor compreensão de como os caminhos devem ser compostos. A operação de substituição pode usar condicionalmente em seu caminho devido à biblioteca jsonpath https://jsonpath.com/. Todos os arquivos json de patch devem começar com uma chave patch que tenha uma matriz de patches com sua operação correspondente (adicionar, substituir, remover), caminho e valor. A remove operação não requer um valor, apenas um caminho. Confira 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 por um 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 – Substituir o armazenamento por um 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 Exigidos

--patch-file

Caminho para um arquivo json de patch baseado na biblioteca 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 exija uma condicional, use a notação jsonpath iniciando seu caminho por $. Isso permitirá que você faça um tipo condicional, como $.key1.key2[?(@.key3=="someValue"].key4. Veja os exemplos abaixo. Para obter ajuda adicional com condicionais, consulte: https://jsonpath.com/.

--path -p

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: 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 arquivo de configuração. Todos os exemplos abaixo são dados no Bash. Se estiver usando outra linha de comando, talvez seja necessário escapar 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 – Remover armazenamento.

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

Parâmetros Exigidos

--json-path -j

Uma lista de caminhos json com base na biblioteca jsonpatch que indica quais valores você gostaria de remover, como: key1.subkey1,key2.subkey2. O comando remove não dá suporte a condicionales. Consulte http://jsonpatch.com/ para obter exemplos de como seu caminho deve ser. Se você quiser acessar uma matriz, deverá fazer isso indicando o índice, como key.0=value.

--path -p

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az sql mi-arc config replace

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

Substitua o valor no caminho json no arquivo de configuração. Todos os exemplos abaixo são dados no Bash. Se estiver usando outra linha de comando, talvez seja necessário escapar 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 – Substituir armazenamento.

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

Parâmetros Exigidos

--json-values -j

Uma lista de pares de valores de chave 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. O comando replace dá suporte a condicionales por meio da biblioteca jsonpath. Para usar isso, inicie seu caminho com um $. Isso permitirá que você faça um tipo condicional, como -j $.key1.key2[?(@.key3=="someValue"].key4=value. Se o valor embutido que você está fornecendo for um par de valor de chave com = ele mesmo e , escape desses caracteres. Por exemplo, key1=\"key2\=val2\,key3\=val3\". Você pode ver exemplos abaixo. Para obter ajuda adicional, consulte: https://jsonpath.com/.

--path -p

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--acquire-policy-token

Adquirir um token Azure Policy automaticamente para essa operação de recurso.

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

A ID de referência de alteração relacionada para esta operação de recurso.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False