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émarrage1 = Un ou plusieurs travaux démarrent2 = Tous les travaux ont été exécutés avec succès3 = Au moins un travail est en cours d’exécution4 = Tous les travaux sont planifiés et inactifs5 = Au moins un travail tente d’s’exécuter après un échec précédent6 = 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 = Push1 = Extraction2 = 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
.