sp_add_agent_parameter (Transact-SQL)

Aggiunge un nuovo parametro e il relativo valore a un profilo agente. 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_parameter [ @profile_id = ] profile_id
        , [ @parameter_name = ] 'parameter_name' 
        , [ @parameter_value = ] 'parameter_value' 

Argomenti

  • [ @profile_id= ] profile_id
    ID del profilo dalla tabella MSagent_profiles nel database msdb. profile_id è di tipo int e non prevede alcun valore predefinito.

    Per individuare il tipo di agente rappresentato da profile_id, individuare tale profile_id nella tabella MSagent_profiles (Transact-SQL) e prendere nota del valore del campo agent_type. 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 è di tipo sysname e non prevede alcun valore predefinito. Per un elenco dei parametri già definiti nei profili di sistema, vedere Profili degli agenti 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 è di tipo nvarchar(255) e non prevede alcun valore predefinito.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

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

Autorizzazioni

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