Поделиться через


sp_articleview (Transact-SQL)

Создает представление, определяющее публикуемую статью, когда таблица фильтруется горизонтально или вертикально. Представление используется как фильтруемый источник схемы и данных для целевых таблиц. Эта хранимая процедура может изменять только те статьи, на которые нет подписки. Эта хранимая процедура выполняется на издателе в базе данных публикации.

Значок ссылки на разделСинтаксические обозначения в Transact-SQL

Синтаксис

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 ]

Аргументы

  • [ @publication=] 'publication'
    Имя публикации, которая содержит статью. Аргумент publication имеет тип sysname и не имеет значения по умолчанию.

  • [ @article=] 'article'
    Имя статьи. Аргумент article имеет тип sysname и не имеет значения по умолчанию.

  • [ @view_name=] 'view_name'
    Имя представления, определяющего опубликованную статью. Аргумент view_name имеет тип nvarchar(386) и значение по умолчанию NULL.

  • [ @filter_clause=] 'filter_clause'
    Предложение ограничения (WHERE), которое задает горизонтальный фильтр. При вводе предложения ограничения опустите ключевое слово WHERE. Аргумент filter_clause имеет тип ntext и значение по умолчанию NULL.

  • [ @change_active = ] change_active
    Разрешает изменение столбцов в публикациях, на которые имеются подписки. Аргумент change_active имеет тип int и значение по умолчанию 0. Если значение равно 0, изменение столбцов невозможно. Если значение равно 1, возможно создание или повторное создание представлений для активных статей, на которые существуют подписки.

  • [ @force_invalidate_snapshot = ] force_invalidate_snapshot
    Подтверждает, что действие, выполненное этой хранимой процедурой, может сделать текущий моментальный снимок недействительным. Аргумент force_invalidate_snapshot имеет тип bit и значение по умолчанию 0.

    0 означает, что изменения в статью не делают моментальный снимок недействительным. Если хранимая процедура определяет, что изменение не требует создания нового моментального снимка, возникает ошибка, и изменение не выполняется.

    1 означает, что изменения в статье могут сделать моментальный снимок недействительным, и, если существуют подписки, для которых потребуется новый моментальный снимок, дает разрешение на отметку текущего моментального снимка как недействительного и на создание нового моментального снимка.

  • [ @force_reinit_subscription = ] force_reinit_subscription
    Подтверждает, что действие, выполняемое данной хранимой процедурой, может сделать необходимой повторную инициализацию текущих подписок. Аргумент force_reinit_subscription имеет тип bit и значение по умолчанию 0.

    0 означает, что изменения статьи не вызывают повторной инициализации подписки. Если хранимая процедура определяет, что изменение потребует повторной инициализации подписки, то выдается сообщение об ошибке, и изменения не производится.

    1 означает, что изменения в данной статье вызовут повторную инициализацию подписки, и дает разрешение на выполнение повторной инициализации подписки.

  • [ @publisher= ] 'publisher'
    Задает издателя, отличного от Microsoft SQL Server. Аргумент publisher имеет тип sysname и значение по умолчанию NULL.

    ПримечаниеПримечание

    Аргумент publisher не следует использовать, когда публикация выполняется с издателя SQL Server.

  • [ @refreshsynctranprocs = ] refreshsynctranprocs
    Указывает, будут ли хранимые процедуры, используемые для синхронизации репликации, автоматически создаваться повторно. Аргумент refreshsynctranprocs имеет тип bit и значение по умолчанию 1.

    1 означает, что хранимые процедуры будут создаваться повторно.

    0 означает, что хранимые процедуры не будут создаваться повторно.

  • [ @internal= ] internal
    Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Хранимая процедура sp_articleview создает представление, определяющее публикуемую статью, вставляет идентификатор этого представления в столбец sync_objid таблицы sysarticles (Transact-SQL) и помещает текст ограничивающего предложения в столбец filter_clause. Если все столбцы реплицируются, и столбец filter_clause отсутствует, тогда в столбец sync_objid таблицы sysarticles (Transact-SQL) записывается идентификатор базовой таблицы, и использование хранимой процедуры sp_articleview не требуется.

Для публикации вертикально фильтруемой таблицы (т.е. для фильтрации столбцов) необходимо выполнить хранимую процедуру sp_addarticle без указания аргумента sync_object, затем выполнить хранимую процедуру sp_articlecolumn (Transact-SQL) для каждого реплицируемого столбца (определяя вертикальный фильтр), и после этого выполнить хранимую процедуру sp_articleview, создающую представление, определяющее публикуемую статью.

Для публикации горизонтально фильтруемой таблицы (т.е. для фильтрации строк) необходимо выполнить хранимую процедуру sp_addarticle (Transact-SQL) без указания аргумента filter. Затем нужно выполнить хранимую процедуру sp_articlefilter (Transact-SQL), указав все аргументы, включая аргумент filter_clause. После этого необходимо выполнить хранимую процедуру sp_articleview со всеми аргументами, включая тот же самый аргумент filter_clause.

Для публикации таблицы, фильтруемой как горизонтально, так и вертикально, необходимо выполнить хранимую процедуру sp_addarticle (Transact-SQL) без аргументов sync_object и filter. После этого нужно выполнить хранимую процедуру sp_articlecolumn (Transact-SQL) по одному разу для каждого реплицируемого столбца, а затем — процедуры sp_articlefilter (Transact-SQL) и sp_articleview.

Если у статьи уже существовало представление, определяющее публикуемую статью, хранимая процедура sp_articleview удалит существующее представление и автоматически создаст новое. Если представление было создано вручную (значение в столбце type таблицы sysarticles (Transact-SQL) равно 5), то существующее представление не удаляется.

Если хранимая процедура пользовательского фильтра и представление, определяющее публикуемую статью, созданы вручную, не следует запускать хранимую процедуру sp_articleview. Вместо этого следует указать их в качестве аргументов filter и sync_object процедуры sp_addarticle (Transact-SQL) вместе с необходимым значением столбца type.

Пример

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

Разрешение

Выполнять хранимую процедуру sp_articleview могут только члены предопределенной роли сервера sysadmin или предопределенной роли базы данных db_owner.