sp_addarticle (Transact-SQL)

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

Viene creato un articolo che viene aggiunto a una pubblicazione. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_addarticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @source_table = ] N'source_table' ]
    [ , [ @destination_table = ] N'destination_table' ]
    [ , [ @vertical_partition = ] N'vertical_partition' ]
    [ , [ @type = ] N'type' ]
    [ , [ @filter = ] N'filter' ]
    [ , [ @sync_object = ] N'sync_object' ]
    [ , [ @ins_cmd = ] N'ins_cmd' ]
    [ , [ @del_cmd = ] N'del_cmd' ]
    [ , [ @upd_cmd = ] N'upd_cmd' ]
    [ , [ @creation_script = ] N'creation_script' ]
    [ , [ @description = ] N'description' ]
    [ , [ @pre_creation_cmd = ] N'pre_creation_cmd' ]
    [ , [ @filter_clause = ] N'filter_clause' ]
    [ , [ @schema_option = ] schema_option ]
    [ , [ @destination_owner = ] N'destination_owner' ]
    [ , [ @status = ] status ]
    [ , [ @source_owner = ] N'source_owner' ]
    [ , [ @sync_object_owner = ] N'sync_object_owner' ]
    [ , [ @filter_owner = ] N'filter_owner' ]
    [ , [ @source_object = ] N'source_object' ]
    [ , [ @artid = ] artid OUTPUT ]
    [ , [ @auto_identity_range = ] N'auto_identity_range' ]
    [ , [ @pub_identity_range = ] pub_identity_range ]
    [ , [ @identity_range = ] identity_range ]
    [ , [ @threshold = ] threshold ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @use_default_datatypes = ] use_default_datatypes ]
    [ , [ @identityrangemanagementoption = ] N'identityrangemanagementoption' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @fire_triggers_on_snapshot = ] N'fire_triggers_on_snapshot' ]
[ ; ]

Argomenti

[ @publication = ] N'publication'

Nome della pubblicazione contenente l'articolo. Deve essere un nome univoco all'interno del database. @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.

[ @source_table = ] N'source_table'

Questo parametro è stato deprecato; usare invece @source_object . @source_table è nvarchar(386), con un valore predefinito .NULL @source_table non è supportato per i server di pubblicazione Oracle.

[ @destination_table = ] N'destination_table'

Nome della tabella di destinazione (sottoscrizione), se diversa da @source_table o dalla stored procedure. @destination_table è sysname, con il valore predefinito NULL. Se impostato su NULL, significa che @source_table è uguale a @destination_table.

[ @vertical_partition = ] N'vertical_partition'

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

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

• true cancella tutte le colonne, ad eccezione della chiave primaria dichiarata, delle colonne nullable senza colonne chiave predefinite e univoche. Le colonne vengono aggiunte tramite sp_articlecolumn.

[ @type = ] N'type'

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

[ @filter = ] N'filter'

Stored procedure (creata con FOR REPLICATION) utilizzata per filtrare la tabella orizzontalmente. @filter è nvarchar(386), con il valore predefinito NULL. È necessario eseguire sp_articleview e sp_articlefilter manualmente per creare la vista e filtrare la stored procedure. Se non NULLè , la routine di filtro non viene creata (presuppone che la stored procedure venga creata manualmente).

[ @sync_object = ] N'sync_object'

Nome della tabella o della vista utilizzata per produrre il file di dati utilizzato per rappresentare lo snapshot per questo articolo. @sync_object è nvarchar(386), con il valore predefinito NULL. Se NULL, sp_articleview viene chiamato per creare automaticamente la vista usata per generare il file di output. Ciò si verifica dopo l'aggiunta di colonne con sp_articlecolumn. Se non NULLè , non viene creata una vista (si presuppone che la visualizzazione venga creata manualmente).

[ @ins_cmd = ] N'ins_cmd'

Tipo di comando di replica utilizzato durante la replica degli inserimenti per questo articolo. @ins_cmd è nvarchar(255)e può essere uno dei valori seguenti.

Per altre informazioni, vedere Articoli transazionali - Specificare la modalità di propagazione delle modifiche.

[ @del_cmd = ] N'del_cmd'

