sp_helppullsubscription (Transact-SQL)sp_helppullsubscription (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

Affiche des informations relatives à un ou plusieurs abonnements de l'Abonné.Displays information about one or more subscriptions at the 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_helppullsubscription [ [ @publisher = ] 'publisher' ]  
    [ , [ @publisher_db = ] 'publisher_db' ]   
    [ , [ @publication = ] 'publication' ]  
    [ , [ @show_push = ] 'show_push' ]  

ArgumentsArguments

[ @publisher = ] 'publisher'Nom du serveur distant.[ @publisher = ] 'publisher' Is the name of the remote server. Publisher est de % type sysname, avec la valeur par défaut, qui retourne des informations pour tous les serveurs de publication.publisher is sysname, with a default of %, which returns information for all Publishers.

[ @publisher_db = ] 'publisher_db'Nom de la base de données du serveur de publication.[ @publisher_db = ] 'publisher_db' Is the name of the Publisher database. publisher_db est de % type sysname, avec la valeur par défaut, qui retourne toutes les bases de données de serveur de publication.publisher_db is sysname, with a default of %, which returns all the Publisher databases.

[ @publication = ] 'publication'Nom de la publication.[ @publication = ] 'publication' Is the name of the publication. publication est de % type sysname, avec la valeur par défaut, qui retourne toutes les publications.publication is sysname, with a default of %, which returns all the publications. Si ce paramètre est égal à ALL, seuls les abonnements par extraction avec independent_agent = 0 sont retournés.If this parameter equals to ALL, only pull subscriptions with independent_agent = 0 are returned.

[ @show_push = ] 'show_push'Indique si tous les abonnements par envoi de notification doivent être retournés.[ @show_push = ] 'show_push' Is whether all push subscriptions are to be returned. show_pushest de type nvarchar (5) , avec false comme valeur par défaut, qui ne retourne pas d’abonnements par envoi de notification.show_pushis nvarchar(5), with a default of FALSE, which does not return push subscriptions.

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
publisher (serveur de publication)publisher sysnamesysname Nom du serveur de publication.Name of the Publisher.
base de données du serveur de publicationpublisher database sysnamesysname Nom de la base de données du serveur de publication.Name of the Publisher database.
publicationpublication sysnamesysname Nom de la publication.Name of the publication.
independent_agentindependent_agent bitbit Indique s'il existe un Agent de distribution autonome pour cette publication.Indicates whether there is a stand-alone Distribution Agent for this publication.
type d’abonnementsubscription type intint Type d'abonnement à la publication.Subscription type to the publication.
agent de distributiondistribution agent nvarchar(100)nvarchar(100) Agent de distribution traitant l'abonnement.Distribution Agent handling the subscription.
Description de la publicationpublication description nvarchar(255)nvarchar(255) Description de la publication.Description of the publication.
heure de la dernière mise à jourlast updating time datedate Heure à laquelle les informations d'abonnement ont été mises à jour.Time the subscription information was updated. Il s'agit d'une chaîne UNICODE de date ISO (114) et d'heure ODBC (121).This is a UNICODE string of ISO date (114) + ODBC time (121). Le format est aaaammjj hh:mi:sss.mmm où aaaa représente l'année, mm le mois, jj le jour, hh l'heure, mi les minutes, sss les secondes et mmm les millisecondes.The format is yyyymmdd hh:mi:sss.mmm where 'yyyy' is year, 'mm' is month, 'dd' is day, 'hh' is hour, 'mi' is minute, 'sss' is seconds, and 'mmm' is milliseconds.
nom de l’abonnementsubscription name varchar(386)varchar(386) Nom de l'abonnement.Name of the subscription.
horodateur de la dernière transactionlast transaction timestamp varbinary(16)varbinary(16) Horodateur de la dernière transaction dupliquée.Timestamp of the last replicated transaction.
mode de mise à jourupdate mode tinyinttinyint Types de mise à jour autorisésType of updates allowed.
job_id de l’agent de distributiondistribution agent job_id intint ID du travail de l'Agent de distribution.Job ID of the Distribution Agent.
enabled_for_synmgrenabled_for_synmgr 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.
GUID de l’abonnementsubscription guid binary(16)binary(16) Identificateur global de la version d'abonnement associée à une publicationGlobal identifier for the version of the subscription on the publication.
subidsubid binary(16)binary(16) Identificateur global d'un abonnement anonymeGlobal identifier for an anonymous subscription.
immediate_syncimmediate_sync bitbit Indique si les fichiers de synchronisation sont créés ou recréés à chaque exécution de l’Agent d'instantané.Whether the synchronization files are created or re-created each time the Snapshot Agent runs.
connexion de l’éditeurpublisher login sysnamesysname ID de connexion utilisé côté serveur de publication pour l'authentification SQL ServerSQL ServerLogin ID used at the Publisher for SQL ServerSQL Server Authentication.
mot de passe du serveur de publicationpublisher password nvarchar(524)nvarchar(524) Mot de passe (chiffré) utilisé côté serveur de publication pour l'authentification SQL ServerSQL ServerPassword (encrypted) used at the Publisher for SQL ServerSQL Server Authentication.
security_mode du serveur de publicationpublisher security_mode Intint Mode de sécurité implémenté sur le serveur de publication :Security mode implemented at the Publisher:

0 = authentificationSQL ServerSQL Server0 = SQL ServerSQL Server Authentication

1 = authentification Windows1 = Windows Authentication

2 = les déclencheurs de synchronisation utilisent une entrée sysservers statique pour effectuer un appel de procédure distante (RPC), et le serveur de publication doit être défini dans la table sysservers en tant que serveur distant ou serveur lié.2 = The synchronization triggers use a static sysservers entry to do remote procedure call (RPC), and publisher must be defined in the sysservers table as a remote server or linked server.
distributordistributor sysnamesysname Nom du serveur de distribution.Name of the Distributor.
distributor_logindistributor_login sysnamesysname ID de connexion utilisé côté serveur de distribution pour l'authentification SQL ServerSQL ServerLogin ID used at the Distributor for SQL ServerSQL Server Authentication.
distributor_passworddistributor_password nvarchar(524)nvarchar(524) Mot de passe (chiffré) utilisé sur le serveur SQL ServerSQL Server de distribution pour l’authentification.Password (encrypted) used at the Distributor for SQL ServerSQL Server Authentication.
distributor_security_modedistributor_security_mode Intint Mode de sécurité implémenté sur le serveur de distribution:Security mode implemented at the Distributor:

0 = authentificationSQL ServerSQL Server0 = SQL ServerSQL Server Authentication

1 = authentification Windows1 = Windows Authentication
ftp_addressftp_address sysnamesysname Pour compatibilité descendante uniquement.For backward compatibility only.
ftp_portftp_port intint Pour compatibilité descendante uniquement.For backward compatibility only.
ftp_loginftp_login sysnamesysname Pour compatibilité descendante uniquement.For backward compatibility only.
ftp_passwordftp_password nvarchar(524)nvarchar(524) Pour compatibilité descendante uniquement.For backward compatibility only.
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 (File Transfer Protocol) lorsque cette option est spécifiée.Fully qualified path to the directory where snapshot files are transferred using File Transfer Protocol (FTP) when that option is specified.
use_ftpuse_ftp bitbit L'abonnement souscrit à la publication via Internet et 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 la valeur est 0, l’abonnement n’utilise pas FTP.If 0, Subscription is not using FTP. Si la condition est 1, l’abonnement utilise FTP.If 1, subscription is using FTP.
publication_typepublication_type Intint Indique le type de réplication de la publication :Specifies the replication type of the publication:

0 = réplication transactionnelle0 = Transactional replication

1 = réplication de capture instantanée1 = Snapshot replication

2 = réplication de fusion2 = Merge replication
dts_package_namedts_package_name sysnamesysname Spécifie le nom du package DTS (Data Transformation Services).Specifies the name of the Data Transformation Services (DTS) package.
dts_package_locationdts_package_location Intint Emplacement auquel le package DTS est enregistré :Location where the DTS package is stored:

0 = serveur de distribution0 = Distributor

1 = abonné1 = Subscriber
offload_agentoffload_agent bitbit Indique si l'agent peut être activé à distance.Specifies if the agent can be activated remotely. Si la valeur est 0, l’agent ne peut pas être activé à distance.If 0, the agent cannot be activated remotely.
offload_serveroffload_server sysnamesysname Indique le nom de réseau du serveur utilisé pour l'activation à distance.Specifies the network name of the server used for remote activation.
last_sync_statuslast_sync_status intint État de l'abonnement :Subscription status:

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

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

2 = toutes les tâches ont été exécutées avec succès2 = All jobs have executed successfully

3 = au moins un travail est en cours d’exécution3 = 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 tente de s’exécuter après un échec précédent5 = At least one job is attempting to execute after a previous failure

6 = au moins un travail n’a pas réussi à s’exécuter correctement6 = At least one job has failed to execute successfully
last_sync_summarylast_sync_summary sysnamesysname Description des résultats de la dernière synchronisation.Description of last synchronization results.
last_sync_timelast_sync_time datetimedatetime Heure à laquelle les informations d'abonnement ont été mises à jour.Time the subscription information was updated. Il s'agit d'une chaîne UNICODE de date ISO (114) et d'heure ODBC (121).This is a UNICODE string of ISO date (114) + ODBC time (121). Le format est aaaammjj hh:mi:sss.mmm où aaaa représente l'année, mm le mois, jj le jour, hh l'heure, mi les minutes, sss les secondes et mmm les millisecondes.The format is yyyymmdd hh:mi:sss.mmm where 'yyyy' is year, 'mm' is month, 'dd' is day, 'hh' is hour, 'mi' is minute, 'sss' is seconds, and 'mmm' is milliseconds.
job_loginjob_login nvarchar(512)nvarchar(512) Compte Windows sous lequel s’exécute l’agent de distribution, qui est retourné au format domaine\nom d’utilisateur.Is the Windows account under which the Distribution agent runs, which is returned in the format domain\username.
job_passwordjob_password sysnamesysname Pour des raisons de sécurité, la valeur **«***»est*toujoursretournée.****For security reasons, a value of "**********" is always returned.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_helppullsubscription est utilisé dans la réplication transactionnelle et d’instantané.sp_helppullsubscription is used in snapshot and transactional replication.

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin ou du rôle de base de données fixe db_owner peuvent exécuter sp_helppullsubscription .Only members of the sysadmin fixed server role or the db_owner fixed database role can execute sp_helppullsubscription .

Voir aussiSee Also

sp_addpullsubscription (Transact-SQL) sp_addpullsubscription (Transact-SQL)
sp_droppullsubscription (Transact-SQL) sp_droppullsubscription (Transact-SQL)
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)