Microsoft SQL Server

连接Foundry到Microsoft SQL Server，以便在SQL Server数据库和Foundry之间读取和同步数据。

支持的功能

设置

1. 打开数据连接应用程序，并在屏幕右上角选择**+ 新建源**。
2. 从可用的连接器类型中选择MS SQL Server。
3. 选择通过互联网使用直接连接或通过代理运行时连接。
4. 按照下面各部分中的信息继续设置连接器的其他配置提示。

了解更多关于在Foundry中设置连接器的信息。

认证

您可以通过以下方式与SQL Server进行认证：

1. 用户名和密码：提供用户名和密码。我们建议使用服务凭证而不是个人用户凭证。
2. Active Directory Msi*：此选项将使用authentication=ActiveDirectoryMSI JDBC设置。可以非必填提供一个msiClientId。
3. Active Directory Password*：此选项将使用authentication=ActiveDirectoryPassword JDBC设置。必须提供Active Directory用户的用户名和密码以使用此设置。
4. Active Directory Service Principal*：此选项将使用authentication=ActiveDirectoryServicePrincipal JDBC设置。必须指定一个主体ID（有时称为应用程序或客户端ID），以及该主体ID的密钥。

有关这些认证模式的更多信息，请参阅官方文档 ↗。对于所有认证选项，请确保所提供的用户和角色在目标数据库上具有必要的权限，以及读取或写入目标表的权限。

* 请注意，Azure Active Directory现已更名为Microsoft Entra ID ↗；然而，微软发布的SQL Server驱动程序上的JDBC选项仍保留原始名称，指的是Active Directory。

网络

Microsoft SQL Server连接器需要访问您希望连接的SQL Server实例的网络。SQL Server连接通常使用主机名连接到端口1433。

为了启用从Foundry直接连接到SQL Server，在数据连接应用程序中设置源时，必须添加适当的出口策略。

对于托管在像Azure SQL或AWS RDS这样的云服务上的SQL Server实例，您必须为从云提供商的控制台检索到的主机名添加出口策略。

• 要查找您的Azure SQL实例的主机名，请导航到Azure门户中的设置 > 属性页面，并查找服务器名称字段。Azure SQL的一个基于主机名的出口策略示例：<your-database-name>.database.windows.net (port 1433)
• 要查找解析的IP，您可以从命令行运行nslookup <your-database-name>.database.windows.net。最终结果将是此主机名在Azure中解析到的IP地址。以下是一个基于IPv4的Azure SQL出口策略示例：x.x.x.x (port 1433)。Azure SQL在多个主机之间进行负载平衡，因此您可能需要多次运行nslookup命令，并添加所有解析的IP地址。

如果您使用代理运行时连接，您必须确保代理主机开放防火墙，以连接到您的MS SQL Server数据库所需的主机名、IP地址和端口。

连接详情

更改数据捕获

Microsoft SQL Server源支持更改数据捕获同步。

要启用Microsoft SQL Server的更改数据捕获，您必须运行如下命令以在数据库上启用CDC。

Copied!
1
2
3
4
USE <database> -- 使用目标数据库
GO
EXEC sys.sp_cdc_enable_db -- 启用数据库的更改数据捕获（Change Data Capture）
GO

然后，在每个应该记录更改日志的表上运行另一个命令：

Copied!
1
2
3
4
5
6
7
8
EXEC sys.sp_cdc_enable_table
    @source_schema = N'<schema>'  -- 源表的架构名称
  , @source_name = N'<table_name>'  -- 源表的名称
  , @role_name = NULL  -- 用于访问更改数据捕获（CDC）数据的角色名称，NULL表示使用默认角色
  , @capture_instance = NULL  -- 捕获实例的名称，NULL表示使用默认实例名
  , @supports_net_changes = 0  -- 指定是否支持净更改，0表示不支持
  , @filegroup_name = N'PRIMARY';  -- 存储CDC对象的文件组名称
GO

上述代码用于启用SQL Server中的更改数据捕获（Change Data Capture, CDC）功能。CDC用于跟踪表中的更改，便于数据同步和审核。 一旦为您希望同步到Foundry的表启用了更改数据捕获，您可以导航到概览页面并选择**+ 创建CDC同步**以开始创建新的更改数据捕获同步。

有关这些命令和在Microsoft SQL Server中使用更改数据捕获（CDC）的更多信息，请参阅所使用版本的SQL Server的官方文档 ↗。