sp_helpmergearticle (Transact-SQL)

Retourne des informations sur un article. Cette procédure stockée est exécutée sur la base de données de publication du serveur de publication ou sur un Abonné de republication sur la base de données d'abonnement.

Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_helpmergearticle [ [ @publication = ] 'publication' ]
    [ , [ @article= ] 'article' ]

Arguments

• [ @publication=] 'publication'
  Nom de la publication sur laquelle extraire des informations. L'argument publicationest du type sysname avec % comme valeur par défaut. Il retourne des informations sur tous les articles de fusion contenus dans toutes les publications de la base de données active.

• [ @article=] 'article'
  Nom de l'article sur lequel des informations doivent être retournées. articleest du type sysname, avec % comme valeur par défaut. Il affiche des informations sur tous les articles de fusion de la publication donnée.

Notes

sp_helpmergearticle est utilisée pour la réplication de fusion.

Autorisations

Seuls les membres appartenant au rôle de base de données fixe db_owner de la base de données de publication, au rôle replmonitor de la base de données de distribution ou figurant dans la liste d'accès d'une publication peuvent exécuter sp_helpmergearticle.

ensemble de résultats

Nom de colonne

Type de données

Description

id

int

Identificateur de l'article

name

sysname

Nom de l'article

source_owner

sysname

Nom du propriétaire de l'objet source

source_object

sysname

Nom de l'objet source à partir duquel l'article doit être ajouté.

sync_object_owner

sysname

Nom du propriétaire de la vue qui définit l'article publié.

sync_object

sysname

Nom de l'objet personnalisé utilisé pour établir les données initiales pour la partition.

description

nvarchar(255)

Description de l'article

status

tinyint

État de l'article, qui peut être l'un des suivants :

1 = Inactif

2 = Actif

5 = Opération DDL (Data Definition Language) en attente

6 = Opération DDL avec une capture de données nouvellement générée

Remarque :

Lorsqu'un article est réinitialisé, les valeurs 5 et 6 sont remplacées par 2.

creation_script

nvarchar(255)

Chemin d'accès et nom d'un script de schéma d'article facultatif utilisé pour créer l'article dans la base de données d'abonnement.

conflict_table

nvarchar(270)

Nom de la table stockant les conflits d'insertion ou de mise à jour

article_resolver

nvarchar(255)

Outil de résolution personnalisé pour l'article

subset_filterclause

nvarchar(1000)

Clause WHERE spécifiant le filtrage horizontal

pre_creation_command

tinyint

Méthode de précréation, qui peut être l'une des suivantes :

0 = none

1 = drop

2 = delete

3 = truncate

schema_option

binary(8)

Bitmap de l'option de génération de schéma pour l'article. Pour plus d'informations sur cette option de bitmap, consultez sp_addmergearticle ou sp_changemergearticle.

type

smallint

Type de l'article, qui peut être l'un des suivants :

10 = table

32 = procédure stockée

64 = vue ou vue indexée

128 = fonction définie par l'utilisateur

160 = synonym schema only

column_tracking

int

Définition du suivi au niveau des colonnes ; où 1 signifie que le suivi au niveau des colonnes est activé, et 0 qu'il est désactivé.

resolver_info

nvarchar(255)

Nom de l'outil de résolution de l'article

vertical_partition

bit

Indique si un article est partitionné verticalement ; où 1 signifie que l'article est partitionné verticalement, et 0 qu'il ne l'est pas.

destination_owner

sysname

Propriétaire de l'objet de destination. Applicable uniquement aux articles de schémas de fonctions utilisateur (UDF), aux vues et aux procédures stockées de fusion.

identity_support

int

Indique si la gestion automatique des plages d'identité est activée ; où 1 signifie qu'elle est activée et 0 signifie qu'elle est désactivée.

pub_identity_range

bigint

Taille de plage à utiliser lors de l'affectation de nouvelles valeurs d'identité. Pour plus d'informations, consultez la section « Réplication de la fusion » de Réplication de colonnes d'identité.

identity_range

bigint

Taille de plage à utiliser lors de l'affectation de nouvelles valeurs d'identité. Pour plus d'informations, consultez la section « Réplication de la fusion » de Réplication de colonnes d'identité.

threshold

int

Pourcentage de valeur utilisé pour les Abonnés exécutant SQL Server 2005 Compact Edition ou les précédentes versions de SQL Server. threshold contrôle à quel moment l'Agent de fusion affecte une nouvelle plage d'identité. Lorsque le pourcentage de valeurs spécifié dans le seuil est utilisé, l'Agent de fusion crée une nouvelle plage d'identité. Pour plus d'informations, consultez la section « Réplication de la fusion » de Réplication de colonnes d'identité.

