sp_help_downloadlist (Transact-SQL)

Listet alle Zeilen in der sysdownloadlist-Systemtabelle für den angegebenen Auftrag auf. Falls kein Auftrag angegeben wird, werden alle Zeilen aufgelistet.

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 ID des Auftrags, für den Informationen zurückgegeben werden sollen. job_id ist vom Datentyp uniqueidentifier; der Standardwert ist NULL.

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

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

• [ @operation= ] 'operation'
  Der gültige Vorgang für den angegebenen Auftrag. operation ist ein Wert vom Datentyp varchar(64). Der Standardwert ist NULL. Die folgenden Werte sind möglich.

  Wert	Beschreibung
  DEFECT	Servervorgang, mit dem der Zielserver aus dem Master-SQLServerAgent-Dienst ausgetragen wird.
  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. Die MSXOperator-Details werden vom Zielserver ebenfalls erneut gedownloadet.
  SET-POLL	Servervorgang, der festlegt, in welchem Intervall (in Sekunden) die Zielserver die Multiserverdomäne abfragen. Wenn angegeben, wird value als der erforderliche Intervallwert interpretiert. Mögliche Werte reichen von 10 bis 28.800.
  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. Die Auftragsschritte und Zeitpläne werden nicht aktualisiert. Der Aufruf erfolgt automatisch durch sp_update_job.

• [ @object_type= ] 'object_type'
  Der Objekttyp für den angegebenen Auftrag. object_type ist ein Wert vom Datentyp varchar(64). Der Standardwert ist NULL. Mögliche Werte für object_type sind JOB und SERVER. Weitere Informationen zu gültigen object_type-Werten finden Sie unter sp_add_category (Transact-SQL).

• [ @object_name= ] 'object_name'
  Der Name des Objekts. object_name ist vom Datentyp sysname; der Standardwert ist NULL. Wenn object_type den Wert JOB aufweist, entspricht object_name dem Auftragsnamen. Wenn object_type den Wert SERVER aufweist, entspricht object_name dem Servernamen.

• [ @target_server= ] 'target_server'
  Der Name des Zielservers. target_server ist vom Datentyp nvarchar(128); der Standardwert ist NULL.

• [ @has_error= ] has_error
  Gibt an, ob der Auftrag Fehler bestätigen soll. has_error ist ein Wert vom Datentyp tinyint. Der Standardwert ist NULL, wodurch angezeigt wird, dass keine Fehler bestätigt werden sollen. Der Wert 1 zeigt an, dass alle Fehler bestätigt werden sollen.

• [ @status= ] status
  Der Status des Auftrags. status ist ein Wert vom Datentyp tinyint. Der Standardwert ist NULL.

• [ @date_posted= ] date_posted
  Das Datum und die Uhrzeit eines Zeitpunkts. Alle Einträge, die an oder nach diesem Zeitpunkt vorgenommen wurden, sollen in das Resultset eingeschlossen werden. date_posted ist ein Wert vom Datentyp datetime. Der Standardwert ist 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 7.0 ist dies immer der Computername des Masterservers.

operation_code

nvarchar(4000)

Vorgangscode für die Anweisung

object_name

sysname

Objekt, das von der Anweisung betroffen ist

object_id

uniqueidentifier

ID des Objekts, das von der Anweisung betroffen ist (job_id für ein Auftragsobjekt oder 0x00 für ein Serverobjekt) oder ein spezifischer Datenwert für operation_code.

target_server

nvarchar(30)

Zielserver, der diese Anweisung downloaden soll

error_message

nvarchar(1024)

Gegebenenfalls Fehlermeldung vom Zielserver, falls beim Verarbeiten dieser Anweisung ein Problem aufgetreten ist.

Hinweis:

Fehlermeldungen blockieren alle weiteren Downloadvorgänge 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 gedownloadet wurde

status

tinyint

Status des Auftrags:

0 = Noch nicht gedownloadet

1 = Erfolgreich gedownloadet

Berechtigungen

Standardmäßig verfügen Mitglieder der festen Serverrolle sysadmin über Berechtigungen zum Ausführen dieser Prozedur.

Beispiele

A. Auflisten der Informationen für einen Auftrag

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

Siehe auch

Verweis

Gespeicherte Systemprozeduren (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005