你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
az databricks workspace
注意
此参考是 Azure CLI（版本 2.45.0 或更高版本）的 databricks 扩展的一部分。 该扩展将在首次运行 az databricks workspace 命令时自动安装。 详细了解扩展。
用于管理 databricks 工作区的命令。
命令
az databricks workspace create
创建新工作区。
az databricks workspace create --name
--resource-group
[--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}]
[--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]示例
创建工作区
az databricks workspace create --resource-group MyResourceGroup --name MyWorkspace --location westus --sku standard为存储帐户创建具有托管标识的工作区
az databricks workspace create --resource-group MyResourceGroup --name MyWorkspace --location eastus2euap --sku premium --prepare-encryption必需参数
工作区的名称。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
可选参数
指示是否应自动将最新的密钥版本用于托管磁盘加密。
KeyVault 密钥的名称。
KeyVault 的 URI。
KeyVault 密钥的版本。
用于启用无公共 IP 功能的标志。
Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。 如果未指定，将使用资源组的位置。
要创建的托管资源组。 它可以是名称或资源 ID。
KeyVault 密钥的名称。
KeyVault 的 URI。
KeyVault 密钥的版本。
不等待长时间运行的操作完成。
为托管存储帐户启用托管标识以准备 CMK 加密的标志。
虚拟网络中的专用子网的名称。
用于设置是否允许从公共 Internet 访问终结点的网络访问的配置。 允许的值：已禁用、已启用。
虚拟网络中的公共子网的名称。
使用平台托管密钥为静态数据启用具有辅助加密层的 DBFS 根文件系统的标志。
仅供内部使用的 Nsg 规则的类型。 允许的值：AllRules、NoAzureDatabricksRules、NoAzureServiceRules。
SKU 层名称。 允许的值：高级、标准、试用。
空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
虚拟网络名称或资源 ID。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az databricks workspace delete
删除工作区。
az databricks workspace delete [--ids]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]示例
删除工作区
az databricks workspace delete --resource-group MyResourceGroup --name MyWorkspace -y可选参数
一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
工作区的名称。
不等待长时间运行的操作完成。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
不提示确认。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az databricks workspace list
获取所有工作区。
az databricks workspace list [--resource-group]示例
列出资源组中的工作区
az databricks workspace list --resource-group MyResourceGroup列出默认订阅中的工作区
az databricks workspace list可选参数
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az databricks workspace show
显示工作区。
az databricks workspace show [--ids]
[--name]
[--resource-group]
[--subscription]示例
显示工作区
az databricks workspace show --resource-group MyResourceGroup --name MyWorkspace可选参数
一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
工作区的名称。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az databricks workspace update
更新工作区。
az databricks workspace update [--add]
[--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}]
[--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]示例
更新工作区的标记。
az databricks workspace update --resource-group MyResourceGroup --name MyWorkspace --tags key1=value1 key2=value2清理工作区的标记。
az databricks workspace update --resource-group MyResourceGroup --name MyWorkspace --tags ""通过为存储帐户分配标识来准备 CMK 加密。
az databricks workspace update --resource-group MyResourceGroup --name MyWorkspace --prepare-encryption配置 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将加密还原到 Microsoft 托管密钥
az databricks workspace update --resource-group MyResourceGroup --name MyWorkspace --key-source Default可选参数
通过指定路径和键值对将对象添加到对象列表。 示例：--add property.listProperty <key=value、string 或 JSON 字符串>。
指示是否应自动将最新的密钥版本用于托管磁盘加密。
KeyVault 密钥的名称。
KeyVault 的 URI。
KeyVault 密钥的版本。
用于启用无公共 IP 功能的标志。
使用“set”或“add”时，保留字符串文本，而不是尝试转换为 JSON。
一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
KeyVault 密钥的名称。
加密密钥源（提供程序）。 允许的值：默认值、Microsoft.Keyvault。
KeyVault 的 URI。
KeyVault 密钥的版本。 更新 CMK 时，这是可选的。
KeyVault 密钥的名称。
KeyVault 的 URI。
KeyVault 密钥的版本。
工作区的名称。
不等待长时间运行的操作完成。
为托管存储帐户启用托管标识以准备 CMK 加密的标志。
用于访问工作区的网络访问类型。 将值设置为禁用，以便仅通过专用链接访问工作区。
从列表中删除属性或元素。 示例：--remove property.list OR --remove propertyToRemove。
仅供内部使用的 Nsg 规则的类型。 允许的值：AllRules、NoAzureDatabricksRules、NoAzureServiceRules。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
存储帐户 SKU 名称，例如：Standard_GRS，Standard_LRS。 请参阅 https://aka.ms/storageskus 有效的输入。
通过指定要设置的属性路径和值来更新对象。 示例：--set property1.property2=。
SKU 层名称。 允许的值：高级、标准、试用。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
az databricks workspace wait
将 CLI 置于等待状态，直到满足条件。
az databricks workspace wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]可选参数
等待在“Succeeded”中使用“provisioningState”创建。
等待条件满足自定义 JMESPath 查询。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。
等到删除为止。
等待资源存在。
一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。
轮询间隔（以秒为单位）。
工作区的名称。
资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
最大等待（以秒为单位）。
等到 provisioningState 更新为“Succeeded”。
全局参数
提高日志记录详细程度以显示所有调试日志。
显示此帮助消息并退出。
只显示错误，取消显示警告。
输出格式。
JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
提高日志记录详细程度。 使用 --debug 获取完整的调试日志。
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