sp_helpsubscription (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

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 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 composition associée. publication est sysname, avec la valeur par défaut %, qui retourne toutes les informations d’abonnement pour ce serveur.

[ @article = ] 'article' Nom de l’article. l’article est sysname, avec la valeur par défaut %, qui retourne toutes les informations d’abonnement pour les publications et abonnés sélectionnés. Si tous les éléments sont complets, une seule entrée est retournée pour l’abonnement complet sur une publication.

[ @subscriber = ] 'subscriber' Nom de l’Abonné sur lequel obtenir des informations d’abonnement. l’abonné est sysname, avec la valeur par défaut %, qui retourne toutes les informations d’abonnement pour les publications et articles sélectionnés.

[ @destination_db = ] 'destination_db' Nom de la base de données de destination. destination_db est sysname, avec la valeur par défaut .%

[ @found = ] 'found'OUTPUT Indicateur pour indiquer les lignes retournées. foundest int et un paramètre OUTPUT, avec une valeur par défaut de 23456.

1 indique que la composition est trouvée.

0 indique que la publication est introuvable.

[ @publisher = ] 'publisher' Nom du serveur de publication. publisher est sysname et utilise par défaut le nom du serveur actuel.

Notes

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

Jeux de résultats

Nom de la colonne Type de données Description
subscriber (Abonné) sysname Nom de l'Abonné.
Publication sysname Nom de la publication.
article sysname Nom de l'article.
base de données de destination sysname Nom de la base de données de destination où sont placées les données répliquées.
état de l’abonnement tinyint État de l'abonnement :

0 = Inactif

1 = Abonné

2 = Actif
type de synchronisation tinyint Type de synchronisation d'abonnement :

1 = Automatique

2 = Aucun
type d’abonnement int Type d'abonnement :

0 = Push

1 = Extraction

2 = Anonyme
full subscription bit Indique si l'abonnement concerne tous les articles de la publication :

0 = Non

1 = Oui
nom de l’abonnement nvarchar(255) Nom de l'abonnement.
mode de mise à jour int 0 = Lecture seule

1 = Abonnement à 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.

1 = Ne renvoie pas.

Utilisé avec la réplication transactionnelle bidirectionnelle. Pour plus d’informations, voir Bidirectional Transactional Replication.
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 offload_server actuelle répertoriée dans MSdistribution_agents table 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 existe un package, la valeur 0 spécifie l’emplacement du package sur le serveur de distribution. La valeur 1 spécifie l’abonné.
subscriber_security_mode smallint Mode de sécurité de l’Abonné, où 1 signifie Authentification Windows et 0 signifie 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 «****** ».
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 «****** ».
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 :

0 = SQL Server Abonné

1 = serveur de 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.

Codet de retour

0 (réussite) ou 1 (échec)

Remarques

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

Autorisations

Les autorisations d’exécution sont par défaut le 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 retournées aux membres du rôle 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.

Voir aussi

sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_dropsubscription (Transact-SQL)
Procédures stockées système (Transact-SQL)