sp_help_job (języka Transact-SQL)

Składnia

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
  Numer identyfikacyjny zadanie .job_idjest uniqueidentifier, domyślna wartość NULL.

• [ @ job_name =] 'job_name"
  Nazwa zadanie.job_namejest sysname, domyślna wartość NULL.

  Ostrzeżenie

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

• [ @ job_aspect =] 'job_aspect"
  zadanieatrybut do wyświetlenia. job_aspectjest varchar(9), domyślna wartość NULL, i może być jedną z tych wartości.

  Wartość	Opis
  ALL	Informacje o zadaniu proporcji
  ZADANIA	Informacje o zadaniu
  HARMONOGRAMY	Informacje o harmonogramie
  KROKI	Informacje o zadaniu kroku
  CELE	Informacje docelowej

• [ @ job_type =] 'job_type"
  Typ zadania do uwzględnienia w raporcie.job_typejest varchar(12), domyślna wartość NULL.job_typemoże być lokalnego lub rozwiązaniem.

• [ @ owner_login_name = ] 'login_name"
  Nazwa logowania właściciela zadanie.login_namejest sysname, domyślna wartość NULL.

• [ @ podsystemu =] 'subsystem"
  Nazwę podsystemu.subsystemjest nvarchar(40), domyślna wartość NULL.

• [ @ category_name =] 'category"
  Nazwa kategorii.categoryjest sysname, domyślna wartość NULL.

• [ @ włączone =] enabled
  Liczba wskazująca, czy informacje są wyświetlane dla włączone zadania zadania lub wyłączone.enabledjest tinyint, domyślna wartość NULL.1 wskazuje włączone zadań i 0 wskazuje wyłączonych zleceń.

• [ @ execution_status =] status
  Stan wykonania zadania.statusjest int, domyślna wartość NULL, i może być jedną z tych wartości.

  Wartość	Opis
  0	Zwraca tylko te zadania, które nie są bezczynne lub zawieszone.
  1	Wykonywanie.
  2	Oczekiwania wątek.
  3	Między ponownymi próbami.
  4	Bezczynności.
  5	Zawieszone.
  7	Wykonywanie akcji zakończenia.

• [ @ date_comparator =] 'date_comparison"
  operator porównania w porównania date_created i date_modified.date_comparisonis char(1),and can be =, <, or >.

• [ @ date_created =] date_created
  data utworzenia zadanie .date_createdjest datetime, domyślna wartość NULL.

• [ @ date_last_modified =] date_modified
  data zadanie ostatniej modyfikacji.date_modifiedjest datetime, domyślna wartość NULL.

• [ @ Opis = ] 'description_pattern"
  Opis zadanie.description_patternjest nvarchar(512), domyślna wartość NULL.description_patternmoże zawierać symbole wieloznaczne SQL Server do dopasowania wzorca.

Wartości kodów powrotnych

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

Zestawy wyników

Jeśli nie podano argumentów, sp_help_job zwraca ten zestaw wyników.

Jeśli job_id lub job_name jest określony, sp_help_job zwraca serwerówmiejsce docelowe tych zestawów wyników dodatkowe czynności zadanie , harmonogramy zadanie i zadanie.

Jest to zestaw wyników dla czynności zadanie .

Jest to zestaw wyników harmonogramów zadanie .

Jest to zestaw wyników dla serwerówmiejsce docelowe zadanie.

Uprawnienia

Domyślnie członkowie sysadmin stała rola serwera można wykonać tę procedura składowana.Inni użytkownicy muszą być przyznawane jedną z następujących SQL Server Agent ról stałej bazy danych w msdb bazy danych:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Szczegółowe informacje na temat uprawnień tych ról, zobacz Ról stałej bazy danych programu SQL Server Agent.

Członkowie SQLAgentUserRole można wyświetlić tylko zadania, których jest właścicielem.Członkowie sysadmin, SQLAgentReaderRole, i SQLAgentOperatorRole można wyświetlić wszystkie zadania lokalne i propagując.

Przykłady

A.Informacje dotyczące listy dla wszystkich zadań

USE msdb ;
GO

EXEC dbo.sp_help_job ;
GO

B.Wyświetlanie informacji dla zadań spełniające określone kryteria

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 listy wszystkich aspektów informacji dla zadanie

USE msdb ;
GO

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

Zobacz także

Odwołanie