sp_change_agent_parameter (Transact-SQL)
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)
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour