sys.sp_cdc_scan (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

変更データ キャプチャ ログ スキャン操作を実行します。

Transact-SQL 構文表記規則

構文

  
sys.sp_cdc_scan [ [ @maxtrans = ] max_trans ]   
     [ , [ @maxscans = ] max_scans ]   
     [ , [ @continuous = ] continuous ]   
     [ , [ @pollinginterval = ] polling_interval ]

引数

[ @maxtrans = ] max_trans 各スキャン サイクルで処理するトランザクションの最大数。 max_trans は int で、既定値は 500 です。

[ @maxscans = ] max_scans ログからすべての行を抽出するために実行するスキャン サイクルの最大数。 max_scans は int で、既定値は 10 です。

[ @continuous = ] continuous 1 回のスキャン サイクル (0) を実行した後でストアド プロシージャを終了するか、または継続的に実行するかを示します。スキャン サイクルを再実行する前に 、polling_interval によって指定された時間だけ一時停止します (1)。 continuous は tinyint で、既定値は 0 です。

[ @pollinginterval = ] polling_interval ログ スキャン サイクル間の秒数。 polling_interval は bigint で、既定値は 0 です。

リターン コードの値

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

結果セット

なし

解説

SQL Server エージェント キャプチャ ジョブが変更データ キャプチャによって使用されている場合、sys.sp_cdc_scanはsys.sp_MScdc_capture_jobによって内部的に呼び出されます。 変更データ キャプチャのログ スキャン操作が既にアクティブである場合、またはデータベースのトランザクション レプリケーションが有効になっている場合は、プロシージャは明示的に実行できません。 このストアド プロシージャは、自動的に構成されるキャプチャ ジョブの動作をカスタマイズする管理者が使用する必要があります。

アクセス許可

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

参照

dbo.cdc_jobs (Transact-SQL)