sys.sp_cdc_enable_table (Transact-SQL)

语法

sys.sp_cdc_enable_table 
    [ @source_schema = ] 'source_schema', 
    [ @source_name = ] 'source_name' ,
    [ @role_name = ] 'role_name'
    [,[ @capture_instance = ] 'capture_instance' ]
    [,[ @supports_net_changes = ] supports_net_changes ]
    [,[ @index_name = ] 'index_name' ]
    [,[ @captured_column_list = ] 'captured_column_list' ]
    [,[ @filegroup_name = ] 'filegroup_name' ]
  [,[ @partition_switch = ] 'partition_switch' ]

参数

• [ @source_schema = ] 'source_schema'
  是源表所属的架构的名称。source_schema 的数据类型为 sysname，无默认值，并且不能为 NULL。

• [ @source_name = ] 'source_name'
  是对其启用变更数据捕获的源表的名称。source_name 的数据类型为 sysname，无默认值，并且不能为 NULL。

  source_name 必须存在于当前数据库中。不能对 cdc 架构中的表启用变更数据捕获。

• [ @role_name = ] 'role_name'
  是用于控制更改数据访问的数据库角色的名称。role_name 为 sysname，并且必须指定。如果显式设置为 NULL，则没有控制角色用于限制对更改数据的访问。

  如果当前存在该角色，则使用它。如果不存在该角色，则会尝试创建具有指定名称的数据库角色。在尝试创建该角色之前，将删除角色名称字符串右侧的空格。如果调用方无权在数据库中创建角色，则存储过程操作将失败。

• [ @capture_instance = ] 'capture_instance'
  是用于命名特定于实例的变更数据捕获对象的捕获实例的名称。capture_instance 为 sysname，并且不能为 NULL。

  如果未指定，则该名称将从源架构名称加上源表名称中派生而来，格式为 schemaname_sourcename。capture_instance 不能超过 100 个字符，并且在数据库中必须是唯一的。不管是指定的还是派生的，都将删除 capture_instance 字符串右侧的任何空格。

  源表最多可以有两个捕获实例。有关详细信息，请参阅sys.sp_cdc_help_change_data_capture (Transact-SQL)。

• [ @supports_net_changes = ] supports_net_changes
  指示是否对此捕获实例启用净更改查询支持。supports_net_changes 为 bit，如果此表有主键，或者有已使用 @index_name 参数进行标识的唯一索引，则此参数的默认值为 1。否则，此参数默认为 0。

  如果为 0，则只生成查询所有更改的支持函数。

  如果为 1，则还会生成查询净更改所需的函数。

  如果将 supports_net_changes 设置为 1，则必须指定 index_name，或者源表必须具有已定义的主键。

• [ @index_name = ] **'**index_name'
  用于唯一标识源表中的行的唯一索引的名称。index_name 为 sysname，并且可以为 NULL。如果指定，则 index_name 必须是源表的唯一有效索引。如果指定 index_name，则标识的索引列优先于任何定义的主键列，就像表的唯一行标识符一样。

• [ @captured_column_list = ] 'captured_column_list'
  标识将包括在更改表中的源表列。captured_column_list 的数据类型为 nvarchar(max)，并且可以为 NULL。如果为 NULL，则所有列都将包括在更改表中。

  列名称必须是源表中的有效列。必须包括在主键索引中定义的列，或在 index_name 所引用的索引中定义的列。

  captured_column_list 是以逗号分隔的列名称列表。可以选择将列表中的单个列名称放在双引号 ("") 或方括号 ([]) 中。如果列名称包含嵌入的逗号，则必须将该列名称引起来。

  captured_column_list 不能包含以下保留的列名称：__$start_lsn、__$end_lsn、__$seqval、__$operation 和 __$update_mask。

