sp_help_downloadlist (Transact-SQL)

  • Artikel

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

Zugehöriger Inhalt