sp_helpmergepullsubscription (Transact-SQL)sp_helpmergepullsubscription (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 des abonnements par extraction de données (pull) existant sur l'Abonné.Returns information about pull subscriptions that exist at a Subscriber. Cette procédure stockée est exécutée sur la base de données d'abonnement de l'Abonné.This stored procedure is executed at the 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_helpmergepullsubscription [ [ @publication=] 'publication']  
    [ , [ @publisher=] 'publisher']  
    [ , [ @publisher_db=] 'publisher_db']  
    [ , [ @subscription_type=] 'subscription_type']  

ArgumentArgument

[ @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 %. Si publication est % , plus d’informations sur toutes les publications de fusion et les abonnements dans la base de données actuelle sont retournées.If publication is %, information about all merge publications and subscriptions in the current database is returned.

[ @publisher = ] 'publisher' Est le nom du serveur de publication.[ @publisher = ] 'publisher' Is the name of the Publisher. serveur de publicationest sysname, avec une valeur par défaut % .publisheris sysname, with a default of %.

[ @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 % .publisher_dbis sysname, with a default of %.

[ @subscription_type = ] 'subscription_type' S’il faut afficher les abonnements par extraction est.[ @subscription_type = ] 'subscription_type' Is whether to show pull subscriptions. subscription_typeest nvarchar (10) , avec une valeur par défaut 'pull' .subscription_typeis nvarchar(10), with a default of 'pull'. Les valeurs valides sont 'push' , 'pull' , ou 'both' .Valid values are 'push', 'pull', or 'both'.

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
subscription_namesubscription_name nvarchar(1000)nvarchar(1000) 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.
subscription_dbsubscription_db sysnamesysname Nom de la base de données d'abonnement.Name of the subscription database.
statusstatus intint État de l'abonnement :Subscription status:

0 = abonnement inactif0 = Inactive subscription

1 = abonnement actif1 = Active subscription

2 = abonnement supprimé2 = Deleted subscription

3 = abonnement détaché3 = Detached subscription

4 = abonnement attaché4 = Attached subscription

5 = abonnement a été marqué pour réinitialisation avec chargement5 = Subscription has been marked for reinitialization with upload

6 = attacher l’abonnement a échoué6 = Attaching the subscription failed

7 = abonnement restauré à partir de la sauvegarde7 = Subscription restored from backup
subscriber_typesubscriber_type intint Type d'Abonné :Type of Subscriber:

1 = global1 = Global

2 = local2 = Local

3 = anonyme3 = Anonymous
subscription_typesubscription_type intint Type d'abonnement :Type of subscription:

0 = push0 = Push

1 = par extraction1 = Pull

2 = anonyme2 = Anonymous
prioritypriority float(8)float(8) Priorité de l'abonnement.Subscription priority. La valeur doit être inférieure à 100,00.The value must be less than 100.00.
sync_typesync_type tinyinttinyint Type de synchronisation d'abonnement :Subscription synchronization type:

1 = automatique1 = Automatic

2 = instantané n’est pas utilisé.2 = Snapshot is not used.
descriptiondescription nvarchar(255)nvarchar(255) Brève description de l’abonnement par extraction.Brief description of the pull subscription.
merge_jobidmerge_jobid binary(16)binary(16) ID de travail de l'Agent de fusion.Job ID of the Merge Agent.
enabled_for_syncmgrenabled_for_syncmgr intint Indique si l'abonnement peut être synchronisé à l'aide du gestionnaire de synchronisation de MicrosoftMicrosoft.Whether the subscription can be synchronized through the MicrosoftMicrosoft Synchronization Manager.
last_updatedlast_updated nvarchar(26)nvarchar(26) Date et heure de la dernière synchronisation de l'abonnement effectuée par l'Agent de fusion.Time that the Merge Agent last successfully synchronized the subscription.
publisher_loginpublisher_login sysnamesysname Nom de connexion du serveur de publication.The Publisher login name.
publisher_passwordpublisher_password sysnamesysname Le mot de passe du serveur de publication.The Publisher password.
publisher_security_modepublisher_security_mode intint Spécifie le mode de sécurité du serveur de publication :Specifies the security mode of the Publisher:

0 = SQL ServerSQL Server l’authentification0 = SQL ServerSQL Server Authentication

1 = l’authentification Windows1 = Windows Authentication
distributordistributor sysnamesysname Nom du serveur de distribution.Name of the Distributor.
distributor_logindistributor_login sysnamesysname Le nom de connexion du serveur de distribution.The Distributor login name.
distributor_passworddistributor_password sysnamesysname Le mot de passe du serveur de distribution.The Distributor password.
distributor_security_modedistributor_security_mode intint Spécifie le mode de sécurité du serveur de distribution :Specifies the security mode of the Distributor:

0 = SQL ServerSQL Server l’authentification0 = SQL ServerSQL Server Authentication

1 = l’authentification Windows1 = Windows Authentication
ftp_addressftp_address sysnamesysname Disponible pour compatibilité descendante uniquement.Available for backward compatibility only. Est l’adresse réseau du service de fichier transfer protocol (FTP) pour le serveur de distribution.Is the network address of the file transfer protocol (FTP) service for the Distributor.
ftp_portftp_port Intint Disponible pour compatibilité descendante uniquement.Available for backward compatibility only. Numéro de port du service FTP du serveur de distribution.Is the port number of the FTP service for the Distributor.
ftp_loginftp_login sysnamesysname Disponible pour compatibilité descendante uniquement.Available for backward compatibility only. Le nom d’utilisateur est utilisé pour se connecter au service FTP.Is the username used to connect to the FTP service.
ftp_passwordftp_password sysnamesysname Disponible pour compatibilité descendante uniquement.Available for backward compatibility only. Mot de passe de l'utilisateur utilisé pour la connexion au service FTP.Is the user password used to connect to the FTP service.
alt_snapshot_folderalt_snapshot_folder nvarchar(255)nvarchar(255) Emplacement de stockage du dossier d'instantané si cet emplacement est différent ou en complément de l'emplacement par défaut.Location where snapshot folder is stored if the location is other than or in addition to the default location.
working_directoryworking_directory nvarchar(255)nvarchar(255) Chemin complet du répertoire dans lequel les fichiers d'instantané sont transférés via FTP lorsque cette option est spécifiée.Fully-qualified path to the directory where snapshot files are transferred using FTP when that option is specified.
use_ftpuse_ftp bitbit Indique si l'abonnement à la publication s'effectue via Internet, et si les propriétés d'adressage FTP sont configurées.Subscription is subscribing to publication over the Internet, and FTP addressing properties are configured. Si 0, abonnement n’utilise pas FTP.If 0, Subscription is not using FTP. Si 1, l’abonnement utilise FTP.If 1, subscription is using FTP.
offload_agentoffload_agent bitbit Indique si l'Agent peut être activé et exécuté à distance.Specifies if the agent can be activated and run remotely. Si 0, l’agent ne peut pas être activé à distance.If 0, the agent cannot be remotely activated.
offload_serveroffload_server sysnamesysname Nom du serveur utilisé pour l'activation à distance.Name of the server used for remote activation.
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, le résolveur interactif n’est pas utilisé.If 0, the interactive resolver is not used.
subidsubid uniqueidentifieruniqueidentifier ID de l'Abonné.ID of the Subscriber.
dynamic_snapshot_locationdynamic_snapshot_location nvarchar(255)nvarchar(255) Chemin d'accès du dossier dans lequel les fichiers d'instantané sont enregistrés.The path to the folder where the snapshot files are saved.
last_sync_statuslast_sync_status intint État de la synchronisation :Synchronization status:

1 = début1 = Starting

2 = a réussi2 = Succeeded

3 = en cours3 = In progress

4 = inactif4 = Idle

5 = nouvelle tentative après un échec5 = Retrying after a previous failure

6 = Échec6 = Failed

7 = Échec de validation7 = Failed validation

8 = validation réussie8 = Passed validation

9 = arrêt demandé9 = Requested a shutdown
last_sync_summarylast_sync_summary sysnamesysname Description des résultats de la dernière synchronisation.Description of last synchronization results.
use_web_syncuse_web_sync bitbit Spécifie si l’abonnement peut être synchronisé via HTTPS, où la valeur 1 signifie que cette fonctionnalité est activée.Specifies if the subscription can be synchronized over HTTPS, where a value of 1 means that this feature is enabled.
internet_urlinternet_url nvarchar(260)nvarchar(260) URL qui représente l'emplacement de l'écouteur de réplication pour la synchronisation Web.URL that represents the location of the replication listener for Web synchronization.
internet_logininternet_login nvarchar(128)nvarchar(128) Connexion que l'Agent de fusion utilise pour se connecter, à l'aide de l'authentification de base, au serveur Web qui héberge la synchronisation Web.Login that the Merge Agent uses when connecting to the Web server that is hosting Web synchronization using Basic Authentication.
internet_passwordinternet_password nvarchar(524)nvarchar(524) Mot de passe de la connexion que l'Agent de fusion utilise pour se connecter, à l'aide de l'authentification de base, au serveur Web qui héberge la synchronisation Web.Password for the login that the Merge Agent uses when connecting to the Web server that is hosting Web synchronization using Basic Authentication.
internet_security_modeinternet_security_mode Intint Mode d'authentification utilisé pour se connecter au serveur Web hôte de la synchronisation Web.The authentication mode used when connecting to the Web server that is hosting Web synchronization. La valeur 1 signifie que l’authentification Windows et la valeur 0 signifie SQL ServerSQL Server l’authentification.A value of 1 means Windows Authentication, and a value of 0 means SQL ServerSQL Server Authentication.
internet_timeoutinternet_timeout intint Délai en secondes avant l'expiration d'une demande de synchronisation Web.Length of time, in seconds, before a Web synchronization request expires.
Nom d’hôtehostname nvarchar(128)nvarchar(128) Spécifie une valeur surchargée pour HOST_NAME lorsque cette fonction est utilisée dans la clause WHERE d’un filtre de lignes paramétrable.Specifies an overloaded value for HOST_NAME when this function is used in the WHERE clause of a parameterized row filter.
job_loginjob_login nvarchar(512)nvarchar(512) Est le compte Windows sous lequel l’agent de fusion s’exécute, ce qui est retourné sous la forme domaine\nom d’utilisateur.Is the Windows account under which the Merge agent runs, which is returned in the format domain\username.
job_passwordjob_password sysnamesysname Pour des raisons de sécurité, une valeur de « ********** » est toujours retourné.For security reasons, a value of "**********" is always returned.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

sp_helpmergepullsubscription est utilisé dans la réplication de fusion.sp_helpmergepullsubscription is used in merge replication. Dans le jeu de résultats, la date renvoyée dans last_updated sous la forme de aaaammjj hh:mm:ss.fff.In the result set, the date returned in last_updated is formatted as YYYYMMDD hh:mm:ss.fff.

AutorisationsPermissions

Seuls les membres de la sysadmin rôle serveur fixe et le db_owner rôle de base de données fixe peuvent exécuter sp_helpmergepullsubscription.Only members of the sysadmin fixed server role and the db_owner fixed database role can execute sp_helpmergepullsubscription.

Voir aussiSee Also

sp_addmergepullsubscription (Transact-SQL) sp_addmergepullsubscription (Transact-SQL)
sp_changemergepullsubscription (Transact-SQL) sp_changemergepullsubscription (Transact-SQL)
sp_dropmergepullsubscription (Transact-SQL) sp_dropmergepullsubscription (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)