Freigeben über


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_typeParameter 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_idBefehl 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.