sys.sp_add_agent_profile (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Skapar en ny profil för en replikationsagent. Den här lagrade proceduren körs på distributören på valfri databas.

Transact-SQL syntaxkonventioner

Syntax

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

Arguments

[ @profile_id = ] profile_id UTGÅNG

ID:t kopplat till den nyinsatta profilen. @profile_id är int och är en valfri OUTPUT parameter. Om angiven sätts värdet till det nya profil-ID:t.

[ @profile_name = ] N'profile_name'

Namnet på profilen. @profile_name är sysname, utan standard.

[ @agent_type = ] agent_type

Typen av replikationsagent. @agent_type är int, utan standard, och kan vara ett av dessa värden.

Value Description
1 Ögonblicksagent
2 Agent för loggläsning
3 Distributionsagent
4 Sammanfogningsagent
9 Agent för köhantering

[ @profile_type = ] profile_type

Typen av profil. @profile_type är int, med standardvärdet .1

0 indikerar en systemprofil. 1 indikerar en anpassad profil. Endast anpassade profiler kan skapas med denna lagrade procedur; därför är 1det enda giltiga värdet . Endast SQL Server skapar systemprofiler.

[ @description = ] Ingen beskrivning'

En beskrivning av profilen. @description är nvarchar(3000), utan standard.

[ @default = ] standard

Indikerar om profilen är standarden för @agent_type. @default är bit, med standardvärdet .0 1 indikerar att profilen som läggs till kommer att bli den nya standardprofilen för agenten som anges av @agent_type.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

sp_add_agent_profile används i replikering av ögonblicksbilder, transaktionsreplikering och sammanslagningsreplikering.

Anpassade agentprofiler läggs till med standardparametrarna för agenter. Använd sp_change_agent_parameter för att ändra dessa standardvärden eller sp_add_agent_parameter för att lägga till ytterligare parametrar.

När sp_add_agent_profile den körs läggs en rad till för den nya anpassade profilen i MSagent_profiles-tabellen och de tillhörande standardparametrarna för denna profil läggs till i MSagent_parameters-tabellen .

Permissions

Endast medlemmar i den fasta serverrollen sysadmin kan köra sp_add_agent_profile.

Relaterat innehåll

  • Last updated on