sp_helpmergesubscription (Transact-SQL)

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 rubriqueConventions 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. L'argument 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é. L'argument 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_db est 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 valide. publisherest de type sysname, avec la valeur par défaut % qui renvoie des informations sur tous les serveurs de publication.

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

  • [ @subscription_type=] 'subscription_type'
    Type de l'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 qui spécifie les lignes renvoyées. found est de type int et un paramètre OUTPUT. Sa valeur par défaut est NULL. 1 indique que la publication est trouvée. 0 indique que la publication n'est pas trouvée.

Ensembles 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

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