1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.0 | 定时任务读写适配 SQL server |
| 4.0.7 | 数据管道输入适配 SQL server 数据管道输出适配 SQL server |
| 4.0.20.1 | 数据服务适配 SQL server |
| 4.1.11.4 | 实时任务读写适配 SQL server |
| 4.1.14.1 | 数据连接支持配置套接字超时（SocketTimeout 设置项中配置），控制数据库查询时间在一个合理范围内，避免出现无限等待的问题 |
1.2 应用场景
FineDataLink 支持连接 Microsoft SQL Server，进行定时任务读写、管道任务读写、作为数据服务数据发布源、实时任务读写。
2. 准备工作
2.1 前提条件
详情请参见：前提条件
2.2 版本和驱动
下载对应的驱动包，如何上传驱动包可参见：驱动管理
注1：4.1.14.1 及之后版本，新增设置项 SocketTimeout，可控制数据库查询时间，详情请参见本文第三章说明；若想使用该设置项，驱动文件需要在 7 以上版本，用户需要到官网根据实际数据库版本下载驱动文件。
注2：4.2.1.1 之前版本，若使用 SQL Server 数据库作为管道任务的来源库，不建议使用自定义驱动。
| 支持的数据库版本 | 驱动包下载 |
|---|---|
| SQL Server 2000 | |
SQL Server 2005 SQL Server 2008 SQL Server 2012 SQL Server 2014 SQL Server 2016 SQL server 2019 注：SQL server 2019 支持在4.0.17.1以及之后的FDL版本中使用 | 已内置无需下载 |
2.3 收集连接信息
在连接数据库之前，请收集以下信息：
数据库所在服务器的 IP 地址和端口号。
数据库的名称。
数据库的用户名和密码。
要连接的数据库模式。
3. 具体连接步骤
1）管理员登录 FDL 工程，点击「管理系统>数据连接>数据连接管理」，选中某个文件夹后，新建数据连接。如下图所示：
2）设置数据连接名称（可同时修改数据连接所在目录）。如下图所示：
3）可根据数据源分类、支持形式、适配模块、数据源名称筛选数据库。如下图所示：
4）输入 2.3 节的连接信息，驱动由于是内置的，选择「默认即可」。
模式需要连接数据库后才可以选择，所以需要先点击「点击连接数据库」后，再选择「模式」。如下图所示：
部分设置项说明如下表所示：
| 设置项 | 说明 |
|---|---|
| SocketTimeout（4.1.14.1 及之后版本新增） | 用户若需要配置该设置项，需要使用 7 以上版本的驱动（产品内置的驱动是 6 版本的），需要到官网根据实际数据库版本下载驱动文件 1）值说明： 配置当前数据连接的套接字超时，单位为秒，默认值为 3600 输入框要求为非负整数，配置为 0 时，视为不设置超时 2）该设置项应用场景： 在网络发生抖动时，可能会出现管道&定时任务发出查询后，无限等待返回数据的问题，用户运维时，看不到报错，但实际任务已不再同步数据 配置该设置项后，将控制查询在一个合理的范围内，达到套接字超时时间后，SQL 语句会自动中断报错，避免出现无限等待的问题 3）该设置项控制的功能范围：
|
| 其他说明 | 注1：用户若是想要连接非默认实例，可以更改「数据连接URL」为：jdbc:sqlserver://ip:port;instanceName=实例名;databaseName=数据库名 注2：连接多模式的数据库时使用 SQL 语句需要带上模式名前缀进行搜索，例如 SELECT * FROM [dbo].[asdfg] |
5）点击「测试连接」，若连接成功则「保存」该连接。如下图所示：
4.使用数据源
配置好数据源后即可在「定时任务」中使用数据源，详情参见：定时任务概述
配置好数据源后即可在「数据管道」中将使用数据源，详情参见：数据管道概述
注1：4.1.1 及之后版本，SQLServer 数据源作为源表，支持 无主键同步
注2：4.2.1.1 之前版本，若使用 SQL Server 数据库作为管道任务的来源库，配置数据连接时不建议使用自定义驱动；且管道任务的日志等级不建议为 DEBUG （可设置为 INFO）。否则管道任务中会出现大量 SQL Server cdc 日志打印。
配置好数据源后即可在「数据服务」中将使用数据源，详情参见：数据服务概述
配置好数据源后即可在「实时任务」中将使用数据源，详情参见：实时任务概述
