sp_add_agent_profile (Transact-SQL)

Articolo
05/07/2013

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 argomento Convenzioni 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 Microsoft SQL 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.

Valore	Descrizione
1	Agente snapshot
2	agente di lettura log
3	Agente di distribuzione
4	Agente di merge
9	agente di lettura coda

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).