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)

Aide et Informations

Assistance sur SQL Server 2005