sp_changemergearticle (Transact-SQL)sp_changemergearticle (Transact-SQL)

QUESTO ARGOMENTO SI APPLICA A:sìSQL Server (a partire dalla versione 2008)noDatabase SQL di AzurenoAzure SQL Data Warehouse noParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Vengono modificate le proprietà di un articolo di tipo merge.Changes the properties of a merge article. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.This stored procedure is executed at the Publisher on the publication database.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax


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

ArgomentiArguments

[ @publication=] 'pubblicazione'[ @publication=] 'publication'
Nome della pubblicazione che include l'articolo.Is the name of the publication in which the article exists. pubblicazione viene sysname, non prevede alcun valore predefinito.publication is sysname, with no default.

[ @article=] 'articolo'[ @article=] 'article'
Nome dell'articolo da modificare.Is the name of the article to change. articolo viene sysname, non prevede alcun valore predefinito.article is sysname, with no default.

[ @property=] 'proprietà'[ @property=] 'property'
Proprietà da modificare per la pubblicazione e l'articolo specificati.Is the property to change for the given article and publication. proprietà viene nvarchar(30), e può essere uno dei valori elencato nella tabella.property is nvarchar(30), and can be one of the values listed in the table.

[ @value=] 'valore'[ @value=] 'value'
Nuovo valore della proprietà specificata.Is the new value for the specified property. valore viene nvarchar(1000), e può essere uno dei valori elencato nella tabella.value is nvarchar(1000), and can be one of the values listed in the table.

Nella tabella seguente vengono descritte le proprietà degli articoli e i valori corrispondenti.This table describes the properties of articles and the values for those properties.

ProprietàProperty ValoriValues DescriptionDescription
allow_interactive_resolverallow_interactive_resolver truetrue Abilita l'utilizzo di un sistema di risoluzione interattivo per l'articolo.Enables the use of an interactive resolver for the article.
falsefalse Disabilita l'utilizzo di un sistema di risoluzione interattivo per l'articolo.Disables the use of an interactive resolver for the article.
article_resolverarticle_resolver Sistema di risoluzione personalizzato per l'articolo.Custom resolver for the article. Proprietà valida solo per gli articoli di tabelle.Applies only to a table article.
check_permissions (bitmap)check_permissions (bitmap) 0x000x00 Le autorizzazioni a livello di tabella non vengono controllate.Table-level permissions are not checked.
0x100x10 Le autorizzazioni a livello di tabella vengono controllate nel server di pubblicazione prima dell'applicazione nel server di pubblicazione delle istruzioni INSERT eseguite nel Sottoscrittore.Table-level permissions are checked at the Publisher before INSERT statements made at the Subscriber are applied at the Publisher.
0x200x20 Le autorizzazioni a livello di tabella vengono controllate nel server di pubblicazione prima dell'applicazione nel server di pubblicazione delle istruzioni UPDATE eseguite nel Sottoscrittore.Table-level permissions are checked at the Publisher before UPDATE statements made at the Subscriber are applied at the Publisher.
0x400x40 Le autorizzazioni a livello di tabella vengono controllate nel server di pubblicazione prima dell'applicazione nel server di pubblicazione delle istruzioni DELETE eseguite nel Sottoscrittore.Table-level permissions are checked at the Publisher before DELETE statements at the Subscriber are applied at the Publisher.
column_trackingcolumn_tracking truetrue Attiva il rilevamento a livello di colonna.Turns on column level tracking. Proprietà valida solo per gli articoli di tabelle.Applies only to a table article.

Nota: Rilevamento a livello di colonna non può essere utilizzato durante la pubblicazione di tabelle con più di 246 colonne.Note: Column level tracking cannot be used when publishing tables with more than 246 columns.
falsefalse Disattiva il rilevamento a livello di colonna e mantiene il rilevamento dei conflitti a livello di riga.Turns off column level tracking and leaves conflict detection at the row level. Proprietà valida solo per gli articoli di tabelle.Applies only to a table article.
compensate_for_errorscompensate_for_errors truetrue Vengono eseguite azioni di compensazione quando si verificano errori durante la sincronizzazione.Compensating actions are performed when errors occur during synchronization. Per ulteriori informazioni, vedere sp_addmergearticle.For more information, see sp_addmergearticle.
falsefalse Non vengono eseguite azioni di compensazione, situazione corrispondente al funzionamento predefinito.Compensating actions are not performed, which is the default behavior. Per ulteriori informazioni, vedere sp_addmergearticle.For more information, see sp_addmergearticle.

