Параметры статуса для соединений с базой данных

#define SQLITE_DBSTATUS_LOOKASIDE_USED       0
#define SQLITE_DBSTATUS_CACHE_USED           1
#define SQLITE_DBSTATUS_SCHEMA_USED          2
#define SQLITE_DBSTATUS_STMT_USED            3
#define SQLITE_DBSTATUS_LOOKASIDE_HIT        4
#define SQLITE_DBSTATUS_LOOKASIDE_MISS_SIZE  5
#define SQLITE_DBSTATUS_LOOKASIDE_MISS_FULL  6
#define SQLITE_DBSTATUS_CACHE_HIT            7
#define SQLITE_DBSTATUS_CACHE_MISS           8
#define SQLITE_DBSTATUS_CACHE_WRITE          9
#define SQLITE_DBSTATUS_DEFERRED_FKS        10
#define SQLITE_DBSTATUS_CACHE_USED_SHARED   11
#define SQLITE_DBSTATUS_CACHE_SPILL         12
#define SQLITE_DBSTATUS_MAX                 12   /* Largest defined DBSTATUS */

Эти константы доступное целое число, которое может быть передано как второй аргумент sqlite3_db_status().

Новые могут быть добавлены в будущих выпусках SQLite. Могли бы быть удалены существующие. Запросы должны проверить код возврата от sqlite3_db_status(), чтобы удостовериться, что запрос работал. sqlite3_db_status() возвратит код ошибки отличный от нуля, если неподдержанное значение будет вызвано.

SQLITE_DBSTATUS_LOOKASIDE_USED

Этот параметр возвращает количество сохраняющих мест памяти, в настоящее время проверяемых.

SQLITE_DBSTATUS_LOOKASIDE_HIT

Этот параметр возвращает количество попыток malloc, которые были удовлетворены, используя сохраняющую память. Только верхнее значение важно, текущее значение всегда ноль.

SQLITE_DBSTATUS_LOOKASIDE_MISS_SIZE

Этот параметр возвращает число попыток malloc, которые, возможно, были бы удовлетворены, используя сохраняющую память, но запросили больше, чем размер слота. Только верхнее значение важно, текущее значение всегда ноль.

SQLITE_DBSTATUS_LOOKASIDE_MISS_FULL

Этот параметр возвращает число попыток malloc, которые, возможно, были бы удовлетворены, используя сохраняющую память, но вся эта память была уже занята. Только верхнее значение важно, текущее значение всегда ноль.

SQLITE_DBSTATUS_CACHE_USED

Этот параметр возвращает приблизительное количество байтов памяти кучи, используемой всеми кэшами страниц, связанными с соединением с базой данных. Высшая точка, связанная с SQLITE_DBSTATUS_CACHE_USED, всегда 0.

SQLITE_DBSTATUS_CACHE_USED_SHARED

Этот параметр подобен DBSTATUS_CACHE_USED, за исключением того, что, если кэш страниц разделяется между двумя или больше связями, байты памяти кучи, используемой тем кэшом страниц, разделены равномерно между связями. Другими словами, если ни один из кэшов страниц, связанных с соединением с базой данных, не разделяется, этот запрос возвращает то же самую значение, как DBSTATUS_CACHE_USED. Или, если один или больше или кэши страниц будут разделены, значение, возвращенное этим запросом, будет меньше, чем возвращенное DBSTATUS_CACHE_USED. Высшая точка, связанная с SQLITE_DBSTATUS_CACHE_USED_SHARED, всегда 0.

SQLITE_DBSTATUS_SCHEMA_USED

Этот параметр возвращает приблизительное количество байтов памяти кучи для хранения схемы для всех баз данных, связанных со связью, main, temp и любые ATTACH-БД. О полном объеме памяти, используемой схемами, сообщают, даже если память схемы разделена с другими соединениями с базой данных из-за включенного общего режима кэширования. Высшая точка, связанная с SQLITE_DBSTATUS_SCHEMA_USED, всегда 0.

SQLITE_DBSTATUS_STMT_USED

Этот параметр возвращает приблизительное количество байтов кучи и сохраняющей памяти, используемой всеми подготовленными запросами, связанными с соединением с базой данных. Высшая точка, связанная с SQLITE_DBSTATUS_STMT_USED, всегда 0.

SQLITE_DBSTATUS_CACHE_HIT

Этот параметр возвращает количество удачных обращений в кэш страниц, которые произошли. Высшая точка, связанная с SQLITE_DBSTATUS_CACHE_HIT, всегда 0.

SQLITE_DBSTATUS_CACHE_MISS

Этот параметр возвращает количество неудачных обращений в кэш страниц, которые произошли. Высшая точка, связанная с SQLITE_DBSTATUS_CACHE_MISS, всегда 0.

SQLITE_DBSTATUS_CACHE_WRITE

Этот параметр возвращает количество грязных записей кэша, которые были написаны на диск. Определенно, число страниц, написанных wal-файлу в базах данных wal-режима или число страниц, написанных файлу базы данных в базах данных режима обратной перемотки. Любые страницы, записанные как часть отката транзакции или операций по восстановлению базы данных, не включены. Если IO или другая ошибка происходят при записи страниц на диск, эффект последующих запросов SQLITE_DBSTATUS_CACHE_WRITE не определен. Высшая точка, связанная с SQLITE_DBSTATUS_CACHE_WRITE, всегда 0.

SQLITE_DBSTATUS_CACHE_SPILL

Этот параметр возвращает количество грязных записей кэша, которые были написаны посреди транзакции из-за переполнения кэша страницы. Транзакции более эффективны, если они написаны после окончания. Когда страницы переполняют середину транзакции, это вводит дополнительные издержки. Этот параметр может использоваться, чтобы определить неэффективность, которая может быть решена, увеличив размер кэша.

SQLITE_DBSTATUS_DEFERRED_FKS

Этот параметр возвращает ноль для текущего значения если и только если все ограничения внешнего ключа (отсроченные или немедленные) были решены. Высшая точка всегда 0.