Condividi tramite


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.

Icona di collegamento a un argomentoConvenzioni 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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

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.