Condividi tramite


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 argomentoConvenzioni 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.

NotaNota
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.

Nota di attenzioneAttenzione
È 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.