排查 Fabric 镜像数据库的故障

Microsoft Fabric 镜像数据库的故障场景、解决方法和变通方法。

资源

查看每个数据源常见问题解答的故障排除部分:

查阅每个数据源的限制文档:

停止复制

选择“停止复制”时,OneLake 文件会保持不变,但增量复制会停止。 可以随时通过选择“启动复制”,重启复制。 在重置复制状态后、更改源数据库后,或用作故障排除手段时,可能需要执行停止/开始。

复制源架构层次结构

从各种类型的源数据库镜像数据时,源架构层次结构将保留在镜像数据库中。 它可确保您的数据在不同服务中始终保持一致的组织,这样您就可以在 SQL 分析终结点、Spark Notebook、语义模型和其他数据引用中使用相同的逻辑来利用这些数据。

对于在启用此功能之前创建的镜像数据库,可以看到源架构在镜像数据库中被平展,架构名称编码为表名。 如果要使用架构重新组织表,请重新创建镜像数据库。

如果使用 API 创建/更新镜像数据库,请为属性 defaultSchema 设置值,该值指示是否从源数据库复制架构层次结构。 请参阅 Microsoft Fabric 镜像公共 REST API中的定义示例。

Delta 列映射支持

镜像支持将名称中包含空格或特殊字符的列(如 ,;{}()\n\t=)从源数据库复制到镜像数据库。 在后台,镜像会将数据写入 OneLake 并启用 Delta 列映射。

对于在启用此功能之前已在复制中的表,若要在名称中包含具有特殊字符的列,需要通过删除和重新添加这些表来更新镜像数据库设置,或者停止并重启镜像数据库。

获取镜像数据库的所有权

目前,镜像数据库不支持所有权更改。 如果镜像数据库因项目所有者离开组织或不再有效而停止运行,则需要重新创建镜像数据库。

疑难解答

本部分包含为镜像排除故障的一般步骤。

无法与数据源建立连接

  1. 检查连接详细信息是否正确,包括服务器名称、数据库名称、用户名和密码。
  2. 检查服务器是否未处于防火墙或专用虚拟网络后面。 打开相应的防火墙端口。

未复制任何视图

当前,视图不受支持。 仅支持复制常规表。

未复制任何表

  1. 通过检查监视状态,对表的状态进行检查。 有关详细信息,请参阅监视 Fabric 镜像数据库复制
  2. 选择“配置复制”按钮。 检查表是否出现在了表列表中,或者,每个表的详细信息中是否有任何警报。

目标表中缺少列

  1. 选择“配置复制”按钮。
  2. 如果有任何列未被复制,请选择表详细信息旁边的警报图标。

列中的某些数据似乎会被截断

Fabric 仓库不支持 VARCHAR(max),目前只支持 VARCHAR(8000)

数据似乎无法复制

“监视”页面,显示的日期是上次成功复制数据的日期。

无法更改源数据库

不支持更改源数据库。 请创建新的镜像数据库。

限制错误消息

这些常见错误消息包含说明和缓解措施:

错误消息 原因 缓解
“由于目标空间限制,复制受到限制。” 每个镜像数据库的目标存储空间最多为 10 TB。 由于目标空间限制,复制受到限制。 在源数据库中,删除表、删除数据或共享数据。
“表计数可能超出限制,可能有一些表丢失。” 最多有 500 个表。 在源数据库中,删除或筛选表。 如果新表是第 500 个表,则无需采取缓解措施。
“复制受到限制,预期在 YYYY-MM-DDTHH:MM:ss 继续。” 每个镜像数据库每天最多捕获 1 TB 更改数据。 等待限制结束。