sp_helpmergepublication (Transact-SQL)

  • Artikel

Aktualisiert: 12. Dezember 2006

Gibt Informationen zu einer Mergepublikation zurück. Diese gespeicherte Prozedur wird beim Verleger mit der Publikationsdatenbank ausgeführt.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

  • [ @publication=] 'publication'
    Der Name der Publikation. publication ist vom Datentyp sysname; der Standard ist %, womit Informationen zu allen Mergepublikationen in der aktuellen Datenbank zurückgegeben werden.
  • [ @found=] 'found' OUTPUT
    Ein Flag zur Angabe der Zeilen, die abgerufen werden sollen. found ist vom Datentyp int und ein OUTPUT-Parameter; der Standard ist NULL. 1 bedeutet, dass die Publikation gefunden wurde. 0 bedeutet, dass die Publikation nicht gefunden wurde.
  • [ @publication_id=] 'publication_id' OUTPUT
    Die ID der Publikation. publication_id ist vom Datentyp uniqueidentifier und ein OUTPUT-Parameter; der Standard ist NULL.
  • [ @reserved=] 'reserved'
    Ist für zukünftige Zwecke reserviert. reserved ist vom Datentyp nvarchar(20); der Standard ist NULL.
  • [ @publisher= ] 'publisher'
    Der Name des Verlegers. publisher ist vom Datentyp sysname; der Standard ist NULL.
  • [@publisher_db = ] 'publisher_db'
    Der Name der Publikationsdatenbank. publisher_db ist vom Datentyp sysname; der Standard ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname

Datentyp

Beschreibung

id

int

Sequenzielle Position der Publikation in der Liste im Resultset.

name

sysname

Name der Publikation.

description

nvarchar(255)

Die Beschreibung der Publikation.

status

tinyint

Gibt an, wann Publikationsdaten verfügbar sind.

retention

int

Der Umfang an Änderungen (in Tagen), die für die angegebene Publikation gespeichert werden sollen.

sync_mode

tinyint

Synchronisierungsmodus dieser Publikation.

0 = Systemeigenes Massenkopierprogramm (Dienstprogramm bcp )

1 = Massenkopieren von Zeichen.

allow_push

int

Gibt an, ob für die jeweilige Publikation Pushabonnements erstellt werden können. 0 bedeutet, dass ein Pushabonnement nicht zulässig ist.

allow_pull

int

Gibt an, ob für die jeweilige Publikation Pullabonnements erstellt werden können. 0 bedeutet, dass ein Pullabonnement nicht zulässig ist.

allow_anonymous

int

Gibt an, ob für die jeweilige Publikation anonyme Abonnements erstellt werden können. 0 bedeutet, dass ein anonymes Abonnement nicht zulässig ist.

centralized_conflicts

int

Gibt an, ob Konfliktdatensätze auf dem angegebenen Verleger gespeichert werden.

0 = Die Konfliktdatensätze werden sowohl auf dem Verleger als auch auf dem Abonnenten gespeichert, die den Konflikt verursacht haben.

1 = Alle Konfliktdatensätze werden auf dem Verleger gespeichert.

priority

float(8)

Priorität des Loopbackabonnements.

snapshot_ready

tinyint

Zeigt an, ob der Snapshot dieser Publikation einsatzbereit ist.

0 = Snapshot kann verwendet werden.

1 = Snapshot kann nicht verwendet werden.

publication_type

int

Typ der Publikation:

0 = Snapshot.

1 = Transaktion.

2 = Merge.

pubid

uniqueidentifier

Eindeutiger Bezeichner dieser Publikation.

snapshot_jobid

binary(16)

Auftrags-ID des Snapshot-Agents. Um den Eintrag für den Snapshotauftrag in der sysjobs-Systemtabelle zu erhalten, müssen Sie diesen Hexadezimalwert in uniqueidentifier konvertieren.

enabled_for_internet

int

Gibt an, ob die Publikation für das Internet aktiviert ist. Bei 1 werden die Synchronisationsdateien für die Publikation im Verzeichnis C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp gespeichert. Der Benutzer muss das FTP-Verzeichnis (File Transfer Protocol) erstellen. Bei 0 ist die Publikation nicht für den Internetzugriff aktiviert.

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 Publikation über Abonnements verfügt. 0 gibt an, dass zurzeit keine Abonnements für diese Publikation bestehen.

snapshot_in_default_folder

bit

Legt fest, ob die Snapshotdateien im Standardordner gespeichert werden.

Bei 1 befinden sich die Snapshotdateien im Standardordner.

