sp_change_agent_parameter (Transact-SQL)
Gilt für:SQL ServerAzure SQL Managed Instance
Ändert einen Parameter eines Replikations-Agent-Profils, das in der MSagent_parameters Systemtabelle gespeichert ist. Diese gespeicherte Prozedur wird auf dem Verteiler, auf dem der Agent ausgeführt wird, für jede Datenbank ausgeführt.
Transact-SQL-Syntaxkonventionen
Syntax
sp_change_agent_parameter [ @profile_id= ] profile_id, [ @parameter_name= ] 'parameter_name', [ @parameter_value= ] 'parameter_value'
Argumente
[ @profile_id = ] profile_id,
Ist die ID des Profils. profile_id ist "int" ohne Standard.
[ @parameter_name = ] 'parameter_name'
Ist der Name des Parameters. parameter_name ist "sysname" ohne Standard. Bei Systemprofilen hängen die veränderbaren Parameter vom Typ der Momentaufnahme ab. Um herauszufinden, welchen Agenttyp dieser profile_id darstellt, suchen Sie die spalte profile_id in der Msagent_profiles Tabelle, und notieren Sie sich den agent_type Wert.
Hinweis
Wenn ein Parameter für eine bestimmte agent_type unterstützt wird, aber nicht im Agentprofil definiert wurde, wird ein Fehler zurückgegeben. Um einem Agentprofil einen Parameter hinzuzufügen, müssen Sie sp_add_agent_parameter ausführen.
Bei einer Momentaufnahmen-Agent (agent_type=1) können die folgenden Eigenschaften geändert werden, wenn sie im Profil definiert sind:
70Subscribers
BcpBatchSize
HistoryVerboseLevel
LoginTimeout
MaxBcpThreads
MaxNetworkOptimization
Output
OutputVerboseLevel
PacketSize
Querytimeout
StartQueueTimeout
UsePerArticleContentsView
Bei einem Protokollleser-Agent (agent_type=2) können die folgenden Eigenschaften geändert werden, wenn sie im Profil definiert sind:
HistoryVerboseLevel
LoginTimeout
MessageInterval
Output
OutputVerboseLevel
PacketSize
PollingInterval
Querytimeout
ReadBatchSize
ReadBatchThreshold
Bei einer Verteilungs-Agent (agent_type=3) können die folgenden Eigenschaften geändert werden, wenn sie im Profil definiert sind:
BcpBatchSize
CommitBatchSize
CommitBatchThreshold
FileTransferType
HistoryVerboseLevel
KeepAliveMessageInterval
LoginTimeout
MaxBcpThreads
MaxDeliveredTransactions
MessageInterval
Output
OutputVerboseLevel
PacketSize
PollingInterval
Querytimeout
QuotedIdentifier
Skiperrors
TransactionsPerHistory
Bei einer Merge-Agent (agent_type=4) können die folgenden Eigenschaften geändert werden, wenn sie im Profil definiert sind:
AltSnapshotFolder
BcpBatchSize
ChangesPerHistory
DestThreads
DownloadGenerationsPerBatch
DownloadReadChangesPerBatch
DownloadWriteChangesPerBatch
DynamicSnapshotLocation
Exchangetype
FastRowCount
FileTransferType
GenerationChangeThreshold
HistoryVerboseLevel
InputMessageFile
InteractiveResolution
InterruptOnMessagePattern
KeepAliveMessageInterval
LoginTimeout
MaxBcpThreads
MaxDownloadChanges
MaxUploadChanges
MetadataRetentionCleanup
NumDeadlockRetries
Output
OutputMessageFile
OutputVerboseLevel
PacketSize
ParallelUploadDownload
PauseOnMessagePattern
PauseTime
PollingInterval
ProcessMessagesAtPublisher
ProcessMessagesAtSubscriber
Querytimeout
QueueSizeMultiplier
SrcThreads
StartQueueTimeout
SyncToAlternate
UploadGenerationsPerBatch
UploadReadChangesPerBatch
UploadWriteChangesPerBatch
UseInprocLoader
Überprüfen
ValidateInterval
Bei einem Warteschlangenleser-Agent (agent_type=9) können die folgenden Eigenschaften geändert werden, wenn sie im Profil definiert sind:
HistoryVerboseLevel
LoginTimeout
Output
OutputVerboseLevel
PollingInterval
Querytimeout
ResolverState
SQLQueueMode
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 dem profile_id zugeordneten profile_name. Führen Sie mit dem entsprechenden profile_id sp_help_agent_parameters mit diesem profile_id aus, um die dem Profil zugeordneten Parameter anzuzeigen. Parameter können einem Profil hinzugefügt werden, indem sp_add_agent_parameter ausgeführt werden.
[ @parameter_value = ] 'parameter_value'
Ist der neue Wert des Parameters. parameter_value ist nvarchar(255), ohne Standard.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Hinweise
sp_change_agent_parameter wird in allen Replikationstypen verwendet.
Berechtigungen
Nur Mitglieder der festen Serverrolle "sysadmin" können sp_change_agent_parameter ausführen.
Weitere Informationen
Replikations-Agent-Profile
Replication Distribution Agent
Replikationsprotokolllese-Agent
Replication Merge Agent
Replication Queue Reader Agent
Replication Snapshot Agent
sp_add_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für