** Importante * \* anche se i dati nelle righe interessate potrebbero sembrare non convergenti, non appena si risolvere gli eventuali errori, è possibile applicare modifiche e ripristinata la convergenza dei dati.** Important *\* Although data in the affected rows might appear to be out of convergence, as soon as you address any errors, changes can be applied and data will converge. Se la tabella di origine per un articolo è già pubblicata in un'altra pubblicazione, il valore di compensate_for_errors deve essere lo stesso per entrambi gli articoli.If the source table for an article is already published in another publication, then the value of compensate_for_errors must be the same for both articles.
creation_scriptcreation_script Percorso e nome di uno script di schema dell'articolo facoltativo utilizzato per la creazione dell'articolo nel database di sottoscrizione.Path and name of an optional article schema script used to create the article in the subscription database.
delete_trackingdelete_tracking truetrue Le istruzioni DELETE vengono replicate, situazione corrispondente al funzionamento predefinito.DELETE statements are replicated, which is the default behavior.
falsefalse Le istruzioni DELETE non vengono replicate.DELETE statements are not replicated.

** Importante * \* impostazione delete_tracking a false risultati nelle righe non convergenza ed eliminate dovranno essere rimossi manualmente.** Important *\* Setting delete_tracking to false results in non-convergence, and deleted rows need to be manually removed.
descriptiondescription Voce descrittiva per l'articolo.Descriptive entry for the article.
destination_ownerdestination_owner Nome del proprietario dell'oggetto nel database di sottoscrizione, se non dbo.Name of the owner of the object in the subscription database, if not dbo.
identity_rangeidentity_range bigint che specifica le dimensioni dell'intervallo da utilizzare quando si assegna nuovi valori identity se l'articolo include identityrangemanagementoption impostata su auto o auto_identity_ intervallo impostato su true.bigint that specifies the range size to use when assigning new identity values if the article has identityrangemanagementoption set to auto or auto_identity_range set to true. Proprietà valida solo per gli articoli di tabelle.Applies to a table article only. Per ulteriori informazioni, vedere la sezione "Replica di tipo Merge" di replicare colonne Identity.For more information, see the "Merge Replication" section of Replicate Identity Columns.
identityrangemanagementoptionidentityrangemanagementoption Manualemanual Disabilita la gestione automatica degli intervalli di valori Identity.Disables automatic identity range management. Contrassegna le colonne Identity con NOT FOR REPLICATION per consentire la gestione manuale degli intervalli di valori Identity.Marks identity columns using NOT FOR REPLICATION to enable manual identity range handling. Per altre informazioni, vedere Replicare colonne Identity.For more information, see Replicate Identity Columns.
Nessunonone Disabilita tutti i tipi di gestione degli intervalli di valori Identity.Disables all identity range management.
logical_record_level_conflict_detectionlogical_record_level_conflict_detection truetrue Viene rilevato un conflitto in presenza di modifiche apportate in qualsiasi posizione del record logico.A conflict is detected if changes are made anywhere in the logical record. È necessario che logical_record_level_conflict_resolution impostare true.Requires that logical_record_level_conflict_resolution be set to true.
falsefalse Viene utilizzato il rilevamento dei conflitti predefinito come specificato da column_tracking.Default conflict detection is used as specified by column_tracking.
logical_record_level_conflict_resolutionlogical_record_level_conflict_resolution truetrue L'intero record logico prevalente sovrascrive il record logico perdente.Entire winning logical record overwrites the losing logical record.
falsefalse Le righe prevalenti non sono vincolate al record logico.Winning rows are not constrained to the logical record.
partition_optionspartition_options 00 Il filtro applicato all'articolo è statico oppure non restituisce un subset di dati univoco per ogni partizione, ovvero si creano partizioni sovrapposte.The filtering for the article either is static or does not yield a unique subset of data for each partition, i.e. an "overlapping" partition.
11 Le partizioni sono sovrapposte e gli aggiornamenti DML eseguiti nel Sottoscrittore non possono modificare la partizione a cui appartiene una riga.The partitions are overlapping, and DML updates made at the Subscriber cannot change the partition to which a row belongs.
22 Il filtro applicato all'articolo restituisce partizioni non sovrapposte, ma più Sottoscrittori possono ricevere la stessa partizione.The filtering for the article yields non-overlapping partitions, but multiple Subscribers can receive the same partition.
33 Il filtro applicato all'articolo restituisce partizioni non sovrapposte univoche per ogni sottoscrizione.The filtering for the article yields non-overlapping partitions that are unique for each subscription.

