sys.sp_changemergearticle (Transact-SQL)

Gäller för:SQL Server

Ändrar egenskaperna hos en sammanslagningsartikel. Den här lagrade proceduren körs i Publisher i publikationsdatabasen.

Transact-SQL syntaxkonventioner

Syntax

sys.sp_changemergearticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ ; ]

Arguments

[ @publication = ] N'publicering'

Namnet på publikationen där artikeln finns. @publication är sysname, utan standard.

[ @article = ] Inte en artikel'

Namnet på artikeln ska ändras. @article är sysname, utan standard.

[ @property = ] N'property'

Egenskapen att ändra sig för den aktuella artikeln och publikationen. @property är sysname och kan vara ett av värdena som listas i följande tabell.

[ @value = ] N'value'

Det nya värdet för den angivna egenskapen. @value är nvarchar(2000) och kan vara ett av värdena som listas i följande tabell.

Denna tabell beskriver artiklarna egenskaperna och värdena för dessa egenskaper.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Erkänner att åtgärden som utförs av denna lagrade procedur kan ogiltigförklara en befintlig snapshot. @force_invalidate_snapshot är bit, med standardvärdet 0.

• 0 specificerar att ändringar i sammanslagningsartikeln inte gör att snapshoten blir ogiltig. Om den lagrade proceduren upptäcker att ändringen kräver en ny snapshot, uppstår ett fel och inga ändringar görs.

• 1 innebär att ändringar i sammanslagningsartikeln kan göra att snapshoten blir ogiltig, och om det finns befintliga prenumerationer som kräver en ny snapshot, ger det tillstånd att markera den befintliga snapshoten som föråldrad och generera en ny snapshot.

Se avsnittet Kommentarer för de egenskaper som, när de ändras, kräver generering av en ny ögonblicksbild.

[ @force_reinit_subscription = ] force_reinit_subscription

Erkänner att åtgärden som utförs av denna lagrade procedur kan kräva att befintliga prenumerationer initialiseras om. @force_reinit_subscription är lite, med standardvärdet 0.

• 0 specificerar att ändringar i sammanslagningsartikeln inte gör att prenumerationen återinitieras. Om den lagrade proceduren upptäcker att ändringen skulle kräva att befintliga prenumerationer initieras om, uppstår ett fel och inga ändringar görs.

• 1 innebär att ändringar i sammanslagningsartikeln gör att befintliga prenumerationer ominitieras, och ger behörighet för prenumerationsominitiering.

Se avsnittet Kommentarer för de egenskaper som, när de ändras, kräver att alla befintliga prenumerationer initieras om.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

sp_changemergearticle används vid sammanslagningsreplikation.

Eftersom sp_changemergearticle används för att ändra artikelegenskaper som ursprungligen specificerades med sp_addmergearticle, se sp_addmergearticle för mer information om dessa egenskaper.

Att ändra följande egenskaper kräver att en ny snapshot genereras, och du måste ange ett värde på 1 för @force_invalidate_snapshot-parametern:

• check_permissions
• column_tracking
• destination_owner
• pre_creation_command
• schema_options
• subset_filterclause

Att ändra följande egenskaper kräver att befintliga prenumerationer initieras om, och du måste ange ett värde på 1 för @force_reinit_subscription-parametern :

• check_permissions
• column_tracking
• destination_owner
• pre_creation_command
• identityrangemanagementoption
• subscriber_upload_options
• subset_filterclause
• creation_script
• schema_option
• logical_record_level_conflict_detection
• logical_record_level_conflict_resolution

När du anger ett värde för 3 , partition_optionsrensas metadata när Merge Agent körs och den partitionerade snapshoten går ut snabbare. När du använder detta alternativ bör du överväga att aktivera en av abonnenten begärd partitionerad snapshot. För mer information, se Skapa en ögonblicksbild för en sammanslagningspublikation med parameteriserade filter.

När egenskapen column_tracking sätts, om tabellen redan är publicerad i andra sammanslagningspublikationer, måste kolumnspårningen vara samma som värdet som används av befintliga artiklar baserade på denna tabell. Denna parameter är endast för tabellartiklar.

Om flera publikationer publicerar artiklar baserade på samma underliggande tabell, leder en ändring delete_tracking av egenskapen eller egenskapen compensate_for_errors för en artikel till att samma ändring görs i de andra artiklarna som är baserade på samma tabell.

Om Publisher-inloggningen/användarkontot som används av sammanslagningsprocessen inte har rätt tabellbehörigheter, loggas de ogiltiga ändringarna som konflikter.

När du ändrar värdet på schema_option, utför systemet ingen bitvis uppdatering. Detta innebär att när du sätter schema_option att använda sp_changemergearticle, kan befintliga bitinställningar stängas av. För att behålla de befintliga inställningarna bör du utföra & (Bitvis OCH) mellan värdet du sätter och det aktuella värdet av schema_option, vilket kan bestämmas genom att köra sp_helpmergearticle.

Giltig schemaoptionstabell

Följande tabell beskriver de tillåtna schema_option värdena, beroende på artikeltyp.

Examples

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @article = N'SalesOrderHeader';

-- Enable column-level conflict tracking.
-- Changing this property requires that existing subscriptions
-- be reinitialized and that a new snapshot be generated.
USE [AdventureWorks2022]
EXEC sp_changemergearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'column_tracking', 
  @value = N'true',
  @force_invalidate_snapshot = 1,
  @force_reinit_subscription = 1;
GO

Permissions

Endast medlemmar av sysadmin-fasta serverrollen eller db_owner fasta databasrollen kan köra sp_changemergearticle.

Relaterat innehåll

• Visa och ändra artikelegenskaper
• Ändra publikation och artikelegenskaper
• sp_addmergearticle (Transact-SQL)
• sp_dropmergearticle (Transact-SQL)
• sp_helpmergearticle (Transact-SQL)
• Lagrade procedurer för replikering (Transact-SQL)