sp_help_downloadlist (Transact-SQL)

Syntaxe

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 ]

Arguments

• [ @job_id= ] job_id
  Numéro d'identification du travail pour lequel renvoyer des informations. job_id est de type uniqueidentifier et sa valeur par défaut est NULL.

• [ @job_name= ] 'job_name'
  Nom du travail. L'argument job_name est de type sysname, avec NULL comme valeur par défaut.

  Notes

  Vous devez définir la valeur de job_id ou de job_name, mais pas les deux valeurs à la fois.

• [ @operation= ] 'operation'
  Opération valide pour le travail spécifié. operation est de type varchar(64) et sa valeur par défaut est NULL. Ce paramètre peut posséder n'importe laquelle de ces valeurs.

  Valeur	Description
  DEFECT	Opération du serveur qui nécessite que le serveur cible soit désinscrit du service SQLServerAgent.
  DELETE	Opération qui supprime intégralement un travail.
  INSERT	Opération qui insère un travail ou actualise un travail existant. Cette opération comporte toutes les étapes et planifications du travail, le cas échéant.
  RE-ENLIST	Opération serveur qui fait renvoyer les informations d'inscription par le serveur cible, y compris la fréquence d'interrogation et le fuseau horaire, au domaine multiserveur. Le serveur cible télécharge également les informations relatives à MSXOperator.
  SET-POLL	Opération de serveur qui définit l'intervalle, en secondes, que doivent respecter les serveurs cibles pour l'interrogation du domaine multiserveur. Si elle est spécifiée, value est interprétée comme la valeur de l'intervalle requis, et elle est comprise entre 10 et 28800.
  START	Opération de travail qui requiert le début de l'exécution d'un travail.
  STOP	Opération de travail qui nécessite l'interruption de l'exécution d'un travail.
  SYNC-TIME	Opération de serveur qui commande au serveur cible de synchroniser son horloge système avec le domaine multiserveur. Cette opération étant coûteuse, il est préférable de l'exécuter le plus rarement possible.
  UPDATE	Opération de travail qui met à jour uniquement les informations sysjobs pour un travail et non les étapes ou la planification du travail. Appelé automatiquement par sp_update_job.

• [ @object_type= ] 'object_type'
  Type de l'objet du travail spécifié. object_type est de type varchar(64) et sa valeur par défaut est NULL. object_type peut être soit JOB soit SERVER. Pour plus d'informations sur les valeurs object_typevalides, consultez sp_add_category (Transact-SQL).

• [ @object_name= ] 'object_name'
  Nom de l'objet. L'argument object_name est de type sysname, avec NULL comme valeur par défaut. Si object_type prend la valeur JOB, object_name constitue le nom du travail. Si object_type est SERVER, object_namereprésente le nom du serveur.

• [ @target_server= ] 'target_server'
  Nom du serveur cible. L'argument target_server est de type nvarchar(128), avec NULL comme valeur par défaut.

• [ @has_error= ] has_error
  Indique si le travail doit signaler les erreurs. L'argument has_error est de type tinyint, avec NULL comme valeur par défaut qui spécifie qu'aucune erreur ne doit être signalée. 1 spécifie que toutes les erreurs doivent être signalées.

• [ @status= ] status
  État du travail. status est de type tinyint, avec une valeur par défaut NULL.

• [ @date_posted= ] date_posted
  Date et heure à partir desquelles toutes les entrées doivent être incluses dans le jeu de résultats. date_posted est de type datetime et sa valeur par défaut est NULL.

Valeurs du code de retour

0 (succès) ou 1 (échec)

Jeux de résultats

Nom de colonne	Type de données	Description
instance_id	int	Numéro d'identification entier unique de l'instruction.
source_server	nvarchar(30)	Nom de l'ordinateur du serveur qui émet l'instruction. Dans Microsoft SQL Server version 7.0, il s'agit toujours du nom d'ordinateur du serveur maître (MSX).
operation_code	nvarchar(4000)	Code d'opération pour l'instruction.
object_name	sysname	Objet affecté par l'instruction.
object_id	uniqueidentifier	Numéro d'identification de l'objet affecté par l'instruction (job_id pour un objet travail ou 0x00 pour un objet serveur) ou valeur de données spécifique à operation_code.
target_server	nvarchar(30)	Serveur cible devant télécharger cette instruction.
error_message	nvarchar(1024)	Message d'erreur (le cas échéant) émis par le serveur cible s'il y a eu un problème lors du traitement de l'instruction. Remarque Tout message d'erreur stoppe les téléchargements du serveur cible.
date_posted	datetime	Date à laquelle l'instruction a été envoyée à la table.
date_downloaded	datetime	Date à laquelle l'instruction a été téléchargée par le serveur cible.
status	tinyint	État du travail : 0 = Pas encore téléchargé 1 = Téléchargé avec succès.

Autorisations

Les autorisations d'exécuter cette procédure reviennent par défaut aux membres du rôle de serveur fixe sysadmin.

Exemples

L'exemple suivant répertorie des lignes dans sysdownloadlist pour le travail NightlyBackups.

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

Voir aussi

Référence