Condividi tramite


sp_add_agent_parameter (Transact-SQL)

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

Aggiunge un nuovo parametro e il relativo valore a un profilo agente. Questa stored procedure viene eseguita in qualsiasi database del server di distribuzione.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_add_agent_parameter [ @profile_id = ] profile_id
        , [ @parameter_name = ] 'parameter_name'
        , [ @parameter_value = ] 'parameter_value'
[ ; ]

Argomenti

[ @profile_id = ] profile_id

ID del profilo della MSagent_profiles tabella nel msdb database. @profile_id è int, senza impostazione predefinita.

Per individuare il tipo di agente rappresentato da questo @profile_id , trovare il @profile_id nella tabella MSagent_profiles e prendere nota del valore del agent_type campo. Sono disponibili i valori seguenti:

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

[ @parameter_name = ] 'parameter_name'

Nome del parametro. @parameter_name è sysname, senza impostazione predefinita. Per un elenco dei parametri già definiti nei profili di sistema, vedere Profili agente di replica. Per un elenco completo dei parametri validi per ogni agente, vedere gli argomenti seguenti:

[ @parameter_value = ] 'parameter_value'

Valore da assegnare al parametro . @parameter_value è nvarchar(255), senza impostazione predefinita.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

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

Autorizzazioni

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