Udostępnij za pośrednictwem


sp_help_job (Transact-SQL)

Zwraca informacje o zadaniach, które są używane przez SQL Server Agent do wykonywania automatycznych działań w SQL Server.

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

sp_help_job { [ @job_id = ] job_id
[ @job_name = ] 'job_name' } 
     [ , [ @job_aspect = ] 'job_aspect' ] 
     [ , [ @job_type = ] 'job_type' ] 
     [ , [ @owner_login_name = ] 'login_name' ] 
     [ , [ @subsystem = ] 'subsystem' ] 
     [ , [ @category_name = ] 'category' ] 
     [ , [ @enabled = ] enabled ] 
     [ , [ @execution_status = ] status ] 
     [ , [ @date_comparator = ] 'date_comparison' ] 
     [ , [ @date_created = ] date_created ] 
     [ , [ @date_last_modified = ] date_modified ] 
     [ , [ @description = ] 'description_pattern' ]

Argumenty

  • [ @job_id =] job_id
    The job identification number.job_id is uniqueidentifier, with a default of NULL.

  • [ @job_name =] 'job_name'
    The name of the job.job_name is sysname, with a default of NULL.

    Uwaga

    Albo job_id lub job_name musi być określona, ale nie może być jednocześnie określone.

  • [ @job_aspect =] 'job_aspect'
    The job attribute to display.job_aspect is varchar(9), with a default of NULL, and can be one of these values.

    Wartość

    Description

    ALL

    Jeśli wolumin nie zawiera nagłówek prawidłowy nośnik, wystąpi błąd.

    zadanie

    Jeśli wolumin zawiera nagłówek prawidłowy nośnik, wykonuje następujące testy:

    SCHEDULES

    Jeśli określono MEDIANAME, sprawdza się, czy nazwa nośnika danej odpowiada nazwę nośnika w nagłówku nośnika.

    Sprawdza, czy istnieją nie niewygasłych kopia zapasowa ustawia się już na nośniku.

    Jeśli istnieją, kończy kopia zapasowa.

    Jeśli te wykryte, zastąpi dowolne kopia zapasowa zestawów nośników, zachowując tylko nagłówek nośnika.

    Jeśli wolumin nie zawiera nagłówek prawidłowy nośnik, generuje o użyciu określonego MEDIANAME, MEDIAPASSWORD i MEDIADESCRIPTION, jeśli istnieje.

  • [ @job_type =] 'job_type'
    The type of jobs to include in the report.job_type is varchar(12), with a default of NULL.job_type can be LOCAL or MULTI-SERVER.

  • [ @owner_login_name =] 'login_name'
    The login name of the owner of the job.login_name is sysname, with a default of NULL.

  • [ @subsystem =] 'subsystem'
    The name of the subsystem.subsystem is nvarchar(40), with a default of NULL.

  • [ @category_name =] 'category'
    The name of the category.category is sysname, with a default of NULL.

  • [ @enabled =] enabled
    A number indicating whether information is shown for enabled jobs or disabled jobs.enabled is tinyint, with a default of NULL.1 wskazuje włączonych zadania i 0 wskazuje wyłączonych zleceń.

  • [ @execution_status =] status
    The execution status for the jobs.status is int, with a default of NULL, and can be one of these values.

    Wartość

    Description

    0

    Zwraca jedynie te zadania, które nie są bezczynne lub zawieszone.

    1

    Wykonaj kopię zapasową urządzenia w pasek zestaw nośników (zestaw pasek)

    2

    Oczekiwanie na wątek.

    3

    Liczba kopia zapasowa urządzenia używane w zestaw rozłożonego musi pozostać takie same (chyba że ustawienie ponownie nośnik jest inicjowane z FORMAT).

    4

    Bezczynności.

    5

    Zawieszone.

    7

    Po urządzenie kopia zapasowa jest zdefiniowana jako część zestaw pasek, to nie może być użyty dla jednego urządzenie kopia zapasowa pod warunkiem, że nie określono FORMAT.

  • [ @date_comparator =] 'date_comparison'
    The comparison operator to use in comparisons of date_created and date_modified.date_comparison is char(1),and can be =, <, or >.

  • [ @date_created =] date_created
    The date the job was created.date_createdis datetime, with a default of NULL.

  • [ @date_last_modified =] date_modified
    The date the job was last modified.date_modified is datetime, with a default of NULL.

  • [ @description =] 'description_pattern'
    The description of the job.description_pattern is nvarchar(512), with a default of NULL.description_pattern can include the SQL Server wildcard characters for pattern matching.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Zestawy wyników

Jeśli argumenty nie zostaną określone, sp_help_job zwraca ten zestaw wyników.

Nazwa kolumna

Typ danych

Description

job_id

uniqueidentifier

