Share via

az sql mi-arc config

  • Referencia

Nota:

Esta referencia forma parte de la extensión arcdata para la CLI de Azure (versión 2.3.1 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az sql mi-arc config . Obtenga más información sobre las extensiones.

Comandos de configuración.

Comandos

Nombre Description Tipo Estado
az sql mi-arc config add

Agrega un valor a una ruta de acceso json en un archivo de configuración.

 Extensión GA
az sql mi-arc config init

Inicializa los archivos CRD y de especificación de una instancia administrada de SQL.

 Extensión GA
az sql mi-arc config patch

Aplica una revisión a un archivo de configuración basándose en un archivo de revisión JSON.

 Extensión GA
az sql mi-arc config remove

Quita un valor de una ruta de acceso json en un archivo de configuración.

 Extensión GA
az sql mi-arc config replace

Reemplaza un valor de una ruta de acceso json en un archivo de configuración.

 Extensión GA

az sql mi-arc config add

Agrega un valor a una ruta de acceso json en un archivo de configuración.

Agrega el valor a la ruta de acceso JSON del archivo de configuración. Todos los ejemplos siguientes se proporcionan en Bash. Si usa otra línea de comandos, puede que necesite añadir caracteres de escape a las comillas según corresponda. Como alternativa, puede usar la función del archivo de revisión.

az sql mi-arc config add --json-values
                         --path

Ejemplos

Ejemplo 1: Adición de almacenamiento.

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

Parámetros requeridos

--json-values -j

Lista de pares clave-valor de rutas de acceso json a valores: key1.subkey1=value1,key2.subkey2=value2. Puede proporcionar valores JSON insertados como: key='{"kind":"cluster","name":"test-cluster"}' o proporcionar una ruta de acceso de archivo, como key=./values.json. El comando add NO admite condicionales. Si el valor insertado que va a proporcionar es un par clave-valor con = y , escape esos caracteres. Por ejemplo: key1=\"key2\=val2\,key3\=val3\". Vea ejemplos de la apariencia de la ruta en http://jsonpatch.com/. Si desea acceder a una matriz, debe hacerlo indicando el índice, como key.0=value.

--path -p

Ruta de acceso a la especificación de recursos personalizada, es decir, custom/spec.json.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sql mi-arc config init

Inicializa los archivos CRD y de especificación de una instancia administrada de SQL.

az sql mi-arc config init --path

Ejemplos

Inicializa los archivos CRD y de especificación de una instancia administrada de SQL.

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

Parámetros requeridos

--path -p

Ruta de acceso donde se deben escribir los archivos CRD y de especificación de la instancia administrada de SQL.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sql mi-arc config patch

Aplica una revisión a un archivo de configuración basándose en un archivo de revisión JSON.

Aplica una revisión en el archivo de configuración según el archivo de revisión especificado. Para obtener más información sobre cómo se deben componer las rutas de acceso, consulte http://jsonpatch.com/. La operación de reemplazar puede usar declaraciones condicionales en la ruta debido a la biblioteca jsonpath https://jsonpath.com/. Todos los archivos JSON de revisión tienen que iniciarse con una clave de patch, que tiene una matriz de revisiones con la operación (add [agregar], replace [reemplazar], remove [quitar]), ruta y valor correspondientes. La operación remove (quitar) no necesita un valor, solo una ruta de acceso. Consulte los ejemplos más abajo.

az sql mi-arc config patch --patch-file
                           --path

Ejemplos

Ejemplo 1: Reemplazo del puerto de un único punto de conexión por un archivo de revisión.

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

Ejemplo 2: Reemplazo del almacenamiento por un archivo de revisión.

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 requeridos

--patch-file

Ruta a un archivo json de revisión basado en la biblioteca jsonpatch: http://jsonpatch.com/. Debe iniciar el archivo JSON de revisión con una clave denominada patch, cuyo valor es una matriz de operaciones de revisión que pretende realizar. Para la ruta de acceso de una operación de revisión, puede usar la notación de puntos, como key1.key2 para la mayoría de las operaciones. Si no quiere realizar una operación de reemplazo y va a reemplazar un valor en una matriz que necesita una condicional, use la notación jsonpath (para hacerlo, agregue un signo de $ al principio de la ruta de acceso). Esto le permitirá realizar un condicional como $.key1.key2[?(@.key3=="someValue"].key4. Consulte los ejemplos siguientes. Para obtener ayuda adicional con los condicionales, consulte: https://jsonpath.com/.

--path -p

Ruta de acceso a la especificación de recursos personalizada, es decir, custom/spec.json.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sql mi-arc config remove

Quita un valor de una ruta de acceso json en un archivo de configuración.

Quita el valor de la ruta de acceso JSON del archivo de configuración. Todos los ejemplos siguientes se proporcionan en Bash. Si usa otra línea de comandos, puede que necesite añadir caracteres de escape a las comillas según corresponda. Como alternativa, puede usar la función del archivo de revisión.

az sql mi-arc config remove --json-path
                            --path

Ejemplos

Ejemplo 1: Eliminación de almacenamiento.

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

Parámetros requeridos

--json-path -j

Lista de rutas JSON basadas en la biblioteca jsonpatch que indica qué valores quiere quitar, por ejemplo: key1.subkey1,key2.subkey2. El comando "remove" NO admite condicionales. Vea ejemplos de la apariencia de la ruta en http://jsonpatch.com/. Si desea acceder a una matriz, debe hacerlo indicando el índice, como key.0=value.

--path -p

Ruta de acceso a la especificación de recursos personalizada, es decir, custom/spec.json.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az sql mi-arc config replace

Reemplaza un valor de una ruta de acceso json en un archivo de configuración.

Reemplaza el valor en la ruta de acceso json del archivo de configuración. Todos los ejemplos siguientes se proporcionan en Bash. Si usa otra línea de comandos, puede que necesite añadir caracteres de escape a las comillas según corresponda. Como alternativa, puede usar la función del archivo de revisión.

az sql mi-arc config replace --json-values
                             --path

Ejemplos

Ejemplo 1: Reemplazo del puerto de un único punto de conexión.

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

Ejemplo 2: Reemplazo del almacenamiento.

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

Parámetros requeridos

--json-values -j

Lista de pares clave-valor de rutas de acceso json a valores: key1.subkey1=value1,key2.subkey2=value2. Puede proporcionar valores JSON insertados como: key={"kind":"cluster","name":"test-cluster"} o proporcionar una ruta de acceso de archivo, como key=./values.json. El comando replace admite condicionales mediante la biblioteca jsonpath. Para usar esto, inicie la ruta con un signo de $. Esto le permitirá realizar un condicional como -j $.key1.key2[?(@.key3=="someValue"].key4=value. Si el valor insertado que va a proporcionar es un par clave-valor con = y , escape esos caracteres. Por ejemplo, key1=\"key2\=val2\,key3\=val3\". A continuación, se muestran algunos ejemplos. Para obtener ayuda adicional, consulte: https://jsonpath.com/.

--path -p

Ruta de acceso a la especificación de recursos personalizada, es decir, custom/spec.json.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.