sp_add_agent_parameter (Transact-SQL)
Gilt für: 
SQL Server Azure SQL Managed Instance
Fügt einem Agentprofil einen neuen Parameter und dessen Wert hinzu. Diese gespeicherte Prozedur wird beim Distributor auf einer beliebigen Datenbank ausgeführt.
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 Tabelle in der MSagent_profiles msdb Datenbank. @profile_id ist "int" ohne Standard.
Um herauszufinden, welchen Agenttyp dieser @profile_id darstellt, suchen Sie die @profile_id in der MSagent_profiles Tabelle, und notieren Sie sich den agent_type Feldwert. Mit den Parametern werden folgende Werte angegeben:
| Wert | Beschreibung |
|---|---|
1 |
Momentaufnahme-Agent |
2 |
Protokolllese-Agent |
3 |
Verteilungs-Agent |
4 |
Merge-Agent |
9 |
Warteschlangenlese-Agent |
[ @parameter_name = ] 'parameter_name'
Der Name des Parameters. @parameter_name ist "sysname" ohne Standard. Eine Liste der Parameter, die bereits in Systemprofilen definiert sind, 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:
- Replication Snapshot Agent
- Replikationsprotokolllese-Agent
- Replication Distribution Agent
- Replication Merge Agent
- Replication Queue Reader Agent
[ @parameter_value = ] 'parameter_value'
Der Wert, der dem Parameter zugewiesen werden soll. @parameter_value ist nvarchar(255), ohne Standard.
Rückgabecodewerte
0 (erfolgreich) oder 1 Fehler.
Hinweise
sp_add_agent_parameter wird in der Momentaufnahmereplikation, Transaktionsreplikation und Zusammenführungsreplikation verwendet.
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin können ausgeführt werden sp_add_agent_parameter.