Partager via


sp_helppublication (Transact-SQL)

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

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @publication = ] 'publication'
    Nom de la publication à afficher. publication est de type sysname, avec % comme valeur par défaut ; celle-ci renvoie des informations sur toutes les publications.

  • [ @found = ] 'found' OUTPUT
    Indicateur désignant les lignes renvoyées. found est de type int, avec 23456 comme valeur par défaut. Il s'agit d'un paramètre OUTPUT. 1 indique que la publication a été trouvée. 0 indique que la publication n'a pas été trouvée.

  • [ @publisher = ] 'publisher'
    Spécifie un serveur de publication non-SQL Server. publisher est de type sysname. Sa valeur par défaut est NULL.

    Notes

    L'argument publisher ne doit pas être utilisé pour demander des informations sur une publication d'un serveur de publication SQL Server.

Ensembles de résultats

Nom de la colonne

Type de données

Description

pubid

int

Identificateur de la publication.

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 = Inactive.

1 = Active.

task

 

Utilisé pour la compatibilité descendante.

replication frequency

tinyint

Type de fréquence de réplication :

0 = Transactionnelle

1 = Capture instantanée

synchronization method

tinyint

Mode de synchronisation :

0 = Programme natif de copie en bloc (utilitaire bcp)

1 = Copie en bloc de caractères

3 = Concurrent : le programme natif de copie en bloc (utilitaire bcp) est utilisé mais les tables ne sont pas verrouillées lors de la capture instantanée

4 = Concurrent_c : la copie en bloc de caractères est utilisée mais les tables ne sont pas verrouillées lors de la capture instantanée

description

nvarchar(255)

Description facultative de la publication.

immediate_sync

bit

Indique si les fichiers de synchronisation sont créés ou recréés à chaque exécution de l’Agent de capture instantanée.

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 de capture instantanée a généré une capture instantanée utilisable par les nouveaux abonnements. Ce paramètre est défini seulement si la publication est configurée de telle sorte qu'une capture instantanée 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, 0 qu'elle n'en a pas.

allow_queued_tran

bit

Indique si la mise en file d'attente des modifications sur l'Abonné jusqu'à leur application sur le serveur de publication est activée. Si la valeur est 0, les modifications effectuées sur l'Abonné ne sont pas mises en file d'attente.

snapshot_in_defaultfolder

bit

Indique si les fichiers de capture instantanée sont stockés dans le dossier par défaut. Si la valeur est égale à 0, les fichiers de capture instantanée sont stockés à l'emplacement secondaire spécifié par alternate_snapshot_folder. Si la valeur est égale à 1, les fichiers de capture instantanée se trouvent dans le dossier par défaut.

alt_snapshot_folder

nvarchar(255)

Indique l'emplacement du dossier de remplacement pour la capture instantanée.

pre_snapshot_script

nvarchar(255)

Spécifie un pointeur vers l'emplacement d'un fichier .sql. L'Agent de distribution exécute le script de pré-capture instantanée avant l'exécution des scripts d'objet répliqué, lors de l'application d'une capture instantanée sur un Abonné.

post_snapshot_script

nvarchar(255)

Spécifie un pointeur vers l'emplacement d'un fichier .sql. L'Agent de distribution exécute le script de post-capture instantanée 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 la capture instantanée écrite à l'emplacement alt_snapshot_folder doit être compressée au format CAB Microsoft. 0 spécifie que la capture instantanée ne sera pas compressée.

ftp_address

sysname

Adresse réseau du service FTP du serveur de distribution. Spécifie l'emplacement à partir duquel l'Agent de distribution ou l'Agent de fusion d'un abonné peut extraire les fichiers de capture instantanée de la publication.

ftp_port

int

Numéro de port du service FTP du 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 de capture instantanée si la publication prend en charge la propagation de captures instantanées via FTP.

ftp_login

sysname

Nom de l'utilisateur, utilisé pour la connexion au service FTP.

allow_dts

bit

Spécifie 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 en conflit sont stockés sur le serveur de publication et sur l'Abonné à l'origine du conflit.

1 = Les enregistrements en 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. Il peut prendre l'une des valeurs suivantes :

1 = Le serveur de publication gagne le conflit.

2 = L'abonné gagne le conflit.

3 = L'abonnement est réinitialisé.

queue_type

 

Indique le type de file d'attente utilisée. Il peut prendre l'une des valeurs suivantes :

msmq = Utilise Microsoft Message Queuing pour stocker les transactions.

sql = Utilise SQL Server pour stocker les transactions.

RemarqueRemarque
La prise en charge de Message Queuing a été arrêtée.

backward_comp_level

 

Niveau de compatibilité de la base de données. Il peut avoir une des valeurs suivantes :

10 = Microsoft SQL Server 7.0

20 = SQL Server 7.0 Service Pack 1

30 = SQL Server 7.0 Service Pack 2

35 = SQL Server 7.0 Service Pack 3

40 = Microsoft SQL Server 2000

50 = SQL Server 2000 Service Pack 1

60 = SQL Server 2000 Service Pack 3

90 = Microsoft SQL Server 2005

100 = Microsoft SQL Server 2008

publish_to_AD

bit

Spécifie si la publication est publiée dans l'annuaire Microsoft Active Directory™. La valeur 1 indique qu'elle est publiée, 0 qu'elle ne l'est pas.

allow_initialize_from_backup

bit

Indique si les Abonnés peuvent initialiser un abonnement à cette publication à partir d'une sauvegarde plutôt que d'une capture instantanée initiale. 1 signifie que l'initialisation est possible à partir d'une sauvegarde, 0 qu'elle ne l'est pas. Pour plus d'informations, consultez Initialisation d'un abonnement transactionnel sans capture instantanée.

replicate_ddl

int

Indique 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 qu'elles ne sont pas répliquées. Pour plus d'informations, consultez Modification du 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 Réplication transactionnelle d'égal à égal.

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. 1 signifie que les Abonnés non-SQL Server sont pris en charge. 0 signifie que les Abonnés non-SQL Server ne sont pas pris en charge. Pour plus d'informations, consultez Abonnés non-SQL Server.

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 les conflits sont détectés. Pour plus d'informations, consultez Détection de conflit dans la réplication d'égal à égal.

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 de conflit si enabled_for_p2p_conflictdetection a la valeur 1. Pour obtenir une 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 à traiter les modifications.

AttentionAttention
Nous vous recommandons d'utiliser la valeur par défaut 0. Lorsque cette option a la valeur 1, l'Agent de distribution tente de converger les données dans la topologie en appliquant la ligne en conflit du nœud doté de l'ID d'appelant 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 Détection de conflit dans la réplication d'égal à égal.

alllow_partition_switch

int

Indique si les instructions ALTER TABLE…SWITCH peuvent être exécutées sur la base de données publiée. Pour plus d'informations, consultez Réplication de tables et d'index partitionnés.

replicate_partition_switch

int

Indique si les instructions ALTER TABLE…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.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Notes

sp_helppublication est utilisé dans la réplication transactionnelle et de capture instantanée.

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 [AdventureWorks2008R2]
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, les membres du rôle de base de données fixe db_owner de la base de données de distribution ou les utilisateurs de la liste d'accès pour cette publication (PAL) peuvent exécuter sp_helppublication.