sp_help_job (Transact-SQL)

Gibt Informationen zu Aufträgen zurück, mit denen der SQL Server-Agent automatisierte Aktivitäten in SQL Server ausführt.

Syntax

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' ]

Argumente

• [ @job_id =] job_id
  Die ID des Auftrags. job_id ist vom Datentyp uniqueidentifier und hat den Standardwert NULL.

• [ @job_name =] 'job_name'
  Der Name des Auftrags. job_name ist ein Wert vom Datentyp sysname. Der Standardwert ist NULL.

  Hinweis:
  Es muss entweder job_id oder job_name angegeben werden, beide Angaben sind jedoch nicht möglich.

• [ @job_aspect =] 'job_aspect'
  Das Auftragsattribut, das angezeigt werden soll. job_aspect hat den Datentyp varchar(9) und den Standardwert NULL. Die folgenden Werte sind möglich.

  Wert	Beschreibung
  ALL	Auftragsaspektinformationen
  JOB	Auftragsinformationen
  SCHEDULES	Zeitplaninformationen
  STEPS	Auftragsschrittinformationen
  TARGETS	Zielinformationen

• [ @job_type =] 'job_type'
  Die Auftragstypen, die in den Bericht eingeschlossen werden sollen. job_type ist vom Datentyp varchar(12); der Standard ist NULL. Mögliche Werte für job_type sind LOCAL und MULTI-SERVER.

• [ @owner_login_name = ] 'login_name'
  Der Anmeldename des Besitzers des Auftrags. login_name hat den Datentyp sysname und den Standardwert NULL.

• [ @subsystem =] 'subsystem'
  Der Name des Teilsystems. subsystem ist ein Wert vom Datentyp nvarchar(40). Der Standardwert ist NULL.

• [ @category_name = ] 'category'
  Der Name der Kategorie. category hat den Datentyp sysname und den Standardwert NULL.

• [ @enabled = ] enabled
  Eine Zahl, die anzeigt, ob Informationen für aktivierte oder deaktivierte Aufträge angezeigt werden. enabled hat den Datentyp tinyint und den Standardwert NULL. 1 zeigt aktivierte Aufträge, und 0 zeigt deaktivierte Aufträge an.

• [ @execution_status =] status
  Der Ausführungsstatus für die Aufträge. status hat den Datentyp int und den Standardwert NULL. Die folgenden Werte sind möglich.

  Wert	Beschreibung
  0	Nur die Aufträge werden zurückgegeben, die sich nicht im Leerlauf befinden oder unterbrochen sind.
  1	Wird ausgeführt
  2	Wartet auf Thread
  3	Zwischen Wiederholungen
  4	Im Leerlauf
  5	Unterbrochen
  7	Abschlussaktionen werden ausgeführt

• [ @date_comparator =] 'date_comparison'
  Der Vergleichsoperator, der für Vergleiche von date_created und date_modified verwendet werden soll. date_comparison hat den Datentyp char(1). Mögliche Werte sind =, < oder >.

• [ @date_created =] date_created
  Das Datum, an dem der Auftrag erstellt wurde. date_createdhat den Datentyp datetime und den Standardwert NULL.

• [ @date_last_modified =] date_modified
  Das Datum, an dem der Auftrag zuletzt verändert wurde. date_modified hat den Datentyp datetime und den Standardwert NULL.

• [ @description =] 'description_pattern'
  Die Beschreibung des Auftrags. description_pattern hat den Datentyp nvarchar(512) und den Standardwert NULL. description_pattern kann die SQL Server-Platzhalterzeichen für den Mustervergleich enthalten.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Wenn keine Argumente angegeben werden, gibt sp_help_job das folgende Resultset zurück.

Wenn job_id oder job_name angegeben wird, gibt sp_help_job die folgenden zusätzlichen Resultsets für Auftragsschritte, Auftragszeitpläne und Auftragszielserver zurück.

Im Folgenden wird das Resultset für Auftragsschritte aufgeführt.

Im Folgenden wird das Resultset für Auftragszeitpläne aufgeführt.

Im Folgenden wird das Resultset für Auftragszielserver aufgeführt.

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Andere Benutzer müssen Mitglieder der festen SQL Server-Agent-Datenbankrollen in der msdb-Datenbank sein:

• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.

Mitglieder von SQLAgentUserRole können nur die Aufträge anzeigen, deren Besitzer sie sind. Mitglieder der sysadmin, SQLAgentReaderRole und SQLAgentOperatorRole-Rolle können alle lokalen und Multiserveraufträge beenden.

Beispiele

A. Auflisten der Informationen für alle Aufträge

Das folgende Beispiel führt die sp_help_job-Prozedur ohne Parameter aus, um Informationen für alle aktuell in der msdb-Datenbank definierten Aufträge zurückzugeben.

USE msdb ;
GO

EXEC dbo.sp_help_job ;
GO

B. Auflisten der Informationen für Aufträge, die einem bestimmten Kriterium entsprechen

Im folgenden Beispiel werden Auftragsinformationen für die Multiserveraufträge im Besitz von françoisa aufgelistet, wenn der Auftrag aktiviert und ausgeführt wird.

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. Auflisten aller Aspekte von Informationen für einen Auftrag

Im folgenden Beispiel werden alle Aspekte der Informationen für den Auftrag NightlyBackups aufgelistet.

USE msdb ;
GO

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

Siehe auch

Verweis

sp_add_job (Transact-SQL)
sp_delete_job (Transact-SQL)
sp_update_job (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005