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.
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.
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
Permissões
Somente membros da função de servidor fixa sysadmin ou da função de banco de dados fixa db_owner podem executar sp_articleview.
Consulte também