sp_helpmergepublication (Transact-SQL)

  • Artikel

Gilt für: SQL Server

Gibt Informationen zu einer Mergeveröffentlichung zurück. Diese gespeicherte Prozedur wird im Publisher in der Publikationsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

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' ]
[ ; ]

Argumente

[ @publication = ] N'Publikation'

Der Name der Veröffentlichung. @publication ist sysname, mit einem Standardwert von %, der Informationen zu allen Zusammenführungspublikationen in der aktuellen Datenbank zurückgibt.

[ @found = ] ausgabe gefunden

Ein Kennzeichen, das angibt, dass Zeilen zurückgegeben werden. @found ist ein OUTPUT-Parameter vom Typ int.

  • 1 gibt an, dass die Publikation gefunden wird.
  • 0 gibt an, dass die Publikation nicht gefunden wurde.

[ @publication_id = ] 'publication_id' OUTPUT

Die Veröffentlichung-ID. @publication_id ist ein OUTPUT-Parameter vom Typ uniqueidentifier.

[ @reserved = ] N'reserved'

Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

[ @publisher = ] N'publisher'

Der Name des Herausgebers. @publisher ist "sysname" mit der Standardeinstellung "NULL.

[ @publisher_db = ] N'publisher_db'

Der Name der Publikationsdatenbank. @publisher_db ist "sysname" mit der Standardeinstellung "NULL.

Resultset

Spaltenname Datentyp BESCHREIBUNG
id int Sequenzielle Position der Veröffentlichung in der Liste im Resultset.
name sysname Name der Veröffentlichung.
description nvarchar(255) Beschreibung der Publikation.
status tinyint Gibt an, wann Veröffentlichungsdaten verfügbar sind.
retention int Die Zeit, die Metadaten zu Änderungen in Artikeln in der Veröffentlichung gespeichert werden sollen. Die Einheiten für diesen Zeitraum kann Tage, Wochen, Monate oder Jahre sein. Informationen zu Einheiten finden Sie in der retention_period_unit-Spalte.
sync_mode tinyint Synchronisierungsmodus dieser Veröffentlichung.

0 = Systemeigenes Massenkopieprogramm (bcp-Hilfsprogramm )

1 = Massenkopie des Zeichens
allow_push int Bestimmt, ob für die angegebene Veröffentlichung Pushabonnements erstellt werden können. 0 bedeutet, dass ein Pushabonnement nicht zulässig ist.
allow_pull int Bestimmt, ob für die angegebene Veröffentlichung Pullabonnements erstellt werden können. 0 bedeutet, dass ein Pullabonnement nicht zulässig ist.
allow_anonymous int Bestimmt, ob für die angegebene Veröffentlichung anonyme Abonnements erstellt werden können. 0 bedeutet, dass ein anonymes Abonnement nicht zulässig ist.
centralized_conflicts int Legt fest, ob Konfliktdatensätze auf dem angegebenen Verleger gespeichert werden:

0 = Konfliktdatensätze werden sowohl beim Herausgeber als auch beim Abonnent gespeichert, der den Konflikt verursacht hat.

1 = Alle Konfliktdatensätze werden im Publisher gespeichert.
priority float(8) Priorität des Loopbackabonnements.
snapshot_ready tinyint Gibt an, ob die Momentaufnahme dieser Veröffentlichung einsatzbereit ist.

0 = Momentaufnahme ist einsatzbereit.

1 = Momentaufnahme ist nicht einsatzbereit.
publication_type int Typ der Veröffentlichung:

0 = Momentaufnahme.

1 = Transaktional.

2 = Zusammenführen.
pubid uniqueidentifier Eindeutiger Bezeichner dieser Veröffentlichung.
snapshot_jobid binary(16) Auftrags-ID des Momentaufnahme-Agents. Um den Eintrag für den Momentaufnahmeauftrag in der Sysjobs-Systemtabelle abzurufen, müssen Sie diesen Hexadezimalwert in einen eindeutigen Bezeichner konvertieren.
enabled_for_internet int Legt fest, ob die Veröffentlichung für das Internet aktiviert ist. Wenn 1die Synchronisierungsdateien für die Publikation in das C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp Verzeichnis eingefügt werden. Der Benutzer muss das FTP-Verzeichnis (File Transfer Protocol) erstellen. Wenn 0die Publikation für den Internetzugriff nicht aktiviert ist.
dynamic_filter int Gibt an, ob ein parametrisierter Zeilenfilter verwendet wird. 0 bedeutet, dass kein parametrisierter Zeilenfilter verwendet wird.
has_subscription bit Gibt an, ob die Veröffentlichung über Abonnements verfügt. 0 bedeutet, dass es derzeit keine Abonnements für diese Publikation gibt.
snapshot_in_default_folder bit Legt fest, ob die Momentaufnahmedateien im Standardordner gespeichert werden.

