Condividi tramite


sp_helpmergepublication (Transact-SQL)

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 e il valore predefinito è %; vengono restituite informazioni su tutte le pubblicazioni di tipo merge nel database corrente.

  • [ @found**=** ] 'found' OUTPUT
    Flag che indica le righe che restituiscono valori. foundè di tipo int, è un parametro OUTPUT e il valore predefinito è NULL. 1 indica che la pubblicazione è stata individuata. 0 indica che la pubblicazione non è stata individuata.

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

  • [ @reserved**=**\] 'reserved'
    Identificato solo a scopo informativo. Non supportato. 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 è di tipo sysname e il valore predefinito è NULL.

  • [@publisher_db**=** ] 'publisher_db'
    Nome del database di pubblicazione. publisher_db è di tipo sysname e 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 per la copia bulk (utilità bcp ) in modalità nativa

1 = copia bulk in modalità carattere

allow_push

int

Determina se è possibile creare sottoscrizioni push per la pubblicazione specificata. 0 indica che non sono consentite sottoscrizioni push.

allow_pull

int

Determina se è possibile creare sottoscrizioni pull per la pubblicazione specificata. 0 indica che non sono consentite sottoscrizioni pull.

allow_anonymous

int

Determina se è possibile creare sottoscrizioni anonime per la pubblicazione specificata. 0 indica che non sono consentite sottoscrizioni anonime.

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 sia nel Sottoscrittore a causa dei quali si è verificato il conflitto.

1 = tutti i record dei conflitti vengono archiviati nel server di pubblicazione.

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'utilizzo.

1 = lo snapshot non è pronto per l'utilizzo.

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 relativa al processo di snapshot archiviata nella tabella di sistema sysjobs, è necessario convertire questo valore esadecimale in un valore di tipo uniqueidentifier.

enabled_for_internet

int

Viene determinato se la pubblicazione è abilitata per Internet. Se il valore è 1, i file di sincronizzazione della pubblicazione vengono inseriti nella directory C:\Program Files\Microsoft SQL Server\MSSQL\Repldata\Ftp. La directory FTP (File Transfer Protocol) deve essere creata dall'utente. Se il valore è 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.

has_subscription

bit

Indica se esistono sottoscrizioni della pubblicazione. 0 indica che attualmente non esistono.

snapshot_in_default_folder

bit

Viene specificato se i file di snapshot sono archiviati nella cartella predefinita.

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

Se il valore è 0, i file di snapshot sono archiviati nella posizione alternativa specificata 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 anche quando è stata specificata una posizione nel parametro alt_snapshot_folder. 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)

Viene specificato il percorso della cartella alternativa per lo snapshot.

pre_snapshot_script

nvarchar(255)

Viene specificato un puntatore a un file con estensione .sql che viene eseguito dall'agente di merge prima dell'esecuzione degli script di oggetti replicati in fase di applicazione dello snapshot in un Sottoscrittore.

post_snapshot_script

nvarchar(255)

Viene specificato un puntatore a un file con estensione .sql che viene eseguito dall'agente di merge dopo l'applicazione di tutti gli altri script di oggetti replicati e dei dati durante una sincronizzazione iniziale.

compress_snapshot

bit

Viene specificato che lo snapshot scritto nella posizione indicata da alt_snapshot_folder viene compresso nel formato Microsoft CAB.

ftp_address

sysname

Indirizzo di rete del servizio FTP per il server 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 server di distribuzione. Il valore predefinito di ftp_port è 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. Il valore predefinito di keep_partition_changes è 0. Il valore 0 indica che la sincronizzazione non viene ottimizzata e che quando vengono apportate modifiche ai dati in una partizione vengono verificate le partizioni inviate a tutti i Sottoscrittori.

1 indica che la sincronizzazione viene ottimizzata e che l'operazione ha effetto solo sui Sottoscrittori che contengono righe nella partizione modificata.

[!NOTA]

Per impostazione predefinita, nelle pubblicazioni di tipo merge vengono utilizzate partizioni precalcolate tramite cui viene garantito un livello di ottimizzazione maggiore rispetto a questa opzione. Per ulteriori informazioni, vedere Filtri di riga con parametri e Ottimizzazione delle prestazioni dei filtri con parametri con le partizioni pre-calcolate.

allow_subscription_copy

int

Viene specificato se la funzionalità che consente di copiare i database di sottoscrizione tramite cui viene sottoscritta 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 non è consentito l'utilizzo di un partner di sincronizzazione.

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 

90 = SQL Server 2005 SP1

90 = SQL Server 2005 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 il valore è 0, non esiste alcuna limitazione al numero di processi di merge eseguibili contemporaneamente.

max_concurrent_dynamic_snapshots

int

Numero massimo di sessioni simultanee di snapshot dei dati filtrati eseguibili nella pubblicazione di tipo merge. Se il valore è 0, non esiste alcuna limitazione relativamente al numero di sessioni di snapshot dei dati filtrati eseguibili contemporaneamente nella pubblicazione.

use_partition_groups

int

Viene determinato se vengono utilizzate partizioni precalcolate. Il valore 1 indica che vengono utilizzate partizioni precalcolate.

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 il processo di snapshot può essere avviato dai Sottoscrittori.

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 ulteriori 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 esistono 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 di una reinizializzazione automatica. Il valore 0 indica che le modifiche non vengono caricate dal Sottoscrittore prima di una reinizializzazione automatica.

Valori di codice restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

sp_helpmergepublication viene utilizzata per la replica di tipo merge.

Autorizzazioni

Tramite i membri dell'elenco di accesso a una pubblicazione è possibile eseguire sp_helpmergepublication per tale pubblicazione. Tramite i membri del ruolo predefinito del database db_owner nel database di pubblicazione è possibile 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

Riferimento

sp_addmergepublication (Transact-SQL)

sp_changemergepublication (Transact-SQL)

sp_dropmergepublication (Transact-SQL)

Stored procedure per la replica (Transact-SQL)

Concetti

Visualizzazione e modifica delle proprietà della pubblicazione