Jak Definiowanie i modyfikowanie filtru sparametryzowana wiersz artykuł korespondencji seryjnej (Programowanie replikacji Transact-SQL)
Podczas tworzenia tabela artykułów, można użyć filtrów parametrami wiersza.Te filtry za pomocą gdzie klauzula, aby wybrać odpowiednie dane, które zostaną opublikowane.Zamiast określania wartości literału w klauzula (jak w statyczny filtr wierszy), określić jedną lub obie z następujących funkcje systemowe: SUSER_SNAME i HOST_NAME.Aby uzyskać więcej informacji, zobacz Sparametryzowana filtry wiersza.Filtry parametrami wiersza można tworzyć i modyfikować programowo przy użyciu procedury przechowywane replikacja.
Aby zdefiniować sparametryzowany filtr wierszy artykuł w publikacja seryjnej
Wydawca na baza danych publikacja, wykonanie sp_addmergearticle (języka Transact-SQL).Określ publikacja @, nazwę artykuł dla @ artykuł, publikowana w tabela @ source_object, klauzula WHERE, definiujący sparametryzowana filtr dla @ subset_filterclause (nie wliczając WHERE), i jedną z następujących wartości @ partition_options, które opisuje typ partycjonowanie na partycje spowoduje z sparametryzowany filtr wierszy:
0 - Filtrowania artykuł jest statyczny lub nie dają unikatowy podzbiór danych dla każdej partycji ("nakładania się" partycja).
1 - Wynikowy partycje są nakładających się i nie można zmienić, aktualizacje dokonane przez subskrybenta partycji, do której należy dany wiersz.
2 — Filtrowanie artykuł daje sasiadująco partycji, ale wielu subskrybentów może odbierać tej samej partycji.
3 - Filtrowania dla partycji sasiadująco plonów artykuł, które są unikatowe dla subskrypcja.
Aby zmienić sparametryzowany filtr wierszy artykuł w publikacja seryjnej
Wydawca na baza danych publikacja, wykonanie sp_changemergearticle.Określ publikacja @, @ artykuł, wartość subset_filterclause dla @ Właściwość, wyrażenie, które definiuje sparametryzowana filtr dla wartość @ (łącznie nie WHERE) i wartość 1 dla obu @ force_invalidate_snapshot i @ force_reinit_subscription.
Jeśli zmiana wyniki w różny sposób partycjonowanie na partycje, a następnie ich wykonać sp_changemergearticle ponownie.Określ publikacja @, @ artykuł, wartość partition_options dla @ Właściwośći najbardziej odpowiednią opcję partycjonowanie dla wartość @, która może być jeden z następujących:
0 - Filtrowania artykuł jest statyczny lub nie dają unikatowy podzbiór danych dla każdej partycji ("nakładania się" partycja).
1 - Wynikowy partycje są nakładających się i nie można zmienić, aktualizacje dokonane przez subskrybenta partycji, do której należy dany wiersz.
2 — Filtrowanie artykuł daje sasiadująco partycji, ale wielu subskrybentów może odbierać tej samej partycji.
3 - Filtrowania dla partycji sasiadująco plonów artykuł, które są unikatowe dla subskrypcja.
Przykład
W tym przykładzie definiuje grupę artykuły w publikacja seryjnej gdzie artykuły są filtrowane z serii filtrów łączyć przeciwko pracownika tabela jest sam przefiltrowane przy użyciu sparametryzowany filtr wierszy na LoginID kolumna.Podczas synchronizacji, wartość zwracana przez HOST_NAME funkcja jest wyłączona.Aby uzyskać więcej informacji, zobacz zastępowanie wartość HOST_NAME() w temacie Filtry parametrami wiersza.
-- To avoid storing the login and password in the script file, the value
-- is passed into SQLCMD as a scripting variable. For information about
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".
--Add a new merge publication.
DECLARE @publicationdb AS sysname;
DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @filter AS sysname;
DECLARE @schema_hr AS sysname;
DECLARE @schema_sales AS sysname;
SET @publicationdb = N'AdventureWorks2008R2';
SET @publication = N'AdvWorksSalesPersonMerge';
SET @table1 = N'Employee';
SET @table2 = N'SalesPerson';
SET @filter = N'SalesPerson_Employee';
SET @schema_hr = N'HumanResources';
SET @schema_sales = N'Sales';
USE [AdventureWorks2008R2];
-- Enable AdventureWorks2008R2 for merge replication.
EXEC sp_replicationdboption
@dbname = @publicationdb,
@optname = N'merge publish',
@value = N'true';
-- Create new merge publication with Subscriber requested snapshot
-- and using the default agent schedule.
EXEC sp_addmergepublication
@publication = @publication,
@description = N'Merge publication of AdventureWorks2008R2.',
@allow_subscriber_initiated_snapshot = N'true',
@publication_compatibility_level = N'90RTM';
-- Create a new snapshot job for the publication, using the default schedule.
-- Pass credentials at runtime using sqlcmd scripting variables.
EXEC sp_addpublication_snapshot
@publication = @publication,
@job_login = $(login),
@job_password = $(password);
-- Add an article for the Employee table,
-- which is horizontally partitioned using
-- a parameterized row filter.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table1,
@source_owner = @schema_hr,
@source_object = @table1,
@type = N'table',
@description = 'contains employee information',
@subset_filterclause = N'[LoginID] = HOST_NAME()';
-- Add an article for the SalesPerson table,
-- which is partitioned based on a join filter.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table2,
@source_owner = @schema_sales,
@source_object = @table2,
@type = N'table',
@description = 'contains salesperson information';
-- Add a join filter between the two articles.
EXEC sp_addmergefilter
@publication = @publication,
@article = @table1,
@filtername = @filter,
@join_articlename = @table2,
@join_filterclause = N'[Employee].[BusinessEntityID] = [SalesPerson].[SalesPersonID]',
@join_unique_key = 1,
@filter_type = 1;
GO
-- Start the agent job to generate the full snapshot for the publication.
-- The filtered data snapshot is generated automatically the first time
-- the subscription is synchronized.
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesPersonMerge';
EXEC sp_startpublication_snapshot
@publication = @publication;
GO