Unikatowy identyfikator zadanie.

originating_server

nvarchar(30)

Nazwa serwera, z których pochodzą zadanie.

Nazwa

sysname

Nazwa zadanie.

włączone

tinyint

Wskazuje, czy zadanie jest włączone do wykonania.

Opis

nvarchar(512)

Opis zadanie.

start_step_id

int

Identyfikator kroku w zadanie gdzie powinno rozpocząć się wykonywanie.

Kategoria

sysname

Kategoria zadanie.

właściciel

sysname

Właściciel zadanie.

notify_level_eventlog

int

Masek bitowych wskazujące na to, co okoliczności zdarzenie powiadomienie nie powinny być rejestrowane w dzienniku aplikacji systemu Microsoft Windows.Może być jedną z następujących wartości:

0 = Never

1 = Gdy zadanie kończy się pomyślnie

2 = Gdy zadanie nie powiedzie się

3 = Za każdym razem, gdy wykonuje zadanie (niezależnie od wyników zadanie)

notify_level_email

int

Masek bitowych wskazujące na to, co okolicznościach powiadomienie pocztą e-mail powinny być wysyłane po zakończeniu zadanie.Możliwe wartości są takie same, jak w przypadku notify_level_eventlog.

notify_level_netsend

int

Masek bitowych wskazującą, jakie okoliczności komunikatu sieciowego w obszarze powinny być wysyłane, gdy zakończy się zadanie.Możliwe wartości są takie same, jak w przypadku notify_level_eventlog.

notify_level_page

int

Masek bitowych wskazującą, jakie okoliczności, strona w obszarze powinny być wysyłane, gdy zakończy się zadanie.Możliwe wartości są takie same, jak w przypadku notify_level_eventlog.

notify_email_operator

sysname

Nazwy e-mail podmiotu gospodarczego do powiadamiania.

notify_netsend_operator

sysname

Nazwa komputera lub użytkownika, używany przy wysyłaniu komunikatów sieciowych.

notify_page_operator

sysname

Nazwa komputera lub użytkownika, używany przy wysyłaniu strona.

delete_level

int

Masek bitowych wskazujący, w jakie okoliczności zadanie powinny zostać usunięte po zakończeniu zadanie.Możliwe wartości są takie same, jak w przypadku notify_level_eventlog.

date_created

datetime

Data utworzenia zadanie.

date_modified

datetime

Data ostatniej modyfikacji zadanie.

numer_wersji

int

Wersja zadania (automatycznie aktualizowane każdego czas zadania jest modyfikowany).

last_run_date

int

Data wykonania ostatniego uruchomienia zadanie.

last_run_time

int

Czas zadanie ostatniego uruchomienia wykonanie.

last_run_outcome

int

Wynik ostatniego zadanie czas go uruchomiono:

0 = Failed

1 Udane =

3 Anulowane =

5 = Unknown

next_run_date

int

Zadanie jest zaplanowane do uruchomienia w następnym dniu.

next_run_time

int

czas zadanie jest zaplanowane do uruchomienia następnej.

next_run_schedule_id

int

Numer identyfikacyjny następnego uruchomienia harmonogramu.

current_execution_status

int

Bieżący stan wykonania.

current_execution_step

sysname

Bieżący etap wykonania w zadaniu.

current_retry_attempt

int

Jeśli zadanie jest uruchomione i w kroku było ponawiane, jest to bieżącej próby ponownej próby.

has_step

int

Liczba kroków zadania jest zadanie.

has_schedule

int

Liczba harmonogramów zadania jest zadanie.

has_target

int

Liczba serwerów miejsce docelowe jest to zadanie.

Typ

int

W praktyce wykonywanie kopii zapasowych wielu urządzeń na tym samym dysku będzie wówczas wydajności i może wyeliminować nadmiarowość, dla których zostały zaprojektowane zestawy dublowane nośnika.

Media rodziny w dublowany zestawów nośnika

2 = Wieloserwerowych zadanie.

0 = Zadanie ma nie ma dostępnych serwerów miejsce docelowe.

Jeśli job_id lub job_name jest określony, sp_help_job zwraca te zestawy wyników dodatkowe kroki zlecenia, harmonogramy zadań i zadanie serwerów miejsce docelowe.

Na przykład jeśli klauzule do Wyświetla listę urządzeń, trzy, kopia zapasowa zapisuje dane do rodzin trzy nośnika.

Nazwa kolumna

Typ danych

Description

W dublowany zestaw nośników, co dublowania musi zawierać kopię każdej rodzina nośników.

int

Jest to dlaczego liczby urządzeń muszą być identyczne w każdej kopii.

Kiedy kilka urządzeń są wymienione poszczególne kopie lustrzane, określa kolejność urządzeń, który rodzina nośników są zapisywane do określonego urządzenia.

