sp_helppublication (Transact-SQL)

Gilt für: SQL Server Azure SQL Managed Instance

Gibt Informationen zu einer Veröffentlichung zurück. Für eine SQL Server-Publikation wird diese gespeicherte Prozedur in Publisher in der Publikationsdatenbank ausgeführt. Bei einer Veröffentlichung für Oracle wird diese gespeicherte Prozedur auf dem Verteiler für eine beliebige Datenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_helppublication_snapshot
    [ @publication = ] N'publication'
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Argumente

[ @publication = ] N'Publikation'

Der Name der zu sehenden Publikation. @publication ist "sysname" mit dem Standardwert "%, der Informationen zu allen Publikationen zurückgibt.

[ @publisher = ] N'publisher'

Gibt einen Nicht-SQL Server-Herausgeber an. @publisher ist "sysname" mit der Standardeinstellung "NULL.

Hinweis

Publisher sollte nicht angegeben werden, wenn Publikationsinformationen von einem SQL Server-Herausgeber angefordert werden.

Resultset

Spaltenname Datentyp BESCHREIBUNG
pubid int ID für die Veröffentlichung.
name sysname Name der Veröffentlichung.
restricted int Nur für Informationszwecke identifiziert. Wird 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 = Transaktional
1 = Momentaufnahme
synchronization method tinyint Synchronisierungsmethode:

0 = Systemeigenes Massenkopieprogramm (bcp-Hilfsprogramm )
1 = Massenkopie des Zeichens
3 = Gleichzeitig, d. h., dass systemeigene Massenkopie (bcp utility) verwendet wird, Tabellen während der Momentaufnahme jedoch nicht gesperrt sind
4 = Concurrent_c, was bedeutet, dass die Massenkopie des Zeichens verwendet wird, tabellen während der Momentaufnahme jedoch nicht gesperrt sind
description nvarchar(255) Optionale Beschreibung für die Veröffentlichung.
immediate_sync bit Gibt an, ob die Synchronisierungsdateien bei jeder Ausführung der Momentaufnahmen-Agent erstellt oder neu erstellt werden.
enabled_for_internet bit Gibt an, ob die Synchronisierungsdateien für die Publikation über das Dateiübertragungsprotokoll (FTP) und andere Dienste für das Internet verfügbar gemacht werden.
allow_push bit Gibt an, ob Pushabonnements für die Publikation zulässig sind.
allow_pull bit Gibt an, ob Pullabonnements für die Publikation zulässig sind.
allow_anonymous bit Gibt an, ob anonyme Abonnements für die Publikation zulässig sind.
independent_agent bit Gibt an, ob für diese Publikation eine eigenständige Verteilungs-Agent vorhanden ist.
immediate_sync_ready bit Gibt an, ob die Momentaufnahmen-Agent eine Momentaufnahme generiert hat, die von neuen Abonnements verwendet werden kann. Dieser Parameter wird nur definiert, wenn die Veröffentlichung so festgelegt ist, dass sie immer eine Momentaufnahme für neue oder neu initialisierte Abonnements zur Verfügung hat.
allow_sync_tran bit Gibt an, ob Abonnements mit sofortiger Aktualisierung für die Veröffentlichung zulässig sind.
autogen_sync_procs bit Gibt an, ob gespeicherte Prozeduren automatisch generiert werden sollen, um Abonnements sofort zu aktualisieren.
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 Publikation über ein aktives Abonnement verfügt. 1 bedeutet, dass die Publikation über aktive Abonnements verfügt und 0 bedeutet, dass die Publikation keine Abonnements hat.
allow_queued_tran bit Gibt an, ob die Warteschlange von Änderungen am Abonnenten deaktiviert wird, bis sie beim Publisher aktiviert werden können. Wenn 0änderungen am Abonnenten nicht in die Warteschlange gestellt werden.
snapshot_in_defaultfolder bit Gibt an, ob Snapshotdateien im Standardordner gespeichert werden. If 0, snapshot files are stored in the alternate location specified by alternate_snapshot_folder. Wenn 1, Snapshot-Dateien im Standardordner gefunden 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 einen .sql Dateispeicherort an. Der Verteilungs-Agent führt das vor der Momentaufnahme ausgeführte Skript vor allen Skripts für replizierte Objekte aus, wenn die Momentaufnahme auf einem Abonnenten angewendet wird.
post_snapshot_script nvarchar(255) Gibt einen Zeiger auf einen .sql Dateispeicherort an. Die Verteilungs-Agent führt das Skript nach der Momentaufnahme aus, 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 werden soll. 0 Gibt an, dass die Momentaufnahme nicht komprimiert ist.
ftp_address sysname Die Netzwerkadresse des FTP-Diensts für den Distributor. Gibt an, wo die Veröffentlichungsmomentaufnahmedateien für den Verteilungs-Agent oder Merge-Agent eines Abonnenten zum Abholen gespeichert sind.
ftp_port int Die Portnummer des FTP-Diensts für den Distributor.
ftp_subdirectory nvarchar(255) Gibt an, wo die Momentaufnahmedateien für die Verteilungs-Agent oder Merge-Agent des Abonnenten verfügbar sind, um aufzunehmen, wenn die Publikation das Verteilen von Momentaufnahmen mithilfe von FTP unterstützt.
ftp_login sysname Der Benutzername, der zum Herstellen einer Verbindung mit dem FTP-Dienst verwendet 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, die diese Publikation abonnieren, aktiviert ist. 0 bedeutet, dass das Kopieren nicht zulässig ist.
centralized_conflicts bit Gibt an, ob Konfliktdatensätze auf dem Verleger gespeichert werden:

