sys.sp_cdc_scan (Transact-SQL)sys.sp_cdc_scan (Transact-SQL)

適用対象: ○SQL Server XAzure SQL Database XAzure SQL Data Warehouse XParallel Data WarehouseAPPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

変更データ キャプチャのログ スキャン操作を実行します。Executes the change data capture log scan operation.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

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

引数Arguments

[ @maxtrans = ] max_trans 各スキャン サイクルで処理するトランザクションの最大数。[ @maxtrans = ] max_trans Maximum number of transactions to process in each scan cycle. max_transint既定値は 500 です。max_trans is int with a default of 500.

[ @maxscans = ] max_scans ログからすべての行を抽出するために実行するスキャン サイクルの最大数。[ @maxscans = ] max_scans Maximum number of scan cycles to execute in order to extract all rows from the log. max_scansint既定値は 10 です。max_scans is int with a default of 10.

[ @continuous = ] continuous ストアド プロシージャが単一のスキャン サイクル (0) 後に終了する必要があるかどうか、または連続して実行で指定された時間一時停止かどうかを示すpolling_intervalしてスキャン サイクル (1) する前にします。[ @continuous = ] continuous Indicates whether the stored procedure should end after executing a single scan cycle (0) or run continuously, pausing for the time specified by polling_interval before reexecuting the scan cycle (1). 継続的なtinyint既定値は 0。continuous is tinyint with a default of 0.

[ @pollinginterval = ] polling_interval ログ スキャン サイクルの間隔の秒数です。[ @pollinginterval = ] polling_interval Number of seconds between log scan cycles. polling_intervalbigint既定値は 0。polling_interval is bigint with a default of 0.

リターン コードの値Return Code Values

0 (成功) または1 (失敗)0 (success) or 1 (failure)

結果セットResult Sets

なしNone

コメントRemarks

SQL ServerSQL Server エージェントのキャプチャ ジョブが変更データ キャプチャによって使用されている場合、sys.sp_cdc_scan は sys.sp_MScdc_capture_job によって内部的に呼び出されます。sys.sp_cdc_scan is called internally by sys.sp_MScdc_capture_job if the SQL ServerSQL Server Agent capture job is being used by change data capture. 変更データ キャプチャのログ スキャン操作が既にアクティブである場合、またはデータベースのトランザクション レプリケーションが有効になっている場合は、プロシージャは明示的に実行できません。The procedure cannot be executed explicitly when a change data capture log scan operation is already active or when the database is enabled for transactional replication. 自動的に構成されているキャプチャ ジョブの動作をカスタマイズする管理者によってこのストアド プロシージャを使用する必要があります。This stored procedure should be used by administrators who want to customize the behavior of the capture job that is automatically configured.

アクセス許可Permissions

db_owner 固定データベース ロールのメンバーシップが必要です。Requires membership in the db_owner fixed database role.

関連項目See Also

dbo.cdc_jobs (TRANSACT-SQL)dbo.cdc_jobs (Transact-SQL)