/ Hex Artifact Content
Login

Artifact 8d6ff5dd9cc503f6e12d408a30409c3f9c653507b24408d9cd7195931c89bc54:


0000: 23 20 32 30 31 36 20 4e 6f 76 65 6d 62 65 72 20  # 2016 November 
0010: 31 38 0a 23 0a 23 20 54 68 65 20 61 75 74 68 6f  18.#.# The autho
0020: 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70 79  r disclaims copy
0030: 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73 6f  right to this so
0040: 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20 70  urce code.  In p
0050: 6c 61 63 65 20 6f 66 0a 23 20 61 20 6c 65 67 61  lace of.# a lega
0060: 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65 20 69  l notice, here i
0070: 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a 23 0a  s a blessing:.#.
0080: 23 20 20 20 20 4d 61 79 20 79 6f 75 20 64 6f 20  #    May you do 
0090: 67 6f 6f 64 20 61 6e 64 20 6e 6f 74 20 65 76 69  good and not evi
00a0: 6c 2e 0a 23 20 20 20 20 4d 61 79 20 79 6f 75 20  l..#    May you 
00b0: 66 69 6e 64 20 66 6f 72 67 69 76 65 6e 65 73 73  find forgiveness
00c0: 20 66 6f 72 20 79 6f 75 72 73 65 6c 66 20 61 6e   for yourself an
00d0: 64 20 66 6f 72 67 69 76 65 20 6f 74 68 65 72 73  d forgive others
00e0: 2e 0a 23 20 20 20 20 4d 61 79 20 79 6f 75 20 73  ..#    May you s
00f0: 68 61 72 65 20 66 72 65 65 6c 79 2c 20 6e 65 76  hare freely, nev
0100: 65 72 20 74 61 6b 69 6e 67 20 6d 6f 72 65 20 74  er taking more t
0110: 68 61 6e 20 79 6f 75 20 67 69 76 65 2e 0a 23 0a  han you give..#.
0120: 23 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  #***************
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 0a 23 20 54 68 69 73 20  ********.# This 
0170: 66 69 6c 65 20 69 6d 70 6c 65 6d 65 6e 74 73 20  file implements 
0180: 72 65 67 72 65 73 73 69 6f 6e 20 74 65 73 74 73  regression tests
0190: 20 66 6f 72 20 53 51 4c 69 74 65 20 6c 69 62 72   for SQLite libr
01a0: 61 72 79 2e 20 54 68 65 20 66 6f 63 75 73 0a 23  ary. The focus.#
01b0: 20 6f 66 20 74 68 69 73 20 66 69 6c 65 20 69 73   of this file is
01c0: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 73 6e 61   the sqlite3_sna
01d0: 70 73 68 6f 74 5f 78 78 78 28 29 20 41 50 49 73  pshot_xxx() APIs
01e0: 2e 0a 23 0a 0a 73 65 74 20 74 65 73 74 64 69 72  ..#..set testdir
01f0: 20 5b 66 69 6c 65 20 64 69 72 6e 61 6d 65 20 24   [file dirname $
0200: 61 72 67 76 30 5d 0a 73 6f 75 72 63 65 20 24 74  argv0].source $t
0210: 65 73 74 64 69 72 2f 74 65 73 74 65 72 2e 74 63  estdir/tester.tc
0220: 6c 0a 69 66 63 61 70 61 62 6c 65 20 21 73 6e 61  l.ifcapable !sna
0230: 70 73 68 6f 74 20 7b 66 69 6e 69 73 68 5f 74 65  pshot {finish_te
0240: 73 74 3b 20 72 65 74 75 72 6e 7d 0a 73 65 74 20  st; return}.set 
0250: 74 65 73 74 70 72 65 66 69 78 20 73 6e 61 70 73  testprefix snaps
0260: 68 6f 74 32 0a 0a 23 20 54 68 69 73 20 74 65 73  hot2..# This tes
0270: 74 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20  t does not work 
0280: 77 69 74 68 20 74 68 65 20 69 6e 6d 65 6d 6f 72  with the inmemor
0290: 79 5f 6a 6f 75 72 6e 61 6c 20 70 65 72 6d 75 74  y_journal permut
02a0: 61 74 69 6f 6e 2e 20 54 68 65 20 72 65 61 73 6f  ation. The reaso
02b0: 6e 0a 23 20 69 73 20 74 68 61 74 20 65 61 63 68  n.# is that each
02c0: 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 6f 70 65 6e   connection open
02d0: 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 74 68  ed as part of th
02e0: 69 73 20 70 65 72 6d 75 74 61 74 69 6f 6e 20 65  is permutation e
02f0: 78 65 63 75 74 65 73 0a 23 20 22 50 52 41 47 4d  xecutes.# "PRAGM
0300: 41 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 3d 6d  A journal_mode=m
0310: 65 6d 6f 72 79 22 2c 20 77 68 69 63 68 20 66 61  emory", which fa
0320: 69 6c 73 20 69 66 20 74 68 65 20 64 61 74 61 62  ils if the datab
0330: 61 73 65 20 69 73 20 69 6e 20 77 61 6c 20 6d 6f  ase is in wal mo
0340: 64 65 0a 23 20 61 6e 64 20 74 68 65 72 65 20 61  de.# and there a
0350: 72 65 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 65  re one or more e
0360: 78 69 73 74 69 6e 67 20 63 6f 6e 6e 65 63 74 69  xisting connecti
0370: 6f 6e 73 2e 0a 69 66 20 7b 5b 70 65 72 6d 75 74  ons..if {[permut
0380: 61 74 69 6f 6e 5d 3d 3d 22 69 6e 6d 65 6d 6f 72  ation]=="inmemor
0390: 79 5f 6a 6f 75 72 6e 61 6c 22 7d 20 7b 0a 20 20  y_journal"} {.  
03a0: 66 69 6e 69 73 68 5f 74 65 73 74 0a 20 20 72 65  finish_test.  re
03b0: 74 75 72 6e 0a 7d 0a 0a 23 2d 2d 2d 2d 2d 2d 2d  turn.}..#-------
03c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
03f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0400: 2d 2d 0a 23 20 43 68 65 63 6b 20 74 68 61 74 20  --.# Check that 
0410: 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62  it is not possib
0420: 6c 65 20 74 6f 20 6f 62 74 61 69 6e 20 61 20 73  le to obtain a s
0430: 6e 61 70 73 68 6f 74 20 69 6d 6d 65 64 69 61 74  napshot immediat
0440: 65 6c 79 20 61 66 74 65 72 0a 23 20 61 20 77 61  ely after.# a wa
0450: 6c 20 6d 6f 64 65 20 64 61 74 61 62 61 73 65 20  l mode database 
0460: 77 69 74 68 20 61 6e 20 65 6d 70 74 79 20 77 61  with an empty wa
0470: 6c 20 66 69 6c 65 20 69 73 20 6f 70 65 6e 65 64  l file is opened
0480: 2e 20 42 75 74 20 69 74 20 69 73 20 61 66 74 65  . But it is afte
0490: 72 0a 23 20 74 68 65 20 66 69 6c 65 20 68 61 73  r.# the file has
04a0: 20 62 65 65 6e 20 77 72 69 74 74 65 6e 2c 20 65   been written, e
04b0: 76 65 6e 20 62 79 20 73 6f 6d 65 20 6f 74 68 65  ven by some othe
04c0: 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 2e 0a 23 0a  r connection..#.
04d0: 64 6f 5f 65 78 65 63 73 71 6c 5f 74 65 73 74 20  do_execsql_test 
04e0: 31 2e 30 20 7b 0a 20 20 50 52 41 47 4d 41 20 6a  1.0 {.  PRAGMA j
04f0: 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20 3d 20 77 61  ournal_mode = wa
0500: 6c 3b 0a 20 20 43 52 45 41 54 45 20 54 41 42 4c  l;.  CREATE TABL
0510: 45 20 74 31 28 61 2c 20 62 2c 20 63 29 3b 0a 20  E t1(a, b, c);. 
0520: 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 31 20   INSERT INTO t1 
0530: 56 41 4c 55 45 53 28 31 2c 20 32 2c 20 33 29 3b  VALUES(1, 2, 3);
0540: 0a 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74  .  INSERT INTO t
0550: 31 20 56 41 4c 55 45 53 28 34 2c 20 35 2c 20 36  1 VALUES(4, 5, 6
0560: 29 3b 0a 7d 20 7b 77 61 6c 7d 0a 0a 64 62 20 63  );.} {wal}..db c
0570: 6c 6f 73 65 0a 64 6f 5f 74 65 73 74 20 31 2e 31  lose.do_test 1.1
0580: 2e 31 20 7b 20 6c 69 73 74 20 5b 66 69 6c 65 20  .1 { list [file 
0590: 65 78 69 73 74 73 20 74 65 73 74 2e 64 62 5d 20  exists test.db] 
05a0: 5b 66 69 6c 65 20 65 78 69 73 74 73 20 74 65 73  [file exists tes
05b0: 74 2e 64 62 2d 77 61 6c 5d 20 7d 20 7b 31 20 30  t.db-wal] } {1 0
05c0: 7d 0a 0a 73 71 6c 69 74 65 33 20 64 62 20 74 65  }..sqlite3 db te
05d0: 73 74 2e 64 62 0a 64 6f 5f 65 78 65 63 73 71 6c  st.db.do_execsql
05e0: 5f 74 65 73 74 20 31 2e 31 2e 32 20 7b 20 53 45  _test 1.1.2 { SE
05f0: 4c 45 43 54 20 2a 20 46 52 4f 4d 20 74 31 20 7d  LECT * FROM t1 }
0600: 20 7b 31 20 32 20 33 20 34 20 35 20 36 7d 0a 0a   {1 2 3 4 5 6}..
0610: 64 6f 5f 74 65 73 74 20 31 2e 31 2e 33 20 7b 0a  do_test 1.1.3 {.
0620: 20 20 65 78 65 63 73 71 6c 20 42 45 47 49 4e 0a    execsql BEGIN.
0630: 20 20 6c 69 73 74 20 5b 63 61 74 63 68 20 7b 20    list [catch { 
0640: 73 71 6c 69 74 65 33 5f 73 6e 61 70 73 68 6f 74  sqlite3_snapshot
0650: 5f 67 65 74 5f 62 6c 6f 62 20 64 62 20 6d 61 69  _get_blob db mai
0660: 6e 20 7d 20 6d 73 67 5d 20 24 6d 73 67 0a 7d 20  n } msg] $msg.} 
0670: 7b 31 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 7d  {1 SQLITE_ERROR}
0680: 0a 65 78 65 63 73 71 6c 20 43 4f 4d 4d 49 54 0a  .execsql COMMIT.
0690: 0a 64 6f 5f 74 65 73 74 20 31 2e 31 2e 34 20 7b  .do_test 1.1.4 {
06a0: 0a 20 20 65 78 65 63 73 71 6c 20 7b 20 49 4e 53  .  execsql { INS
06b0: 45 52 54 20 49 4e 54 4f 20 74 31 20 56 41 4c 55  ERT INTO t1 VALU
06c0: 45 53 28 37 2c 20 38 2c 20 39 29 20 7d 0a 20 20  ES(7, 8, 9) }.  
06d0: 65 78 65 63 73 71 6c 20 42 45 47 49 4e 0a 20 20  execsql BEGIN.  
06e0: 73 74 72 69 6e 67 20 6c 65 6e 67 74 68 20 5b 73  string length [s
06f0: 71 6c 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f  qlite3_snapshot_
0700: 67 65 74 5f 62 6c 6f 62 20 64 62 20 6d 61 69 6e  get_blob db main
0710: 5d 0a 7d 20 34 38 0a 65 78 65 63 73 71 6c 20 43  ].} 48.execsql C
0720: 4f 4d 4d 49 54 0a 0a 64 62 20 63 6c 6f 73 65 0a  OMMIT..db close.
0730: 64 6f 5f 74 65 73 74 20 31 2e 32 2e 31 20 7b 20  do_test 1.2.1 { 
0740: 6c 69 73 74 20 5b 66 69 6c 65 20 65 78 69 73 74  list [file exist
0750: 73 20 74 65 73 74 2e 64 62 5d 20 5b 66 69 6c 65  s test.db] [file
0760: 20 65 78 69 73 74 73 20 74 65 73 74 2e 64 62 2d   exists test.db-
0770: 77 61 6c 5d 20 7d 20 7b 31 20 30 7d 0a 0a 73 71  wal] } {1 0}..sq
0780: 6c 69 74 65 33 20 64 62 20 74 65 73 74 2e 64 62  lite3 db test.db
0790: 0a 64 6f 5f 65 78 65 63 73 71 6c 5f 74 65 73 74  .do_execsql_test
07a0: 20 31 2e 32 2e 32 20 7b 20 53 45 4c 45 43 54 20   1.2.2 { SELECT 
07b0: 2a 20 46 52 4f 4d 20 74 31 20 7d 20 7b 31 20 32  * FROM t1 } {1 2
07c0: 20 33 20 34 20 35 20 36 20 37 20 38 20 39 7d 0a   3 4 5 6 7 8 9}.
07d0: 0a 64 6f 5f 74 65 73 74 20 31 2e 32 2e 33 20 7b  .do_test 1.2.3 {
07e0: 0a 20 20 65 78 65 63 73 71 6c 20 42 45 47 49 4e  .  execsql BEGIN
07f0: 0a 20 20 6c 69 73 74 20 5b 63 61 74 63 68 20 7b  .  list [catch {
0800: 20 73 71 6c 69 74 65 33 5f 73 6e 61 70 73 68 6f   sqlite3_snapsho
0810: 74 5f 67 65 74 5f 62 6c 6f 62 20 64 62 20 6d 61  t_get_blob db ma
0820: 69 6e 20 7d 20 6d 73 67 5d 20 24 6d 73 67 0a 7d  in } msg] $msg.}
0830: 20 7b 31 20 53 51 4c 49 54 45 5f 45 52 52 4f 52   {1 SQLITE_ERROR
0840: 7d 0a 65 78 65 63 73 71 6c 20 43 4f 4d 4d 49 54  }.execsql COMMIT
0850: 0a 0a 64 6f 5f 74 65 73 74 20 31 2e 32 2e 34 20  ..do_test 1.2.4 
0860: 7b 0a 20 20 73 71 6c 69 74 65 33 20 64 62 32 20  {.  sqlite3 db2 
0870: 74 65 73 74 2e 64 62 0a 20 20 65 78 65 63 73 71  test.db.  execsq
0880: 6c 20 7b 20 49 4e 53 45 52 54 20 49 4e 54 4f 20  l { INSERT INTO 
0890: 74 31 20 56 41 4c 55 45 53 28 31 30 2c 20 31 31  t1 VALUES(10, 11
08a0: 2c 20 31 32 29 20 7d 20 64 62 32 0a 20 20 65 78  , 12) } db2.  ex
08b0: 65 63 73 71 6c 20 42 45 47 49 4e 0a 20 20 73 74  ecsql BEGIN.  st
08c0: 72 69 6e 67 20 6c 65 6e 67 74 68 20 5b 73 71 6c  ring length [sql
08d0: 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f 67 65  ite3_snapshot_ge
08e0: 74 5f 62 6c 6f 62 20 64 62 20 6d 61 69 6e 5d 0a  t_blob db main].
08f0: 7d 20 34 38 0a 65 78 65 63 73 71 6c 20 43 4f 4d  } 48.execsql COM
0900: 4d 49 54 0a 64 62 32 20 63 6c 6f 73 65 0a 0a 23  MIT.db2 close..#
0910: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0920: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0930: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0940: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0950: 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 53 69 6d 70  ---------.# Simp
0960: 6c 65 20 74 65 73 74 73 20 66 6f 72 20 73 71 6c  le tests for sql
0970: 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f 72 65  ite3_snapshot_re
0980: 63 6f 76 65 72 28 29 2e 0a 23 0a 72 65 73 65 74  cover()..#.reset
0990: 5f 64 62 0a 64 6f 5f 65 78 65 63 73 71 6c 5f 74  _db.do_execsql_t
09a0: 65 73 74 20 32 2e 30 20 7b 0a 20 20 43 52 45 41  est 2.0 {.  CREA
09b0: 54 45 20 54 41 42 4c 45 20 74 31 28 78 29 3b 0a  TE TABLE t1(x);.
09c0: 20 20 50 52 41 47 4d 41 20 6a 6f 75 72 6e 61 6c    PRAGMA journal
09d0: 5f 6d 6f 64 65 20 3d 20 77 61 6c 3b 0a 20 20 49  _mode = wal;.  I
09e0: 4e 53 45 52 54 20 49 4e 54 4f 20 74 31 20 56 41  NSERT INTO t1 VA
09f0: 4c 55 45 53 28 31 29 3b 0a 20 20 49 4e 53 45 52  LUES(1);.  INSER
0a00: 54 20 49 4e 54 4f 20 74 31 20 56 41 4c 55 45 53  T INTO t1 VALUES
0a10: 28 32 29 3b 0a 7d 20 7b 77 61 6c 7d 0a 0a 64 6f  (2);.} {wal}..do
0a20: 5f 74 65 73 74 20 32 2e 31 20 7b 0a 20 20 64 62  _test 2.1 {.  db
0a30: 20 74 72 61 6e 73 20 7b 20 73 65 74 20 73 6e 61   trans { set sna
0a40: 70 20 5b 73 71 6c 69 74 65 33 5f 73 6e 61 70 73  p [sqlite3_snaps
0a50: 68 6f 74 5f 67 65 74 5f 62 6c 6f 62 20 64 62 20  hot_get_blob db 
0a60: 6d 61 69 6e 5d 20 7d 0a 20 20 73 71 6c 69 74 65  main] }.  sqlite
0a70: 33 5f 64 62 5f 63 6f 6e 66 69 67 20 64 62 20 4e  3_db_config db N
0a80: 4f 5f 43 4b 50 54 5f 4f 4e 5f 43 4c 4f 53 45 20  O_CKPT_ON_CLOSE 
0a90: 31 0a 20 20 64 62 20 63 6c 6f 73 65 0a 20 20 73  1.  db close.  s
0aa0: 71 6c 69 74 65 33 20 64 62 20 74 65 73 74 2e 64  qlite3 db test.d
0ab0: 62 0a 0a 20 20 65 78 65 63 73 71 6c 20 7b 53 45  b..  execsql {SE
0ac0: 4c 45 43 54 20 2a 20 46 52 4f 4d 20 73 71 6c 69  LECT * FROM sqli
0ad0: 74 65 5f 6d 61 73 74 65 72 7d 0a 20 20 65 78 65  te_master}.  exe
0ae0: 63 73 71 6c 20 42 45 47 49 4e 0a 20 20 73 71 6c  csql BEGIN.  sql
0af0: 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f 6f 70  ite3_snapshot_op
0b00: 65 6e 5f 62 6c 6f 62 20 64 62 20 6d 61 69 6e 20  en_blob db main 
0b10: 24 73 6e 61 70 0a 20 20 65 78 65 63 73 71 6c 20  $snap.  execsql 
0b20: 43 4f 4d 4d 49 54 3b 0a 20 20 65 78 65 63 73 71  COMMIT;.  execsq
0b30: 6c 20 7b 20 49 4e 53 45 52 54 20 49 4e 54 4f 20  l { INSERT INTO 
0b40: 74 31 20 56 41 4c 55 45 53 28 33 29 3b 20 7d 0a  t1 VALUES(3); }.
0b50: 7d 20 7b 7d 0a 0a 64 6f 5f 74 65 73 74 20 32 2e  } {}..do_test 2.
0b60: 32 20 7b 0a 20 20 73 71 6c 69 74 65 33 5f 64 62  2 {.  sqlite3_db
0b70: 5f 63 6f 6e 66 69 67 20 64 62 20 4e 4f 5f 43 4b  _config db NO_CK
0b80: 50 54 5f 4f 4e 5f 43 4c 4f 53 45 20 31 0a 20 20  PT_ON_CLOSE 1.  
0b90: 64 62 20 63 6c 6f 73 65 0a 20 20 73 71 6c 69 74  db close.  sqlit
0ba0: 65 33 20 64 62 20 74 65 73 74 2e 64 62 0a 0a 20  e3 db test.db.. 
0bb0: 20 65 78 65 63 73 71 6c 20 7b 53 45 4c 45 43 54   execsql {SELECT
0bc0: 20 2a 20 46 52 4f 4d 20 73 71 6c 69 74 65 5f 6d   * FROM sqlite_m
0bd0: 61 73 74 65 72 7d 0a 20 20 65 78 65 63 73 71 6c  aster}.  execsql
0be0: 20 42 45 47 49 4e 0a 20 20 6c 69 73 74 20 5b 63   BEGIN.  list [c
0bf0: 61 74 63 68 20 7b 20 73 71 6c 69 74 65 33 5f 73  atch { sqlite3_s
0c00: 6e 61 70 73 68 6f 74 5f 6f 70 65 6e 5f 62 6c 6f  napshot_open_blo
0c10: 62 20 64 62 20 6d 61 69 6e 20 24 73 6e 61 70 20  b db main $snap 
0c20: 7d 20 6d 73 67 5d 20 24 6d 73 67 0a 7d 20 7b 31  } msg] $msg.} {1
0c30: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 5f 53 4e   SQLITE_ERROR_SN
0c40: 41 50 53 48 4f 54 7d 0a 0a 64 6f 5f 74 65 73 74  APSHOT}..do_test
0c50: 20 32 2e 33 20 7b 0a 20 20 65 78 65 63 73 71 6c   2.3 {.  execsql
0c60: 20 43 4f 4d 4d 49 54 0a 20 20 73 71 6c 69 74 65   COMMIT.  sqlite
0c70: 33 5f 73 6e 61 70 73 68 6f 74 5f 72 65 63 6f 76  3_snapshot_recov
0c80: 65 72 20 64 62 20 6d 61 69 6e 0a 20 20 65 78 65  er db main.  exe
0c90: 63 73 71 6c 20 42 45 47 49 4e 0a 20 20 73 71 6c  csql BEGIN.  sql
0ca0: 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f 6f 70  ite3_snapshot_op
0cb0: 65 6e 5f 62 6c 6f 62 20 64 62 20 6d 61 69 6e 20  en_blob db main 
0cc0: 24 73 6e 61 70 0a 20 20 65 78 65 63 73 71 6c 20  $snap.  execsql 
0cd0: 7b 20 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20  { SELECT * FROM 
0ce0: 74 31 20 7d 0a 7d 20 7b 31 20 32 7d 0a 0a 64 6f  t1 }.} {1 2}..do
0cf0: 5f 74 65 73 74 20 32 2e 34 20 7b 0a 20 20 65 78  _test 2.4 {.  ex
0d00: 65 63 73 71 6c 20 43 4f 4d 4d 49 54 0a 20 20 65  ecsql COMMIT.  e
0d10: 78 65 63 73 71 6c 20 7b 20 53 45 4c 45 43 54 20  xecsql { SELECT 
0d20: 2a 20 46 52 4f 4d 20 74 31 20 7d 0a 7d 20 7b 31  * FROM t1 }.} {1
0d30: 20 32 20 33 7d 0a 0a 64 6f 5f 74 65 73 74 20 32   2 3}..do_test 2
0d40: 2e 35 20 7b 0a 20 20 65 78 65 63 73 71 6c 20 7b  .5 {.  execsql {
0d50: 20 50 52 41 47 4d 41 20 77 61 6c 5f 63 68 65 63   PRAGMA wal_chec
0d60: 6b 70 6f 69 6e 74 20 7d 0a 20 20 73 71 6c 69 74  kpoint }.  sqlit
0d70: 65 33 5f 64 62 5f 63 6f 6e 66 69 67 20 64 62 20  e3_db_config db 
0d80: 4e 4f 5f 43 4b 50 54 5f 4f 4e 5f 43 4c 4f 53 45  NO_CKPT_ON_CLOSE
0d90: 20 31 0a 20 20 64 62 20 63 6c 6f 73 65 0a 20 20   1.  db close.  
0da0: 73 71 6c 69 74 65 33 20 64 62 20 74 65 73 74 2e  sqlite3 db test.
0db0: 64 62 0a 0a 20 20 73 71 6c 69 74 65 33 5f 73 6e  db..  sqlite3_sn
0dc0: 61 70 73 68 6f 74 5f 72 65 63 6f 76 65 72 20 64  apshot_recover d
0dd0: 62 20 6d 61 69 6e 0a 20 20 65 78 65 63 73 71 6c  b main.  execsql
0de0: 20 42 45 47 49 4e 0a 20 20 6c 69 73 74 20 5b 63   BEGIN.  list [c
0df0: 61 74 63 68 20 7b 20 73 71 6c 69 74 65 33 5f 73  atch { sqlite3_s
0e00: 6e 61 70 73 68 6f 74 5f 6f 70 65 6e 5f 62 6c 6f  napshot_open_blo
0e10: 62 20 64 62 20 6d 61 69 6e 20 24 73 6e 61 70 20  b db main $snap 
0e20: 7d 20 6d 73 67 5d 20 24 6d 73 67 0a 7d 20 7b 31  } msg] $msg.} {1
0e30: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 5f 53 4e   SQLITE_ERROR_SN
0e40: 41 50 53 48 4f 54 7d 0a 0a 23 2d 2d 2d 2d 2d 2d  APSHOT}..#------
0e50: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0e60: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0e70: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0e80: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0e90: 2d 2d 2d 0a 23 20 43 68 65 63 6b 20 74 68 61 74  ---.# Check that
0ea0: 20 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 65 33   calling sqlite3
0eb0: 5f 73 6e 61 70 73 68 6f 74 5f 72 65 63 6f 76 65  _snapshot_recove
0ec0: 72 28 29 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6e  r() does not con
0ed0: 66 75 73 65 20 74 68 65 0a 23 20 70 61 67 65 72  fuse the.# pager
0ee0: 20 63 61 63 68 65 2e 0a 72 65 73 65 74 5f 64 62   cache..reset_db
0ef0: 0a 64 6f 5f 65 78 65 63 73 71 6c 5f 74 65 73 74  .do_execsql_test
0f00: 20 33 2e 30 20 7b 0a 20 20 50 52 41 47 4d 41 20   3.0 {.  PRAGMA 
0f10: 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20 3d 20 77  journal_mode = w
0f20: 61 6c 3b 0a 20 20 43 52 45 41 54 45 20 54 41 42  al;.  CREATE TAB
0f30: 4c 45 20 74 31 28 78 2c 20 79 29 3b 0a 20 20 49  LE t1(x, y);.  I
0f40: 4e 53 45 52 54 20 49 4e 54 4f 20 74 31 20 56 41  NSERT INTO t1 VA
0f50: 4c 55 45 53 28 27 61 27 2c 20 27 62 27 29 3b 0a  LUES('a', 'b');.
0f60: 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 31    INSERT INTO t1
0f70: 20 56 41 4c 55 45 53 28 27 63 27 2c 20 27 64 27   VALUES('c', 'd'
0f80: 29 3b 0a 7d 20 7b 77 61 6c 7d 0a 64 6f 5f 74 65  );.} {wal}.do_te
0f90: 73 74 20 33 2e 31 20 7b 0a 20 20 73 71 6c 69 74  st 3.1 {.  sqlit
0fa0: 65 33 20 64 62 32 20 74 65 73 74 2e 64 62 0a 20  e3 db2 test.db. 
0fb0: 20 65 78 65 63 73 71 6c 20 7b 20 49 4e 53 45 52   execsql { INSER
0fc0: 54 20 49 4e 54 4f 20 74 31 20 56 41 4c 55 45 53  T INTO t1 VALUES
0fd0: 28 27 65 27 2c 20 27 66 27 29 20 7d 20 64 62 32  ('e', 'f') } db2
0fe0: 0a 20 20 64 62 32 20 63 6c 6f 73 65 0a 20 20 73  .  db2 close.  s
0ff0: 71 6c 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f  qlite3_snapshot_
1000: 72 65 63 6f 76 65 72 20 64 62 20 6d 61 69 6e 0a  recover db main.
1010: 7d 20 7b 7d 0a 64 6f 5f 65 78 65 63 73 71 6c 5f  } {}.do_execsql_
1020: 74 65 73 74 20 33 2e 32 20 7b 0a 20 20 53 45 4c  test 3.2 {.  SEL
1030: 45 43 54 20 2a 20 46 52 4f 4d 20 74 31 3b 0a 7d  ECT * FROM t1;.}
1040: 20 7b 61 20 62 20 63 20 64 20 65 20 66 7d 0a 0a   {a b c d e f}..
1050: 23 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  #---------------
1060: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1070: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1080: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1090: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 23 20 43 68 65  ----------.# Che
10a0: 63 6b 20 74 68 61 74 20 73 71 6c 69 74 65 33 5f  ck that sqlite3_
10b0: 73 6e 61 70 73 68 6f 74 5f 72 65 63 6f 76 65 72  snapshot_recover
10c0: 28 29 20 72 65 74 75 72 6e 73 20 61 6e 20 65 72  () returns an er
10d0: 72 6f 72 20 69 66 20 69 74 20 69 73 20 63 61 6c  ror if it is cal
10e0: 6c 65 64 0a 23 20 77 69 74 68 20 61 6e 20 6f 70  led.# with an op
10f0: 65 6e 20 72 65 61 64 2d 74 72 61 6e 73 61 63 74  en read-transact
1100: 69 6f 6e 2e 20 4f 72 20 6f 6e 20 61 20 64 61 74  ion. Or on a dat
1110: 61 62 61 73 65 20 74 68 61 74 20 64 6f 65 73 20  abase that does 
1120: 6e 6f 74 20 65 78 69 73 74 2e 20 4f 72 0a 23 20  not exist. Or.# 
1130: 6f 6e 20 74 68 65 20 74 65 6d 70 20 64 61 74 61  on the temp data
1140: 62 61 73 65 2e 20 4f 72 20 6f 6e 20 61 20 64 62  base. Or on a db
1150: 20 74 68 61 74 20 69 73 20 6e 6f 74 20 69 6e 20   that is not in 
1160: 77 61 6c 20 6d 6f 64 65 2e 0a 23 0a 64 6f 5f 74  wal mode..#.do_t
1170: 65 73 74 20 34 2e 31 20 7b 0a 20 20 73 71 6c 69  est 4.1 {.  sqli
1180: 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f 72 65 63  te3_snapshot_rec
1190: 6f 76 65 72 20 64 62 20 6d 61 69 6e 0a 7d 20 7b  over db main.} {
11a0: 7d 0a 64 6f 5f 74 65 73 74 20 34 2e 32 20 7b 0a  }.do_test 4.2 {.
11b0: 20 20 65 78 65 63 73 71 6c 20 7b 0a 20 20 20 20    execsql {.    
11c0: 42 45 47 49 4e 3b 0a 20 20 20 20 20 20 53 45 4c  BEGIN;.      SEL
11d0: 45 43 54 20 2a 20 46 52 4f 4d 20 73 71 6c 69 74  ECT * FROM sqlit
11e0: 65 5f 6d 61 73 74 65 72 3b 0a 20 20 7d 0a 20 20  e_master;.  }.  
11f0: 6c 69 73 74 20 5b 63 61 74 63 68 20 7b 20 73 71  list [catch { sq
1200: 6c 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f 72  lite3_snapshot_r
1210: 65 63 6f 76 65 72 20 64 62 20 6d 61 69 6e 20 7d  ecover db main }
1220: 20 6d 73 67 5d 20 24 6d 73 67 0a 7d 20 7b 31 20   msg] $msg.} {1 
1230: 53 51 4c 49 54 45 5f 45 52 52 4f 52 7d 0a 64 6f  SQLITE_ERROR}.do
1240: 5f 74 65 73 74 20 34 2e 33 20 7b 0a 20 20 65 78  _test 4.3 {.  ex
1250: 65 63 73 71 6c 20 43 4f 4d 4d 49 54 0a 20 20 73  ecsql COMMIT.  s
1260: 71 6c 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f  qlite3_snapshot_
1270: 72 65 63 6f 76 65 72 20 64 62 20 6d 61 69 6e 0a  recover db main.
1280: 7d 20 7b 7d 0a 64 6f 5f 74 65 73 74 20 34 2e 34  } {}.do_test 4.4
1290: 20 7b 0a 20 20 6c 69 73 74 20 5b 63 61 74 63 68   {.  list [catch
12a0: 20 7b 20 73 71 6c 69 74 65 33 5f 73 6e 61 70 73   { sqlite3_snaps
12b0: 68 6f 74 5f 72 65 63 6f 76 65 72 20 64 62 20 61  hot_recover db a
12c0: 75 78 20 7d 20 6d 73 67 5d 20 24 6d 73 67 0a 7d  ux } msg] $msg.}
12d0: 20 7b 31 20 53 51 4c 49 54 45 5f 45 52 52 4f 52   {1 SQLITE_ERROR
12e0: 7d 0a 64 6f 5f 74 65 73 74 20 34 2e 35 20 7b 0a  }.do_test 4.5 {.
12f0: 20 20 66 6f 72 63 65 64 65 6c 65 74 65 20 74 65    forcedelete te
1300: 73 74 2e 64 62 32 0a 20 20 65 78 65 63 73 71 6c  st.db2.  execsql
1310: 20 7b 0a 20 20 20 20 41 54 54 41 43 48 20 27 74   {.    ATTACH 't
1320: 65 73 74 2e 64 62 32 27 20 41 53 20 61 75 78 3b  est.db2' AS aux;
1330: 0a 20 20 20 20 50 52 41 47 4d 41 20 61 75 78 2e  .    PRAGMA aux.
1340: 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20 3d 20 77  journal_mode = w
1350: 61 6c 3b 0a 20 20 20 20 43 52 45 41 54 45 20 54  al;.    CREATE T
1360: 41 42 4c 45 20 61 75 78 2e 74 32 28 78 2c 20 79  ABLE aux.t2(x, y
1370: 29 3b 0a 20 20 7d 0a 20 20 6c 69 73 74 20 5b 63  );.  }.  list [c
1380: 61 74 63 68 20 7b 20 73 71 6c 69 74 65 33 5f 73  atch { sqlite3_s
1390: 6e 61 70 73 68 6f 74 5f 72 65 63 6f 76 65 72 20  napshot_recover 
13a0: 64 62 20 61 75 78 20 7d 20 6d 73 67 5d 20 24 6d  db aux } msg] $m
13b0: 73 67 0a 7d 20 7b 30 20 7b 7d 7d 0a 64 6f 5f 74  sg.} {0 {}}.do_t
13c0: 65 73 74 20 34 2e 36 20 7b 0a 20 20 6c 69 73 74  est 4.6 {.  list
13d0: 20 5b 63 61 74 63 68 20 7b 20 73 71 6c 69 74 65   [catch { sqlite
13e0: 33 5f 73 6e 61 70 73 68 6f 74 5f 72 65 63 6f 76  3_snapshot_recov
13f0: 65 72 20 64 62 20 74 65 6d 70 20 7d 20 6d 73 67  er db temp } msg
1400: 5d 20 24 6d 73 67 0a 7d 20 7b 31 20 53 51 4c 49  ] $msg.} {1 SQLI
1410: 54 45 5f 45 52 52 4f 52 7d 0a 64 6f 5f 74 65 73  TE_ERROR}.do_tes
1420: 74 20 34 2e 37 20 7b 0a 20 20 65 78 65 63 73 71  t 4.7 {.  execsq
1430: 6c 20 7b 0a 20 20 20 20 50 52 41 47 4d 41 20 61  l {.    PRAGMA a
1440: 75 78 2e 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20  ux.journal_mode 
1450: 3d 20 64 65 6c 65 74 65 3b 0a 20 20 7d 0a 20 20  = delete;.  }.  
1460: 6c 69 73 74 20 5b 63 61 74 63 68 20 7b 20 73 71  list [catch { sq
1470: 6c 69 74 65 33 5f 73 6e 61 70 73 68 6f 74 5f 72  lite3_snapshot_r
1480: 65 63 6f 76 65 72 20 64 62 20 61 75 78 20 7d 20  ecover db aux } 
1490: 6d 73 67 5d 20 24 6d 73 67 0a 7d 20 7b 31 20 53  msg] $msg.} {1 S
14a0: 51 4c 49 54 45 5f 45 52 52 4f 52 7d 0a 0a 23 2d  QLITE_ERROR}..#-
14b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
14c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
14d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
14e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
14f0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 72 65 73 65 74 5f 64  --------.reset_d
1500: 62 0a 73 71 6c 69 74 65 33 20 64 62 32 20 74 65  b.sqlite3 db2 te
1510: 73 74 2e 64 62 20 0a 64 6f 5f 65 78 65 63 73 71  st.db .do_execsq
1520: 6c 5f 74 65 73 74 20 35 2e 30 20 7b 0a 20 20 43  l_test 5.0 {.  C
1530: 52 45 41 54 45 20 54 41 42 4c 45 20 74 32 28 78  REATE TABLE t2(x
1540: 29 3b 0a 20 20 50 52 41 47 4d 41 20 6a 6f 75 72  );.  PRAGMA jour
1550: 6e 61 6c 5f 6d 6f 64 65 20 3d 20 77 61 6c 3b 0a  nal_mode = wal;.
1560: 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 32    INSERT INTO t2
1570: 20 56 41 4c 55 45 53 28 27 61 62 63 27 29 3b 0a   VALUES('abc');.
1580: 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 32    INSERT INTO t2
1590: 20 56 41 4c 55 45 53 28 27 64 65 66 27 29 3b 0a   VALUES('def');.
15a0: 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 32    INSERT INTO t2
15b0: 20 56 41 4c 55 45 53 28 27 67 68 69 27 29 3b 0a   VALUES('ghi');.
15c0: 7d 20 7b 77 61 6c 7d 0a 0a 64 6f 5f 74 65 73 74  } {wal}..do_test
15d0: 20 35 2e 31 20 7b 0a 20 20 65 78 65 63 73 71 6c   5.1 {.  execsql
15e0: 20 7b 20 0a 20 20 20 20 53 45 4c 45 43 54 20 2a   { .    SELECT *
15f0: 20 46 52 4f 4d 20 74 32 3b 0a 20 20 20 20 42 45   FROM t2;.    BE
1600: 47 49 4e 3b 0a 20 20 7d 20 64 62 32 0a 20 20 73  GIN;.  } db2.  s
1610: 65 74 20 73 6e 61 70 20 5b 73 71 6c 69 74 65 33  et snap [sqlite3
1620: 5f 73 6e 61 70 73 68 6f 74 5f 67 65 74 5f 62 6c  _snapshot_get_bl
1630: 6f 62 20 64 62 32 20 6d 61 69 6e 5d 0a 20 20 64  ob db2 main].  d
1640: 62 32 20 65 76 61 6c 20 45 4e 44 0a 7d 20 7b 7d  b2 eval END.} {}
1650: 0a 0a 64 6f 5f 74 65 73 74 20 35 2e 32 20 7b 0a  ..do_test 5.2 {.
1660: 20 20 65 78 65 63 73 71 6c 20 42 45 47 49 4e 20    execsql BEGIN 
1670: 64 62 32 0a 20 20 73 71 6c 69 74 65 33 5f 73 6e  db2.  sqlite3_sn
1680: 61 70 73 68 6f 74 5f 6f 70 65 6e 5f 62 6c 6f 62  apshot_open_blob
1690: 20 64 62 32 20 6d 61 69 6e 20 24 73 6e 61 70 0a   db2 main $snap.
16a0: 20 20 64 62 32 20 65 76 61 6c 20 7b 20 53 45 4c    db2 eval { SEL
16b0: 45 43 54 20 2a 20 46 52 4f 4d 20 74 32 20 3b 20  ECT * FROM t2 ; 
16c0: 45 4e 44 20 7d 0a 7d 20 7b 61 62 63 20 64 65 66  END }.} {abc def
16d0: 20 67 68 69 7d 0a 0a 64 6f 5f 74 65 73 74 20 35   ghi}..do_test 5
16e0: 2e 33 20 7b 0a 20 20 65 78 65 63 73 71 6c 20 7b  .3 {.  execsql {
16f0: 20 50 52 41 47 4d 41 20 77 61 6c 5f 63 68 65 63   PRAGMA wal_chec
1700: 6b 70 6f 69 6e 74 20 3d 20 52 45 53 54 41 52 54  kpoint = RESTART
1710: 20 7d 0a 20 20 65 78 65 63 73 71 6c 20 42 45 47   }.  execsql BEG
1720: 49 4e 20 64 62 32 0a 20 20 73 71 6c 69 74 65 33  IN db2.  sqlite3
1730: 5f 73 6e 61 70 73 68 6f 74 5f 6f 70 65 6e 5f 62  _snapshot_open_b
1740: 6c 6f 62 20 64 62 32 20 6d 61 69 6e 20 24 73 6e  lob db2 main $sn
1750: 61 70 0a 20 20 64 62 32 20 65 76 61 6c 20 7b 20  ap.  db2 eval { 
1760: 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20 74 32  SELECT * FROM t2
1770: 20 3b 20 45 4e 44 20 7d 0a 7d 20 7b 61 62 63 20   ; END }.} {abc 
1780: 64 65 66 20 67 68 69 7d 0a 0a 64 6f 5f 74 65 73  def ghi}..do_tes
1790: 74 20 35 2e 34 20 7b 0a 20 20 65 78 65 63 73 71  t 5.4 {.  execsq
17a0: 6c 20 7b 20 49 4e 53 45 52 54 20 49 4e 54 4f 20  l { INSERT INTO 
17b0: 74 32 20 56 41 4c 55 45 53 28 27 6a 6b 6c 27 29  t2 VALUES('jkl')
17c0: 20 7d 20 0a 20 20 65 78 65 63 73 71 6c 20 42 45   } .  execsql BE
17d0: 47 49 4e 20 64 62 32 0a 20 20 6c 69 73 74 20 5b  GIN db2.  list [
17e0: 63 61 74 63 68 20 7b 20 73 71 6c 69 74 65 33 5f  catch { sqlite3_
17f0: 73 6e 61 70 73 68 6f 74 5f 6f 70 65 6e 5f 62 6c  snapshot_open_bl
1800: 6f 62 20 64 62 32 20 6d 61 69 6e 20 24 73 6e 61  ob db2 main $sna
1810: 70 20 7d 20 6d 73 67 5d 20 24 6d 73 67 0a 7d 20  p } msg] $msg.} 
1820: 7b 31 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 5f  {1 SQLITE_ERROR_
1830: 53 4e 41 50 53 48 4f 54 7d 0a 0a 0a 66 69 6e 69  SNAPSHOT}...fini
1840: 73 68 5f 74 65 73 74 0a                          sh_test.