sp_add_agent_profile (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

Erstellt für einen Replikations-Agent ein neues Profil. Diese gespeicherte Prozedur wird beim Distributor auf einer beliebigen Datenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_add_agent_profile [ [ @profile_id = ] profile_id OUTPUT ]
      , [ @profile_name = ] 'profile_name'
      , [ @agent_type = ] agent_type
    [ , [ @profile_type = ] profile_type ]
    [ , [ @description = ] N'description' ]
    [ , [ @default = ] default ]

Argumente

[ @profile_id = ] profile_id

Die ID, die dem neu eingefügten Profil zugeordnet ist. @profile_id ist int und ein optionaler OUTPUT-Parameter. Wenn profile_id angegeben wird, wird der Wert auf die ID des neuen Profils festgelegt.

[ @profile_name = ] 'profile_name'

Der Name des Profils. @profile_name ist "sysname" ohne Standard.

[ @agent_type = ] agent_type

Der Typ des Replikations-Agents. @agent_type ist int, ohne Standard und kann einer dieser Werte sein.

Wert Beschreibung
1 Momentaufnahme-Agent
2 Protokolllese-Agent
3 Verteilungs-Agent
4 Merge-Agent
9 Warteschlangenlese-Agent

[ @profile_type = ] profile_type

Der Typ des Profils. profile_type ist int mit einem Standardwert von 1.

0 gibt ein Systemprofil an. 1 gibt ein benutzerdefiniertes Profil an. Nur benutzerdefinierte Profile können mithilfe dieser gespeicherten Prozedur erstellt werden. daher ist 1der einzige gültige Wert . Nur SQL Server erstellt Systemprofile.

[ @description = ] N'description'

Eine Beschreibung des Profils. @description ist nvarchar(3000), ohne Standard.

[ @default = ] Standard

Gibt an, ob das Profil die Standardeinstellung für @agent_type ist. @default ist bit, mit einem Standardwert von 0. 1 gibt an, dass das hinzugefügte Profil zum neuen Standardprofil für den von @agent_type angegebenen Agent wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Hinweise

sp_add_agent_profilewird in Momentaufnahme Replikation, Transaktionsreplikation und Zusammenführungsreplikation verwendet.

Benutzerdefinierte Agentprofile werden mit den standardmäßigen Agentparameterwerten hinzugefügt. Verwenden Sie sp_change_agent_parameter (Transact-SQL), um diese Standardwerte oder sp_add_agent_parameter (Transact-SQL) zu ändern, um zusätzliche Parameter hinzuzufügen.

Wenn sp_add_agent_profile sie ausgeführt wird, wird eine Zeile für das neue benutzerdefinierte Profil in der Tabelle MSagent_profiles (Transact-SQL) hinzugefügt, und die zugehörigen Standardparameter für dieses Profil werden der Tabelle MSagent_parameters (Transact-SQL) hinzugefügt.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin können ausgeführt werden sp_add_agent_profile.

Zugehöriger Inhalt