sp_post_msx_operation (Transact-SQL)

Insère des opérations (lignes) dans la table système sysdownloadlist en vue de leur chargement et de leur exécution par les serveurs cibles.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_post_msx_operation
     [ @operation = ] 'operation'
     [ , [ @object_type = ] 'object' ] 
     { , [ @job_id = ] job_id } 
          [ , [ @specific_target_server = ] 'target_server' ] 
     [ , [ @value = ] value ]
     [ , [ @schedule_uid = ] schedule_uid ]

Arguments

  • [ @operation =] 'operation'
    Type de l'opération publiée. L'argument operationest de type varchar(64), sans valeur par défaut. La validation des opérations dépend de object_type.

    Type d'objet

    Opération

    JOB

    INSERT

    UPDATE

    DELETE

    START

    STOP

    SERVER

    RE-ENLIST

    DEFECT

    SYNC-TIME

    SET-POLL

    SCHEDULE

    INSERT

    UPDATE

    DELETE

  • [ @object_type =] 'object'
    Type d'objet pour lequel l'opération doit être publiée. Les types valides sont : JOB, SERVER et SCHEDULE. L'argument object est de type varchar(64), avec JOB comme valeur par défaut.

  • [ @job_id =] job_id
    Numéro d'identification du travail auquel l'opération s'applique. job_id est de type uniqueidentifier, sans valeur par défaut. 0x00 indique TOUS les travaux. Si l'argument object est de type SERVER, alors job_idn'est pas nécessaire.

  • [ @specific_target_server =] 'target_server'
    Nom du serveur cible auquel l'opération spécifiée s'applique. Si job_id est spécifié, mais que target_server ne l'est pas, les opérations sont publiées pour tous les serveurs cibles du travail. target_server est de type nvarchar(30), avec NULL comme valeur par défaut.

  • [ @value =] value
    Fréquence d'interrogation, en secondes. L'argument value est de type int, avec NULL comme valeur par défaut. Ne spécifiez ce paramètre que si operation est SET-POLL.

  • [ @schedule_uid= ] schedule_uid
    Identificateur unique de la planification à laquelle s'applique l'opération. schedule_uid est de type uniqueidentifier, sans valeur par défaut.

Valeurs des codes de retour

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

Ensembles de résultats

Aucun

Notes

La procédure stockée sp_post_msx_operation doit être exécutée à partir de la base de données msdb.

L'appel de sp_post_msx_operation ne présente aucun risque car la procédure détermine en premier lieu si le serveur actif est un Agent SQL Server multiserveur, puis, si c'est le cas, si object est un travail multiserveur.

Une fois l'opération publiée, elle apparaît dans la table sysdownloadlist. Après qu'un travail a été créé et publié, les modifications ultérieures apportées à ce travail doivent être aussi communiquées aux serveurs cibles (TSX). L'opération est également réalisée à l'aide de la liste de téléchargement. .

Il est fortement recommandé de gérer la liste de téléchargement à l'aide de SQL Server Management Studio. Pour plus d'informations, consultez Affichage et modification des travaux.

Autorisations

Pour exécuter cette procédure stockée, les utilisateurs doivent appartenir au rôle de serveur fixe sysadmin.