sp_add_agent_parameter (Transact-SQL)

Artikel
2025-01-02

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:

[ @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.

Freigeben über