sp_add_agent_profile (Transact-SQL)

  • Articolo

Si applica a:SQL Server Istanza gestita di SQL di Azure

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

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

Argomenti

[ @profile_id = ] profile_id

ID associato al profilo appena inserito. @profile_id è 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 è sysname, senza impostazione predefinita.

[ @agent_type = ] agent_type

Tipo di agente di replica. @agent_type è int, senza impostazione predefinita e può essere uno di questi valori.

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 è int, con il valore predefinito 1.

0 indica un profilo di sistema. 1 indica un profilo personalizzato. È possibile creare solo profili personalizzati usando questa stored procedure; pertanto l'unico valore valido è 1. Solo SQL Server crea profili di sistema.

[ @description = ] N'description'

Descrizione del profilo. @description è nvarchar(3000), senza impostazione predefinita.

[ @default = ] impostazione predefinita

Indica se il profilo è l'impostazione predefinita per @agent_type. @default è bit, con il valore predefinito 0. 1 indica che il profilo aggiunto diventerà il nuovo profilo predefinito per l'agente specificato da @agent_type.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_add_agent_profile viene usato nella replica snapshot, nella replica transazionale e nella replica di tipo merge.

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

Quando sp_add_agent_profile viene eseguita, viene aggiunta una riga per il nuovo profilo personalizzato nella tabella MSagent_profiles (Transact-SQL) e 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.

Vedi anche