sp_add_agent_profile (Transact-SQL)

Sintaxis

sp_add_agent_profile [ [ @profile_id= ] profile_id OUTPUT ]
        , [ @profile_name= ] 'profile_name' 
        , [ @agent_type= ] 'agent_type' ] 
    [ , [ @profile_type= ] profile_type ]
    [ , [ @description= ] 'description' ]
    [ , [ @default= ] default ]

Argumentos

• [ @profile_id= ] profile_id
  Es el Id. asociado al perfil que se acaba de insertar. profile_id es de tipo int y es un parámetro opcional de OUTPUT. Si se especifica, el valor se establece en el nuevo Id. de perfil.

• [ @profile_name= ] 'profile_name'
  Es el nombre del perfil. profile_name es de tipo sysname y no tiene ningún valor predeterminado.

• [ @agent_type= ] 'agent_type'
  Es el tipo de Agente de réplica. agent_type es de tipo int, no tiene ningún valor predeterminado y puede tener uno de estos valores.

  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

• [ @profile_type= ] profile_type
  Es el tipo de perfil.profile_type es de tipo int y su valor predeterminado es 1.

  0 indica un perfil del sistema. 1 indica un perfil personalizado. Con este procedimiento almacenado sólo se pueden crear perfiles personalizados, por lo que el único valor válido es 1. Solamente MicrosoftSQL Server crea perfiles del sistema.

• [ @description= ] 'description'
  Es una descripción del perfil. description es de tipo nvarchar(3000) y no tiene ningún valor predeterminado.

• [ @default= ] default
  Indica si el perfil es el valor predeterminado de agent_type*.* default es de tipo bit y su valor predeterminado es 0. 1 indica que el perfil que se va a agregar se convertirá en el nuevo perfil predeterminado para el agente especificado por agent_type.

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

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

Los perfiles de agente personalizados se agregan con los valores predeterminados de los parámetros de agente. Utilice sp_change_agent_parameter (Transact-SQL) para cambiar los valores predeterminados o sp_add_agent_parameter (Transact-SQL) para agregar parámetros adicionales.

Cuando se ejecuta sp_add_agent_profile, se agrega una fila para el nuevo perfil personalizado a la tabla MSagent_profiles (Transact-SQL) y los parámetros predeterminados asociados de este perfil se agregan a la tabla MSagent_parameters (Transact-SQL).

Permisos

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

Vea también

Tasks

Referencia