sys.sp_helpsubscription (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Geeft abonnementsinformatie over die verbonden is aan een bepaalde publicatie, artikel, abonnee of set abonnementen. Deze opgeslagen procedure wordt uitgevoerd bij een Publisher in de publicatiedatabase.

Transact-SQL syntaxis-conventies

Syntax

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

Arguments

[ @publication = ] N'publicatie'

De naam van de bijbehorende publicatie. @publication is sysname, met standaard , %wat alle abonnementsinformatie voor deze server teruggeeft.

[ @article = ] N'artikel'

De naam van het artikel. @article is systeemnaam, met standaard %, wat alle abonnementsinformatie teruggeeft voor de geselecteerde publicaties en abonnees. Als all, wordt slechts één vermelding teruggegeven voor het volledige abonnement op een publicatie.

[ @subscriber = ] N'abonnee'

De naam van de abonnee waarop abonnementsinformatie verkrijgt kan worden. @subscriber is systeemnaam, met standaard , %wat alle abonnementsinformatie voor de geselecteerde publicaties en artikelen teruggeeft.

[ @destination_db = ] N'destination_db'

De naam van de bestemmingsdatabase. @destination_db is een systeemnaam, met standaard .%

[ @found = ] gevonden UITVOER

Een vlag die aangeeft dat rijen worden geretourneerd. @found is een OUTPUT parameter van type int.

  • 1 geeft aan dat de publicatie is gevonden.
  • 0 geeft aan dat de publicatie niet is gevonden.

[ @publisher = ] N'uitgever'

De naam van de uitgever. @publisher is sysname en standaard de naam van de huidige server.

@publisher mag niet worden gespecificeerd, behalve als het een Oracle Publisher is.

Resultaatset

Kolomnaam Gegevenstype Description
subscriber sysname Naam van de abonnee.
publication sysname Naam van de publicatie.
article sysname Naam van het artikel.
destination database sysname Naam van de bestemmingsdatabase waarin gerepliceerde data wordt geplaatst.
subscription status tinyint Abonnementsstatus:

0 = Inactief
1 = Geabonneerd
2 = Actief
synchronization type tinyint Type abonnementssynchronisatie:

1 = Automatisch
2 = Geen
subscription type int Soort abonnement:

0 = Duw
1 = Trek
2 = Anoniem
full subscription bit Of er een abonnement geldt voor alle artikelen in de publicatie:

0 = Nee
1 = Ja
subscription name nvarchar(255) Naam van het abonnement.
update mode int 0 = Alleen-lezen
1 = Abonnement met directe updates
distribution job id binary(16) Job ID van de Distribution Agent.
loopback_detection bit Loopback-detectie bepaalt of de Distribution Agent transacties die bij de abonnee zijn ontstaan terugstuurt naar de abonnee:

0 = Stuurt terug.
1 = Stuurt niet terug.

Gebruikt met bidirectionele transactionele replicatie. Zie Bidirectionele transactionele replicatie voor meer informatie.
offload_enabled bit Geeft aan of de offload-uitvoering van een replicatieagent is ingesteld om te draaien bij de abonnee.

Als 0, wordt agent beheerd bij de Publisher.
Als 1, wordt agent uitgevoerd bij de abonnee.
offload_server sysname Naam van de server ingeschakeld voor externe agentactivatie. Als NULL, dan wordt de huidige offload_server in MSdistribution_agents tabel gebruikt.
dts_package_name sysname Specificeert de naam van het Data Transformation Services (DTS)-pakket.
dts_package_location int Locatie van het DTS-pakket, als er een aan het abonnement is toegewezen. Als er een pakket is, specificeert een waarde van 0 de pakketlocatie op de distributor. Een waarde van 1 specificeert de subscriber.
subscriber_security_mode smallint Is de beveiligingsmodus bij de abonnee, waar 1 Windows-authenticatie betekent, en 0 SQL Server-authenticatie.
subscriber_login sysname De inlognaam bij de Abonnee.
subscriber_password Het echte abonneewachtwoord wordt nooit teruggegeven. Het resultaat wordt gemaskeerd door een ****** string.
job_login sysname Naam van het Windows-account waaronder de Distribution Agent draait.
job_password Het daadwerkelijke werkwachtwoord wordt nooit teruggegeven. Het resultaat wordt gemaskeerd door een ****** string.
distrib_agent_name nvarchar(100) Naam van de agenttaak die het abonnement synchroniseert.
subscriber_type tinyint Type abonnee, wat een van de volgende waarden kan zijn:

0= SQL Server Subscriber
1 = ODBC databronserver
2= Microsoft JET database (verouderd)
3 = OLE DB-provider
subscriber_provider sysname Unieke programmatische identificatie (PROGID) waarmee de OLE DB-provider voor de niet-SQL Server databron is geregistreerd.
subscriber_datasource nvarchar(4000) Naam van de gegevensbron zoals begrepen door de OLE DB-provider.
subscriber_providerstring nvarchar(4000) OLE DB provider-specifieke verbindingsreeks die de databron identificeert.
subscriber_location nvarchar(4000) Locatie van de database zoals begrepen door de OLE DB-provider
subscriber_catalog sysname Catalogus te gebruiken bij het maken van een verbinding met de OLE DB-provider.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Remarks

sp_helpsubscription wordt gebruikt in momentopnamen en transactionele replicatie.

Permissions

Uitvoeringsrechten worden standaard naar de publieke rol. Gebruikers krijgen alleen informatie terug voor abonnementen die zij hebben aangemaakt. Informatie over alle abonnementen wordt teruggegeven aan leden van de sysadmin-vaste serverrol op de Publisher of leden van de db_owner vaste databaserol op de publicatiedatabase.