Databricks Workspace导入文件API：同名异语言文件触发已存在异常

现象说明 #

不少开发者都碰到过这个问题：Databricks API的overwrite参数并非万能的跨场景覆盖。当你要上传的Python笔记本和工作区里已有的同名文件（比如是SQL类型的test.py）语言属性不一致时，哪怕你设了overwrite=True，API还是会抛出RESOURCE_ALREADY_EXISTS错误——这是API的默认校验逻辑导致的，它不允许直接用不同语言的笔记本覆盖原有资源。

可行解决方案 #

• 先删后传：调用Workspace API的delete接口先移除目标路径的现有文件，再执行上传。记得处理删除时可能出现的文件不存在的情况，避免报错中断流程。
  示例Python代码（用requests实现）：

  import requests
  import base64
  
  # 配置Databricks地址和认证头
  databricks_url = "https://your-databricks-instance.cloud.databricks.com"
  auth_headers = {"Authorization": "Bearer YOUR_TOKEN"}
  
  # 第一步：删除现有文件
  delete_endpoint = f"{databricks_url}/api/2.0/workspace/delete"
  delete_data = {"path": "/Shared/Notebooks/test.py", "recursive": False}
  requests.post(delete_endpoint, headers=auth_headers, json=delete_data)
  
  # 第二步：上传新的Python笔记本
  upload_endpoint = f"{databricks_url}/api/2.0/workspace/import"
  with open("test.py", "rb") as f:
      content = base64.b64encode(f.read()).decode()
  upload_data = {
      "path": "/Shared/Notebooks/test.py",
      "format": "SOURCE",
      "language": "PYTHON",
      "overwrite": True,
      "content": content
  }
  response = requests.post(upload_endpoint, headers=auth_headers, json=upload_data)
  

• 用Databricks CLI替代API：CLI的workspace import命令自带的--overwrite参数可以直接处理跨语言覆盖，它内部已经封装了先删后传的逻辑，不用自己写额外代码。
  示例命令：

  databricks workspace import --language PYTHON --overwrite ./test.py /Shared/Notebooks/test.py
  

背后原因 #

Databricks Workspace API的overwrite参数只允许覆盖同类型同语言的资源，这是出于误操作防护的设计——防止开发者不小心把SQL笔记本换成Python，或者反过来。而CLI的--overwrite没有这个限制，是因为它采用了“删除再重建”的方式，绕过了API的类型校验。

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