Tipo di comando di replica usato per la replica delle eliminazioni per questo articolo. @del_cmd è nvarchar(255)e può essere uno dei valori seguenti.

Per altre informazioni, vedere Articoli transazionali - Specificare la modalità di propagazione delle modifiche.

[ @upd_cmd = ] N'upd_cmd'

Tipo di comando di replica usato durante la replica degli aggiornamenti per questo articolo. @upd_cmd è nvarchar(255)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

[ @description = ] N'description'

Voce descrittiva per l'articolo. @description è nvarchar(255), con il valore predefinito NULL.

[ @pre_creation_cmd = ] N'pre_creation_cmd'

Specifica l'azione eseguita dal sistema se nel Sottoscrittore viene rilevato un oggetto esistente con lo stesso nome durante l'applicazione dello snapshot per l'articolo. @pre_creation_cmd è nvarchar(10)e può essere uno dei valori seguenti.

[ @filter_clause = ] N'filter_clause'

Clausola di restrizione (WHERE) che definisce un filtro orizzontale. Quando si specifica la clausola di restrizione, omettere la parola chiave WHERE. @filter_clause è nvarchar(max), con il valore predefinito NULL. Per altre informazioni, vedere Filtrare i dati pubblicati.

[ @schema_option = ] schema_option

Maschera di bit dell'opzione di generazione dello schema per l'articolo specificato. @schema_option è varbinary(8), con un valore predefinito e NULLpuò essere | (OR bit per bit) prodotto di uno o più di questi valori:

¹ Non supportato per i server di pubblicazione Oracle.

Non tutti i valori @schema_option sono validi per ogni tipo di replica e tipo di articolo. La tabella Opzioni schema valide nella sezione Osservazioni mostra le opzioni di schema valide che possono essere scelte in base alla combinazione del tipo di articolo e del tipo di replica.

[ @destination_owner = ] N'destination_owner'

Nome del proprietario dell'oggetto di destinazione. @destination_owner è sysname, con un valore predefinito .NULL Quando @destination_owner non viene specificato, il proprietario viene specificato automaticamente in base alle regole seguenti:

Per supportare sottoscrittori non SQL Server, @destination_owner deve essere NULL.

[ @status = ] status

Specifica se l'articolo è attivo e offre ulteriori opzioni per la propagazione delle modifiche. @status è tinyint e può essere | (OR bit per bit) prodotto di uno o più di questi valori.

Ad esempio, un articolo attivo che usa istruzioni con parametri avrà un valore di 17 in questa colonna. Un valore 0 indica che l'articolo è inattivo e non sono definite proprietà aggiuntive.

[ @source_owner = ] N'source_owner'

Proprietario dell'oggetto di origine. @source_owner è sysname, con un valore predefinito .NULL @source_owner deve essere specificato per i server di pubblicazione Oracle.

[ @sync_object_owner = ] N'sync_object_owner'

Proprietario della visualizzazione che definisce l'articolo pubblicato. @sync_object_owner è sysname, con un valore predefinito .NULL

[ @filter_owner = ] N'filter_owner'

Proprietario del filtro. @filter_owner è sysname, con un valore predefinito .NULL

[ @source_object = ] N'source_object'

Oggetto di database da pubblicare. @source_object è sysname, con un valore predefinito .NULL Se @source_table è NULL, @source_object non può essere NULL. @source_object deve essere usato invece di @source_table. Per altre informazioni sui tipi di oggetti che possono essere pubblicati tramite la replica snapshot o transazionale, vedere Pubblicare dati e oggetti di database.

[ @artid = ] OUTPUT artid

ID articolo del nuovo articolo. @artid è un parametro OUTPUT di tipo int.

[ @auto_identity_range = ] N'auto_identity_range'

Abilita e disabilita la gestione automatica dell'intervallo di valori Identity in una pubblicazione al momento della creazione. @auto_identity_range è nvarchar(5) e può essere uno dei valori seguenti:

[ @pub_identity_range = ] pub_identity_range

Controlla le dimensioni dell'intervallo nel server di pubblicazione se l'articolo ha @identityrangemanagementoption impostato su auto o @auto_identity_range impostato su true. @pub_identity_range è bigint, con il valore predefinito NULL. @pub_identity_range non è supportato per i server di pubblicazione Oracle.

