Article
03/31/2012

sp_helpsubscription (Transact-SQL)

Affiche des informations sur les abonnements associés à une publication, un article, un Abonné ou un ensemble d'abonnements particuliers. Cette procédure stockée est exécutée sur la base de données de publication d'un serveur de publication.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

[ @publication=] 'publication'
Nom de la publication associée. publication est de type sysname. Sa valeur par défaut % retourne toutes les informations sur l'abonnement pour ce serveur.
[ @article= ] 'article'
Nom de l'article. article est de type sysname. Sa valeur par défaut % retourne toutes les informations sur l'abonnement pour les publications et les Abonnés sélectionnés. Si cet argument a la valeur all, une seule entrée est renvoyée pour l'abonnement complet à une publication.
[ @subscriber=] 'subscriber'
Nom de l'Abonné dont vous voulez connaître les informations sur l'abonnement. subscriber est de type sysname. Sa valeur par défaut % retourne toutes les informations sur l'abonnement pour les publications et les articles sélectionnés.
[ @destination_db= ] 'destination_db'
Nom de la base de données de destination. destination_db est de type sysname, avec la valeur par défaut %.
[ @found= ] **'found'**OUTPUT
Indicateur désignant les lignes retournées. found est de type int, avec 23456 comme valeur par défaut. Il s'agit d'un paramètre OUTPUT.

1 indique que la publication a été trouvée.

0 indique que la publication n'a pas été trouvée.
[ @publisher = ] 'publisher'
Nom du serveur de publication. publisher est de type sysname et sa valeur par défaut est le nom du serveur actif.

Notes

publisher ne doit pas être spécifié, sauf s'il s'agit d'un serveur de publication Oracle.

Ensembles de résultats

Nom de la colonne	Type de données	Description
subscriber	sysname	Nom de l'Abonné.
publication	sysname	Nom de la publication.
article	sysname	Nom de l'article.
destination database	sysname	Nom de la base de données de destination où sont placées les données répliquées.
subscription status	tinyint	État de l'abonnement : 0 = Inactif 1 = Souscrit 2 = Actif
synchronisation type	tinyint	Type de synchronisation d'abonnement : 1 = Automatique 2 = Aucune
subscription type	int	Type d'abonnement : 0 = Par envoi de données (push) 1 = Par extraction de données (pull) 2 = Anonyme
full subscription	bit	Indique si l'abonnement concerne tous les articles de la publication : 0 = Non 1 = Oui
subscription name	nvarchar(255)	Nom de l'abonnement.
update mode	int	0 = Lecture seule 1 = Abonnement de mise à jour immédiate
distribution job id	binary(16)	ID du travail de l'Agent de distribution.
loopback_detection	bit	La détection de boucle détermine si l'Agent de distribution renvoie à l'Abonné les transactions émanant de ce dernier : 0 = Renvoie les transactions. 1 = Ne renvoie pas les transactions. Utilisé avec la réplication transactionnelle bidirectionnelle. Pour plus d'informations, consultez Réplication transactionnelle bidirectionnelle.
offload_enabled	bit	Indique si l'exécution du déchargement d'un Agent de réplication est configurée pour être exécuté sur l'Abonné. Si la valeur est 0, l'Agent est exécuté sur le serveur de publication. Si la valeur est 1, l'Agent est exécuté sur l'Abonné.
offload_server	sysname	Nom du serveur activé pour l'activation d'Agent à distance. Si la valeur est NULL, la valeur offload_server figurant dans la table MSdistribution_agents est utilisée.
dts_package_name	sysname	Spécifie le nom du package DTS (Data Transformation Services).
dts_package_location	int	Emplacement du package DTS (si un lot est affecté à l'abonnement). S'il y a un package, la valeur 0 spécifie son emplacement sur le serveur de distribution (distributor). La valeur 1 spécifie l'abonné (subscriber).
subscriber_security_mode	smallint	Mode de sécurité utilisé sur l'Abonné ; 1 signifie l'authentification Windows, 0 l'authentification SQL Server.
subscriber_login	sysname	Nom de connexion sur l'Abonné.
subscriber_password		Le mot de passe réel de l'Abonné n'est jamais renvoyé. Le résultat est masqué par une chaîne de caractères composée d'astérisques (******).
job_login	sysname	Nom du compte Windows sous lequel l'Agent de distribution s'exécute.
job_password		Le mot de passe réel du travail n'est jamais renvoyé. Le résultat est masqué par une chaîne de caractères composée d'astérisques (******).
distrib_agent_name	nvarchar(100)	Nom du travail de l'Agent qui synchronise l'abonnement.
subscriber_type	tinyint	Type d'Abonné, parmi les types suivants : ValeurDescription 0Abonné SQL Server 1Serveur de la source de données ODBC 2Base de données Microsoft JET (désapprouvé) 3Fournisseur OLE DB
subscriber_provider	sysname	Identificateur de programme unique (PROGID) avec lequel le fournisseur OLE DB de la source de données non-SQL Server est inscrit.
subscriber_datasource	nvarchar(4000)	Nom de la source de données tel qu'il est interprété par le fournisseur OLE DB.
subscriber_providerstring	nvarchar(4000)	Chaîne de connexion propre au fournisseur OLE DB qui identifie la source de données.
subscriber_location	nvarchar(4000)	Emplacement de la base de données tel qu'il est interprété par le fournisseur OLE DB.
subscriber_catalog	sysname	Catalogue à utiliser lors d’une connexion au fournisseur OLE DB.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Notes

sp_helpsubscription est utilisé dans la réplication transactionnelle et de capture instantanée.

Autorisations

Les autorisations d'exécution reviennent par défaut au rôle public. Seules les informations des abonnements qu'ils ont créés sont renvoyées aux utilisateurs. Les informations sur tous les abonnements sont renvoyées aux membres du rôle de 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.