sp_add_agent_parameter (Transact-SQL)

Agrega un nuevo parámetro y su valor al perfil de un agente. Este procedimiento almacenado se ejecuta en el distribuidor de cualquier base de datos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

• [ @profile_id= ] profile_id
  Es el Id. del perfil de la tabla MSagent_profiles de la base de datos msdb. profile_id es de tipo int y no tiene ningún valor predeterminado.

  Para saber qué tipo de agente representa este profile_id, busque el profile_id en la tabla MSagent_profiles (Transact-SQL) y compruebe el valor del campo agent_type. Los valores son los siguientes:

  Valor	Descripción
  1	Agente de instantáneas
  2	Agente de registro del LOG
  3	Agente de distribución
  4	Agente de mezcla
  9	Agente de lectura de cola

• [ @parameter_name= ] 'parameter_name'
  Es el nombre del parámetro. parameter_name es de tipo sysname y no tiene ningún valor predeterminado. Para obtener una lista de parámetros definidos en los perfiles del sistema, vea Perfiles del Agente de réplica. Para obtener una lista completa de parámetros válidos para cada agente, vea los siguientes temas:

  • Replication Snapshot Agent
  • Replication Log Reader Agent
  • Replication Distribution Agent
  • Replication Merge Agent
  • Replication Queue Reader Agent

• [ @parameter_value=] 'parameter_value'
  Es el valor que se va a asignar al parámetro. parameter_value es de tipo nvarchar(255) y no tiene ningún valor predeterminado.

Notas

sp_add_agent_parameter se utiliza en la réplica de instantáneas, transaccional y de mezcla.

Permisos

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

Valores de código de retorno

0 (correcto) o 1 (error)

Vea también

Referencia

sp_add_agent_profile (Transact-SQL)
sp_change_agent_profile (Transact-SQL)
sp_change_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)

Otros recursos

How to: Work with Replication Agent Profiles (Replication Transact-SQL Programming)
Perfiles del Agente de réplica

Ayuda e información

Obtener ayuda sobre SQL Server 2005