sys.sp_cdc_disable_table (Transact-SQL)

適用対象:SQL Server

指定したソース テーブルの変更データ キャプチャと、現在のデータベース内のキャプチャ インスタンスを無効にします。 変更データ キャプチャは、Microsoft SQL Server のすべてのエディッションで使用できるわけではありません。 SQL Serverの各エディションでサポートされる機能の一覧については、「 SQL Server 2016 の各エディションがサポートする機能」を参照してください。

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_schemasysname で、既定値は指定せず、NULL にすることはできません。

source_schema は、現在のデータベースに存在する必要があります。

[ @source_name = ] 'source\_name' 変更データ キャプチャを無効にするソース テーブルの名前を指定します。 source_namesysname で、既定値は指定せず、NULL にすることはできません。

source_name は、現在のデータベースに存在する必要があります。

[ @capture_instance = ] 'capture\_instance' | 'all' 指定したソース テーブルに対して無効にするキャプチャ インスタンスの名前を指定します。 capture_instancesysname であり、NULL にすることはできません。

'all' を指定すると、 source_name に対して定義されているすべてのキャプチャ インスタンスが無効になります。

リターン コードの値

0 (成功) または 1 (失敗)

結果セット

なし

解説

sys.sp_cdc_disable_table は、指定されたソース テーブルとキャプチャ インスタンスに関連付けられている変更データ キャプチャ変更テーブルとシステム関数を削除します。 指定されたキャプチャ インスタンスに関連付けられている行が変更データ キャプチャ システム テーブルから削除され、sys.tables カタログ ビューのテーブル エントリのis_tracked_by_cdc列が 0 に設定されます。

アクセス許可

db_owner 固定データベース ロール内でメンバーシップが必要です。

次の例では、テーブルの変更データ キャプチャを HumanResources.Employee 無効にします。

USE AdventureWorks2012;  
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)