sp_add_agent_profile (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server Azure 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 (erfolgreich) oder 1 Fehler.

Hinweise

sp_add_agent_profile wird in der Momentaufnahmereplikation, Transaktionsreplikation und Zusammenführungsreplikation verwendet.

Benutzerdefinierte Agentprofile werden mit den standardmäßigen Agentparameterwerten hinzugefügt. Verwenden Sie sp_change_agent_parameter , um diese Standardwerte zu ändern oder sp_add_agent_parameter , 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 MSagent_profiles Tabelle hinzugefügt, und die zugehörigen Standardparameter für dieses Profil werden der MSagent_parameters Tabelle hinzugefügt.

Berechtigungen

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

Freigeben über