sp_enableagentoffload (Transact-SQL)

Active l'Agent distant de l'Agent d'envoi de données (push) de réplication identifié par le paramètre @job_id. Cette procédure stockée est exécutée sur l'ordinateur faisant actuellement office de serveur d'Agent distant. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.

Important :
La prise en charge de l'activation des Agents distants a été supprimée pour les serveurs de distribution exécutant Microsoft SQL Server 2005 et version ultérieure.

Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_enableagentoffload [ @job_id = ] job_id
    [ , [ @offloadserver = ] 'remote_agent_server_name' ]
    [ , [ @agent_type = ] 'agent_type' ]

Arguments

• [ @job_id =] 'job_id'
  Indique l'identificateur de travail d'Agent SQL Server de l'Agent de réplication à activer pour l'activation distante. job_id est de type varbinary(16), sans valeur par défaut.

• [ @offloadserver= ] 'remote_agent_server_name'
  Indique le nom réseau du serveur à activer pour l'activation de l'Agent distant. L'argument remote_agent_server_name est de type sysname, avec NULL comme valeur par défaut. Si la valeur est NULL, la valeur offload_server figurant dans la table MSDistribution_agents est utilisée.

• [ @agent_type=] 'agent_type'
  Type d'Agent. agent_type est de type sysname, avec la valeur par défaut NULL qui indique que le système détermine si le type correspond à un Agent de distribution ou de fusion. Les valeurs possibles sont distribution, merge et NULL.

Valeurs des codes de retour

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

Notes

sp_enableagentoffload permet d'activer l'exécution du traitement de l'Agent de distribution ou de fusion sur un autre serveur.

Après l'exécution réussie de sp_enableagentoffload, le paramètre –Offloadoffloadserver est ajouté à la ligne de commande de l'Agent de réplication ou mis à jour à partir du nouveau 'remote_agent_server_name' si le paramètre –Offloadoffloadserver existe déjà dans la ligne de commande.

En outre, le champ offload_enabled de l'Agent dans MSdistribution_agents (Transact-SQL) prend pour valeur 1, et le champ offload-server est mis à jour à partir de la nouvelle valeur éventuellement spécifiée dans 'remote_agent_server_name'.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin ou de base de données fixe db_owner, ou le propriétaire d'abonnement de l'Agent spécifié peuvent exécuter sp_enableagentoffload.

Voir aussi

Référence

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

Aide et Informations

Assistance sur SQL Server 2005