sp_help_downloadlist (Transact-SQL)

  • Article

S’applique à :SQL Server

Répertorie toutes les lignes de la table système sysdownloadlist pour le travail fourni, ou toutes les lignes si aucune tâche n’est spécifiée.

Conventions de la syntaxe 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 retourner des informations. job_id est uniqueidentifier, avec la valeur par défaut NULL.

[ @job_name = ] 'job_name' Nom du travail. job_name est sysname, avec la valeur par défaut NULL.

Notes

Vous devez spécifier job_id ou job_name , mais les deux ne peuvent pas être spécifiés.

[ @operation = ] 'operation' Opération valide pour le travail spécifié. operation est varchar(64), avec la valeur par défaut NULL, et peut être l’une de ces valeurs.

Valeur Description
DÉFAUT Opération de serveur qui demande au serveur cible de faire défaut du service Master 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.
RÉINSCRIRE 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 retélécharge également les détails de 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, la valeur est interprétée comme la valeur d’intervalle requise et peut être une valeur comprise entre 10 et 28 800.
COMMENCER 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 d’un travail, et non les étapes ou planifications du travail. Est automatiquement appelé par sp_update_job.

[ @object_type = ] 'object_type' Type d’objet pour le travail spécifié. object_type est varchar(64), avec la valeur par défaut NULL. object_type peut être travail ou serveur. Pour plus d’informations sur les valeurs de object_typevalides, consultez sp_add_category (Transact-SQL).

[ @object_name = ] 'object_name' Nom de l’objet. object_name est sysname, avec la valeur par défaut NULL. Si object_type est JOB, object_nameest le nom du travail. Si object_typeest SERVER, object_nameest le nom du serveur.

[ @target_server = ] 'target_server' Nom du serveur cible. target_server est nvarchar(128), avec la valeur par défaut NULL.

[ @has_error = ] has_error Indique si le travail doit reconnaître les erreurs. has_error est tinyint, avec la valeur par défaut NULL, ce qui indique qu’aucune erreur ne doit être reconnue. 1 indique que toutes les erreurs doivent être reconnues.

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

[ @date_posted = ] date_posted Date et heure pour lesquelles toutes les entrées effectuées à la date et l’heure spécifiées doivent être incluses dans le jeu de résultats. date_posted a la valeur datetime, avec la valeur par défaut NULL.

Codet de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

Nom de la 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 de travail ou 0x00 pour un objet serveur) ou une valeur de données spécifique à l’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 bloque tous les téléchargements supplémentaires par le 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.
statut tinyint État du travail :

0 = Non encore téléchargé

1 = Téléchargement réussi.

Autorisations

Les autorisations d'exécution de cette procédure sont accordées 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

Procédures stockées système (Transact-SQL)