azdata bdc config
Se aplica a: 
CLI de datos de Azure (azdata)
En el siguiente artículo se proporciona una referencia de los comandos sql de la herramienta azdata. Para obtener más información sobre otros comandos de azdata, vea la Referencia de azdata.
Comandos
| Command | Descripción |
|---|---|
| azdata bdc config init | Inicializa un perfil de configuración de clúster de macrodatos que puede usarse con la creación de clústeres de macrodatos. |
| azdata bdc config list | Muestra una lista de opciones de perfil de configuración disponibles. |
| azdata bdc config show | Muestra la configuración actual de BDC o la configuración de un archivo local que especifique (por ejemplo, custom/bdc.json). |
| azdata bdc config add | Agrega un valor a una ruta de acceso json en un archivo de configuración. |
| azdata bdc config remove | Quita un valor de una ruta de acceso json en un archivo de configuración. |
| azdata bdc config replace | Reemplaza un valor de una ruta de acceso json en un archivo de configuración. |
| azdata bdc config patch | Aplica una revisión en un archivo de configuración basándose en un archivo de revisión json. |
azdata bdc config init
Inicializa un perfil de configuración de clúster de macrodatos que puede usarse con la creación de clústeres de macrodatos. El origen concreto del perfil de configuración se puede especificar en los argumentos.
azdata bdc config init [--path -p]
[--source -s]
[--force -f]
[--accept-eula -a]
Ejemplos
Experiencia de inicialización de configuración de BDC guiada: se le solicitarán los valores necesarios.
azdata bdc config init
Inicialización de configuración de BDC con argumentos, se crea un perfil de configuración de aks-dev-test en ./custom.
azdata bdc config init --source aks-dev-test --target custom
Parámetros opcionales
--path -p
Ruta de acceso de archivo donde quiere colocar el perfil de configuración (se usa <cwd>/custom de manera predeterminada).
--source -s
Origen del perfil de configuración: ['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
Obliga a sobrescribir el archivo de destino.
--accept-eula -a
¿Acepta los términos de licencia? [sí/no]. Si no quiere usar este argumento, puede establecer la variable de entorno ACCEPT_EULA en “yes”. Los términos de licencia de este producto se pueden ver en https://aka.ms/eula-azdata-en.
Argumentos 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.
--output -o
Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query -q
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
--verbose
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
azdata bdc config list
Muestra una lista de las opciones disponibles del perfil de configuración para su uso en bdc config init.
azdata bdc config list [--config-profile -c]
[--type -t]
[--accept-eula -a]
Ejemplos
Muestra todos los nombres disponibles del perfil de configuración.
azdata bdc config list
Muestra código json de un perfil de configuración específico.
azdata bdc config list --config-profile aks-dev-test
Parámetros opcionales
--config-profile -c
Perfil de configuración predeterminado: ['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
El tipo de configuración que quiere ver.
--accept-eula -a
¿Acepta los términos de licencia? [sí/no]. Si no quiere usar este argumento, puede establecer la variable de entorno ACCEPT_EULA en “yes”. Los términos de licencia de este producto se pueden ver en https://aka.ms/eula-azdata-en.
Argumentos 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.
--output -o
Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query -q
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
--verbose
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
azdata bdc config show
Muestra la configuración actual de BDC o la configuración de un archivo local que especifique (por ejemplo, custom/bdc.json). El comando también puede admitir una ruta de acceso json si quiere obtener únicamente una sección. También puede especificar un archivo de destino donde quiera enviar el resultado. Si no se especifica un archivo de destino, el resultado se mostrará en el terminal.
azdata bdc config show [--config-file -c]
[--target -t]
[--json-path -j]
[--force -f]
Ejemplos
Mostrar la configuración de BDC en la consola
azdata bdc config show
En un archivo de configuración local, obtiene un valor al final de una ruta de clave json sencilla.
azdata bdc config show --config-file custom-config/bdc.json --json-path "metadata.name" --target section.json
En un archivo de configuración local, obtiene los recursos de un servicio.
azdata bdc config show --config-file custom-config/bdc.json --json-path "$.spec.services.sql.resources" --target section.json
Parámetros opcionales
--config-file -c
Ruta de acceso del archivo de configuración del clúster de macrodatos, si no se quiere usar la configuración del clúster donde se ha iniciado sesión actualmente, por ejemplo, custom/bdc.json.
--target -t
Archivo de salida donde se almacenará el resultado. Predeterminado: se dirige a StdOut.
--json-path -j
La ruta de la clave json que lleva a la sección o valor y que quiere obtener de la configuración (por ejemplo, “clave1.clave2.clave3”). Usa el lenguaje de consulta de ruta de acceso json (https://jsonpath.com/), por ejemplo:-j '$.spec.pools[?(@.spec.type == "Master")]..endpoints'
--force -f
Obliga a sobrescribir el archivo de destino.
Argumentos 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.
--output -o
Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query -q
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
--verbose
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
azdata bdc config add
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, tenga en cuenta que puede que necesite escapar las comillas según corresponda. Como alternativa, puede usar la función del archivo de revisión.
azdata bdc config add --path -p
--json-values -j
Ejemplos
Ejemplo 1: agregar almacenamiento de plano de control.
azdata bdc config add --path custom/control.json --json-values "spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}"
Parámetros obligatorios
--path -p
Ruta de acceso del archivo de configuración del clúster de macrodatos de la configuración que quiere establecer (por ejemplo, custom/bdc.json)
--json-values -j
Lista de pares de clave y valor de rutas json a valores: clave1.subclave1=valor1,clave2.subclave2=valor2. Puede proporcionar valores json insertados (como key='{"kind":"cluster","name":"test-cluster"}'), o bien puede especificar una ruta de archivo (por ejemplo, clave=./valores.json). La adición no admite condicionales. Si el valor en línea facilitado es en sí mismo un par clave-valor con "=" y ",", debe escapar esos caracteres. Por ejemplo, key1="key2=val2,key3=val3". Vea ejemplos de la apariencia de la ruta en http://jsonpatch.com/. Para acceder a una matriz, necesita indicar del índice (por ejemplo, clave.0=valor).
Argumentos 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.
--output -o
Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query -q
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
--verbose
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
azdata bdc config remove
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, tenga en cuenta que puede que necesite escapar las comillas según corresponda. Como alternativa, puede usar la función del archivo de revisión.
azdata bdc config remove --path -p
--json-path -j
Ejemplos
Ejemplo 1: quitar almacenamiento de plano de control.
azdata bdc config remove --path custom/control.json --json-path ".spec.storage"
Parámetros obligatorios
--path -p
Ruta de acceso del archivo de configuración del clúster de macrodatos de la configuración que quiere establecer (por ejemplo, custom/bdc.json)
--json-path -j
Lista de rutas json basadas en la biblioteca jsonpatch que indica qué valores quiere quitar (por ejemplo, “clave1.subclave1,clave2.subclave2”). La eliminación no admite el uso de condicionales. Vea ejemplos de la apariencia de la ruta en http://jsonpatch.com/. Para acceder a una matriz, necesita indicar del índice (por ejemplo, clave.0=valor).
Argumentos 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.
--output -o
Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query -q
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
--verbose
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
azdata bdc config replace
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, tenga en cuenta que puede que necesite escapar las comillas según corresponda. Como alternativa, puede usar la función del archivo de revisión.
azdata bdc config replace --path -p
--json-values -j
Ejemplos
Ejemplo 1: reemplazar el puerto de un único punto de conexión (punto de conexión del controlador).
azdata bdc config replace --path custom/control.json --json-values "$.spec.endpoints[?(@.name=="Controller")].port=30080"
Ejemplo 2: reemplazar el almacenamiento de plano de control.
azdata bdc config replace --path custom/control.json --json-values "spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}"
Ejemplo 3: reemplazar la especificación de recurso storage-0, réplicas incluidas.
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 obligatorios
--path -p
Ruta de acceso del archivo de configuración del clúster de macrodatos de la configuración que quiere establecer (por ejemplo, custom/bdc.json)
--json-values -j
Lista de pares de clave y valor de rutas json a valores: clave1.subclave1=valor1,clave2.subclave2=valor2. Puede proporcionar valores json insertados (como key='{"kind":"cluster","name":"test-cluster"}'), o bien puede especificar una ruta de archivo (por ejemplo, clave=./valores.json). El comando para reemplazar admite condicionales mediante la biblioteca jsonpath. Para usar esto, inicie la ruta con un signo de $. Esto permite agregar una declaración condicional, como as -j $.key1.key2[?(@.key3=='someValue'].key4=value. Si el valor en línea facilitado es en sí mismo un par clave-valor con "=" y ",", debe escapar esos caracteres. Por ejemplo, key1="key2=val2,key3=val3". A continuación, se muestran algunos ejemplos. Para obtener ayuda, vea: https://jsonpath.com/
Argumentos 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.
--output -o
Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query -q
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
--verbose
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
azdata bdc config patch
Aplica una revisión en el archivo de configuración según el archivo de revisión especificado. Para obtener información sobre cómo crear las rutas, vea 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 correspondiente operación (add [agregar], replace [reemplazar], remove [quitar]), ruta y valor. La operación “remove” (quitar) no necesita un valor, solo una ruta de acceso. A continuación, se muestran algunos ejemplos.
azdata bdc config patch --path
--patch-file -p
Ejemplos
Ejemplo 1: reemplazar el puerto de un único punto de conexión (punto de conexión del controlador) con un archivo de revisión.
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}]}
Ejemplo 2: reemplazar el almacenamiento de plano de control con un archivo de revisión.
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"}}]}
Ejemplo 3: reemplazar el almacenamiento de grupos, incluidas las réplicas (grupo de almacenamiento) con un archivo de revisión.
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 obligatorios
--path
Ruta de acceso del archivo de configuración del clúster de macrodatos de la configuración que quiere establecer (por ejemplo, custom/bdc.json)
--patch-file -p
Ruta a un archivo json de revisión basado en la biblioteca jsonpatch: http://jsonpatch.com/. Tiene que empezar el archivo json de revisión con una clave denominada “patch”, cuyo valor es una matriz de operaciones de revisión que quiere realizar. Para la ruta de una operación de revisión, puede usar la notación de puntos (como clave1.clave2) 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 permite agregar una declaración condicional, como $.key1.key2[?(@.key3=='someValue'].key4. A continuación, se muestran algunos ejemplos. Para obtener más información sobre las declaraciones condicionales, vea: https://jsonpath.com/.
Argumentos 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.
--output -o
Formato de salida. Valores permitidos: json, jsonc, table y tsv. Valor predeterminado: json.
--query -q
Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.
--verbose
Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.
Pasos siguientes
Para obtener más información sobre otros comandos de azdata, vea Referencia de azdata.
Para más información sobre cómo instalar la herramienta azdata, consulte Instalación de azdata.