sys.sp_articleview (Transact-SQL)

Aplica-se a: SQL ServerAzure SQL Managed Instance

Cria a vista que define o artigo publicado quando uma tabela é filtrada vertical ou horizontalmente. Esta vista é usada como fonte filtrada do esquema e dos dados para as tabelas de destino. Apenas artigos não subscritos podem ser modificados por este procedimento armazenado. Este procedimento armazenado é executado no Publisher no banco de dados de publicação.

Transact-SQL convenções de sintaxe

Syntax

sys.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 ]
[ ; ]

Arguments

[ @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 opiniã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 introduzir 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 subscrições. @change_active é int, com um padrão de 0.

  • Se 0, as colunas não forem alteradas.
  • Se 1, as visualizações podem ser criadas ou recriadas em 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 da subscrição existente e dá permissão para que a reinicialização da subscrição ocorra.

@publisher [ = ] N'editor'

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

@publisher não devem ser usados ao publicar a partir de um editor SQL Server.

[ @refreshsynctranprocs = ] refreshsynctranprocs

Especifica se os procedimentos armazenados usados para sincronizar a replicação são automaticamente recriados. @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 suportado. A compatibilidade futura não é garantida.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_articleview cria a vista que define o artigo publicado e insere o ID dessa vista na sync_objid coluna da tabela sysarticles , e insere o texto da cláusula de restrição na filter_clause coluna. Se todas as colunas forem replicadas e não filter_clausehouver , o sync_objid na tabela sysarticles é definido para o ID da tabela base, e o uso de sp_articleview não é obrigatório.

Para publicar uma tabela com filtro vertical (isto é, para filtrar colunas), execute primeiro sp_addarticle sem parâmetro de @sync_object , execute sp_articlecolumn uma vez para cada coluna a replicar (definindo o filtro vertical) e depois execute sp_articleview para criar a vista que define o artigo publicado.

Para publicar uma tabela filtrada horizontalmente (isto é, para filtrar linhas), execute sp_addarticle sem parâmetro de @filter_name . Executar sp_articlefilter, fornecendo todos os parâmetros, incluindo @filter_clause. Depois executa sp_articleview, fornecendo todos os parâmetros, incluindo a mesma @filter_clause.

Para publicar uma tabela filtrada vertical e horizontalmente, execute sp_addarticle sem parâmetros de @sync_object ou @filter_name . Execute sp_articlecolumn uma vez para cada coluna a replicar, e depois execute sp_articlefilter e sp_articleview.

Se o artigo já tiver uma vista que define o artigo publicado, sp_articleview a vista existente é abandonada e cria automaticamente uma nova. Se a vista foi criada manualmente (type em sysarticles é 5), a vista existente não é eliminada.

Se criar um procedimento armazenado de filtro personalizado e uma vista que defina manualmente o artigo publicado, não execute sp_articleview. Em vez disso, forneça estes valores como parâmetros @filter_name e @sync_object a sp_addarticle, juntamente com o valor de @type apropriado.

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

Conteúdo relacionado

  • Last updated on