sp_disableagentoffload (Transact-SQL)
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)