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.
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 % renvoie toutes les informations d'abonnement concernant ce serveur.
- [ @article= ] 'article'
Nom de l'article. article est de type sysname. Sa valeur par défaut % renvoie toutes les informations d'abonnement concernant 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 d'abonnement. subscriber est de type sysname. Sa valeur par défaut % renvoie toutes les informations d'abonnement concernant 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 renvoyé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. L'argument publisher est de type sysname. Sa valeur par défaut est le nom du serveur actif.Remarque : publisher ne doit pas être spécifié, sauf s'il s'agit d'un serveur de publication Oracle.
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.
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é 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
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)
Voir aussi
Référence
sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_dropsubscription (Transact-SQL)
Procédures stockées système (Transact-SQL)