sp_addmergearticle (Transact-SQL)

Si applica a: SQL Server Istanza gestita di SQL di Azure

Aggiunge un articolo a una pubblicazione di tipo merge esistente. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_addmergearticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    , [ @source_object = ] N'source_object'
    [ , [ @type = ] N'type' ]
    [ , [ @description = ] N'description' ]
    [ , [ @column_tracking = ] N'column_tracking' ]
    [ , [ @status = ] N'status' ]
    [ , [ @pre_creation_cmd = ] N'pre_creation_cmd' ]
    [ , [ @creation_script = ] N'creation_script' ]
    [ , [ @schema_option = ] schema_option ]
    [ , [ @subset_filterclause = ] N'subset_filterclause' ]
    [ , [ @article_resolver = ] N'article_resolver' ]
    [ , [ @resolver_info = ] N'resolver_info' ]
    [ , [ @source_owner = ] N'source_owner' ]
    [ , [ @destination_owner = ] N'destination_owner' ]
    [ , [ @vertical_partition = ] N'vertical_partition' ]
    [ , [ @auto_identity_range = ] N'auto_identity_range' ]
    [ , [ @pub_identity_range = ] pub_identity_range ]
    [ , [ @identity_range = ] identity_range ]
    [ , [ @threshold = ] threshold ]
    [ , [ @verify_resolver_signature = ] verify_resolver_signature ]
    [ , [ @destination_object = ] N'destination_object' ]
    [ , [ @allow_interactive_resolver = ] N'allow_interactive_resolver' ]
    [ , [ @fast_multicol_updateproc = ] N'fast_multicol_updateproc' ]
    [ , [ @check_permissions = ] check_permissions ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @published_in_tran_pub = ] N'published_in_tran_pub' ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @logical_record_level_conflict_detection = ] N'logical_record_level_conflict_detection' ]
    [ , [ @logical_record_level_conflict_resolution = ] N'logical_record_level_conflict_resolution' ]
    [ , [ @partition_options = ] partition_options ]
    [ , [ @processing_order = ] processing_order ]
    [ , [ @subscriber_upload_options = ] subscriber_upload_options ]
    [ , [ @identityrangemanagementoption = ] N'identityrangemanagementoption' ]
    [ , [ @delete_tracking = ] N'delete_tracking' ]
    [ , [ @compensate_for_errors = ] N'compensate_for_errors' ]
    [ , [ @stream_blob_columns = ] N'stream_blob_columns' ]
[ ; ]

Argomenti

[ @publication = ] N'publication'

Nome della pubblicazione contenente l'articolo. @publication è sysname, senza impostazione predefinita.

[ @article = ] N'article'

Nome dell'articolo. Deve essere un nome univoco all'interno della pubblicazione. @article è sysname, senza impostazione predefinita. @article deve trovarsi nel computer locale che esegue SQL Server e deve essere conforme alle regole per gli identificatori.

[ @source_object = ] N'source_object'

Oggetto di database da pubblicare. @source_object è sysname, senza impostazione predefinita. Per altre informazioni sui tipi di oggetti che possono essere pubblicati tramite la replica di tipo merge, vedere Pubblicare dati e oggetti di database.

[ @type = ] N'type'

Tipo di articolo. @type è sysname, con un valore predefinito , tablee può essere uno dei valori seguenti.

[ @description = ] N'description'

Descrizione dell'articolo. @description è nvarchar(255), con il valore predefinito NULL.

[ @column_tracking = ] N'column_tracking'

Impostazione per il rilevamento a livello di colonna. @column_tracking è nvarchar(10), con il valore predefinito false. false attiva il rilevamento delle colonne. false disattiva il rilevamento delle colonne e lascia il rilevamento dei conflitti a livello di riga. Se la tabella è già pubblicata in altre pubblicazioni di tipo merge, è necessario utilizzare lo stesso valore di rilevamento a livello di colonna utilizzato dagli articoli esistenti basati su questa tabella. Questo parametro è disponibile solo per gli articoli di tabelle.

[ @status = ] N'status'

