sp_help_downloadlist (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server

Listet alle Zeilen in der sysdownloadlist Systemtabelle 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 = ] N'job_name' ]
    [ , [ @operation = ] 'operation' ]
    [ , [ @object_type = ] 'object_type' ]
    [ , [ @object_name = ] N'object_name' ]
    [ , [ @target_server = ] N'target_server' ]
    [ , [ @has_error = ] has_error ]
    [ , [ @status = ] status ]
    [ , [ @date_posted = ] date_posted ]
[ ; ]

Argumente

[ @job_id = ] 'job_id'

Die ID des Auftrags, zu dem Informationen zurückgegeben werden sollen. @job_id ist eindeutiger Bezeichner mit einem Standardwert von NULL.

Entweder @job_id oder @job_name müssen angegeben werden, beide können jedoch nicht angegeben werden.

[ @job_name = ] N'job_name'

Der Name des Auftrags. @job_name ist "sysname" mit der Standardeinstellung "NULL.

Entweder @job_id oder @job_name müssen angegeben werden, beide können jedoch nicht angegeben werden.

[ @operation = ] 'operation'

Der gültige Vorgang für den angegebenen Auftrag. @operation ist varchar(64) und kann einer dieser Werte sein.

Wert	Beschreibung
`DEFECT`	Servervorgang, der den Zielserver anfordert, vom Master-SQL Server-Agent-Dienst zu defekten.
`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 wird auch die `MSXOperator` Details erneut heruntergeladen.
`SET-POLL`	Servervorgang, der festlegt, in welchem Intervall (in Sekunden) die Zielserver die Multiserverdomäne abfragen. Wenn angegeben, wird @value als erforderlicher Intervallwert interpretiert und kann ein Wert zwischen 10 und 28.800 sein.
`START`	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 aufgerufen von `sp_update_job`.

[ @object_type = ] 'object_type'

Der Typ des Objekts für den angegebenen Auftrag. @object_type ist varchar(64) mit einem Standardwert von NULL. @object_type können entweder JOB oder SERVER. Weitere Informationen zu gültigen @object_typeWerten finden Sie unter sp_add_category.

[ @object_name = ] N'object_name'

Der Name des Objekts. @object_name ist "sysname" mit der Standardeinstellung "NULL. Wenn @object_type ist JOB, ist @object_name der Auftragsname. Wenn @object_type ist SERVER, ist @object_name der Servername.

[ @target_server = ] N'target_server'

Der Name des Zielservers. @target_server ist "sysname" mit der Standardeinstellung "NULL.

[ @has_error = ] has_error

Gibt an, ob der Auftrag Fehler bestätigen soll. @has_error ist winzig, mit einem Standardwert von NULL, der angibt, dass keine Fehler erkannt werden sollten. 1 gibt an, dass alle Fehler erkannt werden sollten.

[ @status = ] Status

Der Status für den Auftrag. @status ist winzig, mit einem Standardwert von NULL.

[ @date_posted = ] date_posted

Das Datum und die Uhrzeit des Zeitpunkts, zu dem alle Einträge, die zu oder nach dem angegebenen Datum und der angegebenen Uhrzeit erstellt wurden, im Resultset enthalten sein sollen. @date_posted ist "datetime" mit einem Standardwert von NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Spaltenname	Datentyp	BESCHREIBUNG
`instance_id`	int	Eindeutige, ganzzahlige ID der Anweisung
`source_server`	nvarchar(30)	Computername des Servers, vom dem die Anweisung stammt.
`operation_code`	nvarchar(4000)	Vorgangscode für die Anweisung
`object_name`	sysname	Objekt, das von der Anweisung betroffen ist
`object_id`	uniqueidentifier	Die Identifikationsnummer des Objekts, das von der Anweisung (`job_id` für ein Auftragsobjekt oder `0x00` für ein Serverobjekt) oder einem für das `operation_code`Objekt spezifischen Datenwert betroffen ist.
`target_server`	nvarchar(30)	Zielserver, von dem diese Anweisung heruntergeladen werden soll.
`error_message`	nvarchar(1024)	Gegebenenfalls Fehlermeldung vom Zielserver, falls beim Verarbeiten dieser Anweisung ein Problem aufgetreten ist. Hinweis: Alle Fehlermeldungen blockieren alle weiteren Downloads vom Zielserver.
`date_posted`	datetime	Datum, an dem die Anweisung für die Tabelle bereitgestellt wurde
`date_downloaded`	datetime	Datum, an dem der Zielserver die Anweisung heruntergeladen hat.
`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

Gespeicherte Systemprozeduren (Transact-SQL)

Freigeben über