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