Compartilhar via


sp_articleview (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

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 publicador.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

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

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

@article [ = ] N'artigo'

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

@view_name [ = ] N'view_name'

O nome da exibição que define o artigo publicado. @view_name é nvarchar(386), com um padrão de NULL.

@filter_clause [ = ] N'filter_clause'

Uma cláusula de restrição (WHERE) que define um filtro horizontal. Ao inserir a cláusula de restrição, omita a WHERE palavra-chave. @filter_clause é nvarchar(max), com um padrão de NULL.

@change_active [ = ] change_active

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

  • Se 0, as colunas não serão alteradas.
  • Se 1, as exibições podem ser criadas ou recriadas em artigos ativos que têm assinaturas.

@force_invalidate_snapshot [ = ] force_invalidate_snapshot

Confirma que a ação executada por esse procedimento armazenado pode invalidar um instantâneo 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 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 podem fazer com que o instantâneo seja inválido e, se houver assinaturas existentes que exijam um novo instantâneo, dá 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

Confirma que a ação executada por esse procedimento armazenado pode exigir que as assinaturas existentes sejam reinicializadas. @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 detectar que a alteração exigiria que as assinaturas fossem reinicializadas, ocorrerá um erro e nenhuma alteração será feita.
  • 1 Especifica que as alterações no artigo fazem com que a assinatura existente seja reinicializada e dá permissão para que a reinicialização da assinatura ocorra.

@publisher [ = ] N'editor'

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

@publisher não deve ser usado ao publicar de um Publicador do SQL Server.

@refreshsynctranprocs [ = ] refreshsynctranprocs

Especifica se os procedimentos armazenados usados para sincronizar a replicação são recriados automaticamente. @refreshsynctranprocs é bit, com um padrão de 1.

  • 1 significa que os procedimentos armazenados são recriados.
  • 0 significa que os procedimentos armazenados não são recriados.

@internal [ = ] interno

Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_articleview cria a exibição que define o artigo publicado e insere a ID dessa exibição na sync_objid coluna da tabela sysarticles (Transact-SQL) e insere o texto da cláusula de restrição na filter_clause coluna. Se todas as colunas forem replicadas e não houver , filter_clausea sync_objid 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), primeiro execute sp_addarticle sem @sync_object parâmetro, execute sp_articlecolumn (Transact-SQL) uma vez para cada coluna a ser replicada (definindo o filtro vertical) e, em seguida, execute sp_articleview para criar a exibição que define o artigo publicado.

Para publicar uma tabela filtrada horizontalmente (ou seja, para filtrar linhas), execute sp_addarticle (Transact-SQL) sem @filter_name parâmetro. Execute sp_articlefilter (Transact-SQL), fornecendo todos os parâmetros, incluindo @filter_clause. Em seguida, execute sp_articleview, fornecendo todos os parâmetros, incluindo o mesmo @filter_clause.

Para publicar uma tabela filtrada vertical e horizontalmente, execute sp_addarticle (Transact-SQL) sem parâmetros @sync_object ou @filter_name . Execute sp_articlecolumn (Transact-SQL) uma vez para cada coluna a ser replicada e, em seguida, 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 automaticamente. Se a exibição foi criada manualmente (type em sysarticles (Transact-SQL) é 5), a exibição existente não será descartada.

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

Exemplos

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 db_owner função de banco de dados fixa podem executar sp_articleview.