Condividi tramite

sp_changearticle (Transact-SQL)

  • Articolo

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

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.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_changearticle
    [ [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Argomenti

[ @publication = ] N'publication'

Nome della pubblicazione contenente l'articolo. @publication è sysname, con il valore predefinito NULL.

[ @article = ] N'article'

Nome dell'articolo la cui proprietà deve essere modificata. @article è sysname, con un valore predefinito .NULL

[ @property = ] N'property'

Proprietà dell'articolo da modificare. @property è nvarchar(100), con il valore predefinito NULL.

[ @value = ] N'value'

Nuovo valore della proprietà article. @value è nvarchar(255), con il valore predefinito NULL.

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 DELETE istruzione da eseguire; in caso contrario, viene costruito dal log.
description Nuova voce descrittiva per l'articolo.
dest_object Disponibile per compatibilità con le versioni precedenti. Usare dest_table.
dest_table Nuova tabella di destinazione.
destination_owner Nome del proprietario dell'oggetto di destinazione.
filter Nuova stored procedure da utilizzare per filtrare la tabella in modo orizzontale. Il valore predefinito è NULL. Non è possibile modificare le pubblicazioni nella replica peer-to-peer.
fire_triggers_on_snapshot true I trigger utente replicati vengono eseguiti quando si applica lo snapshot iniziale.

Nota: per i trigger da replicare, il valore della maschera di bit di schema_option deve includere il valore 0x100.
false I trigger utente replicati non vengono eseguiti quando viene applicato 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 INSERT istruzione da eseguire; in caso contrario, viene costruito dal log.
pre_creation_cmd Comando di precreazione che può eliminare, eliminare o troncare la tabella di destinazione prima dell'applicazione della sincronizzazione.
none Non usa un 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 è binary(8). Per altre informazioni, vedere la sezione Osservazioni.
0x00 Disabilita la creazione di script eseguita dall'agente snapshot.
0x01 Genera la creazione dell'oggetto (CREATE TABLE, CREATE PROCEDUREe così via).
0x02 Genera le stored procedure che propagano le eventuali modifiche per l'articolo.
0x04 Le colonne Identity vengono compilate tramite script usando la IDENTITY proprietà .
0x08 Replicare le colonne timestamp . Se non impostato, le colonne timestamp vengono replicate come binarie.
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 usata quando è presente un CHECK vincolo o DEFAULT su una colonna definita dall'utente, se una colonna definito dall'utente fa parte della chiave primaria o se una colonna calcolata fa riferimento a una colonna definita dall'utente. Questa proprietà non è supportata per 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 FOREIGN KEY vincoli. Se la tabella a cui si fa riferimento non fa parte di una pubblicazione, tutti i FOREIGN KEY vincoli di una tabella pubblicata non vengono replicati.
0x400 Replica i CHECK vincoli.
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 la chiave primaria e le chiavi univoche in un articolo di tabella come vincoli tramite ALTER TABLE istruzioni .

Nota: questa opzione è deprecata. In alternativa, usare 0x80 e 0x4000.
0x10000 Replica i CHECK vincoli in NOT FOR REPLICATION modo che i vincoli non vengano applicati durante la sincronizzazione.
0x20000 Replica i FOREIGN KEY vincoli in NOT FOR REPLICATION modo che i vincoli non vengano applicati 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 di regole.
0x1000000 Indice full-text.
0x2000000 Le raccolte di XML Schema associate alle colonne xml non vengono replicate.
0x4000000 Replica gli indici nelle 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 per oggetti di grandi dimensioni (nvarchar(max), varchar(max)e varbinary(max)) introdotti in SQL Server 2005 (9.x) in tipi di dati supportati in SQL Server 2000 (8.x).
0x40000000 Replica le autorizzazioni.
0x80000000 Tentare di eliminare le dipendenze a tutti gli oggetti che non fanno parte della pubblicazione.
0x100000000 Usare questa opzione per replicare l'attributo FILESTREAM se è specificato nelle colonne varbinary(max). Non specificare questa opzione se si esegue la replica delle tabelle nei Sottoscrittori di SQL Server 2005 (9.x). La replica di tabelle con colonne FILESTREAM nei Sottoscrittori di SQL Server 2000 (8.x) non è supportata, indipendentemente dalla modalità di impostazione di questa opzione di schema.

Vedere l'opzione 0x800000000correlata .
0x200000000 Converte i tipi di dati di data e ora (date, time, datetimeoffset e datetime2) introdotti in SQL Server 2008 (10.0.x) in tipi di dati supportati nelle versioni precedenti di SQL Server.
0x400000000 Replica l'opzione di compressione per dati e indici. Per ulteriori informazioni, vedi Compressione dei dati.
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. La replica non crea filegroup; pertanto, se si imposta questa opzione, è necessario creare il filegroup prima di applicare lo snapshot nel Sottoscrittore. Per altre informazioni su come creare oggetti prima di applicare lo snapshot, vedere Eseguire script prima e dopo l'applicazione dello snapshot.

Vedere l'opzione 0x100000000correlata .
0x1000000000 Converte tipi CLR (Common Language Runtime) definiti dall'utente (UDT) superiori a 8.000 byte in varbinary(max) in modo che le colonne di tipo UDT possano essere replicate nei Sottoscrittori che eseguono SQL Server 2005 (9.x).
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 (9.x). Per altre informazioni su come usare le colonne hierarchyid nelle tabelle replicate, vedere riferimento al metodo del tipo di dati hierarchyid.
0x4000000000 Replica gli eventuali indici filtrati sulla tabella. Per altre informazioni sugli indici filtrati, vedere Creare indici filtrati.
0x8000000000 Converte i tipi di dati geography e geometry in varbinary(max) in modo che le colonne di questi tipi possano essere replicate nei Sottoscrittori che eseguono SQL Server 2005 (9.x).
0x10000000000 Replica gli indici sulle colonne di tipo geography e geometry.
0x20000000000 Replica l'attributo SPARSE per le colonne. Per altre informazioni su questo attributo, vedere Usare colonne di tipo sparse.
0x40000000000 Abilitare lo scripting dall'agente snapshot per creare una tabella ottimizzata per la memoria nel sottoscrittore.
0x80000000000 Converte l'indice cluster in un indice non cluster per articoli ottimizzati per la memoria.
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 replicata INSERT .
no column names I nomi delle colonne non sono inclusi nell'istruzione replicata INSERT .
no dts horizontal partitions La partizione orizzontale per l'articolo non è definita da una sottoscrizione trasformabile.
none Cancella tutte le opzioni di 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. Questa proprietà non è supportata per server di pubblicazione Oracle.
tablespace Identifica lo spazio tabella utilizzato dalla tabella di registrazione per un articolo pubblicato da un database Oracle. Per altre informazioni, vedere Gestire 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 Questa proprietà non è supportata per server di pubblicazione Oracle.
logbased Articolo basato su un log.
logbased manualboth Articolo basato su log con filtro manuale e vista manuale. Questa opzione richiede anche di impostare le sync_object proprietà e filter . Questa proprietà non è supportata per server di pubblicazione Oracle.
logbased manualfilter Articolo basato su log con filtro manuale. Questa opzione richiede anche di impostare le sync_object proprietà e filter . Questa proprietà non è supportata per server di pubblicazione Oracle.
logbased manualview Articolo basato su log con vista manuale. Questa opzione richiede anche di impostare la sync_object proprietà . Questa proprietà non è supportata per server di pubblicazione Oracle.
indexed viewlogbased Articolo di vista indicizzata basato su log. Questa proprietà non è supportata per server di pubblicazione Oracle. Per questo tipo di articolo, la tabella di base non deve essere pubblicata separatamente.
indexed viewlogbased manualboth Articolo di vista indicizzata basato su log con filtro manuale e vista manuale. Questa opzione richiede anche di impostare le sync_object proprietà e filter . Per questo tipo di articolo, la tabella di base non deve essere pubblicata separatamente. Questa proprietà non è supportata per server di pubblicazione Oracle.
indexed viewlogbased manualfilter Articolo di vista indicizzata basato su log con filtro manuale. Questa opzione richiede anche di impostare le sync_object proprietà e filter . Per questo tipo di articolo, la tabella di base non deve essere pubblicata separatamente. Questa proprietà non è supportata per server di pubblicazione Oracle.
indexed viewlogbased manualview Articolo di vista indicizzata basato su log con vista manuale. Questa opzione richiede anche di impostare la sync_object proprietà . Per questo tipo di articolo, la tabella di base non deve essere pubblicata separatamente. Questa proprietà non è supportata per server di pubblicazione Oracle.
upd_cmd UPDATE istruzione da eseguire; in caso contrario, viene costruito 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 è bit, con il valore predefinito 0.

0 specifica che le modifiche apportate all'articolo non causano 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 le modifiche apportate all'articolo potrebbero 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.

Vedere la sezione Osservazioni per le proprietà che, quando modificate, richiedono la generazione di un nuovo snapshot.

[ @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 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, si verifica un errore e non vengono apportate modifiche.

1 specifica che le modifiche apportate all'articolo causano la reinizializzazione delle sottoscrizioni esistenti e concede l'autorizzazione per la reinizializzazione della sottoscrizione.

Vedere la sezione Osservazioni per le proprietà che, quando modificate, richiedono la reinizializzazione di tutte le sottoscrizioni esistenti.

[ @publisher = ] N'publisher'

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

Nota

Non è consigliabile usare publisher quando si modificano le proprietà dell'articolo in un server di pubblicazione di SQL Server.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_changearticle viene usato nella replica snapshot e nella replica transazionale.

Quando un articolo appartiene a una pubblicazione che supporta la replica transazionale peer-to-peer, è possibile modificare solo le descriptionproprietà , ins_cmdupd_cmd, e del_cmd .

Per modificare una delle proprietà seguenti è necessario che venga generato un nuovo snapshot ed è necessario specificare un valore per 1 il parametro @force_invalidate_snapshot :

  • del_cmd
  • dest_table
  • destination_owner
  • ins_cmd
  • pre_creation_cmd
  • schema_options
  • upd_cmd

Per modificare una delle proprietà seguenti è necessario reinizializzare le sottoscrizioni esistenti ed è necessario specificare un valore per 1 il parametro @force_reinit_subscription .

  • del_cmd
  • dest_table
  • destination_owner
  • filter
  • ins_cmd
  • status
  • upd_cmd

All'interno di una pubblicazione esistente, è possibile utilizzare sp_changearticle per modificare un articolo 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 impostano schema_option le sp_changearticleimpostazioni di bit esistenti potrebbero essere disattivate. Per mantenere le impostazioni esistenti, è necessario eseguire | (OR bit per bit) tra il valore impostato e il valore corrente di schema_option, che può essere determinato eseguendo sp_helparticle.

Opzioni di schema valide

Nella tabella seguente vengono descritti i valori consentiti di in base al tipo di replica (mostrato nella parte superiore) e al tipo di schema_option articolo (mostrato nella prima colonna).

Tipo di articolo Tipo di replica - Transazionale Tipo di replica - Snapshot
logbased Tutte le opzioni Tutte le opzioni, ma 0x02
logbased manualfilter Tutte le opzioni Tutte le opzioni, ma 0x02
logbased manualview Tutte le opzioni Tutte le opzioni, ma 0x02
indexed view logbased Tutte le opzioni Tutte le opzioni, ma 0x02
indexed view logbased manualfilter Tutte le opzioni Tutte le opzioni, ma 0x02
indexed view logbased manualview Tutte le opzioni Tutte le opzioni, ma 0x02
indexed view logbase manualboth Tutte le opzioni Tutte le opzioni, ma 0x02
proc exec 0x01, 0x20, , 0x400000, 0x8000000x2000000, 0x200000000x80000000x10000000, , e 0x400000000x20000x80000000 0x01, 0x20, , 0x400000, 0x8000000x2000000, 0x200000000x80000000x10000000, , e 0x400000000x20000x80000000
serializable proc exec 0x01, 0x20, , 0x400000, 0x8000000x2000000, 0x200000000x80000000x10000000, , e 0x400000000x20000x80000000 0x01, 0x20, , 0x400000, 0x8000000x2000000, 0x200000000x80000000x10000000, , e 0x400000000x20000x80000000
proc schema only 0x01, 0x20, , 0x400000, 0x8000000x2000000, 0x200000000x80000000x10000000, , e 0x400000000x20000x80000000 0x01, 0x20, , 0x400000, 0x8000000x2000000, 0x200000000x80000000x10000000, , e 0x400000000x20000x80000000
view schema only 0x01, , , , 0x01000x400000x4000000x1000000x20000x200000, e 0x20000000x400000000x8000000x80000000x0400x0100x0200x80000000 0x01, , , , 0x01000x400000x4000000x1000000x20000x200000, e 0x20000000x400000000x8000000x80000000x0400x0100x0200x80000000
func schema only 0x01, 0x20, , 0x400000, 0x8000000x2000000, 0x200000000x80000000x10000000, , e 0x400000000x20000x80000000 0x01, 0x20, , 0x400000, 0x8000000x2000000, 0x200000000x80000000x10000000, , e 0x400000000x20000x80000000
indexed view schema only 0x01, , , , 0x01000x400000x4000000x1000000x20000x200000, e 0x20000000x400000000x8000000x80000000x0400x0100x0200x80000000 0x01, , , , 0x01000x400000x4000000x1000000x20000x200000, e 0x20000000x400000000x8000000x80000000x0400x0100x0200x80000000

Nota

Per le pubblicazioni ad aggiornamento in coda, è necessario abilitare il schema_option valore di 0x80 . I valori supportati schema_option per le pubblicazioni non SQL Server sono: 0x01, 0x02, 0x400x10, 0x80, 0x1000 e 0x4000.

Esempi

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 [AdventureWorks2022]
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 db_owner ruolo predefinito del database possono eseguire sp_changearticle.

Contenuto correlato