sp_helpsubscription (Transact-SQL)

Artikel
04/26/2023

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 = ] 'publication' ]   
    [ , [ @article = ] 'article' ]  
    [ , [ @subscriber = ] 'subscriber' ]  
    [ , [ @destination_db = ] 'destination_db' ]   
    [ , [ @found=] found OUTPUT ]  
    [ , [ @publisher = ] 'publisher' ]

Argumente

[ @publication = ] 'publication' Der Name der zugeordneten Publikation. publication ist sysname, wobei der Standardwert lautet %, der alle Abonnementinformationen für diesen Server zurückgibt.

[ @article = ] 'article' Der Name des Artikels. der Artikel ist sysname mit dem Standardwert , %der alle Abonnementinformationen für die ausgewählten Publikationen und Abonnenten zurückgibt. Wenn alle, wird nur ein Eintrag für das vollständige Abonnement für eine Veröffentlichung zurückgegeben.

[ @subscriber = ] 'subscriber' Der Name des Abonnenten, für den Abonnementinformationen abgerufen werden sollen. Subscriber ist sysname, wobei der Standardwert von %ist. Dadurch werden alle Abonnementinformationen für die ausgewählten Publikationen und Artikel zurückgegeben.

[ @destination_db = ] 'destination_db' Der Name der Zieldatenbank. destination_db ist sysname, wobei der Standardwert lautet %.

[ @found = ] 'found'OUTPUT Ist ein Flag, das auf zurückgegebene Zeilen hinweist. foundist 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' Der Name des Verlegers. publisher ist sysname und wird standardmäßig auf den Namen des aktuellen Servers festgelegt.

Hinweis

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

Resultsets

Spaltenname	Datentyp	BESCHREIBUNG
subscriber	sysname	Name des Abonnenten.
Veröffentlichung	sysname	Name der Veröffentlichung.
Artikel	sysname	Name des Artikels.
Zieldatenbank	sysname	Name der Zieldatenbank, in der replizierte Daten gespeichert werden.
Abonnementstatus	tinyint	Abonnementstatus: 0 = Inaktiv 1 = Abonniert 2 = Aktiv
Synchronisierungstyp	tinyint	Synchronisierungsart des Abonnements: 1 = Automatisch 2 = Keine
Abonnementtyp	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
Abonnementname	nvarchar(255)	Name des Abonnements.
Updatemodus	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 = Wird nicht zurück gesendet. Wird bei der bidirektionalen Transaktionsreplikation verwendet. Weitere Informationen finden Sie unter Bidirectional Transactional Replication.
offload_enabled	bit	Gibt an, ob festgelegt wurde, dass die Ausführung eines ausgelagerten Replikations-Agents auf dem Abonnenten ausgeführt wird. Wenn 0, wird der Agent auf dem Verleger ausgeführt. Wenn 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 NULL wird der aktuelle offload_server verwendet, der in MSdistribution_agents Tabelle aufgeführt ist.
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 0 den Paketspeicherort am Verteiler an. Der Wert 1 gibt den Abonnenten an.
subscriber_security_mode	smallint	Ist der Sicherheitsmodus auf dem Abonnenten, wobei 1 windows-Authentifizierung und 0 SQL Server Authentifizierung bedeutet.
subscriber_login	sysname	Der Anmeldename auf dem 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. Folgende Werte sind möglich: 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 (Erfolg) oder 1 (Fehler)

Bemerkungen

sp_helpsubscription wird bei der Momentaufnahme- und Transaktionsreplikation verwendet.

Berechtigungen

Ausführen von Berechtigungen ist standardmäßig die öffentliche 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 im Verleger oder an Mitglieder der festen Datenbankrolle db_owner festen Datenbankrolle in der Veröffentlichungsdatenbank zurückgegeben.

Weitere Informationen

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