sp_change_agent_parameter (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL Managed Instance

Modifie un paramètre d’un profil d’agent de réplication stocké 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 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 int, sans valeur par défaut.

[ @parameter_name = ] 'parameter_name' Nom du paramètre. parameter_name est sysname, sans valeur par défaut. Pour les profils système, les paramètres modifiables dépendent du type d'Agent. Pour savoir quel type d’agent cette profile_id représente, recherchez la colonne profile_id dans la table Msagent_profiles et notez la valeur agent_type.

Remarque

Si un paramètre est pris en charge pour une agent_type donnée, mais n’a pas été défini dans le profil de l’agent, une erreur est retourné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, les propriétés suivantes peuvent être modifiées :

  • 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, les propriétés suivantes peuvent être modifiées :

  • HistoryVerboseLevel

  • LoginTimeout

  • MessageInterval

  • Sortie

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • ReadBatchSize

  • ReadBatchThreshold

Pour une Agent de distribution (agent_type=3), si elle est définie dans le profil, les propriétés suivantes peuvent être modifiées :

  • BcpBatchSize

  • CommitBatchSize

  • CommitBatchThreshold

  • FileTransferType

  • HistoryVerboseLevel

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDeliveredTransactions

  • MessageInterval

  • Sortie

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • QuotedIdentifier

  • SkipErrors

  • TransactionsPerHistory

Pour une Agent de fusion (agent_type=4), si elle est définie dans le profil, les propriétés suivantes peuvent être modifiées :

  • 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

  • Procéder à la validation

  • ValidateInterval

Pour un Agent de lecture de file d’attente (agent_type=9), s’il est défini dans le profil, les propriétés suivantes peuvent être modifiées :

  • HistoryVerboseLevel

  • LoginTimeout

  • Sortie

  • OutputVerboseLevel

  • PollingInterval

  • QueryTimeout

  • ResolverState

  • SQLQueueMode

Pour voir quels paramètres ont été définis pour un profil donné, exécutez sp_help_agent_profile et notez le profile_name associé au profile_id. Avec la profile_id appropriée, exécutez ensuite sp_help_agent_parameters à l’aide de cette profile_id pour afficher les paramètres associés au profil. Les paramètres peuvent être ajoutés à un profil en exécutant sp_add_agent_parameter.

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

Codet de retour

0 (réussite) ou 1 (échec)

Notes

sp_change_agent_parameter est utilisé dans tous les types de réplication.

Autorisations

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

Voir aussi

Profils de l’Agent de réplication
Replication Distribution Agent
Agent de lecture du journal des réplications
Replication Merge Agent
Agent de lecture de la file d’attente de réplication
Replication Snapshot Agent
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)