sp_change_agent_parameter (Transact-SQL)

Modifie un paramètre d'un profil de l'Agent de réplication enregistré dans la table système MSagent_parameters. Cette procédure stockée est exécutée sur n'importe quelle base de données du serveur de distribution sur lequel l'Agent est en cours d'exécution.

Conventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

• [ @profile_id=] profile_id,
  Identificateur du profil. L'argument profile_id est de type int, sans valeur par défaut.

• [ @parameter_name=] 'parameter_name'
  Nom du paramètre. L'argument parameter_name est de type sysname et n'a pas de valeur par défaut. Pour les profils système, les paramètres modifiables dépendent du type d'Agent. Pour déterminer le type d'Agent représenté par profile_id, recherchez la colonne profile_id dans la table Msagent_profiles et notez la valeur de agent_type.

  Remarque :
  Si un paramètre est pris en charge pour un agent_type donné, mais qu'il n'a pas été défini dans le profil de l'Agent, une erreur est renvoyée. Pour ajouter un paramètre à un profil d'Agent, vous devez exécuter sp_add_agent_parameter.

  Pour un Agent de capture instantanée (agent_type=1), s'il est défini dans le profil, vous pouvez modifier les propriétés suivantes :

  • 70Subscribers
  • BcpBatchSize
  • HistoryVerboseLevel
  • LoginTimeout
  • MaxBcpThreads
  • MaxNetworkOptimization
  • Output
  • OutputVerboseLevel
  • PacketSize
  • QueryTimeout
  • StartQueueTimeout
  • UsePerArticleContentsView

  Pour un Agent de lecture du journal (agent_type=2), s'il est défini dans le profil, vous pouvez modifier les propriétés suivantes :

  • HistoryVerboseLevel
  • LoginTimeout
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • PollingInterval
  • QueryTimeout
  • ReadBatchSize
  • ReadBatchThreshold

  Pour un Agent de distribution (agent_type=3), s'il est défini dans le profil, vous pouvez modifier les propriétés suivantes :

  • BcpBatchSize
  • CommitBatchSize
  • CommitBatchThreshold
  • FileTransferType
  • HistoryVerboseLevel
  • KeepAliveMessageInterval
  • LoginTimeout
  • MaxBcpThreads
  • MaxDeliveredTransactions
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • PollingInterval
  • QueryTimeout
  • QuotedIdentifier
  • SkipErrors
  • TransactionsPerHistory

  Pour un Agent de fusion (agent_type=4), s'il est défini dans le profil, vous pouvez modifier les propriétés suivantes :

  • AltSnapshotFolder
  • BcpBatchSize
  • ChangesPerHistory
  • DestThreads
  • DownloadGenerationsPerBatch
  • DownloadReadChangesPerBatch
  • DownloadWriteChangesPerBatch
  • DynamicSnapshotLocation
  • ExchangeType
  • FastRowCount
  • FileTransferType
  • GenerationChangeThreshold
  • HistoryVerboseLevel
  • InputMessageFile
  • InteractiveResolution
  • InterruptOnMessagePattern
  • KeepAliveMessageInterval
  • LoginTimeout
  • MaxBcpThreads
  • MaxDownloadChanges
  • MaxUploadChanges
  • MetadataRetentionCleanup
  • NumDeadlockRetries
  • Output
  • OutputMessageFile
  • OutputVerboseLevel
  • PacketSize
  • ParallelUploadDownload.
  • PauseOnMessagePattern
  • PauseTime
  • PollingInterval
  • ProcessMessagesAtPublisher
  • ProcessMessagesAtSubscriber
  • QueryTimeout
  • QueueSizeMultiplier
  • SrcThreads
  • StartQueueTimeout
  • SyncToAlternate
  • UploadGenerationsPerBatch
  • UploadReadChangesPerBatch
  • UploadWriteChangesPerBatch
  • UseInprocLoader
  • Validate
  • ValidateInterval

  Pour un Agent de lecture de la file d'attente (agent_type=9), s'il est défini dans le profil, vous pouvez modifier les propriétés suivantes :

  • HistoryVerboseLevel
  • LoginTimeout
  • Output
  • OutputVerboseLevel
  • PollingInterval
  • QueryTimeout
  • ResolverState
  • SQLQueueMode

  Pour afficher les paramètres définis pour un profil donné, exécutez sp_help_agent_profile et notez la valeur de profile_name associée à celle de profile_id. À l'aide de la valeur de profile_id appropriée, exécutez ensuite sp_help_agent_parameters en utilisant cette valeur de profile_id pour afficher les paramètres associés au profil. Vous ajoutez des paramètres au profil en exécutant sp_add_agent_parameter.

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

Notes

La procédure sp_change_agent_parameter est utilisée dans tous les types de réplications.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter la procédure sp_change_agent_parameter.

Valeurs des codes renvoyés

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

Voir aussi

Référence

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

Autres ressources

Profils de l'Agent de réplication
Replication Distribution Agent
Replication Log Reader Agent
Replication Merge Agent
Replication Queue Reader Agent
Replication Snapshot Agent

Aide et Informations

Assistance sur SQL Server 2005