sp_add_agent_profile (Transact-SQL)
Crea un nuevo perfil para un agente de réplica. Este procedimiento almacenado se ejecuta en el distribuidor de cualquier base de datos.
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