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.
.gif "Icona di collegamento a un argomento")
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)