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

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceYesVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceAnwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceYesVerwaltete Azure SQL-InstanzAzure SQL Managed Instance

Ändert einen Parameter eines Replikations-Agentprofils, das in der MSagent_parameters -Systemtabelle gespeichert ist.Changes a parameter of a replication agent profile stored in the MSagent_parameters system table. Diese gespeicherte Prozedur wird auf dem Verteiler, auf dem der Agent ausgeführt wird, für jede Datenbank ausgeführt.This stored procedure is executed at the Distributor where the agent is running, on any database.

Symbol für Themenlink Transact-SQL-SyntaxkonventionenTopic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

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

ArgumenteArguments

[ @profile_id = ] profile_id, Die ID des Profils.[ @profile_id = ] profile_id, Is the ID of the profile. profile_id ist vom Datentyp intund hat keinen Standardwert.profile_id is int, with no default.

[ @parameter_name = ] 'parameter_name' Der Name des Parameters.[ @parameter_name = ] 'parameter_name' Is the name of the parameter. parameter_name ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.parameter_name is sysname, with no default. Bei Systemprofilen hängen die veränderbaren Parameter vom Typ der Momentaufnahme ab.For system profiles, the parameters that can be changed depend on the type of agent. Um herauszufinden, welcher Agenttyp diese profile_id darstellt, suchen Sie die Spalte profile_id in der Tabelle MSagent_profiles , und notieren Sie sich den Wert 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.

Hinweis

Wenn ein Parameter für eine bestimmte agent_typeunterstützt, aber nicht im Agentprofil definiert wurde, wird ein Fehler zurückgegeben.If a parameter is supported for a given agent_type, but has not been defined in the agent profile, an error is returned. Wenn Sie einem Agentprofil einen Parameter hinzufügen möchten, müssen Sie sp_add_agent_parameterausführen.To add a parameter to an agent profile you must execute sp_add_agent_parameter.

Bei einer Momentaufnahmen-Agent (agent_type = 1), die im Profil definiert ist, können die folgenden Eigenschaften geändert werden:For a Snapshot Agent (agent_type=1), if defined in the profile, the following properties can be changed:

  • 70er-Abonnenten70Subscribers

  • BcpBatchSizeBcpBatchSize

  • HistoryVerboseLevelHistoryVerboseLevel

  • LoginTimeoutLoginTimeout

  • MaxBCPThreadsMaxBcpThreads

  • MaxNetworkOptimizationMaxNetworkOptimization

  • AusgabeOutput

  • OutputVerboseLevelOutputVerboseLevel

  • PacketSizePacketSize

  • QueryTimeoutQueryTimeout

  • StartQueueTimeoutStartQueueTimeout

  • UsePerArticleContentsViewUsePerArticleContentsView

Bei einer Protokolllese-Agent (agent_type = 2), die im Profil definiert ist, können die folgenden Eigenschaften geändert werden:For a Log Reader Agent (agent_type=2), if defined in the profile, the following properties can be changed:

  • HistoryVerboseLevelHistoryVerboseLevel

  • LoginTimeoutLoginTimeout

  • MessageIntervalMessageInterval

  • AusgabeOutput

  • OutputVerboseLevelOutputVerboseLevel

  • PacketSizePacketSize

  • PollingIntervalPollingInterval

  • QueryTimeoutQueryTimeout

  • ReadBatchSizeReadBatchSize

  • Read Batch ThresholdReadBatchThreshold

Bei einer Verteilungs-Agent (agent_type = 3), die im Profil definiert ist, können die folgenden Eigenschaften geändert werden:For a Distribution Agent (agent_type=3), if defined in the profile, the following properties can be changed:

  • BcpBatchSizeBcpBatchSize

  • CommitBatchSizeCommitBatchSize

  • CommitBatchThresholdCommitBatchThreshold

  • FileTransferTypeFileTransferType

  • HistoryVerboseLevelHistoryVerboseLevel

  • KeepalivemstinageintervalKeepAliveMessageInterval

  • LoginTimeoutLoginTimeout

  • MaxBCPThreadsMaxBcpThreads

  • MaxDeliveredTransactionsMaxDeliveredTransactions

  • MessageIntervalMessageInterval

  • AusgabeOutput

  • OutputVerboseLevelOutputVerboseLevel

  • PacketSizePacketSize

  • PollingIntervalPollingInterval

  • QueryTimeoutQueryTimeout

  • QuotedIdentifierQuotedIdentifier

  • SkipErrorsSkipErrors

  • TransactionsPerHistory anTransactionsPerHistory

