sp_add_agent_parameter (Transact-SQL)sp_add_agent_parameter (Transact-SQL)

Anwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceYesVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceAnwendungsbereich:Applies to: JaSQL ServerSQL Server (alle unterstützten Versionen) yesSQL ServerSQL Server (all supported versions) JaVerwaltete Azure SQL-InstanzAzure SQL Managed InstanceYesVerwaltete Azure SQL-InstanzAzure SQL Managed Instance

Fügt einem Agentprofil einen neuen Parameter und dessen Wert hinzu.Adds a new parameter and its value to an agent profile. Diese gespeicherte Prozedur wird auf dem Verteiler für jede Datenbank ausgeführt.This stored procedure is executed at the Distributor on any database.

Symbol für Themenlink Transact-SQL-SyntaxkonventionenTopic link icon Transact-SQL Syntax Conventions

SyntaxSyntax

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

ArgumenteArguments

[ @profile_id = ] profile_id Die ID des Profils aus der MSagent_profiles Tabelle in der msdb -Datenbank.[ @profile_id = ] profile_id Is the ID of the profile from the MSagent_profiles table in the msdb database. profile_id ist vom Datentyp intund hat keinen Standardwert.profile_id is int, with no default.

Um herauszufinden, welcher Agenttyp diese profile_id darstellt, suchen Sie die profile_id in der MSagent_profiles (Transact-SQL-) Tabelle, und notieren Sie sich den Wert des agent_type Felds.To find out what agent type this profile_id represents, find the profile_id in the MSagent_profiles (Transact-SQL) table, and note the agent_type field value. Mit den Parametern werden folgende Werte angegeben:The values are as follows:

WertValue BESCHREIBUNGDescription
11 Momentaufnahme-AgentSnapshot Agent
22 Protokolllese-AgentLog Reader Agent
33 Verteilungs-AgentDistribution Agent
44 Merge-AgentMerge Agent
99 Warteschlangenlese-AgentQueue Reader Agent

[ @parameter_name = ] 'parameter_name' Der Name des Parameters.[ @parameter_name = ] 'parameter_name' Is the name of the parameter. parameter_name ist vom Datentyp vom Datentyp sysnameund hat keinen Standardwert.parameter_name is sysname, with no default. Eine Liste der Parameter, die bereits in Systemprofilen definiert sind, finden Sie unter Replikations-Agentprofile.For a list of parameters already defined in system profiles, see Replication Agent Profiles. Eine vollständige Liste der gültigen Parameter für die einzelnen Agents finden Sie in den folgenden Themen:For a complete list of valid parameters for each agent, see the following topics:

[ @parameter_value = ] 'parameter_value' Der Wert, der dem-Parameter zugewiesen werden soll.[ @parameter_value = ] 'parameter_value' Is the value to be assigned to the parameter. parameter_value ist vom Datentyp nvarchar (255) und hat keinen Standardwert.parameter_value is nvarchar(255), with no default.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

BemerkungenRemarks

sp_add_agent_parameter wird bei der Momentaufnahme-, Transaktions-und Mergereplikation verwendet.sp_add_agent_parameter is used in snapshot replication, transactional replication, and merge replication.

BerechtigungenPermissions

Nur Mitglieder der festen Server Rolle sysadmin können sp_add_agent_parameterausführen.Only members of the sysadmin fixed server role can execute sp_add_agent_parameter.

Weitere InformationenSee Also

Arbeiten mit Replikations-Agent-Profilen Work with Replication Agent Profiles
Replikations-Agent-Profile Replication Agent Profiles
sp_add_agent_profile (Transact-SQL-) sp_add_agent_profile (Transact-SQL)
sp_change_agent_profile (Transact-SQL-) sp_change_agent_profile (Transact-SQL)
sp_change_agent_parameter (Transact-SQL-) sp_change_agent_parameter (Transact-SQL)
sp_drop_agent_parameter (Transact-SQL-) sp_drop_agent_parameter (Transact-SQL)
sp_help_agent_parameter (Transact-SQL-)sp_help_agent_parameter (Transact-SQL)