sp_helparticle (Transact-SQL)

Affiche des informations sur un article. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication. Dans le cas des serveurs de 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_helparticle [ @publication = ] 'publication' 
    [ , [ @article = ] 'article' ]
    [ , [ @returnfilter = ] returnfilter ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @found = ] found OUTPUT ]

Arguments

  • [ @publication =] 'publication'
    Nom de la publication. publication est de type sysname, sans valeur par défaut.

  • [ **@article=**\] 'article'
    Nom d'un article dans la publication. article est de type sysname et a la valeur par défaut %. Si article n'est pas fourni, des informations sont retournées sur tous les articles de la publication spécifiée.

  • [ **@returnfilter=**\] returnfilter
    Indique si la clause filter doit être retournée. returnfilter est de type bit, avec la valeur par défaut 1 qui retourne la clause filter.

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

    Note

    publisher ne doit pas être spécifié pour demander des informations sur un article publié par un serveur de publication SQL Server.

  • [ **@found=** ] found OUTPUT
    À usage interne uniquement

Jeux de résultats

Nom de colonne

Type de données

Description

article id

int

Identificateur de l'article.

article name

sysname

Nom de l'article

base object

nvarchar(257)

Nom de la table sous-jacente représentée par l'article ou la procédure stockée.

destination object

sysname

Nom de la table de destination (abonnement)

synchronization object

nvarchar(257)

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

type

smallint

Type d'article :

1 = article basé sur le journal

3 = article basé sur un journal avec filtre manuel

5 = article basé sur un journal avec vue manuelle

7 = article basé sur un journal avec filtre manuel et vue manuelle

8 = exécution d'une procédure stockée

24 = exécution d'une procédure stockée sérialisable

32 = procédure stockée (schéma uniquement)

64 = vue (schéma uniquement)

128 = fonction (schéma uniquement)

status

tinyint

Peut être le résultat & (AND au niveau du bit) d'au moins une des propriétés d'article suivantes :

0x00 = Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

0x01 = article actif.

0x08 = inclut le nom de la colonne dans les instructions d'insertion.

0x16 = utilise des instructions paramétrées.

0x32 = utilise des instructions paramétrées et inclut le nom de la colonne dans les instructions d'insertion.

filter

nvarchar(257)

Procédure stockée utilisée pour filtrer la table horizontalement. Cette procédure stockée doit avoir été créée à l'aide de la clause FOR REPLICATION.

description

nvarchar(255)

Entrée descriptive de l'article

insert_command

nvarchar(255)

Type de commande de réplication utilisé pour répliquer des insertions avec des articles de table. Pour plus d'informations, consultez Spécification du mode de propagation des modifications des articles transactionnels.

update_command

nvarchar(255)

Type de commande de réplication utilisé pour répliquer des mises à jour avec des articles de table. Pour plus d'informations, consultez Spécification du mode de propagation des modifications des articles transactionnels.

delete_command

nvarchar(255)

Type de commande de réplication utilisé pour répliquer des suppressions avec des articles de table. Pour plus d'informations, consultez Spécification du mode de propagation des modifications des articles transactionnels.

creation script path

nvarchar(255)

Chemin d'accès et nom d'un script de schéma d'article utilisé pour créer des tables cibles.

vertical partition

bit

Indique si le partitionnement vertical est activé pour l'article ; la valeur 1 signifie que le partitionnement vertical est activé.

pre_creation_cmd

tinyint

Commande de pré-création pour les instructions DROP TABLE, DELETE TABLE, ou TRUNCATE TABLE.

filter_clause

ntext

Clause WHERE spécifiant le filtrage horizontal.

schema_option

binary(8)

Bitmap de l'option de génération de schéma pour l'article donné. Pour obtenir la liste complète des valeurs schema_option, consultez sp_addarticle (Transact-SQL).

dest_owner

sysname

Nom du propriétaire de l'objet de destination.

source_owner

sysname

Propriétaire de l'objet source.

unqua_source_object

sysname

Nom de l'objet source sans le nom du propriétaire.

sync_object_owner

sysname

Propriétaire de la vue qui définit l'article publié. .

unqualified_sync_object

sysname

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

filter_owner

sysname

Propriétaire du filtre.

unqua_filter

sysname

Nom du filtre, sans le nom du propriétaire.

auto_identity_range

int

Indicateur signalant si la gestion automatique de plages d'identité était activée sur la publication au moment de sa création. 1 signifie que la gestion automatique de plages d'identité est activée ; 0 indique qu'elle est désactivée.

publisher_identity_range

int

Taille de la plage d'identité sur le serveur de publication si l'article possède identityrangemanagementoption défini avec la valeur auto ou auto_identity_range défini avec la valeur true.

identity_range

bigint

Taille de la plage d'identité au niveau de l'Abonné si l'article possède identityrangemanagementoption défini avec la valeur auto ou auto_identity_range défini avec la valeur true.

threshold

bigint

Valeur de pourcentage indiquant le moment où l'Agent de distribution affecte une nouvelle plage d'identité.

identityrangemanagementoption

int

Indique la gestion des plages d'identité appliquée à l'article.

fire_triggers_on_snapshot

bit

Indique si les déclencheurs de l'utilisateur répliqués sont exécutés lorsque la capture instantanée initiale est appliquée.

1 = les déclencheurs de l'utilisateur sont exécutés.

0 = les déclencheurs de l'utilisateur ne sont pas exécutés.

Valeurs des codes de retour

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

Notes

La procédure sp_helparticle est utilisée dans une réplication transactionnelle et une réplication de capture instantanée.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin, du rôle de base de données fixe db_owner ou de la liste d’accès de la publication active peuvent exécuter sp_helparticle.

Exemple

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

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