sp_articleview (Transact-SQL)
Создает представление, определяющее публикуемую статью, когда таблица фильтруется горизонтально или вертикально. Представление используется как фильтруемый источник схемы и данных для целевых таблиц. Эта хранимая процедура может изменять только те статьи, на которые нет подписки. Эта хранимая процедура выполняется на издателе в базе данных публикации.
.gif "Значок ссылки на раздел")
Синтаксические обозначения в 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..gif "ms187790.note(ru-ru,SQL.90).gif")
Примечание.Аргумент 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.
Разрешение
Выполнять хранимую процедуру sp_articleview могут только члены фиксированной серверной роли sysadmin или фиксированной роли базы данных db_owner.
Пример
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_addarticle (Transact-SQL)
sp_articlefilter (Transact-SQL)
sp_changearticle (Transact-SQL)
sp_droparticle (Transact-SQL)
sp_helparticle (Transact-SQL)
Хранимые процедуры репликации (Transact-SQL)
Другие ресурсы
How to: Define an Article (Replication Transact-SQL Programming)
How to: Define and Modify a Static Row Filter (Replication Transact-SQL Programming)