Stato dell'articolo. @status è nvarchar(10), con un valore predefinito .unsynced Se active, viene eseguito lo script di elaborazione iniziale per pubblicare la tabella. Se unsynced, lo script di elaborazione iniziale per pubblicare la tabella viene eseguito alla successiva esecuzione del agente di snapshot.

[ @pre_creation_cmd = ] N'pre_creation_cmd'

Azione eseguita dal sistema se, quando si applica lo snapshot, la tabella esiste già nel Sottoscrittore. @pre_creation_cmd è nvarchar(10)e può essere uno dei valori seguenti.

[ @creation_script = ] N'creation_script'

Percorso e nome di uno script dello schema di articolo facoltativo usato per creare l'articolo nel database di sottoscrizione. @creation_script è nvarchar(255), con un valore predefinito .NULL

[ @schema_option = ] schema_option

Bitmap dell'opzione di generazione dello schema per l'articolo specificato. @schema_option è varbinary(8)e può essere | (OR bit per bit) prodotto di uno o più di questi valori.

Se questo valore è NULL, il sistema genera automaticamente un'opzione di schema valida per l'articolo. La tabella dell'opzione Schema predefinito mostra il valore scelto in base al tipo di articolo. Inoltre, non tutti i valori @schema_option sono validi per ogni tipo di replica e tipo di articolo. La tabella opzione Schema valido mostra le opzioni che è possibile specificare per un determinato tipo di articolo.

[ @subset_filterclause = ] N'subset_filterclause'

Clausola WHERE che specifica il filtro orizzontale di un articolo di tabella senza la parola WHERE inclusa. @subset_filterclause è nvarchar(1000), con un valore predefinito di una stringa vuota.

[ @article_resolver = ] N'article_resolver'

Sistema di risoluzione basato su COM usato per risolvere i conflitti nell'articolo della tabella o nell'assembly .NET Framework richiamato per eseguire la logica di business personalizzata nell'articolo della tabella. @article_resolver è nvarchar(255), con un valore predefinito .NULL I valori disponibili per questo parametro sono elencati in Resolver personalizzati Microsoft. Se il valore fornito non è uno dei resolver Microsoft, SQL Server usa il resolver specificato anziché il sistema di risoluzione fornito dal sistema. Utilizzare sp_enumcustomresolvers per enumerare l'elenco dei resolver personalizzati disponibili. Per altre informazioni, vedere Eseguire la logica di business durante la sincronizzazione di tipo merge e la replica avanzata di tipo merge - Rilevamento e risoluzione dei conflitti.

[ @resolver_info = ] N'resolver_info'

Consente di specificare informazioni aggiuntive richieste da un sistema di risoluzione personalizzato. Alcuni resolver Microsoft richiedono una colonna fornita come input per il sistema di risoluzione. @resolver_info è nvarchar(517), con un valore predefinito .NULL Per altre informazioni, vedere Conflitti avanzati di replica di tipo merge - Resolver basati su COM.

[ @source_owner = ] N'source_owner'

Nome del proprietario del @source_object. @source_owner è sysname, con un valore predefinito .NULL Se NULL, si presuppone che l'utente corrente sia il proprietario.

[ @destination_owner = ] N'destination_owner'

Proprietario dell'oggetto nel database di sottoscrizione, se non dbo. @destination_owner è sysname, con un valore predefinito .NULL Se NULL, dbo si presuppone che sia il proprietario.

[ @vertical_partition = ] N'vertical_partition'

Abilita e disabilita l'applicazione di filtri alle colonne in un articolo di tabella. @vertical_partition è nvarchar(5), con il valore predefinito false.

• false indica che non è presente alcun filtro verticale e pubblica tutte le colonne.

• false cancella tutte le colonne ad eccezione della chiave primaria e ROWGUID delle colonne dichiarate. Le colonne vengono aggiunte tramite sp_mergearticlecolumn.

[ @auto_identity_range = ] N'auto_identity_range'

Abilita e disabilita la gestione automatica degli intervalli di valori Identity per questo articolo della tabella in una pubblicazione al momento della creazione. @auto_identity_range è nvarchar(5), con un valore predefinito .NULL false abilita la gestione automatica dell'intervallo di valori Identity, mentre false la disabilita.

[ @pub_identity_range = ] pub_identity_range

