Databricks作业无法访问GitHub仓库Notebook：权限排查求助

云上老周

2026-6-29

Databricks作业访问GitHub源Notebook权限问题排查

run failed with error message Unable to access the notebook "databricks/notebooks/loaders/pubsub_streaming". Either it does not exist, or the identity used to run this job, sumit.desai@abc.com (sumit.desai@abc.com), lacks the required permissions.

结合你手动导入仓库可正常运行的情况，问题核心集中在作业运行身份的权限缺失上，以下是需要排查的必要权限项：

GitHub仓库读取权限：作业运行身份sumit.desai@abc.com需要拥有目标GitHub仓库的只读访问权限。手动运行时你可能用了个人GitHub凭证，但作业上下文可能未同步该用户的GitHub授权。需确认该用户已被添加为GitHub仓库协作者，或仓库为公开状态且作业能正常访问公开仓库资源。
Databricks Repos权限：在Databricks工作区中，sumit.desai@abc.com需要对关联的GitHub仓库拥有读取权限。进入Databricks的Repos页面，找到对应仓库，检查权限设置，确保该用户至少拥有Read权限。
单用户集群访问权限：启用单用户访问的集群需确保：集群的单用户配置指向sumit.desai@abc.com，且该用户拥有启动集群的权限。若集群由其他用户创建，需集群所有者为该用户分配Can Attach To权限，保证作业能以该用户身份启动集群并访问资源。
Notebook路径与配置一致性：确认作业中配置的Notebook路径与GitHub仓库内的实际路径完全匹配（注意GitHub路径大小写敏感），同时作业需配置为直接引用GitHub仓库中的Notebook，而非本地导入的副本。