sp_helpsubscription (Transact-SQL)

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

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 Publikation. publication ist vom Datentyp sysname und hat den Standardwert %, mit dem alle Abonnementinformationen für diesen Server zurückgegeben werden.

• [ @article= ] 'article'
  Der Name des Artikels. article ist vom Datentyp sysname und hat den Standardwert %, mit dem alle Abonnementinformationen für die ausgewählten Publikationen und Abonnenten zurückgegeben werden. Mit all wird für das vollständige Abonnement einer Publikation nur ein Eintrag zurückgegeben.

• [ @subscriber= ] 'subscriber'
  Der Name des Abonnenten, zu dem Abonnementinformationen abgerufen werden sollen. subscriber ist vom Datentyp sysname und hat den Standardwert %, mit dem alle Abonnementinformationen für die ausgewählten Publikationen und Artikel zurückgegeben werden.

• [ @destination_db= ] 'destination_db'
  Der Name der Zieldatenbank. destination_db ist vom Datentyp sysname und hat den Standardwert %.

• [ @found= ] **'found'**OUTPUT
  Ein Flag zum Angeben zurückgegebener Zeilen. found ist vom Datentyp int und ein OUTPUT-Parameter mit dem Standardwert 23456.

  1 zeigt an, dass die Publikation gefunden wurde.

  0 zeigt an, dass die Publikation nicht gefunden wurde.

• [ @publisher= ] 'publisher'
  Der Name des Verlegers. publisher ist vom Datentyp sysname. Als Standardwert wird der Name des aktuellen Servers verwendet.

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

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname

Datentyp

Beschreibung

subscriber

sysname

Name des Abonnenten.

publication

sysname

Name der Publikation.

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 Publikation abonniert werden:

0 = Nein

1 = Ja

subscription name

nvarchar(255)

Name des Abonnements.

update mode

int

0 = Schreibgeschützt

1 = Abonnement mit sofortiger 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 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

0SQL Server-Abonnent

1ODBC-Datenquellenserver

2Microsoft JET-Datenbank (als veraltet markiert)

3OLE 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.

Hinweise

sp_helpsubscription wird bei der Snapshot- 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 Publikationsdatenbank zurückgegeben.

Siehe auch

Verweis

sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_dropsubscription (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005