sys.sp_addmergepublication (Transact-SQL)

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

Skapar en ny sammanslagningspublikation. Denna lagrade propus utförs hos Publisher i den databas som publiceras.

Transact-SQL syntaxkonventioner

Syntax

sys.sp_addmergepublication
    [ @publication = ] N'publication'
    [ , [ @description = ] N'description' ]
    [ , [ @retention = ] retention ]
    [ , [ @sync_mode = ] N'sync_mode' ]
    [ , [ @allow_push = ] N'allow_push' ]
    [ , [ @allow_pull = ] N'allow_pull' ]
    [ , [ @allow_anonymous = ] N'allow_anonymous' ]
    [ , [ @enabled_for_internet = ] N'enabled_for_internet' ]
    [ , [ @centralized_conflicts = ] N'centralized_conflicts' ]
    [ , [ @dynamic_filters = ] N'dynamic_filters' ]
    [ , [ @snapshot_in_defaultfolder = ] N'snapshot_in_defaultfolder' ]
    [ , [ @alt_snapshot_folder = ] N'alt_snapshot_folder' ]
    [ , [ @pre_snapshot_script = ] N'pre_snapshot_script' ]
    [ , [ @post_snapshot_script = ] N'post_snapshot_script' ]
    [ , [ @compress_snapshot = ] N'compress_snapshot' ]
    [ , [ @ftp_address = ] N'ftp_address' ]
    [ , [ @ftp_port = ] ftp_port ]
    [ , [ @ftp_subdirectory = ] N'ftp_subdirectory' ]
    [ , [ @ftp_login = ] N'ftp_login' ]
    [ , [ @ftp_password = ] N'ftp_password' ]
    [ , [ @conflict_retention = ] conflict_retention ]
    [ , [ @keep_partition_changes = ] N'keep_partition_changes' ]
    [ , [ @allow_subscription_copy = ] N'allow_subscription_copy' ]
    [ , [ @allow_synctoalternate = ] N'allow_synctoalternate' ]
    [ , [ @validate_subscriber_info = ] N'validate_subscriber_info' ]
    [ , [ @add_to_active_directory = ] N'add_to_active_directory' ]
    [ , [ @max_concurrent_merge = ] max_concurrent_merge ]
    [ , [ @max_concurrent_dynamic_snapshots = ] max_concurrent_dynamic_snapshots ]
    [ , [ @use_partition_groups = ] N'use_partition_groups' ]
    [ , [ @publication_compatibility_level = ] N'publication_compatibility_level' ]
    [ , [ @replicate_ddl = ] replicate_ddl ]
    [ , [ @allow_subscriber_initiated_snapshot = ] N'allow_subscriber_initiated_snapshot' ]
    [ , [ @allow_web_synchronization = ] N'allow_web_synchronization' ]
    [ , [ @web_synchronization_url = ] N'web_synchronization_url' ]
    [ , [ @allow_partition_realignment = ] N'allow_partition_realignment' ]
    [ , [ @retention_period_unit = ] N'retention_period_unit' ]
    [ , [ @generation_leveling_threshold = ] generation_leveling_threshold ]
    [ , [ @automatic_reinitialization_policy = ] automatic_reinitialization_policy ]
    [ , [ @conflict_logging = ] N'conflict_logging' ]
[ ; ]

Arguments

[ @publication = ] N'publicering'

Namnet på den sammanslagna publikationen att skapa. @publication är sysname, utan standard, och får inte vara nyckelordet ALL. Publikationens namn måste vara unikt inom databasen.

[ @description = ] Ingen beskrivning'

Publiceringsbeskrivningen. @description är nvarchar(255), med en standard på NULL.

[ @retention = ] retention

Lagringsperioden, i lagringstidsenheter, för vilka man sparar ändringar för den givna @publication. @retention är int, med standardvärdet .14 Enheter för lagringstid definieras av @retention_period_unit. Om prenumerationen inte synkroniseras inom lagringsperioden, och de väntande ändringar den skulle ha fått tas bort av en rensningsoperation hos distributören, går prenumerationen ut och måste initieras om. Den maximalt tillåtna lagringstiden är antalet dagar mellan den 31 december 9999 och det aktuella datumet.

[ @sync_mode = ] N'sync_mode'

Sättet för den initiala synkroniseringen av prenumeranter till publikationen. @sync_mode är nvarchar(10) och kan vara ett av följande värden.

[ @allow_push = ] N'allow_push'