Wenn 1, Snapshot-Dateien im Standardordner gefunden werden.

If 0, snapshot files are stored in the alternate location specified by alt_snapshot_folder. Alternative Speicherorte können sich auf einem anderen Server, auf einem Netzlaufwerk oder auf einem Wechselmedium befinden (z. B. Wechseldatenträger). Momentaufnahmedateien können auch auf einer FTP-Site gespeichert werden, um zu einem späteren Zeitpunkt vom Abonnenten abgerufen zu werden.

Hinweis: Dieser Parameter kann "true" sein und dennoch einen Speicherort im alt_snapshot_folder Parameter aufweisen. Diese Kombination gibt an, dass die Momentaufnahmedateien sowohl an den Standardspeicherorten als auch an den alternativen Standorten gespeichert werden.
alt_snapshot_folder nvarchar(255) Gibt den Speicherort des anderen Ordners für die Momentaufnahme an.
pre_snapshot_script nvarchar(255) Gibt einen Zeiger auf eine .sql Datei an, die vom Merge-Agent ausgeführt wird, bevor eines der replizierten Objektskripts ausgeführt wird, wenn die Momentaufnahme auf einen Abonnenten angewendet wird.
post_snapshot_script nvarchar(255) Gibt einen Zeiger auf eine .sql Datei an, die vom Merge-Agent ausgeführt wird, nachdem alle anderen replizierten Objektskripts und -daten während einer anfänglichen Synchronisierung angewendet wurden.
compress_snapshot bit Gibt an, dass die Momentaufnahme, die in den alt_snapshot_folder Speicherort geschrieben wird, in das Microsoft CAB-Format komprimiert wird.
ftp_address sysname Die Netzwerkadresse des FTP-Diensts für den Distributor. Gibt an, wo sich Publikationsmomentaufnahmendateien befinden, damit die Merge-Agent aufgenommen werden.
ftp_port int Die Portnummer des FTP-Diensts für den Distributor. ftp_port hat einen Standardwert von 21. Gibt an, wo die Veröffentlichungsmomentaufnahmedateien zum Abholen durch den Merge-Agent gespeichert sind.
ftp_subdirectory nvarchar(255) Gibt an, wo die Veröffentlichungsmomentaufnahmedateien zum Abholen durch den Merge-Agent gespeichert sind, wenn die Momentaufnahme mithilfe von FTP übermittelt wird.
ftp_login sysname Der Benutzername, der zum Herstellen einer Verbindung mit dem FTP-Dienst verwendet wird.
conflict_retention int Gibt die Aufbewahrungsdauer in Tagen an, für die Konflikte beibehalten werden. Wenn die angegebene Anzahl von Tagen abgelaufen ist, wird die Konfliktzeile aus der Konflikttabelle gelöscht.
keep_partition_changes int Gibt an, ob die Synchronisierungsoptimierung für diese Veröffentlichung erfolgt. keep_partition_changes hat einen Standardwert von 0. Der Wert bedeutet 0 , dass die Synchronisierung nicht optimiert ist und die an alle Abonnenten gesendeten Partitionen überprüft werden, wenn sich Daten in einer Partition ändern.

1 bedeutet, dass die Synchronisierung optimiert ist und nur Abonnenten mit Zeilen in der geänderten Partition betroffen sind.

Hinweis: Standardmäßig verwenden Zusammenführungspublikationen vorkompilierte Partitionen, die ein höheres Maß an Optimierung bieten als diese Option. Weitere Informationen finden Sie unter Parameterisierte Filter – parametrisierte Zeilenfilter und parametrisierte Filter – Optimieren für vorkompilierte Partitionen.
allow_subscription_copy int Gibt an, ob die Möglichkeit zum Kopieren der Abonnementdatenbanken aktiviert wurde, die diese Veröffentlichung abonniert haben. Ein Wert von 0 "Kopieren" ist nicht zulässig.
allow_synctoalternate int Gibt an, ob ein alternativer Synchronisierungspartner für die Synchronisierung mit diesem Verleger zulässig ist. Ein Wert von 0 bedeutet, dass ein Synchronisierungspartner nicht zulässig ist.
validate_subscriber_info nvarchar(500) Listet die Funktionen auf, die zum Abrufen der Abonnenteninformationen sowie zum Überprüfen der parametrisierten Zeilenfilterkriterien für den Abonnenten verwendet werden. Hilft, zu überprüfen, ob die Informationen konsistent mit den einzelnen Zusammenführungen partitioniert werden.
backward_comp_level int Datenbankkompatibilitätsstufe und kann einer der folgenden Werte sein:

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 Gibt an, ob die Veröffentlichungsinformationen in Active Directory veröffentlicht werden. Ein Wert von 0 bedeutet, dass die Publikationsinformationen aus Active Directory nicht verfügbar sind.

