sp_add_agent_profile (Transact-SQL)

Artículo
05/08/2013

Crea un nuevo perfil para un agente de replicación. Este procedimiento almacenado se ejecuta en el distribuidor de cualquier base de datos.

Icono de vínculo a temas Convenciones de sintaxis de 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 identificador asociado al perfil que se acaba de insertar. profile_id es de tipo int y es un parámetro OUTPUT opcional. 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 replicación. 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 solamente se pueden crear perfiles personalizados, por lo que el único valor válido es 1. Solamente Microsoft SQL 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.

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

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_add_agent_profile se utiliza en la replicación 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).