sp_helpsubscription (Transact-SQL)
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.
.gif "Themenlink (Symbol)")
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 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 Veröffentlichungen und Abonnenten zurückgegeben werden. Mit all wird für das vollständige Abonnement einer Veröffentlichung 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 Veröffentlichungen 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 zur Angabe zurückgegebener Zeilen. found ist vom Datentyp int und ein OUTPUT-Parameter mit dem Standardwert 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. Als Standardwert wird der Name des aktuellen Servers verwendet..gif "Hinweis")
Hinweispublisher sollte nur angegeben werden, wenn es sich um einen Oracle-Verleger handelt.
Resultsets
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 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:
WertBeschreibung
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. |
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
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 Veröffentlichungsdatenbank zurückgegeben.