0 = Konfliktdatensätze werden sowohl beim Herausgeber als auch beim Abonnent gespeichert, der den Konflikt verursacht hat.
1 = Konfliktdatensätze werden im Publisher 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 zur verzögerten Aktualisierung über eine Warteschlange verwendet wird. Einer der folgenden Werte ist möglich:

1 = Publisher gewinnt den Konflikt.
2 = Abonnent gewinnt den Konflikt.
3 = Abonnement wird neu initialisiert.
queue_type Gibt an, welcher Wartenschlangentyp verwendet wird. Einer der folgenden Werte ist möglich:

msmq = Verwenden von Microsoft Message Queuing zum Speichern von Transaktionen.
sql = Verwenden von SQL Server zum Speichern von Transaktionen.
Hinweis: Der Support für Message Queuing wird nicht mehr unterstützt.
backward_comp_level Datenbankkompatibilitätsstufe und kann einer der folgenden Werte sein:

90 = SQL Server 2005 (9.x)
100 = Microsoft SQL Server 2008 (10.0.x)
publish_to_AD bit Gibt an, ob die Publikation im Microsoft Active Directory veröffentlicht wird. Ein Wert, der 1 angibt, dass er veröffentlicht wird, und ein Wert, der 0 angibt, dass er nicht veröffentlicht wird.
allow_initialize_from_backup bit Gibt an, ob Abonnenten ein Abonnement für diese Veröffentlichung über eine Sicherung anstelle einer Anfangsmomentaufnahme initialisieren können. 1 bedeutet, dass Abonnements aus einer Sicherung initialisiert werden können und 0 bedeutet, dass sie nicht möglich sind. Weitere Informationen finden Sie unter Initialisieren eines Transaktionsabonnements ohne Momentaufnahme eines transaktionsbasierten Abonnenten ohne Momentaufnahme.
replicate_ddl int Gibt an, ob die Schemareplikation für die Publikation unterstützt wird. 1 gibt an, dass DDL-Anweisungen (Data Definition Language), die an dem Herausgeber ausgeführt werden, repliziert werden, und 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 Publikation in einer Peer-to-Peer-Replikationstopologie verwendet werden kann. 1 gibt an, dass die Publikation 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. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.
enabled_for_het_sub int Gibt an, ob die Publikation Nicht-SQL Server-Abonnenten unterstützt. Ein Wert von 1 bedeutet, dass Nicht-SQL Server-Abonnenten unterstützt werden. Ein Wert von 0 bedeutet, dass nur SQL Server-Abonnenten unterstützt werden. Weitere Informationen finden Sie unter Non-SQL Server Subscribers.
enabled_for_p2p_conflictdetection int Gibt an, ob der Verteilungs-Agent Konflikte für eine Veröffentlichung erkennt, die für die Peer-zu-Peer-Replikation aktiviert ist. Ein Wert von 1 bedeutet, dass Konflikte erkannt werden. Weitere Informationen finden Sie unter Peer-to-Peer - Konflikterkennung in peer-to-Peer-Replikation.
originator_id int Gibt eine ID für einen Knoten in einer Peer-zu-Peer-Topologie an. Diese ID wird für die Konflikterkennung verwendet, wenn enabled_for_p2p_conflictdetection auf 1. Fragen Sie für eine 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. Ein Wert von 1 bedeutet, dass der Agent weiterhin Änderungen verarbeitet.

Achtung: Es wird empfohlen, den Standardwert von 0. Wenn diese Option auf 1 festgelegt ist, versucht die Verteilungs-Agent, Daten in der Topologie zu konvergenieren, indem die konfliktierende Zeile vom Knoten angewendet wird, der die höchste Absender-ID ist. Diese Methode garantiert keine Konvergenz. Sie sollten sicherstellen, dass die Topologie nach der Erkennung eines Konflikts konsistent ist. Weitere Informationen finden Sie unter "Handling Conflicts" in Peer-to-Peer – Conflict Detection in Peer-to-Peer-Replikation.
allow_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 Replicate Partitioned Tables and Indexes.
replicate_partition_switch int Gibt an, ob ALTER TABLE...SWITCH Anweisungen, die für die veröffentlichte Datenbank ausgeführt werden, in Abonnenten repliziert werden sollen. Diese Option ist nur gültig, wenn allow_partition_switch sie auf 1.
enabled_for_p2p_lastwriter_conflictdetection int Gibt an, ob die Verteilungs-Agent erkennt Konfigurieren von Konflikterkennungs- und Auflösungskonflikten für eine Publikation, die für die Peer-zu-Peer-Replikation aktiviert ist. Ein Wert von 1 bedeutet, dass letzte Writer-Konflikte erkannt werden.

Gilt für: SQL Server 2019 (15.x) CU 13 und höher.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_helppublication wird in der Momentaufnahme- und Transaktionsreplikation verwendet.

sp_helppublication gibt Informationen zu allen Publikationen zurück, die dem Benutzer gehören, der dieses Verfahren ausführt.

Beispiele

DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran' 

USE [AdventureWorks2022]
EXEC sp_helppublication @publication = @myTranPub
GO

Berechtigungen

Es können nur Mitglieder der festen Serverrolle "sysadmin " im Publisher oder in den Mitgliedern der db_owner festen Datenbankrolle in der Publikationsdatenbank oder Benutzer in der Publikationszugriffsliste (PAL) ausgeführt werden sp_helppublication.

Bei einem Nicht-SQL Server-Herausgeber können nur Mitglieder der festen Serverrolle "sysadmin " beim Distributor oder den Mitgliedern der db_owner festen Datenbankrolle in der Verteilungsdatenbank oder Benutzern in der PAL ausgeführt werden sp_helppublication.