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 = ] N'publication' ]
    [ , [ @article = ] N'article' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @destination_db = ] N'destination_db' ]
    [ , [ @found = ] found OUTPUT ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Arguments

[ @publication = ] N’publication'

Nom de la composition associée. @publication est sysname, avec une valeur par défaut %, qui retourne toutes les informations d’abonnement pour ce serveur.

[ @article = ] N’article'

Nom de l’article. @article est sysname, avec une valeur par défaut %, qui retourne toutes les informations d’abonnement pour les publications et abonnés sélectionnés. Si all, une seule entrée est retournée pour l’abonnement complet sur une publication.

[ @subscriber = ] N’subscriber'

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

[ @destination_db = ] N’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 permettant d’indiquer le retour de lignes. @found est un paramètre OUTPUT de type int.

  • 1 indique que la composition est trouvée.
  • 0 indique que la composition n’est pas trouvée.

[ @publisher = ] N’publisher'

Nom du serveur de publication. @publisher est sysname et correspond par défaut au nom du serveur actuel.

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

Jeu 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 Statut d’abonnement :

0 = Inactif
1 = Abonné
2 = Actif
synchronization type tinyint Type de synchronisation d'abonnement :

1 = Automatique
2 = Aucun
subscription type 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
subscription name nvarchar(255) Nom de l'abonnement.
update mode 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 Spécifie si l’exécution du déchargement d’un agent de réplication est définie pour s’exécuter sur l’Abonné.

Si 0, l’agent est exécuté sur le serveur de publication.
Si 1l’agent est exécuté sur l’Abonné.
offload_server sysname Nom du serveur activé pour l'activation d'Agent à distance. Si 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, une valeur de 0 spécifie l’emplacement du package à l’emplacement distributor. Valeur de 1 spécifie le subscriber.
subscriber_security_mode smallint Mode de sécurité sur 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é, qui peut être l’une des valeurs suivantes :

0 = Abonné SQL Server
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.

Valeurs des codes de retour

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

Notes

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

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 retournées aux membres du rôle serveur fixe sysadmin sur le serveur de publication ou les membres du rôle de base de données fixe db_owner sur la base de données de publication.