Metoda EnumDistributionAgentSessionDetails2
Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.
EnumDistributionAgentSessionDetails2 Metoda zwraca QueryResults obiekt, który wylicza szczegółowych informacji o określonej sesja agenta dystrybucji.
Składnia
object
.EnumDistributionAgentSessionDetails2(
AgentName
,
SessionID
,
lEstimatedNumRecords
)
as
QueryResults
Części
obiekt
Wyrażenie, którego wartością obiekt na liście dotyczy.AgentName
Ciąg, który identyfikuje sesja agenta dystrybutora według nazwy.Identyfikator sesji
Ciąg, który identyfikuje sesja.SessionID jest określona przy użyciu znaków najpierw 21 time wartość kolumna w QueryResults zestaw wyników zwróconych przez EnumDistributionAgentSessions2 metoda.lEstimatedNumRecords
Długa liczba całkowita, która określa szacunkową liczbę QueryResults wierszy do zwrotu.
Prototyp (C/C++)
HRESULT EnumDistributionAgentSessionDetails2(
SQLDMO_LPCSTR AgentName,
SQLDMO_LPCSTR SessionID,
long lEstimatedNumRecords,
LPSQLDMOQUERYRESULTS* ppResults);
Zwraca
A QueryResults obiekt, który zawiera jeden zestaw wyników, określonych przez te kolumny.
Kolumna |
Typ danych |
Opis |
|---|---|---|
reserved |
integer |
Określone tylko w celach informacyjnych. Nieobsługiwane. Przyszła zgodność nie jest gwarantowana..Always returns 0. |
average_commands |
integer |
Średnia liczba poleceń na transakcję wydana w sesja. |
comments |
nvarchar(256) |
Tekst opisowy. |
delivered_/commands |
integer |
Skumulowana liczba poleceń dostarczonych w sesja. |
delivered_/transactions |
integer |
Skumulowana liczba transakcji wydana w sesja. |
delivery_latency |
integer |
Czas oczekiwania w milisekundach, pomiędzy wprowadzania transakcji baza danych dystrybucji oraz są stosowane do subskrybenta. |
delivery_rate |
float |
Średnia liczba poleceń wydana na sekundę. |
duration |
integer |
Upłynęło czas aktywności sesja zarejestrowane w sekundach. |
error_id |
integer |
Gdy niezerową, numer komunikatu błędu Microsoft SQL Server. |
runstatus |
integer |
Państwa wykonującego.Interpretować za pomocą SQLDMO_TASKSTATUS_TYPE. |
time |
nvarchar(26) |
Czas rejestrowania szczegółów sesja. |
Uwagi
In the result set, date and time data returned in timeis formatted as YYYYMMDD hh:mm:ss.fff.
Część daty |
Opis |
|---|---|
RRRR |
Reprezentuje rok cztery cyfry. |
MM |
Reprezentuje miesiąc dwiema cyframi (wyściełane zero). |
DD |
Reprezentuje dzień miesiąca w dwie cyfry (zero wyściełane). |
hh |
Reprezentuje godzinę za pomocą dwóch cyfr zegara 24-godzinnego (wyściełane zero). |
mm |
Reprezentuje minuty w dwie cyfry (zero wyściełane). |
ss |
Reprezentuje drugi w dwie cyfry (zero wyściełane). |
fff |
Reprezentuje część ułamkowa drugi w trzech cyfr. |
Na przykład 18:12:00.000 20040512 wartość jest interpretowana jako 6:12 P.M., dnia 12 maja 2004 r.
EnumDistributionAgentSessionDetails2 Metoda różni się od EnumDistributionAgentSessionDetails metody włącznie z lEstimatedNumRecords parametr, który pozwala aplikacjom przekazywanie szacunkową liczbę QueryResults wierszy.Umożliwia aplikacji uniknąć wydajności, obciążenie związane z wielokrotnie przydzielania i zwalniania pamięci.