[ @identity_range = ] identity_range

Controlla le dimensioni dell'intervallo nel Sottoscrittore se l'articolo ha @identityrangemanagementoption impostato su auto o @auto_identity_range impostato su true. @identity_range è bigint, con il valore predefinito NULL. Utilizzato quando @auto_identity_range è impostato su true. @identity_range non è supportato per i server di pubblicazione Oracle.

[ @threshold = ] soglia

Valore percentuale che controlla quando l'agente di distribuzione assegna un nuovo intervallo di valori Identity. Quando viene usata la percentuale di valori specificati in @threshold, il agente di distribuzione crea un nuovo intervallo identity. @threshold è int, con il valore predefinito .NULL Usato quando @identityrangemanagementoption è impostato su auto o @auto_identity_range è impostato su true. @threshold non è supportato per i server di pubblicazione Oracle.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

Riconosce che l'azione eseguita da questa stored procedure può 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 può causare l'invalidità dello snapshot e, se esistono sottoscrizioni che richiedono un nuovo snapshot, concede l'autorizzazione per contrassegnare lo snapshot esistente come obsoleto e generare un nuovo snapshot.

[ @use_default_datatypes = ] use_default_datatypes

Indica se i mapping dei tipi di dati della colonna predefiniti vengono utilizzati durante la pubblicazione di un articolo da un server di pubblicazione Oracle. @use_default_datatypes è bit, con un valore predefinito .1

• 1 = vengono usati i mapping delle colonne degli articoli predefiniti. È possibile visualizzare i mapping dei tipi di dati predefiniti eseguendo sp_getdefaultdatatypemapping.

• 0 = i mapping delle colonne dell'articolo personalizzato sono definiti e pertanto sp_articleview non viene chiamato da sp_addarticle.

Quando @use_default_datatypes è impostato su 0, è necessario eseguire sp_changearticlecolumndatatype una volta per ogni mapping di colonna modificato rispetto all'impostazione predefinita. Dopo aver definito tutti i mapping di colonna personalizzati, è necessario eseguire sp_articleview.

