sp_helpmergesubscription (Transact-SQL)sp_helpmergesubscription (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Renvoie des informations sur un abonnement à une publication de fusion, par envoi (push) et par extraction (pull) de données.Returns information about a subscription to a merge publication, both push and pull. 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.This stored procedure is executed at the Publisher on the publication database or at a republishing Subscriber on the subscription database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @publication = ] 'publication' Est le nom de la publication.[ @publication = ] 'publication' Is the name of the publication. publication est sysname, avec une valeur par défaut % .publication is sysname, with a default of %. La publication doit déjà exister et se conformer aux règles des identificateurs.The publication must already exist and conform to the rules for identifiers. Si NULL ou % , plus d’informations sur toutes les publications de fusion et les abonnements dans la base de données actuelle sont retournées.If NULL or %, information about all merge publications and subscriptions in the current database is returned.

[ @subscriber = ] 'subscriber' Est le nom de l’abonné.[ @subscriber = ] 'subscriber' Is the name of the Subscriber. abonné est sysname, avec une valeur par défaut % .subscriber is sysname, with a default of %. Si le paramètre a la valeur NULL ou %, des informations sur tous les abonnements à la publication donnée sont renvoyées.If NULL or %, information about all subscriptions to the given publication is returned.

[ @subscriber_db = ] 'subscriber_db' Est le nom de la base de données d’abonnement.[ @subscriber_db = ] 'subscriber_db' Is the name of the subscription database. bd_abonnéest sysname, avec une valeur par défaut % , qui retourne des informations sur toutes les données d’abonnement.subscriber_dbis sysname, with a default of %, which returns information about all subscription databases.

[ @publisher = ] 'publisher' Est le nom du serveur de publication.[ @publisher = ] 'publisher' Is the name of the Publisher. Le serveur de publication doit être un serveur valide.The Publisher must be a valid server. serveur de publicationest sysname, avec une valeur par défaut % , qui retourne des informations sur tous les serveurs de publication.publisheris sysname, with a default of %, which returns information about all Publishers.

[ @publisher_db = ] 'publisher_db' Est le nom de la base de données du serveur de publication.[ @publisher_db = ] 'publisher_db' Is the name of the Publisher database. publisher_dbest sysname, avec une valeur par défaut % , qui retourne des informations sur toutes les bases de données de serveur de publication.publisher_dbis sysname, with a default of %, which returns information about all Publisher databases.

[ @subscription_type = ] 'subscription_type' Est le type d’abonnement.[ @subscription_type = ] 'subscription_type' Is the type of subscription. subscription_typeest nvarchar (15) , et peut prendre l’une des valeurs suivantes.subscription_typeis nvarchar(15), and can be one of these values.

ValueValue DescriptionDescription
push (valeur par défaut)push (default) Abonnement par envoi de données (push)Push subscription
pullpull Abonnement par extraction de données (pull)Pull subscription
both (les deux)both Abonnement par envoi (push) et par extraction (pull) de donnéesBoth a push and pull subscription

[ @found = ] 'found'OUTPUT Est un indicateur pour indiquer les lignes renvoyées.[ @found = ] 'found'OUTPUT Is a flag to indicate returning rows. trouvéest int d’un paramètre OUTPUT, avec NULL comme valeur par défaut.foundis int and an OUTPUT parameter, with a default of NULL. 1 indique la publication a été trouvée.1 indicates the publication is found. 0 indique que la publication est introuvable.0 indicates the publication is not found.

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
subscription_namesubscription_name sysnamesysname Nom de l'abonnement.Name of the subscription.
publicationpublication sysnamesysname Nom de la publication.Name of the publication.
publisher (serveur de publication)publisher sysnamesysname Nom du serveur de publication.Name of the Publisher.
publisher_dbpublisher_db sysnamesysname Nom de la base de données du serveur de publication.Name of the Publisher database.
subscriber (Abonné)subscriber sysnamesysname Nom de l'Abonné.Name of the Subscriber.
bd_abonnésubscriber_db sysnamesysname Nom de la base de données d'abonnement.Name of the subscription database.
statusstatus Intint État de l’abonnement :Status of the subscription:

0 = tous les travaux sont en attente de démarrage0 = All jobs are waiting to start

1 = une ou plusieurs travaux commencent1 = One or more jobs are starting

2 = tous les travaux ont été correctement exécutées.2 = All jobs have executed successfully

