sys.sp_add_agent_profile (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Maakt een nieuw profiel aan voor een replicatieagent. Deze opgeslagen procedure wordt uitgevoerd bij de Distributeur op elke database.

Transact-SQL syntaxis-conventies

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 OUTPUT

De ID die gekoppeld is aan het nieuw ingevoegde profiel. @profile_id is int en is een optionele OUTPUT parameter. Indien gespecificeerd, wordt de waarde ingesteld op de nieuwe profiel-ID.

[ @profile_name = ] N'profile_name'

De naam van het profiel. @profile_name is sysname, zonder standaard.

[ @agent_type = ] agent_type

Het type replicatiemiddel. @agent_type is int, zonder standaard, en kan een van deze waarden zijn.

Value Description
1 Agent voor Momentopname
2 Logboekleesagent
3 Distributie-agent
4 Samenvoegingsagent
9 Agent voor wachtrijlezer

[ @profile_type = ] profile_type

Het type profiel. @profile_type is int, met als standaard .1

0 geeft een systeemprofiel aan. 1 duidt op een aangepast profiel. Alleen aangepaste profielen kunnen worden aangemaakt met deze opgeslagen procedure; daarom is 1de enige geldige waarde . Alleen SQL Server maakt systeemprofielen aan.

[ @description = ] Geen beschrijving'

Een beschrijving van het profiel. @description is nvarchar(3000), zonder standaard.

[ @default = ] standaard

Geeft aan of het profiel de standaard is voor @agent_type. @default is bit, met als standaard .0 1 geeft aan dat het toegevoegde profiel het nieuwe standaardprofiel wordt voor de agent die door @agent_type is gespecificeerd.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_add_agent_profile wordt gebruikt in momentopnamereplicatie, transactionele replicatie en samenvoegingsreplicatie.

Aangepaste agentprofielen worden toegevoegd met de standaard agentparameterwaarden. Gebruik sp_change_agent_parameter om deze standaardwaarden te wijzigen of sp_add_agent_parameter om extra parameters toe te voegen.

Wanneer sp_add_agent_profile deze wordt uitgevoerd, wordt er een rij toegevoegd voor het nieuwe aangepaste profiel in de MSagent_profiles tabel en worden de bijbehorende standaardparameters voor dit profiel aan de MSagent_parameters tabel toegevoegd.

Permissions

Alleen leden van de vaste serverrol sysadmin kunnen worden uitgevoerd sp_add_agent_profile.

Verwante inhoud

  • Last updated on