Controlla le dimensioni dell'intervallo di valori Identity allocato a un Sottoscrittore con una sottoscrizione server, quando è attivata la gestione automatica degli intervalli di valori Identity. L'intervallo di valori Identity è riservato al Sottoscrittore di ripubblicazione per l'assegnazione ai propri Sottoscrittori. @pub_identity_range è bigint, con il valore predefinito NULL. È necessario specificare questo parametro se @identityrangemanagementoption è auto o se @auto_identity_range è false.

[ @identity_range = ] identity_range

Controlla le dimensioni dell'intervallo di valori Identity assegnato al server di pubblicazione e al Sottoscrittore quando è attivata la gestione automatica degli intervalli di valori Identity. @identity_range è bigint, con il valore predefinito NULL. È necessario specificare questo parametro se @identityrangemanagementoption è auto o se @auto_identity_range è false.

[ @threshold = ] soglia

Valore percentuale che determina quando l'agente di merge assegna un nuovo intervallo di valori Identity. Quando viene usata la percentuale di valori specificati in @threshold, il agente di merge crea un nuovo intervallo identity. @threshold è int, con il valore predefinito .NULL È necessario specificare questo parametro se @identityrangemanagementoption è auto o se @auto_identity_range è false.

[ @verify_resolver_signature = ] verify_resolver_signature

Specifica se una firma digitale viene verificata prima dell'utilizzo di un sistema di risoluzione nella replica di tipo merge. @verify_resolver_signature è int, con il valore predefinito 1.

• 0 specifica che la firma non è verificata.

• 1 specifica che la firma viene verificata per verificare se proviene da un'origine attendibile.

[ @destination_object = ] N'destination_object'

Nome dell'oggetto nel database di sottoscrizione. @destination_object è sysname, con un valore predefinito di quello che si trova in @source_object. È possibile specificare questo parametro solo se l'articolo include solo lo schema, come nel caso di stored procedure, viste e funzioni definite dall'utente. Se l'articolo specificato è un articolo di tabella, il valore in @source_object sostituisce il valore in @destination_object.

[ @allow_interactive_resolver = ] N'allow_interactive_resolver'

Abilita o disabilita l'utilizzo del sistema di risoluzione interattivo in un articolo. @allow_interactive_resolver è nvarchar(5), con il valore predefinito false. false abilita l'uso del sistema di risoluzione interattivo nell'articolo; false la disabilita.

[ @fast_multicol_updateproc = ] N'fast_multicol_updateproc'

Questo parametro è deprecato e viene mantenuto per la compatibilità con le versioni precedenti degli script.

[ @check_permissions = ] check_permissions

Bitmap delle autorizzazioni a livello di tabella verificate quando il agente di merge applica le modifiche al server di pubblicazione. Se l'account di accesso/utente del server di pubblicazione usato dal processo di merge non dispone delle autorizzazioni corrette per la tabella, le modifiche non valide vengono registrate come conflitti. @check_permissions è int e può essere | (OR bit per bit) prodotto di uno o più dei valori seguenti.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Segnala che l'azione eseguita da questa stored procedure potrebbe invalidare uno snapshot esistente. @force_invalidate_snapshot è bit, con il valore predefinito 0.

• 0 specifica che l'aggiunta di un articolo non causa l'invalidità 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 specifica che l'aggiunta di un articolo potrebbe causare l'invalidità dello snapshot e, se sono presenti sottoscrizioni esistenti che richiedono un nuovo snapshot, concede l'autorizzazione per contrassegnare lo snapshot esistente come obsoleto e un nuovo snapshot generato. @force_invalidate_snapshot è impostato su 1 quando si aggiunge un articolo a una pubblicazione con uno snapshot esistente.

[ @published_in_tran_pub = ] N'published_in_tran_pub'

Indica che un articolo in una pubblicazione di tipo merge viene pubblicato anche in una pubblicazione transazionale. @published_in_tran_pub è nvarchar(5), con il valore predefinito false. false specifica che l'articolo viene pubblicato anche in una pubblicazione transazionale.

[ @force_reinit_subscription = ] force_reinit_subscription

Segnala che l'azione eseguita dalla stored procedure potrebbe richiedere la reinizializzazione delle sottoscrizioni esistenti. @force_reinit_subscription è bit, con un valore predefinito .0

