Udostępnij za pośrednictwem

  • Artykuł

sys.sp_cdc_add_job (Transact-SQL)

Zmiana zadanie oczyszczania lub przechwytywania przechwytywania danych tworzy w bieżącej bazie danych.

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

sys.sp_cdc_add_job [ @job_type = ] 'job_type'
    [ , [ @start_job = ] start_job ] 
    [ , [ @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 add.job_type is nvarchar(20) and cannot be NULL.Są prawidłowe dane wejściowe "Przechwytywanie" and "oczyszczania".

  • [ @start_job= ] start_job
    Flag indicating whether the job should be started immediately after it is added.start_job is bit with a default of 1.

  • [ @ maxtrans = max_trans
    Maximum number of transactions to process in each scan cycle.max_trans is int with a default of 500.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 10.

    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 1.

    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 transakcja podczas każdego skanowania, a następnie wyjścia.

    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 5.

    polling_interval jest prawidłowy tylko w przypadku przechwytywania podczas zadań continuous jest zestaw na 1. Jeśli określony, wartość nie może być ujemna i nie może przekraczać 24 godzin.Jeżeli określono wartość 0, nie ma żadnych oczekiwania między dziennika skanowania.

  • [ @retention ] **=**retention
    Number of minutes that change data rows are to be retained in change tables.retention is bigint with a default of 4320 (72 hours).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 by using a single statement on cleanup.delete_threshold is bigint with a default of 5000.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Zestawy wyników

None

Remarks

zadanie oczyszczania jest tworzona przy użyciu wartości domyślnych, gdy pierwsza tabela w bazie danych jest włączony do przechwytywania danych zmian.Zadanie przechwytywania jest tworzone przy użyciu wartości domyślne, po pierwszej tabela w bazie danych jest włączony do przechwytywania danych zmiany i nie transakcyjnych publikacji istnieje w bazie danych.Po transakcyjnych publikacja istnieje, czytnik transakcyjnych dzienników jest używane do kierowania mechanizm przechwytywania i zadanie oddzielne przechwytywania nie jest wymagane ani dozwolone.

Ponieważ zadania oczyszczania i przechwytywania są tworzone domyślnie, ta procedura przechowywana jest konieczne tylko wtedy, gdy zadanie jawnie usunięta i trzeba ponownie utworzyć.

Nazwa zadanie jest CDC. <_cleanup>nazwa_bazy_danych lub CDC. <nazwa_bazy_danych>_capture, gdzie <nazwa_bazy_danych> jest to nazwa bieżącej bazy danych. Jeśli zadanie o takiej samej nazwie już istnieje, nazwa jest dołączana z okresu (. ) następuje identyfikator unikatowy, na przykład: FC 428 CDC.AdventureWorks_capture.A1ACBDED 13 C-8302-10100EF74F52.

Aby wyświetlić bieżącą konfiguracja zadanie oczyszczania lub przechwytywania, należy użyć sp_cdc_help_jobs.Aby zmienić konfiguracja zadanie, należy użyć sp_cdc_change_job.

Uprawnienia

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

Przykłady

A.Tworzenie zadanie przechwytywania

Poniższy przykład tworzy zadanie przechwytywania.W tym przykładzie założono, że istniejące zadanie oczyszczania został jawnie usunięty, a trzeba ponownie utworzyć.Zadanie jest tworzone przy użyciu wartości domyślnych.

USE AdventureWorks;
GO
EXEC sys.sp_cdc_add_job @job_type = N'capture';
GO

B.Tworzenie zadanie oczyszczania

Poniższy przykład tworzy zadanie oczyszczania w AdventureWorks Baza danych. Parametr @start\_job jest równa 0 i @retention jest ustawiona na 5760 minut (96 godzin). W tym przykładzie założono, że istniejące zadanie oczyszczania został jawnie usunięty, a trzeba ponownie utworzyć.

USE AdventureWorks;
GO
EXEC sys.sp_cdc_add_job
     @job_type = N'cleanup'
    ,@start_job = 0
    ,@retention = 5760;