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.
.gif "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.
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.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Vedere anche
Riferimento
sp_add_agent_parameter (Transact-SQL)
sp_change_agent_parameter (Transact-SQL)
sp_change_agent_profile (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_drop_agent_profile (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)
sp_help_agent_profile (Transact-SQL)
Altre risorse
How to: Work with Replication Agent Profiles (Replication Transact-SQL Programming)
Profili degli agenti di replica