sp_change_agent_parameter (Transact-SQL)

Article
05/07/2013

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.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @profile_id=] profile_id,
ID du profil. profile_id est de type int, sans valeur par défaut.
[ @parameter_name=] 'parameter_name'
Nom du paramètre. parameter_name est de type sysname, sans 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 d'instantané (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
- Sortie
- 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
- Sortie
- 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
- Sortie
- 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
- Sortie
- 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
- Sortie
- 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.