[ @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.

[ @publisher = ] N'publisher'

Specifica un server di pubblicazione non SQL Server. @publisher è sysname, con un valore predefinito .NULL

@publisher non deve essere usato quando si aggiunge un articolo a un server di pubblicazione di SQL Server.

[ @fire_triggers_on_snapshot = ] N'fire_triggers_on_snapshot'

Se i trigger utente replicati vengono eseguiti quando viene applicato lo snapshot iniziale. @fire_triggers_on_snapshot è nvarchar(5), con il valore predefinito false. true significa che i trigger utente in una tabella replicata vengono eseguiti quando viene applicato lo snapshot. Affinché i trigger vengano replicati, il valore della maschera di bit di @schema_option deve includere il valore 0x100.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_addarticle viene usato nella replica snapshot o nella replica transazionale.

Per impostazione predefinita, la replica non pubblica colonne nella tabella di origine quando il tipo di dati della colonna non è supportato dalla replica. Se è necessario pubblicare una colonna di questo tipo, è necessario eseguire sp_articlecolumn per aggiungere la colonna.

Per l'aggiunta di un articolo a una pubblicazione che supporta la replica transazionale peer-to-peer sono valide le restrizioni seguenti:

• È necessario specificare istruzioni con parametri per tutti gli articoli basati su log. È necessario includere 16 nel valore @status .

• Il nome e il proprietario della tabella di destinazione devono corrispondere a quelli della tabella di origine.

• L'articolo non può essere filtrato orizzontalmente o verticalmente.

• La gestione automatica degli intervalli di valori Identity non è supportata. È necessario specificare un valore manuale per @identityrangemanagementoption.

• Se nella tabella è presente una colonna timestamp , è necessario includere 0x08 in @schema_option per replicare la colonna come timestamp.

• Non è possibile specificare un valore SQL per @ins_cmd, @upd_cmd e @del_cmd.

Per altre informazioni, vedere Peer-to-Peer - Replica transazionale.

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 @vertical_partition è impostato su true, sp_addarticle rinvia la creazione della visualizzazione fino a quando non viene chiamato sp_articleview (dopo l'aggiunta dell'ultimo sp_articlecolumn ).

Se la pubblicazione consente di aggiornare le sottoscrizioni e la tabella pubblicata non dispone di una colonna uniqueidentifier , sp_addarticle aggiunge automaticamente una colonna uniqueidentifier alla tabella.

Quando si esegue la replica in un sottoscrittore che non è un'istanza di SQL Server (replica eterogenea), solo le istruzioni Transact-SQL sono supportate per INSERTi comandi , UPDATEe DELETE .

Quando l'agente di lettura log è in esecuzione, l'aggiunta di un articolo a una pubblicazione peer-to-peer può causare un deadlock tra l'agente di lettura log e il processo tramite cui viene aggiunto l'articolo. Per evitare questo problema, prima di aggiungere un articolo a una pubblicazione peer-to-peer, usare Monitoraggio replica per arrestare l'agente di lettura log nel nodo in cui si aggiunge l'articolo. Riavviare l'agente di lettura log dopo aver aggiunto l'articolo.

Quando si imposta @del_cmd su o @ins_cmd su , la propagazione dei comandi potrebbe essere interessata anche dall'invio di UPDATE tali comandi quando si verifica un aggiornamento associato.NONE NONE Un aggiornamento associato è un tipo di istruzione del server di UPDATE pubblicazione che viene replicato come DELETE/INSERT coppia nel sottoscrittore.

Opzioni predefinite dello schema

Questa tabella descrive il valore predefinito impostato dalla replica se @schema_options non è specificato dall'utente, in cui questo valore dipende dal tipo di replica (visualizzato nella parte superiore) e dal tipo di articolo (mostrato nella parte inferiore della prima colonna).

Opzioni di schema valide

Questa tabella descrive i valori consentiti di @schema_option in base al tipo di replica (visualizzato nella parte superiore) e al tipo di articolo (mostrato nella prima colonna).

Esempi

DECLARE @publication    AS sysname;
DECLARE @table AS sysname;
DECLARE @filterclause AS nvarchar(500);
DECLARE @filtername AS nvarchar(386);
DECLARE @schemaowner AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @table = N'Product';
SET @filterclause = N'[DiscontinuedDate] IS NULL'; 
SET @filtername = N'filter_out_discontinued';
SET @schemaowner = N'Production';

-- Add a horizontally and vertically filtered article for the Product table.
-- Manually set @schema_option to ensure that the Production schema 
-- is generated at the Subscriber (0x8000000).
EXEC sp_addarticle 
    @publication = @publication, 
    @article = @table, 
    @source_object = @table,
    @source_owner = @schemaowner, 
    @schema_option = 0x80030F3,
    @vertical_partition = N'true', 
    @type = N'logbased',
    @filter_clause = @filterclause;

-- (Optional) Manually call the stored procedure to create the 
-- horizontal filtering stored procedure. Since the type is 
-- 'logbased', this stored procedures is executed automatically.
EXEC sp_articlefilter 
    @publication = @publication, 
    @article = @table, 
    @filter_clause = @filterclause, 
    @filter_name = @filtername;

-- Add all columns to the article.
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table;

-- Remove the DaysToManufacture column from the article
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table, 
    @column = N'DaysToManufacture', 
    @operation = N'drop';

-- (Optional) Manually call the stored procedure to create the 
-- vertical filtering view. Since the type is 'logbased', 
-- this stored procedures is executed automatically.
EXEC sp_articleview 
    @publication = @publication, 
    @article = @table,
    @filter_clause = @filterclause;
GO

Autorizzazioni

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

Contenuto correlato

• Define an Article
• sp_articlecolumn (Transact-SQL)
• sp_articlefilter (Transact-SQL)
• sp_articleview (Transact-SQL)
• sp_changearticle (Transact-SQL)
• sp_droparticle (Transact-SQL)
• sp_helparticle (Transact-SQL)
• sp_helparticlecolumns (Transact-SQL)
• Stored procedure per la replica (Transact-SQL)
• Pubblicare dati e oggetti di database