Specificerar om push-prenumerationer kan skapas för den aktuella publikationen. @allow_push är nvarchar(5), med standardvärdet , truevilket tillåter push-prenumerationer på publikationen.

[ @allow_pull = ] N'allow_pull'

Specificerar om pull-prenumerationer kan skapas för den aktuella publikationen. @allow_pull är nvarchar(5), med standardvärdet , truevilket tillåter pull-prenumerationer på publikationen. Du måste specificera true för att stödja SQL Server Compact-abonnenter.

[ @allow_anonymous = ] N'allow_anonymous'

Specificerar om anonyma prenumerationer kan skapas för den aktuella publikationen. @allow_anonymous är nvarchar(5), med en standard på true, vilket tillåter anonyma prenumerationer på publikationen. För att stödja SQL Server Compact-prenumeranter måste du specificera true.

[ @enabled_for_internet = ] N'enabled_for_internet'

Specificerar om publiceringen är aktiverad för Internet och avgör om filöverföringsprotokoll (FTP) kan användas för att överföra snapshot-filerna till en prenumerant. @enabled_for_internet är nvarchar(5), med en standard på false. Om true, läggs synkroniseringsfilerna för publiceringen i katalogen C:\Program Files\Microsoft SQL Server\MSSQL\MSSQL.x\Repldata\Ftp . Användaren måste skapa Ftp-katalogen. Om false, är publikationen inte aktiverad för internetåtkomst.

[ @centralized_conflicts = ] N'centralized_conflicts'

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Använd @conflict_logging för att ange platsen där konfliktposter lagras.

[ @dynamic_filters = ] N'dynamic_filters'

Möjliggör att sammanslagningspubliceringen använder parametriserade radfilter. @dynamic_filters är nvarchar(5), med en standard på false.

[ @snapshot_in_defaultfolder = ] N'snapshot_in_defaultfolder'

Specificerar om snapshot-filerna lagras i standardmappen. @snapshot_in_defaultfolder är nvarchar(5), med en standard på true. Om truefinns ögonblicksbildfiler i standardmappen. Om false, lagras snapshot-filer på den alternativa plats som anges av @alternate_snapshot_folder. Alternativa platser kan vara på en annan server, på en nätverksenhet eller på ett flyttbart medium (såsom flyttbara diskar). Du kan också spara snapshot-filerna på en File Transfer Protocol (FTP)-sida, för att prenumeranten ska hämta dem vid ett senare tillfälle. Denna parameter kan vara sann och ändå ha en plats specificerad av @alt_snapshot_folder. Denna kombination anger att snapshot-filerna lagras både på standard- och alternativplatsen.

[ @alt_snapshot_folder = ] N'alt_snapshot_folder'

Anger platsen för den alternativa mappen för ögonblicksbilden. @alt_snapshot_folder är nvarchar(255), med en standard på NULL.

[ @pre_snapshot_script = ] N'pre_snapshot_script'

Specificerar en pekare till en .sql filplats. @pre_snapshot_script är nvarchar(255), med en standard på NULL. Merge Agent kör pre-snapshot-skriptet före något av de replikerade objektskripten när snapshoten appliceras på en prenumerant. Skriptet körs i säkerhetskontexten som används av Merge Agent när den ansluter till prenumerationsdatabasen. Pre-snapshot-skript körs inte på SQL Server Compact-abonnenter.

[ @post_snapshot_script = ] N'post_snapshot_script'

Specificerar en pekare till en .sql filplats. @post_snapshot_script är nvarchar(255), med en standard på NULL. Merge Agent kör post-snapshot-skriptet efter att alla andra replikerade objektskript och data har applicerats under en initial synkronisering. Skriptet körs i säkerhetskontexten som används av Merge Agent när den ansluter till prenumerationsdatabasen. Post-snapshot-skript körs inte på SQL Server Compact-abonnenter.

[ @compress_snapshot = ] N'compress_snapshot'

Specificerar att snapshoten som skrivs till @alt_snapshot_folder plats kommer att komprimeras till Microsoft CAB-formatet. @compress_snapshot är nvarchar(5), med en standard på false.

• false specificerar att snapshoten inte ska komprimeras.

• true specificerar att snapshoten kommer att komprimeras.

Snapshot-filer som är större än 2 GB kan inte komprimeras. Komprimerade snapshot-filer är okomprimerade på platsen där Merge Agent körs; pull-prenumerationer används vanligtvis med komprimerade snapshots så att filer okomprimeras hos prenumeranten. Snapshoten i standardmappen kan inte komprimeras. För att stödja SQL Server Compact-prenumeranter måste du specificera false.