3 = au moins un travail s’exécute.3 = At least one job is executing

4 = tous les travaux sont planifiés et inactifs4 = All jobs are scheduled and idle

5 = au moins un travail est relancée après un échec5 = At least one job is attempting to execute after a previous failure

6 = au moins un travail n’a pas pu s’exécuter avec succès6 = At least one job has failed to execute successfully
subscriber_typesubscriber_type intint Type d'Abonné.Type of Subscriber.
subscription_typesubscription_type intint Type d'abonnement :Type of subscription:

0 = push0 = Push

1 = par extraction1 = Pull

2 = Both2 = Both
prioritypriority float(8)float(8) Numéro indiquant la priorité de l'abonnement.Number indicating the priority for the subscription.
sync_typesync_type tinyinttinyint Type de synchronisation d'abonnementSubscription sync type.
descriptiondescription nvarchar(255)nvarchar(255) Brève description de cet abonnement de fusion.Brief description of this merge subscription.
merge_jobidmerge_jobid binary(16)binary(16) ID de travail de l'Agent de fusion.Job ID of the Merge Agent.
full_publicationfull_publication tinyinttinyint Indique si l'abonnement concerne une publication complète ou filtrée.Whether the subscription is to a full or filtered publication.
offload_enabledoffload_enabled bitbit Indique si le déchargement d'un Agent de réplication est configuré pour être exécuté sur l'Abonné.Specifies if offload execution of a replication agent has been set to run at the Subscriber. Si la valeur est NULL, l'exécution a lieu sur le serveur de publication.If NULL, execution is run at the Publisher.
offload_serveroffload_server sysnamesysname Nom du serveur sur lequel s'exécute l'Agent.Name of the server to where the agent is running.
use_interactive_resolveruse_interactive_resolver Intint Indique si le composant résolveur interactif est utilisé ou non au cours de la réconciliation.Returns whether or not the interactive resolver is used during reconciliation. Si 0, pas le résolveur interactif est utilisé.If 0, the interactive resolver not is used.
Nom d’hôtehostname sysnamesysname Valeur fournie lorsqu’un abonnement est filtré par la valeur de la HOST_NAME (fonction).Value supplied when a subscription is filtered by the value of the HOST_NAME function.
subscriber_security_modesubscriber_security_mode smallintsmallint Mode de sécurité sur l’abonné, où 1 signifie que l’authentification Windows, et 0 signifie MicrosoftMicrosoft SQL ServerSQL Server l’authentification.Is the security mode at the Subscriber, where 1 means Windows Authentication, and 0 means MicrosoftMicrosoft SQL ServerSQL Server Authentication.
subscriber_loginsubscriber_login sysnamesysname Nom de connexion sur l'Abonné.Is the login name at the Subscriber.
subscriber_passwordsubscriber_password sysnamesysname Le mot de passe réel de l'Abonné n'est jamais renvoyé.Actual Subscriber password is never returned. Le résultat est masqué par un « ****** » chaîne.The result is masked by a "******" string.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_helpmergesubscription est utilisé dans la réplication de fusion pour retourner des informations d’abonnement stockées sur le serveur de publication ou un abonné de republication.sp_helpmergesubscription is used in merge replication to return subscription information stored at the Publisher or republishing Subscriber.

Pour les abonnements anonymes, le subscription_typevaleur est toujours 1 (pull).For anonymous subscriptions, the subscription_typevalue is always 1 (pull). Toutefois, vous devez exécuter sp_helpmergepullsubscription sur l’abonné pour plus d’informations sur les abonnements anonymes.However, you must execute sp_helpmergepullsubscription at the Subscriber for information on anonymous subscriptions.

AutorisationsPermissions

Seuls les membres de la sysadmin rôle serveur fixe le db_owner rôle de base de données fixe ou de la liste d’accès à la publication à laquelle appartient l’abonnement peut exécuter sp_ helpmergesubscription.Only members of the sysadmin fixed server role, the db_owner fixed database role or the publication access list for the publication to which the subscription belongs can execute sp_helpmergesubscription.

Voir aussiSee Also

sp_addmergesubscription (Transact-SQL) sp_addmergesubscription (Transact-SQL)
sp_changemergesubscription (Transact-SQL) sp_changemergesubscription (Transact-SQL)
sp_dropmergesubscription (Transact-SQL) sp_dropmergesubscription (Transact-SQL)
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)