Dieser Parameter ist veraltet und wird für die Abwärtskompatibilität von Skripts beibehalten. Sie können Active Directory nicht länger Veröffentlichungsinformationen hinzufügen.
max_concurrent_merge int Die Anzahl gleichzeitiger Mergeprozesse. Wenn 0, gibt es keine Beschränkung auf die Anzahl gleichzeitiger Zusammenführungsprozesse, die zu einem bestimmten Zeitpunkt ausgeführt werden.
max_concurrent_dynamic_snapshots int Die maximale Anzahl gleichzeitiger Sitzungen für eine Momentaufnahme gefilterter Daten, die für die Mergeveröffentlichung ausgeführt werden können. Wenn 0, gibt es keine Beschränkung auf die maximale Anzahl gleichzeitig gefilterter Datenmomentaufnahmesitzungen, die gleichzeitig für die Publikation ausgeführt werden können.
use_partition_groups int Legt fest, ob vorausberechnete Partitionen verwendet werden. Ein Wert von 1 bedeutet, dass vorkompilierte Partitionen verwendet werden.
num_of_articles int Anzahl der Artikel in der Veröffentlichung.
replicate_ddl int Gibt an, ob Schemaänderungen an veröffentlichten Tabellen repliziert werden. Ein Wert bedeutet 1 , dass Schemaänderungen repliziert werden.
publication_number smallint Die Nummer, die dieser Veröffentlichung zugewiesen ist.
allow_subscriber_initiated_snapshot bit Legt fest, ob Abonnenten den Prozess für die Generierung eine Momentaufnahme für gefilterte Daten initiieren können. Ein Wert von 1 bedeutet, dass Abonnenten den Momentaufnahmeprozess initiieren können.
allow_web_synchronization bit Legt fest, ob die Veröffentlichung für die Websynchronisierung aktiviert ist. Ein Wert von 1 bedeutet, dass die Websynchronisierung aktiviert ist.
web_synchronization_url nvarchar(500) Die für die Websynchronisierung verwendete Internet-URL.
allow_partition_realignment bit Bestimmt, ob Löschungen an den Abonnenten gesendet werden, wenn durch eine Änderung der Zeile auf Verlegerebene eine Änderung der zugehörigen Partition ausgelöst wird. Ein Wert von 1 bedeutet, dass Löschdaten an den Abonnenten gesendet werden. Weitere Informationen finden Sie unter sp_addmergepublication (Transact-SQL).
retention_period_unit tinyint Definiert die Einheit, die beim Definieren der Beibehaltung verwendet wird. Mögliche Werte:

0 = Tag

1 = Woche

2 = Monat

3 = Jahr
has_downloadonly_articles bit Gibt an, ob es sich bei Artikeln, die zur Veröffentlichung gehören, um nur herunterladbare Artikel handelt. Ein Wert, der 1 angibt, dass nur Downloadartikel vorhanden sind.
decentralized_conflicts int Gibt an, ob die Konfliktdatensätze auf dem Abonnenten gespeichert werden, der den Konflikt verursacht hat. Ein Wert von 0 gibt an, dass Konfliktdatensätze nicht beim Abonnenten gespeichert werden. Ein Wert, der 1 angibt, dass Konfliktdatensätze beim Abonnenten gespeichert werden.
generation_leveling_threshold int Gibt die Anzahl der Änderungen an, die in einer Generation enthalten sind. Eine Generation ist eine Sammlung von Änderungen, die an einen Herausgeber oder Abonnenten übermittelt werden
automatic_reinitialization_policy bit Gibt an, ob Änderungen vom Abonnenten vor einer automatischen erneuten Initialisierung hochgeladen werden. Ein Wert von 1 gibt an, dass Änderungen aus dem Abonnenten hochgeladen werden, bevor eine automatische Neuiniialisierung eintritt. Der Wert 0 gibt an, dass Änderungen nicht vor einer automatischen Erneutitialisierung hochgeladen werden.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_helpmergepublication wird in der Seriendruckreplikation verwendet.

Berechtigungen

Mitglieder der Publikationszugriffsliste für eine Publikation können für diese Publikation ausgeführt werden sp_helpmergepublication . Mitglieder der db_owner festen Datenbankrolle in der Publikationsdatenbank können für Informationen zu allen Publikationen ausgeführt werden sp_helpmergepublication .

Beispiele

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

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

Zugehöriger Inhalt