sp_change_agent_parameter (Transact-SQL)

  • Artículo

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 temasConvenciones 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
    • 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.

Notas

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

Permisos

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

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Referencia

sp_add_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)

Otros recursos

Perfiles del Agente de réplica
Replication Distribution Agent
Replication Log Reader Agent
Replication Merge Agent
Replication Queue Reader Agent
Replication Snapshot Agent

Ayuda e información

Obtener ayuda sobre SQL Server 2005