[ @ftp_address = ] N'ftp_address'

Nätverksadressen för FTP-tjänsten för distributören. @ftp_address är sysname, med standardvärdet .NULL Specificerar var publiceringssnapshotfiler finns för att en prenumerants Merge Agent ska hämta dem. Eftersom denna egenskap lagras för varje publikation kan varje publikation ha olika @ftp_address. Publikationen måste stödja spridning av snapshots med FTP.

[ @ftp_port = ] ftp_port

Portnumret för FTP-tjänsten för distributören. @ftp_port är int, med standardvärdet .21 Specificerar var publiceringssnapshotfilerna finns för att en prenumerants Merge Agent ska hämta dem. Eftersom denna egenskap lagras för varje publikation kan varje publikation ha sin egen @ftp_port.

[ @ftp_subdirectory = ] N'ftp_subdirectory'

Specificerar var snapshot-filerna finns tillgängliga för prenumerantens Merge Agent att hämta om publikationen stödjer att sprida snapshots med FTP. @ftp_subdirectory är nvarchar(255), med en standard på ftp. Eftersom denna egenskap lagras för varje publikation kan varje publikation ha sin egen @ftp_subdirctory eller välja att inte ha någon underkatalog, markerad med ett NULL värde.

När man förgenererar snapshots för publikationer med parameteriserade filter måste datasnapshoten för varje Subscriber-partition finnas i en egen mapp. Katalogstrukturen för förgenererade snapshots med FTP måste följa följande struktur:

<alternate_snapshot_folder>\ftp\<publisher_publicationDB_publication>\<partitionID>.

[ @ftp_login = ] N'ftp_login'

Användarnamnet som används för att ansluta till FTP-tjänsten. @ftp_login är sysname, med standardvärdet .anonymous

[ @ftp_password = ] N'ftp_password'

Användarlösenordet som används för att ansluta till FTP-tjänsten. @ftp_password är sysname, med standardvärdet .NULL

[ @conflict_retention = ] conflict_retention

Anger lagringstiden, i dagar, för vilken konflikter behålls. @conflict_retention är int, med en standard på 14 dagar innan konfliktstriden rensas från konflikttabellen.

[ @keep_partition_changes = ] N'keep_partition_changes'

Specificerar om partitionsbytesoptimeringar ska aktiveras när förberäknade partitioner inte kan användas. @keep_partition_changes är nvarchar(5), med en standard på true.

• false innebär att partitionsändringar inte optimeras, och när förberäknade partitioner inte används verifieras partitionerna som skickas till alla prenumeranter när data ändras i en partition.

• true innebär att partitionsändringar optimeras, och endast prenumeranter som har rader i de ändrade partitionerna påverkas.

När man använder förberäknade partitioner, ställ @use_partition_groups till true och sätt @keep_partition_changes till false. För mer information, se Parameteriserade filter – Optimera för förberäknade partitioner.

Med SQL Server Compact-prenumeranter måste @keep_partition_changes ställas in på true för att säkerställa att raderingar sprids korrekt. När den sätts till false, kan abonnenten ha fler rader än väntat.

[ @allow_subscription_copy = ] N'allow_subscription_copy'

Möjliggör eller inaktiverar möjligheten att kopiera prenumerationsdatabaser som prenumererar på denna publikation. @allow_subscription_copy är nvarchar(5), med en standard på false. Storleken på den prenumerationsdatabas som kopieras måste vara mindre än 2 GB.

[ @allow_synctoalternate = ] N'allow_synctoalternate'

Identifieras endast i informationssyfte. Stöds ej. Framtida kompatibilitet garanteras inte.

[ @validate_subscriber_info = ] N'validate_subscriber_info'

Listar de funktioner som används för att definiera en prenumerantpartition av den publicerade datan när parametriserade radfilter används. @validate_subscriber_info är nvarchar(500), med standardvärdet .NULL Denna information används av Merge Agent för att validera abonnentens partition. Till exempel, om SUSER_SNAME används i det parameteriserade radfiltret, bör parametern vara @validate_subscriber_info=N'SUSER_SNAME().

[ @add_to_active_directory = ] N'add_to_active_directory'

Denna parameter är föråldrad och behålls för bakåtkompatibilitet mellan skript. Du kan inte längre lägga till publiceringsinformation i Microsoft služba Active Directory.

[ @max_concurrent_merge = ] max_concurrent_merge

