sp_addmergefilter (Transact-SQL)

Статья
11/25/2023

Область применения: SQL Server Управляемый экземпляр SQL Azure

Добавляет новый фильтр слияния для создания секции на базе соединения с другой таблицей. Эта хранимая процедура выполняется на издателе в базе данных публикации.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_addmergefilter
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    , [ @filtername = ] N'filtername'
    , [ @join_articlename = ] N'join_articlename'
    , [ @join_filterclause = ] N'join_filterclause'
    [ , [ @join_unique_key = ] join_unique_key ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @filter_type = ] filter_type ]
[ ; ]

Аргументы

[ @publication = ] N'publication'

Имя публикации, в которой добавляется фильтр слияния. @publication — sysname без значения по умолчанию.

[ @article = ] N'article'

Имя статьи, в которой добавляется фильтр слияния. @article — sysname без значения по умолчанию.

[ @filtername = ] N'filtername'

Имя фильтра. @filtername является обязательным параметром. @filtername — sysname без значения по умолчанию.

[ @join_articlename = ] N'join_articlename'

Родительская статья, к которой дочерняя статья, указанная @article, должна быть присоединена с помощью предложения соединения, указанного @join_filterclause, для определения строк в дочерней статье, удовлетворяющей критерию фильтра слияния. @join_articlename — sysname без значения по умолчанию. Статья должна находиться в публикации, предоставленной @publication.

[ @join_filterclause = ] N'join_filterclause'

Предложение соединения, которое должно использоваться для объединения дочерней статьи, указанной @article и родительской статьей, указанной @join_article, для определения строк, соответствующих фильтру слияния. @join_filterclause — nvarchar(1000), без значения по умолчанию.

[ @join_unique_key = ] join_unique_key

Указывает, является ли соединение между дочерней статьей @article и родительской статьей, @join_article — "один ко многим", "один к одному", "многие ко многим" или "многие ко многим". @join_unique_key имеет значение int с значением по умолчанию0.

0 указывает соединение "многие ко многим" или "многие ко многим".
1 указывает соединение "один к одному" или "один ко многим".

Это значение заключается 1 в том, что присоединенные столбцы образуют уникальный ключ в @join_article или если @join_filterclause между внешним ключом в @article и первичным ключом в @join_article.

Внимание

Установите этот параметр 1 только в том случае, если у вас есть ограничение на присоединенный столбец в базовой таблице родительской статьи, которая гарантирует уникальность. Если @join_unique_key задано 1 неправильно, может возникнуть неконвергенция данных.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

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

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

[ @force_reinit_subscription = ] force_reinit_subscription

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

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

[ @filter_type = ] filter_type

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

значение	Описание
`1`	Только фильтр соединения. Требуется для поддержки подписчиков SQL Server Compact.
`2`	Только связь логических записей.
`3`	Как фильтр соединения, так и связь логических записей.

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

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

0 (успешно) или 1 (сбой).

Замечания

sp_addmergefilter используется в репликации слиянием.

sp_addmergefilter можно использовать только с статьями таблицы. Статьи с представлением и индексированием не поддерживаются.

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

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

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

Невозможно добавить фильтр соединения между двумя опубликованными статьями, если исходные таблицы для обеих статей используют одно и то же имя объекта таблицы. В таком случае, даже если обе таблицы принадлежат разным схемам и имеют уникальные имена статей, создание фильтра соединения завершается ошибкой.

Если как параметризованный фильтр строк, так и фильтр соединения применяются к статье таблицы, то репликация определяет, принадлежит ли строка к секции подписчика. Это делается путем оценки функции фильтрации или фильтра соединения (с помощью оператора OR), а не вычисления пересечения двух условий (с помощью оператора AND).

Примеры

DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @table3 AS sysname;
DECLARE @salesschema AS sysname;
DECLARE @hrschema AS sysname;
DECLARE @filterclause AS nvarchar(1000);
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @table1 = N'Employee'; 
SET @table2 = N'SalesOrderHeader'; 
SET @table3 = N'SalesOrderDetail'; 
SET @salesschema = N'Sales';
SET @hrschema = N'HumanResources';
SET @filterclause = N'Employee.LoginID = HOST_NAME()';

-- Add a filtered article for the Employee table.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table1, 
  @source_object = @table1, 
  @type = N'table', 
  @source_owner = @hrschema,
  @schema_option = 0x0004CF1,
  @description = N'article for the Employee table',
  @subset_filterclause = @filterclause;

-- Add an article for the SalesOrderHeader table that is filtered
-- based on Employee and horizontally filtered.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @source_object = @table2, 
  @type = N'table', 
  @source_owner = @salesschema, 
  @vertical_partition = N'true',
  @schema_option = 0x0034EF1,
  @description = N'article for the SalesOrderDetail table';

-- Add an article for the SalesOrderDetail table that is filtered
-- based on SaledOrderHeader.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table3, 
  @source_object = @table3, 
  @source_owner = @salesschema,
  @description = 'article for the SalesOrderHeader table', 
  @identityrangemanagementoption = N'auto', 
  @pub_identity_range = 100000, 
  @identity_range = 100, 
  @threshold = 80,
  @schema_option = 0x0004EF1;

-- Add all columns to the SalesOrderHeader article.
EXEC sp_mergearticlecolumn 
  @publication = @publication, 
  @article = @table2, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Remove the credit card Approval Code column.
EXEC sp_mergearticlecolumn 
  @publication = @publication, 
  @article = @table2, 
  @column = N'CreditCardApprovalCode', 
  @operation = N'drop', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Add a merge join filter between Employee and SalesOrderHeader.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table2, 
  @filtername = N'SalesOrderHeader_Employee', 
  @join_articlename = @table1, 
  @join_filterclause = N'Employee.EmployeeID = SalesOrderHeader.SalesPersonID', 
  @join_unique_key = 1, 
  @filter_type = 1, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Add a merge join filter between SalesOrderHeader and SalesOrderDetail.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table3, 
  @filtername = N'SalesOrderDetail_SalesOrderHeader', 
  @join_articlename = @table2, 
  @join_filterclause = N'SalesOrderHeader.SalesOrderID = SalesOrderDetail.SalesOrderID', 
  @join_unique_key = 1, 
  @filter_type = 1, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;
GO

Разрешения

Могут выполняться только члены предопределенных ролей сервера sysadmin или db_owner предопределенных ролей базы данных.sp_addmergefilter

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

sp_addmergefilter (Transact-SQL)

Синтаксис

Аргументы

[ @publication = ] N'publication'

[ @article = ] N'article'

[ @filtername = ] N'filtername'

[ @join_articlename = ] N'join_articlename'

[ @join_filterclause = ] N'join_filterclause'

[ @join_unique_key = ] join_unique_key

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

[ @force_reinit_subscription = ] force_reinit_subscription

[ @filter_type = ] filter_type

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

Замечания

Примеры

Разрешения

Обратная связь

Дополнительные ресурсы

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

sp_addmergefilter (Transact-SQL)

Синтаксис

Аргументы

[ @publication = ] N'publication'

[ @article = ] N'article'

[ @filtername = ] N'filtername'

[ @join_articlename = ] N'join_articlename'

[ @join_filterclause = ] N'join_filterclause'

[ @join_unique_key = ] join_unique_key

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

[ @force_reinit_subscription = ] force_reinit_subscription

[ @filter_type = ] filter_type

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

Замечания

Примеры

Разрешения

Связанный контент

Обратная связь

Дополнительные ресурсы