sp_helpmergepublication (Transact-SQL)

2025-06-27

Van toepassing op:SQL Server

Retourneert informatie over een samenvoegpublicatie. Deze opgeslagen procedure wordt uitgevoerd bij Publisher in de publicatiedatabase.

Transact-SQL syntaxis-conventies

Syntaxis

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

Argumenten

[ @publication = ] N'publicatie'

De naam van de publicatie. @publication is sysname, met een standaardwaarde %, waarmee informatie wordt geretourneerd over alle samenvoegpublicaties in de huidige database.

[ @found = ] gevonden UITVOER

Een vlag die aangeeft dat rijen worden geretourneerd. @found is een UITVOERparameter van het type int.

1 geeft aan dat de publicatie is gevonden.
0 geeft aan dat de publicatie niet is gevonden.

[ @publication_id = ] UITVOER 'publication_id'

Het identificatienummer van de publicatie. @publication_id is een OUTPUT-parameter van het type uniqueidentifier.

[ @reserved = ] N'reserved'

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

[ @publisher = ] N'uitgever'

De naam van de uitgever. @publisher is sysname, met een standaardwaarde van NULL.

[ @publisher_db = ] N'publisher_db'

De naam van de publicatiedatabase. @publisher_db is sysname, met een standaardwaarde van NULL.

Resultaatset

