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 focuses on testing queries that use the "rank" column.
15 source [file join [file dirname [info script]] fts5_common.tcl]
16 set testprefix fts5rank
18 # If SQLITE_ENABLE_FTS5 is defined, omit this file.
25 #-------------------------------------------------------------------------
26 # "ORDER BY rank" + highlight() + large poslists.
29 CREATE VIRTUAL TABLE xyz USING fts5(z);
32 set doc [string trim [string repeat "x y " 500]]
33 execsql { INSERT INTO xyz VALUES($doc) }
36 SELECT highlight(xyz, 0, '[', ']') FROM xyz WHERE xyz MATCH 'x' ORDER BY rank
37 } [list [string map {x [x]} $doc]]
40 SELECT highlight(xyz, 0, '[', ']') FROM xyz
41 WHERE xyz MATCH 'x AND y' ORDER BY rank
42 } [list [string map {x [x] y [y]} $doc]]
44 #-------------------------------------------------------------------------
45 # Check that the 'rank' option really is persistent.
48 CREATE VIRTUAL TABLE tt USING fts5(a);
49 INSERT INTO tt VALUES('a x x x x');
50 INSERT INTO tt VALUES('x x a a a');
51 INSERT INTO tt VALUES('x a a x x');
54 proc firstinst {cmd} {
55 foreach {p c o} [$cmd xInst 0] {}
58 sqlite3_fts5_create_function db firstinst firstinst
61 SELECT rowid FROM tt('a') ORDER BY rank;
65 SELECT rowid FROM tt('a', 'firstinst()') ORDER BY rank;
69 INSERT INTO tt(tt, rank) VALUES('rank', 'firstinst()');
70 SELECT rowid FROM tt('a') ORDER BY rank;
75 catchsql { SELECT rowid FROM tt('a') ORDER BY rank; } db2
76 } {1 {no such function: firstinst}}
81 sqlite3_fts5_create_function db2 firstinst firstinst
82 execsql { SELECT rowid FROM tt('a') ORDER BY rank; } db2
86 execsql { SELECT rowid FROM tt('a') ORDER BY rank; } db2
90 execsql { SELECT rowid FROM tt('a') ORDER BY rank; } db
95 #--------------------------------------------------------------------------
96 # At one point there was a problem with queries such as:
98 # ... MATCH 'x OR y' ORDER BY rank;
100 # if there were zero occurrences of token 'y' in the dataset. The
101 # following tests verify that that problem has been addressed.
103 foreach_detail_mode $::testprefix {
104 do_execsql_test 3.1.0 {
105 CREATE VIRTUAL TABLE y1 USING fts5(z, detail=%DETAIL%);
106 INSERT INTO y1 VALUES('test xyz');
107 INSERT INTO y1 VALUES('test test xyz test');
108 INSERT INTO y1 VALUES('test test xyz');
111 do_execsql_test 3.1.1 {
112 SELECT rowid FROM y1('test OR tset');
115 do_execsql_test 3.1.2 {
116 SELECT rowid FROM y1('test OR tset') ORDER BY bm25(y1)
119 do_execsql_test 3.1.3 {
120 SELECT rowid FROM y1('test OR tset') ORDER BY +rank
123 do_execsql_test 3.1.4 {
124 SELECT rowid FROM y1('test OR tset') ORDER BY rank
127 do_execsql_test 3.1.5 {
128 SELECT rowid FROM y1('test OR xyz') ORDER BY rank
132 do_execsql_test 3.2.1 {
133 CREATE VIRTUAL TABLE z1 USING fts5(a, detail=%DETAIL%);
134 INSERT INTO z1 VALUES('wrinkle in time');
135 SELECT * FROM z1 WHERE z1 MATCH 'wrinkle in time OR a wrinkle in time';
136 } {{wrinkle in time}}
139 do_execsql_test 4.1 {
140 DROP TABLE IF EXISTS VTest;
141 CREATE virtual TABLE VTest USING FTS5(
142 Title, AUthor, tokenize ='porter unicode61 remove_diacritics 1',
143 columnsize='1', detail=full
145 INSERT INTO VTest (Title, Author) VALUES ('wrinkle in time', 'Bill Smith');
147 SELECT * FROM VTest WHERE
148 VTest MATCH 'wrinkle in time OR a wrinkle in time' ORDER BY rank;
149 } {{wrinkle in time} {Bill Smith}}
151 #-------------------------------------------------------------------------
153 do_execsql_test 5.0 {
154 CREATE VIRTUAL TABLE ttt USING fts5(a);
156 SELECT 1 UNION ALL SELECT i+1 FROM s WHERE i<100
158 INSERT INTO ttt SELECT 'word ' || i FROM s;
161 do_execsql_test 5.1 {
162 SELECT rowid FROM ttt('word') WHERE rowid BETWEEN 30 AND 40 ORDER BY rank;
163 } {30 31 32 33 34 35 36 37 38 39 40}
165 #-------------------------------------------------------------------------
167 do_execsql_test 6.0 {
168 CREATE VIRTUAL TABLE "My.Table" USING fts5(Text);
170 INSERT INTO "My.Table" VALUES ('hello this is a test');
171 INSERT INTO "My.Table" VALUES ('of trying to order by');
172 INSERT INTO "My.Table" VALUES ('rank on an fts5 table');
173 INSERT INTO "My.Table" VALUES ('that have periods in');
174 INSERT INTO "My.Table" VALUES ('the table names.');
175 INSERT INTO "My.Table" VALUES ('table table table');
177 do_execsql_test 6.1 {
178 SELECT * FROM "My.Table" WHERE Text MATCH 'table' ORDER BY rank;
180 {table table table} {the table names.} {rank on an fts5 table}
184 #-------------------------------------------------------------------------
185 # forum post: https://sqlite.org/forum/forumpost/a2dd636330
188 do_execsql_test 1.0 {
189 CREATE VIRTUAL TABLE t USING fts5 (a, b);
190 INSERT INTO t (a, b) VALUES ('data1', 'sentence1'), ('data2', 'sentence2');
191 INSERT INTO t(t, rank) VALUES ('rank', 'bm25(10.0,1.0)');
195 do_execsql_test -db db2 1.1 {
196 SELECT *, rank<0.0 FROM t('data*') ORDER BY RANK;
197 } {data1 sentence1 1 data2 sentence2 1}
199 do_execsql_test 1.2 {
200 INSERT INTO t(t, rank) VALUES ('rank', 'bm25(10.0,1.0)');
202 do_execsql_test -db db2 1.3 {
203 SELECT *, rank<0.0 FROM t('data*') ORDER BY RANK;
204 } {data1 sentence1 1 data2 sentence2 1}