/ Hex Artifact Content
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Artifact 01b494287ba9e60b70f6ebf3c6c62e0ffe01788e344a4846b08e5de0b344cb66:


0000: 23 20 32 30 31 34 20 44 65 63 65 6d 62 65 72 20  # 2014 December 
0010: 30 34 0a 23 0a 23 20 54 68 65 20 61 75 74 68 6f  04.#.# 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 0a 0a 73 65 74 20  ********.#..set 
0170: 74 65 73 74 64 69 72 20 5b 66 69 6c 65 20 64 69  testdir [file di
0180: 72 6e 61 6d 65 20 24 61 72 67 76 30 5d 0a 73 6f  rname $argv0].so
0190: 75 72 63 65 20 24 74 65 73 74 64 69 72 2f 74 65  urce $testdir/te
01a0: 73 74 65 72 2e 74 63 6c 0a 73 6f 75 72 63 65 20  ster.tcl.source 
01b0: 24 74 65 73 74 64 69 72 2f 77 61 6c 5f 63 6f 6d  $testdir/wal_com
01c0: 6d 6f 6e 2e 74 63 6c 0a 73 65 74 20 74 65 73 74  mon.tcl.set test
01d0: 70 72 65 66 69 78 20 65 5f 77 61 6c 68 6f 6f 6b  prefix e_walhook
01e0: 0a 0a 0a 23 20 45 56 49 44 45 4e 43 45 2d 4f 46  ...# EVIDENCE-OF
01f0: 3a 20 52 2d 30 30 37 35 32 2d 34 33 39 37 35 20  : R-00752-43975 
0200: 54 68 65 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f  The sqlite3_wal_
0210: 68 6f 6f 6b 28 29 20 66 75 6e 63 74 69 6f 6e 20  hook() function 
0220: 69 73 20 75 73 65 64 20 74 6f 0a 23 20 72 65 67  is used to.# reg
0230: 69 73 74 65 72 20 61 20 63 61 6c 6c 62 61 63 6b  ister a callback
0240: 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b 65 64   that is invoked
0250: 20 65 61 63 68 20 74 69 6d 65 20 64 61 74 61 20   each time data 
0260: 69 73 20 63 6f 6d 6d 69 74 74 65 64 20 74 6f 20  is committed to 
0270: 61 0a 23 20 64 61 74 61 62 61 73 65 20 69 6e 20  a.# database in 
0280: 77 61 6c 20 6d 6f 64 65 2e 0a 23 0a 23 20 20 20  wal mode..#.#   
0290: 31 2e 31 3a 20 73 68 6f 77 73 20 74 68 61 74 20  1.1: shows that 
02a0: 74 68 65 20 77 61 6c 2d 68 6f 6f 6b 20 69 73 20  the wal-hook is 
02b0: 6e 6f 74 20 69 6e 76 6f 6b 65 64 20 69 6e 20 72  not invoked in r
02c0: 6f 6c 6c 62 61 63 6b 20 6d 6f 64 65 2e 0a 23 20  ollback mode..# 
02d0: 20 20 31 2e 32 3a 20 62 75 74 20 69 73 20 69 6e    1.2: but is in
02e0: 76 6f 6b 65 64 20 69 6e 20 77 61 6c 20 6d 6f 64  voked in wal mod
02f0: 65 2e 0a 23 0a 73 65 74 20 3a 3a 77 61 6c 5f 68  e..#.set ::wal_h
0300: 6f 6f 6b 5f 63 6f 75 6e 74 20 30 0a 70 72 6f 63  ook_count 0.proc
0310: 20 6d 79 5f 77 61 6c 5f 68 6f 6f 6b 20 7b 61 72   my_wal_hook {ar
0320: 67 73 7d 20 7b 0a 20 20 69 6e 63 72 20 3a 3a 77  gs} {.  incr ::w
0330: 61 6c 5f 68 6f 6f 6b 5f 63 6f 75 6e 74 0a 20 20  al_hook_count.  
0340: 72 65 74 75 72 6e 20 30 0a 7d 0a 0a 64 6f 5f 74  return 0.}..do_t
0350: 65 73 74 20 31 2e 31 2e 31 20 7b 0a 20 20 64 62  est 1.1.1 {.  db
0360: 20 77 61 6c 5f 68 6f 6f 6b 20 6d 79 5f 77 61 6c   wal_hook my_wal
0370: 5f 68 6f 6f 6b 0a 20 20 65 78 65 63 73 71 6c 20  _hook.  execsql 
0380: 7b 0a 20 20 20 20 43 52 45 41 54 45 20 54 41 42  {.    CREATE TAB
0390: 4c 45 20 74 31 28 78 29 3b 0a 20 20 20 20 49 4e  LE t1(x);.    IN
03a0: 53 45 52 54 20 49 4e 54 4f 20 74 31 20 56 41 4c  SERT INTO t1 VAL
03b0: 55 45 53 28 31 29 3b 0a 20 20 7d 0a 20 20 73 65  UES(1);.  }.  se
03c0: 74 20 3a 3a 77 61 6c 5f 68 6f 6f 6b 5f 63 6f 75  t ::wal_hook_cou
03d0: 6e 74 0a 7d 20 30 0a 64 6f 5f 74 65 73 74 20 31  nt.} 0.do_test 1
03e0: 2e 31 2e 32 20 7b 0a 20 20 65 78 65 63 73 71 6c  .1.2 {.  execsql
03f0: 20 7b 20 50 52 41 47 4d 41 20 6a 6f 75 72 6e 61   { PRAGMA journa
0400: 6c 5f 6d 6f 64 65 20 3d 20 77 61 6c 20 7d 0a 20  l_mode = wal }. 
0410: 20 73 65 74 20 3a 3a 77 61 6c 5f 68 6f 6f 6b 5f   set ::wal_hook_
0420: 63 6f 75 6e 74 0a 7d 20 30 0a 0a 64 6f 5f 74 65  count.} 0..do_te
0430: 73 74 20 31 2e 33 20 7b 0a 20 20 65 78 65 63 73  st 1.3 {.  execs
0440: 71 6c 20 7b 20 49 4e 53 45 52 54 20 49 4e 54 4f  ql { INSERT INTO
0450: 20 74 31 20 56 41 4c 55 45 53 28 32 29 20 7d 0a   t1 VALUES(2) }.
0460: 20 20 73 65 74 20 77 61 6c 5f 68 6f 6f 6b 5f 63    set wal_hook_c
0470: 6f 75 6e 74 0a 7d 20 31 0a 0a 64 6f 5f 74 65 73  ount.} 1..do_tes
0480: 74 20 31 2e 34 20 7b 0a 20 20 65 78 65 63 73 71  t 1.4 {.  execsq
0490: 6c 20 7b 20 0a 20 20 20 20 42 45 47 49 4e 3b 0a  l { .    BEGIN;.
04a0: 20 20 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54        INSERT INT
04b0: 4f 20 74 31 20 56 41 4c 55 45 53 28 33 29 3b 0a  O t1 VALUES(3);.
04c0: 20 20 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54        INSERT INT
04d0: 4f 20 74 31 20 56 41 4c 55 45 53 28 34 29 3b 0a  O t1 VALUES(4);.
04e0: 20 20 20 20 43 4f 4d 4d 49 54 3b 0a 20 20 7d 0a      COMMIT;.  }.
04f0: 20 20 73 65 74 20 77 61 6c 5f 68 6f 6f 6b 5f 63    set wal_hook_c
0500: 6f 75 6e 74 0a 7d 20 32 0a 0a 23 20 45 56 49 44  ount.} 2..# EVID
0510: 45 4e 43 45 2d 4f 46 3a 20 52 2d 36 35 33 36 36  ENCE-OF: R-65366
0520: 2d 31 35 31 33 39 20 54 68 65 20 63 61 6c 6c 62  -15139 The callb
0530: 61 63 6b 20 69 73 20 69 6e 76 6f 6b 65 64 20 62  ack is invoked b
0540: 79 20 53 51 4c 69 74 65 20 61 66 74 65 72 20 74  y SQLite after t
0550: 68 65 0a 23 20 63 6f 6d 6d 69 74 20 68 61 73 20  he.# commit has 
0560: 74 61 6b 65 6e 20 70 6c 61 63 65 20 61 6e 64 20  taken place and 
0570: 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 20 77  the associated w
0580: 72 69 74 65 2d 6c 6f 63 6b 20 6f 6e 20 74 68 65  rite-lock on the
0590: 20 64 61 74 61 62 61 73 65 0a 23 20 72 65 6c 65   database.# rele
05a0: 61 73 65 64 0a 23 0a 73 65 74 20 3a 3a 72 65 61  ased.#.set ::rea
05b0: 64 5f 6f 6b 20 30 0a 70 72 6f 63 20 6d 79 5f 77  d_ok 0.proc my_w
05c0: 61 6c 5f 68 6f 6f 6b 20 7b 61 72 67 73 7d 20 7b  al_hook {args} {
05d0: 0a 20 20 73 71 6c 69 74 65 33 20 64 62 32 20 74  .  sqlite3 db2 t
05e0: 65 73 74 2e 64 62 0a 20 20 69 66 20 7b 5b 64 62  est.db.  if {[db
05f0: 32 20 65 76 61 6c 20 7b 20 53 45 4c 45 43 54 20  2 eval { SELECT 
0600: 2a 20 46 52 4f 4d 20 74 31 20 7d 5d 20 3d 3d 20  * FROM t1 }] == 
0610: 22 31 20 32 20 33 20 34 20 35 22 7d 20 7b 0a 20  "1 2 3 4 5"} {. 
0620: 20 20 20 73 65 74 20 3a 3a 72 65 61 64 5f 6f 6b     set ::read_ok
0630: 20 31 0a 20 20 7d 0a 20 20 64 62 32 20 63 6c 6f   1.  }.  db2 clo
0640: 73 65 0a 7d 0a 64 6f 5f 74 65 73 74 20 32 2e 31  se.}.do_test 2.1
0650: 20 7b 0a 20 20 65 78 65 63 73 71 6c 20 7b 20 49   {.  execsql { I
0660: 4e 53 45 52 54 20 49 4e 54 4f 20 74 31 20 56 41  NSERT INTO t1 VA
0670: 4c 55 45 53 28 35 29 20 7d 0a 20 20 73 65 74 20  LUES(5) }.  set 
0680: 3a 3a 72 65 61 64 5f 6f 6b 0a 7d 20 31 0a 0a 23  ::read_ok.} 1..#
0690: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d   EVIDENCE-OF: R-
06a0: 34 34 32 39 34 2d 35 32 38 36 33 20 54 68 65 20  44294-52863 The 
06b0: 74 68 69 72 64 20 70 61 72 61 6d 65 74 65 72 20  third parameter 
06c0: 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  is the name of t
06d0: 68 65 0a 23 20 64 61 74 61 62 61 73 65 20 74 68  he.# database th
06e0: 61 74 20 77 61 73 20 77 72 69 74 74 65 6e 20 74  at was written t
06f0: 6f 20 2d 20 65 69 74 68 65 72 20 22 6d 61 69 6e  o - either "main
0700: 22 20 6f 72 20 74 68 65 20 6e 61 6d 65 20 6f 66  " or the name of
0710: 20 61 6e 0a 23 20 41 54 54 41 43 48 2d 65 64 20   an.# ATTACH-ed 
0720: 64 61 74 61 62 61 73 65 2e 0a 23 0a 23 20 45 56  database..#.# EV
0730: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 31 38 39  IDENCE-OF: R-189
0740: 31 33 2d 31 39 33 35 35 20 54 68 65 20 66 6f 75  13-19355 The fou
0750: 72 74 68 20 70 61 72 61 6d 65 74 65 72 20 69 73  rth parameter is
0760: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 70   the number of p
0770: 61 67 65 73 0a 23 20 63 75 72 72 65 6e 74 6c 79  ages.# currently
0780: 20 69 6e 20 74 68 65 20 77 72 69 74 65 2d 61 68   in the write-ah
0790: 65 61 64 20 6c 6f 67 20 66 69 6c 65 2c 20 69 6e  ead log file, in
07a0: 63 6c 75 64 69 6e 67 20 74 68 6f 73 65 20 74 68  cluding those th
07b0: 61 74 20 77 65 72 65 20 6a 75 73 74 0a 23 20 63  at were just.# c
07c0: 6f 6d 6d 69 74 74 65 64 2e 0a 23 0a 73 65 74 20  ommitted..#.set 
07d0: 3a 3a 77 61 6c 5f 68 6f 6f 6b 5f 61 72 67 73 20  ::wal_hook_args 
07e0: 5b 6c 69 73 74 5d 0a 70 72 6f 63 20 6d 79 5f 77  [list].proc my_w
07f0: 61 6c 5f 68 6f 6f 6b 20 7b 64 62 6e 61 6d 65 20  al_hook {dbname 
0800: 6e 45 6e 74 72 79 7d 20 7b 0a 20 20 73 65 74 20  nEntry} {.  set 
0810: 3a 3a 77 61 6c 5f 68 6f 6f 6b 5f 61 72 67 73 20  ::wal_hook_args 
0820: 5b 6c 69 73 74 20 24 64 62 6e 61 6d 65 20 24 6e  [list $dbname $n
0830: 45 6e 74 72 79 5d 0a 7d 0a 66 6f 72 63 65 64 65  Entry].}.forcede
0840: 6c 65 74 65 20 74 65 73 74 2e 64 62 32 0a 64 6f  lete test.db2.do
0850: 5f 74 65 73 74 20 33 2e 30 20 7b 0a 20 20 65 78  _test 3.0 {.  ex
0860: 65 63 73 71 6c 20 7b 0a 20 20 20 20 41 54 54 41  ecsql {.    ATTA
0870: 43 48 20 27 74 65 73 74 2e 64 62 32 27 20 41 53  CH 'test.db2' AS
0880: 20 61 75 78 3b 0a 20 20 20 20 43 52 45 41 54 45   aux;.    CREATE
0890: 20 54 41 42 4c 45 20 61 75 78 2e 74 32 28 78 29   TABLE aux.t2(x)
08a0: 3b 0a 20 20 20 20 50 52 41 47 4d 41 20 61 75 78  ;.    PRAGMA aux
08b0: 2e 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65 20 3d 20  .journal_mode = 
08c0: 77 61 6c 3b 0a 20 20 7d 0a 7d 20 7b 77 61 6c 7d  wal;.  }.} {wal}
08d0: 0a 0a 23 20 44 61 74 61 62 61 73 65 20 22 61 75  ..# Database "au
08e0: 78 22 0a 64 6f 5f 74 65 73 74 20 33 2e 31 2e 31  x".do_test 3.1.1
08f0: 20 7b 0a 20 20 73 65 74 20 77 61 6c 5f 68 6f 6f   {.  set wal_hoo
0900: 6b 5f 61 72 67 73 20 5b 6c 69 73 74 5d 0a 20 20  k_args [list].  
0910: 65 78 65 63 73 71 6c 20 7b 20 49 4e 53 45 52 54  execsql { INSERT
0920: 20 49 4e 54 4f 20 74 32 20 56 41 4c 55 45 53 28   INTO t2 VALUES(
0930: 27 61 27 29 20 7d 0a 7d 20 7b 7d 0a 64 6f 5f 74  'a') }.} {}.do_t
0940: 65 73 74 20 33 2e 31 2e 32 20 7b 0a 20 20 73 65  est 3.1.2 {.  se
0950: 74 20 77 61 6c 5f 68 6f 6f 6b 5f 61 72 67 73 0a  t wal_hook_args.
0960: 7d 20 5b 6c 69 73 74 20 61 75 78 20 5b 77 61 6c  } [list aux [wal
0970: 5f 66 72 61 6d 65 5f 63 6f 75 6e 74 20 74 65 73  _frame_count tes
0980: 74 2e 64 62 32 2d 77 61 6c 20 31 30 32 34 5d 5d  t.db2-wal 1024]]
0990: 0a 0a 23 20 44 61 74 61 62 61 73 65 20 22 6d 61  ..# Database "ma
09a0: 69 6e 22 0a 64 6f 5f 74 65 73 74 20 33 2e 32 2e  in".do_test 3.2.
09b0: 31 20 7b 0a 20 20 73 65 74 20 77 61 6c 5f 68 6f  1 {.  set wal_ho
09c0: 6f 6b 5f 61 72 67 73 20 5b 6c 69 73 74 5d 0a 20  ok_args [list]. 
09d0: 20 65 78 65 63 73 71 6c 20 7b 20 49 4e 53 45 52   execsql { INSER
09e0: 54 20 49 4e 54 4f 20 74 31 20 56 41 4c 55 45 53  T INTO t1 VALUES
09f0: 28 36 29 20 7d 0a 7d 20 7b 7d 0a 64 6f 5f 74 65  (6) }.} {}.do_te
0a00: 73 74 20 33 2e 31 2e 32 20 7b 0a 20 20 73 65 74  st 3.1.2 {.  set
0a10: 20 77 61 6c 5f 68 6f 6f 6b 5f 61 72 67 73 0a 7d   wal_hook_args.}
0a20: 20 5b 6c 69 73 74 20 6d 61 69 6e 20 5b 77 61 6c   [list main [wal
0a30: 5f 66 72 61 6d 65 5f 63 6f 75 6e 74 20 74 65 73  _frame_count tes
0a40: 74 2e 64 62 2d 77 61 6c 20 31 30 32 34 5d 5d 0a  t.db-wal 1024]].
0a50: 0a 23 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20  .# EVIDENCE-OF: 
0a60: 52 2d 31 34 30 33 34 2d 30 30 39 32 39 20 49 66  R-14034-00929 If
0a70: 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69   an error code i
0a80: 73 20 72 65 74 75 72 6e 65 64 2c 20 74 68 61 74  s returned, that
0a90: 20 65 72 72 6f 72 0a 23 20 77 69 6c 6c 20 70 72   error.# will pr
0aa0: 6f 70 61 67 61 74 65 20 62 61 63 6b 20 75 70 20  opagate back up 
0ab0: 74 68 72 6f 75 67 68 20 74 68 65 20 53 51 4c 69  through the SQLi
0ac0: 74 65 20 63 6f 64 65 20 62 61 73 65 20 74 6f 20  te code base to 
0ad0: 63 61 75 73 65 20 74 68 65 0a 23 20 73 74 61 74  cause the.# stat
0ae0: 65 6d 65 6e 74 20 74 68 61 74 20 70 72 6f 76 6f  ement that provo
0af0: 6b 65 64 20 74 68 65 20 63 61 6c 6c 62 61 63 6b  ked the callback
0b00: 20 74 6f 20 72 65 70 6f 72 74 20 61 6e 20 65 72   to report an er
0b10: 72 6f 72 2c 20 74 68 6f 75 67 68 20 74 68 65 0a  ror, though the.
0b20: 23 20 63 6f 6d 6d 69 74 20 77 69 6c 6c 20 68 61  # commit will ha
0b30: 76 65 20 73 74 69 6c 6c 20 6f 63 63 75 72 72 65  ve still occurre
0b40: 64 2e 0a 23 0a 70 72 6f 63 20 6d 79 5f 77 61 6c  d..#.proc my_wal
0b50: 5f 68 6f 6f 6b 20 7b 61 72 67 73 7d 20 7b 20 72  _hook {args} { r
0b60: 65 74 75 72 6e 20 31 20 3b 23 20 53 51 4c 49 54  eturn 1 ;# SQLIT
0b70: 45 5f 45 52 52 4f 52 20 7d 0a 64 6f 5f 63 61 74  E_ERROR }.do_cat
0b80: 63 68 73 71 6c 5f 74 65 73 74 20 34 2e 31 20 7b  chsql_test 4.1 {
0b90: 0a 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74  .  INSERT INTO t
0ba0: 31 20 56 41 4c 55 45 53 28 37 29 0a 7d 20 7b 31  1 VALUES(7).} {1
0bb0: 20 7b 53 51 4c 20 6c 6f 67 69 63 20 65 72 72 6f   {SQL logic erro
0bc0: 72 7d 7d 0a 0a 70 72 6f 63 20 6d 79 5f 77 61 6c  r}}..proc my_wal
0bd0: 5f 68 6f 6f 6b 20 7b 61 72 67 73 7d 20 7b 20 72  _hook {args} { r
0be0: 65 74 75 72 6e 20 35 20 3b 23 20 53 51 4c 49 54  eturn 5 ;# SQLIT
0bf0: 45 5f 42 55 53 59 20 7d 0a 64 6f 5f 63 61 74 63  E_BUSY }.do_catc
0c00: 68 73 71 6c 5f 74 65 73 74 20 34 2e 32 20 7b 0a  hsql_test 4.2 {.
0c10: 20 20 49 4e 53 45 52 54 20 49 4e 54 4f 20 74 31    INSERT INTO t1
0c20: 20 56 41 4c 55 45 53 28 38 29 0a 7d 20 7b 31 20   VALUES(8).} {1 
0c30: 7b 64 61 74 61 62 61 73 65 20 69 73 20 6c 6f 63  {database is loc
0c40: 6b 65 64 7d 7d 0a 0a 70 72 6f 63 20 6d 79 5f 77  ked}}..proc my_w
0c50: 61 6c 5f 68 6f 6f 6b 20 7b 61 72 67 73 7d 20 7b  al_hook {args} {
0c60: 20 72 65 74 75 72 6e 20 31 34 20 3b 23 20 53 51   return 14 ;# SQ
0c70: 4c 49 54 45 5f 43 41 4e 54 4f 50 45 4e 20 7d 0a  LITE_CANTOPEN }.
0c80: 64 6f 5f 63 61 74 63 68 73 71 6c 5f 74 65 73 74  do_catchsql_test
0c90: 20 34 2e 33 20 7b 0a 20 20 49 4e 53 45 52 54 20   4.3 {.  INSERT 
0ca0: 49 4e 54 4f 20 74 31 20 56 41 4c 55 45 53 28 39  INTO t1 VALUES(9
0cb0: 29 0a 7d 20 7b 31 20 7b 75 6e 61 62 6c 65 20 74  ).} {1 {unable t
0cc0: 6f 20 6f 70 65 6e 20 64 61 74 61 62 61 73 65 20  o open database 
0cd0: 66 69 6c 65 7d 7d 0a 0a 64 6f 5f 65 78 65 63 73  file}}..do_execs
0ce0: 71 6c 5f 74 65 73 74 20 34 2e 34 20 7b 0a 20 20  ql_test 4.4 {.  
0cf0: 53 45 4c 45 43 54 20 2a 20 46 52 4f 4d 20 74 31  SELECT * FROM t1
0d00: 0a 7d 20 7b 31 20 32 20 33 20 34 20 35 20 36 20  .} {1 2 3 4 5 6 
0d10: 37 20 38 20 39 7d 0a 0a 23 20 45 56 49 44 45 4e  7 8 9}..# EVIDEN
0d20: 43 45 2d 4f 46 3a 20 52 2d 31 30 34 36 36 2d 35  CE-OF: R-10466-5
0d30: 33 39 32 30 20 43 61 6c 6c 69 6e 67 20 73 71 6c  3920 Calling sql
0d40: 69 74 65 33 5f 77 61 6c 5f 68 6f 6f 6b 28 29 20  ite3_wal_hook() 
0d50: 72 65 70 6c 61 63 65 73 20 61 6e 79 0a 23 20 70  replaces any.# p
0d60: 72 65 76 69 6f 75 73 6c 79 20 72 65 67 69 73 74  reviously regist
0d70: 65 72 65 64 20 77 72 69 74 65 2d 61 68 65 61 64  ered write-ahead
0d80: 20 6c 6f 67 20 63 61 6c 6c 62 61 63 6b 2e 0a 73   log callback..s
0d90: 65 74 20 3a 3a 6f 6c 64 5f 77 61 6c 5f 68 6f 6f  et ::old_wal_hoo
0da0: 6b 20 30 0a 70 72 6f 63 20 6d 79 5f 6f 6c 64 5f  k 0.proc my_old_
0db0: 77 61 6c 5f 68 6f 6f 6b 20 7b 61 72 67 73 7d 20  wal_hook {args} 
0dc0: 7b 0a 20 20 69 6e 63 72 20 3a 3a 6f 6c 64 5f 77  {.  incr ::old_w
0dd0: 61 6c 5f 68 6f 6f 6b 20 0a 20 20 72 65 74 75 72  al_hook .  retur
0de0: 6e 20 30 0a 7d 0a 64 62 20 77 61 6c 5f 68 6f 6f  n 0.}.db wal_hoo
0df0: 6b 20 6d 79 5f 6f 6c 64 5f 77 61 6c 5f 68 6f 6f  k my_old_wal_hoo
0e00: 6b 0a 64 6f 5f 74 65 73 74 20 35 2e 31 20 7b 0a  k.do_test 5.1 {.
0e10: 20 20 65 78 65 63 73 71 6c 20 7b 20 49 4e 53 45    execsql { INSE
0e20: 52 54 20 49 4e 54 4f 20 74 31 20 56 41 4c 55 45  RT INTO t1 VALUE
0e30: 53 28 31 30 29 20 7d 0a 20 20 73 65 74 20 3a 3a  S(10) }.  set ::
0e40: 6f 6c 64 5f 77 61 6c 5f 68 6f 6f 6b 0a 7d 20 7b  old_wal_hook.} {
0e50: 31 7d 0a 0a 23 20 52 65 70 6c 61 63 65 20 6f 6c  1}..# Replace ol
0e60: 64 5f 77 61 6c 5f 68 6f 6f 6b 2e 20 4f 62 73 65  d_wal_hook. Obse
0e70: 72 76 65 20 74 68 61 74 20 69 74 20 69 73 20 6e  rve that it is n
0e80: 6f 74 20 69 6e 76 6f 6b 65 64 20 61 66 74 65 72  ot invoked after
0e90: 20 69 74 20 68 61 73 20 0a 23 20 62 65 65 6e 20   it has .# been 
0ea0: 72 65 70 6c 61 63 65 64 2e 0a 70 72 6f 63 20 6d  replaced..proc m
0eb0: 79 5f 6e 65 77 5f 77 61 6c 5f 68 6f 6f 6b 20 7b  y_new_wal_hook {
0ec0: 61 72 67 73 7d 20 7b 20 72 65 74 75 72 6e 20 30  args} { return 0
0ed0: 20 7d 0a 64 62 20 77 61 6c 5f 68 6f 6f 6b 20 6d   }.db wal_hook m
0ee0: 79 5f 6e 65 77 5f 77 61 6c 5f 68 6f 6f 6b 0a 64  y_new_wal_hook.d
0ef0: 6f 5f 74 65 73 74 20 35 2e 32 20 7b 0a 20 20 65  o_test 5.2 {.  e
0f00: 78 65 63 73 71 6c 20 7b 20 49 4e 53 45 52 54 20  xecsql { INSERT 
0f10: 49 4e 54 4f 20 74 31 20 56 41 4c 55 45 53 28 31  INTO t1 VALUES(1
0f20: 31 29 20 7d 0a 20 20 73 65 74 20 3a 3a 6f 6c 64  1) }.  set ::old
0f30: 5f 77 61 6c 5f 68 6f 6f 6b 0a 7d 20 7b 31 7d 0a  _wal_hook.} {1}.
0f40: 0a 0a 0a 23 20 45 56 49 44 45 4e 43 45 2d 4f 46  ...# EVIDENCE-OF
0f50: 3a 20 52 2d 35 37 34 34 35 2d 34 33 34 32 35 20  : R-57445-43425 
0f60: 4e 6f 74 65 20 74 68 61 74 20 74 68 65 20 73 71  Note that the sq
0f70: 6c 69 74 65 33 5f 77 61 6c 5f 61 75 74 6f 63 68  lite3_wal_autoch
0f80: 65 63 6b 70 6f 69 6e 74 28 29 0a 23 20 69 6e 74  eckpoint().# int
0f90: 65 72 66 61 63 65 20 61 6e 64 20 74 68 65 20 77  erface and the w
0fa0: 61 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 6e  al_autocheckpoin
0fb0: 74 20 70 72 61 67 6d 61 20 62 6f 74 68 20 69 6e  t pragma both in
0fc0: 76 6f 6b 65 0a 23 20 73 71 6c 69 74 65 33 5f 77  voke.# sqlite3_w
0fd0: 61 6c 5f 68 6f 6f 6b 28 29 20 61 6e 64 20 77 69  al_hook() and wi
0fe0: 6c 6c 20 6f 76 65 72 77 72 69 74 65 20 61 6e 79  ll overwrite any
0ff0: 20 70 72 69 6f 72 20 73 71 6c 69 74 65 33 5f 77   prior sqlite3_w
1000: 61 6c 5f 68 6f 6f 6b 28 29 0a 23 20 73 65 74 74  al_hook().# sett
1010: 69 6e 67 73 2e 0a 23 0a 73 65 74 20 3a 3a 6f 6c  ings..#.set ::ol
1020: 64 5f 77 61 6c 5f 68 6f 6f 6b 20 30 0a 70 72 6f  d_wal_hook 0.pro
1030: 63 20 6d 79 5f 6f 6c 64 5f 77 61 6c 5f 68 6f 6f  c my_old_wal_hoo
1040: 6b 20 7b 61 72 67 73 7d 20 7b 20 69 6e 63 72 20  k {args} { incr 
1050: 3a 3a 6f 6c 64 5f 77 61 6c 5f 68 6f 6f 6b 20 3b  ::old_wal_hook ;
1060: 20 72 65 74 75 72 6e 20 30 20 7d 0a 64 62 20 77   return 0 }.db w
1070: 61 6c 5f 68 6f 6f 6b 20 6d 79 5f 6f 6c 64 5f 77  al_hook my_old_w
1080: 61 6c 5f 68 6f 6f 6b 0a 64 6f 5f 74 65 73 74 20  al_hook.do_test 
1090: 36 2e 31 2e 31 20 7b 0a 20 20 65 78 65 63 73 71  6.1.1 {.  execsq
10a0: 6c 20 7b 20 49 4e 53 45 52 54 20 49 4e 54 4f 20  l { INSERT INTO 
10b0: 74 31 20 56 41 4c 55 45 53 28 31 32 29 20 7d 0a  t1 VALUES(12) }.
10c0: 20 20 73 65 74 20 3a 3a 6f 6c 64 5f 77 61 6c 5f    set ::old_wal_
10d0: 68 6f 6f 6b 0a 7d 20 7b 31 7d 0a 64 6f 5f 74 65  hook.} {1}.do_te
10e0: 73 74 20 36 2e 31 2e 32 20 7b 0a 20 20 65 78 65  st 6.1.2 {.  exe
10f0: 63 73 71 6c 20 7b 20 50 52 41 47 4d 41 20 77 61  csql { PRAGMA wa
1100: 6c 5f 61 75 74 6f 63 68 65 63 6b 70 6f 69 6e 74  l_autocheckpoint
1110: 20 3d 20 31 30 30 30 20 7d 0a 20 20 65 78 65 63   = 1000 }.  exec
1120: 73 71 6c 20 7b 20 49 4e 53 45 52 54 20 49 4e 54  sql { INSERT INT
1130: 4f 20 74 31 20 56 41 4c 55 45 53 28 31 32 29 20  O t1 VALUES(12) 
1140: 7d 0a 20 20 73 65 74 20 3a 3a 6f 6c 64 5f 77 61  }.  set ::old_wa
1150: 6c 5f 68 6f 6f 6b 0a 7d 20 7b 31 7d 0a 0a 23 20  l_hook.} {1}..# 
1160: 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35  EVIDENCE-OF: R-5
1170: 32 36 32 39 2d 33 38 39 36 37 20 54 68 65 20 66  2629-38967 The f
1180: 69 72 73 74 20 70 61 72 61 6d 65 74 65 72 20 70  irst parameter p
1190: 61 73 73 65 64 20 74 6f 20 74 68 65 20 63 61 6c  assed to the cal
11a0: 6c 62 61 63 6b 0a 23 20 66 75 6e 63 74 69 6f 6e  lback.# function
11b0: 20 77 68 65 6e 20 69 74 20 69 73 20 69 6e 76 6f   when it is invo
11c0: 6b 65 64 20 69 73 20 61 20 63 6f 70 79 20 6f 66  ked is a copy of
11d0: 20 74 68 65 20 74 68 69 72 64 20 70 61 72 61 6d   the third param
11e0: 65 74 65 72 20 70 61 73 73 65 64 20 74 6f 0a 23  eter passed to.#
11f0: 20 73 71 6c 69 74 65 33 5f 77 61 6c 5f 68 6f 6f   sqlite3_wal_hoo
1200: 6b 28 29 20 77 68 65 6e 20 72 65 67 69 73 74 65  k() when registe
1210: 72 69 6e 67 20 74 68 65 20 63 61 6c 6c 62 61 63  ring the callbac
1220: 6b 2e 0a 23 0a 23 20 20 20 20 54 68 69 73 20 69  k..#.#    This i
1230: 73 20 74 72 69 63 6b 79 20 74 6f 20 74 65 73 74  s tricky to test
1240: 20 75 73 69 6e 67 20 74 68 65 20 74 63 6c 20 69   using the tcl i
1250: 6e 74 65 72 66 61 63 65 2e 20 48 6f 77 65 76 65  nterface. Howeve
1260: 72 2c 20 74 68 65 0a 23 20 20 20 20 6d 65 63 68  r, the.#    mech
1270: 61 6e 69 73 6d 20 75 73 65 64 20 74 6f 20 69 6e  anism used to in
1280: 76 6f 6b 65 20 74 68 65 20 74 63 6c 20 73 63 72  voke the tcl scr
1290: 69 70 74 20 72 65 67 69 73 74 65 72 65 64 20 61  ipt registered a
12a0: 73 20 61 20 77 61 6c 2d 68 6f 6f 6b 0a 23 20 20  s a wal-hook.#  
12b0: 20 20 64 65 70 65 6e 64 73 20 6f 6e 20 74 68 65    depends on the
12c0: 20 63 6f 6e 74 65 78 74 20 70 6f 69 6e 74 65 72   context pointer
12d0: 20 62 65 69 6e 67 20 63 6f 72 72 65 63 74 6c 79   being correctly
12e0: 20 70 61 73 73 65 64 20 74 68 72 6f 75 67 68 2e   passed through.
12f0: 20 41 6e 64 0a 23 20 20 20 20 73 69 6e 63 65 20   And.#    since 
1300: 6d 75 6c 74 69 70 6c 65 20 64 69 66 66 65 72 65  multiple differe
1310: 6e 74 20 77 61 6c 2d 68 6f 6f 6b 20 73 63 72 69  nt wal-hook scri
1320: 70 74 73 20 68 61 76 65 20 62 65 65 6e 20 73 75  pts have been su
1330: 63 63 65 73 73 66 75 6c 6c 79 0a 23 20 20 20 20  ccessfully.#    
1340: 69 6e 76 6f 6b 65 64 20 62 79 20 74 68 69 73 20  invoked by this 
1350: 74 65 73 74 20 73 63 72 69 70 74 2c 20 63 6f 6e  test script, con
1360: 73 69 64 65 72 20 74 68 69 73 20 74 65 73 74 65  sider this teste
1370: 64 2e 0a 23 0a 23 20 45 56 49 44 45 4e 43 45 2d  d..#.# EVIDENCE-
1380: 4f 46 3a 20 52 2d 32 33 33 37 38 2d 34 32 35 33  OF: R-23378-4253
1390: 36 20 54 68 65 20 73 65 63 6f 6e 64 20 69 73 20  6 The second is 
13a0: 61 20 63 6f 70 79 20 6f 66 20 74 68 65 20 64 61  a copy of the da
13b0: 74 61 62 61 73 65 0a 23 20 68 61 6e 64 6c 65 2e  tabase.# handle.
13c0: 0a 23 0a 23 20 20 20 20 54 68 65 72 65 20 69 73  .#.#    There is
13d0: 20 61 6e 20 61 73 73 65 72 74 28 29 20 69 6e 20   an assert() in 
13e0: 74 68 65 20 43 20 77 61 6c 2d 68 6f 6f 6b 20 75  the C wal-hook u
13f0: 73 65 64 20 62 79 20 74 63 6c 73 71 6c 69 74 65  sed by tclsqlite
1400: 2e 63 20 74 6f 0a 23 20 20 20 20 70 72 6f 76 65  .c to.#    prove
1410: 20 74 68 69 73 2e 20 41 6e 64 20 74 68 61 74 20   this. And that 
1420: 68 6f 6f 6b 20 68 61 73 20 62 65 65 6e 20 69 6e  hook has been in
1430: 76 6f 6b 65 64 20 6d 75 6c 74 69 70 6c 65 20 74  voked multiple t
1440: 69 6d 65 73 20 77 68 65 6e 0a 23 20 20 20 20 72  imes when.#    r
1450: 75 6e 6e 69 6e 67 20 74 68 69 73 20 73 63 72 69  unning this scri
1460: 70 74 2e 20 53 6f 20 63 6f 6e 73 69 64 65 72 20  pt. So consider 
1470: 74 68 69 73 20 72 65 71 75 69 72 65 6d 65 6e 74  this requirement
1480: 20 74 65 73 74 65 64 20 61 73 20 77 65 6c 6c 2e   tested as well.
1490: 0a 23 0a 0a 66 69 6e 69 73 68 5f 74 65 73 74 0a  .#..finish_test.