sp_add_agent_parameter (Transact-SQL)
Fügt einem Agentprofil einen neuen Parameter und dessen Wert hinzu. Diese gespeicherte Prozedur wird auf dem Verteiler für jede Datenbank ausgeführt.
.gif "Themenlink (Symbol)")
Transact-SQL-Syntaxkonventionen
Syntax
sp_add_agent_parameter [ @profile_id = ] profile_id
, [ @parameter_name = ] 'parameter_name'
, [ @parameter_value = ] 'parameter_value'
Argumente
[ @profile_id= ] profile_id
Die ID des Profils aus der MSagent_profiles-Tabelle in der msdb-Datenbank. profile_id ist vom Datentyp int und hat keinen Standardwert.Wenn Sie herausfinden möchten, welchen Agenttyp ein bestimmter Wert von profile_id darstellt, suchen Sie profile_id in der MSagent_profiles (Transact-SQL)-Tabelle, und beachten Sie den Wert des agent_type-Feldes. Die folgenden Werte sind möglich:
Wert Beschreibung 1
Snapshot-Agent
2
Protokolllese-Agent
3
Verteilungs-Agent
4
Merge-Agent
9
Warteschlangenlese-Agent
[ @parameter_name= ] 'parameter_name'
Der Name des Parameters. parameter_name ist vom Datentyp sysname und hat keinen Standardwert. Eine Liste der bereits in Systemprofilen definierten Parameter finden Sie unter Replikations-Agent-Profile. Eine vollständige Liste der gültigen Parameter für die einzelnen Agents finden Sie in den folgenden Themen:
- [ @parameter_value=] 'parameter_value'
Der Wert, der dem Parameter zugewiesen werden soll. parameter_value ist vom Datentyp nvarchar(255) und hat keinen Standardwert.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Hinweise
sp_add_agent_parameter wird bei der Snapshot-, Transaktions- und Mergereplikation verwendet.
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin können sp_add_agent_parameter ausführen.
Siehe auch
Verweis
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)
Andere Ressourcen
How to: Work with Replication Agent Profiles (Replication Transact-SQL Programming)
Replikations-Agent-Profile