sp_change_agent_parameter (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure 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= ] 'parameter_name', [ @parameter_value= ] 'parameter_value'

Argumentos

[ @profile_id = ] profile_id, Es el identificador del perfil. profile_id es int, sin valor predeterminado.

[ @parameter_name = ] 'parameter_name' Es 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 columna profile_id en la tabla Msagent_profiles y anote el valor agent_type .

Nota:

Si se admite un parámetro para una agent_type determinada, pero no se ha 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

  • Salida

  • OutputVerboseLevel

  • PacketSize

  • QueryTimeout

  • StartQueueTimeout

  • UsePerArticleContentsView

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

  • HistoryVerboseLevel

  • LoginTimeout

  • MessageInterval

  • Salida

  • 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

  • Salida

  • 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

  • Salida

  • OutputMessageFile

  • OutputVerboseLevel

  • PacketSize

  • ParallelUploadDownload

  • PauseOnMessagePattern

  • PauseTime

  • PollingInterval

  • ProcessMessagesAtPublisher

  • ProcessMessagesAtSubscriber

  • QueryTimeout

  • QueueSizeMultiplier

  • SrcThreads

  • StartQueueTimeout

  • SyncToAlternate

  • UploadGenerationsPerBatch

  • UploadReadChangesPerBatch

  • UploadWriteChangesPerBatch

  • UseInprocLoader

  • Validación

  • 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

  • Salida

  • OutputVerboseLevel

  • PollingInterval

  • QueryTimeout

  • ResolverState

  • SQLQueueMode

Para ver qué parámetros se han definido para un perfil determinado, ejecute sp_help_agent_profile y anote el profile_name asociado al profile_id. Con el profile_id adecuado, ejecute sp_help_agent_parameters mediante ese 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 = ] 'parameter_value' Es el nuevo valor del parámetro . parameter_value es nvarchar(255), sin ningún valor predeterminado.

Valores de código de retorno

0 (correcto) o 1 (error)

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.

Consulte también

Perfiles del Agente de replicación
Replication Distribution Agent
Agente de registro del LOG de replicación
Replication Merge Agent
Agente de lectura de cola de replicación
Replication Snapshot Agent
sp_add_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)