Artigo
04/01/2012

sp_articleview (Transact-SQL)

Cria a exibição que define o artigo publicado, quando uma tabela é filtrada verticalmente ou horizontalmente. Essa exibição é usada como a fonte filtrada de esquema e dados para as tabelas de destino. Somente artigos não assinados podem ser modificados por esse procedimento armazenado. Esse procedimento armazenado é executado no Publicador, no banco de dados de publicação.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

sp_articleview [ @publication = ] 'publication'
        , [ @article = ] 'article'
    [ , [ @view_name = ] 'view_name']
    [ , [ @filter_clause = ] 'filter_clause']
    [ , [ @change_active = ] change_active ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @refreshsynctranprocs = ] refreshsynctranprocs ]
    [ , [ @internal = ] internal ]

Argumentos

[ @publication=] 'publication'
É o nome da publicação que contém o artigo. publication é sysname, sem padrão.
[ @article=] 'article'
É o nome do artigo. article é sysname, sem padrão.
[ @view_name=] 'view_name'
É o nome da exibição que define o artigo publicado. view_name é nvarchar (386), com um padrão NULL.
[ @filter_clause=] 'filter_clause'
É uma cláusula de restrição (WHERE) que define um filtro horizontal. Ao inserir a cláusula de restrição, omita a palavra-chave WHERE. filter_clause é ntext, com um padrão NULL.
[ @ change_active = ] change_active
Permite modificar as colunas em publicações que têm assinatura. change_active é um int, com um padrão 0. Se for 0, as colunas não serão alteradas . Se for 1, as exibições poderão ser criadas ou recriadas em artigos ativos que têm assinaturas.
[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Reconhece que a ação tomada por esse procedimento armazenado pode invalidar um instantâneo existente. force_invalidate_snapshot é um bit, com um padrão 0.

0 especifica que as alterações no artigo não invalidam o instantâneo. Se o procedimento armazenado detectar que a alteração requer um novo instantâneo, ocorrerá um erro e nenhuma alteração será feita.

1 especifica que as alterações no artigo de mesclagem podem invalidar o instantâneo e se houver assinaturas existentes que exigem um novo instantâneo, dará permissão para que o instantâneo existente seja marcado como obsoleto e um novo instantâneo seja gerado.
[ @force_reinit_subscription = ] force_reinit_subscription
Reconhece que a ação tomada por esse procedimento armazenado pode requerer que as assinaturas existentes sejam reiniciadas. force_reinit_subscription é um bit, com um padrão 0.

0 especifica que as alterações no artigo não fazem com que a assinatura seja reiniciada. Se o procedimento armazenado detectar que a alteração irá requerer que as assinaturas existentes sejam reiniciadas, ocorrerá um erro e nenhuma alteração será feita.

1 especifica que alterações no artigo causam a reinicialização de assinaturas existentes e dão permissão para que a assinatura seja reiniciada.
[ @publisher= ] 'publisher'
Especifica um Publicador não-Microsoft SQL Server. publisher é sysname, com um padrão NULL.

Observação

publisher não deve ser usado ao publicar de um Editor SQL Server.
[ @refreshsynctranprocs = ] refreshsynctranprocs
Se os procedimentos armazenados usados para sincronizar replicações serão automaticamente recriados. refreshsynctranprocs é bit, com um padrão 1.

1 significa que os procedimentos armazenados são recriados.

0 significa que os procedimentos armazenados não são recriados.
[ @internal= ] internal
Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.

Observação
publisher não deve ser usado ao publicar de um Editor SQL Server.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_articleview cria a definição que cria o artigo publicado e insere a ID dessa exibição na coluna sync_objid da tabela sysarticles (Transact-SQL) e insere o texto da cláusula de restrição na coluna filter_clause. Se todas as colunas forem replicadas e não houver filter_clause, sync_objid na tabela sysarticles (Transact-SQL) será definida como a ID da tabela base e o uso de sp_articleview não será necessário.

Para publicar uma tabela filtrada verticalmente (ou seja, para filtrar colunas) execute primeiro sp_addarticle sem nenhum parâmetro sync_object, execute sp_articlecolumn (Transact-SQL) uma vez para cada coluna a ser replicada (definindo o filtro vertical) e, então, execute sp_articleview para criar a exibição que define o artigo publicado.

Para publicar uma tabela horizontalmente filtrada (ou seja, para filtrar linhas), execute sp_addarticle (Transact-SQL) sem nenhum parâmetro filter. Execute sp_articlefilter (Transact-SQL), fornecendo todos os parâmetros, incluindo filter_clause. Depois execute sp_articleview, fornecendo todos os parâmetros incluindo o filter_clause idêntico.

Para publicar uma tabela filtrada verticalmente e horizontalmente, execute sp_addarticle (Transact-SQL) sem os parâmetros sync_object ou filter. Execute sp_articlecolumn (Transact-SQL) uma vez para cada coluna a ser replicada e, então, execute sp_articlefilter (Transact-SQL) e sp_articleview.

Se o artigo já tiver uma exibição que define o artigo publicado, sp_articleview descartará a exibição existente e criará uma nova exibição automaticamente. Se a exibição foi criada manualmente (type em sysarticles (Transact-SQL) é 5), a exibição existente não será descartada.

Se você criou um procedimento armazenado de filtro personalizado e uma exibição que define o artigo publicado manualmente, não execute sp_articleview. Em vez disso, forneça esses como os parâmetros filter e sync_object para sp_addarticle (Transact-SQL), junto com o valor type apropriado.

Exemplo

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