sp_helpmergepublication (Transact-SQL)

Si applica a: sìSQL Server (tutte le versioni supportate)

Vengono restituite informazioni su una pubblicazione di tipo merge. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.

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

Sintassi

  
sp_helpmergepublication [ [ @publication = ] 'publication' ]  
    [ , [ @found = ] 'found' OUTPUT ]  
    [ , [ @publication_id = ] 'publication_id' OUTPUT ]  
    [ , [ @reserved = ] 'reserved' ]  
    [ , [ @publisher = ] 'publisher' ]  
    [ , [ @publisher_db = ] 'publisher_db' ]  

Argomenti

[ @publication = ] 'publication'
Nome della pubblicazione. publication è di tipo sysname, con il valore predefinito % , che restituisce informazioni su tutte le pubblicazioni di tipo merge nel database corrente.

[ @found = ] ' trovato*'* OUTPUT
Flag che indica le righe che restituiscono valori. found è int e un parametro OUTPUT, con valore predefinito NULL. 1 indica che la pubblicazione è stata trovata. 0 indica che la pubblicazione non è stata trovata.

[ @publication_id = ] ' publication_id*'* OUTPUT
Numero di identificazione della pubblicazione. publication_id è uniqueidentifier e un parametro OUTPUT, con il valore predefinito NULL.

[ @reserved = ] 'reserved'
Identificato solo a scopo informativo. Non supportata. Non è garantita la compatibilità con le versioni future.reserved è di tipo nvarchar(20) e il valore predefinito è NULL.

[ @publisher = ] ' publisher*'*
Nome del server di pubblicazione. publisher è sysname e il valore predefinito è NULL.

[ @publisher_db = ] 'publisher_db'
Nome del database di pubblicazione. publisher_db è sysname, con il valore predefinito NULL.

Set di risultati

Nome colonna Tipo di dati Descrizione
id int Ordine sequenziale della pubblicazione nell'elenco del set di risultati.
name sysname Nome della pubblicazione.
description nvarchar(255) Descrizione della pubblicazione.
status tinyint Viene indicato quando i dati della pubblicazione sono disponibili.
retention int Tempo per salvare i metadati delle modifiche per gli articoli nella pubblicazione. Le unità per questo periodo di tempo possono essere giorni, settimane, mesi o anni. Per informazioni sulle unità, vedere la colonna retention_period_unit.
sync_mode tinyint Modalità di sincronizzazione della pubblicazione:

0 = Programma di copia bulk nativo (utilità bcp)

1 = Copia bulk di caratteri
allow_push int Determina se è possibile creare sottoscrizioni push per la pubblicazione specificata. 0 indica che una sottoscrizione push non è consentita.
allow_pull int Determina se è possibile creare sottoscrizioni pull per la pubblicazione specificata. 0 indica che una sottoscrizione pull non è consentita.
allow_anonymous int Determina se è possibile creare sottoscrizioni anonime per la pubblicazione specificata. 0 indica che non è consentita una sottoscrizione anonima.
centralized_conflicts int Viene determinato se i record dei conflitti vengono archiviati nel server di pubblicazione specificato:

0 = I record dei conflitti vengono archiviati sia nel server di pubblicazione che nel Sottoscrittore che ha causato il conflitto.

1 = tutti i record dei conflitti vengono archiviati nel Publisher.
priority float(8) Priorità della sottoscrizione di loopback.
snapshot_ready tinyint Viene indicato se lo snapshot della pubblicazione specificata è pronto:

0 = Lo snapshot è pronto per l'uso.

1 = Lo snapshot non è pronto per l'uso.
publication_type int Tipo di pubblicazione:

0 = Snapshot.

1 = Transazionale.

2 = Merge.
pubid uniqueidentifier Identificatore univoco della pubblicazione.
snapshot_jobid binary(16) ID di processo dell'agente snapshot. Per ottenere la voce per il processo snapshot nella tabella di sistema sysjobs, è necessario convertire questo valore esadecimale in uniqueidentifier.
enabled_for_internet int Viene determinato se la pubblicazione è abilitata per Internet. Se 1, i file di sincronizzazione per la pubblicazione vengono inseriti nella C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp directory . La directory FTP (File Transfer Protocol) deve essere creata dall'utente. Se 0, la pubblicazione non è abilitata per l'accesso a Internet.
dynamic_filter int Indica se viene utilizzato un filtro di riga con parametri. 0 indica che non viene utilizzato un filtro di riga con parametri.
has_subscription bit Indica se esistono sottoscrizioni della pubblicazione. 0 indica che attualmente non sono presenti sottoscrizioni per la pubblicazione.
snapshot_in_default_folder bit Viene specificato se i file di snapshot sono archiviati nella cartella predefinita.

