3 # The author disclaims copyright to this source code. In place of
4 # a legal notice, here is a blessing:
6 # May you do good and not evil.
7 # May you find forgiveness for yourself and forgive others.
8 # May you share freely, never taking more than you give.
10 #***********************************************************************
12 # This file contains automated tests used to verify that the text terms
13 # at the end of sqlite_stat1.stat are processed correctly.
15 # (1) "unordered" means that the index cannot be used for ORDER BY
16 # or for range queries
18 # (2) "sz=NNN" sets the relative size of the index entries
20 # (3) All other fields are silently ignored
23 set testdir [file dirname $argv0]
24 source $testdir/tester.tcl
25 set testprefix analyzeC
27 # Baseline case. Range queries work OK. Indexes can be used for
31 CREATE TABLE t1(a,b,c);
33 VALUES(1,2,3),(7,8,9),(4,5,6),(10,11,12),(4,8,12),(1,11,111);
34 CREATE INDEX t1a ON t1(a);
35 CREATE INDEX t1b ON t1(b);
37 DELETE FROM sqlite_stat1;
38 INSERT INTO sqlite_stat1(tbl,idx,stat)
39 VALUES('t1','t1a','12345 2'),('t1','t1b','12345 4');
40 ANALYZE sqlite_master;
41 SELECT *, '#' FROM t1 WHERE a BETWEEN 3 AND 8 ORDER BY c;
42 } {4 5 6 # 7 8 9 # 4 8 12 #}
45 SELECT *, '#' FROM t1 WHERE a BETWEEN 3 AND 8 ORDER BY c;
46 } {/.* USING INDEX t1a .a>. AND a<...*/}
48 SELECT c FROM t1 ORDER BY a;
52 SELECT c FROM t1 ORDER BY a;
53 } {/.*SCAN TABLE t1 USING INDEX t1a.*/}
54 do_execsql_test 1.3x {
56 SELECT c FROM t1 ORDER BY a;
57 } {~/.*B-TREE FOR ORDER BY.*/}
59 # Now mark the t1a index as "unordered". Range queries and ORDER BY no
60 # longer use the index, but equality queries do.
63 UPDATE sqlite_stat1 SET stat='12345 2 unordered' WHERE idx='t1a';
64 ANALYZE sqlite_master;
65 SELECT *, '#' FROM t1 WHERE a BETWEEN 3 AND 8 ORDER BY c;
66 } {4 5 6 # 7 8 9 # 4 8 12 #}
69 SELECT *, '#' FROM t1 WHERE a BETWEEN 3 AND 8 ORDER BY c;
70 } {~/.*USING INDEX.*/}
72 SELECT c FROM t1 ORDER BY a;
76 SELECT c FROM t1 ORDER BY a;
77 } {~/.*USING INDEX.*/}
78 do_execsql_test 2.3x {
80 SELECT c FROM t1 ORDER BY a;
81 } {/.*B-TREE FOR ORDER BY.*/}
83 # Ignore extraneous text parameters in the sqlite_stat1.stat field.
86 UPDATE sqlite_stat1 SET stat='12345 2 whatever=5 unordered xyzzy=11'
88 ANALYZE sqlite_master;
89 SELECT *, '#' FROM t1 WHERE a BETWEEN 3 AND 8 ORDER BY c;
90 } {4 5 6 # 7 8 9 # 4 8 12 #}
93 SELECT *, '#' FROM t1 WHERE a BETWEEN 3 AND 8 ORDER BY c;
94 } {~/.*USING INDEX.*/}
96 SELECT c FROM t1 ORDER BY a;
100 SELECT c FROM t1 ORDER BY a;
101 } {~/.*USING INDEX.*/}
102 do_execsql_test 3.3x {
104 SELECT c FROM t1 ORDER BY a;
105 } {/.*B-TREE FOR ORDER BY.*/}
107 # The sz=NNN parameter determines which index to scan
109 do_execsql_test 4.0 {
111 CREATE INDEX t1ab ON t1(a,b);
112 CREATE INDEX t1ca ON t1(c,a);
113 DELETE FROM sqlite_stat1;
114 INSERT INTO sqlite_stat1(tbl,idx,stat)
115 VALUES('t1','t1ab','12345 3 2 sz=10'),('t1','t1ca','12345 3 2 sz=20');
116 ANALYZE sqlite_master;
117 SELECT count(a) FROM t1;
119 do_execsql_test 4.1 {
121 SELECT count(a) FROM t1;
123 do_execsql_test 4.2 {
124 DELETE FROM sqlite_stat1;
125 INSERT INTO sqlite_stat1(tbl,idx,stat)
126 VALUES('t1','t1ab','12345 3 2 sz=20'),('t1','t1ca','12345 3 2 sz=10');
127 ANALYZE sqlite_master;
128 SELECT count(a) FROM t1;
130 do_execsql_test 4.3 {
132 SELECT count(a) FROM t1;
136 # The sz=NNN parameter works even if there is other extraneous text
137 # in the sqlite_stat1.stat column.
139 do_execsql_test 5.0 {
140 DELETE FROM sqlite_stat1;
141 INSERT INTO sqlite_stat1(tbl,idx,stat)
142 VALUES('t1','t1ab','12345 3 2 x=5 sz=10 y=10'),
143 ('t1','t1ca','12345 3 2 whatever sz=20 junk');
144 ANALYZE sqlite_master;
145 SELECT count(a) FROM t1;
147 do_execsql_test 5.1 {
149 SELECT count(a) FROM t1;
151 do_execsql_test 5.2 {
152 DELETE FROM sqlite_stat1;
153 INSERT INTO sqlite_stat1(tbl,idx,stat)
154 VALUES('t1','t1ca','12345 3 2 x=5 sz=10 y=10'),
155 ('t1','t1ab','12345 3 2 whatever sz=20 junk');
156 ANALYZE sqlite_master;
157 SELECT count(a) FROM t1;
159 do_execsql_test 5.3 {
161 SELECT count(a) FROM t1;