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.

Convenzioni 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:

  • Replication Snapshot Agent
  • Replication Log Reader Agent
  • Replication Distribution Agent
  • Replication Merge Agent
  • Replication Queue Reader Agent

• [ @parameter_value=] 'parameter_value'
  Valore da assegnare al parametro. parameter_value è di tipo nvarchar(255) e non prevede alcun valore predefinito.

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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Vedere anche

Riferimento

sp_add_agent_profile (Transact-SQL)
sp_change_agent_profile (Transact-SQL)
sp_change_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL)

Altre risorse

How to: Work with Replication Agent Profiles (Replication Transact-SQL Programming)
Profili degli agenti di replica

Guida in linea e informazioni

Assistenza su SQL Server 2005