Azure Cosmos DB for MongoDB迁移时UUID格式不一致问题求助

问题根源 #

源库的UUID通过MongoDB C#驱动配置为GuidRepresentation.Standard（RFC 4122标准格式）存储，MongoDB Compass会识别该格式并以UUID('xxx')展示。但Azure Data Factory默认复制时可能将Guid字段当作普通二进制数据处理，未保留Guid的表示方式元数据，导致目标库中该字段被识别为普通Binary subtype 3，Compass便以Binary.createFromBase64格式展示。

解决方案 #

1. 修改ADF目标数据集的Guid表示配置 #

在Azure Data Factory的目标Cosmos DB for MongoDB数据集中，显式指定与源库一致的Guid表示方式：

• 打开目标数据集编辑页面，切换到连接选项卡
• 找到Guid Representation设置，选择Standard（对应源库使用的GuidRepresentation.Standard）
• 若使用JSON编辑模式，在数据集连接属性中添加：

  "guidRepresentation": "standard"
  

2. 调整复制活动的字段类型映射（可选） #

如果ADF自动推断的字段类型不准确，可手动指定字段类型为Guid：

• 打开复制活动的映射选项卡
• 找到目标端的UUID字段，将其类型设置为Guid（而非默认的Binary）

3. 配置MongoDB Compass的连接参数 #

即使数据存储正确，若Compass连接目标库时未指定Guid表示方式，仍会显示为Binary格式。修改Compass连接设置：

• 在Compass连接目标库的高级选项中，找到Guid Representation，选择Standard
• 或直接在连接字符串末尾追加参数：?guidRepresentation=standard

验证 #

完成上述配置后重新运行迁移管道，再用Compass连接目标库查看UUID字段，即可看到与源端一致的UUID('xxx')格式展示。

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