Udostępnij za pośrednictwem


sys.sp_cdc_change_job (języka Transact-SQL)

Modyfikuje konfiguracja zmiany przechwytywania oczyszczania lub przechwytywania zadanie danych w bieżącej bazie danych.Aby wyświetlić bieżącą konfiguracja zadanie, należy zbadać dbo.cdc_jobs tabela lub wykorzystania sp_cdc_help_jobs.

Topic link iconKonwencje składni języka Transact-SQL

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'

Argumenty

  • [ @job_type= ] 'job_type'
    Type of job to modify.job_type is nvarchar(20) with a default of 'capture'.Prawidłowe dane wejściowe są "Przechwytywanie" i "oczyszczania".

  • [ @maxtrans ] **=**max_trans
    Maximum number of transactions to process in each scan cycle.max_trans is int with a default of NULL, which indicates no change for this parameter.Jeśli określony, wartość musi być dodatnią liczbą całkowitą.

    max_trans jest prawidłowa tylko dla zadań przechwytywania.

  • [ @maxscans ] **=**max_scans
    Maximum number of scan cycles to execute in order to extract all rows from the log.max_scans is int with a default of NULL, which indicates no change for this parameter.

    max_scan jest prawidłowa tylko dla zadań przechwytywania.

  • [ @continuous ] **=**continuous
    Indicates whether the capture job is to run continuously (1), or run only once (0).continuous is bit with a default of NULL, which indicates no change for this parameter.

    Kiedy continuous = 1, sp_cdc_scan zadanie skanowania w dzienniku i przetwarza do (max_trans * max_scans) transakcji. Następnie czeka liczbę sekund określoną w polling_interval przed rozpoczęciem następnego skanowania dziennika.

    Kiedy continuous = 0, sp_cdc_scan wykonuje zadanie max_scans skanowanie z przetwarzania do dziennika max_trans transakcji podczas każdej skanowania, a następnie wyjścia.

    Jeśli @ ciągłe została zmieniona z 1 na 0, @ pollinginterval jest automatycznie zestaw na 0.Wartość określona dla @ pollinginterval inną niż 0 jest ignorowana.

    Jeśli @ ciągłe zostanie pominięty lub jawnie zestaw NULL i @ pollinginterval jest jawnie zestaw na wartość większą niż 0, @ ciągłe jest automatycznie zestaw na 1.

    continuous jest prawidłowa tylko dla zadań przechwytywania.

  • [ @pollinginterval ] **=**polling_interval
    Number of seconds between log scan cycles.polling_interval is bigint with a default of NULL, which indicates no change for this parameter.

    polling_interval jest prawidłowy tylko w przypadku przechwytywania podczas zadań continuous jest zestaw na 1.

  • [ @retention ] **=**retention
    Number of minutes that change rows are to be retained in change tables.retention is bigint with a default of NULL, which indicates no change for this parameter.Maksymalna wartość to 52494800 (100 lat).Jeśli określony, wartość musi być dodatnią liczbą całkowitą.

    retention jest prawidłowa tylko dla zadań oczyszczania.

  • [ @threshold= ] 'delete threshold'
    Maximum number of delete entries that can be deleted using a single statement on cleanup.delete threshold is bigint with a default of NULL, which indicates no change for this parameter.delete threshold is valid only for cleanup jobs.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Zestawy wyników

None

Remarks

Jeśli parametr zostanie pominięty, wartość skojarzona z dbo.cdc_jobs tabela nie jest aktualizowany.Parametr wartość jawnie NULL jest traktowana tak, jakby ten parametr zostanie pominięty.

Określając parametr, który jest nieprawidłowy dla typu zadanie spowoduje, że instrukcja nie powiedzie się.

Zmiany wprowadzone do zadania te odniosą skutek, dopóki zadanie nie zostanie zatrzymana przy użyciu sp_cdc_stop_job i ponownego uruchomienia przy użyciu sp_cdc_start_job.

Uprawnienia

Członkostwo w grupie wymaga db_owner stała rola bazy danych.

Przykłady

A.Zmiana zadanie przechwytywania

Następujące aktualizacje przykład @job\_type, @maxscans, a @maxtrans Parametry zadanie przechwytywania w AdventureWorks Baza danych. Inne prawidłowe parametry zadanie przechwytywania @continuous i @pollinginterval, zostały pominięte; ich wartości nie są modyfikowane.

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

B.Zmiana zadanie oczyszczania

W poniższym przykładzie aktualizuje zadanie oczyszczania w AdventureWorks Baza danych. Wpisz wszystkich prawidłowych parametrów dla tego zadanie, z wyjątkiem próg @, są określone.Wartość próg @ nie jest modyfikowany.

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