sys.sp_cdc_change_job (Transact-SQL)sys.sp_cdc_change_job (Transact-SQL)

DIESES THEMA GILT FÜR:jaSQL Server (ab 2008)neinAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Ändert die Konfiguration eines Cleanup- oder Aufzeichnungsauftrags für Change Data Capture in der aktuellen Datenbank.Modifies the configuration of a change data capture cleanup or capture job in the current database. Um die aktuelle Konfiguration eines Auftrags anzuzeigen, Fragen Sie die cdc_jobs -Tabelle ab, oder verwenden Sie Sp_cdc_help_jobs.To view the current configuration of a job, query the dbo.cdc_jobs table, or use sp_cdc_help_jobs.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax


sys.sp_cdc_change_job [ [ @job_type = ] 'job_type' ]  
    [ , [ @maxtrans = ] max_trans ]   
    [ , [ @maxscans = ] max_scans ]   
    [ , [ @continuous = ] continuous ]   
    [ , [ @pollinginterval = ] polling_interval ]   
    [ , [ @retention ] = retention ]   
    [ @threshold = ] 'delete threshold'  

ArgumenteArguments

[ @job_type= ] "Job_type"[ @job_type= ] 'job_type'
Der Typ des zu ändernden Auftrags.Type of job to modify. Der Standardwert ist ist nvarchar(20) hat den Standardwert 'Capture'.job_type is nvarchar(20) with a default of 'capture'. Gültige Eingaben sind 'capture' und 'cleanup'.Valid inputs are 'capture' and 'cleanup'.

[ @maxtrans ] = Max_trans[ @maxtrans ] =max_trans
Maximale Anzahl der in jedem Scanzyklus zu verarbeitenden Transaktionen.Maximum number of transactions to process in each scan cycle. Max_trans ist Int hat den Standardwert NULL, gibt für diesen Parameter keine Änderung vorliegt.max_trans is int with a default of NULL, which indicates no change for this parameter. Wenn dieser Wert angegeben ist, muss er eine positive ganze Zahl annehmen.If specified, the value must be a positive integer.

Max_trans ist nur für aufzeichnungsaufträge gültig.max_trans is valid only for capture jobs.

[ @maxscans ] = Max_scans[ @maxscans ] =max_scans
Maximale Anzahl der Scanzyklen, die ausgeführt werden sollen, um alle Zeilen aus dem Protokoll zu extrahieren.Maximum number of scan cycles to execute in order to extract all rows from the log. Max_scans ist Int hat den Standardwert NULL, gibt für diesen Parameter keine Änderung vorliegt.max_scans is int with a default of NULL, which indicates no change for this parameter.

Max_scan ist nur für aufzeichnungsaufträge gültig.max_scan is valid only for capture jobs.

[ @continuous ] = fortlaufende[ @continuous ] =continuous
Gibt an, ob der Aufzeichnungsauftrag kontinuierlich (1) oder nur einmal (0) ausgeführt wird.Indicates whether the capture job is to run continuously (1), or run only once (0). kontinuierliche ist Bit hat den Standardwert NULL, gibt für diesen Parameter keine Änderung vorliegt.continuous is bit with a default of NULL, which indicates no change for this parameter.

Wenn fortlaufende = 1, der Sp_cdc_scan Auftrag überprüft das Protokoll und verarbeitet bis zu (Max_trans * Max_scans) Transaktionen.When continuous = 1, the sp_cdc_scan job scans the log and processes up to (max_trans * max_scans) transactions. Er wartet dann die Anzahl der Sekunden, die im angegebenen Polling_interval vor Beginn des nächsten protokollscans.It then waits the number of seconds specified in polling_interval before beginning the next log scan.

Wenn fortlaufende = 0, die Sp_cdc_scan Auftrag ausführt, bis zu Max_scans Scanvorgänge des Protokolls, verarbeitet dabei bis zu Max_trans Transaktionen während jedes Scanvorgangs und wird dann beendet.When continuous = 0, the sp_cdc_scan job executes up to max_scans scans of the log, processing up to max_trans transactions during each scan, and then exits.

Wenn @continuous von 1 in 0 geändert wird @pollinginterval automatisch auf 0 festgelegt ist.If @continuous is changed from 1 to 0, @pollinginterval is automatically set to 0. Ein Wert für angegeben @pollinginterval abgesehen 0 ignoriert wird.A value specified for @pollinginterval other than 0 is ignored.

Wenn @continuous weggelassen oder explizit auf NULL gesetzt und @pollinginterval wird explizit auf einen Wert größer 0 festgelegt, @continuous automatisch auf 1 festgelegt.If @continuous is omitted or explicitly set to NULL and @pollinginterval is explicitly set to a value greater than 0, @continuous is automatically set to 1.

fortlaufende ist nur für aufzeichnungsaufträge gültig.continuous is valid only for capture jobs.

