sp_change_agent_parameter (Transact-SQL)
Gilt für: SQL Server Azure 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 = ] N'parameter_name'
, [ @parameter_value = ] N'parameter_value'
[ ; ]
Argumente
[ @profile_id = ] profile_id
Die ID des Profils. @profile_id ist "int" ohne Standard.
[ @parameter_name = ] N'parameter_name'
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 profile_id
Spalte in der Msagent_profiles
Tabelle, und notieren Sie den agent_type
Wert.
Wenn ein Parameter für einen bestimmten agent_type
Parameter unterstützt wird, aber nicht im Agentprofil definiert ist, wird ein Fehler zurückgegeben. Um einem Agentprofil einen Parameter hinzuzufügen, müssen Sie sp_add_agent_parameter ausführen.
Bei einem Momentaufnahmen-Agent (agent_type = 1
), wenn im Profil definiert, können die folgenden Eigenschaften geändert werden:
70Subscribers
BcpBatchSize
HistoryVerboseLevel
LoginTimeout
MaxBcpThreads
MaxNetworkOptimization
Output
OutputVerboseLevel
PacketSize
QueryTimeout
StartQueueTimeout
UsePerArticleContentsView
Bei einem Protokollleser-Agent (agent_type = 2
), falls im Profil definiert, können die folgenden Eigenschaften geändert werden:
HistoryVerboseLevel
LoginTimeout
MessageInterval
Output
OutputVerboseLevel
PacketSize
PollingInterval
QueryTimeout
ReadBatchSize
ReadBatchThreshold
Bei einem Verteilungs-Agent (agent_type = 3
), falls im Profil definiert, können die folgenden Eigenschaften geändert werden:
BcpBatchSize
CommitBatchSize
CommitBatchThreshold
FileTransferType
HistoryVerboseLevel
KeepAliveMessageInterval
LoginTimeout
MaxBcpThreads
MaxDeliveredTransactions
MessageInterval
Output
OutputVerboseLevel
PacketSize
PollingInterval
QueryTimeout
QuotedIdentifier
SkipErrors
TransactionsPerHistory
Bei einem Merge-Agent (agent_type = 4
), falls im Profil definiert, 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
Output
OutputMessageFile
OutputVerboseLevel
PacketSize
ParallelUploadDownload
PauseOnMessagePattern
PauseTime
PollingInterval
ProcessMessagesAtPublisher
ProcessMessagesAtSubscriber
QueryTimeout
QueueSizeMultiplier
SrcThreads
StartQueueTimeout
SyncToAlternate
UploadGenerationsPerBatch
UploadReadChangesPerBatch
UploadWriteChangesPerBatch
UseInprocLoader
Validate
ValidateInterval
Für einen Warteschlangenleser-Agent (agent_type = 9
), falls im Profil definiert, können die folgenden Eigenschaften geändert werden:
HistoryVerboseLevel
LoginTimeout
Output
OutputVerboseLevel
PollingInterval
QueryTimeout
ResolverState
SQLQueueMode
Um zu sehen, welche Parameter für ein bestimmtes Profil definiert sind, führen Sie aus sp_help_agent_profile
, und notieren Sie den profile_name
zugeordneten profile_id
. Führen Sie mit dem entsprechenden profile_id
Befehl die folgenden Schritte aus sp_help_agent_parameters
profile_id
, um die parameter anzuzeigen, die dem Profil zugeordnet sind. Parameter können einem Profil hinzugefügt werden, indem sp_add_agent_parameter ausgeführt werden.
[ @parameter_value = ] N'parameter_value'
Der neue Wert des Parameters @parameter_value ist nvarchar(255), ohne Standard.
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Hinweise
sp_change_agent_parameter
wird in allen Replikationstypen verwendet.
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin können ausgeführt werden sp_change_agent_parameter
.
Zugehöriger Inhalt
- 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)