sp_change_agent_parameter (Transact-SQL)
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.
.gif "Icono de vínculo a temas")
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
Output
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
Output
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
Output
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
Output
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
Output
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.
Valores de código de retorno
0 (correcto) o 1 (error)
Notas
sp_change_agent_parameter se utiliza en todos los tipos de replicación.
Permisos
Sólo los miembros de la función fija de servidor sysadmin pueden ejecutar sp_change_agent_parameter.
Vea también