Compartir a través de

az databricks workspace

  • Referencia

Nota:

Esta referencia forma parte de la extensión databricks para la CLI de Azure (versión 2.57.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az databricks workspace . Obtenga más información sobre las extensiones.

Comandos para administrar el área de trabajo de Databricks.

Comandos

Nombre Description Tipo Estado
az databricks workspace create

Cree un nuevo espacio de trabajo.

 Extensión GA
az databricks workspace delete

Eliminar el área de trabajo.

 Extensión GA
az databricks workspace list

Obtenga todas las áreas de trabajo.

 Extensión GA
az databricks workspace outbound-endpoint

Comandos para administrar puntos de conexión en el área de trabajo especificada.

 Extensión GA
az databricks workspace outbound-endpoint list

Enumere la lista de puntos de conexión que el área de trabajo insertada de red virtual llama al plano de control de Azure Databricks. Debe configurar el acceso saliente con estos puntos de conexión. Para obtener más información, vea https://docs.microsoft.com/en-us/azure/databricks/administration-guide/cloud-configurations/azure/udr.

 Extensión GA
az databricks workspace private-endpoint-connection

Comandos para administrar conexiones de punto de conexión privado del área de trabajo de Databricks.

 Extensión GA
az databricks workspace private-endpoint-connection create

Cree el estado de una conexión de punto de conexión privado con el nombre especificado.

 Extensión GA
az databricks workspace private-endpoint-connection delete

Elimine la conexión de punto de conexión privado con el nombre especificado.

 Extensión GA
az databricks workspace private-endpoint-connection list

Enumerar las conexiones de punto de conexión privado del área de trabajo.

 Extensión GA
az databricks workspace private-endpoint-connection show

Obtenga las propiedades de conexión de un punto de conexión privado para un área de trabajo.

 Extensión GA
az databricks workspace private-endpoint-connection update

Actualice el estado de una conexión de punto de conexión privado con el nombre especificado.

 Extensión GA
az databricks workspace private-endpoint-connection wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Extensión GA
az databricks workspace private-link-resource

Comandos para administrar recursos de vínculo privado del área de trabajo de Databricks.

 Extensión GA
az databricks workspace private-link-resource list

Enumera los recursos de vínculo privado de un área de trabajo determinada.

 Extensión GA
az databricks workspace private-link-resource show

Obtenga el recurso de vínculo privado especificado para el identificador de grupo especificado (subrecurso).

 Extensión GA
az databricks workspace show

Mostrar el área de trabajo.

 Extensión GA
az databricks workspace update

Actualice el área de trabajo.

 Extensión GA
az databricks workspace vnet-peering

Comandos para administrar el emparejamiento de vnet del área de trabajo de Databricks.

 Extensión GA
az databricks workspace vnet-peering create

Cree un emparejamiento de red virtual para un área de trabajo.

 Extensión GA
az databricks workspace vnet-peering delete

Elimine el emparejamiento de red virtual.

 Extensión GA
az databricks workspace vnet-peering list

Enumeración de emparejamientos de red virtual en un área de trabajo.

 Extensión GA
az databricks workspace vnet-peering show

Mostrar el emparejamiento de vnet.

 Extensión GA
az databricks workspace vnet-peering update

Actualice el emparejamiento de vnet.

 Extensión GA
az databricks workspace vnet-peering wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Extensión GA
az databricks workspace wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Extensión GA

az databricks workspace create

Cree un nuevo espacio de trabajo.

az databricks workspace create --name
                               --resource-group
                               [--access-connector]
                               [--default-catalog]
                               [--default-storage-firewall {Disabled, Enabled}]
                               [--disk-key-auto-rotation {0, 1, f, false, n, no, t, true, y, yes}]
                               [--disk-key-name]
                               [--disk-key-vault]
                               [--disk-key-version]
                               [--enable-no-public-ip {0, 1, f, false, n, no, t, true, y, yes}]
                               [--enhanced-security-compliance]
                               [--location]
                               [--managed-resource-group]
                               [--managed-services-key-name]
                               [--managed-services-key-vault]
                               [--managed-services-key-version]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--prepare-encryption {0, 1, f, false, n, no, t, true, y, yes}]
                               [--private-subnet]
                               [--public-network-access {Disabled, Enabled}]
                               [--public-subnet]
                               [--require-infrastructure-encryption {0, 1, f, false, n, no, t, true, y, yes}]
                               [--required-nsg-rules {AllRules, NoAzureDatabricksRules, NoAzureServiceRules}]
                               [--sku]
                               [--tags]
                               [--vnet]

Ejemplos

Creación de un área de trabajo

