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.
.gif "Icône Lien de rubrique")
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.