Se 1, i file di snapshot sono disponibili nella cartella predefinita.

Se 0, i file di snapshot vengono archiviati nel percorso alternativo specificato da alt_snapshot_folder. Una posizione alternativa può essere un altro server, un'unità di rete oppure un supporto rimovibile, ad esempio un CD o un disco rimovibile. È inoltre possibile archiviare i file di snapshot in un sito FTP in modo che possano essere successivamente recuperati dal Sottoscrittore.

Nota: questo parametro può essere true e avere ancora una posizione nel alt_snapshot_folder parametro . Tale combinazione consente di specificare che i file di snapshot vengono archiviati sia nel percorso predefinito che in quello alternativo.
alt_snapshot_folder nvarchar(255) Specifica la posizione della cartella alternativa per lo snapshot.
pre_snapshot_script nvarchar(255) Specifica un puntatore a un file con estensione sql eseguito dal agente di merge prima di uno degli script dell'oggetto replicato quando si applica lo snapshot in un Sottoscrittore.
post_snapshot_script nvarchar(255) Specifica un puntatore a un file con estensione sql eseguito dal agente di merge dopo l'applicazione di tutti gli altri script e dati degli oggetti replicati durante una sincronizzazione iniziale.
compress_snapshot bit Specifica che lo snapshot scritto nel percorso alt_snapshot_folder viene compresso nel Microsoft formato CAB.
ftp_address sysname Indirizzo di rete del servizio FTP per il database di distribuzione. Viene specificata la posizione in cui i file di snapshot della pubblicazione possono essere prelevati dall'agente di merge.
ftp_port int Numero di porta del servizio FTP per il database di distribuzione. ftp_port ha un valore predefinito di 21. Viene specificata la posizione in cui i file di snapshot della pubblicazione possono essere prelevati dall'agente di merge.
ftp_subdirectory nvarchar(255) Viene specificata la posizione in cui i file di snapshot possono essere prelevati dall'agente di merge quando lo snapshot viene recapitato tramite FTP.
ftp_login sysname Nome utente utilizzato per la connessione al servizio FTP.
conflict_retention int Viene specificato il periodo di memorizzazione dei conflitti espresso in giorni. Al trascorrere del numero di giorni specificati, la riga in conflitto viene eliminata dalla tabella dei conflitti.
keep_partition_changes int Specifica se viene eseguita l'ottimizzazione della sincronizzazione per la pubblicazione specificata. keep_partition_changes ha un valore predefinito di 0. Il valore 0 indica che la sincronizzazione non è ottimizzata e che le partizioni inviate a tutti i Sottoscrittori vengono verificate quando i dati vengono modificato in una partizione.

1 indica che la sincronizzazione è ottimizzata e che sono interessati solo i Sottoscrittori che hanno righe nella partizione modificata.

Nota: per impostazione predefinita, le pubblicazioni di tipo merge utilizzano partizioni pre-ricalcolate, che forniscono un maggiore livello di ottimizzazione rispetto a questa opzione. Per altre informazioni, vedere Filtri di riga con parametri e Ottimizzare le prestazioni dei filtri con parametri con partizioni pre-ricalcolate.
allow_subscription_copy int Specifica se la funzionalità che consente di copiare i database di sottoscrizione che sottoscrivono la pubblicazione è abilitata. Il valore 0 indica che la copia non è consentita.
allow_synctoalternate int Viene specificato se è consentito l'utilizzo di un partner di sincronizzazione alternativo per la sincronizzazione con il server di pubblicazione. Il valore 0 indica che un partner di sincronizzazione non è consentito.
validate_subscriber_info nvarchar(500) Viene visualizzato un elenco delle funzioni utilizzate per il recupero delle informazioni sul Sottoscrittore e la convalida dei criteri per i filtri di riga con parametri nel Sottoscrittore. Inoltre, viene facilitata la verifica del partizionamento consistente delle informazioni a ogni operazione di unione.
backward_comp_level int Livello di compatibilità del database. I possibili valori sono i seguenti:

90 = SQL Server 2005 (9.x)

90 = SQL Server 2005 (9.x) SP1

90 = SQL Server 2005 (9.x) SP2

