sp_add_agent_parameter (Transact-SQL)

Ajoute un nouveau paramètre et sa valeur au profil d'un agent. Cette procédure stockée est exécutée sur n'importe quelle base de données du serveur de distribution.

Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_add_agent_parameter [ @profile_id = ] profile_id
        , [ @parameter_name = ] 'parameter_name' 
        , [ @parameter_value = ] 'parameter_value' 

Arguments

• [ @profile_id= ] profile_id
  ID du profil provenant de la table MSagent_profiles de la base de données msdb. profile_id est de type int, sans valeur par défaut.

  Pour déterminer à quel type d'agent correspond la valeur de profile_id, recherchez cette valeur dans la table MSagent_profiles (Transact-SQL) et notez la valeur du champ agent_type. Les valeurs sont les suivantes :

  Valeur	Description
  1	Agent de capture instantanée
  2	Agent de lecture du journal
  3	Agent de distribution
  4	Agent de fusion
  9	Agent de lecture de la file d'attente

• [ @parameter_name= ] 'parameter_name'
  Nom du paramètre. parameter_name est de type sysname et n'a pas de valeur par défaut. Pour obtenir la liste des paramètres déjà définis dans les profils système, consultez Profils de l'Agent de réplication. Pour obtenir la liste complète des paramètres valides pour chaque agent, consultez les rubriques suivantes :

  • Replication Snapshot Agent
  • Replication Log Reader Agent
  • Replication Distribution Agent
  • Replication Merge Agent
  • Replication Queue Reader Agent

• [ @parameter_value=] 'parameter_value'
  Valeur à affecter au paramètre. parameter_value est de type nvarchar(255), sans valeur par défaut.

Notes

La procédure sp_add_agent_parameter est utilisée lors d'une réplication transactionnelle, de capture instantanée ou de fusion.

Autorisations

Seuls les membres appartenant au rôle de serveur fixe sysadmin peuvent exécuter sp_add_agent_parameter.

Valeurs des codes retournés

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

Voir aussi

Référence

sp_add_agent_profile (Transact-SQL)
sp_change_agent_profile (Transact-SQL)
sp_change_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)

Autres ressources

How to: Work with Replication Agent Profiles (Replication Transact-SQL Programming)
Profils de l'Agent de réplication

Aide et Informations

Assistance sur SQL Server 2005