sp_change_agent_parameter (Transact-SQL)

  • Artículo

Se aplica a: SQL Server Azure SQL Managed Instance

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

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @profile_id = ] profile_id

Identificador del perfil. @profile_id es int, sin valor predeterminado.

[ @parameter_name = ] N'parameter_name'

El nombre del parámetro. @parameter_name es sysname, sin ningún valor predeterminado. Para los perfiles del sistema, los parámetros que se pueden cambiar dependen del tipo de agente. Para averiguar qué tipo de agente representa este @profile_id , busque la profile_id columna en la Msagent_profiles tabla y anote el agent_type valor.

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

Para un Agente de instantáneas (agent_type = 1), si se define en el perfil, se pueden cambiar las siguientes propiedades:

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

Para un Agenteagent_type = 2 de registro del Log (), si se define en el perfil, se pueden cambiar las siguientes propiedades:

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

Para un Agente de distribución (agent_type = 3), si se define en el perfil, se pueden cambiar 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 se define en el perfil, se pueden cambiar 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
  • Validate
  • ValidateInterval

Para un Agente de lectura de cola (agent_type = 9), si se define en el perfil, se pueden cambiar las siguientes propiedades:

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

Para ver qué parámetros se definen para un perfil determinado, ejecute sp_help_agent_profile y anote el profile_name asociado a .profile_id Con el adecuado profile_id, ejecute a continuación sp_help_agent_parameters con eso profile_id para ver los parámetros asociados al perfil. Los parámetros se pueden agregar a un perfil ejecutando sp_add_agent_parameter.

[ @parameter_value = ] N'parameter_value'

Valor nuevo del parámetro. @parameter_value es nvarchar(255), sin ningún valor predeterminado.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

sp_change_agent_parameter se usa en todos los tipos de replicación.

Permisos

Solo los miembros del rol fijo de servidor sysadmin pueden ejecutar sp_change_agent_parameter.

Contenido relacionado