一、参考网址
SQLite中的限制(官网):https://sqlite.org/limits.html
运行时限制类别(官网):https://sqlite.org/c3ref/c_limit_attached.html#sqlitelimitcolumn
二、详解
1、查看、设置sqlite限制命令.limit
sqlite> .limit // 显示或设置数据库限制信息:SQLITE_LIMIT
length 1000000000 // 字符串或BLOB的最大长度10亿,一行的最大长度
sql_length 1000000000 // sql语句最大长度
column 2000 // 列数,可以在编译时才可以将最大列出改为32767
expr_depth 1000 // 表达式树的最大深度,SQLite将表达式解析到树中进行处理。
compound_select 500 // 复合SELECT语句中的最大术语数
vdbe_op 25000 // 虚拟机程序中用于实现SQL语句的最大指令数
function_arg 127 // 一个函数的最大参数个数
attached 10 // ATTACH语句,附加数据库最大值为125
like_pattern_length 50000 // LIKE模式匹配算法或GLOB模式的最大长度
variable_number 250000 // 任何参数的索引号
trigger_depth 1000 // 触发递归的最大深度
worker_threads 0 // 可以启动的辅助工作线程的最大数量
2、SQLite中的限制汇总
1)字符串或BLOB的最大长度
注:BLOB是sqlite的一种类型,用于存储二进制。
限制SQLite中字符串、BLOB类型值、数据库一行的最大字节数,默认值为10亿,最大为2147483647;
在编译时,通过SQLITE_MAX_LENGTH来设置;
-DSQLITE_MAX_LENGTH = 123456789
1
在运行时,通过sqlite3_limit(db, SQLITE_LIMIT_LENGTH, size)来降低该值;
官方建议:最好将最大字符串长度和blob长度减小到几百万。
在SQLite的INSERT和SELECT处理的一部分期间,数据库中每一行的全部内容被编码为单个BLOB。因此,SQLITE_MAX_LENGTH参数还确定一行中的最大字节数。
2)最大列数
最大列数用于限制一下项的上限:
表中的列数
索引中的列数
视图中的列数
UPDATE语句的SET子句中的术语数
SELECT语句的结果集中的列数
GROUP BY或ORDER BY子句中的术语数
INSERT语句中的值数
默认值为2000,最大为32767;
在编译时,通过SQLITE_MAX_COLUMN来设置,
在运行时,通过sqlite3_limit(db, SQLITE_LIMIT_COLUMN,size)来降低最大列数。
3)SQL语句的最大长度
对SQL语句的最大字节数的限制,默认值为1000000,最大为SQLITE_MAX_LENGTH和1073741824中较小的一个。
在编译时,通过SQLITE_MAX_SQL_LENGTH来设置;
在运行时,通过sqlite3_limit(db, SQLITE_LIMIT_SQL_LENGTH, size)来降低该值。
4)联接中的最大表数
SQLite不支持包含超过64个表的联接。不可更改
5)表达式树的最大深度
限制SQL语句表达式的复杂程度;
编译时通过SQLITE_MAX_EXPR_DEPTH参数设置,默认是1000;
如果SQLITE_MAX_EXPR_DEPTH为正,可以在运行时通过sqlite3_limit(db,SQLITE_LIMIT_EXPR_DEPTH,size)来降低;
如果SQLITE_MAX_EXPR_DEPTH为0,则不受限制,上面的接口无效。
6)函数的最大参数个数
限制函数的参数个数,默认值是100,最大为127;
在编译时,通过SQLITE_MAX_FUNCTION_ARG来设置最大值;
在运行时,通过sqlite3_limit(db,SQLITE_LIMIT_FUNCTION_ARG,size)来降低该值。
7)复合SELECT语句中的最大项数
复合SELECT语句是通过运算符UNION,UNION ALL,EXCEPT或INTERSECT连接的两个或多个SELECT语句。每个单独的SELECT语句称为“项”。
默认值为500;官方不建议再增大;
在编译时,通过SQLITE_MAX_COMPOUND_SELECT来设置最大值;
在运行时,通过 qlite3_limit(db,SQLITE_LIMIT_COMPOUND_SELECT,size)来降低该值。
8)LIKE或GLOB模式的最大长度
LIKE、GLOB运算符:模式匹配比较,类似正则表达式;
限制LIKE或GLOB模式的表达式的字符长度;默认值为50000,官方不建议再增大;
在编译时,通过SQLITE_MAX_LIKE_PATTERN_LENGTH来设置最大值;
在运行时,通过sqlite3_limit(db,SQLITE_LIMIT_LIKE_PATTERN_LENGTH,size)来降低该值。
9)单个SQL语句中的最大占位符个数
限制C或C++ SQL接口中使用的占位符的个数;默认为999,最大值10亿;
在编译时,通过SQLITE_MAX_VARIABLE_NUMBER来设置最大值;
在运行时,通过sqlite3_limit(db,SQLITE_LIMIT_VARIABLE_NUMBER,size)来降低该值。
10)触发递归的最大深度
SQLite 触发器(Trigger)是数据库的回调函数,它会在指定的数据库事件发生时自动执行/调用。
限制回调函数递归的深度。
默认值是1000.;
在编译时,通过SQLITE_MAX_TRIGGER_DEPTH来设置最大值;
在运行时,无法设置;
11)数据库关联的最大数
使用ATTACH可以将多个数据库关联到一起,这样在操作时,就像操作一个数据库。
限制关联数据库的个数,默认值10,最大125;
在编译时,通过SQLITE_MAX_ATTACHED来设置最大值;
在运行时,通过sqlite3_limit(db,SQLITE_LIMIT_ATTACHED,size)来降低该值。
12)数据库文件中的最大页数
防止单个数据库文件过大;数据库文件大小由页数和单个页大小决定;
默认值为1073741823,最大2147483646
在编译时,通过SQLITE_MAX_PAGE_COUNT来设置;
在运行时,通过PRAGMA schema.max_page_count来查询和设置该值;
在插入新数据时,页数将要超过该值,会返回SQLITE_FULL。
如果页数最大为2147483646,页大小为65536时,数据库大小约为140 TB。
13)表中的最大行数
表中的理论最大行数为2^ 64(18446744073709551616或大约1.8e+19)。由于将首先达到140 TB的最大数据库大小,因此无法达到此限制。一个140 TB的数据库最多可以容纳大约1e+13行。
无法改变该值。
14)数据库大小限制
页数最大为2147483646,页大小为65536时,数据库大小约为140 TB
15)表个数限制
保存每个表的描述信息需要一页,因此该表的数量不会超过页数。
初始化数据库时,需要扫描所有表的描述信息、并保存在内存中。因此数据库连接启动时间和初始内存使用量和表的数量成正比。
3、运行时限制类别
#define SQLITE_LIMIT_LENGTH 0
#define SQLITE_LIMIT_SQL_LENGTH 1
#define SQLITE_LIMIT_COLUMN 2
#define SQLITE_LIMIT_EXPR_DEPTH 3
#define SQLITE_LIMIT_COMPOUND_SELECT 4
#define SQLITE_LIMIT_VDBE_OP 5
#define SQLITE_LIMIT_FUNCTION_ARG 6
#define SQLITE_LIMIT_ATTACHED 7
#define SQLITE_LIMIT_LIKE_PATTERN_LENGTH 8
#define SQLITE_LIMIT_VARIABLE_NUMBER 9
#define SQLITE_LIMIT_TRIGGER_DEPTH 10
#define SQLITE_LIMIT_WORKER_THREADS 11
这些常量定义了各种性能限制,可以在运行时使用 sqlite3_limit 降低这些限制
int sqlite3_limit(sqlite3*, int id, int newVal);
1
id取值如下:
SQLITE_LIMIT_LENGTH:任何字符串或BLOB或表行的最大大小,以字节为单位。
SQLITE_LIMIT_SQL_LENGTH:SQL语句的最大长度,以字节为单位。
SQLITE_LIMIT_COLUMN:表定义或SELECT结果集中的最大列数,或索引或ORDER BY或GROUP BY子句中的最大列数。
SQLITE_LIMIT_EXPR_DEPTH:任何表达式上分析树的最大深度。
SQLITE_LIMIT_COMPOUND_SELECT:复合SELECT语句中的最大术语数。
SQLITE_LIMIT_VDBE_OP:虚拟机程序中用于实现SQL语句的最大指令数。如果sqlite3_prepare_v2()或等效方法试图在单个准备好的语句中为多个操作码分配空间,则将返回SQLITE_NOMEM错误。
SQLITE_LIMIT_FUNCTION_ARG:一个函数的最大参数个数。
SQLITE_LIMIT_ATTACHED:附加数据库的最大数量。
SQLITE_LIMIT_LIKE_PATTERN_LENGTH:LIKE或 GLOB运算符的pattern参数的最大长度。
SQLITE_LIMIT_VARIABLE_NUMBER:SQL语句中任何参数的最大索引号。
SQLITE_LIMIT_TRIGGER_DEPTH:触发器的最大递归深度。
SQLITE_LIMIT_WORKER_THREADS:一个准备好的语句可以启动的辅助工作线程的最大数量 。