Nota: Se si specifica un valore di 3 per partition_options, può essere presente una sola sottoscrizione per ogni partizione di dati dell'articolo.Note: If you specify a value of 3 for partition_options, there can be only a single subscription for each partition of data in that article. 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.If a second subscription is created in which the filtering criterion of the new subscription resolves to the same partition as the existing subscription, the existing subscription is dropped.
pre_creation_commandpre_creation_command Nessunonone Se la tabella esiste già nel Sottoscrittore, non viene eseguita alcuna azione.If the table already exists at the Subscriber, no action is taken.
deletedelete Esegue un'operazione di eliminazione in base alla clausola WHERE del filtro di subset.Issues a delete based on the WHERE clause in the subset filter.
dropdrop Elimina la tabella prima di ricrearla.Drops the table before re-creating it.
truncatetruncate Tronca la tabella di destinazione.Truncates the destination table.
processing_orderprocessing_order int che indica l'ordine di elaborazione degli articoli in una pubblicazione di tipo merge.int that indicates the processing order of articles in a merge publication.
pub_identity_rangepub_identity_range bigint che specifica le dimensioni dell'intervallo allocata a un sottoscrittore con una sottoscrizione server se l'articolo include identityrangemanagementoption impostata su auto o auto_ identity_range impostato su true.bigint that specifies the range size allocated to a Subscriber with a server subscription if the article has identityrangemanagementoption set to auto or auto_identity_range set to true. L'intervallo di valori Identity è riservato al Sottoscrittore di ripubblicazione per l'assegnazione ai propri Sottoscrittori.This identity range is reserved for a republishing Subscriber to allocate to its own Subscribers. Proprietà valida solo per gli articoli di tabelle.Applies to a table article only. Per ulteriori informazioni, vedere la sezione "Replica di tipo Merge" di replicare colonne Identity.For more information, see the "Merge Replication" section of Replicate Identity Columns.
published_in_tran_pubpublished_in_tran_pub truetrue L'articolo è pubblicato anche in una pubblicazione transazionale.Article is also published in a transactional publication.
falsefalse L'articolo non è pubblicato anche in una pubblicazione transazionale.Article is not also published in a transactional publication.
resolver_inforesolver_info Specifica le informazioni aggiuntive necessarie per un sistema di risoluzione personalizzato.Is used to specify additional information required by a custom resolver. Alcuni sistemi di risoluzione MicrosoftMicrosoft richiedono una colonna come input.Some of the MicrosoftMicrosoft Resolvers require a column provided as input to the resolver. resolver_info viene nvarchar(255, con un valore predefinito è NULL.resolver_info is nvarchar(255), with a default of NULL. Per altre informazioni, vedere Sistemi di risoluzione dei conflitti basati su Microsoft COM.For more information, see Microsoft COM-Based Resolvers.
schema_option (bitmap)schema_option (bitmap) Per ulteriori informazioni, vedere la sezione Osservazioni di seguito in questo argomento.For more information, see the Remarks section later in this topic.
0x000x00 Disabilita la creazione di script tramite l'agente Snapshot e utilizza lo script fornito in creation_script.Disables scripting by the Snapshot Agent and uses the script provided in creation_script.
0x010x01 Genera lo script per la creazione di oggetti (CREATE TABLE, CREATE PROCEDURE e così via).Generates the object creation script (CREATE TABLE, CREATE PROCEDURE, and so on).
0x100x10 Genera un indice cluster corrispondente.Generates a corresponding clustered index.
0x200x20 Converte i tipi di dati definiti dall'utente in tipi di dati di base nel Sottoscrittore.Converts user-defined data types to base data types at the Subscriber. Questa opzione non può essere utilizzata quando è presente un vincolo CHECK o DEFAULT su una colonna con tipo definito dall'utente (UDT), se una colonna UDT è inclusa nella chiave primaria o se una colonna calcolata fa riferimento a una colonna UDT.This option cannot be used when there is a CHECK or DEFAULT constraint on a user-defined type (UDT) column, if a UDT column is part of the primary key, or if a computed column references a UDT column.
0x400x40 Genera indici non cluster corrispondenti.Generates corresponding nonclustered indexes.
0x800x80 include i vincoli di integrità referenziale dichiarati nelle chiavi primarie.Includes declared referential integrity on the primary keys.
0x1000x100 Replica gli eventuali trigger dell'utente di un articolo di tabella.Replicates user triggers on a table article, if defined.
0x2000x200 Replica i vincoli FOREIGN KEY.Replicates FOREIGN KEY constraints. Se la tabella con riferimenti non fa parte di una pubblicazione, tutti i vincoli FOREIGN KEY in una tabella pubblicata non vengono replicati.If the referenced table is not part of a publication, all FOREIGN KEY constraints on a published table are not replicated.
0x4000x400 Replica i vincoli CHECK.Replicates CHECK constraints.
0x8000x800 Replica i valori predefiniti.Replicates defaults.
0x10000x1000 Replica le regole di confronto a livello di colonna.Replicates column-level collation.
0x20000x2000 Replica le proprietà estese associate all'oggetto di origine dell'articolo pubblicato.Replicates extended properties associated with the published article source object.
0x40000x4000 Replica le eventuali chiavi univoche definite in un articolo di tabella.Replicates unique keys if defined on a table article.
0x80000x8000 Genera istruzioni ALTER TABLE per la creazione di script dei vincoli.Generates ALTER TABLE statements when scripting constraints.
0x10000.0x10000 Replica i vincoli CHECK come NOT FOR REPLICATION in modo che i vincoli non vengono imposti durante la sincronizzazione.Replicates CHECK constraints as NOT FOR REPLICATION so that the constraints are not enforced during synchronization.
0x200000x20000 Replica i vincoli FOREIGN KEY come NOT FOR REPLICATION in modo che i vincoli non vengono imposti durante la sincronizzazione.Replicates FOREIGN KEY constraints as NOT FOR REPLICATION so that the constraints are not enforced during synchronization.
0x400000x40000 Replica i filegroup associati a una tabella o un indice partizionato.Replicates filegroups associated with a partitioned table or index.
0x800000x80000 Replica lo schema di partizione per una tabella partizionata.Replicates the partition scheme for a partitioned table.
0x1000000x100000 Replica lo schema di partizione per un indice partizionato.Replicates the partition scheme for a partitioned index.
0x2000000x200000 Replica le statistiche della tabella.Replicates table statistics.
0x4000000x400000 Replica le associazioni predefinite.Replicates default Bindings
0x8000000x800000 Replica le associazioni di regole.Replicates rule Bindings
0x10000000x1000000 Replica l'indice full-text.Replicates the full-text index
0x20000000x2000000 Raccolte di XML schema associata a xml colonne non vengono replicate.XML schema collections bound to xml columns are not replicated.
0x40000000x4000000 Replica gli indici su xml colonne.Replicates indexes on xml columns.
0x80000000x8000000 Crea gli schemi non ancora presenti nel Sottoscrittore.Create any schemas not already present on the subscriber.
0x100000000x10000000 Converte xml colonne ntext nel Sottoscrittore.Converts xml columns to ntext on the Subscriber.
0x200000000x20000000 Tipi di dati dell'oggetto converte di grandi dimensioni (nvarchar (max), varchar (max), e varbinary (max)) che sono stati introdotti in SQL Server 2005SQL Server 2005 ai tipi di dati supportati in SQL Server 2000 (8.x)SQL Server 2000 (8.x).Converts large object data types (nvarchar(max), varchar(max), and varbinary(max)) that were introduced in SQL Server 2005SQL Server 2005 to data types that are supported on SQL Server 2000 (8.x)SQL Server 2000 (8.x).
0x400000000x40000000 Replica le autorizzazioni.Replicate permissions.
0x800000000x80000000 Tenta di eliminare le dipendenze da tutti gli oggetti che non fanno parte della pubblicazione.Attempt to drop dependencies to any objects that are not part of the publication.
0x1000000000x100000000 Utilizzare questa opzione per replicare l'attributo FILESTREAM se viene specificato in varbinary (max) colonne.Use this option to replicate the FILESTREAM attribute if it is specified on varbinary(max) columns. Non specificare questa opzione se si stanno replicando tabelle nei Sottoscrittori SQL Server 2005SQL Server 2005.Do not specify this option if you are replicating tables to SQL Server 2005SQL Server 2005 Subscribers. La replica di tabelle con colonne FILESTREAM in SQL Server 2000 (8.x)SQL Server 2000 (8.x) sottoscrittori non è supportata, indipendentemente dall'impostazione di questa opzione dello schema.Replicating tables that have FILESTREAM columns to SQL Server 2000 (8.x)SQL Server 2000 (8.x) Subscribers is not supported, regardless of how this schema option is set. Vedere l'opzione correlata 0x800000000.See related option 0x800000000.
0x2000000000x200000000 Converte i tipi di dati data e ora (data, ora, datetimeoffset, e datetime2) che vengono introdotti SQL Server 2008SQL Server 2008 per i tipi di dati supportati nelle versioni precedenti di SQL ServerSQL Server.Converts date and time data types (date, time, datetimeoffset, and datetime2) that are introduced in SQL Server 2008SQL Server 2008 to data types that are supported on earlier versions of SQL ServerSQL Server.
0x4000000000x400000000 Replica l'opzione di compressione per dati e indici.Replicates the compression option for data and indexes. Per altre informazioni, vedere Data Compression.For more information, see Data Compression.
0x8000000000x800000000 Impostare questa opzione per archiviare i dati FILESTREAM nel relativo filegroup nel Sottoscrittore.Set this option to store FILESTREAM data on its own filegroup at the Subscriber. Se questa opzione non è impostata, i dati FILESTREAM vengono archiviati nel filegroup predefinito.If this option is not set, FILESTREAM data is stored on the default filegroup. Tramite la replica non vengono creati filegroup, pertanto, se si imposta questa opzione, è necessario creare il filegroup prima di applicare lo snapshot nel Sottoscrittore.Replication does not create filegroups; therefore, if you set this option, you must create the filegroup before you apply the snapshot at the Subscriber. Per ulteriori informazioni su come creare gli oggetti prima di applicare lo snapshot, vedere eseguire script prima e dopo l'applicazione dello Snapshot.For more information about how to create objects before you apply the snapshot, see Execute Scripts Before and After the Snapshot Is Applied.

Vedere l'opzione correlata 0x100000000.See related option 0x100000000.
0x10000000000x1000000000 Converte i tipi common language runtime (CLR) definito dall'utente (UDT) in varbinary (max) in modo che le colonne di tipo definito dall'utente possono essere replicate nei Sottoscrittori che eseguono SQL Server 2005SQL Server 2005.Converts common language runtime (CLR) user-defined types (UDTs) to varbinary(max) so that columns of type UDT can be replicated to Subscribers that are running SQL Server 2005SQL Server 2005.
0x20000000000x2000000000 Converte il hierarchyid tipo di dati varbinary (max) in modo che le colonne di tipo hierarchyid possano essere replicate nei Sottoscrittori che eseguono SQL Server 2005SQL Server 2005.Converts the hierarchyid data type to varbinary(max) so that columns of type hierarchyid can be replicated to Subscribers that are running SQL Server 2005SQL Server 2005. Per ulteriori informazioni su come usare hierarchyid le colonne nelle tabelle replicate, vedere hierarchyid (Transact-SQL).For more information about how to use hierarchyid columns in replicated tables, see hierarchyid (Transact-SQL).
0x40000000000x4000000000 Replica gli eventuali indici filtrati sulla tabella.Replicates any filtered indexes on the table. Per ulteriori informazioni sugli indici filtrati, vedere Create Filtered Indexes.For more information about filtered indexes, see Create Filtered Indexes.
0x80000000000x8000000000 Converte il geography e geometry tipi di dati di varbinary (max) in modo che le colonne di questi tipi possono essere replicate nei Sottoscrittori che eseguono SQL Server 2005SQL Server 2005.Converts the geography and geometry data types to varbinary(max) so that columns of these types can be replicated to Subscribers that are running SQL Server 2005SQL Server 2005.
0x100000000000x10000000000 Replica gli indici su colonne di tipo geography e geometry.Replicates indexes on columns of type geography and geometry.
NULLNULL Il sistema genera automaticamente un'opzione di schema valida per l'articolo.System auto-generates a valid schema option for the article.
statusstatus Attivaactive Viene eseguito lo script di elaborazione iniziale per la pubblicazione della tabella.Initial processing script to publish the table is run.
unsyncedunsynced Lo script di elaborazione iniziale per la pubblicazione della tabella viene eseguito in occasione della successiva esecuzione dell'agente snapshot.The initial processing script to publish the table is run the next time the Snapshot Agent runs.
stream_blob_columnsstream_blob_columns truetrue Viene utilizzata l'ottimizzazione del flusso di dati per la replica di colonne BLOB.A data stream optimization is used when replicating binary large object columns. Tuttavia, alcune funzionalità della replica di tipo merge, come i record logici, potrebbero impedire l'utilizzo dell'ottimizzazione del flusso.However, certain merge replication functionalities, such as logical records, can still prevent the stream optimization from being used. stream_blob_columns è impostata su true se FILESTREAM è abilitato.stream_blob_columns is set to true when FILESTREAM is enabled. In questo modo, la replica dei dati FILESTREAM può essere eseguita in maniera ottimale e si riduce l'utilizzo della memoria.This allows replication of FILESTREAM data to perform optimally and reduce memory utilization. Per forzare gli articoli di tabella FILESTREAM non vengano utilizzati flussi blob, impostare stream_blob_columns su false.To force FILESTREAM table articles to not use blob streaming, set stream_blob_columns to false.

** Importante * \* l'abilitazione di questa ottimizzazione della memoria può ridurre le prestazioni dell'agente di Merge durante la sincronizzazione.** Important *\* Enabling this memory optimization might hurt the performance of the Merge Agent during synchronization. È consigliabile utilizzare questa opzione solo se vengono replicate colonne contenenti più megabyte di dati.This option should only be used when replicating columns that contain megabytes of data.
falsefalse Non viene utilizzata l'ottimizzazione per la replica di colonne BLOB.The optimization is not used when replicating binary large object columns.
subscriber_upload_optionssubscriber_upload_options 00 Nessuna restrizione per gli aggiornamenti eseguiti in un Sottoscrittore con una sottoscrizione client. Le modifiche vengono caricate nel server di pubblicazione.No restrictions on updates made at a Subscriber with a client subscription; changes are uploaded to the Publisher. La modifica di questa proprietà potrebbe richiedere la reinizializzazione dei Sottoscrittori esistenti.Changing this property may require that existing Subscribers be reinitialized.
11 Sono consentite modifiche in un Sottoscrittore con una sottoscrizione client, ma tali modifiche non vengono caricate nel server di pubblicazione.Changes are allowed at a Subscriber with a client subscription, but they are not uploaded to the Publisher.
22 Non sono consentite modifiche in un Sottoscrittore con una sottoscrizione client.Changes are not allowed at a Subscriber with a client subscription.
subset_filterclausesubset_filterclause Clausola WHERE che specifica il filtro orizzontale.WHERE clause specifying the horizontal filtering. Proprietà valida solo per gli articoli di tabelle.Applies only to a table article.

** Importante * \* per motivi di prestazioni, è consigliabile non applicare funzioni ai nomi di colonna nelle clausole di filtro di riga con parametri, ad esempio LEFT([MyColumn]) = SUSER_SNAME().** Important *\* For performance reasons, we recommended that you not apply functions to column names in parameterized row filter clauses, such as LEFT([MyColumn]) = SUSER_SNAME(). Se si utilizza HOST_NAME in una clausola di filtro e si sostituisce il valore di HOST_NAME, potrebbe essere necessario convertire i tipi di dati tramite CONVERTIRE.If you use HOST_NAME in a filter clause and override the HOST_NAME value, you might have to convert data types by using CONVERT. Per ulteriori informazioni sulle procedure consigliate in questo caso, vedere la sezione "Si esegue l'override del valore di HOST_NAME ()" in Parameterized Row Filters.For more information about best practices for this case, see the section "Overriding the HOST_NAME() Value" in Parameterized Row Filters.
Sogliathreshold Valore percentuale utilizzato per i sottoscrittori che eseguono SQL Server CompactSQL Server Compact o versioni precedenti di SQL ServerSQL Server.Percentage value used for Subscribers running SQL Server CompactSQL Server Compact or earlier versions of SQL ServerSQL Server. soglia determina quando l'agente di Merge deve assegnare un nuovo intervallo di valori identity.threshold controls when the Merge Agent assigns a new identity range. Quando viene utilizzata la percentuale di valori specificata in threshold, l'agente di merge crea un nuovo intervallo di valori Identity.When the percentage of values specified in threshold is used, the Merge Agent creates a new identity range. Utilizzato quando identityrangemanagementoption è impostato su auto o auto_identity_range è impostato su true.Used when identityrangemanagementoption is set to auto or auto_identity_range is set to true. Proprietà valida solo per gli articoli di tabelle.Applies to a table article only. Per ulteriori informazioni, vedere la sezione "Replica di tipo Merge" di replicare colonne Identity.For more information, see the "Merge Replication" section of Replicate Identity Columns.
verify_resolver_signatureverify_resolver_signature 11 La firma digitale di un sistema di risoluzione personalizzato viene verificata per stabilire se l'origine è attendibile.Digital signature on a custom resolver is verified to determine if it is from a trusted source.
00 La firma digitale di un sistema di risoluzione personalizzato non viene verificata per stabilire se l'origine è attendibile.Digital signature on a custom resolver is not verified to determine if it is from a trusted source.
NULL (predefinito)NULL (default) Restituisce l'elenco di valori supportati per proprietà.Returns the list of supported values for property.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Segnala che l'azione eseguita da questa stored procedure potrebbe invalidare uno snapshot esistente.Acknowledges that the action taken by this stored procedure may invalidate an existing snapshot. force_invalidate_snapshot è un bit, il valore predefinito è 0.force_invalidate_snapshot is a bit, with a default of 0.

0 specifica che le modifiche apportate all'articolo di merge non invalidano lo snapshot non è valido.0 specifies that changes to the merge article do not cause the snapshot to be invalid. Se la stored procedure rileva che la modifica richiede un nuovo snapshot, viene generato un errore e non viene apportata alcuna modifica.If the stored procedure detects that the change does require a new snapshot, an error occurs and no changes are made.

1 significa che le modifiche apportate all'articolo di merge potrebbero invalidare lo snapshot non è valido e se sono disponibili sottoscrizioni che richiedono un nuovo snapshot, concede l'autorizzazione per lo snapshot esistente deve essere contrassegnato come obsoleto e di generarne uno nuovo.1 means that changes to the merge article may cause the snapshot to be invalid, and if there are existing subscriptions that would require a new snapshot, gives permission for the existing snapshot to be marked as obsolete and a new snapshot generated.

Per informazioni sulle proprietà che richiedono la generazione di un nuovo snapshot quando vengono modificate, vedere la sezione Osservazioni.See the Remarks section for the properties that, when changed, require the generation of a new snapshot.

[ @force_reinit_subscription = ] force_reinit_subscription[ @force_reinit_subscription = ] force_reinit_subscription
Segnala che l'azione eseguita dalla stored procedure potrebbe richiedere la reinizializzazione delle sottoscrizioni esistenti.Acknowledges that the action taken by this stored procedure may require existing subscriptions to be reinitialized. force_reinit_subscription è un bit, il valore predefinito è 0.force_reinit_subscription is a bit, with a default of 0.

0 specifica che le modifiche apportate all'articolo di merge non causano la reinizializzazione della sottoscrizione.0 specifies that changes to the merge article do not cause the subscription to be reinitialized. Se la stored procedure rileva che la modifica richiede la reinizializzazione delle sottoscrizioni esistenti, viene generato un errore e non viene apportata alcuna modifica.If the stored procedure detects that the change would require existing subscriptions to be reinitialized, an error occurs and no changes are made.

1 significa che le modifiche apportate all'articolo di merge causa reinizializzazione delle sottoscrizioni esistenti e concede l'autorizzazione per la reinizializzazione.1 means that changes to the merge article cause existing subscriptions to be reinitialized, and gives permission for the subscription reinitialization to occur.

Per ulteriori informazioni sulle proprietà che richiedono la reinizializzazione di tutte le sottoscrizioni esistenti in caso di modifica, vedere la sezione Osservazioni.See the Remarks section for the properties that, when changed, require that all existing subscriptions be reinitialized.

Valori restituitiReturn Code Values

0 (esito positivo) o 1 (esito negativo)0 (success) or 1 (failure)

OsservazioniRemarks

sp_changemergearticle viene utilizzata nella replica di tipo merge.sp_changemergearticle is used in merge replication.

Poiché sp_changemergearticle viene utilizzata per modificare le proprietà degli articoli specificate inizialmente tramite sp_addmergearticle, fare riferimento a sp_addmergearticle Per ulteriori informazioni su queste proprietà.Because sp_changemergearticle is used to change article properties that were initially specified by using sp_addmergearticle, refer to sp_addmergearticle for additional information about these properties.

Modifica delle proprietà seguenti richiede la generazione di un nuovo snapshot, ed è necessario specificare un valore di 1 per il force_invalidate_snapshot parametro:Changing the following properties requires that a new snapshot be generated, and you must specify a value of 1 for the force_invalidate_snapshot parameter:

  • check_permissionscheck_permissions

  • column_trackingcolumn_tracking

  • destination_ownerdestination_owner

  • pre_creation_commandpre_creation_command

  • schema_optionsschema_options

  • subset_filterclausesubset_filterclause

    Modifica delle proprietà seguenti richiede esistenti reinizializzazione delle sottoscrizioni ed è necessario specificare un valore di 1 per il force_reinit_subscription parametro:Changing the following properties requires that existing subscriptions be reinitialized, and you must specify a value of 1 for the force_reinit_subscription parameter:

  • check_permissionscheck_permissions

  • column_trackingcolumn_tracking

  • destination_ownerdestination_owner

  • pre_creation_commandpre_creation_command

  • identityrangemanagementoptionidentityrangemanagementoption

  • subscriber_upload_optionssubscriber_upload_options

  • subset_filterclausesubset_filterclause

  • creation_scriptcreation_script

  • schema_optionschema_option

  • logical_record_level_conflict_detectionlogical_record_level_conflict_detection

  • logical_record_level_conflict_resolutionlogical_record_level_conflict_resolution

    Quando si specifica un valore pari a 3 per partition_options, i metadati vengono puliti ogni volta che viene eseguito l'agente di Merge e lo snapshot partizionato scade più rapidamente.When specifying a value of 3 for partition_options, metadata is cleaned up whenever the Merge Agent runs and the partitioned snapshot expires more quickly. Quando si utilizza questa opzione è consigliabile prendere in considerazione l'abilitazione di snapshot partizionati richiesti dal Sottoscrittore.When using this option, you should consider enabling subscriber requested partitioned snapshot. Per altre informazioni, vedere Snapshots for Merge Publications with Parameterized Filters.For more information, see Snapshots for Merge Publications with Parameterized Filters.

    Quando si imposta la column_tracking proprietà, se la tabella è già pubblicata in altre pubblicazioni di tipo merge, la colonna di rilevamento deve essere lo stesso come il valore viene utilizzato dagli articoli esistenti basati su questa tabella.When setting the column_tracking property, if the table is already published in other merge publications, the column tracking must be the same as the value being used by existing articles based on this table. Questo parametro è disponibile solo per gli articoli di tabelle.This parameter is specific to table articles only.

    Se più pubblicazioni pubblicano articoli basati sulla stessa tabella sottostante, la modifica di delete_tracking proprietà o compensate_for_errors proprietà per un articolo causa la stessa modifica a eseguire ad altri articoli che sono basati sulla stessa tabella.If multiple publications publish articles based on the same underlying table, changing the delete_tracking property or the compensate_for_errors property for one article causes the same change to be made to the other articles that are based on the same table.

    Se l'account di accesso o l'account utente del server di pubblicazione utilizzato per il processo di merge non dispone delle autorizzazioni corrette per le tabelle, le modifiche non valide vengono registrate come conflitti.If the Publisher login/user account used by the merge process does not have the correct table permissions, the invalid changes are logged as conflicts.

    Quando si modifica il valore di schema_option, il sistema non esegue un aggiornamento bit per bit.When changing the value of schema_option, the system does not perform a bitwise update. Ciò significa che quando si imposta schema_option utilizzando sp_changemergearticleesistente, le impostazioni di bit possono essere disattivate.This means that when you set schema_option using sp_changemergearticle, existing bit settings may be turned off. 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_helpmergearticle.To retain the existing settings, you should perform & (Bitwise AND) between the value that you are setting and the current value of schema_option, which can be determined by executing sp_helpmergearticle.

Attenzione

Quando è molti (fino a raggiungere centinaia) degli articoli in una pubblicazione e di eseguire sp_changemergearticle per uno degli articoli, potrebbe richiedere molto tempo per completare l'esecuzione.When you many (perhaps hundreds) of articles in a publication and you execute sp_changemergearticle for one of the articles, it might take a long time to finish execution.

Tabella delle opzioni di schema valideValid Schema Option Table

La tabella seguente descrive consentiti schema_optionvalori, in base al tipo di articolo.The following table describes the allowed schema_optionvalues, depending on article type.

Tipo di articoloArticle type Valori delle opzioni di schemaSchema option values
Func schema solofunc schema only 0x01 e 0x20000x01 and 0x2000
solo schema della vista indicizzataindexed view schema only 0x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000e 0x2000000x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000, and 0x200000
proc schema soloproc schema only 0x01 e 0x20000x01 and 0x2000
tabletable Tutte le opzioni.All options.
solo schema della vistaview schema only 0x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000e 0x2000000x01, 0x040, 0x0100, 0x2000, 0x40000, 0x1000000, and 0x200000

EsempioExample

DECLARE @publication AS sysname;
DECLARE @article AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
SET @article = N'SalesOrderHeader';

-- Enable column-level conflict tracking.
-- Changing this property requires that existing subscriptions
-- be reinitialized and that a new snapshot be generated.
USE [AdventureWorks2012]
EXEC sp_changemergearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'column_tracking', 
  @value = N'true',
  @force_invalidate_snapshot = 1,
  @force_reinit_subscription = 1;
GO

AutorizzazioniPermissions

Solo i membri del sysadmin ruolo predefinito del server o db_owner ruolo predefinito del database possono eseguire sp_changemergearticle.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_changemergearticle.

Vedere ancheSee Also

Visualizzare e modificare le proprietà di articolo View and Modify Article Properties
Modifica delle proprietà di pubblicazioni e articoli Change Publication and Article Properties
sp_addmergearticle (Transact-SQL) sp_addmergearticle (Transact-SQL)
sp_dropmergearticle (Transact-SQL) sp_dropmergearticle (Transact-SQL)
sp_helpmergearticle (Transact-SQL) sp_helpmergearticle (Transact-SQL)
Stored procedure per la replica (Transact-SQL)Replication Stored Procedures (Transact-SQL)