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

Artifact 8dc2b14dd93cd991629ce98e02bc4a5a181f7146:


0000: 2f 2a 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74  /*.**.** The aut
0010: 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f  hor disclaims co
0020: 70 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20  pyright to this 
0030: 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e  source code.  In
0040: 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c   place of.** a l
0050: 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72  egal notice, her
0060: 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a  e is a blessing:
0070: 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f  .**.**    May yo
0080: 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f  u do good and no
0090: 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61  t evil..**    Ma
00a0: 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69  y you find forgi
00b0: 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73  veness for yours
00c0: 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20  elf and forgive 
00d0: 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61  others..**    Ma
00e0: 79 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65  y you share free
00f0: 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67  ly, never taking
0100: 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67   more than you g
0110: 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a  ive..**.********
0120: 2a 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 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63  *.** This file c
0170: 6f 6e 74 61 69 6e 73 20 63 6f 64 65 20 75 73 65  ontains code use
0180: 64 20 62 79 20 74 68 65 20 63 6f 6d 70 69 6c 65  d by the compile
0190: 72 20 74 6f 20 61 64 64 20 66 6f 72 65 69 67 6e  r to add foreign
01a0: 20 6b 65 79 0a 2a 2a 20 73 75 70 70 6f 72 74 20   key.** support 
01b0: 74 6f 20 63 6f 6d 70 69 6c 65 64 20 53 51 4c 20  to compiled SQL 
01c0: 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2f 0a 23  statements..*/.#
01d0: 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49  include "sqliteI
01e0: 6e 74 2e 68 22 0a 0a 23 69 66 6e 64 65 66 20 53  nt.h"..#ifndef S
01f0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45 49  QLITE_OMIT_FOREI
0200: 47 4e 5f 4b 45 59 0a 23 69 66 6e 64 65 66 20 53  GN_KEY.#ifndef S
0210: 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52 49 47 47  QLITE_OMIT_TRIGG
0220: 45 52 0a 0a 2f 2a 0a 2a 2a 20 44 65 66 65 72 72  ER../*.** Deferr
0230: 65 64 20 61 6e 64 20 49 6d 6d 65 64 69 61 74 65  ed and Immediate
0240: 20 46 4b 73 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d   FKs.** --------
0250: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0260: 2d 2d 0a 2a 2a 0a 2a 2a 20 46 6f 72 65 69 67 6e  --.**.** Foreign
0270: 20 6b 65 79 73 20 69 6e 20 53 51 4c 69 74 65 20   keys in SQLite 
0280: 63 6f 6d 65 20 69 6e 20 74 77 6f 20 66 6c 61 76  come in two flav
0290: 6f 75 72 73 3a 20 64 65 66 65 72 72 65 64 20 61  ours: deferred a
02a0: 6e 64 20 69 6d 6d 65 64 69 61 74 65 2e 0a 2a 2a  nd immediate..**
02b0: 20 49 66 20 61 6e 20 69 6d 6d 65 64 69 61 74 65   If an immediate
02c0: 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e   foreign key con
02d0: 73 74 72 61 69 6e 74 20 69 73 20 76 69 6f 6c 61  straint is viola
02e0: 74 65 64 2c 0a 2a 2a 20 53 51 4c 49 54 45 5f 43  ted,.** SQLITE_C
02f0: 4f 4e 53 54 52 41 49 4e 54 5f 46 4f 52 45 49 47  ONSTRAINT_FOREIG
0300: 4e 4b 45 59 20 69 73 20 72 65 74 75 72 6e 65 64  NKEY is returned
0310: 20 61 6e 64 20 74 68 65 20 63 75 72 72 65 6e 74   and the current
0320: 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20 74 72  .** statement tr
0330: 61 6e 73 61 63 74 69 6f 6e 20 72 6f 6c 6c 65 64  ansaction rolled
0340: 20 62 61 63 6b 2e 20 49 66 20 61 20 0a 2a 2a 20   back. If a .** 
0350: 64 65 66 65 72 72 65 64 20 66 6f 72 65 69 67 6e  deferred foreign
0360: 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20   key constraint 
0370: 69 73 20 76 69 6f 6c 61 74 65 64 2c 20 6e 6f 20  is violated, no 
0380: 61 63 74 69 6f 6e 20 69 73 20 74 61 6b 65 6e 20  action is taken 
0390: 0a 2a 2a 20 69 6d 6d 65 64 69 61 74 65 6c 79 2e  .** immediately.
03a0: 20 48 6f 77 65 76 65 72 20 69 66 20 74 68 65 20   However if the 
03b0: 61 70 70 6c 69 63 61 74 69 6f 6e 20 61 74 74 65  application atte
03c0: 6d 70 74 73 20 74 6f 20 63 6f 6d 6d 69 74 20 74  mpts to commit t
03d0: 68 65 20 0a 2a 2a 20 74 72 61 6e 73 61 63 74 69  he .** transacti
03e0: 6f 6e 20 62 65 66 6f 72 65 20 66 69 78 69 6e 67  on before fixing
03f0: 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 20   the constraint 
0400: 76 69 6f 6c 61 74 69 6f 6e 2c 20 74 68 65 20 61  violation, the a
0410: 74 74 65 6d 70 74 20 66 61 69 6c 73 2e 0a 2a 2a  ttempt fails..**
0420: 0a 2a 2a 20 44 65 66 65 72 72 65 64 20 63 6f 6e  .** Deferred con
0430: 73 74 72 61 69 6e 74 73 20 61 72 65 20 69 6d 70  straints are imp
0440: 6c 65 6d 65 6e 74 65 64 20 75 73 69 6e 67 20 61  lemented using a
0450: 20 73 69 6d 70 6c 65 20 63 6f 75 6e 74 65 72 20   simple counter 
0460: 61 73 73 6f 63 69 61 74 65 64 0a 2a 2a 20 77 69  associated.** wi
0470: 74 68 20 74 68 65 20 64 61 74 61 62 61 73 65 20  th the database 
0480: 68 61 6e 64 6c 65 2e 20 54 68 65 20 63 6f 75 6e  handle. The coun
0490: 74 65 72 20 69 73 20 73 65 74 20 74 6f 20 7a 65  ter is set to ze
04a0: 72 6f 20 65 61 63 68 20 74 69 6d 65 20 61 20 0a  ro each time a .
04b0: 2a 2a 20 64 61 74 61 62 61 73 65 20 74 72 61 6e  ** database tran
04c0: 73 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 65  saction is opene
04d0: 64 2e 20 45 61 63 68 20 74 69 6d 65 20 61 20 73  d. Each time a s
04e0: 74 61 74 65 6d 65 6e 74 20 69 73 20 65 78 65 63  tatement is exec
04f0: 75 74 65 64 20 0a 2a 2a 20 74 68 61 74 20 63 61  uted .** that ca
0500: 75 73 65 73 20 61 20 66 6f 72 65 69 67 6e 20 6b  uses a foreign k
0510: 65 79 20 76 69 6f 6c 61 74 69 6f 6e 2c 20 74 68  ey violation, th
0520: 65 20 63 6f 75 6e 74 65 72 20 69 73 20 69 6e 63  e counter is inc
0530: 72 65 6d 65 6e 74 65 64 2e 20 45 61 63 68 0a 2a  remented. Each.*
0540: 2a 20 74 69 6d 65 20 61 20 73 74 61 74 65 6d 65  * time a stateme
0550: 6e 74 20 69 73 20 65 78 65 63 75 74 65 64 20 74  nt is executed t
0560: 68 61 74 20 72 65 6d 6f 76 65 73 20 61 6e 20 65  hat removes an e
0570: 78 69 73 74 69 6e 67 20 76 69 6f 6c 61 74 69 6f  xisting violatio
0580: 6e 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 64 61  n from.** the da
0590: 74 61 62 61 73 65 2c 20 74 68 65 20 63 6f 75 6e  tabase, the coun
05a0: 74 65 72 20 69 73 20 64 65 63 72 65 6d 65 6e 74  ter is decrement
05b0: 65 64 2e 20 57 68 65 6e 20 74 68 65 20 74 72 61  ed. When the tra
05c0: 6e 73 61 63 74 69 6f 6e 20 69 73 0a 2a 2a 20 63  nsaction is.** c
05d0: 6f 6d 6d 69 74 74 65 64 2c 20 74 68 65 20 63 6f  ommitted, the co
05e0: 6d 6d 69 74 20 66 61 69 6c 73 20 69 66 20 74 68  mmit fails if th
05f0: 65 20 63 75 72 72 65 6e 74 20 76 61 6c 75 65 20  e current value 
0600: 6f 66 20 74 68 65 20 63 6f 75 6e 74 65 72 20 69  of the counter i
0610: 73 0a 2a 2a 20 67 72 65 61 74 65 72 20 74 68 61  s.** greater tha
0620: 6e 20 7a 65 72 6f 2e 20 54 68 69 73 20 73 63 68  n zero. This sch
0630: 65 6d 65 20 68 61 73 20 74 77 6f 20 62 69 67 20  eme has two big 
0640: 64 72 61 77 62 61 63 6b 73 3a 0a 2a 2a 0a 2a 2a  drawbacks:.**.**
0650: 20 20 20 2a 20 57 68 65 6e 20 61 20 63 6f 6d 6d     * When a comm
0660: 69 74 20 66 61 69 6c 73 20 64 75 65 20 74 6f 20  it fails due to 
0670: 61 20 64 65 66 65 72 72 65 64 20 66 6f 72 65 69  a deferred forei
0680: 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e  gn key constrain
0690: 74 2c 20 0a 2a 2a 20 20 20 20 20 74 68 65 72 65  t, .**     there
06a0: 20 69 73 20 6e 6f 20 77 61 79 20 74 6f 20 74 65   is no way to te
06b0: 6c 6c 20 77 68 69 63 68 20 66 6f 72 65 69 67 6e  ll which foreign
06c0: 20 63 6f 6e 73 74 72 61 69 6e 74 20 69 73 20 6e   constraint is n
06d0: 6f 74 20 73 61 74 69 73 66 69 65 64 2c 0a 2a 2a  ot satisfied,.**
06e0: 20 20 20 20 20 6f 72 20 77 68 69 63 68 20 72 6f       or which ro
06f0: 77 20 69 74 20 69 73 20 6e 6f 74 20 73 61 74 69  w it is not sati
0700: 73 66 69 65 64 20 66 6f 72 2e 0a 2a 2a 0a 2a 2a  sfied for..**.**
0710: 20 20 20 2a 20 49 66 20 74 68 65 20 64 61 74 61     * If the data
0720: 62 61 73 65 20 63 6f 6e 74 61 69 6e 73 20 66 6f  base contains fo
0730: 72 65 69 67 6e 20 6b 65 79 20 76 69 6f 6c 61 74  reign key violat
0740: 69 6f 6e 73 20 77 68 65 6e 20 74 68 65 20 0a 2a  ions when the .*
0750: 2a 20 20 20 20 20 74 72 61 6e 73 61 63 74 69 6f  *     transactio
0760: 6e 20 69 73 20 6f 70 65 6e 65 64 2c 20 74 68 69  n is opened, thi
0770: 73 20 6d 61 79 20 63 61 75 73 65 20 74 68 65 20  s may cause the 
0780: 6d 65 63 68 61 6e 69 73 6d 20 74 6f 20 6d 61 6c  mechanism to mal
0790: 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20  function..**.** 
07a0: 44 65 73 70 69 74 65 20 74 68 65 73 65 20 70 72  Despite these pr
07b0: 6f 62 6c 65 6d 73 2c 20 74 68 69 73 20 61 70 70  oblems, this app
07c0: 72 6f 61 63 68 20 69 73 20 61 64 6f 70 74 65 64  roach is adopted
07d0: 20 61 73 20 69 74 20 73 65 65 6d 73 20 73 69 6d   as it seems sim
07e0: 70 6c 65 72 0a 2a 2a 20 74 68 61 6e 20 74 68 65  pler.** than the
07f0: 20 61 6c 74 65 72 6e 61 74 69 76 65 73 2e 0a 2a   alternatives..*
0800: 2a 0a 2a 2a 20 49 4e 53 45 52 54 20 6f 70 65 72  *.** INSERT oper
0810: 61 74 69 6f 6e 73 3a 0a 2a 2a 0a 2a 2a 20 20 20  ations:.**.**   
0820: 49 2e 31 29 20 46 6f 72 20 65 61 63 68 20 46 4b  I.1) For each FK
0830: 20 66 6f 72 20 77 68 69 63 68 20 74 68 65 20 74   for which the t
0840: 61 62 6c 65 20 69 73 20 74 68 65 20 63 68 69 6c  able is the chil
0850: 64 20 74 61 62 6c 65 2c 20 73 65 61 72 63 68 0a  d table, search.
0860: 2a 2a 20 20 20 20 20 20 20 20 74 68 65 20 70 61  **        the pa
0870: 72 65 6e 74 20 74 61 62 6c 65 20 66 6f 72 20 61  rent table for a
0880: 20 6d 61 74 63 68 2e 20 49 66 20 6e 6f 6e 65 20   match. If none 
0890: 69 73 20 66 6f 75 6e 64 20 69 6e 63 72 65 6d 65  is found increme
08a0: 6e 74 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20  nt the.**       
08b0: 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e   constraint coun
08c0: 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 2e 32  ter..**.**   I.2
08d0: 29 20 46 6f 72 20 65 61 63 68 20 46 4b 20 66 6f  ) For each FK fo
08e0: 72 20 77 68 69 63 68 20 74 68 65 20 74 61 62 6c  r which the tabl
08f0: 65 20 69 73 20 74 68 65 20 70 61 72 65 6e 74 20  e is the parent 
0900: 74 61 62 6c 65 2c 20 0a 2a 2a 20 20 20 20 20 20  table, .**      
0910: 20 20 73 65 61 72 63 68 20 74 68 65 20 63 68 69    search the chi
0920: 6c 64 20 74 61 62 6c 65 20 66 6f 72 20 72 6f 77  ld table for row
0930: 73 20 74 68 61 74 20 63 6f 72 72 65 73 70 6f 6e  s that correspon
0940: 64 20 74 6f 20 74 68 65 20 6e 65 77 0a 2a 2a 20  d to the new.** 
0950: 20 20 20 20 20 20 20 72 6f 77 20 69 6e 20 74 68         row in th
0960: 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 2e 20  e parent table. 
0970: 44 65 63 72 65 6d 65 6e 74 20 74 68 65 20 63 6f  Decrement the co
0980: 75 6e 74 65 72 20 66 6f 72 20 65 61 63 68 20 72  unter for each r
0990: 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20 66 6f 75  ow.**        fou
09a0: 6e 64 20 28 61 73 20 74 68 65 20 63 6f 6e 73 74  nd (as the const
09b0: 72 61 69 6e 74 20 69 73 20 6e 6f 77 20 73 61 74  raint is now sat
09c0: 69 73 66 69 65 64 29 2e 0a 2a 2a 0a 2a 2a 20 44  isfied)..**.** D
09d0: 45 4c 45 54 45 20 6f 70 65 72 61 74 69 6f 6e 73  ELETE operations
09e0: 3a 0a 2a 2a 0a 2a 2a 20 20 20 44 2e 31 29 20 46  :.**.**   D.1) F
09f0: 6f 72 20 65 61 63 68 20 46 4b 20 66 6f 72 20 77  or each FK for w
0a00: 68 69 63 68 20 74 68 65 20 74 61 62 6c 65 20 69  hich the table i
0a10: 73 20 74 68 65 20 63 68 69 6c 64 20 74 61 62 6c  s the child tabl
0a20: 65 2c 20 0a 2a 2a 20 20 20 20 20 20 20 20 73 65  e, .**        se
0a30: 61 72 63 68 20 74 68 65 20 70 61 72 65 6e 74 20  arch the parent 
0a40: 74 61 62 6c 65 20 66 6f 72 20 61 20 72 6f 77 20  table for a row 
0a50: 74 68 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 73  that corresponds
0a60: 20 74 6f 20 74 68 65 20 0a 2a 2a 20 20 20 20 20   to the .**     
0a70: 20 20 20 64 65 6c 65 74 65 64 20 72 6f 77 20 69     deleted row i
0a80: 6e 20 74 68 65 20 63 68 69 6c 64 20 74 61 62 6c  n the child tabl
0a90: 65 2e 20 49 66 20 73 75 63 68 20 61 20 72 6f 77  e. If such a row
0aa0: 20 69 73 20 6e 6f 74 20 66 6f 75 6e 64 2c 20 0a   is not found, .
0ab0: 2a 2a 20 20 20 20 20 20 20 20 64 65 63 72 65 6d  **        decrem
0ac0: 65 6e 74 20 74 68 65 20 63 6f 75 6e 74 65 72 2e  ent the counter.
0ad0: 0a 2a 2a 0a 2a 2a 20 20 20 44 2e 32 29 20 46 6f  .**.**   D.2) Fo
0ae0: 72 20 65 61 63 68 20 46 4b 20 66 6f 72 20 77 68  r each FK for wh
0af0: 69 63 68 20 74 68 65 20 74 61 62 6c 65 20 69 73  ich the table is
0b00: 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c   the parent tabl
0b10: 65 2c 20 73 65 61 72 63 68 20 0a 2a 2a 20 20 20  e, search .**   
0b20: 20 20 20 20 20 74 68 65 20 63 68 69 6c 64 20 74       the child t
0b30: 61 62 6c 65 20 66 6f 72 20 72 6f 77 73 20 74 68  able for rows th
0b40: 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f  at correspond to
0b50: 20 74 68 65 20 64 65 6c 65 74 65 64 20 72 6f 77   the deleted row
0b60: 20 0a 2a 2a 20 20 20 20 20 20 20 20 69 6e 20 74   .**        in t
0b70: 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 2e  he parent table.
0b80: 20 46 6f 72 20 65 61 63 68 20 66 6f 75 6e 64 20   For each found 
0b90: 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 63 6f  increment the co
0ba0: 75 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 55 50 44  unter..**.** UPD
0bb0: 41 54 45 20 6f 70 65 72 61 74 69 6f 6e 73 3a 0a  ATE operations:.
0bc0: 2a 2a 0a 2a 2a 20 20 20 41 6e 20 55 50 44 41 54  **.**   An UPDAT
0bd0: 45 20 63 6f 6d 6d 61 6e 64 20 72 65 71 75 69 72  E command requir
0be0: 65 73 20 74 68 61 74 20 61 6c 6c 20 34 20 73 74  es that all 4 st
0bf0: 65 70 73 20 61 62 6f 76 65 20 61 72 65 20 74 61  eps above are ta
0c00: 6b 65 6e 2c 20 62 75 74 20 6f 6e 6c 79 0a 2a 2a  ken, but only.**
0c10: 20 20 20 66 6f 72 20 46 4b 20 63 6f 6e 73 74 72     for FK constr
0c20: 61 69 6e 74 73 20 66 6f 72 20 77 68 69 63 68 20  aints for which 
0c30: 74 68 65 20 61 66 66 65 63 74 65 64 20 63 6f 6c  the affected col
0c40: 75 6d 6e 73 20 61 72 65 20 61 63 74 75 61 6c 6c  umns are actuall
0c50: 79 20 0a 2a 2a 20 20 20 6d 6f 64 69 66 69 65 64  y .**   modified
0c60: 20 28 76 61 6c 75 65 73 20 6d 75 73 74 20 62 65   (values must be
0c70: 20 63 6f 6d 70 61 72 65 64 20 61 74 20 72 75 6e   compared at run
0c80: 74 69 6d 65 29 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 74  time)..**.** Not
0c90: 65 20 74 68 61 74 20 49 2e 31 20 61 6e 64 20 44  e that I.1 and D
0ca0: 2e 31 20 61 72 65 20 76 65 72 79 20 73 69 6d 69  .1 are very simi
0cb0: 6c 61 72 20 6f 70 65 72 61 74 69 6f 6e 73 2c 20  lar operations, 
0cc0: 61 73 20 61 72 65 20 49 2e 32 20 61 6e 64 20 44  as are I.2 and D
0cd0: 2e 32 2e 0a 2a 2a 20 54 68 69 73 20 73 69 6d 70  .2..** This simp
0ce0: 6c 69 66 69 65 73 20 74 68 65 20 69 6d 70 6c 65  lifies the imple
0cf0: 6d 65 6e 74 61 74 69 6f 6e 20 61 20 62 69 74 2e  mentation a bit.
0d00: 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 74 68 65 20 70  .**.** For the p
0d10: 75 72 70 6f 73 65 73 20 6f 66 20 69 6d 6d 65 64  urposes of immed
0d20: 69 61 74 65 20 46 4b 20 63 6f 6e 73 74 72 61 69  iate FK constrai
0d30: 6e 74 73 2c 20 74 68 65 20 4f 52 20 52 45 50 4c  nts, the OR REPL
0d40: 41 43 45 20 63 6f 6e 66 6c 69 63 74 0a 2a 2a 20  ACE conflict.** 
0d50: 72 65 73 6f 6c 75 74 69 6f 6e 20 69 73 20 63 6f  resolution is co
0d60: 6e 73 69 64 65 72 65 64 20 74 6f 20 64 65 6c 65  nsidered to dele
0d70: 74 65 20 72 6f 77 73 20 62 65 66 6f 72 65 20 74  te rows before t
0d80: 68 65 20 6e 65 77 20 72 6f 77 20 69 73 20 69 6e  he new row is in
0d90: 73 65 72 74 65 64 2e 0a 2a 2a 20 49 66 20 61 20  serted..** If a 
0da0: 64 65 6c 65 74 65 20 63 61 75 73 65 64 20 62 79  delete caused by
0db0: 20 4f 52 20 52 45 50 4c 41 43 45 20 76 69 6f 6c   OR REPLACE viol
0dc0: 61 74 65 73 20 61 6e 20 46 4b 20 63 6f 6e 73 74  ates an FK const
0dd0: 72 61 69 6e 74 2c 20 61 6e 20 65 78 63 65 70 74  raint, an except
0de0: 69 6f 6e 0a 2a 2a 20 69 73 20 74 68 72 6f 77 6e  ion.** is thrown
0df0: 2c 20 65 76 65 6e 20 69 66 20 74 68 65 20 46 4b  , even if the FK
0e00: 20 63 6f 6e 73 74 72 61 69 6e 74 20 77 6f 75 6c   constraint woul
0e10: 64 20 62 65 20 73 61 74 69 73 66 69 65 64 20 61  d be satisfied a
0e20: 66 74 65 72 20 74 68 65 20 6e 65 77 20 0a 2a 2a  fter the new .**
0e30: 20 72 6f 77 20 69 73 20 69 6e 73 65 72 74 65 64   row is inserted
0e40: 2e 0a 2a 2a 0a 2a 2a 20 49 6d 6d 65 64 69 61 74  ..**.** Immediat
0e50: 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 61 72  e constraints ar
0e60: 65 20 75 73 75 61 6c 6c 79 20 68 61 6e 64 6c 65  e usually handle
0e70: 64 20 73 69 6d 69 6c 61 72 6c 79 2e 20 54 68 65  d similarly. The
0e80: 20 6f 6e 6c 79 20 64 69 66 66 65 72 65 6e 63 65   only difference
0e90: 20 0a 2a 2a 20 69 73 20 74 68 61 74 20 74 68 65   .** is that the
0ea0: 20 63 6f 75 6e 74 65 72 20 75 73 65 64 20 69 73   counter used is
0eb0: 20 73 74 6f 72 65 64 20 61 73 20 70 61 72 74 20   stored as part 
0ec0: 6f 66 20 65 61 63 68 20 69 6e 64 69 76 69 64 75  of each individu
0ed0: 61 6c 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20  al statement.** 
0ee0: 6f 62 6a 65 63 74 20 28 73 74 72 75 63 74 20 56  object (struct V
0ef0: 64 62 65 29 2e 20 49 66 2c 20 61 66 74 65 72 20  dbe). If, after 
0f00: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 68 61  the statement ha
0f10: 73 20 72 75 6e 2c 20 69 74 73 20 69 6d 6d 65 64  s run, its immed
0f20: 69 61 74 65 0a 2a 2a 20 63 6f 6e 73 74 72 61 69  iate.** constrai
0f30: 6e 74 20 63 6f 75 6e 74 65 72 20 69 73 20 67 72  nt counter is gr
0f40: 65 61 74 65 72 20 74 68 61 6e 20 7a 65 72 6f 2c  eater than zero,
0f50: 0a 2a 2a 20 69 74 20 72 65 74 75 72 6e 73 20 53  .** it returns S
0f60: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54  QLITE_CONSTRAINT
0f70: 5f 46 4f 52 45 49 47 4e 4b 45 59 0a 2a 2a 20 61  _FOREIGNKEY.** a
0f80: 6e 64 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  nd the statement
0f90: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20   transaction is 
0fa0: 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 41 6e 20  rolled back. An 
0fb0: 65 78 63 65 70 74 69 6f 6e 20 69 73 20 61 6e 20  exception is an 
0fc0: 49 4e 53 45 52 54 0a 2a 2a 20 73 74 61 74 65 6d  INSERT.** statem
0fd0: 65 6e 74 20 74 68 61 74 20 69 6e 73 65 72 74 73  ent that inserts
0fe0: 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 20 6f 6e   a single row on
0ff0: 6c 79 20 28 6e 6f 20 74 72 69 67 67 65 72 73 29  ly (no triggers)
1000: 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 2c 0a  . In this case,.
1010: 2a 2a 20 69 6e 73 74 65 61 64 20 6f 66 20 75 73  ** instead of us
1020: 69 6e 67 20 61 20 63 6f 75 6e 74 65 72 2c 20 61  ing a counter, a
1030: 6e 20 65 78 63 65 70 74 69 6f 6e 20 69 73 20 74  n exception is t
1040: 68 72 6f 77 6e 20 69 6d 6d 65 64 69 61 74 65 6c  hrown immediatel
1050: 79 20 69 66 20 74 68 65 0a 2a 2a 20 49 4e 53 45  y if the.** INSE
1060: 52 54 20 76 69 6f 6c 61 74 65 73 20 61 20 66 6f  RT violates a fo
1070: 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72  reign key constr
1080: 61 69 6e 74 2e 20 54 68 69 73 20 69 73 20 6e 65  aint. This is ne
1090: 63 65 73 73 61 72 79 20 61 73 20 73 75 63 68 0a  cessary as such.
10a0: 2a 2a 20 61 6e 20 49 4e 53 45 52 54 20 64 6f 65  ** an INSERT doe
10b0: 73 20 6e 6f 74 20 6f 70 65 6e 20 61 20 73 74 61  s not open a sta
10c0: 74 65 6d 65 6e 74 20 74 72 61 6e 73 61 63 74 69  tement transacti
10d0: 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 4f 44 4f 3a 20  on..**.** TODO: 
10e0: 48 6f 77 20 73 68 6f 75 6c 64 20 64 72 6f 70 70  How should dropp
10f0: 69 6e 67 20 61 20 74 61 62 6c 65 20 62 65 20 68  ing a table be h
1100: 61 6e 64 6c 65 64 3f 20 48 6f 77 20 73 68 6f 75  andled? How shou
1110: 6c 64 20 72 65 6e 61 6d 69 6e 67 20 61 20 0a 2a  ld renaming a .*
1120: 2a 20 74 61 62 6c 65 20 62 65 20 68 61 6e 64 6c  * table be handl
1130: 65 64 3f 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 51 75 65  ed?.**.**.** Que
1140: 72 79 20 41 50 49 20 4e 6f 74 65 73 0a 2a 2a 20  ry API Notes.** 
1150: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a  ---------------.
1160: 2a 2a 0a 2a 2a 20 42 65 66 6f 72 65 20 63 6f 64  **.** Before cod
1170: 69 6e 67 20 61 6e 20 55 50 44 41 54 45 20 6f 72  ing an UPDATE or
1180: 20 44 45 4c 45 54 45 20 72 6f 77 20 6f 70 65 72   DELETE row oper
1190: 61 74 69 6f 6e 2c 20 74 68 65 20 63 6f 64 65 2d  ation, the code-
11a0: 67 65 6e 65 72 61 74 6f 72 0a 2a 2a 20 66 6f 72  generator.** for
11b0: 20 74 68 6f 73 65 20 74 77 6f 20 6f 70 65 72 61   those two opera
11c0: 74 69 6f 6e 73 20 6e 65 65 64 73 20 74 6f 20 6b  tions needs to k
11d0: 6e 6f 77 20 77 68 65 74 68 65 72 20 6f 72 20 6e  now whether or n
11e0: 6f 74 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e  ot the operation
11f0: 0a 2a 2a 20 72 65 71 75 69 72 65 73 20 61 6e 79  .** requires any
1200: 20 46 4b 20 70 72 6f 63 65 73 73 69 6e 67 20 61   FK processing a
1210: 6e 64 2c 20 69 66 20 73 6f 2c 20 77 68 69 63 68  nd, if so, which
1220: 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 74 68 65 20   columns of the 
1230: 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20 72 6f 77 20  original.** row 
1240: 61 72 65 20 72 65 71 75 69 72 65 64 20 62 79 20  are required by 
1250: 74 68 65 20 46 4b 20 70 72 6f 63 65 73 73 69 6e  the FK processin
1260: 67 20 56 44 42 45 20 63 6f 64 65 20 28 69 2e 65  g VDBE code (i.e
1270: 2e 20 69 66 20 46 4b 73 20 77 65 72 65 0a 2a 2a  . if FKs were.**
1280: 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 75 73 69   implemented usi
1290: 6e 67 20 74 72 69 67 67 65 72 73 2c 20 77 68 69  ng triggers, whi
12a0: 63 68 20 6f 66 20 74 68 65 20 6f 6c 64 2e 2a 20  ch of the old.* 
12b0: 63 6f 6c 75 6d 6e 73 20 77 6f 75 6c 64 20 62 65  columns would be
12c0: 20 0a 2a 2a 20 61 63 63 65 73 73 65 64 29 2e 20   .** accessed). 
12d0: 4e 6f 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 69  No information i
12e0: 73 20 72 65 71 75 69 72 65 64 20 62 79 20 74 68  s required by th
12f0: 65 20 63 6f 64 65 2d 67 65 6e 65 72 61 74 6f 72  e code-generator
1300: 20 62 65 66 6f 72 65 0a 2a 2a 20 63 6f 64 69 6e   before.** codin
1310: 67 20 61 6e 20 49 4e 53 45 52 54 20 6f 70 65 72  g an INSERT oper
1320: 61 74 69 6f 6e 2e 20 54 68 65 20 66 75 6e 63 74  ation. The funct
1330: 69 6f 6e 73 20 75 73 65 64 20 62 79 20 74 68 65  ions used by the
1340: 20 55 50 44 41 54 45 2f 44 45 4c 45 54 45 0a 2a   UPDATE/DELETE.*
1350: 2a 20 67 65 6e 65 72 61 74 69 6f 6e 20 63 6f 64  * generation cod
1360: 65 20 74 6f 20 71 75 65 72 79 20 66 6f 72 20 74  e to query for t
1370: 68 69 73 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  his information 
1380: 61 72 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 73 71 6c  are:.**.**   sql
1390: 69 74 65 33 46 6b 52 65 71 75 69 72 65 64 28 29  ite3FkRequired()
13a0: 20 2d 20 54 65 73 74 20 74 6f 20 73 65 65 20 69   - Test to see i
13b0: 66 20 46 4b 20 70 72 6f 63 65 73 73 69 6e 67 20  f FK processing 
13c0: 69 73 20 72 65 71 75 69 72 65 64 2e 0a 2a 2a 20  is required..** 
13d0: 20 20 73 71 6c 69 74 65 33 46 6b 4f 6c 64 6d 61    sqlite3FkOldma
13e0: 73 6b 28 29 20 20 2d 20 51 75 65 72 79 20 66 6f  sk()  - Query fo
13f0: 72 20 74 68 65 20 73 65 74 20 6f 66 20 72 65 71  r the set of req
1400: 75 69 72 65 64 20 6f 6c 64 2e 2a 20 63 6f 6c 75  uired old.* colu
1410: 6d 6e 73 2e 0a 2a 2a 0a 2a 2a 0a 2a 2a 20 45 78  mns..**.**.** Ex
1420: 74 65 72 6e 61 6c 6c 79 20 61 63 63 65 73 73 69  ternally accessi
1430: 62 6c 65 20 6d 6f 64 75 6c 65 20 66 75 6e 63 74  ble module funct
1440: 69 6f 6e 73 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d  ions.** --------
1450: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1460: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a  --------------.*
1470: 2a 0a 2a 2a 20 20 20 73 71 6c 69 74 65 33 46 6b  *.**   sqlite3Fk
1480: 43 68 65 63 6b 28 29 20 20 20 20 2d 20 43 68 65  Check()    - Che
1490: 63 6b 20 66 6f 72 20 66 6f 72 65 69 67 6e 20 6b  ck for foreign k
14a0: 65 79 20 76 69 6f 6c 61 74 69 6f 6e 73 2e 0a 2a  ey violations..*
14b0: 2a 20 20 20 73 71 6c 69 74 65 33 46 6b 41 63 74  *   sqlite3FkAct
14c0: 69 6f 6e 73 28 29 20 20 2d 20 43 6f 64 65 20 74  ions()  - Code t
14d0: 72 69 67 67 65 72 73 20 66 6f 72 20 4f 4e 20 55  riggers for ON U
14e0: 50 44 41 54 45 2f 4f 4e 20 44 45 4c 45 54 45 20  PDATE/ON DELETE 
14f0: 61 63 74 69 6f 6e 73 2e 0a 2a 2a 20 20 20 73 71  actions..**   sq
1500: 6c 69 74 65 33 46 6b 44 65 6c 65 74 65 28 29 20  lite3FkDelete() 
1510: 20 20 2d 20 44 65 6c 65 74 65 20 61 6e 20 46 4b    - Delete an FK
1520: 65 79 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f  ey structure..*/
1530: 0a 0a 2f 2a 0a 2a 2a 20 56 44 42 45 20 43 61 6c  ../*.** VDBE Cal
1540: 6c 69 6e 67 20 43 6f 6e 76 65 6e 74 69 6f 6e 0a  ling Convention.
1550: 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ** -------------
1560: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 0a 2a 2a  ----------.**.**
1570: 20 45 78 61 6d 70 6c 65 3a 0a 2a 2a 0a 2a 2a 20   Example:.**.** 
1580: 20 20 46 6f 72 20 74 68 65 20 66 6f 6c 6c 6f 77    For the follow
1590: 69 6e 67 20 49 4e 53 45 52 54 20 73 74 61 74 65  ing INSERT state
15a0: 6d 65 6e 74 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  ment:.**.**     
15b0: 43 52 45 41 54 45 20 54 41 42 4c 45 20 74 31 28  CREATE TABLE t1(
15c0: 61 2c 20 62 20 49 4e 54 45 47 45 52 20 50 52 49  a, b INTEGER PRI
15d0: 4d 41 52 59 20 4b 45 59 2c 20 63 29 3b 0a 2a 2a  MARY KEY, c);.**
15e0: 20 20 20 20 20 49 4e 53 45 52 54 20 49 4e 54 4f       INSERT INTO
15f0: 20 74 31 20 56 41 4c 55 45 53 28 31 2c 20 32 2c   t1 VALUES(1, 2,
1600: 20 33 2e 31 29 3b 0a 2a 2a 0a 2a 2a 20 20 20 52   3.1);.**.**   R
1610: 65 67 69 73 74 65 72 20 28 78 29 3a 20 20 20 20  egister (x):    
1620: 20 20 20 20 32 20 20 20 20 28 74 79 70 65 20 69      2    (type i
1630: 6e 74 65 67 65 72 29 0a 2a 2a 20 20 20 52 65 67  nteger).**   Reg
1640: 69 73 74 65 72 20 28 78 2b 31 29 3a 20 20 20 20  ister (x+1):    
1650: 20 20 31 20 20 20 20 28 74 79 70 65 20 69 6e 74    1    (type int
1660: 65 67 65 72 29 0a 2a 2a 20 20 20 52 65 67 69 73  eger).**   Regis
1670: 74 65 72 20 28 78 2b 32 29 3a 20 20 20 20 20 20  ter (x+2):      
1680: 4e 55 4c 4c 20 28 74 79 70 65 20 4e 55 4c 4c 29  NULL (type NULL)
1690: 0a 2a 2a 20 20 20 52 65 67 69 73 74 65 72 20 28  .**   Register (
16a0: 78 2b 33 29 3a 20 20 20 20 20 20 33 2e 31 20 20  x+3):      3.1  
16b0: 28 74 79 70 65 20 72 65 61 6c 29 0a 2a 2f 0a 0a  (type real).*/..
16c0: 2f 2a 0a 2a 2a 20 41 20 66 6f 72 65 69 67 6e 20  /*.** A foreign 
16d0: 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 72  key constraint r
16e0: 65 71 75 69 72 65 73 20 74 68 61 74 20 74 68 65  equires that the
16f0: 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e 20   key columns in 
1700: 74 68 65 20 70 61 72 65 6e 74 0a 2a 2a 20 74 61  the parent.** ta
1710: 62 6c 65 20 61 72 65 20 63 6f 6c 6c 65 63 74 69  ble are collecti
1720: 76 65 6c 79 20 73 75 62 6a 65 63 74 20 74 6f 20  vely subject to 
1730: 61 20 55 4e 49 51 55 45 20 6f 72 20 50 52 49 4d  a UNIQUE or PRIM
1740: 41 52 59 20 4b 45 59 20 63 6f 6e 73 74 72 61 69  ARY KEY constrai
1750: 6e 74 2e 0a 2a 2a 20 47 69 76 65 6e 20 74 68 61  nt..** Given tha
1760: 74 20 70 50 61 72 65 6e 74 20 69 73 20 74 68 65  t pParent is the
1770: 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 66 6f   parent table fo
1780: 72 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f  r foreign key co
1790: 6e 73 74 72 61 69 6e 74 20 70 46 4b 65 79 2c 20  nstraint pFKey, 
17a0: 0a 2a 2a 20 73 65 61 72 63 68 20 74 68 65 20 73  .** search the s
17b0: 63 68 65 6d 61 20 66 6f 72 20 61 20 75 6e 69 71  chema for a uniq
17c0: 75 65 20 69 6e 64 65 78 20 6f 6e 20 74 68 65 20  ue index on the 
17d0: 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d  parent key colum
17e0: 6e 73 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75  ns. .**.** If su
17f0: 63 63 65 73 73 66 75 6c 2c 20 7a 65 72 6f 20 69  ccessful, zero i
1800: 73 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 74  s returned. If t
1810: 68 65 20 70 61 72 65 6e 74 20 6b 65 79 20 69 73  he parent key is
1820: 20 61 6e 20 49 4e 54 45 47 45 52 20 50 52 49 4d   an INTEGER PRIM
1830: 41 52 59 20 0a 2a 2a 20 4b 45 59 20 63 6f 6c 75  ARY .** KEY colu
1840: 6d 6e 2c 20 74 68 65 6e 20 6f 75 74 70 75 74 20  mn, then output 
1850: 76 61 72 69 61 62 6c 65 20 2a 70 70 49 64 78 20  variable *ppIdx 
1860: 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 2e 20  is set to NULL. 
1870: 4f 74 68 65 72 77 69 73 65 2c 20 2a 70 70 49 64  Otherwise, *ppId
1880: 78 20 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20  x .** is set to 
1890: 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 75 6e 69  point to the uni
18a0: 71 75 65 20 69 6e 64 65 78 2e 20 0a 2a 2a 20 0a  que index. .** .
18b0: 2a 2a 20 49 66 20 74 68 65 20 70 61 72 65 6e 74  ** If the parent
18c0: 20 6b 65 79 20 63 6f 6e 73 69 73 74 73 20 6f 66   key consists of
18d0: 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e   a single column
18e0: 20 28 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65   (the foreign ke
18f0: 79 20 63 6f 6e 73 74 72 61 69 6e 74 0a 2a 2a 20  y constraint.** 
1900: 69 73 20 6e 6f 74 20 61 20 63 6f 6d 70 6f 73 69  is not a composi
1910: 74 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 29 2c  te foreign key),
1920: 20 6f 75 74 70 75 74 20 76 61 72 69 61 62 6c 65   output variable
1930: 20 2a 70 61 69 43 6f 6c 20 69 73 20 73 65 74 20   *paiCol is set 
1940: 74 6f 20 4e 55 4c 4c 2e 0a 2a 2a 20 4f 74 68 65  to NULL..** Othe
1950: 72 77 69 73 65 2c 20 69 74 20 69 73 20 73 65 74  rwise, it is set
1960: 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 61 6e 20   to point to an 
1970: 61 6c 6c 6f 63 61 74 65 64 20 61 72 72 61 79 20  allocated array 
1980: 6f 66 20 73 69 7a 65 20 4e 2c 20 77 68 65 72 65  of size N, where
1990: 0a 2a 2a 20 4e 20 69 73 20 74 68 65 20 6e 75 6d  .** N is the num
19a0: 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69  ber of columns i
19b0: 6e 20 74 68 65 20 70 61 72 65 6e 74 20 6b 65 79  n the parent key
19c0: 2e 20 54 68 65 20 66 69 72 73 74 20 65 6c 65 6d  . The first elem
19d0: 65 6e 74 20 6f 66 20 74 68 65 0a 2a 2a 20 61 72  ent of the.** ar
19e0: 72 61 79 20 69 73 20 74 68 65 20 69 6e 64 65 78  ray is the index
19f0: 20 6f 66 20 74 68 65 20 63 68 69 6c 64 20 74 61   of the child ta
1a00: 62 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20  ble column that 
1a10: 69 73 20 6d 61 70 70 65 64 20 62 79 20 74 68 65  is mapped by the
1a20: 20 46 4b 0a 2a 2a 20 63 6f 6e 73 74 72 61 69 6e   FK.** constrain
1a30: 74 20 74 6f 20 74 68 65 20 70 61 72 65 6e 74 20  t to the parent 
1a40: 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 73 74 6f  table column sto
1a50: 72 65 64 20 69 6e 20 74 68 65 20 6c 65 66 74 2d  red in the left-
1a60: 6d 6f 73 74 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f  most column.** o
1a70: 66 20 69 6e 64 65 78 20 2a 70 70 49 64 78 2e 20  f index *ppIdx. 
1a80: 54 68 65 20 73 65 63 6f 6e 64 20 65 6c 65 6d 65  The second eleme
1a90: 6e 74 20 6f 66 20 74 68 65 20 61 72 72 61 79 20  nt of the array 
1aa0: 69 73 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20  is the index of 
1ab0: 74 68 65 0a 2a 2a 20 63 68 69 6c 64 20 74 61 62  the.** child tab
1ac0: 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20 63  le column that c
1ad0: 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68  orresponds to th
1ae0: 65 20 73 65 63 6f 6e 64 20 6c 65 66 74 2d 6d 6f  e second left-mo
1af0: 73 74 20 63 6f 6c 75 6d 6e 20 6f 66 0a 2a 2a 20  st column of.** 
1b00: 2a 70 70 49 64 78 2c 20 61 6e 64 20 73 6f 20 6f  *ppIdx, and so o
1b10: 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20  n..**.** If the 
1b20: 72 65 71 75 69 72 65 64 20 69 6e 64 65 78 20 63  required index c
1b30: 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 2c 20  annot be found, 
1b40: 65 69 74 68 65 72 20 62 65 63 61 75 73 65 3a 0a  either because:.
1b50: 2a 2a 0a 2a 2a 20 20 20 31 29 20 54 68 65 20 6e  **.**   1) The n
1b60: 61 6d 65 64 20 70 61 72 65 6e 74 20 6b 65 79 20  amed parent key 
1b70: 63 6f 6c 75 6d 6e 73 20 64 6f 20 6e 6f 74 20 65  columns do not e
1b80: 78 69 73 74 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20  xist, or.**.**  
1b90: 20 32 29 20 54 68 65 20 6e 61 6d 65 64 20 70 61   2) The named pa
1ba0: 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 73  rent key columns
1bb0: 20 64 6f 20 65 78 69 73 74 2c 20 62 75 74 20 61   do exist, but a
1bc0: 72 65 20 6e 6f 74 20 73 75 62 6a 65 63 74 20 74  re not subject t
1bd0: 6f 20 61 0a 2a 2a 20 20 20 20 20 20 55 4e 49 51  o a.**      UNIQ
1be0: 55 45 20 6f 72 20 50 52 49 4d 41 52 59 20 4b 45  UE or PRIMARY KE
1bf0: 59 20 63 6f 6e 73 74 72 61 69 6e 74 2c 20 6f 72  Y constraint, or
1c00: 0a 2a 2a 0a 2a 2a 20 20 20 33 29 20 4e 6f 20 70  .**.**   3) No p
1c10: 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e  arent key column
1c20: 73 20 77 65 72 65 20 70 72 6f 76 69 64 65 64 20  s were provided 
1c30: 65 78 70 6c 69 63 69 74 6c 79 20 61 73 20 70 61  explicitly as pa
1c40: 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 20 20 20  rt of the.**    
1c50: 20 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 64 65    foreign key de
1c60: 66 69 6e 69 74 69 6f 6e 2c 20 61 6e 64 20 74 68  finition, and th
1c70: 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 64  e parent table d
1c80: 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 61 0a 2a  oes not have a.*
1c90: 2a 20 20 20 20 20 20 50 52 49 4d 41 52 59 20 4b  *      PRIMARY K
1ca0: 45 59 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 34  EY, or.**.**   4
1cb0: 29 20 4e 6f 20 70 61 72 65 6e 74 20 6b 65 79 20  ) No parent key 
1cc0: 63 6f 6c 75 6d 6e 73 20 77 65 72 65 20 70 72 6f  columns were pro
1cd0: 76 69 64 65 64 20 65 78 70 6c 69 63 69 74 6c 79  vided explicitly
1ce0: 20 61 73 20 70 61 72 74 20 6f 66 20 74 68 65 0a   as part of the.
1cf0: 2a 2a 20 20 20 20 20 20 66 6f 72 65 69 67 6e 20  **      foreign 
1d00: 6b 65 79 20 64 65 66 69 6e 69 74 69 6f 6e 2c 20  key definition, 
1d10: 61 6e 64 20 74 68 65 20 50 52 49 4d 41 52 59 20  and the PRIMARY 
1d20: 4b 45 59 20 6f 66 20 74 68 65 20 70 61 72 65 6e  KEY of the paren
1d30: 74 20 74 61 62 6c 65 20 0a 2a 2a 20 20 20 20 20  t table .**     
1d40: 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 61   consists of a a
1d50: 20 64 69 66 66 65 72 65 6e 74 20 6e 75 6d 62 65   different numbe
1d60: 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 74 6f 20  r of columns to 
1d70: 74 68 65 20 63 68 69 6c 64 20 6b 65 79 20 69 6e  the child key in
1d80: 20 0a 2a 2a 20 20 20 20 20 20 74 68 65 20 63 68   .**      the ch
1d90: 69 6c 64 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a  ild table..**.**
1da0: 20 74 68 65 6e 20 6e 6f 6e 2d 7a 65 72 6f 20 69   then non-zero i
1db0: 73 20 72 65 74 75 72 6e 65 64 2c 20 61 6e 64 20  s returned, and 
1dc0: 61 20 22 66 6f 72 65 69 67 6e 20 6b 65 79 20 6d  a "foreign key m
1dd0: 69 73 6d 61 74 63 68 22 20 65 72 72 6f 72 20 6c  ismatch" error l
1de0: 6f 61 64 65 64 0a 2a 2a 20 69 6e 74 6f 20 70 50  oaded.** into pP
1df0: 61 72 73 65 2e 20 49 66 20 61 6e 20 4f 4f 4d 20  arse. If an OOM 
1e00: 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 6e 6f  error occurs, no
1e10: 6e 2d 7a 65 72 6f 20 69 73 20 72 65 74 75 72 6e  n-zero is return
1e20: 65 64 20 61 6e 64 20 74 68 65 0a 2a 2a 20 70 50  ed and the.** pP
1e30: 61 72 73 65 2d 3e 64 62 2d 3e 6d 61 6c 6c 6f 63  arse->db->malloc
1e40: 46 61 69 6c 65 64 20 66 6c 61 67 20 69 73 20 73  Failed flag is s
1e50: 65 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  et..*/.int sqlit
1e60: 65 33 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78 28  e3FkLocateIndex(
1e70: 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65  .  Parse *pParse
1e80: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
1e90: 20 20 20 2f 2a 20 50 61 72 73 65 20 63 6f 6e 74     /* Parse cont
1ea0: 65 78 74 20 74 6f 20 73 74 6f 72 65 20 61 6e 79  ext to store any
1eb0: 20 65 72 72 6f 72 20 69 6e 20 2a 2f 0a 20 20 54   error in */.  T
1ec0: 61 62 6c 65 20 2a 70 50 61 72 65 6e 74 2c 20 20  able *pParent,  
1ed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1ee0: 2a 20 50 61 72 65 6e 74 20 74 61 62 6c 65 20 6f  * Parent table o
1ef0: 66 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74 20  f FK constraint 
1f00: 70 46 4b 65 79 20 2a 2f 0a 20 20 46 4b 65 79 20  pFKey */.  FKey 
1f10: 2a 70 46 4b 65 79 2c 20 20 20 20 20 20 20 20 20  *pFKey,         
1f20: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6f             /* Fo
1f30: 72 65 69 67 6e 20 6b 65 79 20 74 6f 20 66 69 6e  reign key to fin
1f40: 64 20 69 6e 64 65 78 20 66 6f 72 20 2a 2f 0a 20  d index for */. 
1f50: 20 49 6e 64 65 78 20 2a 2a 70 70 49 64 78 2c 20   Index **ppIdx, 
1f60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1f70: 20 2f 2a 20 4f 55 54 3a 20 55 6e 69 71 75 65 20   /* OUT: Unique 
1f80: 69 6e 64 65 78 20 6f 6e 20 70 61 72 65 6e 74 20  index on parent 
1f90: 74 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 2a  table */.  int *
1fa0: 2a 70 61 69 43 6f 6c 20 20 20 20 20 20 20 20 20  *paiCol         
1fb0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55             /* OU
1fc0: 54 3a 20 4d 61 70 20 6f 66 20 69 6e 64 65 78 20  T: Map of index 
1fd0: 63 6f 6c 75 6d 6e 73 20 69 6e 20 70 46 4b 65 79  columns in pFKey
1fe0: 20 2a 2f 0a 29 7b 0a 20 20 49 6e 64 65 78 20 2a   */.){.  Index *
1ff0: 70 49 64 78 20 3d 20 30 3b 20 20 20 20 20 20 20  pIdx = 0;       
2000: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2010: 56 61 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20  Value to return 
2020: 76 69 61 20 2a 70 70 49 64 78 20 2a 2f 0a 20 20  via *ppIdx */.  
2030: 69 6e 74 20 2a 61 69 43 6f 6c 20 3d 20 30 3b 20  int *aiCol = 0; 
2040: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2050: 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20      /* Value to 
2060: 72 65 74 75 72 6e 20 76 69 61 20 2a 70 61 69 43  return via *paiC
2070: 6f 6c 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 6f 6c  ol */.  int nCol
2080: 20 3d 20 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3b 20   = pFKey->nCol; 
2090: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e              /* N
20a0: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73  umber of columns
20b0: 20 69 6e 20 70 61 72 65 6e 74 20 6b 65 79 20 2a   in parent key *
20c0: 2f 0a 20 20 63 68 61 72 20 2a 7a 4b 65 79 20 3d  /.  char *zKey =
20d0: 20 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 30 5d 2e   pFKey->aCol[0].
20e0: 7a 43 6f 6c 3b 20 20 20 2f 2a 20 4e 61 6d 65 20  zCol;   /* Name 
20f0: 6f 66 20 6c 65 66 74 2d 6d 6f 73 74 20 70 61 72  of left-most par
2100: 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 20 2a  ent key column *
2110: 2f 0a 0a 20 20 2f 2a 20 54 68 65 20 63 61 6c 6c  /..  /* The call
2120: 65 72 20 69 73 20 72 65 73 70 6f 6e 73 69 62 6c  er is responsibl
2130: 65 20 66 6f 72 20 7a 65 72 6f 69 6e 67 20 6f 75  e for zeroing ou
2140: 74 70 75 74 20 70 61 72 61 6d 65 74 65 72 73 2e  tput parameters.
2150: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 70   */.  assert( pp
2160: 49 64 78 20 26 26 20 2a 70 70 49 64 78 3d 3d 30  Idx && *ppIdx==0
2170: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 21 70   );.  assert( !p
2180: 61 69 43 6f 6c 20 7c 7c 20 2a 70 61 69 43 6f 6c  aiCol || *paiCol
2190: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ==0 );.  assert(
21a0: 20 70 50 61 72 73 65 20 29 3b 0a 0a 20 20 2f 2a   pParse );..  /*
21b0: 20 49 66 20 74 68 69 73 20 69 73 20 61 20 6e 6f   If this is a no
21c0: 6e 2d 63 6f 6d 70 6f 73 69 74 65 20 28 73 69 6e  n-composite (sin
21d0: 67 6c 65 20 63 6f 6c 75 6d 6e 29 20 66 6f 72 65  gle column) fore
21e0: 69 67 6e 20 6b 65 79 2c 20 63 68 65 63 6b 20 69  ign key, check i
21f0: 66 20 69 74 20 0a 20 20 2a 2a 20 6d 61 70 73 20  f it .  ** maps 
2200: 74 6f 20 74 68 65 20 49 4e 54 45 47 45 52 20 50  to the INTEGER P
2210: 52 49 4d 41 52 59 20 4b 45 59 20 6f 66 20 74 61  RIMARY KEY of ta
2220: 62 6c 65 20 70 50 61 72 65 6e 74 2e 20 49 66 20  ble pParent. If 
2230: 73 6f 2c 20 6c 65 61 76 65 20 2a 70 70 49 64 78  so, leave *ppIdx
2240: 20 0a 20 20 2a 2a 20 61 6e 64 20 2a 70 61 69 43   .  ** and *paiC
2250: 6f 6c 20 73 65 74 20 74 6f 20 7a 65 72 6f 20 61  ol set to zero a
2260: 6e 64 20 72 65 74 75 72 6e 20 65 61 72 6c 79 2e  nd return early.
2270: 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4f 74 68 65   .  **.  ** Othe
2280: 72 77 69 73 65 2c 20 66 6f 72 20 61 20 63 6f 6d  rwise, for a com
2290: 70 6f 73 69 74 65 20 66 6f 72 65 69 67 6e 20 6b  posite foreign k
22a0: 65 79 20 28 6d 6f 72 65 20 74 68 61 6e 20 6f 6e  ey (more than on
22b0: 65 20 63 6f 6c 75 6d 6e 29 2c 20 61 6c 6c 6f 63  e column), alloc
22c0: 61 74 65 0a 20 20 2a 2a 20 73 70 61 63 65 20 66  ate.  ** space f
22d0: 6f 72 20 74 68 65 20 61 69 43 6f 6c 20 61 72 72  or the aiCol arr
22e0: 61 79 20 28 72 65 74 75 72 6e 65 64 20 76 69 61  ay (returned via
22f0: 20 6f 75 74 70 75 74 20 70 61 72 61 6d 65 74 65   output paramete
2300: 72 20 2a 70 61 69 43 6f 6c 29 2e 0a 20 20 2a 2a  r *paiCol)..  **
2310: 20 4e 6f 6e 2d 63 6f 6d 70 6f 73 69 74 65 20 66   Non-composite f
2320: 6f 72 65 69 67 6e 20 6b 65 79 73 20 64 6f 20 6e  oreign keys do n
2330: 6f 74 20 72 65 71 75 69 72 65 20 74 68 65 20 61  ot require the a
2340: 69 43 6f 6c 20 61 72 72 61 79 2e 0a 20 20 2a 2f  iCol array..  */
2350: 0a 20 20 69 66 28 20 6e 43 6f 6c 3d 3d 31 20 29  .  if( nCol==1 )
2360: 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 46 4b 20  {.    /* The FK 
2370: 6d 61 70 73 20 74 6f 20 74 68 65 20 49 50 4b 20  maps to the IPK 
2380: 69 66 20 61 6e 79 20 6f 66 20 74 68 65 20 66 6f  if any of the fo
2390: 6c 6c 6f 77 69 6e 67 20 61 72 65 20 74 72 75 65  llowing are true
23a0: 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20  :.    **.    ** 
23b0: 20 20 31 29 20 54 68 65 72 65 20 69 73 20 61 6e    1) There is an
23c0: 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59   INTEGER PRIMARY
23d0: 20 4b 45 59 20 63 6f 6c 75 6d 6e 20 61 6e 64 20   KEY column and 
23e0: 74 68 65 20 46 4b 20 69 73 20 69 6d 70 6c 69 63  the FK is implic
23f0: 69 74 6c 79 20 0a 20 20 20 20 2a 2a 20 20 20 20  itly .    **    
2400: 20 20 6d 61 70 70 65 64 20 74 6f 20 74 68 65 20    mapped to the 
2410: 70 72 69 6d 61 72 79 20 6b 65 79 20 6f 66 20 74  primary key of t
2420: 61 62 6c 65 20 70 50 61 72 65 6e 74 2c 20 6f 72  able pParent, or
2430: 0a 20 20 20 20 2a 2a 20 20 20 32 29 20 54 68 65  .    **   2) The
2440: 20 46 4b 20 69 73 20 65 78 70 6c 69 63 69 74 6c   FK is explicitl
2450: 79 20 6d 61 70 70 65 64 20 74 6f 20 61 20 63 6f  y mapped to a co
2460: 6c 75 6d 6e 20 64 65 63 6c 61 72 65 64 20 61 73  lumn declared as
2470: 20 49 4e 54 45 47 45 52 0a 20 20 20 20 2a 2a 20   INTEGER.    ** 
2480: 20 20 20 20 20 50 52 49 4d 41 52 59 20 4b 45 59       PRIMARY KEY
2490: 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28  ..    */.    if(
24a0: 20 70 50 61 72 65 6e 74 2d 3e 69 50 4b 65 79 3e   pParent->iPKey>
24b0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20  =0 ){.      if( 
24c0: 21 7a 4b 65 79 20 29 20 72 65 74 75 72 6e 20 30  !zKey ) return 0
24d0: 3b 0a 20 20 20 20 20 20 69 66 28 20 21 73 71 6c  ;.      if( !sql
24e0: 69 74 65 33 53 74 72 49 43 6d 70 28 70 50 61 72  ite3StrICmp(pPar
24f0: 65 6e 74 2d 3e 61 43 6f 6c 5b 70 50 61 72 65 6e  ent->aCol[pParen
2500: 74 2d 3e 69 50 4b 65 79 5d 2e 7a 4e 61 6d 65 2c  t->iPKey].zName,
2510: 20 7a 4b 65 79 29 20 29 20 72 65 74 75 72 6e 20   zKey) ) return 
2520: 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65  0;.    }.  }else
2530: 20 69 66 28 20 70 61 69 43 6f 6c 20 29 7b 0a 20   if( paiCol ){. 
2540: 20 20 20 61 73 73 65 72 74 28 20 6e 43 6f 6c 3e     assert( nCol>
2550: 31 20 29 3b 0a 20 20 20 20 61 69 43 6f 6c 20 3d  1 );.    aiCol =
2560: 20 28 69 6e 74 20 2a 29 73 71 6c 69 74 65 33 44   (int *)sqlite3D
2570: 62 4d 61 6c 6c 6f 63 52 61 77 28 70 50 61 72 73  bMallocRaw(pPars
2580: 65 2d 3e 64 62 2c 20 6e 43 6f 6c 2a 73 69 7a 65  e->db, nCol*size
2590: 6f 66 28 69 6e 74 29 29 3b 0a 20 20 20 20 69 66  of(int));.    if
25a0: 28 20 21 61 69 43 6f 6c 20 29 20 72 65 74 75 72  ( !aiCol ) retur
25b0: 6e 20 31 3b 0a 20 20 20 20 2a 70 61 69 43 6f 6c  n 1;.    *paiCol
25c0: 20 3d 20 61 69 43 6f 6c 3b 0a 20 20 7d 0a 0a 20   = aiCol;.  }.. 
25d0: 20 66 6f 72 28 70 49 64 78 3d 70 50 61 72 65 6e   for(pIdx=pParen
25e0: 74 2d 3e 70 49 6e 64 65 78 3b 20 70 49 64 78 3b  t->pIndex; pIdx;
25f0: 20 70 49 64 78 3d 70 49 64 78 2d 3e 70 4e 65 78   pIdx=pIdx->pNex
2600: 74 29 7b 0a 20 20 20 20 69 66 28 20 70 49 64 78  t){.    if( pIdx
2610: 2d 3e 6e 4b 65 79 43 6f 6c 3d 3d 6e 43 6f 6c 20  ->nKeyCol==nCol 
2620: 26 26 20 70 49 64 78 2d 3e 6f 6e 45 72 72 6f 72  && pIdx->onError
2630: 21 3d 4f 45 5f 4e 6f 6e 65 20 29 7b 20 0a 20 20  !=OE_None ){ .  
2640: 20 20 20 20 2f 2a 20 70 49 64 78 20 69 73 20 61      /* pIdx is a
2650: 20 55 4e 49 51 55 45 20 69 6e 64 65 78 20 28 6f   UNIQUE index (o
2660: 72 20 61 20 50 52 49 4d 41 52 59 20 4b 45 59 29  r a PRIMARY KEY)
2670: 20 61 6e 64 20 68 61 73 20 74 68 65 20 72 69 67   and has the rig
2680: 68 74 20 6e 75 6d 62 65 72 0a 20 20 20 20 20 20  ht number.      
2690: 2a 2a 20 6f 66 20 63 6f 6c 75 6d 6e 73 2e 20 49  ** of columns. I
26a0: 66 20 65 61 63 68 20 69 6e 64 65 78 65 64 20 63  f each indexed c
26b0: 6f 6c 75 6d 6e 20 63 6f 72 72 65 73 70 6f 6e 64  olumn correspond
26c0: 73 20 74 6f 20 61 20 66 6f 72 65 69 67 6e 20 6b  s to a foreign k
26d0: 65 79 0a 20 20 20 20 20 20 2a 2a 20 63 6f 6c 75  ey.      ** colu
26e0: 6d 6e 20 6f 66 20 70 46 4b 65 79 2c 20 74 68 65  mn of pFKey, the
26f0: 6e 20 74 68 69 73 20 69 6e 64 65 78 20 69 73 20  n this index is 
2700: 61 20 77 69 6e 6e 65 72 2e 20 20 2a 2f 0a 0a 20  a winner.  */.. 
2710: 20 20 20 20 20 69 66 28 20 7a 4b 65 79 3d 3d 30       if( zKey==0
2720: 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49   ){.        /* I
2730: 66 20 7a 4b 65 79 20 69 73 20 4e 55 4c 4c 2c 20  f zKey is NULL, 
2740: 74 68 65 6e 20 74 68 69 73 20 66 6f 72 65 69 67  then this foreig
2750: 6e 20 6b 65 79 20 69 73 20 69 6d 70 6c 69 63 69  n key is implici
2760: 74 6c 79 20 6d 61 70 70 65 64 20 74 6f 20 0a 20  tly mapped to . 
2770: 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 50 52         ** the PR
2780: 49 4d 41 52 59 20 4b 45 59 20 6f 66 20 74 61 62  IMARY KEY of tab
2790: 6c 65 20 70 50 61 72 65 6e 74 2e 20 54 68 65 20  le pParent. The 
27a0: 50 52 49 4d 41 52 59 20 4b 45 59 20 69 6e 64 65  PRIMARY KEY inde
27b0: 78 20 6d 61 79 20 62 65 20 0a 20 20 20 20 20 20  x may be .      
27c0: 20 20 2a 2a 20 69 64 65 6e 74 69 66 69 65 64 20    ** identified 
27d0: 62 79 20 74 68 65 20 74 65 73 74 20 28 49 6e 64  by the test (Ind
27e0: 65 78 2e 61 75 74 6f 49 6e 64 65 78 3d 3d 32 29  ex.autoIndex==2)
27f0: 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 66  .  */.        if
2800: 28 20 70 49 64 78 2d 3e 61 75 74 6f 49 6e 64 65  ( pIdx->autoInde
2810: 78 3d 3d 32 20 29 7b 0a 20 20 20 20 20 20 20 20  x==2 ){.        
2820: 20 20 69 66 28 20 61 69 43 6f 6c 20 29 7b 0a 20    if( aiCol ){. 
2830: 20 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 69             int i
2840: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 66 6f  ;.            fo
2850: 72 28 69 3d 30 3b 20 69 3c 6e 43 6f 6c 3b 20 69  r(i=0; i<nCol; i
2860: 2b 2b 29 20 61 69 43 6f 6c 5b 69 5d 20 3d 20 70  ++) aiCol[i] = p
2870: 46 4b 65 79 2d 3e 61 43 6f 6c 5b 69 5d 2e 69 46  FKey->aCol[i].iF
2880: 72 6f 6d 3b 0a 20 20 20 20 20 20 20 20 20 20 7d  rom;.          }
2890: 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b  .          break
28a0: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
28b0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
28c0: 20 2f 2a 20 49 66 20 7a 4b 65 79 20 69 73 20 6e   /* If zKey is n
28d0: 6f 6e 2d 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68  on-NULL, then th
28e0: 69 73 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 77  is foreign key w
28f0: 61 73 20 64 65 63 6c 61 72 65 64 20 74 6f 0a 20  as declared to. 
2900: 20 20 20 20 20 20 20 2a 2a 20 6d 61 70 20 74 6f         ** map to
2910: 20 61 6e 20 65 78 70 6c 69 63 69 74 20 6c 69 73   an explicit lis
2920: 74 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20  t of columns in 
2930: 74 61 62 6c 65 20 70 50 61 72 65 6e 74 2e 20 43  table pParent. C
2940: 68 65 63 6b 20 69 66 20 74 68 69 73 0a 20 20 20  heck if this.   
2950: 20 20 20 20 20 2a 2a 20 69 6e 64 65 78 20 6d 61       ** index ma
2960: 74 63 68 65 73 20 74 68 6f 73 65 20 63 6f 6c 75  tches those colu
2970: 6d 6e 73 2e 20 41 6c 73 6f 2c 20 63 68 65 63 6b  mns. Also, check
2980: 20 74 68 61 74 20 74 68 65 20 69 6e 64 65 78 20   that the index 
2990: 75 73 65 73 0a 20 20 20 20 20 20 20 20 2a 2a 20  uses.        ** 
29a0: 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c  the default coll
29b0: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 73 20  ation sequences 
29c0: 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d 6e 2e  for each column.
29d0: 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 6e 74 20   */.        int 
29e0: 69 2c 20 6a 3b 0a 20 20 20 20 20 20 20 20 66 6f  i, j;.        fo
29f0: 72 28 69 3d 30 3b 20 69 3c 6e 43 6f 6c 3b 20 69  r(i=0; i<nCol; i
2a00: 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69  ++){.          i
2a10: 31 36 20 69 43 6f 6c 20 3d 20 70 49 64 78 2d 3e  16 iCol = pIdx->
2a20: 61 69 43 6f 6c 75 6d 6e 5b 69 5d 3b 20 20 20 20  aiColumn[i];    
2a30: 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 63 6f 6c   /* Index of col
2a40: 75 6d 6e 20 69 6e 20 70 61 72 65 6e 74 20 74 62  umn in parent tb
2a50: 6c 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 63  l */.          c
2a60: 68 61 72 20 2a 7a 44 66 6c 74 43 6f 6c 6c 3b 20  har *zDfltColl; 
2a70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2a80: 20 2f 2a 20 44 65 66 2e 20 63 6f 6c 6c 61 74 69   /* Def. collati
2a90: 6f 6e 20 66 6f 72 20 63 6f 6c 75 6d 6e 20 2a 2f  on for column */
2aa0: 0a 20 20 20 20 20 20 20 20 20 20 63 68 61 72 20  .          char 
2ab0: 2a 7a 49 64 78 43 6f 6c 3b 20 20 20 20 20 20 20  *zIdxCol;       
2ac0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
2ad0: 4e 61 6d 65 20 6f 66 20 69 6e 64 65 78 65 64 20  Name of indexed 
2ae0: 63 6f 6c 75 6d 6e 20 2a 2f 0a 0a 20 20 20 20 20  column */..     
2af0: 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 69       /* If the i
2b00: 6e 64 65 78 20 75 73 65 73 20 61 20 63 6f 6c 6c  ndex uses a coll
2b10: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 74  ation sequence t
2b20: 68 61 74 20 69 73 20 64 69 66 66 65 72 65 6e 74  hat is different
2b30: 20 66 72 6f 6d 0a 20 20 20 20 20 20 20 20 20 20   from.          
2b40: 2a 2a 20 74 68 65 20 64 65 66 61 75 6c 74 20 63  ** the default c
2b50: 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63  ollation sequenc
2b60: 65 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e  e for the column
2b70: 2c 20 74 68 69 73 20 69 6e 64 65 78 20 69 73 0a  , this index is.
2b80: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 75 6e 75            ** unu
2b90: 73 61 62 6c 65 2e 20 42 61 69 6c 20 6f 75 74 20  sable. Bail out 
2ba0: 65 61 72 6c 79 20 69 6e 20 74 68 69 73 20 63 61  early in this ca
2bb0: 73 65 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 20  se.  */.        
2bc0: 20 20 7a 44 66 6c 74 43 6f 6c 6c 20 3d 20 70 50    zDfltColl = pP
2bd0: 61 72 65 6e 74 2d 3e 61 43 6f 6c 5b 69 43 6f 6c  arent->aCol[iCol
2be0: 5d 2e 7a 43 6f 6c 6c 3b 0a 20 20 20 20 20 20 20  ].zColl;.       
2bf0: 20 20 20 69 66 28 20 21 7a 44 66 6c 74 43 6f 6c     if( !zDfltCol
2c00: 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20  l ){.           
2c10: 20 7a 44 66 6c 74 43 6f 6c 6c 20 3d 20 22 42 49   zDfltColl = "BI
2c20: 4e 41 52 59 22 3b 0a 20 20 20 20 20 20 20 20 20  NARY";.         
2c30: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 28   }.          if(
2c40: 20 73 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28   sqlite3StrICmp(
2c50: 70 49 64 78 2d 3e 61 7a 43 6f 6c 6c 5b 69 5d 2c  pIdx->azColl[i],
2c60: 20 7a 44 66 6c 74 43 6f 6c 6c 29 20 29 20 62 72   zDfltColl) ) br
2c70: 65 61 6b 3b 0a 0a 20 20 20 20 20 20 20 20 20 20  eak;..          
2c80: 7a 49 64 78 43 6f 6c 20 3d 20 70 50 61 72 65 6e  zIdxCol = pParen
2c90: 74 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 2e 7a 4e  t->aCol[iCol].zN
2ca0: 61 6d 65 3b 0a 20 20 20 20 20 20 20 20 20 20 66  ame;.          f
2cb0: 6f 72 28 6a 3d 30 3b 20 6a 3c 6e 43 6f 6c 3b 20  or(j=0; j<nCol; 
2cc0: 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20  j++){.          
2cd0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 74 72    if( sqlite3Str
2ce0: 49 43 6d 70 28 70 46 4b 65 79 2d 3e 61 43 6f 6c  ICmp(pFKey->aCol
2cf0: 5b 6a 5d 2e 7a 43 6f 6c 2c 20 7a 49 64 78 43 6f  [j].zCol, zIdxCo
2d00: 6c 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20  l)==0 ){.       
2d10: 20 20 20 20 20 20 20 69 66 28 20 61 69 43 6f 6c         if( aiCol
2d20: 20 29 20 61 69 43 6f 6c 5b 69 5d 20 3d 20 70 46   ) aiCol[i] = pF
2d30: 4b 65 79 2d 3e 61 43 6f 6c 5b 6a 5d 2e 69 46 72  Key->aCol[j].iFr
2d40: 6f 6d 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  om;.            
2d50: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20    break;.       
2d60: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20       }.         
2d70: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69 66 28   }.          if(
2d80: 20 6a 3d 3d 6e 43 6f 6c 20 29 20 62 72 65 61 6b   j==nCol ) break
2d90: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
2da0: 20 20 20 20 69 66 28 20 69 3d 3d 6e 43 6f 6c 20      if( i==nCol 
2db0: 29 20 62 72 65 61 6b 3b 20 20 20 20 20 20 2f 2a  ) break;      /*
2dc0: 20 70 49 64 78 20 69 73 20 75 73 61 62 6c 65 20   pIdx is usable 
2dd0: 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  */.      }.    }
2de0: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 21 70 49 64  .  }..  if( !pId
2df0: 78 20 29 7b 0a 20 20 20 20 69 66 28 20 21 70 50  x ){.    if( !pP
2e00: 61 72 73 65 2d 3e 64 69 73 61 62 6c 65 54 72 69  arse->disableTri
2e10: 67 67 65 72 73 20 29 7b 0a 20 20 20 20 20 20 73  ggers ){.      s
2e20: 71 6c 69 74 65 33 45 72 72 6f 72 4d 73 67 28 70  qlite3ErrorMsg(p
2e30: 50 61 72 73 65 2c 0a 20 20 20 20 20 20 20 20 20  Parse,.         
2e40: 20 20 22 66 6f 72 65 69 67 6e 20 6b 65 79 20 6d    "foreign key m
2e50: 69 73 6d 61 74 63 68 20 2d 20 5c 22 25 77 5c 22  ismatch - \"%w\"
2e60: 20 72 65 66 65 72 65 6e 63 69 6e 67 20 5c 22 25   referencing \"%
2e70: 77 5c 22 22 2c 0a 20 20 20 20 20 20 20 20 20 20  w\"",.          
2e80: 20 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 2d 3e 7a   pFKey->pFrom->z
2e90: 4e 61 6d 65 2c 20 70 46 4b 65 79 2d 3e 7a 54 6f  Name, pFKey->zTo
2ea0: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c  );.    }.    sql
2eb0: 69 74 65 33 44 62 46 72 65 65 28 70 50 61 72 73  ite3DbFree(pPars
2ec0: 65 2d 3e 64 62 2c 20 61 69 43 6f 6c 29 3b 0a 20  e->db, aiCol);. 
2ed0: 20 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d     return 1;.  }
2ee0: 0a 0a 20 20 2a 70 70 49 64 78 20 3d 20 70 49 64  ..  *ppIdx = pId
2ef0: 78 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d  x;.  return 0;.}
2f00: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e  ../*.** This fun
2f10: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20  ction is called 
2f20: 77 68 65 6e 20 61 20 72 6f 77 20 69 73 20 69 6e  when a row is in
2f30: 73 65 72 74 65 64 20 69 6e 74 6f 20 6f 72 20 64  serted into or d
2f40: 65 6c 65 74 65 64 20 66 72 6f 6d 20 74 68 65 20  eleted from the 
2f50: 0a 2a 2a 20 63 68 69 6c 64 20 74 61 62 6c 65 20  .** child table 
2f60: 6f 66 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63  of foreign key c
2f70: 6f 6e 73 74 72 61 69 6e 74 20 70 46 4b 65 79 2e  onstraint pFKey.
2f80: 20 49 66 20 61 6e 20 53 51 4c 20 55 50 44 41 54   If an SQL UPDAT
2f90: 45 20 69 73 20 65 78 65 63 75 74 65 64 20 0a 2a  E is executed .*
2fa0: 2a 20 6f 6e 20 74 68 65 20 63 68 69 6c 64 20 74  * on the child t
2fb0: 61 62 6c 65 20 6f 66 20 70 46 4b 65 79 2c 20 74  able of pFKey, t
2fc0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
2fd0: 69 6e 76 6f 6b 65 64 20 74 77 69 63 65 20 66 6f  invoked twice fo
2fe0: 72 20 65 61 63 68 20 72 6f 77 0a 2a 2a 20 61 66  r each row.** af
2ff0: 66 65 63 74 65 64 20 2d 20 6f 6e 63 65 20 74 6f  fected - once to
3000: 20 22 64 65 6c 65 74 65 22 20 74 68 65 20 6f 6c   "delete" the ol
3010: 64 20 72 6f 77 2c 20 61 6e 64 20 74 68 65 6e 20  d row, and then 
3020: 61 67 61 69 6e 20 74 6f 20 22 69 6e 73 65 72 74  again to "insert
3030: 22 20 74 68 65 0a 2a 2a 20 6e 65 77 20 72 6f 77  " the.** new row
3040: 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 74 69 6d  ..**.** Each tim
3050: 65 20 69 74 20 69 73 20 63 61 6c 6c 65 64 2c 20  e it is called, 
3060: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 67 65  this function ge
3070: 6e 65 72 61 74 65 73 20 56 44 42 45 20 63 6f 64  nerates VDBE cod
3080: 65 20 74 6f 20 6c 6f 63 61 74 65 20 74 68 65 0a  e to locate the.
3090: 2a 2a 20 72 6f 77 20 69 6e 20 74 68 65 20 70 61  ** row in the pa
30a0: 72 65 6e 74 20 74 61 62 6c 65 20 74 68 61 74 20  rent table that 
30b0: 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74  corresponds to t
30c0: 68 65 20 72 6f 77 20 62 65 69 6e 67 20 69 6e 73  he row being ins
30d0: 65 72 74 65 64 20 69 6e 74 6f 20 0a 2a 2a 20 6f  erted into .** o
30e0: 72 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 74  r deleted from t
30f0: 68 65 20 63 68 69 6c 64 20 74 61 62 6c 65 2e 20  he child table. 
3100: 49 66 20 74 68 65 20 70 61 72 65 6e 74 20 72 6f  If the parent ro
3110: 77 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 2c 20  w can be found, 
3120: 6e 6f 20 0a 2a 2a 20 73 70 65 63 69 61 6c 20 61  no .** special a
3130: 63 74 69 6f 6e 20 69 73 20 74 61 6b 65 6e 2e 20  ction is taken. 
3140: 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20 74 68  Otherwise, if th
3150: 65 20 70 61 72 65 6e 74 20 72 6f 77 20 63 61 6e  e parent row can
3160: 20 2a 6e 6f 74 2a 20 62 65 0a 2a 2a 20 66 6f 75   *not* be.** fou
3170: 6e 64 20 69 6e 20 74 68 65 20 70 61 72 65 6e 74  nd in the parent
3180: 20 74 61 62 6c 65 3a 0a 2a 2a 0a 2a 2a 20 20 20   table:.**.**   
3190: 4f 70 65 72 61 74 69 6f 6e 20 7c 20 46 4b 20 74  Operation | FK t
31a0: 79 70 65 20 20 20 7c 20 41 63 74 69 6f 6e 20 74  ype   | Action t
31b0: 61 6b 65 6e 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d  aken.**   ------
31c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
31d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
31e0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
31f0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
3200: 2d 2d 2d 2d 0a 2a 2a 20 20 20 49 4e 53 45 52 54  ----.**   INSERT
3210: 20 20 20 20 20 20 69 6d 6d 65 64 69 61 74 65 20        immediate 
3220: 20 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20    Increment the 
3230: 22 69 6d 6d 65 64 69 61 74 65 20 63 6f 6e 73 74  "immediate const
3240: 72 61 69 6e 74 20 63 6f 75 6e 74 65 72 22 2e 0a  raint counter"..
3250: 2a 2a 0a 2a 2a 20 20 20 44 45 4c 45 54 45 20 20  **.**   DELETE  
3260: 20 20 20 20 69 6d 6d 65 64 69 61 74 65 20 20 20      immediate   
3270: 44 65 63 72 65 6d 65 6e 74 20 74 68 65 20 22 69  Decrement the "i
3280: 6d 6d 65 64 69 61 74 65 20 63 6f 6e 73 74 72 61  mmediate constra
3290: 69 6e 74 20 63 6f 75 6e 74 65 72 22 2e 0a 2a 2a  int counter"..**
32a0: 0a 2a 2a 20 20 20 49 4e 53 45 52 54 20 20 20 20  .**   INSERT    
32b0: 20 20 64 65 66 65 72 72 65 64 20 20 20 20 49 6e    deferred    In
32c0: 63 72 65 6d 65 6e 74 20 74 68 65 20 22 64 65 66  crement the "def
32d0: 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69 6e 74  erred constraint
32e0: 20 63 6f 75 6e 74 65 72 22 2e 0a 2a 2a 0a 2a 2a   counter"..**.**
32f0: 20 20 20 44 45 4c 45 54 45 20 20 20 20 20 20 64     DELETE      d
3300: 65 66 65 72 72 65 64 20 20 20 20 44 65 63 72 65  eferred    Decre
3310: 6d 65 6e 74 20 74 68 65 20 22 64 65 66 65 72 72  ment the "deferr
3320: 65 64 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f  ed constraint co
3330: 75 6e 74 65 72 22 2e 0a 2a 2a 0a 2a 2a 20 54 68  unter"..**.** Th
3340: 65 73 65 20 6f 70 65 72 61 74 69 6f 6e 73 20 61  ese operations a
3350: 72 65 20 69 64 65 6e 74 69 66 69 65 64 20 69 6e  re identified in
3360: 20 74 68 65 20 63 6f 6d 6d 65 6e 74 20 61 74 20   the comment at 
3370: 74 68 65 20 74 6f 70 20 6f 66 20 74 68 69 73 20  the top of this 
3380: 66 69 6c 65 20 0a 2a 2a 20 28 66 6b 65 79 2e 63  file .** (fkey.c
3390: 29 20 61 73 20 22 49 2e 31 22 20 61 6e 64 20 22  ) as "I.1" and "
33a0: 44 2e 31 22 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  D.1"..*/.static 
33b0: 76 6f 69 64 20 66 6b 4c 6f 6f 6b 75 70 50 61 72  void fkLookupPar
33c0: 65 6e 74 28 0a 20 20 50 61 72 73 65 20 2a 70 50  ent(.  Parse *pP
33d0: 61 72 73 65 2c 20 20 20 20 20 20 20 20 2f 2a 20  arse,        /* 
33e0: 50 61 72 73 65 20 63 6f 6e 74 65 78 74 20 2a 2f  Parse context */
33f0: 0a 20 20 69 6e 74 20 69 44 62 2c 20 20 20 20 20  .  int iDb,     
3400: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65           /* Inde
3410: 78 20 6f 66 20 64 61 74 61 62 61 73 65 20 68 6f  x of database ho
3420: 75 73 69 6e 67 20 70 54 61 62 20 2a 2f 0a 20 20  using pTab */.  
3430: 54 61 62 6c 65 20 2a 70 54 61 62 2c 20 20 20 20  Table *pTab,    
3440: 20 20 20 20 20 20 2f 2a 20 50 61 72 65 6e 74 20        /* Parent 
3450: 74 61 62 6c 65 20 6f 66 20 46 4b 20 70 46 4b 65  table of FK pFKe
3460: 79 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 70 49  y */.  Index *pI
3470: 64 78 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20  dx,          /* 
3480: 55 6e 69 71 75 65 20 69 6e 64 65 78 20 6f 6e 20  Unique index on 
3490: 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d  parent key colum
34a0: 6e 73 20 69 6e 20 70 54 61 62 20 2a 2f 0a 20 20  ns in pTab */.  
34b0: 46 4b 65 79 20 2a 70 46 4b 65 79 2c 20 20 20 20  FKey *pFKey,    
34c0: 20 20 20 20 20 20 2f 2a 20 46 6f 72 65 69 67 6e        /* Foreign
34d0: 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20   key constraint 
34e0: 2a 2f 0a 20 20 69 6e 74 20 2a 61 69 43 6f 6c 2c  */.  int *aiCol,
34f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61             /* Ma
3500: 70 20 66 72 6f 6d 20 70 61 72 65 6e 74 20 6b 65  p from parent ke
3510: 79 20 63 6f 6c 75 6d 6e 73 20 74 6f 20 63 68 69  y columns to chi
3520: 6c 64 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 73  ld table columns
3530: 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 44 61 74   */.  int regDat
3540: 61 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41  a,          /* A
3550: 64 64 72 65 73 73 20 6f 66 20 61 72 72 61 79 20  ddress of array 
3560: 63 6f 6e 74 61 69 6e 69 6e 67 20 63 68 69 6c 64  containing child
3570: 20 74 61 62 6c 65 20 72 6f 77 20 2a 2f 0a 20 20   table row */.  
3580: 69 6e 74 20 6e 49 6e 63 72 2c 20 20 20 20 20 20  int nIncr,      
3590: 20 20 20 20 20 20 2f 2a 20 49 6e 63 72 65 6d 65        /* Increme
35a0: 6e 74 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f  nt constraint co
35b0: 75 6e 74 65 72 20 62 79 20 74 68 69 73 20 2a 2f  unter by this */
35c0: 0a 20 20 69 6e 74 20 69 73 49 67 6e 6f 72 65 20  .  int isIgnore 
35d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74           /* If t
35e0: 72 75 65 2c 20 70 72 65 74 65 6e 64 20 70 54 61  rue, pretend pTa
35f0: 62 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 20 4e  b contains all N
3600: 55 4c 4c 20 76 61 6c 75 65 73 20 2a 2f 0a 29 7b  ULL values */.){
3610: 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20  .  int i;       
3620: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3630: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
3640: 49 74 65 72 61 74 6f 72 20 76 61 72 69 61 62 6c  Iterator variabl
3650: 65 20 2a 2f 0a 20 20 56 64 62 65 20 2a 76 20 3d  e */.  Vdbe *v =
3660: 20 73 71 6c 69 74 65 33 47 65 74 56 64 62 65 28   sqlite3GetVdbe(
3670: 70 50 61 72 73 65 29 3b 20 20 20 20 20 20 20 20  pParse);        
3680: 20 2f 2a 20 56 64 62 65 20 74 6f 20 61 64 64 20   /* Vdbe to add 
3690: 63 6f 64 65 20 74 6f 20 2a 2f 0a 20 20 69 6e 74  code to */.  int
36a0: 20 69 43 75 72 20 3d 20 70 50 61 72 73 65 2d 3e   iCur = pParse->
36b0: 6e 54 61 62 20 2d 20 31 3b 20 20 20 20 20 20 20  nTab - 1;       
36c0: 20 20 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72         /* Cursor
36d0: 20 6e 75 6d 62 65 72 20 74 6f 20 75 73 65 20 2a   number to use *
36e0: 2f 0a 20 20 69 6e 74 20 69 4f 6b 20 3d 20 73 71  /.  int iOk = sq
36f0: 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c 61 62  lite3VdbeMakeLab
3700: 65 6c 28 76 29 3b 20 20 20 20 20 20 20 20 2f 2a  el(v);        /*
3710: 20 6a 75 6d 70 20 68 65 72 65 20 69 66 20 70 61   jump here if pa
3720: 72 65 6e 74 20 6b 65 79 20 66 6f 75 6e 64 20 2a  rent key found *
3730: 2f 0a 0a 20 20 2f 2a 20 49 66 20 6e 49 6e 63 72  /..  /* If nIncr
3740: 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20 7a 65   is less than ze
3750: 72 6f 2c 20 74 68 65 6e 20 63 68 65 63 6b 20 61  ro, then check a
3760: 74 20 72 75 6e 74 69 6d 65 20 69 66 20 74 68 65  t runtime if the
3770: 72 65 20 61 72 65 20 61 6e 79 0a 20 20 2a 2a 20  re are any.  ** 
3780: 6f 75 74 73 74 61 6e 64 69 6e 67 20 63 6f 6e 73  outstanding cons
3790: 74 72 61 69 6e 74 73 20 74 6f 20 72 65 73 6f 6c  traints to resol
37a0: 76 65 2e 20 49 66 20 74 68 65 72 65 20 61 72 65  ve. If there are
37b0: 20 6e 6f 74 2c 20 74 68 65 72 65 20 69 73 20 6e   not, there is n
37c0: 6f 20 6e 65 65 64 0a 20 20 2a 2a 20 74 6f 20 63  o need.  ** to c
37d0: 68 65 63 6b 20 69 66 20 64 65 6c 65 74 69 6e 67  heck if deleting
37e0: 20 74 68 69 73 20 72 6f 77 20 72 65 73 6f 6c 76   this row resolv
37f0: 65 73 20 61 6e 79 20 6f 75 74 73 74 61 6e 64 69  es any outstandi
3800: 6e 67 20 76 69 6f 6c 61 74 69 6f 6e 73 2e 0a 20  ng violations.. 
3810: 20 2a 2a 0a 20 20 2a 2a 20 43 68 65 63 6b 20 69   **.  ** Check i
3820: 66 20 61 6e 79 20 6f 66 20 74 68 65 20 6b 65 79  f any of the key
3830: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20   columns in the 
3840: 63 68 69 6c 64 20 74 61 62 6c 65 20 72 6f 77 20  child table row 
3850: 61 72 65 20 4e 55 4c 4c 2e 20 49 66 20 0a 20 20  are NULL. If .  
3860: 2a 2a 20 61 6e 79 20 61 72 65 2c 20 74 68 65 6e  ** any are, then
3870: 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 20   the constraint 
3880: 69 73 20 63 6f 6e 73 69 64 65 72 65 64 20 73 61  is considered sa
3890: 74 69 73 66 69 65 64 2e 20 4e 6f 20 6e 65 65 64  tisfied. No need
38a0: 20 74 6f 20 0a 20 20 2a 2a 20 73 65 61 72 63 68   to .  ** search
38b0: 20 66 6f 72 20 61 20 6d 61 74 63 68 69 6e 67 20   for a matching 
38c0: 72 6f 77 20 69 6e 20 74 68 65 20 70 61 72 65 6e  row in the paren
38d0: 74 20 74 61 62 6c 65 2e 20 20 2a 2f 0a 20 20 69  t table.  */.  i
38e0: 66 28 20 6e 49 6e 63 72 3c 30 20 29 7b 0a 20 20  f( nIncr<0 ){.  
38f0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64    sqlite3VdbeAdd
3900: 4f 70 32 28 76 2c 20 4f 50 5f 46 6b 49 66 5a 65  Op2(v, OP_FkIfZe
3910: 72 6f 2c 20 70 46 4b 65 79 2d 3e 69 73 44 65 66  ro, pFKey->isDef
3920: 65 72 72 65 64 2c 20 69 4f 6b 29 3b 0a 20 20 7d  erred, iOk);.  }
3930: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 46  .  for(i=0; i<pF
3940: 4b 65 79 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29 7b  Key->nCol; i++){
3950: 0a 20 20 20 20 69 6e 74 20 69 52 65 67 20 3d 20  .    int iReg = 
3960: 61 69 43 6f 6c 5b 69 5d 20 2b 20 72 65 67 44 61  aiCol[i] + regDa
3970: 74 61 20 2b 20 31 3b 0a 20 20 20 20 73 71 6c 69  ta + 1;.    sqli
3980: 74 65 33 56 64 62 65 41 64 64 4f 70 32 28 76 2c  te3VdbeAddOp2(v,
3990: 20 4f 50 5f 49 73 4e 75 6c 6c 2c 20 69 52 65 67   OP_IsNull, iReg
39a0: 2c 20 69 4f 6b 29 3b 0a 20 20 7d 0a 0a 20 20 69  , iOk);.  }..  i
39b0: 66 28 20 69 73 49 67 6e 6f 72 65 3d 3d 30 20 29  f( isIgnore==0 )
39c0: 7b 0a 20 20 20 20 69 66 28 20 70 49 64 78 3d 3d  {.    if( pIdx==
39d0: 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 66  0 ){.      /* If
39e0: 20 70 49 64 78 20 69 73 20 4e 55 4c 4c 2c 20 74   pIdx is NULL, t
39f0: 68 65 6e 20 74 68 65 20 70 61 72 65 6e 74 20 6b  hen the parent k
3a00: 65 79 20 69 73 20 74 68 65 20 49 4e 54 45 47 45  ey is the INTEGE
3a10: 52 20 50 52 49 4d 41 52 59 20 4b 45 59 0a 20 20  R PRIMARY KEY.  
3a20: 20 20 20 20 2a 2a 20 63 6f 6c 75 6d 6e 20 6f 66      ** column of
3a30: 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c   the parent tabl
3a40: 65 20 28 74 61 62 6c 65 20 70 54 61 62 29 2e 20  e (table pTab). 
3a50: 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 69 4d   */.      int iM
3a60: 75 73 74 42 65 49 6e 74 3b 20 20 20 20 20 20 20  ustBeInt;       
3a70: 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 65          /* Addre
3a80: 73 73 20 6f 66 20 4d 75 73 74 42 65 49 6e 74 20  ss of MustBeInt 
3a90: 69 6e 73 74 72 75 63 74 69 6f 6e 20 2a 2f 0a 20  instruction */. 
3aa0: 20 20 20 20 20 69 6e 74 20 72 65 67 54 65 6d 70       int regTemp
3ab0: 20 3d 20 73 71 6c 69 74 65 33 47 65 74 54 65 6d   = sqlite3GetTem
3ac0: 70 52 65 67 28 70 50 61 72 73 65 29 3b 0a 20 20  pReg(pParse);.  
3ad0: 0a 20 20 20 20 20 20 2f 2a 20 49 6e 76 6f 6b 65  .      /* Invoke
3ae0: 20 4d 75 73 74 42 65 49 6e 74 20 74 6f 20 63 6f   MustBeInt to co
3af0: 65 72 63 65 20 74 68 65 20 63 68 69 6c 64 20 6b  erce the child k
3b00: 65 79 20 76 61 6c 75 65 20 74 6f 20 61 6e 20 69  ey value to an i
3b10: 6e 74 65 67 65 72 20 28 69 2e 65 2e 20 0a 20 20  nteger (i.e. .  
3b20: 20 20 20 20 2a 2a 20 61 70 70 6c 79 20 74 68 65      ** apply the
3b30: 20 61 66 66 69 6e 69 74 79 20 6f 66 20 74 68 65   affinity of the
3b40: 20 70 61 72 65 6e 74 20 6b 65 79 29 2e 20 49 66   parent key). If
3b50: 20 74 68 69 73 20 66 61 69 6c 73 2c 20 74 68 65   this fails, the
3b60: 6e 20 74 68 65 72 65 0a 20 20 20 20 20 20 2a 2a  n there.      **
3b70: 20 69 73 20 6e 6f 20 6d 61 74 63 68 69 6e 67 20   is no matching 
3b80: 70 61 72 65 6e 74 20 6b 65 79 2e 20 42 65 66 6f  parent key. Befo
3b90: 72 65 20 75 73 69 6e 67 20 4d 75 73 74 42 65 49  re using MustBeI
3ba0: 6e 74 2c 20 6d 61 6b 65 20 61 20 63 6f 70 79 20  nt, make a copy 
3bb0: 6f 66 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20  of.      ** the 
3bc0: 76 61 6c 75 65 2e 20 4f 74 68 65 72 77 69 73 65  value. Otherwise
3bd0: 2c 20 74 68 65 20 76 61 6c 75 65 20 69 6e 73 65  , the value inse
3be0: 72 74 65 64 20 69 6e 74 6f 20 74 68 65 20 63 68  rted into the ch
3bf0: 69 6c 64 20 6b 65 79 20 63 6f 6c 75 6d 6e 0a 20  ild key column. 
3c00: 20 20 20 20 20 2a 2a 20 77 69 6c 6c 20 68 61 76       ** will hav
3c10: 65 20 49 4e 54 45 47 45 52 20 61 66 66 69 6e 69  e INTEGER affini
3c20: 74 79 20 61 70 70 6c 69 65 64 20 74 6f 20 69 74  ty applied to it
3c30: 2c 20 77 68 69 63 68 20 6d 61 79 20 6e 6f 74 20  , which may not 
3c40: 62 65 20 63 6f 72 72 65 63 74 2e 20 20 2a 2f 0a  be correct.  */.
3c50: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
3c60: 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 53 43  eAddOp2(v, OP_SC
3c70: 6f 70 79 2c 20 61 69 43 6f 6c 5b 30 5d 2b 31 2b  opy, aiCol[0]+1+
3c80: 72 65 67 44 61 74 61 2c 20 72 65 67 54 65 6d 70  regData, regTemp
3c90: 29 3b 0a 20 20 20 20 20 20 69 4d 75 73 74 42 65  );.      iMustBe
3ca0: 49 6e 74 20 3d 20 73 71 6c 69 74 65 33 56 64 62  Int = sqlite3Vdb
3cb0: 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 4d 75  eAddOp2(v, OP_Mu
3cc0: 73 74 42 65 49 6e 74 2c 20 72 65 67 54 65 6d 70  stBeInt, regTemp
3cd0: 2c 20 30 29 3b 0a 20 20 0a 20 20 20 20 20 20 2f  , 0);.  .      /
3ce0: 2a 20 49 66 20 74 68 65 20 70 61 72 65 6e 74 20  * If the parent 
3cf0: 74 61 62 6c 65 20 69 73 20 74 68 65 20 73 61 6d  table is the sam
3d00: 65 20 61 73 20 74 68 65 20 63 68 69 6c 64 20 74  e as the child t
3d10: 61 62 6c 65 2c 20 61 6e 64 20 77 65 20 61 72 65  able, and we are
3d20: 20 61 62 6f 75 74 0a 20 20 20 20 20 20 2a 2a 20   about.      ** 
3d30: 74 6f 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 65  to increment the
3d40: 20 63 6f 6e 73 74 72 61 69 6e 74 2d 63 6f 75 6e   constraint-coun
3d50: 74 65 72 20 28 69 2e 65 2e 20 74 68 69 73 20 69  ter (i.e. this i
3d60: 73 20 61 6e 20 49 4e 53 45 52 54 20 6f 70 65 72  s an INSERT oper
3d70: 61 74 69 6f 6e 29 2c 0a 20 20 20 20 20 20 2a 2a  ation),.      **
3d80: 20 74 68 65 6e 20 63 68 65 63 6b 20 69 66 20 74   then check if t
3d90: 68 65 20 72 6f 77 20 62 65 69 6e 67 20 69 6e 73  he row being ins
3da0: 65 72 74 65 64 20 6d 61 74 63 68 65 73 20 69 74  erted matches it
3db0: 73 65 6c 66 2e 20 49 66 20 73 6f 2c 20 64 6f 20  self. If so, do 
3dc0: 6e 6f 74 0a 20 20 20 20 20 20 2a 2a 20 69 6e 63  not.      ** inc
3dd0: 72 65 6d 65 6e 74 20 74 68 65 20 63 6f 6e 73 74  rement the const
3de0: 72 61 69 6e 74 2d 63 6f 75 6e 74 65 72 2e 20 20  raint-counter.  
3df0: 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 54 61  */.      if( pTa
3e00: 62 3d 3d 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 20  b==pFKey->pFrom 
3e10: 26 26 20 6e 49 6e 63 72 3d 3d 31 20 29 7b 0a 20  && nIncr==1 ){. 
3e20: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64         sqlite3Vd
3e30: 62 65 41 64 64 4f 70 33 28 76 2c 20 4f 50 5f 45  beAddOp3(v, OP_E
3e40: 71 2c 20 72 65 67 44 61 74 61 2c 20 69 4f 6b 2c  q, regData, iOk,
3e50: 20 72 65 67 54 65 6d 70 29 3b 0a 20 20 20 20 20   regTemp);.     
3e60: 20 7d 0a 20 20 0a 20 20 20 20 20 20 73 71 6c 69   }.  .      sqli
3e70: 74 65 33 4f 70 65 6e 54 61 62 6c 65 28 70 50 61  te3OpenTable(pPa
3e80: 72 73 65 2c 20 69 43 75 72 2c 20 69 44 62 2c 20  rse, iCur, iDb, 
3e90: 70 54 61 62 2c 20 4f 50 5f 4f 70 65 6e 52 65 61  pTab, OP_OpenRea
3ea0: 64 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  d);.      sqlite
3eb0: 33 56 64 62 65 41 64 64 4f 70 33 28 76 2c 20 4f  3VdbeAddOp3(v, O
3ec0: 50 5f 4e 6f 74 45 78 69 73 74 73 2c 20 69 43 75  P_NotExists, iCu
3ed0: 72 2c 20 30 2c 20 72 65 67 54 65 6d 70 29 3b 0a  r, 0, regTemp);.
3ee0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
3ef0: 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 47 6f  eAddOp2(v, OP_Go
3f00: 74 6f 2c 20 30 2c 20 69 4f 6b 29 3b 0a 20 20 20  to, 0, iOk);.   
3f10: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4a 75     sqlite3VdbeJu
3f20: 6d 70 48 65 72 65 28 76 2c 20 73 71 6c 69 74 65  mpHere(v, sqlite
3f30: 33 56 64 62 65 43 75 72 72 65 6e 74 41 64 64 72  3VdbeCurrentAddr
3f40: 28 76 29 2d 32 29 3b 0a 20 20 20 20 20 20 73 71  (v)-2);.      sq
3f50: 6c 69 74 65 33 56 64 62 65 4a 75 6d 70 48 65 72  lite3VdbeJumpHer
3f60: 65 28 76 2c 20 69 4d 75 73 74 42 65 49 6e 74 29  e(v, iMustBeInt)
3f70: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 52  ;.      sqlite3R
3f80: 65 6c 65 61 73 65 54 65 6d 70 52 65 67 28 70 50  eleaseTempReg(pP
3f90: 61 72 73 65 2c 20 72 65 67 54 65 6d 70 29 3b 0a  arse, regTemp);.
3fa0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
3fb0: 20 69 6e 74 20 6e 43 6f 6c 20 3d 20 70 46 4b 65   int nCol = pFKe
3fc0: 79 2d 3e 6e 43 6f 6c 3b 0a 20 20 20 20 20 20 69  y->nCol;.      i
3fd0: 6e 74 20 72 65 67 54 65 6d 70 20 3d 20 73 71 6c  nt regTemp = sql
3fe0: 69 74 65 33 47 65 74 54 65 6d 70 52 61 6e 67 65  ite3GetTempRange
3ff0: 28 70 50 61 72 73 65 2c 20 6e 43 6f 6c 29 3b 0a  (pParse, nCol);.
4000: 20 20 20 20 20 20 69 6e 74 20 72 65 67 52 65 63        int regRec
4010: 20 3d 20 73 71 6c 69 74 65 33 47 65 74 54 65 6d   = sqlite3GetTem
4020: 70 52 65 67 28 70 50 61 72 73 65 29 3b 0a 20 20  pReg(pParse);.  
4030: 20 20 20 20 4b 65 79 49 6e 66 6f 20 2a 70 4b 65      KeyInfo *pKe
4040: 79 20 3d 20 73 71 6c 69 74 65 33 49 6e 64 65 78  y = sqlite3Index
4050: 4b 65 79 69 6e 66 6f 28 70 50 61 72 73 65 2c 20  Keyinfo(pParse, 
4060: 70 49 64 78 29 3b 0a 20 20 0a 20 20 20 20 20 20  pIdx);.  .      
4070: 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70  sqlite3VdbeAddOp
4080: 33 28 76 2c 20 4f 50 5f 4f 70 65 6e 52 65 61 64  3(v, OP_OpenRead
4090: 2c 20 69 43 75 72 2c 20 70 49 64 78 2d 3e 74 6e  , iCur, pIdx->tn
40a0: 75 6d 2c 20 69 44 62 29 3b 0a 20 20 20 20 20 20  um, iDb);.      
40b0: 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67  sqlite3VdbeChang
40c0: 65 50 34 28 76 2c 20 2d 31 2c 20 28 63 68 61 72  eP4(v, -1, (char
40d0: 2a 29 70 4b 65 79 2c 20 50 34 5f 4b 45 59 49 4e  *)pKey, P4_KEYIN
40e0: 46 4f 5f 48 41 4e 44 4f 46 46 29 3b 0a 20 20 20  FO_HANDOFF);.   
40f0: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43     for(i=0; i<nC
4100: 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  ol; i++){.      
4110: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64    sqlite3VdbeAdd
4120: 4f 70 32 28 76 2c 20 4f 50 5f 43 6f 70 79 2c 20  Op2(v, OP_Copy, 
4130: 61 69 43 6f 6c 5b 69 5d 2b 31 2b 72 65 67 44 61  aiCol[i]+1+regDa
4140: 74 61 2c 20 72 65 67 54 65 6d 70 2b 69 29 3b 0a  ta, regTemp+i);.
4150: 20 20 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 20        }.  .     
4160: 20 2f 2a 20 49 66 20 74 68 65 20 70 61 72 65 6e   /* If the paren
4170: 74 20 74 61 62 6c 65 20 69 73 20 74 68 65 20 73  t table is the s
4180: 61 6d 65 20 61 73 20 74 68 65 20 63 68 69 6c 64  ame as the child
4190: 20 74 61 62 6c 65 2c 20 61 6e 64 20 77 65 20 61   table, and we a
41a0: 72 65 20 61 62 6f 75 74 0a 20 20 20 20 20 20 2a  re about.      *
41b0: 2a 20 74 6f 20 69 6e 63 72 65 6d 65 6e 74 20 74  * to increment t
41c0: 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 2d 63 6f  he constraint-co
41d0: 75 6e 74 65 72 20 28 69 2e 65 2e 20 74 68 69 73  unter (i.e. this
41e0: 20 69 73 20 61 6e 20 49 4e 53 45 52 54 20 6f 70   is an INSERT op
41f0: 65 72 61 74 69 6f 6e 29 2c 0a 20 20 20 20 20 20  eration),.      
4200: 2a 2a 20 74 68 65 6e 20 63 68 65 63 6b 20 69 66  ** then check if
4210: 20 74 68 65 20 72 6f 77 20 62 65 69 6e 67 20 69   the row being i
4220: 6e 73 65 72 74 65 64 20 6d 61 74 63 68 65 73 20  nserted matches 
4230: 69 74 73 65 6c 66 2e 20 49 66 20 73 6f 2c 20 64  itself. If so, d
4240: 6f 20 6e 6f 74 0a 20 20 20 20 20 20 2a 2a 20 69  o not.      ** i
4250: 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 63 6f 6e  ncrement the con
4260: 73 74 72 61 69 6e 74 2d 63 6f 75 6e 74 65 72 2e  straint-counter.
4270: 20 0a 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20   .      **.     
4280: 20 2a 2a 20 49 66 20 61 6e 79 20 6f 66 20 74 68   ** If any of th
4290: 65 20 70 61 72 65 6e 74 2d 6b 65 79 20 76 61 6c  e parent-key val
42a0: 75 65 73 20 61 72 65 20 4e 55 4c 4c 2c 20 74 68  ues are NULL, th
42b0: 65 6e 20 74 68 65 20 72 6f 77 20 63 61 6e 6e 6f  en the row canno
42c0: 74 20 6d 61 74 63 68 20 0a 20 20 20 20 20 20 2a  t match .      *
42d0: 2a 20 69 74 73 65 6c 66 2e 20 53 6f 20 73 65 74  * itself. So set
42e0: 20 4a 55 4d 50 49 46 4e 55 4c 4c 20 74 6f 20 6d   JUMPIFNULL to m
42f0: 61 6b 65 20 73 75 72 65 20 77 65 20 64 6f 20 74  ake sure we do t
4300: 68 65 20 4f 50 5f 46 6f 75 6e 64 20 69 66 20 61  he OP_Found if a
4310: 6e 79 0a 20 20 20 20 20 20 2a 2a 20 6f 66 20 74  ny.      ** of t
4320: 68 65 20 70 61 72 65 6e 74 2d 6b 65 79 20 76 61  he parent-key va
4330: 6c 75 65 73 20 61 72 65 20 4e 55 4c 4c 20 28 61  lues are NULL (a
4340: 74 20 74 68 69 73 20 70 6f 69 6e 74 20 69 74 20  t this point it 
4350: 69 73 20 6b 6e 6f 77 6e 20 74 68 61 74 0a 20 20  is known that.  
4360: 20 20 20 20 2a 2a 20 6e 6f 6e 65 20 6f 66 20 74      ** none of t
4370: 68 65 20 63 68 69 6c 64 20 6b 65 79 20 76 61 6c  he child key val
4380: 75 65 73 20 61 72 65 29 2e 0a 20 20 20 20 20 20  ues are)..      
4390: 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70 54 61  */.      if( pTa
43a0: 62 3d 3d 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 20  b==pFKey->pFrom 
43b0: 26 26 20 6e 49 6e 63 72 3d 3d 31 20 29 7b 0a 20  && nIncr==1 ){. 
43c0: 20 20 20 20 20 20 20 69 6e 74 20 69 4a 75 6d 70         int iJump
43d0: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 43 75   = sqlite3VdbeCu
43e0: 72 72 65 6e 74 41 64 64 72 28 76 29 20 2b 20 6e  rrentAddr(v) + n
43f0: 43 6f 6c 20 2b 20 31 3b 0a 20 20 20 20 20 20 20  Col + 1;.       
4400: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 6f 6c   for(i=0; i<nCol
4410: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20  ; i++){.        
4420: 20 20 69 6e 74 20 69 43 68 69 6c 64 20 3d 20 61    int iChild = a
4430: 69 43 6f 6c 5b 69 5d 2b 31 2b 72 65 67 44 61 74  iCol[i]+1+regDat
4440: 61 3b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74  a;.          int
4450: 20 69 50 61 72 65 6e 74 20 3d 20 70 49 64 78 2d   iParent = pIdx-
4460: 3e 61 69 43 6f 6c 75 6d 6e 5b 69 5d 2b 31 2b 72  >aiColumn[i]+1+r
4470: 65 67 44 61 74 61 3b 0a 20 20 20 20 20 20 20 20  egData;.        
4480: 20 20 61 73 73 65 72 74 28 20 61 69 43 6f 6c 5b    assert( aiCol[
4490: 69 5d 21 3d 70 54 61 62 2d 3e 69 50 4b 65 79 20  i]!=pTab->iPKey 
44a0: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28  );.          if(
44b0: 20 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b   pIdx->aiColumn[
44c0: 69 5d 3d 3d 70 54 61 62 2d 3e 69 50 4b 65 79 20  i]==pTab->iPKey 
44d0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f  ){.            /
44e0: 2a 20 54 68 65 20 70 61 72 65 6e 74 20 6b 65 79  * The parent key
44f0: 20 69 73 20 61 20 63 6f 6d 70 6f 73 69 74 65 20   is a composite 
4500: 6b 65 79 20 74 68 61 74 20 69 6e 63 6c 75 64 65  key that include
4510: 73 20 74 68 65 20 49 50 4b 20 63 6f 6c 75 6d 6e  s the IPK column
4520: 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20   */.            
4530: 69 50 61 72 65 6e 74 20 3d 20 72 65 67 44 61 74  iParent = regDat
4540: 61 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20  a;.          }. 
4550: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
4560: 56 64 62 65 41 64 64 4f 70 33 28 76 2c 20 4f 50  VdbeAddOp3(v, OP
4570: 5f 4e 65 2c 20 69 43 68 69 6c 64 2c 20 69 4a 75  _Ne, iChild, iJu
4580: 6d 70 2c 20 69 50 61 72 65 6e 74 29 3b 0a 20 20  mp, iParent);.  
4590: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56          sqlite3V
45a0: 64 62 65 43 68 61 6e 67 65 50 35 28 76 2c 20 53  dbeChangeP5(v, S
45b0: 51 4c 49 54 45 5f 4a 55 4d 50 49 46 4e 55 4c 4c  QLITE_JUMPIFNULL
45c0: 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  );.        }.   
45d0: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
45e0: 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 47 6f 74  AddOp2(v, OP_Got
45f0: 6f 2c 20 30 2c 20 69 4f 6b 29 3b 0a 20 20 20 20  o, 0, iOk);.    
4600: 20 20 7d 0a 20 20 0a 20 20 20 20 20 20 73 71 6c    }.  .      sql
4610: 69 74 65 33 56 64 62 65 41 64 64 4f 70 33 28 76  ite3VdbeAddOp3(v
4620: 2c 20 4f 50 5f 4d 61 6b 65 52 65 63 6f 72 64 2c  , OP_MakeRecord,
4630: 20 72 65 67 54 65 6d 70 2c 20 6e 43 6f 6c 2c 20   regTemp, nCol, 
4640: 72 65 67 52 65 63 29 3b 0a 20 20 20 20 20 20 73  regRec);.      s
4650: 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65  qlite3VdbeChange
4660: 50 34 28 76 2c 20 2d 31 2c 20 73 71 6c 69 74 65  P4(v, -1, sqlite
4670: 33 49 6e 64 65 78 41 66 66 69 6e 69 74 79 53 74  3IndexAffinitySt
4680: 72 28 76 2c 70 49 64 78 29 2c 20 50 34 5f 54 52  r(v,pIdx), P4_TR
4690: 41 4e 53 49 45 4e 54 29 3b 0a 20 20 20 20 20 20  ANSIENT);.      
46a0: 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70  sqlite3VdbeAddOp
46b0: 34 49 6e 74 28 76 2c 20 4f 50 5f 46 6f 75 6e 64  4Int(v, OP_Found
46c0: 2c 20 69 43 75 72 2c 20 69 4f 6b 2c 20 72 65 67  , iCur, iOk, reg
46d0: 52 65 63 2c 20 30 29 3b 0a 20 20 0a 20 20 20 20  Rec, 0);.  .    
46e0: 20 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 65    sqlite3Release
46f0: 54 65 6d 70 52 65 67 28 70 50 61 72 73 65 2c 20  TempReg(pParse, 
4700: 72 65 67 52 65 63 29 3b 0a 20 20 20 20 20 20 73  regRec);.      s
4710: 71 6c 69 74 65 33 52 65 6c 65 61 73 65 54 65 6d  qlite3ReleaseTem
4720: 70 52 61 6e 67 65 28 70 50 61 72 73 65 2c 20 72  pRange(pParse, r
4730: 65 67 54 65 6d 70 2c 20 6e 43 6f 6c 29 3b 0a 20  egTemp, nCol);. 
4740: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20     }.  }..  if( 
4750: 21 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 72  !pFKey->isDeferr
4760: 65 64 20 26 26 20 21 28 70 50 61 72 73 65 2d 3e  ed && !(pParse->
4770: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49  db->flags & SQLI
4780: 54 45 5f 44 65 66 65 72 46 4b 73 29 0a 20 20 20  TE_DeferFKs).   
4790: 26 26 20 21 70 50 61 72 73 65 2d 3e 70 54 6f 70  && !pParse->pTop
47a0: 6c 65 76 65 6c 20 0a 20 20 20 26 26 20 21 70 50  level .   && !pP
47b0: 61 72 73 65 2d 3e 69 73 4d 75 6c 74 69 57 72 69  arse->isMultiWri
47c0: 74 65 20 0a 20 20 29 7b 0a 20 20 20 20 2f 2a 20  te .  ){.    /* 
47d0: 53 70 65 63 69 61 6c 20 63 61 73 65 3a 20 49 66  Special case: If
47e0: 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e 53 45   this is an INSE
47f0: 52 54 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61  RT statement tha
4800: 74 20 77 69 6c 6c 20 69 6e 73 65 72 74 20 65 78  t will insert ex
4810: 61 63 74 6c 79 0a 20 20 20 20 2a 2a 20 6f 6e 65  actly.    ** one
4820: 20 72 6f 77 20 69 6e 74 6f 20 74 68 65 20 74 61   row into the ta
4830: 62 6c 65 2c 20 72 61 69 73 65 20 61 20 63 6f 6e  ble, raise a con
4840: 73 74 72 61 69 6e 74 20 69 6d 6d 65 64 69 61 74  straint immediat
4850: 65 6c 79 20 69 6e 73 74 65 61 64 20 6f 66 0a 20  ely instead of. 
4860: 20 20 20 2a 2a 20 69 6e 63 72 65 6d 65 6e 74 69     ** incrementi
4870: 6e 67 20 61 20 63 6f 75 6e 74 65 72 2e 20 54 68  ng a counter. Th
4880: 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 79 20  is is necessary 
4890: 61 73 20 74 68 65 20 56 4d 20 63 6f 64 65 20 69  as the VM code i
48a0: 73 20 62 65 69 6e 67 0a 20 20 20 20 2a 2a 20 67  s being.    ** g
48b0: 65 6e 65 72 61 74 65 64 20 66 6f 72 20 77 69 6c  enerated for wil
48c0: 6c 20 6e 6f 74 20 6f 70 65 6e 20 61 20 73 74 61  l not open a sta
48d0: 74 65 6d 65 6e 74 20 74 72 61 6e 73 61 63 74 69  tement transacti
48e0: 6f 6e 2e 20 20 2a 2f 0a 20 20 20 20 61 73 73 65  on.  */.    asse
48f0: 72 74 28 20 6e 49 6e 63 72 3d 3d 31 20 29 3b 0a  rt( nIncr==1 );.
4900: 20 20 20 20 73 71 6c 69 74 65 33 48 61 6c 74 43      sqlite3HaltC
4910: 6f 6e 73 74 72 61 69 6e 74 28 70 50 61 72 73 65  onstraint(pParse
4920: 2c 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41  , SQLITE_CONSTRA
4930: 49 4e 54 5f 46 4f 52 45 49 47 4e 4b 45 59 2c 0a  INT_FOREIGNKEY,.
4940: 20 20 20 20 20 20 20 20 4f 45 5f 41 62 6f 72 74          OE_Abort
4950: 2c 20 22 66 6f 72 65 69 67 6e 20 6b 65 79 20 63  , "foreign key c
4960: 6f 6e 73 74 72 61 69 6e 74 20 66 61 69 6c 65 64  onstraint failed
4970: 22 2c 20 50 34 5f 53 54 41 54 49 43 0a 20 20 20  ", P4_STATIC.   
4980: 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20   );.  }else{.   
4990: 20 69 66 28 20 6e 49 6e 63 72 3e 30 20 26 26 20   if( nIncr>0 && 
49a0: 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 72 65  pFKey->isDeferre
49b0: 64 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 71  d==0 ){.      sq
49c0: 6c 69 74 65 33 50 61 72 73 65 54 6f 70 6c 65 76  lite3ParseToplev
49d0: 65 6c 28 70 50 61 72 73 65 29 2d 3e 6d 61 79 41  el(pParse)->mayA
49e0: 62 6f 72 74 20 3d 20 31 3b 0a 20 20 20 20 7d 0a  bort = 1;.    }.
49f0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41      sqlite3VdbeA
4a00: 64 64 4f 70 32 28 76 2c 20 4f 50 5f 46 6b 43 6f  ddOp2(v, OP_FkCo
4a10: 75 6e 74 65 72 2c 20 70 46 4b 65 79 2d 3e 69 73  unter, pFKey->is
4a20: 44 65 66 65 72 72 65 64 2c 20 6e 49 6e 63 72 29  Deferred, nIncr)
4a30: 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65 33  ;.  }..  sqlite3
4a40: 56 64 62 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c  VdbeResolveLabel
4a50: 28 76 2c 20 69 4f 6b 29 3b 0a 20 20 73 71 6c 69  (v, iOk);.  sqli
4a60: 74 65 33 56 64 62 65 41 64 64 4f 70 31 28 76 2c  te3VdbeAddOp1(v,
4a70: 20 4f 50 5f 43 6c 6f 73 65 2c 20 69 43 75 72 29   OP_Close, iCur)
4a80: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20  ;.}../*.** This 
4a90: 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c  function is call
4aa0: 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 63  ed to generate c
4ab0: 6f 64 65 20 65 78 65 63 75 74 65 64 20 77 68 65  ode executed whe
4ac0: 6e 20 61 20 72 6f 77 20 69 73 20 64 65 6c 65 74  n a row is delet
4ad0: 65 64 0a 2a 2a 20 66 72 6f 6d 20 74 68 65 20 70  ed.** from the p
4ae0: 61 72 65 6e 74 20 74 61 62 6c 65 20 6f 66 20 66  arent table of f
4af0: 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74  oreign key const
4b00: 72 61 69 6e 74 20 70 46 4b 65 79 20 61 6e 64 2c  raint pFKey and,
4b10: 20 69 66 20 70 46 4b 65 79 20 69 73 20 0a 2a 2a   if pFKey is .**
4b20: 20 64 65 66 65 72 72 65 64 2c 20 77 68 65 6e 20   deferred, when 
4b30: 61 20 72 6f 77 20 69 73 20 69 6e 73 65 72 74 65  a row is inserte
4b40: 64 20 69 6e 74 6f 20 74 68 65 20 73 61 6d 65 20  d into the same 
4b50: 74 61 62 6c 65 2e 20 57 68 65 6e 20 67 65 6e 65  table. When gene
4b60: 72 61 74 69 6e 67 0a 2a 2a 20 63 6f 64 65 20 66  rating.** code f
4b70: 6f 72 20 61 6e 20 53 51 4c 20 55 50 44 41 54 45  or an SQL UPDATE
4b80: 20 6f 70 65 72 61 74 69 6f 6e 2c 20 74 68 69 73   operation, this
4b90: 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 62 65   function may be
4ba0: 20 63 61 6c 6c 65 64 20 74 77 69 63 65 20 2d 0a   called twice -.
4bb0: 2a 2a 20 6f 6e 63 65 20 74 6f 20 22 64 65 6c 65  ** once to "dele
4bc0: 74 65 22 20 74 68 65 20 6f 6c 64 20 72 6f 77 20  te" the old row 
4bd0: 61 6e 64 20 6f 6e 63 65 20 74 6f 20 22 69 6e 73  and once to "ins
4be0: 65 72 74 22 20 74 68 65 20 6e 65 77 20 72 6f 77  ert" the new row
4bf0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 64 65  ..**.** The code
4c00: 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 74 68   generated by th
4c10: 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 63 61 6e  is function scan
4c20: 73 20 74 68 72 6f 75 67 68 20 74 68 65 20 72 6f  s through the ro
4c30: 77 73 20 69 6e 20 74 68 65 20 63 68 69 6c 64 0a  ws in the child.
4c40: 2a 2a 20 74 61 62 6c 65 20 74 68 61 74 20 63 6f  ** table that co
4c50: 72 72 65 73 70 6f 6e 64 20 74 6f 20 74 68 65 20  rrespond to the 
4c60: 70 61 72 65 6e 74 20 74 61 62 6c 65 20 72 6f 77  parent table row
4c70: 20 62 65 69 6e 67 20 64 65 6c 65 74 65 64 20 6f   being deleted o
4c80: 72 20 69 6e 73 65 72 74 65 64 2e 0a 2a 2a 20 46  r inserted..** F
4c90: 6f 72 20 65 61 63 68 20 63 68 69 6c 64 20 72 6f  or each child ro
4ca0: 77 20 66 6f 75 6e 64 2c 20 6f 6e 65 20 6f 66 20  w found, one of 
4cb0: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 63  the following ac
4cc0: 74 69 6f 6e 73 20 69 73 20 74 61 6b 65 6e 3a 0a  tions is taken:.
4cd0: 2a 2a 0a 2a 2a 20 20 20 4f 70 65 72 61 74 69 6f  **.**   Operatio
4ce0: 6e 20 7c 20 46 4b 20 74 79 70 65 20 20 20 7c 20  n | FK type   | 
4cf0: 41 63 74 69 6f 6e 20 74 61 6b 65 6e 0a 2a 2a 20  Action taken.** 
4d00: 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d    --------------
4d10: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4d20: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4d30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4d40: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20  ------------.** 
4d50: 20 20 44 45 4c 45 54 45 20 20 20 20 20 20 69 6d    DELETE      im
4d60: 6d 65 64 69 61 74 65 20 20 20 49 6e 63 72 65 6d  mediate   Increm
4d70: 65 6e 74 20 74 68 65 20 22 69 6d 6d 65 64 69 61  ent the "immedia
4d80: 74 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f  te constraint co
4d90: 75 6e 74 65 72 22 2e 0a 2a 2a 20 20 20 20 20 20  unter"..**      
4da0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4db0: 20 20 20 20 20 4f 72 2c 20 69 66 20 74 68 65 20       Or, if the 
4dc0: 4f 4e 20 28 55 50 44 41 54 45 7c 44 45 4c 45 54  ON (UPDATE|DELET
4dd0: 45 29 20 61 63 74 69 6f 6e 20 69 73 20 52 45 53  E) action is RES
4de0: 54 52 49 43 54 2c 0a 2a 2a 20 20 20 20 20 20 20  TRICT,.**       
4df0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4e00: 20 20 20 20 74 68 72 6f 77 20 61 20 22 66 6f 72      throw a "for
4e10: 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61  eign key constra
4e20: 69 6e 74 20 66 61 69 6c 65 64 22 20 65 78 63 65  int failed" exce
4e30: 70 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 49  ption..**.**   I
4e40: 4e 53 45 52 54 20 20 20 20 20 20 69 6d 6d 65 64  NSERT      immed
4e50: 69 61 74 65 20 20 20 44 65 63 72 65 6d 65 6e 74  iate   Decrement
4e60: 20 74 68 65 20 22 69 6d 6d 65 64 69 61 74 65 20   the "immediate 
4e70: 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e 74  constraint count
4e80: 65 72 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 44 45 4c  er"..**.**   DEL
4e90: 45 54 45 20 20 20 20 20 20 64 65 66 65 72 72 65  ETE      deferre
4ea0: 64 20 20 20 20 49 6e 63 72 65 6d 65 6e 74 20 74  d    Increment t
4eb0: 68 65 20 22 64 65 66 65 72 72 65 64 20 63 6f 6e  he "deferred con
4ec0: 73 74 72 61 69 6e 74 20 63 6f 75 6e 74 65 72 22  straint counter"
4ed0: 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20  ..**            
4ee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4f                 O
4ef0: 72 2c 20 69 66 20 74 68 65 20 4f 4e 20 28 55 50  r, if the ON (UP
4f00: 44 41 54 45 7c 44 45 4c 45 54 45 29 20 61 63 74  DATE|DELETE) act
4f10: 69 6f 6e 20 69 73 20 52 45 53 54 52 49 43 54 2c  ion is RESTRICT,
4f20: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20  .**             
4f30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68                th
4f40: 72 6f 77 20 61 20 22 66 6f 72 65 69 67 6e 20 6b  row a "foreign k
4f50: 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 66 61  ey constraint fa
4f60: 69 6c 65 64 22 20 65 78 63 65 70 74 69 6f 6e 2e  iled" exception.
4f70: 0a 2a 2a 0a 2a 2a 20 20 20 49 4e 53 45 52 54 20  .**.**   INSERT 
4f80: 20 20 20 20 20 64 65 66 65 72 72 65 64 20 20 20       deferred   
4f90: 20 44 65 63 72 65 6d 65 6e 74 20 74 68 65 20 22   Decrement the "
4fa0: 64 65 66 65 72 72 65 64 20 63 6f 6e 73 74 72 61  deferred constra
4fb0: 69 6e 74 20 63 6f 75 6e 74 65 72 22 2e 0a 2a 2a  int counter"..**
4fc0: 0a 2a 2a 20 54 68 65 73 65 20 6f 70 65 72 61 74  .** These operat
4fd0: 69 6f 6e 73 20 61 72 65 20 69 64 65 6e 74 69 66  ions are identif
4fe0: 69 65 64 20 69 6e 20 74 68 65 20 63 6f 6d 6d 65  ied in the comme
4ff0: 6e 74 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66  nt at the top of
5000: 20 74 68 69 73 20 66 69 6c 65 20 0a 2a 2a 20 28   this file .** (
5010: 66 6b 65 79 2e 63 29 20 61 73 20 22 49 2e 32 22  fkey.c) as "I.2"
5020: 20 61 6e 64 20 22 44 2e 32 22 2e 0a 2a 2f 0a 73   and "D.2"..*/.s
5030: 74 61 74 69 63 20 76 6f 69 64 20 66 6b 53 63 61  tatic void fkSca
5040: 6e 43 68 69 6c 64 72 65 6e 28 0a 20 20 50 61 72  nChildren(.  Par
5050: 73 65 20 2a 70 50 61 72 73 65 2c 20 20 20 20 20  se *pParse,     
5060: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5070: 50 61 72 73 65 20 63 6f 6e 74 65 78 74 20 2a 2f  Parse context */
5080: 0a 20 20 53 72 63 4c 69 73 74 20 2a 70 53 72 63  .  SrcList *pSrc
5090: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
50a0: 20 20 20 2f 2a 20 53 72 63 4c 69 73 74 20 63 6f     /* SrcList co
50b0: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 74 61 62  ntaining the tab
50c0: 6c 65 20 74 6f 20 73 63 61 6e 20 2a 2f 0a 20 20  le to scan */.  
50d0: 54 61 62 6c 65 20 2a 70 54 61 62 2c 0a 20 20 49  Table *pTab,.  I
50e0: 6e 64 65 78 20 2a 70 49 64 78 2c 20 20 20 20 20  ndex *pIdx,     
50f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5100: 2a 20 46 6f 72 65 69 67 6e 20 6b 65 79 20 69 6e  * Foreign key in
5110: 64 65 78 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70  dex */.  FKey *p
5120: 46 4b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20  FKey,           
5130: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 65           /* Fore
5140: 69 67 6e 20 6b 65 79 20 72 65 6c 61 74 69 6f 6e  ign key relation
5150: 73 68 69 70 20 2a 2f 0a 20 20 69 6e 74 20 2a 61  ship */.  int *a
5160: 69 43 6f 6c 2c 20 20 20 20 20 20 20 20 20 20 20  iCol,           
5170: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 70            /* Map
5180: 20 66 72 6f 6d 20 70 49 64 78 20 63 6f 6c 73 20   from pIdx cols 
5190: 74 6f 20 63 68 69 6c 64 20 74 61 62 6c 65 20 63  to child table c
51a0: 6f 6c 73 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67  ols */.  int reg
51b0: 44 61 74 61 2c 20 20 20 20 20 20 20 20 20 20 20  Data,           
51c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 66 65           /* Refe
51d0: 72 65 6e 63 65 64 20 74 61 62 6c 65 20 64 61 74  renced table dat
51e0: 61 20 73 74 61 72 74 73 20 68 65 72 65 20 2a 2f  a starts here */
51f0: 0a 20 20 69 6e 74 20 6e 49 6e 63 72 20 20 20 20  .  int nIncr    
5200: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5210: 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 74 6f 20     /* Amount to 
5220: 69 6e 63 72 65 6d 65 6e 74 20 64 65 66 65 72 72  increment deferr
5230: 65 64 20 63 6f 75 6e 74 65 72 20 62 79 20 2a 2f  ed counter by */
5240: 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  .){.  sqlite3 *d
5250: 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 20  b = pParse->db; 
5260: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73        /* Databas
5270: 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e  e handle */.  in
5280: 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20  t i;            
5290: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
52a0: 20 49 74 65 72 61 74 6f 72 20 76 61 72 69 61 62   Iterator variab
52b0: 6c 65 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 57  le */.  Expr *pW
52c0: 68 65 72 65 20 3d 20 30 3b 20 20 20 20 20 20 20  here = 0;       
52d0: 20 20 20 20 20 20 20 20 2f 2a 20 57 48 45 52 45          /* WHERE
52e0: 20 63 6c 61 75 73 65 20 74 6f 20 73 63 61 6e 20   clause to scan 
52f0: 77 69 74 68 20 2a 2f 0a 20 20 4e 61 6d 65 43 6f  with */.  NameCo
5300: 6e 74 65 78 74 20 73 4e 61 6d 65 43 6f 6e 74 65  ntext sNameConte
5310: 78 74 3b 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e  xt;       /* Con
5320: 74 65 78 74 20 75 73 65 64 20 74 6f 20 72 65 73  text used to res
5330: 6f 6c 76 65 20 57 48 45 52 45 20 63 6c 61 75 73  olve WHERE claus
5340: 65 20 2a 2f 0a 20 20 57 68 65 72 65 49 6e 66 6f  e */.  WhereInfo
5350: 20 2a 70 57 49 6e 66 6f 3b 20 20 20 20 20 20 20   *pWInfo;       
5360: 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65 78         /* Contex
5370: 74 20 75 73 65 64 20 62 79 20 73 71 6c 69 74 65  t used by sqlite
5380: 33 57 68 65 72 65 58 58 58 28 29 20 2a 2f 0a 20  3WhereXXX() */. 
5390: 20 69 6e 74 20 69 46 6b 49 66 5a 65 72 6f 20 3d   int iFkIfZero =
53a0: 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20   0;             
53b0: 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 4f   /* Address of O
53c0: 50 5f 46 6b 49 66 5a 65 72 6f 20 2a 2f 0a 20 20  P_FkIfZero */.  
53d0: 56 64 62 65 20 2a 76 20 3d 20 73 71 6c 69 74 65  Vdbe *v = sqlite
53e0: 33 47 65 74 56 64 62 65 28 70 50 61 72 73 65 29  3GetVdbe(pParse)
53f0: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 21 70 49  ;..  assert( !pI
5400: 64 78 20 7c 7c 20 70 49 64 78 2d 3e 70 54 61 62  dx || pIdx->pTab
5410: 6c 65 3d 3d 70 54 61 62 20 29 3b 0a 0a 20 20 69  le==pTab );..  i
5420: 66 28 20 6e 49 6e 63 72 3c 30 20 29 7b 0a 20 20  f( nIncr<0 ){.  
5430: 20 20 69 46 6b 49 66 5a 65 72 6f 20 3d 20 73 71    iFkIfZero = sq
5440: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28  lite3VdbeAddOp2(
5450: 76 2c 20 4f 50 5f 46 6b 49 66 5a 65 72 6f 2c 20  v, OP_FkIfZero, 
5460: 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 72 65  pFKey->isDeferre
5470: 64 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  d, 0);.  }..  /*
5480: 20 43 72 65 61 74 65 20 61 6e 20 45 78 70 72 20   Create an Expr 
5490: 6f 62 6a 65 63 74 20 72 65 70 72 65 73 65 6e 74  object represent
54a0: 69 6e 67 20 61 6e 20 53 51 4c 20 65 78 70 72 65  ing an SQL expre
54b0: 73 73 69 6f 6e 20 6c 69 6b 65 3a 0a 20 20 2a 2a  ssion like:.  **
54c0: 0a 20 20 2a 2a 20 20 20 3c 70 61 72 65 6e 74 2d  .  **   <parent-
54d0: 6b 65 79 31 3e 20 3d 20 3c 63 68 69 6c 64 2d 6b  key1> = <child-k
54e0: 65 79 31 3e 20 41 4e 44 20 3c 70 61 72 65 6e 74  ey1> AND <parent
54f0: 2d 6b 65 79 32 3e 20 3d 20 3c 63 68 69 6c 64 2d  -key2> = <child-
5500: 6b 65 79 32 3e 20 2e 2e 2e 0a 20 20 2a 2a 0a 20  key2> ....  **. 
5510: 20 2a 2a 20 54 68 65 20 63 6f 6c 6c 61 74 69 6f   ** The collatio
5520: 6e 20 73 65 71 75 65 6e 63 65 20 75 73 65 64 20  n sequence used 
5530: 66 6f 72 20 74 68 65 20 63 6f 6d 70 61 72 69 73  for the comparis
5540: 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 74 68 61  on should be tha
5550: 74 20 6f 66 0a 20 20 2a 2a 20 74 68 65 20 70 61  t of.  ** the pa
5560: 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 73  rent key columns
5570: 2e 20 54 68 65 20 61 66 66 69 6e 69 74 79 20 6f  . The affinity o
5580: 66 20 74 68 65 20 70 61 72 65 6e 74 20 6b 65 79  f the parent key
5590: 20 63 6f 6c 75 6d 6e 20 73 68 6f 75 6c 64 0a 20   column should. 
55a0: 20 2a 2a 20 62 65 20 61 70 70 6c 69 65 64 20 74   ** be applied t
55b0: 6f 20 65 61 63 68 20 63 68 69 6c 64 20 6b 65 79  o each child key
55c0: 20 76 61 6c 75 65 20 62 65 66 6f 72 65 20 74 68   value before th
55d0: 65 20 63 6f 6d 70 61 72 69 73 6f 6e 20 74 61 6b  e comparison tak
55e0: 65 73 20 70 6c 61 63 65 2e 0a 20 20 2a 2f 0a 20  es place..  */. 
55f0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 46 4b 65   for(i=0; i<pFKe
5600: 79 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20  y->nCol; i++){. 
5610: 20 20 20 45 78 70 72 20 2a 70 4c 65 66 74 3b 20     Expr *pLeft; 
5620: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5630: 20 2f 2a 20 56 61 6c 75 65 20 66 72 6f 6d 20 70   /* Value from p
5640: 61 72 65 6e 74 20 74 61 62 6c 65 20 72 6f 77 20  arent table row 
5650: 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 52 69  */.    Expr *pRi
5660: 67 68 74 3b 20 20 20 20 20 20 20 20 20 20 20 20  ght;            
5670: 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 72       /* Column r
5680: 65 66 20 74 6f 20 63 68 69 6c 64 20 74 61 62 6c  ef to child tabl
5690: 65 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70  e */.    Expr *p
56a0: 45 71 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  Eq;             
56b0: 20 20 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73         /* Expres
56c0: 73 69 6f 6e 20 28 70 4c 65 66 74 20 3d 20 70 52  sion (pLeft = pR
56d0: 69 67 68 74 29 20 2a 2f 0a 20 20 20 20 69 31 36  ight) */.    i16
56e0: 20 69 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20   iCol;          
56f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e             /* In
5700: 64 65 78 20 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e  dex of column in
5710: 20 63 68 69 6c 64 20 74 61 62 6c 65 20 2a 2f 20   child table */ 
5720: 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20  .    const char 
5730: 2a 7a 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20  *zCol;          
5740: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 63 6f     /* Name of co
5750: 6c 75 6d 6e 20 69 6e 20 63 68 69 6c 64 20 74 61  lumn in child ta
5760: 62 6c 65 20 2a 2f 0a 0a 20 20 20 20 70 4c 65 66  ble */..    pLef
5770: 74 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 28  t = sqlite3Expr(
5780: 64 62 2c 20 54 4b 5f 52 45 47 49 53 54 45 52 2c  db, TK_REGISTER,
5790: 20 30 29 3b 0a 20 20 20 20 69 66 28 20 70 4c 65   0);.    if( pLe
57a0: 66 74 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 53  ft ){.      /* S
57b0: 65 74 20 74 68 65 20 63 6f 6c 6c 61 74 69 6f 6e  et the collation
57c0: 20 73 65 71 75 65 6e 63 65 20 61 6e 64 20 61 66   sequence and af
57d0: 66 69 6e 69 74 79 20 6f 66 20 74 68 65 20 4c 48  finity of the LH
57e0: 53 20 6f 66 20 65 61 63 68 20 54 4b 5f 45 51 0a  S of each TK_EQ.
57f0: 20 20 20 20 20 20 2a 2a 20 65 78 70 72 65 73 73        ** express
5800: 69 6f 6e 20 74 6f 20 74 68 65 20 70 61 72 65 6e  ion to the paren
5810: 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 20 64 65 66  t key column def
5820: 61 75 6c 74 73 2e 20 20 2a 2f 0a 20 20 20 20 20  aults.  */.     
5830: 20 69 66 28 20 70 49 64 78 20 29 7b 0a 20 20 20   if( pIdx ){.   
5840: 20 20 20 20 20 43 6f 6c 75 6d 6e 20 2a 70 43 6f       Column *pCo
5850: 6c 3b 0a 20 20 20 20 20 20 20 20 63 6f 6e 73 74  l;.        const
5860: 20 63 68 61 72 20 2a 7a 43 6f 6c 6c 3b 0a 20 20   char *zColl;.  
5870: 20 20 20 20 20 20 69 43 6f 6c 20 3d 20 70 49 64        iCol = pId
5880: 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 69 5d 3b 0a  x->aiColumn[i];.
5890: 20 20 20 20 20 20 20 20 70 43 6f 6c 20 3d 20 26          pCol = &
58a0: 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d  pTab->aCol[iCol]
58b0: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 54  ;.        if( pT
58c0: 61 62 2d 3e 69 50 4b 65 79 3d 3d 69 43 6f 6c 20  ab->iPKey==iCol 
58d0: 29 20 69 43 6f 6c 20 3d 20 2d 31 3b 0a 20 20 20  ) iCol = -1;.   
58e0: 20 20 20 20 20 70 4c 65 66 74 2d 3e 69 54 61 62       pLeft->iTab
58f0: 6c 65 20 3d 20 72 65 67 44 61 74 61 2b 69 43 6f  le = regData+iCo
5900: 6c 2b 31 3b 0a 20 20 20 20 20 20 20 20 70 4c 65  l+1;.        pLe
5910: 66 74 2d 3e 61 66 66 69 6e 69 74 79 20 3d 20 70  ft->affinity = p
5920: 43 6f 6c 2d 3e 61 66 66 69 6e 69 74 79 3b 0a 20  Col->affinity;. 
5930: 20 20 20 20 20 20 20 7a 43 6f 6c 6c 20 3d 20 70         zColl = p
5940: 43 6f 6c 2d 3e 7a 43 6f 6c 6c 3b 0a 20 20 20 20  Col->zColl;.    
5950: 20 20 20 20 69 66 28 20 7a 43 6f 6c 6c 3d 3d 30      if( zColl==0
5960: 20 29 20 7a 43 6f 6c 6c 20 3d 20 64 62 2d 3e 70   ) zColl = db->p
5970: 44 66 6c 74 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 3b  DfltColl->zName;
5980: 0a 20 20 20 20 20 20 20 20 70 4c 65 66 74 20 3d  .        pLeft =
5990: 20 73 71 6c 69 74 65 33 45 78 70 72 41 64 64 43   sqlite3ExprAddC
59a0: 6f 6c 6c 61 74 65 53 74 72 69 6e 67 28 70 50 61  ollateString(pPa
59b0: 72 73 65 2c 20 70 4c 65 66 74 2c 20 7a 43 6f 6c  rse, pLeft, zCol
59c0: 6c 29 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b  l);.      }else{
59d0: 0a 20 20 20 20 20 20 20 20 70 4c 65 66 74 2d 3e  .        pLeft->
59e0: 69 54 61 62 6c 65 20 3d 20 72 65 67 44 61 74 61  iTable = regData
59f0: 3b 0a 20 20 20 20 20 20 20 20 70 4c 65 66 74 2d  ;.        pLeft-
5a00: 3e 61 66 66 69 6e 69 74 79 20 3d 20 53 51 4c 49  >affinity = SQLI
5a10: 54 45 5f 41 46 46 5f 49 4e 54 45 47 45 52 3b 0a  TE_AFF_INTEGER;.
5a20: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
5a30: 20 20 69 43 6f 6c 20 3d 20 61 69 43 6f 6c 20 3f    iCol = aiCol ?
5a40: 20 61 69 43 6f 6c 5b 69 5d 20 3a 20 70 46 4b 65   aiCol[i] : pFKe
5a50: 79 2d 3e 61 43 6f 6c 5b 30 5d 2e 69 46 72 6f 6d  y->aCol[0].iFrom
5a60: 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 43  ;.    assert( iC
5a70: 6f 6c 3e 3d 30 20 29 3b 0a 20 20 20 20 7a 43 6f  ol>=0 );.    zCo
5a80: 6c 20 3d 20 70 46 4b 65 79 2d 3e 70 46 72 6f 6d  l = pFKey->pFrom
5a90: 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 2e 7a 4e 61  ->aCol[iCol].zNa
5aa0: 6d 65 3b 0a 20 20 20 20 70 52 69 67 68 74 20 3d  me;.    pRight =
5ab0: 20 73 71 6c 69 74 65 33 45 78 70 72 28 64 62 2c   sqlite3Expr(db,
5ac0: 20 54 4b 5f 49 44 2c 20 7a 43 6f 6c 29 3b 0a 20   TK_ID, zCol);. 
5ad0: 20 20 20 70 45 71 20 3d 20 73 71 6c 69 74 65 33     pEq = sqlite3
5ae0: 50 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b  PExpr(pParse, TK
5af0: 5f 45 51 2c 20 70 4c 65 66 74 2c 20 70 52 69 67  _EQ, pLeft, pRig
5b00: 68 74 2c 20 30 29 3b 0a 20 20 20 20 70 57 68 65  ht, 0);.    pWhe
5b10: 72 65 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72  re = sqlite3Expr
5b20: 41 6e 64 28 64 62 2c 20 70 57 68 65 72 65 2c 20  And(db, pWhere, 
5b30: 70 45 71 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  pEq);.  }..  /* 
5b40: 49 66 20 74 68 65 20 63 68 69 6c 64 20 74 61 62  If the child tab
5b50: 6c 65 20 69 73 20 74 68 65 20 73 61 6d 65 20 61  le is the same a
5b60: 73 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62  s the parent tab
5b70: 6c 65 2c 20 61 6e 64 20 74 68 69 73 20 73 63 61  le, and this sca
5b80: 6e 0a 20 20 2a 2a 20 69 73 20 74 61 6b 69 6e 67  n.  ** is taking
5b90: 20 70 6c 61 63 65 20 61 73 20 70 61 72 74 20 6f   place as part o
5ba0: 66 20 61 20 44 45 4c 45 54 45 20 6f 70 65 72 61  f a DELETE opera
5bb0: 74 69 6f 6e 20 28 6f 70 65 72 61 74 69 6f 6e 20  tion (operation 
5bc0: 44 2e 32 29 2c 20 6f 6d 69 74 20 74 68 65 0a 20  D.2), omit the. 
5bd0: 20 2a 2a 20 72 6f 77 20 62 65 69 6e 67 20 64 65   ** row being de
5be0: 6c 65 74 65 64 20 66 72 6f 6d 20 74 68 65 20 73  leted from the s
5bf0: 63 61 6e 20 62 79 20 61 64 64 69 6e 67 20 28 24  can by adding ($
5c00: 72 6f 77 69 64 20 21 3d 20 72 6f 77 69 64 29 20  rowid != rowid) 
5c10: 74 6f 20 74 68 65 20 57 48 45 52 45 20 0a 20 20  to the WHERE .  
5c20: 2a 2a 20 63 6c 61 75 73 65 2c 20 77 68 65 72 65  ** clause, where
5c30: 20 24 72 6f 77 69 64 20 69 73 20 74 68 65 20 72   $rowid is the r
5c40: 6f 77 69 64 20 6f 66 20 74 68 65 20 72 6f 77 20  owid of the row 
5c50: 62 65 69 6e 67 20 64 65 6c 65 74 65 64 2e 20 20  being deleted.  
5c60: 2a 2f 0a 20 20 69 66 28 20 70 54 61 62 3d 3d 70  */.  if( pTab==p
5c70: 46 4b 65 79 2d 3e 70 46 72 6f 6d 20 26 26 20 6e  FKey->pFrom && n
5c80: 49 6e 63 72 3e 30 20 26 26 20 48 61 73 52 6f 77  Incr>0 && HasRow
5c90: 69 64 28 70 54 61 62 29 20 2f 2a 46 49 58 4d 45  id(pTab) /*FIXME
5ca0: 2a 2f 20 29 7b 0a 20 20 20 20 45 78 70 72 20 2a  */ ){.    Expr *
5cb0: 70 45 71 3b 20 20 20 20 20 20 20 20 20 20 20 20  pEq;            
5cc0: 20 20 20 20 20 20 20 20 2f 2a 20 45 78 70 72 65          /* Expre
5cd0: 73 73 69 6f 6e 20 28 70 4c 65 66 74 20 3d 20 70  ssion (pLeft = p
5ce0: 52 69 67 68 74 29 20 2a 2f 0a 20 20 20 20 45 78  Right) */.    Ex
5cf0: 70 72 20 2a 70 4c 65 66 74 3b 20 20 20 20 20 20  pr *pLeft;      
5d00: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56              /* V
5d10: 61 6c 75 65 20 66 72 6f 6d 20 70 61 72 65 6e 74  alue from parent
5d20: 20 74 61 62 6c 65 20 72 6f 77 20 2a 2f 0a 20 20   table row */.  
5d30: 20 20 45 78 70 72 20 2a 70 52 69 67 68 74 3b 20    Expr *pRight; 
5d40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5d50: 2f 2a 20 43 6f 6c 75 6d 6e 20 72 65 66 20 74 6f  /* Column ref to
5d60: 20 63 68 69 6c 64 20 74 61 62 6c 65 20 2a 2f 0a   child table */.
5d70: 20 20 20 20 70 4c 65 66 74 20 3d 20 73 71 6c 69      pLeft = sqli
5d80: 74 65 33 45 78 70 72 28 64 62 2c 20 54 4b 5f 52  te3Expr(db, TK_R
5d90: 45 47 49 53 54 45 52 2c 20 30 29 3b 0a 20 20 20  EGISTER, 0);.   
5da0: 20 70 52 69 67 68 74 20 3d 20 73 71 6c 69 74 65   pRight = sqlite
5db0: 33 45 78 70 72 28 64 62 2c 20 54 4b 5f 43 4f 4c  3Expr(db, TK_COL
5dc0: 55 4d 4e 2c 20 30 29 3b 0a 20 20 20 20 69 66 28  UMN, 0);.    if(
5dd0: 20 70 4c 65 66 74 20 26 26 20 70 52 69 67 68 74   pLeft && pRight
5de0: 20 29 7b 0a 20 20 20 20 20 20 70 4c 65 66 74 2d   ){.      pLeft-
5df0: 3e 69 54 61 62 6c 65 20 3d 20 72 65 67 44 61 74  >iTable = regDat
5e00: 61 3b 0a 20 20 20 20 20 20 70 4c 65 66 74 2d 3e  a;.      pLeft->
5e10: 61 66 66 69 6e 69 74 79 20 3d 20 53 51 4c 49 54  affinity = SQLIT
5e20: 45 5f 41 46 46 5f 49 4e 54 45 47 45 52 3b 0a 20  E_AFF_INTEGER;. 
5e30: 20 20 20 20 20 70 52 69 67 68 74 2d 3e 69 54 61       pRight->iTa
5e40: 62 6c 65 20 3d 20 70 53 72 63 2d 3e 61 5b 30 5d  ble = pSrc->a[0]
5e50: 2e 69 43 75 72 73 6f 72 3b 0a 20 20 20 20 20 20  .iCursor;.      
5e60: 70 52 69 67 68 74 2d 3e 69 43 6f 6c 75 6d 6e 20  pRight->iColumn 
5e70: 3d 20 2d 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20  = -1;.    }.    
5e80: 70 45 71 20 3d 20 73 71 6c 69 74 65 33 50 45 78  pEq = sqlite3PEx
5e90: 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 4e 45  pr(pParse, TK_NE
5ea0: 2c 20 70 4c 65 66 74 2c 20 70 52 69 67 68 74 2c  , pLeft, pRight,
5eb0: 20 30 29 3b 0a 20 20 20 20 70 57 68 65 72 65 20   0);.    pWhere 
5ec0: 3d 20 73 71 6c 69 74 65 33 45 78 70 72 41 6e 64  = sqlite3ExprAnd
5ed0: 28 64 62 2c 20 70 57 68 65 72 65 2c 20 70 45 71  (db, pWhere, pEq
5ee0: 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 52 65 73  );.  }..  /* Res
5ef0: 6f 6c 76 65 20 74 68 65 20 72 65 66 65 72 65 6e  olve the referen
5f00: 63 65 73 20 69 6e 20 74 68 65 20 57 48 45 52 45  ces in the WHERE
5f10: 20 63 6c 61 75 73 65 2e 20 2a 2f 0a 20 20 6d 65   clause. */.  me
5f20: 6d 73 65 74 28 26 73 4e 61 6d 65 43 6f 6e 74 65  mset(&sNameConte
5f30: 78 74 2c 20 30 2c 20 73 69 7a 65 6f 66 28 4e 61  xt, 0, sizeof(Na
5f40: 6d 65 43 6f 6e 74 65 78 74 29 29 3b 0a 20 20 73  meContext));.  s
5f50: 4e 61 6d 65 43 6f 6e 74 65 78 74 2e 70 53 72 63  NameContext.pSrc
5f60: 4c 69 73 74 20 3d 20 70 53 72 63 3b 0a 20 20 73  List = pSrc;.  s
5f70: 4e 61 6d 65 43 6f 6e 74 65 78 74 2e 70 50 61 72  NameContext.pPar
5f80: 73 65 20 3d 20 70 50 61 72 73 65 3b 0a 20 20 73  se = pParse;.  s
5f90: 71 6c 69 74 65 33 52 65 73 6f 6c 76 65 45 78 70  qlite3ResolveExp
5fa0: 72 4e 61 6d 65 73 28 26 73 4e 61 6d 65 43 6f 6e  rNames(&sNameCon
5fb0: 74 65 78 74 2c 20 70 57 68 65 72 65 29 3b 0a 0a  text, pWhere);..
5fc0: 20 20 2f 2a 20 43 72 65 61 74 65 20 56 44 42 45    /* Create VDBE
5fd0: 20 74 6f 20 6c 6f 6f 70 20 74 68 72 6f 75 67 68   to loop through
5fe0: 20 74 68 65 20 65 6e 74 72 69 65 73 20 69 6e 20   the entries in 
5ff0: 70 53 72 63 20 74 68 61 74 20 6d 61 74 63 68 20  pSrc that match 
6000: 74 68 65 20 57 48 45 52 45 0a 20 20 2a 2a 20 63  the WHERE.  ** c
6010: 6c 61 75 73 65 2e 20 49 66 20 74 68 65 20 63 6f  lause. If the co
6020: 6e 73 74 72 61 69 6e 74 20 69 73 20 6e 6f 74 20  nstraint is not 
6030: 64 65 66 65 72 72 65 64 2c 20 74 68 72 6f 77 20  deferred, throw 
6040: 61 6e 20 65 78 63 65 70 74 69 6f 6e 20 66 6f 72  an exception for
6050: 0a 20 20 2a 2a 20 65 61 63 68 20 72 6f 77 20 66  .  ** each row f
6060: 6f 75 6e 64 2e 20 4f 74 68 65 72 77 69 73 65 2c  ound. Otherwise,
6070: 20 66 6f 72 20 64 65 66 65 72 72 65 64 20 63 6f   for deferred co
6080: 6e 73 74 72 61 69 6e 74 73 2c 20 69 6e 63 72 65  nstraints, incre
6090: 6d 65 6e 74 20 74 68 65 0a 20 20 2a 2a 20 64 65  ment the.  ** de
60a0: 66 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69 6e  ferred constrain
60b0: 74 20 63 6f 75 6e 74 65 72 20 62 79 20 6e 49 6e  t counter by nIn
60c0: 63 72 20 66 6f 72 20 65 61 63 68 20 72 6f 77 20  cr for each row 
60d0: 73 65 6c 65 63 74 65 64 2e 20 20 2a 2f 0a 20 20  selected.  */.  
60e0: 70 57 49 6e 66 6f 20 3d 20 73 71 6c 69 74 65 33  pWInfo = sqlite3
60f0: 57 68 65 72 65 42 65 67 69 6e 28 70 50 61 72 73  WhereBegin(pPars
6100: 65 2c 20 70 53 72 63 2c 20 70 57 68 65 72 65 2c  e, pSrc, pWhere,
6110: 20 30 2c 20 30 2c 20 30 2c 20 30 29 3b 0a 20 20   0, 0, 0, 0);.  
6120: 69 66 28 20 6e 49 6e 63 72 3e 30 20 26 26 20 70  if( nIncr>0 && p
6130: 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 72 65 64  FKey->isDeferred
6140: 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  ==0 ){.    sqlit
6150: 65 33 50 61 72 73 65 54 6f 70 6c 65 76 65 6c 28  e3ParseToplevel(
6160: 70 50 61 72 73 65 29 2d 3e 6d 61 79 41 62 6f 72  pParse)->mayAbor
6170: 74 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 73 71 6c  t = 1;.  }.  sql
6180: 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28 76  ite3VdbeAddOp2(v
6190: 2c 20 4f 50 5f 46 6b 43 6f 75 6e 74 65 72 2c 20  , OP_FkCounter, 
61a0: 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 72 65  pFKey->isDeferre
61b0: 64 2c 20 6e 49 6e 63 72 29 3b 0a 20 20 69 66 28  d, nIncr);.  if(
61c0: 20 70 57 49 6e 66 6f 20 29 7b 0a 20 20 20 20 73   pWInfo ){.    s
61d0: 71 6c 69 74 65 33 57 68 65 72 65 45 6e 64 28 70  qlite3WhereEnd(p
61e0: 57 49 6e 66 6f 29 3b 0a 20 20 7d 0a 0a 20 20 2f  WInfo);.  }..  /
61f0: 2a 20 43 6c 65 61 6e 20 75 70 20 74 68 65 20 57  * Clean up the W
6200: 48 45 52 45 20 63 6c 61 75 73 65 20 63 6f 6e 73  HERE clause cons
6210: 74 72 75 63 74 65 64 20 61 62 6f 76 65 2e 20 2a  tructed above. *
6220: 2f 0a 20 20 73 71 6c 69 74 65 33 45 78 70 72 44  /.  sqlite3ExprD
6230: 65 6c 65 74 65 28 64 62 2c 20 70 57 68 65 72 65  elete(db, pWhere
6240: 29 3b 0a 20 20 69 66 28 20 69 46 6b 49 66 5a 65  );.  if( iFkIfZe
6250: 72 6f 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  ro ){.    sqlite
6260: 33 56 64 62 65 4a 75 6d 70 48 65 72 65 28 76 2c  3VdbeJumpHere(v,
6270: 20 69 46 6b 49 66 5a 65 72 6f 29 3b 0a 20 20 7d   iFkIfZero);.  }
6280: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
6290: 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20  unction returns 
62a0: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  a pointer to the
62b0: 20 68 65 61 64 20 6f 66 20 61 20 6c 69 6e 6b 65   head of a linke
62c0: 64 20 6c 69 73 74 20 6f 66 20 46 4b 0a 2a 2a 20  d list of FK.** 
62d0: 63 6f 6e 73 74 72 61 69 6e 74 73 20 66 6f 72 20  constraints for 
62e0: 77 68 69 63 68 20 74 61 62 6c 65 20 70 54 61 62  which table pTab
62f0: 20 69 73 20 74 68 65 20 70 61 72 65 6e 74 20 74   is the parent t
6300: 61 62 6c 65 2e 20 46 6f 72 20 65 78 61 6d 70 6c  able. For exampl
6310: 65 2c 0a 2a 2a 20 67 69 76 65 6e 20 74 68 65 20  e,.** given the 
6320: 66 6f 6c 6c 6f 77 69 6e 67 20 73 63 68 65 6d 61  following schema
6330: 3a 0a 2a 2a 0a 2a 2a 20 20 20 43 52 45 41 54 45  :.**.**   CREATE
6340: 20 54 41 42 4c 45 20 74 31 28 61 20 50 52 49 4d   TABLE t1(a PRIM
6350: 41 52 59 20 4b 45 59 29 3b 0a 2a 2a 20 20 20 43  ARY KEY);.**   C
6360: 52 45 41 54 45 20 54 41 42 4c 45 20 74 32 28 62  REATE TABLE t2(b
6370: 20 52 45 46 45 52 45 4e 43 45 53 20 74 31 28 61   REFERENCES t1(a
6380: 29 3b 0a 2a 2a 0a 2a 2a 20 43 61 6c 6c 69 6e 67  );.**.** Calling
6390: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77   this function w
63a0: 69 74 68 20 74 61 62 6c 65 20 22 74 31 22 20 61  ith table "t1" a
63b0: 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 20 72 65  s an argument re
63c0: 74 75 72 6e 73 20 61 20 70 6f 69 6e 74 65 72 0a  turns a pointer.
63d0: 2a 2a 20 74 6f 20 74 68 65 20 46 4b 65 79 20 73  ** to the FKey s
63e0: 74 72 75 63 74 75 72 65 20 72 65 70 72 65 73 65  tructure represe
63f0: 6e 74 69 6e 67 20 74 68 65 20 66 6f 72 65 69 67  nting the foreig
6400: 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74  n key constraint
6410: 20 6f 6e 20 74 61 62 6c 65 0a 2a 2a 20 22 74 32   on table.** "t2
6420: 22 2e 20 43 61 6c 6c 69 6e 67 20 74 68 69 73 20  ". Calling this 
6430: 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20 22 74  function with "t
6440: 32 22 20 61 73 20 74 68 65 20 61 72 67 75 6d 65  2" as the argume
6450: 6e 74 20 77 6f 75 6c 64 20 72 65 74 75 72 6e 20  nt would return 
6460: 61 0a 2a 2a 20 4e 55 4c 4c 20 70 6f 69 6e 74 65  a.** NULL pointe
6470: 72 20 28 61 73 20 74 68 65 72 65 20 61 72 65 20  r (as there are 
6480: 6e 6f 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74  no FK constraint
6490: 73 20 66 6f 72 20 77 68 69 63 68 20 74 32 20 69  s for which t2 i
64a0: 73 20 74 68 65 20 70 61 72 65 6e 74 0a 2a 2a 20  s the parent.** 
64b0: 74 61 62 6c 65 29 2e 0a 2a 2f 0a 46 4b 65 79 20  table)..*/.FKey 
64c0: 2a 73 71 6c 69 74 65 33 46 6b 52 65 66 65 72 65  *sqlite3FkRefere
64d0: 6e 63 65 73 28 54 61 62 6c 65 20 2a 70 54 61 62  nces(Table *pTab
64e0: 29 7b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65 20 3d  ){.  int nName =
64f0: 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30   sqlite3Strlen30
6500: 28 70 54 61 62 2d 3e 7a 4e 61 6d 65 29 3b 0a 20  (pTab->zName);. 
6510: 20 72 65 74 75 72 6e 20 28 46 4b 65 79 20 2a 29   return (FKey *)
6520: 73 71 6c 69 74 65 33 48 61 73 68 46 69 6e 64 28  sqlite3HashFind(
6530: 26 70 54 61 62 2d 3e 70 53 63 68 65 6d 61 2d 3e  &pTab->pSchema->
6540: 66 6b 65 79 48 61 73 68 2c 20 70 54 61 62 2d 3e  fkeyHash, pTab->
6550: 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 29 3b 0a 7d  zName, nName);.}
6560: 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 65 63 6f  ../*.** The seco
6570: 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73 20 61  nd argument is a
6580: 20 54 72 69 67 67 65 72 20 73 74 72 75 63 74 75   Trigger structu
6590: 72 65 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20  re allocated by 
65a0: 74 68 65 20 0a 2a 2a 20 66 6b 41 63 74 69 6f 6e  the .** fkAction
65b0: 54 72 69 67 67 65 72 28 29 20 72 6f 75 74 69 6e  Trigger() routin
65c0: 65 2e 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  e. This function
65d0: 20 64 65 6c 65 74 65 73 20 74 68 65 20 54 72 69   deletes the Tri
65e0: 67 67 65 72 20 73 74 72 75 63 74 75 72 65 0a 2a  gger structure.*
65f0: 2a 20 61 6e 64 20 61 6c 6c 20 6f 66 20 69 74 73  * and all of its
6600: 20 73 75 62 2d 63 6f 6d 70 6f 6e 65 6e 74 73 2e   sub-components.
6610: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 54 72 69 67 67  .**.** The Trigg
6620: 65 72 20 73 74 72 75 63 74 75 72 65 20 6f 72 20  er structure or 
6630: 61 6e 79 20 6f 66 20 69 74 73 20 73 75 62 2d 63  any of its sub-c
6640: 6f 6d 70 6f 6e 65 6e 74 73 20 6d 61 79 20 62 65  omponents may be
6650: 20 61 6c 6c 6f 63 61 74 65 64 20 66 72 6f 6d 0a   allocated from.
6660: 2a 2a 20 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65  ** the lookaside
6670: 20 62 75 66 66 65 72 20 62 65 6c 6f 6e 67 69 6e   buffer belongin
6680: 67 20 74 6f 20 64 61 74 61 62 61 73 65 20 68 61  g to database ha
6690: 6e 64 6c 65 20 64 62 4d 65 6d 2e 0a 2a 2f 0a 73  ndle dbMem..*/.s
66a0: 74 61 74 69 63 20 76 6f 69 64 20 66 6b 54 72 69  tatic void fkTri
66b0: 67 67 65 72 44 65 6c 65 74 65 28 73 71 6c 69 74  ggerDelete(sqlit
66c0: 65 33 20 2a 64 62 4d 65 6d 2c 20 54 72 69 67 67  e3 *dbMem, Trigg
66d0: 65 72 20 2a 70 29 7b 0a 20 20 69 66 28 20 70 20  er *p){.  if( p 
66e0: 29 7b 0a 20 20 20 20 54 72 69 67 67 65 72 53 74  ){.    TriggerSt
66f0: 65 70 20 2a 70 53 74 65 70 20 3d 20 70 2d 3e 73  ep *pStep = p->s
6700: 74 65 70 5f 6c 69 73 74 3b 0a 20 20 20 20 73 71  tep_list;.    sq
6710: 6c 69 74 65 33 45 78 70 72 44 65 6c 65 74 65 28  lite3ExprDelete(
6720: 64 62 4d 65 6d 2c 20 70 53 74 65 70 2d 3e 70 57  dbMem, pStep->pW
6730: 68 65 72 65 29 3b 0a 20 20 20 20 73 71 6c 69 74  here);.    sqlit
6740: 65 33 45 78 70 72 4c 69 73 74 44 65 6c 65 74 65  e3ExprListDelete
6750: 28 64 62 4d 65 6d 2c 20 70 53 74 65 70 2d 3e 70  (dbMem, pStep->p
6760: 45 78 70 72 4c 69 73 74 29 3b 0a 20 20 20 20 73  ExprList);.    s
6770: 71 6c 69 74 65 33 53 65 6c 65 63 74 44 65 6c 65  qlite3SelectDele
6780: 74 65 28 64 62 4d 65 6d 2c 20 70 53 74 65 70 2d  te(dbMem, pStep-
6790: 3e 70 53 65 6c 65 63 74 29 3b 0a 20 20 20 20 73  >pSelect);.    s
67a0: 71 6c 69 74 65 33 45 78 70 72 44 65 6c 65 74 65  qlite3ExprDelete
67b0: 28 64 62 4d 65 6d 2c 20 70 2d 3e 70 57 68 65 6e  (dbMem, p->pWhen
67c0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62  );.    sqlite3Db
67d0: 46 72 65 65 28 64 62 4d 65 6d 2c 20 70 29 3b 0a  Free(dbMem, p);.
67e0: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69    }.}../*.** Thi
67f0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61  s function is ca
6800: 6c 6c 65 64 20 74 6f 20 67 65 6e 65 72 61 74 65  lled to generate
6810: 20 63 6f 64 65 20 74 68 61 74 20 72 75 6e 73 20   code that runs 
6820: 77 68 65 6e 20 74 61 62 6c 65 20 70 54 61 62 20  when table pTab 
6830: 69 73 0a 2a 2a 20 62 65 69 6e 67 20 64 72 6f 70  is.** being drop
6840: 70 65 64 20 66 72 6f 6d 20 74 68 65 20 64 61 74  ped from the dat
6850: 61 62 61 73 65 2e 20 54 68 65 20 53 72 63 4c 69  abase. The SrcLi
6860: 73 74 20 70 61 73 73 65 64 20 61 73 20 74 68 65  st passed as the
6870: 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74   second argument
6880: 0a 2a 2a 20 74 6f 20 74 68 69 73 20 66 75 6e 63  .** to this func
6890: 74 69 6f 6e 20 63 6f 6e 74 61 69 6e 73 20 61 20  tion contains a 
68a0: 73 69 6e 67 6c 65 20 65 6e 74 72 79 20 67 75 61  single entry gua
68b0: 72 61 6e 74 65 65 64 20 74 6f 20 72 65 73 6f 6c  ranteed to resol
68c0: 76 65 20 74 6f 0a 2a 2a 20 74 61 62 6c 65 20 70  ve to.** table p
68d0: 54 61 62 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 72 6d 61  Tab..**.** Norma
68e0: 6c 6c 79 2c 20 6e 6f 20 63 6f 64 65 20 69 73 20  lly, no code is 
68f0: 72 65 71 75 69 72 65 64 2e 20 48 6f 77 65 76 65  required. Howeve
6900: 72 2c 20 69 66 20 65 69 74 68 65 72 0a 2a 2a 0a  r, if either.**.
6910: 2a 2a 20 20 20 28 61 29 20 54 68 65 20 74 61 62  **   (a) The tab
6920: 6c 65 20 69 73 20 74 68 65 20 70 61 72 65 6e 74  le is the parent
6930: 20 74 61 62 6c 65 20 6f 66 20 61 20 46 4b 20 63   table of a FK c
6940: 6f 6e 73 74 72 61 69 6e 74 2c 20 6f 72 0a 2a 2a  onstraint, or.**
6950: 20 20 20 28 62 29 20 54 68 65 20 74 61 62 6c 65     (b) The table
6960: 20 69 73 20 74 68 65 20 63 68 69 6c 64 20 74 61   is the child ta
6970: 62 6c 65 20 6f 66 20 61 20 64 65 66 65 72 72 65  ble of a deferre
6980: 64 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74 20  d FK constraint 
6990: 61 6e 64 20 69 74 20 69 73 0a 2a 2a 20 20 20 20  and it is.**    
69a0: 20 20 20 64 65 74 65 72 6d 69 6e 65 64 20 61 74     determined at
69b0: 20 72 75 6e 74 69 6d 65 20 74 68 61 74 20 74 68   runtime that th
69c0: 65 72 65 20 61 72 65 20 6f 75 74 73 74 61 6e 64  ere are outstand
69d0: 69 6e 67 20 64 65 66 65 72 72 65 64 20 46 4b 20  ing deferred FK 
69e0: 0a 2a 2a 20 20 20 20 20 20 20 63 6f 6e 73 74 72  .**       constr
69f0: 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 73 20  aint violations 
6a00: 69 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2c  in the database,
6a10: 0a 2a 2a 0a 2a 2a 20 74 68 65 6e 20 74 68 65 20  .**.** then the 
6a20: 65 71 75 69 76 61 6c 65 6e 74 20 6f 66 20 22 44  equivalent of "D
6a30: 45 4c 45 54 45 20 46 52 4f 4d 20 3c 74 62 6c 3e  ELETE FROM <tbl>
6a40: 22 20 69 73 20 65 78 65 63 75 74 65 64 20 62 65  " is executed be
6a50: 66 6f 72 65 20 64 72 6f 70 70 69 6e 67 0a 2a 2a  fore dropping.**
6a60: 20 74 68 65 20 74 61 62 6c 65 20 66 72 6f 6d 20   the table from 
6a70: 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 54 72  the database. Tr
6a80: 69 67 67 65 72 73 20 61 72 65 20 64 69 73 61 62  iggers are disab
6a90: 6c 65 64 20 77 68 69 6c 65 20 72 75 6e 6e 69 6e  led while runnin
6aa0: 67 20 74 68 69 73 0a 2a 2a 20 44 45 4c 45 54 45  g this.** DELETE
6ab0: 2c 20 62 75 74 20 66 6f 72 65 69 67 6e 20 6b 65  , but foreign ke
6ac0: 79 20 61 63 74 69 6f 6e 73 20 61 72 65 20 6e 6f  y actions are no
6ad0: 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74  t..*/.void sqlit
6ae0: 65 33 46 6b 44 72 6f 70 54 61 62 6c 65 28 50 61  e3FkDropTable(Pa
6af0: 72 73 65 20 2a 70 50 61 72 73 65 2c 20 53 72 63  rse *pParse, Src
6b00: 4c 69 73 74 20 2a 70 4e 61 6d 65 2c 20 54 61 62  List *pName, Tab
6b10: 6c 65 20 2a 70 54 61 62 29 7b 0a 20 20 73 71 6c  le *pTab){.  sql
6b20: 69 74 65 33 20 2a 64 62 20 3d 20 70 50 61 72 73  ite3 *db = pPars
6b30: 65 2d 3e 64 62 3b 0a 20 20 69 66 28 20 28 64 62  e->db;.  if( (db
6b40: 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45 5f 46  ->flags&SQLITE_F
6b50: 6f 72 65 69 67 6e 4b 65 79 73 29 20 26 26 20 21  oreignKeys) && !
6b60: 49 73 56 69 72 74 75 61 6c 28 70 54 61 62 29 20  IsVirtual(pTab) 
6b70: 26 26 20 21 70 54 61 62 2d 3e 70 53 65 6c 65 63  && !pTab->pSelec
6b80: 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 53 6b  t ){.    int iSk
6b90: 69 70 20 3d 20 30 3b 0a 20 20 20 20 56 64 62 65  ip = 0;.    Vdbe
6ba0: 20 2a 76 20 3d 20 73 71 6c 69 74 65 33 47 65 74   *v = sqlite3Get
6bb0: 56 64 62 65 28 70 50 61 72 73 65 29 3b 0a 0a 20  Vdbe(pParse);.. 
6bc0: 20 20 20 61 73 73 65 72 74 28 20 76 20 29 3b 20     assert( v ); 
6bd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6be0: 20 2f 2a 20 56 44 42 45 20 68 61 73 20 61 6c 72   /* VDBE has alr
6bf0: 65 61 64 79 20 62 65 65 6e 20 61 6c 6c 6f 63 61  eady been alloca
6c00: 74 65 64 20 2a 2f 0a 20 20 20 20 69 66 28 20 73  ted */.    if( s
6c10: 71 6c 69 74 65 33 46 6b 52 65 66 65 72 65 6e 63  qlite3FkReferenc
6c20: 65 73 28 70 54 61 62 29 3d 3d 30 20 29 7b 0a 20  es(pTab)==0 ){. 
6c30: 20 20 20 20 20 2f 2a 20 53 65 61 72 63 68 20 66       /* Search f
6c40: 6f 72 20 61 20 64 65 66 65 72 72 65 64 20 66 6f  or a deferred fo
6c50: 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72  reign key constr
6c60: 61 69 6e 74 20 66 6f 72 20 77 68 69 63 68 20 74  aint for which t
6c70: 68 69 73 20 74 61 62 6c 65 0a 20 20 20 20 20 20  his table.      
6c80: 2a 2a 20 69 73 20 74 68 65 20 63 68 69 6c 64 20  ** is the child 
6c90: 74 61 62 6c 65 2e 20 49 66 20 6f 6e 65 20 63 61  table. If one ca
6ca0: 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 2c 20 72  nnot be found, r
6cb0: 65 74 75 72 6e 20 77 69 74 68 6f 75 74 20 0a 20  eturn without . 
6cc0: 20 20 20 20 20 2a 2a 20 67 65 6e 65 72 61 74 69       ** generati
6cd0: 6e 67 20 61 6e 79 20 56 44 42 45 20 63 6f 64 65  ng any VDBE code
6ce0: 2e 20 49 66 20 6f 6e 65 20 63 61 6e 20 62 65 20  . If one can be 
6cf0: 66 6f 75 6e 64 2c 20 74 68 65 6e 20 6a 75 6d 70  found, then jump
6d00: 20 6f 76 65 72 0a 20 20 20 20 20 20 2a 2a 20 74   over.      ** t
6d10: 68 65 20 65 6e 74 69 72 65 20 44 45 4c 45 54 45  he entire DELETE
6d20: 20 69 66 20 74 68 65 72 65 20 61 72 65 20 6e 6f   if there are no
6d30: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 64 65 66   outstanding def
6d40: 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69 6e 74  erred constraint
6d50: 73 0a 20 20 20 20 20 20 2a 2a 20 77 68 65 6e 20  s.      ** when 
6d60: 74 68 69 73 20 73 74 61 74 65 6d 65 6e 74 20 69  this statement i
6d70: 73 20 72 75 6e 2e 20 20 2a 2f 0a 20 20 20 20 20  s run.  */.     
6d80: 20 46 4b 65 79 20 2a 70 3b 0a 20 20 20 20 20 20   FKey *p;.      
6d90: 66 6f 72 28 70 3d 70 54 61 62 2d 3e 70 46 4b 65  for(p=pTab->pFKe
6da0: 79 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 74  y; p; p=p->pNext
6db0: 46 72 6f 6d 29 7b 0a 20 20 20 20 20 20 20 20 69  From){.        i
6dc0: 66 28 20 70 2d 3e 69 73 44 65 66 65 72 72 65 64  f( p->isDeferred
6dd0: 20 7c 7c 20 28 64 62 2d 3e 66 6c 61 67 73 20 26   || (db->flags &
6de0: 20 53 51 4c 49 54 45 5f 44 65 66 65 72 46 4b 73   SQLITE_DeferFKs
6df0: 29 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20  ) ) break;.     
6e00: 20 7d 0a 20 20 20 20 20 20 69 66 28 20 21 70 20   }.      if( !p 
6e10: 29 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 20 20  ) return;.      
6e20: 69 53 6b 69 70 20 3d 20 73 71 6c 69 74 65 33 56  iSkip = sqlite3V
6e30: 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28 76 29 3b  dbeMakeLabel(v);
6e40: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
6e50: 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 46  beAddOp2(v, OP_F
6e60: 6b 49 66 5a 65 72 6f 2c 20 31 2c 20 69 53 6b 69  kIfZero, 1, iSki
6e70: 70 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70  p);.    }..    p
6e80: 50 61 72 73 65 2d 3e 64 69 73 61 62 6c 65 54 72  Parse->disableTr
6e90: 69 67 67 65 72 73 20 3d 20 31 3b 0a 20 20 20 20  iggers = 1;.    
6ea0: 73 71 6c 69 74 65 33 44 65 6c 65 74 65 46 72 6f  sqlite3DeleteFro
6eb0: 6d 28 70 50 61 72 73 65 2c 20 73 71 6c 69 74 65  m(pParse, sqlite
6ec0: 33 53 72 63 4c 69 73 74 44 75 70 28 64 62 2c 20  3SrcListDup(db, 
6ed0: 70 4e 61 6d 65 2c 20 30 29 2c 20 30 29 3b 0a 20  pName, 0), 0);. 
6ee0: 20 20 20 70 50 61 72 73 65 2d 3e 64 69 73 61 62     pParse->disab
6ef0: 6c 65 54 72 69 67 67 65 72 73 20 3d 20 30 3b 0a  leTriggers = 0;.
6f00: 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 44  .    /* If the D
6f10: 45 4c 45 54 45 20 68 61 73 20 67 65 6e 65 72 61  ELETE has genera
6f20: 74 65 64 20 69 6d 6d 65 64 69 61 74 65 20 66 6f  ted immediate fo
6f30: 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72  reign key constr
6f40: 61 69 6e 74 20 0a 20 20 20 20 2a 2a 20 76 69 6f  aint .    ** vio
6f50: 6c 61 74 69 6f 6e 73 2c 20 68 61 6c 74 20 74 68  lations, halt th
6f60: 65 20 56 44 42 45 20 61 6e 64 20 72 65 74 75 72  e VDBE and retur
6f70: 6e 20 61 6e 20 65 72 72 6f 72 20 61 74 20 74 68  n an error at th
6f80: 69 73 20 70 6f 69 6e 74 2c 20 62 65 66 6f 72 65  is point, before
6f90: 0a 20 20 20 20 2a 2a 20 61 6e 79 20 6d 6f 64 69  .    ** any modi
6fa0: 66 69 63 61 74 69 6f 6e 73 20 74 6f 20 74 68 65  fications to the
6fb0: 20 73 63 68 65 6d 61 20 61 72 65 20 6d 61 64 65   schema are made
6fc0: 2e 20 54 68 69 73 20 69 73 20 62 65 63 61 75 73  . This is becaus
6fd0: 65 20 73 74 61 74 65 6d 65 6e 74 0a 20 20 20 20  e statement.    
6fe0: 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20  ** transactions 
6ff0: 61 72 65 20 6e 6f 74 20 61 62 6c 65 20 74 6f 20  are not able to 
7000: 72 6f 6c 6c 62 61 63 6b 20 73 63 68 65 6d 61 20  rollback schema 
7010: 63 68 61 6e 67 65 73 2e 20 20 0a 20 20 20 20 2a  changes.  .    *
7020: 2a 0a 20 20 20 20 2a 2a 20 49 66 20 74 68 65 20  *.    ** If the 
7030: 53 51 4c 49 54 45 5f 44 65 66 65 72 46 4b 73 20  SQLITE_DeferFKs 
7040: 66 6c 61 67 20 69 73 20 73 65 74 2c 20 74 68 65  flag is set, the
7050: 6e 20 74 68 69 73 20 69 73 20 6e 6f 74 20 72 65  n this is not re
7060: 71 75 69 72 65 64 2c 20 61 73 0a 20 20 20 20 2a  quired, as.    *
7070: 2a 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20  * the statement 
7080: 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c  transaction will
7090: 20 6e 6f 74 20 62 65 20 72 6f 6c 6c 65 64 20 62   not be rolled b
70a0: 61 63 6b 20 65 76 65 6e 20 69 66 20 46 4b 0a 20  ack even if FK. 
70b0: 20 20 20 2a 2a 20 63 6f 6e 73 74 72 61 69 6e 74     ** constraint
70c0: 73 20 61 72 65 20 76 69 6f 6c 61 74 65 64 2e 0a  s are violated..
70d0: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 28      */.    if( (
70e0: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49  db->flags & SQLI
70f0: 54 45 5f 44 65 66 65 72 46 4b 73 29 3d 3d 30 20  TE_DeferFKs)==0 
7100: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  ){.      sqlite3
7110: 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50  VdbeAddOp2(v, OP
7120: 5f 46 6b 49 66 5a 65 72 6f 2c 20 30 2c 20 73 71  _FkIfZero, 0, sq
7130: 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 6e 74  lite3VdbeCurrent
7140: 41 64 64 72 28 76 29 2b 32 29 3b 0a 20 20 20 20  Addr(v)+2);.    
7150: 20 20 73 71 6c 69 74 65 33 48 61 6c 74 43 6f 6e    sqlite3HaltCon
7160: 73 74 72 61 69 6e 74 28 70 50 61 72 73 65 2c 20  straint(pParse, 
7170: 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e  SQLITE_CONSTRAIN
7180: 54 5f 46 4f 52 45 49 47 4e 4b 45 59 2c 0a 20 20  T_FOREIGNKEY,.  
7190: 20 20 20 20 20 20 20 20 4f 45 5f 41 62 6f 72 74          OE_Abort
71a0: 2c 20 22 66 6f 72 65 69 67 6e 20 6b 65 79 20 63  , "foreign key c
71b0: 6f 6e 73 74 72 61 69 6e 74 20 66 61 69 6c 65 64  onstraint failed
71c0: 22 2c 20 50 34 5f 53 54 41 54 49 43 0a 20 20 20  ", P4_STATIC.   
71d0: 20 20 20 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20     );.    }..   
71e0: 20 69 66 28 20 69 53 6b 69 70 20 29 7b 0a 20 20   if( iSkip ){.  
71f0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 52      sqlite3VdbeR
7200: 65 73 6f 6c 76 65 4c 61 62 65 6c 28 76 2c 20 69  esolveLabel(v, i
7210: 53 6b 69 70 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  Skip);.    }.  }
7220: 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73  .}.../*.** The s
7230: 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 70  econd argument p
7240: 6f 69 6e 74 73 20 74 6f 20 61 6e 20 46 4b 65 79  oints to an FKey
7250: 20 6f 62 6a 65 63 74 20 72 65 70 72 65 73 65 6e   object represen
7260: 74 69 6e 67 20 61 20 66 6f 72 65 69 67 6e 20 6b  ting a foreign k
7270: 65 79 0a 2a 2a 20 66 6f 72 20 77 68 69 63 68 20  ey.** for which 
7280: 70 54 61 62 20 69 73 20 74 68 65 20 63 68 69 6c  pTab is the chil
7290: 64 20 74 61 62 6c 65 2e 20 41 6e 20 55 50 44 41  d table. An UPDA
72a0: 54 45 20 73 74 61 74 65 6d 65 6e 74 20 61 67 61  TE statement aga
72b0: 69 6e 73 74 20 70 54 61 62 0a 2a 2a 20 69 73 20  inst pTab.** is 
72c0: 63 75 72 72 65 6e 74 6c 79 20 62 65 69 6e 67 20  currently being 
72d0: 70 72 6f 63 65 73 73 65 64 2e 20 46 6f 72 20 65  processed. For e
72e0: 61 63 68 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68  ach column of th
72f0: 65 20 74 61 62 6c 65 20 74 68 61 74 20 69 73 20  e table that is 
7300: 0a 2a 2a 20 61 63 74 75 61 6c 6c 79 20 75 70 64  .** actually upd
7310: 61 74 65 64 2c 20 74 68 65 20 63 6f 72 72 65 73  ated, the corres
7320: 70 6f 6e 64 69 6e 67 20 65 6c 65 6d 65 6e 74 20  ponding element 
7330: 69 6e 20 74 68 65 20 61 43 68 61 6e 67 65 5b 5d  in the aChange[]
7340: 20 61 72 72 61 79 0a 2a 2a 20 69 73 20 7a 65 72   array.** is zer
7350: 6f 20 6f 72 20 67 72 65 61 74 65 72 20 28 69 66  o or greater (if
7360: 20 61 20 63 6f 6c 75 6d 6e 20 69 73 20 75 6e 6d   a column is unm
7370: 6f 64 69 66 69 65 64 20 74 68 65 20 63 6f 72 72  odified the corr
7380: 65 73 70 6f 6e 64 69 6e 67 20 65 6c 65 6d 65 6e  esponding elemen
7390: 74 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20 2d  t.** is set to -
73a0: 31 29 2e 20 49 66 20 74 68 65 20 72 6f 77 69 64  1). If the rowid
73b0: 20 63 6f 6c 75 6d 6e 20 69 73 20 6d 6f 64 69 66   column is modif
73c0: 69 65 64 20 62 79 20 74 68 65 20 55 50 44 41 54  ied by the UPDAT
73d0: 45 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 74  E statement.** t
73e0: 68 65 20 62 43 68 6e 67 52 6f 77 69 64 20 61 72  he bChngRowid ar
73f0: 67 75 6d 65 6e 74 20 69 73 20 6e 6f 6e 2d 7a 65  gument is non-ze
7400: 72 6f 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66  ro..**.** This f
7410: 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e 73 20  unction returns 
7420: 74 72 75 65 20 69 66 20 61 6e 79 20 6f 66 20 74  true if any of t
7430: 68 65 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20  he columns that 
7440: 61 72 65 20 70 61 72 74 20 6f 66 20 74 68 65 0a  are part of the.
7450: 2a 2a 20 63 68 69 6c 64 20 6b 65 79 20 66 6f 72  ** child key for
7460: 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a   FK constraint *
7470: 70 20 61 72 65 20 6d 6f 64 69 66 69 65 64 2e 0a  p are modified..
7480: 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 66 6b  */.static int fk
7490: 43 68 69 6c 64 49 73 4d 6f 64 69 66 69 65 64 28  ChildIsModified(
74a0: 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 2c 20  .  Table *pTab, 
74b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
74c0: 20 20 20 2f 2a 20 54 61 62 6c 65 20 62 65 69 6e     /* Table bein
74d0: 67 20 75 70 64 61 74 65 64 20 2a 2f 0a 20 20 46  g updated */.  F
74e0: 4b 65 79 20 2a 70 2c 20 20 20 20 20 20 20 20 20  Key *p,         
74f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
7500: 2a 20 46 6f 72 65 69 67 6e 20 6b 65 79 20 66 6f  * Foreign key fo
7510: 72 20 77 68 69 63 68 20 70 54 61 62 20 69 73 20  r which pTab is 
7520: 74 68 65 20 63 68 69 6c 64 20 2a 2f 0a 20 20 69  the child */.  i
7530: 6e 74 20 2a 61 43 68 61 6e 67 65 2c 20 20 20 20  nt *aChange,    
7540: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
7550: 2a 20 41 72 72 61 79 20 69 6e 64 69 63 61 74 69  * Array indicati
7560: 6e 67 20 6d 6f 64 69 66 69 65 64 20 63 6f 6c 75  ng modified colu
7570: 6d 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 62 43 68  mns */.  int bCh
7580: 6e 67 52 6f 77 69 64 20 20 20 20 20 20 20 20 20  ngRowid         
7590: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65           /* True
75a0: 20 69 66 20 72 6f 77 69 64 20 69 73 20 6d 6f 64   if rowid is mod
75b0: 69 66 69 65 64 20 62 79 20 74 68 69 73 20 75 70  ified by this up
75c0: 64 61 74 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74  date */.){.  int
75d0: 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69   i;.  for(i=0; i
75e0: 3c 70 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a  <p->nCol; i++){.
75f0: 20 20 20 20 69 6e 74 20 69 43 68 69 6c 64 4b 65      int iChildKe
7600: 79 20 3d 20 70 2d 3e 61 43 6f 6c 5b 69 5d 2e 69  y = p->aCol[i].i
7610: 46 72 6f 6d 3b 0a 20 20 20 20 69 66 28 20 61 43  From;.    if( aC
7620: 68 61 6e 67 65 5b 69 43 68 69 6c 64 4b 65 79 5d  hange[iChildKey]
7630: 3e 3d 30 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  >=0 ) return 1;.
7640: 20 20 20 20 69 66 28 20 69 43 68 69 6c 64 4b 65      if( iChildKe
7650: 79 3d 3d 70 54 61 62 2d 3e 69 50 4b 65 79 20 26  y==pTab->iPKey &
7660: 26 20 62 43 68 6e 67 52 6f 77 69 64 20 29 20 72  & bChngRowid ) r
7670: 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 72  eturn 1;.  }.  r
7680: 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a  eturn 0;.}../*.*
7690: 2a 20 54 68 65 20 73 65 63 6f 6e 64 20 61 72 67  * The second arg
76a0: 75 6d 65 6e 74 20 70 6f 69 6e 74 73 20 74 6f 20  ument points to 
76b0: 61 6e 20 46 4b 65 79 20 6f 62 6a 65 63 74 20 72  an FKey object r
76c0: 65 70 72 65 73 65 6e 74 69 6e 67 20 61 20 66 6f  epresenting a fo
76d0: 72 65 69 67 6e 20 6b 65 79 0a 2a 2a 20 66 6f 72  reign key.** for
76e0: 20 77 68 69 63 68 20 70 54 61 62 20 69 73 20 74   which pTab is t
76f0: 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 2e  he parent table.
7700: 20 41 6e 20 55 50 44 41 54 45 20 73 74 61 74 65   An UPDATE state
7710: 6d 65 6e 74 20 61 67 61 69 6e 73 74 20 70 54 61  ment against pTa
7720: 62 0a 2a 2a 20 69 73 20 63 75 72 72 65 6e 74 6c  b.** is currentl
7730: 79 20 62 65 69 6e 67 20 70 72 6f 63 65 73 73 65  y being processe
7740: 64 2e 20 46 6f 72 20 65 61 63 68 20 63 6f 6c 75  d. For each colu
7750: 6d 6e 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20  mn of the table 
7760: 74 68 61 74 20 69 73 20 0a 2a 2a 20 61 63 74 75  that is .** actu
7770: 61 6c 6c 79 20 75 70 64 61 74 65 64 2c 20 74 68  ally updated, th
7780: 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20  e corresponding 
7790: 65 6c 65 6d 65 6e 74 20 69 6e 20 74 68 65 20 61  element in the a
77a0: 43 68 61 6e 67 65 5b 5d 20 61 72 72 61 79 0a 2a  Change[] array.*
77b0: 2a 20 69 73 20 7a 65 72 6f 20 6f 72 20 67 72 65  * is zero or gre
77c0: 61 74 65 72 20 28 69 66 20 61 20 63 6f 6c 75 6d  ater (if a colum
77d0: 6e 20 69 73 20 75 6e 6d 6f 64 69 66 69 65 64 20  n is unmodified 
77e0: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e  the correspondin
77f0: 67 20 65 6c 65 6d 65 6e 74 0a 2a 2a 20 69 73 20  g element.** is 
7800: 73 65 74 20 74 6f 20 2d 31 29 2e 20 49 66 20 74  set to -1). If t
7810: 68 65 20 72 6f 77 69 64 20 63 6f 6c 75 6d 6e 20  he rowid column 
7820: 69 73 20 6d 6f 64 69 66 69 65 64 20 62 79 20 74  is modified by t
7830: 68 65 20 55 50 44 41 54 45 20 73 74 61 74 65 6d  he UPDATE statem
7840: 65 6e 74 0a 2a 2a 20 74 68 65 20 62 43 68 6e 67  ent.** the bChng
7850: 52 6f 77 69 64 20 61 72 67 75 6d 65 6e 74 20 69  Rowid argument i
7860: 73 20 6e 6f 6e 2d 7a 65 72 6f 2e 0a 2a 2a 0a 2a  s non-zero..**.*
7870: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
7880: 72 65 74 75 72 6e 73 20 74 72 75 65 20 69 66 20  returns true if 
7890: 61 6e 79 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d  any of the colum
78a0: 6e 73 20 74 68 61 74 20 61 72 65 20 70 61 72 74  ns that are part
78b0: 20 6f 66 20 74 68 65 0a 2a 2a 20 70 61 72 65 6e   of the.** paren
78c0: 74 20 6b 65 79 20 66 6f 72 20 46 4b 20 63 6f 6e  t key for FK con
78d0: 73 74 72 61 69 6e 74 20 2a 70 20 61 72 65 20 6d  straint *p are m
78e0: 6f 64 69 66 69 65 64 2e 0a 2a 2f 0a 73 74 61 74  odified..*/.stat
78f0: 69 63 20 69 6e 74 20 66 6b 50 61 72 65 6e 74 49  ic int fkParentI
7900: 73 4d 6f 64 69 66 69 65 64 28 0a 20 20 54 61 62  sModified(.  Tab
7910: 6c 65 20 2a 70 54 61 62 2c 20 0a 20 20 46 4b 65  le *pTab, .  FKe
7920: 79 20 2a 70 2c 20 0a 20 20 69 6e 74 20 2a 61 43  y *p, .  int *aC
7930: 68 61 6e 67 65 2c 20 0a 20 20 69 6e 74 20 62 43  hange, .  int bC
7940: 68 6e 67 52 6f 77 69 64 0a 29 7b 0a 20 20 69 6e  hngRowid.){.  in
7950: 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20  t i;.  for(i=0; 
7960: 69 3c 70 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29 7b  i<p->nCol; i++){
7970: 0a 20 20 20 20 63 68 61 72 20 2a 7a 4b 65 79 20  .    char *zKey 
7980: 3d 20 70 2d 3e 61 43 6f 6c 5b 69 5d 2e 7a 43 6f  = p->aCol[i].zCo
7990: 6c 3b 0a 20 20 20 20 69 6e 74 20 69 4b 65 79 3b  l;.    int iKey;
79a0: 0a 20 20 20 20 66 6f 72 28 69 4b 65 79 3d 30 3b  .    for(iKey=0;
79b0: 20 69 4b 65 79 3c 70 54 61 62 2d 3e 6e 43 6f 6c   iKey<pTab->nCol
79c0: 3b 20 69 4b 65 79 2b 2b 29 7b 0a 20 20 20 20 20  ; iKey++){.     
79d0: 20 69 66 28 20 61 43 68 61 6e 67 65 5b 69 4b 65   if( aChange[iKe
79e0: 79 5d 3e 3d 30 20 7c 7c 20 28 69 4b 65 79 3d 3d  y]>=0 || (iKey==
79f0: 70 54 61 62 2d 3e 69 50 4b 65 79 20 26 26 20 62  pTab->iPKey && b
7a00: 43 68 6e 67 52 6f 77 69 64 29 20 29 7b 0a 20 20  ChngRowid) ){.  
7a10: 20 20 20 20 20 20 43 6f 6c 75 6d 6e 20 2a 70 43        Column *pC
7a20: 6f 6c 20 3d 20 26 70 54 61 62 2d 3e 61 43 6f 6c  ol = &pTab->aCol
7a30: 5b 69 4b 65 79 5d 3b 0a 20 20 20 20 20 20 20 20  [iKey];.        
7a40: 69 66 28 20 7a 4b 65 79 20 29 7b 0a 20 20 20 20  if( zKey ){.    
7a50: 20 20 20 20 20 20 69 66 28 20 30 3d 3d 73 71 6c        if( 0==sql
7a60: 69 74 65 33 53 74 72 49 43 6d 70 28 70 43 6f 6c  ite3StrICmp(pCol
7a70: 2d 3e 7a 4e 61 6d 65 2c 20 7a 4b 65 79 29 20 29  ->zName, zKey) )
7a80: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 20   return 1;.     
7a90: 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 43 6f     }else if( pCo
7aa0: 6c 2d 3e 63 6f 6c 46 6c 61 67 73 20 26 20 43 4f  l->colFlags & CO
7ab0: 4c 46 4c 41 47 5f 50 52 49 4d 4b 45 59 20 29 7b  LFLAG_PRIMKEY ){
7ac0: 0a 20 20 20 20 20 20 20 20 20 20 72 65 74 75 72  .          retur
7ad0: 6e 20 31 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  n 1;.        }. 
7ae0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
7af0: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a  .  return 0;.}..
7b00: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
7b10: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 68  ion is called wh
7b20: 65 6e 20 69 6e 73 65 72 74 69 6e 67 2c 20 64 65  en inserting, de
7b30: 6c 65 74 69 6e 67 20 6f 72 20 75 70 64 61 74 69  leting or updati
7b40: 6e 67 20 61 20 72 6f 77 20 6f 66 0a 2a 2a 20 74  ng a row of.** t
7b50: 61 62 6c 65 20 70 54 61 62 20 74 6f 20 67 65 6e  able pTab to gen
7b60: 65 72 61 74 65 20 56 44 42 45 20 63 6f 64 65 20  erate VDBE code 
7b70: 74 6f 20 70 65 72 66 6f 72 6d 20 66 6f 72 65 69  to perform forei
7b80: 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e  gn key constrain
7b90: 74 20 0a 2a 2a 20 70 72 6f 63 65 73 73 69 6e 67  t .** processing
7ba0: 20 66 6f 72 20 74 68 65 20 6f 70 65 72 61 74 69   for the operati
7bb0: 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 20  on..**.** For a 
7bc0: 44 45 4c 45 54 45 20 6f 70 65 72 61 74 69 6f 6e  DELETE operation
7bd0: 2c 20 70 61 72 61 6d 65 74 65 72 20 72 65 67 4f  , parameter regO
7be0: 6c 64 20 69 73 20 70 61 73 73 65 64 20 74 68 65  ld is passed the
7bf0: 20 69 6e 64 65 78 20 6f 66 20 74 68 65 0a 2a 2a   index of the.**
7c00: 20 66 69 72 73 74 20 72 65 67 69 73 74 65 72 20   first register 
7c10: 69 6e 20 61 6e 20 61 72 72 61 79 20 6f 66 20 28  in an array of (
7c20: 70 54 61 62 2d 3e 6e 43 6f 6c 2b 31 29 20 72 65  pTab->nCol+1) re
7c30: 67 69 73 74 65 72 73 20 63 6f 6e 74 61 69 6e 69  gisters containi
7c40: 6e 67 20 74 68 65 0a 2a 2a 20 72 6f 77 69 64 20  ng the.** rowid 
7c50: 6f 66 20 74 68 65 20 72 6f 77 20 62 65 69 6e 67  of the row being
7c60: 20 64 65 6c 65 74 65 64 2c 20 66 6f 6c 6c 6f 77   deleted, follow
7c70: 65 64 20 62 79 20 65 61 63 68 20 6f 66 20 74 68  ed by each of th
7c80: 65 20 63 6f 6c 75 6d 6e 20 76 61 6c 75 65 73 0a  e column values.
7c90: 2a 2a 20 6f 66 20 74 68 65 20 72 6f 77 20 62 65  ** of the row be
7ca0: 69 6e 67 20 64 65 6c 65 74 65 64 2c 20 66 72 6f  ing deleted, fro
7cb0: 6d 20 6c 65 66 74 20 74 6f 20 72 69 67 68 74 2e  m left to right.
7cc0: 20 50 61 72 61 6d 65 74 65 72 20 72 65 67 4e 65   Parameter regNe
7cd0: 77 20 69 73 20 70 61 73 73 65 64 0a 2a 2a 20 7a  w is passed.** z
7ce0: 65 72 6f 20 69 6e 20 74 68 69 73 20 63 61 73 65  ero in this case
7cf0: 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 6e 20 49  ..**.** For an I
7d00: 4e 53 45 52 54 20 6f 70 65 72 61 74 69 6f 6e 2c  NSERT operation,
7d10: 20 72 65 67 4f 6c 64 20 69 73 20 70 61 73 73 65   regOld is passe
7d20: 64 20 7a 65 72 6f 20 61 6e 64 20 72 65 67 4e 65  d zero and regNe
7d30: 77 20 69 73 20 70 61 73 73 65 64 20 74 68 65 0a  w is passed the.
7d40: 2a 2a 20 66 69 72 73 74 20 72 65 67 69 73 74 65  ** first registe
7d50: 72 20 6f 66 20 61 6e 20 61 72 72 61 79 20 6f 66  r of an array of
7d60: 20 28 70 54 61 62 2d 3e 6e 43 6f 6c 2b 31 29 20   (pTab->nCol+1) 
7d70: 72 65 67 69 73 74 65 72 73 20 63 6f 6e 74 61 69  registers contai
7d80: 6e 69 6e 67 20 74 68 65 20 6e 65 77 0a 2a 2a 20  ning the new.** 
7d90: 72 6f 77 20 64 61 74 61 2e 0a 2a 2a 0a 2a 2a 20  row data..**.** 
7da0: 46 6f 72 20 61 6e 20 55 50 44 41 54 45 20 6f 70  For an UPDATE op
7db0: 65 72 61 74 69 6f 6e 2c 20 74 68 69 73 20 66 75  eration, this fu
7dc0: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64  nction is called
7dd0: 20 74 77 69 63 65 2e 20 4f 6e 63 65 20 62 65 66   twice. Once bef
7de0: 6f 72 65 0a 2a 2a 20 74 68 65 20 6f 72 69 67 69  ore.** the origi
7df0: 6e 61 6c 20 72 65 63 6f 72 64 20 69 73 20 64 65  nal record is de
7e00: 6c 65 74 65 64 20 66 72 6f 6d 20 74 68 65 20 74  leted from the t
7e10: 61 62 6c 65 20 75 73 69 6e 67 20 74 68 65 20 63  able using the c
7e20: 61 6c 6c 69 6e 67 20 63 6f 6e 76 65 6e 74 69 6f  alling conventio
7e30: 6e 0a 2a 2a 20 64 65 73 63 72 69 62 65 64 20 66  n.** described f
7e40: 6f 72 20 44 45 4c 45 54 45 2e 20 54 68 65 6e 20  or DELETE. Then 
7e50: 61 67 61 69 6e 20 61 66 74 65 72 20 74 68 65 20  again after the 
7e60: 6f 72 69 67 69 6e 61 6c 20 72 65 63 6f 72 64 20  original record 
7e70: 69 73 20 64 65 6c 65 74 65 64 0a 2a 2a 20 62 75  is deleted.** bu
7e80: 74 20 62 65 66 6f 72 65 20 74 68 65 20 6e 65 77  t before the new
7e90: 20 72 65 63 6f 72 64 20 69 73 20 69 6e 73 65 72   record is inser
7ea0: 74 65 64 20 75 73 69 6e 67 20 74 68 65 20 49 4e  ted using the IN
7eb0: 53 45 52 54 20 63 6f 6e 76 65 6e 74 69 6f 6e 2e  SERT convention.
7ec0: 20 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65   .*/.void sqlite
7ed0: 33 46 6b 43 68 65 63 6b 28 0a 20 20 50 61 72 73  3FkCheck(.  Pars
7ee0: 65 20 2a 70 50 61 72 73 65 2c 20 20 20 20 20 20  e *pParse,      
7ef0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50              /* P
7f00: 61 72 73 65 20 63 6f 6e 74 65 78 74 20 2a 2f 0a  arse context */.
7f10: 20 20 54 61 62 6c 65 20 2a 70 54 61 62 2c 20 20    Table *pTab,  
7f20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7f30: 20 20 2f 2a 20 52 6f 77 20 69 73 20 62 65 69 6e    /* Row is bein
7f40: 67 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 74  g deleted from t
7f50: 68 69 73 20 74 61 62 6c 65 20 2a 2f 20 0a 20 20  his table */ .  
7f60: 69 6e 74 20 72 65 67 4f 6c 64 2c 20 20 20 20 20  int regOld,     
7f70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7f80: 2f 2a 20 50 72 65 76 69 6f 75 73 20 72 6f 77 20  /* Previous row 
7f90: 64 61 74 61 20 69 73 20 73 74 6f 72 65 64 20 68  data is stored h
7fa0: 65 72 65 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67  ere */.  int reg
7fb0: 4e 65 77 2c 20 20 20 20 20 20 20 20 20 20 20 20  New,            
7fc0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 77 20           /* New 
7fd0: 72 6f 77 20 64 61 74 61 20 69 73 20 73 74 6f 72  row data is stor
7fe0: 65 64 20 68 65 72 65 20 2a 2f 0a 20 20 69 6e 74  ed here */.  int
7ff0: 20 2a 61 43 68 61 6e 67 65 2c 20 20 20 20 20 20   *aChange,      
8000: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
8010: 41 72 72 61 79 20 69 6e 64 69 63 61 74 69 6e 67  Array indicating
8020: 20 55 50 44 41 54 45 64 20 63 6f 6c 75 6d 6e 73   UPDATEd columns
8030: 20 28 6f 72 20 30 29 20 2a 2f 0a 20 20 69 6e 74   (or 0) */.  int
8040: 20 62 43 68 6e 67 52 6f 77 69 64 20 20 20 20 20   bChngRowid     
8050: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
8060: 54 72 75 65 20 69 66 20 72 6f 77 69 64 20 69 73  True if rowid is
8070: 20 55 50 44 41 54 45 64 20 2a 2f 0a 29 7b 0a 20   UPDATEd */.){. 
8080: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70   sqlite3 *db = p
8090: 50 61 72 73 65 2d 3e 64 62 3b 20 20 20 20 20 20  Parse->db;      
80a0: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e   /* Database han
80b0: 64 6c 65 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70  dle */.  FKey *p
80c0: 46 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 20  FKey;           
80d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65 64           /* Used
80e0: 20 74 6f 20 69 74 65 72 61 74 65 20 74 68 72 6f   to iterate thro
80f0: 75 67 68 20 46 4b 73 20 2a 2f 0a 20 20 69 6e 74  ugh FKs */.  int
8100: 20 69 44 62 3b 20 20 20 20 20 20 20 20 20 20 20   iDb;           
8110: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
8120: 49 6e 64 65 78 20 6f 66 20 64 61 74 61 62 61 73  Index of databas
8130: 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 70 54 61  e containing pTa
8140: 62 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61  b */.  const cha
8150: 72 20 2a 7a 44 62 3b 20 20 20 20 20 20 20 20 20  r *zDb;         
8160: 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f         /* Name o
8170: 66 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74 61  f database conta
8180: 69 6e 69 6e 67 20 70 54 61 62 20 2a 2f 0a 20 20  ining pTab */.  
8190: 69 6e 74 20 69 73 49 67 6e 6f 72 65 45 72 72 6f  int isIgnoreErro
81a0: 72 73 20 3d 20 70 50 61 72 73 65 2d 3e 64 69 73  rs = pParse->dis
81b0: 61 62 6c 65 54 72 69 67 67 65 72 73 3b 0a 0a 20  ableTriggers;.. 
81c0: 20 2f 2a 20 45 78 61 63 74 6c 79 20 6f 6e 65 20   /* Exactly one 
81d0: 6f 66 20 72 65 67 4f 6c 64 20 61 6e 64 20 72 65  of regOld and re
81e0: 67 4e 65 77 20 73 68 6f 75 6c 64 20 62 65 20 6e  gNew should be n
81f0: 6f 6e 2d 7a 65 72 6f 2e 20 2a 2f 0a 20 20 61 73  on-zero. */.  as
8200: 73 65 72 74 28 20 28 72 65 67 4f 6c 64 3d 3d 30  sert( (regOld==0
8210: 29 21 3d 28 72 65 67 4e 65 77 3d 3d 30 29 20 29  )!=(regNew==0) )
8220: 3b 0a 0a 20 20 2f 2a 20 49 66 20 66 6f 72 65 69  ;..  /* If forei
8230: 67 6e 2d 6b 65 79 73 20 61 72 65 20 64 69 73 61  gn-keys are disa
8240: 62 6c 65 64 2c 20 74 68 69 73 20 66 75 6e 63 74  bled, this funct
8250: 69 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 2e 20  ion is a no-op. 
8260: 2a 2f 0a 20 20 69 66 28 20 28 64 62 2d 3e 66 6c  */.  if( (db->fl
8270: 61 67 73 26 53 51 4c 49 54 45 5f 46 6f 72 65 69  ags&SQLITE_Forei
8280: 67 6e 4b 65 79 73 29 3d 3d 30 20 29 20 72 65 74  gnKeys)==0 ) ret
8290: 75 72 6e 3b 0a 0a 20 20 69 44 62 20 3d 20 73 71  urn;..  iDb = sq
82a0: 6c 69 74 65 33 53 63 68 65 6d 61 54 6f 49 6e 64  lite3SchemaToInd
82b0: 65 78 28 64 62 2c 20 70 54 61 62 2d 3e 70 53 63  ex(db, pTab->pSc
82c0: 68 65 6d 61 29 3b 0a 20 20 7a 44 62 20 3d 20 64  hema);.  zDb = d
82d0: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d  b->aDb[iDb].zNam
82e0: 65 3b 0a 0a 20 20 2f 2a 20 4c 6f 6f 70 20 74 68  e;..  /* Loop th
82f0: 72 6f 75 67 68 20 61 6c 6c 20 74 68 65 20 66 6f  rough all the fo
8300: 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72  reign key constr
8310: 61 69 6e 74 73 20 66 6f 72 20 77 68 69 63 68 20  aints for which 
8320: 70 54 61 62 20 69 73 20 74 68 65 0a 20 20 2a 2a  pTab is the.  **
8330: 20 63 68 69 6c 64 20 74 61 62 6c 65 20 28 74 68   child table (th
8340: 65 20 74 61 62 6c 65 20 74 68 61 74 20 74 68 65  e table that the
8350: 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 64 65 66   foreign key def
8360: 69 6e 69 74 69 6f 6e 20 69 73 20 70 61 72 74 20  inition is part 
8370: 6f 66 29 2e 20 20 2a 2f 0a 20 20 66 6f 72 28 70  of).  */.  for(p
8380: 46 4b 65 79 3d 70 54 61 62 2d 3e 70 46 4b 65 79  FKey=pTab->pFKey
8390: 3b 20 70 46 4b 65 79 3b 20 70 46 4b 65 79 3d 70  ; pFKey; pFKey=p
83a0: 46 4b 65 79 2d 3e 70 4e 65 78 74 46 72 6f 6d 29  FKey->pNextFrom)
83b0: 7b 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54 6f  {.    Table *pTo
83c0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
83d0: 20 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 74 61      /* Parent ta
83e0: 62 6c 65 20 6f 66 20 66 6f 72 65 69 67 6e 20 6b  ble of foreign k
83f0: 65 79 20 70 46 4b 65 79 20 2a 2f 0a 20 20 20 20  ey pFKey */.    
8400: 49 6e 64 65 78 20 2a 70 49 64 78 20 3d 20 30 3b  Index *pIdx = 0;
8410: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
8420: 20 49 6e 64 65 78 20 6f 6e 20 6b 65 79 20 63 6f   Index on key co
8430: 6c 75 6d 6e 73 20 69 6e 20 70 54 6f 20 2a 2f 0a  lumns in pTo */.
8440: 20 20 20 20 69 6e 74 20 2a 61 69 46 72 65 65 20      int *aiFree 
8450: 3d 20 30 3b 0a 20 20 20 20 69 6e 74 20 2a 61 69  = 0;.    int *ai
8460: 43 6f 6c 3b 0a 20 20 20 20 69 6e 74 20 69 43 6f  Col;.    int iCo
8470: 6c 3b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20  l;.    int i;.  
8480: 20 20 69 6e 74 20 69 73 49 67 6e 6f 72 65 20 3d    int isIgnore =
8490: 20 30 3b 0a 0a 20 20 20 20 69 66 28 20 61 43 68   0;..    if( aCh
84a0: 61 6e 67 65 20 0a 20 20 20 20 20 26 26 20 73 71  ange .     && sq
84b0: 6c 69 74 65 33 5f 73 74 72 69 63 6d 70 28 70 54  lite3_stricmp(pT
84c0: 61 62 2d 3e 7a 4e 61 6d 65 2c 20 70 46 4b 65 79  ab->zName, pFKey
84d0: 2d 3e 7a 54 6f 29 21 3d 30 0a 20 20 20 20 20 26  ->zTo)!=0.     &
84e0: 26 20 66 6b 43 68 69 6c 64 49 73 4d 6f 64 69 66  & fkChildIsModif
84f0: 69 65 64 28 70 54 61 62 2c 20 70 46 4b 65 79 2c  ied(pTab, pFKey,
8500: 20 61 43 68 61 6e 67 65 2c 20 62 43 68 6e 67 52   aChange, bChngR
8510: 6f 77 69 64 29 3d 3d 30 20 0a 20 20 20 20 29 7b  owid)==0 .    ){
8520: 0a 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b  .      continue;
8530: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 46  .    }..    /* F
8540: 69 6e 64 20 74 68 65 20 70 61 72 65 6e 74 20 74  ind the parent t
8550: 61 62 6c 65 20 6f 66 20 74 68 69 73 20 66 6f 72  able of this for
8560: 65 69 67 6e 20 6b 65 79 2e 20 41 6c 73 6f 20 66  eign key. Also f
8570: 69 6e 64 20 61 20 75 6e 69 71 75 65 20 69 6e 64  ind a unique ind
8580: 65 78 20 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 68  ex .    ** on th
8590: 65 20 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c  e parent key col
85a0: 75 6d 6e 73 20 69 6e 20 74 68 65 20 70 61 72 65  umns in the pare
85b0: 6e 74 20 74 61 62 6c 65 2e 20 49 66 20 65 69 74  nt table. If eit
85c0: 68 65 72 20 6f 66 20 74 68 65 73 65 20 0a 20 20  her of these .  
85d0: 20 20 2a 2a 20 73 63 68 65 6d 61 20 69 74 65 6d    ** schema item
85e0: 73 20 63 61 6e 6e 6f 74 20 62 65 20 6c 6f 63 61  s cannot be loca
85f0: 74 65 64 2c 20 73 65 74 20 61 6e 20 65 72 72 6f  ted, set an erro
8600: 72 20 69 6e 20 70 50 61 72 73 65 20 61 6e 64 20  r in pParse and 
8610: 72 65 74 75 72 6e 20 0a 20 20 20 20 2a 2a 20 65  return .    ** e
8620: 61 72 6c 79 2e 20 20 2a 2f 0a 20 20 20 20 69 66  arly.  */.    if
8630: 28 20 70 50 61 72 73 65 2d 3e 64 69 73 61 62 6c  ( pParse->disabl
8640: 65 54 72 69 67 67 65 72 73 20 29 7b 0a 20 20 20  eTriggers ){.   
8650: 20 20 20 70 54 6f 20 3d 20 73 71 6c 69 74 65 33     pTo = sqlite3
8660: 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 70 46  FindTable(db, pF
8670: 4b 65 79 2d 3e 7a 54 6f 2c 20 7a 44 62 29 3b 0a  Key->zTo, zDb);.
8680: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
8690: 20 70 54 6f 20 3d 20 73 71 6c 69 74 65 33 4c 6f   pTo = sqlite3Lo
86a0: 63 61 74 65 54 61 62 6c 65 28 70 50 61 72 73 65  cateTable(pParse
86b0: 2c 20 30 2c 20 70 46 4b 65 79 2d 3e 7a 54 6f 2c  , 0, pFKey->zTo,
86c0: 20 7a 44 62 29 3b 0a 20 20 20 20 7d 0a 20 20 20   zDb);.    }.   
86d0: 20 69 66 28 20 21 70 54 6f 20 7c 7c 20 73 71 6c   if( !pTo || sql
86e0: 69 74 65 33 46 6b 4c 6f 63 61 74 65 49 6e 64 65  ite3FkLocateInde
86f0: 78 28 70 50 61 72 73 65 2c 20 70 54 6f 2c 20 70  x(pParse, pTo, p
8700: 46 4b 65 79 2c 20 26 70 49 64 78 2c 20 26 61 69  FKey, &pIdx, &ai
8710: 46 72 65 65 29 20 29 7b 0a 20 20 20 20 20 20 61  Free) ){.      a
8720: 73 73 65 72 74 28 20 69 73 49 67 6e 6f 72 65 45  ssert( isIgnoreE
8730: 72 72 6f 72 73 3d 3d 30 20 7c 7c 20 28 72 65 67  rrors==0 || (reg
8740: 4f 6c 64 21 3d 30 20 26 26 20 72 65 67 4e 65 77  Old!=0 && regNew
8750: 3d 3d 30 29 20 29 3b 0a 20 20 20 20 20 20 69 66  ==0) );.      if
8760: 28 20 21 69 73 49 67 6e 6f 72 65 45 72 72 6f 72  ( !isIgnoreError
8770: 73 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46  s || db->mallocF
8780: 61 69 6c 65 64 20 29 20 72 65 74 75 72 6e 3b 0a  ailed ) return;.
8790: 20 20 20 20 20 20 69 66 28 20 70 54 6f 3d 3d 30        if( pTo==0
87a0: 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49   ){.        /* I
87b0: 66 20 69 73 49 67 6e 6f 72 65 45 72 72 6f 72 73  f isIgnoreErrors
87c0: 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 61   is true, then a
87d0: 20 74 61 62 6c 65 20 69 73 20 62 65 69 6e 67 20   table is being 
87e0: 64 72 6f 70 70 65 64 2e 20 49 6e 20 74 68 69 73  dropped. In this
87f0: 0a 20 20 20 20 20 20 20 20 2a 2a 20 63 61 73 65  .        ** case
8800: 20 53 51 4c 69 74 65 20 72 75 6e 73 20 61 20 22   SQLite runs a "
8810: 44 45 4c 45 54 45 20 46 52 4f 4d 20 78 78 78 22  DELETE FROM xxx"
8820: 20 6f 6e 20 74 68 65 20 74 61 62 6c 65 20 62 65   on the table be
8830: 69 6e 67 20 64 72 6f 70 70 65 64 0a 20 20 20 20  ing dropped.    
8840: 20 20 20 20 2a 2a 20 62 65 66 6f 72 65 20 61 63      ** before ac
8850: 74 75 61 6c 6c 79 20 64 72 6f 70 70 69 6e 67 20  tually dropping 
8860: 69 74 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 63  it in order to c
8870: 68 65 63 6b 20 46 4b 20 63 6f 6e 73 74 72 61 69  heck FK constrai
8880: 6e 74 73 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20  nts..        ** 
8890: 49 66 20 74 68 65 20 70 61 72 65 6e 74 20 74 61  If the parent ta
88a0: 62 6c 65 20 6f 66 20 61 6e 20 46 4b 20 63 6f 6e  ble of an FK con
88b0: 73 74 72 61 69 6e 74 20 6f 6e 20 74 68 65 20 63  straint on the c
88c0: 75 72 72 65 6e 74 20 74 61 62 6c 65 20 69 73 0a  urrent table is.
88d0: 20 20 20 20 20 20 20 20 2a 2a 20 6d 69 73 73 69          ** missi
88e0: 6e 67 2c 20 62 65 68 61 76 65 20 61 73 20 69 66  ng, behave as if
88f0: 20 69 74 20 69 73 20 65 6d 70 74 79 2e 20 69 2e   it is empty. i.
8900: 65 2e 20 64 65 63 72 65 6d 65 6e 74 20 74 68 65  e. decrement the
8910: 20 72 65 6c 65 76 61 6e 74 0a 20 20 20 20 20 20   relevant.      
8920: 20 20 2a 2a 20 46 4b 20 63 6f 75 6e 74 65 72 20    ** FK counter 
8930: 66 6f 72 20 65 61 63 68 20 72 6f 77 20 6f 66 20  for each row of 
8940: 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 62 6c  the current tabl
8950: 65 20 77 69 74 68 20 6e 6f 6e 2d 4e 55 4c 4c 20  e with non-NULL 
8960: 6b 65 79 73 2e 0a 20 20 20 20 20 20 20 20 2a 2f  keys..        */
8970: 0a 20 20 20 20 20 20 20 20 56 64 62 65 20 2a 76  .        Vdbe *v
8980: 20 3d 20 73 71 6c 69 74 65 33 47 65 74 56 64 62   = sqlite3GetVdb
8990: 65 28 70 50 61 72 73 65 29 3b 0a 20 20 20 20 20  e(pParse);.     
89a0: 20 20 20 69 6e 74 20 69 4a 75 6d 70 20 3d 20 73     int iJump = s
89b0: 71 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 6e  qlite3VdbeCurren
89c0: 74 41 64 64 72 28 76 29 20 2b 20 70 46 4b 65 79  tAddr(v) + pFKey
89d0: 2d 3e 6e 43 6f 6c 20 2b 20 31 3b 0a 20 20 20 20  ->nCol + 1;.    
89e0: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
89f0: 46 4b 65 79 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29  FKey->nCol; i++)
8a00: 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74 20  {.          int 
8a10: 69 52 65 67 20 3d 20 70 46 4b 65 79 2d 3e 61 43  iReg = pFKey->aC
8a20: 6f 6c 5b 69 5d 2e 69 46 72 6f 6d 20 2b 20 72 65  ol[i].iFrom + re
8a30: 67 4f 6c 64 20 2b 20 31 3b 0a 20 20 20 20 20 20  gOld + 1;.      
8a40: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41      sqlite3VdbeA
8a50: 64 64 4f 70 32 28 76 2c 20 4f 50 5f 49 73 4e 75  ddOp2(v, OP_IsNu
8a60: 6c 6c 2c 20 69 52 65 67 2c 20 69 4a 75 6d 70 29  ll, iReg, iJump)
8a70: 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20  ;.        }.    
8a80: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41      sqlite3VdbeA
8a90: 64 64 4f 70 32 28 76 2c 20 4f 50 5f 46 6b 43 6f  ddOp2(v, OP_FkCo
8aa0: 75 6e 74 65 72 2c 20 70 46 4b 65 79 2d 3e 69 73  unter, pFKey->is
8ab0: 44 65 66 65 72 72 65 64 2c 20 2d 31 29 3b 0a 20  Deferred, -1);. 
8ac0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 6f 6e       }.      con
8ad0: 74 69 6e 75 65 3b 0a 20 20 20 20 7d 0a 20 20 20  tinue;.    }.   
8ae0: 20 61 73 73 65 72 74 28 20 70 46 4b 65 79 2d 3e   assert( pFKey->
8af0: 6e 43 6f 6c 3d 3d 31 20 7c 7c 20 28 61 69 46 72  nCol==1 || (aiFr
8b00: 65 65 20 26 26 20 70 49 64 78 29 20 29 3b 0a 0a  ee && pIdx) );..
8b10: 20 20 20 20 69 66 28 20 61 69 46 72 65 65 20 29      if( aiFree )
8b20: 7b 0a 20 20 20 20 20 20 61 69 43 6f 6c 20 3d 20  {.      aiCol = 
8b30: 61 69 46 72 65 65 3b 0a 20 20 20 20 7d 65 6c 73  aiFree;.    }els
8b40: 65 7b 0a 20 20 20 20 20 20 69 43 6f 6c 20 3d 20  e{.      iCol = 
8b50: 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 30 5d 2e 69  pFKey->aCol[0].i
8b60: 46 72 6f 6d 3b 0a 20 20 20 20 20 20 61 69 43 6f  From;.      aiCo
8b70: 6c 20 3d 20 26 69 43 6f 6c 3b 0a 20 20 20 20 7d  l = &iCol;.    }
8b80: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
8b90: 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b  pFKey->nCol; i++
8ba0: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 61 69 43  ){.      if( aiC
8bb0: 6f 6c 5b 69 5d 3d 3d 70 54 61 62 2d 3e 69 50 4b  ol[i]==pTab->iPK
8bc0: 65 79 20 29 7b 0a 20 20 20 20 20 20 20 20 61 69  ey ){.        ai
8bd0: 43 6f 6c 5b 69 5d 20 3d 20 2d 31 3b 0a 20 20 20  Col[i] = -1;.   
8be0: 20 20 20 7d 0a 23 69 66 6e 64 65 66 20 53 51 4c     }.#ifndef SQL
8bf0: 49 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49  ITE_OMIT_AUTHORI
8c00: 5a 41 54 49 4f 4e 0a 20 20 20 20 20 20 2f 2a 20  ZATION.      /* 
8c10: 52 65 71 75 65 73 74 20 70 65 72 6d 69 73 73 69  Request permissi
8c20: 6f 6e 20 74 6f 20 72 65 61 64 20 74 68 65 20 70  on to read the p
8c30: 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e  arent key column
8c40: 73 2e 20 49 66 20 74 68 65 20 0a 20 20 20 20 20  s. If the .     
8c50: 20 2a 2a 20 61 75 74 68 6f 72 69 7a 61 74 69 6f   ** authorizatio
8c60: 6e 20 63 61 6c 6c 62 61 63 6b 20 72 65 74 75 72  n callback retur
8c70: 6e 73 20 53 51 4c 49 54 45 5f 49 47 4e 4f 52 45  ns SQLITE_IGNORE
8c80: 2c 20 62 65 68 61 76 65 20 61 73 20 69 66 20 61  , behave as if a
8c90: 6e 79 0a 20 20 20 20 20 20 2a 2a 20 76 61 6c 75  ny.      ** valu
8ca0: 65 73 20 72 65 61 64 20 66 72 6f 6d 20 74 68 65  es read from the
8cb0: 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 61 72   parent table ar
8cc0: 65 20 4e 55 4c 4c 2e 20 2a 2f 0a 20 20 20 20 20  e NULL. */.     
8cd0: 20 69 66 28 20 64 62 2d 3e 78 41 75 74 68 20 29   if( db->xAuth )
8ce0: 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 72 63  {.        int rc
8cf0: 61 75 74 68 3b 0a 20 20 20 20 20 20 20 20 63 68  auth;.        ch
8d00: 61 72 20 2a 7a 43 6f 6c 20 3d 20 70 54 6f 2d 3e  ar *zCol = pTo->
8d10: 61 43 6f 6c 5b 70 49 64 78 20 3f 20 70 49 64 78  aCol[pIdx ? pIdx
8d20: 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 69 5d 20 3a 20  ->aiColumn[i] : 
8d30: 70 54 6f 2d 3e 69 50 4b 65 79 5d 2e 7a 4e 61 6d  pTo->iPKey].zNam
8d40: 65 3b 0a 20 20 20 20 20 20 20 20 72 63 61 75 74  e;.        rcaut
8d50: 68 20 3d 20 73 71 6c 69 74 65 33 41 75 74 68 52  h = sqlite3AuthR
8d60: 65 61 64 43 6f 6c 28 70 50 61 72 73 65 2c 20 70  eadCol(pParse, p
8d70: 54 6f 2d 3e 7a 4e 61 6d 65 2c 20 7a 43 6f 6c 2c  To->zName, zCol,
8d80: 20 69 44 62 29 3b 0a 20 20 20 20 20 20 20 20 69   iDb);.        i
8d90: 73 49 67 6e 6f 72 65 20 3d 20 28 72 63 61 75 74  sIgnore = (rcaut
8da0: 68 3d 3d 53 51 4c 49 54 45 5f 49 47 4e 4f 52 45  h==SQLITE_IGNORE
8db0: 29 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 69  );.      }.#endi
8dc0: 66 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20  f.    }..    /* 
8dd0: 54 61 6b 65 20 61 20 73 68 61 72 65 64 2d 63 61  Take a shared-ca
8de0: 63 68 65 20 61 64 76 69 73 6f 72 79 20 72 65 61  che advisory rea
8df0: 64 2d 6c 6f 63 6b 20 6f 6e 20 74 68 65 20 70 61  d-lock on the pa
8e00: 72 65 6e 74 20 74 61 62 6c 65 2e 20 41 6c 6c 6f  rent table. Allo
8e10: 63 61 74 65 20 0a 20 20 20 20 2a 2a 20 61 20 63  cate .    ** a c
8e20: 75 72 73 6f 72 20 74 6f 20 75 73 65 20 74 6f 20  ursor to use to 
8e30: 73 65 61 72 63 68 20 74 68 65 20 75 6e 69 71 75  search the uniqu
8e40: 65 20 69 6e 64 65 78 20 6f 6e 20 74 68 65 20 70  e index on the p
8e50: 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e  arent key column
8e60: 73 20 0a 20 20 20 20 2a 2a 20 69 6e 20 74 68 65  s .    ** in the
8e70: 20 70 61 72 65 6e 74 20 74 61 62 6c 65 2e 20 20   parent table.  
8e80: 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 54 61  */.    sqlite3Ta
8e90: 62 6c 65 4c 6f 63 6b 28 70 50 61 72 73 65 2c 20  bleLock(pParse, 
8ea0: 69 44 62 2c 20 70 54 6f 2d 3e 74 6e 75 6d 2c 20  iDb, pTo->tnum, 
8eb0: 30 2c 20 70 54 6f 2d 3e 7a 4e 61 6d 65 29 3b 0a  0, pTo->zName);.
8ec0: 20 20 20 20 70 50 61 72 73 65 2d 3e 6e 54 61 62      pParse->nTab
8ed0: 2b 2b 3b 0a 0a 20 20 20 20 69 66 28 20 72 65 67  ++;..    if( reg
8ee0: 4f 6c 64 21 3d 30 20 29 7b 0a 20 20 20 20 20 20  Old!=0 ){.      
8ef0: 2f 2a 20 41 20 72 6f 77 20 69 73 20 62 65 69 6e  /* A row is bein
8f00: 67 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74  g removed from t
8f10: 68 65 20 63 68 69 6c 64 20 74 61 62 6c 65 2e 20  he child table. 
8f20: 53 65 61 72 63 68 20 66 6f 72 20 74 68 65 20 70  Search for the p
8f30: 61 72 65 6e 74 2e 0a 20 20 20 20 20 20 2a 2a 20  arent..      ** 
8f40: 49 66 20 74 68 65 20 70 61 72 65 6e 74 20 64 6f  If the parent do
8f50: 65 73 20 6e 6f 74 20 65 78 69 73 74 2c 20 72 65  es not exist, re
8f60: 6d 6f 76 69 6e 67 20 74 68 65 20 63 68 69 6c 64  moving the child
8f70: 20 72 6f 77 20 72 65 73 6f 6c 76 65 73 20 61 6e   row resolves an
8f80: 20 0a 20 20 20 20 20 20 2a 2a 20 6f 75 74 73 74   .      ** outst
8f90: 61 6e 64 69 6e 67 20 66 6f 72 65 69 67 6e 20 6b  anding foreign k
8fa0: 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69  ey constraint vi
8fb0: 6f 6c 61 74 69 6f 6e 2e 20 2a 2f 0a 20 20 20 20  olation. */.    
8fc0: 20 20 66 6b 4c 6f 6f 6b 75 70 50 61 72 65 6e 74    fkLookupParent
8fd0: 28 70 50 61 72 73 65 2c 20 69 44 62 2c 20 70 54  (pParse, iDb, pT
8fe0: 6f 2c 20 70 49 64 78 2c 20 70 46 4b 65 79 2c 20  o, pIdx, pFKey, 
8ff0: 61 69 43 6f 6c 2c 20 72 65 67 4f 6c 64 2c 20 2d  aiCol, regOld, -
9000: 31 2c 69 73 49 67 6e 6f 72 65 29 3b 0a 20 20 20  1,isIgnore);.   
9010: 20 7d 0a 20 20 20 20 69 66 28 20 72 65 67 4e 65   }.    if( regNe
9020: 77 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a  w!=0 ){.      /*
9030: 20 41 20 72 6f 77 20 69 73 20 62 65 69 6e 67 20   A row is being 
9040: 61 64 64 65 64 20 74 6f 20 74 68 65 20 63 68 69  added to the chi
9050: 6c 64 20 74 61 62 6c 65 2e 20 49 66 20 61 20 70  ld table. If a p
9060: 61 72 65 6e 74 20 72 6f 77 20 63 61 6e 6e 6f 74  arent row cannot
9070: 0a 20 20 20 20 20 20 2a 2a 20 62 65 20 66 6f 75  .      ** be fou
9080: 6e 64 2c 20 61 64 64 69 6e 67 20 74 68 65 20 63  nd, adding the c
9090: 68 69 6c 64 20 72 6f 77 20 68 61 73 20 76 69 6f  hild row has vio
90a0: 6c 61 74 65 64 20 74 68 65 20 46 4b 20 63 6f 6e  lated the FK con
90b0: 73 74 72 61 69 6e 74 2e 20 2a 2f 20 0a 20 20 20  straint. */ .   
90c0: 20 20 20 66 6b 4c 6f 6f 6b 75 70 50 61 72 65 6e     fkLookupParen
90d0: 74 28 70 50 61 72 73 65 2c 20 69 44 62 2c 20 70  t(pParse, iDb, p
90e0: 54 6f 2c 20 70 49 64 78 2c 20 70 46 4b 65 79 2c  To, pIdx, pFKey,
90f0: 20 61 69 43 6f 6c 2c 20 72 65 67 4e 65 77 2c 20   aiCol, regNew, 
9100: 2b 31 2c 69 73 49 67 6e 6f 72 65 29 3b 0a 20 20  +1,isIgnore);.  
9110: 20 20 7d 0a 0a 20 20 20 20 73 71 6c 69 74 65 33    }..    sqlite3
9120: 44 62 46 72 65 65 28 64 62 2c 20 61 69 46 72 65  DbFree(db, aiFre
9130: 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4c 6f  e);.  }..  /* Lo
9140: 6f 70 20 74 68 72 6f 75 67 68 20 61 6c 6c 20 74  op through all t
9150: 68 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63  he foreign key c
9160: 6f 6e 73 74 72 61 69 6e 74 73 20 74 68 61 74 20  onstraints that 
9170: 72 65 66 65 72 20 74 6f 20 74 68 69 73 20 74 61  refer to this ta
9180: 62 6c 65 20 2a 2f 0a 20 20 66 6f 72 28 70 46 4b  ble */.  for(pFK
9190: 65 79 20 3d 20 73 71 6c 69 74 65 33 46 6b 52 65  ey = sqlite3FkRe
91a0: 66 65 72 65 6e 63 65 73 28 70 54 61 62 29 3b 20  ferences(pTab); 
91b0: 70 46 4b 65 79 3b 20 70 46 4b 65 79 3d 70 46 4b  pFKey; pFKey=pFK
91c0: 65 79 2d 3e 70 4e 65 78 74 54 6f 29 7b 0a 20 20  ey->pNextTo){.  
91d0: 20 20 49 6e 64 65 78 20 2a 70 49 64 78 20 3d 20    Index *pIdx = 
91e0: 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0;              
91f0: 2f 2a 20 46 6f 72 65 69 67 6e 20 6b 65 79 20 69  /* Foreign key i
9200: 6e 64 65 78 20 66 6f 72 20 70 46 4b 65 79 20 2a  ndex for pFKey *
9210: 2f 0a 20 20 20 20 53 72 63 4c 69 73 74 20 2a 70  /.    SrcList *p
9220: 53 72 63 3b 0a 20 20 20 20 69 6e 74 20 2a 61 69  Src;.    int *ai
9230: 43 6f 6c 20 3d 20 30 3b 0a 0a 20 20 20 20 69 66  Col = 0;..    if
9240: 28 20 61 43 68 61 6e 67 65 20 26 26 20 66 6b 50  ( aChange && fkP
9250: 61 72 65 6e 74 49 73 4d 6f 64 69 66 69 65 64 28  arentIsModified(
9260: 70 54 61 62 2c 20 70 46 4b 65 79 2c 20 61 43 68  pTab, pFKey, aCh
9270: 61 6e 67 65 2c 20 62 43 68 6e 67 52 6f 77 69 64  ange, bChngRowid
9280: 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 63 6f  )==0 ){.      co
9290: 6e 74 69 6e 75 65 3b 0a 20 20 20 20 7d 0a 0a 20  ntinue;.    }.. 
92a0: 20 20 20 69 66 28 20 21 70 46 4b 65 79 2d 3e 69     if( !pFKey->i
92b0: 73 44 65 66 65 72 72 65 64 20 26 26 20 21 28 64  sDeferred && !(d
92c0: 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54  b->flags & SQLIT
92d0: 45 5f 44 65 66 65 72 46 4b 73 29 20 0a 20 20 20  E_DeferFKs) .   
92e0: 20 20 26 26 20 21 70 50 61 72 73 65 2d 3e 70 54    && !pParse->pT
92f0: 6f 70 6c 65 76 65 6c 20 26 26 20 21 70 50 61 72  oplevel && !pPar
9300: 73 65 2d 3e 69 73 4d 75 6c 74 69 57 72 69 74 65  se->isMultiWrite
9310: 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 61   .    ){.      a
9320: 73 73 65 72 74 28 20 72 65 67 4f 6c 64 3d 3d 30  ssert( regOld==0
9330: 20 26 26 20 72 65 67 4e 65 77 21 3d 30 20 29 3b   && regNew!=0 );
9340: 0a 20 20 20 20 20 20 2f 2a 20 49 6e 73 65 72 74  .      /* Insert
9350: 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 72 6f 77  ing a single row
9360: 20 69 6e 74 6f 20 61 20 70 61 72 65 6e 74 20 74   into a parent t
9370: 61 62 6c 65 20 63 61 6e 6e 6f 74 20 63 61 75 73  able cannot caus
9380: 65 20 61 6e 20 69 6d 6d 65 64 69 61 74 65 0a 20  e an immediate. 
9390: 20 20 20 20 20 2a 2a 20 66 6f 72 65 69 67 6e 20       ** foreign 
93a0: 6b 65 79 20 76 69 6f 6c 61 74 69 6f 6e 2e 20 53  key violation. S
93b0: 6f 20 64 6f 20 6e 6f 74 68 69 6e 67 20 69 6e 20  o do nothing in 
93c0: 74 68 69 73 20 63 61 73 65 2e 20 20 2a 2f 0a 20  this case.  */. 
93d0: 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20       continue;. 
93e0: 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20 73 71     }..    if( sq
93f0: 6c 69 74 65 33 46 6b 4c 6f 63 61 74 65 49 6e 64  lite3FkLocateInd
9400: 65 78 28 70 50 61 72 73 65 2c 20 70 54 61 62 2c  ex(pParse, pTab,
9410: 20 70 46 4b 65 79 2c 20 26 70 49 64 78 2c 20 26   pFKey, &pIdx, &
9420: 61 69 43 6f 6c 29 20 29 7b 0a 20 20 20 20 20 20  aiCol) ){.      
9430: 69 66 28 20 21 69 73 49 67 6e 6f 72 65 45 72 72  if( !isIgnoreErr
9440: 6f 72 73 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f  ors || db->mallo
9450: 63 46 61 69 6c 65 64 20 29 20 72 65 74 75 72 6e  cFailed ) return
9460: 3b 0a 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65  ;.      continue
9470: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65  ;.    }.    asse
9480: 72 74 28 20 61 69 43 6f 6c 20 7c 7c 20 70 46 4b  rt( aiCol || pFK
9490: 65 79 2d 3e 6e 43 6f 6c 3d 3d 31 20 29 3b 0a 0a  ey->nCol==1 );..
94a0: 20 20 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20      /* Create a 
94b0: 53 72 63 4c 69 73 74 20 73 74 72 75 63 74 75 72  SrcList structur
94c0: 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 73  e containing a s
94d0: 69 6e 67 6c 65 20 74 61 62 6c 65 20 28 74 68 65  ingle table (the
94e0: 20 74 61 62 6c 65 20 0a 20 20 20 20 2a 2a 20 74   table .    ** t
94f0: 68 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 74  he foreign key t
9500: 68 61 74 20 72 65 66 65 72 73 20 74 6f 20 74 68  hat refers to th
9510: 69 73 20 74 61 62 6c 65 20 69 73 20 61 74 74 61  is table is atta
9520: 63 68 65 64 20 74 6f 29 2e 20 54 68 69 73 0a 20  ched to). This. 
9530: 20 20 20 2a 2a 20 69 73 20 72 65 71 75 69 72 65     ** is require
9540: 64 20 66 6f 72 20 74 68 65 20 73 71 6c 69 74 65  d for the sqlite
9550: 33 57 68 65 72 65 58 58 58 28 29 20 69 6e 74 65  3WhereXXX() inte
9560: 72 66 61 63 65 2e 20 20 2a 2f 0a 20 20 20 20 70  rface.  */.    p
9570: 53 72 63 20 3d 20 73 71 6c 69 74 65 33 53 72 63  Src = sqlite3Src
9580: 4c 69 73 74 41 70 70 65 6e 64 28 64 62 2c 20 30  ListAppend(db, 0
9590: 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 69 66 28  , 0, 0);.    if(
95a0: 20 70 53 72 63 20 29 7b 0a 20 20 20 20 20 20 73   pSrc ){.      s
95b0: 74 72 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74  truct SrcList_it
95c0: 65 6d 20 2a 70 49 74 65 6d 20 3d 20 70 53 72 63  em *pItem = pSrc
95d0: 2d 3e 61 3b 0a 20 20 20 20 20 20 70 49 74 65 6d  ->a;.      pItem
95e0: 2d 3e 70 54 61 62 20 3d 20 70 46 4b 65 79 2d 3e  ->pTab = pFKey->
95f0: 70 46 72 6f 6d 3b 0a 20 20 20 20 20 20 70 49 74  pFrom;.      pIt
9600: 65 6d 2d 3e 7a 4e 61 6d 65 20 3d 20 70 46 4b 65  em->zName = pFKe
9610: 79 2d 3e 70 46 72 6f 6d 2d 3e 7a 4e 61 6d 65 3b  y->pFrom->zName;
9620: 0a 20 20 20 20 20 20 70 49 74 65 6d 2d 3e 70 54  .      pItem->pT
9630: 61 62 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 20  ab->nRef++;.    
9640: 20 20 70 49 74 65 6d 2d 3e 69 43 75 72 73 6f 72    pItem->iCursor
9650: 20 3d 20 70 50 61 72 73 65 2d 3e 6e 54 61 62 2b   = pParse->nTab+
9660: 2b 3b 0a 20 20 0a 20 20 20 20 20 20 69 66 28 20  +;.  .      if( 
9670: 72 65 67 4e 65 77 21 3d 30 20 29 7b 0a 20 20 20  regNew!=0 ){.   
9680: 20 20 20 20 20 66 6b 53 63 61 6e 43 68 69 6c 64       fkScanChild
9690: 72 65 6e 28 70 50 61 72 73 65 2c 20 70 53 72 63  ren(pParse, pSrc
96a0: 2c 20 70 54 61 62 2c 20 70 49 64 78 2c 20 70 46  , pTab, pIdx, pF
96b0: 4b 65 79 2c 20 61 69 43 6f 6c 2c 20 72 65 67 4e  Key, aiCol, regN
96c0: 65 77 2c 20 2d 31 29 3b 0a 20 20 20 20 20 20 7d  ew, -1);.      }
96d0: 0a 20 20 20 20 20 20 69 66 28 20 72 65 67 4f 6c  .      if( regOl
96e0: 64 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20  d!=0 ){.        
96f0: 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 61  /* If there is a
9700: 20 52 45 53 54 52 49 43 54 20 61 63 74 69 6f 6e   RESTRICT action
9710: 20 63 6f 6e 66 69 67 75 72 65 64 20 66 6f 72 20   configured for 
9720: 74 68 65 20 63 75 72 72 65 6e 74 20 6f 70 65 72  the current oper
9730: 61 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 2a 2a  ation.        **
9740: 20 6f 6e 20 74 68 65 20 70 61 72 65 6e 74 20 74   on the parent t
9750: 61 62 6c 65 20 6f 66 20 74 68 69 73 20 46 4b 2c  able of this FK,
9760: 20 74 68 65 6e 20 74 68 72 6f 77 20 61 6e 20 65   then throw an e
9770: 78 63 65 70 74 69 6f 6e 20 0a 20 20 20 20 20 20  xception .      
9780: 20 20 2a 2a 20 69 6d 6d 65 64 69 61 74 65 6c 79    ** immediately
9790: 20 69 66 20 74 68 65 20 46 4b 20 63 6f 6e 73 74   if the FK const
97a0: 72 61 69 6e 74 20 69 73 20 76 69 6f 6c 61 74 65  raint is violate
97b0: 64 2c 20 65 76 65 6e 20 69 66 20 74 68 69 73 20  d, even if this 
97c0: 69 73 20 61 0a 20 20 20 20 20 20 20 20 2a 2a 20  is a.        ** 
97d0: 64 65 66 65 72 72 65 64 20 74 72 69 67 67 65 72  deferred trigger
97e0: 2e 20 54 68 61 74 27 73 20 77 68 61 74 20 52 45  . That's what RE
97f0: 53 54 52 49 43 54 20 6d 65 61 6e 73 2e 20 54 6f  STRICT means. To
9800: 20 64 65 66 65 72 20 63 68 65 63 6b 69 6e 67 0a   defer checking.
9810: 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 63          ** the c
9820: 6f 6e 73 74 72 61 69 6e 74 2c 20 74 68 65 20 46  onstraint, the F
9830: 4b 20 73 68 6f 75 6c 64 20 73 70 65 63 69 66 79  K should specify
9840: 20 4e 4f 20 41 43 54 49 4f 4e 20 28 72 65 70 72   NO ACTION (repr
9850: 65 73 65 6e 74 65 64 0a 20 20 20 20 20 20 20 20  esented.        
9860: 2a 2a 20 75 73 69 6e 67 20 4f 45 5f 4e 6f 6e 65  ** using OE_None
9870: 29 2e 20 4e 4f 20 41 43 54 49 4f 4e 20 69 73 20  ). NO ACTION is 
9880: 74 68 65 20 64 65 66 61 75 6c 74 2e 20 20 2a 2f  the default.  */
9890: 0a 20 20 20 20 20 20 20 20 66 6b 53 63 61 6e 43  .        fkScanC
98a0: 68 69 6c 64 72 65 6e 28 70 50 61 72 73 65 2c 20  hildren(pParse, 
98b0: 70 53 72 63 2c 20 70 54 61 62 2c 20 70 49 64 78  pSrc, pTab, pIdx
98c0: 2c 20 70 46 4b 65 79 2c 20 61 69 43 6f 6c 2c 20  , pFKey, aiCol, 
98d0: 72 65 67 4f 6c 64 2c 20 31 29 3b 0a 20 20 20 20  regOld, 1);.    
98e0: 20 20 7d 0a 20 20 20 20 20 20 70 49 74 65 6d 2d    }.      pItem-
98f0: 3e 7a 4e 61 6d 65 20 3d 20 30 3b 0a 20 20 20 20  >zName = 0;.    
9900: 20 20 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74    sqlite3SrcList
9910: 44 65 6c 65 74 65 28 64 62 2c 20 70 53 72 63 29  Delete(db, pSrc)
9920: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  ;.    }.    sqli
9930: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 61 69  te3DbFree(db, ai
9940: 43 6f 6c 29 3b 0a 20 20 7d 0a 7d 0a 0a 23 64 65  Col);.  }.}..#de
9950: 66 69 6e 65 20 43 4f 4c 55 4d 4e 5f 4d 41 53 4b  fine COLUMN_MASK
9960: 28 78 29 20 28 28 28 78 29 3e 33 31 29 20 3f 20  (x) (((x)>31) ? 
9970: 30 78 66 66 66 66 66 66 66 66 20 3a 20 28 28 75  0xffffffff : ((u
9980: 33 32 29 31 3c 3c 28 78 29 29 29 0a 0a 2f 2a 0a  32)1<<(x)))../*.
9990: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
99a0: 20 69 73 20 63 61 6c 6c 65 64 20 62 65 66 6f 72   is called befor
99b0: 65 20 67 65 6e 65 72 61 74 69 6e 67 20 63 6f 64  e generating cod
99c0: 65 20 74 6f 20 75 70 64 61 74 65 20 6f 72 20 64  e to update or d
99d0: 65 6c 65 74 65 20 61 20 0a 2a 2a 20 72 6f 77 20  elete a .** row 
99e0: 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 74 61 62  contained in tab
99f0: 6c 65 20 70 54 61 62 2e 0a 2a 2f 0a 75 33 32 20  le pTab..*/.u32 
9a00: 73 71 6c 69 74 65 33 46 6b 4f 6c 64 6d 61 73 6b  sqlite3FkOldmask
9a10: 28 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73  (.  Parse *pPars
9a20: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e,              
9a30: 20 20 20 20 2f 2a 20 50 61 72 73 65 20 63 6f 6e      /* Parse con
9a40: 74 65 78 74 20 2a 2f 0a 20 20 54 61 62 6c 65 20  text */.  Table 
9a50: 2a 70 54 61 62 20 20 20 20 20 20 20 20 20 20 20  *pTab           
9a60: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 62            /* Tab
9a70: 6c 65 20 62 65 69 6e 67 20 6d 6f 64 69 66 69 65  le being modifie
9a80: 64 20 2a 2f 0a 29 7b 0a 20 20 75 33 32 20 6d 61  d */.){.  u32 ma
9a90: 73 6b 20 3d 20 30 3b 0a 20 20 69 66 28 20 70 50  sk = 0;.  if( pP
9aa0: 61 72 73 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 26  arse->db->flags&
9ab0: 53 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65  SQLITE_ForeignKe
9ac0: 79 73 20 29 7b 0a 20 20 20 20 46 4b 65 79 20 2a  ys ){.    FKey *
9ad0: 70 3b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20  p;.    int i;.  
9ae0: 20 20 66 6f 72 28 70 3d 70 54 61 62 2d 3e 70 46    for(p=pTab->pF
9af0: 4b 65 79 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65  Key; p; p=p->pNe
9b00: 78 74 46 72 6f 6d 29 7b 0a 20 20 20 20 20 20 66  xtFrom){.      f
9b10: 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 43 6f  or(i=0; i<p->nCo
9b20: 6c 3b 20 69 2b 2b 29 20 6d 61 73 6b 20 7c 3d 20  l; i++) mask |= 
9b30: 43 4f 4c 55 4d 4e 5f 4d 41 53 4b 28 70 2d 3e 61  COLUMN_MASK(p->a
9b40: 43 6f 6c 5b 69 5d 2e 69 46 72 6f 6d 29 3b 0a 20  Col[i].iFrom);. 
9b50: 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 70 3d 73     }.    for(p=s
9b60: 71 6c 69 74 65 33 46 6b 52 65 66 65 72 65 6e 63  qlite3FkReferenc
9b70: 65 73 28 70 54 61 62 29 3b 20 70 3b 20 70 3d 70  es(pTab); p; p=p
9b80: 2d 3e 70 4e 65 78 74 54 6f 29 7b 0a 20 20 20 20  ->pNextTo){.    
9b90: 20 20 49 6e 64 65 78 20 2a 70 49 64 78 20 3d 20    Index *pIdx = 
9ba0: 30 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  0;.      sqlite3
9bb0: 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78 28 70 50  FkLocateIndex(pP
9bc0: 61 72 73 65 2c 20 70 54 61 62 2c 20 70 2c 20 26  arse, pTab, p, &
9bd0: 70 49 64 78 2c 20 30 29 3b 0a 20 20 20 20 20 20  pIdx, 0);.      
9be0: 69 66 28 20 70 49 64 78 20 29 7b 0a 20 20 20 20  if( pIdx ){.    
9bf0: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
9c00: 49 64 78 2d 3e 6e 4b 65 79 43 6f 6c 3b 20 69 2b  Idx->nKeyCol; i+
9c10: 2b 29 20 6d 61 73 6b 20 7c 3d 20 43 4f 4c 55 4d  +) mask |= COLUM
9c20: 4e 5f 4d 41 53 4b 28 70 49 64 78 2d 3e 61 69 43  N_MASK(pIdx->aiC
9c30: 6f 6c 75 6d 6e 5b 69 5d 29 3b 0a 20 20 20 20 20  olumn[i]);.     
9c40: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72   }.    }.  }.  r
9c50: 65 74 75 72 6e 20 6d 61 73 6b 3b 0a 7d 0a 0a 0a  eturn mask;.}...
9c60: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
9c70: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 62 65  ion is called be
9c80: 66 6f 72 65 20 67 65 6e 65 72 61 74 69 6e 67 20  fore generating 
9c90: 63 6f 64 65 20 74 6f 20 75 70 64 61 74 65 20 6f  code to update o
9ca0: 72 20 64 65 6c 65 74 65 20 61 20 0a 2a 2a 20 72  r delete a .** r
9cb0: 6f 77 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20  ow contained in 
9cc0: 74 61 62 6c 65 20 70 54 61 62 2e 20 49 66 20 74  table pTab. If t
9cd0: 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 73 20  he operation is 
9ce0: 61 20 44 45 4c 45 54 45 2c 20 74 68 65 6e 0a 2a  a DELETE, then.*
9cf0: 2a 20 70 61 72 61 6d 65 74 65 72 20 61 43 68 61  * parameter aCha
9d00: 6e 67 65 20 69 73 20 70 61 73 73 65 64 20 61 20  nge is passed a 
9d10: 4e 55 4c 4c 20 76 61 6c 75 65 2e 20 46 6f 72 20  NULL value. For 
9d20: 61 6e 20 55 50 44 41 54 45 2c 20 61 43 68 61 6e  an UPDATE, aChan
9d30: 67 65 20 70 6f 69 6e 74 73 0a 2a 2a 20 74 6f 20  ge points.** to 
9d40: 61 6e 20 61 72 72 61 79 20 6f 66 20 73 69 7a 65  an array of size
9d50: 20 4e 2c 20 77 68 65 72 65 20 4e 20 69 73 20 74   N, where N is t
9d60: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c  he number of col
9d70: 75 6d 6e 73 20 69 6e 20 74 61 62 6c 65 20 70 54  umns in table pT
9d80: 61 62 2e 0a 2a 2a 20 49 66 20 74 68 65 20 69 27  ab..** If the i'
9d90: 74 68 20 63 6f 6c 75 6d 6e 20 69 73 20 6e 6f 74  th column is not
9da0: 20 6d 6f 64 69 66 69 65 64 20 62 79 20 74 68 65   modified by the
9db0: 20 55 50 44 41 54 45 2c 20 74 68 65 6e 20 74 68   UPDATE, then th
9dc0: 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20  e corresponding 
9dd0: 0a 2a 2a 20 65 6e 74 72 79 20 69 6e 20 74 68 65  .** entry in the
9de0: 20 61 43 68 61 6e 67 65 5b 5d 20 61 72 72 61 79   aChange[] array
9df0: 20 69 73 20 73 65 74 20 74 6f 20 2d 31 2e 20 49   is set to -1. I
9e00: 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 69 73 20  f the column is 
9e10: 6d 6f 64 69 66 69 65 64 2c 0a 2a 2a 20 74 68 65  modified,.** the
9e20: 20 76 61 6c 75 65 20 69 73 20 30 20 6f 72 20 67   value is 0 or g
9e30: 72 65 61 74 65 72 2e 20 50 61 72 61 6d 65 74 65  reater. Paramete
9e40: 72 20 63 68 6e 67 52 6f 77 69 64 20 69 73 20 73  r chngRowid is s
9e50: 65 74 20 74 6f 20 74 72 75 65 20 69 66 20 74 68  et to true if th
9e60: 65 0a 2a 2a 20 55 50 44 41 54 45 20 73 74 61 74  e.** UPDATE stat
9e70: 65 6d 65 6e 74 20 6d 6f 64 69 66 69 65 73 20 74  ement modifies t
9e80: 68 65 20 72 6f 77 69 64 20 66 69 65 6c 64 73 20  he rowid fields 
9e90: 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 0a 2a 2a  of the table..**
9ea0: 0a 2a 2a 20 49 66 20 61 6e 79 20 66 6f 72 65 69  .** If any forei
9eb0: 67 6e 20 6b 65 79 20 70 72 6f 63 65 73 73 69 6e  gn key processin
9ec0: 67 20 77 69 6c 6c 20 62 65 20 72 65 71 75 69 72  g will be requir
9ed0: 65 64 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f  ed, this functio
9ee0: 6e 20 72 65 74 75 72 6e 73 0a 2a 2a 20 74 72 75  n returns.** tru
9ef0: 65 2e 20 49 66 20 74 68 65 72 65 20 69 73 20 6e  e. If there is n
9f00: 6f 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 72 65  o foreign key re
9f10: 6c 61 74 65 64 20 70 72 6f 63 65 73 73 69 6e 67  lated processing
9f20: 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  , this function 
9f30: 0a 2a 2a 20 72 65 74 75 72 6e 73 20 66 61 6c 73  .** returns fals
9f40: 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  e..*/.int sqlite
9f50: 33 46 6b 52 65 71 75 69 72 65 64 28 0a 20 20 50  3FkRequired(.  P
9f60: 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 20 20  arse *pParse,   
9f70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
9f80: 2a 20 50 61 72 73 65 20 63 6f 6e 74 65 78 74 20  * Parse context 
9f90: 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62  */.  Table *pTab
9fa0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
9fb0: 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 62 65       /* Table be
9fc0: 69 6e 67 20 6d 6f 64 69 66 69 65 64 20 2a 2f 0a  ing modified */.
9fd0: 20 20 69 6e 74 20 2a 61 43 68 61 6e 67 65 2c 20    int *aChange, 
9fe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9ff0: 20 20 2f 2a 20 4e 6f 6e 2d 4e 55 4c 4c 20 66 6f    /* Non-NULL fo
a000: 72 20 55 50 44 41 54 45 20 6f 70 65 72 61 74 69  r UPDATE operati
a010: 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 63 68 6e  ons */.  int chn
a020: 67 52 6f 77 69 64 20 20 20 20 20 20 20 20 20 20  gRowid          
a030: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65           /* True
a040: 20 66 6f 72 20 55 50 44 41 54 45 20 74 68 61 74   for UPDATE that
a050: 20 61 66 66 65 63 74 73 20 72 6f 77 69 64 20 2a   affects rowid *
a060: 2f 0a 29 7b 0a 20 20 69 66 28 20 70 50 61 72 73  /.){.  if( pPars
a070: 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c  e->db->flags&SQL
a080: 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73 20  ITE_ForeignKeys 
a090: 29 7b 0a 20 20 20 20 69 66 28 20 21 61 43 68 61  ){.    if( !aCha
a0a0: 6e 67 65 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20  nge ){.      /* 
a0b0: 41 20 44 45 4c 45 54 45 20 6f 70 65 72 61 74 69  A DELETE operati
a0c0: 6f 6e 2e 20 46 6f 72 65 69 67 6e 20 6b 65 79 20  on. Foreign key 
a0d0: 70 72 6f 63 65 73 73 69 6e 67 20 69 73 20 72 65  processing is re
a0e0: 71 75 69 72 65 64 20 69 66 20 74 68 65 20 0a 20  quired if the . 
a0f0: 20 20 20 20 20 2a 2a 20 74 61 62 6c 65 20 69 6e       ** table in
a100: 20 71 75 65 73 74 69 6f 6e 20 69 73 20 65 69 74   question is eit
a110: 68 65 72 20 74 68 65 20 63 68 69 6c 64 20 6f 72  her the child or
a120: 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 66 6f   parent table fo
a130: 72 20 61 6e 79 20 0a 20 20 20 20 20 20 2a 2a 20  r any .      ** 
a140: 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73  foreign key cons
a150: 74 72 61 69 6e 74 2e 20 20 2a 2f 0a 20 20 20 20  traint.  */.    
a160: 20 20 72 65 74 75 72 6e 20 28 73 71 6c 69 74 65    return (sqlite
a170: 33 46 6b 52 65 66 65 72 65 6e 63 65 73 28 70 54  3FkReferences(pT
a180: 61 62 29 20 7c 7c 20 70 54 61 62 2d 3e 70 46 4b  ab) || pTab->pFK
a190: 65 79 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  ey);.    }else{.
a1a0: 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 69 73        /* This is
a1b0: 20 61 6e 20 55 50 44 41 54 45 2e 20 46 6f 72 65   an UPDATE. Fore
a1c0: 69 67 6e 20 6b 65 79 20 70 72 6f 63 65 73 73 69  ign key processi
a1d0: 6e 67 20 69 73 20 6f 6e 6c 79 20 72 65 71 75 69  ng is only requi
a1e0: 72 65 64 20 69 66 20 74 68 65 0a 20 20 20 20 20  red if the.     
a1f0: 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20 6d 6f   ** operation mo
a200: 64 69 66 69 65 73 20 6f 6e 65 20 6f 72 20 6d 6f  difies one or mo
a210: 72 65 20 63 68 69 6c 64 20 6f 72 20 70 61 72 65  re child or pare
a220: 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 2e 20  nt key columns. 
a230: 2a 2f 0a 20 20 20 20 20 20 46 4b 65 79 20 2a 70  */.      FKey *p
a240: 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 43 68 65 63  ;..      /* Chec
a250: 6b 20 69 66 20 61 6e 79 20 63 68 69 6c 64 20 6b  k if any child k
a260: 65 79 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 62  ey columns are b
a270: 65 69 6e 67 20 6d 6f 64 69 66 69 65 64 2e 20 2a  eing modified. *
a280: 2f 0a 20 20 20 20 20 20 66 6f 72 28 70 3d 70 54  /.      for(p=pT
a290: 61 62 2d 3e 70 46 4b 65 79 3b 20 70 3b 20 70 3d  ab->pFKey; p; p=
a2a0: 70 2d 3e 70 4e 65 78 74 46 72 6f 6d 29 7b 0a 20  p->pNextFrom){. 
a2b0: 20 20 20 20 20 20 20 69 66 28 20 66 6b 43 68 69         if( fkChi
a2c0: 6c 64 49 73 4d 6f 64 69 66 69 65 64 28 70 54 61  ldIsModified(pTa
a2d0: 62 2c 20 70 2c 20 61 43 68 61 6e 67 65 2c 20 63  b, p, aChange, c
a2e0: 68 6e 67 52 6f 77 69 64 29 20 29 20 72 65 74 75  hngRowid) ) retu
a2f0: 72 6e 20 31 3b 0a 20 20 20 20 20 20 7d 0a 0a 20  rn 1;.      }.. 
a300: 20 20 20 20 20 2f 2a 20 43 68 65 63 6b 20 69 66       /* Check if
a310: 20 61 6e 79 20 70 61 72 65 6e 74 20 6b 65 79 20   any parent key 
a320: 63 6f 6c 75 6d 6e 73 20 61 72 65 20 62 65 69 6e  columns are bein
a330: 67 20 6d 6f 64 69 66 69 65 64 2e 20 2a 2f 0a 20  g modified. */. 
a340: 20 20 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74       for(p=sqlit
a350: 65 33 46 6b 52 65 66 65 72 65 6e 63 65 73 28 70  e3FkReferences(p
a360: 54 61 62 29 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e  Tab); p; p=p->pN
a370: 65 78 74 54 6f 29 7b 0a 20 20 20 20 20 20 20 20  extTo){.        
a380: 69 66 28 20 66 6b 50 61 72 65 6e 74 49 73 4d 6f  if( fkParentIsMo
a390: 64 69 66 69 65 64 28 70 54 61 62 2c 20 70 2c 20  dified(pTab, p, 
a3a0: 61 43 68 61 6e 67 65 2c 20 63 68 6e 67 52 6f 77  aChange, chngRow
a3b0: 69 64 29 20 29 20 72 65 74 75 72 6e 20 31 3b 0a  id) ) return 1;.
a3c0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
a3d0: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  }.  return 0;.}.
a3e0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
a3f0: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77  tion is called w
a400: 68 65 6e 20 61 6e 20 55 50 44 41 54 45 20 6f 72  hen an UPDATE or
a410: 20 44 45 4c 45 54 45 20 6f 70 65 72 61 74 69 6f   DELETE operatio
a420: 6e 20 69 73 20 62 65 69 6e 67 20 0a 2a 2a 20 63  n is being .** c
a430: 6f 6d 70 69 6c 65 64 20 6f 6e 20 74 61 62 6c 65  ompiled on table
a440: 20 70 54 61 62 2c 20 77 68 69 63 68 20 69 73 20   pTab, which is 
a450: 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65  the parent table
a460: 20 6f 66 20 66 6f 72 65 69 67 6e 2d 6b 65 79 20   of foreign-key 
a470: 70 46 4b 65 79 2e 0a 2a 2a 20 49 66 20 74 68 65  pFKey..** If the
a480: 20 63 75 72 72 65 6e 74 20 6f 70 65 72 61 74 69   current operati
a490: 6f 6e 20 69 73 20 61 6e 20 55 50 44 41 54 45 2c  on is an UPDATE,
a4a0: 20 74 68 65 6e 20 74 68 65 20 70 43 68 61 6e 67   then the pChang
a4b0: 65 73 20 70 61 72 61 6d 65 74 65 72 20 69 73 0a  es parameter is.
a4c0: 2a 2a 20 70 61 73 73 65 64 20 61 20 70 6f 69 6e  ** passed a poin
a4d0: 74 65 72 20 74 6f 20 74 68 65 20 6c 69 73 74 20  ter to the list 
a4e0: 6f 66 20 63 6f 6c 75 6d 6e 73 20 62 65 69 6e 67  of columns being
a4f0: 20 6d 6f 64 69 66 69 65 64 2e 20 49 66 20 69 74   modified. If it
a500: 20 69 73 20 61 0a 2a 2a 20 44 45 4c 45 54 45 2c   is a.** DELETE,
a510: 20 70 43 68 61 6e 67 65 73 20 69 73 20 70 61 73   pChanges is pas
a520: 73 65 64 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74  sed a NULL point
a530: 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 72 65 74  er..**.** It ret
a540: 75 72 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 74  urns a pointer t
a550: 6f 20 61 20 54 72 69 67 67 65 72 20 73 74 72 75  o a Trigger stru
a560: 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 69 6e 67  cture containing
a570: 20 61 20 74 72 69 67 67 65 72 0a 2a 2a 20 65 71   a trigger.** eq
a580: 75 69 76 61 6c 65 6e 74 20 74 6f 20 74 68 65 20  uivalent to the 
a590: 4f 4e 20 55 50 44 41 54 45 20 6f 72 20 4f 4e 20  ON UPDATE or ON 
a5a0: 44 45 4c 45 54 45 20 61 63 74 69 6f 6e 20 73 70  DELETE action sp
a5b0: 65 63 69 66 69 65 64 20 62 79 20 70 46 4b 65 79  ecified by pFKey
a5c0: 2e 0a 2a 2a 20 49 66 20 74 68 65 20 61 63 74 69  ..** If the acti
a5d0: 6f 6e 20 69 73 20 22 4e 4f 20 41 43 54 49 4f 4e  on is "NO ACTION
a5e0: 22 20 6f 72 20 22 52 45 53 54 52 49 43 54 22 2c  " or "RESTRICT",
a5f0: 20 74 68 65 6e 20 61 20 4e 55 4c 4c 20 70 6f 69   then a NULL poi
a600: 6e 74 65 72 20 69 73 0a 2a 2a 20 72 65 74 75 72  nter is.** retur
a610: 6e 65 64 20 28 74 68 65 73 65 20 61 63 74 69 6f  ned (these actio
a620: 6e 73 20 72 65 71 75 69 72 65 20 6e 6f 20 73 70  ns require no sp
a630: 65 63 69 61 6c 20 68 61 6e 64 6c 69 6e 67 20 62  ecial handling b
a640: 79 20 74 68 65 20 74 72 69 67 67 65 72 73 0a 2a  y the triggers.*
a650: 2a 20 73 75 62 2d 73 79 73 74 65 6d 2c 20 63 6f  * sub-system, co
a660: 64 65 20 66 6f 72 20 74 68 65 6d 20 69 73 20 63  de for them is c
a670: 72 65 61 74 65 64 20 62 79 20 66 6b 53 63 61 6e  reated by fkScan
a680: 43 68 69 6c 64 72 65 6e 28 29 29 2e 0a 2a 2a 0a  Children())..**.
a690: 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20  ** For example, 
a6a0: 69 66 20 70 46 4b 65 79 20 69 73 20 74 68 65 20  if pFKey is the 
a6b0: 66 6f 72 65 69 67 6e 20 6b 65 79 20 61 6e 64 20  foreign key and 
a6c0: 70 54 61 62 20 69 73 20 74 61 62 6c 65 20 22 70  pTab is table "p
a6d0: 22 20 69 6e 20 0a 2a 2a 20 74 68 65 20 66 6f 6c  " in .** the fol
a6e0: 6c 6f 77 69 6e 67 20 73 63 68 65 6d 61 3a 0a 2a  lowing schema:.*
a6f0: 2a 0a 2a 2a 20 20 20 43 52 45 41 54 45 20 54 41  *.**   CREATE TA
a700: 42 4c 45 20 70 28 70 6b 20 50 52 49 4d 41 52 59  BLE p(pk PRIMARY
a710: 20 4b 45 59 29 3b 0a 2a 2a 20 20 20 43 52 45 41   KEY);.**   CREA
a720: 54 45 20 54 41 42 4c 45 20 63 28 63 6b 20 52 45  TE TABLE c(ck RE
a730: 46 45 52 45 4e 43 45 53 20 70 20 4f 4e 20 44 45  FERENCES p ON DE
a740: 4c 45 54 45 20 43 41 53 43 41 44 45 29 3b 0a 2a  LETE CASCADE);.*
a750: 2a 0a 2a 2a 20 74 68 65 6e 20 74 68 65 20 72 65  *.** then the re
a760: 74 75 72 6e 65 64 20 74 72 69 67 67 65 72 20 73  turned trigger s
a770: 74 72 75 63 74 75 72 65 20 69 73 20 65 71 75 69  tructure is equi
a780: 76 61 6c 65 6e 74 20 74 6f 3a 0a 2a 2a 0a 2a 2a  valent to:.**.**
a790: 20 20 20 43 52 45 41 54 45 20 54 52 49 47 47 45     CREATE TRIGGE
a7a0: 52 20 2e 2e 2e 20 44 45 4c 45 54 45 20 4f 4e 20  R ... DELETE ON 
a7b0: 70 20 42 45 47 49 4e 0a 2a 2a 20 20 20 20 20 44  p BEGIN.**     D
a7c0: 45 4c 45 54 45 20 46 52 4f 4d 20 63 20 57 48 45  ELETE FROM c WHE
a7d0: 52 45 20 63 6b 20 3d 20 6f 6c 64 2e 70 6b 3b 0a  RE ck = old.pk;.
a7e0: 2a 2a 20 20 20 45 4e 44 3b 0a 2a 2a 0a 2a 2a 20  **   END;.**.** 
a7f0: 54 68 65 20 72 65 74 75 72 6e 65 64 20 70 6f 69  The returned poi
a800: 6e 74 65 72 20 69 73 20 63 61 63 68 65 64 20 61  nter is cached a
a810: 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 66 6f  s part of the fo
a820: 72 65 69 67 6e 20 6b 65 79 20 6f 62 6a 65 63 74  reign key object
a830: 2e 20 49 74 0a 2a 2a 20 69 73 20 65 76 65 6e 74  . It.** is event
a840: 75 61 6c 6c 79 20 66 72 65 65 64 20 61 6c 6f 6e  ually freed alon
a850: 67 20 77 69 74 68 20 74 68 65 20 72 65 73 74 20  g with the rest 
a860: 6f 66 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b  of the foreign k
a870: 65 79 20 6f 62 6a 65 63 74 20 62 79 20 0a 2a 2a  ey object by .**
a880: 20 73 71 6c 69 74 65 33 46 6b 44 65 6c 65 74 65   sqlite3FkDelete
a890: 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 54 72  ()..*/.static Tr
a8a0: 69 67 67 65 72 20 2a 66 6b 41 63 74 69 6f 6e 54  igger *fkActionT
a8b0: 72 69 67 67 65 72 28 0a 20 20 50 61 72 73 65 20  rigger(.  Parse 
a8c0: 2a 70 50 61 72 73 65 2c 20 20 20 20 20 20 20 20  *pParse,        
a8d0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72            /* Par
a8e0: 73 65 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20  se context */.  
a8f0: 54 61 62 6c 65 20 2a 70 54 61 62 2c 20 20 20 20  Table *pTab,    
a900: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a910: 2f 2a 20 54 61 62 6c 65 20 62 65 69 6e 67 20 75  /* Table being u
a920: 70 64 61 74 65 64 20 6f 72 20 64 65 6c 65 74 65  pdated or delete
a930: 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 46 4b 65 79  d from */.  FKey
a940: 20 2a 70 46 4b 65 79 2c 20 20 20 20 20 20 20 20   *pFKey,        
a950: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46              /* F
a960: 6f 72 65 69 67 6e 20 6b 65 79 20 74 6f 20 67 65  oreign key to ge
a970: 74 20 61 63 74 69 6f 6e 20 66 6f 72 20 2a 2f 0a  t action for */.
a980: 20 20 45 78 70 72 4c 69 73 74 20 2a 70 43 68 61    ExprList *pCha
a990: 6e 67 65 73 20 20 20 20 20 20 20 20 20 20 20 20  nges            
a9a0: 20 20 2f 2a 20 43 68 61 6e 67 65 2d 6c 69 73 74    /* Change-list
a9b0: 20 66 6f 72 20 55 50 44 41 54 45 2c 20 4e 55 4c   for UPDATE, NUL
a9c0: 4c 20 66 6f 72 20 44 45 4c 45 54 45 20 2a 2f 0a  L for DELETE */.
a9d0: 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  ){.  sqlite3 *db
a9e0: 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 20 20   = pParse->db;  
a9f0: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
aa00: 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e 74   handle */.  int
aa10: 20 61 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 20   action;        
aa20: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
aa30: 4f 6e 65 20 6f 66 20 4f 45 5f 4e 6f 6e 65 2c 20  One of OE_None, 
aa40: 4f 45 5f 43 61 73 63 61 64 65 20 65 74 63 2e 20  OE_Cascade etc. 
aa50: 2a 2f 0a 20 20 54 72 69 67 67 65 72 20 2a 70 54  */.  Trigger *pT
aa60: 72 69 67 67 65 72 3b 20 20 20 20 20 20 20 20 20  rigger;         
aa70: 20 20 20 20 20 2f 2a 20 54 72 69 67 67 65 72 20       /* Trigger 
aa80: 64 65 66 69 6e 69 74 69 6f 6e 20 74 6f 20 72 65  definition to re
aa90: 74 75 72 6e 20 2a 2f 0a 20 20 69 6e 74 20 69 41  turn */.  int iA
aaa0: 63 74 69 6f 6e 20 3d 20 28 70 43 68 61 6e 67 65  ction = (pChange
aab0: 73 21 3d 30 29 3b 20 20 20 20 2f 2a 20 31 20 66  s!=0);    /* 1 f
aac0: 6f 72 20 55 50 44 41 54 45 2c 20 30 20 66 6f 72  or UPDATE, 0 for
aad0: 20 44 45 4c 45 54 45 20 2a 2f 0a 0a 20 20 61 63   DELETE */..  ac
aae0: 74 69 6f 6e 20 3d 20 70 46 4b 65 79 2d 3e 61 41  tion = pFKey->aA
aaf0: 63 74 69 6f 6e 5b 69 41 63 74 69 6f 6e 5d 3b 0a  ction[iAction];.
ab00: 20 20 70 54 72 69 67 67 65 72 20 3d 20 70 46 4b    pTrigger = pFK
ab10: 65 79 2d 3e 61 70 54 72 69 67 67 65 72 5b 69 41  ey->apTrigger[iA
ab20: 63 74 69 6f 6e 5d 3b 0a 0a 20 20 69 66 28 20 61  ction];..  if( a
ab30: 63 74 69 6f 6e 21 3d 4f 45 5f 4e 6f 6e 65 20 26  ction!=OE_None &
ab40: 26 20 21 70 54 72 69 67 67 65 72 20 29 7b 0a 20  & !pTrigger ){. 
ab50: 20 20 20 75 38 20 65 6e 61 62 6c 65 4c 6f 6f 6b     u8 enableLook
ab60: 61 73 69 64 65 3b 20 20 20 20 20 20 20 20 20 20  aside;          
ab70: 20 2f 2a 20 43 6f 70 79 20 6f 66 20 64 62 2d 3e   /* Copy of db->
ab80: 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c  lookaside.bEnabl
ab90: 65 64 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 63  ed */.    char c
aba0: 6f 6e 73 74 20 2a 7a 46 72 6f 6d 3b 20 20 20 20  onst *zFrom;    
abb0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20          /* Name 
abc0: 6f 66 20 63 68 69 6c 64 20 74 61 62 6c 65 20 2a  of child table *
abd0: 2f 0a 20 20 20 20 69 6e 74 20 6e 46 72 6f 6d 3b  /.    int nFrom;
abe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
abf0: 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 69 6e      /* Length in
ac00: 20 62 79 74 65 73 20 6f 66 20 7a 46 72 6f 6d 20   bytes of zFrom 
ac10: 2a 2f 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 49  */.    Index *pI
ac20: 64 78 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20  dx = 0;         
ac30: 20 20 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 6b       /* Parent k
ac40: 65 79 20 69 6e 64 65 78 20 66 6f 72 20 74 68 69  ey index for thi
ac50: 73 20 46 4b 20 2a 2f 0a 20 20 20 20 69 6e 74 20  s FK */.    int 
ac60: 2a 61 69 43 6f 6c 20 3d 20 30 3b 20 20 20 20 20  *aiCol = 0;     
ac70: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 63 68 69            /* chi
ac80: 6c 64 20 74 61 62 6c 65 20 63 6f 6c 73 20 2d 3e  ld table cols ->
ac90: 20 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 73   parent key cols
aca0: 20 2a 2f 0a 20 20 20 20 54 72 69 67 67 65 72 53   */.    TriggerS
acb0: 74 65 70 20 2a 70 53 74 65 70 20 3d 20 30 3b 20  tep *pStep = 0; 
acc0: 20 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20         /* First 
acd0: 28 6f 6e 6c 79 29 20 73 74 65 70 20 6f 66 20 74  (only) step of t
ace0: 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d 20 2a  rigger program *
acf0: 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 57 68 65  /.    Expr *pWhe
ad00: 72 65 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20  re = 0;         
ad10: 20 20 20 20 2f 2a 20 57 48 45 52 45 20 63 6c 61      /* WHERE cla
ad20: 75 73 65 20 6f 66 20 74 72 69 67 67 65 72 20 73  use of trigger s
ad30: 74 65 70 20 2a 2f 0a 20 20 20 20 45 78 70 72 4c  tep */.    ExprL
ad40: 69 73 74 20 2a 70 4c 69 73 74 20 3d 20 30 3b 20  ist *pList = 0; 
ad50: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 68 61 6e           /* Chan
ad60: 67 65 73 20 6c 69 73 74 20 69 66 20 4f 4e 20 55  ges list if ON U
ad70: 50 44 41 54 45 20 43 41 53 43 41 44 45 20 2a 2f  PDATE CASCADE */
ad80: 0a 20 20 20 20 53 65 6c 65 63 74 20 2a 70 53 65  .    Select *pSe
ad90: 6c 65 63 74 20 3d 20 30 3b 20 20 20 20 20 20 20  lect = 0;       
ada0: 20 20 20 2f 2a 20 49 66 20 52 45 53 54 52 49 43     /* If RESTRIC
adb0: 54 2c 20 22 53 45 4c 45 43 54 20 52 41 49 53 45  T, "SELECT RAISE
adc0: 28 2e 2e 2e 29 22 20 2a 2f 0a 20 20 20 20 69 6e  (...)" */.    in
add0: 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20  t i;            
ade0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49              /* I
adf0: 74 65 72 61 74 6f 72 20 76 61 72 69 61 62 6c 65  terator variable
ae00: 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 57   */.    Expr *pW
ae10: 68 65 6e 20 3d 20 30 3b 20 20 20 20 20 20 20 20  hen = 0;        
ae20: 20 20 20 20 20 20 2f 2a 20 57 48 45 4e 20 63 6c        /* WHEN cl
ae30: 61 75 73 65 20 66 6f 72 20 74 68 65 20 74 72 69  ause for the tri
ae40: 67 67 65 72 20 2a 2f 0a 0a 20 20 20 20 69 66 28  gger */..    if(
ae50: 20 73 71 6c 69 74 65 33 46 6b 4c 6f 63 61 74 65   sqlite3FkLocate
ae60: 49 6e 64 65 78 28 70 50 61 72 73 65 2c 20 70 54  Index(pParse, pT
ae70: 61 62 2c 20 70 46 4b 65 79 2c 20 26 70 49 64 78  ab, pFKey, &pIdx
ae80: 2c 20 26 61 69 43 6f 6c 29 20 29 20 72 65 74 75  , &aiCol) ) retu
ae90: 72 6e 20 30 3b 0a 20 20 20 20 61 73 73 65 72 74  rn 0;.    assert
aea0: 28 20 61 69 43 6f 6c 20 7c 7c 20 70 46 4b 65 79  ( aiCol || pFKey
aeb0: 2d 3e 6e 43 6f 6c 3d 3d 31 20 29 3b 0a 0a 20 20  ->nCol==1 );..  
aec0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 46 4b    for(i=0; i<pFK
aed0: 65 79 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a  ey->nCol; i++){.
aee0: 20 20 20 20 20 20 54 6f 6b 65 6e 20 74 4f 6c 64        Token tOld
aef0: 20 3d 20 7b 20 22 6f 6c 64 22 2c 20 33 20 7d 3b   = { "old", 3 };
af00: 20 20 2f 2a 20 4c 69 74 65 72 61 6c 20 22 6f 6c    /* Literal "ol
af10: 64 22 20 74 6f 6b 65 6e 20 2a 2f 0a 20 20 20 20  d" token */.    
af20: 20 20 54 6f 6b 65 6e 20 74 4e 65 77 20 3d 20 7b    Token tNew = {
af30: 20 22 6e 65 77 22 2c 20 33 20 7d 3b 20 20 2f 2a   "new", 3 };  /*
af40: 20 4c 69 74 65 72 61 6c 20 22 6e 65 77 22 20 74   Literal "new" t
af50: 6f 6b 65 6e 20 2a 2f 0a 20 20 20 20 20 20 54 6f  oken */.      To
af60: 6b 65 6e 20 74 46 72 6f 6d 43 6f 6c 3b 20 20 20  ken tFromCol;   
af70: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d            /* Nam
af80: 65 20 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e 20 63  e of column in c
af90: 68 69 6c 64 20 74 61 62 6c 65 20 2a 2f 0a 20 20  hild table */.  
afa0: 20 20 20 20 54 6f 6b 65 6e 20 74 54 6f 43 6f 6c      Token tToCol
afb0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
afc0: 2f 2a 20 4e 61 6d 65 20 6f 66 20 63 6f 6c 75 6d  /* Name of colum
afd0: 6e 20 69 6e 20 70 61 72 65 6e 74 20 74 61 62 6c  n in parent tabl
afe0: 65 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 69  e */.      int i
aff0: 46 72 6f 6d 43 6f 6c 3b 20 20 20 20 20 20 20 20  FromCol;        
b000: 20 20 20 20 20 20 20 2f 2a 20 49 64 78 20 6f 66         /* Idx of
b010: 20 63 6f 6c 75 6d 6e 20 69 6e 20 63 68 69 6c 64   column in child
b020: 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 20 20   table */.      
b030: 45 78 70 72 20 2a 70 45 71 3b 20 20 20 20 20 20  Expr *pEq;      
b040: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 74              /* t
b050: 46 72 6f 6d 43 6f 6c 20 3d 20 4f 4c 44 2e 74 54  FromCol = OLD.tT
b060: 6f 43 6f 6c 20 2a 2f 0a 0a 20 20 20 20 20 20 69  oCol */..      i
b070: 46 72 6f 6d 43 6f 6c 20 3d 20 61 69 43 6f 6c 20  FromCol = aiCol 
b080: 3f 20 61 69 43 6f 6c 5b 69 5d 20 3a 20 70 46 4b  ? aiCol[i] : pFK
b090: 65 79 2d 3e 61 43 6f 6c 5b 30 5d 2e 69 46 72 6f  ey->aCol[0].iFro
b0a0: 6d 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28  m;.      assert(
b0b0: 20 69 46 72 6f 6d 43 6f 6c 3e 3d 30 20 29 3b 0a   iFromCol>=0 );.
b0c0: 20 20 20 20 20 20 74 54 6f 43 6f 6c 2e 7a 20 3d        tToCol.z =
b0d0: 20 70 49 64 78 20 3f 20 70 54 61 62 2d 3e 61 43   pIdx ? pTab->aC
b0e0: 6f 6c 5b 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d  ol[pIdx->aiColum
b0f0: 6e 5b 69 5d 5d 2e 7a 4e 61 6d 65 20 3a 20 22 6f  n[i]].zName : "o
b100: 69 64 22 3b 0a 20 20 20 20 20 20 74 46 72 6f 6d  id";.      tFrom
b110: 43 6f 6c 2e 7a 20 3d 20 70 46 4b 65 79 2d 3e 70  Col.z = pFKey->p
b120: 46 72 6f 6d 2d 3e 61 43 6f 6c 5b 69 46 72 6f 6d  From->aCol[iFrom
b130: 43 6f 6c 5d 2e 7a 4e 61 6d 65 3b 0a 0a 20 20 20  Col].zName;..   
b140: 20 20 20 74 54 6f 43 6f 6c 2e 6e 20 3d 20 73 71     tToCol.n = sq
b150: 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 74 54  lite3Strlen30(tT
b160: 6f 43 6f 6c 2e 7a 29 3b 0a 20 20 20 20 20 20 74  oCol.z);.      t
b170: 46 72 6f 6d 43 6f 6c 2e 6e 20 3d 20 73 71 6c 69  FromCol.n = sqli
b180: 74 65 33 53 74 72 6c 65 6e 33 30 28 74 46 72 6f  te3Strlen30(tFro
b190: 6d 43 6f 6c 2e 7a 29 3b 0a 0a 20 20 20 20 20 20  mCol.z);..      
b1a0: 2f 2a 20 43 72 65 61 74 65 20 74 68 65 20 65 78  /* Create the ex
b1b0: 70 72 65 73 73 69 6f 6e 20 22 4f 4c 44 2e 7a 54  pression "OLD.zT
b1c0: 6f 43 6f 6c 20 3d 20 7a 46 72 6f 6d 43 6f 6c 22  oCol = zFromCol"
b1d0: 2e 20 49 74 20 69 73 20 69 6d 70 6f 72 74 61 6e  . It is importan
b1e0: 74 0a 20 20 20 20 20 20 2a 2a 20 74 68 61 74 20  t.      ** that 
b1f0: 74 68 65 20 22 4f 4c 44 2e 7a 54 6f 43 6f 6c 22  the "OLD.zToCol"
b200: 20 74 65 72 6d 20 69 73 20 6f 6e 20 74 68 65 20   term is on the 
b210: 4c 48 53 20 6f 66 20 74 68 65 20 3d 20 6f 70 65  LHS of the = ope
b220: 72 61 74 6f 72 2c 20 73 6f 0a 20 20 20 20 20 20  rator, so.      
b230: 2a 2a 20 74 68 61 74 20 74 68 65 20 61 66 66 69  ** that the affi
b240: 6e 69 74 79 20 61 6e 64 20 63 6f 6c 6c 61 74 69  nity and collati
b250: 6f 6e 20 73 65 71 75 65 6e 63 65 20 61 73 73 6f  on sequence asso
b260: 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 0a  ciated with the.
b270: 20 20 20 20 20 20 2a 2a 20 70 61 72 65 6e 74 20        ** parent 
b280: 74 61 62 6c 65 20 61 72 65 20 75 73 65 64 20 66  table are used f
b290: 6f 72 20 74 68 65 20 63 6f 6d 70 61 72 69 73 6f  or the compariso
b2a0: 6e 2e 20 2a 2f 0a 20 20 20 20 20 20 70 45 71 20  n. */.      pEq 
b2b0: 3d 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70  = sqlite3PExpr(p
b2c0: 50 61 72 73 65 2c 20 54 4b 5f 45 51 2c 0a 20 20  Parse, TK_EQ,.  
b2d0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50          sqlite3P
b2e0: 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f  Expr(pParse, TK_
b2f0: 44 4f 54 2c 20 0a 20 20 20 20 20 20 20 20 20 20  DOT, .          
b300: 20 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70    sqlite3PExpr(p
b310: 50 61 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30 2c  Parse, TK_ID, 0,
b320: 20 30 2c 20 26 74 4f 6c 64 29 2c 0a 20 20 20 20   0, &tOld),.    
b330: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50          sqlite3P
b340: 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f  Expr(pParse, TK_
b350: 49 44 2c 20 30 2c 20 30 2c 20 26 74 54 6f 43 6f  ID, 0, 0, &tToCo
b360: 6c 29 0a 20 20 20 20 20 20 20 20 20 20 2c 20 30  l).          , 0
b370: 29 2c 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  ),.          sql
b380: 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65  ite3PExpr(pParse
b390: 2c 20 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26  , TK_ID, 0, 0, &
b3a0: 74 46 72 6f 6d 43 6f 6c 29 0a 20 20 20 20 20 20  tFromCol).      
b3b0: 2c 20 30 29 3b 0a 20 20 20 20 20 20 70 57 68 65  , 0);.      pWhe
b3c0: 72 65 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72  re = sqlite3Expr
b3d0: 41 6e 64 28 64 62 2c 20 70 57 68 65 72 65 2c 20  And(db, pWhere, 
b3e0: 70 45 71 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20  pEq);..      /* 
b3f0: 46 6f 72 20 4f 4e 20 55 50 44 41 54 45 2c 20 63  For ON UPDATE, c
b400: 6f 6e 73 74 72 75 63 74 20 74 68 65 20 6e 65 78  onstruct the nex
b410: 74 20 74 65 72 6d 20 6f 66 20 74 68 65 20 57 48  t term of the WH
b420: 45 4e 20 63 6c 61 75 73 65 2e 0a 20 20 20 20 20  EN clause..     
b430: 20 2a 2a 20 54 68 65 20 66 69 6e 61 6c 20 57 48   ** The final WH
b440: 45 4e 20 63 6c 61 75 73 65 20 77 69 6c 6c 20 62  EN clause will b
b450: 65 20 6c 69 6b 65 20 74 68 69 73 3a 0a 20 20 20  e like this:.   
b460: 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 20     **.      **  
b470: 20 20 57 48 45 4e 20 4e 4f 54 28 6f 6c 64 2e 63    WHEN NOT(old.c
b480: 6f 6c 31 20 49 53 20 6e 65 77 2e 63 6f 6c 31 20  ol1 IS new.col1 
b490: 41 4e 44 20 2e 2e 2e 20 41 4e 44 20 6f 6c 64 2e  AND ... AND old.
b4a0: 63 6f 6c 4e 20 49 53 20 6e 65 77 2e 63 6f 6c 4e  colN IS new.colN
b4b0: 29 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20  ).      */.     
b4c0: 20 69 66 28 20 70 43 68 61 6e 67 65 73 20 29 7b   if( pChanges ){
b4d0: 0a 20 20 20 20 20 20 20 20 70 45 71 20 3d 20 73  .        pEq = s
b4e0: 71 6c 69 74 65 33 50 45 78 70 72 28 70 50 61 72  qlite3PExpr(pPar
b4f0: 73 65 2c 20 54 4b 5f 49 53 2c 0a 20 20 20 20 20  se, TK_IS,.     
b500: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 45         sqlite3PE
b510: 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 44  xpr(pParse, TK_D
b520: 4f 54 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20  OT, .           
b530: 20 20 20 73 71 6c 69 74 65 33 50 45 78 70 72 28     sqlite3PExpr(
b540: 70 50 61 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30  pParse, TK_ID, 0
b550: 2c 20 30 2c 20 26 74 4f 6c 64 29 2c 0a 20 20 20  , 0, &tOld),.   
b560: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
b570: 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c 20  e3PExpr(pParse, 
b580: 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26 74 54  TK_ID, 0, 0, &tT
b590: 6f 43 6f 6c 29 2c 0a 20 20 20 20 20 20 20 20 20  oCol),.         
b5a0: 20 20 20 20 20 30 29 2c 0a 20 20 20 20 20 20 20       0),.       
b5b0: 20 20 20 20 20 73 71 6c 69 74 65 33 50 45 78 70       sqlite3PExp
b5c0: 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 44 4f 54  r(pParse, TK_DOT
b5d0: 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  , .             
b5e0: 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 50   sqlite3PExpr(pP
b5f0: 61 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30 2c 20  arse, TK_ID, 0, 
b600: 30 2c 20 26 74 4e 65 77 29 2c 0a 20 20 20 20 20  0, &tNew),.     
b610: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
b620: 50 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b  PExpr(pParse, TK
b630: 5f 49 44 2c 20 30 2c 20 30 2c 20 26 74 54 6f 43  _ID, 0, 0, &tToC
b640: 6f 6c 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20  ol),.           
b650: 20 20 20 30 29 2c 0a 20 20 20 20 20 20 20 20 20     0),.         
b660: 20 20 20 30 29 3b 0a 20 20 20 20 20 20 20 20 70     0);.        p
b670: 57 68 65 6e 20 3d 20 73 71 6c 69 74 65 33 45 78  When = sqlite3Ex
b680: 70 72 41 6e 64 28 64 62 2c 20 70 57 68 65 6e 2c  prAnd(db, pWhen,
b690: 20 70 45 71 29 3b 0a 20 20 20 20 20 20 7d 0a 20   pEq);.      }. 
b6a0: 20 0a 20 20 20 20 20 20 69 66 28 20 61 63 74 69   .      if( acti
b6b0: 6f 6e 21 3d 4f 45 5f 52 65 73 74 72 69 63 74 20  on!=OE_Restrict 
b6c0: 26 26 20 28 61 63 74 69 6f 6e 21 3d 4f 45 5f 43  && (action!=OE_C
b6d0: 61 73 63 61 64 65 20 7c 7c 20 70 43 68 61 6e 67  ascade || pChang
b6e0: 65 73 29 20 29 7b 0a 20 20 20 20 20 20 20 20 45  es) ){.        E
b6f0: 78 70 72 20 2a 70 4e 65 77 3b 0a 20 20 20 20 20  xpr *pNew;.     
b700: 20 20 20 69 66 28 20 61 63 74 69 6f 6e 3d 3d 4f     if( action==O
b710: 45 5f 43 61 73 63 61 64 65 20 29 7b 0a 20 20 20  E_Cascade ){.   
b720: 20 20 20 20 20 20 20 70 4e 65 77 20 3d 20 73 71         pNew = sq
b730: 6c 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73  lite3PExpr(pPars
b740: 65 2c 20 54 4b 5f 44 4f 54 2c 20 0a 20 20 20 20  e, TK_DOT, .    
b750: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50          sqlite3P
b760: 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f  Expr(pParse, TK_
b770: 49 44 2c 20 30 2c 20 30 2c 20 26 74 4e 65 77 29  ID, 0, 0, &tNew)
b780: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71  ,.            sq
b790: 6c 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73  lite3PExpr(pPars
b7a0: 65 2c 20 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20  e, TK_ID, 0, 0, 
b7b0: 26 74 54 6f 43 6f 6c 29 0a 20 20 20 20 20 20 20  &tToCol).       
b7c0: 20 20 20 2c 20 30 29 3b 0a 20 20 20 20 20 20 20     , 0);.       
b7d0: 20 7d 65 6c 73 65 20 69 66 28 20 61 63 74 69 6f   }else if( actio
b7e0: 6e 3d 3d 4f 45 5f 53 65 74 44 66 6c 74 20 29 7b  n==OE_SetDflt ){
b7f0: 0a 20 20 20 20 20 20 20 20 20 20 45 78 70 72 20  .          Expr 
b800: 2a 70 44 66 6c 74 20 3d 20 70 46 4b 65 79 2d 3e  *pDflt = pFKey->
b810: 70 46 72 6f 6d 2d 3e 61 43 6f 6c 5b 69 46 72 6f  pFrom->aCol[iFro
b820: 6d 43 6f 6c 5d 2e 70 44 66 6c 74 3b 0a 20 20 20  mCol].pDflt;.   
b830: 20 20 20 20 20 20 20 69 66 28 20 70 44 66 6c 74         if( pDflt
b840: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20   ){.            
b850: 70 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 45 78  pNew = sqlite3Ex
b860: 70 72 44 75 70 28 64 62 2c 20 70 44 66 6c 74 2c  prDup(db, pDflt,
b870: 20 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d   0);.          }
b880: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20  else{.          
b890: 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 65 33    pNew = sqlite3
b8a0: 50 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b  PExpr(pParse, TK
b8b0: 5f 4e 55 4c 4c 2c 20 30 2c 20 30 2c 20 30 29 3b  _NULL, 0, 0, 0);
b8c0: 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20  .          }.   
b8d0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20       }else{.    
b8e0: 20 20 20 20 20 20 70 4e 65 77 20 3d 20 73 71 6c        pNew = sql
b8f0: 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65  ite3PExpr(pParse
b900: 2c 20 54 4b 5f 4e 55 4c 4c 2c 20 30 2c 20 30 2c  , TK_NULL, 0, 0,
b910: 20 30 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20   0);.        }. 
b920: 20 20 20 20 20 20 20 70 4c 69 73 74 20 3d 20 73         pList = s
b930: 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 41 70  qlite3ExprListAp
b940: 70 65 6e 64 28 70 50 61 72 73 65 2c 20 70 4c 69  pend(pParse, pLi
b950: 73 74 2c 20 70 4e 65 77 29 3b 0a 20 20 20 20 20  st, pNew);.     
b960: 20 20 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69     sqlite3ExprLi
b970: 73 74 53 65 74 4e 61 6d 65 28 70 50 61 72 73 65  stSetName(pParse
b980: 2c 20 70 4c 69 73 74 2c 20 26 74 46 72 6f 6d 43  , pList, &tFromC
b990: 6f 6c 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a  ol, 0);.      }.
b9a0: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
b9b0: 33 44 62 46 72 65 65 28 64 62 2c 20 61 69 43 6f  3DbFree(db, aiCo
b9c0: 6c 29 3b 0a 0a 20 20 20 20 7a 46 72 6f 6d 20 3d  l);..    zFrom =
b9d0: 20 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 2d 3e 7a   pFKey->pFrom->z
b9e0: 4e 61 6d 65 3b 0a 20 20 20 20 6e 46 72 6f 6d 20  Name;.    nFrom 
b9f0: 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33  = sqlite3Strlen3
ba00: 30 28 7a 46 72 6f 6d 29 3b 0a 0a 20 20 20 20 69  0(zFrom);..    i
ba10: 66 28 20 61 63 74 69 6f 6e 3d 3d 4f 45 5f 52 65  f( action==OE_Re
ba20: 73 74 72 69 63 74 20 29 7b 0a 20 20 20 20 20 20  strict ){.      
ba30: 54 6f 6b 65 6e 20 74 46 72 6f 6d 3b 0a 20 20 20  Token tFrom;.   
ba40: 20 20 20 45 78 70 72 20 2a 70 52 61 69 73 65 3b     Expr *pRaise;
ba50: 20 0a 0a 20 20 20 20 20 20 74 46 72 6f 6d 2e 7a   ..      tFrom.z
ba60: 20 3d 20 7a 46 72 6f 6d 3b 0a 20 20 20 20 20 20   = zFrom;.      
ba70: 74 46 72 6f 6d 2e 6e 20 3d 20 6e 46 72 6f 6d 3b  tFrom.n = nFrom;
ba80: 0a 20 20 20 20 20 20 70 52 61 69 73 65 20 3d 20  .      pRaise = 
ba90: 73 71 6c 69 74 65 33 45 78 70 72 28 64 62 2c 20  sqlite3Expr(db, 
baa0: 54 4b 5f 52 41 49 53 45 2c 20 22 66 6f 72 65 69  TK_RAISE, "forei
bab0: 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e  gn key constrain
bac0: 74 20 66 61 69 6c 65 64 22 29 3b 0a 20 20 20 20  t failed");.    
bad0: 20 20 69 66 28 20 70 52 61 69 73 65 20 29 7b 0a    if( pRaise ){.
bae0: 20 20 20 20 20 20 20 20 70 52 61 69 73 65 2d 3e          pRaise->
baf0: 61 66 66 69 6e 69 74 79 20 3d 20 4f 45 5f 41 62  affinity = OE_Ab
bb00: 6f 72 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  ort;.      }.   
bb10: 20 20 20 70 53 65 6c 65 63 74 20 3d 20 73 71 6c     pSelect = sql
bb20: 69 74 65 33 53 65 6c 65 63 74 4e 65 77 28 70 50  ite3SelectNew(pP
bb30: 61 72 73 65 2c 20 0a 20 20 20 20 20 20 20 20 20  arse, .         
bb40: 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74   sqlite3ExprList
bb50: 41 70 70 65 6e 64 28 70 50 61 72 73 65 2c 20 30  Append(pParse, 0
bb60: 2c 20 70 52 61 69 73 65 29 2c 0a 20 20 20 20 20  , pRaise),.     
bb70: 20 20 20 20 20 73 71 6c 69 74 65 33 53 72 63 4c       sqlite3SrcL
bb80: 69 73 74 41 70 70 65 6e 64 28 64 62 2c 20 30 2c  istAppend(db, 0,
bb90: 20 26 74 46 72 6f 6d 2c 20 30 29 2c 0a 20 20 20   &tFrom, 0),.   
bba0: 20 20 20 20 20 20 20 70 57 68 65 72 65 2c 0a 20         pWhere,. 
bbb0: 20 20 20 20 20 20 20 20 20 30 2c 20 30 2c 20 30           0, 0, 0
bbc0: 2c 20 30 2c 20 30 2c 20 30 0a 20 20 20 20 20 20  , 0, 0, 0.      
bbd0: 29 3b 0a 20 20 20 20 20 20 70 57 68 65 72 65 20  );.      pWhere 
bbe0: 3d 20 30 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20  = 0;.    }..    
bbf0: 2f 2a 20 44 69 73 61 62 6c 65 20 6c 6f 6f 6b 61  /* Disable looka
bc00: 73 69 64 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f  side memory allo
bc10: 63 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 65 6e  cation */.    en
bc20: 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 20 3d 20  ableLookaside = 
bc30: 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 45  db->lookaside.bE
bc40: 6e 61 62 6c 65 64 3b 0a 20 20 20 20 64 62 2d 3e  nabled;.    db->
bc50: 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c  lookaside.bEnabl
bc60: 65 64 20 3d 20 30 3b 0a 0a 20 20 20 20 70 54 72  ed = 0;..    pTr
bc70: 69 67 67 65 72 20 3d 20 28 54 72 69 67 67 65 72  igger = (Trigger
bc80: 20 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c   *)sqlite3DbMall
bc90: 6f 63 5a 65 72 6f 28 64 62 2c 20 0a 20 20 20 20  ocZero(db, .    
bca0: 20 20 20 20 73 69 7a 65 6f 66 28 54 72 69 67 67      sizeof(Trigg
bcb0: 65 72 29 20 2b 20 20 20 20 20 20 20 20 20 2f 2a  er) +         /*
bcc0: 20 73 74 72 75 63 74 20 54 72 69 67 67 65 72 20   struct Trigger 
bcd0: 2a 2f 0a 20 20 20 20 20 20 20 20 73 69 7a 65 6f  */.        sizeo
bce0: 66 28 54 72 69 67 67 65 72 53 74 65 70 29 20 2b  f(TriggerStep) +
bcf0: 20 20 20 20 20 2f 2a 20 53 69 6e 67 6c 65 20 73       /* Single s
bd00: 74 65 70 20 69 6e 20 74 72 69 67 67 65 72 20 70  tep in trigger p
bd10: 72 6f 67 72 61 6d 20 2a 2f 0a 20 20 20 20 20 20  rogram */.      
bd20: 20 20 6e 46 72 6f 6d 20 2b 20 31 20 20 20 20 20    nFrom + 1     
bd30: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53              /* S
bd40: 70 61 63 65 20 66 6f 72 20 70 53 74 65 70 2d 3e  pace for pStep->
bd50: 74 61 72 67 65 74 2e 7a 20 2a 2f 0a 20 20 20 20  target.z */.    
bd60: 29 3b 0a 20 20 20 20 69 66 28 20 70 54 72 69 67  );.    if( pTrig
bd70: 67 65 72 20 29 7b 0a 20 20 20 20 20 20 70 53 74  ger ){.      pSt
bd80: 65 70 20 3d 20 70 54 72 69 67 67 65 72 2d 3e 73  ep = pTrigger->s
bd90: 74 65 70 5f 6c 69 73 74 20 3d 20 28 54 72 69 67  tep_list = (Trig
bda0: 67 65 72 53 74 65 70 20 2a 29 26 70 54 72 69 67  gerStep *)&pTrig
bdb0: 67 65 72 5b 31 5d 3b 0a 20 20 20 20 20 20 70 53  ger[1];.      pS
bdc0: 74 65 70 2d 3e 74 61 72 67 65 74 2e 7a 20 3d 20  tep->target.z = 
bdd0: 28 63 68 61 72 20 2a 29 26 70 53 74 65 70 5b 31  (char *)&pStep[1
bde0: 5d 3b 0a 20 20 20 20 20 20 70 53 74 65 70 2d 3e  ];.      pStep->
bdf0: 74 61 72 67 65 74 2e 6e 20 3d 20 6e 46 72 6f 6d  target.n = nFrom
be00: 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 28  ;.      memcpy((
be10: 63 68 61 72 20 2a 29 70 53 74 65 70 2d 3e 74 61  char *)pStep->ta
be20: 72 67 65 74 2e 7a 2c 20 7a 46 72 6f 6d 2c 20 6e  rget.z, zFrom, n
be30: 46 72 6f 6d 29 3b 0a 20 20 0a 20 20 20 20 20 20  From);.  .      
be40: 70 53 74 65 70 2d 3e 70 57 68 65 72 65 20 3d 20  pStep->pWhere = 
be50: 73 71 6c 69 74 65 33 45 78 70 72 44 75 70 28 64  sqlite3ExprDup(d
be60: 62 2c 20 70 57 68 65 72 65 2c 20 45 58 50 52 44  b, pWhere, EXPRD
be70: 55 50 5f 52 45 44 55 43 45 29 3b 0a 20 20 20 20  UP_REDUCE);.    
be80: 20 20 70 53 74 65 70 2d 3e 70 45 78 70 72 4c 69    pStep->pExprLi
be90: 73 74 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72  st = sqlite3Expr
bea0: 4c 69 73 74 44 75 70 28 64 62 2c 20 70 4c 69 73  ListDup(db, pLis
beb0: 74 2c 20 45 58 50 52 44 55 50 5f 52 45 44 55 43  t, EXPRDUP_REDUC
bec0: 45 29 3b 0a 20 20 20 20 20 20 70 53 74 65 70 2d  E);.      pStep-
bed0: 3e 70 53 65 6c 65 63 74 20 3d 20 73 71 6c 69 74  >pSelect = sqlit
bee0: 65 33 53 65 6c 65 63 74 44 75 70 28 64 62 2c 20  e3SelectDup(db, 
bef0: 70 53 65 6c 65 63 74 2c 20 45 58 50 52 44 55 50  pSelect, EXPRDUP
bf00: 5f 52 45 44 55 43 45 29 3b 0a 20 20 20 20 20 20  _REDUCE);.      
bf10: 69 66 28 20 70 57 68 65 6e 20 29 7b 0a 20 20 20  if( pWhen ){.   
bf20: 20 20 20 20 20 70 57 68 65 6e 20 3d 20 73 71 6c       pWhen = sql
bf30: 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65  ite3PExpr(pParse
bf40: 2c 20 54 4b 5f 4e 4f 54 2c 20 70 57 68 65 6e 2c  , TK_NOT, pWhen,
bf50: 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20   0, 0);.        
bf60: 70 54 72 69 67 67 65 72 2d 3e 70 57 68 65 6e 20  pTrigger->pWhen 
bf70: 3d 20 73 71 6c 69 74 65 33 45 78 70 72 44 75 70  = sqlite3ExprDup
bf80: 28 64 62 2c 20 70 57 68 65 6e 2c 20 45 58 50 52  (db, pWhen, EXPR
bf90: 44 55 50 5f 52 45 44 55 43 45 29 3b 0a 20 20 20  DUP_REDUCE);.   
bfa0: 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20     }.    }..    
bfb0: 2f 2a 20 52 65 2d 65 6e 61 62 6c 65 20 74 68 65  /* Re-enable the
bfc0: 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75 66 66 65   lookaside buffe
bfd0: 72 2c 20 69 66 20 69 74 20 77 61 73 20 64 69 73  r, if it was dis
bfe0: 61 62 6c 65 64 20 65 61 72 6c 69 65 72 2e 20 2a  abled earlier. *
bff0: 2f 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73  /.    db->lookas
c000: 69 64 65 2e 62 45 6e 61 62 6c 65 64 20 3d 20 65  ide.bEnabled = e
c010: 6e 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 3b 0a  nableLookaside;.
c020: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 72  .    sqlite3Expr
c030: 44 65 6c 65 74 65 28 64 62 2c 20 70 57 68 65 72  Delete(db, pWher
c040: 65 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45  e);.    sqlite3E
c050: 78 70 72 44 65 6c 65 74 65 28 64 62 2c 20 70 57  xprDelete(db, pW
c060: 68 65 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  hen);.    sqlite
c070: 33 45 78 70 72 4c 69 73 74 44 65 6c 65 74 65 28  3ExprListDelete(
c080: 64 62 2c 20 70 4c 69 73 74 29 3b 0a 20 20 20 20  db, pList);.    
c090: 73 71 6c 69 74 65 33 53 65 6c 65 63 74 44 65 6c  sqlite3SelectDel
c0a0: 65 74 65 28 64 62 2c 20 70 53 65 6c 65 63 74 29  ete(db, pSelect)
c0b0: 3b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 6d 61  ;.    if( db->ma
c0c0: 6c 6c 6f 63 46 61 69 6c 65 64 3d 3d 31 20 29 7b  llocFailed==1 ){
c0d0: 0a 20 20 20 20 20 20 66 6b 54 72 69 67 67 65 72  .      fkTrigger
c0e0: 44 65 6c 65 74 65 28 64 62 2c 20 70 54 72 69 67  Delete(db, pTrig
c0f0: 67 65 72 29 3b 0a 20 20 20 20 20 20 72 65 74 75  ger);.      retu
c100: 72 6e 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20  rn 0;.    }.    
c110: 61 73 73 65 72 74 28 20 70 53 74 65 70 21 3d 30  assert( pStep!=0
c120: 20 29 3b 0a 0a 20 20 20 20 73 77 69 74 63 68 28   );..    switch(
c130: 20 61 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20   action ){.     
c140: 20 63 61 73 65 20 4f 45 5f 52 65 73 74 72 69 63   case OE_Restric
c150: 74 3a 0a 20 20 20 20 20 20 20 20 70 53 74 65 70  t:.        pStep
c160: 2d 3e 6f 70 20 3d 20 54 4b 5f 53 45 4c 45 43 54  ->op = TK_SELECT
c170: 3b 20 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b  ; .        break
c180: 3b 0a 20 20 20 20 20 20 63 61 73 65 20 4f 45 5f  ;.      case OE_
c190: 43 61 73 63 61 64 65 3a 20 0a 20 20 20 20 20 20  Cascade: .      
c1a0: 20 20 69 66 28 20 21 70 43 68 61 6e 67 65 73 20    if( !pChanges 
c1b0: 29 7b 20 0a 20 20 20 20 20 20 20 20 20 20 70 53  ){ .          pS
c1c0: 74 65 70 2d 3e 6f 70 20 3d 20 54 4b 5f 44 45 4c  tep->op = TK_DEL
c1d0: 45 54 45 3b 20 0a 20 20 20 20 20 20 20 20 20 20  ETE; .          
c1e0: 62 72 65 61 6b 3b 20 0a 20 20 20 20 20 20 20 20  break; .        
c1f0: 7d 0a 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a  }.      default:
c200: 0a 20 20 20 20 20 20 20 20 70 53 74 65 70 2d 3e  .        pStep->
c210: 6f 70 20 3d 20 54 4b 5f 55 50 44 41 54 45 3b 0a  op = TK_UPDATE;.
c220: 20 20 20 20 7d 0a 20 20 20 20 70 53 74 65 70 2d      }.    pStep-
c230: 3e 70 54 72 69 67 20 3d 20 70 54 72 69 67 67 65  >pTrig = pTrigge
c240: 72 3b 0a 20 20 20 20 70 54 72 69 67 67 65 72 2d  r;.    pTrigger-
c250: 3e 70 53 63 68 65 6d 61 20 3d 20 70 54 61 62 2d  >pSchema = pTab-
c260: 3e 70 53 63 68 65 6d 61 3b 0a 20 20 20 20 70 54  >pSchema;.    pT
c270: 72 69 67 67 65 72 2d 3e 70 54 61 62 53 63 68 65  rigger->pTabSche
c280: 6d 61 20 3d 20 70 54 61 62 2d 3e 70 53 63 68 65  ma = pTab->pSche
c290: 6d 61 3b 0a 20 20 20 20 70 46 4b 65 79 2d 3e 61  ma;.    pFKey->a
c2a0: 70 54 72 69 67 67 65 72 5b 69 41 63 74 69 6f 6e  pTrigger[iAction
c2b0: 5d 20 3d 20 70 54 72 69 67 67 65 72 3b 0a 20 20  ] = pTrigger;.  
c2c0: 20 20 70 54 72 69 67 67 65 72 2d 3e 6f 70 20 3d    pTrigger->op =
c2d0: 20 28 70 43 68 61 6e 67 65 73 20 3f 20 54 4b 5f   (pChanges ? TK_
c2e0: 55 50 44 41 54 45 20 3a 20 54 4b 5f 44 45 4c 45  UPDATE : TK_DELE
c2f0: 54 45 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75  TE);.  }..  retu
c300: 72 6e 20 70 54 72 69 67 67 65 72 3b 0a 7d 0a 0a  rn pTrigger;.}..
c310: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
c320: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 68  ion is called wh
c330: 65 6e 20 64 65 6c 65 74 69 6e 67 20 6f 72 20 75  en deleting or u
c340: 70 64 61 74 69 6e 67 20 61 20 72 6f 77 20 74 6f  pdating a row to
c350: 20 69 6d 70 6c 65 6d 65 6e 74 0a 2a 2a 20 61 6e   implement.** an
c360: 79 20 72 65 71 75 69 72 65 64 20 43 41 53 43 41  y required CASCA
c370: 44 45 2c 20 53 45 54 20 4e 55 4c 4c 20 6f 72 20  DE, SET NULL or 
c380: 53 45 54 20 44 45 46 41 55 4c 54 20 61 63 74 69  SET DEFAULT acti
c390: 6f 6e 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  ons..*/.void sql
c3a0: 69 74 65 33 46 6b 41 63 74 69 6f 6e 73 28 0a 20  ite3FkActions(. 
c3b0: 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20   Parse *pParse, 
c3c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c3d0: 20 2f 2a 20 50 61 72 73 65 20 63 6f 6e 74 65 78   /* Parse contex
c3e0: 74 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54  t */.  Table *pT
c3f0: 61 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ab,             
c400: 20 20 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20         /* Table 
c410: 62 65 69 6e 67 20 75 70 64 61 74 65 64 20 6f 72  being updated or
c420: 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 2a 2f   deleted from */
c430: 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 43 68  .  ExprList *pCh
c440: 61 6e 67 65 73 2c 20 20 20 20 20 20 20 20 20 20  anges,          
c450: 20 20 20 2f 2a 20 43 68 61 6e 67 65 2d 6c 69 73     /* Change-lis
c460: 74 20 66 6f 72 20 55 50 44 41 54 45 2c 20 4e 55  t for UPDATE, NU
c470: 4c 4c 20 66 6f 72 20 44 45 4c 45 54 45 20 2a 2f  LL for DELETE */
c480: 0a 20 20 69 6e 74 20 72 65 67 4f 6c 64 2c 20 20  .  int regOld,  
c490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c4a0: 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66     /* Address of
c4b0: 20 61 72 72 61 79 20 63 6f 6e 74 61 69 6e 69 6e   array containin
c4c0: 67 20 6f 6c 64 20 72 6f 77 20 2a 2f 0a 20 20 69  g old row */.  i
c4d0: 6e 74 20 2a 61 43 68 61 6e 67 65 2c 20 20 20 20  nt *aChange,    
c4e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
c4f0: 2a 20 41 72 72 61 79 20 69 6e 64 69 63 61 74 69  * Array indicati
c500: 6e 67 20 55 50 44 41 54 45 64 20 63 6f 6c 75 6d  ng UPDATEd colum
c510: 6e 73 20 28 6f 72 20 30 29 20 2a 2f 0a 20 20 69  ns (or 0) */.  i
c520: 6e 74 20 62 43 68 6e 67 52 6f 77 69 64 20 20 20  nt bChngRowid   
c530: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
c540: 2a 20 54 72 75 65 20 69 66 20 72 6f 77 69 64 20  * True if rowid 
c550: 69 73 20 55 50 44 41 54 45 64 20 2a 2f 0a 29 7b  is UPDATEd */.){
c560: 0a 20 20 2f 2a 20 49 66 20 66 6f 72 65 69 67 6e  .  /* If foreign
c570: 2d 6b 65 79 20 73 75 70 70 6f 72 74 20 69 73 20  -key support is 
c580: 65 6e 61 62 6c 65 64 2c 20 69 74 65 72 61 74 65  enabled, iterate
c590: 20 74 68 72 6f 75 67 68 20 61 6c 6c 20 46 4b 73   through all FKs
c5a0: 20 74 68 61 74 20 0a 20 20 2a 2a 20 72 65 66 65   that .  ** refe
c5b0: 72 20 74 6f 20 74 61 62 6c 65 20 70 54 61 62 2e  r to table pTab.
c5c0: 20 49 66 20 74 68 65 72 65 20 69 73 20 61 6e 20   If there is an 
c5d0: 61 63 74 69 6f 6e 20 61 73 73 6f 63 69 61 74 65  action associate
c5e0: 64 20 77 69 74 68 20 74 68 65 20 46 4b 20 0a 20  d with the FK . 
c5f0: 20 2a 2a 20 66 6f 72 20 74 68 69 73 20 6f 70 65   ** for this ope
c600: 72 61 74 69 6f 6e 20 28 65 69 74 68 65 72 20 75  ration (either u
c610: 70 64 61 74 65 20 6f 72 20 64 65 6c 65 74 65 29  pdate or delete)
c620: 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20 61 73 73  , invoke the ass
c630: 6f 63 69 61 74 65 64 20 0a 20 20 2a 2a 20 74 72  ociated .  ** tr
c640: 69 67 67 65 72 20 73 75 62 2d 70 72 6f 67 72 61  igger sub-progra
c650: 6d 2e 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 61  m.  */.  if( pPa
c660: 72 73 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 53  rse->db->flags&S
c670: 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79  QLITE_ForeignKey
c680: 73 20 29 7b 0a 20 20 20 20 46 4b 65 79 20 2a 70  s ){.    FKey *p
c690: 46 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 20  FKey;           
c6a0: 20 20 20 20 20 20 20 2f 2a 20 49 74 65 72 61 74         /* Iterat
c6b0: 6f 72 20 76 61 72 69 61 62 6c 65 20 2a 2f 0a 20  or variable */. 
c6c0: 20 20 20 66 6f 72 28 70 46 4b 65 79 20 3d 20 73     for(pFKey = s
c6d0: 71 6c 69 74 65 33 46 6b 52 65 66 65 72 65 6e 63  qlite3FkReferenc
c6e0: 65 73 28 70 54 61 62 29 3b 20 70 46 4b 65 79 3b  es(pTab); pFKey;
c6f0: 20 70 46 4b 65 79 3d 70 46 4b 65 79 2d 3e 70 4e   pFKey=pFKey->pN
c700: 65 78 74 54 6f 29 7b 0a 20 20 20 20 20 20 69 66  extTo){.      if
c710: 28 20 61 43 68 61 6e 67 65 3d 3d 30 20 7c 7c 20  ( aChange==0 || 
c720: 66 6b 50 61 72 65 6e 74 49 73 4d 6f 64 69 66 69  fkParentIsModifi
c730: 65 64 28 70 54 61 62 2c 20 70 46 4b 65 79 2c 20  ed(pTab, pFKey, 
c740: 61 43 68 61 6e 67 65 2c 20 62 43 68 6e 67 52 6f  aChange, bChngRo
c750: 77 69 64 29 20 29 7b 0a 20 20 20 20 20 20 20 20  wid) ){.        
c760: 54 72 69 67 67 65 72 20 2a 70 41 63 74 20 3d 20  Trigger *pAct = 
c770: 66 6b 41 63 74 69 6f 6e 54 72 69 67 67 65 72 28  fkActionTrigger(
c780: 70 50 61 72 73 65 2c 20 70 54 61 62 2c 20 70 46  pParse, pTab, pF
c790: 4b 65 79 2c 20 70 43 68 61 6e 67 65 73 29 3b 0a  Key, pChanges);.
c7a0: 20 20 20 20 20 20 20 20 69 66 28 20 70 41 63 74          if( pAct
c7b0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71   ){.          sq
c7c0: 6c 69 74 65 33 43 6f 64 65 52 6f 77 54 72 69 67  lite3CodeRowTrig
c7d0: 67 65 72 44 69 72 65 63 74 28 70 50 61 72 73 65  gerDirect(pParse
c7e0: 2c 20 70 41 63 74 2c 20 70 54 61 62 2c 20 72 65  , pAct, pTab, re
c7f0: 67 4f 6c 64 2c 20 4f 45 5f 41 62 6f 72 74 2c 20  gOld, OE_Abort, 
c800: 30 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  0);.        }.  
c810: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a      }.    }.  }.
c820: 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 69 66 6e  }..#endif /* ifn
c830: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
c840: 54 52 49 47 47 45 52 20 2a 2f 0a 0a 2f 2a 0a 2a  TRIGGER */../*.*
c850: 2a 20 46 72 65 65 20 61 6c 6c 20 6d 65 6d 6f 72  * Free all memor
c860: 79 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74  y associated wit
c870: 68 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 64 65  h foreign key de
c880: 66 69 6e 69 74 69 6f 6e 73 20 61 74 74 61 63 68  finitions attach
c890: 65 64 20 74 6f 0a 2a 2a 20 74 61 62 6c 65 20 70  ed to.** table p
c8a0: 54 61 62 2e 20 52 65 6d 6f 76 65 20 74 68 65 20  Tab. Remove the 
c8b0: 64 65 6c 65 74 65 64 20 66 6f 72 65 69 67 6e 20  deleted foreign 
c8c0: 6b 65 79 73 20 66 72 6f 6d 20 74 68 65 20 53 63  keys from the Sc
c8d0: 68 65 6d 61 2e 66 6b 65 79 48 61 73 68 0a 2a 2a  hema.fkeyHash.**
c8e0: 20 68 61 73 68 20 74 61 62 6c 65 2e 0a 2a 2f 0a   hash table..*/.
c8f0: 76 6f 69 64 20 73 71 6c 69 74 65 33 46 6b 44 65  void sqlite3FkDe
c900: 6c 65 74 65 28 73 71 6c 69 74 65 33 20 2a 64 62  lete(sqlite3 *db
c910: 2c 20 54 61 62 6c 65 20 2a 70 54 61 62 29 7b 0a  , Table *pTab){.
c920: 20 20 46 4b 65 79 20 2a 70 46 4b 65 79 3b 20 20    FKey *pFKey;  
c930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
c940: 20 20 2f 2a 20 49 74 65 72 61 74 6f 72 20 76 61    /* Iterator va
c950: 72 69 61 62 6c 65 20 2a 2f 0a 20 20 46 4b 65 79  riable */.  FKey
c960: 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 20 20   *pNext;        
c970: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43              /* C
c980: 6f 70 79 20 6f 66 20 70 46 4b 65 79 2d 3e 70 4e  opy of pFKey->pN
c990: 65 78 74 46 72 6f 6d 20 2a 2f 0a 0a 20 20 61 73  extFrom */..  as
c9a0: 73 65 72 74 28 20 64 62 3d 3d 30 20 7c 7c 20 73  sert( db==0 || s
c9b0: 71 6c 69 74 65 33 53 63 68 65 6d 61 4d 75 74 65  qlite3SchemaMute
c9c0: 78 48 65 6c 64 28 64 62 2c 20 30 2c 20 70 54 61  xHeld(db, 0, pTa
c9d0: 62 2d 3e 70 53 63 68 65 6d 61 29 20 29 3b 0a 20  b->pSchema) );. 
c9e0: 20 66 6f 72 28 70 46 4b 65 79 3d 70 54 61 62 2d   for(pFKey=pTab-
c9f0: 3e 70 46 4b 65 79 3b 20 70 46 4b 65 79 3b 20 70  >pFKey; pFKey; p
ca00: 46 4b 65 79 3d 70 4e 65 78 74 29 7b 0a 0a 20 20  FKey=pNext){..  
ca10: 20 20 2f 2a 20 52 65 6d 6f 76 65 20 74 68 65 20    /* Remove the 
ca20: 46 4b 20 66 72 6f 6d 20 74 68 65 20 66 6b 65 79  FK from the fkey
ca30: 48 61 73 68 20 68 61 73 68 20 74 61 62 6c 65 2e  Hash hash table.
ca40: 20 2a 2f 0a 20 20 20 20 69 66 28 20 21 64 62 20   */.    if( !db 
ca50: 7c 7c 20 64 62 2d 3e 70 6e 42 79 74 65 73 46 72  || db->pnBytesFr
ca60: 65 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20  eed==0 ){.      
ca70: 69 66 28 20 70 46 4b 65 79 2d 3e 70 50 72 65 76  if( pFKey->pPrev
ca80: 54 6f 20 29 7b 0a 20 20 20 20 20 20 20 20 70 46  To ){.        pF
ca90: 4b 65 79 2d 3e 70 50 72 65 76 54 6f 2d 3e 70 4e  Key->pPrevTo->pN
caa0: 65 78 74 54 6f 20 3d 20 70 46 4b 65 79 2d 3e 70  extTo = pFKey->p
cab0: 4e 65 78 74 54 6f 3b 0a 20 20 20 20 20 20 7d 65  NextTo;.      }e
cac0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 76 6f 69  lse{.        voi
cad0: 64 20 2a 70 20 3d 20 28 76 6f 69 64 20 2a 29 70  d *p = (void *)p
cae0: 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f 3b 0a 20  FKey->pNextTo;. 
caf0: 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61         const cha
cb00: 72 20 2a 7a 20 3d 20 28 70 20 3f 20 70 46 4b 65  r *z = (p ? pFKe
cb10: 79 2d 3e 70 4e 65 78 74 54 6f 2d 3e 7a 54 6f 20  y->pNextTo->zTo 
cb20: 3a 20 70 46 4b 65 79 2d 3e 7a 54 6f 29 3b 0a 20  : pFKey->zTo);. 
cb30: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 48 61         sqlite3Ha
cb40: 73 68 49 6e 73 65 72 74 28 26 70 54 61 62 2d 3e  shInsert(&pTab->
cb50: 70 53 63 68 65 6d 61 2d 3e 66 6b 65 79 48 61 73  pSchema->fkeyHas
cb60: 68 2c 20 7a 2c 20 73 71 6c 69 74 65 33 53 74 72  h, z, sqlite3Str
cb70: 6c 65 6e 33 30 28 7a 29 2c 20 70 29 3b 0a 20 20  len30(z), p);.  
cb80: 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20      }.      if( 
cb90: 70 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f 20 29  pFKey->pNextTo )
cba0: 7b 0a 20 20 20 20 20 20 20 20 70 46 4b 65 79 2d  {.        pFKey-
cbb0: 3e 70 4e 65 78 74 54 6f 2d 3e 70 50 72 65 76 54  >pNextTo->pPrevT
cbc0: 6f 20 3d 20 70 46 4b 65 79 2d 3e 70 50 72 65 76  o = pFKey->pPrev
cbd0: 54 6f 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  To;.      }.    
cbe0: 7d 0a 0a 20 20 20 20 2f 2a 20 45 56 3a 20 52 2d  }..    /* EV: R-
cbf0: 33 30 33 32 33 2d 32 31 39 31 37 20 45 61 63 68  30323-21917 Each
cc00: 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e   foreign key con
cc10: 73 74 72 61 69 6e 74 20 69 6e 20 53 51 4c 69 74  straint in SQLit
cc20: 65 20 69 73 0a 20 20 20 20 2a 2a 20 63 6c 61 73  e is.    ** clas
cc30: 73 69 66 69 65 64 20 61 73 20 65 69 74 68 65 72  sified as either
cc40: 20 69 6d 6d 65 64 69 61 74 65 20 6f 72 20 64 65   immediate or de
cc50: 66 65 72 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20  ferred..    */. 
cc60: 20 20 20 61 73 73 65 72 74 28 20 70 46 4b 65 79     assert( pFKey
cc70: 2d 3e 69 73 44 65 66 65 72 72 65 64 3d 3d 30 20  ->isDeferred==0 
cc80: 7c 7c 20 70 46 4b 65 79 2d 3e 69 73 44 65 66 65  || pFKey->isDefe
cc90: 72 72 65 64 3d 3d 31 20 29 3b 0a 0a 20 20 20 20  rred==1 );..    
cca0: 2f 2a 20 44 65 6c 65 74 65 20 61 6e 79 20 74 72  /* Delete any tr
ccb0: 69 67 67 65 72 73 20 63 72 65 61 74 65 64 20 74  iggers created t
ccc0: 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 61 63 74 69  o implement acti
ccd0: 6f 6e 73 20 66 6f 72 20 74 68 69 73 20 46 4b 2e  ons for this FK.
cce0: 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49   */.#ifndef SQLI
ccf0: 54 45 5f 4f 4d 49 54 5f 54 52 49 47 47 45 52 0a  TE_OMIT_TRIGGER.
cd00: 20 20 20 20 66 6b 54 72 69 67 67 65 72 44 65 6c      fkTriggerDel
cd10: 65 74 65 28 64 62 2c 20 70 46 4b 65 79 2d 3e 61  ete(db, pFKey->a
cd20: 70 54 72 69 67 67 65 72 5b 30 5d 29 3b 0a 20 20  pTrigger[0]);.  
cd30: 20 20 66 6b 54 72 69 67 67 65 72 44 65 6c 65 74    fkTriggerDelet
cd40: 65 28 64 62 2c 20 70 46 4b 65 79 2d 3e 61 70 54  e(db, pFKey->apT
cd50: 72 69 67 67 65 72 5b 31 5d 29 3b 0a 23 65 6e 64  rigger[1]);.#end
cd60: 69 66 0a 0a 20 20 20 20 70 4e 65 78 74 20 3d 20  if..    pNext = 
cd70: 70 46 4b 65 79 2d 3e 70 4e 65 78 74 46 72 6f 6d  pFKey->pNextFrom
cd80: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46  ;.    sqlite3DbF
cd90: 72 65 65 28 64 62 2c 20 70 46 4b 65 79 29 3b 0a  ree(db, pFKey);.
cda0: 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20    }.}.#endif /* 
cdb0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
cdc0: 49 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 20 2a  IT_FOREIGN_KEY *
cdd0: 2f 0a                                            /.