[ @pollinginterval ] = Polling_interval[ @pollinginterval ] =polling_interval
Anzahl der Sekunden zwischen Protokollscan navigieren.Number of seconds between log scan cycles. Polling_interval ist "bigint" hat den Standardwert NULL, gibt für diesen Parameter keine Änderung vorliegt.polling_interval is bigint with a default of NULL, which indicates no change for this parameter.

Polling_interval ist nur für aufzeichnungsaufträge gültig Wenn Aufträge fortlaufende auf 1 festgelegt ist.polling_interval is valid only for capture jobs when continuous is set to 1.

[ @retention ] = Aufbewahrung[ @retention ] =retention
Die Anzahl von Minuten, für die Änderungszeilen in Änderungstabellen beibehalten werden sollen.Number of minutes that change rows are to be retained in change tables. Aufbewahrung ist "bigint" hat den Standardwert NULL, gibt für diesen Parameter keine Änderung vorliegt.retention is bigint with a default of NULL, which indicates no change for this parameter. Der Maximalwert beträgt 52494800 (100 Jahre).The maximum value is 52494800 (100 years). Wenn dieser Wert angegeben ist, muss er eine positive ganze Zahl annehmen.If specified, the value must be a positive integer.

Aufbewahrung ist nur für cleanupaufträge gültig.retention is valid only for cleanup jobs.

[ @threshold= ] "löschen Schwellenwert"[ @threshold= ] 'delete threshold'
Maximale Anzahl von Einträgen für Löschvorgänge, die mit einer einzelnen Anweisung beim Cleanup gelöscht werden können.Maximum number of delete entries that can be deleted using a single statement on cleanup. Löschen von Schwellenwert ist "bigint" hat den Standardwert NULL, gibt für diesen Parameter keine Änderung vorliegt.delete threshold is bigint with a default of NULL, which indicates no change for this parameter. Löschen von Schwellenwert ist nur für cleanupaufträge gültig.delete threshold is valid only for cleanup jobs.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

ResultsetsResult Sets

KeineNone

HinweiseRemarks

Wenn ein Parameter weggelassen, wird der zugeordnete Wert in der cdc_jobs Tabelle wird nicht aktualisiert.If a parameter is omitted, the associated value in the dbo.cdc_jobs table is not updated. Ein explizit auf NULL festgelegter Parameter wird so behandelt, als ob der Parameter weggelassen wird.A parameter set explicitly to NULL is treated as though the parameter is omitted.

Die Angabe eines für den Auftragstyp ungültigen Parameters führt dazu, dass die Anweisung fehlschlägt.Specifying a parameter that is invalid for the job type will cause the statement to fail.

Änderungen an einem Auftrag werden wirksam, bis der Auftrag beendet wird, mithilfe von Sp_cdc_stop_job und über Sp_cdc_start_job.Changes to a job do not take effect until the job is stopped by using sp_cdc_stop_job and restarted by using sp_cdc_start_job.

BerechtigungenPermissions

Erfordert die Mitgliedschaft in der Db_owner festen Datenbankrolle "".Requires membership in the db_owner fixed database role.

BeispieleExamples

A.A. Ändern eines AufzeichnungsauftragsChanging a capture job

Das folgende Beispiel aktualisiert die @job_type, @maxscans, und @maxtrans Parameter eines aufzeichnungsauftrags in der AdventureWorks2012 Datenbank.The following example updates the @job_type, @maxscans, and @maxtrans parameters of a capture job in the AdventureWorks2012 database. Die anderen gültigen Parameter für einen Aufzeichnungsauftrag, @continuous und @pollinginterval, werden weggelassen. Deren Werte werden nicht geändert.The other valid parameters for a capture job, @continuous and @pollinginterval, are omitted; their values are not modified.

USE AdventureWorks2012;  
GO  
EXECUTE sys.sp_cdc_change_job   
    @job_type = N'capture',  
    @maxscans = 1000,  
    @maxtrans = 15;  
GO  

B.B. Ändern eines CleanupauftragsChanging a cleanup job

Im folgenden Beispiel wird ein Cleanupauftrag in der AdventureWorks2012-Datenbank aktualisiert.The following example updates a cleanup job in the AdventureWorks2012 database. Alle gültigen Parameter für diesen Auftragstyp, außer @threshold , angegeben werden.All valid parameters for this job type, except @threshold, are specified. Der Wert der @threshold wird nicht geändert.The value of @threshold is not modified.

USE AdventureWorks2012;  
GO  
EXECUTE sys.sp_cdc_change_job   
    @job_type = N'cleanup',  
    @retention = 2880;  
GO  

Siehe auchSee Also

cdc_jobs ( Transact-SQL ) dbo.cdc_jobs (Transact-SQL)
Sys. sp_cdc_enable_table ( Transact-SQL ) sys.sp_cdc_enable_table (Transact-SQL)
sys.sp_cdc_add_job (Transact-SQL)sys.sp_cdc_add_job (Transact-SQL)