Partager via


sp_articlecolumn (Transact-SQL)

Permet de spécifier les colonnes incluses dans un article pour filtrer verticalement des données dans une table publiée. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.

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

Syntaxe

sp_articlecolumn [ @publication = ] 'publication'
        , [ @article = ] 'article'
    [ , [ @column = ] 'column' ]
    [ , [ @operation = ] 'operation' ]
    [ , [ @refresh_synctran_procs = ] refresh_synctran_procs ]
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @change_active = ] change_actve ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @internal = ] 'internal' ]

Arguments

  • [ @publication=] 'publication'
    Nom de la publication qui contient l'article. L'argument publication est de type sysname et n'a pas de valeur par défaut.

  • [ @article= ] 'article'
    Nom de l'article. L'argument article est de type sysname et n'a pas de valeur par défaut.

  • [ @column = ] 'column'
    Nom de la colonne à ajouter ou supprimer. column est de type sysname et sa valeur par défaut est NULL. Si la valeur est NULL, toutes les colonnes sont publiées.

  • [ @operation =] 'operation'
    Spécifie s'il faut ajouter ou supprimer des colonnes dans un article. operation est de type nvarchar(5) et sa valeur par défaut est l'ajout. add marque les colonnes à répliquer. drop supprime les marques des colonnes.

  • [ @refresh_synctran_procs=] refresh_synctran_procs
    Indique si les procédures stockées qui prennent en charge les abonnements de mise à jour immédiate sont actualisées pour qu'il y ait correspondance avec le nombre de colonnes répliquées. refresh_synctran_procs est de type bit et sa valeur par défaut est 1. Si sa valeur est 1, les procédures stockées sont actualisées.

  • [ @ignore_distributor=] ignore_distributor
    Indique si cette procédure stockée s'exécute sans connexion au serveur de distribution. ignore_distributor est de type bit et sa valeur par défaut est 0. Si la valeur est 0, la base de données doit être activée pour la publication, et le cache de l'article doit être actualisé pour refléter les nouvelles colonnes répliquées par l'article. Si la valeur est 1, les colonnes des articles résidant dans une base de données non publiée peuvent être supprimées. Utilisez cette valeur uniquement dans le cas d'une récupération de base de données.

  • [ @change_active = ] change_active
    Autorise la modification des colonnes dans les publications possédant des abonnements. L'argument change_active est de type int, avec 0 comme valeur par défaut. Si la valeur est 0, les colonnes ne sont pas modifiées. Si la valeur est 1, des colonnes peuvent être ajoutées ou supprimées à partir d'articles actifs possédant des abonnements.

  • [ @force_invalidate_snapshot = ] force_invalidate_snapshot
    Accepte que l'action exécutée par la procédure stockée puisse invalider une capture instantanée existante. force_invalidate_snapshot est de type bit, avec la valeur par défaut 0.

    0 indique que les modifications apportées à l'article n'invalident pas la capture instantanée. Si la procédure stockée détecte que la modification requiert une nouvelle capture instantanée, une erreur se produit et aucune modification n'est effectuée.

    1 indique que les modifications apportées à l'article peuvent entraîner l'invalidation de la capture instantanée. En outre, s'il existe déjà des abonnements nécessitant une nouvelle capture instantanée, cette valeur permet de marquer la capture instantanée existante comme obsolète et de générer une nouvelle capture instantanée.

  • [@force_reinit_subscription = ] force_reinit_subscription
    Confirme que l'action entreprise par cette procédure stockée peut nécessiter la réinitialisation des abonnements existants. L'argument force_reinit_subscription est de type bit, avec 0 comme valeur par défaut.

    0 indique que les modifications apportées à l'article ne réinitialisent pas l'abonnement. Si la procédure stockée détecte que la modification requiert la réinitialisation des abonnements, une erreur se produit et aucune modification n'est effectuée. 1 indique que les modifications apportées à l'article entraînent la réinitialisation des abonnements existants et autorise la réinitialisation des abonnements.

  • [ @publisher= ] 'publisher'
    Spécifie un serveur de publication non-MicrosoftSQL Server. publisher est de type sysname. Sa valeur par défaut est NULL.

    [!REMARQUE]

    publisher ne doit pas être utilisé avec un serveur de publication SQL Server.

  • [ @internal= ] 'internal'
    À usage interne uniquement

Valeurs des codes de retour

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

Notes

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

Seul un article ne faisant pas l'objet d'un abonnement peut être filtré par sp_articlecolumn.

Exemple

DECLARE @publication    AS sysname;
DECLARE @table AS sysname;
DECLARE @filterclause AS nvarchar(500);
DECLARE @filtername AS nvarchar(386);
DECLARE @schemaowner AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @table = N'Product';
SET @filterclause = N'[DiscontinuedDate] IS NULL'; 
SET @filtername = N'filter_out_discontinued';
SET @schemaowner = N'Production';

-- Add a horizontally and vertically filtered article for the Product table.
-- Manually set @schema_option to ensure that the Production schema 
-- is generated at the Subscriber (0x8000000).
EXEC sp_addarticle 
    @publication = @publication, 
    @article = @table, 
    @source_object = @table,
    @source_owner = @schemaowner, 
    @schema_option = 0x80030F3,
    @vertical_partition = N'true', 
    @type = N'logbased',
    @filter_clause = @filterclause;

-- (Optional) Manually call the stored procedure to create the 
-- horizontal filtering stored procedure. Since the type is 
-- 'logbased', this stored procedures is executed automatically.
EXEC sp_articlefilter 
    @publication = @publication, 
    @article = @table, 
    @filter_clause = @filterclause, 
    @filter_name = @filtername;

-- Add all columns to the article.
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table;

-- Remove the DaysToManufacture column from the article
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table, 
    @column = N'DaysToManufacture', 
    @operation = N'drop';

-- (Optional) Manually call the stored procedure to create the 
-- vertical filtering view. Since the type is 'logbased', 
-- this stored procedures is executed automatically.
EXEC sp_articleview 
    @publication = @publication, 
    @article = @table,
    @filter_clause = @filterclause;
GO

Autorisations

Seuls les membres du rôle serveur fixe sysadmin ou du rôle de base de données fixe db_owner peuvent exécuter la procédure sp_articlecolumn.