Det maximala antalet samtidiga sammanslagningsprocesser. @max_concurrent_merge är int, med standardvärdet .0 Ett värde på 0 för betyder att det inte finns någon gräns för antalet samtidiga sammanslagningsprocesser som körs vid varje given tidpunkt.

Denna egenskap sätter en gräns för antalet samtidiga sammanslagningsprocesser som kan köras mot en sammanslagningspublikation samtidigt. Om det finns fler sammanslagningsprocesser schemalagda samtidigt än värdet som tillåts köras, placeras överskottsjobben i en kö och väntas tills en pågående sammanslagningsprocess är klar.

[ @max_concurrent_dynamic_snapshots = ] max_concurrent_dynamic_snapshots

Det maximala antalet Snapshot Agent-sessioner som kan köras samtidigt för att generera filtrerade datasnapshots för Subscriber-partitioner. @max_concurrent_dynamic_snapshots är int, med standardvärdet .0 Om 0, finns det ingen gräns för antalet snapshot-sessioner. Om det finns fler snapshot-processer schemalagda samtidigt än värdet som tillåts köra, placeras överskottsjobben i en kö och väntas tills en pågående snapshot-process är klar.

[ @use_partition_groups = ] N'use_partition_groups'

Specificerar att förberäknade partitioner ska användas för att optimera synkroniseringsprocessen. @use_partition_groups är nvarchar(5) och kan vara ett av dessa värden:

Förberäknade partitioner används som standard. För att undvika att använda förberäknade partitioner måste @use_partition_groups sättas till false. När NULL, avgör systemet om förberäknade partitioner kan användas. Om förberäknade partitioner inte kan användas, blir false detta värde i praktiken utan att generera några fel. I sådana fall kan @keep_partition_changes ställas in på true för att ge viss optimering. För mer information, se Parameterized Filters - Parameterized Row Filters och Parameterized Filters - Optimize for Precomputed Partitions.

[ @publication_compatibility_level = ] N'publication_compatibility_level'

Indikerar publikationens bakåtkompatibilitet. @publication_compatibility_level är nvarchar(6) och kan vara ett av dessa värden:

[ @replicate_ddl = ] replicate_ddl

Anger om schemareplikering stöds för publikationen. @replicate_ddl är int, med standardvärdet .NULL 1 anger att DDL-instruktioner (datadefinitionsspråk) som körs på utgivaren replikeras och 0 anger att DDL-instruktioner inte replikeras. Mer information finns i Göra schemaändringar i publikationsdatabaser.

Parametern @replicate_ddl respekteras när en DDL-sats lägger till en kolumn. Parametern @replicate_ddl ignoreras när en DDL-sats ändrar eller tar bort en kolumn av följande skäl.

• När en kolumn tas bort måste den sysarticlecolumns uppdateras för att förhindra att nya DML-satser inkluderar den borttagna kolumnen som skulle få distributionsagenten att fallera. Den @replicate_ddl parametern ignoreras eftersom replikering alltid måste replikera schemaändringen.

• När en kolumn ändras kan källdatatypen eller nullbarheten ha ändrats, vilket gör att DML-satser innehåller ett värde som kanske inte är kompatibelt med tabellen hos abonnenten. Sådana DML-uttalanden kan få distributionsagenten att fallera. Den @replicate_ddl parametern ignoreras eftersom replikering alltid måste replikera schemaändringen.

• När ett DDL-uttalande lägger till en ny kolumn, sysarticlecolumns inkluderar inte den nya kolumnen. DML-satser försöker inte replikera data för den nya kolumnen. Parametern respekteras eftersom det är acceptabelt att antingen replikera eller inte replikera DDL.

[ @allow_subscriber_initiated_snapshot = ] N'allow_subscriber_initiated_snapshot'

Indikerar om prenumeranter på denna publikation kan initiera snapshot-processen för att generera den filtrerade snapshoten för sin datapartition. @allow_subscriber_initiated_snapshot är nvarchar(5), med standardvärdet .false true indikerar att prenumeranter kan initiera snapshot-processen.

[ @allow_web_synchronization = ] N'allow_web_synchronization'

Specificerar om publikationen är aktiverad för webbsynkronisering. @allow_web_synchronization är nvarchar(5), med standardvärdet .false true specificerar att prenumerationer på denna publikation kan synkroniseras över HTTPS. Mer information finns i Webbsynkronisering för sammanslagningsreplikering. För att stödja SQL Server Compact-prenumeranter måste du specificera true.

[ @web_synchronization_url = ] N'web_synchronization_url'