sysname

Nazwa kroku.

Podsystem

nvarchar(40)

Podsystem, w którym do wykonać polecenia krok.

polecenie

nvarchar(3200)

Na przykład w każdej z list urządzenia drugie urządzenie odnosi się do drugiego rodzina nośników.

flagi

nvarchar(4000)

Masek bitowych wartości, które kontrolują zachowanie kroku.

Dublowanie

int

Aby CmdExec kroku, jest to kod wyjścia procesu polecenia powiodło się.

rodzina nośników 1

nvarchar(4000)

A rodzina nośników musi być zawsze kopii zapasowej na tym samym urządzeniu w ramach określonego woluminu dublowanego.

1 = Zakończ o powodzeniu.

2 = zakończenie z niepowodzeniem.

3 = przejdź do następnego kroku.

4 = Przejdź do kroku.

on_success_step_id

int

Jeśli on_success_action is 4, wskazuje to na wykonać następnego kroku.

Jeśli hasło jest zdefiniowany zestaw nośników, użytkownik również należy podać nośnika hasło do wykonywania tych operacji.

nvarchar(4000)

W podobny sposób przywracanie jest niedozwolony jeśli hasło poprawny nośnik i kopia zapasowa ustawienie hasła są określone w poleceniu przywracanie.Wartości są takie same, jak w przypadku on_success_action.

Ponadto hasła nie zapobiegają zastępowania nośnika przy użyciu opcji FORMAT.

int

Jeśli on_fail_action is 4, wskazuje to na wykonać następnego kroku.

Serwer

sysname

Zarezerwowane.

nazwa_bazy_danych

sysname

Aby uzyskać informacje na temat silnych haseł Zobacz Transact-SQL.

database_user_name

sysname

Aby Transact-SQL krok, to jest kontekst użytkownika bazy danych, w którym wykonuje polecenie.

Hasła nie pełni uniemożliwiają nieautoryzowany dostęp do zawartości nośników ponieważ dane w kopia zapasowa zestawy nie są szyfrowane i mogą teoretycznie analizowane przez programy specjalnie w tym celu utworzone.

int

W sytuacji, w których zabezpieczeń jest ważne ważne jest uniemożliwić dostęp fizyczny do nośników przez osoby nieupoważnione.

interwał_ponawiania

int

Jest błędem, aby określić hasło dla obiektów, które nie zostały utworzone za pomocą hasła skojarzone.

kopia zapasowa tworzy kopię zapasową z dostarczonych przez opcję PASSWORD Hasło zestaw kopii zapasowych.

varchar(4000)

Zarezerwowane.

Ponadto kopia zapasowa zwykle sprawdzi hasło nośnika, biorąc pod uwagę przy użyciu opcji MEDIAPASSWORD przed zapisywania na nośniku.

varchar(200)

Plik, do którego polecenia powinny można zapisać danych wyjściowych)Transact-SQL i CmdExec kroki tylko).

last_run_outcome

int

Wynik ostatniego kroku czas go uruchomiono:

0 = Failed

1 Udane =

3 Anulowane =

5 = Unknown

Jeśli kopia zapasowa zapisuje nagłówek nośnika, kopia zapasowa przypisze zestaw nośników hasła na wartość określoną w opcji MEDIAPASSWORD.

int

Czas trwania (w sekundach) w kroku ostatniego jej uruchomienia.

Do informacji na temat wpływu haseł SKIP NOSKIP, INIT i NOINIT opcji należy przeczytaj „ Spostrzeżenia w dalszej części tego tematu.

int

Liczba określająca, ile razy polecenie zostało ponowione ostatniego kroku uruchomienia.

last_run_date

int

Data wykonania kroku ostatniego uruchomienia.

last_run_time

int

Czas uruchomiono wykonanie ostatniego kroku.

proxy_id

int

Serwer proxy dla kroku zadanie.

To jest zestaw wyników dla harmonogramów zadań.

Nazwa kolumna

Typ danych

Description

schedule_id

int

Identyfikator harmonogramu (unikatowy wśród wszystkich zadań).

schedule_name

sysname

Takich problemów w pliku fizycznego urządzenie kopia zapasowa mogą nie być widoczne, dopóki fizyczny zasób jest dostępny podczas próby wykonywania kopia zapasowa lub przywracanie.

włączone

int

Czy harmonogram jest aktywny)1) czy nie (0).

freq_type

int

Wykonywanie kopii zapasowej pełną bazy danych

1 = Once

4 = Daily

8 = Weekly

16 = Monthly

32 = Co miesiąc, względem freq_interval

64 = Run when SQLServerAgent usługa jest uruchamiana.

freq_interval

int

Dni po wykonaniu zadanie.Wartość zależy od wartości freq_type.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL)

