sys.sp_replicationdboption (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Stelt een replicatiedatabase-optie in voor de opgegeven database. Deze opgeslagen procedure wordt uitgevoerd bij de Publisher of Subscriber in elke database.

Transact-SQL syntaxis-conventies

Syntax

sys.sp_replicationdboption
    [ @dbname = ] N'dbname'
    , [ @optname = ] N'optname'
    , [ @value = ] { N'true' | N'false' }
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @from_scripting = ] from_scripting ]
[ ; ]

Arguments

[ @dbname = ] N'dbname'

De database waarvoor de replicatiedatabaseoptie wordt ingesteld. @dbname is een systeemnaam, zonder standaard.

[ @optname = ] Naamloos

De replicatiedatabase-optie om in of uit te schakelen. @optname is sysname, en kan een van deze waarden zijn.

Value Description
merge publish Database kan worden gebruikt voor samengevoegde publicaties.
publish Database kan worden gebruikt voor andere soorten publicaties.
subscribe Database is een abonnementsdatabase.
sync with backup De database is ingeschakeld voor gecoördineerde back-up. Voor meer informatie, zie Gecoördineerde back-ups inschakelen voor transactionele replicatie.

[ @value = ] { Niet waar' | N'false' }

Of je de gegeven replicatiedatabaseoptie in- of uitschakelt. @value is sysname, zonder standaard. Wanneer deze waarde is false en @optname , merge publishworden ook abonnementen op de merged gepubliceerde database verwijderd.

[ @ignore_distributor = ] ignore_distributor

Geeft aan of deze opgeslagen procedure wordt uitgevoerd zonder verbinding te maken met de Distributor. @ignore_distributor is bit, met als standaard .0

  • Als 0, moet de distributeur worden gekoppeld aan en bijgewerkt worden met de nieuwe status van de publicatiedatabase.

  • 1 moet alleen worden gespecificeerd als de distributeur ontoegankelijk is en sp_replicationdboption wordt gebruikt om publicatie uit te schakelen.

[ @from_scripting = ] from_scripting

Alleen ter informatie geïdentificeerd. Wordt niet ondersteund. Toekomstige compatibiliteit is niet gegarandeerd.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_replicationdboption wordt gebruikt in momentopnamereplicatie, transactionele replicatie en samenvoegingsreplicatie.

Deze procedure maakt specifieke replicatiesysteemtabellen, beveiligingsaccounts, enzovoort aan of verwijdert die, afhankelijk van de aangeboden opties. Stelt de overeenkomstige is_published (transactionele of snapshotreplicatie), is_merge_published (merge-replicatie) of is_distributor bits in de systeemtabel in en master.databases creëert de benodigde systeemtabellen.

Om publicatie uit te schakelen, moet de publicatiedatabase online zijn. Als er een databasesnapshot bestaat voor de publicatiedatabase, moet deze worden verwijderd voordat publicatie wordt uitgeschakeld. Een databasesnapshot is een alleen-lezen offline kopie van een database en heeft geen relatie tot een replicatiesnapshot. Voor meer informatie, zie Database snapshots (SQL Server).

Permissions

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