sp_help_downloadlist (Transact-SQL)

  • Article

S'applique à : SQL Server

Répertorie toutes les lignes de la sysdownloadlist table système pour le travail fourni ou toutes les lignes si aucun travail n’est spécifié.

Conventions de la syntaxe Transact-SQL

Syntaxe

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 ]
[ ; ]

Arguments

[ @job_id = ] 'job_id'

Numéro d'identification du travail pour lequel renvoyer des informations. @job_id est uniqueidentifier, avec la valeur par défaut NULL.

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

[ @job_name = ] N’job_name'

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

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

[ @operation = ] 'operation'

Opération valide pour le travail spécifié. @operation est varchar(64) et peut être l’une de ces valeurs.

Valeur Description
DEFECT Opération de serveur qui demande au serveur cible de faire défaut à partir du service Master SQL Server Agent.
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 recharge également les MSXOperator détails.
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 d’intervalle requise et peut être une valeur comprise entre 10 et 28 800.
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 sysjobs informations d’un travail, et non les étapes ou les planifications du travail. Est automatiquement appelé par sp_update_job.

[ @object_type = ] 'object_type'

Type de l'objet du travail spécifié. @object_type est varchar(64), avec la valeur par défaut NULL. @object_type peut être soit JOB ou SERVER. Pour plus d’informations sur les valeurs de @object_typevalides, consultez sp_add_category.

[ @object_name = ] N'object_name'

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

[ @target_server = ] N’target_server'

Nom du serveur cible. @target_server est sysname, avec la valeur par défaut NULL.

[ @has_error = ] has_error

Spécifie si le travail doit accuser réception des erreurs. @has_error est tinyint, avec une 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 = ] état

État du travail. @status est tinyint, avec une valeur par défaut de 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 datetime, avec la valeur par défaut NULL.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Jeu 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.
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’objet operation_code.
target_server nvarchar(30) Serveur cible par lequel cette instruction doit être téléchargée.
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 le serveur cible a téléchargé l’instruction.
status tinyint État du travail :

0 = Pas encore téléchargé
1 = Téléchargé avec succès.

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

Contenu connexe