• Artikel

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.

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.

    HinweisHinweis

    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.