教程：在 Azure Cosmos DB 中配置 Microsoft Fabric 镜像数据库（预览）

在本教程中，您将从 Azure Cosmos DB for NoSQL 帐户配置 Fabric 镜像数据库。

重要

Azure Cosmos DB 镜像目前处于预览阶段。 预览期间不支持生产工作负载。 目前，仅支持 Azure Cosmos DB for NoSQL 帐户。

先决条件

• 一个现有的 Azure Cosmos DB for NoSQL 帐户。
  • 如果你没有 Azure 订阅，请免费试用 Azure Cosmos DB for NoSQL。
  • 如果你当前有 Azure 订阅，请创建新的 Azure Cosmos DB for NoSQL 帐户。
• 现有的 Fabric 容量。 如果没有现有容量，请启动 Fabric 试用版。 某些 Fabric 区域可能无法使用镜像。 有关详细信息，请参阅支持的区域。
• 在 Fabric 租户或工作区中启用镜像。 如果尚未启用此功能，请在 Fabric 租户中启用镜像。
  • 如果在 Fabric 工作区或租户中看不到镜像，则组织管理员必须在管理员设置中启用镜像。

提示

在公共预览期间，建议使用现有 Azure Cosmos DB 数据的测试或开发副本，以便从备份中快速恢复。

配置 Azure Cosmos DB 帐户

首先，确保正确配置源 Azure Cosmos DB 帐户，以便用于 Fabric 镜像。

1. 在 Azure 门户中，导航到你的 Azure Cosmos DB 帐户。

2. 确保已启用连续备份。 如果未启用，请按照将现有 Azure Cosmos DB 帐户迁移到连续备份指南来启用连续备份。 此功能可能不支持某些场景。 有关详细信息，请参阅数据库和帐户限制。

3. 确保所有网络的网络选项均设置为公用网络访问。 如果没有，请按照配置 Azure Cosmos DB 帐户的网络访问指南操作。

创建镜像数据库

现在，创建一个镜像数据库，作为复制数据的目标。 有关详细信息，请参阅镜像会带来什么。

1. 导航到 Fabric 门户主页。

2. 打开现有工作区或创建新工作区。

3. 在导航菜单中，选择创建。

4. 选择“创建”，找到“数据仓库”部分，然后选择“镜像 Azure Cosmos DB（预览）”。

5. 为镜像数据库命名，然后选择“创建”。

连接到源数据库

接下来，将源数据库连接到镜像数据库。

1. 在“新建连接”部分，选择 Azure Cosmos DB for NoSQL。

2. 为 Azure Cosmos DB for NoSQL 帐户提供凭证，包括以下项：

   	值
   Azure Cosmos DB 终结点	源帐户的 URL 终结点。
   连接名称	连接的唯一名称。
   身份验证种类	选择“帐户密钥”。
   帐户密钥	源帐户的读写密钥。

   

3. 选择“连接” 。 然后，选择要镜像的数据库。

   注意

   数据库中的所有容器都是镜像的。

启动镜像过程

1. 选择“镜像数据库”。 镜像现在开始。

2. 等待两到五分钟。 然后，选择“监视复制”以查看复制操作的状态。

3. 几分钟后，状态应变为“正在运行”，这表明容器正在同步。

   提示

   如果找不到容器和相应的复制状态，请等待几秒钟，然后刷新窗格。 在极少数情况下，可能会收到暂时性错误消息。 你可以放心忽略它们，继续刷新。

4. 当镜像完成容器的初始复制时，上次刷新列中会显示一个日期。 如果数据复制成功，汇总行列将包含复制的项数。

监视结构镜像

现在，你的数据已启动并运行，整个 Fabric 中具有各种可用的分析场景。

1. 配置 Fabric 镜像后，会自动导航到“复制状态”窗格。

2. 在此处监视复制的当前状态。 有关复制状态的更多信息和详细信息，请参阅监视 Fabric 镜像复制。

