sp_add_agent_profile (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL Managed Instance

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

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 = ] N'description' ]
    [ , [ @default = ] default ]

Argumentos

[ @profile_id = ] profile_id

Identificador asociado al perfil recién insertado. @profile_id es 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'

Nombre del perfil. @profile_name es sysname, sin valor predeterminado.

[ @agent_type = ] agent_type

Tipo de agente de replicación. @agent_type es int, sin valor predeterminado, y puede ser uno de estos valores.

Value 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

Tipo de perfil. profile_type es int, con un valor predeterminado de 1.

0 indica un perfil del sistema. 1 indica un perfil personalizado. Solo se pueden crear perfiles personalizados mediante este procedimiento almacenado; por lo tanto, el único valor válido es 1. Solo SQL Server crea perfiles del sistema.

[ @description = ] N'description'

Descripción del perfil. @description es nvarchar(3000), sin ningún valor predeterminado.

[ @default = ] valor predeterminado

Indica si el perfil es el valor predeterminado de @agent_type. @default es bit, con un valor predeterminado de 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 (erróneo).

Comentarios

sp_add_agent_profile se usa en la replicación de instantáneas, la replicación transaccional y la replicación de mezcla.

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

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

Permisos

Solo los miembros del rol fijo de servidor sysadmin pueden ejecutar sp_add_agent_profile.

Contenido relacionado