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 relative alla 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 = Inizio2 = Operazione riuscita3 = In corso4 = Inattiva5 = Riprovare6 = 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 = Caricamento2 = 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
.