sp_replmonitorhelpmergesession (Transact-SQL)

Si applica a:SQL Server Istanza gestita di SQL di Azure

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 di sintassi Transact-SQL

Sintassi

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

Argomenti

[ @agent_name = ] N'agent_name'

Nome dell'agente. @agent_name è nvarchar(100), senza impostazione predefinita.

[ @hours = ] ore

Intervallo di tempo, espresso in ore, per il quale vengono restituite le informazioni sulla sessione dell'agente cronologico. @hours è int e può essere uno degli intervalli 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 si sono verificate nell'ultimo numero di ore .

[ @session_type = ] session_type

Filtra il set di risultati in base al risultato finale della sessione. @session_type è int e può essere uno di questi valori.

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

[ @publisher = ] N'publisher'

Nome del server di pubblicazione. @publisher è sysname, con un valore predefinito .NULL Questo parametro viene utilizzato durante l'esecuzione sp_replmonitorhelpmergesession nel Sottoscrittore.

[ @publisher_db = ] N'publisher_db'

Nome del database di pubblicazione. @publisher_db è sysname, con il valore predefinito NULL. Questo parametro viene utilizzato durante l'esecuzione sp_replmonitorhelpmergesession nel Sottoscrittore.

[ @publication = ] N'publication'

Nome della pubblicazione. @publication è sysname, con il valore predefinito NULL. Questo parametro viene utilizzato durante l'esecuzione sp_replmonitorhelpmergesession nel Sottoscrittore.

Set di risultati

Nome colonna Tipo di dati Descrizione
Session_id int ID della sessione del processo dell'agente.
Status int Stato dell'esecuzione dell'agente:

1 = Inizio

2 = Operazione riuscita

3 = In corso

4 = Inattiva

5 = Riprovare

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 La fase corrente di una sessione attiva e può essere una delle seguenti.

1 = Caricamento

2 = Download
LastMessage nvarchar(500) Ultimo messaggio registrato da agente di merge durante la sessione.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

sp_replmonitorhelpmergesession viene usato per monitorare la replica di tipo merge.

Se eseguito nel Sottoscrittore, sp_replmonitorhelpmergesession restituisce solo informazioni sulle ultime cinque sessioni agente di merge.

Autorizzazioni

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