• 0 specifica che l'aggiunta di un articolo non comporta la reinizializzazione della sottoscrizione. Se la stored procedure rileva che la modifica richiede la reinizializzazione delle sottoscrizioni esistenti, si verifica un errore e non vengono apportate modifiche.

• 1 significa che le modifiche apportate all'articolo di merge causano la reinizializzazione delle sottoscrizioni esistenti e concede l'autorizzazione per la reinizializzazione della sottoscrizione. @force_reinit_subscription è impostato su 1 quando @subset_filterclause specifica un filtro di riga con parametri.

[ @logical_record_level_conflict_detection = ] N'logical_record_level_conflict_detection'

Specifica il livello di rilevamento dei conflitti per un articolo membro di un record logico. @logical_record_level_conflict_detection è nvarchar(5), con il valore predefinito false.

• false specifica che viene rilevato un conflitto se vengono apportate modifiche in qualsiasi punto del record logico.

• false specifica che il rilevamento dei conflitti predefinito viene utilizzato come specificato da @column_tracking. Per altre informazioni, vedere Raggruppare modifiche alle righe correlate con record logici.

[ @logical_record_level_conflict_resolution = ] N'logical_record_level_conflict_resolution'

Specifica il livello di risoluzione dei conflitti per un articolo membro di un record logico. @logical_record_level_conflict_resolution è nvarchar(5), con il valore predefinito false.

• false specifica che l'intero record logico vincente sovrascrive il record logico perso.

• false specifica che le righe vincenti non sono vincolate al record logico.

Se @logical_record_level_conflict_detection è false, è necessario impostare anche @logical_record_level_conflict_resolution su false. Per altre informazioni, vedere Raggruppare modifiche alle righe correlate con record logici.

[ @partition_options = ] partition_options

Definisce il modo in cui vengono partizionati i dati nell'articolo. Ciò consente di ottimizzare le prestazioni se tutte le righe appartengono a un'unica partizione o a un'unica sottoscrizione. @partition_options è tinyint e può essere uno dei valori seguenti.

[ @processing_order = ] processing_order

Indica l'ordine di elaborazione degli articoli in una pubblicazione di tipo merge. @processing_order è int, con il valore predefinito 0. 0 specifica che l'articolo non è ordinato e qualsiasi altro valore rappresenta il valore ordinale dell'ordine di elaborazione per questo articolo. Gli articoli vengono elaborati in ordine crescente in base al valore. Se due articoli hanno lo stesso valore, l'ordine di elaborazione viene determinato dall'ordine del nome alternativo dell'articolo nella tabella di sistema sysmergearticles . Per altre informazioni, vedere Specificare le proprietà della replica di tipo merge.

[ @subscriber_upload_options = ] subscriber_upload_options

Specifica le restrizioni per gli aggiornamenti eseguiti in un Sottoscrittore con una sottoscrizione client. Per altre informazioni, vedere Ottimizzare le prestazioni della replica di tipo merge con gli articoli di solo download. @subscriber_upload_options è tinyint e può essere uno dei valori seguenti.

Per modificare @subscriber_upload_options è necessario reinizializzare la sottoscrizione chiamando sp_reinitmergepullsubscription.

[ @identityrangemanagementoption = ] N'identityrangemanagementoption'

Specifica la modalità di gestione degli intervalli di valori Identity per l'articolo. @identityrangemanagementoption è nvarchar(10)e può essere uno dei valori seguenti.

Per la compatibilità con le versioni precedenti, quando il valore di @identityrangemanagementoption è NULL, viene controllato il valore di @auto_identity_range . Tuttavia, quando il valore di @identityrangemanagementoption non NULLè , il valore di @auto_identity_range viene ignorato. Per altre informazioni, vedere Replicare colonne Identity.

[ @delete_tracking = ] N'delete_tracking'

Indica se viene eseguita la replica delle eliminazioni. @delete_tracking è nvarchar(5), con il valore predefinito true. false indica che le eliminazioni non vengono replicate e true indica che le eliminazioni vengono replicate, ovvero il comportamento consueto per la replica di tipo merge. Quando @delete_tracking è impostato su false, le righe eliminate nel Sottoscrittore devono essere rimosse manualmente nel server di pubblicazione e le righe eliminate nel server di pubblicazione devono essere rimosse manualmente nel Sottoscrittore.

