sp_change_agent_parameter (Transact-SQL)

  • Artikel

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)