• [ @filegroup_name = ] 'filegroup_name'
  是要用于为捕获实例创建的更改表的文件组。filegroup_name 为 sysname，并且可以 NULL。如果指定，则必须为当前数据库定义 filegroup_name。如果为 NULL，则使用默认文件组。

  我们建议为变更数据捕获的更改表创建一个单独的文件组。有关详细信息，请参阅配置变更数据捕获。

• [ @allow_partition_switch= ] 'allow_partition_switch'
  指示是否可以对启用了变更数据捕获的表执行 ALTER TABLE 的 SWITCH PARTITION 命令。allow_partition_switch 为 bit，默认值为 1。

  对于非分区表，此开关设置始终为 1，并忽略实际的设置。如果对于非分区表将此开关显式设置为 0，则发出警告 22857 以指示已忽略此开关设置。如果对于分区表将此开关显式设置为 0，则发出警告 22356 以指示将禁止源表上的分区切换操作。最后，如果此开关设置显式设置为 1 或允许默认为 1 并且被启用的表已分区，则发出警告 22855 以指示不会阻塞分区切换。如果发生任何分区切换，则变更数据捕获不会跟踪由此切换产生的更改。这将导致使用更改数据时数据不一致。

  重要提示
  SWITCH PARTITION 为元数据操作，但能导致数据更改。与此操作相关联的数据更改不会在变更数据捕获的更改表中捕获。请考虑一个有三个分区的表，并对此表进行更改。捕获进程将跟踪用户对该表执行的插入、更新和删除操作。但是，如果分区切出到另一个表（例如，为了执行大容量删除操作），作为此操作的一部分移动的行不会被捕获为更改表中的已删除行。同样，如果将已预填充行的新分区添加到该表，这些行将不会反映在更改表中。当更改被应用程序使用并应用于目标时，这可能会导致数据不一致。

返回代码值

0（成功）或 1（失败）

结果集

None

注释

在可以对表启用变更数据捕获之前，必须先对数据库启用变更数据捕获。若要确定数据库是否已启用变更数据捕获，请查询 sys.databases 目录视图中的 is_cdc_enabled 列。若要启用数据库，请使用 sys.sp_cdc_enable_db 存储过程。

对表启用变更数据捕获时，将生成一个更改表以及一个或两个查询函数。更改表充当捕获进程从事务日志中提取的源表更改的存储库。查询函数则用于从更改表中提取数据。这些函数的名称按以下方式派生自 capture_instance 参数：

• 所有更改函数： cdc.fn_cdc_get_all_changes_ < capture_instance >

• 净更改函数： cdc.fn_cdc_get_net_changes_ < capture_instance >

如果源表是数据库中第一个要启用变更数据捕获的表，并且数据库不存在事务发布，则 sys.sp_cdc_enable_table 还将为数据库创建捕获和清理作业。它将 sys.tables 目录视图中的 is_tracked_by_cdc 列设置为 1。

注意
对表启用变更数据捕获时，SQL Server 代理不必正在运行。但是，只有当 SQL Server 代理正在运行时，捕获进程才会处理事务日志并将条目写入更改表。

权限

要求具有 db_owner 固定数据库角色中的成员资格。

示例

A. 通过仅指定必需的参数来启用变更数据捕获

USE AdventureWorks2008R2;
GO
EXECUTE sys.sp_cdc_enable_table
    @source_schema = N'HumanResources'
  , @source_name = N'Employee'
  , @role_name = N'cdc_Admin';
GO

B. 通过指定其他可选参数启用变更数据捕获

USE AdventureWorks2008R2;
GO
EXEC sys.sp_cdc_enable_table
    @source_schema = N'HumanResources'
  , @source_name = N'Department'
  , @role_name = N'cdc_admin'
  , @capture_instance = N'HR_Department' 
  , @supports_net_changes = 1
  , @index_name = N'AK_Department_Name' 
  , @captured_column_list = N'DepartmentID, Name, GroupName' 
  , @filegroup_name = N'PRIMARY';
GO

请参阅

参考

其他资源