sp_change_agent_parameter (Transact-SQL)sp_change_agent_parameter (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Modifie un paramètre d’un profil d’agent de réplication stocké dans la table système MSagent_parameters .Changes a parameter of a replication agent profile stored in the MSagent_parameters system table. 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.This stored procedure is executed at the Distributor where the agent is running, on any database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @profile_id = ] profile_id,ID du profil.[ @profile_id = ] profile_id, Is the ID of the profile. l’option par défaut est de type int, sans valeur par défaut.profile_id is int, with no default.

[ @parameter_name = ] 'parameter_name'Nom du paramètre.[ @parameter_name = ] 'parameter_name' Is the name of the parameter. nom_de_paramètre est de type sysname, sans valeur par défaut.parameter_name is sysname, with no default. Pour les profils système, les paramètres modifiables dépendent du type d'Agent.For system profiles, the parameters that can be changed depend on the type of agent. Pour connaître le type d’agent représenté par le type d’élément, recherchez la colonne dans la table MSagent_profiles et notez la valeur agent_type .To find out what type of agent this profile_id represents, locate the profile_id column in the Msagent_profiles table, and note the agent_type value.

Notes

Si un paramètre est pris en charge pour un agent_typedonné, mais qu’il n’a pas été défini dans le profil d’agent, une erreur est retournée.If a parameter is supported for a given agent_type, but has not been defined in the agent profile, an error is returned. Pour ajouter un paramètre à un profil d’agent, vous devez exécuter sp_add_agent_parameter.To add a parameter to an agent profile you must execute sp_add_agent_parameter.

Pour une agent d’instantané (agent_type=1), si elle est définie dans le profil, les propriétés suivantes peuvent être modifiées:For a Snapshot Agent (agent_type=1), if defined in the profile, the following properties can be changed:

  • 70Subscribers70Subscribers

  • BcpBatchSizeBcpBatchSize

  • HistoryVerboseLevelHistoryVerboseLevel

  • LoginTimeoutLoginTimeout

  • MaxBcpThreadsMaxBcpThreads

  • MaxNetworkOptimizationMaxNetworkOptimization

  • SortieOutput

  • OutputVerboseLevelOutputVerboseLevel

  • PacketSizePacketSize

  • QueryTimeoutQueryTimeout

  • StartQueueTimeoutStartQueueTimeout

  • UsePerArticleContentsViewUsePerArticleContentsView

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:For a Log Reader Agent (agent_type=2), if defined in the profile, the following properties can be changed:

  • HistoryVerboseLevelHistoryVerboseLevel

  • LoginTimeoutLoginTimeout

  • MessageIntervalMessageInterval

  • SortieOutput

  • OutputVerboseLevelOutputVerboseLevel

  • PacketSizePacketSize

  • PollingIntervalPollingInterval

  • QueryTimeoutQueryTimeout

  • ReadBatchSizeReadBatchSize

  • ReadBatchThresholdReadBatchThreshold

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:For a Distribution Agent (agent_type=3), if defined in the profile, the following properties can be changed:

  • BcpBatchSizeBcpBatchSize

  • CommitBatchSizeCommitBatchSize

  • CommitBatchThresholdCommitBatchThreshold

  • FileTransferTypeFileTransferType

  • HistoryVerboseLevelHistoryVerboseLevel

  • KeepAliveMessageIntervalKeepAliveMessageInterval

  • LoginTimeoutLoginTimeout

  • MaxBcpThreadsMaxBcpThreads

  • MaxDeliveredTransactionsMaxDeliveredTransactions

  • MessageIntervalMessageInterval

  • SortieOutput

  • OutputVerboseLevelOutputVerboseLevel

  • PacketSizePacketSize

  • PollingIntervalPollingInterval

  • QueryTimeoutQueryTimeout

  • QuotedIdentifierQuotedIdentifier

  • SkipErrorsSkipErrors

  • TransactionsPerHistoryTransactionsPerHistory

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:For a Merge Agent (agent_type=4), if defined in the profile, the following properties can be changed:

  • AltSnapshotFolderAltSnapshotFolder

  • BcpBatchSizeBcpBatchSize

  • ChangesPerHistoryChangesPerHistory

  • DestThreadsDestThreads

  • DownloadGenerationsPerBatchDownloadGenerationsPerBatch

  • DownloadReadChangesPerBatchDownloadReadChangesPerBatch

  • DownloadWriteChangesPerBatchDownloadWriteChangesPerBatch

  • DynamicSnapshotLocationDynamicSnapshotLocation

  • ExchangeTypeExchangeType

  • FastRowCountFastRowCount

  • FileTransferTypeFileTransferType

  • GenerationChangeThresholdGenerationChangeThreshold

  • HistoryVerboseLevelHistoryVerboseLevel

  • InputMessageFileInputMessageFile

  • InteractiveResolutionInteractiveResolution

  • InterruptOnMessagePatternInterruptOnMessagePattern

  • KeepAliveMessageIntervalKeepAliveMessageInterval

  • LoginTimeoutLoginTimeout

  • MaxBcpThreadsMaxBcpThreads

  • MaxDownloadChangesMaxDownloadChanges

  • MaxUploadChangesMaxUploadChanges

  • MetadataRetentionCleanupMetadataRetentionCleanup

  • NumDeadlockRetriesNumDeadlockRetries

  • SortieOutput

  • OutputMessageFileOutputMessageFile

  • OutputVerboseLevelOutputVerboseLevel

  • PacketSizePacketSize

  • ParallelUploadDownloadParallelUploadDownload

  • PauseOnMessagePatternPauseOnMessagePattern

  • PauseTimePauseTime

  • PollingIntervalPollingInterval

  • ProcessMessagesAtPublisherProcessMessagesAtPublisher

  • ProcessMessagesAtSubscriberProcessMessagesAtSubscriber

  • QueryTimeoutQueryTimeout

  • QueueSizeMultiplierQueueSizeMultiplier

  • SrcThreadsSrcThreads

  • StartQueueTimeoutStartQueueTimeout

  • SyncToAlternateSyncToAlternate

  • UploadGenerationsPerBatchUploadGenerationsPerBatch

  • UploadReadChangesPerBatchUploadReadChangesPerBatch

  • UploadWriteChangesPerBatchUploadWriteChangesPerBatch

  • UseInprocLoaderUseInprocLoader

  • ValiderValidate

  • ValidateIntervalValidateInterval

