sp_help_downloadlist (Transact-SQL)

Gilt für:SQL Server

Listet alle Zeilen in der Systemtabelle sysdownloadlist für den angegebenen Auftrag oder alle Zeilen auf, wenn kein Auftrag angegeben ist.

Transact-SQL-Syntaxkonventionen

Syntax

  
sp_help_downloadlist { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }   
     [ , [ @operation = ] 'operation' ]   
     [ , [ @object_type = ] 'object_type' ]   
     [ , [ @object_name = ] 'object_name' ]   
     [ , [ @target_server = ] 'target_server' ]   
     [ , [ @has_error = ] has_error ]   
     [ , [ @status = ] status ]   
     [ , [ @date_posted = ] date_posted ]  

Argumente

[ @job_id = ] job_id Die Auftragsidentifikationsnummer, für die Informationen zurückgegeben werden sollen. job_id ist uniqueidentifier mit dem Standardwert NULL.

[ @job_name = ] 'job_name' Der Name des Auftrags. job_name ist sysname mit dem Standardwert NULL.

Hinweis

Es müssen entweder job_id oder job_name angegeben werden, aber beide können nicht angegeben werden.

[ @operation = ] 'operation' Der gültige Vorgang für den angegebenen Auftrag. Der -Vorgang ist varchar(64) mit dem Standardwert NULL und kann einer dieser Werte sein.

Wert	BESCHREIBUNG
DEFEKT	Servervorgang, der den Zielserver zum Fehler beim Master SQLServerAgent-Dienst anfordert.
DELETE	Auftragsvorgang, mit dem ein gesamter Auftrag entfernt wird
INSERT	Auftragsvorgang, der einen gesamten Auftrag einfügt oder einen vorhandenen Auftrag aktualisiert. Dieser Vorgang schließt ggf. alle Auftragsschritte und Zeitpläne ein.
RE-ENLIST	Servervorgang, der bewirkt, dass der Zielserver die Eintragsinformationen, einschließlich des Abrufintervalls und der Zeitzone, erneut an die Multiserverdomäne sendet. Der Zielserver downloadet auch die MSXOperator-Details erneut.
SET-POLL	Servervorgang, der festlegt, in welchem Intervall (in Sekunden) die Zielserver die Multiserverdomäne abfragen. Wenn angegeben, wird der Wert als erforderlicher Intervallwert interpretiert und kann ein Wert von 10 bis 28.800 sein.
STARTEN	Auftragsvorgang, der den Start der Auftragsausführung anfordert
STOP	Auftragsvorgang, der das Beenden der Auftragsausführung anfordert
SYNC-TIME	Servervorgang, der bewirkt, dass der Zielserver die Systemuhr mit der Multiserverdomäne synchronisiert. Dies ist ein kostenaufwendiger Vorgang und sollte deshalb nur selten und in begrenztem Umfang durchgeführt werden.
UPDATE	Auftragsvorgang, der nur die sysjobs-Informationen für einen Auftrag aktualisiert, nicht die Auftragsschritte oder -zeitpläne. Wird automatisch von sp_update_job aufgerufen.

[ @object_type = ] 'object_type' Der Objekttyp für den angegebenen Auftrag. object_type ist varchar(64) mit dem Standardwert NULL. object_type kann entweder JOB oder SERVER sein. Weitere Informationen zu gültigen object_typeWerten finden Sie unter sp_add_category (Transact-SQL).

[ @object_name = ] 'object_name' Der Name des Objekts. object_name ist sysname mit dem Standardwert NULL. Wenn object_type JOB ist, ist object_nameder Auftragsname. Wenn object_typeSERVER ist, ist object_nameder Servername.

[ @target_server = ] 'target_server' Der Name des Zielservers. target_server ist nvarchar(128) mit dem Standardwert NULL.

[ @has_error = ] has_error Gibt an, ob der Auftrag Fehler bestätigen soll. has_error ist tinyint mit dem Standardwert NULL, der angibt, dass keine Fehler bestätigt werden sollten. 1 gibt an, dass alle Fehler bestätigt werden sollten.

[ @status = ] status Der Status für den Auftrag. status ist tinyint, mit dem Standardwert NULL.

[ @date_posted = ] date_posted Das Datum und die Uhrzeit, für die alle Einträge, die am oder nach dem angegebenen Datum und der angegebenen Uhrzeit vorgenommen werden, im Resultset enthalten sein sollen. date_posted ist datetime mit dem Standardwert NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname	Datentyp	BESCHREIBUNG
instance_id	int	Eindeutige, ganzzahlige ID der Anweisung
source_server	nvarchar(30)	Computername des Servers, vom dem die Anweisung stammt. In Microsoft SQL Server Version 7.0 ist dies immer der Computername des Masterservers (MSX).
operation_code	nvarchar(4000)	Vorgangscode für die Anweisung
object_name	sysname	Objekt, das von der Anweisung betroffen ist
object_id	uniqueidentifier	Identifikationsnummer des Objekts, das von der Anweisung betroffen ist (job_id für ein Auftragsobjekt oder 0x00 für ein Serverobjekt) oder eines für den operation_code spezifischen Datenwerts.
target_server	nvarchar(30)	Zielserver, der diese Anweisung herunterladen soll
error_message	nvarchar(1024)	Gegebenenfalls Fehlermeldung vom Zielserver, falls beim Verarbeiten dieser Anweisung ein Problem aufgetreten ist. Hinweis: Jede Fehlermeldung blockiert alle weiteren Downloads durch den Zielserver.
date_posted	datetime	Datum, an dem die Anweisung für die Tabelle bereitgestellt wurde
date_downloaded	datetime	Datum, an dem die Anweisung durch den Zielserver heruntergeladen wurde
status	tinyint	Status des Auftrags: 0 = Noch nicht heruntergeladen 1 = Erfolgreich heruntergeladen.

Berechtigungen

Berechtigungen zur Ausführung dieser Prozedur erhalten standardmäßig Mitglieder der festen Serverrolle sysadmin .

Beispiele

Im folgenden Beispiel werden Zeilen in der sysdownloadlist-Tabelle für den Auftrag NightlyBackups aufgelistet.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_downloadlist  
    @job_name = N'NightlyBackups',  
    @operation = N'UPDATE',   
    @object_type = N'JOB',   
    @object_name = N'NightlyBackups',  
    @target_server = N'SEATTLE2',   
    @has_error = 1,   
    @status = NULL,   
    @date_posted = NULL ;  
GO  

Weitere Informationen

Gespeicherte Systemprozeduren (Transact-SQL)