sp_helpsubscription (Transact-SQL)

Article
05/07/2013

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 % comme valeur par défaut.
[ @found= ] **'found'**OUTPUT
Indicateur désignant les lignes retournées. found est de type int et est un paramètre OUTPUT, avec 23456 comme valeur par défaut.

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 sysname, et a comme valeur par défaut le nom du serveur actuel.

[!REMARQUE]

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

Jeux de résultats

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.

état des abonnements

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 = 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 :

Valeur	Description
0	Abonné SQL Server
1	Serveur de la source de données ODBC.
2	Base de données Microsoft JET (déconseillée)
3	Fournisseur 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 de retour

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

Notes

sp_helpsubscription est utilisé dans la réplication transactionnelle et d'instantané.

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.