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 = Transaktional1 = Momentaufnahme |
synchronization method |
tinyint | Synchronisierungsmethode:0 = Systemeigenes Massenkopieprogramm (bcp-Hilfsprogramm )1 = Massenkopie des Zeichens3 = Gleichzeitig, d. h., dass systemeigene Massenkopie (bcp utility) verwendet wird, Tabellen während der Momentaufnahme jedoch nicht gesperrt sind4 = 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
.