az databricks workspace create --resource-group MyResourceGroup --name MyWorkspace --location westus --sku standard

Creación de un área de trabajo con identidad administrada para la cuenta de almacenamiento

az databricks workspace create --resource-group MyResourceGroup --name MyWorkspace --location eastus2euap --sku premium --prepare-encryption

Parámetros requeridos

--name -n

El nombre del área de trabajo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--access-connector

Acceso al recurso del conector que se va a asociar con el área de trabajo de Databricks Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--default-catalog

Propiedades para la configuración predeterminada del catálogo durante la creación del área de trabajo. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--default-storage-firewall

Obtiene o establece la información de configuración del firewall de almacenamiento predeterminado.

Valores aceptados: Disabled, Enabled
--disk-key-auto-rotation

Indique si la versión de clave más reciente se debe usar automáticamente para Managed Disk Encryption.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--disk-key-name

Nombre de la clave KeyVault.

--disk-key-vault

Identificador URI de KeyVault.

--disk-key-version

Versión de la clave KeyVault.

--enable-no-public-ip

Marca para habilitar la característica sin dirección IP pública.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enhanced-security-compliance

Contiene la configuración relacionada con el complemento seguridad y cumplimiento mejorados. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>. Cuando no se especifique, se usará la ubicación del grupo de recursos.

--managed-resource-group

Grupo de recursos administrado que se va a crear. Puede ser un nombre o un identificador de recurso.

--managed-services-key-name --ms-key-name

Nombre de la clave KeyVault.

--managed-services-key-vault --ms-key-vault

Uri de KeyVault.

--managed-services-key-version --ms-key-version

Versión de la clave KeyVault.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--prepare-encryption

Marca para habilitar la identidad administrada para la cuenta de almacenamiento administrada para prepararse para el cifrado de CMK.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--private-subnet

Nombre de una subred privada dentro de la red virtual.

--public-network-access

Configuración que se va a establecer si se permite el acceso a la red desde la red pública de Internet a los puntos de conexión. Valores permitidos: Disabled, Enabled.

Valores aceptados: Disabled, Enabled
--public-subnet

Nombre de una subred pública dentro de la red virtual.

--require-infrastructure-encryption

Marca para habilitar el sistema de archivos raíz de DBFS con la capa secundaria de cifrado con claves administradas por la plataforma para los datos en reposo.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--required-nsg-rules

El tipo de regla Nsg solo para uso interno. Valores permitidos: AllRules, NoAzureDatabricksRules, NoAzureServiceRules.

Valores aceptados: AllRules, NoAzureDatabricksRules, NoAzureServiceRules
--sku

Nombre del nivel de SKU. Valores permitidos: premium, estándar y de prueba.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--vnet

Nombre de red virtual o identificador de recurso.

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 databricks workspace delete

Eliminar el área de trabajo.

az databricks workspace delete [--force-deletion {0, 1, f, false, n, no, t, true, y, yes}]
                               [--ids]
                               [--name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--resource-group]
                               [--subscription]
                               [--yes]

Ejemplos

Eliminar el área de trabajo

az databricks workspace delete --resource-group MyResourceGroup --name MyWorkspace -y

Parámetros opcionales

--force-deletion

Parámetro opcional para conservar los datos predeterminados del catálogo de Unity. De forma predeterminada, los datos se conservarán si Uc está habilitado en el área de trabajo.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

El nombre del área de trabajo.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

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

--yes -y

No solicita confirmación.

Valor predeterminado: False
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 databricks workspace list

Obtenga todas las áreas de trabajo.

az databricks workspace list [--max-items]
                             [--next-token]
                             [--resource-group]

Ejemplos

Enumeración de áreas de trabajo dentro de un grupo de recursos

az databricks workspace list --resource-group MyResourceGroup

Enumeración de áreas de trabajo dentro de la suscripción predeterminada

az databricks workspace list

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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 databricks workspace show

Mostrar el área de trabajo.

az databricks workspace show [--ids]
                             [--name]
                             [--resource-group]
                             [--subscription]

Ejemplos

Mostrar el área de trabajo

az databricks workspace show --resource-group MyResourceGroup --name MyWorkspace

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

El nombre del área de trabajo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

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

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 databricks workspace update

Actualice el área de trabajo.

