sp_changearticle (Transact-SQL)
Modifica le proprietà di un articolo in una pubblicazione transazionale o snapshot. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.
.gif "Icona di collegamento a un argomento")
Sintassi
sp_changearticle [ [@publication= ] 'publication' ]
[ , [ @article= ] 'article' ]
[ , [ @property= ] 'property' ]
[ , [ @value= ] 'value' ]
[ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
[ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ , [ @publisher = ] 'publisher' ]
Argomenti
[ @publication=] 'publication'
Nome della pubblicazione contenente l'articolo. publication è di tipo sysname e il valore predefinito è NULL.[ @article=] 'article'
Nome dell'articolo di cui modificare la proprietà. article è di tipo sysname e il valore predefinito è NULL.[ @property=] 'property'
Proprietà dell'articolo da modificare. property è di tipo nvarchar(100).[ @value=] 'value'
Nuovo valore della proprietà dell'articolo. value è di tipo nvarchar(255).Nella tabella seguente vengono descritte le proprietà degli articoli e i valori corrispondenti.
Proprietà
Valori
Descrizione
creation_script
Percorso e nome di uno script di schema dell'articolo utilizzato per la creazione delle tabelle di destinazione. Il valore predefinito è NULL.
del_cmd
Istruzione DELETE da eseguire. In alternativa, viene creata dal log.
description
Nuova voce descrittiva per l'articolo.
dest_object
Disponibile per compatibilità con le versioni precedenti. Utilizzare dest_table.
dest_table
Nuova tabella di destinazione.
destination_owner
Proprietario dell'oggetto di destinazione.
filter
Nuova stored procedure da utilizzare per filtrare la tabella in modo orizzontale. Il valore predefinito è NULL. Non può essere modificato per le pubblicazioni nella replica peer-to-peer.
fire_triggers_on_snapshot
true
I trigger utente replicati vengono eseguiti quando si applica lo snapshot iniziale.
.gif "Nota")
Nota
Per consentire la replica dei trigger, è necessario che la maschera di bit di schema_option includa il valore 0x100.false
I trigger utente replicati non vengono eseguiti quando si applica lo snapshot iniziale.
identity_range
Controlla le dimensioni degli intervalli di valori Identity assegnati nel Sottoscrittore. Non supportato per la replica peer-to-peer.
ins_cmd
Istruzione INSERT da eseguire. In alternativa, viene creata dal log.
pre_creation_cmd
Comando preliminare per eliminare, rimuovere o troncare la tabella di destinazione prima della sincronizzazione.
none
Non utilizza alcun comando.
drop
Rimuove la tabella di destinazione.
delete
Elimina la tabella di destinazione.
truncate
Tronca la tabella di destinazione.
pub_identity_range
Controlla le dimensioni degli intervalli di valori Identity assegnati nel Sottoscrittore. Non supportato per la replica peer-to-peer.
schema_option
Specifica la mappa di bit dell'opzione di generazione dello schema per l'articolo specificato. schema_option è di tipo binary(8). Per ulteriori informazioni, vedere la sezione Osservazioni di seguito in questo argomento.
0x00
Disattiva la creazione di script eseguita dall'agente snapshot.
0x01
Genera le istruzioni per la creazione di oggetti (CREATE TABLE, CREATE PROCEDURE e così via).
0x02
Genera le stored procedure che propagano le eventuali modifiche per l'articolo.
0x04
Gli script per le colonne Identity vengono creati tramite la proprietà IDENTITY.
0x08
Replica le colonne di tipo timestamp. Se non si imposta questo valore, le colonne timestamp vengono replicate come binary.
0x10
Genera un indice cluster corrispondente.
0x20
Converte i tipi di dati definiti dall'utente (UDT) in tipi di dati di base nel Sottoscrittore. Questa opzione non può essere utilizzata quando è presente un vincolo CHECK o DEFAULT su una colonna UDT, se una colonna UDT è inclusa nella chiave primaria o se una colonna calcolata fa riferimento a una colonna UDT. Non supportato per i server di pubblicazione Oracle.
0x40
Genera indici non cluster corrispondenti.
0x80
include i vincoli di integrità referenziale dichiarati nelle chiavi primarie.
0x100
Replica gli eventuali trigger dell'utente di un articolo di tabella.
0x200
Replica i vincoli FOREIGN KEY. Se la tabella con riferimenti non fa parte di una pubblicazione, tutti i vincoli FOREIGN KEY in una tabella pubblicata non vengono replicati.
0x400
Replica i vincoli CHECK.
0x800
Replica i valori predefiniti.
0x1000
Replica le regole di confronto a livello di colonna.
0x2000
Replica le proprietà estese associate all'oggetto di origine dell'articolo pubblicato.
0x4000
Replica le eventuali chiavi univoche definite in un articolo di tabella.
0x8000
Replica come vincoli la chiave primaria e le chiavi univoche di un articolo di tabella tramite istruzioni ALTER TABLE.
Nota
Questa opzione è obsoleta. Utilizzare in alternativa 0x80 e 0x4000.0x10000
Replica i vincoli CHECK come NOT FOR REPLICATION in modo che i vincoli non vengono imposti durante la sincronizzazione.
0x20000
Replica i vincoli FOREIGN KEY come NOT FOR REPLICATION in modo che i vincoli non vengono imposti durante la sincronizzazione.
0x40000
Replica i filegroup associati a una tabella o un indice partizionato.
0x80000
Replica lo schema di partizione per una tabella partizionata.
0x100000
Replica lo schema di partizione per un indice partizionato.
0x200000
Replica le statistiche della tabella.
0x400000
Associazioni predefinite
0x800000
Associazioni regola
0x1000000
Indice full-text
0x2000000
Le raccolte di schemi XML associate a colonne xml non vengono replicate.
0x4000000
Replica gli indici su colonne xml.
0x8000000
Crea gli schemi non ancora presenti nel Sottoscrittore.
0x10000000
Converte le colonne xml in ntext nel Sottoscrittore.
0x20000000
Converte i tipi di dati LOB (Large Object) (nvarchar(max), varchar(max) e varbinary(max)) introdotti in SQL Server 2005 in tipi di dati supportati in SQL Server 2000. Per informazioni sulla modalità di mapping di questi tipi, vedere la sezione relativa al mapping di nuovi tipi di dati per le versioni precedenti in Utilizzo di più versioni di SQL Server in una topologia di replica.
0x40000000
Replica le autorizzazioni.
0x80000000
Tenta di eliminare le dipendenze da tutti gli oggetti che non fanno parte della pubblicazione.
0x100000000
Utilizzare questa opzione per replicare l'attributo FILESTREAM se è specificato nelle colonne varbinary(max). Non specificare questa opzione se si stanno replicando tabelle nei Sottoscrittori SQL Server 2005. La replica di tabelle con colonne FILESTREAM nei Sottoscrittori SQL Server 2000 non è supportata, indipendentemente dall'impostazione di questa opzione dello schema.
Vedere l'opzione correlata 0x800000000.
0x200000000
Converte i tipi di dati data/ora (date, time, datetimeoffset e datetime2) introdotti in SQL Server 2008 in tipi di dati supportati nelle versioni precedenti di SQL Server. Per informazioni sulla modalità di mapping di questi tipi, vedere la sezione relativa al mapping di nuovi tipi di dati per le versioni precedenti in Utilizzo di più versioni di SQL Server in una topologia di replica.
0x400000000
Replica l'opzione di compressione per dati e indici. Per ulteriori informazioni, vedere Creazione di tabelle e di indici compressi.
0x800000000
Impostare questa opzione per archiviare i dati FILESTREAM nel relativo filegroup nel Sottoscrittore. Se questa opzione non è impostata, i dati FILESTREAM vengono archiviati nel filegroup predefinito. Tramite la replica non vengono creati filegroup, pertanto, se si imposta questa opzione, è necessario creare il filegroup prima di applicare lo snapshot nel Sottoscrittore. Per ulteriori informazioni su come creare gli oggetti prima di applicare lo snapshot, vedere Esecuzione di script prima e dopo l'applicazione dello snapshot.
Vedere l'opzione correlata 0x100000000.
0x1000000000
Converte i tipi CLR definiti dall'utente con dimensioni maggiori di 8000 byte in varbinary(max) così che le colonne con tipo definito dall'utente possano essere replicate nei Sottoscrittori che eseguono SQL Server 2005.
0x2000000000
Converte il tipo di dati hierarchyid in varbinary(max) in modo che le colonne di tipo hierarchyid possano essere replicate nei Sottoscrittori che eseguono SQL Server 2005. Per ulteriori informazioni su come utilizzare le colonne hierarchyid nelle tabelle replicate, vedere hierarchyid (Transact-SQL).
0x4000000000
Replica gli eventuali indici filtrati sulla tabella. Per ulteriori informazioni sugli indici filtrati, vedere Linee guida per la progettazione di indici filtrati.
0x8000000000
Converte i tipi di dati geography e geometryin varbinary(max) in modo che le colonne di questi tipi possano essere replicate nei Sottoscrittori che eseguono SQL Server 2005.
0x10000000000
Replica gli indici nelle colonne di tipo geography e geometry.
0x20000000000
Replica l'attributo SPARSE per le colonne. Per ulteriori informazioni su questo attributo, vedere Utilizzo di colonne di tipo sparse.
status
Nuovo stato della proprietà.
dts horizontal partitions
Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
include column names
I nomi delle colonne sono inclusi nell'istruzione INSERT replicata.
no column names
I nomi delle colonne non sono inclusi nell'istruzione INSERT replicata.
no dts horizontal partitions
La partizione orizzontale per l'articolo non è definita da una sottoscrizione trasformabile.
none
Deseleziona tutte le opzioni relative allo stato nella tabella sysarticles e contrassegna l'articolo come inattivo.
parameters
Le modifiche vengono propagate al Sottoscrittore tramite i comandi con parametri. Questa è l'impostazione predefinita per un nuovo articolo.
string literals
Le modifiche vengono propagate al Sottoscrittore tramite i valori letterali stringa.
sync_object
Nome della tabella o vista utilizzata per generare un file di output di sincronizzazione. Il valore predefinito è NULL. Non supportato per i server di pubblicazione Oracle.
tablespace
Identifica lo spazio tabella utilizzato dalla tabella di registrazione per un articolo pubblicato da un database Oracle. Per ulteriori informazioni, vedere Gestione di spazi di tabella Oracle.
threshold
Valore percentuale che controlla quando l'agente di distribuzione assegna un nuovo intervallo di valori Identity. Non supportato per la replica peer-to-peer.
type
Non supportato per i server di pubblicazione Oracle.
logbased
Articolo basato su un log.
logbased manualboth
Articolo basato su log con filtro manuale e vista manuale. Per utilizzare questa opzione è inoltre necessario impostare le proprietà sync_object e filter. Non supportato per i server di pubblicazione Oracle.
logbased manualfilter
Articolo basato su log con filtro manuale. Per utilizzare questa opzione è inoltre necessario impostare le proprietà sync_object e filter. Non supportato per i server di pubblicazione Oracle.
logbased manualview
Articolo basato su log con vista manuale. Per utilizzare questa opzione è inoltre necessario impostare la proprietà sync_object. Non supportato per i server di pubblicazione Oracle.
indexed viewlogbased
Articolo di vista indicizzata basato su log. Non supportato per i server di pubblicazione Oracle. Per questo tipo di articolo non è necessario pubblicare separatamente la tabella di base.
indexed viewlogbased manualboth
Articolo di vista indicizzata basato su log con filtro manuale e vista manuale. Per utilizzare questa opzione è inoltre necessario impostare le proprietà sync_object e filter. Per questo tipo di articolo non è necessario pubblicare separatamente la tabella di base. Non supportato per i server di pubblicazione Oracle.
indexed viewlogbased manualfilter
Articolo di vista indicizzata basato su log con filtro manuale. Per utilizzare questa opzione è inoltre necessario impostare le proprietà sync_object e filter. Per questo tipo di articolo non è necessario pubblicare separatamente la tabella di base. Non supportato per i server di pubblicazione Oracle.
indexed viewlogbased manualview
Articolo di vista indicizzata basato su log con vista manuale. Per utilizzare questa opzione è inoltre necessario impostare la proprietà sync_object. Per questo tipo di articolo non è necessario pubblicare separatamente la tabella di base. Non supportato per i server di pubblicazione Oracle.
upd_cmd
Istruzione UPDATE da eseguire. In alternativa, viene creata dal log.
NULL
NULL
Restituisce un elenco di proprietà dell'articolo che è possibile modificare.
[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Segnala che l'azione eseguita da questa stored procedure potrebbe invalidare uno snapshot esistente. force_invalidate_snapshot è di tipo bit e il valore predefinito è 0.0 specifica che le modifiche apportate all'articolo non invalideranno lo 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 le modifiche apportate all'articolo potrebbero invalidare lo snapshot e, se sono disponibili sottoscrizioni che richiedono un nuovo snapshot, consente di contrassegnare lo snapshot esistente come obsoleto e di generarne uno nuovo.
Per informazioni sulle proprietà che, se modificate, richiedono la generazione di un nuovo snapshot, vedere la sezione Osservazioni.
[ **@force_reinit_subscription=]**force_reinit_subscription
Segnala che l'azione eseguita dalla stored procedure potrebbe richiedere la reinizializzazione delle sottoscrizioni esistenti. force_reinit_subscription è di tipo bit e il valore predefinito è 0.0 specifica che le modifiche apportate all'articolo 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 comportano la reinizializzazione delle sottoscrizioni esistenti e consente la reinizializzazione.
Per informazioni sulle proprietà che, se modificate, richiedono la generazione di un nuovo snapshot, vedere la sezione Osservazioni.
[ @publisher= ] 'publisher'
Specifica un server di pubblicazione non SQL Server. publisher è di tipo sysname e il valore predefinito è NULL.[!NOTA]
Non utilizzare l'argomento publisher quando si modificano le proprietà dell'articolo in un server di pubblicazione SQL Server.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Osservazioni
La stored procedure sp_changearticle viene utilizzata in repliche snapshot e transazionali.
Quando un articolo appartiene a una pubblicazione che supporta la replica transazionale peer-to-peer, è possibile modificare solo le proprietà description, ins_cmd, upd_cmd e del_cmd.
La modifica di una delle proprietà seguenti richiede la generazione di un nuovo snapshot ed è necessario specificare il valore 1 per il parametro force_invalidate_snapshot:
del_cmd
dest_table
destination_owner
ins_cmd
pre_creation_cmd
schema_options
upd_cmd
La modifica di una delle proprietà seguenti richiede la reinizializzazione delle sottoscrizioni esistenti ed è necessario specificare un valore 1 per il parametro force_reinit_subscription.
del_cmd
dest_table
destination_owner
filter
ins_cmd
status
upd_cmd
All'interno di una pubblicazione esistente è possibile modificare un determinato articolo tramite sp_changearticle senza dover eliminare e ricreare l'intera pubblicazione.
[!NOTA]
Quando si modifica il valore di schema_option, il sistema non esegue un aggiornamento bit per bit. Ciò significa che quando si imposta schema_option tramite sp_changearticle, è possibile che le impostazioni di bit esistenti vengano disattivate. Per mantenere le impostazioni esistenti, è necessario eseguire & (AND bit per bit) tra il valore da impostare e il valore corrente di schema_option, che è possibile determinare eseguendo sp_helparticle.
Opzioni di schema valide
Nella tabella seguente vengono descritti i valori consentiti di schema_option in base ai tipi di replica (indicati nella prima riga) e al tipo di articolo (indicato nella prima colonna).
Tipo di articolo |
Tipo di replica |
|
|---|---|---|
|
Transazionale |
Snapshot |
logbased |
Tutte le opzioni |
Tutte le opzioni tranne 0x02 |
logbased manualfilter |
Tutte le opzioni |
Tutte le opzioni tranne 0x02 |
logbased manualview |
Tutte le opzioni |
Tutte le opzioni tranne 0x02 |
indexed view logbased |
Tutte le opzioni |
Tutte le opzioni tranne 0x02 |
indexed view logbased manualfilter |
Tutte le opzioni |
Tutte le opzioni tranne 0x02 |
indexed view logbased manualview |
Tutte le opzioni |
Tutte le opzioni tranne 0x02 |
indexed view logbase manualboth |
Tutte le opzioni |
Tutte le opzioni tranne 0x02 |
proc exec |
0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000 e 0x80000000 |
0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000 e 0x80000000 |
serializable proc exec |
0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000 e 0x80000000 |
0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000 e 0x80000000 |
proc schema only |
0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000 e 0x80000000 |
0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000 e 0x80000000 |
view schema only |
0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000 e 0x80000000 |
0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000 e 0x80000000 |
func schema only |
0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000 e 0x80000000 |
0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x40000000 e 0x80000000 |
indexed view schema only |
0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000 e 0x80000000 |
0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x40000000 e 0x80000000 |
[!NOTA]
Per pubblicazioni ad aggiornamento in coda, è necessario attivare il valore 0x80 di schema_option. I valori di schema_option supportati per le pubblicazioni non SQL Server sono i seguenti: 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000 e 0x4000.
Esempio
DECLARE @publication AS sysname;
DECLARE @article AS sysname;
DECLARE @option AS int;
SET @publication = N'AdvWorksProductTran';
SET @article = N'Product';
SET @option = (SELECT CAST(0x0000000002030073 AS int));
-- Change the schema options to replicate schema with XML.
USE [AdventureWorks]
EXEC sp_changearticle
@publication = @publication,
@article = @article,
@property = N'schema_option',
@value = @option,
@force_invalidate_snapshot = 1;
GO
Autorizzazioni
Solo i membri del ruolo predefinito del server sysadmin o del ruolo predefinito del database db_owner possono eseguire sp_changearticle.
Vedere anche