sp_helpmergearticle (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Restituisce informazioni su un articolo. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione o nel database di sottoscrizione di un Sottoscrittore di ripubblicazione.

Convenzioni di sintassi Transact-SQL

Sintassi

sp_helpmergearticle
    [ [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
[ ; ]

Argomenti

[ @publication = ] N'publication'

Nome della pubblicazione su cui recuperare le informazioni. @publication è sysname, con un valore predefinito %, che restituisce informazioni su tutti gli articoli di merge contenuti in tutte le pubblicazioni nel database corrente.

[ @article = ] N'article'

Nome dell'articolo per cui restituire informazioni. @article è sysname, con un valore predefinito %, che restituisce informazioni su tutti gli articoli di merge nella pubblicazione specificata.

Set di risultati

Nome colonna Tipo di dati Descrizione
id int Identificatore dell'articolo.
name sysname Nome dell'articolo.
source_owner sysname Nome del proprietario dell'oggetto di origine.
source_object sysname Nome dell'oggetto di origine da cui aggiungere l'articolo.
sync_object_owner sysname Nome del proprietario della vista che definisce l'articolo pubblicato.
sync_object sysname Nome dell'oggetto personalizzato utilizzato per stabilire i dati iniziali per la partizione.
description nvarchar(255) Descrizione dell'articolo.
status tinyint Stato dell'articolo, che può essere uno dei valori seguenti:

1 = inattivo

2 = attivo

5 = operazione DDL (Data Definition Language) in sospeso

6 = Operazione DDL con uno snapshot appena generato

Nota: quando un articolo viene reinizializzato, i valori di 5 e 6 vengono modificati in 2.
creation_script nvarchar(255) Percorso e nome di uno script di schema dell'articolo facoltativo utilizzato per la creazione dell'articolo nel database di sottoscrizione.
conflict_table nvarchar(270) Nome della tabella in cui sono archiviati i conflitti di inserimento o aggiornamento.
article_resolver nvarchar(255) Sistema di risoluzione personalizzato per l'articolo.
subset_filterclause nvarchar(1000) Clausola WHERE che specifica il filtro orizzontale.
pre_creation_command tinyint Metodo di pre-creazione, che può essere uno dei valori seguenti:

0 = nessuno

1 = drop

2 = delete

3 = troncamento
schema_option binary(8) Mappa di bit dell'opzione di generazione dello schema per l'articolo. Per informazioni su questa opzione bitmap, vedere sp_addmergearticle o sp_changemergearticle.
type smallint Tipo di articolo, che può essere uno dei valori seguenti:

10 = tabella

32 = stored procedure

64 = vista o vista indicizzata

128 = funzione definita dall'utente

160 = solo schema sinonimo
column_tracking int Impostazione per il rilevamento a livello di colonna; dove 1 indica che il rilevamento a livello di colonna è attivo e 0 indica che il rilevamento a livello di colonna è disattivato.
resolver_info nvarchar(255) Nome del sistema di risoluzione dell'articolo.
vertical_partition bit Se l'articolo è partizionato verticalmente; dove 1 significa che l'articolo è partizionato verticalmente e 0 significa che non lo è.
destination_owner sysname Proprietario dell'oggetto di destinazione. È applicabile solo per gli articoli di schema di tipo merge per stored procedure, viste e funzioni definite dall'utente.
identity_support int Se la gestione automatica degli intervalli di valori Identity è abilitata; dove 1 è abilitato ed 0 è disabilitato.
pub_identity_range bigint Dimensioni di intervallo da utilizzare per l'assegnazione di nuovi valori Identity. Per altre informazioni, vedere la sezione "Replica di tipo merge" di Replica colonne Identity.
identity_range bigint Dimensioni di intervallo da utilizzare per l'assegnazione di nuovi valori Identity. Per altre informazioni, vedere la sezione "Replica di tipo merge" di Replica colonne Identity.
threshold int Valore percentuale usato per i Sottoscrittori che eseguono SQL Server Compact o versioni precedenti di SQL Server. thresholdcontrolla quando il agente di merge assegna un nuovo intervallo di valori Identity. Quando viene utilizzata la percentuale di valori specificata in threshold, l'agente di merge crea un nuovo intervallo di valori Identity. Per altre informazioni, vedere la sezione "Replica di tipo merge" di Replica colonne Identity.
verify_resolver_signature int Se una firma digitale viene verificata prima di usare un resolver nella replica di tipo merge; dove 0 significa che la firma non è verificata e 1 significa che la firma viene verificata per verificare se proviene da un'origine attendibile.
destination_object sysname Nome dell'oggetto di destinazione. È applicabile solo per gli articoli di schema di tipo merge per stored procedure, viste e funzioni definite dall'utente.
allow_interactive_resolver int Se il sistema di risoluzione interattivo viene usato in un articolo; dove 1 significa che questo sistema di risoluzione viene usato e 0 significa che non viene usato.
fast_multicol_updateproc int Consente o disabilita il agente di merge di applicare modifiche a più colonne nella stessa riga in un'istruzione UPDATE. 1 Ciò significa che più colonne vengono aggiornate in un'unica istruzione e 0 significa che le istruzioni UPDATE separate sono problemi per ogni colonna aggiornata.
check_permissions int Valore integer che rappresenta la mappa di bit delle autorizzazioni a livello di tabella da verificare. Per un elenco dei valori possibili, vedere sp_addmergearticle (Transact-SQL).
processing_order int Ordine di applicazione delle modifiche dei dati agli articoli di una pubblicazione.
upload_options tinyint Imposta le restrizioni per gli aggiornamenti eseguiti in un Sottoscrittore con una sottoscrizione client. I possibili valori sono i seguenti.

0 = Non esistono restrizioni sugli aggiornamenti eseguiti in un Sottoscrittore con una sottoscrizione client; tutte le modifiche vengono caricate nel server di pubblicazione.

1 = Le modifiche sono consentite in un Sottoscrittore con una sottoscrizione client, ma non vengono caricate nel server di pubblicazione.

2 = Le modifiche non sono consentite in un Sottoscrittore con una sottoscrizione client.

Per altre informazioni, vedere Ottimizzare le prestazioni della replica di tipo merge con gli articoli di solo download.
identityrangemanagementoption int Specifica se è attivata la gestione automatica degli intervalli di valori Identity. 1 è abilitato ed 0 è disabilitato.
delete_tracking bit Specifica se le eliminazioni vengono replicate. 1 significa che le eliminazioni vengono replicate e 0 significa che non lo sono.
compensate_for_errors bit Indica se vengono eseguite azioni di compensazione quando si verificano errori durante la sincronizzazione; dove 1 indica che vengono eseguite azioni di compensazione e 0 significa che le azioni di compensazione non vengono eseguite.
partition_options tinyint Definisce il modo in cui i dati nell'articolo vengono partizionati. Questa opzione abilita le ottimizzazioni delle prestazioni quando tutte le righe appartengono a una sola partizione o in una sola sottoscrizione. partition_options può essere uno dei valori seguenti.

0 = Il filtro per l'articolo è statico o non produce un subset univoco di dati per ogni partizione; vale a dire, è una partizione "sovrapposta".

1 = Le partizioni sono sovrapposte e gli aggiornamenti DML (Data Manipulation Language) eseguiti nel Sottoscrittore non possono modificare la partizione a cui appartiene una riga.

2 = Il filtro per l'articolo produce partizioni non sovrapposte, ma più Sottoscrittori possono ricevere la stessa partizione.

3 = Il filtro per l'articolo restituisce partizioni non sovrapposte univoche per ogni sottoscrizione.
artid uniqueidentifier Identificatore univoco dell'articolo.
pubid uniqueidentifier Identificatore univoco della pubblicazione in cui viene pubblicato l'articolo.
stream_blob_columns bit Indica se viene utilizzata l'ottimizzazione del flusso di dati per la replica di colonne BLOB. 1 significa che l'ottimizzazione viene usata e 0 significa che l'ottimizzazione non viene usata.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_helpmergearticle viene usato nella replica di tipo merge.

Autorizzazioni

Solo i membri del ruolo predefinito del database di db_owner nel database di pubblicazione, il ruolo replmonitor nel database di distribuzione o l'elenco di accesso alla pubblicazione per una pubblicazione possono eseguire sp_helpmergearticle.

Esempi

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

USE [AdventureWorks2022]
EXEC sp_helpmergearticle
  @publication = @publication;
GO

Contenuto correlato