在Databricks UCX迁移中运行sync-workspace-info报错求助

排查步骤 #

• 检查UCX版本兼容性：执行databricks labs ucx version查看当前版本，旧版本可能存在已知bug，建议升级到最新稳定版：databricks labs install ucx --upgrade
• 验证权限覆盖：即使是Account Administrator，也需确认同时拥有目标工作区的Workspace Admin权限，UCX部分同步逻辑需要双权限支撑
• 确认配置文件有效性：检查.databrickscfg中指定的profile是否对应正确的账户/工作区，可通过databricks workspace list --profile <你的profile名称>验证连接是否正常
• 获取详细错误日志：添加--debug参数重新执行命令，捕捉完整错误栈：databricks labs ucx sync-workspace-info --debug，日志会暴露具体的API调用失败原因或权限缺失项
• 排查网络限制：确认企业防火墙、代理是否阻止了UCX调用Databricks的Account/Workspace级API端点，可尝试在无限制的网络环境下复现操作

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