Partager via


sp_helpmergepublication (Transact-SQL)

Renvoie des informations sur une publication de fusion. Cette procédure stockée est exécutée sur la base de données de publication du serveur de publication.

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

Syntaxe

sp_helpmergepublication [ [ @publication = ] 'publication' ]
    [ , [ @found = ] 'found' OUTPUT ]
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]
    [ , [ @reserved = ] 'reserved' ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @publisher_db = ] 'publisher_db' ]

Arguments

  • [ @publication = ] 'publication'
    Nom de la publication. publication est de type sysname, avec la valeur par défaut %, qui retourne des informations sur toutes les publications de fusion dans la base de données actuelle.

  • [ @found = ] 'found' OUTPUT
    Indicateur désignant les lignes retournées. foundest int avec NULL 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 est introuvable.

  • [ @publication_id**=**\] **'**publication_id' OUTPUT
    Numéro d'identification de la publication. publication_id est de type uniqueidentifier, avec NULL comme valeur par défaut. Il s'agit d'un paramètre OUTPUT.

  • [ @reserved**=**\] 'reserved'
    Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. reserved est de type nvarchar(20), avec NULL comme valeur par défaut.

  • [ @publisher**=** ] 'publisher'
    Nom du serveur de publication. publisher est de type sysname, avec NULL comme valeur par défaut.

  • [@publisher_db = ] 'publisher_db'
    Nom de la base de données de publication. L'argument publisher_db est de type sysname avec NULL comme valeur par défaut.

Ensembles de résultats

Nom de la colonne

Type de données

Description

id

int

Numéro séquentiel de la publication dans la liste de l'ensemble de résultats.

name

sysname

Nom de la publication.

description

nvarchar(255)

Description de la publication.

status

tinyint

Indique quand les données de publication sont disponibles.

retention

int

Temps nécessaire pour enregistrer les métadonnées relatives aux modifications des articles dans la publication. Les unités utilisées pour cette période peuvent être des jours, des semaines, des mois ou des années. Pour plus d'informations sur ces unités, consultez la colonne retention_period_unit.

sync_mode

tinyint

Mode de synchronisation de la publication :

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

1 = Copie en bloc de caractères

allow_push

int

Indique si des abonnements par envoi de données (push) peuvent être créés pour la publication concernée. 0 indique qu'un abonnement par envoi de données (push) n'est pas autorisé.

allow_pull

int

Indique si des abonnements par extraction de données (pull) peuvent être créés pour la publication concernée. 0 indique qu'un abonnement par extraction de données (pull) n'est pas autorisé.

allow_anonymous

int

Indique si des abonnements anonymes peuvent être créés pour la publication concernée. 0 indique qu'un abonnement anonyme n'est pas autorisé.

centralized_conflicts

int

Détermine si les enregistrements en conflit sont stockés sur le serveur de publication donné :

0 = Les enregistrements en conflit sont stockés sur le serveur de publication et sur l'Abonné à l'origine du conflit.

1 = tous les enregistrements en conflit sont stockés sur le serveur de publication.

priority

float(8)

Priorité de l'abonnement en boucle.

snapshot_ready

tinyint

Indique si l'instantané de cette publication est prêt :

0 = Instantané prêt à être utilisé.

1 = Instantané non prêt à être utilisé.

publication_type

int

Type de publication :

0 = Instantané

1 = Transactionnelle.

2 = Fusion.

pubid

uniqueidentifier

Identificateur unique de la publication.

snapshot_jobid

binary(16)

ID de travail de l'Agent d'instantané. Pour obtenir l'entrée du travail d'instantané dans la table système sysjobs, vous devez convertir cette valeur hexadécimale en uniqueidentifier.

enabled_for_internet

int

Détermine si la publication est activée pour Internet. Si la valeur est 1, les fichiers de synchronisation de la publication sont placés dans le répertoire C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp. L'utilisateur doit créer le répertoire FTP (File Transfer Protocol). Si la valeur est 0, la publication n'est pas activée pour l'accès Internet.

dynamic_filter

int

Indique si un filtre de lignes paramétrable est utilisé. 0 signifie qu'un filtre de lignes paramétrable n'est pas utilisé.

has_subscription

