Share via

sp_change_agent_parameter (Transact-SQL)

  • Artikel

Ä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.

Themenlink (Symbol)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,
    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.

    ms190313.note(de-de,SQL.90).gifHinweis:
    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 Wertes 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

Verweis

sp_add_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)

Andere Ressourcen

Replikations-Agent-Profile
Replication Distribution Agent
Replication Log Reader Agent
Replication Merge Agent
Replication Queue Reader Agent
Replication Snapshot Agent

Hilfe und Informationen

Informationsquellen für SQL Server 2005