Compartir a través de


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.

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.

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.