• Artikel

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