Bei einer Merge-Agent (agent_type = 4), die im Profil definiert ist, können die folgenden Eigenschaften geändert werden:For a Merge Agent (agent_type=4), if defined in the profile, the following properties can be changed:

  • AltSnapshotFolderAltSnapshotFolder

  • BcpBatchSizeBcpBatchSize

  • ChangesPerHistoryChangesPerHistory

  • DestThreadsDestThreads

  • DownloadGenerationsPerBatchDownloadGenerationsPerBatch

  • DownloadumchangesperbatchDownloadReadChangesPerBatch

  • DownloadschreibchangesperbatchDownloadWriteChangesPerBatch

  • DynamicSnapshotLocationDynamicSnapshotLocation

  • ExchangeTypeExchangeType

  • FastrowcountFastRowCount

  • FileTransferTypeFileTransferType

  • GenerationChangeThresholdGenerationChangeThreshold

  • HistoryVerboseLevelHistoryVerboseLevel

  • InputMessageFileInputMessageFile

  • InteractiveResolutionInteractiveResolution

  • InterruptOnMessagePatternInterruptOnMessagePattern

  • KeepalivemstinageintervalKeepAliveMessageInterval

  • LoginTimeoutLoginTimeout

  • MaxBCPThreadsMaxBcpThreads

  • MaxDownloadChangesMaxDownloadChanges

  • MaxUploadChangesMaxUploadChanges

  • MetadataRetentionCleanupMetadataRetentionCleanup

  • NumdeadlockretriesNumDeadlockRetries

  • AusgabeOutput

  • OutputMessageFileOutputMessageFile

  • OutputVerboseLevelOutputVerboseLevel

  • PacketSizePacketSize

  • ParallelUploadDownloadParallelUploadDownload

  • PauseOnMessagePatternPauseOnMessagePattern

  • PauseTimePauseTime

  • PollingIntervalPollingInterval

  • ProcessMessagesAtPublisherProcessMessagesAtPublisher

  • ProcessMessagesAtSubscriberProcessMessagesAtSubscriber

  • QueryTimeoutQueryTimeout

  • QueuesizemultiplikatorQueueSizeMultiplier

  • SrcThreadsSrcThreads

  • StartQueueTimeoutStartQueueTimeout

  • SyncToAlternateSyncToAlternate

  • UploadGenerationsPerBatchUploadGenerationsPerBatch

  • UploadReadChangesPerBatchUploadReadChangesPerBatch

  • UploadschreitechangesperbatchUploadWriteChangesPerBatch

  • UseInprocLoaderUseInprocLoader

  • ÜberprüfenValidate

  • ValidateIntervalValidateInterval

Bei einem Warteschlangenlese-Agent (agent_type = 9), wenn es im Profil definiert ist, können die folgenden Eigenschaften geändert werden:For a Queue Reader Agent (agent_type=9), if defined in the profile, the following properties can be changed:

  • HistoryVerboseLevelHistoryVerboseLevel

  • LoginTimeoutLoginTimeout

  • AusgabeOutput

  • OutputVerboseLevelOutputVerboseLevel

  • PollingIntervalPollingInterval

  • QueryTimeoutQueryTimeout

  • ResolverStateResolverState

  • SQLQueueModeSQLQueueMode

Um zu sehen, welche Parameter für ein bestimmtes Profil definiert wurden, führen Sie sp_help_agent_profile aus, und notieren Sie sich die profile_name , die dem profile_idzugeordnet sind.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. Führen Sie mit dem entsprechenden profile_idals nächstes sp_help_agent_parameters mithilfe dieses profile_id aus, um die Parameter anzuzeigen, die dem Profil zugeordnet sind.With the appropriate profile_id, next run sp_help_agent_parameters using that profile_id to see the parameters associated with the profile. Parameter können einem Profil hinzugefügt werden, indem sp_add_agent_parameterausgeführt wird.Parameters can be added to a profile by executing sp_add_agent_parameter.

[ @parameter_value = ] 'parameter_value' Der neue Wert des-Parameters.[ @parameter_value = ] 'parameter_value' Is the new value of the parameter. parameter_value ist vom Datentyp nvarchar (255) und hat keinen Standardwert.parameter_value is nvarchar(255), with no default.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

HinweiseRemarks

sp_change_agent_parameter wird bei allen Replikations Typen verwendet.sp_change_agent_parameter is used in all types of replication.

BerechtigungenPermissions

Nur Mitglieder der festen Server Rolle sysadmin können sp_change_agent_parameterausführen.Only members of the sysadmin fixed server role can execute sp_change_agent_parameter.

Weitere InformationenSee Also

Replikations-Agent-Profile Replication Agent Profiles
Replication Distribution Agent Replication Distribution Agent
Replication Log Reader Agent Replication Log Reader Agent
Replication Merge Agent Replication Merge Agent
Warteschlangenlese-Agent der Microsoft SQL Server-Replikation 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)
Gespeicherte Systemprozeduren (Transact-SQL)System Stored Procedures (Transact-SQL)