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