Pour une agent de lecture de la file d’attente (agent_type=9), si elle est définie dans le profil, les propriétés suivantes peuvent être modifiées:For a Queue Reader Agent (agent_type=9), if defined in the profile, the following properties can be changed:

  • HistoryVerboseLevelHistoryVerboseLevel

  • LoginTimeoutLoginTimeout

  • SortieOutput

  • OutputVerboseLevelOutputVerboseLevel

  • PollingIntervalPollingInterval

  • QueryTimeoutQueryTimeout

  • ResolverStateResolverState

  • SQLQueueModeSQLQueueMode

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 modèlede page.To see what parameters have been defined for a given profile, run sp_help_agent_profile and note the profile_name associated with the profile_id. Avec le modèlede page de démarrage approprié, exécutez ensuite sp_help_agent_parameters à l’aide de ce paramètre d’utilisation pour afficher les paramètres associés au profil.With the appropriate profile_id, next run sp_help_agent_parameters using that profile_id to see the parameters associated with the profile. Les paramètres peuvent être ajoutés à un profil en exécutant sp_add_agent_parameter.Parameters can be added to a profile by executing sp_add_agent_parameter.

[ @parameter_value = ] 'parameter_value'Nouvelle valeur du paramètre.[ @parameter_value = ] 'parameter_value' Is the new value of the parameter. parameter_value est de type nvarchar (255) , sans valeur par défaut.parameter_value is nvarchar(255), with no default.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_change_agent_parameter est utilisé dans tous les types de réplications.sp_change_agent_parameter is used in all types of replication.

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_change_agent_parameter.Only members of the sysadmin fixed server role can execute sp_change_agent_parameter.

Voir aussiSee Also

Profils de l’Agent de réplication Replication Agent Profiles
Replication Distribution Agent Replication Distribution Agent
Agent de lecture du journal de réplication Replication Log Reader Agent
Agent de fusion de réplication Replication Merge Agent
Agent de lecture de la file d'attente de réplication Replication Queue Reader Agent
Replication Snapshot Agent Replication Snapshot Agent
sp_add_agent_parameter (Transact-SQL) sp_add_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL) sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL) sp_help_agent_parameter (Transact-SQL)
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)