sp_helpsubscription (Transact-SQL)

Gilt für: SQL Server Azure SQL Managed Instance

Listet Abonnementinformationen bezüglich einer bestimmten Veröffentlichung, eines Artikels, eines Abonnenten oder einer Gruppe von Abonnements auf. Diese gespeicherte Prozedur wird auf einem Verleger für die Veröffentlichungsdatenbank ausgeführt.

Transact-SQL-Syntaxkonventionen

Syntax

sp_helpsubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @destination_db = ] N'destination_db' ]
    [ , [ @found = ] found OUTPUT ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Argumente

[ @publication = ] N'Publikation'

Der Name der zugehörigen Publikation. @publication ist sysname mit einem Standardwert von %, der alle Abonnementinformationen für diesen Server zurückgibt.

[ @article = ] N'article'

Der Name des Artikels. @article ist sysname mit einem Standardwert von %, der alle Abonnementinformationen für die ausgewählten Publikationen und Abonnenten zurückgibt. Wenn allnur ein Eintrag für das vollständige Abonnement einer Publikation zurückgegeben wird.

[ @subscriber = ] N'subscriber'

Der Name des Abonnenten, zu dem Abonnementinformationen erhalten werden sollen. @subscriber ist sysname, mit einem Standardwert von %, der alle Abonnementinformationen für die ausgewählten Publikationen und Artikel zurückgibt.

[ @destination_db = ] N'destination_db'

Der Name der Zieldatenbank. @destination_db ist "sysname" mit der Standardeinstellung "%.

[ @found = ] ausgabe gefunden

Ein Kennzeichen, das angibt, dass Zeilen zurückgegeben werden. @found ist ein OUTPUT-Parameter vom Typ int.

  • 1 gibt an, dass die Publikation gefunden wird.
  • 0 gibt an, dass die Publikation nicht gefunden wurde.

[ @publisher = ] N'publisher'

Der Name des Herausgebers. @publisher ist "sysname" und standardmäßig auf den Namen des aktuellen Servers festgelegt.

@publisher sollte nicht angegeben werden, außer wenn es sich um einen Oracle Publisher handelt.

Resultset

Spaltenname Datentyp Beschreibung
subscriber sysname Name des Abonnenten.
publication sysname Name der Veröffentlichung.
article sysname Name des Artikels.
destination database sysname Name der Zieldatenbank, in der replizierte Daten gespeichert werden.
subscription status tinyint Abonnementstatus:

0 = Inaktiv
1 = Abonniert
2 = Aktiv
synchronization type tinyint Synchronisierungsart des Abonnements:

1 = Automatisch
2 = Keine
subscription type int Typ des Abonnements:

0 = Push
1 = Pull
2 = Anonym
full subscription bit Gibt an, ob alle Artikel in der Veröffentlichung abonniert werden:

0 = Nein
1 = Ja
subscription name nvarchar(255) Name des Abonnements.
update mode int 0 = Schreibgeschützt
1 = Abonnement zur sofortigen Aktualisierung
distribution job id binary(16) Auftrags-ID des Verteilungs-Agents.
loopback_detection bit Bestimmt, ob der Verteilungs-Agent Transaktionen des Abonnenten zurück an den Abonnenten sendet:

0 = Sendet zurück.
1 = Sendet nicht zurück.

Wird bei der bidirektionalen Transaktionsreplikation verwendet. Weitere Informationen finden Sie unter Bidirectional Transactional Replication.
offload_enabled bit Gibt an, ob die Offloadausführung eines Replikations-Agents für die Ausführung beim Abonnenten festgelegt ist.

Wenn 0, agent wird im Publisher ausgeführt.
If 1, agent is run at the Subscriber.
offload_server sysname Name des Servers, der für die Aktivierung des Remote-Agents aktiviert ist. Wenn NULLdie aktuelle offload_server, die in MSdistribution_agents Tabelle aufgeführt ist, verwendet wird.
dts_package_name sysname Gibt den Namen des DTS-Pakets (Data Transformation Services) an.
dts_package_location int Speicherort des DTS-Pakets, wenn dem Abonnement eines zugewiesen wurde. Wenn ein Paket vorhanden ist, gibt der Wert des 0 Paketspeicherorts an.distributor Ein Wert von 1 specifies the subscriber.
subscriber_security_mode smallint Ist der Sicherheitsmodus am Abonnenten, wo 1 bedeutet Windows-Authentifizierung und 0 bedeutet SQL Server-Authentifizierung.
subscriber_login sysname Der Anmeldename beim Abonnenten.
subscriber_password Das tatsächliche Abonnentenkennwort wird nie zurückgegeben. Das Ergebnis wird durch eine ****** Zeichenfolge maskiert.
job_login sysname Name des Windows-Kontos, unter dem der Verteilungs-Agent ausgeführt wird.
job_password Das tatsächliche Auftragskennwort wird nie zurückgegeben. Das Ergebnis wird durch eine ****** Zeichenfolge maskiert.
distrib_agent_name nvarchar(100) Name des Agentauftrags, der das Abonnement synchronisiert.
subscriber_type tinyint Typ des Abonnenten, der einen der folgenden Werte sein kann:

0 = SQL Server-Abonnent
1 = ODBC-Datenquellenserver
2 = Microsoft JET-Datenbank (veraltet)
3 = OLE DB-Anbieter
subscriber_provider sysname Eindeutiger Programmbezeichner (PROGID, Programmatic Identifier), mit dem der OLE DB-Anbieter für die Nicht-SQL Server-Datenquelle registriert wird.
subscriber_datasource nvarchar(4000) Name der Datenquelle im vom OLE DB-Anbieter unterstützten Format.
subscriber_providerstring nvarchar(4000) Für den OLE DB-Anbieter spezifische Verbindungszeichenfolge, die die Datenquelle identifiziert.
subscriber_location nvarchar(4000) Speicherort der Datenbank im vom OLE DB-Anbieter unterstützten Format.
subscriber_catalog sysname Katalog, der beim Herstellen einer Verbindung mit dem OLE DB-Anbieter verwendet werden soll.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Hinweise

sp_helpsubscription wird in der Momentaufnahme- und Transaktionsreplikation verwendet.

Berechtigungen

Die Ausführungsberechtigungen erhält standardmäßig die public -Rolle. Benutzern werden nur Informationen für Abonnements zurückgegeben, die sie erstellt haben. Informationen zu allen Abonnements werden an Mitglieder der festen Serverrolle "sysadmin " am Herausgeber oder an Mitglieder der db_owner festen Datenbankrolle in der Publikationsdatenbank zurückgegeben.