sp_changemergefilter (Transact-SQL)

Si applica a: sìSQL Server (tutte le versioni supportate)

Consente di modificare alcune proprietà del filtro di merge. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

  
sp_changemergefilter [ @publication= ] 'publication'  
        , [ @article= ] 'article'  
        , [ @filtername= ] 'filtername'  
        , [ @property= ] 'property'  
        , [ @value= ] 'value'  
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  

Argomenti

[ @publication = ] 'publication' Nome della pubblicazione. publication è sysname, senza alcun valore predefinito.

[ @article = ] 'article' Nome dell'articolo. article è sysname, senza alcun valore predefinito.

[ @filtername = ] 'filtername' Nome corrente del filtro. filtername è sysname, senza alcun valore predefinito.

[ @property = ] 'property' Nome della proprietà da modificare. la proprietà è sysname, senza alcun valore predefinito.

[ @value = ] 'value' Nuovo valore per la proprietà specificata. value è nvarchar(1000), senza alcun valore predefinito.

Nella tabella seguente vengono descritte le proprietà degli articoli e i valori corrispondenti.

Proprietà Valore Descrizione
filter_type 1 Filtro join.

Questa opzione è necessaria per supportare i Sottoscrittori SQL Server Compact.
2 Relazione tra record logici.
3 Il filtro join è anche una relazione tra record logici.
filtername Nome del filtro.
join_articlename Nome dell'articolo di join.
join_filterclause Clausola di filtro.
join_unique_key true Il join è basato su una chiave univoca.
false Il join non è basato su una chiave univoca.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot Riconosce che l'azione eseguita da questo stored procedure può invalidare uno snapshot esistente. force_invalidate_snapshot è un bit, con un valore predefinito 0.

0 specifica che le modifiche all'articolo di merge non causano l'invalido dello snapshot. Se la stored procedure rileva che la modifica richiede un nuovo snapshot, viene generato un errore e non viene apportata alcuna modifica.

1 indica che le modifiche apportate all'articolo di merge possono causare l'invalido dello snapshot e, se sono presenti sottoscrizioni esistenti che richiedono un nuovo snapshot, concede l'autorizzazione per l'eliminazione dello snapshot esistente come obsoleto e la generazione di un nuovo snapshot.

[ @force_reinit_subscription = ] force_reinit_subscription Riconosce che l'azione eseguita da questo stored procedure può richiedere la reinizializzazione delle sottoscrizioni esistenti. force_reinit_subscription è un bit con il valore predefinito 0.

0 specifica che le modifiche all'articolo di merge non causano la reinizializzazione della sottoscrizione. Se la stored procedure rileva che la modifica richiede la reinizializzazione delle sottoscrizioni esistenti, viene generato un errore e non viene apportata alcuna modifica.

1 indica che le modifiche all'articolo di merge causeranno la reinizializzazione delle sottoscrizioni esistenti e concede l'autorizzazione per la reinizializzazione della sottoscrizione.

Valori del codice restituito

0 (esito positivo) o 1 (errore)

Commenti

sp_changemergefilter viene usato nella replica di tipo merge.

Per modificare il filtro in un articolo di merge, è necessario ricreare lo snapshot, se disponibile. Questa operazione viene eseguita impostando il @ force_invalidate_snapshot su 1. È inoltre necessario reinizializzare le eventuali sottoscrizioni esistenti dell'articolo. Questa operazione viene eseguita impostando il @ force_reinit_subscription su 1.

Per utilizzare record logici, è necessario che la pubblicazione e gli articoli soddisfino alcuni requisiti. Per altre informazioni, vedere Raggruppare modifiche alle righe correlate con record logici.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin o db_owner ruolo predefinito del database possono eseguire sp_changemergefilter .

Vedere anche

Modificare le proprietà di pubblicazioni e articoli
sp_addmergefilter (Transact-SQL)
sp_dropmergefilter (Transact-SQL)
sp_helpmergefilter (Transact-SQL)
Stored procedure di sistema (Transact-SQL)