Udostępnij za pośrednictwem


sys.sp_cdc_add_job (języka Transact-SQL)

Tworzy zmiana przechwytywania oczyszczania lub przechwytywania danych zadanie w bieżącej bazie danych.

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

Składnia

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'
    Typ zadanie , aby dodać.job_typejest nvarchar(20) i nie może być NULL.Nieprawidłowe dane wejściowe są "Przechwytywanie" i "oczyszczania".

  • [ @start_job= ] start_job
    Flaga wskazująca, czy zadanie mają być uruchamiane natychmiast po dodaniu.start_jobjest bit z domyślną 1.

  • [ @ maxtrans ] = max_trans
    Maksymalna liczba transakcji do przetwarzania w każdym cyklu skanowania.max_transjest int z domyślną 500.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ślną 10.

    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ślną 1.

    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 w trakcie każdego skanowania, a następnie zamyka.

    continuousjest prawidłowa tylko dla zadań przechwytywania.

  • [ @ pollinginterval ] **=**polling_interval
    Liczba sekund między cyklów skanowania dziennika.polling_intervaljest bigint z domyślną 5.

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

  • [ @retention ] **=**retention
    Liczba minut, które zmieniają się dane, które wiersze są przechowywane w zmiany tabel.retentionjest bigint z domyślnymi 4320 (72 godziny).Wartość maksymalna wynosi 52494800 (100 lat).Jeśli określony, wartość musi być dodatnią liczbą całkowitą.

    retentionjest prawidłowa tylko dla zadań oczyszczania.

  • [ @ progu = ] 'delete_threshold"
    Maksymalna liczba wpisów delete, które można usunąć za pomocą pojedynczej instrukcja na oczyszczanie.delete_thresholdjest bigint z domyślną 5000.

Wartości kodów powrotnych

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

Zestawy wyników

Brak

Uwagi

Oczyszczanie zadanie jest tworzony przy użyciu wartości domyślnych, podczas pierwszej tabela w bazie danych jest włączony do przechwytywania danych zmian.Przechwytywanie zadanie jest tworzony przy użyciu wartości domyślnych, podczas pierwszej tabela w bazie danych jest włączony do przechwytywania danych zmiany i nie transakcyjnych publikacji istnieje w bazie danych.Gdy istnieje transakcyjnych publikacja czytnik transakcyjnych dzienników jest używany do kierowania mechanizm przechwytywania i przechwytywania oddzielne zadanie nie jest wymagane ani dozwolone.

Ponieważ zadania oczyszczania i przechwytywania są tworzone domyślnie, ta procedura składowana jest niezbędna tylko wtedy, gdy zadanie jawnie usunięty i muszą być odtworzone.

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

Aby wyświetlić bieżącą konfiguracja oczyszczania lub przechwytywanie zadanie, użyj sp_cdc_help_jobs.Aby zmienić konfiguracja zadanie, użyj sp_cdc_change_job.

Uprawnienia

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

Przykłady

A.Tworzenie przechwytywania zadanie

Poniższy przykład tworzy przechwytywania zadanie.W tym przykładzie założono, że istniejące Oczyszczanie zadanie został jawnie usunięty i muszą być odtworzone.zadanie jest tworzone przy użyciu wartości domyślnych.

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

B.Tworzenie zadanieoczyszczania

Poniższy przykład tworzy zadanie oczyszczania w AdventureWorks2008R2 bazy danych.Parametr @start_job jest zestaw na wartość 0 i @retention jest zestaw na 5760 minut (96 godzin).W tym przykładzie założono, że istniejące Oczyszczanie zadanie został jawnie usunięty i muszą być odtworzone.

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