sp_replmonitorhelpmergesession (Transact-SQL)

Restituisce informazioni sulle sessioni passate per un agente di merge specifico. Viene restituita una riga per ogni sessione che soddisfa i criteri del filtro. Questa stored procedure, utilizzata per il monitoraggio della replica di tipo merge, viene eseguita nel database di distribuzione del server di distribuzione o nel database di sottoscrizione del Sottoscrittore.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_replmonitorhelpmergesession [ [ @agent_name = ] 'agent_name' ]
    [ , [ @hours = ] hours ]
    [ , [ @session_type = ] session_type ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @publisher_db = ] 'publisher_db' ]
    [ , [ @publication = ] 'publication' ] 

Argomenti

• [ @agent_name = ] 'agent_name'
  Nome dell'agente. agent_name è di tipo nvarchar(100) e non prevede alcun valore predefinito.

• [ @hours = ] hours
  Intervallo di tempo, espresso in ore, per cui vengono restituite informazioni sulle sessioni passate dell'agente. hours è di tipo int. I possibili valori sono i seguenti.

  Valore	Descrizione
  < 0	Restituisce informazioni sulle esecuzioni passate dell'agente, per al massimo 100 esecuzioni.
  0 (predefinito)	Restituisce informazioni su tutte le esecuzioni passate dell'agente.
  > 0	Restituisce informazioni sulle esecuzioni dell'agente che hanno avuto luogo nel numero di ore specificato per hours.

• [ @session_type = ] session_type
  Filtra il set di risultati in base al risultato finale della sessione. session_type è di tipo int. I possibili valori sono i seguenti.

  Valore	Descrizione
  1 (predefinito)	Sessioni dell'agente con esito positivo o da ritentare.
  0	Sessioni dell'agente con esito negativo.

• [ @publisher = ] 'publisher'
  Nome del server di pubblicazione. publisher è di tipo sysname e il valore predefinito è NULL. Questo parametro viene utilizzato quando si esegue la stored procedure sp_replmonitorhelpmergesession nel Sottoscrittore.

• [ @publisher_db = ] 'publisher_db'
  Nome del database di pubblicazione. publisher_db è di tipo sysname e il valore predefinito è NULL. Questo parametro viene utilizzato quando si esegue la stored procedure sp_replmonitorhelpmergesession nel Sottoscrittore.

• [ @publication= ] 'publication'
  Nome della pubblicazione. publication è di tipo sysname e il valore predefinito è NULL. Questo parametro viene utilizzato quando si esegue la stored procedure sp_replmonitorhelpmergesession nel Sottoscrittore.

Set di risultati

Nome colonna	Tipo di dati	Descrizione
Session_id	int	ID della sessione del processo dell'agente.
Stato	int	Stato dell'esecuzione dell'agente: 1 = Avvio 2 = Completato 3 = In corso 4 = Inattivo 5 = Nuovo tentativo 6 = Esito negativo
StartTime	datetime	Data e ora di inizio della sessione del processo dell'agente.
EndTime	datetime	Data e ora di completamento della sessione del processo dell'agente.
Duration	int	Durata cumulativa, espressa in secondi, della sessione del processo.
UploadedCommands	int	Numero di comandi caricati durante la sessione dell'agente.
DownloadedCommands	int	Numero di comandi scaricati durante la sessione dell'agente.
ErrorMessages	int	Numero di messaggi di errore generati durante la sessione dell'agente.
ErrorID	int	ID dell'errore che si è verificato
PercentageDone	decimal	Percentuale stimata del numero totale di modifiche già recapitate in una sessione attiva.
TimeRemaining	int	Numero stimato di secondi rimanenti in una sessione attiva.
CurrentPhase	int	Fase corrente di una sessione attiva. I possibili valori sono i seguenti. 1 = Caricamento 2 = Download
LastMessage	nvarchar(500)	Ultimo messaggio registrato dall'agente di merge durante la sessione.

Osservazioni

La stored procedure sp_replmonitorhelpmergesession viene utilizzata per monitorare la replica di tipo merge.

Quando viene eseguita nel Sottoscrittore, sp_replmonitorhelpmergesession restituisce solo informazioni sulle ultime cinque sessioni dell'agente di merge.

Autorizzazioni

Solo i membri del ruolo predefinito del database db_owner o replmonitor nel database di distribuzione del server di distribuzione o nel database di sottoscrizione del Sottoscrittore possono eseguire la stored procedure sp_replmonitorhelpmergesession.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Vedere anche

Altre risorse

How to: Programmatically Monitor Replication (Replication Transact-SQL Programming)

Guida in linea e informazioni

Assistenza su SQL Server 2005