Definire e modificare un filtro di riga con parametri per un articolo di merge
Si applica a:
SQL Server
Questo argomento descrive come definire e modificare un filtro di riga con parametri in SQL Server usando SQL Server Management Studio o Transact-SQL.
Quando si creano articoli di tabella, è possibile usare filtri di riga con parametri. Questi filtri usano una clausola WHERE per selezionare i dati adatti da pubblicare. Anziché specificare un valore letterale nella clausola, come avviene con il filtro di riga statico, si specificano una o entrambe le funzioni di sistema seguenti: SUSER_SNAME e HOST_NAME. Per altre informazioni sui filtri di riga con parametri, vedere Filtri di riga con parametri.
Contenuto dell'articolo
Prima di iniziare:
Per definire e modificare un filtro di riga con parametri, usando:
Prima di iniziare
Limitazioni e restrizioni
- Se si aggiunge, modifica o elimina un filtro di riga con parametri dopo che sono state inizializzate sottoscrizioni per la pubblicazione, è necessario generare un nuovo snapshot e reinizializzare tutte le sottoscrizioni in seguito alla modifica. Per altre informazioni sui requisiti per la modifica delle proprietà, vedere Modificare le proprietà di pubblicazioni e articoli.
Consigli
- Per motivi relativi alle prestazioni è consigliabile evitare di applicare funzioni ai nomi di colonna nelle clausole per filtri di riga con parametri, come
LEFT([MyColumn]) = SUSER_SNAME(). Se si usano HOST_NAME in una clausola di filtro e si sostituisce il valore HOST_NAME, può essere necessario convertire i tipi di dati tramite l'istruzione CONVERT. Per altre informazioni sulle procedure consigliate in questo caso, vedere la sezione relativa alla sostituzione del valore HOST_NAME() nell'argomento Parameterized Row Filters.
Utilizzo di SQL Server Management Studio
Definire, modificare ed eliminare filtri di riga con parametri nella pagina Filtro righe tabella della Creazione guidata nuova pubblicazione oppure nella pagina Filtra righe della finestra di dialogo Proprietà pubblicazione - <Pubblicazione>. Per altre informazioni sull'uso della creazione guidata e l'accesso alla finestra di dialogo, vedere Creare una pubblicazione e Visualizzare e modificare le proprietà della pubblicazione.
Per definire un filtro di riga con parametri
Nella pagina Filtro righe tabella della Creazione guidata nuova pubblicazione oppure nella pagina Filtra righe della finestra di dialogo Proprietà pubblicazione - <Pubblicazione> fare clic su Aggiungi e quindi su Aggiungi filtro.
Nella finestra di dialogo Aggiungi filtro selezionare una tabella da filtrare nell'elenco a discesa.
Creare un'istruzione di filtro nella casella di testo Istruzione per il filtro . È possibile digitare direttamente nell'area di testo nonché trascinare colonne dalla casella di riepilogo Colonne .
L'area di testo Istruzione per il filtro contiene il testo predefinito, nel formato seguente:
SELECT <published_columns> FROM [tableowner].[tablename] WHEREIl testo predefinito non può essere modificato. Digitare la clausola di filtro dopo la parola chiave WHERE usando la sintassi SQL standard. Un filtro con parametri include una chiamata alla funzione di sistema HOST_NAME() e/o SUSER_SNAME()oppure a una funzione definita dall'utente che fa riferimento a una di queste funzioni o a entrambe. Di seguito è riportato un esempio di una clausola di filtro completa per un filtro di riga con parametri:
SELECT <published_columns> FROM [HumanResources].[Employee] WHERE LoginID = SUSER_SNAME()Per la clausola WHERE è consigliabile usare nomi in due parti. I nomi in tre e quattro parti non sono supportati.
Selezionare l'opzione corrispondente alla modalità desiderata di condivisione dei dati tra i Sottoscrittori:
Una riga di questa tabella verrà inviata a più sottoscrizioni
Una riga di questa tabella verrà inviata a una sola sottoscrizione
Selezionando Una riga di questa tabella verrà inviata a una sola sottoscrizioneè possibile ottimizzare le prestazioni della replica di tipo merge archiviando ed elaborando una minore quantità di metadati. È tuttavia necessario garantire che i dati vengano partizionati in modo da non consentire la replica di una riga in più Sottoscrittori. Per altre informazioni, vedere la sezione relativa all'impostazione delle opzioni delle partizioni nell'argomento Filtri di riga con parametri.
Seleziona OK.
Se è visualizzata la finestra di dialogo Proprietà pubblicazione - <Pubblicazione> fare clic su OK per salvare e chiudere la finestra di dialogo.
Per modificare un filtro di riga con parametri
Nella pagina Filtro righe tabella della Creazione guidata nuova pubblicazione o nella pagina Filtro righe di Proprietà pubblicazione - <Pubblicazione> selezionare un filtro nel riquadro Tabelle filtrate e quindi fare clic su Modifica.
Nella finestra di dialogo Modifica filtro modificare il filtro.
Seleziona OK.
Per eliminare un filtro di riga con parametri
- Nella pagina Filtro righe tabella della Creazione guidata nuova pubblicazione o nella pagina Filtro righe di Proprietà pubblicazione - <Pubblicazione> selezionare un filtro nel riquadro Tabelle filtrate e quindi fare clic su Elimina.
Utilizzo di Transact-SQL
È possibile creare e modificare a livello di programmazione i filtri di riga con parametri tramite le stored procedure di replica.
Per definire un filtro di riga con parametri per un articolo in una pubblicazione di tipo merge
Nel database di pubblicazione del server di pubblicazione eseguire sp_addmergearticle (Transact-SQL). Specificare @publication, un nome di articolo per @article, la tabella da pubblicare per @source_object, la clausola WHERE che definisce il filtro con parametri per @subset_filterclause (escluso
WHERE) e uno dei valori seguenti per @partition_options, che descrive il tipo di partizionamento risultante dall'applicazione del filtro di riga con parametri:0 : il filtro dell'articolo è statico oppure non restituisce un subset univoco di dati per ogni partizione, ovvero si tratta di una partizione "sovrapposta".
1 : le partizioni risultanti sono sovrapposte e gli aggiornamenti apportati nel Sottoscrittore non possono modificare la partizione a cui appartiene una riga.
2 : il filtro dell'articolo restituisce partizioni non sovrapposte, ma più Sottoscrittori ricevono la stessa partizione.
3 : il filtro dell'articolo restituisce partizioni non sovrapposte univoche per ogni sottoscrizione.
Per modificare un filtro di riga con parametri per un articolo in una pubblicazione di tipo merge
Nel database di pubblicazione del server di pubblicazione eseguire sp_changemergearticle. Specificare @publication, @article, il valore subset_filterclause per @property, the expression that defines the parameterized filter per @value (escluso
WHERE) e il valore 1 per both @perce_invalidate_snapshot e @perce_reinit_subscription.Se questa modifica implica un diverso comportamento del partizionamento, eseguire nuovamente sp_changemergearticle . Specificare @publication, @article, il valore partition_options per @propertye l'opzione di partizionamento più appropriata tra quelle elencate di seguito per @value:
0 : il filtro dell'articolo è statico oppure non restituisce un subset univoco di dati per ogni partizione, ovvero si tratta di una partizione "sovrapposta".
1 : le partizioni risultanti sono sovrapposte e gli aggiornamenti apportati nel Sottoscrittore non possono modificare la partizione a cui appartiene una riga.
2 : il filtro dell'articolo restituisce partizioni non sovrapposte, ma più Sottoscrittori ricevono la stessa partizione.
3 : il filtro dell'articolo restituisce partizioni non sovrapposte univoche per ogni sottoscrizione.
Esempio (Transact-SQL)
In questo esempio viene definito un gruppo di articoli di una pubblicazione di tipo merge in cui agli articoli è applicata una serie di filtri di join sulla tabella Employee che presenta essa stessa un filtro di riga con parametri sulla colonna LoginID . Durante la sincronizzazione viene sostituito il valore restituito dalla funzione HOST_NAME . Per altre informazioni, vedere la sezione relativa alla sostituzione del valore HOST_NAME() nell'argomento Parameterized Row Filters.
-- 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'AdventureWorks2022';
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 [AdventureWorks2022];
-- Enable AdventureWorks2022 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 AdventureWorks2022.',
@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
Vedi anche
Definizione e modifica di un filtro di join tra articoli di merge
Modificare le proprietà di pubblicazioni e articoli
Filtri di join
Filtri di riga con parametri
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per