如何配置Azure Synapse与GitHub集成以保留Notebook文件夹结构

调整GitHub集成的路径映射设置 #

• 进入Synapse Studio，点击右上角「管理」→ 选择「GitHub集成」→ 编辑当前的集成配置。
• 在「发布设置」区域，确认工作区文件夹与GitHub仓库路径的映射规则：不要将Synapse的/Notebooks直接映射为GitHub仓库的repo_name/notebook（这种单路径映射会扁平化结构），而是保持工作区的/Notebooks对应GitHub仓库的/notebook目录，让Synapse自动同步子文件夹层级。
  • 注意：Synapse和GitHub的路径大小写敏感，确保两边的目录名称大小写一致（比如都是notebook或Notebooks）。

验证Synapse中Notebook的文件夹结构有效性 #

• 在Synapse Studio的「开发」面板中，右键点击Notebooks目录下的Dev1/Dev2文件夹，查看「属性」，确认其路径是/Notebooks/Dev1、/Notebooks/Dev2这类原生工作区子目录，而非手动上传文件时生成的虚拟目录。只有原生工作区文件夹才能被GitHub集成识别并同步层级结构。

重新发布并验证结果 #

• 完成配置调整后，点击Synapse Studio右上角的「发布」按钮，选择发布到目标GitHub仓库。
• 发布完成后，登录GitHub仓库检查notebook目录下是否出现Dev1、Dev2子文件夹，对应的notebook文件是否存放在各自子目录中。

额外排查点 #

• 若GitHub仓库中已有平级的notebook文件（比如之前发布的notebook1直接在notebook目录下），先删除这些文件再重新发布，避免因文件冲突导致文件夹结构同步失败。
• 确认Synapse集成使用的GitHub账号拥有仓库的写入权限，权限不足会导致无法创建子文件夹。

内容的提问来源于stack exchange，提问作者G. Young