sys.sp_cdc_change_job (języka Transact-SQL)

Modyfikuje konfiguracja zmiana przechwytywania oczyszczania lub przechwytywania danych zadanie w bieżącej bazie danych.Aby wyświetlić bieżącą konfiguracja zadanie, kwerenda dbo.cdc_jobs tabelalub wykorzystania sp_cdc_help_jobs.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

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'
    Typ zadanie do zmodyfikowania.job_typejest nvarchar(20) z domyślnymi "Przechwytywanie".Prawidłowe są "Przechwytywanie" i "czyszczenie".

  • [ @maxtrans ] **=**max_trans
    Maksymalna liczba transakcji do przetwarzania w każdym cyklu skanowania.max_transjest int z domyślnej wartości NULL, co oznacza żadna zmiana tego parametru.Jeśli określony, wartość musi być dodatnią liczbą całkowitą.

    max_transjest prawidłowa tylko dla zadań przechwytywania.

  • [ @maxscans ] **=**max_scans
    Maksymalna liczba skanowania cykli do wykonać w celu wyodrębnić wszystkie wiersze z dziennika.max_scansjest int z domyślnej wartości NULL, co oznacza żadna zmiana tego parametru.

    max_scanjest prawidłowa tylko dla zadań przechwytywania.

  • [ @ ciągłego ] **=**continuous
    Wskazuje, czy działania ciągłego przechwytywania zadanie (1) lub uruchomić tylko raz (0).continuousjest bit z domyślnej wartości NULL, co oznacza żadna zmiana tego parametru.

    Gdy continuous = 1, sp_cdc_scan zadanie skanuje dziennika i do przetwarzania (max_trans * max_scans) transakcje.Następnie czeka liczba sekund określona w polling_interval przed rozpoczęciem następnego skanowania dziennika.

    Gdy continuous = 0, sp_cdc_scan zadanie wykonuje się do max_scans skanuje z przetwarzania do dziennika max_trans transakcji podczas każdego skanowania, a następnie zamyka.

    Jeśli @ ciągłego zmieniona z 1 na 0, @ pollinginterval zostanie automatycznie zestaw na 0.Wartość określona dla @ pollinginterval innych niż 0 jest ignorowana.

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

    continuousjest prawidłowa tylko dla zadań przechwytywania.

  • [ @ pollinginterval ] **=**polling_interval
    Liczba sekund między cyklów skanowania dziennika.polling_intervaljest bigint z domyślnej wartości NULL, co oznacza żadna zmiana tego parametru.

    polling_intervaljest prawidłowy tylko w przypadku przechwytywania zadaniach przy continuous jest zestaw na wartość 1.

  • [ @retention ] **=**retention
    Liczba minut, które zmieniają się wiersze są przechowywane w tabelach zmiany.retentionjest bigint z domyślnej wartości NULL, co oznacza żadna zmiana tego parametru.Wartość maksymalna wynosi 52494800 (100 lat).Jeśli określony, wartość musi być dodatnią liczbą całkowitą.

    retentionjest prawidłowa tylko dla zadań oczyszczania.

  • [ @threshold= ] 'delete threshold'
    Maksymalna liczba wpisów delete, które można usunąć za pomocą pojedynczej instrukcja na oczyszczanie.delete thresholdjest bigint z domyślnej wartości NULL, co oznacza żadna zmiana tego parametru.delete thresholdjest prawidłowa tylko dla zadań oczyszczania.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Zestawy wyników

Brak

Uwagi

Jeśli parametr zostanie pominięty, wartość skojarzoną w dbo.cdc_jobsnie jest aktualizowanatabela . Parametr zestaw jawnie NULL jest traktowana tak, jakby został pominięty.

Określenie parametru jest nieprawidłowa dla typu zadanie spowoduje, że instrukcja nie powiedzie się.

Zmiany zadanie nie zostały wprowadzone, dopóki zadanie nie zostanie zatrzymana przy użyciu sp_cdc_stop_job i ponownie uruchomiony za pomocą sp_cdc_start_job.

Uprawnienia

Wymaga członkostwa w db_owner rola bazy danychstałej.

Przykłady

A.Zmiana przechwytywania zadanie

Następujące aktualizacje przykład @job_type, @maxscans, i @maxtrans parametrów przechwytywania zadanie w AdventureWorks2008R2 bazy danych.Prawidłowe parametry przechwytywania zadanie @continuous i @pollinginterval, są pomijane; ich wartości nie są modyfikowane.

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

B.Zmiana Oczyszczanie zadanie

Poniższy przykład aktualizacje zadanie oczyszczania w AdventureWorks2008R2 bazy danych.Wpisz wszystkie prawidłowe parametry dla tego zadanie , z wyjątkiem @ próg, są określone.Wartość @ próg nie jest modyfikowany.

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