sys.sp_cdc_disable_table (Transact-SQL)
适用于:SQL Server
对当前数据库中指定的源表和捕获实例禁用变更数据捕获。 并非每个版本的 SQL Server 都提供变更数据捕获。 有关 SQL Server 各个版次支持的功能列表,请参阅 SQL Server 2022 的各个版次及其支持的功能。
语法
sys.sp_cdc_disable_table
[ @source_schema = ] 'source_schema'
, [ @source_name = ] 'source_name'
[ , [ @capture_instance = ] { 'capture_instance' | 'all' } ]
[ ; ]
参数
[ @source_schema = ] 'source_schema'
包含源表的架构的名称。 @source_schema 为 sysname,没有默认值,不能为 NULL。
当前 数据库中必须存在@source_schema。
[ @source_name = ] 'source_name'
要从中禁用变更数据捕获的源表的名称。 @source_name 为 sysname,没有默认值,不能为 NULL。
当前 数据库中必须存在@source_name。
[ @capture_instance = ] { 'capture_instance' |'all' }
要为指定的源表禁用的捕获实例的名称。 @capture_instance 为 sysname ,不能为 NULL。
指定 时 'all'
,将禁用为 @source_name 定义的所有捕获实例。
返回代码值
0
(成功) 或 1
(失败) 。
结果集
无。
备注
sys.sp_cdc_disable_table
删除与指定的源表和捕获实例关联的变更数据捕获更改表和系统函数。 它从变更数据捕获系统表中删除与指定捕获实例关联的任何行,并将 sys.tables 目录视图中表条目的列设置为 0
is_tracked_by_cdc
。
权限
要求具有 db_owner 固定数据库角色中的成员资格。
示例
下例对 HumanResources.Employee
表禁用了变更数据捕获。
USE AdventureWorks2022;
GO
EXECUTE sys.sp_cdc_disable_table
@source_schema = N'HumanResources',
@source_name = N'Employee',
@capture_instance = N'HumanResources_Employee';