sp_helppublication (Transact-SQL)

S’applique à :SQL ServerAzure SQL Managed Instance

Renvoie des informations sur une publication. Pour une publication Microsoft SQL Server, cette procédure stockée est exécutée sur le serveur de publication sur la base de données de publication. 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.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @publication = ] 'publication' Nom de la composition à afficher. publication est sysname, avec une valeur par défaut de %, qui retourne des informations sur toutes les publications.

[ @found = ] 'found' OUTPUT Indicateur pour indiquer les lignes retournées. found est int et un paramètre OUTPUT, avec une valeur par défaut de 23456. 1 indique que la composition est trouvée. 0 indique que la publication est introuvable.

[ @publisher = ] 'publisher'Spécifie un éditeur non SQL Server. publisher est sysname, avec une valeur par défaut NULL.

Notes

publisher ne doit pas être spécifié lors de la demande d’informations de publication à un SQL Server Publisher.

Jeux de résultats

Nom de la colonne	Type de données	Description
pubid	int	ID de la composition.
name	sysname	Nom de la publication.
restricted	int	Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
status	tinyint	État actuel de la publication. 0 = Inactif. 1 = Actif.
tâche		Utilisé pour la compatibilité descendante.
replication frequency	tinyint	Type de fréquence de réplication : 0 = Transactionnelle 1 = Instantané
synchronization method	tinyint	Mode de synchronisation : 0 = Programme de copie en bloc native (utilitaire bcp ) 1 = Copie en bloc de caractères 3 = Simultané, ce qui signifie que la copie en bloc native (utilitaire bcp) est utilisée, mais que les tables ne sont pas verrouillées pendant la instantané 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 pendant la instantané
description	nvarchar(255)	Description facultative de la composition.
immediate_sync	bit	Indique si les fichiers de synchronisation sont créés ou recréés à chaque exécution de l’Agent d'instantané.
enabled_for_internet	bit	Indique si les fichiers de synchronisation pour la publication sont accessibles sur Internet par le biais du protocole FTP et d'autres services.
allow_push	bit	Indique si des abonnements par envoi de données (push) sont autorisés pour la publication.
allow_pull	bit	Indique si des abonnements par extraction de données (pull) sont autorisés pour la publication.
allow_anonymous	bit	Indique si des abonnements anonymes sont autorisés pour la publication.
independent_agent	bit	Indique s'il existe une version autonome de l'Agent de distribution pour cette publication.
immediate_sync_ready	bit	Indique si l'Agent d'instantané a généré un instantané utilisable par les nouveaux abonnements. 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.
allow_sync_tran	bit	Indique si des abonnements mis à jour immédiatement sont autorisés pour la publication.
autogen_sync_procs	bit	Indique s'il faut générer automatiquement les procédures stockées pour la prise en charge des abonnements mis à jour immédiatement.
snapshot_jobid	binary(16)	ID de tâche planifiée
retention	int	Volume des modifications, en heures, à enregistrer pour la publication donnée.
has subscription	bit	Indique si la publication a des abonnements actifs. 1 signifie que la publication a des abonnements actifs, et 0 signifie que la publication n’a pas d’abonnements.
allow_queued_tran	bit	Spécifie si la mise en file d’attente des modifications sur l’Abonné jusqu’à ce qu’elles puissent être appliquées au serveur de publication a été activée. Si la valeur est 0, les modifications sur l’Abonné ne sont pas mises en file d’attente.
snapshot_in_defaultfolder	bit	Spécifie si les fichiers instantané sont stockés dans le dossier par défaut. Si la valeur est 0, instantané fichiers ont été stockés à l’autre emplacement spécifié par alternate_snapshot_folder. Si la valeur est 1, instantané fichiers se trouvent dans le dossier par défaut.
alt_snapshot_folder	nvarchar(255)	Indique l'emplacement du dossier de remplacement pour l'instantané.
pre_snapshot_script	nvarchar(255)	Spécifie un pointeur vers un emplacement de fichier .sql . 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é.
post_snapshot_script	nvarchar(255)	Spécifie un pointeur vers un emplacement de fichier .sql . 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.
compress_snapshot	bit	Spécifie que le instantané écrit dans l’emplacement alt_snapshot_folder doit être compressé au format CAB Microsoft. 0 spécifie que le instantané ne sera pas compressé.
ftp_address	sysname	Adresse réseau du service FTP pour le serveur de distribution. 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.
ftp_port	int	Numéro de port du service FTP pour le serveur de distribution.
ftp_subdirectory	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.
ftp_login	sysname	Nom d'utilisateur, utilisé pour la connexion au service FTP.
allow_dts	bit	Indique que la publication autorise les transformations de données. 0 spécifie que les transformations DTS ne sont pas autorisées.
allow_subscription_copy	bit	Spécifie si la possibilité de copier les bases de données d'abonnement qui s'abonnent à cette publication a été activée. 0 signifie que la copie n’est pas autorisée.
centralized_conflicts	bit	Spécifie si les enregistrements en conflit sont stockés sur le serveur de publication : 0 = Les enregistrements de conflit sont stockés à la fois sur l’éditeur et sur l’abonné à l’origine du conflit. 1 = Les enregistrements de conflit sont stockés sur le serveur de publication.
conflict_retention	int	Spécifie la durée de rétention des conflits en jours.
conflict_policy	int	Spécifie la stratégie de résolution de conflits à suivre lorsque l'option d'abonné avec mise à jour en attente est utilisée. Peut prendre l'une des valeurs suivantes : 1 = Le serveur de publication remporte le conflit. 2 = L’abonné gagne le conflit. 3 = L’abonnement est réinitialisé.
queue_type		Spécifie le type de file d'attente utilisé. Peut prendre l'une des valeurs suivantes : msmq = Utiliser Microsoft Message Queuing pour stocker les transactions. sql = Utiliser SQL Server pour stocker les transactions. Remarque : La prise en charge de Message Queuing a été interrompue.
backward_comp_level		Niveau de compatibilité de la base de données. Il peut avoir une des valeurs suivantes : 90 = Microsoft SQL Server 2005 (9.x) 100 = Microsoft SQL Server 2008 (10.0.x)
publish_to_AD	bit	Spécifie si la publication est publiée dans Microsoft Active Directory. La valeur 1 indique qu’elle est publiée et la valeur 0 indique qu’elle n’est pas publiée.
allow_initialize_from_backup	bit	Indique si les Abonnés peuvent initialiser un abonnement à cette publication à partir d'une sauvegarde plutôt qu'à partir de son instantané initial. 1 signifie que les abonnements peuvent être initialisés à partir d’une sauvegarde, et 0 signifie qu’ils ne peuvent pas. Pour plus d’informations, consultez Initialiser un abonnement transactionnel sans instantané un abonné transactionnel sans instantané.
replicate_ddl	int	Précise si la réplication de schéma est prise en charge pour la 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. Pour plus d’informations, consultez Modifier le schéma dans les bases de données de publication.
enabled_for_p2p	int	Indique si la publication est utilisable dans une topologie de réplication d'égal à égal. 1 indique que la publication prend en charge la réplication d’égal à égal. Pour plus d'informations, consultez Peer-to-Peer Transactional Replication.
publish_local_changes_only	int	Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
enabled_for_het_sub	int	Spécifie si la publication prend en charge les Abonnés non SQL Server. La valeur 1 signifie que les Abonnés non SQL Server sont pris en charge. La valeur 0 signifie que seuls SQL Server Abonnés sont pris en charge. Pour plus d’informations, consultez Non-SQL Server Subscribers.
enabled_for_p2p_conflictdetection	int	Spécifie si l'Agent de distribution détecte des conflits pour une publication activée pour la réplication d'égal à égal. La valeur 1 signifie que des conflits sont détectés. Pour plus d’informations, voir Conflict Detection in Peer-to-Peer Replication.
originator_id	int	Spécifie un ID pour un nœud dans une topologie d'égal à égal. Cet ID est utilisé pour la détection des conflits si enabled_for_p2p_conflictdetection a la valeur 1. Pour obtenir la liste des ID qui ont déjà été utilisés, interrogez la table système Mspeer_originatorid_history .
p2p_continue_onconflict	int	Indique si l'Agent de distribution continue à traiter les modifications lorsqu'un conflit est détecté. La valeur 1 signifie que l’agent continue de traiter les modifications. **Attention** Nous vous recommandons d’utiliser la valeur par défaut 0. Lorsque cette option a la valeur 1, le Agent de distribution tente de faire converger les données dans la topologie en appliquant la ligne en conflit à partir du nœud qui a l’ID d’expéditeur le plus élevé. Cette méthode ne garantit pas la convergence. Vous devez vous assurer que la topologie est cohérente après la détection d'un conflit. Pour plus d'informations, consultez « Gestion des conflits » dans Conflict Detection in Peer-to-Peer Replication.
allow_partition_switch	int	Spécifie si ALTER TABLE... Les instructions SWITCH peuvent être exécutées sur la base de données publiée. Pour plus d’informations, consultez Répliquer des tables et des index partitionnés.
replicate_partition_switch	int	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. Cette option est valide uniquement si allow_partition_switch a la valeur 1.
enabled_for_p2p_lastwriter_conflictdetection	int	À compter de SQL Server 2019 (15.x) CU 13, spécifie si le Agent de distribution détecte les conflits du dernier writer pour une publication activée pour la réplication d’égal à égal. La valeur 1 signifie que les conflits du dernier writer sont détectés.

Codet de retour

0 (réussite) ou 1 (échec)

Notes

sp_helppublication est utilisé dans la réplication transactionnelle et d'instantané.

sp_helppublication renvoie des informations sur toutes les publications dont l'utilisateur qui exécute cette procédure est propriétaire.

Exemple

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

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

Autorisations

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.

Pour un serveur de publication non SQL Server, 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 dans le pal peuvent exécuter sp_helppublication.

Voir aussi

Afficher et modifier les propriétés d’une publication
sp_addpublication (Transact-SQL)
sp_changepublication (Transact-SQL)
sp_droppublication (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)