[ @compensate_for_errors = ] N'compensate_for_errors'

Specifica se devono essere eseguite azioni di compensazione quando vengono rilevati errori durante la sincronizzazione. @compensate_for_errors è nvarchar(5), con un valore predefinito .false Se impostato su true, le modifiche che non possono essere applicate a un Sottoscrittore o a un server di pubblicazione durante la sincronizzazione comportano sempre l'annullamento delle azioni di compensazione della modifica. Tuttavia, un Sottoscrittore configurato in modo non corretto che genera un errore può causare l'annullamento delle modifiche in altri Sottoscrittori e server di pubblicazione. false disabilita queste azioni di compensazione, tuttavia, gli errori vengono comunque registrati come con compensazione e le operazioni di unione successive continuano a tentare di applicare le modifiche fino a quando non vengono eseguite correttamente.

[ @stream_blob_columns = ] N'stream_blob_columns'

Specifica se viene utilizzata l'ottimizzazione del flusso di dati per la replica di colonne BLOB (Binary Large Object). @stream_blob_columns è nvarchar(5), con il valore predefinito false. true significa che verrà tentata l'ottimizzazione. @stream_blob_columns è impostato su true quando FILESTREAM è abilitato. In questo modo, la replica dei dati FILESTREAM può essere eseguita in maniera ottimale e si riduce l'utilizzo della memoria. Per forzare gli articoli della tabella FILESTREAM a non usare il flusso BLOB, usare sp_changemergearticle per impostare @stream_blob_columns su false.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_addmergearticle viene usato nella replica di tipo merge.

Quando si pubblicano gli oggetti, nei Sottoscrittori vengono copiate le relative definizioni. Se si pubblica un oggetto di database che dipende da uno o più oggetti, è necessario pubblicare tutti gli oggetti a cui si fa riferimento. Se ad esempio si pubblica una vista che dipende da una tabella, sarà necessario pubblicare anche la tabella.

Se si specifica un valore per 3 @partition_options:

• In tale articolo può essere presente una sola sottoscrizione per ogni partizione di dati. Se si crea una seconda sottoscrizione nella quale il criterio di filtro porta alla restituzione della stessa partizione della sottoscrizione esistente, quest'ultima viene eliminata.

• I metadati vengono puliti ogni volta che viene eseguito il agente di merge e lo snapshot partizionato scade più rapidamente. Quando si utilizza questa opzione è consigliabile prendere in considerazione l'abilitazione di snapshot partizionati richiesti dal Sottoscrittore. Per altre informazioni, vedere Creazione di uno snapshot per una pubblicazione di tipo merge con filtri con parametri.

Se si aggiunge un articolo con un filtro orizzontale statico, utilizzando @subset_filterclause, a una pubblicazione esistente con articoli con filtri con parametri, è necessario reinizializzare le sottoscrizioni.

Quando si specifica @processing_order, è consigliabile lasciare spazi vuoti tra i valori dell'ordine degli articoli, semplificando così l'impostazione di nuovi valori in futuro. Ad esempio, se sono presenti tre articoli, Article1, Article2e Article3, impostare @processing_order su 10, 20e 30, anziché 1, 2e 3. Per altre informazioni, vedere Specificare le proprietà della replica di tipo merge.

Tabella delle opzioni dello schema predefinita

Questa tabella descrive il valore predefinito impostato dalla stored procedure, se viene specificato un NULL valore per @schema_option, che dipende dal tipo di articolo.

Tabella delle opzioni dello schema valida

Nella tabella seguente vengono descritti i valori consentiti @schema_option a seconda del tipo di articolo.

Esempi

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.BusinessEntityID = 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

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server sysadmin o al ruolo predefinito del database db_owner .

Contenuto correlato

• Define an Article
• Pubblicare dati e oggetti di database
• Replicare colonne Identity
• sp_changemergearticle (Transact-SQL)
• sp_dropmergearticle (Transact-SQL)
• sp_helpmergearticle (Transact-SQL)
• Stored procedure per la replica (Transact-SQL)