使用Databricks CLI复制本地文件夹至DBFS时目录结构丢失问题排查

错误根源 #

1. Windows路径格式错误：你使用的本地路径'C:myname/work/animal/'缺少盘符后的反斜杠，正确的Windows路径应为C:\myname\work\animal（或正斜杠格式C:/myname/work/animal）。这种路径解析错误会导致Databricks CLI无法正确识别sea子目录的层级结构，进而出现文件平级放置的异常。
2. 路径末尾斜杠的影响：本地文件夹末尾的斜杠与目标路径的组合逻辑在CLI中会影响目录复制的结构，错误的斜杠使用可能破坏子目录的层级保留。

修正命令 #

根据你要在dbfs:/earth/organism下保留land和sea子目录的需求，分两种场景处理：

场景1：目标路径dbfs:/earth/organism已存在 #

直接将animal目录下的所有子目录和文件复制到organism目录下，命令如下：

databricks fs cp -r "C:\myname\work\animal" dbfs:/earth/organism

场景2：目标路径dbfs:/earth/organism不存在，或需要在organism下创建animal父目录 #

如果希望dbfs:/earth/organism/animal下保留land和sea，使用以下命令：

databricks fs cp -r "C:\myname\work\animal" dbfs:/earth/organism/animal

额外注意事项 #

• Windows路径建议用双引号包裹，避免路径中存在空格或特殊字符时出现解析错误；
• 确保你的Databricks CLI是最新版本，旧版本可能存在递归复制的逻辑bug；
• 复制完成后可执行databricks fs ls dbfs:/earth/organism验证目录结构是否符合预期。

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