sp_helppublication (Transact-SQL)
Restituisce informazioni su una pubblicazione. Per una pubblicazione Microsoft SQL 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.
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 e il 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 e il 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
Riservata per utilizzi futuri.
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 di massa (utilità bcp) in modalità nativa
1 = Copia di massa in modalità carattere
3 = Simultanea, ovvero viene utilizzata la copia di massa (utilità bcp) in modalità nativa, ma durante lo snapshot le tabelle non vengono bloccate
4 = Concurrent_c, ovvero viene utilizzata la copia di massa 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 = Microsoft SQL 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 = Microsoft SQL Server 2000
50 = SQL Server 2000 Service Pack 1
60 = SQL Server 2000 Service Pack 3
90 = Microsoft SQL Server 2005
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
Solo per uso interno.
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.
Osservazioni
sp_helppublication viene utilizzata per la replica snapshot e transazionale.
sp_helppublication restituisce informazioni su tutte le pubblicazioni di proprietà dell'utente che esegue questa procedura.
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.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Esempio
DECLARE @myTranPub AS sysname
SET @myTranPub = N'AdvWorksProductTran'
USE [AdventureWorks]
EXEC sp_helppublication @publication = @myTranPub
GO
Vedere anche
Riferimento
sp_addpublication (Transact-SQL)
sp_changepublication (Transact-SQL)
sp_droppublication (Transact-SQL)
Stored procedure per la replica (Transact-SQL)
Altre risorse
How to: View and Modify Publication Properties (Replication Transact-SQL Programming)