100 = SQL Server 2008
publish_to_activedirectory bit Specifica se le informazioni sulla pubblicazione sono pubblicate in Active Directory. Il valore 0 indica che le informazioni sulla pubblicazione non sono disponibili in Active Directory.

Questo parametro è deprecato ed è supportato solo per compatibilità con gli script di versioni precedenti. Non è più possibile aggiungere informazioni sulla pubblicazione in Active Directory.
max_concurrent_merge int Numero massimo di processi di merge simultanei. Se 0, non esiste alcun limite al numero di processi di merge simultanei in esecuzione in un determinato momento.
max_concurrent_dynamic_snapshots int Numero massimo di sessioni simultanee di snapshot dei dati filtrati eseguibili nella pubblicazione di tipo merge. Se 0, non esiste alcun limite al numero massimo di sessioni simultanee di snapshot dei dati filtrati che possono essere eseguite simultaneamente sulla pubblicazione in un determinato momento.
use_partition_groups int Viene determinato se vengono utilizzate partizioni precalcolate. Il valore 1 indica che vengono usate partizioni pre-ricalcolate.
num_of_articles int Numero di articoli nella pubblicazione.
replicate_ddl int Viene specificato se le modifiche dello schema apportate in tabelle pubblicate vengono replicate. Il valore 1 indica che le modifiche dello schema vengono replicate.
publication_number smallint Numero assegnato alla pubblicazione.
allow_subscriber_initiated_snapshot bit Viene determinato se il processo di generazione dello snapshot dei dati filtrati può essere avviato dai Sottoscrittori. Il valore 1 indica che i Sottoscrittori possono avviare il processo di snapshot.
allow_web_synchronization bit Viene determinato se la pubblicazione è abilitata per la sincronizzazione Web. Il valore 1 indica che la sincronizzazione Web è abilitata.
web_synchronization_url nvarchar(500) URL Internet utilizzato per la sincronizzazione Web.
allow_partition_realignment bit Viene determinato se le eliminazioni vengono inviate al Sottoscrittore quando la modifica apportata alla riga nel server di pubblicazione comporta un cambiamento di partizione. Il valore 1 indica che le eliminazioni vengono inviate al Sottoscrittore. Per altre informazioni, vedere sp_addmergepublication (Transact-SQL).
retention_period_unit tinyint Viene definita l'unità utilizzata per la definizione del periodo di memorizzazione. I valori possibili sono i seguenti:

0 = giorno

1 = Settimana

2 = Mese

3 = Anno
has_downloadonly_articles bit Specifica se la pubblicazione include articoli di solo download. Il valore 1 indica che sono presenti articoli di solo download.
decentralized_conflicts int Viene specificato se i record dei conflitti vengono archiviati nel Sottoscrittore a causa dei quali si è verificato il conflitto. Il valore 0 indica che i record dei conflitti non vengono archiviati nel Sottoscrittore. Il valore 1 indica che i record dei conflitti vengono archiviati nel Sottoscrittore.
generation_leveling_threshold int Viene specificato il numero di modifiche contenute in una generazione. Una generazione è una raccolta di modifiche recapitate a un server di pubblicazione o a un Sottoscrittore
automatic_reinitialization_policy bit Indica se le modifiche vengono caricate dal Sottoscrittore prima di una reinizializzazione automatica. Il valore 1 indica che le modifiche vengono caricate dal Sottoscrittore prima che venga eseguita una reinizializzazione automatica. Il valore 0 indica che le modifiche non vengono caricate dal Sottoscrittore prima di una reinizializzazione automatica.

Valori del codice restituito

0 (esito positivo) o 1 (esito negativo)

Commenti

sp_helpmergepublication viene utilizzata per la replica di tipo merge.

Autorizzazioni

I membri dell'elenco di accesso a una pubblicazione possono eseguire sp_helpmergepublication per tale pubblicazione. I membri del ruolo predefinito del database db_owner nel database di pubblicazione possono eseguire sp_helpmergepublication per ottenere informazioni su tutte le pubblicazioni.

Esempio

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

USE [AdventureWorks2012]
EXEC sp_helpmergepublication @publication = @publication;
GO

Vedere anche

Visualizzare e modificare le proprietà della pubblicazione
sp_addmergepublication (Transact-SQL)
sp_changemergepublication (Transact-SQL)
sp_dropmergepublication (Transact-SQL)
Stored procedure per la replica (Transact-SQL)