sp_helpmergesubscription (Transact-SQL)

S’applique à :SQL Server

Renvoie des informations sur un abonnement à une publication de fusion, par envoi (push) et par extraction (pull) de données. Cette procédure stockée est exécutée sur la base de données de publication du serveur de publication ou sur la base de données d'abonnement d'un Abonné de republication.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_helpmergesubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @subscriber_db = ] N'subscriber_db' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
    [ , [ @found = ] found OUTPUT ]
[ ; ]

Arguments

[ @publication = ] N’publication'

Nom de la publication. @publication est sysname, avec la valeur par défaut %. La publication doit déjà exister et respecter les règles pour les identificateurs. Si NULL ou %, des informations sur toutes les publications et abonnements de fusion dans la base de données active sont retournées.

[ @subscriber = ] N’subscriber'

Nom de l'Abonné. @subscriber est sysname, avec la valeur par défaut %. Si NULL ou %, des informations sur tous les abonnements à la publication donnée sont retournées.

[ @subscriber_db = ] N’subscriber_db'

Nom de la base de données d’abonnement. @subscriber_db est sysname, avec une valeur par défaut %, qui retourne des informations sur toutes les bases de données d’abonnement.

[ @publisher = ] N’publisher'

Nom du serveur de publication. @publisher est sysname, avec une valeur par défaut %, avec une valeur par défaut , qui retourne des informations sur tous les serveurs de %publication. Le serveur de publication doit être un serveur valide.

[ @publisher_db = ] N’publisher_db'

Nom de la base de données du serveur de publication. @publisher_db est sysname, avec une valeur par défaut , qui retourne des informations sur toutes les bases de %données Publisher.

[ @subscription_type = ] N’subscription_type'

Type d’abonnement. @subscription_type est nvarchar(15) et peut être l’une de ces valeurs.

Valeur Description
push (valeur par défaut) Abonnement par envoi de données (push)
pull Abonnement par extraction de données (pull)
both Abonnement par envoi (push) et par extraction (pull) de données

[ @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.

Jeu de résultats

Nom de la colonne Type de données Description
subscription_name sysname Nom de l'abonnement.
publication sysname Nom de la publication.
publisher sysname Nom du serveur de publication.
publisher_db sysname Nom de la base de données publisher.
subscriber sysname Nom de l'Abonné.
subscriber_db sysname Nom de la base de données d'abonnement.
status int État de l’abonnement :

0 = Tous les travaux sont en attente de démarrage

1 = Un ou plusieurs travaux démarrent

2 = Tous les travaux ont été exécutés avec succès

3 = Au moins un travail est en cours d’exécution

4 = Tous les travaux sont planifiés et inactifs

5 = Au moins un travail tente d’s’exécuter après un échec précédent

6 = Au moins un travail n’a pas pu s’exécuter correctement
subscriber_type int Type d'Abonné.
subscription_type int Type d'abonnement :

0 = Push

1 = Extraction

2 = Les deux
priority float(8) Numéro indiquant la priorité de l'abonnement.
sync_type tinyint Type de synchronisation d'abonnement
description nvarchar(255) Brève description de cet abonnement de fusion.
merge_jobid binary(16) ID de travail de l'Agent de fusion.
full_publication tinyint Indique si l'abonnement concerne une publication complète ou filtrée.
offload_enabled bit Indique si le déchargement d'un Agent de réplication est configuré pour être exécuté sur l'Abonné. Si NULL, l’exécution est exécutée sur le serveur de publication.
offload_server sysname Nom du serveur sur lequel s'exécute l'Agent.
use_interactive_resolver int Indique si le composant résolveur interactif est utilisé ou non au cours de la réconciliation. Si 0, le programme de résolution interactif n’est pas utilisé.
hostname sysname Valeur fournie lorsqu’un abonnement est filtré par la valeur de la fonction HOST_NAME .
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 sysname Le mot de passe réel de l'Abonné n'est jamais renvoyé. Le résultat est masqué par une ****** chaîne.

Valeurs des codes de retour

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

Notes

sp_helpmergesubscription est utilisé dans la réplication de fusion pour retourner les informations d’abonnement stockées sur le serveur de publication ou republier l’Abonné.

Pour les abonnements anonymes, la valeur subscription_typeest toujours 1 (pull). Toutefois, vous devez exécuter sp_helpmergepullsubscription sur l’Abonné pour obtenir des informations sur les abonnements anonymes.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin , le rôle de base de données fixe db_owner ou la liste d’accès à la publication à laquelle appartient l’abonnement peuvent s’exécuter sp_helpmergesubscription.