sys.sp_articlecolumn (Transact-SQL)

Aplica-se a: SQL Server

Usado para especificar colunas incluídas num artigo para filtrar verticalmente dados numa tabela publicada. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_articlecolumn
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @column = ] N'column' ]
    [ , [ @operation = ] N'operation' ]
    [ , [ @refresh_synctran_procs = ] refresh_synctran_procs ]
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @change_active = ] change_active ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @internal = ] internal ]
[ ; ]

Arguments

[ @publication = ] N'publicação'

O nome da publicação que contém este artigo. @publication é sysname, sem padrão.

[ @article = ] N'artigo'

O nome do artigo. @article é sysname, sem padrão.

@column [ = ] N'coluna'

O nome da coluna a ser adicionada ou retirada. @column é sysname, com um padrão de NULL. Se NULL, todas as colunas são publicadas.

[ @operation = ] N'operação'

Especifica se deve adicionar ou eliminar colunas num artigo. @operation é nvarchar(5), com um padrão de add.

  • add marca a coluna para replicação.
  • drop desmarca a coluna.

[ @refresh_synctran_procs = ] refresh_synctran_procs

Especifica se os procedimentos armazenados que suportam subscrições de atualização imediata são regenerados para corresponder ao número de colunas replicadas. @refresh_synctran_procs é bit, com um padrão de 1. Se 1, os procedimentos armazenados são regenerados.

[ @ignore_distributor = ] ignore_distributor

Indica se este procedimento armazenado é executado sem se ligar ao Distribuidor. @ignore_distributor é bit, com um padrão de 0.

  • Se 0, a base de dados deve estar ativada para publicação, e a cache do artigo deve ser atualizada para refletir as novas colunas replicadas pelo artigo.
  • Se 1, permite que colunas de artigos sejam eliminadas para artigos que residem numa base de dados não publicada; deve ser usado apenas em situações de recuperação.

[ @change_active = ] change_active

Permite modificar as colunas em publicações que têm subscrições. @change_active é int, com um padrão de 0.

  • Se 0, as colunas não forem modificadas.
  • Se 1, colunas podem ser adicionadas ou retiradas de artigos ativos que tenham subscrições.

@force_invalidate_snapshot [ = ] force_invalidate_snapshot

Reconhece que a ação tomada por este procedimento armazenado pode invalidar um snapshot existente. @force_invalidate_snapshot é bit, com um padrão de 0.

  • 0 Especifica que as alterações no artigo não fazem com que o instantâneo seja inválido. Se o procedimento armazenado detetar que a alteração requer um novo snapshot, ocorre um erro e não são feitas alterações.
  • 1 especifica que alterações ao artigo podem tornar o snapshot inválido e, se existirem subscrições existentes que exijam um novo snapshot, dá permissão para que o snapshot existente seja marcado como obsoleto e gerado um novo snapshot.

@force_reinit_subscription [ = ] force_reinit_subscription

Reconhece que a ação tomada por este procedimento armazenado pode exigir a reinicialização das subscrições existentes. @force_reinit_subscription é bit, com um padrão de 0.

  • 0 Especifica que as alterações no artigo não fazem com que a assinatura seja reinicializada. Se o procedimento armazenado detetar que a alteração exigiria a reinicialização das subscrições, ocorre um erro e não são feitas alterações.
  • 1 especifica que alterações ao artigo causam a reinicialização das subscrições existentes e dá permissão para que a reinicialização da subscrição ocorra.

@publisher [ = ] N'editor'

Especifica um Editor de Server que não seja SQL. @publisher é sysname, com um padrão de NULL.

@publisher não deve ser usado com um SQL Server Publisher.

[ @internal = ] interno

Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_articlecolumn é usado na replicação instantânea e na replicação transacional.

Apenas um artigo não subscrito pode ser filtrado usando sp_articlecolumn.

Examples

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

Permissions

Apenas os membros do papel fixo de servidor administrador do sistema ou db_owner papel fixo de base de dados podem executar sp_articlecolumn.

Conteúdo relacionado

  • Last updated on