bit

Indique si la publication autorise les abonnements. 0 signifie que la publication n'a actuellement aucun abonnement.

snapshot_in_default_folder

bit

Indique si les fichiers d'instantané sont stockés dans le dossier par défaut.

Si la valeur est 1, les fichiers d'instantané se trouvent dans le dossier par défaut.

Si la valeur est 0, les fichiers d'instantané sont stockés dans le dossier de remplacement spécifié par alt_snapshot_folder. Les emplacements secondaires peuvent se trouver sur un autre serveur, un lecteur réseau ou un support amovible (tel qu'un CD-ROM ou des disques amovibles). Vous pouvez également enregistrer les fichiers d'instantané sur un site FTP, pour permettre à l'Abonné de les extraire plus tard.

RemarqueRemarque
Ce paramètre peut avoir la valeur true et disposer encore d'un emplacement dans le paramètre alt_snapshot_folder. Cette combinaison spécifie que les fichiers d'instantané sont stockés à la fois dans l'emplacement par défaut et dans l'emplacement secondaire.

alt_snapshot_folder

nvarchar(255)

Spécifie l'emplacement du dossier secondaire de l'instantané.

pre_snapshot_script

nvarchar(255)

Spécifie un pointeur vers un fichier .sql que l'Agent de fusion exécute avant les scripts d'objets répliqués lors de l'application de l'instantané au niveau de l'Abonné.

post_snapshot_script

nvarchar(255)

Spécifie un pointeur vers un fichier .sql que l'Agent de fusion exécute après que tous les autres scripts et données d'objets répliqués aient été appliqués au cours d'une synchronisation initiale.

compress_snapshot

bit

Spécifie que l'instantané écrit à l'emplacement alt_snapshot_folder est compressé au format Microsoft CAB.

ftp_address

sysname

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

ftp_port

int

Numéro de port du service FTP du serveur de distribution. ftp_port a une valeur par défaut de 21. Spécifie l'emplacement où l'Agent de fusion peut accéder aux fichiers d'instantané de la publication.

ftp_subdirectory

nvarchar(255)

Spécifie l'emplacement où l'Agent de fusion peut accéder aux fichiers d'instantanés lorsque l'instantané est envoyé via FTP.

ftp_login

sysname

Nom d'utilisateur utilisé pour la connexion au service FTP.

conflict_retention

int

Indique la période de rétention, en jours, pendant laquelle les conflits sont conservés. Au terme du nombre de jours spécifié, la ligne en conflit est purgée de la table des conflits.

keep_partition_changes

int

Spécifie si la synchronisation est optimisée pour cette publication. keep_partition_changes a la valeur par défaut 0. La valeur 0 indique que la synchronisation n'est pas optimisée et que les partitions envoyées à tous les Abonnés sont vérifiées lorsque les données d'une partition sont modifiées.

La valeur 1 indique que la synchronisation est optimisée et que seuls les Abonnés ayant des lignes dans la partition changée sont affectés.

RemarqueRemarque
Par défaut, les publications de fusion utilisent des partitions précalculées, ce qui offre un meilleur niveau d'optimisation que cette option. Pour plus d'informations, consultez Filtres de lignes paramétrés et Optimisation des performances des filtres paramétrés avec des partitions précalculées.

allow_subscription_copy

int

Spécifie si la possibilité de copier les bases de données d'abonnement qui s'abonnent à cette publication a été activée. La valeur 0 indique que la copie n'est pas autorisée.

allow_synctoalternate

int

Spécifie si un partenaire de synchronisation différent est autorisé pour se synchroniser avec le serveur de publication. La valeur 0 signifie qu'un partenaire de synchronisation n'est pas autorisé.

validate_subscriber_info

nvarchar(500)

Donne la liste des fonctions utilisées pour extraire les informations d'Abonné et valider les critères de filtre de lignes paramétrable sur l'Abonné. Permet de vérifier la cohérence du partitionnement des informations avec chaque fusion.

backward_comp_level

int

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

10 = SQL Server 7.0

20 = SQL Server 7.0 SP1

30 = SQL Server 7.0 SP2

30 = SQL Server 7.0 SP3

30 = SQL Server 7.0 SP4