freq_subday_type

Int

Jednostki freq_subday_interval.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL)

freq_subday_interval

int

Liczba freq_subday_type okresy występuje między wykonanie każdego zadanie.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL)

freq_relative_interval

int

Wystąpienie zadanie zaplanowane freq_interval w każdym miesiącu.Aby uzyskać więcej informacji, zobacz sp_add_schedule (języka Transact-SQL)

freq_recurrence_factor

int

Liczba miesięcy między wykonywania zaplanowanego zadanie.

active_start_date

int

Wykonywanie kopii zapasowej bazy danych i dziennika

active_end_date

int

Tworzenie pełnego kopia zapasowa pliku z pomocniczego filegroups

active_start_time

int

Czas początkowy wykonanie zadanie active_start_date.

active_end_time

int

Czas zakończenia realizacji zadanie na active_end_date.

date_created

datetime

Data jest tworzony w harmonogramie.

schedule_description

nvarchar(4000)

Tworzenie i backing do multifamily dublowany zestaw nośników

next_run_date

int

data harmonogramu dalej spowoduje uruchomienie zadanie.

next_run_time

int

Czas harmonogramu dalej spowoduje uruchomienie zadanie.

schedule_uid

uniqueidentifier

Identyfikator harmonogramu.

job_count

int

Wykonywanie kopii zapasowej do istniejącego dublowany zestaw nośników

Tworzenie kopia zapasowa skompresowane w nowy zestaw nośników

Nazwa kolumna

Typ danych

Description

server_id

int

kopia zapasowa Instrukcjami tematy zawierają dodatkowe przykłady.

nazwa_serwera

nvarchar(30)

Nazwa komputera serwera docelowego.

enlist_date

datetime

Data zarejestrowania docelowego serwera na serwerze głównym.

last_poll_date

datetime

Data ostatniego sondowania serwera głównego przez serwer docelowy.

last_run_date

int

Data ostatniego uruchomienia zadania na tym docelowym serwerze.

last_run_time

int

Godzina ostatniego uruchomienia zadania na tym docelowym serwerze.

Jeśli kopia zapasowa zapisuje nagłówek nośnika, kopia zapasowa przypisze zestaw nośników hasła na wartość określoną w opcji MEDIAPASSWORD.

int

W przypadku produkcji bazy danych w dzienniku regularnie tworzyć kopie zapasowe.

last_run_outcome

tinyint

Kopie zapasowe dziennika powinien być wystarczająco często, aby zapewnić odpowiednią ochronę przed utratą danych.

0 = Failed

1 Udane =

3 Anulowane =

5 = Unknown

Poniższy przykład tworzy pełny kopia zapasowa pliku wszystkich plików w obu filegroups pomocniczego.

nvarchar(1024)

Poniższy przykład tworzy kopię zapasową pliku różnicowego wszystkich plików w obu filegroups pomocniczego.

Uprawnienia

Domyślnie członkowie sysadmin stała rola serwera możliwość wykonać tej procedura przechowywana.Inni użytkownicy klastrowa musi mieć jedną z następujących czynności SQL Server Agent stałe role bazy danych w msdb bazy danych:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Aby uzyskać szczegółowe informacje o uprawnieniach z tych ról zobacz SQL Server Agent Fixed Database Roles.

Członkowie SQLAgentUserRole można przeglądać tylko te zadania, na których jest właścicielem.Członkowie sysadmin, SQLAgentReaderRole, and SQLAgentOperatorRole mogą przeglądać wszystkie lokalne i wieloserwerowych zadania.

Przykłady

A.Wyświetlanie informacji o wszystkich zadaniach

W poniższym przykładzie wykonywany sp_help_job Procedura bez parametrów, aby przywrócić informacje dla wszystkich zadań, aktualnie zdefiniowanych w msdb Baza danych.

USE msdb ;
GO

EXEC dbo.sp_help_job ;
GO

B.NOINIT, które jest ustawieniem domyślnym, w tym miejscu wyświetlana jest dla jasności.

Następujące formaty przykład nośników, tworząc nowy nośnik zestaw, a następnie wykonaj skompresowanych pełna kopia zapasowa françoisa Baza danych.

USE msdb ;
GO

EXEC dbo.sp_help_job 
   @job_type = N'MULTI-SERVER',
   @owner_login_name = N'françoisa',
   @enabled = 1,
   @execution_status = 1 ;
GO

C.Wyświetlanie wszystkich aspektów informacji o zadaniu

W poniższym przykładzie są wyświetlane wszystkie aspekty informacji o zadaniu NightlyBackups.

USE msdb ;
GO

EXEC dbo.sp_help_job
    @job_name = N'NightlyBackups',
    @job_aspect = N'ALL' ;
GO