sp_helparticle (Transact-SQL)

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

Visualizza informazioni su un articolo. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione. Per i server di pubblicazione Oracle questa stored procedure viene eseguita in qualsiasi database del server di distribuzione.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_helparticle
    [ @publication = ] N'publication'
    [ , [ @article = ] N'article' ]
    [ , [ @returnfilter = ] returnfilter ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @found = ] found OUTPUT ]
[ ; ]

Argomenti

[ @publication = ] N'publication'

Nome della pubblicazione. @publication è sysname, senza impostazione predefinita.

[ @article = ] N'article'

Nome di un articolo della pubblicazione. @article è sysname, con un valore predefinito .% Se @article non viene fornito, vengono restituite informazioni su tutti gli articoli per la pubblicazione specificata.

[ @returnfilter = ] returnfilter

Indica se restituire o meno la clausola di filtro. @returnfilter è bit, con un valore predefinito , 1che restituisce la clausola di filtro.

[ @publisher = ] N'publisher'

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

@publisher non deve essere specificato quando si richiedono informazioni su un articolo pubblicato da un server di pubblicazione di SQL Server.

[ @found = ] found OUTPUT

Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.

Set di risultati

Nome colonna Tipo di dati Descrizione
article id int ID dell'articolo.
article name sysname Nome dell'articolo.
base object nvarchar(257) Nome della tabella sottostante rappresentata dall'articolo o dalla stored procedure.
destination object sysname Nome della tabella di destinazione (sottoscrizione).
synchronization object nvarchar(257) Nome della vista che definisce l'articolo pubblicato.
type smallint Tipo di articolo:

1 = Basato su log.
3 = Basato su log con filtro manuale.
5 = Basato su log con visualizzazione manuale.
7 = Basato su log con filtro manuale e visualizzazione manuale.
8 = Esecuzione di stored procedure.
24 = Esecuzione di stored procedure serializzabili.
32 = Stored procedure (solo schema).
64 = Visualizzazione (solo schema).
96 = Funzione di aggregazione (solo schema).
128 = Funzione (solo schema).
257 = Vista indicizzata basata su log.
259 = Vista indicizzata basata su log con filtro manuale.
261 = Vista indicizzata basata su log con visualizzazione manuale.
263 = Vista indicizzata basata su log con filtro manuale e visualizzazione manuale.
320 = Vista indicizzata (solo schema).
status tinyint Può essere il risultato &(AND bit per bit) di una o più proprietà dell'articolo:

0x00 = Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
0x01 = L'articolo è attivo.
0x08 = Includere il nome della colonna nelle istruzioni insert.
0x16 = Usare istruzioni con parametri.
0x32 = Usare istruzioni con parametri e includere il nome della colonna nelle istruzioni insert.
filter nvarchar(257) Stored procedure utilizzata per filtrare la tabella in senso orizzontale. Questa stored procedure deve essere creata utilizzando la FOR REPLICATION clausola .
description nvarchar(255) Voce descrittiva per l'articolo.
insert_command nvarchar(255) Tipo di comando di replica utilizzato per la replica degli inserimenti con articoli di tabella. 1
update_command nvarchar(255) Tipo di comando di replica utilizzato per la replica degli aggiornamenti con articoli di tabella. 1
delete_command nvarchar(255) Tipo di comando di replica utilizzato per la replica delle eliminazioni con articoli di tabella. 1
creation script path nvarchar(255) Percorso e nome di uno script di schema dell'articolo utilizzato per la creazione delle tabelle di destinazione.
vertical partition bit Indica se il partizionamento verticale è abilitato per l'articolo; dove un valore indica 1 che il partizionamento verticale è abilitato.
pre_creation_cmd tinyint Comando di precreazione per DROP TABLE, DELETE TABLEo TRUNCATE TABLE.
filter_clause ntext Clausola WHERE che specifica il filtro orizzontale.
schema_option binary(8) Maschera di bit dell'opzione di creazione dello schema per l'articolo specificato. Per un elenco completo dei schema_option valori, vedere sp_addarticle.
dest_owner sysname Nome del proprietario dell'oggetto di destinazione.
source_owner sysname Proprietario dell'oggetto di origine.
unqua_source_object sysname Nome dell'oggetto di origine, senza il nome del proprietario.
sync_object_owner sysname Proprietario della vista che definisce l'articolo pubblicato.
unqualified_sync_object sysname Nome della vista che definisce l'articolo pubblicato, senza il nome del proprietario.
filter_owner sysname Proprietario del filtro.
unqua_filter sysname Nome del filtro, senza il nome del proprietario.
auto_identity_range int Flag che indica se la gestione automatica degli intervalli di valori Identity era attivata nella pubblicazione quando la pubblicazione è stata creata. 1 significa che l'intervallo di valori Identity automatico è abilitato; 0 significa che è disabilitato.
publisher_identity_range int Dimensioni dell'intervallo di valori Identity nel server di pubblicazione se l'articolo è identityrangemanagementoption impostato su auto o auto_identity_range impostato su true.
identity_range bigint Dimensioni dell'intervallo di valori Identity nel Sottoscrittore se l'articolo è identityrangemanagementoption impostato su auto o auto_identity_range impostato su true.
threshold bigint Valore percentuale che indica quando l'agente di distribuzione assegna un nuovo intervallo di valori Identity.
identityrangemanagementoption int Indica la gestione degli intervalli di valori Identity per l'articolo.
fire_triggers_on_snapshot bit Indica se i trigger utente replicati vengono eseguiti quando viene applicato lo snapshot iniziale.

1 = vengono eseguiti trigger utente.
0 = i trigger utente non vengono eseguiti.

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

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_helparticle viene usato nella replica snapshot e nella replica transazionale.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin , il ruolo predefinito del database db_owner oppure l'elenco di accesso alla pubblicazione per la pubblicazione corrente può eseguire sp_helparticle.

Esempi

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

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