Коды события SQL Trace

#define SQLITE_TRACE_STMT       0x01
#define SQLITE_TRACE_PROFILE    0x02
#define SQLITE_TRACE_ROW        0x04
#define SQLITE_TRACE_CLOSE      0x08

Эти константы определяют классы событий, которые могут следить за развитием, используя sqlite3_trace_v2(). Аргумент M в sqlite3_trace_v2(D,M,X,P) это OR-комбинация одной или больше следующих констант. Первый аргумент отзыва трассировки это одна из следующих констант.

Новые поисковые константы могут быть добавлены в будущих выпусках.

У отзыва есть четыре аргумента: xCallback(T,C,P,X). Аргумент T это один из кодов целого типа выше. Аргумент C это копия указателя контекста, переданного как четвертый аргумент sqlite3_trace_v2(). Аргументы P и X это указатели, значения которых зависят от T.

SQLITE_TRACE_STMT

Отзыв SQLITE_TRACE_STMT вызван, когда подготовленный запрос сначала начинает работать и возможно в других случаях во время выполнения подготовленного запроса, например, в начале каждого триггера. Аргумент P это указатель на подготовленный запрос. Аргумент X это указатель на последовательность, которая является нерасширенным кодом SQL подготовленного запроса или комментария SQL, который указывает на вызов триггера. Отзыв может вычислить тот же самый текст, который был бы возвращен sqlite3_trace() при помощи аргумента X, когда X начинается с "--", иначе вызывает sqlite3_expanded_sql(P).

SQLITE_TRACE_PROFILE

Отзыв SQLITE_TRACE_PROFILE предоставляет приблизительно ту же самую информацию, как обеспечивается sqlite3_profile(). Аргумент P это указатель на подготовленный запрос, аргумент X указывает на 64-bit integer, которое является приблизительным числом наносекунд, которые подготовленный запрос работал. Отзыв SQLITE_TRACE_PROFILE вызван, когда запрос заканчивается.

SQLITE_TRACE_ROW

Отзыв SQLITE_TRACE_ROW вызван каждый раз, когда подготовленный запрос производит единственную строку результата. Аргумент P это указатель на подготовленный запрос, аргумент X не использован.

SQLITE_TRACE_CLOSE

Отзыв SQLITE_TRACE_CLOSE вызван, когда соединение с базой данных закрывается. Аргумент P это указатель на подготовленный запрос, аргумент X не использован.