sys.sp_cdc_disable_table （Transact-SQL）

  • 發行項

適用於：SQL Server

停用指定源數據表的異動數據擷取，並在目前資料庫中擷取實例。 變更數據擷取不適用於每個 SQL Server 版本。 如需 SQL Server 版本支援的功能清單，請參閱 SQL Server 2022 的版本和支援功能。

Transact-SQL 語法慣例

語法

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 目錄檢視中資料表項目的資料行設定is_tracked_by_cdc為 0。

權限

需要 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';

相關內容