sp_helppublication (Transact-SQL)
Gilt für:
SQL ServerAzure SQL Managed Instance
Gibt Informationen zu einer Veröffentlichung zurück. Bei einer Microsoft SQL Server-Veröffentlichung wird diese gespeicherte Prozedur auf dem Verleger in der 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.
Transact-SQL-Syntaxkonventionen
Syntax
sp_helppublication [ [ @publication = ] 'publication' ]
[ , [ @found=] found OUTPUT]
[ , [ @publisher = ] 'publisher' ]
Argumente
[ @publication = ] 'publication' Der Name der anzuzeigenden Veröffentlichung. publication ist sysname mit dem Standardwert , %der Informationen zu allen Veröffentlichungen zurückgibt.
[ @found = ] 'found' OUTPUT Ist ein Flag, das auf zurückgegebene Zeilen hinweist. Found ist int und ein OUTPUT-Parameter mit dem Standardwert 23456. 1 gibt an, dass die Veröffentlichung gefunden wurde. 0 gibt an, dass die Veröffentlichung nicht gefunden wurde.
[ @publisher = ] 'publisher'Gibt einen nicht SQL Server Herausgeber an. publisher ist sysname mit dem Standardwert NULL.
Hinweis
publisher sollte beim Anfordern von Veröffentlichungsinformationen von einem SQL Server Publisher nicht angegeben 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. 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 = Natives Massenkopierprogramm (bcp-Hilfsprogramm ) 1 = Massenkopieren von Zeichen 3 = Gleichzeitig, d. h., dass native Massenkopiervorgänge (bcp-Hilfsprogramm) verwendet werden, Tabellen jedoch während der Momentaufnahme 4 = Concurrent_c, d. h., dass das Massenkopieren von Zeichen verwendet wird, tabellen während der Momentaufnahme |
| description | nvarchar(255) | Optionale Beschreibung für die Veröffentlichung. |
| immediate_sync | bit | Gibt an, ob die Synchronisierungsdateien bei jeder Ausführung des Momentaufnahme-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 für diese Veröffentlichung ein eigenständiger Verteilungs-Agent vorhanden ist. |
| immediate_sync_ready | bit | Gibt an, ob der Momentaufnahme-Agent eine Momentaufnahme generiert, der zum Verwenden durch neue Abonnements bereitsteht. 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 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 die Veröffentlichung über keine Abonnements verfügt. |
| 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. Wenn 0, werden Änderungen am Abonnenten nicht in die Warteschlange eingereiht. |
| snapshot_in_defaultfolder | bit | Gibt an, ob Momentaufnahme Dateien im Standardordner gespeichert werden. Wenn 0, wurden Momentaufnahme Dateien an dem alternativen Speicherort gespeichert, der von alternate_snapshot_folder angegeben wird. Wenn 1, können Momentaufnahme 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 bei einem Abonnenten angewendet wird. |
| post_snapshot_script | nvarchar(255) | Gibt einen Zeiger auf einen SQL-Dateispeicherort an. Der Verteilungs-Agent führt das nach der Momentaufnahme 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 die Momentaufnahme, die in den alt_snapshot_folder Speicherort geschrieben wird, im Microsoft CAB-Format komprimiert werden soll. 0 gibt an, dass die Momentaufnahme nicht komprimiert wird. |
| ftp_address | sysname | Die Netzwerkadresse des FTP-Diensts für den Verteiler. 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 Verteiler. |
| ftp_subdirectory | nvarchar(255) | Gibt an, wo die Momentaufnahmedateien für den Verteilungs-Agent oder Merge-Agent eines Abonnenten zum Abholen verfügbar sind, wenn die Veröffentlichung das Weitergeben 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 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 = Konfliktdatensätze werden sowohl auf dem Herausgeber als auch auf dem Abonnenten gespeichert, der den Konflikt verursacht hat. 1 = 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 zur verzögerten Aktualisierung über eine Warteschlange verwendet wird. Einer der folgenden Werte ist möglich: 1 = Publisher gewinnt den Konflikt. 2 = Der Abonnent gewinnt den Konflikt. 3 = Das Abonnement wird neu initialisiert. |
| queue_type | Gibt an, welcher Wartenschlangentyp verwendet wird. Einer der folgenden Werte ist möglich: msmq = Verwenden Sie Microsoft Message Queuing zum Speichern von Transaktionen. sql = Verwenden Sie SQL Server zum Speichern von Transaktionen. Hinweis: Die Unterstützung für Message Queuing wurde eingestellt. |
|
| backward_comp_level | Der Datenbank-Kompatibilitätsgrad. Folgende Werte sind möglich: 90 = Microsoft SQL Server 2005 (9.x) 100 = Microsoft SQL Server 2008 (10.0.x) |
|
| publish_to_AD | bit | Gibt an, ob die Veröffentlichung in Microsoft Active Directory veröffentlicht wird. Der Wert 1 gibt an, dass es veröffentlicht wird, und der Wert 0 gibt an, 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 können. Weitere Informationen finden Sie unter Initialisieren eines Transaktionsabonnements ohne Momentaufnahme eines Transaktionsabonnents ohne Momentaufnahme. |
| replicate_ddl | int | Gibt an, ob die Schemareplikation für die Veröffentlichung unterstützt wird. 1 gibt an, dass DDL-Anweisungen (Data Definition Language), die auf 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 Veröffentlichung in einer Peer-zu-Peer-Replikationstopologie verwendet werden kann. 1 gibt an, dass die Veröffentlichung die Peer-zu-Peer-Replikation unterstützt. Weitere Informationen finden Sie unter Peer-to-Peer Transactional Replication. |
| 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 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 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. Der Wert 1 bedeutet, dass Konflikte erkannt werden. Weitere Informationen finden Sie unter Conflict Detection in Peer-to-Peer Replication. |
| 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 festgelegt ist. Zum Anzeigen einer Liste der bereits verwendeten IDs fragen Sie 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. Der Wert 1 bedeutet, dass der Agent weiterhin Änderungen verarbeitet. **Vorsicht** Es wird empfohlen, den Standardwert 0 zu verwenden. Wenn diese Option auf 1 festgelegt ist, versucht der Verteilungs-Agent, Daten in der Topologie zu konvergieren, indem die konfliktierende Zeile vom 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 Conflict Detection in Peer-to-Peer Replication. |
| allow_partition_switch | int | Gibt an, ob ALTER TABLE... SWITCH-Anweisungen können für die veröffentlichte Datenbank ausgeführt werden. 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, sollten in Abonnenten repliziert werden. Diese Option ist nur gültig, wenn allow_partition_switch auf 1 festgelegt ist. |
| enabled_for_p2p_lastwriter_conflictdetection | int | Ab SQL Server 2019 (15.x) CU 13 gibt an, ob die Verteilungs-Agent Konflikte mit dem letzten Writer für eine Veröffentlichung erkennt, die für die Peer-to-Peer-Replikation aktiviert ist. Der Wert 1 bedeutet, dass Konflikte mit dem letzten Writer erkannt werden. |
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Bemerkungen
sp_helppublication wird bei der Momentaufnahme- 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 [AdventureWorks2022]
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 einen Nicht-SQL Server Verleger können nur Mitglieder der festen Serverrolle sysadmin beim Verteiler oder Mitglieder der festen Datenbankrolle db_owner festen Datenbankrolle in der Verteilungsdatenbank oder Benutzer in der PAL sp_helppublication ausführen.
Weitere Informationen
Anzeigen und Ändern von Veröffentlichungseigenschaften
sp_addpublication (Transact-SQL)
sp_changepublication (Transact-SQL)
sp_droppublication (Transact-SQL)
Gespeicherte Replikationsprozeduren (Transact-SQL)
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für