Parámetros de estado para conexiones de base de datos
#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 */
Estas constantes son los "verbos" enteros disponibles que pueden pasarse como segundo argumento a la interfaz interfaz sqlite3_db_status().
Es posible que en futuras versiones de SQLite se añadan nuevos verbos. Los verbos existentes pueden ser descontinuados. Las aplicaciones deben comprobar el código de retorno de sqlite3_db_status() para asegurarse de que la llamada ha funcionado. La interfaz sqlite3_db_status() devolverá un código de error distinto de cero si se invoca un verbo discontinuado o no soportado.
- SQLITE_DBSTATUS_LOOKASIDE_USED
- Este parámetro devuelve el número de ranuras de memoria lookaside actualmente retiradas.
- SQLITE_DBSTATUS_LOOKASIDE_HIT
- Este parámetro devuelve el número de intentos de malloc que fueron satisfechos usando memoria lookaside. Sólo el valor máximo es significativo; el valor actual es siempre cero.
- SQLITE_DBSTATUS_LOOKASIDE_MISS_SIZE
- Este parámetro devuelve el número de intentos de malloc que podrían haber sido satisfechos usando memoria lookaside pero que fallaron debido a que la cantidad de memoria solicitada era mayor que el tamaño del slot lookaside. Sólo el valor máximo es significativo; el valor actual es siempre cero.
- SQLITE_DBSTATUS_LOOKASIDE_MISS_FULL
- Este parámetro devuelve el número de intentos de malloc que podrían haber sido satisfechos usando memoria lookaside pero que fallaron debido a que toda la memoria lookaside ya estaba en uso. Sólo el valor máximo es significativo; el valor actual es siempre cero.
- SQLITE_DBSTATUS_CACHE_USED
- Este parámetro devuelve el número aproximado de bytes de memoria heap utilizados por todas las cachés de buscapersonas asociadas con la conexión a la base de datos. La marca de agua alta asociada con SQLITE_DBSTATUS_CACHE_USED es siempre 0.
- SQLITE_DBSTATUS_CACHE_USED_SHARED
- Este parámetro es similar a DBSTATUS_CACHE_USED, excepto que si una caché de paginador se comparte entre dos o más conexiones, los bytes de memoria heap utilizados por esa caché de paginador se dividen equitativamente entre las conexiones adjuntas. En otras palabras, si ninguna de las cachés de paginador asociadas a la conexión de base de datos está compartida, esta petición devuelve el mismo valor que DBSTATUS_CACHE_USED. O, si una o más de las cachés de paginadorar están compartidas, el valor devuelto por esta llamada será menor que el devuelto por DBSTATUS_CACHE_USED. La marca de agua alta asociada con SQLITE_DBSTATUS_CACHE_USED_SHARED es siempre 0.
- SQLITE_DBSTATUS_SCHEMA_USED
Este parámetro devuelve el número aproximado de bytes de memoria heap utilizados para almacenar el esquema de todas las bases de datos asociadas con la conexión - principal, temporal y cualquier base de datos ATTACH-ed.
Se informa de la cantidad total de memoria utilizada por los esquemas, incluso si la memoria del esquema se comparte con otras conexiones de bases de datos debido a que está activado el modo de caché compartida. La marca alta asociada con SQLITE_DBSTATUS_SCHEMA_USED es siempre 0.
- SQLITE_DBSTATUS_STMT_USED
Este parámetro devuelve el número aproximado de bytes de memoria heap y lookaside utilizados por todas las sentencias preparadas asociadas con la conexión a la base de datos.
La marca de agua alta asociada con SQLITE_DBSTATUS_STMT_USED es siempre 0.
- SQLITE_DBSTATUS_CACHE_HIT
Este parámetro devuelve el número de accesos a la caché del paginador que se han producido.
La marca de agua alta asociada con SQLITE_DBSTATUS_CACHE_HIT es siempre 0.
- SQLITE_DBSTATUS_CACHE_MISS
Este parámetro devuelve el número de pérdidas de caché del buscapersonas que se han producido.
La marca de agua alta asociada con SQLITE_DBSTATUS_CACHE_MISS es siempre 0.
- SQLITE_DBSTATUS_CACHE_WRITE
Este parámetro devuelve el número de entradas de caché sucias que se han escrito en disco.
Específicamente, el número de páginas escritas en el archivo wal en bases de datos en modo wal, o el número de páginas escritas en el archivo de base de datos en bases de datos en modo rollback. No se incluyen las páginas escritas como parte de operaciones de reversión de transacciones o de recuperación de bases de datos. Si se produce un error de E/S o de otro tipo mientras se escribe una página en el disco, el efecto sobre las siguientes peticiones SQLITE_DBSTATUS_CACHE_WRITE es indefinido. La marca de agua alta asociada con SQLITE_DBSTATUS_CACHE_WRITE es siempre 0.
- SQLITE_DBSTATUS_CACHE_SPILL
Este parámetro devuelve el número de entradas de caché sucias que se han escrito en disco en medio de una transacción debido al desbordamiento de la caché de páginas.
Las transacciones son más eficientes si se escriben en disco todas a la vez. Cuando las páginas se desbordan a mitad de la transacción, esto introduce una sobrecarga adicional. Este parámetro puede utilizarse para identificar ineficiencias que pueden resolverse aumentando el tamaño de la caché.
- SQLITE_DBSTATUS_DEFERRED_FKS
- Este parámetro devuelve cero para el valor actual si y sólo si se han resuelto todas las restricciones de clave foránea (diferidas o inmediatas). La marca de agua alta es siempre 0.