从 Fabric 查询源数据库

使用 Fabric 门户浏览 Azure Cosmos DB 帐户中已存在的数据，查询源 Cosmos DB 数据库。

1. 导航到 Fabric 门户中的镜像数据库。

2. 选择“视图”，然后选择“源数据库”。 此操作将打开 Azure Cosmos DB 数据资源管理器，其中包含源数据库的只读视图。

   

3. 选择容器，然后打开上下文菜单，并选择“新建 SQL 查询”。

4. 运行任何查询。 例如，使用 SELECT COUNT(1) FROM container 计算容器中的项数。

   注意

   源数据库上的所有读取都会路由到 Azure，并将消耗为帐户分配的请求单位 (RU)。

分析目标镜像数据库

现在，使用 T-SQL 查询当前存储在 Fabric OneLake 中的 NoSQL 数据。

1. 导航到 Fabric 门户中的镜像数据库。

2. 从镜像 Azure Cosmos DB 切换到 SQL 分析终结点。

   

3. 源数据库中的每个容器都应在 SQL 分析终结点中表示为仓库表。

4. 选择任意表，打开上下文菜单，然后选择“新建 SQL 查询”，最后选择“选择前 100 个”。

5. 查询将执行并返回所选表中的 100 条记录。

6. 打开同一表的上下文菜单，然后选择“新建 SQL 查询”。 编写一个使用 SUM、 COUNT、MIN 或 MAX 等聚合的示例查询。 联接仓库中的多个表，跨多个容器执行查询。

   注意

   例如，此查询将跨多个容器执行：

   SELECT
       d.[product_category_name],
       t.[order_status],
       c.[customer_country],
       s.[seller_state],
       p.[payment_type],
       sum(o.[price]) as price,
       sum(o.[freight_value]) freight_value 
   FROM
       [dbo].[products] p 
   INNER JOIN
       [dbo].[OrdersDB_order_payments] p 
           on o.[order_id] = p.[order_id] 
   INNER JOIN
       [dbo].[OrdersDB_order_status] t 
           ON o.[order_id] = t.[order_id] 
   INNER JOIN
       [dbo].[OrdersDB_customers] c 
           on t.[customer_id] = c.[customer_id] 
   INNER JOIN
       [dbo].[OrdersDB_productdirectory] d 
           ON o.product_id = d.product_id 
   INNER JOIN
       [dbo].[OrdersDB_sellers] s 
           on o.seller_id = s.seller_id 
   GROUP BY
       d.[product_category_name],
       t.[order_status],
       c.[customer_country],
       s.[seller_state],
       p.[payment_type]
   

   此示例假定了表和列的名称。 编写 SQL 查询时使用你自己的表和列。

7. 选择查询，然后选择“另存为视图”。 为视图指定唯一名称。 可随时从 Fabric 门户访问此视图。

8. 选择查询，然后选择“浏览此数据（预览）”。 此操作直接使用 OneLake 镜像数据上的 Direct Lake 浏览 Power BI 中的查询。

   提示

   还可以选择使用 Copilot 或其他增强功能生成仪表板和报告，无需进一步的数据移动。

9. 返回到 Fabric 门户中的镜像数据库。

10. 选择“新建视觉对象查询”。 使用查询编辑器生成复杂的查询。

    

更多示例

详细了解如何在 Fabric 中访问和查询镜像 Azure Cosmos DB 数据：

• 操作说明：从 Azure Cosmos DB 查询 Microsoft Fabric 中的嵌套数据镜像数据库
• 操作说明：从 Microsoft Fabric 访问湖屋和笔记本中的镜像 Azure Cosmos DB 数据（预览）
• 操作说明：在 MicrosoftFabric 中将镜像的 Azure Cosmos DB 数据与其他镜像数据库联接

相关内容

• 镜像 Azure Cosmos DB（预览）
• 常见问题解答：Azure Cosmos DB 中的 Microsoft Fabric 镜像数据库