Specificerar standardvärdet för den Internet-URL som används för webbsynkronisering. @web_synchronization_url är nvarchar(500), med en standard på NULL. Definierar standard-URL:en på Internet om en sådan inte är explicit inställd när sp_addmergepullsubscription_agent körs.

[ @allow_partition_realignment = ] N'allow_partition_realignment'

Avgör om raderingar skickas till abonnenten när en ändring av raden på publicisten gör att den ändrar sin partition. @allow_partition_realignment är nvarchar(5), med en standard på true.

• true skickar raderingar till prenumeranten för att spegla resultatet av en partitionsändring genom att ta bort data som inte längre ingår i prenumerantens partition.

• falselämnar data från en gammal partition på Subscriber, där ändringar gjorda i denna data på Publisher inte replikeras till denna Subscriber, men ändringar gjorda på Subscriber replikeras till Publisher.

Att sätta @allow_partition_realignment till false används för att behålla data i en prenumeration från en gammal partition när datan behöver vara tillgänglig för historiska ändamål.

[ @retention_period_unit = ] N'retention_period_unit'

Specificerar enheterna för den lagringsperiod som fastställts av @retention. @retention_period_unit är nvarchar(10) och kan vara ett av följande värden.

[ @generation_leveling_threshold = ] generation_leveling_threshold

Specificerar antalet ändringar som finns i en generation. En generation är en samling förändringar som levereras till en Publisher eller prenumerant. @generation_leveling_threshold är int, med standardvärdet .1000

[ @automatic_reinitialization_policy = ] automatic_reinitialization_policy

Specificerar om ändringar laddas upp från prenumeranten innan en automatisk ominitialisering krävs av en ändring i publikationen, där ett värde på 1 angetts för @force_reinit_subscription. @automatic_reinitialization_policy är bit, med standardvärdet .0

1 innebär att ändringar laddas upp från prenumeranten innan en automatisk ominitialisering sker.

[ @conflict_logging = ] N'conflict_logging'

Specificerar var konfliktposter lagras. @conflict_logging är nvarchar(15) och kan vara ett av följande värden:

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Remarks

sp_addmergepublication används vid sammanslagningsreplikation.

För att lista publiceringsobjekt till služba Active Directory med hjälp av parametern @add_to_active_directory måste SQL Server-objektet redan skapas i služba Active Directory.

Om det finns flera publikationer som publicerar samma databasobjekt, endast publikationer med ett @replicate_ddl värde av 1 replikera ALTER TABLE, ALTER VIEW, ALTER PROCEDURE, ALTER FUNCTION, och ALTER TRIGGER DDL-satser. Dock kommer ett ALTER TABLE DROP COLUMN DDL-uttalande att replikeras av alla publikationer som publicerar kolumnen om att släppa.

För SQL Server Compact-abonnenter används värdet av @alternate_snapshot_folder endast när värdet av @snapshot_in_default_folder är false.

Med DDL-replikering aktiverad (@replicate_ddl = 1) för en publikation, för att göra icke-replikerande DDL-ändringar i publikationen, måste sp_changemergepublication först köras för att sätta @replicate_ddl till 0. Efter att de icke-replikerande DDL-satserna har utfärdats sp_changemergepublication kan de köras igen för att slå på DDL-replikeringen.

Examples

-- To avoid storing the login and password in the script file, the value 
-- is passed into SQLCMD as a scripting variable. For information about 
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".

--Declarations for adding a merge publication
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2022'; 
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @login = $(Login);
SET @password = $(Password);

-- Enable merge replication on the publication database, using defaults.
USE master
EXEC sp_replicationdboption 
  @dbname=@publicationDB, 
  @optname=N'merge publish',
  @value = N'true' 

-- Create a new merge publication, explicitly setting the defaults. 
USE [AdventureWorks2022]
EXEC sp_addmergepublication 
-- These parameters are optional.
  @publication = @publication,
  -- optional parameters 
  @description = N'Merge publication of AdventureWorks2022.',
  @publication_compatibility_level  = N'120RTM';

-- Create a new snapshot job for the publication.
EXEC sp_addpublication_snapshot 
  @publication = @publication, 
  @job_login = @login, 
  @job_password = @password;
GO

Permissions

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

Relaterat innehåll

• Skapa en publikation
• Publicera data och databasobjekt
• sys.sp_changemergepublication (Transact-SQL)
• sys.sp_dropmergepublication (Transact-SQL)
• sys.sp_helpmergepublication (Transact-SQL)
• Lagrade procedurer för replikering (Transact-SQL)