sp_change_agent_parameter (Transact-SQL)
Ändert einen Parameter eines Replikations-Agentprofils, das in der MSagent_parameters-Systemtabelle gespeichert ist. Diese gespeicherte Prozedur wird bei dem Verteiler, auf dem der Agent ausgeführt wird, für jede Datenbank ausgeführt.
Syntax
sp_change_agent_parameter [ @profile_id= ] profile_id, [ @parameter_name= ] 'parameter_name', [ @parameter_value= ] 'parameter_value'
Argumente
[ @profile_id=] profile_id,
Die ID des Profils. profile_id ist vom Datentyp int und hat keinen Standardwert.[ @parameter_name=] 'parameter_name'
Der Name des Parameters. parameter_name ist vom Datentyp sysname und hat keinen Standardwert. Bei Systemprofilen hängen die veränderbaren Parameter vom Typ des Agents ab. Wenn Sie herausfinden möchten, welchen Agenttyp dieser Wert für profile_id darstellt, suchen Sie die profile_id-Spalte in der Msagent_profiles-Tabelle, und beachten Sie den Wert für agent_type.Hinweis Wenn ein Parameter für einen angegebenen Wert für agent_type unterstützt wird, aber im Agentprofil nicht definiert wurde, wird ein Fehler zurückgegeben. Zum Hinzufügen eines Parameters zu einem Agentprofil müssen Sie sp_add_agent_parameter ausführen.
Für einen im Profil definierten Snapshot-Agent (agent_type=1) können die folgenden Eigenschaften geändert werden:
70Subscribers
BcpBatchSize
HistoryVerboseLevel
LoginTimeout
MaxBcpThreads
MaxNetworkOptimization
Ausgabe
OutputVerboseLevel
PacketSize
QueryTimeout
StartQueueTimeout
UsePerArticleContentsView
Für einen im Profil definierten Protokolllese-Agent (agent_type=2) können die folgenden Eigenschaften geändert werden:
HistoryVerboseLevel
LoginTimeout
MessageInterval
Ausgabe
OutputVerboseLevel
PacketSize
PollingInterval
QueryTimeout
ReadBatchSize
ReadBatchThreshold
Für einen im Profil definierten Verteilungs-Agent (agent_type=3) können die folgenden Eigenschaften geändert werden:
BcpBatchSize
CommitBatchSize
CommitBatchThreshold
FileTransferType
HistoryVerboseLevel
KeepAliveMessageInterval
LoginTimeout
MaxBcpThreads
MaxDeliveredTransactions
MessageInterval
Ausgabe
OutputVerboseLevel
PacketSize
PollingInterval
QueryTimeout
QuotedIdentifier
SkipErrors
TransactionsPerHistory
Für einen im Profil definierten Merge-Agent (agent_type=4) können die folgenden Eigenschaften geändert werden:
AltSnapshotFolder
BcpBatchSize
ChangesPerHistory
DestThreads
DownloadGenerationsPerBatch
DownloadReadChangesPerBatch
DownloadWriteChangesPerBatch
DynamicSnapshotLocation
ExchangeType
FastRowCount
FileTransferType
GenerationChangeThreshold
HistoryVerboseLevel
InputMessageFile
InteractiveResolution
InterruptOnMessagePattern
KeepAliveMessageInterval
LoginTimeout
MaxBcpThreads
MaxDownloadChanges
MaxUploadChanges
MetadataRetentionCleanup
NumDeadlockRetries
Ausgabe
OutputMessageFile
OutputVerboseLevel
PacketSize
ParallelUploadDownload
PauseOnMessagePattern
PauseTime
PollingInterval
ProcessMessagesAtPublisher
ProcessMessagesAtSubscriber
QueryTimeout
QueueSizeMultiplier
SrcThreads
StartQueueTimeout
SyncToAlternate
UploadGenerationsPerBatch
UploadReadChangesPerBatch
UploadWriteChangesPerBatch
UseInprocLoader
Überprüfen
ValidateInterval
Für einen im Profil definierten Warteschlangenlese-Agent (agent_type=9) können die folgenden Eigenschaften geändert werden:
HistoryVerboseLevel
LoginTimeout
Ausgabe
OutputVerboseLevel
PollingInterval
QueryTimeout
ResolverState
SQLQueueMode
Zum Anzeigen der definierten Parameter für ein bestimmtes Profil führen Sie sp_help_agent_profile aus, und beachten Sie den profile_id zugeordneten Wert für profile_name. Führen Sie dann sp_help_agent_parameters mit dem entsprechenden Wert für profile_id aus, um mithilfe des Werts für profile_id die dem Profil zugeordneten Parameter anzuzeigen. Parameter können einem Profil durch Ausführen von sp_add_agent_parameter hinzugefügt werden.
[ @parameter_value=] 'parameter_value'
Der neue Wert des Parameters. parameter_value ist vom Datentyp nvarchar(255) und hat keinen Standardwert.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Hinweise
sp_change_agent_parameter wird für alle Replikationstypen verwendet.
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin können sp_change_agent_parameter ausführen.
Siehe auch