# 2006 June 10

 #

 # The author disclaims copyright to this source code.  In place of

 # a legal notice, here is a blessing:

 #

 #    May you do good and not evil.

 #    May you find forgiveness for yourself and forgive others.

 #    May you share freely, never taking more than you give.

 #

 #***********************************************************************

 # This file implements regression tests for SQLite library.  The

 # focus of this file is creating and dropping virtual tables.

 #

 # $Id: vtab1.test,v 1.57 2008/08/01 17:51:47 danielk1977 Exp $

 set testdir [file dirname $argv0]

 source $testdir/tester.tcl

 ifcapable !vtab||!schema_pragmas {

   finish_test

   return

 }

 #----------------------------------------------------------------------

 # Organization of tests in this file:

 #

 # vtab1-1.*: Error conditions and other issues surrounding creation/connection

 #            of a virtual module.

 # vtab1-2.*: Test sqlite3_declare_vtab() and the xConnect/xDisconnect methods.

 # vtab1-3.*: Table scans and WHERE clauses.

 # vtab1-4.*: Table scans and ORDER BY clauses.

 # vtab1-5.*: Test queries that include joins. This brings the

 #            sqlite3_index_info.estimatedCost variable into play.

 # vtab1-6.*: Test UPDATE/INSERT/DELETE on vtables.

 # vtab1-7.*: Test sqlite3_last_insert_rowid().

 #

 # This file uses the "echo" module (see src/test8.c). Refer to comments

 # in that file for the special behaviour of the Tcl $echo_module variable.

 #

 # TODO: 

 #   * How to test the sqlite3_index_constraint_usage.omit field?

 #   * vtab1-5.*

 #

 # vtab1-14.*: Test 'IN' constraints - i.e. "SELECT * FROM t1 WHERE id IN(...)"

 #

 #----------------------------------------------------------------------

 # Test cases vtab1.1.*

 #

 # We cannot create a virtual table if the module has not been registered.

 #

 do_test vtab1-1.1 {

   explain {

     CREATE VIRTUAL TABLE t1 USING echo;

   }

   catchsql {

     CREATE VIRTUAL TABLE t1 USING echo;

   }

 } {1 {no such module: echo}}

 do_test vtab1-1.2 {

   execsql {

     SELECT name FROM sqlite_master ORDER BY 1

   }

 } {}

 # Register the module

 register_echo_module [sqlite3_connection_pointer db]

 # Once a module has been registered, virtual tables using that module

 # may be created. However if a module xCreate() fails to call

 # sqlite3_declare_vtab() an error will be raised and the table not created.

 #

 # The "echo" module does not invoke sqlite3_declare_vtab() if it is

 # passed zero arguments.

 #

 do_test vtab1-1.3 {

   catchsql {

     CREATE VIRTUAL TABLE t1 USING echo;

   }

 } {1 {vtable constructor did not declare schema: t1}}

 do_test vtab1-1.4 {

   execsql {

     SELECT name FROM sqlite_master ORDER BY 1

   }

 } {}

 # The "echo" module xCreate method returns an error and does not create

 # the virtual table if it is passed an argument that does not correspond

 # to an existing real table in the same database.

 #

 do_test vtab1-1.5 {

   catchsql {

     CREATE VIRTUAL TABLE t1 USING echo(no_such_table);

   }

 } {1 {vtable constructor failed: t1}}

 do_test vtab1-1.6 {

   execsql {

     SELECT name FROM sqlite_master ORDER BY 1

   }

 } {}

 # Ticket #2156.  Using the sqlite3_prepare_v2() API, make sure that

 # a CREATE VIRTUAL TABLE statement can be used multiple times.

 #

 do_test vtab1-1.2152.1 {

   set DB [sqlite3_connection_pointer db]

   set sql {CREATE VIRTUAL TABLE t2152a USING echo(t2152b)}

   set STMT [sqlite3_prepare_v2 $DB $sql -1 TAIL]

   sqlite3_step $STMT

 } SQLITE_ERROR

 do_test vtab-1.2152.2 {

   sqlite3_reset $STMT

   sqlite3_step $STMT

 } SQLITE_ERROR

 do_test vtab-1.2152.3 {

   sqlite3_reset $STMT

   db eval {CREATE TABLE t2152b(x,y)}

   sqlite3_step $STMT

 } SQLITE_DONE

 do_test vtab-1.2152.4 {

   sqlite3_finalize $STMT

   db eval {DROP TABLE t2152a; DROP TABLE t2152b}

 } {}

 # Test to make sure nothing goes wrong and no memory is leaked if we 

 # select an illegal table-name (i.e a reserved name or the name of a

 # table that already exists).

 #

 do_test vtab1-1.7 {

   catchsql {

     CREATE VIRTUAL TABLE sqlite_master USING echo;

   }

 } {1 {object name reserved for internal use: sqlite_master}}

 do_test vtab1-1.8 {

   catchsql {

     CREATE TABLE treal(a, b, c);

     CREATE VIRTUAL TABLE treal USING echo(treal);

   }

 } {1 {table treal already exists}}

 do_test vtab1-1.9 {

   execsql {

     DROP TABLE treal;

     SELECT name FROM sqlite_master ORDER BY 1

   }

 } {}

 do_test vtab1-1.10 {

   execsql {

     CREATE TABLE treal(a, b, c);

     CREATE VIRTUAL TABLE techo USING echo(treal);

   }

   db close

   sqlite3 db test.db

   catchsql {

     SELECT * FROM techo;

   }

 } {1 {no such module: echo}}

 do_test vtab1-1.11 {

   catchsql {

     INSERT INTO techo VALUES(1, 2, 3);

   }

 } {1 {no such module: echo}}

 do_test vtab1-1.12 {

   catchsql {

     UPDATE techo SET a = 10;

   }

 } {1 {no such module: echo}}

 do_test vtab1-1.13 {

   catchsql {

     DELETE FROM techo;

   }

 } {1 {no such module: echo}}

 do_test vtab1-1.14 {

   catchsql {

     PRAGMA table_info(techo)

   }

 } {1 {no such module: echo}}

 do_test vtab1-1.15 {

   catchsql {

     DROP TABLE techo;

   }

 } {1 {no such module: echo}}

 register_echo_module [sqlite3_connection_pointer db]

 register_echo_module [sqlite3_connection_pointer db]

 # Test an error message returned from a v-table constructor.

 #

 do_test vtab1-1.16 {

   execsql {

     DROP TABLE techo;

     CREATE TABLE logmsg(log);

   }

   catchsql {

     CREATE VIRTUAL TABLE techo USING echo(treal, logmsg);

   }

 } {1 {table 'logmsg' already exists}}

 do_test vtab1-1.17 {

   execsql {

     DROP TABLE treal;

     DROP TABLE logmsg;

     SELECT sql FROM sqlite_master;

   }

 } {}

 #----------------------------------------------------------------------

 # Test cases vtab1.2.*

 #

 # At this point, the database is completely empty. The echo module

 # has already been registered.

 # If a single argument is passed to the echo module during table

 # creation, it is assumed to be the name of a table in the same

 # database. The echo module attempts to set the schema of the

 # new virtual table to be the same as the existing database table.

 #

 do_test vtab1-2.1 {

   execsql {

     CREATE TABLE template(a, b, c);

   }

   execsql { PRAGMA table_info(template); }

 } [list         \

   0 a {} 0 {} 0 \

   1 b {} 0 {} 0 \

   2 c {} 0 {} 0 \

 ]

 do_test vtab1-2.2 {

   execsql {

     CREATE VIRTUAL TABLE t1 USING echo(template);

   }

   execsql { PRAGMA table_info(t1); }

 } [list         \

   0 a {} 0 {} 0 \

   1 b {} 0 {} 0 \

   2 c {} 0 {} 0 \

 ]

 # Test that the database can be unloaded. This should invoke the xDisconnect()

 # callback for the successfully create virtual table (t1).

 #

 do_test vtab1-2.3 {

   set echo_module [list]

   db close

   set echo_module

 } [list xDisconnect]

 # Re-open the database. This should not cause any virtual methods to 

 # be called. The invocation of xConnect() is delayed until the virtual

 # table schema is first required by the compiler.

 #

 do_test vtab1-2.4 {

   set echo_module [list]

   sqlite3 db test.db

   db cache size 0

   set echo_module

 } {}

 # Try to query the virtual table schema. This should fail, as the

 # echo module has not been registered with this database connection.

 #

 do_test vtab1.2.6 {

   catchsql { PRAGMA table_info(t1); }

 } {1 {no such module: echo}}

 # Register the module

 register_echo_module [sqlite3_connection_pointer db]

 # Try to query the virtual table schema again. This time it should

 # invoke the xConnect method and succeed.

 #

 do_test vtab1.2.7 {

   execsql { PRAGMA table_info(t1); }

 } [list         \

   0 a {} 0 {} 0 \

   1 b {} 0 {} 0 \

   2 c {} 0 {} 0 \

 ]

 do_test vtab1.2.8 {

   set echo_module

 } {xConnect echo main t1 template}

 # Drop table t1. This should cause the xDestroy (but not xDisconnect) method 

 # to be invoked.

 do_test vtab1-2.5 {

   set echo_module ""

   execsql {

     DROP TABLE t1;

   }

   set echo_module

 } {xDestroy}

 do_test vtab1-2.6 {

   execsql { 

     PRAGMA table_info(t1); 

   }

 } {}

 do_test vtab1-2.7 {

   execsql {

     SELECT sql FROM sqlite_master;

   }

 } [list {CREATE TABLE template(a, b, c)}]

 # Clean up other test artifacts:

 do_test vtab1-2.8 {

   execsql { 

     DROP TABLE template;

     SELECT sql FROM sqlite_master;

   }

 } [list]

 #----------------------------------------------------------------------

 # Test case vtab1-3 test table scans and the echo module's 

 # xBestIndex/xFilter handling of WHERE conditions.

 do_test vtab1-3.1 {

   set echo_module ""

   execsql {

     CREATE TABLE treal(a INTEGER, b INTEGER, c); 

     CREATE INDEX treal_idx ON treal(b);

     CREATE VIRTUAL TABLE t1 USING echo(treal);

   }

   set echo_module

 } [list xCreate echo main t1 treal   \

         xSync   echo(treal)  \

         xCommit echo(treal)  \

 ]

 # Test that a SELECT on t1 doesn't crash. No rows are returned

 # because the underlying real table is currently empty.

 #

 do_test vtab1-3.2 {

   execsql {

     SELECT a, b, c FROM t1;

   }

 } {}

 # Put some data into the table treal. Then try a few simple SELECT 

 # statements on t1.

 #

 do_test vtab1-3.3 {

   execsql {

     INSERT INTO treal VALUES(1, 2, 3);

     INSERT INTO treal VALUES(4, 5, 6);

     SELECT * FROM t1;

   }

 } {1 2 3 4 5 6}

 do_test vtab1-3.4 {

   execsql {

     SELECT a FROM t1;

   }

 } {1 4}

 do_test vtab1-3.5 {

   execsql {

     SELECT rowid FROM t1;

   }

 } {1 2}

 do_test vtab1-3.6 {

   set echo_module ""

   execsql {

     SELECT * FROM t1;

   }

 } {1 2 3 4 5 6}

 do_test vtab1-3.7 {

   execsql {

     SELECT rowid, * FROM t1;

   }

 } {1 1 2 3 2 4 5 6}

 do_test vtab1-3.8 {

   execsql {

     SELECT a AS d, b AS e, c AS f FROM t1;

   }

 } {1 2 3 4 5 6}

 # Execute some SELECT statements with WHERE clauses on the t1 table.

 # Then check the echo_module variable (written to by the module methods

 # in test8.c) to make sure the xBestIndex() and xFilter() methods were

 # called correctly.

 #

 do_test vtab1-3.8 {

   set echo_module ""

   execsql {

     SELECT * FROM t1;

   }

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'treal'} \

         xFilter    {SELECT rowid, * FROM 'treal'} ]

 do_test vtab1-3.9 {

   set echo_module ""

   execsql {

     SELECT * FROM t1 WHERE b = 5;

   }

 } {4 5 6}

 do_test vtab1-3.10 {

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'treal' WHERE b = ?}   \

         xFilter    {SELECT rowid, * FROM 'treal' WHERE b = ?} 5 ]

 do_test vtab1-3.10 {

   set echo_module ""

   execsql {

     SELECT * FROM t1 WHERE b >= 5 AND b <= 10;

   }

 } {4 5 6}

 do_test vtab1-3.11 {

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'treal' WHERE b >= ? AND b <= ?}      \

         xFilter    {SELECT rowid, * FROM 'treal' WHERE b >= ? AND b <= ?} 5 10 ]

 do_test vtab1-3.12 {

   set echo_module ""

   execsql {

     SELECT * FROM t1 WHERE b BETWEEN 2 AND 10;

   }

 } {1 2 3 4 5 6}

 do_test vtab1-3.13 {

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'treal' WHERE b >= ? AND b <= ?}      \

         xFilter    {SELECT rowid, * FROM 'treal' WHERE b >= ? AND b <= ?} 2 10 ]

 # Add a function for the MATCH operator. Everything always matches!

 #proc test_match {lhs rhs} {

 #  lappend ::echo_module MATCH $lhs $rhs

 #  return 1

 #}

 #db function match test_match

 set echo_module ""

 do_test vtab1-3.12 {

   set echo_module ""

   catchsql {

     SELECT * FROM t1 WHERE a MATCH 'string';

   }

 } {1 {unable to use function MATCH in the requested context}}

 do_test vtab1-3.13 {

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'treal'} \

         xFilter    {SELECT rowid, * FROM 'treal'}]

 ifcapable subquery {

 # The echo module uses a subquery internally to implement the MATCH operator.

 do_test vtab1-3.14 {

   set echo_module ""

   execsql {

     SELECT * FROM t1 WHERE b MATCH 'string';

   }

 } {}

 do_test vtab1-3.15 {

   set echo_module

 } [list xBestIndex \

         {SELECT rowid, * FROM 'treal' WHERE b LIKE (SELECT '%'||?||'%')}  \

         xFilter \

         {SELECT rowid, * FROM 'treal' WHERE b LIKE (SELECT '%'||?||'%')} \

         string ]

 }; #ifcapable subquery

 #----------------------------------------------------------------------

 # Test case vtab1-3 test table scans and the echo module's 

 # xBestIndex/xFilter handling of ORDER BY clauses.

 # This procedure executes the SQL.  Then it checks to see if the OP_Sort

 # opcode was executed.  If an OP_Sort did occur, then "sort" is appended

 # to the result.  If no OP_Sort happened, then "nosort" is appended.

 #

 # This procedure is used to check to make sure sorting is or is not

 # occurring as expected.

 #

 proc cksort {sql} {

   set ::sqlite_sort_count 0

   set data [execsql $sql]

   if {$::sqlite_sort_count} {set x sort} {set x nosort}

   lappend data $x

   return $data

 }

 do_test vtab1-4.1 {

   set echo_module ""

   cksort {

     SELECT b FROM t1 ORDER BY b;

   }

 } {2 5 nosort}

 do_test vtab1-4.2 {

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'treal' ORDER BY b ASC} \

         xFilter    {SELECT rowid, * FROM 'treal' ORDER BY b ASC} ]

 do_test vtab1-4.3 {

   set echo_module ""

   cksort {

     SELECT b FROM t1 ORDER BY b DESC;

   }

 } {5 2 nosort}

 do_test vtab1-4.4 {

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'treal' ORDER BY b DESC} \

         xFilter    {SELECT rowid, * FROM 'treal' ORDER BY b DESC} ]

 do_test vtab1-4.3 {

   set echo_module ""

   cksort {

     SELECT b FROM t1 ORDER BY b||'';

   }

 } {2 5 sort}

 do_test vtab1-4.4 {

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'treal'} \

         xFilter    {SELECT rowid, * FROM 'treal'} ]

 execsql {

   DROP TABLE t1;

   DROP TABLE treal;

 }

 #----------------------------------------------------------------------

 # Test cases vtab1-5 test SELECT queries that include joins on virtual 

 # tables.

 proc filter {log} {

   set out [list]

   for {set ii 0} {$ii < [llength $log]} {incr ii} {

     if {[lindex $log $ii] eq "xFilter"} {

       lappend out xFilter

       lappend out [lindex $log [expr $ii+1]]

     }

   }

   return $out

 }

 do_test vtab1-5-1 {

   execsql { 

     CREATE TABLE t1(a, b, c);

     CREATE TABLE t2(d, e, f);

     INSERT INTO t1 VALUES(1, 'red', 'green');

     INSERT INTO t1 VALUES(2, 'blue', 'black');

     INSERT INTO t2 VALUES(1, 'spades', 'clubs');

     INSERT INTO t2 VALUES(2, 'hearts', 'diamonds');

     CREATE VIRTUAL TABLE et1 USING echo(t1);

     CREATE VIRTUAL TABLE et2 USING echo(t2);

   }

 } {}

 do_test vtab1-5-2 {

   set echo_module ""

   execsql {

     SELECT * FROM et1, et2;

   }

 } [list \

   1 red green 1 spades clubs     \

   1 red green 2 hearts diamonds  \

   2 blue black 1 spades clubs    \

   2 blue black 2 hearts diamonds \

 ]

 do_test vtab1-5-3 {

   filter $echo_module

 } [list \

   xFilter {SELECT rowid, * FROM 't1'} \

   xFilter {SELECT rowid, * FROM 't2'} \

   xFilter {SELECT rowid, * FROM 't2'} \

 ]

 do_test vtab1-5-4 {

   set echo_module ""

   execsql {

     SELECT * FROM et1, et2 WHERE et2.d = 2;

   }

 } [list \

   1 red green 2 hearts diamonds  \

   2 blue black 2 hearts diamonds \

 ]

 do_test vtab1-5-5 {

   filter $echo_module

 } [list \

   xFilter {SELECT rowid, * FROM 't1'} \

   xFilter {SELECT rowid, * FROM 't2'} \

   xFilter {SELECT rowid, * FROM 't2'} \

 ]

 do_test vtab1-5-6 {

   execsql {

     CREATE INDEX i1 ON t2(d);

   }

   db close

   sqlite3 db test.db

   register_echo_module [sqlite3_connection_pointer db]

   set ::echo_module ""

   execsql {

     SELECT * FROM et1, et2 WHERE et2.d = 2;

   }

 } [list \

   1 red green 2 hearts diamonds  \

   2 blue black 2 hearts diamonds \

 ]

 do_test vtab1-5-7 {

   filter $::echo_module

 } [list \

   xFilter {SELECT rowid, * FROM 't2' WHERE d = ?} \

   xFilter {SELECT rowid, * FROM 't1'}             \

 ]

 execsql {

   DROP TABLE t1;

   DROP TABLE t2;

   DROP TABLE et1;

   DROP TABLE et2;

 }

 #----------------------------------------------------------------------

 # Test cases vtab1-6 test INSERT, UPDATE and DELETE operations 

 # on virtual tables.

 do_test vtab1-6-1 {

   execsql { SELECT sql FROM sqlite_master }

 } {}

 do_test vtab1-6-2 {

   execsql {

     CREATE TABLE treal(a PRIMARY KEY, b, c);

     CREATE VIRTUAL TABLE techo USING echo(treal);

     SELECT name FROM sqlite_master WHERE type = 'table';

   }

 } {treal techo}

 do_test vtab1-6-3.1.1 {

   execsql {

     PRAGMA count_changes=ON;

     INSERT INTO techo VALUES(1, 2, 3);

   }

 } {1}

 do_test vtab1-6-3.1.2 {

   db changes

 } {1}

 do_test vtab1-6-3.2 {

   execsql {

     SELECT * FROM techo;

   }

 } {1 2 3}

 do_test vtab1-6-4.1 {

   execsql {

     UPDATE techo SET a = 5;

   }

   db changes

 } {1}

 do_test vtab1-6-4.2 {

   execsql {

     SELECT * FROM techo;

   }

 } {5 2 3}

 do_test vtab1-6-4.3 {

   execsql {

     UPDATE techo SET a=6 WHERE a<0;

   }

   db changes

 } {0}

 do_test vtab1-6-4.4 {

   execsql {

     SELECT * FROM techo;

   }

 } {5 2 3}

 do_test vtab1-6-5.1 {

  execsql {

    UPDATE techo set a = a||b||c;

  }

  db changes

 } {1}

 do_test vtab1-6-5.2 {

  execsql {

    SELECT * FROM techo;

  }

 } {523 2 3}

 do_test vtab1-6-6.1 {

   execsql {

     UPDATE techo set rowid = 10;

   }

   db changes

 } {1}

 do_test vtab1-6-6.2 {

   execsql {

     SELECT rowid FROM techo;

   }

 } {10}

 do_test vtab1-6-7.1.1 {

   execsql {

     INSERT INTO techo VALUES(11,12,13);

   }

 } {1}

 do_test vtab1-6-7.1.2 {

   db changes

 } {1}

 do_test vtab1-6-7.2 {

   execsql {

     SELECT * FROM techo ORDER BY a;

   }

 } {11 12 13 523 2 3}

 do_test vtab1-6-7.3 {

   execsql {

     UPDATE techo SET b=b+1000

   }

   db changes

 } {2}

 do_test vtab1-6-7.4 {

   execsql {

     SELECT * FROM techo ORDER BY a;

   }

 } {11 1012 13 523 1002 3}

 do_test vtab1-6-8.1 {

   execsql {

     DELETE FROM techo WHERE a=5;

   }

   db changes

 } {0}

 do_test vtab1-6-8.2 {

   execsql {

     SELECT * FROM techo ORDER BY a;

   }

 } {11 1012 13 523 1002 3}

 do_test vtab1-6-8.3 {

   execsql {

     DELETE FROM techo;

   }

   db changes

 } {2}

 do_test vtab1-6-8.4 {

   execsql {

     SELECT * FROM techo ORDER BY a;

   }

 } {}

 execsql {PRAGMA count_changes=OFF}

 file delete -force test2.db

 file delete -force test2.db-journal

 sqlite3 db2 test2.db

 execsql {

   CREATE TABLE techo(a PRIMARY KEY, b, c);

 } db2

 proc check_echo_table {tn} {

   set ::data1 [execsql {SELECT rowid, * FROM techo}]

   set ::data2 [execsql {SELECT rowid, * FROM techo} db2]

   do_test $tn {

     string equal $::data1 $::data2

   } 1

 }

 set tn 0

 foreach stmt [list \

   {INSERT INTO techo VALUES('abc', 'def', 'ghi')}                        \

   {INSERT INTO techo SELECT a||'.'||rowid, b, c FROM techo}              \

   {INSERT INTO techo SELECT a||'x'||rowid, b, c FROM techo}              \

   {INSERT INTO techo SELECT a||'y'||rowid, b, c FROM techo}              \

   {DELETE FROM techo WHERE (oid % 3) = 0}                                \

   {UPDATE techo set rowid = 100 WHERE rowid = 1}                         \

   {INSERT INTO techo(a, b) VALUES('hello', 'world')}                     \

   {DELETE FROM techo}                                                    \

 ] {

   execsql $stmt

   execsql $stmt db2

   check_echo_table vtab1-6.8.[incr tn]

 }

 db2 close

 #----------------------------------------------------------------------

 # Test cases vtab1-7 tests that the value returned by 

 # sqlite3_last_insert_rowid() is set correctly when rows are inserted

 # into virtual tables.

 do_test vtab1.7-1 {

   execsql {

     CREATE TABLE real_abc(a PRIMARY KEY, b, c);

     CREATE VIRTUAL TABLE echo_abc USING echo(real_abc);

   }

 } {}

 do_test vtab1.7-2 {

   execsql {

     INSERT INTO echo_abc VALUES(1, 2, 3);

     SELECT last_insert_rowid();

   }

 } {1}

 do_test vtab1.7-3 {

   execsql {

     INSERT INTO echo_abc(rowid) VALUES(31427);

     SELECT last_insert_rowid();

   }

 } {31427}

 do_test vtab1.7-4 {

   execsql {

     INSERT INTO echo_abc SELECT a||'.v2', b, c FROM echo_abc;

     SELECT last_insert_rowid();

   }

 } {31429}

 do_test vtab1.7-5 {

   execsql {

     SELECT rowid, a, b, c FROM echo_abc

   }

 } [list 1     1    2  3  \

         31427 {}   {} {} \

         31428 1.v2 2  3  \

         31429 {}  {} {}  \

 ]

 # Now test that DELETE and UPDATE operations do not modify the value.

 do_test vtab1.7-6 {

   execsql {

     UPDATE echo_abc SET c = 5 WHERE b = 2;

     SELECT last_insert_rowid();

   }

 } {31429}

 do_test vtab1.7-7 {

   execsql {

     UPDATE echo_abc SET rowid = 5 WHERE rowid = 1;

     SELECT last_insert_rowid();

   }

 } {31429}

 do_test vtab1.7-8 {

   execsql {

     DELETE FROM echo_abc WHERE b = 2;

     SELECT last_insert_rowid();

   }

 } {31429}

 do_test vtab1.7-9 {

   execsql {

     SELECT rowid, a, b, c FROM echo_abc

   }

 } [list 31427 {} {} {} \

         31429 {} {} {} \

 ]

 do_test vtab1.7-10 {

   execsql {

     DELETE FROM echo_abc WHERE b = 2;

     SELECT last_insert_rowid();

   }

 } {31429}

 do_test vtab1.7-11 {

   execsql {

     SELECT rowid, a, b, c FROM real_abc

   }

 } [list 31427 {} {} {} \

         31429 {} {} {} \

 ]

 do_test vtab1.7-12 {

   execsql {

     DELETE FROM echo_abc;

     SELECT last_insert_rowid();

   }

 } {31429}

 do_test vtab1.7-13 {

   execsql {

     SELECT rowid, a, b, c FROM real_abc

   }

 } {}

 ifcapable attach {

   do_test vtab1.8-1 {

     set echo_module ""

     execsql {

       ATTACH 'test2.db' AS aux;

       CREATE VIRTUAL TABLE aux.e2 USING echo(real_abc);

     }

     set echo_module

   } [list xCreate echo aux e2 real_abc   \

           xSync   echo(real_abc)         \

           xCommit echo(real_abc)         \

   ]

 }

 do_test vtab1.8-2 {

   catchsql {

     DROP TABLE aux.e2;

   }

   execsql {

     DROP TABLE treal;

     DROP TABLE techo;

     DROP TABLE echo_abc;

     DROP TABLE real_abc;

   }

 } {}

 do_test vtab1.9-1 {

   set echo_module ""

   execsql {

     CREATE TABLE r(a, b, c);

     CREATE VIRTUAL TABLE e USING echo(r, e_log);

     SELECT name FROM sqlite_master;

   }

 } {r e e_log}

 do_test vtab1.9-2 {

   execsql {

     DROP TABLE e;

     SELECT name FROM sqlite_master;

   }

 } {r}

 do_test vtab1.9-3 {

   set echo_module ""

   execsql {

     CREATE VIRTUAL TABLE e USING echo(r, e_log, virtual 1 2 3 varchar(32));

   }

   set echo_module

 } [list                                                        \

   xCreate echo main e r e_log {virtual 1 2 3 varchar(32)}      \

   xSync echo(r)                                                \

   xCommit echo(r)                                              \

 ]

 do_test vtab1.10-1 {

   execsql {

     CREATE TABLE del(d);

     CREATE VIRTUAL TABLE e2 USING echo(del);

   }

   db close

   sqlite3 db test.db

   register_echo_module [sqlite3_connection_pointer db]

   execsql {

     DROP TABLE del;

   }

   catchsql {

     SELECT * FROM e2;

   }

 } {1 {vtable constructor failed: e2}}

 do_test vtab1.10-2 {

   set rc [catch {

     set ptr [sqlite3_connection_pointer db]

     sqlite3_declare_vtab $ptr {CREATE TABLE abc(a, b, c)}

   } msg]

   list $rc $msg

 } {1 {library routine called out of sequence}}

 do_test vtab1.10-3 {

   set ::echo_module_begin_fail r

   catchsql {

     INSERT INTO e VALUES(1, 2, 3);

   }

 } {1 {SQL logic error or missing database}}

 do_test vtab1.10-4 {

   catch {execsql {

     EXPLAIN SELECT * FROM e WHERE rowid = 2;

     EXPLAIN QUERY PLAN SELECT * FROM e WHERE rowid = 2 ORDER BY rowid;

   }}

 } {0}

 do_test vtab1.10-5 {

   set echo_module ""

   execsql {

     SELECT * FROM e WHERE rowid||'' MATCH 'pattern';

   }

   set echo_module

 } [list \

   xBestIndex {SELECT rowid, * FROM 'r'} \

   xFilter {SELECT rowid, * FROM 'r'}    \

 ]

 proc match_func {args} {return ""}

 do_test vtab1.10-6 {

   set echo_module ""

   db function match match_func

   execsql {

     SELECT * FROM e WHERE match('pattern', rowid, 'pattern2');

   }

   set echo_module

 } [list \

   xBestIndex {SELECT rowid, * FROM 'r'} \

   xFilter {SELECT rowid, * FROM 'r'}    \

 ]

 # Testing the xFindFunction interface

 #

 catch {rename ::echo_glob_overload {}}

 do_test vtab1.11-1 {

   execsql {

     INSERT INTO r(a,b,c) VALUES(1,'?',99);

     INSERT INTO r(a,b,c) VALUES(2,3,99);

     SELECT a GLOB b FROM e

   }

 } {1 0}

 proc ::echo_glob_overload {a b} {

  return [list $b $a]

 }

 do_test vtab1.11-2 {

   execsql {

     SELECT a like 'b' FROM e

   }

 } {0 0}

 do_test vtab1.11-3 {

   execsql {

     SELECT a glob '2' FROM e

   }

 } {{1 2} {2 2}}

 do_test vtab1.11-4 {

   execsql {

     SELECT  glob('2',a) FROM e

   }

 } {0 1}

 do_test vtab1.11-5 {

   execsql {

     SELECT  glob(a,'2') FROM e

   }

 } {{2 1} {2 2}}

 #----------------------------------------------------------------------

 # Test the outcome if a constraint is encountered half-way through

 # a multi-row INSERT that is inside a transaction

 #

 do_test vtab1.12-1 {

   execsql {

     CREATE TABLE b(a, b, c);

     CREATE TABLE c(a UNIQUE, b, c);

     INSERT INTO b VALUES(1, 'A', 'B');

     INSERT INTO b VALUES(2, 'C', 'D');

     INSERT INTO b VALUES(3, 'E', 'F');

     INSERT INTO c VALUES(3, 'G', 'H');

     CREATE VIRTUAL TABLE echo_c USING echo(c);

   }

 } {}

 # First test outside of a transaction.

 do_test vtab1.12-2 {

   catchsql { INSERT INTO echo_c SELECT * FROM b; }

 } {1 {echo-vtab-error: column a is not unique}}

 do_test vtab1.12-2.1 {

   sqlite3_errmsg db

 } {echo-vtab-error: column a is not unique}

 do_test vtab1.12-3 {

   execsql { SELECT * FROM c }

 } {3 G H}

 # Now the real test - wrapped in a transaction.

 do_test vtab1.12-4 {

   execsql  {BEGIN}

   catchsql { INSERT INTO echo_c SELECT * FROM b; }

 } {1 {echo-vtab-error: column a is not unique}}

 do_test vtab1.12-5 {

   execsql { SELECT * FROM c }

 } {3 G H}

 do_test vtab1.12-6 {

   execsql { COMMIT }

   execsql { SELECT * FROM c }

 } {3 G H}

 # At one point (ticket #2759), a WHERE clause of the form "<column> IS NULL"

 # on a virtual table was causing an assert() to fail in the compiler.

 #

 # "IS NULL" clauses should not be passed through to the virtual table

 # implementation. They are handled by SQLite after the vtab returns its

 # data.

 #

 do_test vtab1.13-1 {

   execsql { 

     SELECT * FROM echo_c WHERE a IS NULL 

   }

 } {}

 do_test vtab1.13-2 {

   execsql { 

     INSERT INTO c VALUES(NULL, 15, 16);

     SELECT * FROM echo_c WHERE a IS NULL 

   }

 } {{} 15 16}

 do_test vtab1.13-3 {

   execsql { 

     INSERT INTO c VALUES(15, NULL, 16);

     SELECT * FROM echo_c WHERE b IS NULL 

   }

 } {15 {} 16}

 do_test vtab1.13-3 {

   execsql { 

     SELECT * FROM echo_c WHERE b IS NULL AND a = 15;

   }

 } {15 {} 16}

 do_test vtab1-14.1 {

   execsql { DELETE FROM c }

   set echo_module ""

   execsql { SELECT * FROM echo_c WHERE rowid IN (1, 2, 3) }

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'c'} xFilter {SELECT rowid, * FROM 'c'}]

 do_test vtab1-14.2 {

   set echo_module ""

   execsql { SELECT * FROM echo_c WHERE rowid = 1 }

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'c' WHERE rowid = ?} xFilter {SELECT rowid, * FROM 'c' WHERE rowid = ?} 1]

 do_test vtab1-14.3 {

   set echo_module ""

   execsql { SELECT * FROM echo_c WHERE a = 1 }

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'c' WHERE a = ?} xFilter {SELECT rowid, * FROM 'c' WHERE a = ?} 1]

 do_test vtab1-14.4 {

   set echo_module ""

   execsql { SELECT * FROM echo_c WHERE a IN (1, 2) }

   set echo_module

 } [list xBestIndex {SELECT rowid, * FROM 'c'} xFilter {SELECT rowid, * FROM 'c'}]

 do_test vtab1-15.1 {

   execsql {

     CREATE TABLE t1(a, b, c);

     CREATE VIRTUAL TABLE echo_t1 USING echo(t1);

   }

 } {}

 do_test vtab1-15.2 {

   execsql {

     INSERT INTO echo_t1(rowid) VALUES(45);

     SELECT rowid, * FROM echo_t1;

   }

 } {45 {} {} {}}

 do_test vtab1-15.3 {

   execsql {

     INSERT INTO echo_t1(rowid) VALUES(NULL);

     SELECT rowid, * FROM echo_t1;

   }

 } {45 {} {} {} 46 {} {} {}}

 do_test vtab1-15.4 {

   catchsql {

     INSERT INTO echo_t1(rowid) VALUES('new rowid');

   }

 } {1 {datatype mismatch}}

 # The following tests - vtab1-16.* - are designed to test that setting 

 # sqlite3_vtab.zErrMsg variable can be used by the vtab interface to 

 # return an error message to the user.

 # 

 do_test vtab1-16.1 {

   execsql {

     CREATE TABLE t2(a PRIMARY KEY, b, c);

     INSERT INTO t2 VALUES(1, 2, 3);

     INSERT INTO t2 VALUES(4, 5, 6);

     CREATE VIRTUAL TABLE echo_t2 USING echo(t2);

   }

 } {}

 set tn 2

 foreach method [list \

     xBestIndex       \

     xOpen            \

     xFilter          \

     xNext            \

     xColumn          \

     xRowid           \

 ] {

   do_test vtab1-16.$tn {

     set echo_module_fail($method,t2) "the $method method has failed"

     catchsql { SELECT rowid, * FROM echo_t2 WHERE a >= 1 }

   } "1 {echo-vtab-error: the $method method has failed}"

   unset echo_module_fail($method,t2)

   incr tn

 }

 foreach method [list \

   xUpdate            \

   xBegin             \

   xSync              \

 ] {

   do_test vtab1-16.$tn {

     set echo_module_fail($method,t2) "the $method method has failed"

     catchsql { INSERT INTO echo_t2 VALUES(7, 8, 9) }

   } "1 {echo-vtab-error: the $method method has failed}"

   unset echo_module_fail($method,t2)

   incr tn

 }

 do_test vtab1-16.$tn {

   set echo_module_fail(xRename,t2) "the xRename method has failed"

   catchsql { ALTER TABLE echo_t2 RENAME TO another_name }

 } "1 {echo-vtab-error: the xRename method has failed}"

 unset echo_module_fail(xRename,t2)

 incr tn

 unset -nocomplain echo_module_begin_fail

 finish_test