sp_add_agent_profile (Transact-SQL)

Crea un nuovo profilo per un agente di replica. Questa stored procedure viene eseguita in qualsiasi database del server di distribuzione.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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 ]

Argomenti

  • [ @profile_id= ] profile_id
    ID associato al nuovo profilo inserito. profile_id è di tipo int ed è un parametro OUTPUT facoltativo. Se viene specificato, il valore è impostato sull'ID del nuovo profilo.

  • [ @profile_name= ] 'profile_name'
    Nome del profilo. profile_name è di tipo sysname e non prevede alcun valore predefinito.

  • [ @agent_type= ] 'agent_type'
    Tipo di agente di replica. agent_type è di tipo int e non prevede alcun valore predefinito. I possibili valori sono i seguenti.

    Valore

    Descrizione

    1

    Agente snapshot

    2

    Agente di lettura log

    3

    Agente di distribuzione

    4

    Agente di merge

    9

    Agente di lettura coda

  • [ @profile_type= ] profile_type
    Tipo di profilo. profile_type è di tipo int e il valore predefinito è 1.

    0 indica un profilo di sistema. 1 indica un profilo personalizzato. Tramite questa stored procedure è possibile creare solo profili personalizzati. Pertanto l'unico valore valido è 1. I profili di sistema vengono creati solo da MicrosoftSQL Server.

  • [ @description= ] 'description'
    Descrizione del profilo. description è di tipo nvarchar(3000) e non prevede alcun valore predefinito.

  • [ @default= ] default
    Indica se il profilo corrisponde a quello predefinito per agent_type*.* default è di tipo bit e il valore predefinito è 0. 1 indica che il profilo da aggiungere verrà impostato come nuovo profilo predefinito per l'agente specificato da agent_type.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_add_agent_profile viene utilizzata per la replica snapshot, transazionale e di tipo merge.

I profili agenti personalizzati vengono aggiunti con valori predefiniti dei parametri degli agenti. Utilizzare sp_change_agent_parameter (Transact-SQL) per modificare questi valori predefiniti oppure sp_add_agent_parameter (Transact-SQL) per aggiungere altri parametri.

Se viene eseguita la stored procedure sp_add_agent_profile, nella tabella MSagent_profiles (Transact-SQL) viene aggiunta una riga per il nuovo profilo personalizzato, mentre i parametri predefiniti associati per questo profilo vengono aggiunti alla tabella MSagent_parameters (Transact-SQL).

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_add_agent_profile.