sp_change_agent_parameter (Transact-SQL)

Cambia un parámetro de un perfil de agente de réplica 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


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

[ @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.

ms190313.note(es-es,SQL.90).gifNota:
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.

sp_change_agent_parameter se utiliza en todos los tipos de réplica.

Sólo los miembros de la función fija de servidor sysadmin pueden ejecutar sp_change_agent_parameter.

0 (correcto) o 1 (error)

Adiciones de comunidad

AGREGAR
Mostrar: