sys.sp_cdc_disable_table (Transact-SQL)

現在のデータベース内の指定したソース テーブルおよびキャプチャ インスタンスを対象に、変更データ キャプチャを無効にします。変更データ キャプチャは、SQL Server 2008 Enterprise Edition、Developer Edition、および Evaluation Edition でのみ使用できます。

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 AdventureWorks2008R2;
GO
EXECUTE sys.sp_cdc_disable_table 
    @source_schema = N'HumanResources', 
    @source_name = N'Employee',
    @capture_instance = N'HumanResources_Employee';

関連項目

参照

sys.sp_cdc_enable_table (Transact-SQL)