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)
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour