sp_change_agent_parameter (Transact-SQL)

Artículo
05/08/2013

Cambia un parámetro de un perfil de agente de replicación almacenado en la tabla del sistema MSagent_parameters. Este procedimiento almacenado se ejecuta en el distribuidor en el que se está ejecutando el agente, en cualquier base de datos.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @profile_id=] profile_id,
Es el identificador del perfil. profile_id es de tipo int y no tiene ningún valor predeterminado.
[ @parameter_name=] 'parameter_name'
Es el nombre del parámetro. parameter_name es de tipo sysname y no tiene ningún valor predeterminado. Para los perfiles del sistema, los parámetros que se pueden cambiar dependen del tipo de agente. Para saber qué tipo de agente representa este profile_id, busque la columna profile_id en la tabla Msagent_profiles y observe el valor de agent_type.

[!NOTA]

Si se admite un parámetro para un agent_type determinado, pero no se ha definido en el perfil del agente, se muestra un error. Para agregar un parámetro a un perfil del agente debe ejecutar sp_add_agent_parameter.

Para un Agente de instantáneas (agent_type=1), si está definido en el perfil, pueden cambiarse las siguientes propiedades:
- 70Subscribers
- BcpBatchSize
- HistoryVerboseLevel
- LoginTimeout
- MaxBcpThreads
- MaxNetworkOptimization
- Resultados
- OutputVerboseLevel
- PacketSize
- QueryTimeout
- StartQueueTimeout
- UsePerArticleContentsView
Para un Agente de registro del LOG (agent_type=2), si está definido en el perfil, pueden cambiarse las siguientes propiedades:
- HistoryVerboseLevel
- LoginTimeout
- MessageInterval
- Resultados
- OutputVerboseLevel
- PacketSize
- PollingInterval
- QueryTimeout
- ReadBatchSize
- ReadBatchThreshold
Para un Agente de distribución (agent_type=3), si está definido en el perfil, pueden cambiarse las siguientes propiedades:
- BcpBatchSize
- CommitBatchSize
- CommitBatchThreshold
- FileTransferType
- HistoryVerboseLevel
- KeepAliveMessageInterval
- LoginTimeout
- MaxBcpThreads
- MaxDeliveredTransactions
- MessageInterval
- Resultados
- OutputVerboseLevel
- PacketSize
- PollingInterval
- QueryTimeout
- QuotedIdentifier
- SkipErrors
- TransactionsPerHistory
Para un Agente de mezcla (agent_type=4), si está definido en el perfil, pueden cambiarse las siguientes propiedades:
- AltSnapshotFolder
- BcpBatchSize
- ChangesPerHistory
- DestThreads
- DownloadGenerationsPerBatch
- DownloadReadChangesPerBatch
- DownloadWriteChangesPerBatch
- DynamicSnapshotLocation
- ExchangeType
- FastRowCount
- FileTransferType
- GenerationChangeThreshold
- HistoryVerboseLevel
- InputMessageFile
- InteractiveResolution
- InterruptOnMessagePattern
- KeepAliveMessageInterval
- LoginTimeout
- MaxBcpThreads
- MaxDownloadChanges
- MaxUploadChanges
- MetadataRetentionCleanup
- NumDeadlockRetries
- Resultados
- OutputMessageFile
- OutputVerboseLevel
- PacketSize
- ParallelUploadDownload
- PauseOnMessagePattern
- PauseTime
- PollingInterval
- ProcessMessagesAtPublisher
- ProcessMessagesAtSubscriber
- QueryTimeout
- QueueSizeMultiplier
- SrcThreads
- StartQueueTimeout
- SyncToAlternate
- UploadGenerationsPerBatch
- UploadReadChangesPerBatch
- UploadWriteChangesPerBatch
- UseInprocLoader
- Validar
- ValidateInterval
Para un Agente de lectura de cola (agent_type=9), si está definido en el perfil, pueden cambiarse las siguientes propiedades:
- HistoryVerboseLevel
- LoginTimeout
- Resultados
- OutputVerboseLevel
- PollingInterval
- QueryTimeout
- ResolverState
- SQLQueueMode
Para ver los parámetros que se han definido para un perfil determinado, ejecute sp_help_agent_profile y observe profile_name asociado a profile_id. Con el profile_id adecuado, ejecute a continuación sp_help_agent_parameters utilizando ese profile_id para ver los parámetros asociados al perfil. Los parámetros pueden agregarse a un perfil mediante la ejecución de sp_add_agent_parameter.
[ @parameter_value=] 'parameter_value'
Es el nuevo valor del parámetro. parameter_value es de tipo nvarchar(255) y no tiene ningún valor predeterminado.