Bei 0 werden Snapshotdateien an dem alternativen Speicherort gespeichert, der durch alt_snapshot_folder festgelegt wird. Alternative Speicherorte können sich auf einem anderen Server, auf einem Netzlaufwerk oder auf einem Wechselmedium (z. B. CD-ROM oder Wechseldatenträger) befinden. Snapshotdateien lassen sich auch in einer FTP-Site speichern, um zu einem späteren Zeitpunkt vom Abonnenten abgerufen zu werden.

ms189475.note(de-de,SQL.90).gifHinweis:

Dieser Parameter kann den Wert true besitzen und trotzdem kann eine Position im Parameter alt_snapshot_folder angegeben sein. Diese Kombination gibt an, dass die Snapshotdateien 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 den Snapshot an.

pre_snapshot_script

nvarchar(255)

Gibt einen Zeiger auf eine SQL-Datei an, die der Merge-Agent vor allen replizierten Objektskripts ausführt, wenn er den Snapshot auf einem Abonnenten anwendet.

post_snapshot_script

nvarchar(255)

Gibt einen Zeiger auf eine SQL-Datei an, die der Merge-Agent ausführt, nachdem alle anderen replizierten Objektskripts und -daten während einer anfänglichen Synchronisierung angewendet wurden.

compress_snapshot

bit

Gibt an, dass der Snapshot, der an den Speicherort alt_snapshot_folder geschrieben wird, in das CAB-Format von Microsoft komprimiert wird.

ftp_address

sysname

Die Netzwerkadresse des FTP-Dienstes für den Verteiler. Gibt an, wo die Publikationssnapshotdateien zum Abholen durch den Merge-Agent gespeichert sind.

ftp_port

int

Die Portnummer auf dem FTP-Dienst für den Verteiler. ftp_port hat den Standardwert 21. Gibt an, wo die Publikationssnapshotdateien zum Abholen durch den Merge-Agent gespeichert sind.

ftp_subdirectory

nvarchar(255)

Gibt an, wo die Publikationssnapshotdateien zum Abholen durch den Merge-Agent gespeichert sind, wenn der Snapshot mithilfe von FTP übermittelt wird.

ftp_login

sysname

Der Benutzername, mit dem eine Verbindung zum FTP-Dienst hergestellt 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 für diese Publikation eine Synchronisierungsoptimierung erfolgt. keep_partition_changes hat den Standardwert 0.

0 bedeutet, dass die Synchronisierung nicht optimiert wird und die an alle Abonnenten gesendeten Partitionen überprüft werden, wenn sich Daten in einer Partition ändern.

1 bedeutet, dass die Synchronisierung optimiert wird und nur Abonnenten betroffen sind, die über Zeilen in der geänderten Partition verfügen.

ms189475.note(de-de,SQL.90).gifHinweis:

Standardmäßig verwenden Mergepublikationen vorausberechnete Partitionen, die ein höheres Optimierungsmaß ermöglichen als diese Option. Weitere Informationen finden Sie unter Parametrisierte Zeilenfilter und Optimieren der Leistung parametrisierter Filter mithilfe vorausberechneter Partitionen.

allow_subscription_copy

int

Gibt an, ob die Möglichkeit zum Kopieren der Abonnementdatenbanken aktiviert wurde, die diese Publikation abonniert haben. 0 bedeutet, dass das Kopieren nicht zulässig ist.

allow_synctoalternate

int

Gibt an, ob ein alternativer Synchronisierungspartner für die Synchronisierung mit diesem Verleger zulässig ist. 0 bedeutet, dass ein alternativer 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. Dies hilft dabei, zu überprüfen, ob die Informationen bei jedem Mergeprozess konsistent partitioniert werden.

backward_comp_level

int

Der Datenbank-Kompatibilitätsgrad. Folgende Werte sind möglich:

10 = Microsoft SQL Server 7.0

20 = SQL Server 7.0 Service Pack 1

30 = SQL Server 7.0 Service Pack 2

35 = SQL Server 7.0 Service Pack 3

40 = Microsoft SQL Server 2000

50 = SQL Server 2000 Service Pack 1

60 = SQL Server 2000 Service Pack 3

90 = Microsoft SQL Server 2005

publish_to_activedirectory

bit

Gibt an, ob die Publikationsinformationen in Microsoft Active Directory veröffentlicht werden. 0 bedeutet, dass die Publikationsinformationen nicht in Active Directory verfügbar sind.

Dieser Parameter wurde als veraltet markiert und wird nur zum Sicherstellen der Abwärtskompatibilität von Skripts unterstützt. Sie können Publikationsinformationen nicht mehr zu Microsoft Active Directory hinzufügen.

max_concurrent_merge

int

