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.

Conventions 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 et n'a pas de valeur par défaut.

• [ @article=] 'article'
  Nom d'un article de la publication. article est de type sysname, avec % comme valeur par défaut. Si l'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, et sa valeur par défaut 1, retourne la clause filter.

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

  Remarque :
  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

Valeurs des codes de retour

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

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 = à usage interne uniquement. 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.
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 à la valeur auto ou auto_identity_range défini à 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 à la valeur auto ou auto_identity_range défini à 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.

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 de 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 [AdventureWorks]
EXEC sp_helparticle
  @publication = @publication;
GO

Voir aussi

Référence

sp_addarticle (Transact-SQL)
sp_articlecolumn (Transact-SQL)
sp_changearticle (Transact-SQL)
sp_droparticle (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