将 Azure SQL 数据库 CDC 源添加到事件流(预览版)

本文介绍如何将 Azure SQL 数据库变更数据捕获 (CDC) 源添加到事件流。

通过用于 Microsoft Fabric 事件流的 Azure SQL 数据库 CDC 源连接器,你可以捕获 Azure SQL 数据库中当前数据的快照。 然后,连接器将监视并记录对此数据进行的任何未来的行级别更改。 在事件流中捕获更改后,可以实时处理此 CDC 数据,并将其发送到 Fabric 内的不同目标,以进一步处理或分析。

重要

Fabric 事件流的增强功能目前以预览版方式提供。

注意

工作区容量的以下区域不支持此源:美国西部 3瑞士西部

先决条件

  • 使用“参与者”或更高权限访问 Fabric 高级工作区
  • 具有 Azure SQL 数据库的正在运行的 Azure SQL 服务器。
  • 你的 Azure SQL 数据库必须可供公开访问,并且不能位于防火墙后面或在虚拟网络中受到保护。
  • 通过运行存储过程 sys.sp_cdc_enable_db 在 Azure SQL 数据库中启用了 CDC。 有关详细信息,请参阅启用和禁用变更数据捕获

请注意,不得在 Azure SQL 数据库中启用镜像。

注意

一个事件流的源和目标的最大数量为 11

在 Azure SQL 数据库中启用 CDC

  1. 转到 Azure 门户,打开 Azure SQL 数据库并选择“查询编辑器”。 选择要登录的身份验证方法。

    打开 Azure SQL 数据库的屏幕截图。

  2. 请执行以下 SQL 命令以在数据库中启用 CDC:

    -- Enable Database for CDC
    EXEC sys.sp_cdc_enable_db;
    
    -- Enable CDC for a table using a gating role option
    EXEC sys.sp_cdc_enable_table
        @source_schema = N'dbo',
        @source_name   = N'MyTable',
        @role_name     = NULL
    GO
    
  3. 查询成功执行后,你已经在 Azure SQL 数据库中启用了 CDC。

    启用 Azure SQL CDC 的屏幕截图。

添加 Azure SQL 数据库 CDC 作为源

  1. 选择“事件流”以创建新的事件流。 确保已启用“增强功能(预览版)”选项。

    创建新事件流的屏幕截图。

  2. 在下一个屏幕上,选择“添加外部源”

    选择“添加外部源”的屏幕快照。

配置并连接到 Azure SQL 数据库 CDC

  1. 在“选择数据源”屏幕上,选择“Azure SQL DB (CDC)”

    选择 Azure SQL DB (CDC) 的屏幕截图。

  2. 在“连接”页上,选择“新建连接”

    显示“获取事件”向导的“连接”页的屏幕截图,其中突出显示了 **新建连接** 链接。

  3. 在“连接设置”部分中,为 Azure SQL 数据库输入以下值:

    • 服务器:输入 Azure 门户中的 Azure SQL 服务器名称。

    • 数据库:输入 Azure 门户中的 Azure SQL 数据库名称。

      显示“新建连接”页的“连接设置”部分的屏幕截图。

  4. 向下滚动,然后在“连接凭据”部分中,执行以下步骤。

    • 对于“连接名称”,为连接输入名称。

    • 对于“身份验证类型”,选择“基本”

      注意

      目前,Fabric 事件流仅支持“基本”身份验证。

    • 输入数据库的“用户名”和“密码”

  5. 选择“连接” 。

    显示“新建连接”页的“连接凭据”部分的屏幕截图。

  6. 现在,在“连接”页上,输入以下信息:

    • 选择“所有表”或输入用逗号分隔的表名,例如:dbo.table1, dbo.table2
    • 对于端口,默认值为 1433,且不能修改。
  7. 选择下一步

    显示填充了“获取事件”向导的“连接”页的屏幕截图。

  8. 在“查看并创建”屏幕上,查看摘要,然后选择“添加”

    显示填充了“获取事件”向导的“查看并创建”页的屏幕截图。

可以在“编辑模式”下看到添加到事件流的 Azure SQL 数据库 (CDC) 源。

在“编辑视图”中流式处理 Azure SQL 数据库 CDC 源的屏幕截图。

要实现这个新添加的 Azure SQL 数据库 CDC 源,请选择“发布”。 完成这些步骤后,你的 Azure SQL 数据库 CDC 源可在“实时视图”中进行可视化。

在“实时视图”中流式处理 Azure SQL 数据库 CDC 源的屏幕截图。

其他连接器: