sys.sp_cdc_disable_table (Transact-SQL)
適用対象:SQL Server
指定したソース テーブルの変更データ キャプチャと、現在のデータベース内のキャプチャ インスタンスを無効にします。 変更データ キャプチャは、Microsoft SQL Server のすべてのエディッションで使用できるわけではありません。 SQL Serverの各エディションでサポートされる機能の一覧については、「 SQL Server 2016 の各エディションがサポートする機能」を参照してください。
構文
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 AdventureWorks2012;
GO
EXECUTE sys.sp_cdc_disable_table
@source_schema = N'HumanResources',
@source_name = N'Employee',
@capture_instance = N'HumanResources_Employee';