Compartir a través de

  • Artículo

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.

Icono de vínculo a temasConvenciones 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 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 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.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

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.