Kolomnaam	Gegevenstype	Beschrijving
`id`	Int	Opeenvolgende volgorde van de publicatie in de lijst met resultatensets.
`name`	sysname	Naam van de publicatie.
`description`	nvarchar(255)	Beschrijving van de publicatie.
`status`	tinyint	Geeft aan wanneer publicatiegegevens beschikbaar zijn.
`retention`	Int	Tijd om metagegevens over wijzigingen in artikelen in de publicatie op te slaan. De eenheden voor deze periode kunnen dagen, weken, maanden of jaren zijn. Zie de kolom retention_period_unit voor meer informatie over eenheden.
`sync_mode`	tinyint	Synchronisatiemodus van deze publicatie: `0` = Systeemeigen programma voor bulkkopie (bcp-hulpprogramma ) `1` = Bulkkopie van tekens
`allow_push`	Int	Bepaalt of pushabonnementen kunnen worden gemaakt voor de opgegeven publicatie. `0` betekent dat een push-abonnement niet is toegestaan.
`allow_pull`	Int	Bepaalt of pull-abonnementen kunnen worden gemaakt voor de opgegeven publicatie. `0` betekent dat een pull-abonnement niet is toegestaan.
`allow_anonymous`	Int	Bepaalt of anonieme abonnementen kunnen worden gemaakt voor de opgegeven publicatie. `0` betekent dat een anoniem abonnement niet is toegestaan.
`centralized_conflicts`	Int	Bepaalt of conflictrecords worden opgeslagen in de opgegeven uitgever: `0` = conflictrecords worden opgeslagen bij zowel de uitgever als bij de abonnee die het conflict heeft veroorzaakt. `1` = alle conflictrecords worden opgeslagen bij Publisher.
`priority`	float(8)	Prioriteit van het loop-back-abonnement.
`snapshot_ready`	tinyint	Hiermee wordt aangegeven of de momentopname van deze publicatie gereed is: `0` = Momentopname is gereed voor gebruik. `1` = Momentopname is niet gereed voor gebruik.
`publication_type`	Int	Type publicatie: `0` = Momentopname. `1` = Transactioneel. `2` = Samenvoegen.
`pubid`	uniqueidentifier	Unieke id van deze publicatie.
`snapshot_jobid`	binary(16)	Taak-id van de momentopnameagent. Als u de vermelding voor de momentopnametaak in de systeemtabel sysjobs wilt ophalen, moet u deze hexadecimale waarde converteren naar uniqueidentifier.
`enabled_for_internet`	Int	Bepaalt of de publicatie is ingeschakeld voor internet. Als `1`de synchronisatiebestanden voor de publicatie in de `C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp` map worden geplaatst. De gebruiker moet de FTP-map (File Transfer Protocol) maken. Als `0`de publicatie niet is ingeschakeld voor internettoegang.
`dynamic_filter`	Int	Hiermee wordt aangegeven of een geparameteriseerd rijfilter wordt gebruikt. `0` betekent dat een geparameteriseerd rijfilter niet wordt gebruikt.
`has_subscription`	bit	Geeft aan of de publicatie abonnementen heeft. `0` betekent dat er momenteel geen abonnementen op deze publicatie zijn.
`snapshot_in_default_folder`	bit	Hiermee geeft u op of de momentopnamebestanden worden opgeslagen in de standaardmap. Als `1`u momentopnamebestanden kunt vinden in de standaardmap. Als `0`, momentopname bestanden worden opgeslagen op de alternatieve locatie opgegeven door `alt_snapshot_folder`. Alternatieve locaties kunnen zich op een andere server, op een netwerkstation of op een verwisselbare media (zoals verwisselbare schijven) bevinden. U kunt de momentopnamebestanden ook opslaan op een FTP-site voor het ophalen door de abonnee op een later tijdstip. Notitie: Deze parameter kan waar zijn en nog steeds een locatie in de `alt_snapshot_folder` parameter hebben. Deze combinatie geeft aan dat de momentopnamebestanden worden opgeslagen op zowel de standaard- als alternatieve locaties.
`alt_snapshot_folder`	nvarchar(255)	Hiermee geeft u de locatie van de alternatieve map voor de momentopname.
`pre_snapshot_script`	nvarchar(255)	Hiermee geeft u een aanwijzer naar een .sql-bestand dat door de samenvoegagent wordt uitgevoerd vóór een van de gerepliceerde objectscripts bij het toepassen van de momentopname bij een abonnee.
`post_snapshot_script`	nvarchar(255)	Hiermee geeft u een aanwijzer naar een .sql-bestand dat door de samenvoegagent wordt uitgevoerd nadat alle andere gerepliceerde objectscripts en -gegevens zijn toegepast tijdens een initiële synchronisatie.
`compress_snapshot`	bit	Hiermee geeft u op dat de momentopname die naar de `alt_snapshot_folder` locatie wordt geschreven, wordt gecomprimeerd in de Microsoft CAB-indeling.
`ftp_address`	sysname	Het netwerkadres van de FTP-service voor de distributeur. Hiermee geeft u op waar momentopnamebestanden van de publicatie zich bevinden voor de samenvoegagent die moet worden opgehaald.
`ftp_port`	Int	Het poortnummer van de FTP-service voor de distributeur. `ftp_port` heeft een standaardwaarde van `21`. Hiermee geeft u op waar de momentopnamebestanden van de publicatie zich bevinden om de samenvoegagent op te halen.
`ftp_subdirectory`	nvarchar(255)	Hiermee geeft u op waar de momentopnamebestanden beschikbaar zijn om de samenvoegagent op te halen wanneer de momentopname wordt geleverd met FTP.
`ftp_login`	sysname	De gebruikersnaam die wordt gebruikt om verbinding te maken met de FTP-service.
`conflict_retention`	Int	Hiermee geeft u de bewaarperiode, in dagen, waarvoor conflicten worden bewaard. Nadat het opgegeven aantal dagen is verstreken, wordt de conflictrij uit de conflicttabel verwijderd.
`keep_partition_changes`	Int	Hiermee geeft u op of synchronisatieoptimalisatie plaatsvindt voor deze publicatie. `keep_partition_changes` heeft een standaardwaarde van `0`. Een waarde die `0` betekent dat synchronisatie niet is geoptimaliseerd en dat de partities die naar alle abonnees worden verzonden, worden gecontroleerd wanneer gegevens in een partitie worden gewijzigd. `1` betekent dat synchronisatie is geoptimaliseerd en dat alleen abonnees met rijen in de gewijzigde partitie worden beïnvloed. Notitie: Standaard maken samenvoegpublicaties gebruik van vooraf samengestelde partities, die een grotere mate van optimalisatie bieden dan deze optie. Zie Geparameteriseerde filters - Geparameteriseerde rijfilters en geparameteriseerde filters - Optimaliseren voor vooraf samengestelde partities voor meer informatie.
`allow_subscription_copy`	Int	Hiermee geeft u op of de mogelijkheid om de abonnementsdatabases te kopiëren die zich op deze publicatie abonneren, is ingeschakeld. Een waarde van `0` betekent dat kopiëren niet is toegestaan.
`allow_synctoalternate`	Int	Hiermee geeft u op of een alternatieve synchronisatiepartner mag synchroniseren met deze uitgever. Een waarde van `0` betekent dat een synchronisatiepartner niet is toegestaan.
`validate_subscriber_info`	nvarchar(500)	Geeft een overzicht van de functies die worden gebruikt voor het ophalen van abonneegegevens en het valideren van de geparameteriseerde criteria voor het filteren van rijen op de abonnee. Hiermee kunt u controleren of de informatie consistent wordt gepartitioneerd bij elke samenvoeging.
`backward_comp_level`	Int	Databasecompatibiliteitsniveau en kan een van de volgende waarden zijn: `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	Hiermee geeft u op of de publicatiegegevens naar Active Directory worden gepubliceerd. Een waarde van `0` dit type betekent dat de publicatiegegevens niet beschikbaar zijn in Active Directory. Deze parameter is afgeschaft en wordt onderhouden voor achterwaartse compatibiliteit van scripts. U kunt geen publicatiegegevens meer toevoegen aan Active Directory.
`max_concurrent_merge`	Int	Het aantal gelijktijdige samenvoegprocessen. Als `0`er geen limiet is voor het aantal gelijktijdige samenvoegprocessen dat op een bepaald moment wordt uitgevoerd.
`max_concurrent_dynamic_snapshots`	Int	Het maximum aantal gelijktijdig gefilterde sessies voor momentopnamen van gegevens die kunnen worden uitgevoerd voor de samenvoegpublicatie. Als `0`er op elk gewenst moment geen limiet is voor het maximum aantal gelijktijdig gefilterde momentopnamesessies voor gefilterde gegevens die tegelijkertijd op de publicatie kunnen worden uitgevoerd.
`use_partition_groups`	Int	Bepaalt of vooraf samengestelde partities worden gebruikt. Een waarde van `1` betekent dat vooraf samengestelde partities worden gebruikt.
`num_of_articles`	Int	Aantal artikelen in de publicatie.
`replicate_ddl`	Int	Als schemawijzigingen in gepubliceerde tabellen worden gerepliceerd. Een waarde van `1` betekent dat schemawijzigingen worden gerepliceerd.
`publication_number`	smallint	Nummer dat is toegewezen aan deze publicatie.
`allow_subscriber_initiated_snapshot`	bit	Bepaalt of abonnees het proces voor het genereren van gefilterde momentopnamen kunnen initiëren. Een waarde die `1` betekent dat abonnees het momentopnameproces kunnen initiëren.
`allow_web_synchronization`	bit	Bepaalt of de publicatie is ingeschakeld voor websynchronisatie. Een waarde van `1` dit type betekent dat websynchronisatie is ingeschakeld.
`web_synchronization_url`	nvarchar(500)	Internet-URL die wordt gebruikt voor websynchronisatie.
`allow_partition_realignment`	bit	Bepaalt of verwijderingen naar de abonnee worden verzonden wanneer wijzigingen van de rij op de uitgever ertoe leiden dat de partitie wordt gewijzigd. Een waarde van `1` dit type betekent dat verwijderingen naar de abonnee worden verzonden. Zie sp_addmergepublication voor meer informatie.
`retention_period_unit`	tinyint	Definieert de eenheid die wordt gebruikt bij het definiëren van retentie. Dit kan een van de volgende waarden zijn: `0` = dag `1` = week `2` = maand `3` = jaar
`has_downloadonly_articles`	bit	Geeft aan of artikelen die deel uitmaken van de publicatie alleen-downloaden zijn. Een waarde van `1` geeft aan dat er alleen-downloaden artikelen zijn.
`decentralized_conflicts`	Int	Geeft aan of de conflictrecords zijn opgeslagen bij de abonnee die het conflict heeft veroorzaakt. Een waarde van `0` geeft aan dat conflictrecords niet worden opgeslagen bij de abonnee. Een waarde waarmee `1` wordt aangegeven dat conflictrecords worden opgeslagen bij de abonnee.
`generation_leveling_threshold`	Int	Hiermee geeft u het aantal wijzigingen op dat in een generatie is opgenomen. Een generatie is een verzameling wijzigingen die worden geleverd aan een uitgever of abonnee
`automatic_reinitialization_policy`	bit	Hiermee wordt aangegeven of wijzigingen van de abonnee worden geüpload voordat een automatische herinitialisatie plaatsvindt. Een waarde van `1` geeft aan dat wijzigingen worden geüpload van de abonnee voordat een automatische herinitialisatie plaatsvindt. Een waarde van 0 geeft aan dat wijzigingen niet worden geüpload vóór een automatische herinitialisatie.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Opmerkingen

sp_helpmergepublication wordt gebruikt in samenvoegreplicatie.

Machtigingen

Leden van de toegangslijst voor de publicatie voor een publicatie kunnen worden uitgevoerd sp_helpmergepublication voor die publicatie. Leden van de db_owner vaste databaserol in de publicatiedatabase kunnen worden uitgevoerd sp_helpmergepublication voor informatie over alle publicaties.

Voorbeelden

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

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