使用Databricks CLI绑定存储凭证至工作区时遇错误的技术问询

问题复盘 #

将Databricks元存储隔离模式设为ISOLATED后，执行CLI绑定存储凭证命令时遇到两个矛盾错误：

• 不指定binding_type时，报错：Error: Supported binding types for STORAGE_CREDENTIAL are BINDING_TYPE_READ_WRITE
• 指定--binding-type BINDING_TYPE_READ_WRITE后，报错：Error: assigned workspace 0 does not exist or is not assigned the same metastore as the current workspace
• UI手动绑定后，执行同一移除绑定命令可成功。

解决方案 #

1. 修正工作区ID参数 #

第二个错误的核心原因是命令中使用了无效的工作区ID（比如误填的0）：

• 从Databricks UI的URL获取实际工作区ID：URL格式为https://<workspace-domain>/o/<workspace-id>/，提取<workspace-id>部分
• 确保目标工作区已关联当前操作的元存储（可在元存储管理页面的"工作区"标签页确认）

2. 显式指定绑定类型并使用正确参数 #

尽管官方文档未提及强制要求，但在ISOLATED模式下，CLI需要显式声明绑定类型。使用以下正确格式的命令：

databricks storage-credentials bind \
  --name <你的存储凭证名称> \
  --workspace-id <实际工作区ID> \
  --binding-type BINDING_TYPE_READ_WRITE

3. 验证CLI上下文与权限 #

• 检查CLI当前连接的工作区/元存储是否正确：

  # 查看当前CLI配置的工作区
  databricks workspace get-status
  # 查看当前元存储信息
  databricks metastore get
  

• 确保执行命令的账号拥有METASTORE ADMIN或STORAGE CREDENTIAL ADMIN权限，权限不足可能导致错误提示失真

4. 升级Databricks CLI版本 #

旧版本CLI对ISOLATED模式的参数处理可能存在bug，升级到最新版本：

pip install --upgrade databricks-cli

内容的提问来源于stack exchange，提问作者tt_921