sp_helppublication (Transact-SQL)sp_helppublication (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

Renvoie des informations sur une publication.Returns information about a publication. Pour une MicrosoftMicrosoft SQL ServerSQL Server publication, cette procédure stockée est exécutée sur la base de données de publication du serveur de publication.For a MicrosoftMicrosoft SQL ServerSQL Server publication, this stored procedure is executed at the Publisher on the publication database. Pour une publication Oracle, cette procédure stockée est exécutée sur n'importe quelle base de données du serveur de distribution.For an Oracle publication, this stored procedure is executed at the Distributor on any database.

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

SyntaxeSyntax

  
sp_helppublication [ [ @publication = ] 'publication' ]  
    [ , [ @found=] found OUTPUT]  
    [ , [ @publisher = ] 'publisher' ]  

ArgumentsArguments

[ @publication = ] 'publication'Nom de la publication à afficher.[ @publication = ] 'publication' Is the name of the publication to be viewed. publication est de type sysname, avec la % valeur par défaut, qui retourne des informations sur toutes les publications.publication is sysname, with a default of %, which returns information about all publications.

[ @found = ] 'found' OUTPUTIndicateur qui signale le retour de lignes.[ @found = ] 'found' OUTPUT Is a flag to indicate returning rows. valeur de type int et paramètre de sortie, avec la valeur par défaut 23456.foundis int and an OUTPUT parameter, with a default of 23456. 1 indique que la publication est trouvée.1 indicates the publication is found. 0 indique que la publication est introuvable.0 indicates the publication is not found.

[ @publisher = ] 'publisher'Spécifie un serveur SQL ServerSQL Server de publication non-.[ @publisher = ] 'publisher' Specifies a non- SQL ServerSQL Server publisher. Publisher est de type sysname, avec NULL comme valeur par défaut.publisher is sysname, with a default of NULL.

Notes

l' éditeur ne doit pas être spécifié lors de la demande SQL ServerSQL Server d’informations de publication à partir d’un serveur de publication.publisher should not be specified when requesting publication information from a SQL ServerSQL Server Publisher.

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
pubidpubid intint ID de la publication.ID for the publication.
namename sysnamesysname Nom de la publication.Name of the publication.
restrictedrestricted intint Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.
statusstatus tinyinttinyint État actuel de la publication.The current status of the publication.

0 = inactif.0 = Inactive.

1 = actif.1 = Active.
tâchetask Utilisé pour la compatibilité descendante.Used for backward compatibility.
replication frequencyreplication frequency tinyinttinyint Type de fréquence de réplication :Type of replication frequency:

0 = transactionnel0 = Transactional

1 = instantané1 = Snapshot
synchronization methodsynchronization method tinyinttinyint Mode de synchronisation :Synchronization mode:

0 = programme de copie en bloc natif (utilitaireBCP )0 = Native bulk copy program (bcp utility)

1 = copie en bloc de caractères1 = Character bulk copy

3 = simultané, ce qui signifie que la copie en bloc native (utilitaireBCP) est utilisée, mais que les tables ne sont pas verrouillées lors de l’instantané3 = Concurrent, which means that native bulk copy (bcputility) is used but tables are not locked during the snapshot

4 = concurrent_c, ce qui signifie que la copie en bloc de caractères est utilisée, mais que les tables ne sont pas verrouillées lors de l’instantané4 = Concurrent_c, which means that character bulk copy is used but tables are not locked during the snapshot
descriptiondescription nvarchar(255)nvarchar(255) Description facultative de la publication.Optional description for the publication.
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.
enabled_for_internetenabled_for_internet bitbit Indique si les fichiers de synchronisation pour la publication sont accessibles sur Internet par le biais du protocole FTP et d'autres services.Whether the synchronization files for the publication are exposed to the Internet, through file transfer protocol (FTP) and other services.
allow_pushallow_push bitbit Indique si des abonnements par envoi de données (push) sont autorisés pour la publication.Whether push subscriptions are allowed on the publication.
allow_pullallow_pull bitbit Indique si des abonnements par extraction de données (pull) sont autorisés pour la publication.Whether pull subscriptions are allowed on the publication.
allow_anonymousallow_anonymous bitbit Indique si des abonnements anonymes sont autorisés pour la publication.Whether anonymous subscriptions are allowed on the publication.
independent_agentindependent_agent bitbit Indique s'il existe une version autonome de l'Agent de distribution pour cette publication.Whether there is a stand-alone Distribution Agent for this publication.
immediate_sync_readyimmediate_sync_ready bitbit Indique si l'Agent d'instantané a généré un instantané utilisable par les nouveaux abonnements.Whether or not the Snapshot Agent generated a snapshot that is ready to be used by new subscriptions. Ce paramètre est défini seulement si la publication est configurée de telle sorte qu'un instantané soit toujours disponible pour les abonnements nouveaux ou réinitialisés.This parameter is defined only if the publication is set to always have a snapshot available for new or reinitialized subscriptions.
allow_sync_tranallow_sync_tran bitbit Indique si des abonnements mis à jour immédiatement sont autorisés pour la publication.Whether immediate-updating subscriptions are allowed on the publication.
autogen_sync_procsautogen_sync_procs bitbit Indique s'il faut générer automatiquement les procédures stockées pour la prise en charge des abonnements mis à jour immédiatement.Whether to automatically generate stored procedures to support immediate-updating subscriptions.
snapshot_jobidsnapshot_jobid binary(16)binary(16) ID de tâche planifiéeScheduled task ID.
retentionretention intint Volume des modifications, en heures, à enregistrer pour la publication donnée.Amount of change, in hours, to save for the given publication.
has subscriptionhas subscription bitbit Indique si la publication a des abonnements actifs.If the publication has an active subscriptions. 1 signifie que la publication a des abonnements actifs et 0 signifie que la publication n’a pas d’abonnement.1 means that the publication has active subscriptions, and 0 means that the publication has no subscriptions.
allow_queued_tranallow_queued_tran bitbit Spécifie si la mise en file d’attente des modifications sur l’abonné jusqu’à ce qu’elles puissent être appliquées sur le serveur de publication a été activée.Specifies whether disables queuing of changes at the Subscriber until they can be applied at the Publisher has been enabled. Si la valeur est 0, les modifications apportées à l’abonné ne sont pas mises en file d’attente.If 0, changes at the Subscriber are not queued.
snapshot_in_defaultfoldersnapshot_in_defaultfolder bitbit Spécifie si les fichiers d’instantanés sont stockés dans le dossier par défaut.Specifies whether snapshot files are stored in the default folder. Si la valeur est 0, les fichiers d’instantanés ont été stockés à l’emplacement secondaire spécifié par alternate_snapshot_folder.If 0, snapshot files have been stored in the alternate location specified by alternate_snapshot_folder. Si la valeur est 1, les fichiers d’instantanés se trouvent dans le dossier par défaut.If 1, snapshot files can be found in the default folder.
alt_snapshot_folderalt_snapshot_folder nvarchar(255)nvarchar(255) Indique l'emplacement du dossier de remplacement pour l'instantané.Specifies the location of the alternate folder for the snapshot.
pre_snapshot_scriptpre_snapshot_script nvarchar(255)nvarchar(255) Spécifie un pointeur vers un emplacement de fichier . SQL .Specifies a pointer to an .sql file location. L'Agent de distribution exécute le script de pré-instantané avant l'exécution des scripts d'objet répliqué, lors de l'application d'un instantané sur un Abonné.The Distribution Agent will run the pre-snapshot script before running any of the replicated object scripts when applying a snapshot at a Subscriber.
post_snapshot_scriptpost_snapshot_script nvarchar(255)nvarchar(255) Spécifie un pointeur vers un emplacement de fichier . SQL .Specifies a pointer to an .sql file location. L'Agent de distribution exécute le script de post-instantané après que tous les autres scripts et données d'objet répliqué ont été appliqués lors d'une synchronisation initiale.The Distribution Agent will run the post-snapshot script after all the other replicated object scripts and data have been applied during an initial synchronization.
compress_snapshotcompress_snapshot bitbit Spécifie que l’instantané écrit à l’emplacement alt_snapshot_folder doit être compressé MicrosoftMicrosoft au format cab.Specifies that the snapshot that is written to the alt_snapshot_folder location is to be compressed into the MicrosoftMicrosoft CAB format. 0 indique que l’instantané ne sera pas compressé.0 specifies that the snapshot will not be compressed.
ftp_addressftp_address sysnamesysname Adresse réseau du service FTP du serveur de distribution.The network address of the FTP service for the Distributor. Indique l'emplacement à partir duquel l'Agent de distribution ou l'Agent de fusion d'un abonné peut extraire les fichiers d'instantané de la publication.Specifies where publication snapshot files are located for the Distribution Agent or Merge Agent of a subscriber to pick up.
ftp_portftp_port Intint Numéro de port du service FTP du serveur de distribution.The port number of the FTP service for the Distributor.
ftp_subdirectoryftp_subdirectory nvarchar(255)nvarchar(255) Indique l'emplacement à partir duquel l'Agent de distribution ou de fusion d'un abonné peut extraire les fichiers d'instantané si la publication prend en charge la propagation d'instantanés via FTP.Specifies where the snapshot files will be available for the Distribution Agent or Merge Agent of subscriber to pick up if the publication supports propagating snapshots using FTP.
ftp_loginftp_login sysnamesysname Nom d'utilisateur, utilisé pour la connexion au service FTP.The username used to connect to the FTP service.
allow_dtsallow_dts bitbit Indique que la publication autorise les transformations de données.Specifies that the publication allows data transformations. 0 indique que les transformations DTS ne sont pas autorisées.0 specifies that DTS transformations are not allowed.
allow_subscription_copyallow_subscription_copy bitbit Spécifie si la possibilité de copier les bases de données d'abonnement qui s'abonnent à cette publication a été activée.Specifies whether the ability to copy the subscription databases that subscribe to this publication has been enabled. 0 signifie que la copie n’est pas autorisée.0 means that copying is not allowed.
centralized_conflictscentralized_conflicts bitbit Spécifie si les enregistrements en conflit sont stockés sur le serveur de publication :Specifies whether conflict records are stored on the Publisher:

0 = les enregistrements en conflit sont stockés sur le serveur de publication et sur l’abonné à l’origine du conflit.0 = Conflict records are stored at both the publisher and at the subscriber that caused the conflict.

1 = les enregistrements en conflit sont stockés sur le serveur de publication.1 = Conflict records are stored at the Publisher.
conflict_retentionconflict_retention intint Spécifie la durée de rétention des conflits en jours.Specifies the conflict retention period, in days.
conflict_policyconflict_policy Intint Spécifie la stratégie de résolution de conflits à suivre lorsque l'option d'abonné avec mise à jour en attente est utilisée.Specifies the conflict resolution policy followed when the queued updating subscriber option is used. Peut prendre l'une des valeurs suivantes :Can be one of these values:

1 = le serveur de publication gagne le conflit.1 = Publisher wins the conflict.

2 = l’abonné gagne le conflit.2 = Subscriber wins the conflict.

3 = l’abonnement est réinitialisé.3 = Subscription is reinitialized.
queue_typequeue_type Spécifie le type de file d'attente utilisé.Specifies which type of queue is used. Peut prendre l'une des valeurs suivantes :Can be one of these values:

MSMQ = utilisez MicrosoftMicrosoft Message Queuing pour stocker les transactions.msmq = Use MicrosoftMicrosoft Message Queuing to store transactions.

SQL = utilisé SQL ServerSQL Server pour stocker les transactions.sql = Use SQL ServerSQL Server to store transactions.

Remarque : La prise en charge de Message Queuing a été interrompue.Note: Support for Message Queuing has been discontinued.
backward_comp_levelbackward_comp_level Niveau de compatibilité de la base de données. Il peut avoir une des valeurs suivantes :Database compatibility level, and can be one of the following:

90 = MicrosoftMicrosoft SQL Server 2005 (9.x)SQL Server 2005 (9.x)90 = MicrosoftMicrosoft SQL Server 2005 (9.x)SQL Server 2005 (9.x)

100 = MicrosoftMicrosoft SQL Server 2008SQL Server 2008100 = MicrosoftMicrosoft SQL Server 2008SQL Server 2008
publish_to_ADpublish_to_AD bitbit Spécifie si la publication est publiée dans MicrosoftMicrosoft le Active Directory???.Specifies whether the publication is published in the MicrosoftMicrosoft Active Directory???. La valeur 1 indique qu’elle est publiée, tandis que la valeur 0 indique qu’elle n’est pas publiée.A value of 1 indicates that it is published, and a value of 0 indicates that it is not published.
allow_initialize_from_backupallow_initialize_from_backup bitbit Indique si les Abonnés peuvent initialiser un abonnement à cette publication à partir d'une sauvegarde plutôt qu'à partir de son instantané initial.Indicates if Subscribers can initialize a subscription to this publication from a backup rather than an initial snapshot. 1 signifie que les abonnements peuvent être initialisés à partir d’une sauvegarde, et 0 signifie qu’ils ne le peuvent pas.1 means that subscriptions can be initialized from a backup, and 0 means that they cannot. Pour plus d’informations, consultez initialiser un abonnement transactionnel sans instantané un abonné transactionnel sans instantané.For more information, see Initialize a Transactional Subscription Without a Snapshot a transactional Subscriber without a snapshot.
replicate_ddlreplicate_ddl Intint Précise si la réplication de schéma est prise en charge pour la publication.Indicates if schema replication is supported for the publication. 1 indique que les instructions DDL (Data Definition Language) exécutées sur le serveur de publication sont répliquées, et 0 indique que les instructions DDL ne sont pas répliquées.1 indicates that data definition language (DDL) statements executed at the publisher are replicated, and 0 indicates that DDL statements are not replicated. Pour plus d’informations, consultez Modifier le schéma dans les bases de données de publication.For more information, see Make Schema Changes on Publication Databases.
enabled_for_p2penabled_for_p2p intint Indique si la publication est utilisable dans une topologie de réplication d'égal à égal.If the publication can be used in a peer-to-peer replication topology. 1 indique que la publication prend en charge la réplication d’égal à égal.1 indicates that the publication supports peer-to-peer replication. Pour plus d'informations, consultez Peer-to-Peer Transactional Replication.For more information, see Peer-to-Peer Transactional Replication.
publish_local_changes_onlypublish_local_changes_only intint Identifié à titre d'information uniquement.Identified for informational purposes only. Non pris en charge.Not supported. La compatibilité future n'est pas garantie.Future compatibility is not guaranteed.
enabled_for_het_subenabled_for_het_sub intint Spécifie si la publication prend en charge les Abonnés non-SQL ServerSQL Server.Specifies whether the publication supports non-SQL ServerSQL Server Subscribers. La valeur 1 signifie que les abonnés nonSQL ServerSQL Server -sont pris en charge.A value of 1 means that non-SQL ServerSQL Server Subscribers are supported. La valeur 0 signifie que seuls SQL ServerSQL Server les abonnés sont pris en charge.A value of 0 means that only SQL ServerSQL Server Subscribers are supported. Pour plus d’informations, consultez Non-SQL Server Subscribers.For more information, see Non-SQL Server Subscribers.
enabled_for_p2p_conflictdetectionenabled_for_p2p_conflictdetection Intint Spécifie si l'Agent de distribution détecte des conflits pour une publication activée pour la réplication d'égal à égal.Specifies whether the Distribution Agent detects conflicts for a publication that is enabled for peer-to-peer replication. La valeur 1 signifie que les conflits sont détectés.A value of 1 means that conflicts are detected. Pour plus d’informations, voir Conflict Detection in Peer-to-Peer Replication.For more information, see Conflict Detection in Peer-to-Peer Replication.
originator_idoriginator_id Intint Spécifie un ID pour un nœud dans une topologie d'égal à égal.Specifies an ID for a node in a peer-to-peer topology. Cet ID est utilisé pour la détection de conflit si enabled_for_p2p_conflictdetection a la valeur 1.This ID is used for conflict detection if enabled_for_p2p_conflictdetection is set to 1. Pour obtenir la liste des ID qui ont déjà été utilisés, interrogez la table système Mspeer_originatorid_history .For a list of IDs that have already been used, query the Mspeer_originatorid_history system table.
p2p_continue_onconflictp2p_continue_onconflict intint Indique si l'Agent de distribution continue à traiter les modifications lorsqu'un conflit est détecté.Specifies whether The Distribution Agent continues to process changes when a conflict is detected. La valeur 1 signifie que l’agent continue à traiter les modifications.A value of 1 means that the agent continues to process changes.

Attentionnous*vous recommandons d’utiliser la valeur par défaut 0. * * *** Caution ** We recommend that you use the default value of 0. Lorsque cette option a la valeur 1, le agent de distribution tente de converger les données dans la topologie en appliquant la ligne en conflit du nœud qui a l’ID d’appelant le plus élevé.When this option is set to 1, the Distribution Agent tries to converge data in the topology by applying the conflicting row from the node that has the highest originator ID. Cette méthode ne garantit pas la convergence.This method does not guarantee convergence. Vous devez vous assurer que la topologie est cohérente après la détection d'un conflit.You should make sure that the topology is consistent after a conflict is detected. Pour plus d'informations, consultez « Gestion des conflits » dans Conflict Detection in Peer-to-Peer Replication.For more information, see "Handling Conflicts" in Conflict Detection in Peer-to-Peer Replication.
allow_partition_switchallow_partition_switch intint Spécifie si ALTER TABLE... Les instructions SWITCH peuvent être exécutées sur la base de données publiée.Specifies whether ALTER TABLE...SWITCH statements can be executed against the published database. Pour plus d’informations, consultez Répliquer des tables et des index partitionnés.For more information, see Replicate Partitioned Tables and Indexes.
replicate_partition_switchreplicate_partition_switch intint Spécifie si ALTER TABLE... Les instructions SWITCH exécutées sur la base de données publiée doivent être répliquées sur les abonnés.Specifies whether ALTER TABLE...SWITCH statements that are executed against the published database should be replicated to Subscribers. Cette option est valide uniquement si allow_partition_switch a la valeur 1.This option is valid only if allow_partition_switch is set to 1.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

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

sp_helppublication renvoie des informations sur toutes les publications dont l'utilisateur qui exécute cette procédure est propriétaire.sp_helppublication will return information on all publications that are owned by the user executing this procedure.

ExempleExample

DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran' 

USE [AdventureWorks2012]
EXEC sp_helppublication @publication = @myTranPub
GO

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin sur le serveur de publication, les membres du rôle de base de données fixe db_owner de la base de données de publication ou les utilisateurs de la liste d'accès aux publications (PAL) peuvent exécuter sp_helppublication.Only members of the sysadmin fixed server role at the Publisher or members of the db_owner fixed database role on the publication database or users in the publication access list (PAL) can execute sp_helppublication.

Pour un serveur de SQL ServerSQL Server publication non-, seuls les membres du rôle serveur fixe sysadmin sur le serveur de distribution ou les membres du rôle de base de données fixe db_owner sur la base de données de distribution ou les utilisateurs de la PAL peuvent exécuter sp_helppublication.For a non- SQL ServerSQL Server Publisher, only members of the sysadmin fixed server role at the Distributor or members of the db_owner fixed database role on the distribution database or users in the PAL can execute sp_helppublication.

Voir aussiSee Also

Afficher et modifier les propriétés d’une publication View and Modify Publication Properties
sp_addpublication (Transact-SQL) sp_addpublication (Transact-SQL)
sp_changepublication (Transact-SQL) sp_changepublication (Transact-SQL)
sp_droppublication (Transact-SQL) sp_droppublication (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)Replication Stored Procedures (Transact-SQL)