sp_articlecolumn (Transact-sql)

Makale
10/29/2012

Dikey olarak yayımlanmış tablodaki verilere filtre uygulamak için bir makale dahil sütunları belirtmek için kullanılır. Bu saklı yordam, yayını veritabanı üzerinde yayımcı adresindeki yürütülür.

Konu bağlantısı simgesi Transact-SQL Sözdizim Kuralları

Sözdizimi

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' ]

Bağımsız değişkenler

@ publication ='publication'
Bu makale içeren Yayını addır. publicationise sysname, hiçbir varsayılan ile.
@article='article'
Makaleyi addır. articleise sysname, hiçbir varsayılan ile.
@column='column'
Eklenen veya bırakılan sütun addır. columnise sysname, null varsayılan. BOŞ ise, tüm sütunları yayınlanır.
işlem ='operation'
Ekledikten veya bir makale sütun belirtir. operationise nvarchar(5), varsayılan Ekle. ekleme sütun çoğaltma için işaretler. damla sütun imler.
**@ refresh_synctran_procs =**refresh_synctran_procs
Hemen güncelleştirme abonelikleri destekleyen saklı yordamlarda çoğaltılan sütunları eşleştirmek için yeniden olup olmadığını belirtir. refresh_synctran_procsise bit, varsayılan 1. Eğer 1, saklı yordamları yeniden oluşturulur.
**@ ignore_distributor =**ignore_distributor
Bu saklı yordam Dağıtımcı olarak bağlanırken olmadan yürütür belirtir. ignore_distributorise bit, varsayılan 0. Eğer 0, veritabanı yayımlama için etkinleştirilmiş olması gerekir ve madde önbellek tarafından makale çoğaltılan yeni sütunlar yansıtacak şekilde yenilenmesi. Eğer 1, makaleyi sütunları yayınlanmamış bir veritabanında; bulunan makaleler için kesilmesini sağlar yalnızca kurtarma durumlarda kullanılmalıdır.
@ change_active = change_active
Abonelikleri bulunan yayınları sütunları değiştirme izin verir. change_activeolan bir int varsayılan 0. Eğer 0, sütunları değiştirilemez. Eğer 1, sütun eklendiğinde veya abonelikleri sahip aktif Makaleler düştü.
@ force_invalidate_snapshot = force_invalidate_snapshot
Bu saklı yordam tarafından gerçekleştirilen eylemi varolan bir anlık görüntüsünü geçersiz kılabilir kabul eder. force_invalidate_snapshotolan bir bit, varsayılan 0.

0 makaleyi değişiklikleri anlık geçersiz neden olmaz belirtir. Saklı yordam değiştirmek yeni bir anlık görüntü gerektirecek algılarsa, bir hata oluşur ve değişiklik yapılmaz.

1 makaleyi değişiklikleri anlık geçersiz neden olabilir ve yeni bir anlık görüntü gerektirecek varolan abonelikleri varsa varolan anlık görüntü geçersiz olarak işaretlenmesi için izni verir ve yeni bir anlık görüntü oluşturulan belirtir.
@ force_reinit_subscription = force_reinit_subscription
Bu saklı yordam tarafından gerçekleştirilen eylemi varolan abonelikleri yeniden gerektirdiğine dikkat eder. force_reinit_subscriptionolan bir bit, varsayılan 0.

0 makale değişiklikleri abonelik yeniden neden olmaz belirtir. Saklı yordam yeniden abonelikleri değişikliği gerektirecek algılarsa, bir hata oluşur ve değişiklik yapılmaz. 1 değişiklikleri makale yeniden, varolan abonelikleri neden belirtir ve abonelik reinitialization yapılmasına izin verir.
@publisher='publisher'
Olmayan bir belirtir- Microsoft SQL Server Yayınevi. publisherise sysname, null varsayılan.

[!NOT]

publisherile kullanılmamalıdır bir SQL ServerYayınevi.
@internal='internal'
Yalnızca iç kullanım.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hata)

Açıklamalar

sp_articlecolumn anlık görüntü çoğaltma ve işlem çoğaltma kullanılır.

Aboneliği bir makale kullanarak filtre uygulanabilir sp_articlecolumn.

Örnek

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