sp_disableagentoffload (Transact-SQL)

Article
12/15/2008

Désactive l'Agent d'envoi distant de l'Agent d'envoi de réplication identifié par le paramètre @job_id. 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.

Syntaxe

sp_disableagentoffload [ @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 à désactiver de 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 à utiliser 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 ou NULL.

Valeurs des codes de retour

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

Notes

sp_disableagentoffload permet de désactiver la possibilité d'exécuter le traitement de l'Agent de distribution ou de fusion sur un autre serveur.

Après l'exécution réussie de sp_disableagentoffload, le paramètre –Offloadoffloadserver est supprimé de la ligne de commande de l'Agent de réplication. En outre, le champ offload_enabled de l'Agent dans MSdistribution_agents (Transact-SQL) prend pour valeur 0, 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_disableagentoffload.

Voir aussi

Référence

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

Aide et Informations

Assistance sur SQL Server 2005

Partager via