Metoda EnumQueueReaderAgentSessions
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.
EnumQueueReaderAgentSessions Metoda zwraca QueryResults obiekt, który wylicza wykonanie stan danych o sesjach kolejki czytnik Agent działający na określonej publikacja.
Składnia
object
.EnumQueueReaderAgentSessions(
lPublicationID
,
SessionType
,
SessionDuration
,
lEstimatedNumRecords
)
as
QueryResults
Części
obiekt
Wyrażenie, którego wartością obiekt na liście dotyczy.lPublicationID
Liczba całkowita długa, identyfikujący publikacja przez identyfikator.SessionType
Stała SQLDMO_SESSION_TYPE, która wskazuje typ sesja, jak opisano w ustawieniach.SessionDuration
Długa liczba całkowita określająca liczbę godzin.Ogranicza członkostwo zestaw wyników tymi sesjami rozpoczętej w ramach określonej liczby godzin.Użycie 0, aby określić czas rozpoczęcia sesja agenta bez ograniczeń.lEstimatedNumRecords
Długa liczba całkowita, która określa szacunkową liczbę QueryResults wierszy do zwrotu.
Prototyp (C/C++)
HRESULT EnumQueueReaderAgentSessions(
long lPublicationID,
SQLDMO_SESSION_TYPE SessionType,
long SessionDuration,
long lEstimatedNumRecords,
LPSQLDMOQUERYRESULTS *ppResults);
Ustawienia
Ustaw SessionType za pomocą tych wartości.
Stała |
Wartość |
Opis |
|---|---|---|
SQLDMOSession_All |
1 |
Dane wyjściowe zawierają informacje dziennika dla wszystkich sesji agenta. |
SQLDMOSession_Errors |
2 |
Dane wyjściowe zawierają informacje dziennika tylko dla tych prób wykonanie kończy się błędem. |
Zwraca
A QueryResults obiekt, który zawiera jeden zestaw wyników, określonych przez te kolumny.
Kolumna |
Typ danych |
Opis |
|---|---|---|
action_count |
integer |
Całkowita liczba sesja szczegółów. |
average_commands |
integer |
Średnia liczba poleceń. |
commands_processed |
integer |
Skumulowana liczba poleceń przetwarzane w sesja. |
comments |
nvarchar(255) |
Tekst opisowy. |
delivery_latency |
integer |
Czas oczekiwania w milisekundach, pomiędzy transakcji wprowadzanie kolejki i jest stosowany do Wydawca. |
delivery_rate |
integer |
Średnia liczba poleceń wydana na sekundę. |
duration |
integer |
Upłynęło czas aktywności sesja zarejestrowane w sekundach. |
error_id |
integer |
Niezerowa, oznacza numer komunikatu błędu Microsoft SQL Server. |
publication_id |
integer |
Identyfikator publikacji. |
start_time |
nvarchar(24) |
Data i czas na sesja agenta, którego uruchomiona. |
status |
integer |
Stan kolejki agenta czytnika. |
time |
nvarchar(24) |
Data i czas ostatniej rejestrowany komunikat. |
transactions_processed |
integer |
Skumulowana liczba transakcji przetwarzane w sesja. |
Uwagi
zestaw wyników, Data i czas danych zwracanych w start_time i time są sformatowane jako hh:mm:ss.fff RRRRMMDD.
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.
EnumQueueReaderAgentSessions Metoda zawiera 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.
Ostrzeżenie
If an application calls EnumQueueReaderAgentSessionson an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000 or later" are returned.