Microsoft Fabric 镜像数据库的故障场景、解决方法和变通方法。
资源
查看每个数据源常见问题解答的故障排除部分：
- 故障排除 Azure SQL 数据库镜像 和 有关 Azure SQL 数据库镜像的常见问题解答
- 对镜像 Azure SQL 托管实例进行故障排除 ，以及 有关镜像 Azure SQL 托管实例的常见问题解答
- Azure Database for PostgreSQL 灵活服务器镜像故障排除以及 Azure Database for PostgreSQL 灵活服务器镜像常见问题解答
- 排查镜像 Azure Cosmos DB 问题和有关镜像 Azure Cosmos DB 的常见问题解答
- 排查镜像 Snowflake 问题
- 有关镜像 Azure Databricks 的常见问题解答
- 排查 Fabric SQL 数据库镜像问题（预览版）和有关 Fabric SQL 数据库镜像的常见问题解答（预览版）
- 排查 SQL Server 中的 Fabric 镜像数据库 和 Microsoft Fabric 中镜像 SQL Server 的常见问题解答
查阅每个数据源的限制文档：
- Azure SQL 数据库中的 Microsoft Fabric 镜像数据库的限制
- Azure SQL 托管实例中Microsoft Fabric 镜像数据库的限制（预览版）
- Azure Database for PostgreSQL 灵活服务器中的 Microsoft Fabric 镜像数据库的限制（预览版）
- Azure Cosmos DB 中Microsoft Fabric 镜像数据库的限制（预览版）
- Azure Databricks 中Microsoft Fabric 镜像数据库的限制（预览版）
- 来自 Snowflake 的 Microsoft Fabric 镜像数据库的限制
- SQL Server 中 Microsoft Fabric 镜像数据库的限制
- Fabric SQL 数据库镜像的局限性
对 Fabric 容量的更改
| 场景 | 说明 |
|---|---|
| Fabric 容量暂停 | 镜像停止，无法列出或访问镜像数据库项。 恢复或重新分配工作区容量。 |
| 已恢复 Fabric 容量 |
已知限制：从暂停状态恢复容量时，镜像数据库状态显示为“正在运行”，但镜像不会自动启动。 因此，源中所做的更改不会复制到 OneLake。 若要恢复镜像，请转到 Fabric 门户中的镜像数据库，选择“ 配置复制”，然后单击“ 应用更改”。 镜像将从暂停的位置继续运行。 请注意，如果长时间暂停容量，镜像可能无法从停止点恢复，而是从头开始重新传输数据。 例如，如果数据库的事务日志已满，就可能出现这种情况。 |
| Fabric 容量缩放 | 镜像继续运行。 如果降低容量配额，请注意，存放镜像数据的 OneLake 存储空间在容量规格对应的限额内可供免费使用，降低容量配额可能会产生额外的存储费用。 从 镜像成本中了解详细信息。 |
| Fabric 容量受限制 | 等待过载状态结束或更新容量。 容量恢复后，镜像将继续运行。 通过为从过载情况中恢复可采取的操作了解详细信息。 |
| Fabric 试用容量已过期 | 镜像停止。 若要保留镜像数据库，请购买 Fabric 容量。 了解更多关于 Fabric 试用容量到期 的信息。 |
数据似乎无法复制
如果观察到镜像数据出现延迟，请检查以下内容：
镜像状态： 在镜像数据库的 Fabric 门户监视页 中，检查镜像数据库和特定表的状态，以及“上次完成”列，该列指示 Fabric 上次从源刷新镜像表的时间。 为空表示该表尚未镜像。
如果启用工作区监视，还可以通过查询
ReplicatorBatchLatency镜像数据库作日志中的值来检查镜像执行延迟。对于 Azure SQL 数据库、 Azure SQL 托管实例 和 Azure Database for PostgreSQL 等源类型，请按照特定说明检查源数据库配置和状态。
OneLake 中的数据： 镜像会以 Delta Lake 表格式将数据连续复制到 OneLake。 若要验证数据是否正确降落在 OneLake 中，可以将镜像表的快捷方式创建到 Lakehouse 中，然后使用 Spark 查询生成笔记本来查询数据。 了解有关 使用笔记本进行探索的详细信息。
SQL 分析终结点中的数据： 您可以通过镜像数据库的 SQL 分析终结点，或通过指向镜像数据的快捷方式在 Lakehouse 中查询镜像数据。 出现延迟时，请验证 OneLake 中的镜像状态和数据，如前所述。 如果数据显示在 OneLake 中，但不显示在 SQL 分析终结点中，则可能是由 SQL 分析终结点中的 元数据同步 延迟引起的。
可以手动强制刷新自动元数据扫描。 在 SQL 分析终结点的页面上，选择“ 刷新 ”按钮，如下图所示。 等待一段时间，然后再次查询数据以检查。
停止复制
选择 “停止复制”时，OneLake 文件保持不变，但增量复制会停止。 可以通过选择 “开始复制”来随时重启复制。 在重置复制状态后、更改源数据库后，或用作故障排除手段时，可能需要执行停止/开始。
复制源架构层次结构
从各种类型的源数据库镜像数据时，源架构层次结构将保留在镜像数据库中。 它可确保您的数据在不同服务中始终保持一致的组织，这样您就可以在 SQL 分析终结点、Spark Notebook、语义模型和其他数据引用中使用相同的逻辑来利用这些数据。
对于在启用此功能之前创建的镜像数据库，可以看到源架构在镜像数据库中被平展，架构名称编码为表名。 如果要使用架构重新组织表，请重新创建镜像数据库。
如果使用 API 创建/更新镜像数据库，请为属性 defaultSchema 设置值，该值指示是否从源数据库复制架构层次结构。 请参阅 Microsoft Fabric 镜像公共 REST API 中的定义示例。
Delta 列映射支持
镜像支持将名称中包含空格或特殊字符的列（如 ,;{}()\n\t=）从源数据库复制到镜像数据库。 在后台，镜像会将数据写入 OneLake 并启用 Delta 列映射。
对于在启用此功能之前已在复制中的表，若要在名称中包含具有特殊字符的列，需要通过删除和重新添加这些表来更新镜像数据库设置，或者停止并重启镜像数据库。
获取镜像数据库的所有权
目前，镜像数据库不支持所有权更改。 如果镜像数据库因项目所有者离开组织或不再有效而停止运行，则需要重新创建镜像数据库。
支持的区域
以下是支持数据库镜像和开放镜像的 Fabric 区域：
美洲：
- 巴西南部
- 加拿大中部
- 加拿大东部
- 美国中部
- 美国东部
- 美国东部 2
- 美国中北部
- 美国中南部
- 美国西部
- 西部美国 2
- 美国西部 3
亚太地区：
- 东亚
- 东南亚
- 澳大利亚东部
- 澳大利亚东南部
- 印度中部
- 印度南部
- 日本东部
- 韩国中部
欧洲、中东和非洲：
- 北欧
- 西欧
- 法国中部
- 德国中西部
- 意大利北部
- 挪威东部
- 波兰中部
- 南非北部
- 瑞典中部
- 瑞士北部
- 瑞士西部
- 阿拉伯联合酋长国北部
- 英国南部
- 英国西部
疑难解答
本部分包含为镜像排除故障的一般步骤。
无法与数据源建立连接
- 检查连接详细信息是否正确，包括服务器名称、数据库名称、用户名和密码。
- 检查服务器是否未处于防火墙或专用虚拟网络后面。 打开相应的防火墙端口。
未复制任何视图
当前，视图不受支持。 仅支持复制常规表。
未复制任何表
- 通过检查监视状态，对表的状态进行检查。 有关详细信息，请参阅 Monitor Fabric 镜像数据库复制。
- 选择“ 配置复制 ”按钮。 检查表是否出现在了表列表中，或者，每个表的详细信息中是否有任何警报。
目标表中缺少列
- 选择“ 配置复制 ”按钮。
- 如果有任何列未被复制，请选择表详细信息旁边的警报图标。
列中的某些数据似乎会被截断
SQL 分析终结点不支持 VARCHAR（max），它当前仅支持 VARCHAR（8000）。
无法更改源数据库
不支持更改源数据库。 请创建新的镜像数据库。
限制错误消息
这些常见错误消息包含说明和缓解措施：
| 错误信息 | 原因 | 缓解 |
|---|---|---|
| “表计数可能超出限制，可能有一些表丢失。” | 最多有 500 个表。 | 在源数据库中，删除或筛选表。 如果新表是第 500 个表，则无需采取缓解措施。 |
| “复制受到限制，预期在 YYYY-MM-DDTHH：MM：ss 继续。” | 每个镜像数据库每天最多捕获 1 TB 更改数据。 | 等待限制结束。 |