sp_change_agent_parameter (Transact-SQL)

Sintassi

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

Argomenti

• [ @profile_id=] profile_id,
  ID del profilo. profile_id è di tipo int e non prevede alcun valore predefinito.

• [ @parameter_name=] 'parameter_name'
  Nome del parametro. parameter_name è di tipo sysname e non prevede alcun valore predefinito. I parametri che è possibile modificare per i profili sistema dipendono dal tipo di agente. Per identificare il tipo di agente rappresentato da profile_id, individuare la colonna profile_id nella tabella Msagent_profiles e prendere nota del valore di agent_type.

  Nota

  Se per un determinato agent_type è supportato un parametro non definito nel profilo agente, verrà restituito un errore. Per aggiungere un parametro a un profilo agente, è necessario eseguire sp_add_agent_parameter.

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

  • 70Subscribers

  • BcpBatchSize

  • HistoryVerboseLevel

  • LoginTimeout

  • MaxBcpThreads

  • MaxNetworkOptimization

  • Output

  • OutputVerboseLevel

  • PacketSize

  • QueryTimeout

  • StartQueueTimeout

  • UsePerArticleContentsView

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

  • HistoryVerboseLevel

  • LoginTimeout

  • MessageInterval

  • Output

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • ReadBatchSize

  • ReadBatchThreshold

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

  • BcpBatchSize

  • CommitBatchSize

  • CommitBatchThreshold

  • FileTransferType

  • HistoryVerboseLevel

  • KeepAliveMessageInterval

  • LoginTimeout

  • MaxBcpThreads

  • MaxDeliveredTransactions

  • MessageInterval

  • Output

  • OutputVerboseLevel

  • PacketSize

  • PollingInterval

  • QueryTimeout

  • QuotedIdentifier

  • SkipErrors

  • TransactionsPerHistory

  Se nel profilo è definito un agente di merge (agent_type=4), è 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

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

  • HistoryVerboseLevel

  • LoginTimeout

  • Output

  • OutputVerboseLevel

  • PollingInterval

  • QueryTimeout

  • ResolverState

  • SQLQueueMode

  Per visualizzare i parametri definiti per un profilo determinato, eseguire sp_help_agent_profile e prendere nota del valore profile_name associato a profile_id. Dopo aver individuato il valore profile_id appropriato, utilizzarlo per visualizzare i parametri associati al profilo mediante l'esecuzione di sp_help_agent_parameters. Per aggiungere parametri a un profilo eseguire sp_add_agent_parameter.

• [ @parameter_value=] 'parameter_value'
  Nuovo valore del parametro. parameter_value è di tipo nvarchar(255) e non prevede alcun valore predefinito.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

sp_change_agent_parameter viene utilizzata in tutti i tipi di replica.

Autorizzazioni

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

Vedere anche

Riferimento