Die Anzahl gleichzeitiger Mergeprozesse. Der Wert 0 bedeutet für diese Eigenschaft, dass es keine Beschränkung hinsichtlich der Anzahl gleichzeitiger Mergeprozesse gibt, die zu einem beliebigen angegebenen Zeitpunkt ausgeführt werden.

max_concurrent_dynamic_snapshots

int

Die maximale Anzahl gleichzeitiger Sitzungen für einen Snapshot gefilterter Daten, die für die Mergepublikation ausgeführt werden können. Ist dieser Wert 0, besteht keine Einschränkung für die maximale Anzahl gleichzeitiger Sitzungen für einen Snapshot gefilterter Daten, die für die Publikation ausgeführt werden können.

use_partition_groups

int

Gibt an, ob vorausberechnete Partitionen verwendet werden. 1 bedeutet, dass vorausberechnete Partitionen verwendet werden.

num_of_articles

int

Anzahl der Artikel in der Publikation.

replicate_ddl

int

Gibt an, ob Schemaänderungen an veröffentlichten Tabellen repliziert werden. 1 bedeutet, dass Schemaänderungen repliziert werden.

publication_number

smallint

Die Nummer, die dieser Publikation zugewiesen ist.

allow_subscriber_initiated_snapshot

bit

Gibt an, ob Abonnenten den Prozess für die Generierung eines Snapshots für gefilterte Daten initiieren können. 1 bedeutet, dass Abonnenten den Snapshotprozess initiieren können.

allow_web_synchronization

bit

Gibt an, ob die Publikation für die Websynchronisierung aktiviert ist. 1 bedeutet, dass die Websynchronisierung aktiviert ist.

web_synchronization_url

nvarchar(500)

Der für die Websynchronisierung verwendete Internet-URL.

allow_partition_realignment

bit

Gibt an, ob Löschvorgänge an den Abonnenten gesendet werden, wenn die Änderung der Zeile auf dem Verleger zum Ändern der Partition führt.

1 bedeutet, dass Löschvorgänge an den Abonnenten gesendet werden.

0 bedeutet, dass keine Löschvorgänge gesendet werden. Weitere Informationen finden Sie unter sp_addmergepublication

retention_period_unit

tinyint

Definiert die Einheit, die beim Definieren der Beibehaltung verwendet wird. Folgende Werte sind möglich:

0 = Tag

1 = Woche

2 = Monat

3 = Jahr

has_downloadonly_articles

bit

Gibt an, ob es sich bei Artikeln, die zur Publikation gehören, um nur downloadbare Artikel handelt. Ein Wert von 1 gibt an, dass es sich um nur downloadbare Artikel handelt.

decentralized_conflicts

int

Gibt an, ob die Konfliktdatensätze auf dem Abonnenten gespeichert werden, der den Konflikt verursacht hat.

0 = Die Konfliktdatensätze werden nicht auf dem Abonnenten gespeichert.

1 = Die Konfliktdatensätze werden auf dem Abonnenten gespeichert.

generation_leveling_threshold

int

Gibt die Anzahl der Änderungen an, die in einer Generierung enthalten sind. Eine Generierung ist eine Auflistung von Änderungen, die an einen Verleger oder Abonnenten übermittelt werden. Weitere Informationen finden Sie unter Funktionsweise der Nachverfolgung und der Enumeration bei der Mergereplikation.

automatic_reinitialization_policy

bit

Gibt an, ob Änderungen vom Abonnenten vor einer automatischen erneuten Initialisierung geuploadet werden.

1 = Änderungen werden vom Abonnenten vor einer automatischen erneuten Initialisierung geuploadet.

0 = Änderungen werden vor einer automatischen erneuten Initialisierung nicht geuploadet.

Hinweise

sp_helpmergepublication wird für die Mergereplikation verwendet.

Berechtigungen

Mitglieder der Publikationszugriffsliste für eine Publikation können sp_helpmergepublication für diese Publikation ausführen. Mitglieder der festen Datenbankrolle db_owner für die Publikationsdatenbank können sp_helpmergepublication für Informationen zu allen Publikationen ausführen.

Beispiel

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

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

Siehe auch

Verweis

sp_addmergepublication (Transact-SQL)
sp_changemergepublication (Transact-SQL)
sp_dropmergepublication (Transact-SQL)
Gespeicherte Replikationsprozeduren (Transact-SQL)

Andere Ressourcen

How to: View and Modify Publication Properties (Replication Transact-SQL Programming)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version Verlauf

12. Dezember 2006
Neuer Inhalt:
  • Informationen zur generation_leveling_threshold-Spalte wurden hinzugefügt.