sp_helppublication (Transact-SQL)

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

Restituisce informazioni su una pubblicazione. Per una pubblicazione di 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 di sintassi Transact-SQL

Sintassi

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

Argomenti

[ @publication = ] 'publication' Nome della pubblicazione da visualizzare. publication è sysname, con un valore predefinito , %che restituisce informazioni su tutte le pubblicazioni.

[ @found = ] 'found' OUTPUT Flag che indica la restituzione di righe. found è int e un parametro OUTPUT, con un valore predefinito 23456. 1 indica che la pubblicazione viene trovata. 0 indica che la pubblicazione non è stata trovata.

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

Nota

Non è necessario specificare publisher quando si richiedono informazioni sulla pubblicazione da un server di pubblicazione di 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.
stato	tinyint	Stato corrente della pubblicazione. 0 = Inattivo. 1 = Attivo.
attività		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 di copia bulk nativa (utilità bcp ) 1 = Copia bulk di caratteri 3 = Concurrent, il che significa che viene usata la copia bulk nativa (utilità bcp), ma le tabelle non sono bloccate durante lo snapshot 4 = Concurrent_c, il che significa che viene usata la copia bulk dei caratteri, ma le tabelle non vengono bloccate durante lo snapshot
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 la pubblicazione dispone di sottoscrizioni attive e 0 indica che la pubblicazione non dispone di sottoscrizioni.
allow_queued_tran	bit	Specifica se è abilitato o meno l'inserimento in coda delle modifiche apportate nel Sottoscrittore finché non è possibile applicarle al server di pubblicazione. Se 0, le modifiche nel Sottoscrittore non vengono accodate.
snapshot_in_defaultfolder	bit	Specifica se i file di snapshot sono archiviati nella cartella predefinita. Se 0, i file di snapshot sono stati archiviati nel percorso alternativo specificato 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 a un percorso di file con estensione sql . L'agente di distribuzione esegue lo script pre-snapshot prima dell'esecuzione di tutti gli script di oggetti replicati durante l'applicazione di uno snapshot in un Sottoscrittore.
post_snapshot_script	nvarchar(255)	Specifica un puntatore a un percorso di file con estensione sql . L'agente di distribuzione esegue lo script post-snapshot dopo l'applicazione di tutti gli altri dati e script di oggetti replicati durante una sincronizzazione iniziale.
compress_snapshot	bit	Specifica che lo snapshot scritto nel percorso di alt_snapshot_folder deve essere compresso nel formato CAB Microsoft. 0 specifica 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 supporta le trasformazioni di dati. 0 specifica che le trasformazioni DTS non sono consentite.
allow_subscription_copy	bit	Specifica se la funzionalità che consente di copiare i database di sottoscrizione che sottoscrivono la pubblicazione è abilitata. 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 in conflitto vengono archiviati sia nel server di pubblicazione che nel sottoscrittore che hanno causato il conflitto. 1 = I record in conflitto vengono archiviati nel server di pubblicazione.
conflict_retention	int	Specifica il periodo di memorizzazione dei conflitti, espresso in giorni.
conflict_policy	int	Specifica i criteri di risoluzione dei conflitti adottati quando viene utilizzata l'opzione per Sottoscrittori ad aggiornamento in coda. I possibili valori sono i seguenti: 1 = Il server di pubblicazione vince il conflitto. 2 = Il Sottoscrittore vince il conflitto. 3 = La sottoscrizione viene reinizializzata.
queue_type		Specifica il tipo di coda da utilizzare. I possibili valori sono i seguenti: msmq = Usare Accodamento messaggi Microsoft per archiviare le transazioni. sql = Usare SQL Server per archiviare le transazioni. Nota: il supporto per Accodamento messaggi non è più disponibile.
backward_comp_level		Livello di compatibilità del database. I possibili valori sono i seguenti: 90 = Microsoft SQL Server 2005 (9.x) 100 = Microsoft SQL Server 2008 (10.0.x)
publish_to_AD	bit	Specifica se la pubblicazione viene pubblicata in Microsoft Active Directory. Il valore 1 indica che viene pubblicato e il valore 0 indica che non è pubblicato.
allow_initialize_from_backup	bit	Specifica se i Sottoscrittori possono inizializzare una sottoscrizione di questa pubblicazione da un backup anziché da uno snapshot iniziale. 1 significa che le sottoscrizioni possono essere inizializzate da un backup e 0 significa che non possono. Per altre informazioni, vedere Inizializzare una sottoscrizione transazionale senza uno snapshot di un Sottoscrittore 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 e 0 indica che le istruzioni DDL non vengono replicate. Per altre informazioni, vedere Apportare 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 altre informazioni, vedere Peer-to-Peer Transactional Replication.
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 i Sottoscrittori non SQL Server sono supportati. Il valore 0 indica che sono supportati solo i Sottoscrittori di SQL Server. Per altre informazioni, vedere Non-SQL Server Subscribers.
enabled_for_p2p_conflictdetection	int	Specifica se l'Agente di Distribuzione rileva i conflitti per una pubblicazione abilitata per la replica peer-to-peer. Il valore 1 indica che vengono rilevati conflitti. Per altre informazioni, vedere Conflict Detection in Peer-to-Peer Replication.
originator_id	int	Specifica un ID per un nodo in una topologia peer-to-peer. Questo ID viene usato per il rilevamento dei conflitti se enabled_for_p2p_conflictdetection è impostato 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 usare il valore predefinito 0. Quando questa opzione è impostata su 1, l'agente di distribuzione tenta di convergere i dati nella topologia applicando la riga in conflitto dal nodo con l'ID origine più alto. 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 Conflict Detection in Peer-to-Peer Replication.
allow_partition_switch	int	Specifica se ALTER TABLE... Le istruzioni SWITCH possono essere eseguite sul database pubblicato. Per altre informazioni, vedere Replicare tabelle e indici partizionati.
replicate_partition_switch	int	Specifica se ALTER TABLE... Le istruzioni SWITCH eseguite sul database pubblicato devono essere replicate nei Sottoscrittori. Questa opzione è valida solo se allow_partition_switch è impostato su 1.
enabled_for_p2p_lastwriter_conflictdetection	int	A partire da SQL Server 2019 (15.x) CU 13, specifica se l'agente di distribuzione rileva i conflitti dell'ultimo writer per una pubblicazione abilitata per la replica peer-to-peer. Il valore 1 indica che vengono rilevati ultimi conflitti di scrittura.

Valori del codice restituito

0 (esito positivo) o 1 (errore)

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 [AdventureWorks2022]
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 un server di pubblicazione non SQL Server, solo i membri del ruolo predefinito del server sysadmin nel server di distribuzione o nei membri del ruolo predefinito del database db_owner nel database di distribuzione o gli utenti dell'elenco di accesso alla pubblicazione possono eseguire sp_helppublication.

Vedi anche

Visualizzare e modificare le proprietà della pubblicazione
sp_addpublication (Transact-SQL)
sp_changepublication (Transact-SQL)
sp_droppublication (Transact-SQL)
Stored procedure di replica (Transact-SQL)