cdc。<>capture_instance_CT (Transact-SQL)

适用于:SQL Server Azure SQL 数据库 Azure SQL 托管实例

在源表上启用更改数据捕获时创建的更改表。 该表为对源表执行的每个插入和删除操作返回一行,为对源表执行的每个更新操作返回两行。 启用源表时未指定更改表的名称时,将派生该名称。 名称的格式为 cdc。capture_instance_CT其中capture_instance是源表的架构名称,以及格式为schema_table的源表名称。 例如,如果为变更数据捕获启用了 AdventureWorks 示例数据库中的表 Person.Address,则派生的更改表名称将cdc.Person_Address_CT

建议 不要直接查询系统表。 请改为执行 cdc.fn_cdc_get_all_changes_<capture_instance>cdc.fn_cdc_get_net_changes_<capture_instance> 函数。

列名称 数据类型 说明
__$start_lsn binary(10) 与相应更改的提交事务关联的日志序列号 (LSN)。

在同一事务中提交的所有更改将共享同一个提交 LSN。 例如,如果源表上的删除操作删除两行,则更改表包含两行,每个行具有相同 的 __$start_lsn 值。
__$end_lsn binary(10) 标识为仅供参考。 不支持。 不保证以后的兼容性。

在 SQL Server 2012(11.x)中,此列始终为 NULL。
__$seqval binary(10) 事务日志中表示的操作序列。 不应用于排序。 请改用 __$command_id 列。
__$operation int 标识与相应更改关联的数据操作语言 (DML) 操作。 可以是以下值之一:

1 = 删除

2 = 插入

3 = 更新(旧值)

列数据中具有执行更新语句之前的行值。

4 = 更新(新值)

列数据中具有执行更新语句之后的行值。
__$update_mask varbinary(128) 基于更改表的列序号的位掩码,用于标识那些发生更改的列。
<捕获的源表列> 多种多样 更改表中的其余列是在创建捕获实例时源表中标识为已捕获列的那些列。 如果已捕获列的列表中未指定任何列,则源表中的所有列将包括在此表中。
__$command_id int 跟踪事务中的操作顺序。

注解

__$command_id 列是在版本 2012 到 2016 的累积更新中引入的。 有关版本和下载信息,请参阅 FIX 中的 知识库文章3030352:为 Microsoft SQL Server 数据库启用更改数据捕获后,更改表因更新的行错误排序。 有关详细信息,请参阅 CDC 功能升级到 SQL Server 2012、2014 和 2016 的最新 CU 后可能会中断。

已捕获列的数据类型

此表中包含的已捕获列具有与其对应源列相同的数据类型和值,但下述情况例外:

  • 时间戳列定义为 binary(8)。

  • 标识 列定义为 intbigint

不过,这些列中的值与源列的值相同。

大型对象数据类型

当 __$operation = 1 或 __$operation = 3 时,始终为数据类型图像、文本和 ntext 的列分配 NULL 值。 除非更新期间列发生更改,否则为数据类型 varbinary(max)varchar(max)nvarchar(max) 的列分配 NULL 值。 当 __$operation = 1 时,这些列会在删除时分配其值。 捕获实例中包含的计算列始终值为 NULL

默认情况下,在一个 INSERT、UPDATE、WRITETEXT 或 UPDATETEXT 语句中可添加到已捕获列的最大大小为 65,536 字节或 64 KB。 若要增加此大小以支持更大的 LOB 数据,请使用 “配置最大文本重排大小服务器配置选项” 指定更大的最大大小。 有关详细信息,请参阅 配置 max text repl size 服务器配置选项

数据定义语言修改

对源表的 DDL 修改(例如添加或删除列)记录在 cdc.ddl_history 表中。 这些更改不会应用于更改表。 也就是说,更改表的定义保持不变。 在更改表中插入行时,捕获进程将忽略未显示在与源表关联的捕获列列表中。 如果某列出现在已捕获列的列表中,但已不再位于源表中,则会为该列指定一个 null 值。

在源表中更改列的数据类型也会记录在 cdc.ddl_history 表中。 但是,此更改不会改变更改表的定义。 当捕获进程遇到对源表所做的 DDL 更改的此日志记录时,更改表中的此已捕获列的数据类型会进行相应更改。

如果需要修改源表中已捕获列的数据类型以减小该数据类型的大小,请使用以下过程以确保可以成功修改更改表中的对应列。

  1. 在源表中,更新要修改的列中的值以适合所计划的数据类型大小。 例如,如果将数据类型从 int 更改为 smallint,请将值更新为适合 smallint 范围的大小-32,768 到 32,767。

  2. 在更改表中,对对应列执行相同的更新操作。

  3. 通过指定新数据类型来更改源表。 该数据类型更改成功传播到更改表。

数据操作语言修改

对启用了变更数据捕获的源表执行插入、更新和删除操作时,这些 DML 操作的记录将显示在数据库事务日志中。 更改数据捕获过程从事务日志中检索有关这些更改的信息,并将一行或两行添加到更改表中以记录更改。 条目按照提交到源表的顺序添加到更改表中。 也就是说,更改表条目的提交通常必须针对一组更改执行,而不是为每个条目执行。

插入操作导致添加到更改表的一行;删除操作导致添加到更改表的一行;如果 SQL Server 将更新实现为“延迟更新”,这意味着作为一对删除和插入操作,则更新操作将产生两行添加到更改表:第一行反映删除捕获的数据,第二行反映插入更新、捕获的数据;如果 SQL Server 未将更新实现为“延迟更新”,更新操作将产生两行添加到更改表中:第一行反映更新前捕获的数据,第二行反映更新后捕获的数据。

在更改表项中, __$start_lsn 列用于记录与源表更改关联的提交 LSN, __$command_id 列用于对其事务中的更改进行排序,而 __$操作 列用于记录所执行的操作。 这些元数据列可共同用于确保保留源更改的提交顺序。 由于捕获进程从事务日志中获取其更改信息,因此请务必注意,更改表条目不会与其相应的源表更改同步显示。 在捕获进程处理了事务日志中的相关更改条目后,对应的更改将异步显示。

对于插入和删除操作,会设置更新掩码中的所有位。 对于更新操作,会修改更新(旧值)行和更新(新值)行中的更新掩码以指出在更新过程中有所更改的列。

另请参阅

sys.sp_cdc_enable_table (Transact-SQL)
sys.sp_cdc_get_ddl_history (Transact-SQL)