sp_helpmergesubscription (Transact-SQL)

Article
05/07/2013

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.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

[ @publication=] 'publication'
Nom de la publication. publication est de type sysname, avec % comme valeur par défaut. La publication doit déjà exister et respecter les règles applicables aux identificateurs. Si la valeur est NULL ou %, les informations sur toutes les publications de fusion et tous les abonnements de la base de données actuelle sont renvoyées.
[ @subscriber=] 'subscriber'
Nom de l'abonné. subscriber est de type sysname, avec % comme valeur par défaut. Si le paramètre a la valeur NULL ou %, des informations sur tous les abonnements à la publication donnée sont renvoyées.
[ @subscriber_db=] 'subscriber_db'
Nom de la base de données d'abonnement. subscriber_dbest de type sysname, avec % comme valeur par défaut qui retourne des informations sur toutes les bases de données d'abonnement.
[ @publisher=] 'publisher'
Nom du serveur de publication. Le serveur de publication doit être un serveur valide. publisherest de type sysname et sa valeur par défaut, %, retourne des informations sur tous les serveurs de publication.
[ @publisher_db=] 'publisher_db'
Nom de la base de données du serveur de publication. publisher_dbest de type sysname et sa valeur par défaut, %, retourne des informations sur toutes les bases de données de serveur de publication.

[ @subscription_type=] 'subscription_type'
Type d'abonnement. subscription_typeest de type nvarchar(15) et peut prendre l'une des valeurs suivantes.

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 désignant les lignes retournées. foundest de type int. Il s'agit d'un paramètre OUTPUT, avec NULL comme valeur par défaut. 1 indique que la publication est trouvée. 0 indique que la publication n'a pas été trouvée.

Jeux 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 du serveur de publication.
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 en attente de démarrage 1 = Démarrage d'un ou de plusieurs travaux 2 = Exécution correcte de tous les travaux 3 = Exécution en cours d'au moins un travail 4 = Tous les travaux sont planifiés et inactifs 5 = L'exécution d'au moins un travail est relancée après un échec 6 = Au moins un travail n'a pas été exécuté correctement
subscriber_type	int	Type d'Abonné.
subscription_type	int	Type d'abonnement : 0 = Par envoi de données (push) 1 = Par extraction de données (pull) 2 = Les deux
priorité	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 la valeur est NULL, l'exécution a lieu 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 la valeur est 0, le composant résolveur interactif n'est pas utilisé.
hostname	sysname	Valeur fournie lorsqu'un abonnement est filtré en fonction de la valeur de la fonction HOST_NAME.
subscriber_security_mode	smallint	Mode de sécurité sur l'Abonné, où 1 correspond à l'authentification Windows, et 0 à l'authentification Microsoft SQL Server.
subscriber_login	sysname	Nom de connexion sur l'Abonné.
subscriber_password	sysname	Le mot de passe de l'Abonné n'est jamais renvoyé. Le résultat est masqué par une chaîne "******".

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

sp_helpmergesubscription est utilisé dans une réplication de fusion pour renvoyer des informations d'abonnement stockées sur le serveur de publication ou au niveau de l'Abonné de republication.

Pour les abonnements anonymes, la valeur subscription_typeest toujours 1 (extraction de données). Toutefois, vous devez exécuter sp_helpmergepullsubscription au niveau de l'Abonné pour obtenir des informations sur les abonnements anonymes.

Autorisations

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