sp_helppublication (Transact-SQL)
Gibt Informationen zu einer Veröffentlichung zurück. Bei einer Veröffentlichung für MicrosoftSQL Server wird diese gespeicherte Prozedur auf dem Verleger für die Veröffentlichungsdatenbank ausgeführt. Bei einer Veröffentlichung für Oracle wird diese gespeicherte Prozedur auf dem Verteiler für eine beliebige Datenbank ausgeführt.
.gif "Themenlink (Symbol)")
Syntax
sp_helppublication [ [ @publication = ] 'publication' ]
[ , [ @found=] found OUTPUT]
[ , [ @publisher = ] 'publisher' ]
Argumente
[ @publication=] 'publication'
Der Name der Veröffentlichung, die angezeigt werden soll. publication ist vom Datentyp sysname und hat den Standardwert %, mit dem Informationen zu allen Veröffentlichungen zurückgegeben werden.[ @found = ] 'found' OUTPUT
Ein Flag zum Anzeigen zurückgegebener Zeilen. found ist vom Datentyp int und ein OUTPUT-Parameter mit dem Standardwert 23456. 1 zeigt an, dass die Veröffentlichung gefunden wurde. 0 bedeutet, dass die Veröffentlichung nicht gefunden wurde.[ @publisher= ] 'publisher'
Gibt einen Nicht-SQL Server-Verleger an. publisher ist vom Datentyp sysname und hat den Standardwert NULL..gif "Hinweis")
Hinweispublisher sollte nicht angegeben werden, wenn Veröffentlichungsinformationen von einem SQL Server-Verleger angefordert werden.
Resultsets
Spaltenname |
Datentyp |
Beschreibung |
|---|---|---|
pubid |
int |
ID für die Veröffentlichung. |
name |
sysname |
Name der Veröffentlichung. |
restricted |
int |
Nur für Informationszwecke identifiziert. Nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt. |
status |
tinyint |
Der aktuelle Status der Veröffentlichung. 0 = Inaktiv. 1 = Aktiv. |
task |
|
Dieser Parameter wird aus Gründen der Abwärtskompatibilität verwendet. |
replication frequency |
tinyint |
Art der Replikationshäufigkeit: 0 = Transaktionsreplikation 1 = Snapshotreplikation |
synchronization method |
tinyint |
Synchronisierungsmethode: 0 = Systemeigenes Massenkopierprogramm (Dienstprogramm bcp) 1 = Massenkopieren von Zeichen 3 = Gleichzeitig (Concurrent). Dies bedeutet, dass das systemeigene Massenkopieren (Dienstprogramm bcp) verwendet wird, die Tabellen jedoch während des Snapshots nicht gesperrt werden. 4 = Gleichzeitig und zeichenbasiert (Concurrent_c). Dies bedeutet, dass das Massenkopieren von Zeichen verwendet wird, die Tabellen jedoch während des Snapshots nicht gesperrt werden. |
description |
nvarchar(255) |
Optionale Beschreibung für die Veröffentlichung. |
immediate_sync |
bit |
Gibt an, ob die Synchronisierungsdateien bei jeder Ausführung des Snapshot-Agents erstellt oder neu erstellt werden. |
enabled_for_internet |
bit |
Gibt an, ob die Synchronisierungsdateien für die Veröffentlichung im Internet über FTP (File Transfer Protocol) oder andere Dienste bereitgestellt werden. |
allow_push |
bit |
Gibt an, ob Pushabonnements für die Veröffentlichung zulässig sind. |
allow_pull |
bit |
Gibt an, ob Pullabonnements für die Veröffentlichung zulässig sind. |
allow_anonymous |
bit |
Gibt an, ob anonyme Abonnements für die Veröffentlichung zulässig sind. |
independent_agent |
bit |
Gibt an, ob ein eigenständiger Verteilungs-Agent für diese Veröffentlichung vorhanden ist. |
immediate_sync_ready |
bit |
Gibt an, ob der Snapshot-Agent einen Snapshot generiert, der zum Verwenden durch neue Abonnements bereitsteht. Dieser Parameter wird nur definiert, wenn die Veröffentlichung so festgelegt ist, dass sie immer einen Snapshot für neue oder neu initialisierte Abonnements zur Verfügung hat. |
allow_sync_tran |
bit |
Gibt an, ob sofort aktualisierbare Abonnements für die Veröffentlichung zulässig sind. |
autogen_sync_procs |
bit |
Gibt an, ob gespeicherte Prozeduren automatisch generiert werden sollen, um sofort aktualisierbare Abonnements zu unterstützen. |
snapshot_jobid |
binary(16) |
ID für geplanten Task. |
retention |
int |
Der Änderungsumfang (in Stunden), der für die angegebene Veröffentlichung eingespart werden soll. |
has subscription |
bit |
Gibt an, ob die Veröffentlichung über aktive Abonnements verfügt. 1 bedeutet, dass die Veröffentlichung über aktive Abonnements verfügt, und 0 bedeutet, dass für die Veröffentlichung keine Abonnements vorhanden sind. |
allow_queued_tran |
bit |
Gibt an, ob das Hinzufügen von Änderungen beim Abonnenten zu Warteschlangen, bis diese beim Verleger zugeordnet werden können, aktiviert wurde. Bei 0 werden Änderungen auf dem Abonnenten nicht in eine Warteschlange eingereiht. |
snapshot_in_defaultfolder |
bit |
Gibt an, ob Snapshotdateien im Standardordner gespeichert werden. Bei 0 wurden die Snapshotdateien an einem alternativen Speicherort gespeichert, der durch alternate_snapshot_folder angegeben wird. Bei 1 befinden sich die Snapshotdateien im Standardordner. |
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 einen Speicherort fürSQL-Dateien an. Der Verteilungs-Agent führt das vor dem Snapshot ausgeführte Skript vor allen Skripts für replizierte Objekte aus, wenn der Snapshot bei einem Abonnenten angewendet wird. |
post_snapshot_script |
nvarchar(255) |
Gibt einen Zeiger auf einen Speicherort fürSQL-Dateien an. Der Verteilungs-Agent führt das nach dem Snapshot ausgeführte Skript aus, nachdem alle anderen Skripts für replizierte Objekte und Daten während der Erstsynchronisierung angewendet wurden. |
compress_snapshot |
bit |
Gibt an, dass der Snapshot, der an den Speicherort alt_snapshot_folder geschrieben wurde, in das CAB-Format für Microsoft komprimiert werden soll. 0 gibt an, dass der Snapshot nicht komprimiert wird. |
ftp_address |
sysname |
Die Netzwerkadresse des FTP-Diensts für den Verteiler. Gibt an, wo die Veröffentlichungssnapshotdateien für den Verteilungs-Agent oder Merge-Agent eines Abonnenten zum Abholen gespeichert sind. |
ftp_port |
int |
Die Nummer des Anschlusses für den FTP-Dienst des Verteilers. |
ftp_subdirectory |
nvarchar(255) |
Gibt an, wo die Snapshotdateien für den Verteilungs-Agent oder Merge-Agent eines Abonnenten zum Abholen verfügbar sind, wenn die Veröffentlichung das Weitergeben von Snapshots mithilfe von FTP unterstützt. |
ftp_login |
sysname |
Der Benutzername, mit dem eine Verbindung zum FTP-Dienst hergestellt wird. |
allow_dts |
bit |
Gibt an, dass die Veröffentlichung Datentransformationen zulässt. 0 gibt an, dass DTS-Transformationen nicht zulässig sind. |
allow_subscription_copy |
bit |
Gibt an, ob die Möglichkeit zum Kopieren der Abonnementdatenbanken aktiviert wurde, die diese Veröffentlichung abonniert haben. 0 bedeutet, dass das Kopieren nicht zulässig ist. |
centralized_conflicts |
bit |
Gibt an, ob Konfliktdatensätze auf dem Verleger gespeichert werden. 0 = Die Konfliktdatensätze werden sowohl auf dem den Konflikt verursachenden Verleger als auch auf dem Abonnenten gespeichert. 1 = Die Konfliktdatensätze werden auf dem Verleger gespeichert. |
conflict_retention |
int |
Gibt die Konfliktaufbewahrungsdauer in Tagen an. |
conflict_policy |
int |
Gibt die Richtlinie zur Konfliktlösung an, die für die Option zum verzögerten Aktualisieren des Abonnenten über eine Warteschlange verwendet wird. Kann einen der folgenden Werte annehmen: 1 = Der Verleger gewinnt den Konflikt. 2 = Der Abonnent gewinnt den Konflikt. 3 = Das Abonnement wird erneut initialisiert. |
queue_type |
|
Gibt an, welcher Wartenschlangentyp verwendet wird. Kann einen der folgenden Werte annehmen: msmq = Zum Speichern von Transaktionen wird Microsoft Message Queuing verwendet. sql = Zum Speichern von Transaktionen wird SQL Server verwendet. Hinweis
Message Queuing wird nicht mehr unterstützt.
|
backward_comp_level |
|
Datenbank-Kompatibilitätsgrad, der einen der folgenden Werte haben kann: 10 = MicrosoftSQL 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 = MicrosoftSQL Server 2000 50 = SQL Server 2000 Service Pack 1 60 = SQL Server 2000 Service Pack 3 90 = MicrosoftSQL Server 2005 100 = MicrosoftSQL Server 2008 |
publish_to_AD |
bit |
Gibt an, ob die Veröffentlichung in Microsoft Active Directory™ veröffentlicht wird. Durch den Wert 1 wird angegeben, dass sie veröffentlicht wird, während der Wert 0 angibt, dass sie nicht veröffentlicht wird. |
allow_initialize_from_backup |
bit |
Gibt an, ob Abonnenten ein Abonnement für diese Veröffentlichung über eine Sicherung anstelle eines Anfangssnapshots initialisieren können. 1 bedeutet, dass Abonnements über eine Sicherung initialisiert werden können. 0 bedeutet, dass dies nicht möglich ist. Weitere Informationen finden Sie unter Initialisieren eines Transaktionsabonnements ohne Snapshot. |
replicate_ddl |
int |
Gibt an, ob die Schemareplikation für die Veröffentlichung unterstützt wird. 1 gibt an, dass auf dem Verleger ausgeführte DDL-Anweisungen (Data Definition Language, Datendefinitionssprache) repliziert werden. 0 gibt an, dass DDL-Anweisungen nicht repliziert werden. Weitere Informationen finden Sie unter Vornehmen von Schemaänderungen in Veröffentlichungsdatenbanken. |
enabled_for_p2p |
int |
Gibt an, ob die Veröffentlichung in einer Peer-to-Peer-Replikationstopologie verwendet werden kann. 1 gibt an, dass die Veröffentlichung die Peer-to-Peer-Replikation unterstützt. Weitere Informationen finden Sie unter Peer-to-Peer-Transaktionsreplikation. |
publish_local_changes_only |
int |
Nur für Informationszwecke identifiziert. Nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt. |
enabled_for_het_sub |
int |
Gibt an, ob die Veröffentlichung Nicht-SQL Server-Abonnenten unterstützt. Der Wert 1 bedeutet, dass Nicht-SQL Server-Abonnenten unterstützt werden. Der Wert 0 bedeutet, dass nur SQL Server-Abonnenten unterstützt werden. Weitere Informationen finden Sie unter Nicht-SQL Server-Abonnenten. |
enabled_for_p2p_conflictdetection |
int |
Gibt an, ob der Verteilungs-Agent Konflikte für eine Veröffentlichung erkennt, die für die Peer-to-Peer-Replikation aktiviert ist. Der Wert 1 bedeutet, dass Konflikte erkannt werden. Weitere Informationen finden Sie unter Konflikterkennung bei der Peer-to-Peer-Replikation. |
originator_id |
int |
Gibt eine ID für einen Knoten in einer Peer-to-Peer-Topologie an. Diese ID wird für die Konflikterkennung verwendet, wenn enabled_for_p2p_conflictdetection auf 1 festgelegt ist. Fragen Sie zum Anzeigen einer Liste der bereits verwendeten IDs die Mspeer_originatorid_history-Systemtabelle ab. |
p2p_continue_onconflict |
int |
Gibt an, ob der Verteilungs-Agent bei Erkennung eines Konflikts die Verarbeitung von Änderungen fortsetzt. Die Angabe des Werts 1 bedeutet, dass der Agent die Verarbeitung von Änderungen fortsetzt. .gif "Vorsichtshinweis") Vorsicht
Es wird empfohlen, den Standardwert 0 zu verwenden. Wenn diese Option auf 1 festgelegt wird, versucht der Verteilungs-Agent, die Datenkonvergenz in der Topologie herbeizuführen, indem die konfliktverursachende Zeile von dem Knoten mit der höchsten Absender-ID angewendet wird. Bei dieser Methode ist keine Konvergenz garantiert. Sie sollten sicherstellen, dass die Topologie nach der Erkennung eines Konflikts konsistent ist. Weitere Informationen finden Sie im Abschnitt "Konfliktbehandlung" unter Konflikterkennung bei der Peer-to-Peer-Replikation.
|
alllow_partition_switch |
int |
Gibt an, ob ALTER TABLE…SWITCH-Anweisungen für die veröffentlichte Datenbank ausgeführt werden können. Weitere Informationen finden Sie unter Replizieren partitionierter Tabellen und Indizes. |
replicate_partition_switch |
int |
Gibt an, ob ALTER TABLE…SWITCH-Anweisungen, die für die veröffentlichte Datenbank ausgeführt werden, auf Abonnenten repliziert werden sollen. Diese Option ist nur gültig, wenn allow_partition_switch auf 1 festgelegt wurde. |
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Hinweise
sp_helppublication wird bei der Snapshot- und Transaktionsreplikation verwendet.
sp_helppublication gibt Informationen zu allen Veröffentlichungen zurück, die sich im Besitz des Benutzers befinden, der diese Prozedur ausführt.
Beispiel
DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran'
USE [AdventureWorks]
EXEC sp_helppublication @publication = @myTranPub
GO
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin auf dem Verleger bzw. Mitglieder der festen Datenbankrolle db_owner in der Veröffentlichungsdatenbank bzw. Benutzer in der Veröffentlichungszugriffsliste können sp_helppublication ausführen.
Für Nicht-SQL Server-Verleger können nur Mitglieder der festen Serverrolle sysadmin auf dem Verteiler bzw. Mitglieder der festen Datenbankrolle db_owner in der Verteilungsdatenbank bzw. Benutzer in der Veröffentlichungszugriffsliste sp_helppublication ausführen.