sp_helpsubscription (Transact-SQL)

Artikel
05/07/2013

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.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @publication = ] 'publication'
Der Name der zugeordneten Veröffentlichung. publication ist vom Datentyp sysname. Mit dem Standardwert % werden alle Abonnementinformationen für diesen Server zurückgegeben.
[ @article= ] 'article'
Der Name des Artikels. article ist vom Datentyp sysname. Mit dem Standardwert % werden alle Abonnementinformationen für die ausgewählten Veröffentlichungen und Abonnenten zurückgegeben. Mit all wird für das vollständige Abonnement einer Veröffentlichung nur ein Eintrag zurückgegeben.
[ @subscriber= ] 'subscriber'
Der Name des Abonnenten, für den Abonnementinformationen abgerufen werden sollen. subscriber ist vom Datentyp sysname. Mit dem Standardwert % werden alle Abonnementinformationen für die ausgewählten Veröffentlichungen und Artikel zurückgegeben.
[ @destination_db= ] 'destination_db'
Der Name der Zieldatenbank. destination_db ist vom Datentyp sysname. Der Standardwert ist %.
[ @found= ] **'found'**OUTPUT
Ein Flag zur Angabe zurückgegebener Zeilen. foundist vom Datentyp int und ein OUTPUT-Parameter. Der Standardwert ist 23456.

1 zeigt an, dass die Veröffentlichung gefunden wurde.

0 zeigt an, dass die Veröffentlichung nicht gefunden wurde.
[ @publisher= ] 'publisher'
Der Name des Verlegers. publisher ist vom Datentyp sysname. Der Standardwert ist der Name des aktuellen Servers.

Hinweis

publisher sollte nur angegeben werden, wenn es sich um einen Oracle-Verleger handelt.

Hinweis
publisher sollte nur angegeben werden, wenn es sich um einen Oracle-Verleger handelt.

Resultsets

subscriber

sysname

Name des Abonnenten.

publication

sysname

Name der Veröffentlichung.

article

sysname

Der 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 = Pullabonnement

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 mit sofortigem Update

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 Bidirektionale Transaktionsreplikation.

offload_enabled

bit

Gibt an, ob festgelegt wurde, dass die Ausführung eines ausgelagerten Replikations-Agents auf dem Abonnenten ausgeführt wird.

Bei 0 wird der Agent auf dem Verleger ausgeführt.

Bei 1 wird der Agent auf dem Abonnenten ausgeführt.

offload_server

sysname

Name des Servers, der für die Aktivierung des Remote-Agents aktiviert ist. Bei einem Wert von NULL wird der aktuelle offload_server-Wert in der MSdistribution_agents-Tabelle verwendet.

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. Falls ein Paket vorhanden ist, gibt der Wert 0 die Speicherung des Pakets auf dem Verteiler an. Der Wert 1 gibt die Speicherung auf dem Abonnenten an.

subscriber_security_mode

smallint

Der Sicherheitsmodus auf dem Abonnenten. Dabei bezeichnet 1 die Windows-Authentifizierung und 0 die SQL Server-Authentifizierung.

subscriber_login

sysname

Der Anmeldename auf dem Abonnenten.

subscriber_password

Das tatsächliche Abonnentenkennwort wird nie zurückgegeben. Das Ergebnis ist durch die 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 ist durch die Zeichenfolge "******" maskiert.

distrib_agent_name

nvarchar(100)

Name des Agentauftrags, der das Abonnement synchronisiert.

subscriber_type

tinyint

Typ des Abonnenten. Folgende Werte sind möglich:

Wert	Beschreibung
0	SQL Server-Abonnent
1	ODBC-Datenquellenserver
2	Microsoft JET-Datenbank (als veraltet markiert)
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 einem OLE DB-Anbieter verwendet wird.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_helpsubscription wird bei der Momentaufnahme- und der 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 auf dem Verleger oder an Mitglieder der festen Datenbankrolle db_owner für die Veröffentlichungsdatenbank zurückgegeben.