sp_helpsubscription (Transact-SQL)sp_helpsubscription (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Affiche des informations sur les abonnements associés à une publication, un article, un Abonné ou un ensemble d'abonnements particuliers.Lists subscription information associated with a particular publication, article, Subscriber, or set of subscriptions. Cette procédure stockée est exécutée sur la base de données de publication d'un serveur de publication.This stored procedure is executed at a Publisher on the publication database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication associée.[ @publication = ] 'publication' Is the name of the associated publication. publication est de % type sysname, avec la valeur par défaut, qui retourne toutes les informations d’abonnement pour ce serveur.publication is sysname, with a default of %, which returns all subscription information for this server.

[ @article = ] 'article'Nom de l’article.[ @article = ] 'article' Is the name of the article. article est de % type sysname, avec la valeur par défaut, qui retourne toutes les informations d’abonnement pour les publications et les abonnés sélectionnés.article is sysname, with a default of %, which returns all subscription information for the selected publications and Subscribers. Si la valeur est All, une seule entrée est retournée pour l’abonnement complet sur une publication.If all, only one entry is returned for the full subscription on a publication.

[ @subscriber = ] 'subscriber'Nom de l’abonné sur lequel les informations d’abonnement sont obtenues.[ @subscriber = ] 'subscriber' Is the name of the Subscriber on which to obtain subscription information. Subscriber est de % type sysname, avec la valeur par défaut, qui retourne toutes les informations d’abonnement pour les publications et les articles sélectionnés.subscriber is sysname, with a default of %, which returns all subscription information for the selected publications and articles.

[ @destination_db = ] 'destination_db'Nom de la base de données de destination.[ @destination_db = ] 'destination_db' Is the name of the destination database. destination_db est de % type sysname, avec la valeur par défaut.destination_db is sysname, with a default of %.

[ @found = ] 'found'OUTPUTIndicateur qui signale le retour de lignes.[ @found = ] 'found'OUTPUT Is a flag to indicate returning rows. valeur de type int et paramètre de sortie, avec la valeur par défaut 23456.foundis int and an OUTPUT parameter, with a default of 23456.

1 indique que la publication est trouvée.1 indicates the publication is found.

0 indique que la publication est introuvable.0 indicates the publication is not found.

[ @publisher = ] 'publisher'Nom du serveur de publication.[ @publisher = ] 'publisher' Is the name of the Publisher. Publisher est de type sysnameet sa valeur par défaut est le nom du serveur actuel.publisher is sysname, and defaults to the name of the current server.

Notes

l' éditeur ne doit pas être spécifié, sauf s’il s’agit d’un serveur de publication Oracle.publisher should not be specified, except when it is an Oracle Publisher.

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
subscriber (Abonné)subscriber sysnamesysname Nom de l'Abonné.Name of the Subscriber.
publicationpublication sysnamesysname Nom de la publication.Name of the publication.
articlearticle sysnamesysname Nom de l'article.Name of the article.
base de données de destinationdestination database sysnamesysname Nom de la base de données de destination où sont placées les données répliquées.Name of the destination database in which replicated data is placed.
État de l’abonnementsubscription status tinyinttinyint État de l'abonnement :Subscription status:

0 = inactif0 = Inactive

1 = abonné1 = Subscribed

2 = actif2 = Active
type de synchronisationsynchronization type tinyinttinyint Type de synchronisation d'abonnement :Subscription synchronization type:

1 = automatique1 = Automatic

2 = aucun2 = None
type d’abonnementsubscription type intint Type d'abonnement :Type of subscription:

0 = Push0 = Push

1 = extraction1 = Pull

2 = anonyme2 = Anonymous
abonnement completfull subscription bitbit Indique si l'abonnement concerne tous les articles de la publication :Whether subscription is to all articles in the publication:

0 = Non0 = No

1 = Oui1 = Yes
nom de l’abonnementsubscription name nvarchar(255)nvarchar(255) Nom de l'abonnement.Name of the subscription.
mode de mise à jourupdate mode intint 0 = lecture seule0 = Read-only

1 = abonnement avec mise à jour immédiate1 = Immediate-updating subscription
ID de tâche de distributiondistribution job id binary(16)binary(16) ID du travail de l'Agent de distribution.Job ID of the Distribution Agent.
loopback_detectionloopback_detection bitbit La détection de boucle détermine si l'Agent de distribution renvoie à l'Abonné les transactions émanant de ce dernier :Loopback detection determines whether the Distribution Agent sends transactions originated at the Subscriber back to the Subscriber:

0 = renvoie.0 = Sends back.

1 = n’est pas renvoyé.1 = Does not send back.

Utilisé avec la réplication transactionnelle bidirectionnelle.Used with bidirectional transactional replication. Pour plus d’informations, voir Bidirectional Transactional Replication.For more information, see Bidirectional Transactional Replication.
offload_enabledoffload_enabled bitbit Indique si l'exécution du déchargement d'un Agent de réplication est configurée pour être exécuté sur l'Abonné.Specifies whether offload execution of a replication agent has been set to run at the Subscriber.

Si la valeur est 0, l’agent est exécuté sur le serveur de publication.If 0, agent is run at the Publisher.

Si la condition est 1, l’agent est exécuté sur l’abonné.If 1, agent is run at the Subscriber.
offload_serveroffload_server sysnamesysname Nom du serveur activé pour l'activation d'Agent à distance.Name of the server enabled for remote agent activation. Si la valeur est NULL, le offload_server actuel figurant dans la table MSdistribution_agents est utilisé.If NULL, then the current offload_server listed in MSdistribution_agents table is used.
dts_package_namedts_package_name sysnamesysname Spécifie le nom du package DTS (Data Transformation Services).Specifies the name of the Data Transformation Services (DTS) package.
dts_package_locationdts_package_location intint Emplacement du package DTS (si un lot est affecté à l'abonnement).Location of the DTS package, if one is assigned to the subscription. S’il existe un package, la valeur 0 spécifie l’emplacement du package sur le serveur de distribution.If there is a package, a value of 0 specifies the package location at the distributor. La valeur 1 spécifie l' abonné.A value of 1 specifies the subscriber.
subscriber_security_modesubscriber_security_mode smallintsmallint Est le mode de sécurité de l’abonné, où 1 correspond à l’authentification Windows et SQL ServerSQL Server 0 à l’authentification.Is the security mode at the Subscriber, where 1 means Windows Authentication, and 0 means SQL ServerSQL Server Authentication.
subscriber_loginsubscriber_login sysnamesysname Nom de connexion sur l'Abonné.Is the login name at the Subscriber.
subscriber_passwordsubscriber_password Le mot de passe réel de l'Abonné n'est jamais renvoyé.Actual Subscriber password is never returned. Le résultat est masqué par une chaîne « ***** ».The result is masked by a "******" string.
job_loginjob_login sysnamesysname Nom du compte Windows sous lequel l'Agent de distribution s'exécute.Name of the Windows account under which the Distribution Agent runs.
job_passwordjob_password Le mot de passe réel du travail n'est jamais renvoyé.Actual job password is never returned. Le résultat est masqué par une chaîne « ***** ».The result is masked by a "******" string.
distrib_agent_namedistrib_agent_name nvarchar(100)nvarchar(100) Nom du travail de l'Agent qui synchronise l'abonnement.Name of the agent job that synchronizes the subscription.
subscriber_typesubscriber_type tinyinttinyint Type d'Abonné, parmi les types suivants :Type of Subscriber, which can be one of the following:

0 = abonné SQL Server0 = SQL Server Subscriber

1 = serveur de source de données ODBC1 = ODBC data source server

2 = base de données Microsoft Jet (déconseillée)2 = Microsoft JET database (deprecated)

3 = OLE DB fournisseur3 = OLE DB provider
subscriber_providersubscriber_provider sysnamesysname Identificateur de programme unique (PROGID) avec lequel le fournisseur OLE DB de la source de données non-SQL Server est inscrit.Unique programmatic identifier (PROGID) with which the OLE DB provider for the non-SQL Server data source is registered.
subscriber_datasourcesubscriber_datasource nvarchar(4000)nvarchar(4000) Nom de la source de données tel qu'il est interprété par le fournisseur OLE DB.Name of the data source as understood by the OLE DB provider.
subscriber_providerstringsubscriber_providerstring nvarchar(4000)nvarchar(4000) Chaîne de connexion propre au fournisseur OLE DB qui identifie la source de données.OLE DB provider-specific connection string that identifies the data source.
subscriber_locationsubscriber_location nvarchar(4000)nvarchar(4000) Emplacement de la base de données tel qu'il est interprété par le fournisseur OLE DB.Location of the database as understood by the OLE DB provider
subscriber_catalogsubscriber_catalog sysnamesysname Catalogue à utiliser lors d’une connexion au fournisseur OLE DB.Catalog to be used when making a connection to the OLE DB provider.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_helpsubscription est utilisé dans la réplication transactionnelle et d’instantané.sp_helpsubscription is used in snapshot and transactional replication.

AutorisationsPermissions

Les autorisations d'exécution reviennent par défaut au rôle public .Execute permissions default to the public role. Seules les informations des abonnements qu'ils ont créés sont renvoyées aux utilisateurs.Users are only returned information for subscriptions that they created. Les informations sur tous les abonnements sont retournées aux membres du rôle serveur fixe sysadmin sur le serveur de publication ou aux membres du rôle de base de données fixe db_owner sur la base de données de publication.Information on all subscriptions is returned to members of the sysadmin fixed server role at the Publisher or members of the db_owner fixed database role on the publication database.

Voir aussiSee Also

sp_addsubscription (Transact-SQL) sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL) sp_changesubstatus (Transact-SQL)
sp_dropsubscription (Transact-SQL) sp_dropsubscription (Transact-SQL)
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)