Dela via

sp_helpmergepublication (Transact-SQL)

gäller för:SQL Server

Returnerar information om en sammanslagningspublikation. Den här lagrade proceduren körs i Publisher i publikationsdatabasen.

Transact-SQL syntaxkonventioner

Syntax

sp_helpmergepublication
    [ [ @publication = ] N'publication' ]
    [ , [ @found = ] found OUTPUT ]
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]
    [ , [ @reserved = ] N'reserved' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
[ ; ]

Argumentpunkter

[ @publication = ] N'publication'

Namnet på publikationen. @publication är sysname, med standardvärdet %, som returnerar information om alla sammanslagningspublikationer i den aktuella databasen.

[ @found = ] hittade UTDATA

En flagga som anger returnerade rader. @found är en OUTPUT-parameter av typen int.

  • 1 indikerar att publikationen hittas.
  • 0 anger att publikationen inte hittas.

[ @publication_id = ] "publication_id" UTDATA

Publikationens ID-nummer. @publication_id är en OUTPUT-parameter av typen uniqueidentifier.

[ @reserved = ] N'reserved'

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

[ @publisher = ] N'utgivare'

Namnet på utgivaren. @publisher är sysname, med standardvärdet NULL.

[ @publisher_db = ] N'publisher_db'

Namnet på publikationsdatabasen. @publisher_db är sysname med standardvärdet NULL.

Resultatuppsättning

Kolumnnamn Datatyp Beskrivning
id Int Sekventiell ordning för publikationen i resultatuppsättningslistan.
name sysname Publikationens namn.
description nvarchar(255) Beskrivning av publikationen.
status tinyint Anger när publiceringsdata är tillgängliga.
retention Int Tid för att spara metadata om ändringar för artiklar i publikationen. Enheterna för den här tidsperioden kan vara dagar, veckor, månader eller år. Information om enheter finns i kolumnen retention_period_unit.
sync_mode tinyint Synkroniseringsläge för den här publikationen:

0 = Internt masskopieringsprogram (bcp-verktyg )

1 = Masskopiering av tecken
allow_push Int Avgör om push-prenumerationer kan skapas för den aktuella publikationen. 0 innebär att en push-prenumeration inte är tillåten.
allow_pull Int Avgör om pull-prenumerationer kan skapas för den aktuella publikationen. 0 innebär att en pull-prenumeration inte är tillåten.
allow_anonymous Int Avgör om anonyma prenumerationer kan skapas för den aktuella publikationen. 0 innebär att en anonym prenumeration inte är tillåten.
centralized_conflicts Int Avgör om konfliktposter lagras på den angivna utgivaren:

0 = konfliktposter lagras både hos utgivaren och hos prenumeranten som orsakade konflikten.

1 = alla konfliktposter lagras i Publisher.
priority float(8) Prioritet för loop-back-prenumerationen.
snapshot_ready tinyint Anger om ögonblicksbilden av den här publikationen är klar:

0 = Ögonblicksbilden är klar för användning.

1 = Ögonblicksbilden är inte redo att användas.
publication_type Int Typ av publikation:

0 = Ögonblicksbild.

1 = Transaktionell.

2 = Sammanfoga.
pubid unika identifierare Unik identifierare för den här publikationen.
snapshot_jobid binär(16) Jobb-ID för ögonblicksbildsagenten. Om du vill hämta posten för ögonblicksbildjobbet i systemtabellen sysjobs måste du konvertera det här hexadecimala värdet till uniqueidentifier.
enabled_for_internet Int Avgör om publikationen är aktiverad för Internet. Om 1placeras synkroniseringsfilerna för publikationen i C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp katalogen. Användaren måste skapa ftp-katalogen (File Transfer Protocol). Om 0är publikationen inte aktiverad för Internetåtkomst.
dynamic_filter Int Anger om ett parameteriserat radfilter används. 0 innebär att ett parameteriserat radfilter inte används.
has_subscription bit Anger om publikationen har några prenumerationer. 0 innebär att det för närvarande inte finns några prenumerationer på den här publikationen.
snapshot_in_default_folder bit Anger om ögonblicksbildfilerna lagras i standardmappen.

Om 1finns ögonblicksbildfiler i standardmappen.

Om 0lagras ögonblicksbildfiler på den alternativa plats som anges av alt_snapshot_folder. Alternativa platser kan finnas på en annan server, på en nätverksenhet eller på ett flyttbart medium (till exempel flyttbara diskar). Du kan också spara ögonblicksbildfilerna på en FTP-plats för hämtning av prenumeranten vid ett senare tillfälle.

Not: Den här parametern kan vara sann och har fortfarande en plats i parametern alt_snapshot_folder . Den kombinationen anger att ögonblicksbildfilerna lagras på både standard- och alternativa platser.
alt_snapshot_folder nvarchar(255) Anger platsen för den alternativa mappen för ögonblicksbilden.
pre_snapshot_script nvarchar(255) Anger en pekare till en .sql fil som sammanslagningsagenten körs före något av de replikerade objektskripten när ögonblicksbilden tillämpas på en prenumerant.
post_snapshot_script nvarchar(255) Anger en pekare till en .sql fil som sammanslagningsagenten körs efter att alla andra replikerade objektskript och data har tillämpats under en inledande synkronisering.
compress_snapshot bit Anger att ögonblicksbilden som skrivs till alt_snapshot_folder platsen komprimeras till Microsoft CAB-formatet.
ftp_address sysname Nätverksadressen för FTP-tjänsten för distributören. Anger var ögonblicksbildfilerna för publikationen finns för sammanslagningsagenten som ska hämtas.
ftp_port Int Portnumret för FTP-tjänsten för distributören. ftp_port har standardvärdet 21. Anger var ögonblicksbildfilerna för publikationen finns för sammanslagningsagenten som ska hämtas.
ftp_subdirectory nvarchar(255) Anger var ögonblicksbildfilerna är tillgängliga för sammanslagningsagenten som ska hämtas när ögonblicksbilden levereras med FTP.
ftp_login sysname Användarnamnet som används för att ansluta till FTP-tjänsten.
conflict_retention Int Anger kvarhållningsperioden, i dagar, för vilken konflikter behålls. När det angivna antalet dagar har passerat rensas konfliktraden från konflikttabellen.
keep_partition_changes Int Anger om synkroniseringsoptimering sker för den här publikationen. keep_partition_changes har standardvärdet 0. Värdet 0 innebär att synkroniseringen inte är optimerad och att partitionerna som skickas till alla prenumeranter verifieras när data ändras i en partition.

1 innebär att synkroniseringen är optimerad och att endast prenumeranter som har rader i den ändrade partitionen påverkas.

Not: Som standard använder sammanslagningspublikationer fördefinierade partitioner, vilket ger en högre grad av optimering än det här alternativet. Mer information finns i Parameteriserade filter – Parameteriserade radfilter och parameteriserade filter – Optimera för förberäknade partitioner.
allow_subscription_copy Int Anger om möjligheten att kopiera de prenumerationsdatabaser som prenumererar på den här publikationen har aktiverats. 0 Värdet innebär att kopiering inte tillåts.
allow_synctoalternate Int Anger om en alternativ synkroniseringspartner tillåts synkronisera med den här utgivaren. 0 Värdet innebär att en synkroniseringspartner inte tillåts.
validate_subscriber_info nvarchar(500) Visar en lista över de funktioner som används för att hämta prenumerantinformation och validera parameteriserade radfiltreringsvillkor för Prenumeranten. Hjälper till att kontrollera att informationen partitioneras konsekvent med varje sammanslagning.
backward_comp_level Int Databaskompatibilitetsnivå och kan vara något av följande värden:

90 = SQL Server 2005 (9.x)

90 = SQL Server 2005 (9.x) SP1

90 = SQL Server 2005 (9.x) SP2

100 = SQL Server 2008 (10.0.x)
publish_to_activedirectory bit Anger om publikationsinformationen publiceras till Active Directory. 0 Värdet innebär att publikationsinformationen inte är tillgänglig från Active Directory.

Den här parametern är inaktuell och underhålls för bakåtkompatibilitet för skript. Du kan inte längre lägga till publikationsinformation i Active Directory.
max_concurrent_merge Int Antalet samtidiga sammanslagningsprocesser. Om 0finns det ingen gräns för antalet samtidiga sammanslagningsprocesser som körs vid en viss tidpunkt.
max_concurrent_dynamic_snapshots Int Det maximala antalet samtidiga filtrerade dataögonblickssessioner som kan köras mot sammanslagningspublikationen. Om 0finns det ingen gräns för det maximala antalet samtidiga filtrerade dataögonblickssessioner som kan köras samtidigt mot publikationen vid en viss tidpunkt.
use_partition_groups Int Avgör om förberäknade partitioner används. Värdet 1 innebär att förberäknade partitioner används.
num_of_articles Int Antal artiklar i publikationen.
replicate_ddl Int Om schemaändringar i publicerade tabeller replikeras. Värdet 1 innebär att schemaändringar replikeras.
publication_number smallint Nummer som tilldelats den här publikationen.
allow_subscriber_initiated_snapshot bit Avgör om prenumeranter kan initiera genereringsprocessen för filtrerade dataögonblicksbilder. 1 Värdet innebär att prenumeranter kan initiera ögonblicksbildsprocessen.
allow_web_synchronization bit Avgör om publikationen är aktiverad för webbsynkronisering. Värdet 1 innebär att webbsynkronisering är aktiverat.
web_synchronization_url nvarchar(500) Internet-URL som används för webbsynkronisering.
allow_partition_realignment bit Avgör om borttagningar skickas till prenumeranten när en rad på utgivaren ändras. Värdet 1 innebär att borttagningar skickas till prenumeranten. Mer information finns i sp_addmergepublication.
retention_period_unit tinyint Definierar den enhet som används när du definierar kvarhållning. Detta kan vara något av följande värden:

0 = dag

1 = vecka

2 = månad

3 = år
has_downloadonly_articles bit Anger om några artiklar som tillhör publikationen är endast nedladdningsbara artiklar. Värdet 1 anger att det finns endast nedladdningsbara artiklar.
decentralized_conflicts Int Anger om konfliktposterna lagras hos prenumeranten som orsakade konflikten. Värdet 0 anger att konfliktposter inte lagras i Prenumeranten. Värdet 1 anger att konfliktposter lagras hos Prenumeranten.
generation_leveling_threshold Int Anger antalet ändringar som finns i en generation. En generation är en samling ändringar som levereras till en utgivare eller prenumerant
automatic_reinitialization_policy bit Anger om ändringar laddas upp från Prenumeranten innan en automatisk återinitiering sker. Värdet 1 anger att ändringar laddas upp från prenumeranten innan en automatisk ominitiering sker. Värdet 0 anger att ändringar inte laddas upp före en automatisk ominitiering.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Anmärkningar

sp_helpmergepublication används i sammanslagningsreplikering.

Behörigheter

Medlemmar i publikationens åtkomstlista för en publikation kan köras sp_helpmergepublication för den publikationen. Medlemmar i db_owner fast databasroll i publikationsdatabasen kan köras sp_helpmergepublication för information om alla publikationer.

Exempel

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

USE [AdventureWorks2022]
EXEC sp_helpmergepublication @publication = @publication;
GO

Relaterat innehåll