Share via


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.

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-Felds. 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 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 Momentaufnahme-, Transaktions- und Mergereplikation verwendet.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin können sp_add_agent_parameter ausführen.

Siehe auch

Verweis

Replikations-Agent-Profile

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)

Konzepte

Arbeiten mit Replikations-Agent-Profilen