Master Data Services 2016创建新目标实体同步时出现MDS错误求助

我来分享几个实际排查中常用的方向，帮你定位问题根源：

• 先确认权限是否足够
  别小看权限问题！当前操作账号不仅需要源实体的读取权限，还得有目标模型的实体创建权限，甚至可能需要MDS系统级的管理员权限。有些时候权限不足不会直接提示“权限不够”，而是触发隐性错误导致同步失败。

• 检查源实体的完整性
  先排查源实体本身有没有问题：比如有没有数据类型异常的属性、未通过业务规则验证的记录，或者实体处于锁定状态。你可以先在实体管理里对源实体执行一次完全验证，排除源数据本身的异常。

• 核对同步向导的配置细节
  倒回去重新走一遍同步流程，仔细检查每一步：

  • 目标模型是不是选对了？有没有误选不存在或权限不足的模型；
  • 属性映射有没有遗漏必填项？源属性和目标属性的数据类型是不是匹配（比如源是整数，目标却选了字符串）；
  • 新实体的命名有没有违反MDS规则？比如带特殊字符、长度超限之类的。

• 查看MDS日志抓具体错误信息
  这是最关键的一步！默认MDS会记录详细错误日志：

  1. 打开MDS配置管理器，把日志级别设为“详细”；
  2. 重新执行同步操作触发错误；
  3. 到MDS安装目录的日志文件夹（默认路径类似C:\Program Files\Microsoft SQL Server\130\Master Data Services\WebApplication\App_Data\Logs，130对应SQL 2016）找最新的日志文件；
  4. 搜索错误相关的条目，里面会有具体的错误代码和描述，比如数据库约束冲突、连接异常等，直接帮你定位问题。

• 检查SQL Server依赖服务与数据库状态
  确认MDS依赖的SQL Server服务（数据库引擎、SQL Server Agent）都在正常运行；检查MDS对应的数据库（默认是MDS）有没有空间不足、事务日志爆满的情况，或者数据库级别的约束被触发。

• 简化场景做测试
  如果还是找不到问题，先简化同步内容：只选源实体里的基础属性（比如ID、名称）来创建新实体，排除复杂属性（比如层次结构、派生属性）的干扰。要是简化后成功了，再逐步添加属性，就能找到导致错误的具体项。

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