sp_change_agent_parameter (Transact-SQL)

Si applica a: SQL Server Istanza gestita di SQL di Azure

Modifica un parametro di un profilo dell'agente di replica archiviato nella tabella di sistema MSagent_parameters . Questa stored procedure viene eseguita in qualsiasi database del server di distribuzione in cui l'agente è in esecuzione.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_change_agent_parameter
    [ @profile_id = ] profile_id
    , [ @parameter_name = ] N'parameter_name'
    , [ @parameter_value = ] N'parameter_value'
[ ; ]

Argomenti

[ @profile_id = ] profile_id

ID del profilo. @profile_id è int, senza impostazione predefinita.

[ @parameter_name = ] N'parameter_name'

Nome del parametro. @parameter_name è sysname, senza impostazione predefinita. I parametri che è possibile modificare per i profili sistema dipendono dal tipo di agente. Per scoprire il tipo di agente rappresentato da questa @profile_id , individuare la profile_id colonna nella Msagent_profiles tabella e prendere nota del agent_type valore.

Se un parametro è supportato per un determinato agent_typeoggetto , ma non è definito nel profilo dell'agente, viene restituito un errore. Per aggiungere un parametro a un profilo agente, è necessario eseguire sp_add_agent_parameter.

Per un agente di snapshot (agent_type = 1), se definito nel profilo, è possibile modificare le proprietà seguenti:

  • 70Subscribers
  • BcpBatchSize
  • HistoryVerboseLevel
  • LoginTimeout
  • MaxBcpThreads
  • MaxNetworkOptimization
  • Output
  • OutputVerboseLevel
  • PacketSize
  • QueryTimeout
  • StartQueueTimeout
  • UsePerArticleContentsView

Per un agente di lettura log (agent_type = 2), se definito nel profilo, è possibile modificare le proprietà seguenti:

  • HistoryVerboseLevel
  • LoginTimeout
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • PollingInterval
  • QueryTimeout
  • ReadBatchSize
  • ReadBatchThreshold

Per un agente di distribuzione (agent_type = 3), se definito nel profilo, è possibile modificare le proprietà seguenti:

  • BcpBatchSize
  • CommitBatchSize
  • CommitBatchThreshold
  • FileTransferType
  • HistoryVerboseLevel
  • KeepAliveMessageInterval
  • LoginTimeout
  • MaxBcpThreads
  • MaxDeliveredTransactions
  • MessageInterval
  • Output
  • OutputVerboseLevel
  • PacketSize
  • PollingInterval
  • QueryTimeout
  • QuotedIdentifier
  • SkipErrors
  • TransactionsPerHistory

Per un agente di merge (agent_type = 4), se definito nel profilo, è possibile modificare le proprietà seguenti:

  • 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

Per un agente di lettura coda (agent_type = 9), se definito nel profilo, è possibile modificare le proprietà seguenti:

  • HistoryVerboseLevel
  • LoginTimeout
  • Output
  • OutputVerboseLevel
  • PollingInterval
  • QueryTimeout
  • ResolverState
  • SQLQueueMode

Per visualizzare i parametri definiti per un determinato profilo, eseguire sp_help_agent_profile e prendere nota dell'oggetto profile_name profile_idassociato a . Con l'oggetto appropriato profile_id, eseguire sp_help_agent_parameters quindi usando tale profile_id parametro per visualizzare i parametri associati al profilo. I parametri possono essere aggiunti a un profilo eseguendo sp_add_agent_parameter.

[ @parameter_value = ] N'parameter_value'

Nuovo valore del parametro @parameter_value è nvarchar(255), senza impostazione predefinita.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_change_agent_parameter viene usato in tutti i tipi di replica.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_change_agent_parameter.