az databricks workspace update [--access-connector]
                               [--add]
                               [--default-catalog]
                               [--default-storage-firewall {Disabled, Enabled}]
                               [--disk-key-auto-rotation {0, 1, f, false, n, no, t, true, y, yes}]
                               [--disk-key-name]
                               [--disk-key-vault]
                               [--disk-key-version]
                               [--enable-no-public-ip {0, 1, f, false, n, no, t, true, y, yes}]
                               [--enhanced-security-compliance]
                               [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                               [--ids]
                               [--key-name]
                               [--key-source {Default, Microsoft.Keyvault}]
                               [--key-vault]
                               [--key-version]
                               [--managed-services-key-name]
                               [--managed-services-key-vault]
                               [--managed-services-key-version]
                               [--name]
                               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                               [--prepare-encryption {0, 1, f, false, n, no, t, true, y, yes}]
                               [--public-network-access {Disabled, Enabled}]
                               [--remove]
                               [--required-nsg-rules {AllRules, NoAzureDatabricksRules, NoAzureServiceRules}]
                               [--resource-group]
                               [--sa-sku-name]
                               [--set]
                               [--sku]
                               [--subscription]
                               [--tags]

Ejemplos

Actualice las etiquetas del área de trabajo.

az databricks workspace update --resource-group MyResourceGroup --name MyWorkspace --tags key1=value1 key2=value2

Limpie las etiquetas del área de trabajo.

az databricks workspace update --resource-group MyResourceGroup --name MyWorkspace --tags ""

Prepárese para el cifrado cmK mediante la asignación de identidades para la cuenta de almacenamiento.

az databricks workspace update --resource-group MyResourceGroup --name MyWorkspace --prepare-encryption

Configuración del cifrado de CMK

az databricks workspace update --resource-group MyResourceGroup --name MyWorkspace --key-source Microsoft.KeyVault --key-name MyKey --key-vault https://myKeyVault.vault.azure.net/ --key-version 00000000000000000000000000000000

Revertir el cifrado a claves administradas de Microsoft

az databricks workspace update --resource-group MyResourceGroup --name MyWorkspace --key-source Default

Parámetros opcionales

--access-connector

Acceso al recurso del conector que se va a asociar con el área de trabajo de Databricks Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string o JSON string>.

--default-catalog

Propiedades para la configuración predeterminada del catálogo durante la creación del área de trabajo. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--default-storage-firewall

Obtiene o establece la información de configuración del firewall de almacenamiento predeterminado.

Valores aceptados: Disabled, Enabled
--disk-key-auto-rotation

Indique si la versión de clave más reciente se debe usar automáticamente para Managed Disk Encryption.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--disk-key-name

Nombre de la clave KeyVault.

--disk-key-vault

Identificador URI de KeyVault.

--disk-key-version

Versión de la clave KeyVault.

--enable-no-public-ip

Marca para habilitar la característica sin dirección IP pública.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enhanced-security-compliance

Contiene la configuración relacionada con el complemento seguridad y cumplimiento mejorados. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--key-name

Nombre de la clave KeyVault.

--key-source

El origen de la clave de cifrado (proveedor). Valores permitidos: Valor predeterminado, Microsoft.Keyvault.

Valores aceptados: Default, Microsoft.Keyvault
--key-vault

Uri de KeyVault.

--key-version

Versión de la clave KeyVault. Es opcional al actualizar CMK.

--managed-services-key-name --ms-key-name

Nombre de la clave KeyVault.

--managed-services-key-vault --ms-key-vault

Uri de KeyVault.

--managed-services-key-version --ms-key-version

Versión de la clave KeyVault.

--name -n

El nombre del área de trabajo.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--prepare-encryption

Marca para habilitar la identidad administrada para la cuenta de almacenamiento administrada para prepararse para el cifrado de CMK.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--public-network-access

Tipo de acceso de red para acceder al área de trabajo. Establezca el valor en deshabilitado para acceder al área de trabajo solo a través de private link.

Valores aceptados: Disabled, Enabled
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list OR --remove propertyToRemove.

--required-nsg-rules

El tipo de regla Nsg solo para uso interno. Valores permitidos: AllRules, NoAzureDatabricksRules, NoAzureServiceRules.

Valores aceptados: AllRules, NoAzureDatabricksRules, NoAzureServiceRules
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sa-sku-name --storage-account-sku-name

Nombre de la SKU de la cuenta de almacenamiento, por ejemplo: Standard_GRS, Standard_LRS. Consulte https://aka.ms/storageskus las entradas válidas.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=.

--sku

Nombre del nivel de SKU. Valores permitidos: premium, estándar y de prueba.

--subscription

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

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

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 databricks workspace wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

az databricks workspace wait [--created]
                             [--custom]
                             [--deleted]
                             [--exists]
                             [--ids]
                             [--interval]
                             [--name]
                             [--resource-group]
                             [--subscription]
                             [--timeout]
                             [--updated]

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--name -n

El nombre del área de trabajo.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

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

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
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.