sp_helpmergepublication (Transact-SQL)
Data aggiornamento: 12 dicembre 2006
Restituisce informazioni su una pubblicazione di tipo merge. Questa stored procedure viene eseguita nel database di pubblicazione del server di pubblicazione.
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 è %, che restituisce 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'
Riservato per utilizzi futuri. 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
Specifica quando i dati della pubblicazione sono disponibili.
retention
int
Quantità di modifiche, espresse in giorni, da salvare per la pubblicazione specificata.
sync_mode
tinyint
Modalità di sincronizzazione della pubblicazione:
0 = Programma per la copia di massa (utilità bcp) in modalità nativa
1 = Copia di massa in modalità carattere
allow_push
int
Specifica se è consentito creare sottoscrizioni push per la pubblicazione specificata. 0 indica che tali sottoscrizioni non sono supportate.
allow_pull
int
Specifica se è consentito creare sottoscrizioni pull per la pubblicazione specificata. 0 indica che tali sottoscrizioni non sono supportate.
allow_anonymous
int
Specifica se è consentito creare sottoscrizioni anonime per la pubblicazione specificata. 0 indica che tali sottoscrizioni non sono supportate.
centralized_conflicts
int
Specifica 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 che ha causato 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
Specifica 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
Specifica se la pubblicazione è abilitata per Internet. Se è 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 è 0, la pubblicazione non è abilitata per Internet.
dynamic_filter
int
Specifica se viene utilizzato un filtro di riga con parametri. 0 indica che non viene utilizzato un filtro di riga con parametri.
has_subscription
bit
Specifica se esistono sottoscrizioni della pubblicazione. 0 indica che attualmente non esistono sottoscrizioni della pubblicazione.
snapshot_in_default_folder
bit
Specifica 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 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 indica che i file di snapshot vengono archiviati sia nella posizione predefinita che in quella alternativa.
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 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)
Specifica 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
Specifica 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. Specifica 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. Specifica la posizione in cui i file di snapshot della pubblicazione possono essere prelevati dall'agente di merge.
ftp_subdirectory
nvarchar(255)
Specifica 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
Specifica 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.
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 contenenti righe nella partizione modificata.
Nota:
Per impostazione predefinita, le pubblicazioni di tipo merge utilizzano partizioni pre-calcolate, che garantiscono 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
Specifica se è stata attivata la funzione di copia dei database di sottoscrizione che sottoscrivono la pubblicazione. 0 indica che la copia non è consentita.
allow_synctoalternate
int
Specifica se è consentito l'utilizzo di un partner di sincronizzazione alternativo per la sincronizzazione con il server di pubblicazione. 0 indica che non è consentito l'utilizzo di un partner di sincronizzazione.
validate_subscriber_info
nvarchar(500)
Visualizza 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. Facilita la verifica del partizionamento consistente delle informazioni a ogni operazione di merge.
backward_comp_level
int
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_activedirectory
bit
Specifica se le informazioni della pubblicazione sono pubblicate in Microsoft Active Directory. 0 indica che le informazioni della pubblicazione non sono disponibili in Active Directory.
Questo parametro è obsoleto ed è supportato solo per compatibilità con gli script di versioni precedenti. Non è più possibile aggiungere informazioni di pubblicazione in Microsoft Active Directory.
max_concurrent_merge
int
Numero massimo di processi di merge simultanei. Il valore 0 indica che non esiste alcuna limitazione per il 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 è 0, non esiste alcuna limitazione per il numero di sessioni di snapshot dei dati filtrati eseguibili contemporaneamente nella pubblicazione.
use_partition_groups
int
Specifica se vengono utilizzate partizioni pre-calcolate. 1 indica che vengono utilizzate partizioni pre-calcolate.
num_of_articles
int
Numero di articoli nella pubblicazione.
replicate_ddl
int
Specifica se le modifiche dello schema apportate in tabelle pubblicate vengono replicate. 1 indica che le modifiche dello schema vengono replicate.
publication_number
smallint
Numero assegnato alla pubblicazione.
allow_subscriber_initiated_snapshot
bit
Specifica se i Sottoscrittori possono avviare il processo di generazione dello snapshot dei dati filtrati. 1 indica che i Sottoscrittori possono avviare il processo di snapshot.
allow_web_synchronization
bit
Specifica se la pubblicazione è abilitata per la sincronizzazione tramite il Web. 1 indica che la sincronizzazione tramite il Web è attivata.
web_synchronization_url
nvarchar(500)
URL Internet utilizzato per la sincronizzazione tramite il Web.
allow_partition_realignment
bit
Specifica se le eliminazioni vengono inviate al Sottoscrittore quando la modifica apportata alla riga nel server di pubblicazione comporta un cambiamento di partizione.
1 indica che le eliminazioni vengono inviate al Sottoscrittore.
0 indica che le eliminazioni non vengono inviate. Per ulteriori informazioni, vedere sp_addmergepublication
retention_period_unit
tinyint
Definisce l'unità utilizzata per la definizione del periodo di memorizzazione. I possibili valori sono i seguenti:
0 = giorno
1 = settimana
2 = mese
3 = anno
has_downloadonly_articles
bit
Specifica se la pubblicazione include articoli di tipo solo download. Il valore 1 indica che esistono articoli di tipo solo download.
decentralized_conflicts
int
Specifica se i record dei conflitti vengono archiviati nel Sottoscrittore che ha causato il conflitto:
0 = I record dei conflitti non vengono archiviati nel Sottoscrittore.
1 = I record dei conflitti vengono archiviati nel Sottoscrittore.
generation_leveling_threshold
int
Specifica il numero di modifiche contenute in una generazione. Una generazione è un insieme di modifiche recapitate a un server di pubblicazione o a un Sottoscrittore. Per ulteriori informazioni, vedere Come la replica di tipo merge rileva ed enumera le modifiche.
automatic_reinitialization_policy
bit
Specifica se le modifiche vengono caricate dal Sottoscrittore prima di una reinizializzazione automatica.
1 = le modifiche vengono caricate dal Sottoscrittore prima di una reinizializzazione automatica.
0 = le modifiche non vengono caricate prima di una reinizializzazione automatica.
Osservazioni
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.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Esempio
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
USE [AdventureWorks]
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)
Altre risorse
How to: View and Modify Publication Properties (Replication Transact-SQL Programming)
Guida in linea e informazioni
Cronologia modifiche
Versione | Cronologia |
---|---|
12 dicembre 2006 |
|