Articolo
09/28/2010

sp_helppublication (Transact-SQL)

Restituisce informazioni su una pubblicazione. Per una pubblicazione MicrosoftSQL Server, questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione. Per una pubblicazione Oracle, questa stored procedure viene eseguita in qualsiasi database del server di distribuzione.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

sp_helppublication [ [ @publication = ] 'publication' ]
    [ , [ @found=] found OUTPUT]
    [ , [ @publisher = ] 'publisher' ]

Argomenti

[ @publication = ] 'publication'
Nome della pubblicazione da visualizzare. publication è di tipo sysname, con un valore predefinito % che restituisce informazioni su tutte le pubblicazioni.
[ @found = ] 'found' OUTPUT
Flag che indica le righe che restituiscono valori. foundè di tipo int, è un parametro OUTPUT e il valore predefinito è 23456. 1 indica che la pubblicazione è stata individuata. 0 indica che la pubblicazione non è stata individuata.
[ @publisher = ] 'publisher'
Specifica un server di pubblicazione non SQL Server. publisher è di tipo sysname, con un valore predefinito NULL.

[!NOTA]

Non è consigliabile specificare publisher quando si richiedono informazioni sulle pubblicazioni da un server di pubblicazione SQL Server.

Set di risultati

Nome colonna	Tipo di dati	Descrizione
pubid	int	ID della pubblicazione.
name	sysname	Nome della pubblicazione.
restricted	int	Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
status	tinyint	Stato corrente della pubblicazione. 0 = Inattiva. 1 = Attiva.
task		Disponibile per compatibilità con le versioni precedenti.
replication frequency	tinyint	Tipo di frequenza della replica: 0 = Transazionale 1 = Snapshot
synchronization method	tinyint	Modalità di sincronizzazione: 0 = Programma per la copia bulk (utilità bcp) in modalità nativa 1 = Copia bulk in modalità carattere 3 = Simultanea, ovvero viene utilizzata la copia bulk (utilità bcp) in modalità nativa, ma durante lo snapshot le tabelle non vengono bloccate 4 = Concurrent_c, ovvero viene utilizzata la copia bulk in modalità carattere, ma durante lo snapshot le tabelle non vengono bloccate
description	nvarchar(255)	Descrizione facoltativa della pubblicazione.
immediate_sync	bit	Indica se i file di sincronizzazione vengono creati o ricreati a ogni esecuzione dell'agente snapshot.
enabled_for_internet	bit	Indica se i file di sincronizzazione della pubblicazione vengono esposti a Internet tramite FTP e altri servizi.
allow_push	bit	Indica se per la pubblicazione sono consentite o meno sottoscrizioni push.
allow_pull	bit	Indica se per la pubblicazione sono consentite o meno sottoscrizioni pull.
allow_anonymous	bit	Indica se per la pubblicazione sono consentite o meno sottoscrizioni anonime.
independent_agent	bit	Indica se per la pubblicazione è disponibile un agente di distribuzione autonomo.
immediate_sync_ready	bit	Indica se l'agente snapshot ha generato o meno uno snapshot pronto per l'utilizzo nelle nuove sottoscrizioni. Questo parametro viene definito solo se la pubblicazione è configurata in modo che sia sempre disponibile uno snapshot per le sottoscrizioni nuove o reinizializzate.
allow_sync_tran	bit	Indica se per la pubblicazione sono consentite sottoscrizioni ad aggiornamento immediato.
autogen_sync_procs	bit	Indica se generare automaticamente stored procedure per il supporto di sottoscrizioni ad aggiornamento immediato.
snapshot_jobid	binary(16)	ID dell'attività pianificata.
retention	int	Quantità di modifiche, espresse in ore, da salvare per la pubblicazione specificata.
has subscription	bit	Indica se esistono sottoscrizioni attive della pubblicazione. 1 indica che esistono sottoscrizioni attive della pubblicazione. 0 indica che non esistono sottoscrizioni della pubblicazione.
allow_queued_tran	bit	Specifica se è attivato o meno l'inserimento in coda delle modifiche apportate nel Sottoscrittore finché non è possibile applicarle al server di pubblicazione. 0 indica che le modifiche apportate nel Sottoscrittore non vengono inserite in coda.
snapshot_in_defaultfolder	bit	Specifica se i file di snapshot sono archiviati nella cartella predefinita. Se è 0, i file di snapshot sono stati archiviati nella posizione alternativa specificata da alternate_snapshot_folder. Se è 1, i file di snapshot sono disponibili nella cartella predefinita.
alt_snapshot_folder	nvarchar(255)	Specifica la posizione della cartella alternativa per lo snapshot.
pre_snapshot_script	nvarchar(255)	Specifica un puntatore al percorso di un file con estensione sql. L'agente di distribuzione esegue lo script pre-snapshot prima dell'esecuzione degli script di oggetti replicati in fase di applicazione di uno snapshot in un Sottoscrittore.
post_snapshot_script	nvarchar(255)	Specifica un puntatore al percorso di un file con estensione sql. L'agente di distribuzione esegue lo script post-snapshot dopo l'applicazione di tutti gli altri script di oggetti replicati e dei dati durante una sincronizzazione iniziale.
compress_snapshot	bit	Specifica che lo snapshot scritto nella posizione indicata da alt_snapshot_folder deve essere compresso nel formato Microsoft CAB. 0 indica che lo snapshot non verrà compresso.
ftp_address	sysname	Indirizzo di rete del servizio FTP per il server di distribuzione. Specifica la posizione in cui i file di snapshot della pubblicazione possono essere prelevati dall'agente di distribuzione o di merge di un Sottoscrittore.
ftp_port	int	Numero di porta del servizio FTP per il server di distribuzione.
ftp_subdirectory	nvarchar(255)	Specifica la posizione in cui i file di snapshot possono essere prelevati dall'agente di distribuzione o di merge di un Sottoscrittore se la pubblicazione supporta la propagazione degli snapshot tramite FTP.
ftp_login	sysname	Nome utente utilizzato per la connessione al servizio FTP.
allow_dts	bit	Specifica che la pubblicazione consente trasformazioni di dati. 0 indica che le trasformazioni DTS non sono consentite.
allow_subscription_copy	bit	Specifica se è stata attivata la funzione di copia dei database di sottoscrizione che sottoscrivono la pubblicazione. 0 indica che la copia non è consentita.
centralized_conflicts	bit	Specifica se i record dei conflitti vengono archiviati nel server di pubblicazione: 0 = I record dei conflitti vengono archiviati sia nel server di pubblicazione sia nel Sottoscrittore che ha causato il conflitto. 1 = I record dei conflitti vengono archiviati nel server di pubblicazione.
conflict_retention	int	Specifica il periodo di memorizzazione dei conflitti espresso in giorni.
conflict_policy	int	Specifica il criterio di risoluzione dei conflitti adottato quando nel Sottoscrittore è attivato l'aggiornamento in coda. I possibili valori sono i seguenti: 1 = Prevale il server di pubblicazione. 2 = Prevale il Sottoscrittore. 3 = La sottoscrizione viene reinizializzata.
queue_type		Specifica il tipo di coda da utilizzare. I possibili valori sono i seguenti: msmq = Viene utilizzato il servizio di accodamento messaggi Microsoft per l'archiviazione delle transazioni. sql = Viene utilizzato SQL Server per l'archiviazione delle transazioni. Nota Il servizio di accodamento messaggi non è più supportato.
backward_comp_level		Livello di compatibilità del database. I possibili valori sono i seguenti: 10 = MicrosoftSQL Server 7.0 20 = SQL Server 7.0 Service Pack 1 30 = SQL Server 7.0 Service Pack 2 35 = SQL Server 7.0 Service Pack 3 40 = MicrosoftSQL Server 2000 50 = SQL Server 2000 Service Pack 1 60 = SQL Server 2000 Service Pack 3 90 = MicrosoftSQL Server 2005 100 = MicrosoftSQL Server 2008
publish_to_AD	bit	Specifica se la pubblicazione è pubblicata in Microsoft Active Directory™. Il valore 1 indica che è pubblicata. Il valore 0 indica che non è pubblicata.
allow_initialize_from_backup	bit	Indica se i Sottoscrittori possono inizializzare una sottoscrizione della pubblicazione da un backup anziché da uno snapshot iniziale. 1 indica che le sottoscrizioni possono essere inizializzate da un backup. 0 indica il contrario. Per ulteriori informazioni, vedere Inizializzazione di una sottoscrizione transazionale senza uno snapshot.
replicate_ddl	int	Indica se per la pubblicazione è supportata la replica dello schema. 1 indica che le istruzioni DDL (Data Definition Language) eseguite nel server di pubblicazione vengono replicate. 0 indica che le istruzioni DDL non vengono replicate. Per ulteriori informazioni, vedere Modifiche allo schema nei database di pubblicazione.
enabled_for_p2p	int	Indica se la pubblicazione può essere utilizzata in una topologia di replica peer-to-peer. 1 indica che la pubblicazione supporta la replica peer-to-peer. Per ulteriori informazioni, vedere Replica transazionale peer-to-peer.
publish_local_changes_only	int	Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
enabled_for_het_sub	int	Specifica se la pubblicazione supporta Sottoscrittori non SQL Server. Il valore 1 indica che sono supportati Sottoscrittori non SQL Server. Il valore 0 indica che sono supportati solo Sottoscrittori SQL Server. Per ulteriori informazioni, vedere Sottoscrittori non SQL Server.
enabled_for_p2p_conflictdetection	int	Specifica se l'Agente di Distribuzione rileva i conflitti per una pubblicazione abilitata per la replica peer-to-peer. Un valore 1 significa che i conflitti vengono rilevati. Per ulteriori informazioni, vedere Rilevamento dei conflitti nella replica peer-to-peer.
originator_id	int	Specifica un ID per un nodo in una topologia peer-to-peer. Questo ID viene utilizzato per il rilevamento dei conflitti se l'opzione enabled_for_p2p_conflictdetection è impostata su 1. Per un elenco degli ID che sono già stati utilizzati, eseguire una query sulla tabella di sistema Mspeer_originatorid_history.
p2p_continue_onconflict	int	Specifica se l'agente di distribuzione continua a elaborare le modifiche quando viene rilevato un conflitto. Il valore 1 indica che l'agente continua a elaborare le modifiche. Attenzione È consigliabile utilizzare il valore predefinito 0. Quando questa opzione è impostata su 1, l'agente di distribuzione tenta di garantire la convergenza dei dati nella topologia applicando la riga in conflitto dal nodo con ID di origine maggiore. Questo metodo non garantisce la convergenza. Dopo il rilevamento di un conflitto, è necessario assicurarsi che la topologia sia coerente. Per ulteriori informazioni, vedere la sezione relativa alla gestione dei conflitti in Rilevamento dei conflitti nella replica peer-to-peer.
alllow_partition_switch	int	Specifica se le istruzioni ALTER TABLE...SWITCH possono essere eseguite sul database pubblicato. Per ulteriori informazioni, vedere Replica di tabelle e indici partizionati.
replicate_partition_switch	int	Specifica se le istruzioni ALTER TABLE...SWITCH eseguite sul database pubblicato devono essere replicate ai Sottoscrittori. Questa opzione è valida solo se allow_partition_switch è impostato su 1.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

sp_helppublication viene utilizzato per la replica snapshot e transazionale.

sp_helppublication restituisce informazioni su tutte le pubblicazioni di proprietà dell'utente che esegue questa procedura.

Esempio

DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran' 

USE [AdventureWorks]
EXEC sp_helppublication @publication = @myTranPub
GO

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin nel server di pubblicazione o i membri del ruolo predefinito del database db_owner nel database di pubblicazione o gli utenti nell'elenco di accesso alla pubblicazione possono eseguire sp_helppublication.

Per server di pubblicazione non SQL Server, solo i membri del ruolo predefinito del server sysadmin nel server di distribuzione o i membri del ruolo predefinito del database db_owner nel database di distribuzione o gli utenti nell'elenco di accesso alla pubblicazione possono eseguire sp_helppublication.