verify_resolver_signature

int

Indique si une signature numérique est vérifiée avant d'utiliser un outil de résolution dans la réplication de fusion ; où 0 signifie que la signature n'est pas vérifiée, et 1 que la signature est vérifiée pour déterminer qu'elle provient d'une source approuvée.

destination_object

sysname

Nom de l'objet de destination. Applicable uniquement aux articles de schémas de fonctions utilisateur, aux vues et aux procédures stockées de fusion.

allow_interactive_resolver

int

Indique si l'outil de résolution interactif est utilisé sur un article ; où 1 signifie que l'outil est utilisé, et 0 qu'il ne l'est pas.

fast_multicol_updateproc

int

Active ou désactive l'Agent de fusion pour appliquer des modifications à plusieurs colonnes de la même ligne dans une instruction UPDATE ; où 1 signifie que plusieurs colonnes sont mises à jour dans une instruction, et 0 que des instructions UPDATE séparées sont émises pour la mise à jour de chaque colonne.

check_permissions

int

Valeur entière qui représente la bitmap des autorisations au niveau des tables qui sont vérifiées. Pour obtenir la liste de valeurs possibles, consultez sp_addmergearticle.

processing_order

int

Ordre selon lequel les modifications de données sont appliquées aux articles d'une publication.

upload_options

tinyint

Définit des restrictions sur des mises à jour effectuées sur l'Abonné disposant d'un abonnement client, qui peut avoir l'une des valeurs suivantes.

0 = Il n'y a aucune restriction sur les mises à jour effectuées sur un Abonné disposant d'un abonnement client ; toutes les modifications sont téléchargées sur le serveur de publication.

1 = Les modifications sont autorisées sur un Abonné disposant d'un abonnement client, mais elles ne sont pas téléchargées sur le serveur de publication.

2 = Les modifications ne sont pas autorisées sur un Abonné disposant d'un abonnement client.

Pour plus d'informations, consultez Optimisation des performances de la réplication de fusion avec les articles en téléchargement seul.

identityrangemanagementoption

int

Indique si la gestion automatique des plages d'identité est activée ; où 1 signifie qu'elle est activée et 0 signifie qu'elle est désactivée.

delete_tracking

bit

Indique si des suppressions sont répliquées ; où 1 signifie que les suppressions sont répliquées, et 0 qu'elles ne le sont pas.

compensate_for_errors

bit

Indique si des actions de compensation sont entreprises lorsque des erreurs se produisent au cours de la synchronisation ; où 1 indique que des actions de compensation sont entreprises, et 0 qu'elles ne le sont pas.

partition_options

tinyint

Définit la façon dont les données de l'article sont partitionnées, ce qui permet d'optimiser les performances lorsque toutes les lignes appartiennent à une seule partition ou à un seul abonnement. partition_options peut prendre l'une des valeurs suivantes.

0 = Le filtrage de l'article est statique, ou il ne produit pas un sous-ensemble unique de données pour chaque partition, c'est-à-dire une partition en « chevauchement ».

1 = Les partitions se chevauchent, et les mises à jour DML (langage de manipulation des données) effectuées sur l'Abonné ne peuvent pas modifier la partition à laquelle une ligne appartient.

2 = Le filtrage de l'article produit des partitions qui ne se chevauchent pas, mais plusieurs Abonnés peuvent recevoir la même partition.

3 = Le filtrage de l'article produit des partitions qui ne se chevauchent pas et qui sont uniques pour chaque abonnement.

artid

uniqueidentifier

Identificateur qui identifie l'article de façon unique

pubid

uniqueidentifier

Identificateur qui identifie de manière unique la publication dans laquelle l'article est publié.

stream_blob_columns

bit

Indique si un optimisation du flux de données est utilisée lors de la réplication de colonnes BLOB (binary large objects). 1 signifie que l'optimisation est utilisée, et 0 qu'elle ne l'est pas.

Valeurs des codes retournés

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

Exemple

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

USE [AdventureWorks]
EXEC sp_helpmergearticle
  @publication = @publication;
GO

Voir aussi

Référence

sp_addmergearticle (Transact-SQL)
sp_changemergearticle (Transact-SQL)
sp_dropmergearticle (Transact-SQL)
Procédures stockées de réplication (Transact-SQL)

Autres ressources

How to: View and Modify Article Properties (Replication Transact-SQL Programming)

Aide et Informations

Assistance sur SQL Server 2005