40 = SQL Server 2000

40 = SQL Server 2000 SP1

40 = SQL Server 2000 SP2

40 = SQL Server 2000 SP3

90 = SQL Server 2005

90 = SQL Server 2005 SP1

90 = SQL Server 2005 SP2

100 = SQL Server 2008

publish_to_activedirectory

bit

Spécifie si les informations de publication sont publiées dans Active Directory. La valeur 0 signifie que les informations de publication ne sont pas disponibles dans Active Directory.

Ce paramètre est déconseillé et il n'est pris en charge que pour la compatibilité descendante des scripts. Vous ne pouvez plus ajouter d'informations de publication dans Active Directory.

max_concurrent_merge

int

Nombre de processus de fusion simultanés. Si la valeur est 0, cela indique qu'il peut exister un nombre illimité de processus de fusion simultanés à tout instant.

max_concurrent_dynamic_snapshots

int

Nombre maximal de sessions d'instantané filtrée pouvant être exécutées simultanément par rapport à la publication de fusion. Si la valeur est 0, il peut exister un nombre illimité de sessions d'instantanés filtrées simultanées exécutées par rapport à la publication à n'importe quel moment.

use_partition_groups

int

Détermine si des partitions précalculées sont utilisées. La valeur 1 indique que des partitions précalculées sont utilisées.

num_of_articles

int

Nombre d'articles dans la publication.

replicate_ddl

int

Indique si les modifications de schéma des tables publiées sont répliquées. La valeur 1 indique que les modifications de schéma sont répliquées.

publication_number

smallint

Numéro affecté à cette publication.

allow_subscriber_initiated_snapshot

bit

Détermine si les Abonnés peuvent lancer le processus de génération d'instantané de données filtrées. La valeur 1 indique que les Abonnés peuvent lancer le processus d'instantané.

allow_web_synchronization

bit

Détermine si la publication est activée pour la synchronisation Web. La valeur 1 indique que la synchronisation Web est activée.

web_synchronization_url

nvarchar(500)

URL Internet utilisé pour la synchronisation Web.

allow_partition_realignment

bit

Détermine si les suppressions sont envoyées à l'abonné lorsque la modification de la ligne sur le serveur de publication entraîne la modification de sa partition. La valeur 1 indique que les suppressions sont envoyées à l'Abonné. Pour plus d'informations, consultez sp_addmergepublication (Transact-SQL).

retention_period_unit

tinyint

Définit l'unité utilisée lors la définition de la rétention. Les valeurs possibles sont :

0 = jour

1 = semaine

2 = mois

3 = année

has_downloadonly_articles

bit

Indique si des articles qui appartiennent à la publication sont des articles téléchargeables uniquement. La valeur 1 indique qu'il s'agit d'articles téléchargeables uniquement.

decentralized_conflicts

int

Indique si les enregistrements en conflit sont stockés sur l'Abonné qui a généré le conflit. La valeur 0 indique que les enregistrements en conflit ne sont pas stockés sur l'Abonné qui a généré le conflit. La valeur 1 indique que les enregistrements en conflit sont stockés sur l'Abonné.

generation_leveling_threshold

int

Indique le nombre de modifications contenues dans une génération. Une génération est une collection de modifications remises à un serveur de publication ou à un Abonné. Pour plus d'informations, consultez Comment la réplication de fusion effectue le suivi et l'énumération des modifications.

automatic_reinitialization_policy

bit

Indique si les modifications sont téléchargées depuis l'Abonné avant une réinitialisation automatique. La valeur 1 indique que des modifications sont téléchargées depuis l'Abonné avant une réinitialisation automatique. La valeur 0 indique que des modifications ne sont pas téléchargées avant une réinitialisation automatique.

Valeurs des codes de retour

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

Notes

sp_helpmergepublication est utilisé dans la réplication de fusion.

Autorisations

Les membres de la liste d'accès à la publication d'une publication peuvent exécuter sp_helpmergepublication pour cette publication. Les membres du rôle de base de données fixe db_owner de la base de données de publication peuvent exécuter sp_helpmergepublication pour obtenir des informations sur toutes les publications.

Exemple

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2008R2]
EXEC sp_helpmergepublication @publication = @publication;
GO