跳到主要内容
版本:3.x

SQL Server

请遵循以下说明以确保在 Tapdata 中成功添加和使用 SQL Server 数据库。默认情况下,未启用 SQL Server 增量复制。为了在 SQL Server上执行更改数据捕获,必须事先由管理员明确启用增量复制功能。

提示

您必须以 sysadmin 的成员身份登录到 SQLServer Management Studio 或 sqlcmd。 增量复制是 SQLServer 2008 及更高版本支持的功能。 确保 SQL 代理 任务是启动状态(在 SQLServer Management Studio 里面左下角)

支持版本

SQL Server 2005、2008、2008 R2、2012、2014、2016、2017

先决条件

开启 Sql Server 数据库代理服务

  • 查找 mssql-conf 工具
find / -name mssql-conf
  • 开启代理服务
mssql-conf set sqlagent.enabled true

启用数据库增量复制

  • 数据库启用增量复制
use [数据库名称]
go
EXEC sys.sp_cdc_enable_db
go

其中 [数据库名称] 是要启用增量复制的数据库。

  • 检查数据库是否启用增量复制
SELECT [name], database_id, is_cdc_enabled
FROM sys.databases
WHERE [name] = N'[数据库名称]'
go

其中 [数据库名称] 是您要复制的数据库。

表开启增量复制

  • 启用增量复制
use<数据库名称>
go
EXEC sys.sp_cdc_enable_table
@source_schema = N'[Schema]',
@source_name = N'[Table]',
@role_name = N'[Role]'
go

说明:

<Schema> :如dbo

<Table> :是数据表的名称(没有 schema )。

<Role>:是可以访问更改数据的角色。如果您不想使用选通角色,请将其设置为NULL

提示

如果在启用增量复制时指定了 "",则必须确保提供给 Tapdata 的数据库用户名具有适当的角色,以便 Tapdata 可以访问增量复制表。

  • 检查是否为表启用了增量复制
use <数据库名称>
go
SELECT [name],is_tracked_by_cdc
FROM sys.tables
WHERE [name] = N'[table]'
go
  • CDC的表执行DDL后

如果CDC的表对字段进行了增、删、改的DDL操作,则必须进行如下操作,否则在增量同步过程中,可能会出现数据不同步或者报错的情况

  • 需要disable该表的CDC*
go
EXEC sys.sp_cdc_disable_table
@source_schema = N'[Schema]',
@source_name = N'[Table]',
@capture_instance = N'[Schema_Table]'
go
// capture_instance一般为schema_table的格式拼接而成,可以通过以下命令,查询实际的值
exec sys.sp_cdc_help_change_data_capture
@source_schema = N'[Schema]',
@source_name = N'[Table]';
  • 重新enable开启CDC
use<数据库名称>
go
EXEC sys.sp_cdc_enable_table
@source_schema = N'[Schema]',
@source_name = N'[Table]',
@role_name = N'[Role]'
go

版本低于 2008 的 CDC

MSSQL 从 SQLServer 2008 开始提供 CDC 支持。对于较早的版本,必须使用 “custom sql” 功能来模拟更改数据捕获。在从旧版本复制数据时,需要考虑以下几点:

  • 源表必须有一个更改跟踪列,比如 LAST_UPDATED_TIME,它在每次插入或更新记录时都会更新。
  • 在任务设置界面

确保只选择 INITIAL_SYNC ,因为不支持** CDC

将 “重复运行自定义 SQL” 设置为 **True。这将导致重复执行定制 SQL。

  • 在映射设计上提供适当的自定义 SQL

CDC 日志清理设置

SQL Server开启 CDC 后,不会自动清理增量数据日志,需要进行如下设置开启清理任务。

--retention的单位为分钟,本处设定清理周期为2天

USE AdventureWorks2012;
GO
EXECUTE sys.sp_cdc_change_job
@job_type = N'cleanup',
@retention = 2880;
GO

SQL Server全库 CDC 设置

开启全库 CDC

-- 全局替换 将 TAPDATA 替换为实际的数据库名
-- 全局替换 将 INSURANCE 替换为实际的 schema 名称
USE TAPDATA
GO
EXEC sys.sp_cdc_enable_db
GO

declare @table_name varchar(100)
declare @database_name varchar(100)
declare @schema_name varchar(100)

set @database_name = 'TAPDATA'
set @schema_name = 'INSURANCE'

declare my_cursor cursor for SELECT TABLE_NAME
FROM TAPDATA.INFORMATION_SCHEMA.TABLES
where TABLE_CATALOG = @database_name
and TABLE_SCHEMA = @schema_name;
open my_cursor
fetch next from my_cursor into @table_name
while @@FETCH_STATUS = 0
begin
begin try
exec sys.sp_cdc_enable_table
@source_schema = @schema_name,
@source_name = @table_name,
@role_name = NULL
end try
begin catch
print('[ERROR] ' + @table_name)
end catch

fetch next from my_cursor into @table_name
end
close my_cursor
deallocate my_cursor

关闭全库CDC

-- 全局替换 将 TAPDATA 替换为实际的数据库名
-- 全局替换 将 INSURANCE 替换为实际的 schema 名称
USE TAPDATA
GO

declare @table_name varchar(100)
declare @database_name varchar(100)
declare @schema_name varchar(100)

set @database_name = 'TAPDATA'
set @schema_name = 'INSURANCE'

declare my_cursor cursor for SELECT TABLE_NAME
FROM TAPDATA.INFORMATION_SCHEMA.TABLES
where TABLE_CATALOG = @database_name
and TABLE_SCHEMA = @schema_name;
open my_cursor
fetch next from my_cursor into @table_name
while @@FETCH_STATUS = 0
begin
begin try
EXEC sys.sp_cdc_disable_table
@source_schema = @schema_name,
@source_name = @table_name,
@capture_instance = 'all';
end try
begin catch
print ('[ERROR] ' + @table_name)
end catch

fetch next from my_cursor into @table_name
end
close my_cursor
deallocate my_cursor

EXEC sys.sp_cdc_disable_db
GO

SQL Server从节点同步配置

如果要从节点上做同步,除按照3(先决条件)配置之外,还需要:

SQL server从节点上的数据同步,需检查以下配置项:

  1. 开启 SQL Server 数据库代理服务 :

    mssql-conf set sqlagent.enabled true
  1. 开启SQL Server数据库增量复制:

    use 数据库名称
    go
    EXEC sys.sp_cdc_enable_db
    go
  1. 开启SQL Server数据库表的增量复制:

    use 数据库名称
    Go
    EXEC sys.sp_cdc_enable_table
    @source_schema = N’schema,
    @source_name = N’name’,
    @role_name = N’role’
    go

SQL Server CDC 配置微软官方指引

当遇到本文未覆盖到的问题时,请参考微软官方文档