/ Hex Artifact Content
Login

Artifact f19ee86f39aac8069761b3c2acd65ace057d33f793b048734e5d203ef038be9e:


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 64   consists of a d
1d50: 69 66 66 65 72 65 6e 74 20 6e 75 6d 62 65 72 20  ifferent number 
1d60: 6f 66 20 63 6f 6c 75 6d 6e 73 20 74 6f 20 74 68  of columns to th
1d70: 65 20 63 68 69 6c 64 20 6b 65 79 20 69 6e 20 0a  e child key in .
1d80: 2a 2a 20 20 20 20 20 20 74 68 65 20 63 68 69 6c  **      the chil
1d90: 64 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 74  d table..**.** t
1da0: 68 65 6e 20 6e 6f 6e 2d 7a 65 72 6f 20 69 73 20  hen non-zero is 
1db0: 72 65 74 75 72 6e 65 64 2c 20 61 6e 64 20 61 20  returned, and a 
1dc0: 22 66 6f 72 65 69 67 6e 20 6b 65 79 20 6d 69 73  "foreign key mis
1dd0: 6d 61 74 63 68 22 20 65 72 72 6f 72 20 6c 6f 61  match" error loa
1de0: 64 65 64 0a 2a 2a 20 69 6e 74 6f 20 70 50 61 72  ded.** into pPar
1df0: 73 65 2e 20 49 66 20 61 6e 20 4f 4f 4d 20 65 72  se. If an OOM er
1e00: 72 6f 72 20 6f 63 63 75 72 73 2c 20 6e 6f 6e 2d  ror occurs, non-
1e10: 7a 65 72 6f 20 69 73 20 72 65 74 75 72 6e 65 64  zero is returned
1e20: 20 61 6e 64 20 74 68 65 0a 2a 2a 20 70 50 61 72   and the.** pPar
1e30: 73 65 2d 3e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61  se->db->mallocFa
1e40: 69 6c 65 64 20 66 6c 61 67 20 69 73 20 73 65 74  iled flag is set
1e50: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
1e60: 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78 28 0a 20  FkLocateIndex(. 
1e70: 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20   Parse *pParse, 
1e80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1e90: 20 2f 2a 20 50 61 72 73 65 20 63 6f 6e 74 65 78   /* Parse contex
1ea0: 74 20 74 6f 20 73 74 6f 72 65 20 61 6e 79 20 65  t to store any e
1eb0: 72 72 6f 72 20 69 6e 20 2a 2f 0a 20 20 54 61 62  rror in */.  Tab
1ec0: 6c 65 20 2a 70 50 61 72 65 6e 74 2c 20 20 20 20  le *pParent,    
1ed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1ee0: 50 61 72 65 6e 74 20 74 61 62 6c 65 20 6f 66 20  Parent table of 
1ef0: 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74 20 70 46  FK constraint pF
1f00: 4b 65 79 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70  Key */.  FKey *p
1f10: 46 4b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20  FKey,           
1f20: 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 65           /* Fore
1f30: 69 67 6e 20 6b 65 79 20 74 6f 20 66 69 6e 64 20  ign key to find 
1f40: 69 6e 64 65 78 20 66 6f 72 20 2a 2f 0a 20 20 49  index for */.  I
1f50: 6e 64 65 78 20 2a 2a 70 70 49 64 78 2c 20 20 20  ndex **ppIdx,   
1f60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1f70: 2a 20 4f 55 54 3a 20 55 6e 69 71 75 65 20 69 6e  * OUT: Unique in
1f80: 64 65 78 20 6f 6e 20 70 61 72 65 6e 74 20 74 61  dex on parent ta
1f90: 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 2a 70  ble */.  int **p
1fa0: 61 69 43 6f 6c 20 20 20 20 20 20 20 20 20 20 20  aiCol           
1fb0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
1fc0: 20 4d 61 70 20 6f 66 20 69 6e 64 65 78 20 63 6f   Map of index co
1fd0: 6c 75 6d 6e 73 20 69 6e 20 70 46 4b 65 79 20 2a  lumns in pFKey *
1fe0: 2f 0a 29 7b 0a 20 20 49 6e 64 65 78 20 2a 70 49  /.){.  Index *pI
1ff0: 64 78 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20  dx = 0;         
2000: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61             /* Va
2010: 6c 75 65 20 74 6f 20 72 65 74 75 72 6e 20 76 69  lue to return vi
2020: 61 20 2a 70 70 49 64 78 20 2a 2f 0a 20 20 69 6e  a *ppIdx */.  in
2030: 74 20 2a 61 69 43 6f 6c 20 3d 20 30 3b 20 20 20  t *aiCol = 0;   
2040: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2050: 20 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 72 65    /* Value to re
2060: 74 75 72 6e 20 76 69 61 20 2a 70 61 69 43 6f 6c  turn via *paiCol
2070: 20 2a 2f 0a 20 20 69 6e 74 20 6e 43 6f 6c 20 3d   */.  int nCol =
2080: 20 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3b 20 20 20   pFKey->nCol;   
2090: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d            /* Num
20a0: 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69  ber of columns i
20b0: 6e 20 70 61 72 65 6e 74 20 6b 65 79 20 2a 2f 0a  n parent key */.
20c0: 20 20 63 68 61 72 20 2a 7a 4b 65 79 20 3d 20 70    char *zKey = p
20d0: 46 4b 65 79 2d 3e 61 43 6f 6c 5b 30 5d 2e 7a 43  FKey->aCol[0].zC
20e0: 6f 6c 3b 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66  ol;   /* Name of
20f0: 20 6c 65 66 74 2d 6d 6f 73 74 20 70 61 72 65 6e   left-most paren
2100: 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 20 2a 2f 0a  t key column */.
2110: 0a 20 20 2f 2a 20 54 68 65 20 63 61 6c 6c 65 72  .  /* The caller
2120: 20 69 73 20 72 65 73 70 6f 6e 73 69 62 6c 65 20   is responsible 
2130: 66 6f 72 20 7a 65 72 6f 69 6e 67 20 6f 75 74 70  for zeroing outp
2140: 75 74 20 70 61 72 61 6d 65 74 65 72 73 2e 20 2a  ut parameters. *
2150: 2f 0a 20 20 61 73 73 65 72 74 28 20 70 70 49 64  /.  assert( ppId
2160: 78 20 26 26 20 2a 70 70 49 64 78 3d 3d 30 20 29  x && *ppIdx==0 )
2170: 3b 0a 20 20 61 73 73 65 72 74 28 20 21 70 61 69  ;.  assert( !pai
2180: 43 6f 6c 20 7c 7c 20 2a 70 61 69 43 6f 6c 3d 3d  Col || *paiCol==
2190: 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  0 );.  assert( p
21a0: 50 61 72 73 65 20 29 3b 0a 0a 20 20 2f 2a 20 49  Parse );..  /* I
21b0: 66 20 74 68 69 73 20 69 73 20 61 20 6e 6f 6e 2d  f this is a non-
21c0: 63 6f 6d 70 6f 73 69 74 65 20 28 73 69 6e 67 6c  composite (singl
21d0: 65 20 63 6f 6c 75 6d 6e 29 20 66 6f 72 65 69 67  e column) foreig
21e0: 6e 20 6b 65 79 2c 20 63 68 65 63 6b 20 69 66 20  n key, check if 
21f0: 69 74 20 0a 20 20 2a 2a 20 6d 61 70 73 20 74 6f  it .  ** maps to
2200: 20 74 68 65 20 49 4e 54 45 47 45 52 20 50 52 49   the INTEGER PRI
2210: 4d 41 52 59 20 4b 45 59 20 6f 66 20 74 61 62 6c  MARY KEY of tabl
2220: 65 20 70 50 61 72 65 6e 74 2e 20 49 66 20 73 6f  e pParent. If so
2230: 2c 20 6c 65 61 76 65 20 2a 70 70 49 64 78 20 0a  , leave *ppIdx .
2240: 20 20 2a 2a 20 61 6e 64 20 2a 70 61 69 43 6f 6c    ** and *paiCol
2250: 20 73 65 74 20 74 6f 20 7a 65 72 6f 20 61 6e 64   set to zero and
2260: 20 72 65 74 75 72 6e 20 65 61 72 6c 79 2e 20 0a   return early. .
2270: 20 20 2a 2a 0a 20 20 2a 2a 20 4f 74 68 65 72 77    **.  ** Otherw
2280: 69 73 65 2c 20 66 6f 72 20 61 20 63 6f 6d 70 6f  ise, for a compo
2290: 73 69 74 65 20 66 6f 72 65 69 67 6e 20 6b 65 79  site foreign key
22a0: 20 28 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20   (more than one 
22b0: 63 6f 6c 75 6d 6e 29 2c 20 61 6c 6c 6f 63 61 74  column), allocat
22c0: 65 0a 20 20 2a 2a 20 73 70 61 63 65 20 66 6f 72  e.  ** space for
22d0: 20 74 68 65 20 61 69 43 6f 6c 20 61 72 72 61 79   the aiCol array
22e0: 20 28 72 65 74 75 72 6e 65 64 20 76 69 61 20 6f   (returned via o
22f0: 75 74 70 75 74 20 70 61 72 61 6d 65 74 65 72 20  utput parameter 
2300: 2a 70 61 69 43 6f 6c 29 2e 0a 20 20 2a 2a 20 4e  *paiCol)..  ** N
2310: 6f 6e 2d 63 6f 6d 70 6f 73 69 74 65 20 66 6f 72  on-composite for
2320: 65 69 67 6e 20 6b 65 79 73 20 64 6f 20 6e 6f 74  eign keys do not
2330: 20 72 65 71 75 69 72 65 20 74 68 65 20 61 69 43   require the aiC
2340: 6f 6c 20 61 72 72 61 79 2e 0a 20 20 2a 2f 0a 20  ol array..  */. 
2350: 20 69 66 28 20 6e 43 6f 6c 3d 3d 31 20 29 7b 0a   if( nCol==1 ){.
2360: 20 20 20 20 2f 2a 20 54 68 65 20 46 4b 20 6d 61      /* The FK ma
2370: 70 73 20 74 6f 20 74 68 65 20 49 50 4b 20 69 66  ps to the IPK if
2380: 20 61 6e 79 20 6f 66 20 74 68 65 20 66 6f 6c 6c   any of the foll
2390: 6f 77 69 6e 67 20 61 72 65 20 74 72 75 65 3a 0a  owing are true:.
23a0: 20 20 20 20 2a 2a 0a 20 20 20 20 2a 2a 20 20 20      **.    **   
23b0: 31 29 20 54 68 65 72 65 20 69 73 20 61 6e 20 49  1) There is an I
23c0: 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b  NTEGER PRIMARY K
23d0: 45 59 20 63 6f 6c 75 6d 6e 20 61 6e 64 20 74 68  EY column and th
23e0: 65 20 46 4b 20 69 73 20 69 6d 70 6c 69 63 69 74  e FK is implicit
23f0: 6c 79 20 0a 20 20 20 20 2a 2a 20 20 20 20 20 20  ly .    **      
2400: 6d 61 70 70 65 64 20 74 6f 20 74 68 65 20 70 72  mapped to the pr
2410: 69 6d 61 72 79 20 6b 65 79 20 6f 66 20 74 61 62  imary key of tab
2420: 6c 65 20 70 50 61 72 65 6e 74 2c 20 6f 72 0a 20  le pParent, or. 
2430: 20 20 20 2a 2a 20 20 20 32 29 20 54 68 65 20 46     **   2) The F
2440: 4b 20 69 73 20 65 78 70 6c 69 63 69 74 6c 79 20  K is explicitly 
2450: 6d 61 70 70 65 64 20 74 6f 20 61 20 63 6f 6c 75  mapped to a colu
2460: 6d 6e 20 64 65 63 6c 61 72 65 64 20 61 73 20 49  mn declared as I
2470: 4e 54 45 47 45 52 0a 20 20 20 20 2a 2a 20 20 20  NTEGER.    **   
2480: 20 20 20 50 52 49 4d 41 52 59 20 4b 45 59 2e 0a     PRIMARY KEY..
2490: 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 70      */.    if( p
24a0: 50 61 72 65 6e 74 2d 3e 69 50 4b 65 79 3e 3d 30  Parent->iPKey>=0
24b0: 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 21 7a   ){.      if( !z
24c0: 4b 65 79 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  Key ) return 0;.
24d0: 20 20 20 20 20 20 69 66 28 20 21 73 71 6c 69 74        if( !sqlit
24e0: 65 33 53 74 72 49 43 6d 70 28 70 50 61 72 65 6e  e3StrICmp(pParen
24f0: 74 2d 3e 61 43 6f 6c 5b 70 50 61 72 65 6e 74 2d  t->aCol[pParent-
2500: 3e 69 50 4b 65 79 5d 2e 7a 4e 61 6d 65 2c 20 7a  >iPKey].zName, z
2510: 4b 65 79 29 20 29 20 72 65 74 75 72 6e 20 30 3b  Key) ) return 0;
2520: 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20 69  .    }.  }else i
2530: 66 28 20 70 61 69 43 6f 6c 20 29 7b 0a 20 20 20  f( paiCol ){.   
2540: 20 61 73 73 65 72 74 28 20 6e 43 6f 6c 3e 31 20   assert( nCol>1 
2550: 29 3b 0a 20 20 20 20 61 69 43 6f 6c 20 3d 20 28  );.    aiCol = (
2560: 69 6e 74 20 2a 29 73 71 6c 69 74 65 33 44 62 4d  int *)sqlite3DbM
2570: 61 6c 6c 6f 63 52 61 77 28 70 50 61 72 73 65 2d  allocRaw(pParse-
2580: 3e 64 62 2c 20 6e 43 6f 6c 2a 73 69 7a 65 6f 66  >db, nCol*sizeof
2590: 28 69 6e 74 29 29 3b 0a 20 20 20 20 69 66 28 20  (int));.    if( 
25a0: 21 61 69 43 6f 6c 20 29 20 72 65 74 75 72 6e 20  !aiCol ) return 
25b0: 31 3b 0a 20 20 20 20 2a 70 61 69 43 6f 6c 20 3d  1;.    *paiCol =
25c0: 20 61 69 43 6f 6c 3b 0a 20 20 7d 0a 0a 20 20 66   aiCol;.  }..  f
25d0: 6f 72 28 70 49 64 78 3d 70 50 61 72 65 6e 74 2d  or(pIdx=pParent-
25e0: 3e 70 49 6e 64 65 78 3b 20 70 49 64 78 3b 20 70  >pIndex; pIdx; p
25f0: 49 64 78 3d 70 49 64 78 2d 3e 70 4e 65 78 74 29  Idx=pIdx->pNext)
2600: 7b 0a 20 20 20 20 69 66 28 20 70 49 64 78 2d 3e  {.    if( pIdx->
2610: 6e 4b 65 79 43 6f 6c 3d 3d 6e 43 6f 6c 20 26 26  nKeyCol==nCol &&
2620: 20 49 73 55 6e 69 71 75 65 49 6e 64 65 78 28 70   IsUniqueIndex(p
2630: 49 64 78 29 20 29 7b 20 0a 20 20 20 20 20 20 2f  Idx) ){ .      /
2640: 2a 20 70 49 64 78 20 69 73 20 61 20 55 4e 49 51  * pIdx is a UNIQ
2650: 55 45 20 69 6e 64 65 78 20 28 6f 72 20 61 20 50  UE index (or a P
2660: 52 49 4d 41 52 59 20 4b 45 59 29 20 61 6e 64 20  RIMARY KEY) and 
2670: 68 61 73 20 74 68 65 20 72 69 67 68 74 20 6e 75  has the right nu
2680: 6d 62 65 72 0a 20 20 20 20 20 20 2a 2a 20 6f 66  mber.      ** of
2690: 20 63 6f 6c 75 6d 6e 73 2e 20 49 66 20 65 61 63   columns. If eac
26a0: 68 20 69 6e 64 65 78 65 64 20 63 6f 6c 75 6d 6e  h indexed column
26b0: 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20   corresponds to 
26c0: 61 20 66 6f 72 65 69 67 6e 20 6b 65 79 0a 20 20  a foreign key.  
26d0: 20 20 20 20 2a 2a 20 63 6f 6c 75 6d 6e 20 6f 66      ** column of
26e0: 20 70 46 4b 65 79 2c 20 74 68 65 6e 20 74 68 69   pFKey, then thi
26f0: 73 20 69 6e 64 65 78 20 69 73 20 61 20 77 69 6e  s index is a win
2700: 6e 65 72 2e 20 20 2a 2f 0a 0a 20 20 20 20 20 20  ner.  */..      
2710: 69 66 28 20 7a 4b 65 79 3d 3d 30 20 29 7b 0a 20  if( zKey==0 ){. 
2720: 20 20 20 20 20 20 20 2f 2a 20 49 66 20 7a 4b 65         /* If zKe
2730: 79 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20  y is NULL, then 
2740: 74 68 69 73 20 66 6f 72 65 69 67 6e 20 6b 65 79  this foreign key
2750: 20 69 73 20 69 6d 70 6c 69 63 69 74 6c 79 20 6d   is implicitly m
2760: 61 70 70 65 64 20 74 6f 20 0a 20 20 20 20 20 20  apped to .      
2770: 20 20 2a 2a 20 74 68 65 20 50 52 49 4d 41 52 59    ** the PRIMARY
2780: 20 4b 45 59 20 6f 66 20 74 61 62 6c 65 20 70 50   KEY of table pP
2790: 61 72 65 6e 74 2e 20 54 68 65 20 50 52 49 4d 41  arent. The PRIMA
27a0: 52 59 20 4b 45 59 20 69 6e 64 65 78 20 6d 61 79  RY KEY index may
27b0: 20 62 65 20 0a 20 20 20 20 20 20 20 20 2a 2a 20   be .        ** 
27c0: 69 64 65 6e 74 69 66 69 65 64 20 62 79 20 74 68  identified by th
27d0: 65 20 74 65 73 74 2e 20 20 2a 2f 0a 20 20 20 20  e test.  */.    
27e0: 20 20 20 20 69 66 28 20 49 73 50 72 69 6d 61 72      if( IsPrimar
27f0: 79 4b 65 79 49 6e 64 65 78 28 70 49 64 78 29 20  yKeyIndex(pIdx) 
2800: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28  ){.          if(
2810: 20 61 69 43 6f 6c 20 29 7b 0a 20 20 20 20 20 20   aiCol ){.      
2820: 20 20 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20        int i;.   
2830: 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d 30           for(i=0
2840: 3b 20 69 3c 6e 43 6f 6c 3b 20 69 2b 2b 29 20 61  ; i<nCol; i++) a
2850: 69 43 6f 6c 5b 69 5d 20 3d 20 70 46 4b 65 79 2d  iCol[i] = pFKey-
2860: 3e 61 43 6f 6c 5b 69 5d 2e 69 46 72 6f 6d 3b 0a  >aCol[i].iFrom;.
2870: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20            }.    
2880: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20        break;.   
2890: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c       }.      }el
28a0: 73 65 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49  se{.        /* I
28b0: 66 20 7a 4b 65 79 20 69 73 20 6e 6f 6e 2d 4e 55  f zKey is non-NU
28c0: 4c 4c 2c 20 74 68 65 6e 20 74 68 69 73 20 66 6f  LL, then this fo
28d0: 72 65 69 67 6e 20 6b 65 79 20 77 61 73 20 64 65  reign key was de
28e0: 63 6c 61 72 65 64 20 74 6f 0a 20 20 20 20 20 20  clared to.      
28f0: 20 20 2a 2a 20 6d 61 70 20 74 6f 20 61 6e 20 65    ** map to an e
2900: 78 70 6c 69 63 69 74 20 6c 69 73 74 20 6f 66 20  xplicit list of 
2910: 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 61 62 6c 65  columns in table
2920: 20 70 50 61 72 65 6e 74 2e 20 43 68 65 63 6b 20   pParent. Check 
2930: 69 66 20 74 68 69 73 0a 20 20 20 20 20 20 20 20  if this.        
2940: 2a 2a 20 69 6e 64 65 78 20 6d 61 74 63 68 65 73  ** index matches
2950: 20 74 68 6f 73 65 20 63 6f 6c 75 6d 6e 73 2e 20   those columns. 
2960: 41 6c 73 6f 2c 20 63 68 65 63 6b 20 74 68 61 74  Also, check that
2970: 20 74 68 65 20 69 6e 64 65 78 20 75 73 65 73 0a   the index uses.
2980: 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 64          ** the d
2990: 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74 69 6f 6e  efault collation
29a0: 20 73 65 71 75 65 6e 63 65 73 20 66 6f 72 20 65   sequences for e
29b0: 61 63 68 20 63 6f 6c 75 6d 6e 2e 20 2a 2f 0a 20  ach column. */. 
29c0: 20 20 20 20 20 20 20 69 6e 74 20 69 2c 20 6a 3b         int i, j;
29d0: 0a 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d 30  .        for(i=0
29e0: 3b 20 69 3c 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a  ; i<nCol; i++){.
29f0: 20 20 20 20 20 20 20 20 20 20 69 31 36 20 69 43            i16 iC
2a00: 6f 6c 20 3d 20 70 49 64 78 2d 3e 61 69 43 6f 6c  ol = pIdx->aiCol
2a10: 75 6d 6e 5b 69 5d 3b 20 20 20 20 20 2f 2a 20 49  umn[i];     /* I
2a20: 6e 64 65 78 20 6f 66 20 63 6f 6c 75 6d 6e 20 69  ndex of column i
2a30: 6e 20 70 61 72 65 6e 74 20 74 62 6c 20 2a 2f 0a  n parent tbl */.
2a40: 20 20 20 20 20 20 20 20 20 20 63 68 61 72 20 2a            char *
2a50: 7a 44 66 6c 74 43 6f 6c 6c 3b 20 20 20 20 20 20  zDfltColl;      
2a60: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44              /* D
2a70: 65 66 2e 20 63 6f 6c 6c 61 74 69 6f 6e 20 66 6f  ef. collation fo
2a80: 72 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 20 20  r column */.    
2a90: 20 20 20 20 20 20 63 68 61 72 20 2a 7a 49 64 78        char *zIdx
2aa0: 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20  Col;            
2ab0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20          /* Name 
2ac0: 6f 66 20 69 6e 64 65 78 65 64 20 63 6f 6c 75 6d  of indexed colum
2ad0: 6e 20 2a 2f 0a 0a 20 20 20 20 20 20 20 20 20 20  n */..          
2ae0: 2f 2a 20 49 66 20 74 68 65 20 69 6e 64 65 78 20  /* If the index 
2af0: 75 73 65 73 20 61 20 63 6f 6c 6c 61 74 69 6f 6e  uses a collation
2b00: 20 73 65 71 75 65 6e 63 65 20 74 68 61 74 20 69   sequence that i
2b10: 73 20 64 69 66 66 65 72 65 6e 74 20 66 72 6f 6d  s different from
2b20: 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68  .          ** th
2b30: 65 20 64 65 66 61 75 6c 74 20 63 6f 6c 6c 61 74  e default collat
2b40: 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 66 6f 72  ion sequence for
2b50: 20 74 68 65 20 63 6f 6c 75 6d 6e 2c 20 74 68 69   the column, thi
2b60: 73 20 69 6e 64 65 78 20 69 73 0a 20 20 20 20 20  s index is.     
2b70: 20 20 20 20 20 2a 2a 20 75 6e 75 73 61 62 6c 65       ** unusable
2b80: 2e 20 42 61 69 6c 20 6f 75 74 20 65 61 72 6c 79  . Bail out early
2b90: 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 20   in this case.  
2ba0: 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 7a 44 66  */.          zDf
2bb0: 6c 74 43 6f 6c 6c 20 3d 20 70 50 61 72 65 6e 74  ltColl = pParent
2bc0: 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 2e 7a 43 6f  ->aCol[iCol].zCo
2bd0: 6c 6c 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66  ll;.          if
2be0: 28 20 21 7a 44 66 6c 74 43 6f 6c 6c 20 29 7b 0a  ( !zDfltColl ){.
2bf0: 20 20 20 20 20 20 20 20 20 20 20 20 7a 44 66 6c              zDfl
2c00: 74 43 6f 6c 6c 20 3d 20 22 42 49 4e 41 52 59 22  tColl = "BINARY"
2c10: 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20  ;.          }.  
2c20: 20 20 20 20 20 20 20 20 69 66 28 20 73 71 6c 69          if( sqli
2c30: 74 65 33 53 74 72 49 43 6d 70 28 70 49 64 78 2d  te3StrICmp(pIdx-
2c40: 3e 61 7a 43 6f 6c 6c 5b 69 5d 2c 20 7a 44 66 6c  >azColl[i], zDfl
2c50: 74 43 6f 6c 6c 29 20 29 20 62 72 65 61 6b 3b 0a  tColl) ) break;.
2c60: 0a 20 20 20 20 20 20 20 20 20 20 7a 49 64 78 43  .          zIdxC
2c70: 6f 6c 20 3d 20 70 50 61 72 65 6e 74 2d 3e 61 43  ol = pParent->aC
2c80: 6f 6c 5b 69 43 6f 6c 5d 2e 7a 4e 61 6d 65 3b 0a  ol[iCol].zName;.
2c90: 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 6a 3d            for(j=
2ca0: 30 3b 20 6a 3c 6e 43 6f 6c 3b 20 6a 2b 2b 29 7b  0; j<nCol; j++){
2cb0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28  .            if(
2cc0: 20 73 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28   sqlite3StrICmp(
2cd0: 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 6a 5d 2e 7a  pFKey->aCol[j].z
2ce0: 43 6f 6c 2c 20 7a 49 64 78 43 6f 6c 29 3d 3d 30  Col, zIdxCol)==0
2cf0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20   ){.            
2d00: 20 20 69 66 28 20 61 69 43 6f 6c 20 29 20 61 69    if( aiCol ) ai
2d10: 43 6f 6c 5b 69 5d 20 3d 20 70 46 4b 65 79 2d 3e  Col[i] = pFKey->
2d20: 61 43 6f 6c 5b 6a 5d 2e 69 46 72 6f 6d 3b 0a 20  aCol[j].iFrom;. 
2d30: 20 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65               bre
2d40: 61 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  ak;.            
2d50: 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20  }.          }.  
2d60: 20 20 20 20 20 20 20 20 69 66 28 20 6a 3d 3d 6e          if( j==n
2d70: 43 6f 6c 20 29 20 62 72 65 61 6b 3b 0a 20 20 20  Col ) break;.   
2d80: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 69       }.        i
2d90: 66 28 20 69 3d 3d 6e 43 6f 6c 20 29 20 62 72 65  f( i==nCol ) bre
2da0: 61 6b 3b 20 20 20 20 20 20 2f 2a 20 70 49 64 78  ak;      /* pIdx
2db0: 20 69 73 20 75 73 61 62 6c 65 20 2a 2f 0a 20 20   is usable */.  
2dc0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a      }.    }.  }.
2dd0: 0a 20 20 69 66 28 20 21 70 49 64 78 20 29 7b 0a  .  if( !pIdx ){.
2de0: 20 20 20 20 69 66 28 20 21 70 50 61 72 73 65 2d      if( !pParse-
2df0: 3e 64 69 73 61 62 6c 65 54 72 69 67 67 65 72 73  >disableTriggers
2e00: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
2e10: 33 45 72 72 6f 72 4d 73 67 28 70 50 61 72 73 65  3ErrorMsg(pParse
2e20: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 22 66 6f  ,.           "fo
2e30: 72 65 69 67 6e 20 6b 65 79 20 6d 69 73 6d 61 74  reign key mismat
2e40: 63 68 20 2d 20 5c 22 25 77 5c 22 20 72 65 66 65  ch - \"%w\" refe
2e50: 72 65 6e 63 69 6e 67 20 5c 22 25 77 5c 22 22 2c  rencing \"%w\"",
2e60: 0a 20 20 20 20 20 20 20 20 20 20 20 70 46 4b 65  .           pFKe
2e70: 79 2d 3e 70 46 72 6f 6d 2d 3e 7a 4e 61 6d 65 2c  y->pFrom->zName,
2e80: 20 70 46 4b 65 79 2d 3e 7a 54 6f 29 3b 0a 20 20   pFKey->zTo);.  
2e90: 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 44    }.    sqlite3D
2ea0: 62 46 72 65 65 28 70 50 61 72 73 65 2d 3e 64 62  bFree(pParse->db
2eb0: 2c 20 61 69 43 6f 6c 29 3b 0a 20 20 20 20 72 65  , aiCol);.    re
2ec0: 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 0a 20 20 2a  turn 1;.  }..  *
2ed0: 70 70 49 64 78 20 3d 20 70 49 64 78 3b 0a 20 20  ppIdx = pIdx;.  
2ee0: 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a  return 0;.}../*.
2ef0: 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e  ** This function
2f00: 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 6e 20   is called when 
2f10: 61 20 72 6f 77 20 69 73 20 69 6e 73 65 72 74 65  a row is inserte
2f20: 64 20 69 6e 74 6f 20 6f 72 20 64 65 6c 65 74 65  d into or delete
2f30: 64 20 66 72 6f 6d 20 74 68 65 20 0a 2a 2a 20 63  d from the .** c
2f40: 68 69 6c 64 20 74 61 62 6c 65 20 6f 66 20 66 6f  hild table of fo
2f50: 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72  reign key constr
2f60: 61 69 6e 74 20 70 46 4b 65 79 2e 20 49 66 20 61  aint pFKey. If a
2f70: 6e 20 53 51 4c 20 55 50 44 41 54 45 20 69 73 20  n SQL UPDATE is 
2f80: 65 78 65 63 75 74 65 64 20 0a 2a 2a 20 6f 6e 20  executed .** on 
2f90: 74 68 65 20 63 68 69 6c 64 20 74 61 62 6c 65 20  the child table 
2fa0: 6f 66 20 70 46 4b 65 79 2c 20 74 68 69 73 20 66  of pFKey, this f
2fb0: 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e 76 6f 6b  unction is invok
2fc0: 65 64 20 74 77 69 63 65 20 66 6f 72 20 65 61 63  ed twice for eac
2fd0: 68 20 72 6f 77 0a 2a 2a 20 61 66 66 65 63 74 65  h row.** affecte
2fe0: 64 20 2d 20 6f 6e 63 65 20 74 6f 20 22 64 65 6c  d - once to "del
2ff0: 65 74 65 22 20 74 68 65 20 6f 6c 64 20 72 6f 77  ete" the old row
3000: 2c 20 61 6e 64 20 74 68 65 6e 20 61 67 61 69 6e  , and then again
3010: 20 74 6f 20 22 69 6e 73 65 72 74 22 20 74 68 65   to "insert" the
3020: 0a 2a 2a 20 6e 65 77 20 72 6f 77 2e 0a 2a 2a 0a  .** new row..**.
3030: 2a 2a 20 45 61 63 68 20 74 69 6d 65 20 69 74 20  ** Each time it 
3040: 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 69 73 20  is called, this 
3050: 66 75 6e 63 74 69 6f 6e 20 67 65 6e 65 72 61 74  function generat
3060: 65 73 20 56 44 42 45 20 63 6f 64 65 20 74 6f 20  es VDBE code to 
3070: 6c 6f 63 61 74 65 20 74 68 65 0a 2a 2a 20 72 6f  locate the.** ro
3080: 77 20 69 6e 20 74 68 65 20 70 61 72 65 6e 74 20  w in the parent 
3090: 74 61 62 6c 65 20 74 68 61 74 20 63 6f 72 72 65  table that corre
30a0: 73 70 6f 6e 64 73 20 74 6f 20 74 68 65 20 72 6f  sponds to the ro
30b0: 77 20 62 65 69 6e 67 20 69 6e 73 65 72 74 65 64  w being inserted
30c0: 20 69 6e 74 6f 20 0a 2a 2a 20 6f 72 20 64 65 6c   into .** or del
30d0: 65 74 65 64 20 66 72 6f 6d 20 74 68 65 20 63 68  eted from the ch
30e0: 69 6c 64 20 74 61 62 6c 65 2e 20 49 66 20 74 68  ild table. If th
30f0: 65 20 70 61 72 65 6e 74 20 72 6f 77 20 63 61 6e  e parent row can
3100: 20 62 65 20 66 6f 75 6e 64 2c 20 6e 6f 20 0a 2a   be found, no .*
3110: 2a 20 73 70 65 63 69 61 6c 20 61 63 74 69 6f 6e  * special action
3120: 20 69 73 20 74 61 6b 65 6e 2e 20 4f 74 68 65 72   is taken. Other
3130: 77 69 73 65 2c 20 69 66 20 74 68 65 20 70 61 72  wise, if the par
3140: 65 6e 74 20 72 6f 77 20 63 61 6e 20 2a 6e 6f 74  ent row can *not
3150: 2a 20 62 65 0a 2a 2a 20 66 6f 75 6e 64 20 69 6e  * be.** found in
3160: 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c   the parent tabl
3170: 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 4f 70 65 72 61  e:.**.**   Opera
3180: 74 69 6f 6e 20 7c 20 46 4b 20 74 79 70 65 20 20  tion | FK type  
3190: 20 7c 20 41 63 74 69 6f 6e 20 74 61 6b 65 6e 0a   | Action taken.
31a0: 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  **   -----------
31b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
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 0a  ---------------.
31f0: 2a 2a 20 20 20 49 4e 53 45 52 54 20 20 20 20 20  **   INSERT     
3200: 20 69 6d 6d 65 64 69 61 74 65 20 20 20 49 6e 63   immediate   Inc
3210: 72 65 6d 65 6e 74 20 74 68 65 20 22 69 6d 6d 65  rement the "imme
3220: 64 69 61 74 65 20 63 6f 6e 73 74 72 61 69 6e 74  diate constraint
3230: 20 63 6f 75 6e 74 65 72 22 2e 0a 2a 2a 0a 2a 2a   counter"..**.**
3240: 20 20 20 44 45 4c 45 54 45 20 20 20 20 20 20 69     DELETE      i
3250: 6d 6d 65 64 69 61 74 65 20 20 20 44 65 63 72 65  mmediate   Decre
3260: 6d 65 6e 74 20 74 68 65 20 22 69 6d 6d 65 64 69  ment the "immedi
3270: 61 74 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 63  ate constraint c
3280: 6f 75 6e 74 65 72 22 2e 0a 2a 2a 0a 2a 2a 20 20  ounter"..**.**  
3290: 20 49 4e 53 45 52 54 20 20 20 20 20 20 64 65 66   INSERT      def
32a0: 65 72 72 65 64 20 20 20 20 49 6e 63 72 65 6d 65  erred    Increme
32b0: 6e 74 20 74 68 65 20 22 64 65 66 65 72 72 65 64  nt the "deferred
32c0: 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e   constraint coun
32d0: 74 65 72 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 44 45  ter"..**.**   DE
32e0: 4c 45 54 45 20 20 20 20 20 20 64 65 66 65 72 72  LETE      deferr
32f0: 65 64 20 20 20 20 44 65 63 72 65 6d 65 6e 74 20  ed    Decrement 
3300: 74 68 65 20 22 64 65 66 65 72 72 65 64 20 63 6f  the "deferred co
3310: 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e 74 65 72  nstraint counter
3320: 22 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 6f  "..**.** These o
3330: 70 65 72 61 74 69 6f 6e 73 20 61 72 65 20 69 64  perations are id
3340: 65 6e 74 69 66 69 65 64 20 69 6e 20 74 68 65 20  entified in the 
3350: 63 6f 6d 6d 65 6e 74 20 61 74 20 74 68 65 20 74  comment at the t
3360: 6f 70 20 6f 66 20 74 68 69 73 20 66 69 6c 65 20  op of this file 
3370: 0a 2a 2a 20 28 66 6b 65 79 2e 63 29 20 61 73 20  .** (fkey.c) as 
3380: 22 49 2e 31 22 20 61 6e 64 20 22 44 2e 31 22 2e  "I.1" and "D.1".
3390: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
33a0: 66 6b 4c 6f 6f 6b 75 70 50 61 72 65 6e 74 28 0a  fkLookupParent(.
33b0: 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c    Parse *pParse,
33c0: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 65          /* Parse
33d0: 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 69 6e   context */.  in
33e0: 74 20 69 44 62 2c 20 20 20 20 20 20 20 20 20 20  t iDb,          
33f0: 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20      /* Index of 
3400: 64 61 74 61 62 61 73 65 20 68 6f 75 73 69 6e 67  database housing
3410: 20 70 54 61 62 20 2a 2f 0a 20 20 54 61 62 6c 65   pTab */.  Table
3420: 20 2a 70 54 61 62 2c 20 20 20 20 20 20 20 20 20   *pTab,         
3430: 20 2f 2a 20 50 61 72 65 6e 74 20 74 61 62 6c 65   /* Parent table
3440: 20 6f 66 20 46 4b 20 70 46 4b 65 79 20 2a 2f 0a   of FK pFKey */.
3450: 20 20 49 6e 64 65 78 20 2a 70 49 64 78 2c 20 20    Index *pIdx,  
3460: 20 20 20 20 20 20 20 20 2f 2a 20 55 6e 69 71 75          /* Uniqu
3470: 65 20 69 6e 64 65 78 20 6f 6e 20 70 61 72 65 6e  e index on paren
3480: 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e  t key columns in
3490: 20 70 54 61 62 20 2a 2f 0a 20 20 46 4b 65 79 20   pTab */.  FKey 
34a0: 2a 70 46 4b 65 79 2c 20 20 20 20 20 20 20 20 20  *pFKey,         
34b0: 20 2f 2a 20 46 6f 72 65 69 67 6e 20 6b 65 79 20   /* Foreign key 
34c0: 63 6f 6e 73 74 72 61 69 6e 74 20 2a 2f 0a 20 20  constraint */.  
34d0: 69 6e 74 20 2a 61 69 43 6f 6c 2c 20 20 20 20 20  int *aiCol,     
34e0: 20 20 20 20 20 20 2f 2a 20 4d 61 70 20 66 72 6f        /* Map fro
34f0: 6d 20 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c  m parent key col
3500: 75 6d 6e 73 20 74 6f 20 63 68 69 6c 64 20 74 61  umns to child ta
3510: 62 6c 65 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a 20  ble columns */. 
3520: 20 69 6e 74 20 72 65 67 44 61 74 61 2c 20 20 20   int regData,   
3530: 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73         /* Addres
3540: 73 20 6f 66 20 61 72 72 61 79 20 63 6f 6e 74 61  s of array conta
3550: 69 6e 69 6e 67 20 63 68 69 6c 64 20 74 61 62 6c  ining child tabl
3560: 65 20 72 6f 77 20 2a 2f 0a 20 20 69 6e 74 20 6e  e row */.  int n
3570: 49 6e 63 72 2c 20 20 20 20 20 20 20 20 20 20 20  Incr,           
3580: 20 2f 2a 20 49 6e 63 72 65 6d 65 6e 74 20 63 6f   /* Increment co
3590: 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e 74 65 72  nstraint counter
35a0: 20 62 79 20 74 68 69 73 20 2a 2f 0a 20 20 69 6e   by this */.  in
35b0: 74 20 69 73 49 67 6e 6f 72 65 20 20 20 20 20 20  t isIgnore      
35c0: 20 20 20 20 2f 2a 20 49 66 20 74 72 75 65 2c 20      /* If true, 
35d0: 70 72 65 74 65 6e 64 20 70 54 61 62 20 63 6f 6e  pretend pTab con
35e0: 74 61 69 6e 73 20 61 6c 6c 20 4e 55 4c 4c 20 76  tains all NULL v
35f0: 61 6c 75 65 73 20 2a 2f 0a 29 7b 0a 20 20 69 6e  alues */.){.  in
3600: 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20  t i;            
3610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3620: 20 20 20 20 20 20 20 20 2f 2a 20 49 74 65 72 61          /* Itera
3630: 74 6f 72 20 76 61 72 69 61 62 6c 65 20 2a 2f 0a  tor variable */.
3640: 20 20 56 64 62 65 20 2a 76 20 3d 20 73 71 6c 69    Vdbe *v = sqli
3650: 74 65 33 47 65 74 56 64 62 65 28 70 50 61 72 73  te3GetVdbe(pPars
3660: 65 29 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 56  e);         /* V
3670: 64 62 65 20 74 6f 20 61 64 64 20 63 6f 64 65 20  dbe to add code 
3680: 74 6f 20 2a 2f 0a 20 20 69 6e 74 20 69 43 75 72  to */.  int iCur
3690: 20 3d 20 70 50 61 72 73 65 2d 3e 6e 54 61 62 20   = pParse->nTab 
36a0: 2d 20 31 3b 20 20 20 20 20 20 20 20 20 20 20 20  - 1;            
36b0: 20 20 2f 2a 20 43 75 72 73 6f 72 20 6e 75 6d 62    /* Cursor numb
36c0: 65 72 20 74 6f 20 75 73 65 20 2a 2f 0a 20 20 69  er to use */.  i
36d0: 6e 74 20 69 4f 6b 20 3d 20 73 71 6c 69 74 65 33  nt iOk = sqlite3
36e0: 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28 76 29  VdbeMakeLabel(v)
36f0: 3b 20 20 20 20 20 20 20 20 2f 2a 20 6a 75 6d 70  ;        /* jump
3700: 20 68 65 72 65 20 69 66 20 70 61 72 65 6e 74 20   here if parent 
3710: 6b 65 79 20 66 6f 75 6e 64 20 2a 2f 0a 0a 20 20  key found */..  
3720: 2f 2a 20 49 66 20 6e 49 6e 63 72 20 69 73 20 6c  /* If nIncr is l
3730: 65 73 73 20 74 68 61 6e 20 7a 65 72 6f 2c 20 74  ess than zero, t
3740: 68 65 6e 20 63 68 65 63 6b 20 61 74 20 72 75 6e  hen check at run
3750: 74 69 6d 65 20 69 66 20 74 68 65 72 65 20 61 72  time if there ar
3760: 65 20 61 6e 79 0a 20 20 2a 2a 20 6f 75 74 73 74  e any.  ** outst
3770: 61 6e 64 69 6e 67 20 63 6f 6e 73 74 72 61 69 6e  anding constrain
3780: 74 73 20 74 6f 20 72 65 73 6f 6c 76 65 2e 20 49  ts to resolve. I
3790: 66 20 74 68 65 72 65 20 61 72 65 20 6e 6f 74 2c  f there are not,
37a0: 20 74 68 65 72 65 20 69 73 20 6e 6f 20 6e 65 65   there is no nee
37b0: 64 0a 20 20 2a 2a 20 74 6f 20 63 68 65 63 6b 20  d.  ** to check 
37c0: 69 66 20 64 65 6c 65 74 69 6e 67 20 74 68 69 73  if deleting this
37d0: 20 72 6f 77 20 72 65 73 6f 6c 76 65 73 20 61 6e   row resolves an
37e0: 79 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 76 69  y outstanding vi
37f0: 6f 6c 61 74 69 6f 6e 73 2e 0a 20 20 2a 2a 0a 20  olations..  **. 
3800: 20 2a 2a 20 43 68 65 63 6b 20 69 66 20 61 6e 79   ** Check if any
3810: 20 6f 66 20 74 68 65 20 6b 65 79 20 63 6f 6c 75   of the key colu
3820: 6d 6e 73 20 69 6e 20 74 68 65 20 63 68 69 6c 64  mns in the child
3830: 20 74 61 62 6c 65 20 72 6f 77 20 61 72 65 20 4e   table row are N
3840: 55 4c 4c 2e 20 49 66 20 0a 20 20 2a 2a 20 61 6e  ULL. If .  ** an
3850: 79 20 61 72 65 2c 20 74 68 65 6e 20 74 68 65 20  y are, then the 
3860: 63 6f 6e 73 74 72 61 69 6e 74 20 69 73 20 63 6f  constraint is co
3870: 6e 73 69 64 65 72 65 64 20 73 61 74 69 73 66 69  nsidered satisfi
3880: 65 64 2e 20 4e 6f 20 6e 65 65 64 20 74 6f 20 0a  ed. No need to .
3890: 20 20 2a 2a 20 73 65 61 72 63 68 20 66 6f 72 20    ** search for 
38a0: 61 20 6d 61 74 63 68 69 6e 67 20 72 6f 77 20 69  a matching row i
38b0: 6e 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62  n the parent tab
38c0: 6c 65 2e 20 20 2a 2f 0a 20 20 69 66 28 20 6e 49  le.  */.  if( nI
38d0: 6e 63 72 3c 30 20 29 7b 0a 20 20 20 20 73 71 6c  ncr<0 ){.    sql
38e0: 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28 76  ite3VdbeAddOp2(v
38f0: 2c 20 4f 50 5f 46 6b 49 66 5a 65 72 6f 2c 20 70  , OP_FkIfZero, p
3900: 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 72 65 64  FKey->isDeferred
3910: 2c 20 69 4f 6b 29 3b 0a 20 20 20 20 56 64 62 65  , iOk);.    Vdbe
3920: 43 6f 76 65 72 61 67 65 28 76 29 3b 0a 20 20 7d  Coverage(v);.  }
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 20 56 64 62 65 43 6f 76 65  , iOk); VdbeCove
39b0: 72 61 67 65 28 76 29 3b 0a 20 20 7d 0a 0a 20 20  rage(v);.  }..  
39c0: 69 66 28 20 69 73 49 67 6e 6f 72 65 3d 3d 30 20  if( isIgnore==0 
39d0: 29 7b 0a 20 20 20 20 69 66 28 20 70 49 64 78 3d  ){.    if( pIdx=
39e0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49  =0 ){.      /* I
39f0: 66 20 70 49 64 78 20 69 73 20 4e 55 4c 4c 2c 20  f pIdx is NULL, 
3a00: 74 68 65 6e 20 74 68 65 20 70 61 72 65 6e 74 20  then the parent 
3a10: 6b 65 79 20 69 73 20 74 68 65 20 49 4e 54 45 47  key is the INTEG
3a20: 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 0a 20  ER PRIMARY KEY. 
3a30: 20 20 20 20 20 2a 2a 20 63 6f 6c 75 6d 6e 20 6f       ** column o
3a40: 66 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62  f the parent tab
3a50: 6c 65 20 28 74 61 62 6c 65 20 70 54 61 62 29 2e  le (table pTab).
3a60: 20 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 69    */.      int i
3a70: 4d 75 73 74 42 65 49 6e 74 3b 20 20 20 20 20 20  MustBeInt;      
3a80: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72           /* Addr
3a90: 65 73 73 20 6f 66 20 4d 75 73 74 42 65 49 6e 74  ess of MustBeInt
3aa0: 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 2a 2f 0a   instruction */.
3ab0: 20 20 20 20 20 20 69 6e 74 20 72 65 67 54 65 6d        int regTem
3ac0: 70 20 3d 20 73 71 6c 69 74 65 33 47 65 74 54 65  p = sqlite3GetTe
3ad0: 6d 70 52 65 67 28 70 50 61 72 73 65 29 3b 0a 20  mpReg(pParse);. 
3ae0: 20 0a 20 20 20 20 20 20 2f 2a 20 49 6e 76 6f 6b   .      /* Invok
3af0: 65 20 4d 75 73 74 42 65 49 6e 74 20 74 6f 20 63  e MustBeInt to c
3b00: 6f 65 72 63 65 20 74 68 65 20 63 68 69 6c 64 20  oerce the child 
3b10: 6b 65 79 20 76 61 6c 75 65 20 74 6f 20 61 6e 20  key value to an 
3b20: 69 6e 74 65 67 65 72 20 28 69 2e 65 2e 20 0a 20  integer (i.e. . 
3b30: 20 20 20 20 20 2a 2a 20 61 70 70 6c 79 20 74 68       ** apply th
3b40: 65 20 61 66 66 69 6e 69 74 79 20 6f 66 20 74 68  e affinity of th
3b50: 65 20 70 61 72 65 6e 74 20 6b 65 79 29 2e 20 49  e parent key). I
3b60: 66 20 74 68 69 73 20 66 61 69 6c 73 2c 20 74 68  f this fails, th
3b70: 65 6e 20 74 68 65 72 65 0a 20 20 20 20 20 20 2a  en there.      *
3b80: 2a 20 69 73 20 6e 6f 20 6d 61 74 63 68 69 6e 67  * is no matching
3b90: 20 70 61 72 65 6e 74 20 6b 65 79 2e 20 42 65 66   parent key. Bef
3ba0: 6f 72 65 20 75 73 69 6e 67 20 4d 75 73 74 42 65  ore using MustBe
3bb0: 49 6e 74 2c 20 6d 61 6b 65 20 61 20 63 6f 70 79  Int, make a copy
3bc0: 20 6f 66 0a 20 20 20 20 20 20 2a 2a 20 74 68 65   of.      ** the
3bd0: 20 76 61 6c 75 65 2e 20 4f 74 68 65 72 77 69 73   value. Otherwis
3be0: 65 2c 20 74 68 65 20 76 61 6c 75 65 20 69 6e 73  e, the value ins
3bf0: 65 72 74 65 64 20 69 6e 74 6f 20 74 68 65 20 63  erted into the c
3c00: 68 69 6c 64 20 6b 65 79 20 63 6f 6c 75 6d 6e 0a  hild key column.
3c10: 20 20 20 20 20 20 2a 2a 20 77 69 6c 6c 20 68 61        ** will ha
3c20: 76 65 20 49 4e 54 45 47 45 52 20 61 66 66 69 6e  ve INTEGER affin
3c30: 69 74 79 20 61 70 70 6c 69 65 64 20 74 6f 20 69  ity applied to i
3c40: 74 2c 20 77 68 69 63 68 20 6d 61 79 20 6e 6f 74  t, which may not
3c50: 20 62 65 20 63 6f 72 72 65 63 74 2e 20 20 2a 2f   be correct.  */
3c60: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
3c70: 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 53  beAddOp2(v, OP_S
3c80: 43 6f 70 79 2c 20 61 69 43 6f 6c 5b 30 5d 2b 31  Copy, aiCol[0]+1
3c90: 2b 72 65 67 44 61 74 61 2c 20 72 65 67 54 65 6d  +regData, regTem
3ca0: 70 29 3b 0a 20 20 20 20 20 20 69 4d 75 73 74 42  p);.      iMustB
3cb0: 65 49 6e 74 20 3d 20 73 71 6c 69 74 65 33 56 64  eInt = sqlite3Vd
3cc0: 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 4d  beAddOp2(v, OP_M
3cd0: 75 73 74 42 65 49 6e 74 2c 20 72 65 67 54 65 6d  ustBeInt, regTem
3ce0: 70 2c 20 30 29 3b 0a 20 20 20 20 20 20 56 64 62  p, 0);.      Vdb
3cf0: 65 43 6f 76 65 72 61 67 65 28 76 29 3b 0a 20 20  eCoverage(v);.  
3d00: 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65  .      /* If the
3d10: 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 69 73   parent table is
3d20: 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 65   the same as the
3d30: 20 63 68 69 6c 64 20 74 61 62 6c 65 2c 20 61 6e   child table, an
3d40: 64 20 77 65 20 61 72 65 20 61 62 6f 75 74 0a 20  d we are about. 
3d50: 20 20 20 20 20 2a 2a 20 74 6f 20 69 6e 63 72 65       ** to incre
3d60: 6d 65 6e 74 20 74 68 65 20 63 6f 6e 73 74 72 61  ment the constra
3d70: 69 6e 74 2d 63 6f 75 6e 74 65 72 20 28 69 2e 65  int-counter (i.e
3d80: 2e 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e 53  . this is an INS
3d90: 45 52 54 20 6f 70 65 72 61 74 69 6f 6e 29 2c 0a  ERT operation),.
3da0: 20 20 20 20 20 20 2a 2a 20 74 68 65 6e 20 63 68        ** then ch
3db0: 65 63 6b 20 69 66 20 74 68 65 20 72 6f 77 20 62  eck if the row b
3dc0: 65 69 6e 67 20 69 6e 73 65 72 74 65 64 20 6d 61  eing inserted ma
3dd0: 74 63 68 65 73 20 69 74 73 65 6c 66 2e 20 49 66  tches itself. If
3de0: 20 73 6f 2c 20 64 6f 20 6e 6f 74 0a 20 20 20 20   so, do not.    
3df0: 20 20 2a 2a 20 69 6e 63 72 65 6d 65 6e 74 20 74    ** increment t
3e00: 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 2d 63 6f  he constraint-co
3e10: 75 6e 74 65 72 2e 20 20 2a 2f 0a 20 20 20 20 20  unter.  */.     
3e20: 20 69 66 28 20 70 54 61 62 3d 3d 70 46 4b 65 79   if( pTab==pFKey
3e30: 2d 3e 70 46 72 6f 6d 20 26 26 20 6e 49 6e 63 72  ->pFrom && nIncr
3e40: 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20 20 20 73  ==1 ){.        s
3e50: 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 33  qlite3VdbeAddOp3
3e60: 28 76 2c 20 4f 50 5f 45 71 2c 20 72 65 67 44 61  (v, OP_Eq, regDa
3e70: 74 61 2c 20 69 4f 6b 2c 20 72 65 67 54 65 6d 70  ta, iOk, regTemp
3e80: 29 3b 20 56 64 62 65 43 6f 76 65 72 61 67 65 28  ); VdbeCoverage(
3e90: 76 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69  v);.        sqli
3ea0: 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 35 28  te3VdbeChangeP5(
3eb0: 76 2c 20 53 51 4c 49 54 45 5f 4e 4f 54 4e 55 4c  v, SQLITE_NOTNUL
3ec0: 4c 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 0a 20  L);.      }.  . 
3ed0: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 70 65 6e       sqlite3Open
3ee0: 54 61 62 6c 65 28 70 50 61 72 73 65 2c 20 69 43  Table(pParse, iC
3ef0: 75 72 2c 20 69 44 62 2c 20 70 54 61 62 2c 20 4f  ur, iDb, pTab, O
3f00: 50 5f 4f 70 65 6e 52 65 61 64 29 3b 0a 20 20 20  P_OpenRead);.   
3f10: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64     sqlite3VdbeAd
3f20: 64 4f 70 33 28 76 2c 20 4f 50 5f 4e 6f 74 45 78  dOp3(v, OP_NotEx
3f30: 69 73 74 73 2c 20 69 43 75 72 2c 20 30 2c 20 72  ists, iCur, 0, r
3f40: 65 67 54 65 6d 70 29 3b 20 56 64 62 65 43 6f 76  egTemp); VdbeCov
3f50: 65 72 61 67 65 28 76 29 3b 0a 20 20 20 20 20 20  erage(v);.      
3f60: 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70  sqlite3VdbeAddOp
3f70: 32 28 76 2c 20 4f 50 5f 47 6f 74 6f 2c 20 30 2c  2(v, OP_Goto, 0,
3f80: 20 69 4f 6b 29 3b 0a 20 20 20 20 20 20 73 71 6c   iOk);.      sql
3f90: 69 74 65 33 56 64 62 65 4a 75 6d 70 48 65 72 65  ite3VdbeJumpHere
3fa0: 28 76 2c 20 73 71 6c 69 74 65 33 56 64 62 65 43  (v, sqlite3VdbeC
3fb0: 75 72 72 65 6e 74 41 64 64 72 28 76 29 2d 32 29  urrentAddr(v)-2)
3fc0: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  ;.      sqlite3V
3fd0: 64 62 65 4a 75 6d 70 48 65 72 65 28 76 2c 20 69  dbeJumpHere(v, i
3fe0: 4d 75 73 74 42 65 49 6e 74 29 3b 0a 20 20 20 20  MustBeInt);.    
3ff0: 20 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 65    sqlite3Release
4000: 54 65 6d 70 52 65 67 28 70 50 61 72 73 65 2c 20  TempReg(pParse, 
4010: 72 65 67 54 65 6d 70 29 3b 0a 20 20 20 20 7d 65  regTemp);.    }e
4020: 6c 73 65 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e  lse{.      int n
4030: 43 6f 6c 20 3d 20 70 46 4b 65 79 2d 3e 6e 43 6f  Col = pFKey->nCo
4040: 6c 3b 0a 20 20 20 20 20 20 69 6e 74 20 72 65 67  l;.      int reg
4050: 54 65 6d 70 20 3d 20 73 71 6c 69 74 65 33 47 65  Temp = sqlite3Ge
4060: 74 54 65 6d 70 52 61 6e 67 65 28 70 50 61 72 73  tTempRange(pPars
4070: 65 2c 20 6e 43 6f 6c 29 3b 0a 20 20 20 20 20 20  e, nCol);.      
4080: 69 6e 74 20 72 65 67 52 65 63 20 3d 20 73 71 6c  int regRec = sql
4090: 69 74 65 33 47 65 74 54 65 6d 70 52 65 67 28 70  ite3GetTempReg(p
40a0: 50 61 72 73 65 29 3b 0a 20 20 0a 20 20 20 20 20  Parse);.  .     
40b0: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
40c0: 70 33 28 76 2c 20 4f 50 5f 4f 70 65 6e 52 65 61  p3(v, OP_OpenRea
40d0: 64 2c 20 69 43 75 72 2c 20 70 49 64 78 2d 3e 74  d, iCur, pIdx->t
40e0: 6e 75 6d 2c 20 69 44 62 29 3b 0a 20 20 20 20 20  num, iDb);.     
40f0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 50   sqlite3VdbeSetP
4100: 34 4b 65 79 49 6e 66 6f 28 70 50 61 72 73 65 2c  4KeyInfo(pParse,
4110: 20 70 49 64 78 29 3b 0a 20 20 20 20 20 20 66 6f   pIdx);.      fo
4120: 72 28 69 3d 30 3b 20 69 3c 6e 43 6f 6c 3b 20 69  r(i=0; i<nCol; i
4130: 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  ++){.        sql
4140: 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28 76  ite3VdbeAddOp2(v
4150: 2c 20 4f 50 5f 43 6f 70 79 2c 20 61 69 43 6f 6c  , OP_Copy, aiCol
4160: 5b 69 5d 2b 31 2b 72 65 67 44 61 74 61 2c 20 72  [i]+1+regData, r
4170: 65 67 54 65 6d 70 2b 69 29 3b 0a 20 20 20 20 20  egTemp+i);.     
4180: 20 7d 0a 20 20 0a 20 20 20 20 20 20 2f 2a 20 49   }.  .      /* I
4190: 66 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62  f the parent tab
41a0: 6c 65 20 69 73 20 74 68 65 20 73 61 6d 65 20 61  le is the same a
41b0: 73 20 74 68 65 20 63 68 69 6c 64 20 74 61 62 6c  s the child tabl
41c0: 65 2c 20 61 6e 64 20 77 65 20 61 72 65 20 61 62  e, and we are ab
41d0: 6f 75 74 0a 20 20 20 20 20 20 2a 2a 20 74 6f 20  out.      ** to 
41e0: 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 63 6f  increment the co
41f0: 6e 73 74 72 61 69 6e 74 2d 63 6f 75 6e 74 65 72  nstraint-counter
4200: 20 28 69 2e 65 2e 20 74 68 69 73 20 69 73 20 61   (i.e. this is a
4210: 6e 20 49 4e 53 45 52 54 20 6f 70 65 72 61 74 69  n INSERT operati
4220: 6f 6e 29 2c 0a 20 20 20 20 20 20 2a 2a 20 74 68  on),.      ** th
4230: 65 6e 20 63 68 65 63 6b 20 69 66 20 74 68 65 20  en check if the 
4240: 72 6f 77 20 62 65 69 6e 67 20 69 6e 73 65 72 74  row being insert
4250: 65 64 20 6d 61 74 63 68 65 73 20 69 74 73 65 6c  ed matches itsel
4260: 66 2e 20 49 66 20 73 6f 2c 20 64 6f 20 6e 6f 74  f. If so, do not
4270: 0a 20 20 20 20 20 20 2a 2a 20 69 6e 63 72 65 6d  .      ** increm
4280: 65 6e 74 20 74 68 65 20 63 6f 6e 73 74 72 61 69  ent the constrai
4290: 6e 74 2d 63 6f 75 6e 74 65 72 2e 20 0a 20 20 20  nt-counter. .   
42a0: 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 49     **.      ** I
42b0: 66 20 61 6e 79 20 6f 66 20 74 68 65 20 70 61 72  f any of the par
42c0: 65 6e 74 2d 6b 65 79 20 76 61 6c 75 65 73 20 61  ent-key values a
42d0: 72 65 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68  re NULL, then th
42e0: 65 20 72 6f 77 20 63 61 6e 6e 6f 74 20 6d 61 74  e row cannot mat
42f0: 63 68 20 0a 20 20 20 20 20 20 2a 2a 20 69 74 73  ch .      ** its
4300: 65 6c 66 2e 20 53 6f 20 73 65 74 20 4a 55 4d 50  elf. So set JUMP
4310: 49 46 4e 55 4c 4c 20 74 6f 20 6d 61 6b 65 20 73  IFNULL to make s
4320: 75 72 65 20 77 65 20 64 6f 20 74 68 65 20 4f 50  ure we do the OP
4330: 5f 46 6f 75 6e 64 20 69 66 20 61 6e 79 0a 20 20  _Found if any.  
4340: 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 20 70 61      ** of the pa
4350: 72 65 6e 74 2d 6b 65 79 20 76 61 6c 75 65 73 20  rent-key values 
4360: 61 72 65 20 4e 55 4c 4c 20 28 61 74 20 74 68 69  are NULL (at thi
4370: 73 20 70 6f 69 6e 74 20 69 74 20 69 73 20 6b 6e  s point it is kn
4380: 6f 77 6e 20 74 68 61 74 0a 20 20 20 20 20 20 2a  own that.      *
4390: 2a 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20 63 68  * none of the ch
43a0: 69 6c 64 20 6b 65 79 20 76 61 6c 75 65 73 20 61  ild key values a
43b0: 72 65 29 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20  re)..      */.  
43c0: 20 20 20 20 69 66 28 20 70 54 61 62 3d 3d 70 46      if( pTab==pF
43d0: 4b 65 79 2d 3e 70 46 72 6f 6d 20 26 26 20 6e 49  Key->pFrom && nI
43e0: 6e 63 72 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20  ncr==1 ){.      
43f0: 20 20 69 6e 74 20 69 4a 75 6d 70 20 3d 20 73 71    int iJump = sq
4400: 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 6e 74  lite3VdbeCurrent
4410: 41 64 64 72 28 76 29 20 2b 20 6e 43 6f 6c 20 2b  Addr(v) + nCol +
4420: 20 31 3b 0a 20 20 20 20 20 20 20 20 66 6f 72 28   1;.        for(
4430: 69 3d 30 3b 20 69 3c 6e 43 6f 6c 3b 20 69 2b 2b  i=0; i<nCol; i++
4440: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 6e 74  ){.          int
4450: 20 69 43 68 69 6c 64 20 3d 20 61 69 43 6f 6c 5b   iChild = aiCol[
4460: 69 5d 2b 31 2b 72 65 67 44 61 74 61 3b 0a 20 20  i]+1+regData;.  
4470: 20 20 20 20 20 20 20 20 69 6e 74 20 69 50 61 72          int iPar
4480: 65 6e 74 20 3d 20 70 49 64 78 2d 3e 61 69 43 6f  ent = pIdx->aiCo
4490: 6c 75 6d 6e 5b 69 5d 2b 31 2b 72 65 67 44 61 74  lumn[i]+1+regDat
44a0: 61 3b 0a 20 20 20 20 20 20 20 20 20 20 61 73 73  a;.          ass
44b0: 65 72 74 28 20 61 69 43 6f 6c 5b 69 5d 21 3d 70  ert( aiCol[i]!=p
44c0: 54 61 62 2d 3e 69 50 4b 65 79 20 29 3b 0a 20 20  Tab->iPKey );.  
44d0: 20 20 20 20 20 20 20 20 69 66 28 20 70 49 64 78          if( pIdx
44e0: 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 69 5d 3d 3d 70  ->aiColumn[i]==p
44f0: 54 61 62 2d 3e 69 50 4b 65 79 20 29 7b 0a 20 20  Tab->iPKey ){.  
4500: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65            /* The
4510: 20 70 61 72 65 6e 74 20 6b 65 79 20 69 73 20 61   parent key is a
4520: 20 63 6f 6d 70 6f 73 69 74 65 20 6b 65 79 20 74   composite key t
4530: 68 61 74 20 69 6e 63 6c 75 64 65 73 20 74 68 65  hat includes the
4540: 20 49 50 4b 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 20   IPK column */. 
4550: 20 20 20 20 20 20 20 20 20 20 20 69 50 61 72 65             iPare
4560: 6e 74 20 3d 20 72 65 67 44 61 74 61 3b 0a 20 20  nt = regData;.  
4570: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
4580: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41      sqlite3VdbeA
4590: 64 64 4f 70 33 28 76 2c 20 4f 50 5f 4e 65 2c 20  ddOp3(v, OP_Ne, 
45a0: 69 43 68 69 6c 64 2c 20 69 4a 75 6d 70 2c 20 69  iChild, iJump, i
45b0: 50 61 72 65 6e 74 29 3b 20 56 64 62 65 43 6f 76  Parent); VdbeCov
45c0: 65 72 61 67 65 28 76 29 3b 0a 20 20 20 20 20 20  erage(v);.      
45d0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 43      sqlite3VdbeC
45e0: 68 61 6e 67 65 50 35 28 76 2c 20 53 51 4c 49 54  hangeP5(v, SQLIT
45f0: 45 5f 4a 55 4d 50 49 46 4e 55 4c 4c 29 3b 0a 20  E_JUMPIFNULL);. 
4600: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20         }.       
4610: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f   sqlite3VdbeAddO
4620: 70 32 28 76 2c 20 4f 50 5f 47 6f 74 6f 2c 20 30  p2(v, OP_Goto, 0
4630: 2c 20 69 4f 6b 29 3b 0a 20 20 20 20 20 20 7d 0a  , iOk);.      }.
4640: 20 20 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33    .      sqlite3
4650: 56 64 62 65 41 64 64 4f 70 34 28 76 2c 20 4f 50  VdbeAddOp4(v, OP
4660: 5f 4d 61 6b 65 52 65 63 6f 72 64 2c 20 72 65 67  _MakeRecord, reg
4670: 54 65 6d 70 2c 20 6e 43 6f 6c 2c 20 72 65 67 52  Temp, nCol, regR
4680: 65 63 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  ec,.            
4690: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69              sqli
46a0: 74 65 33 49 6e 64 65 78 41 66 66 69 6e 69 74 79  te3IndexAffinity
46b0: 53 74 72 28 76 2c 70 49 64 78 29 2c 20 6e 43 6f  Str(v,pIdx), nCo
46c0: 6c 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  l);.      sqlite
46d0: 33 56 64 62 65 41 64 64 4f 70 34 49 6e 74 28 76  3VdbeAddOp4Int(v
46e0: 2c 20 4f 50 5f 46 6f 75 6e 64 2c 20 69 43 75 72  , OP_Found, iCur
46f0: 2c 20 69 4f 6b 2c 20 72 65 67 52 65 63 2c 20 30  , iOk, regRec, 0
4700: 29 3b 20 56 64 62 65 43 6f 76 65 72 61 67 65 28  ); VdbeCoverage(
4710: 76 29 3b 0a 20 20 0a 20 20 20 20 20 20 73 71 6c  v);.  .      sql
4720: 69 74 65 33 52 65 6c 65 61 73 65 54 65 6d 70 52  ite3ReleaseTempR
4730: 65 67 28 70 50 61 72 73 65 2c 20 72 65 67 52 65  eg(pParse, regRe
4740: 63 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  c);.      sqlite
4750: 33 52 65 6c 65 61 73 65 54 65 6d 70 52 61 6e 67  3ReleaseTempRang
4760: 65 28 70 50 61 72 73 65 2c 20 72 65 67 54 65 6d  e(pParse, regTem
4770: 70 2c 20 6e 43 6f 6c 29 3b 0a 20 20 20 20 7d 0a  p, nCol);.    }.
4780: 20 20 7d 0a 0a 20 20 69 66 28 20 21 70 46 4b 65    }..  if( !pFKe
4790: 79 2d 3e 69 73 44 65 66 65 72 72 65 64 20 26 26  y->isDeferred &&
47a0: 20 21 28 70 50 61 72 73 65 2d 3e 64 62 2d 3e 66   !(pParse->db->f
47b0: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 44 65  lags & SQLITE_De
47c0: 66 65 72 46 4b 73 29 0a 20 20 20 26 26 20 21 70  ferFKs).   && !p
47d0: 50 61 72 73 65 2d 3e 70 54 6f 70 6c 65 76 65 6c  Parse->pToplevel
47e0: 20 0a 20 20 20 26 26 20 21 70 50 61 72 73 65 2d   .   && !pParse-
47f0: 3e 69 73 4d 75 6c 74 69 57 72 69 74 65 20 0a 20  >isMultiWrite . 
4800: 20 29 7b 0a 20 20 20 20 2f 2a 20 53 70 65 63 69   ){.    /* Speci
4810: 61 6c 20 63 61 73 65 3a 20 49 66 20 74 68 69 73  al case: If this
4820: 20 69 73 20 61 6e 20 49 4e 53 45 52 54 20 73 74   is an INSERT st
4830: 61 74 65 6d 65 6e 74 20 74 68 61 74 20 77 69 6c  atement that wil
4840: 6c 20 69 6e 73 65 72 74 20 65 78 61 63 74 6c 79  l insert exactly
4850: 0a 20 20 20 20 2a 2a 20 6f 6e 65 20 72 6f 77 20  .    ** one row 
4860: 69 6e 74 6f 20 74 68 65 20 74 61 62 6c 65 2c 20  into the table, 
4870: 72 61 69 73 65 20 61 20 63 6f 6e 73 74 72 61 69  raise a constrai
4880: 6e 74 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 69  nt immediately i
4890: 6e 73 74 65 61 64 20 6f 66 0a 20 20 20 20 2a 2a  nstead of.    **
48a0: 20 69 6e 63 72 65 6d 65 6e 74 69 6e 67 20 61 20   incrementing a 
48b0: 63 6f 75 6e 74 65 72 2e 20 54 68 69 73 20 69 73  counter. This is
48c0: 20 6e 65 63 65 73 73 61 72 79 20 61 73 20 74 68   necessary as th
48d0: 65 20 56 4d 20 63 6f 64 65 20 69 73 20 62 65 69  e VM code is bei
48e0: 6e 67 0a 20 20 20 20 2a 2a 20 67 65 6e 65 72 61  ng.    ** genera
48f0: 74 65 64 20 66 6f 72 20 77 69 6c 6c 20 6e 6f 74  ted for will not
4900: 20 6f 70 65 6e 20 61 20 73 74 61 74 65 6d 65 6e   open a statemen
4910: 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20  t transaction.  
4920: 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e  */.    assert( n
4930: 49 6e 63 72 3d 3d 31 20 29 3b 0a 20 20 20 20 73  Incr==1 );.    s
4940: 71 6c 69 74 65 33 48 61 6c 74 43 6f 6e 73 74 72  qlite3HaltConstr
4950: 61 69 6e 74 28 70 50 61 72 73 65 2c 20 53 51 4c  aint(pParse, SQL
4960: 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 46  ITE_CONSTRAINT_F
4970: 4f 52 45 49 47 4e 4b 45 59 2c 0a 20 20 20 20 20  OREIGNKEY,.     
4980: 20 20 20 4f 45 5f 41 62 6f 72 74 2c 20 30 2c 20     OE_Abort, 0, 
4990: 50 34 5f 53 54 41 54 49 43 2c 20 50 35 5f 43 6f  P4_STATIC, P5_Co
49a0: 6e 73 74 72 61 69 6e 74 46 4b 29 3b 0a 20 20 7d  nstraintFK);.  }
49b0: 65 6c 73 65 7b 0a 20 20 20 20 69 66 28 20 6e 49  else{.    if( nI
49c0: 6e 63 72 3e 30 20 26 26 20 70 46 4b 65 79 2d 3e  ncr>0 && pFKey->
49d0: 69 73 44 65 66 65 72 72 65 64 3d 3d 30 20 29 7b  isDeferred==0 ){
49e0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 4d 61  .      sqlite3Ma
49f0: 79 41 62 6f 72 74 28 70 50 61 72 73 65 29 3b 0a  yAbort(pParse);.
4a00: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
4a10: 33 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f  3VdbeAddOp2(v, O
4a20: 50 5f 46 6b 43 6f 75 6e 74 65 72 2c 20 70 46 4b  P_FkCounter, pFK
4a30: 65 79 2d 3e 69 73 44 65 66 65 72 72 65 64 2c 20  ey->isDeferred, 
4a40: 6e 49 6e 63 72 29 3b 0a 20 20 7d 0a 0a 20 20 73  nIncr);.  }..  s
4a50: 71 6c 69 74 65 33 56 64 62 65 52 65 73 6f 6c 76  qlite3VdbeResolv
4a60: 65 4c 61 62 65 6c 28 76 2c 20 69 4f 6b 29 3b 0a  eLabel(v, iOk);.
4a70: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64    sqlite3VdbeAdd
4a80: 4f 70 31 28 76 2c 20 4f 50 5f 43 6c 6f 73 65 2c  Op1(v, OP_Close,
4a90: 20 69 43 75 72 29 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a   iCur);.}.../*.*
4aa0: 2a 20 52 65 74 75 72 6e 20 61 6e 20 45 78 70 72  * Return an Expr
4ab0: 20 6f 62 6a 65 63 74 20 74 68 61 74 20 72 65 66   object that ref
4ac0: 65 72 73 20 74 6f 20 61 20 6d 65 6d 6f 72 79 20  ers to a memory 
4ad0: 72 65 67 69 73 74 65 72 20 63 6f 72 72 65 73 70  register corresp
4ae0: 6f 6e 64 69 6e 67 0a 2a 2a 20 74 6f 20 63 6f 6c  onding.** to col
4af0: 75 6d 6e 20 69 43 6f 6c 20 6f 66 20 74 61 62 6c  umn iCol of tabl
4b00: 65 20 70 54 61 62 2e 0a 2a 2a 0a 2a 2a 20 72 65  e pTab..**.** re
4b10: 67 42 61 73 65 20 69 73 20 74 68 65 20 66 69 72  gBase is the fir
4b20: 73 74 20 6f 66 20 61 6e 20 61 72 72 61 79 20 6f  st of an array o
4b30: 66 20 72 65 67 69 73 74 65 72 20 74 68 61 74 20  f register that 
4b40: 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 64 61 74  contains the dat
4b50: 61 0a 2a 2a 20 66 6f 72 20 70 54 61 62 2e 20 20  a.** for pTab.  
4b60: 72 65 67 42 61 73 65 20 69 74 73 65 6c 66 20 68  regBase itself h
4b70: 6f 6c 64 73 20 74 68 65 20 72 6f 77 69 64 2e 20  olds the rowid. 
4b80: 20 72 65 67 42 61 73 65 2b 31 20 68 6f 6c 64 73   regBase+1 holds
4b90: 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 63 6f   the first.** co
4ba0: 6c 75 6d 6e 2e 20 20 72 65 67 42 61 73 65 2b 32  lumn.  regBase+2
4bb0: 20 68 6f 6c 64 73 20 74 68 65 20 73 65 63 6f 6e   holds the secon
4bc0: 64 20 63 6f 6c 75 6d 6e 2c 20 61 6e 64 20 73 6f  d column, and so
4bd0: 20 66 6f 72 74 68 2e 0a 2a 2f 0a 73 74 61 74 69   forth..*/.stati
4be0: 63 20 45 78 70 72 20 2a 65 78 70 72 54 61 62 6c  c Expr *exprTabl
4bf0: 65 52 65 67 69 73 74 65 72 28 0a 20 20 50 61 72  eRegister(.  Par
4c00: 73 65 20 2a 70 50 61 72 73 65 2c 20 20 20 20 20  se *pParse,     
4c10: 2f 2a 20 50 61 72 73 69 6e 67 20 61 6e 64 20 63  /* Parsing and c
4c20: 6f 64 65 20 67 65 6e 65 72 61 74 69 6e 67 20 63  ode generating c
4c30: 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 54 61 62 6c  ontext */.  Tabl
4c40: 65 20 2a 70 54 61 62 2c 20 20 20 20 20 20 20 2f  e *pTab,       /
4c50: 2a 20 54 68 65 20 74 61 62 6c 65 20 77 68 6f 73  * The table whos
4c60: 65 20 63 6f 6e 74 65 6e 74 20 69 73 20 61 74 20  e content is at 
4c70: 72 5b 72 65 67 42 61 73 65 5d 2e 2e 2e 20 2a 2f  r[regBase]... */
4c80: 0a 20 20 69 6e 74 20 72 65 67 42 61 73 65 2c 20  .  int regBase, 
4c90: 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65 6e 74        /* Content
4ca0: 73 20 6f 66 20 74 61 62 6c 65 20 70 54 61 62 20  s of table pTab 
4cb0: 2a 2f 0a 20 20 69 31 36 20 69 43 6f 6c 20 20 20  */.  i16 iCol   
4cc0: 20 20 20 20 20 20 20 20 2f 2a 20 57 68 69 63 68          /* Which
4cd0: 20 63 6f 6c 75 6d 6e 20 6f 66 20 70 54 61 62 20   column of pTab 
4ce0: 69 73 20 64 65 73 69 72 65 64 20 2a 2f 0a 29 7b  is desired */.){
4cf0: 0a 20 20 45 78 70 72 20 2a 70 45 78 70 72 3b 0a  .  Expr *pExpr;.
4d00: 20 20 43 6f 6c 75 6d 6e 20 2a 70 43 6f 6c 3b 0a    Column *pCol;.
4d10: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 43    const char *zC
4d20: 6f 6c 6c 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a  oll;.  sqlite3 *
4d30: 64 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b  db = pParse->db;
4d40: 0a 0a 20 20 70 45 78 70 72 20 3d 20 73 71 6c 69  ..  pExpr = sqli
4d50: 74 65 33 45 78 70 72 28 64 62 2c 20 54 4b 5f 52  te3Expr(db, TK_R
4d60: 45 47 49 53 54 45 52 2c 20 30 29 3b 0a 20 20 69  EGISTER, 0);.  i
4d70: 66 28 20 70 45 78 70 72 20 29 7b 0a 20 20 20 20  f( pExpr ){.    
4d80: 69 66 28 20 69 43 6f 6c 3e 3d 30 20 26 26 20 69  if( iCol>=0 && i
4d90: 43 6f 6c 21 3d 70 54 61 62 2d 3e 69 50 4b 65 79  Col!=pTab->iPKey
4da0: 20 29 7b 0a 20 20 20 20 20 20 70 43 6f 6c 20 3d   ){.      pCol =
4db0: 20 26 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 6f   &pTab->aCol[iCo
4dc0: 6c 5d 3b 0a 20 20 20 20 20 20 70 45 78 70 72 2d  l];.      pExpr-
4dd0: 3e 69 54 61 62 6c 65 20 3d 20 72 65 67 42 61 73  >iTable = regBas
4de0: 65 20 2b 20 69 43 6f 6c 20 2b 20 31 3b 0a 20 20  e + iCol + 1;.  
4df0: 20 20 20 20 70 45 78 70 72 2d 3e 61 66 66 69 6e      pExpr->affin
4e00: 69 74 79 20 3d 20 70 43 6f 6c 2d 3e 61 66 66 69  ity = pCol->affi
4e10: 6e 69 74 79 3b 0a 20 20 20 20 20 20 7a 43 6f 6c  nity;.      zCol
4e20: 6c 20 3d 20 70 43 6f 6c 2d 3e 7a 43 6f 6c 6c 3b  l = pCol->zColl;
4e30: 0a 20 20 20 20 20 20 69 66 28 20 7a 43 6f 6c 6c  .      if( zColl
4e40: 3d 3d 30 20 29 20 7a 43 6f 6c 6c 20 3d 20 64 62  ==0 ) zColl = db
4e50: 2d 3e 70 44 66 6c 74 43 6f 6c 6c 2d 3e 7a 4e 61  ->pDfltColl->zNa
4e60: 6d 65 3b 0a 20 20 20 20 20 20 70 45 78 70 72 20  me;.      pExpr 
4e70: 3d 20 73 71 6c 69 74 65 33 45 78 70 72 41 64 64  = sqlite3ExprAdd
4e80: 43 6f 6c 6c 61 74 65 53 74 72 69 6e 67 28 70 50  CollateString(pP
4e90: 61 72 73 65 2c 20 70 45 78 70 72 2c 20 7a 43 6f  arse, pExpr, zCo
4ea0: 6c 6c 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  ll);.    }else{.
4eb0: 20 20 20 20 20 20 70 45 78 70 72 2d 3e 69 54 61        pExpr->iTa
4ec0: 62 6c 65 20 3d 20 72 65 67 42 61 73 65 3b 0a 20  ble = regBase;. 
4ed0: 20 20 20 20 20 70 45 78 70 72 2d 3e 61 66 66 69       pExpr->affi
4ee0: 6e 69 74 79 20 3d 20 53 51 4c 49 54 45 5f 41 46  nity = SQLITE_AF
4ef0: 46 5f 49 4e 54 45 47 45 52 3b 0a 20 20 20 20 7d  F_INTEGER;.    }
4f00: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 45  .  }.  return pE
4f10: 78 70 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65  xpr;.}../*.** Re
4f20: 74 75 72 6e 20 61 6e 20 45 78 70 72 20 6f 62 6a  turn an Expr obj
4f30: 65 63 74 20 74 68 61 74 20 72 65 66 65 72 73 20  ect that refers 
4f40: 74 6f 20 63 6f 6c 75 6d 6e 20 69 43 6f 6c 20 6f  to column iCol o
4f50: 66 20 74 61 62 6c 65 20 70 54 61 62 20 77 68 69  f table pTab whi
4f60: 63 68 0a 2a 2a 20 68 61 73 20 63 75 72 73 6f 72  ch.** has cursor
4f70: 20 69 43 75 72 2e 0a 2a 2f 0a 73 74 61 74 69 63   iCur..*/.static
4f80: 20 45 78 70 72 20 2a 65 78 70 72 54 61 62 6c 65   Expr *exprTable
4f90: 43 6f 6c 75 6d 6e 28 0a 20 20 73 71 6c 69 74 65  Column(.  sqlite
4fa0: 33 20 2a 64 62 2c 20 20 20 20 20 20 2f 2a 20 54  3 *db,      /* T
4fb0: 68 65 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e  he database conn
4fc0: 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 54 61 62 6c  ection */.  Tabl
4fd0: 65 20 2a 70 54 61 62 2c 20 20 20 20 20 20 2f 2a  e *pTab,      /*
4fe0: 20 54 68 65 20 74 61 62 6c 65 20 77 68 6f 73 65   The table whose
4ff0: 20 63 6f 6c 75 6d 6e 20 69 73 20 64 65 73 69 72   column is desir
5000: 65 64 20 2a 2f 0a 20 20 69 6e 74 20 69 43 75 72  ed */.  int iCur
5010: 73 6f 72 2c 20 20 20 20 20 20 2f 2a 20 54 68 65  sor,      /* The
5020: 20 6f 70 65 6e 20 63 75 72 73 6f 72 20 6f 6e 20   open cursor on 
5030: 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 69  the table */.  i
5040: 31 36 20 69 43 6f 6c 20 20 20 20 20 20 20 20 20  16 iCol         
5050: 20 2f 2a 20 54 68 65 20 63 6f 6c 75 6d 6e 20 74   /* The column t
5060: 68 61 74 20 69 73 20 77 61 6e 74 65 64 20 2a 2f  hat is wanted */
5070: 0a 29 7b 0a 20 20 45 78 70 72 20 2a 70 45 78 70  .){.  Expr *pExp
5080: 72 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 28  r = sqlite3Expr(
5090: 64 62 2c 20 54 4b 5f 43 4f 4c 55 4d 4e 2c 20 30  db, TK_COLUMN, 0
50a0: 29 3b 0a 20 20 69 66 28 20 70 45 78 70 72 20 29  );.  if( pExpr )
50b0: 7b 0a 20 20 20 20 70 45 78 70 72 2d 3e 70 54 61  {.    pExpr->pTa
50c0: 62 20 3d 20 70 54 61 62 3b 0a 20 20 20 20 70 45  b = pTab;.    pE
50d0: 78 70 72 2d 3e 69 54 61 62 6c 65 20 3d 20 69 43  xpr->iTable = iC
50e0: 75 72 73 6f 72 3b 0a 20 20 20 20 70 45 78 70 72  ursor;.    pExpr
50f0: 2d 3e 69 43 6f 6c 75 6d 6e 20 3d 20 69 43 6f 6c  ->iColumn = iCol
5100: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70  ;.  }.  return p
5110: 45 78 70 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  Expr;.}../*.** T
5120: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
5130: 63 61 6c 6c 65 64 20 74 6f 20 67 65 6e 65 72 61  called to genera
5140: 74 65 20 63 6f 64 65 20 65 78 65 63 75 74 65 64  te code executed
5150: 20 77 68 65 6e 20 61 20 72 6f 77 20 69 73 20 64   when a row is d
5160: 65 6c 65 74 65 64 0a 2a 2a 20 66 72 6f 6d 20 74  eleted.** from t
5170: 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20  he parent table 
5180: 6f 66 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63  of foreign key c
5190: 6f 6e 73 74 72 61 69 6e 74 20 70 46 4b 65 79 20  onstraint pFKey 
51a0: 61 6e 64 2c 20 69 66 20 70 46 4b 65 79 20 69 73  and, if pFKey is
51b0: 20 0a 2a 2a 20 64 65 66 65 72 72 65 64 2c 20 77   .** deferred, w
51c0: 68 65 6e 20 61 20 72 6f 77 20 69 73 20 69 6e 73  hen a row is ins
51d0: 65 72 74 65 64 20 69 6e 74 6f 20 74 68 65 20 73  erted into the s
51e0: 61 6d 65 20 74 61 62 6c 65 2e 20 57 68 65 6e 20  ame table. When 
51f0: 67 65 6e 65 72 61 74 69 6e 67 0a 2a 2a 20 63 6f  generating.** co
5200: 64 65 20 66 6f 72 20 61 6e 20 53 51 4c 20 55 50  de for an SQL UP
5210: 44 41 54 45 20 6f 70 65 72 61 74 69 6f 6e 2c 20  DATE operation, 
5220: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61  this function ma
5230: 79 20 62 65 20 63 61 6c 6c 65 64 20 74 77 69 63  y be called twic
5240: 65 20 2d 0a 2a 2a 20 6f 6e 63 65 20 74 6f 20 22  e -.** once to "
5250: 64 65 6c 65 74 65 22 20 74 68 65 20 6f 6c 64 20  delete" the old 
5260: 72 6f 77 20 61 6e 64 20 6f 6e 63 65 20 74 6f 20  row and once to 
5270: 22 69 6e 73 65 72 74 22 20 74 68 65 20 6e 65 77  "insert" the new
5280: 20 72 6f 77 2e 0a 2a 2a 0a 2a 2a 20 50 61 72 61   row..**.** Para
5290: 6d 65 74 65 72 20 6e 49 6e 63 72 20 69 73 20 70  meter nIncr is p
52a0: 61 73 73 65 64 20 2d 31 20 77 68 65 6e 20 69 6e  assed -1 when in
52b0: 73 65 72 74 69 6e 67 20 61 20 72 6f 77 20 28 61  serting a row (a
52c0: 73 20 74 68 69 73 20 6d 61 79 20 64 65 63 72 65  s this may decre
52d0: 61 73 65 0a 2a 2a 20 74 68 65 20 6e 75 6d 62 65  ase.** the numbe
52e0: 72 20 6f 66 20 46 4b 20 76 69 6f 6c 61 74 69 6f  r of FK violatio
52f0: 6e 73 20 69 6e 20 74 68 65 20 64 62 29 20 6f 72  ns in the db) or
5300: 20 2b 31 20 77 68 65 6e 20 64 65 6c 65 74 69 6e   +1 when deletin
5310: 67 20 6f 6e 65 20 28 61 73 20 74 68 69 73 0a 2a  g one (as this.*
5320: 2a 20 6d 61 79 20 69 6e 63 72 65 61 73 65 20 74  * may increase t
5330: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 46 4b 20  he number of FK 
5340: 63 6f 6e 73 74 72 61 69 6e 74 20 70 72 6f 62 6c  constraint probl
5350: 65 6d 73 29 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  ems)..**.** The 
5360: 63 6f 64 65 20 67 65 6e 65 72 61 74 65 64 20 62  code generated b
5370: 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  y this function 
5380: 73 63 61 6e 73 20 74 68 72 6f 75 67 68 20 74 68  scans through th
5390: 65 20 72 6f 77 73 20 69 6e 20 74 68 65 20 63 68  e rows in the ch
53a0: 69 6c 64 0a 2a 2a 20 74 61 62 6c 65 20 74 68 61  ild.** table tha
53b0: 74 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20  t correspond to 
53c0: 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65  the parent table
53d0: 20 72 6f 77 20 62 65 69 6e 67 20 64 65 6c 65 74   row being delet
53e0: 65 64 20 6f 72 20 69 6e 73 65 72 74 65 64 2e 0a  ed or inserted..
53f0: 2a 2a 20 46 6f 72 20 65 61 63 68 20 63 68 69 6c  ** For each chil
5400: 64 20 72 6f 77 20 66 6f 75 6e 64 2c 20 6f 6e 65  d row found, one
5410: 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e   of the followin
5420: 67 20 61 63 74 69 6f 6e 73 20 69 73 20 74 61 6b  g actions is tak
5430: 65 6e 3a 0a 2a 2a 0a 2a 2a 20 20 20 4f 70 65 72  en:.**.**   Oper
5440: 61 74 69 6f 6e 20 7c 20 46 4b 20 74 79 70 65 20  ation | FK type 
5450: 20 20 7c 20 41 63 74 69 6f 6e 20 74 61 6b 65 6e    | Action taken
5460: 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  .**   ----------
5470: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
5480: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
5490: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
54a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
54b0: 0a 2a 2a 20 20 20 44 45 4c 45 54 45 20 20 20 20  .**   DELETE    
54c0: 20 20 69 6d 6d 65 64 69 61 74 65 20 20 20 49 6e    immediate   In
54d0: 63 72 65 6d 65 6e 74 20 74 68 65 20 22 69 6d 6d  crement the "imm
54e0: 65 64 69 61 74 65 20 63 6f 6e 73 74 72 61 69 6e  ediate constrain
54f0: 74 20 63 6f 75 6e 74 65 72 22 2e 0a 2a 2a 20 20  t counter"..**  
5500: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5510: 20 20 20 20 20 20 20 20 20 4f 72 2c 20 69 66 20           Or, if 
5520: 74 68 65 20 4f 4e 20 28 55 50 44 41 54 45 7c 44  the ON (UPDATE|D
5530: 45 4c 45 54 45 29 20 61 63 74 69 6f 6e 20 69 73  ELETE) action is
5540: 20 52 45 53 54 52 49 43 54 2c 0a 2a 2a 20 20 20   RESTRICT,.**   
5550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5560: 20 20 20 20 20 20 20 20 74 68 72 6f 77 20 61 20          throw a 
5570: 22 46 4f 52 45 49 47 4e 20 4b 45 59 20 63 6f 6e  "FOREIGN KEY con
5580: 73 74 72 61 69 6e 74 20 66 61 69 6c 65 64 22 20  straint failed" 
5590: 65 78 63 65 70 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a  exception..**.**
55a0: 20 20 20 49 4e 53 45 52 54 20 20 20 20 20 20 69     INSERT      i
55b0: 6d 6d 65 64 69 61 74 65 20 20 20 44 65 63 72 65  mmediate   Decre
55c0: 6d 65 6e 74 20 74 68 65 20 22 69 6d 6d 65 64 69  ment the "immedi
55d0: 61 74 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 63  ate constraint c
55e0: 6f 75 6e 74 65 72 22 2e 0a 2a 2a 0a 2a 2a 20 20  ounter"..**.**  
55f0: 20 44 45 4c 45 54 45 20 20 20 20 20 20 64 65 66   DELETE      def
5600: 65 72 72 65 64 20 20 20 20 49 6e 63 72 65 6d 65  erred    Increme
5610: 6e 74 20 74 68 65 20 22 64 65 66 65 72 72 65 64  nt the "deferred
5620: 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e   constraint coun
5630: 74 65 72 22 2e 0a 2a 2a 20 20 20 20 20 20 20 20  ter"..**        
5640: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5650: 20 20 20 4f 72 2c 20 69 66 20 74 68 65 20 4f 4e     Or, if the ON
5660: 20 28 55 50 44 41 54 45 7c 44 45 4c 45 54 45 29   (UPDATE|DELETE)
5670: 20 61 63 74 69 6f 6e 20 69 73 20 52 45 53 54 52   action is RESTR
5680: 49 43 54 2c 0a 2a 2a 20 20 20 20 20 20 20 20 20  ICT,.**         
5690: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
56a0: 20 20 74 68 72 6f 77 20 61 20 22 46 4f 52 45 49    throw a "FOREI
56b0: 47 4e 20 4b 45 59 20 63 6f 6e 73 74 72 61 69 6e  GN KEY constrain
56c0: 74 20 66 61 69 6c 65 64 22 20 65 78 63 65 70 74  t failed" except
56d0: 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 4e 53  ion..**.**   INS
56e0: 45 52 54 20 20 20 20 20 20 64 65 66 65 72 72 65  ERT      deferre
56f0: 64 20 20 20 20 44 65 63 72 65 6d 65 6e 74 20 74  d    Decrement t
5700: 68 65 20 22 64 65 66 65 72 72 65 64 20 63 6f 6e  he "deferred con
5710: 73 74 72 61 69 6e 74 20 63 6f 75 6e 74 65 72 22  straint counter"
5720: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 6f 70  ..**.** These op
5730: 65 72 61 74 69 6f 6e 73 20 61 72 65 20 69 64 65  erations are ide
5740: 6e 74 69 66 69 65 64 20 69 6e 20 74 68 65 20 63  ntified in the c
5750: 6f 6d 6d 65 6e 74 20 61 74 20 74 68 65 20 74 6f  omment at the to
5760: 70 20 6f 66 20 74 68 69 73 20 66 69 6c 65 20 0a  p of this file .
5770: 2a 2a 20 28 66 6b 65 79 2e 63 29 20 61 73 20 22  ** (fkey.c) as "
5780: 49 2e 32 22 20 61 6e 64 20 22 44 2e 32 22 2e 0a  I.2" and "D.2"..
5790: 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66  */.static void f
57a0: 6b 53 63 61 6e 43 68 69 6c 64 72 65 6e 28 0a 20  kScanChildren(. 
57b0: 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20   Parse *pParse, 
57c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
57d0: 20 2f 2a 20 50 61 72 73 65 20 63 6f 6e 74 65 78   /* Parse contex
57e0: 74 20 2a 2f 0a 20 20 53 72 63 4c 69 73 74 20 2a  t */.  SrcList *
57f0: 70 53 72 63 2c 20 20 20 20 20 20 20 20 20 20 20  pSrc,           
5800: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 68         /* The ch
5810: 69 6c 64 20 74 61 62 6c 65 20 74 6f 20 62 65 20  ild table to be 
5820: 73 63 61 6e 6e 65 64 20 2a 2f 0a 20 20 54 61 62  scanned */.  Tab
5830: 6c 65 20 2a 70 54 61 62 2c 20 20 20 20 20 20 20  le *pTab,       
5840: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5850: 54 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65  The parent table
5860: 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 70 49 64   */.  Index *pId
5870: 78 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  x,              
5880: 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f        /* Index o
5890: 6e 20 70 61 72 65 6e 74 20 63 6f 76 65 72 69 6e  n parent coverin
58a0: 67 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65  g the foreign ke
58b0: 79 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 46 4b  y */.  FKey *pFK
58c0: 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  ey,             
58d0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 66 6f         /* The fo
58e0: 72 65 69 67 6e 20 6b 65 79 20 6c 69 6e 6b 69 6e  reign key linkin
58f0: 67 20 70 53 72 63 20 74 6f 20 70 54 61 62 20 2a  g pSrc to pTab *
5900: 2f 0a 20 20 69 6e 74 20 2a 61 69 43 6f 6c 2c 20  /.  int *aiCol, 
5910: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5920: 20 20 20 20 2f 2a 20 4d 61 70 20 66 72 6f 6d 20      /* Map from 
5930: 70 49 64 78 20 63 6f 6c 73 20 74 6f 20 63 68 69  pIdx cols to chi
5940: 6c 64 20 74 61 62 6c 65 20 63 6f 6c 73 20 2a 2f  ld table cols */
5950: 0a 20 20 69 6e 74 20 72 65 67 44 61 74 61 2c 20  .  int regData, 
5960: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5970: 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 72 6f 77     /* Parent row
5980: 20 64 61 74 61 20 73 74 61 72 74 73 20 68 65 72   data starts her
5990: 65 20 2a 2f 0a 20 20 69 6e 74 20 6e 49 6e 63 72  e */.  int nIncr
59a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
59b0: 20 20 20 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74         /* Amount
59c0: 20 74 6f 20 69 6e 63 72 65 6d 65 6e 74 20 64 65   to increment de
59d0: 66 65 72 72 65 64 20 63 6f 75 6e 74 65 72 20 62  ferred counter b
59e0: 79 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65  y */.){.  sqlite
59f0: 33 20 2a 64 62 20 3d 20 70 50 61 72 73 65 2d 3e  3 *db = pParse->
5a00: 64 62 3b 20 20 20 20 20 20 20 2f 2a 20 44 61 74  db;       /* Dat
5a10: 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a  abase handle */.
5a20: 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20    int i;        
5a30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5a40: 20 20 2f 2a 20 49 74 65 72 61 74 6f 72 20 76 61    /* Iterator va
5a50: 72 69 61 62 6c 65 20 2a 2f 0a 20 20 45 78 70 72  riable */.  Expr
5a60: 20 2a 70 57 68 65 72 65 20 3d 20 30 3b 20 20 20   *pWhere = 0;   
5a70: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57              /* W
5a80: 48 45 52 45 20 63 6c 61 75 73 65 20 74 6f 20 73  HERE clause to s
5a90: 63 61 6e 20 77 69 74 68 20 2a 2f 0a 20 20 4e 61  can with */.  Na
5aa0: 6d 65 43 6f 6e 74 65 78 74 20 73 4e 61 6d 65 43  meContext sNameC
5ab0: 6f 6e 74 65 78 74 3b 20 20 20 20 20 20 20 2f 2a  ontext;       /*
5ac0: 20 43 6f 6e 74 65 78 74 20 75 73 65 64 20 74 6f   Context used to
5ad0: 20 72 65 73 6f 6c 76 65 20 57 48 45 52 45 20 63   resolve WHERE c
5ae0: 6c 61 75 73 65 20 2a 2f 0a 20 20 57 68 65 72 65  lause */.  Where
5af0: 49 6e 66 6f 20 2a 70 57 49 6e 66 6f 3b 20 20 20  Info *pWInfo;   
5b00: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f             /* Co
5b10: 6e 74 65 78 74 20 75 73 65 64 20 62 79 20 73 71  ntext used by sq
5b20: 6c 69 74 65 33 57 68 65 72 65 58 58 58 28 29 20  lite3WhereXXX() 
5b30: 2a 2f 0a 20 20 69 6e 74 20 69 46 6b 49 66 5a 65  */.  int iFkIfZe
5b40: 72 6f 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20  ro = 0;         
5b50: 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20       /* Address 
5b60: 6f 66 20 4f 50 5f 46 6b 49 66 5a 65 72 6f 20 2a  of OP_FkIfZero *
5b70: 2f 0a 20 20 56 64 62 65 20 2a 76 20 3d 20 73 71  /.  Vdbe *v = sq
5b80: 6c 69 74 65 33 47 65 74 56 64 62 65 28 70 50 61  lite3GetVdbe(pPa
5b90: 72 73 65 29 3b 0a 0a 20 20 61 73 73 65 72 74 28  rse);..  assert(
5ba0: 20 70 49 64 78 3d 3d 30 20 7c 7c 20 70 49 64 78   pIdx==0 || pIdx
5bb0: 2d 3e 70 54 61 62 6c 65 3d 3d 70 54 61 62 20 29  ->pTable==pTab )
5bc0: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 49 64 78  ;.  assert( pIdx
5bd0: 3d 3d 30 20 7c 7c 20 70 49 64 78 2d 3e 6e 4b 65  ==0 || pIdx->nKe
5be0: 79 43 6f 6c 3d 3d 70 46 4b 65 79 2d 3e 6e 43 6f  yCol==pFKey->nCo
5bf0: 6c 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70  l );.  assert( p
5c00: 49 64 78 21 3d 30 20 7c 7c 20 70 46 4b 65 79 2d  Idx!=0 || pFKey-
5c10: 3e 6e 43 6f 6c 3d 3d 31 20 29 3b 0a 20 20 61 73  >nCol==1 );.  as
5c20: 73 65 72 74 28 20 70 49 64 78 21 3d 30 20 7c 7c  sert( pIdx!=0 ||
5c30: 20 48 61 73 52 6f 77 69 64 28 70 54 61 62 29 20   HasRowid(pTab) 
5c40: 29 3b 0a 0a 20 20 69 66 28 20 6e 49 6e 63 72 3c  );..  if( nIncr<
5c50: 30 20 29 7b 0a 20 20 20 20 69 46 6b 49 66 5a 65  0 ){.    iFkIfZe
5c60: 72 6f 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65  ro = sqlite3Vdbe
5c70: 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 46 6b 49  AddOp2(v, OP_FkI
5c80: 66 5a 65 72 6f 2c 20 70 46 4b 65 79 2d 3e 69 73  fZero, pFKey->is
5c90: 44 65 66 65 72 72 65 64 2c 20 30 29 3b 0a 20 20  Deferred, 0);.  
5ca0: 20 20 56 64 62 65 43 6f 76 65 72 61 67 65 28 76    VdbeCoverage(v
5cb0: 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 72 65  );.  }..  /* Cre
5cc0: 61 74 65 20 61 6e 20 45 78 70 72 20 6f 62 6a 65  ate an Expr obje
5cd0: 63 74 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20  ct representing 
5ce0: 61 6e 20 53 51 4c 20 65 78 70 72 65 73 73 69 6f  an SQL expressio
5cf0: 6e 20 6c 69 6b 65 3a 0a 20 20 2a 2a 0a 20 20 2a  n like:.  **.  *
5d00: 2a 20 20 20 3c 70 61 72 65 6e 74 2d 6b 65 79 31  *   <parent-key1
5d10: 3e 20 3d 20 3c 63 68 69 6c 64 2d 6b 65 79 31 3e  > = <child-key1>
5d20: 20 41 4e 44 20 3c 70 61 72 65 6e 74 2d 6b 65 79   AND <parent-key
5d30: 32 3e 20 3d 20 3c 63 68 69 6c 64 2d 6b 65 79 32  2> = <child-key2
5d40: 3e 20 2e 2e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20  > ....  **.  ** 
5d50: 54 68 65 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65  The collation se
5d60: 71 75 65 6e 63 65 20 75 73 65 64 20 66 6f 72 20  quence used for 
5d70: 74 68 65 20 63 6f 6d 70 61 72 69 73 6f 6e 20 73  the comparison s
5d80: 68 6f 75 6c 64 20 62 65 20 74 68 61 74 20 6f 66  hould be that of
5d90: 0a 20 20 2a 2a 20 74 68 65 20 70 61 72 65 6e 74  .  ** the parent
5da0: 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 2e 20 54 68   key columns. Th
5db0: 65 20 61 66 66 69 6e 69 74 79 20 6f 66 20 74 68  e affinity of th
5dc0: 65 20 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c  e parent key col
5dd0: 75 6d 6e 20 73 68 6f 75 6c 64 0a 20 20 2a 2a 20  umn should.  ** 
5de0: 62 65 20 61 70 70 6c 69 65 64 20 74 6f 20 65 61  be applied to ea
5df0: 63 68 20 63 68 69 6c 64 20 6b 65 79 20 76 61 6c  ch child key val
5e00: 75 65 20 62 65 66 6f 72 65 20 74 68 65 20 63 6f  ue before the co
5e10: 6d 70 61 72 69 73 6f 6e 20 74 61 6b 65 73 20 70  mparison takes p
5e20: 6c 61 63 65 2e 0a 20 20 2a 2f 0a 20 20 66 6f 72  lace..  */.  for
5e30: 28 69 3d 30 3b 20 69 3c 70 46 4b 65 79 2d 3e 6e  (i=0; i<pFKey->n
5e40: 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 45  Col; i++){.    E
5e50: 78 70 72 20 2a 70 4c 65 66 74 3b 20 20 20 20 20  xpr *pLeft;     
5e60: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5e70: 56 61 6c 75 65 20 66 72 6f 6d 20 70 61 72 65 6e  Value from paren
5e80: 74 20 74 61 62 6c 65 20 72 6f 77 20 2a 2f 0a 20  t table row */. 
5e90: 20 20 20 45 78 70 72 20 2a 70 52 69 67 68 74 3b     Expr *pRight;
5ea0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5eb0: 20 2f 2a 20 43 6f 6c 75 6d 6e 20 72 65 66 20 74   /* Column ref t
5ec0: 6f 20 63 68 69 6c 64 20 74 61 62 6c 65 20 2a 2f  o child table */
5ed0: 0a 20 20 20 20 45 78 70 72 20 2a 70 45 71 3b 20  .    Expr *pEq; 
5ee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5ef0: 20 20 20 2f 2a 20 45 78 70 72 65 73 73 69 6f 6e     /* Expression
5f00: 20 28 70 4c 65 66 74 20 3d 20 70 52 69 67 68 74   (pLeft = pRight
5f10: 29 20 2a 2f 0a 20 20 20 20 69 31 36 20 69 43 6f  ) */.    i16 iCo
5f20: 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  l;              
5f30: 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20         /* Index 
5f40: 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e 20 63 68 69  of column in chi
5f50: 6c 64 20 74 61 62 6c 65 20 2a 2f 20 0a 20 20 20  ld table */ .   
5f60: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 43 6f   const char *zCo
5f70: 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  l;             /
5f80: 2a 20 4e 61 6d 65 20 6f 66 20 63 6f 6c 75 6d 6e  * Name of column
5f90: 20 69 6e 20 63 68 69 6c 64 20 74 61 62 6c 65 20   in child table 
5fa0: 2a 2f 0a 0a 20 20 20 20 69 43 6f 6c 20 3d 20 70  */..    iCol = p
5fb0: 49 64 78 20 3f 20 70 49 64 78 2d 3e 61 69 43 6f  Idx ? pIdx->aiCo
5fc0: 6c 75 6d 6e 5b 69 5d 20 3a 20 2d 31 3b 0a 20 20  lumn[i] : -1;.  
5fd0: 20 20 70 4c 65 66 74 20 3d 20 65 78 70 72 54 61    pLeft = exprTa
5fe0: 62 6c 65 52 65 67 69 73 74 65 72 28 70 50 61 72  bleRegister(pPar
5ff0: 73 65 2c 20 70 54 61 62 2c 20 72 65 67 44 61 74  se, pTab, regDat
6000: 61 2c 20 69 43 6f 6c 29 3b 0a 20 20 20 20 69 43  a, iCol);.    iC
6010: 6f 6c 20 3d 20 61 69 43 6f 6c 20 3f 20 61 69 43  ol = aiCol ? aiC
6020: 6f 6c 5b 69 5d 20 3a 20 70 46 4b 65 79 2d 3e 61  ol[i] : pFKey->a
6030: 43 6f 6c 5b 30 5d 2e 69 46 72 6f 6d 3b 0a 20 20  Col[0].iFrom;.  
6040: 20 20 61 73 73 65 72 74 28 20 69 43 6f 6c 3e 3d    assert( iCol>=
6050: 30 20 29 3b 0a 20 20 20 20 7a 43 6f 6c 20 3d 20  0 );.    zCol = 
6060: 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 2d 3e 61 43  pFKey->pFrom->aC
6070: 6f 6c 5b 69 43 6f 6c 5d 2e 7a 4e 61 6d 65 3b 0a  ol[iCol].zName;.
6080: 20 20 20 20 70 52 69 67 68 74 20 3d 20 73 71 6c      pRight = sql
6090: 69 74 65 33 45 78 70 72 28 64 62 2c 20 54 4b 5f  ite3Expr(db, TK_
60a0: 49 44 2c 20 7a 43 6f 6c 29 3b 0a 20 20 20 20 70  ID, zCol);.    p
60b0: 45 71 20 3d 20 73 71 6c 69 74 65 33 50 45 78 70  Eq = sqlite3PExp
60c0: 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 45 51 2c  r(pParse, TK_EQ,
60d0: 20 70 4c 65 66 74 2c 20 70 52 69 67 68 74 2c 20   pLeft, pRight, 
60e0: 30 29 3b 0a 20 20 20 20 70 57 68 65 72 65 20 3d  0);.    pWhere =
60f0: 20 73 71 6c 69 74 65 33 45 78 70 72 41 6e 64 28   sqlite3ExprAnd(
6100: 64 62 2c 20 70 57 68 65 72 65 2c 20 70 45 71 29  db, pWhere, pEq)
6110: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74  ;.  }..  /* If t
6120: 68 65 20 63 68 69 6c 64 20 74 61 62 6c 65 20 69  he child table i
6130: 73 20 74 68 65 20 73 61 6d 65 20 61 73 20 74 68  s the same as th
6140: 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 2c 20  e parent table, 
6150: 74 68 65 6e 20 61 64 64 20 74 65 72 6d 73 0a 20  then add terms. 
6160: 20 2a 2a 20 74 6f 20 74 68 65 20 57 48 45 52 45   ** to the WHERE
6170: 20 63 6c 61 75 73 65 20 74 68 61 74 20 70 72 65   clause that pre
6180: 76 65 6e 74 20 74 68 69 73 20 65 6e 74 72 79 20  vent this entry 
6190: 66 72 6f 6d 20 62 65 69 6e 67 20 73 63 61 6e 6e  from being scann
61a0: 65 64 2e 0a 20 20 2a 2a 20 54 68 65 20 61 64 64  ed..  ** The add
61b0: 65 64 20 57 48 45 52 45 20 63 6c 61 75 73 65 20  ed WHERE clause 
61c0: 74 65 72 6d 73 20 61 72 65 20 6c 69 6b 65 20 74  terms are like t
61d0: 68 69 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20  his:.  **.  **  
61e0: 20 20 20 24 63 75 72 72 65 6e 74 5f 72 6f 77 69     $current_rowi
61f0: 64 21 3d 72 6f 77 69 64 0a 20 20 2a 2a 20 20 20  d!=rowid.  **   
6200: 20 20 4e 4f 54 28 20 24 63 75 72 72 65 6e 74 5f    NOT( $current_
6210: 61 3d 3d 61 20 41 4e 44 20 24 63 75 72 72 65 6e  a==a AND $curren
6220: 74 5f 62 3d 3d 62 20 41 4e 44 20 2e 2e 2e 20 29  t_b==b AND ... )
6230: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 66  .  **.  ** The f
6240: 69 72 73 74 20 66 6f 72 6d 20 69 73 20 75 73 65  irst form is use
6250: 64 20 66 6f 72 20 72 6f 77 69 64 20 74 61 62 6c  d for rowid tabl
6260: 65 73 2e 20 20 54 68 65 20 73 65 63 6f 6e 64 20  es.  The second 
6270: 66 6f 72 6d 20 69 73 20 75 73 65 64 0a 20 20 2a  form is used.  *
6280: 2a 20 66 6f 72 20 57 49 54 48 4f 55 54 20 52 4f  * for WITHOUT RO
6290: 57 49 44 20 74 61 62 6c 65 73 2e 20 20 49 6e 20  WID tables.  In 
62a0: 74 68 65 20 73 65 63 6f 6e 64 20 66 6f 72 6d 2c  the second form,
62b0: 20 74 68 65 20 70 72 69 6d 61 72 79 20 6b 65 79   the primary key
62c0: 20 69 73 0a 20 20 2a 2a 20 28 61 2c 62 2c 2e 2e   is.  ** (a,b,..
62d0: 2e 29 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 54  .).  */.  if( pT
62e0: 61 62 3d 3d 70 46 4b 65 79 2d 3e 70 46 72 6f 6d  ab==pFKey->pFrom
62f0: 20 26 26 20 6e 49 6e 63 72 3e 30 20 29 7b 0a 20   && nIncr>0 ){. 
6300: 20 20 20 45 78 70 72 20 2a 70 4e 65 3b 20 20 20     Expr *pNe;   
6310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6320: 20 2f 2a 20 45 78 70 72 65 73 73 69 6f 6e 20 28   /* Expression (
6330: 70 4c 65 66 74 20 21 3d 20 70 52 69 67 68 74 29  pLeft != pRight)
6340: 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 4c   */.    Expr *pL
6350: 65 66 74 3b 20 20 20 20 20 20 20 20 20 20 20 20  eft;            
6360: 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 66        /* Value f
6370: 72 6f 6d 20 70 61 72 65 6e 74 20 74 61 62 6c 65  rom parent table
6380: 20 72 6f 77 20 2a 2f 0a 20 20 20 20 45 78 70 72   row */.    Expr
6390: 20 2a 70 52 69 67 68 74 3b 20 20 20 20 20 20 20   *pRight;       
63a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6c            /* Col
63b0: 75 6d 6e 20 72 65 66 20 74 6f 20 63 68 69 6c 64  umn ref to child
63c0: 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 69 66   table */.    if
63d0: 28 20 48 61 73 52 6f 77 69 64 28 70 54 61 62 29  ( HasRowid(pTab)
63e0: 20 29 7b 0a 20 20 20 20 20 20 70 4c 65 66 74 20   ){.      pLeft 
63f0: 3d 20 65 78 70 72 54 61 62 6c 65 52 65 67 69 73  = exprTableRegis
6400: 74 65 72 28 70 50 61 72 73 65 2c 20 70 54 61 62  ter(pParse, pTab
6410: 2c 20 72 65 67 44 61 74 61 2c 20 2d 31 29 3b 0a  , regData, -1);.
6420: 20 20 20 20 20 20 70 52 69 67 68 74 20 3d 20 65        pRight = e
6430: 78 70 72 54 61 62 6c 65 43 6f 6c 75 6d 6e 28 64  xprTableColumn(d
6440: 62 2c 20 70 54 61 62 2c 20 70 53 72 63 2d 3e 61  b, pTab, pSrc->a
6450: 5b 30 5d 2e 69 43 75 72 73 6f 72 2c 20 2d 31 29  [0].iCursor, -1)
6460: 3b 0a 20 20 20 20 20 20 70 4e 65 20 3d 20 73 71  ;.      pNe = sq
6470: 6c 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73  lite3PExpr(pPars
6480: 65 2c 20 54 4b 5f 4e 45 2c 20 70 4c 65 66 74 2c  e, TK_NE, pLeft,
6490: 20 70 52 69 67 68 74 2c 20 30 29 3b 0a 20 20 20   pRight, 0);.   
64a0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 45 78   }else{.      Ex
64b0: 70 72 20 2a 70 45 71 2c 20 2a 70 41 6c 6c 20 3d  pr *pEq, *pAll =
64c0: 20 30 3b 0a 20 20 20 20 20 20 49 6e 64 65 78 20   0;.      Index 
64d0: 2a 70 50 6b 20 3d 20 73 71 6c 69 74 65 33 50 72  *pPk = sqlite3Pr
64e0: 69 6d 61 72 79 4b 65 79 49 6e 64 65 78 28 70 54  imaryKeyIndex(pT
64f0: 61 62 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72  ab);.      asser
6500: 74 28 20 70 49 64 78 21 3d 30 20 29 3b 0a 20 20  t( pIdx!=0 );.  
6510: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70      for(i=0; i<p
6520: 50 6b 2d 3e 6e 4b 65 79 43 6f 6c 3b 20 69 2b 2b  Pk->nKeyCol; i++
6530: 29 7b 0a 20 20 20 20 20 20 20 20 69 31 36 20 69  ){.        i16 i
6540: 43 6f 6c 20 3d 20 70 49 64 78 2d 3e 61 69 43 6f  Col = pIdx->aiCo
6550: 6c 75 6d 6e 5b 69 5d 3b 0a 20 20 20 20 20 20 20  lumn[i];.       
6560: 20 70 4c 65 66 74 20 3d 20 65 78 70 72 54 61 62   pLeft = exprTab
6570: 6c 65 52 65 67 69 73 74 65 72 28 70 50 61 72 73  leRegister(pPars
6580: 65 2c 20 70 54 61 62 2c 20 72 65 67 44 61 74 61  e, pTab, regData
6590: 2c 20 69 43 6f 6c 29 3b 0a 20 20 20 20 20 20 20  , iCol);.       
65a0: 20 70 52 69 67 68 74 20 3d 20 65 78 70 72 54 61   pRight = exprTa
65b0: 62 6c 65 43 6f 6c 75 6d 6e 28 64 62 2c 20 70 54  bleColumn(db, pT
65c0: 61 62 2c 20 70 53 72 63 2d 3e 61 5b 30 5d 2e 69  ab, pSrc->a[0].i
65d0: 43 75 72 73 6f 72 2c 20 69 43 6f 6c 29 3b 0a 20  Cursor, iCol);. 
65e0: 20 20 20 20 20 20 20 70 45 71 20 3d 20 73 71 6c         pEq = sql
65f0: 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65  ite3PExpr(pParse
6600: 2c 20 54 4b 5f 45 51 2c 20 70 4c 65 66 74 2c 20  , TK_EQ, pLeft, 
6610: 70 52 69 67 68 74 2c 20 30 29 3b 0a 20 20 20 20  pRight, 0);.    
6620: 20 20 20 20 70 41 6c 6c 20 3d 20 73 71 6c 69 74      pAll = sqlit
6630: 65 33 45 78 70 72 41 6e 64 28 64 62 2c 20 70 41  e3ExprAnd(db, pA
6640: 6c 6c 2c 20 70 45 71 29 3b 0a 20 20 20 20 20 20  ll, pEq);.      
6650: 7d 0a 20 20 20 20 20 20 70 4e 65 20 3d 20 73 71  }.      pNe = sq
6660: 6c 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73  lite3PExpr(pPars
6670: 65 2c 20 54 4b 5f 4e 4f 54 2c 20 70 41 6c 6c 2c  e, TK_NOT, pAll,
6680: 20 30 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20   0, 0);.    }.  
6690: 20 20 70 57 68 65 72 65 20 3d 20 73 71 6c 69 74    pWhere = sqlit
66a0: 65 33 45 78 70 72 41 6e 64 28 64 62 2c 20 70 57  e3ExprAnd(db, pW
66b0: 68 65 72 65 2c 20 70 4e 65 29 3b 0a 20 20 7d 0a  here, pNe);.  }.
66c0: 0a 20 20 2f 2a 20 52 65 73 6f 6c 76 65 20 74 68  .  /* Resolve th
66d0: 65 20 72 65 66 65 72 65 6e 63 65 73 20 69 6e 20  e references in 
66e0: 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65  the WHERE clause
66f0: 2e 20 2a 2f 0a 20 20 6d 65 6d 73 65 74 28 26 73  . */.  memset(&s
6700: 4e 61 6d 65 43 6f 6e 74 65 78 74 2c 20 30 2c 20  NameContext, 0, 
6710: 73 69 7a 65 6f 66 28 4e 61 6d 65 43 6f 6e 74 65  sizeof(NameConte
6720: 78 74 29 29 3b 0a 20 20 73 4e 61 6d 65 43 6f 6e  xt));.  sNameCon
6730: 74 65 78 74 2e 70 53 72 63 4c 69 73 74 20 3d 20  text.pSrcList = 
6740: 70 53 72 63 3b 0a 20 20 73 4e 61 6d 65 43 6f 6e  pSrc;.  sNameCon
6750: 74 65 78 74 2e 70 50 61 72 73 65 20 3d 20 70 50  text.pParse = pP
6760: 61 72 73 65 3b 0a 20 20 73 71 6c 69 74 65 33 52  arse;.  sqlite3R
6770: 65 73 6f 6c 76 65 45 78 70 72 4e 61 6d 65 73 28  esolveExprNames(
6780: 26 73 4e 61 6d 65 43 6f 6e 74 65 78 74 2c 20 70  &sNameContext, p
6790: 57 68 65 72 65 29 3b 0a 0a 20 20 2f 2a 20 43 72  Where);..  /* Cr
67a0: 65 61 74 65 20 56 44 42 45 20 74 6f 20 6c 6f 6f  eate VDBE to loo
67b0: 70 20 74 68 72 6f 75 67 68 20 74 68 65 20 65 6e  p through the en
67c0: 74 72 69 65 73 20 69 6e 20 70 53 72 63 20 74 68  tries in pSrc th
67d0: 61 74 20 6d 61 74 63 68 20 74 68 65 20 57 48 45  at match the WHE
67e0: 52 45 0a 20 20 2a 2a 20 63 6c 61 75 73 65 2e 20  RE.  ** clause. 
67f0: 46 6f 72 20 65 61 63 68 20 72 6f 77 20 66 6f 75  For each row fou
6800: 6e 64 2c 20 69 6e 63 72 65 6d 65 6e 74 20 65 69  nd, increment ei
6810: 74 68 65 72 20 74 68 65 20 64 65 66 65 72 72 65  ther the deferre
6820: 64 20 6f 72 20 69 6d 6d 65 64 69 61 74 65 0a 20  d or immediate. 
6830: 20 2a 2a 20 66 6f 72 65 69 67 6e 20 6b 65 79 20   ** foreign key 
6840: 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e 74  constraint count
6850: 65 72 2e 20 2a 2f 0a 20 20 70 57 49 6e 66 6f 20  er. */.  pWInfo 
6860: 3d 20 73 71 6c 69 74 65 33 57 68 65 72 65 42 65  = sqlite3WhereBe
6870: 67 69 6e 28 70 50 61 72 73 65 2c 20 70 53 72 63  gin(pParse, pSrc
6880: 2c 20 70 57 68 65 72 65 2c 20 30 2c 20 30 2c 20  , pWhere, 0, 0, 
6890: 30 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 33  0, 0);.  sqlite3
68a0: 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50  VdbeAddOp2(v, OP
68b0: 5f 46 6b 43 6f 75 6e 74 65 72 2c 20 70 46 4b 65  _FkCounter, pFKe
68c0: 79 2d 3e 69 73 44 65 66 65 72 72 65 64 2c 20 6e  y->isDeferred, n
68d0: 49 6e 63 72 29 3b 0a 20 20 69 66 28 20 70 57 49  Incr);.  if( pWI
68e0: 6e 66 6f 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  nfo ){.    sqlit
68f0: 65 33 57 68 65 72 65 45 6e 64 28 70 57 49 6e 66  e3WhereEnd(pWInf
6900: 6f 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 6c  o);.  }..  /* Cl
6910: 65 61 6e 20 75 70 20 74 68 65 20 57 48 45 52 45  ean up the WHERE
6920: 20 63 6c 61 75 73 65 20 63 6f 6e 73 74 72 75 63   clause construc
6930: 74 65 64 20 61 62 6f 76 65 2e 20 2a 2f 0a 20 20  ted above. */.  
6940: 73 71 6c 69 74 65 33 45 78 70 72 44 65 6c 65 74  sqlite3ExprDelet
6950: 65 28 64 62 2c 20 70 57 68 65 72 65 29 3b 0a 20  e(db, pWhere);. 
6960: 20 69 66 28 20 69 46 6b 49 66 5a 65 72 6f 20 29   if( iFkIfZero )
6970: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  {.    sqlite3Vdb
6980: 65 4a 75 6d 70 48 65 72 65 28 76 2c 20 69 46 6b  eJumpHere(v, iFk
6990: 49 66 5a 65 72 6f 29 3b 0a 20 20 7d 0a 7d 0a 0a  IfZero);.  }.}..
69a0: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
69b0: 69 6f 6e 20 72 65 74 75 72 6e 73 20 61 20 6c 69  ion returns a li
69c0: 6e 6b 65 64 20 6c 69 73 74 20 6f 66 20 46 4b 65  nked list of FKe
69d0: 79 20 6f 62 6a 65 63 74 73 20 28 63 6f 6e 6e 65  y objects (conne
69e0: 63 74 65 64 20 62 79 0a 2a 2a 20 46 4b 65 79 2e  cted by.** FKey.
69f0: 70 4e 65 78 74 54 6f 29 20 68 6f 6c 64 69 6e 67  pNextTo) holding
6a00: 20 61 6c 6c 20 63 68 69 6c 64 72 65 6e 20 6f 66   all children of
6a10: 20 74 61 62 6c 65 20 70 54 61 62 2e 20 20 46 6f   table pTab.  Fo
6a20: 72 20 65 78 61 6d 70 6c 65 2c 0a 2a 2a 20 67 69  r example,.** gi
6a30: 76 65 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  ven the followin
6a40: 67 20 73 63 68 65 6d 61 3a 0a 2a 2a 0a 2a 2a 20  g schema:.**.** 
6a50: 20 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 74    CREATE TABLE t
6a60: 31 28 61 20 50 52 49 4d 41 52 59 20 4b 45 59 29  1(a PRIMARY KEY)
6a70: 3b 0a 2a 2a 20 20 20 43 52 45 41 54 45 20 54 41  ;.**   CREATE TA
6a80: 42 4c 45 20 74 32 28 62 20 52 45 46 45 52 45 4e  BLE t2(b REFEREN
6a90: 43 45 53 20 74 31 28 61 29 3b 0a 2a 2a 0a 2a 2a  CES t1(a);.**.**
6aa0: 20 43 61 6c 6c 69 6e 67 20 74 68 69 73 20 66 75   Calling this fu
6ab0: 6e 63 74 69 6f 6e 20 77 69 74 68 20 74 61 62 6c  nction with tabl
6ac0: 65 20 22 74 31 22 20 61 73 20 61 6e 20 61 72 67  e "t1" as an arg
6ad0: 75 6d 65 6e 74 20 72 65 74 75 72 6e 73 20 61 20  ument returns a 
6ae0: 70 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 68  pointer.** to th
6af0: 65 20 46 4b 65 79 20 73 74 72 75 63 74 75 72 65  e FKey structure
6b00: 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68   representing th
6b10: 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f  e foreign key co
6b20: 6e 73 74 72 61 69 6e 74 20 6f 6e 20 74 61 62 6c  nstraint on tabl
6b30: 65 0a 2a 2a 20 22 74 32 22 2e 20 43 61 6c 6c 69  e.** "t2". Calli
6b40: 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  ng this function
6b50: 20 77 69 74 68 20 22 74 32 22 20 61 73 20 74 68   with "t2" as th
6b60: 65 20 61 72 67 75 6d 65 6e 74 20 77 6f 75 6c 64  e argument would
6b70: 20 72 65 74 75 72 6e 20 61 0a 2a 2a 20 4e 55 4c   return a.** NUL
6b80: 4c 20 70 6f 69 6e 74 65 72 20 28 61 73 20 74 68  L pointer (as th
6b90: 65 72 65 20 61 72 65 20 6e 6f 20 46 4b 20 63 6f  ere are no FK co
6ba0: 6e 73 74 72 61 69 6e 74 73 20 66 6f 72 20 77 68  nstraints for wh
6bb0: 69 63 68 20 74 32 20 69 73 20 74 68 65 20 70 61  ich t2 is the pa
6bc0: 72 65 6e 74 0a 2a 2a 20 74 61 62 6c 65 29 2e 0a  rent.** table)..
6bd0: 2a 2f 0a 46 4b 65 79 20 2a 73 71 6c 69 74 65 33  */.FKey *sqlite3
6be0: 46 6b 52 65 66 65 72 65 6e 63 65 73 28 54 61 62  FkReferences(Tab
6bf0: 6c 65 20 2a 70 54 61 62 29 7b 0a 20 20 72 65 74  le *pTab){.  ret
6c00: 75 72 6e 20 28 46 4b 65 79 20 2a 29 73 71 6c 69  urn (FKey *)sqli
6c10: 74 65 33 48 61 73 68 46 69 6e 64 28 26 70 54 61  te3HashFind(&pTa
6c20: 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 6b 65 79  b->pSchema->fkey
6c30: 48 61 73 68 2c 20 70 54 61 62 2d 3e 7a 4e 61 6d  Hash, pTab->zNam
6c40: 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65  e);.}../*.** The
6c50: 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74   second argument
6c60: 20 69 73 20 61 20 54 72 69 67 67 65 72 20 73 74   is a Trigger st
6c70: 72 75 63 74 75 72 65 20 61 6c 6c 6f 63 61 74 65  ructure allocate
6c80: 64 20 62 79 20 74 68 65 20 0a 2a 2a 20 66 6b 41  d by the .** fkA
6c90: 63 74 69 6f 6e 54 72 69 67 67 65 72 28 29 20 72  ctionTrigger() r
6ca0: 6f 75 74 69 6e 65 2e 20 54 68 69 73 20 66 75 6e  outine. This fun
6cb0: 63 74 69 6f 6e 20 64 65 6c 65 74 65 73 20 74 68  ction deletes th
6cc0: 65 20 54 72 69 67 67 65 72 20 73 74 72 75 63 74  e Trigger struct
6cd0: 75 72 65 0a 2a 2a 20 61 6e 64 20 61 6c 6c 20 6f  ure.** and all o
6ce0: 66 20 69 74 73 20 73 75 62 2d 63 6f 6d 70 6f 6e  f its sub-compon
6cf0: 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20  ents..**.** The 
6d00: 54 72 69 67 67 65 72 20 73 74 72 75 63 74 75 72  Trigger structur
6d10: 65 20 6f 72 20 61 6e 79 20 6f 66 20 69 74 73 20  e or any of its 
6d20: 73 75 62 2d 63 6f 6d 70 6f 6e 65 6e 74 73 20 6d  sub-components m
6d30: 61 79 20 62 65 20 61 6c 6c 6f 63 61 74 65 64 20  ay be allocated 
6d40: 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 6c 6f 6f 6b  from.** the look
6d50: 61 73 69 64 65 20 62 75 66 66 65 72 20 62 65 6c  aside buffer bel
6d60: 6f 6e 67 69 6e 67 20 74 6f 20 64 61 74 61 62 61  onging to databa
6d70: 73 65 20 68 61 6e 64 6c 65 20 64 62 4d 65 6d 2e  se handle dbMem.
6d80: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
6d90: 66 6b 54 72 69 67 67 65 72 44 65 6c 65 74 65 28  fkTriggerDelete(
6da0: 73 71 6c 69 74 65 33 20 2a 64 62 4d 65 6d 2c 20  sqlite3 *dbMem, 
6db0: 54 72 69 67 67 65 72 20 2a 70 29 7b 0a 20 20 69  Trigger *p){.  i
6dc0: 66 28 20 70 20 29 7b 0a 20 20 20 20 54 72 69 67  f( p ){.    Trig
6dd0: 67 65 72 53 74 65 70 20 2a 70 53 74 65 70 20 3d  gerStep *pStep =
6de0: 20 70 2d 3e 73 74 65 70 5f 6c 69 73 74 3b 0a 20   p->step_list;. 
6df0: 20 20 20 73 71 6c 69 74 65 33 45 78 70 72 44 65     sqlite3ExprDe
6e00: 6c 65 74 65 28 64 62 4d 65 6d 2c 20 70 53 74 65  lete(dbMem, pSte
6e10: 70 2d 3e 70 57 68 65 72 65 29 3b 0a 20 20 20 20  p->pWhere);.    
6e20: 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 44  sqlite3ExprListD
6e30: 65 6c 65 74 65 28 64 62 4d 65 6d 2c 20 70 53 74  elete(dbMem, pSt
6e40: 65 70 2d 3e 70 45 78 70 72 4c 69 73 74 29 3b 0a  ep->pExprList);.
6e50: 20 20 20 20 73 71 6c 69 74 65 33 53 65 6c 65 63      sqlite3Selec
6e60: 74 44 65 6c 65 74 65 28 64 62 4d 65 6d 2c 20 70  tDelete(dbMem, p
6e70: 53 74 65 70 2d 3e 70 53 65 6c 65 63 74 29 3b 0a  Step->pSelect);.
6e80: 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 72 44      sqlite3ExprD
6e90: 65 6c 65 74 65 28 64 62 4d 65 6d 2c 20 70 2d 3e  elete(dbMem, p->
6ea0: 70 57 68 65 6e 29 3b 0a 20 20 20 20 73 71 6c 69  pWhen);.    sqli
6eb0: 74 65 33 44 62 46 72 65 65 28 64 62 4d 65 6d 2c  te3DbFree(dbMem,
6ec0: 20 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a   p);.  }.}../*.*
6ed0: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
6ee0: 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 67 65 6e  is called to gen
6ef0: 65 72 61 74 65 20 63 6f 64 65 20 74 68 61 74 20  erate code that 
6f00: 72 75 6e 73 20 77 68 65 6e 20 74 61 62 6c 65 20  runs when table 
6f10: 70 54 61 62 20 69 73 0a 2a 2a 20 62 65 69 6e 67  pTab is.** being
6f20: 20 64 72 6f 70 70 65 64 20 66 72 6f 6d 20 74 68   dropped from th
6f30: 65 20 64 61 74 61 62 61 73 65 2e 20 54 68 65 20  e database. The 
6f40: 53 72 63 4c 69 73 74 20 70 61 73 73 65 64 20 61  SrcList passed a
6f50: 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 72 67  s the second arg
6f60: 75 6d 65 6e 74 0a 2a 2a 20 74 6f 20 74 68 69 73  ument.** to this
6f70: 20 66 75 6e 63 74 69 6f 6e 20 63 6f 6e 74 61 69   function contai
6f80: 6e 73 20 61 20 73 69 6e 67 6c 65 20 65 6e 74 72  ns a single entr
6f90: 79 20 67 75 61 72 61 6e 74 65 65 64 20 74 6f 20  y guaranteed to 
6fa0: 72 65 73 6f 6c 76 65 20 74 6f 0a 2a 2a 20 74 61  resolve to.** ta
6fb0: 62 6c 65 20 70 54 61 62 2e 0a 2a 2a 0a 2a 2a 20  ble pTab..**.** 
6fc0: 4e 6f 72 6d 61 6c 6c 79 2c 20 6e 6f 20 63 6f 64  Normally, no cod
6fd0: 65 20 69 73 20 72 65 71 75 69 72 65 64 2e 20 48  e is required. H
6fe0: 6f 77 65 76 65 72 2c 20 69 66 20 65 69 74 68 65  owever, if eithe
6ff0: 72 0a 2a 2a 0a 2a 2a 20 20 20 28 61 29 20 54 68  r.**.**   (a) Th
7000: 65 20 74 61 62 6c 65 20 69 73 20 74 68 65 20 70  e table is the p
7010: 61 72 65 6e 74 20 74 61 62 6c 65 20 6f 66 20 61  arent table of a
7020: 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74 2c 20   FK constraint, 
7030: 6f 72 0a 2a 2a 20 20 20 28 62 29 20 54 68 65 20  or.**   (b) The 
7040: 74 61 62 6c 65 20 69 73 20 74 68 65 20 63 68 69  table is the chi
7050: 6c 64 20 74 61 62 6c 65 20 6f 66 20 61 20 64 65  ld table of a de
7060: 66 65 72 72 65 64 20 46 4b 20 63 6f 6e 73 74 72  ferred FK constr
7070: 61 69 6e 74 20 61 6e 64 20 69 74 20 69 73 0a 2a  aint and it is.*
7080: 2a 20 20 20 20 20 20 20 64 65 74 65 72 6d 69 6e  *       determin
7090: 65 64 20 61 74 20 72 75 6e 74 69 6d 65 20 74 68  ed at runtime th
70a0: 61 74 20 74 68 65 72 65 20 61 72 65 20 6f 75 74  at there are out
70b0: 73 74 61 6e 64 69 6e 67 20 64 65 66 65 72 72 65  standing deferre
70c0: 64 20 46 4b 20 0a 2a 2a 20 20 20 20 20 20 20 63  d FK .**       c
70d0: 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74  onstraint violat
70e0: 69 6f 6e 73 20 69 6e 20 74 68 65 20 64 61 74 61  ions in the data
70f0: 62 61 73 65 2c 0a 2a 2a 0a 2a 2a 20 74 68 65 6e  base,.**.** then
7100: 20 74 68 65 20 65 71 75 69 76 61 6c 65 6e 74 20   the equivalent 
7110: 6f 66 20 22 44 45 4c 45 54 45 20 46 52 4f 4d 20  of "DELETE FROM 
7120: 3c 74 62 6c 3e 22 20 69 73 20 65 78 65 63 75 74  <tbl>" is execut
7130: 65 64 20 62 65 66 6f 72 65 20 64 72 6f 70 70 69  ed before droppi
7140: 6e 67 0a 2a 2a 20 74 68 65 20 74 61 62 6c 65 20  ng.** the table 
7150: 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73  from the databas
7160: 65 2e 20 54 72 69 67 67 65 72 73 20 61 72 65 20  e. Triggers are 
7170: 64 69 73 61 62 6c 65 64 20 77 68 69 6c 65 20 72  disabled while r
7180: 75 6e 6e 69 6e 67 20 74 68 69 73 0a 2a 2a 20 44  unning this.** D
7190: 45 4c 45 54 45 2c 20 62 75 74 20 66 6f 72 65 69  ELETE, but forei
71a0: 67 6e 20 6b 65 79 20 61 63 74 69 6f 6e 73 20 61  gn key actions a
71b0: 72 65 20 6e 6f 74 2e 0a 2a 2f 0a 76 6f 69 64 20  re not..*/.void 
71c0: 73 71 6c 69 74 65 33 46 6b 44 72 6f 70 54 61 62  sqlite3FkDropTab
71d0: 6c 65 28 50 61 72 73 65 20 2a 70 50 61 72 73 65  le(Parse *pParse
71e0: 2c 20 53 72 63 4c 69 73 74 20 2a 70 4e 61 6d 65  , SrcList *pName
71f0: 2c 20 54 61 62 6c 65 20 2a 70 54 61 62 29 7b 0a  , Table *pTab){.
7200: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20    sqlite3 *db = 
7210: 70 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 69 66  pParse->db;.  if
7220: 28 20 28 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c  ( (db->flags&SQL
7230: 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73 29  ITE_ForeignKeys)
7240: 20 26 26 20 21 49 73 56 69 72 74 75 61 6c 28 70   && !IsVirtual(p
7250: 54 61 62 29 20 26 26 20 21 70 54 61 62 2d 3e 70  Tab) && !pTab->p
7260: 53 65 6c 65 63 74 20 29 7b 0a 20 20 20 20 69 6e  Select ){.    in
7270: 74 20 69 53 6b 69 70 20 3d 20 30 3b 0a 20 20 20  t iSkip = 0;.   
7280: 20 56 64 62 65 20 2a 76 20 3d 20 73 71 6c 69 74   Vdbe *v = sqlit
7290: 65 33 47 65 74 56 64 62 65 28 70 50 61 72 73 65  e3GetVdbe(pParse
72a0: 29 3b 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20  );..    assert( 
72b0: 76 20 29 3b 20 20 20 20 20 20 20 20 20 20 20 20  v );            
72c0: 20 20 20 20 20 20 2f 2a 20 56 44 42 45 20 68 61        /* VDBE ha
72d0: 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 61  s already been a
72e0: 6c 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20 20 20  llocated */.    
72f0: 69 66 28 20 73 71 6c 69 74 65 33 46 6b 52 65 66  if( sqlite3FkRef
7300: 65 72 65 6e 63 65 73 28 70 54 61 62 29 3d 3d 30  erences(pTab)==0
7310: 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 53 65 61   ){.      /* Sea
7320: 72 63 68 20 66 6f 72 20 61 20 64 65 66 65 72 72  rch for a deferr
7330: 65 64 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63  ed foreign key c
7340: 6f 6e 73 74 72 61 69 6e 74 20 66 6f 72 20 77 68  onstraint for wh
7350: 69 63 68 20 74 68 69 73 20 74 61 62 6c 65 0a 20  ich this table. 
7360: 20 20 20 20 20 2a 2a 20 69 73 20 74 68 65 20 63       ** is the c
7370: 68 69 6c 64 20 74 61 62 6c 65 2e 20 49 66 20 6f  hild table. If o
7380: 6e 65 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75  ne cannot be fou
7390: 6e 64 2c 20 72 65 74 75 72 6e 20 77 69 74 68 6f  nd, return witho
73a0: 75 74 20 0a 20 20 20 20 20 20 2a 2a 20 67 65 6e  ut .      ** gen
73b0: 65 72 61 74 69 6e 67 20 61 6e 79 20 56 44 42 45  erating any VDBE
73c0: 20 63 6f 64 65 2e 20 49 66 20 6f 6e 65 20 63 61   code. If one ca
73d0: 6e 20 62 65 20 66 6f 75 6e 64 2c 20 74 68 65 6e  n be found, then
73e0: 20 6a 75 6d 70 20 6f 76 65 72 0a 20 20 20 20 20   jump over.     
73f0: 20 2a 2a 20 74 68 65 20 65 6e 74 69 72 65 20 44   ** the entire D
7400: 45 4c 45 54 45 20 69 66 20 74 68 65 72 65 20 61  ELETE if there a
7410: 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e  re no outstandin
7420: 67 20 64 65 66 65 72 72 65 64 20 63 6f 6e 73 74  g deferred const
7430: 72 61 69 6e 74 73 0a 20 20 20 20 20 20 2a 2a 20  raints.      ** 
7440: 77 68 65 6e 20 74 68 69 73 20 73 74 61 74 65 6d  when this statem
7450: 65 6e 74 20 69 73 20 72 75 6e 2e 20 20 2a 2f 0a  ent is run.  */.
7460: 20 20 20 20 20 20 46 4b 65 79 20 2a 70 3b 0a 20        FKey *p;. 
7470: 20 20 20 20 20 66 6f 72 28 70 3d 70 54 61 62 2d       for(p=pTab-
7480: 3e 70 46 4b 65 79 3b 20 70 3b 20 70 3d 70 2d 3e  >pFKey; p; p=p->
7490: 70 4e 65 78 74 46 72 6f 6d 29 7b 0a 20 20 20 20  pNextFrom){.    
74a0: 20 20 20 20 69 66 28 20 70 2d 3e 69 73 44 65 66      if( p->isDef
74b0: 65 72 72 65 64 20 7c 7c 20 28 64 62 2d 3e 66 6c  erred || (db->fl
74c0: 61 67 73 20 26 20 53 51 4c 49 54 45 5f 44 65 66  ags & SQLITE_Def
74d0: 65 72 46 4b 73 29 20 29 20 62 72 65 61 6b 3b 0a  erFKs) ) break;.
74e0: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66        }.      if
74f0: 28 20 21 70 20 29 20 72 65 74 75 72 6e 3b 0a 20  ( !p ) return;. 
7500: 20 20 20 20 20 69 53 6b 69 70 20 3d 20 73 71 6c       iSkip = sql
7510: 69 74 65 33 56 64 62 65 4d 61 6b 65 4c 61 62 65  ite3VdbeMakeLabe
7520: 6c 28 76 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  l(v);.      sqli
7530: 74 65 33 56 64 62 65 41 64 64 4f 70 32 28 76 2c  te3VdbeAddOp2(v,
7540: 20 4f 50 5f 46 6b 49 66 5a 65 72 6f 2c 20 31 2c   OP_FkIfZero, 1,
7550: 20 69 53 6b 69 70 29 3b 20 56 64 62 65 43 6f 76   iSkip); VdbeCov
7560: 65 72 61 67 65 28 76 29 3b 0a 20 20 20 20 7d 0a  erage(v);.    }.
7570: 0a 20 20 20 20 70 50 61 72 73 65 2d 3e 64 69 73  .    pParse->dis
7580: 61 62 6c 65 54 72 69 67 67 65 72 73 20 3d 20 31  ableTriggers = 1
7590: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 65 6c  ;.    sqlite3Del
75a0: 65 74 65 46 72 6f 6d 28 70 50 61 72 73 65 2c 20  eteFrom(pParse, 
75b0: 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 44 75  sqlite3SrcListDu
75c0: 70 28 64 62 2c 20 70 4e 61 6d 65 2c 20 30 29 2c  p(db, pName, 0),
75d0: 20 30 2c 20 30 2c 20 30 2c 20 30 29 3b 0a 20 20   0, 0, 0, 0);.  
75e0: 20 20 70 50 61 72 73 65 2d 3e 64 69 73 61 62 6c    pParse->disabl
75f0: 65 54 72 69 67 67 65 72 73 20 3d 20 30 3b 0a 0a  eTriggers = 0;..
7600: 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 44 45      /* If the DE
7610: 4c 45 54 45 20 68 61 73 20 67 65 6e 65 72 61 74  LETE has generat
7620: 65 64 20 69 6d 6d 65 64 69 61 74 65 20 66 6f 72  ed immediate for
7630: 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61  eign key constra
7640: 69 6e 74 20 0a 20 20 20 20 2a 2a 20 76 69 6f 6c  int .    ** viol
7650: 61 74 69 6f 6e 73 2c 20 68 61 6c 74 20 74 68 65  ations, halt the
7660: 20 56 44 42 45 20 61 6e 64 20 72 65 74 75 72 6e   VDBE and return
7670: 20 61 6e 20 65 72 72 6f 72 20 61 74 20 74 68 69   an error at thi
7680: 73 20 70 6f 69 6e 74 2c 20 62 65 66 6f 72 65 0a  s point, before.
7690: 20 20 20 20 2a 2a 20 61 6e 79 20 6d 6f 64 69 66      ** any modif
76a0: 69 63 61 74 69 6f 6e 73 20 74 6f 20 74 68 65 20  ications to the 
76b0: 73 63 68 65 6d 61 20 61 72 65 20 6d 61 64 65 2e  schema are made.
76c0: 20 54 68 69 73 20 69 73 20 62 65 63 61 75 73 65   This is because
76d0: 20 73 74 61 74 65 6d 65 6e 74 0a 20 20 20 20 2a   statement.    *
76e0: 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 61  * transactions a
76f0: 72 65 20 6e 6f 74 20 61 62 6c 65 20 74 6f 20 72  re not able to r
7700: 6f 6c 6c 62 61 63 6b 20 73 63 68 65 6d 61 20 63  ollback schema c
7710: 68 61 6e 67 65 73 2e 20 20 0a 20 20 20 20 2a 2a  hanges.  .    **
7720: 0a 20 20 20 20 2a 2a 20 49 66 20 74 68 65 20 53  .    ** If the S
7730: 51 4c 49 54 45 5f 44 65 66 65 72 46 4b 73 20 66  QLITE_DeferFKs f
7740: 6c 61 67 20 69 73 20 73 65 74 2c 20 74 68 65 6e  lag is set, then
7750: 20 74 68 69 73 20 69 73 20 6e 6f 74 20 72 65 71   this is not req
7760: 75 69 72 65 64 2c 20 61 73 0a 20 20 20 20 2a 2a  uired, as.    **
7770: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74   the statement t
7780: 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c 20  ransaction will 
7790: 6e 6f 74 20 62 65 20 72 6f 6c 6c 65 64 20 62 61  not be rolled ba
77a0: 63 6b 20 65 76 65 6e 20 69 66 20 46 4b 0a 20 20  ck even if FK.  
77b0: 20 20 2a 2a 20 63 6f 6e 73 74 72 61 69 6e 74 73    ** constraints
77c0: 20 61 72 65 20 76 69 6f 6c 61 74 65 64 2e 0a 20   are violated.. 
77d0: 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 28 64     */.    if( (d
77e0: 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54  b->flags & SQLIT
77f0: 45 5f 44 65 66 65 72 46 4b 73 29 3d 3d 30 20 29  E_DeferFKs)==0 )
7800: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  {.      sqlite3V
7810: 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f  dbeAddOp2(v, OP_
7820: 46 6b 49 66 5a 65 72 6f 2c 20 30 2c 20 73 71 6c  FkIfZero, 0, sql
7830: 69 74 65 33 56 64 62 65 43 75 72 72 65 6e 74 41  ite3VdbeCurrentA
7840: 64 64 72 28 76 29 2b 32 29 3b 0a 20 20 20 20 20  ddr(v)+2);.     
7850: 20 56 64 62 65 43 6f 76 65 72 61 67 65 28 76 29   VdbeCoverage(v)
7860: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 48  ;.      sqlite3H
7870: 61 6c 74 43 6f 6e 73 74 72 61 69 6e 74 28 70 50  altConstraint(pP
7880: 61 72 73 65 2c 20 53 51 4c 49 54 45 5f 43 4f 4e  arse, SQLITE_CON
7890: 53 54 52 41 49 4e 54 5f 46 4f 52 45 49 47 4e 4b  STRAINT_FOREIGNK
78a0: 45 59 2c 0a 20 20 20 20 20 20 20 20 20 20 4f 45  EY,.          OE
78b0: 5f 41 62 6f 72 74 2c 20 30 2c 20 50 34 5f 53 54  _Abort, 0, P4_ST
78c0: 41 54 49 43 2c 20 50 35 5f 43 6f 6e 73 74 72 61  ATIC, P5_Constra
78d0: 69 6e 74 46 4b 29 3b 0a 20 20 20 20 7d 0a 0a 20  intFK);.    }.. 
78e0: 20 20 20 69 66 28 20 69 53 6b 69 70 20 29 7b 0a     if( iSkip ){.
78f0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
7900: 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c 28 76 2c  eResolveLabel(v,
7910: 20 69 53 6b 69 70 29 3b 0a 20 20 20 20 7d 0a 20   iSkip);.    }. 
7920: 20 7d 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 65   }.}.../*.** The
7930: 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74   second argument
7940: 20 70 6f 69 6e 74 73 20 74 6f 20 61 6e 20 46 4b   points to an FK
7950: 65 79 20 6f 62 6a 65 63 74 20 72 65 70 72 65 73  ey object repres
7960: 65 6e 74 69 6e 67 20 61 20 66 6f 72 65 69 67 6e  enting a foreign
7970: 20 6b 65 79 0a 2a 2a 20 66 6f 72 20 77 68 69 63   key.** for whic
7980: 68 20 70 54 61 62 20 69 73 20 74 68 65 20 63 68  h pTab is the ch
7990: 69 6c 64 20 74 61 62 6c 65 2e 20 41 6e 20 55 50  ild table. An UP
79a0: 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74 20 61  DATE statement a
79b0: 67 61 69 6e 73 74 20 70 54 61 62 0a 2a 2a 20 69  gainst pTab.** i
79c0: 73 20 63 75 72 72 65 6e 74 6c 79 20 62 65 69 6e  s currently bein
79d0: 67 20 70 72 6f 63 65 73 73 65 64 2e 20 46 6f 72  g processed. For
79e0: 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 6f 66 20   each column of 
79f0: 74 68 65 20 74 61 62 6c 65 20 74 68 61 74 20 69  the table that i
7a00: 73 20 0a 2a 2a 20 61 63 74 75 61 6c 6c 79 20 75  s .** actually u
7a10: 70 64 61 74 65 64 2c 20 74 68 65 20 63 6f 72 72  pdated, the corr
7a20: 65 73 70 6f 6e 64 69 6e 67 20 65 6c 65 6d 65 6e  esponding elemen
7a30: 74 20 69 6e 20 74 68 65 20 61 43 68 61 6e 67 65  t in the aChange
7a40: 5b 5d 20 61 72 72 61 79 0a 2a 2a 20 69 73 20 7a  [] array.** is z
7a50: 65 72 6f 20 6f 72 20 67 72 65 61 74 65 72 20 28  ero or greater (
7a60: 69 66 20 61 20 63 6f 6c 75 6d 6e 20 69 73 20 75  if a column is u
7a70: 6e 6d 6f 64 69 66 69 65 64 20 74 68 65 20 63 6f  nmodified the co
7a80: 72 72 65 73 70 6f 6e 64 69 6e 67 20 65 6c 65 6d  rresponding elem
7a90: 65 6e 74 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f  ent.** is set to
7aa0: 20 2d 31 29 2e 20 49 66 20 74 68 65 20 72 6f 77   -1). If the row
7ab0: 69 64 20 63 6f 6c 75 6d 6e 20 69 73 20 6d 6f 64  id column is mod
7ac0: 69 66 69 65 64 20 62 79 20 74 68 65 20 55 50 44  ified by the UPD
7ad0: 41 54 45 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a  ATE statement.**
7ae0: 20 74 68 65 20 62 43 68 6e 67 52 6f 77 69 64 20   the bChngRowid 
7af0: 61 72 67 75 6d 65 6e 74 20 69 73 20 6e 6f 6e 2d  argument is non-
7b00: 7a 65 72 6f 2e 0a 2a 2a 0a 2a 2a 20 54 68 69 73  zero..**.** This
7b10: 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e   function return
7b20: 73 20 74 72 75 65 20 69 66 20 61 6e 79 20 6f 66  s true if any of
7b30: 20 74 68 65 20 63 6f 6c 75 6d 6e 73 20 74 68 61   the columns tha
7b40: 74 20 61 72 65 20 70 61 72 74 20 6f 66 20 74 68  t are part of th
7b50: 65 0a 2a 2a 20 63 68 69 6c 64 20 6b 65 79 20 66  e.** child key f
7b60: 6f 72 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74  or FK constraint
7b70: 20 2a 70 20 61 72 65 20 6d 6f 64 69 66 69 65 64   *p are modified
7b80: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
7b90: 66 6b 43 68 69 6c 64 49 73 4d 6f 64 69 66 69 65  fkChildIsModifie
7ba0: 64 28 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62  d(.  Table *pTab
7bb0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
7bc0: 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 62 65       /* Table be
7bd0: 69 6e 67 20 75 70 64 61 74 65 64 20 2a 2f 0a 20  ing updated */. 
7be0: 20 46 4b 65 79 20 2a 70 2c 20 20 20 20 20 20 20   FKey *p,       
7bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7c00: 20 2f 2a 20 46 6f 72 65 69 67 6e 20 6b 65 79 20   /* Foreign key 
7c10: 66 6f 72 20 77 68 69 63 68 20 70 54 61 62 20 69  for which pTab i
7c20: 73 20 74 68 65 20 63 68 69 6c 64 20 2a 2f 0a 20  s the child */. 
7c30: 20 69 6e 74 20 2a 61 43 68 61 6e 67 65 2c 20 20   int *aChange,  
7c40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7c50: 20 2f 2a 20 41 72 72 61 79 20 69 6e 64 69 63 61   /* Array indica
7c60: 74 69 6e 67 20 6d 6f 64 69 66 69 65 64 20 63 6f  ting modified co
7c70: 6c 75 6d 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 62  lumns */.  int b
7c80: 43 68 6e 67 52 6f 77 69 64 20 20 20 20 20 20 20  ChngRowid       
7c90: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72             /* Tr
7ca0: 75 65 20 69 66 20 72 6f 77 69 64 20 69 73 20 6d  ue if rowid is m
7cb0: 6f 64 69 66 69 65 64 20 62 79 20 74 68 69 73 20  odified by this 
7cc0: 75 70 64 61 74 65 20 2a 2f 0a 29 7b 0a 20 20 69  update */.){.  i
7cd0: 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30 3b  nt i;.  for(i=0;
7ce0: 20 69 3c 70 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29   i<p->nCol; i++)
7cf0: 7b 0a 20 20 20 20 69 6e 74 20 69 43 68 69 6c 64  {.    int iChild
7d00: 4b 65 79 20 3d 20 70 2d 3e 61 43 6f 6c 5b 69 5d  Key = p->aCol[i]
7d10: 2e 69 46 72 6f 6d 3b 0a 20 20 20 20 69 66 28 20  .iFrom;.    if( 
7d20: 61 43 68 61 6e 67 65 5b 69 43 68 69 6c 64 4b 65  aChange[iChildKe
7d30: 79 5d 3e 3d 30 20 29 20 72 65 74 75 72 6e 20 31  y]>=0 ) return 1
7d40: 3b 0a 20 20 20 20 69 66 28 20 69 43 68 69 6c 64  ;.    if( iChild
7d50: 4b 65 79 3d 3d 70 54 61 62 2d 3e 69 50 4b 65 79  Key==pTab->iPKey
7d60: 20 26 26 20 62 43 68 6e 67 52 6f 77 69 64 20 29   && bChngRowid )
7d70: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 20   return 1;.  }. 
7d80: 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a   return 0;.}../*
7d90: 0a 2a 2a 20 54 68 65 20 73 65 63 6f 6e 64 20 61  .** The second a
7da0: 72 67 75 6d 65 6e 74 20 70 6f 69 6e 74 73 20 74  rgument points t
7db0: 6f 20 61 6e 20 46 4b 65 79 20 6f 62 6a 65 63 74  o an FKey object
7dc0: 20 72 65 70 72 65 73 65 6e 74 69 6e 67 20 61 20   representing a 
7dd0: 66 6f 72 65 69 67 6e 20 6b 65 79 0a 2a 2a 20 66  foreign key.** f
7de0: 6f 72 20 77 68 69 63 68 20 70 54 61 62 20 69 73  or which pTab is
7df0: 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c   the parent tabl
7e00: 65 2e 20 41 6e 20 55 50 44 41 54 45 20 73 74 61  e. An UPDATE sta
7e10: 74 65 6d 65 6e 74 20 61 67 61 69 6e 73 74 20 70  tement against p
7e20: 54 61 62 0a 2a 2a 20 69 73 20 63 75 72 72 65 6e  Tab.** is curren
7e30: 74 6c 79 20 62 65 69 6e 67 20 70 72 6f 63 65 73  tly being proces
7e40: 73 65 64 2e 20 46 6f 72 20 65 61 63 68 20 63 6f  sed. For each co
7e50: 6c 75 6d 6e 20 6f 66 20 74 68 65 20 74 61 62 6c  lumn of the tabl
7e60: 65 20 74 68 61 74 20 69 73 20 0a 2a 2a 20 61 63  e that is .** ac
7e70: 74 75 61 6c 6c 79 20 75 70 64 61 74 65 64 2c 20  tually updated, 
7e80: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e  the correspondin
7e90: 67 20 65 6c 65 6d 65 6e 74 20 69 6e 20 74 68 65  g element in the
7ea0: 20 61 43 68 61 6e 67 65 5b 5d 20 61 72 72 61 79   aChange[] array
7eb0: 0a 2a 2a 20 69 73 20 7a 65 72 6f 20 6f 72 20 67  .** is zero or g
7ec0: 72 65 61 74 65 72 20 28 69 66 20 61 20 63 6f 6c  reater (if a col
7ed0: 75 6d 6e 20 69 73 20 75 6e 6d 6f 64 69 66 69 65  umn is unmodifie
7ee0: 64 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64  d the correspond
7ef0: 69 6e 67 20 65 6c 65 6d 65 6e 74 0a 2a 2a 20 69  ing element.** i
7f00: 73 20 73 65 74 20 74 6f 20 2d 31 29 2e 20 49 66  s set to -1). If
7f10: 20 74 68 65 20 72 6f 77 69 64 20 63 6f 6c 75 6d   the rowid colum
7f20: 6e 20 69 73 20 6d 6f 64 69 66 69 65 64 20 62 79  n is modified by
7f30: 20 74 68 65 20 55 50 44 41 54 45 20 73 74 61 74   the UPDATE stat
7f40: 65 6d 65 6e 74 0a 2a 2a 20 74 68 65 20 62 43 68  ement.** the bCh
7f50: 6e 67 52 6f 77 69 64 20 61 72 67 75 6d 65 6e 74  ngRowid argument
7f60: 20 69 73 20 6e 6f 6e 2d 7a 65 72 6f 2e 0a 2a 2a   is non-zero..**
7f70: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
7f80: 6e 20 72 65 74 75 72 6e 73 20 74 72 75 65 20 69  n returns true i
7f90: 66 20 61 6e 79 20 6f 66 20 74 68 65 20 63 6f 6c  f any of the col
7fa0: 75 6d 6e 73 20 74 68 61 74 20 61 72 65 20 70 61  umns that are pa
7fb0: 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 70 61 72  rt of the.** par
7fc0: 65 6e 74 20 6b 65 79 20 66 6f 72 20 46 4b 20 63  ent key for FK c
7fd0: 6f 6e 73 74 72 61 69 6e 74 20 2a 70 20 61 72 65  onstraint *p are
7fe0: 20 6d 6f 64 69 66 69 65 64 2e 0a 2a 2f 0a 73 74   modified..*/.st
7ff0: 61 74 69 63 20 69 6e 74 20 66 6b 50 61 72 65 6e  atic int fkParen
8000: 74 49 73 4d 6f 64 69 66 69 65 64 28 0a 20 20 54  tIsModified(.  T
8010: 61 62 6c 65 20 2a 70 54 61 62 2c 20 0a 20 20 46  able *pTab, .  F
8020: 4b 65 79 20 2a 70 2c 20 0a 20 20 69 6e 74 20 2a  Key *p, .  int *
8030: 61 43 68 61 6e 67 65 2c 20 0a 20 20 69 6e 74 20  aChange, .  int 
8040: 62 43 68 6e 67 52 6f 77 69 64 0a 29 7b 0a 20 20  bChngRowid.){.  
8050: 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d 30  int i;.  for(i=0
8060: 3b 20 69 3c 70 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b  ; i<p->nCol; i++
8070: 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 4b 65  ){.    char *zKe
8080: 79 20 3d 20 70 2d 3e 61 43 6f 6c 5b 69 5d 2e 7a  y = p->aCol[i].z
8090: 43 6f 6c 3b 0a 20 20 20 20 69 6e 74 20 69 4b 65  Col;.    int iKe
80a0: 79 3b 0a 20 20 20 20 66 6f 72 28 69 4b 65 79 3d  y;.    for(iKey=
80b0: 30 3b 20 69 4b 65 79 3c 70 54 61 62 2d 3e 6e 43  0; iKey<pTab->nC
80c0: 6f 6c 3b 20 69 4b 65 79 2b 2b 29 7b 0a 20 20 20  ol; iKey++){.   
80d0: 20 20 20 69 66 28 20 61 43 68 61 6e 67 65 5b 69     if( aChange[i
80e0: 4b 65 79 5d 3e 3d 30 20 7c 7c 20 28 69 4b 65 79  Key]>=0 || (iKey
80f0: 3d 3d 70 54 61 62 2d 3e 69 50 4b 65 79 20 26 26  ==pTab->iPKey &&
8100: 20 62 43 68 6e 67 52 6f 77 69 64 29 20 29 7b 0a   bChngRowid) ){.
8110: 20 20 20 20 20 20 20 20 43 6f 6c 75 6d 6e 20 2a          Column *
8120: 70 43 6f 6c 20 3d 20 26 70 54 61 62 2d 3e 61 43  pCol = &pTab->aC
8130: 6f 6c 5b 69 4b 65 79 5d 3b 0a 20 20 20 20 20 20  ol[iKey];.      
8140: 20 20 69 66 28 20 7a 4b 65 79 20 29 7b 0a 20 20    if( zKey ){.  
8150: 20 20 20 20 20 20 20 20 69 66 28 20 30 3d 3d 73          if( 0==s
8160: 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28 70 43  qlite3StrICmp(pC
8170: 6f 6c 2d 3e 7a 4e 61 6d 65 2c 20 7a 4b 65 79 29  ol->zName, zKey)
8180: 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20   ) return 1;.   
8190: 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70       }else if( p
81a0: 43 6f 6c 2d 3e 63 6f 6c 46 6c 61 67 73 20 26 20  Col->colFlags & 
81b0: 43 4f 4c 46 4c 41 47 5f 50 52 49 4d 4b 45 59 20  COLFLAG_PRIMKEY 
81c0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 72 65 74  ){.          ret
81d0: 75 72 6e 20 31 3b 0a 20 20 20 20 20 20 20 20 7d  urn 1;.        }
81e0: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
81f0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d   }.  return 0;.}
8200: 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74  ../*.** Return t
8210: 72 75 65 20 69 66 20 74 68 65 20 70 61 72 73 65  rue if the parse
8220: 72 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20  r passed as the 
8230: 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74 20 69  first argument i
8240: 73 20 62 65 69 6e 67 0a 2a 2a 20 75 73 65 64 20  s being.** used 
8250: 74 6f 20 63 6f 64 65 20 61 20 74 72 69 67 67 65  to code a trigge
8260: 72 20 74 68 61 74 20 69 73 20 72 65 61 6c 6c 79  r that is really
8270: 20 61 20 22 53 45 54 20 4e 55 4c 4c 22 20 61 63   a "SET NULL" ac
8280: 74 69 6f 6e 20 62 65 6c 6f 6e 67 69 6e 67 0a 2a  tion belonging.*
8290: 2a 20 74 6f 20 74 72 69 67 67 65 72 20 70 46 4b  * to trigger pFK
82a0: 65 79 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  ey..*/.static in
82b0: 74 20 69 73 53 65 74 4e 75 6c 6c 41 63 74 69 6f  t isSetNullActio
82c0: 6e 28 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c  n(Parse *pParse,
82d0: 20 46 4b 65 79 20 2a 70 46 4b 65 79 29 7b 0a 20   FKey *pFKey){. 
82e0: 20 50 61 72 73 65 20 2a 70 54 6f 70 20 3d 20 73   Parse *pTop = s
82f0: 71 6c 69 74 65 33 50 61 72 73 65 54 6f 70 6c 65  qlite3ParseTople
8300: 76 65 6c 28 70 50 61 72 73 65 29 3b 0a 20 20 69  vel(pParse);.  i
8310: 66 28 20 70 54 6f 70 2d 3e 70 54 72 69 67 67 65  f( pTop->pTrigge
8320: 72 50 72 67 20 29 7b 0a 20 20 20 20 54 72 69 67  rPrg ){.    Trig
8330: 67 65 72 20 2a 70 20 3d 20 70 54 6f 70 2d 3e 70  ger *p = pTop->p
8340: 54 72 69 67 67 65 72 50 72 67 2d 3e 70 54 72 69  TriggerPrg->pTri
8350: 67 67 65 72 3b 0a 20 20 20 20 69 66 28 20 28 70  gger;.    if( (p
8360: 3d 3d 70 46 4b 65 79 2d 3e 61 70 54 72 69 67 67  ==pFKey->apTrigg
8370: 65 72 5b 30 5d 20 26 26 20 70 46 4b 65 79 2d 3e  er[0] && pFKey->
8380: 61 41 63 74 69 6f 6e 5b 30 5d 3d 3d 4f 45 5f 53  aAction[0]==OE_S
8390: 65 74 4e 75 6c 6c 29 0a 20 20 20 20 20 7c 7c 20  etNull).     || 
83a0: 28 70 3d 3d 70 46 4b 65 79 2d 3e 61 70 54 72 69  (p==pFKey->apTri
83b0: 67 67 65 72 5b 31 5d 20 26 26 20 70 46 4b 65 79  gger[1] && pFKey
83c0: 2d 3e 61 41 63 74 69 6f 6e 5b 31 5d 3d 3d 4f 45  ->aAction[1]==OE
83d0: 5f 53 65 74 4e 75 6c 6c 29 0a 20 20 20 20 29 7b  _SetNull).    ){
83e0: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b  .      return 1;
83f0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74  .    }.  }.  ret
8400: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20  urn 0;.}../*.** 
8410: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  This function is
8420: 20 63 61 6c 6c 65 64 20 77 68 65 6e 20 69 6e 73   called when ins
8430: 65 72 74 69 6e 67 2c 20 64 65 6c 65 74 69 6e 67  erting, deleting
8440: 20 6f 72 20 75 70 64 61 74 69 6e 67 20 61 20 72   or updating a r
8450: 6f 77 20 6f 66 0a 2a 2a 20 74 61 62 6c 65 20 70  ow of.** table p
8460: 54 61 62 20 74 6f 20 67 65 6e 65 72 61 74 65 20  Tab to generate 
8470: 56 44 42 45 20 63 6f 64 65 20 74 6f 20 70 65 72  VDBE code to per
8480: 66 6f 72 6d 20 66 6f 72 65 69 67 6e 20 6b 65 79  form foreign key
8490: 20 63 6f 6e 73 74 72 61 69 6e 74 20 0a 2a 2a 20   constraint .** 
84a0: 70 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 20 74  processing for t
84b0: 68 65 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 2a 2a  he operation..**
84c0: 0a 2a 2a 20 46 6f 72 20 61 20 44 45 4c 45 54 45  .** For a DELETE
84d0: 20 6f 70 65 72 61 74 69 6f 6e 2c 20 70 61 72 61   operation, para
84e0: 6d 65 74 65 72 20 72 65 67 4f 6c 64 20 69 73 20  meter regOld is 
84f0: 70 61 73 73 65 64 20 74 68 65 20 69 6e 64 65 78  passed the index
8500: 20 6f 66 20 74 68 65 0a 2a 2a 20 66 69 72 73 74   of the.** first
8510: 20 72 65 67 69 73 74 65 72 20 69 6e 20 61 6e 20   register in an 
8520: 61 72 72 61 79 20 6f 66 20 28 70 54 61 62 2d 3e  array of (pTab->
8530: 6e 43 6f 6c 2b 31 29 20 72 65 67 69 73 74 65 72  nCol+1) register
8540: 73 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65  s containing the
8550: 0a 2a 2a 20 72 6f 77 69 64 20 6f 66 20 74 68 65  .** rowid of the
8560: 20 72 6f 77 20 62 65 69 6e 67 20 64 65 6c 65 74   row being delet
8570: 65 64 2c 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20  ed, followed by 
8580: 65 61 63 68 20 6f 66 20 74 68 65 20 63 6f 6c 75  each of the colu
8590: 6d 6e 20 76 61 6c 75 65 73 0a 2a 2a 20 6f 66 20  mn values.** of 
85a0: 74 68 65 20 72 6f 77 20 62 65 69 6e 67 20 64 65  the row being de
85b0: 6c 65 74 65 64 2c 20 66 72 6f 6d 20 6c 65 66 74  leted, from left
85c0: 20 74 6f 20 72 69 67 68 74 2e 20 50 61 72 61 6d   to right. Param
85d0: 65 74 65 72 20 72 65 67 4e 65 77 20 69 73 20 70  eter regNew is p
85e0: 61 73 73 65 64 0a 2a 2a 20 7a 65 72 6f 20 69 6e  assed.** zero in
85f0: 20 74 68 69 73 20 63 61 73 65 2e 0a 2a 2a 0a 2a   this case..**.*
8600: 2a 20 46 6f 72 20 61 6e 20 49 4e 53 45 52 54 20  * For an INSERT 
8610: 6f 70 65 72 61 74 69 6f 6e 2c 20 72 65 67 4f 6c  operation, regOl
8620: 64 20 69 73 20 70 61 73 73 65 64 20 7a 65 72 6f  d is passed zero
8630: 20 61 6e 64 20 72 65 67 4e 65 77 20 69 73 20 70   and regNew is p
8640: 61 73 73 65 64 20 74 68 65 0a 2a 2a 20 66 69 72  assed the.** fir
8650: 73 74 20 72 65 67 69 73 74 65 72 20 6f 66 20 61  st register of a
8660: 6e 20 61 72 72 61 79 20 6f 66 20 28 70 54 61 62  n array of (pTab
8670: 2d 3e 6e 43 6f 6c 2b 31 29 20 72 65 67 69 73 74  ->nCol+1) regist
8680: 65 72 73 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74  ers containing t
8690: 68 65 20 6e 65 77 0a 2a 2a 20 72 6f 77 20 64 61  he new.** row da
86a0: 74 61 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 6e  ta..**.** For an
86b0: 20 55 50 44 41 54 45 20 6f 70 65 72 61 74 69 6f   UPDATE operatio
86c0: 6e 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  n, this function
86d0: 20 69 73 20 63 61 6c 6c 65 64 20 74 77 69 63 65   is called twice
86e0: 2e 20 4f 6e 63 65 20 62 65 66 6f 72 65 0a 2a 2a  . Once before.**
86f0: 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 72 65   the original re
8700: 63 6f 72 64 20 69 73 20 64 65 6c 65 74 65 64 20  cord is deleted 
8710: 66 72 6f 6d 20 74 68 65 20 74 61 62 6c 65 20 75  from the table u
8720: 73 69 6e 67 20 74 68 65 20 63 61 6c 6c 69 6e 67  sing the calling
8730: 20 63 6f 6e 76 65 6e 74 69 6f 6e 0a 2a 2a 20 64   convention.** d
8740: 65 73 63 72 69 62 65 64 20 66 6f 72 20 44 45 4c  escribed for DEL
8750: 45 54 45 2e 20 54 68 65 6e 20 61 67 61 69 6e 20  ETE. Then again 
8760: 61 66 74 65 72 20 74 68 65 20 6f 72 69 67 69 6e  after the origin
8770: 61 6c 20 72 65 63 6f 72 64 20 69 73 20 64 65 6c  al record is del
8780: 65 74 65 64 0a 2a 2a 20 62 75 74 20 62 65 66 6f  eted.** but befo
8790: 72 65 20 74 68 65 20 6e 65 77 20 72 65 63 6f 72  re the new recor
87a0: 64 20 69 73 20 69 6e 73 65 72 74 65 64 20 75 73  d is inserted us
87b0: 69 6e 67 20 74 68 65 20 49 4e 53 45 52 54 20 63  ing the INSERT c
87c0: 6f 6e 76 65 6e 74 69 6f 6e 2e 20 0a 2a 2f 0a 76  onvention. .*/.v
87d0: 6f 69 64 20 73 71 6c 69 74 65 33 46 6b 43 68 65  oid sqlite3FkChe
87e0: 63 6b 28 0a 20 20 50 61 72 73 65 20 2a 70 50 61  ck(.  Parse *pPa
87f0: 72 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 20  rse,            
8800: 20 20 20 20 20 20 2f 2a 20 50 61 72 73 65 20 63        /* Parse c
8810: 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 54 61 62 6c  ontext */.  Tabl
8820: 65 20 2a 70 54 61 62 2c 20 20 20 20 20 20 20 20  e *pTab,        
8830: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52              /* R
8840: 6f 77 20 69 73 20 62 65 69 6e 67 20 64 65 6c 65  ow is being dele
8850: 74 65 64 20 66 72 6f 6d 20 74 68 69 73 20 74 61  ted from this ta
8860: 62 6c 65 20 2a 2f 20 0a 20 20 69 6e 74 20 72 65  ble */ .  int re
8870: 67 4f 6c 64 2c 20 20 20 20 20 20 20 20 20 20 20  gOld,           
8880: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72 65            /* Pre
8890: 76 69 6f 75 73 20 72 6f 77 20 64 61 74 61 20 69  vious row data i
88a0: 73 20 73 74 6f 72 65 64 20 68 65 72 65 20 2a 2f  s stored here */
88b0: 0a 20 20 69 6e 74 20 72 65 67 4e 65 77 2c 20 20  .  int regNew,  
88c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
88d0: 20 20 20 2f 2a 20 4e 65 77 20 72 6f 77 20 64 61     /* New row da
88e0: 74 61 20 69 73 20 73 74 6f 72 65 64 20 68 65 72  ta is stored her
88f0: 65 20 2a 2f 0a 20 20 69 6e 74 20 2a 61 43 68 61  e */.  int *aCha
8900: 6e 67 65 2c 20 20 20 20 20 20 20 20 20 20 20 20  nge,            
8910: 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 20         /* Array 
8920: 69 6e 64 69 63 61 74 69 6e 67 20 55 50 44 41 54  indicating UPDAT
8930: 45 64 20 63 6f 6c 75 6d 6e 73 20 28 6f 72 20 30  Ed columns (or 0
8940: 29 20 2a 2f 0a 20 20 69 6e 74 20 62 43 68 6e 67  ) */.  int bChng
8950: 52 6f 77 69 64 20 20 20 20 20 20 20 20 20 20 20  Rowid           
8960: 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 69         /* True i
8970: 66 20 72 6f 77 69 64 20 69 73 20 55 50 44 41 54  f rowid is UPDAT
8980: 45 64 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74  Ed */.){.  sqlit
8990: 65 33 20 2a 64 62 20 3d 20 70 50 61 72 73 65 2d  e3 *db = pParse-
89a0: 3e 64 62 3b 20 20 20 20 20 20 20 2f 2a 20 44 61  >db;       /* Da
89b0: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f  tabase handle */
89c0: 0a 20 20 46 4b 65 79 20 2a 70 46 4b 65 79 3b 20  .  FKey *pFKey; 
89d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
89e0: 20 20 20 2f 2a 20 55 73 65 64 20 74 6f 20 69 74     /* Used to it
89f0: 65 72 61 74 65 20 74 68 72 6f 75 67 68 20 46 4b  erate through FK
8a00: 73 20 2a 2f 0a 20 20 69 6e 74 20 69 44 62 3b 20  s */.  int iDb; 
8a10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8a20: 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20         /* Index 
8a30: 6f 66 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74  of database cont
8a40: 61 69 6e 69 6e 67 20 70 54 61 62 20 2a 2f 0a 20  aining pTab */. 
8a50: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62   const char *zDb
8a60: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
8a70: 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 64 61 74 61   /* Name of data
8a80: 62 61 73 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20  base containing 
8a90: 70 54 61 62 20 2a 2f 0a 20 20 69 6e 74 20 69 73  pTab */.  int is
8aa0: 49 67 6e 6f 72 65 45 72 72 6f 72 73 20 3d 20 70  IgnoreErrors = p
8ab0: 50 61 72 73 65 2d 3e 64 69 73 61 62 6c 65 54 72  Parse->disableTr
8ac0: 69 67 67 65 72 73 3b 0a 0a 20 20 2f 2a 20 45 78  iggers;..  /* Ex
8ad0: 61 63 74 6c 79 20 6f 6e 65 20 6f 66 20 72 65 67  actly one of reg
8ae0: 4f 6c 64 20 61 6e 64 20 72 65 67 4e 65 77 20 73  Old and regNew s
8af0: 68 6f 75 6c 64 20 62 65 20 6e 6f 6e 2d 7a 65 72  hould be non-zer
8b00: 6f 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  o. */.  assert( 
8b10: 28 72 65 67 4f 6c 64 3d 3d 30 29 21 3d 28 72 65  (regOld==0)!=(re
8b20: 67 4e 65 77 3d 3d 30 29 20 29 3b 0a 0a 20 20 2f  gNew==0) );..  /
8b30: 2a 20 49 66 20 66 6f 72 65 69 67 6e 2d 6b 65 79  * If foreign-key
8b40: 73 20 61 72 65 20 64 69 73 61 62 6c 65 64 2c 20  s are disabled, 
8b50: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73  this function is
8b60: 20 61 20 6e 6f 2d 6f 70 2e 20 2a 2f 0a 20 20 69   a no-op. */.  i
8b70: 66 28 20 28 64 62 2d 3e 66 6c 61 67 73 26 53 51  f( (db->flags&SQ
8b80: 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73  LITE_ForeignKeys
8b90: 29 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 0a  )==0 ) return;..
8ba0: 20 20 69 44 62 20 3d 20 73 71 6c 69 74 65 33 53    iDb = sqlite3S
8bb0: 63 68 65 6d 61 54 6f 49 6e 64 65 78 28 64 62 2c  chemaToIndex(db,
8bc0: 20 70 54 61 62 2d 3e 70 53 63 68 65 6d 61 29 3b   pTab->pSchema);
8bd0: 0a 20 20 7a 44 62 20 3d 20 64 62 2d 3e 61 44 62  .  zDb = db->aDb
8be0: 5b 69 44 62 5d 2e 7a 4e 61 6d 65 3b 0a 0a 20 20  [iDb].zName;..  
8bf0: 2f 2a 20 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20  /* Loop through 
8c00: 61 6c 6c 20 74 68 65 20 66 6f 72 65 69 67 6e 20  all the foreign 
8c10: 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 20  key constraints 
8c20: 66 6f 72 20 77 68 69 63 68 20 70 54 61 62 20 69  for which pTab i
8c30: 73 20 74 68 65 0a 20 20 2a 2a 20 63 68 69 6c 64  s the.  ** child
8c40: 20 74 61 62 6c 65 20 28 74 68 65 20 74 61 62 6c   table (the tabl
8c50: 65 20 74 68 61 74 20 74 68 65 20 66 6f 72 65 69  e that the forei
8c60: 67 6e 20 6b 65 79 20 64 65 66 69 6e 69 74 69 6f  gn key definitio
8c70: 6e 20 69 73 20 70 61 72 74 20 6f 66 29 2e 20 20  n is part of).  
8c80: 2a 2f 0a 20 20 66 6f 72 28 70 46 4b 65 79 3d 70  */.  for(pFKey=p
8c90: 54 61 62 2d 3e 70 46 4b 65 79 3b 20 70 46 4b 65  Tab->pFKey; pFKe
8ca0: 79 3b 20 70 46 4b 65 79 3d 70 46 4b 65 79 2d 3e  y; pFKey=pFKey->
8cb0: 70 4e 65 78 74 46 72 6f 6d 29 7b 0a 20 20 20 20  pNextFrom){.    
8cc0: 54 61 62 6c 65 20 2a 70 54 6f 3b 20 20 20 20 20  Table *pTo;     
8cd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
8ce0: 20 50 61 72 65 6e 74 20 74 61 62 6c 65 20 6f 66   Parent table of
8cf0: 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 70 46 4b   foreign key pFK
8d00: 65 79 20 2a 2f 0a 20 20 20 20 49 6e 64 65 78 20  ey */.    Index 
8d10: 2a 70 49 64 78 20 3d 20 30 3b 20 20 20 20 20 20  *pIdx = 0;      
8d20: 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78          /* Index
8d30: 20 6f 6e 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20   on key columns 
8d40: 69 6e 20 70 54 6f 20 2a 2f 0a 20 20 20 20 69 6e  in pTo */.    in
8d50: 74 20 2a 61 69 46 72 65 65 20 3d 20 30 3b 0a 20  t *aiFree = 0;. 
8d60: 20 20 20 69 6e 74 20 2a 61 69 43 6f 6c 3b 0a 20     int *aiCol;. 
8d70: 20 20 20 69 6e 74 20 69 43 6f 6c 3b 0a 20 20 20     int iCol;.   
8d80: 20 69 6e 74 20 69 3b 0a 20 20 20 20 69 6e 74 20   int i;.    int 
8d90: 62 49 67 6e 6f 72 65 20 3d 20 30 3b 0a 0a 20 20  bIgnore = 0;..  
8da0: 20 20 69 66 28 20 61 43 68 61 6e 67 65 20 0a 20    if( aChange . 
8db0: 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 5f 73      && sqlite3_s
8dc0: 74 72 69 63 6d 70 28 70 54 61 62 2d 3e 7a 4e 61  tricmp(pTab->zNa
8dd0: 6d 65 2c 20 70 46 4b 65 79 2d 3e 7a 54 6f 29 21  me, pFKey->zTo)!
8de0: 3d 30 0a 20 20 20 20 20 26 26 20 66 6b 43 68 69  =0.     && fkChi
8df0: 6c 64 49 73 4d 6f 64 69 66 69 65 64 28 70 54 61  ldIsModified(pTa
8e00: 62 2c 20 70 46 4b 65 79 2c 20 61 43 68 61 6e 67  b, pFKey, aChang
8e10: 65 2c 20 62 43 68 6e 67 52 6f 77 69 64 29 3d 3d  e, bChngRowid)==
8e20: 30 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20  0 .    ){.      
8e30: 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 7d 0a  continue;.    }.
8e40: 0a 20 20 20 20 2f 2a 20 46 69 6e 64 20 74 68 65  .    /* Find the
8e50: 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 6f 66   parent table of
8e60: 20 74 68 69 73 20 66 6f 72 65 69 67 6e 20 6b 65   this foreign ke
8e70: 79 2e 20 41 6c 73 6f 20 66 69 6e 64 20 61 20 75  y. Also find a u
8e80: 6e 69 71 75 65 20 69 6e 64 65 78 20 0a 20 20 20  nique index .   
8e90: 20 2a 2a 20 6f 6e 20 74 68 65 20 70 61 72 65 6e   ** on the paren
8ea0: 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e  t key columns in
8eb0: 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c   the parent tabl
8ec0: 65 2e 20 49 66 20 65 69 74 68 65 72 20 6f 66 20  e. If either of 
8ed0: 74 68 65 73 65 20 0a 20 20 20 20 2a 2a 20 73 63  these .    ** sc
8ee0: 68 65 6d 61 20 69 74 65 6d 73 20 63 61 6e 6e 6f  hema items canno
8ef0: 74 20 62 65 20 6c 6f 63 61 74 65 64 2c 20 73 65  t be located, se
8f00: 74 20 61 6e 20 65 72 72 6f 72 20 69 6e 20 70 50  t an error in pP
8f10: 61 72 73 65 20 61 6e 64 20 72 65 74 75 72 6e 20  arse and return 
8f20: 0a 20 20 20 20 2a 2a 20 65 61 72 6c 79 2e 20 20  .    ** early.  
8f30: 2a 2f 0a 20 20 20 20 69 66 28 20 70 50 61 72 73  */.    if( pPars
8f40: 65 2d 3e 64 69 73 61 62 6c 65 54 72 69 67 67 65  e->disableTrigge
8f50: 72 73 20 29 7b 0a 20 20 20 20 20 20 70 54 6f 20  rs ){.      pTo 
8f60: 3d 20 73 71 6c 69 74 65 33 46 69 6e 64 54 61 62  = sqlite3FindTab
8f70: 6c 65 28 64 62 2c 20 70 46 4b 65 79 2d 3e 7a 54  le(db, pFKey->zT
8f80: 6f 2c 20 7a 44 62 29 3b 0a 20 20 20 20 7d 65 6c  o, zDb);.    }el
8f90: 73 65 7b 0a 20 20 20 20 20 20 70 54 6f 20 3d 20  se{.      pTo = 
8fa0: 73 71 6c 69 74 65 33 4c 6f 63 61 74 65 54 61 62  sqlite3LocateTab
8fb0: 6c 65 28 70 50 61 72 73 65 2c 20 30 2c 20 70 46  le(pParse, 0, pF
8fc0: 4b 65 79 2d 3e 7a 54 6f 2c 20 7a 44 62 29 3b 0a  Key->zTo, zDb);.
8fd0: 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 21 70      }.    if( !p
8fe0: 54 6f 20 7c 7c 20 73 71 6c 69 74 65 33 46 6b 4c  To || sqlite3FkL
8ff0: 6f 63 61 74 65 49 6e 64 65 78 28 70 50 61 72 73  ocateIndex(pPars
9000: 65 2c 20 70 54 6f 2c 20 70 46 4b 65 79 2c 20 26  e, pTo, pFKey, &
9010: 70 49 64 78 2c 20 26 61 69 46 72 65 65 29 20 29  pIdx, &aiFree) )
9020: 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20  {.      assert( 
9030: 69 73 49 67 6e 6f 72 65 45 72 72 6f 72 73 3d 3d  isIgnoreErrors==
9040: 30 20 7c 7c 20 28 72 65 67 4f 6c 64 21 3d 30 20  0 || (regOld!=0 
9050: 26 26 20 72 65 67 4e 65 77 3d 3d 30 29 20 29 3b  && regNew==0) );
9060: 0a 20 20 20 20 20 20 69 66 28 20 21 69 73 49 67  .      if( !isIg
9070: 6e 6f 72 65 45 72 72 6f 72 73 20 7c 7c 20 64 62  noreErrors || db
9080: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29  ->mallocFailed )
9090: 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 20 20 69   return;.      i
90a0: 66 28 20 70 54 6f 3d 3d 30 20 29 7b 0a 20 20 20  f( pTo==0 ){.   
90b0: 20 20 20 20 20 2f 2a 20 49 66 20 69 73 49 67 6e       /* If isIgn
90c0: 6f 72 65 45 72 72 6f 72 73 20 69 73 20 74 72 75  oreErrors is tru
90d0: 65 2c 20 74 68 65 6e 20 61 20 74 61 62 6c 65 20  e, then a table 
90e0: 69 73 20 62 65 69 6e 67 20 64 72 6f 70 70 65 64  is being dropped
90f0: 2e 20 49 6e 20 74 68 69 73 0a 20 20 20 20 20 20  . In this.      
9100: 20 20 2a 2a 20 63 61 73 65 20 53 51 4c 69 74 65    ** case SQLite
9110: 20 72 75 6e 73 20 61 20 22 44 45 4c 45 54 45 20   runs a "DELETE 
9120: 46 52 4f 4d 20 78 78 78 22 20 6f 6e 20 74 68 65  FROM xxx" on the
9130: 20 74 61 62 6c 65 20 62 65 69 6e 67 20 64 72 6f   table being dro
9140: 70 70 65 64 0a 20 20 20 20 20 20 20 20 2a 2a 20  pped.        ** 
9150: 62 65 66 6f 72 65 20 61 63 74 75 61 6c 6c 79 20  before actually 
9160: 64 72 6f 70 70 69 6e 67 20 69 74 20 69 6e 20 6f  dropping it in o
9170: 72 64 65 72 20 74 6f 20 63 68 65 63 6b 20 46 4b  rder to check FK
9180: 20 63 6f 6e 73 74 72 61 69 6e 74 73 2e 0a 20 20   constraints..  
9190: 20 20 20 20 20 20 2a 2a 20 49 66 20 74 68 65 20        ** If the 
91a0: 70 61 72 65 6e 74 20 74 61 62 6c 65 20 6f 66 20  parent table of 
91b0: 61 6e 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74  an FK constraint
91c0: 20 6f 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20   on the current 
91d0: 74 61 62 6c 65 20 69 73 0a 20 20 20 20 20 20 20  table is.       
91e0: 20 2a 2a 20 6d 69 73 73 69 6e 67 2c 20 62 65 68   ** missing, beh
91f0: 61 76 65 20 61 73 20 69 66 20 69 74 20 69 73 20  ave as if it is 
9200: 65 6d 70 74 79 2e 20 69 2e 65 2e 20 64 65 63 72  empty. i.e. decr
9210: 65 6d 65 6e 74 20 74 68 65 20 72 65 6c 65 76 61  ement the releva
9220: 6e 74 0a 20 20 20 20 20 20 20 20 2a 2a 20 46 4b  nt.        ** FK
9230: 20 63 6f 75 6e 74 65 72 20 66 6f 72 20 65 61 63   counter for eac
9240: 68 20 72 6f 77 20 6f 66 20 74 68 65 20 63 75 72  h row of the cur
9250: 72 65 6e 74 20 74 61 62 6c 65 20 77 69 74 68 20  rent table with 
9260: 6e 6f 6e 2d 4e 55 4c 4c 20 6b 65 79 73 2e 0a 20  non-NULL keys.. 
9270: 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20         */.      
9280: 20 20 56 64 62 65 20 2a 76 20 3d 20 73 71 6c 69    Vdbe *v = sqli
9290: 74 65 33 47 65 74 56 64 62 65 28 70 50 61 72 73  te3GetVdbe(pPars
92a0: 65 29 3b 0a 20 20 20 20 20 20 20 20 69 6e 74 20  e);.        int 
92b0: 69 4a 75 6d 70 20 3d 20 73 71 6c 69 74 65 33 56  iJump = sqlite3V
92c0: 64 62 65 43 75 72 72 65 6e 74 41 64 64 72 28 76  dbeCurrentAddr(v
92d0: 29 20 2b 20 70 46 4b 65 79 2d 3e 6e 43 6f 6c 20  ) + pFKey->nCol 
92e0: 2b 20 31 3b 0a 20 20 20 20 20 20 20 20 66 6f 72  + 1;.        for
92f0: 28 69 3d 30 3b 20 69 3c 70 46 4b 65 79 2d 3e 6e  (i=0; i<pFKey->n
9300: 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20  Col; i++){.     
9310: 20 20 20 20 20 69 6e 74 20 69 52 65 67 20 3d 20       int iReg = 
9320: 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 69 5d 2e 69  pFKey->aCol[i].i
9330: 46 72 6f 6d 20 2b 20 72 65 67 4f 6c 64 20 2b 20  From + regOld + 
9340: 31 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c  1;.          sql
9350: 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28 76  ite3VdbeAddOp2(v
9360: 2c 20 4f 50 5f 49 73 4e 75 6c 6c 2c 20 69 52 65  , OP_IsNull, iRe
9370: 67 2c 20 69 4a 75 6d 70 29 3b 20 56 64 62 65 43  g, iJump); VdbeC
9380: 6f 76 65 72 61 67 65 28 76 29 3b 0a 20 20 20 20  overage(v);.    
9390: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 73 71      }.        sq
93a0: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28  lite3VdbeAddOp2(
93b0: 76 2c 20 4f 50 5f 46 6b 43 6f 75 6e 74 65 72 2c  v, OP_FkCounter,
93c0: 20 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 72   pFKey->isDeferr
93d0: 65 64 2c 20 2d 31 29 3b 0a 20 20 20 20 20 20 7d  ed, -1);.      }
93e0: 0a 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b  .      continue;
93f0: 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72  .    }.    asser
9400: 74 28 20 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3d 3d  t( pFKey->nCol==
9410: 31 20 7c 7c 20 28 61 69 46 72 65 65 20 26 26 20  1 || (aiFree && 
9420: 70 49 64 78 29 20 29 3b 0a 0a 20 20 20 20 69 66  pIdx) );..    if
9430: 28 20 61 69 46 72 65 65 20 29 7b 0a 20 20 20 20  ( aiFree ){.    
9440: 20 20 61 69 43 6f 6c 20 3d 20 61 69 46 72 65 65    aiCol = aiFree
9450: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
9460: 20 20 20 69 43 6f 6c 20 3d 20 70 46 4b 65 79 2d     iCol = pFKey-
9470: 3e 61 43 6f 6c 5b 30 5d 2e 69 46 72 6f 6d 3b 0a  >aCol[0].iFrom;.
9480: 20 20 20 20 20 20 61 69 43 6f 6c 20 3d 20 26 69        aiCol = &i
9490: 43 6f 6c 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66  Col;.    }.    f
94a0: 6f 72 28 69 3d 30 3b 20 69 3c 70 46 4b 65 79 2d  or(i=0; i<pFKey-
94b0: 3e 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20  >nCol; i++){.   
94c0: 20 20 20 69 66 28 20 61 69 43 6f 6c 5b 69 5d 3d     if( aiCol[i]=
94d0: 3d 70 54 61 62 2d 3e 69 50 4b 65 79 20 29 7b 0a  =pTab->iPKey ){.
94e0: 20 20 20 20 20 20 20 20 61 69 43 6f 6c 5b 69 5d          aiCol[i]
94f0: 20 3d 20 2d 31 3b 0a 20 20 20 20 20 20 7d 0a 23   = -1;.      }.#
9500: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
9510: 49 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e  IT_AUTHORIZATION
9520: 0a 20 20 20 20 20 20 2f 2a 20 52 65 71 75 65 73  .      /* Reques
9530: 74 20 70 65 72 6d 69 73 73 69 6f 6e 20 74 6f 20  t permission to 
9540: 72 65 61 64 20 74 68 65 20 70 61 72 65 6e 74 20  read the parent 
9550: 6b 65 79 20 63 6f 6c 75 6d 6e 73 2e 20 49 66 20  key columns. If 
9560: 74 68 65 20 0a 20 20 20 20 20 20 2a 2a 20 61 75  the .      ** au
9570: 74 68 6f 72 69 7a 61 74 69 6f 6e 20 63 61 6c 6c  thorization call
9580: 62 61 63 6b 20 72 65 74 75 72 6e 73 20 53 51 4c  back returns SQL
9590: 49 54 45 5f 49 47 4e 4f 52 45 2c 20 62 65 68 61  ITE_IGNORE, beha
95a0: 76 65 20 61 73 20 69 66 20 61 6e 79 0a 20 20 20  ve as if any.   
95b0: 20 20 20 2a 2a 20 76 61 6c 75 65 73 20 72 65 61     ** values rea
95c0: 64 20 66 72 6f 6d 20 74 68 65 20 70 61 72 65 6e  d from the paren
95d0: 74 20 74 61 62 6c 65 20 61 72 65 20 4e 55 4c 4c  t table are NULL
95e0: 2e 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 64  . */.      if( d
95f0: 62 2d 3e 78 41 75 74 68 20 29 7b 0a 20 20 20 20  b->xAuth ){.    
9600: 20 20 20 20 69 6e 74 20 72 63 61 75 74 68 3b 0a      int rcauth;.
9610: 20 20 20 20 20 20 20 20 63 68 61 72 20 2a 7a 43          char *zC
9620: 6f 6c 20 3d 20 70 54 6f 2d 3e 61 43 6f 6c 5b 70  ol = pTo->aCol[p
9630: 49 64 78 20 3f 20 70 49 64 78 2d 3e 61 69 43 6f  Idx ? pIdx->aiCo
9640: 6c 75 6d 6e 5b 69 5d 20 3a 20 70 54 6f 2d 3e 69  lumn[i] : pTo->i
9650: 50 4b 65 79 5d 2e 7a 4e 61 6d 65 3b 0a 20 20 20  PKey].zName;.   
9660: 20 20 20 20 20 72 63 61 75 74 68 20 3d 20 73 71       rcauth = sq
9670: 6c 69 74 65 33 41 75 74 68 52 65 61 64 43 6f 6c  lite3AuthReadCol
9680: 28 70 50 61 72 73 65 2c 20 70 54 6f 2d 3e 7a 4e  (pParse, pTo->zN
9690: 61 6d 65 2c 20 7a 43 6f 6c 2c 20 69 44 62 29 3b  ame, zCol, iDb);
96a0: 0a 20 20 20 20 20 20 20 20 62 49 67 6e 6f 72 65  .        bIgnore
96b0: 20 3d 20 28 72 63 61 75 74 68 3d 3d 53 51 4c 49   = (rcauth==SQLI
96c0: 54 45 5f 49 47 4e 4f 52 45 29 3b 0a 20 20 20 20  TE_IGNORE);.    
96d0: 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d    }.#endif.    }
96e0: 0a 0a 20 20 20 20 2f 2a 20 54 61 6b 65 20 61 20  ..    /* Take a 
96f0: 73 68 61 72 65 64 2d 63 61 63 68 65 20 61 64 76  shared-cache adv
9700: 69 73 6f 72 79 20 72 65 61 64 2d 6c 6f 63 6b 20  isory read-lock 
9710: 6f 6e 20 74 68 65 20 70 61 72 65 6e 74 20 74 61  on the parent ta
9720: 62 6c 65 2e 20 41 6c 6c 6f 63 61 74 65 20 0a 20  ble. Allocate . 
9730: 20 20 20 2a 2a 20 61 20 63 75 72 73 6f 72 20 74     ** a cursor t
9740: 6f 20 75 73 65 20 74 6f 20 73 65 61 72 63 68 20  o use to search 
9750: 74 68 65 20 75 6e 69 71 75 65 20 69 6e 64 65 78  the unique index
9760: 20 6f 6e 20 74 68 65 20 70 61 72 65 6e 74 20 6b   on the parent k
9770: 65 79 20 63 6f 6c 75 6d 6e 73 20 0a 20 20 20 20  ey columns .    
9780: 2a 2a 20 69 6e 20 74 68 65 20 70 61 72 65 6e 74  ** in the parent
9790: 20 74 61 62 6c 65 2e 20 20 2a 2f 0a 20 20 20 20   table.  */.    
97a0: 73 71 6c 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b  sqlite3TableLock
97b0: 28 70 50 61 72 73 65 2c 20 69 44 62 2c 20 70 54  (pParse, iDb, pT
97c0: 6f 2d 3e 74 6e 75 6d 2c 20 30 2c 20 70 54 6f 2d  o->tnum, 0, pTo-
97d0: 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 70 50 61  >zName);.    pPa
97e0: 72 73 65 2d 3e 6e 54 61 62 2b 2b 3b 0a 0a 20 20  rse->nTab++;..  
97f0: 20 20 69 66 28 20 72 65 67 4f 6c 64 21 3d 30 20    if( regOld!=0 
9800: 29 7b 0a 20 20 20 20 20 20 2f 2a 20 41 20 72 6f  ){.      /* A ro
9810: 77 20 69 73 20 62 65 69 6e 67 20 72 65 6d 6f 76  w is being remov
9820: 65 64 20 66 72 6f 6d 20 74 68 65 20 63 68 69 6c  ed from the chil
9830: 64 20 74 61 62 6c 65 2e 20 53 65 61 72 63 68 20  d table. Search 
9840: 66 6f 72 20 74 68 65 20 70 61 72 65 6e 74 2e 0a  for the parent..
9850: 20 20 20 20 20 20 2a 2a 20 49 66 20 74 68 65 20        ** If the 
9860: 70 61 72 65 6e 74 20 64 6f 65 73 20 6e 6f 74 20  parent does not 
9870: 65 78 69 73 74 2c 20 72 65 6d 6f 76 69 6e 67 20  exist, removing 
9880: 74 68 65 20 63 68 69 6c 64 20 72 6f 77 20 72 65  the child row re
9890: 73 6f 6c 76 65 73 20 61 6e 20 0a 20 20 20 20 20  solves an .     
98a0: 20 2a 2a 20 6f 75 74 73 74 61 6e 64 69 6e 67 20   ** outstanding 
98b0: 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73  foreign key cons
98c0: 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e  traint violation
98d0: 2e 20 2a 2f 0a 20 20 20 20 20 20 66 6b 4c 6f 6f  . */.      fkLoo
98e0: 6b 75 70 50 61 72 65 6e 74 28 70 50 61 72 73 65  kupParent(pParse
98f0: 2c 20 69 44 62 2c 20 70 54 6f 2c 20 70 49 64 78  , iDb, pTo, pIdx
9900: 2c 20 70 46 4b 65 79 2c 20 61 69 43 6f 6c 2c 20  , pFKey, aiCol, 
9910: 72 65 67 4f 6c 64 2c 20 2d 31 2c 20 62 49 67 6e  regOld, -1, bIgn
9920: 6f 72 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  ore);.    }.    
9930: 69 66 28 20 72 65 67 4e 65 77 21 3d 30 20 26 26  if( regNew!=0 &&
9940: 20 21 69 73 53 65 74 4e 75 6c 6c 41 63 74 69 6f   !isSetNullActio
9950: 6e 28 70 50 61 72 73 65 2c 20 70 46 4b 65 79 29  n(pParse, pFKey)
9960: 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 41 20 72   ){.      /* A r
9970: 6f 77 20 69 73 20 62 65 69 6e 67 20 61 64 64 65  ow is being adde
9980: 64 20 74 6f 20 74 68 65 20 63 68 69 6c 64 20 74  d to the child t
9990: 61 62 6c 65 2e 20 49 66 20 61 20 70 61 72 65 6e  able. If a paren
99a0: 74 20 72 6f 77 20 63 61 6e 6e 6f 74 0a 20 20 20  t row cannot.   
99b0: 20 20 20 2a 2a 20 62 65 20 66 6f 75 6e 64 2c 20     ** be found, 
99c0: 61 64 64 69 6e 67 20 74 68 65 20 63 68 69 6c 64  adding the child
99d0: 20 72 6f 77 20 68 61 73 20 76 69 6f 6c 61 74 65   row has violate
99e0: 64 20 74 68 65 20 46 4b 20 63 6f 6e 73 74 72 61  d the FK constra
99f0: 69 6e 74 2e 20 0a 20 20 20 20 20 20 2a 2a 0a 20  int. .      **. 
9a00: 20 20 20 20 20 2a 2a 20 49 66 20 74 68 69 73 20       ** If this 
9a10: 6f 70 65 72 61 74 69 6f 6e 20 69 73 20 62 65 69  operation is bei
9a20: 6e 67 20 70 65 72 66 6f 72 6d 65 64 20 61 73 20  ng performed as 
9a30: 70 61 72 74 20 6f 66 20 61 20 74 72 69 67 67 65  part of a trigge
9a40: 72 20 70 72 6f 67 72 61 6d 0a 20 20 20 20 20 20  r program.      
9a50: 2a 2a 20 74 68 61 74 20 69 73 20 61 63 74 75 61  ** that is actua
9a60: 6c 6c 79 20 61 20 22 53 45 54 20 4e 55 4c 4c 22  lly a "SET NULL"
9a70: 20 61 63 74 69 6f 6e 20 62 65 6c 6f 6e 67 69 6e   action belongin
9a80: 67 20 74 6f 20 74 68 69 73 20 76 65 72 79 20 0a  g to this very .
9a90: 20 20 20 20 20 20 2a 2a 20 66 6f 72 65 69 67 6e        ** foreign
9aa0: 20 6b 65 79 2c 20 74 68 65 6e 20 6f 6d 69 74 20   key, then omit 
9ab0: 74 68 69 73 20 73 63 61 6e 20 61 6c 74 6f 67 65  this scan altoge
9ac0: 74 68 65 72 2e 20 41 73 20 61 6c 6c 20 63 68 69  ther. As all chi
9ad0: 6c 64 20 6b 65 79 0a 20 20 20 20 20 20 2a 2a 20  ld key.      ** 
9ae0: 76 61 6c 75 65 73 20 61 72 65 20 67 75 61 72 61  values are guara
9af0: 6e 74 65 65 64 20 74 6f 20 62 65 20 4e 55 4c 4c  nteed to be NULL
9b00: 2c 20 69 74 20 69 73 20 6e 6f 74 20 70 6f 73 73  , it is not poss
9b10: 69 62 6c 65 20 66 6f 72 20 61 64 64 69 6e 67 0a  ible for adding.
9b20: 20 20 20 20 20 20 2a 2a 20 74 68 69 73 20 72 6f        ** this ro
9b30: 77 20 74 6f 20 63 61 75 73 65 20 61 6e 20 46 4b  w to cause an FK
9b40: 20 76 69 6f 6c 61 74 69 6f 6e 2e 20 20 2a 2f 0a   violation.  */.
9b50: 20 20 20 20 20 20 66 6b 4c 6f 6f 6b 75 70 50 61        fkLookupPa
9b60: 72 65 6e 74 28 70 50 61 72 73 65 2c 20 69 44 62  rent(pParse, iDb
9b70: 2c 20 70 54 6f 2c 20 70 49 64 78 2c 20 70 46 4b  , pTo, pIdx, pFK
9b80: 65 79 2c 20 61 69 43 6f 6c 2c 20 72 65 67 4e 65  ey, aiCol, regNe
9b90: 77 2c 20 2b 31 2c 20 62 49 67 6e 6f 72 65 29 3b  w, +1, bIgnore);
9ba0: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 73 71 6c 69  .    }..    sqli
9bb0: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 61 69  te3DbFree(db, ai
9bc0: 46 72 65 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  Free);.  }..  /*
9bd0: 20 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20 61 6c   Loop through al
9be0: 6c 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65  l the foreign ke
9bf0: 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 74 68  y constraints th
9c00: 61 74 20 72 65 66 65 72 20 74 6f 20 74 68 69 73  at refer to this
9c10: 20 74 61 62 6c 65 2e 0a 20 20 2a 2a 20 28 74 68   table..  ** (th
9c20: 65 20 22 63 68 69 6c 64 22 20 63 6f 6e 73 74 72  e "child" constr
9c30: 61 69 6e 74 73 29 20 2a 2f 0a 20 20 66 6f 72 28  aints) */.  for(
9c40: 70 46 4b 65 79 20 3d 20 73 71 6c 69 74 65 33 46  pFKey = sqlite3F
9c50: 6b 52 65 66 65 72 65 6e 63 65 73 28 70 54 61 62  kReferences(pTab
9c60: 29 3b 20 70 46 4b 65 79 3b 20 70 46 4b 65 79 3d  ); pFKey; pFKey=
9c70: 70 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f 29 7b  pFKey->pNextTo){
9c80: 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 49 64 78  .    Index *pIdx
9c90: 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20   = 0;           
9ca0: 20 20 20 2f 2a 20 46 6f 72 65 69 67 6e 20 6b 65     /* Foreign ke
9cb0: 79 20 69 6e 64 65 78 20 66 6f 72 20 70 46 4b 65  y index for pFKe
9cc0: 79 20 2a 2f 0a 20 20 20 20 53 72 63 4c 69 73 74  y */.    SrcList
9cd0: 20 2a 70 53 72 63 3b 0a 20 20 20 20 69 6e 74 20   *pSrc;.    int 
9ce0: 2a 61 69 43 6f 6c 20 3d 20 30 3b 0a 0a 20 20 20  *aiCol = 0;..   
9cf0: 20 69 66 28 20 61 43 68 61 6e 67 65 20 26 26 20   if( aChange && 
9d00: 66 6b 50 61 72 65 6e 74 49 73 4d 6f 64 69 66 69  fkParentIsModifi
9d10: 65 64 28 70 54 61 62 2c 20 70 46 4b 65 79 2c 20  ed(pTab, pFKey, 
9d20: 61 43 68 61 6e 67 65 2c 20 62 43 68 6e 67 52 6f  aChange, bChngRo
9d30: 77 69 64 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20  wid)==0 ){.     
9d40: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 7d   continue;.    }
9d50: 0a 0a 20 20 20 20 69 66 28 20 21 70 46 4b 65 79  ..    if( !pFKey
9d60: 2d 3e 69 73 44 65 66 65 72 72 65 64 20 26 26 20  ->isDeferred && 
9d70: 21 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51  !(db->flags & SQ
9d80: 4c 49 54 45 5f 44 65 66 65 72 46 4b 73 29 20 0a  LITE_DeferFKs) .
9d90: 20 20 20 20 20 26 26 20 21 70 50 61 72 73 65 2d       && !pParse-
9da0: 3e 70 54 6f 70 6c 65 76 65 6c 20 26 26 20 21 70  >pToplevel && !p
9db0: 50 61 72 73 65 2d 3e 69 73 4d 75 6c 74 69 57 72  Parse->isMultiWr
9dc0: 69 74 65 20 0a 20 20 20 20 29 7b 0a 20 20 20 20  ite .    ){.    
9dd0: 20 20 61 73 73 65 72 74 28 20 72 65 67 4f 6c 64    assert( regOld
9de0: 3d 3d 30 20 26 26 20 72 65 67 4e 65 77 21 3d 30  ==0 && regNew!=0
9df0: 20 29 3b 0a 20 20 20 20 20 20 2f 2a 20 49 6e 73   );.      /* Ins
9e00: 65 72 74 69 6e 67 20 61 20 73 69 6e 67 6c 65 20  erting a single 
9e10: 72 6f 77 20 69 6e 74 6f 20 61 20 70 61 72 65 6e  row into a paren
9e20: 74 20 74 61 62 6c 65 20 63 61 6e 6e 6f 74 20 63  t table cannot c
9e30: 61 75 73 65 20 28 6f 72 20 66 69 78 29 0a 20 20  ause (or fix).  
9e40: 20 20 20 20 2a 2a 20 61 6e 20 69 6d 6d 65 64 69      ** an immedi
9e50: 61 74 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 20  ate foreign key 
9e60: 76 69 6f 6c 61 74 69 6f 6e 2e 20 53 6f 20 64 6f  violation. So do
9e70: 20 6e 6f 74 68 69 6e 67 20 69 6e 20 74 68 69 73   nothing in this
9e80: 20 63 61 73 65 2e 20 20 2a 2f 0a 20 20 20 20 20   case.  */.     
9e90: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 7d   continue;.    }
9ea0: 0a 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65  ..    if( sqlite
9eb0: 33 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78 28 70  3FkLocateIndex(p
9ec0: 50 61 72 73 65 2c 20 70 54 61 62 2c 20 70 46 4b  Parse, pTab, pFK
9ed0: 65 79 2c 20 26 70 49 64 78 2c 20 26 61 69 43 6f  ey, &pIdx, &aiCo
9ee0: 6c 29 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20  l) ){.      if( 
9ef0: 21 69 73 49 67 6e 6f 72 65 45 72 72 6f 72 73 20  !isIgnoreErrors 
9f00: 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69  || db->mallocFai
9f10: 6c 65 64 20 29 20 72 65 74 75 72 6e 3b 0a 20 20  led ) return;.  
9f20: 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20      continue;.  
9f30: 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20    }.    assert( 
9f40: 61 69 43 6f 6c 20 7c 7c 20 70 46 4b 65 79 2d 3e  aiCol || pFKey->
9f50: 6e 43 6f 6c 3d 3d 31 20 29 3b 0a 0a 20 20 20 20  nCol==1 );..    
9f60: 2f 2a 20 43 72 65 61 74 65 20 61 20 53 72 63 4c  /* Create a SrcL
9f70: 69 73 74 20 73 74 72 75 63 74 75 72 65 20 63 6f  ist structure co
9f80: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 63 68 69  ntaining the chi
9f90: 6c 64 20 74 61 62 6c 65 2e 20 20 57 65 20 6e 65  ld table.  We ne
9fa0: 65 64 20 74 68 65 0a 20 20 20 20 2a 2a 20 63 68  ed the.    ** ch
9fb0: 69 6c 64 20 74 61 62 6c 65 20 61 73 20 61 20 53  ild table as a S
9fc0: 72 63 4c 69 73 74 20 66 6f 72 20 73 71 6c 69 74  rcList for sqlit
9fd0: 65 33 57 68 65 72 65 42 65 67 69 6e 28 29 20 2a  e3WhereBegin() *
9fe0: 2f 0a 20 20 20 20 70 53 72 63 20 3d 20 73 71 6c  /.    pSrc = sql
9ff0: 69 74 65 33 53 72 63 4c 69 73 74 41 70 70 65 6e  ite3SrcListAppen
a000: 64 28 64 62 2c 20 30 2c 20 30 2c 20 30 29 3b 0a  d(db, 0, 0, 0);.
a010: 20 20 20 20 69 66 28 20 70 53 72 63 20 29 7b 0a      if( pSrc ){.
a020: 20 20 20 20 20 20 73 74 72 75 63 74 20 53 72 63        struct Src
a030: 4c 69 73 74 5f 69 74 65 6d 20 2a 70 49 74 65 6d  List_item *pItem
a040: 20 3d 20 70 53 72 63 2d 3e 61 3b 0a 20 20 20 20   = pSrc->a;.    
a050: 20 20 70 49 74 65 6d 2d 3e 70 54 61 62 20 3d 20    pItem->pTab = 
a060: 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 3b 0a 20 20  pFKey->pFrom;.  
a070: 20 20 20 20 70 49 74 65 6d 2d 3e 7a 4e 61 6d 65      pItem->zName
a080: 20 3d 20 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 2d   = pFKey->pFrom-
a090: 3e 7a 4e 61 6d 65 3b 0a 20 20 20 20 20 20 70 49  >zName;.      pI
a0a0: 74 65 6d 2d 3e 70 54 61 62 2d 3e 6e 52 65 66 2b  tem->pTab->nRef+
a0b0: 2b 3b 0a 20 20 20 20 20 20 70 49 74 65 6d 2d 3e  +;.      pItem->
a0c0: 69 43 75 72 73 6f 72 20 3d 20 70 50 61 72 73 65  iCursor = pParse
a0d0: 2d 3e 6e 54 61 62 2b 2b 3b 0a 20 20 0a 20 20 20  ->nTab++;.  .   
a0e0: 20 20 20 69 66 28 20 72 65 67 4e 65 77 21 3d 30     if( regNew!=0
a0f0: 20 29 7b 0a 20 20 20 20 20 20 20 20 66 6b 53 63   ){.        fkSc
a100: 61 6e 43 68 69 6c 64 72 65 6e 28 70 50 61 72 73  anChildren(pPars
a110: 65 2c 20 70 53 72 63 2c 20 70 54 61 62 2c 20 70  e, pSrc, pTab, p
a120: 49 64 78 2c 20 70 46 4b 65 79 2c 20 61 69 43 6f  Idx, pFKey, aiCo
a130: 6c 2c 20 72 65 67 4e 65 77 2c 20 2d 31 29 3b 0a  l, regNew, -1);.
a140: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66        }.      if
a150: 28 20 72 65 67 4f 6c 64 21 3d 30 20 29 7b 0a 20  ( regOld!=0 ){. 
a160: 20 20 20 20 20 20 20 69 6e 74 20 65 41 63 74 69         int eActi
a170: 6f 6e 20 3d 20 70 46 4b 65 79 2d 3e 61 41 63 74  on = pFKey->aAct
a180: 69 6f 6e 5b 61 43 68 61 6e 67 65 21 3d 30 5d 3b  ion[aChange!=0];
a190: 0a 20 20 20 20 20 20 20 20 66 6b 53 63 61 6e 43  .        fkScanC
a1a0: 68 69 6c 64 72 65 6e 28 70 50 61 72 73 65 2c 20  hildren(pParse, 
a1b0: 70 53 72 63 2c 20 70 54 61 62 2c 20 70 49 64 78  pSrc, pTab, pIdx
a1c0: 2c 20 70 46 4b 65 79 2c 20 61 69 43 6f 6c 2c 20  , pFKey, aiCol, 
a1d0: 72 65 67 4f 6c 64 2c 20 31 29 3b 0a 20 20 20 20  regOld, 1);.    
a1e0: 20 20 20 20 2f 2a 20 49 66 20 74 68 69 73 20 69      /* If this i
a1f0: 73 20 61 20 64 65 66 65 72 72 65 64 20 46 4b 20  s a deferred FK 
a200: 63 6f 6e 73 74 72 61 69 6e 74 2c 20 6f 72 20 61  constraint, or a
a210: 20 43 41 53 43 41 44 45 20 6f 72 20 53 45 54 20   CASCADE or SET 
a220: 4e 55 4c 4c 0a 20 20 20 20 20 20 20 20 2a 2a 20  NULL.        ** 
a230: 61 63 74 69 6f 6e 20 61 70 70 6c 69 65 73 2c 20  action applies, 
a240: 74 68 65 6e 20 61 6e 79 20 66 6f 72 65 69 67 6e  then any foreign
a250: 20 6b 65 79 20 76 69 6f 6c 61 74 69 6f 6e 73 20   key violations 
a260: 63 61 75 73 65 64 20 62 79 0a 20 20 20 20 20 20  caused by.      
a270: 20 20 2a 2a 20 72 65 6d 6f 76 69 6e 67 20 74 68    ** removing th
a280: 65 20 70 61 72 65 6e 74 20 6b 65 79 20 77 69 6c  e parent key wil
a290: 6c 20 62 65 20 72 65 63 74 69 66 69 65 64 20 62  l be rectified b
a2a0: 79 20 74 68 65 20 61 63 74 69 6f 6e 20 74 72 69  y the action tri
a2b0: 67 67 65 72 2e 0a 20 20 20 20 20 20 20 20 2a 2a  gger..        **
a2c0: 20 53 6f 20 64 6f 20 6e 6f 74 20 73 65 74 20 74   So do not set t
a2d0: 68 65 20 22 6d 61 79 2d 61 62 6f 72 74 22 20 66  he "may-abort" f
a2e0: 6c 61 67 20 69 6e 20 74 68 69 73 20 63 61 73 65  lag in this case
a2f0: 2e 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 20  ..        **.   
a300: 20 20 20 20 20 2a 2a 20 4e 6f 74 65 20 31 3a 20       ** Note 1: 
a310: 49 66 20 74 68 65 20 46 4b 20 69 73 20 64 65 63  If the FK is dec
a320: 6c 61 72 65 64 20 22 4f 4e 20 55 50 44 41 54 45  lared "ON UPDATE
a330: 20 43 41 53 43 41 44 45 22 2c 20 74 68 65 6e 20   CASCADE", then 
a340: 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 6d  the.        ** m
a350: 61 79 2d 61 62 6f 72 74 20 66 6c 61 67 20 77 69  ay-abort flag wi
a360: 6c 6c 20 65 76 65 6e 74 75 61 6c 6c 79 20 62 65  ll eventually be
a370: 20 73 65 74 20 6f 6e 20 74 68 69 73 20 73 74 61   set on this sta
a380: 74 65 6d 65 6e 74 20 61 6e 79 77 61 79 0a 20 20  tement anyway.  
a390: 20 20 20 20 20 20 2a 2a 20 28 77 68 65 6e 20 74        ** (when t
a3a0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
a3b0: 63 61 6c 6c 65 64 20 61 73 20 70 61 72 74 20 6f  called as part o
a3c0: 66 20 70 72 6f 63 65 73 73 69 6e 67 20 74 68 65  f processing the
a3d0: 20 55 50 44 41 54 45 0a 20 20 20 20 20 20 20 20   UPDATE.        
a3e0: 2a 2a 20 77 69 74 68 69 6e 20 74 68 65 20 61 63  ** within the ac
a3f0: 74 69 6f 6e 20 74 72 69 67 67 65 72 29 2e 0a 20  tion trigger).. 
a400: 20 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20         **.      
a410: 20 20 2a 2a 20 4e 6f 74 65 20 32 3a 20 41 74 20    ** Note 2: At 
a420: 66 69 72 73 74 20 67 6c 61 6e 63 65 20 69 74 20  first glance it 
a430: 6d 61 79 20 73 65 65 6d 20 6c 69 6b 65 20 53 51  may seem like SQ
a440: 4c 69 74 65 20 63 6f 75 6c 64 20 73 69 6d 70 6c  Lite could simpl
a450: 79 20 6f 6d 69 74 0a 20 20 20 20 20 20 20 20 2a  y omit.        *
a460: 2a 20 61 6c 6c 20 4f 50 5f 46 6b 43 6f 75 6e 74  * all OP_FkCount
a470: 65 72 20 72 65 6c 61 74 65 64 20 73 63 61 6e 73  er related scans
a480: 20 77 68 65 6e 20 65 69 74 68 65 72 20 43 41 53   when either CAS
a490: 43 41 44 45 20 6f 72 20 53 45 54 20 4e 55 4c 4c  CADE or SET NULL
a4a0: 0a 20 20 20 20 20 20 20 20 2a 2a 20 61 70 70 6c  .        ** appl
a4b0: 69 65 73 2e 20 54 68 65 20 74 72 6f 75 62 6c 65  ies. The trouble
a4c0: 20 73 74 61 72 74 73 20 69 66 20 74 68 65 20 43   starts if the C
a4d0: 41 53 43 41 44 45 20 6f 72 20 53 45 54 20 4e 55  ASCADE or SET NU
a4e0: 4c 4c 20 61 63 74 69 6f 6e 20 0a 20 20 20 20 20  LL action .     
a4f0: 20 20 20 2a 2a 20 74 72 69 67 67 65 72 20 63 61     ** trigger ca
a500: 75 73 65 73 20 6f 74 68 65 72 20 74 72 69 67 67  uses other trigg
a510: 65 72 73 20 6f 72 20 61 63 74 69 6f 6e 20 72 75  ers or action ru
a520: 6c 65 73 20 61 74 74 61 63 68 65 64 20 74 6f 20  les attached to 
a530: 74 68 65 20 0a 20 20 20 20 20 20 20 20 2a 2a 20  the .        ** 
a540: 63 68 69 6c 64 20 74 61 62 6c 65 20 74 6f 20 66  child table to f
a550: 69 72 65 2e 20 49 6e 20 74 68 65 73 65 20 63 61  ire. In these ca
a560: 73 65 73 20 74 68 65 20 66 6b 20 63 6f 6e 73 74  ses the fk const
a570: 72 61 69 6e 74 20 63 6f 75 6e 74 65 72 73 0a 20  raint counters. 
a580: 20 20 20 20 20 20 20 2a 2a 20 6d 69 67 68 74 20         ** might 
a590: 62 65 20 73 65 74 20 69 6e 63 6f 72 72 65 63 74  be set incorrect
a5a0: 6c 79 20 69 66 20 61 6e 79 20 4f 50 5f 46 6b 43  ly if any OP_FkC
a5b0: 6f 75 6e 74 65 72 20 72 65 6c 61 74 65 64 20 73  ounter related s
a5c0: 63 61 6e 73 20 61 72 65 20 0a 20 20 20 20 20 20  cans are .      
a5d0: 20 20 2a 2a 20 6f 6d 69 74 74 65 64 2e 20 20 2a    ** omitted.  *
a5e0: 2f 0a 20 20 20 20 20 20 20 20 69 66 28 20 21 70  /.        if( !p
a5f0: 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 72 65 64  FKey->isDeferred
a600: 20 26 26 20 65 41 63 74 69 6f 6e 21 3d 4f 45 5f   && eAction!=OE_
a610: 43 61 73 63 61 64 65 20 26 26 20 65 41 63 74 69  Cascade && eActi
a620: 6f 6e 21 3d 4f 45 5f 53 65 74 4e 75 6c 6c 20 29  on!=OE_SetNull )
a630: 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69  {.          sqli
a640: 74 65 33 4d 61 79 41 62 6f 72 74 28 70 50 61 72  te3MayAbort(pPar
a650: 73 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20  se);.        }. 
a660: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 49 74       }.      pIt
a670: 65 6d 2d 3e 7a 4e 61 6d 65 20 3d 20 30 3b 0a 20  em->zName = 0;. 
a680: 20 20 20 20 20 73 71 6c 69 74 65 33 53 72 63 4c       sqlite3SrcL
a690: 69 73 74 44 65 6c 65 74 65 28 64 62 2c 20 70 53  istDelete(db, pS
a6a0: 72 63 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73  rc);.    }.    s
a6b0: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c  qlite3DbFree(db,
a6c0: 20 61 69 43 6f 6c 29 3b 0a 20 20 7d 0a 7d 0a 0a   aiCol);.  }.}..
a6d0: 23 64 65 66 69 6e 65 20 43 4f 4c 55 4d 4e 5f 4d  #define COLUMN_M
a6e0: 41 53 4b 28 78 29 20 28 28 28 78 29 3e 33 31 29  ASK(x) (((x)>31)
a6f0: 20 3f 20 30 78 66 66 66 66 66 66 66 66 20 3a 20   ? 0xffffffff : 
a700: 28 28 75 33 32 29 31 3c 3c 28 78 29 29 29 0a 0a  ((u32)1<<(x)))..
a710: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74  /*.** This funct
a720: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 62 65  ion is called be
a730: 66 6f 72 65 20 67 65 6e 65 72 61 74 69 6e 67 20  fore generating 
a740: 63 6f 64 65 20 74 6f 20 75 70 64 61 74 65 20 6f  code to update o
a750: 72 20 64 65 6c 65 74 65 20 61 20 0a 2a 2a 20 72  r delete a .** r
a760: 6f 77 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20  ow contained in 
a770: 74 61 62 6c 65 20 70 54 61 62 2e 0a 2a 2f 0a 75  table pTab..*/.u
a780: 33 32 20 73 71 6c 69 74 65 33 46 6b 4f 6c 64 6d  32 sqlite3FkOldm
a790: 61 73 6b 28 0a 20 20 50 61 72 73 65 20 2a 70 50  ask(.  Parse *pP
a7a0: 61 72 73 65 2c 20 20 20 20 20 20 20 20 20 20 20  arse,           
a7b0: 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 65 20         /* Parse 
a7c0: 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 54 61 62  context */.  Tab
a7d0: 6c 65 20 2a 70 54 61 62 20 20 20 20 20 20 20 20  le *pTab        
a7e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
a7f0: 54 61 62 6c 65 20 62 65 69 6e 67 20 6d 6f 64 69  Table being modi
a800: 66 69 65 64 20 2a 2f 0a 29 7b 0a 20 20 75 33 32  fied */.){.  u32
a810: 20 6d 61 73 6b 20 3d 20 30 3b 0a 20 20 69 66 28   mask = 0;.  if(
a820: 20 70 50 61 72 73 65 2d 3e 64 62 2d 3e 66 6c 61   pParse->db->fla
a830: 67 73 26 53 51 4c 49 54 45 5f 46 6f 72 65 69 67  gs&SQLITE_Foreig
a840: 6e 4b 65 79 73 20 29 7b 0a 20 20 20 20 46 4b 65  nKeys ){.    FKe
a850: 79 20 2a 70 3b 0a 20 20 20 20 69 6e 74 20 69 3b  y *p;.    int i;
a860: 0a 20 20 20 20 66 6f 72 28 70 3d 70 54 61 62 2d  .    for(p=pTab-
a870: 3e 70 46 4b 65 79 3b 20 70 3b 20 70 3d 70 2d 3e  >pFKey; p; p=p->
a880: 70 4e 65 78 74 46 72 6f 6d 29 7b 0a 20 20 20 20  pNextFrom){.    
a890: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e    for(i=0; i<p->
a8a0: 6e 43 6f 6c 3b 20 69 2b 2b 29 20 6d 61 73 6b 20  nCol; i++) mask 
a8b0: 7c 3d 20 43 4f 4c 55 4d 4e 5f 4d 41 53 4b 28 70  |= COLUMN_MASK(p
a8c0: 2d 3e 61 43 6f 6c 5b 69 5d 2e 69 46 72 6f 6d 29  ->aCol[i].iFrom)
a8d0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28  ;.    }.    for(
a8e0: 70 3d 73 71 6c 69 74 65 33 46 6b 52 65 66 65 72  p=sqlite3FkRefer
a8f0: 65 6e 63 65 73 28 70 54 61 62 29 3b 20 70 3b 20  ences(pTab); p; 
a900: 70 3d 70 2d 3e 70 4e 65 78 74 54 6f 29 7b 0a 20  p=p->pNextTo){. 
a910: 20 20 20 20 20 49 6e 64 65 78 20 2a 70 49 64 78       Index *pIdx
a920: 20 3d 20 30 3b 0a 20 20 20 20 20 20 73 71 6c 69   = 0;.      sqli
a930: 74 65 33 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78  te3FkLocateIndex
a940: 28 70 50 61 72 73 65 2c 20 70 54 61 62 2c 20 70  (pParse, pTab, p
a950: 2c 20 26 70 49 64 78 2c 20 30 29 3b 0a 20 20 20  , &pIdx, 0);.   
a960: 20 20 20 69 66 28 20 70 49 64 78 20 29 7b 0a 20     if( pIdx ){. 
a970: 20 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20         for(i=0; 
a980: 69 3c 70 49 64 78 2d 3e 6e 4b 65 79 43 6f 6c 3b  i<pIdx->nKeyCol;
a990: 20 69 2b 2b 29 20 6d 61 73 6b 20 7c 3d 20 43 4f   i++) mask |= CO
a9a0: 4c 55 4d 4e 5f 4d 41 53 4b 28 70 49 64 78 2d 3e  LUMN_MASK(pIdx->
a9b0: 61 69 43 6f 6c 75 6d 6e 5b 69 5d 29 3b 0a 20 20  aiColumn[i]);.  
a9c0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a      }.    }.  }.
a9d0: 20 20 72 65 74 75 72 6e 20 6d 61 73 6b 3b 0a 7d    return mask;.}
a9e0: 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  .../*.** This fu
a9f0: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64  nction is called
aa00: 20 62 65 66 6f 72 65 20 67 65 6e 65 72 61 74 69   before generati
aa10: 6e 67 20 63 6f 64 65 20 74 6f 20 75 70 64 61 74  ng code to updat
aa20: 65 20 6f 72 20 64 65 6c 65 74 65 20 61 20 0a 2a  e or delete a .*
aa30: 2a 20 72 6f 77 20 63 6f 6e 74 61 69 6e 65 64 20  * row contained 
aa40: 69 6e 20 74 61 62 6c 65 20 70 54 61 62 2e 20 49  in table pTab. I
aa50: 66 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20  f the operation 
aa60: 69 73 20 61 20 44 45 4c 45 54 45 2c 20 74 68 65  is a DELETE, the
aa70: 6e 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 20 61  n.** parameter a
aa80: 43 68 61 6e 67 65 20 69 73 20 70 61 73 73 65 64  Change is passed
aa90: 20 61 20 4e 55 4c 4c 20 76 61 6c 75 65 2e 20 46   a NULL value. F
aaa0: 6f 72 20 61 6e 20 55 50 44 41 54 45 2c 20 61 43  or an UPDATE, aC
aab0: 68 61 6e 67 65 20 70 6f 69 6e 74 73 0a 2a 2a 20  hange points.** 
aac0: 74 6f 20 61 6e 20 61 72 72 61 79 20 6f 66 20 73  to an array of s
aad0: 69 7a 65 20 4e 2c 20 77 68 65 72 65 20 4e 20 69  ize N, where N i
aae0: 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20  s the number of 
aaf0: 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 61 62 6c 65  columns in table
ab00: 20 70 54 61 62 2e 0a 2a 2a 20 49 66 20 74 68 65   pTab..** If the
ab10: 20 69 27 74 68 20 63 6f 6c 75 6d 6e 20 69 73 20   i'th column is 
ab20: 6e 6f 74 20 6d 6f 64 69 66 69 65 64 20 62 79 20  not modified by 
ab30: 74 68 65 20 55 50 44 41 54 45 2c 20 74 68 65 6e  the UPDATE, then
ab40: 20 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69   the correspondi
ab50: 6e 67 20 0a 2a 2a 20 65 6e 74 72 79 20 69 6e 20  ng .** entry in 
ab60: 74 68 65 20 61 43 68 61 6e 67 65 5b 5d 20 61 72  the aChange[] ar
ab70: 72 61 79 20 69 73 20 73 65 74 20 74 6f 20 2d 31  ray is set to -1
ab80: 2e 20 49 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20  . If the column 
ab90: 69 73 20 6d 6f 64 69 66 69 65 64 2c 0a 2a 2a 20  is modified,.** 
aba0: 74 68 65 20 76 61 6c 75 65 20 69 73 20 30 20 6f  the value is 0 o
abb0: 72 20 67 72 65 61 74 65 72 2e 20 50 61 72 61 6d  r greater. Param
abc0: 65 74 65 72 20 63 68 6e 67 52 6f 77 69 64 20 69  eter chngRowid i
abd0: 73 20 73 65 74 20 74 6f 20 74 72 75 65 20 69 66  s set to true if
abe0: 20 74 68 65 0a 2a 2a 20 55 50 44 41 54 45 20 73   the.** UPDATE s
abf0: 74 61 74 65 6d 65 6e 74 20 6d 6f 64 69 66 69 65  tatement modifie
ac00: 73 20 74 68 65 20 72 6f 77 69 64 20 66 69 65 6c  s the rowid fiel
ac10: 64 73 20 6f 66 20 74 68 65 20 74 61 62 6c 65 2e  ds of the table.
ac20: 0a 2a 2a 0a 2a 2a 20 49 66 20 61 6e 79 20 66 6f  .**.** If any fo
ac30: 72 65 69 67 6e 20 6b 65 79 20 70 72 6f 63 65 73  reign key proces
ac40: 73 69 6e 67 20 77 69 6c 6c 20 62 65 20 72 65 71  sing will be req
ac50: 75 69 72 65 64 2c 20 74 68 69 73 20 66 75 6e 63  uired, this func
ac60: 74 69 6f 6e 20 72 65 74 75 72 6e 73 0a 2a 2a 20  tion returns.** 
ac70: 74 72 75 65 2e 20 49 66 20 74 68 65 72 65 20 69  true. If there i
ac80: 73 20 6e 6f 20 66 6f 72 65 69 67 6e 20 6b 65 79  s no foreign key
ac90: 20 72 65 6c 61 74 65 64 20 70 72 6f 63 65 73 73   related process
aca0: 69 6e 67 2c 20 74 68 69 73 20 66 75 6e 63 74 69  ing, this functi
acb0: 6f 6e 20 0a 2a 2a 20 72 65 74 75 72 6e 73 20 66  on .** returns f
acc0: 61 6c 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  alse..*/.int sql
acd0: 69 74 65 33 46 6b 52 65 71 75 69 72 65 64 28 0a  ite3FkRequired(.
ace0: 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c    Parse *pParse,
acf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ad00: 20 20 2f 2a 20 50 61 72 73 65 20 63 6f 6e 74 65    /* Parse conte
ad10: 78 74 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70  xt */.  Table *p
ad20: 54 61 62 2c 20 20 20 20 20 20 20 20 20 20 20 20  Tab,            
ad30: 20 20 20 20 20 20 20 20 2f 2a 20 54 61 62 6c 65          /* Table
ad40: 20 62 65 69 6e 67 20 6d 6f 64 69 66 69 65 64 20   being modified 
ad50: 2a 2f 0a 20 20 69 6e 74 20 2a 61 43 68 61 6e 67  */.  int *aChang
ad60: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e,              
ad70: 20 20 20 20 20 2f 2a 20 4e 6f 6e 2d 4e 55 4c 4c       /* Non-NULL
ad80: 20 66 6f 72 20 55 50 44 41 54 45 20 6f 70 65 72   for UPDATE oper
ad90: 61 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 20  ations */.  int 
ada0: 63 68 6e 67 52 6f 77 69 64 20 20 20 20 20 20 20  chngRowid       
adb0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54              /* T
adc0: 72 75 65 20 66 6f 72 20 55 50 44 41 54 45 20 74  rue for UPDATE t
add0: 68 61 74 20 61 66 66 65 63 74 73 20 72 6f 77 69  hat affects rowi
ade0: 64 20 2a 2f 0a 29 7b 0a 20 20 69 66 28 20 70 50  d */.){.  if( pP
adf0: 61 72 73 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 26  arse->db->flags&
ae00: 53 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65  SQLITE_ForeignKe
ae10: 79 73 20 29 7b 0a 20 20 20 20 69 66 28 20 21 61  ys ){.    if( !a
ae20: 43 68 61 6e 67 65 20 29 7b 0a 20 20 20 20 20 20  Change ){.      
ae30: 2f 2a 20 41 20 44 45 4c 45 54 45 20 6f 70 65 72  /* A DELETE oper
ae40: 61 74 69 6f 6e 2e 20 46 6f 72 65 69 67 6e 20 6b  ation. Foreign k
ae50: 65 79 20 70 72 6f 63 65 73 73 69 6e 67 20 69 73  ey processing is
ae60: 20 72 65 71 75 69 72 65 64 20 69 66 20 74 68 65   required if the
ae70: 20 0a 20 20 20 20 20 20 2a 2a 20 74 61 62 6c 65   .      ** table
ae80: 20 69 6e 20 71 75 65 73 74 69 6f 6e 20 69 73 20   in question is 
ae90: 65 69 74 68 65 72 20 74 68 65 20 63 68 69 6c 64  either the child
aea0: 20 6f 72 20 70 61 72 65 6e 74 20 74 61 62 6c 65   or parent table
aeb0: 20 66 6f 72 20 61 6e 79 20 0a 20 20 20 20 20 20   for any .      
aec0: 2a 2a 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63  ** foreign key c
aed0: 6f 6e 73 74 72 61 69 6e 74 2e 20 20 2a 2f 0a 20  onstraint.  */. 
aee0: 20 20 20 20 20 72 65 74 75 72 6e 20 28 73 71 6c       return (sql
aef0: 69 74 65 33 46 6b 52 65 66 65 72 65 6e 63 65 73  ite3FkReferences
af00: 28 70 54 61 62 29 20 7c 7c 20 70 54 61 62 2d 3e  (pTab) || pTab->
af10: 70 46 4b 65 79 29 3b 0a 20 20 20 20 7d 65 6c 73  pFKey);.    }els
af20: 65 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73  e{.      /* This
af30: 20 69 73 20 61 6e 20 55 50 44 41 54 45 2e 20 46   is an UPDATE. F
af40: 6f 72 65 69 67 6e 20 6b 65 79 20 70 72 6f 63 65  oreign key proce
af50: 73 73 69 6e 67 20 69 73 20 6f 6e 6c 79 20 72 65  ssing is only re
af60: 71 75 69 72 65 64 20 69 66 20 74 68 65 0a 20 20  quired if the.  
af70: 20 20 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e      ** operation
af80: 20 6d 6f 64 69 66 69 65 73 20 6f 6e 65 20 6f 72   modifies one or
af90: 20 6d 6f 72 65 20 63 68 69 6c 64 20 6f 72 20 70   more child or p
afa0: 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e  arent key column
afb0: 73 2e 20 2a 2f 0a 20 20 20 20 20 20 46 4b 65 79  s. */.      FKey
afc0: 20 2a 70 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 43   *p;..      /* C
afd0: 68 65 63 6b 20 69 66 20 61 6e 79 20 63 68 69 6c  heck if any chil
afe0: 64 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 61 72  d key columns ar
aff0: 65 20 62 65 69 6e 67 20 6d 6f 64 69 66 69 65 64  e being modified
b000: 2e 20 2a 2f 0a 20 20 20 20 20 20 66 6f 72 28 70  . */.      for(p
b010: 3d 70 54 61 62 2d 3e 70 46 4b 65 79 3b 20 70 3b  =pTab->pFKey; p;
b020: 20 70 3d 70 2d 3e 70 4e 65 78 74 46 72 6f 6d 29   p=p->pNextFrom)
b030: 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 66 6b  {.        if( fk
b040: 43 68 69 6c 64 49 73 4d 6f 64 69 66 69 65 64 28  ChildIsModified(
b050: 70 54 61 62 2c 20 70 2c 20 61 43 68 61 6e 67 65  pTab, p, aChange
b060: 2c 20 63 68 6e 67 52 6f 77 69 64 29 20 29 20 72  , chngRowid) ) r
b070: 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 20 20 7d  eturn 1;.      }
b080: 0a 0a 20 20 20 20 20 20 2f 2a 20 43 68 65 63 6b  ..      /* Check
b090: 20 69 66 20 61 6e 79 20 70 61 72 65 6e 74 20 6b   if any parent k
b0a0: 65 79 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 62  ey columns are b
b0b0: 65 69 6e 67 20 6d 6f 64 69 66 69 65 64 2e 20 2a  eing modified. *
b0c0: 2f 0a 20 20 20 20 20 20 66 6f 72 28 70 3d 73 71  /.      for(p=sq
b0d0: 6c 69 74 65 33 46 6b 52 65 66 65 72 65 6e 63 65  lite3FkReference
b0e0: 73 28 70 54 61 62 29 3b 20 70 3b 20 70 3d 70 2d  s(pTab); p; p=p-
b0f0: 3e 70 4e 65 78 74 54 6f 29 7b 0a 20 20 20 20 20  >pNextTo){.     
b100: 20 20 20 69 66 28 20 66 6b 50 61 72 65 6e 74 49     if( fkParentI
b110: 73 4d 6f 64 69 66 69 65 64 28 70 54 61 62 2c 20  sModified(pTab, 
b120: 70 2c 20 61 43 68 61 6e 67 65 2c 20 63 68 6e 67  p, aChange, chng
b130: 52 6f 77 69 64 29 20 29 20 72 65 74 75 72 6e 20  Rowid) ) return 
b140: 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  1;.      }.    }
b150: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b  .  }.  return 0;
b160: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
b170: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
b180: 64 20 77 68 65 6e 20 61 6e 20 55 50 44 41 54 45  d when an UPDATE
b190: 20 6f 72 20 44 45 4c 45 54 45 20 6f 70 65 72 61   or DELETE opera
b1a0: 74 69 6f 6e 20 69 73 20 62 65 69 6e 67 20 0a 2a  tion is being .*
b1b0: 2a 20 63 6f 6d 70 69 6c 65 64 20 6f 6e 20 74 61  * compiled on ta
b1c0: 62 6c 65 20 70 54 61 62 2c 20 77 68 69 63 68 20  ble pTab, which 
b1d0: 69 73 20 74 68 65 20 70 61 72 65 6e 74 20 74 61  is the parent ta
b1e0: 62 6c 65 20 6f 66 20 66 6f 72 65 69 67 6e 2d 6b  ble of foreign-k
b1f0: 65 79 20 70 46 4b 65 79 2e 0a 2a 2a 20 49 66 20  ey pFKey..** If 
b200: 74 68 65 20 63 75 72 72 65 6e 74 20 6f 70 65 72  the current oper
b210: 61 74 69 6f 6e 20 69 73 20 61 6e 20 55 50 44 41  ation is an UPDA
b220: 54 45 2c 20 74 68 65 6e 20 74 68 65 20 70 43 68  TE, then the pCh
b230: 61 6e 67 65 73 20 70 61 72 61 6d 65 74 65 72 20  anges parameter 
b240: 69 73 0a 2a 2a 20 70 61 73 73 65 64 20 61 20 70  is.** passed a p
b250: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6c 69  ointer to the li
b260: 73 74 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 62 65  st of columns be
b270: 69 6e 67 20 6d 6f 64 69 66 69 65 64 2e 20 49 66  ing modified. If
b280: 20 69 74 20 69 73 20 61 0a 2a 2a 20 44 45 4c 45   it is a.** DELE
b290: 54 45 2c 20 70 43 68 61 6e 67 65 73 20 69 73 20  TE, pChanges is 
b2a0: 70 61 73 73 65 64 20 61 20 4e 55 4c 4c 20 70 6f  passed a NULL po
b2b0: 69 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 74 20  inter..**.** It 
b2c0: 72 65 74 75 72 6e 73 20 61 20 70 6f 69 6e 74 65  returns a pointe
b2d0: 72 20 74 6f 20 61 20 54 72 69 67 67 65 72 20 73  r to a Trigger s
b2e0: 74 72 75 63 74 75 72 65 20 63 6f 6e 74 61 69 6e  tructure contain
b2f0: 69 6e 67 20 61 20 74 72 69 67 67 65 72 0a 2a 2a  ing a trigger.**
b300: 20 65 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 74   equivalent to t
b310: 68 65 20 4f 4e 20 55 50 44 41 54 45 20 6f 72 20  he ON UPDATE or 
b320: 4f 4e 20 44 45 4c 45 54 45 20 61 63 74 69 6f 6e  ON DELETE action
b330: 20 73 70 65 63 69 66 69 65 64 20 62 79 20 70 46   specified by pF
b340: 4b 65 79 2e 0a 2a 2a 20 49 66 20 74 68 65 20 61  Key..** If the a
b350: 63 74 69 6f 6e 20 69 73 20 22 4e 4f 20 41 43 54  ction is "NO ACT
b360: 49 4f 4e 22 20 6f 72 20 22 52 45 53 54 52 49 43  ION" or "RESTRIC
b370: 54 22 2c 20 74 68 65 6e 20 61 20 4e 55 4c 4c 20  T", then a NULL 
b380: 70 6f 69 6e 74 65 72 20 69 73 0a 2a 2a 20 72 65  pointer is.** re
b390: 74 75 72 6e 65 64 20 28 74 68 65 73 65 20 61 63  turned (these ac
b3a0: 74 69 6f 6e 73 20 72 65 71 75 69 72 65 20 6e 6f  tions require no
b3b0: 20 73 70 65 63 69 61 6c 20 68 61 6e 64 6c 69 6e   special handlin
b3c0: 67 20 62 79 20 74 68 65 20 74 72 69 67 67 65 72  g by the trigger
b3d0: 73 0a 2a 2a 20 73 75 62 2d 73 79 73 74 65 6d 2c  s.** sub-system,
b3e0: 20 63 6f 64 65 20 66 6f 72 20 74 68 65 6d 20 69   code for them i
b3f0: 73 20 63 72 65 61 74 65 64 20 62 79 20 66 6b 53  s created by fkS
b400: 63 61 6e 43 68 69 6c 64 72 65 6e 28 29 29 2e 0a  canChildren())..
b410: 2a 2a 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c  **.** For exampl
b420: 65 2c 20 69 66 20 70 46 4b 65 79 20 69 73 20 74  e, if pFKey is t
b430: 68 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 61  he foreign key a
b440: 6e 64 20 70 54 61 62 20 69 73 20 74 61 62 6c 65  nd pTab is table
b450: 20 22 70 22 20 69 6e 20 0a 2a 2a 20 74 68 65 20   "p" in .** the 
b460: 66 6f 6c 6c 6f 77 69 6e 67 20 73 63 68 65 6d 61  following schema
b470: 3a 0a 2a 2a 0a 2a 2a 20 20 20 43 52 45 41 54 45  :.**.**   CREATE
b480: 20 54 41 42 4c 45 20 70 28 70 6b 20 50 52 49 4d   TABLE p(pk PRIM
b490: 41 52 59 20 4b 45 59 29 3b 0a 2a 2a 20 20 20 43  ARY KEY);.**   C
b4a0: 52 45 41 54 45 20 54 41 42 4c 45 20 63 28 63 6b  REATE TABLE c(ck
b4b0: 20 52 45 46 45 52 45 4e 43 45 53 20 70 20 4f 4e   REFERENCES p ON
b4c0: 20 44 45 4c 45 54 45 20 43 41 53 43 41 44 45 29   DELETE CASCADE)
b4d0: 3b 0a 2a 2a 0a 2a 2a 20 74 68 65 6e 20 74 68 65  ;.**.** then the
b4e0: 20 72 65 74 75 72 6e 65 64 20 74 72 69 67 67 65   returned trigge
b4f0: 72 20 73 74 72 75 63 74 75 72 65 20 69 73 20 65  r structure is e
b500: 71 75 69 76 61 6c 65 6e 74 20 74 6f 3a 0a 2a 2a  quivalent to:.**
b510: 0a 2a 2a 20 20 20 43 52 45 41 54 45 20 54 52 49  .**   CREATE TRI
b520: 47 47 45 52 20 2e 2e 2e 20 44 45 4c 45 54 45 20  GGER ... DELETE 
b530: 4f 4e 20 70 20 42 45 47 49 4e 0a 2a 2a 20 20 20  ON p BEGIN.**   
b540: 20 20 44 45 4c 45 54 45 20 46 52 4f 4d 20 63 20    DELETE FROM c 
b550: 57 48 45 52 45 20 63 6b 20 3d 20 6f 6c 64 2e 70  WHERE ck = old.p
b560: 6b 3b 0a 2a 2a 20 20 20 45 4e 44 3b 0a 2a 2a 0a  k;.**   END;.**.
b570: 2a 2a 20 54 68 65 20 72 65 74 75 72 6e 65 64 20  ** The returned 
b580: 70 6f 69 6e 74 65 72 20 69 73 20 63 61 63 68 65  pointer is cache
b590: 64 20 61 73 20 70 61 72 74 20 6f 66 20 74 68 65  d as part of the
b5a0: 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 6f 62 6a   foreign key obj
b5b0: 65 63 74 2e 20 49 74 0a 2a 2a 20 69 73 20 65 76  ect. It.** is ev
b5c0: 65 6e 74 75 61 6c 6c 79 20 66 72 65 65 64 20 61  entually freed a
b5d0: 6c 6f 6e 67 20 77 69 74 68 20 74 68 65 20 72 65  long with the re
b5e0: 73 74 20 6f 66 20 74 68 65 20 66 6f 72 65 69 67  st of the foreig
b5f0: 6e 20 6b 65 79 20 6f 62 6a 65 63 74 20 62 79 20  n key object by 
b600: 0a 2a 2a 20 73 71 6c 69 74 65 33 46 6b 44 65 6c  .** sqlite3FkDel
b610: 65 74 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63  ete()..*/.static
b620: 20 54 72 69 67 67 65 72 20 2a 66 6b 41 63 74 69   Trigger *fkActi
b630: 6f 6e 54 72 69 67 67 65 72 28 0a 20 20 50 61 72  onTrigger(.  Par
b640: 73 65 20 2a 70 50 61 72 73 65 2c 20 20 20 20 20  se *pParse,     
b650: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
b660: 50 61 72 73 65 20 63 6f 6e 74 65 78 74 20 2a 2f  Parse context */
b670: 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 2c 20  .  Table *pTab, 
b680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b690: 20 20 20 2f 2a 20 54 61 62 6c 65 20 62 65 69 6e     /* Table bein
b6a0: 67 20 75 70 64 61 74 65 64 20 6f 72 20 64 65 6c  g updated or del
b6b0: 65 74 65 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 46  eted from */.  F
b6c0: 4b 65 79 20 2a 70 46 4b 65 79 2c 20 20 20 20 20  Key *pFKey,     
b6d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
b6e0: 2a 20 46 6f 72 65 69 67 6e 20 6b 65 79 20 74 6f  * Foreign key to
b6f0: 20 67 65 74 20 61 63 74 69 6f 6e 20 66 6f 72 20   get action for 
b700: 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70  */.  ExprList *p
b710: 43 68 61 6e 67 65 73 20 20 20 20 20 20 20 20 20  Changes         
b720: 20 20 20 20 20 2f 2a 20 43 68 61 6e 67 65 2d 6c       /* Change-l
b730: 69 73 74 20 66 6f 72 20 55 50 44 41 54 45 2c 20  ist for UPDATE, 
b740: 4e 55 4c 4c 20 66 6f 72 20 44 45 4c 45 54 45 20  NULL for DELETE 
b750: 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20  */.){.  sqlite3 
b760: 2a 64 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62  *db = pParse->db
b770: 3b 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62  ;       /* Datab
b780: 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20  ase handle */.  
b790: 69 6e 74 20 61 63 74 69 6f 6e 3b 20 20 20 20 20  int action;     
b7a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b7b0: 2f 2a 20 4f 6e 65 20 6f 66 20 4f 45 5f 4e 6f 6e  /* One of OE_Non
b7c0: 65 2c 20 4f 45 5f 43 61 73 63 61 64 65 20 65 74  e, OE_Cascade et
b7d0: 63 2e 20 2a 2f 0a 20 20 54 72 69 67 67 65 72 20  c. */.  Trigger 
b7e0: 2a 70 54 72 69 67 67 65 72 3b 20 20 20 20 20 20  *pTrigger;      
b7f0: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 69 67 67          /* Trigg
b800: 65 72 20 64 65 66 69 6e 69 74 69 6f 6e 20 74 6f  er definition to
b810: 20 72 65 74 75 72 6e 20 2a 2f 0a 20 20 69 6e 74   return */.  int
b820: 20 69 41 63 74 69 6f 6e 20 3d 20 28 70 43 68 61   iAction = (pCha
b830: 6e 67 65 73 21 3d 30 29 3b 20 20 20 20 2f 2a 20  nges!=0);    /* 
b840: 31 20 66 6f 72 20 55 50 44 41 54 45 2c 20 30 20  1 for UPDATE, 0 
b850: 66 6f 72 20 44 45 4c 45 54 45 20 2a 2f 0a 0a 20  for DELETE */.. 
b860: 20 61 63 74 69 6f 6e 20 3d 20 70 46 4b 65 79 2d   action = pFKey-
b870: 3e 61 41 63 74 69 6f 6e 5b 69 41 63 74 69 6f 6e  >aAction[iAction
b880: 5d 3b 0a 20 20 70 54 72 69 67 67 65 72 20 3d 20  ];.  pTrigger = 
b890: 70 46 4b 65 79 2d 3e 61 70 54 72 69 67 67 65 72  pFKey->apTrigger
b8a0: 5b 69 41 63 74 69 6f 6e 5d 3b 0a 0a 20 20 69 66  [iAction];..  if
b8b0: 28 20 61 63 74 69 6f 6e 21 3d 4f 45 5f 4e 6f 6e  ( action!=OE_Non
b8c0: 65 20 26 26 20 21 70 54 72 69 67 67 65 72 20 29  e && !pTrigger )
b8d0: 7b 0a 20 20 20 20 75 38 20 65 6e 61 62 6c 65 4c  {.    u8 enableL
b8e0: 6f 6f 6b 61 73 69 64 65 3b 20 20 20 20 20 20 20  ookaside;       
b8f0: 20 20 20 20 2f 2a 20 43 6f 70 79 20 6f 66 20 64      /* Copy of d
b900: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e  b->lookaside.bEn
b910: 61 62 6c 65 64 20 2a 2f 0a 20 20 20 20 63 68 61  abled */.    cha
b920: 72 20 63 6f 6e 73 74 20 2a 7a 46 72 6f 6d 3b 20  r const *zFrom; 
b930: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61             /* Na
b940: 6d 65 20 6f 66 20 63 68 69 6c 64 20 74 61 62 6c  me of child tabl
b950: 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e 46 72  e */.    int nFr
b960: 6f 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  om;             
b970: 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68         /* Length
b980: 20 69 6e 20 62 79 74 65 73 20 6f 66 20 7a 46 72   in bytes of zFr
b990: 6f 6d 20 2a 2f 0a 20 20 20 20 49 6e 64 65 78 20  om */.    Index 
b9a0: 2a 70 49 64 78 20 3d 20 30 3b 20 20 20 20 20 20  *pIdx = 0;      
b9b0: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 65 6e          /* Paren
b9c0: 74 20 6b 65 79 20 69 6e 64 65 78 20 66 6f 72 20  t key index for 
b9d0: 74 68 69 73 20 46 4b 20 2a 2f 0a 20 20 20 20 69  this FK */.    i
b9e0: 6e 74 20 2a 61 69 43 6f 6c 20 3d 20 30 3b 20 20  nt *aiCol = 0;  
b9f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
ba00: 63 68 69 6c 64 20 74 61 62 6c 65 20 63 6f 6c 73  child table cols
ba10: 20 2d 3e 20 70 61 72 65 6e 74 20 6b 65 79 20 63   -> parent key c
ba20: 6f 6c 73 20 2a 2f 0a 20 20 20 20 54 72 69 67 67  ols */.    Trigg
ba30: 65 72 53 74 65 70 20 2a 70 53 74 65 70 20 3d 20  erStep *pStep = 
ba40: 30 3b 20 20 20 20 20 20 20 20 2f 2a 20 46 69 72  0;        /* Fir
ba50: 73 74 20 28 6f 6e 6c 79 29 20 73 74 65 70 20 6f  st (only) step o
ba60: 66 20 74 72 69 67 67 65 72 20 70 72 6f 67 72 61  f trigger progra
ba70: 6d 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70  m */.    Expr *p
ba80: 57 68 65 72 65 20 3d 20 30 3b 20 20 20 20 20 20  Where = 0;      
ba90: 20 20 20 20 20 20 20 2f 2a 20 57 48 45 52 45 20         /* WHERE 
baa0: 63 6c 61 75 73 65 20 6f 66 20 74 72 69 67 67 65  clause of trigge
bab0: 72 20 73 74 65 70 20 2a 2f 0a 20 20 20 20 45 78  r step */.    Ex
bac0: 70 72 4c 69 73 74 20 2a 70 4c 69 73 74 20 3d 20  prList *pList = 
bad0: 30 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43  0;          /* C
bae0: 68 61 6e 67 65 73 20 6c 69 73 74 20 69 66 20 4f  hanges list if O
baf0: 4e 20 55 50 44 41 54 45 20 43 41 53 43 41 44 45  N UPDATE CASCADE
bb00: 20 2a 2f 0a 20 20 20 20 53 65 6c 65 63 74 20 2a   */.    Select *
bb10: 70 53 65 6c 65 63 74 20 3d 20 30 3b 20 20 20 20  pSelect = 0;    
bb20: 20 20 20 20 20 20 2f 2a 20 49 66 20 52 45 53 54        /* If REST
bb30: 52 49 43 54 2c 20 22 53 45 4c 45 43 54 20 52 41  RICT, "SELECT RA
bb40: 49 53 45 28 2e 2e 2e 29 22 20 2a 2f 0a 20 20 20  ISE(...)" */.   
bb50: 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20   int i;         
bb60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
bb70: 2a 20 49 74 65 72 61 74 6f 72 20 76 61 72 69 61  * Iterator varia
bb80: 62 6c 65 20 2a 2f 0a 20 20 20 20 45 78 70 72 20  ble */.    Expr 
bb90: 2a 70 57 68 65 6e 20 3d 20 30 3b 20 20 20 20 20  *pWhen = 0;     
bba0: 20 20 20 20 20 20 20 20 20 2f 2a 20 57 48 45 4e           /* WHEN
bbb0: 20 63 6c 61 75 73 65 20 66 6f 72 20 74 68 65 20   clause for the 
bbc0: 74 72 69 67 67 65 72 20 2a 2f 0a 0a 20 20 20 20  trigger */..    
bbd0: 69 66 28 20 73 71 6c 69 74 65 33 46 6b 4c 6f 63  if( sqlite3FkLoc
bbe0: 61 74 65 49 6e 64 65 78 28 70 50 61 72 73 65 2c  ateIndex(pParse,
bbf0: 20 70 54 61 62 2c 20 70 46 4b 65 79 2c 20 26 70   pTab, pFKey, &p
bc00: 49 64 78 2c 20 26 61 69 43 6f 6c 29 20 29 20 72  Idx, &aiCol) ) r
bc10: 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 61 73 73  eturn 0;.    ass
bc20: 65 72 74 28 20 61 69 43 6f 6c 20 7c 7c 20 70 46  ert( aiCol || pF
bc30: 4b 65 79 2d 3e 6e 43 6f 6c 3d 3d 31 20 29 3b 0a  Key->nCol==1 );.
bc40: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c  .    for(i=0; i<
bc50: 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b  pFKey->nCol; i++
bc60: 29 7b 0a 20 20 20 20 20 20 54 6f 6b 65 6e 20 74  ){.      Token t
bc70: 4f 6c 64 20 3d 20 7b 20 22 6f 6c 64 22 2c 20 33  Old = { "old", 3
bc80: 20 7d 3b 20 20 2f 2a 20 4c 69 74 65 72 61 6c 20   };  /* Literal 
bc90: 22 6f 6c 64 22 20 74 6f 6b 65 6e 20 2a 2f 0a 20  "old" token */. 
bca0: 20 20 20 20 20 54 6f 6b 65 6e 20 74 4e 65 77 20       Token tNew 
bcb0: 3d 20 7b 20 22 6e 65 77 22 2c 20 33 20 7d 3b 20  = { "new", 3 }; 
bcc0: 20 2f 2a 20 4c 69 74 65 72 61 6c 20 22 6e 65 77   /* Literal "new
bcd0: 22 20 74 6f 6b 65 6e 20 2a 2f 0a 20 20 20 20 20  " token */.     
bce0: 20 54 6f 6b 65 6e 20 74 46 72 6f 6d 43 6f 6c 3b   Token tFromCol;
bcf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
bd00: 4e 61 6d 65 20 6f 66 20 63 6f 6c 75 6d 6e 20 69  Name of column i
bd10: 6e 20 63 68 69 6c 64 20 74 61 62 6c 65 20 2a 2f  n child table */
bd20: 0a 20 20 20 20 20 20 54 6f 6b 65 6e 20 74 54 6f  .      Token tTo
bd30: 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20  Col;            
bd40: 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 63 6f     /* Name of co
bd50: 6c 75 6d 6e 20 69 6e 20 70 61 72 65 6e 74 20 74  lumn in parent t
bd60: 61 62 6c 65 20 2a 2f 0a 20 20 20 20 20 20 69 6e  able */.      in
bd70: 74 20 69 46 72 6f 6d 43 6f 6c 3b 20 20 20 20 20  t iFromCol;     
bd80: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 64 78            /* Idx
bd90: 20 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e 20 63 68   of column in ch
bda0: 69 6c 64 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20  ild table */.   
bdb0: 20 20 20 45 78 70 72 20 2a 70 45 71 3b 20 20 20     Expr *pEq;   
bdc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
bdd0: 2a 20 74 46 72 6f 6d 43 6f 6c 20 3d 20 4f 4c 44  * tFromCol = OLD
bde0: 2e 74 54 6f 43 6f 6c 20 2a 2f 0a 0a 20 20 20 20  .tToCol */..    
bdf0: 20 20 69 46 72 6f 6d 43 6f 6c 20 3d 20 61 69 43    iFromCol = aiC
be00: 6f 6c 20 3f 20 61 69 43 6f 6c 5b 69 5d 20 3a 20  ol ? aiCol[i] : 
be10: 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 30 5d 2e 69  pFKey->aCol[0].i
be20: 46 72 6f 6d 3b 0a 20 20 20 20 20 20 61 73 73 65  From;.      asse
be30: 72 74 28 20 69 46 72 6f 6d 43 6f 6c 3e 3d 30 20  rt( iFromCol>=0 
be40: 29 3b 0a 20 20 20 20 20 20 74 54 6f 43 6f 6c 2e  );.      tToCol.
be50: 7a 20 3d 20 70 49 64 78 20 3f 20 70 54 61 62 2d  z = pIdx ? pTab-
be60: 3e 61 43 6f 6c 5b 70 49 64 78 2d 3e 61 69 43 6f  >aCol[pIdx->aiCo
be70: 6c 75 6d 6e 5b 69 5d 5d 2e 7a 4e 61 6d 65 20 3a  lumn[i]].zName :
be80: 20 22 6f 69 64 22 3b 0a 20 20 20 20 20 20 74 46   "oid";.      tF
be90: 72 6f 6d 43 6f 6c 2e 7a 20 3d 20 70 46 4b 65 79  romCol.z = pFKey
bea0: 2d 3e 70 46 72 6f 6d 2d 3e 61 43 6f 6c 5b 69 46  ->pFrom->aCol[iF
beb0: 72 6f 6d 43 6f 6c 5d 2e 7a 4e 61 6d 65 3b 0a 0a  romCol].zName;..
bec0: 20 20 20 20 20 20 74 54 6f 43 6f 6c 2e 6e 20 3d        tToCol.n =
bed0: 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30   sqlite3Strlen30
bee0: 28 74 54 6f 43 6f 6c 2e 7a 29 3b 0a 20 20 20 20  (tToCol.z);.    
bef0: 20 20 74 46 72 6f 6d 43 6f 6c 2e 6e 20 3d 20 73    tFromCol.n = s
bf00: 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 28 74  qlite3Strlen30(t
bf10: 46 72 6f 6d 43 6f 6c 2e 7a 29 3b 0a 0a 20 20 20  FromCol.z);..   
bf20: 20 20 20 2f 2a 20 43 72 65 61 74 65 20 74 68 65     /* Create the
bf30: 20 65 78 70 72 65 73 73 69 6f 6e 20 22 4f 4c 44   expression "OLD
bf40: 2e 7a 54 6f 43 6f 6c 20 3d 20 7a 46 72 6f 6d 43  .zToCol = zFromC
bf50: 6f 6c 22 2e 20 49 74 20 69 73 20 69 6d 70 6f 72  ol". It is impor
bf60: 74 61 6e 74 0a 20 20 20 20 20 20 2a 2a 20 74 68  tant.      ** th
bf70: 61 74 20 74 68 65 20 22 4f 4c 44 2e 7a 54 6f 43  at the "OLD.zToC
bf80: 6f 6c 22 20 74 65 72 6d 20 69 73 20 6f 6e 20 74  ol" term is on t
bf90: 68 65 20 4c 48 53 20 6f 66 20 74 68 65 20 3d 20  he LHS of the = 
bfa0: 6f 70 65 72 61 74 6f 72 2c 20 73 6f 0a 20 20 20  operator, so.   
bfb0: 20 20 20 2a 2a 20 74 68 61 74 20 74 68 65 20 61     ** that the a
bfc0: 66 66 69 6e 69 74 79 20 61 6e 64 20 63 6f 6c 6c  ffinity and coll
bfd0: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 61  ation sequence a
bfe0: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 74  ssociated with t
bff0: 68 65 0a 20 20 20 20 20 20 2a 2a 20 70 61 72 65  he.      ** pare
c000: 6e 74 20 74 61 62 6c 65 20 61 72 65 20 75 73 65  nt table are use
c010: 64 20 66 6f 72 20 74 68 65 20 63 6f 6d 70 61 72  d for the compar
c020: 69 73 6f 6e 2e 20 2a 2f 0a 20 20 20 20 20 20 70  ison. */.      p
c030: 45 71 20 3d 20 73 71 6c 69 74 65 33 50 45 78 70  Eq = sqlite3PExp
c040: 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 45 51 2c  r(pParse, TK_EQ,
c050: 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74  .          sqlit
c060: 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c 20  e3PExpr(pParse, 
c070: 54 4b 5f 44 4f 54 2c 20 0a 20 20 20 20 20 20 20  TK_DOT, .       
c080: 20 20 20 20 20 73 71 6c 69 74 65 33 50 45 78 70       sqlite3PExp
c090: 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 49 44 2c  r(pParse, TK_ID,
c0a0: 20 30 2c 20 30 2c 20 26 74 4f 6c 64 29 2c 0a 20   0, 0, &tOld),. 
c0b0: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
c0c0: 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c 20  e3PExpr(pParse, 
c0d0: 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26 74 54  TK_ID, 0, 0, &tT
c0e0: 6f 43 6f 6c 29 0a 20 20 20 20 20 20 20 20 20 20  oCol).          
c0f0: 2c 20 30 29 2c 0a 20 20 20 20 20 20 20 20 20 20  , 0),.          
c100: 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 50 61  sqlite3PExpr(pPa
c110: 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30 2c 20 30  rse, TK_ID, 0, 0
c120: 2c 20 26 74 46 72 6f 6d 43 6f 6c 29 0a 20 20 20  , &tFromCol).   
c130: 20 20 20 2c 20 30 29 3b 0a 20 20 20 20 20 20 70     , 0);.      p
c140: 57 68 65 72 65 20 3d 20 73 71 6c 69 74 65 33 45  Where = sqlite3E
c150: 78 70 72 41 6e 64 28 64 62 2c 20 70 57 68 65 72  xprAnd(db, pWher
c160: 65 2c 20 70 45 71 29 3b 0a 0a 20 20 20 20 20 20  e, pEq);..      
c170: 2f 2a 20 46 6f 72 20 4f 4e 20 55 50 44 41 54 45  /* For ON UPDATE
c180: 2c 20 63 6f 6e 73 74 72 75 63 74 20 74 68 65 20  , construct the 
c190: 6e 65 78 74 20 74 65 72 6d 20 6f 66 20 74 68 65  next term of the
c1a0: 20 57 48 45 4e 20 63 6c 61 75 73 65 2e 0a 20 20   WHEN clause..  
c1b0: 20 20 20 20 2a 2a 20 54 68 65 20 66 69 6e 61 6c      ** The final
c1c0: 20 57 48 45 4e 20 63 6c 61 75 73 65 20 77 69 6c   WHEN clause wil
c1d0: 6c 20 62 65 20 6c 69 6b 65 20 74 68 69 73 3a 0a  l be like this:.
c1e0: 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a        **.      *
c1f0: 2a 20 20 20 20 57 48 45 4e 20 4e 4f 54 28 6f 6c  *    WHEN NOT(ol
c200: 64 2e 63 6f 6c 31 20 49 53 20 6e 65 77 2e 63 6f  d.col1 IS new.co
c210: 6c 31 20 41 4e 44 20 2e 2e 2e 20 41 4e 44 20 6f  l1 AND ... AND o
c220: 6c 64 2e 63 6f 6c 4e 20 49 53 20 6e 65 77 2e 63  ld.colN IS new.c
c230: 6f 6c 4e 29 0a 20 20 20 20 20 20 2a 2f 0a 20 20  olN).      */.  
c240: 20 20 20 20 69 66 28 20 70 43 68 61 6e 67 65 73      if( pChanges
c250: 20 29 7b 0a 20 20 20 20 20 20 20 20 70 45 71 20   ){.        pEq 
c260: 3d 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70  = sqlite3PExpr(p
c270: 50 61 72 73 65 2c 20 54 4b 5f 49 53 2c 0a 20 20  Parse, TK_IS,.  
c280: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65            sqlite
c290: 33 50 45 78 70 72 28 70 50 61 72 73 65 2c 20 54  3PExpr(pParse, T
c2a0: 4b 5f 44 4f 54 2c 20 0a 20 20 20 20 20 20 20 20  K_DOT, .        
c2b0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 45 78        sqlite3PEx
c2c0: 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 49 44  pr(pParse, TK_ID
c2d0: 2c 20 30 2c 20 30 2c 20 26 74 4f 6c 64 29 2c 0a  , 0, 0, &tOld),.
c2e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71                sq
c2f0: 6c 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73  lite3PExpr(pPars
c300: 65 2c 20 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20  e, TK_ID, 0, 0, 
c310: 26 74 54 6f 43 6f 6c 29 2c 0a 20 20 20 20 20 20  &tToCol),.      
c320: 20 20 20 20 20 20 20 20 30 29 2c 0a 20 20 20 20          0),.    
c330: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50          sqlite3P
c340: 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f  Expr(pParse, TK_
c350: 44 4f 54 2c 20 0a 20 20 20 20 20 20 20 20 20 20  DOT, .          
c360: 20 20 20 20 73 71 6c 69 74 65 33 50 45 78 70 72      sqlite3PExpr
c370: 28 70 50 61 72 73 65 2c 20 54 4b 5f 49 44 2c 20  (pParse, TK_ID, 
c380: 30 2c 20 30 2c 20 26 74 4e 65 77 29 2c 0a 20 20  0, 0, &tNew),.  
c390: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69              sqli
c3a0: 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c  te3PExpr(pParse,
c3b0: 20 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26 74   TK_ID, 0, 0, &t
c3c0: 54 6f 43 6f 6c 29 2c 0a 20 20 20 20 20 20 20 20  ToCol),.        
c3d0: 20 20 20 20 20 20 30 29 2c 0a 20 20 20 20 20 20        0),.      
c3e0: 20 20 20 20 20 20 30 29 3b 0a 20 20 20 20 20 20        0);.      
c3f0: 20 20 70 57 68 65 6e 20 3d 20 73 71 6c 69 74 65    pWhen = sqlite
c400: 33 45 78 70 72 41 6e 64 28 64 62 2c 20 70 57 68  3ExprAnd(db, pWh
c410: 65 6e 2c 20 70 45 71 29 3b 0a 20 20 20 20 20 20  en, pEq);.      
c420: 7d 0a 20 20 0a 20 20 20 20 20 20 69 66 28 20 61  }.  .      if( a
c430: 63 74 69 6f 6e 21 3d 4f 45 5f 52 65 73 74 72 69  ction!=OE_Restri
c440: 63 74 20 26 26 20 28 61 63 74 69 6f 6e 21 3d 4f  ct && (action!=O
c450: 45 5f 43 61 73 63 61 64 65 20 7c 7c 20 70 43 68  E_Cascade || pCh
c460: 61 6e 67 65 73 29 20 29 7b 0a 20 20 20 20 20 20  anges) ){.      
c470: 20 20 45 78 70 72 20 2a 70 4e 65 77 3b 0a 20 20    Expr *pNew;.  
c480: 20 20 20 20 20 20 69 66 28 20 61 63 74 69 6f 6e        if( action
c490: 3d 3d 4f 45 5f 43 61 73 63 61 64 65 20 29 7b 0a  ==OE_Cascade ){.
c4a0: 20 20 20 20 20 20 20 20 20 20 70 4e 65 77 20 3d            pNew =
c4b0: 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 50   sqlite3PExpr(pP
c4c0: 61 72 73 65 2c 20 54 4b 5f 44 4f 54 2c 20 0a 20  arse, TK_DOT, . 
c4d0: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
c4e0: 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c 20  e3PExpr(pParse, 
c4f0: 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26 74 4e  TK_ID, 0, 0, &tN
c500: 65 77 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20  ew),.           
c510: 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 50   sqlite3PExpr(pP
c520: 61 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30 2c 20  arse, TK_ID, 0, 
c530: 30 2c 20 26 74 54 6f 43 6f 6c 29 0a 20 20 20 20  0, &tToCol).    
c540: 20 20 20 20 20 20 2c 20 30 29 3b 0a 20 20 20 20        , 0);.    
c550: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 61 63      }else if( ac
c560: 74 69 6f 6e 3d 3d 4f 45 5f 53 65 74 44 66 6c 74  tion==OE_SetDflt
c570: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 45 78   ){.          Ex
c580: 70 72 20 2a 70 44 66 6c 74 20 3d 20 70 46 4b 65  pr *pDflt = pFKe
c590: 79 2d 3e 70 46 72 6f 6d 2d 3e 61 43 6f 6c 5b 69  y->pFrom->aCol[i
c5a0: 46 72 6f 6d 43 6f 6c 5d 2e 70 44 66 6c 74 3b 0a  FromCol].pDflt;.
c5b0: 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 44            if( pD
c5c0: 66 6c 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20  flt ){.         
c5d0: 20 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 65     pNew = sqlite
c5e0: 33 45 78 70 72 44 75 70 28 64 62 2c 20 70 44 66  3ExprDup(db, pDf
c5f0: 6c 74 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20  lt, 0);.        
c600: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
c610: 20 20 20 20 20 70 4e 65 77 20 3d 20 73 71 6c 69       pNew = sqli
c620: 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c  te3PExpr(pParse,
c630: 20 54 4b 5f 4e 55 4c 4c 2c 20 30 2c 20 30 2c 20   TK_NULL, 0, 0, 
c640: 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a  0);.          }.
c650: 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20          }else{. 
c660: 20 20 20 20 20 20 20 20 20 70 4e 65 77 20 3d 20           pNew = 
c670: 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 50 61  sqlite3PExpr(pPa
c680: 72 73 65 2c 20 54 4b 5f 4e 55 4c 4c 2c 20 30 2c  rse, TK_NULL, 0,
c690: 20 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20   0, 0);.        
c6a0: 7d 0a 20 20 20 20 20 20 20 20 70 4c 69 73 74 20  }.        pList 
c6b0: 3d 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73  = sqlite3ExprLis
c6c0: 74 41 70 70 65 6e 64 28 70 50 61 72 73 65 2c 20  tAppend(pParse, 
c6d0: 70 4c 69 73 74 2c 20 70 4e 65 77 29 3b 0a 20 20  pList, pNew);.  
c6e0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 78 70        sqlite3Exp
c6f0: 72 4c 69 73 74 53 65 74 4e 61 6d 65 28 70 50 61  rListSetName(pPa
c700: 72 73 65 2c 20 70 4c 69 73 74 2c 20 26 74 46 72  rse, pList, &tFr
c710: 6f 6d 43 6f 6c 2c 20 30 29 3b 0a 20 20 20 20 20  omCol, 0);.     
c720: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c   }.    }.    sql
c730: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 61  ite3DbFree(db, a
c740: 69 43 6f 6c 29 3b 0a 0a 20 20 20 20 7a 46 72 6f  iCol);..    zFro
c750: 6d 20 3d 20 70 46 4b 65 79 2d 3e 70 46 72 6f 6d  m = pFKey->pFrom
c760: 2d 3e 7a 4e 61 6d 65 3b 0a 20 20 20 20 6e 46 72  ->zName;.    nFr
c770: 6f 6d 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c  om = sqlite3Strl
c780: 65 6e 33 30 28 7a 46 72 6f 6d 29 3b 0a 0a 20 20  en30(zFrom);..  
c790: 20 20 69 66 28 20 61 63 74 69 6f 6e 3d 3d 4f 45    if( action==OE
c7a0: 5f 52 65 73 74 72 69 63 74 20 29 7b 0a 20 20 20  _Restrict ){.   
c7b0: 20 20 20 54 6f 6b 65 6e 20 74 46 72 6f 6d 3b 0a     Token tFrom;.
c7c0: 20 20 20 20 20 20 45 78 70 72 20 2a 70 52 61 69        Expr *pRai
c7d0: 73 65 3b 20 0a 0a 20 20 20 20 20 20 74 46 72 6f  se; ..      tFro
c7e0: 6d 2e 7a 20 3d 20 7a 46 72 6f 6d 3b 0a 20 20 20  m.z = zFrom;.   
c7f0: 20 20 20 74 46 72 6f 6d 2e 6e 20 3d 20 6e 46 72     tFrom.n = nFr
c800: 6f 6d 3b 0a 20 20 20 20 20 20 70 52 61 69 73 65  om;.      pRaise
c810: 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 28 64   = sqlite3Expr(d
c820: 62 2c 20 54 4b 5f 52 41 49 53 45 2c 20 22 46 4f  b, TK_RAISE, "FO
c830: 52 45 49 47 4e 20 4b 45 59 20 63 6f 6e 73 74 72  REIGN KEY constr
c840: 61 69 6e 74 20 66 61 69 6c 65 64 22 29 3b 0a 20  aint failed");. 
c850: 20 20 20 20 20 69 66 28 20 70 52 61 69 73 65 20       if( pRaise 
c860: 29 7b 0a 20 20 20 20 20 20 20 20 70 52 61 69 73  ){.        pRais
c870: 65 2d 3e 61 66 66 69 6e 69 74 79 20 3d 20 4f 45  e->affinity = OE
c880: 5f 41 62 6f 72 74 3b 0a 20 20 20 20 20 20 7d 0a  _Abort;.      }.
c890: 20 20 20 20 20 20 70 53 65 6c 65 63 74 20 3d 20        pSelect = 
c8a0: 73 71 6c 69 74 65 33 53 65 6c 65 63 74 4e 65 77  sqlite3SelectNew
c8b0: 28 70 50 61 72 73 65 2c 20 0a 20 20 20 20 20 20  (pParse, .      
c8c0: 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 72 4c      sqlite3ExprL
c8d0: 69 73 74 41 70 70 65 6e 64 28 70 50 61 72 73 65  istAppend(pParse
c8e0: 2c 20 30 2c 20 70 52 61 69 73 65 29 2c 0a 20 20  , 0, pRaise),.  
c8f0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 53          sqlite3S
c900: 72 63 4c 69 73 74 41 70 70 65 6e 64 28 64 62 2c  rcListAppend(db,
c910: 20 30 2c 20 26 74 46 72 6f 6d 2c 20 30 29 2c 0a   0, &tFrom, 0),.
c920: 20 20 20 20 20 20 20 20 20 20 70 57 68 65 72 65            pWhere
c930: 2c 0a 20 20 20 20 20 20 20 20 20 20 30 2c 20 30  ,.          0, 0
c940: 2c 20 30 2c 20 30 2c 20 30 2c 20 30 0a 20 20 20  , 0, 0, 0, 0.   
c950: 20 20 20 29 3b 0a 20 20 20 20 20 20 70 57 68 65     );.      pWhe
c960: 72 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 0a 20  re = 0;.    }.. 
c970: 20 20 20 2f 2a 20 44 69 73 61 62 6c 65 20 6c 6f     /* Disable lo
c980: 6f 6b 61 73 69 64 65 20 6d 65 6d 6f 72 79 20 61  okaside memory a
c990: 6c 6c 6f 63 61 74 69 6f 6e 20 2a 2f 0a 20 20 20  llocation */.   
c9a0: 20 65 6e 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65   enableLookaside
c9b0: 20 3d 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65   = db->lookaside
c9c0: 2e 62 45 6e 61 62 6c 65 64 3b 0a 20 20 20 20 64  .bEnabled;.    d
c9d0: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e  b->lookaside.bEn
c9e0: 61 62 6c 65 64 20 3d 20 30 3b 0a 0a 20 20 20 20  abled = 0;..    
c9f0: 70 54 72 69 67 67 65 72 20 3d 20 28 54 72 69 67  pTrigger = (Trig
ca00: 67 65 72 20 2a 29 73 71 6c 69 74 65 33 44 62 4d  ger *)sqlite3DbM
ca10: 61 6c 6c 6f 63 5a 65 72 6f 28 64 62 2c 20 0a 20  allocZero(db, . 
ca20: 20 20 20 20 20 20 20 73 69 7a 65 6f 66 28 54 72         sizeof(Tr
ca30: 69 67 67 65 72 29 20 2b 20 20 20 20 20 20 20 20  igger) +        
ca40: 20 2f 2a 20 73 74 72 75 63 74 20 54 72 69 67 67   /* struct Trigg
ca50: 65 72 20 2a 2f 0a 20 20 20 20 20 20 20 20 73 69  er */.        si
ca60: 7a 65 6f 66 28 54 72 69 67 67 65 72 53 74 65 70  zeof(TriggerStep
ca70: 29 20 2b 20 20 20 20 20 2f 2a 20 53 69 6e 67 6c  ) +     /* Singl
ca80: 65 20 73 74 65 70 20 69 6e 20 74 72 69 67 67 65  e step in trigge
ca90: 72 20 70 72 6f 67 72 61 6d 20 2a 2f 0a 20 20 20  r program */.   
caa0: 20 20 20 20 20 6e 46 72 6f 6d 20 2b 20 31 20 20       nFrom + 1  
cab0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
cac0: 2a 20 53 70 61 63 65 20 66 6f 72 20 70 53 74 65  * Space for pSte
cad0: 70 2d 3e 74 61 72 67 65 74 2e 7a 20 2a 2f 0a 20  p->target.z */. 
cae0: 20 20 20 29 3b 0a 20 20 20 20 69 66 28 20 70 54     );.    if( pT
caf0: 72 69 67 67 65 72 20 29 7b 0a 20 20 20 20 20 20  rigger ){.      
cb00: 70 53 74 65 70 20 3d 20 70 54 72 69 67 67 65 72  pStep = pTrigger
cb10: 2d 3e 73 74 65 70 5f 6c 69 73 74 20 3d 20 28 54  ->step_list = (T
cb20: 72 69 67 67 65 72 53 74 65 70 20 2a 29 26 70 54  riggerStep *)&pT
cb30: 72 69 67 67 65 72 5b 31 5d 3b 0a 20 20 20 20 20  rigger[1];.     
cb40: 20 70 53 74 65 70 2d 3e 74 61 72 67 65 74 2e 7a   pStep->target.z
cb50: 20 3d 20 28 63 68 61 72 20 2a 29 26 70 53 74 65   = (char *)&pSte
cb60: 70 5b 31 5d 3b 0a 20 20 20 20 20 20 70 53 74 65  p[1];.      pSte
cb70: 70 2d 3e 74 61 72 67 65 74 2e 6e 20 3d 20 6e 46  p->target.n = nF
cb80: 72 6f 6d 3b 0a 20 20 20 20 20 20 6d 65 6d 63 70  rom;.      memcp
cb90: 79 28 28 63 68 61 72 20 2a 29 70 53 74 65 70 2d  y((char *)pStep-
cba0: 3e 74 61 72 67 65 74 2e 7a 2c 20 7a 46 72 6f 6d  >target.z, zFrom
cbb0: 2c 20 6e 46 72 6f 6d 29 3b 0a 20 20 0a 20 20 20  , nFrom);.  .   
cbc0: 20 20 20 70 53 74 65 70 2d 3e 70 57 68 65 72 65     pStep->pWhere
cbd0: 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 44 75   = sqlite3ExprDu
cbe0: 70 28 64 62 2c 20 70 57 68 65 72 65 2c 20 45 58  p(db, pWhere, EX
cbf0: 50 52 44 55 50 5f 52 45 44 55 43 45 29 3b 0a 20  PRDUP_REDUCE);. 
cc00: 20 20 20 20 20 70 53 74 65 70 2d 3e 70 45 78 70       pStep->pExp
cc10: 72 4c 69 73 74 20 3d 20 73 71 6c 69 74 65 33 45  rList = sqlite3E
cc20: 78 70 72 4c 69 73 74 44 75 70 28 64 62 2c 20 70  xprListDup(db, p
cc30: 4c 69 73 74 2c 20 45 58 50 52 44 55 50 5f 52 45  List, EXPRDUP_RE
cc40: 44 55 43 45 29 3b 0a 20 20 20 20 20 20 70 53 74  DUCE);.      pSt
cc50: 65 70 2d 3e 70 53 65 6c 65 63 74 20 3d 20 73 71  ep->pSelect = sq
cc60: 6c 69 74 65 33 53 65 6c 65 63 74 44 75 70 28 64  lite3SelectDup(d
cc70: 62 2c 20 70 53 65 6c 65 63 74 2c 20 45 58 50 52  b, pSelect, EXPR
cc80: 44 55 50 5f 52 45 44 55 43 45 29 3b 0a 20 20 20  DUP_REDUCE);.   
cc90: 20 20 20 69 66 28 20 70 57 68 65 6e 20 29 7b 0a     if( pWhen ){.
cca0: 20 20 20 20 20 20 20 20 70 57 68 65 6e 20 3d 20          pWhen = 
ccb0: 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 50 61  sqlite3PExpr(pPa
ccc0: 72 73 65 2c 20 54 4b 5f 4e 4f 54 2c 20 70 57 68  rse, TK_NOT, pWh
ccd0: 65 6e 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 20  en, 0, 0);.     
cce0: 20 20 20 70 54 72 69 67 67 65 72 2d 3e 70 57 68     pTrigger->pWh
ccf0: 65 6e 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72  en = sqlite3Expr
cd00: 44 75 70 28 64 62 2c 20 70 57 68 65 6e 2c 20 45  Dup(db, pWhen, E
cd10: 58 50 52 44 55 50 5f 52 45 44 55 43 45 29 3b 0a  XPRDUP_REDUCE);.
cd20: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20        }.    }.. 
cd30: 20 20 20 2f 2a 20 52 65 2d 65 6e 61 62 6c 65 20     /* Re-enable 
cd40: 74 68 65 20 6c 6f 6f 6b 61 73 69 64 65 20 62 75  the lookaside bu
cd50: 66 66 65 72 2c 20 69 66 20 69 74 20 77 61 73 20  ffer, if it was 
cd60: 64 69 73 61 62 6c 65 64 20 65 61 72 6c 69 65 72  disabled earlier
cd70: 2e 20 2a 2f 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f  . */.    db->loo
cd80: 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 64 20  kaside.bEnabled 
cd90: 3d 20 65 6e 61 62 6c 65 4c 6f 6f 6b 61 73 69 64  = enableLookasid
cda0: 65 3b 0a 0a 20 20 20 20 73 71 6c 69 74 65 33 45  e;..    sqlite3E
cdb0: 78 70 72 44 65 6c 65 74 65 28 64 62 2c 20 70 57  xprDelete(db, pW
cdc0: 68 65 72 65 29 3b 0a 20 20 20 20 73 71 6c 69 74  here);.    sqlit
cdd0: 65 33 45 78 70 72 44 65 6c 65 74 65 28 64 62 2c  e3ExprDelete(db,
cde0: 20 70 57 68 65 6e 29 3b 0a 20 20 20 20 73 71 6c   pWhen);.    sql
cdf0: 69 74 65 33 45 78 70 72 4c 69 73 74 44 65 6c 65  ite3ExprListDele
ce00: 74 65 28 64 62 2c 20 70 4c 69 73 74 29 3b 0a 20  te(db, pList);. 
ce10: 20 20 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74     sqlite3Select
ce20: 44 65 6c 65 74 65 28 64 62 2c 20 70 53 65 6c 65  Delete(db, pSele
ce30: 63 74 29 3b 0a 20 20 20 20 69 66 28 20 64 62 2d  ct);.    if( db-
ce40: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 3d 3d 31  >mallocFailed==1
ce50: 20 29 7b 0a 20 20 20 20 20 20 66 6b 54 72 69 67   ){.      fkTrig
ce60: 67 65 72 44 65 6c 65 74 65 28 64 62 2c 20 70 54  gerDelete(db, pT
ce70: 72 69 67 67 65 72 29 3b 0a 20 20 20 20 20 20 72  rigger);.      r
ce80: 65 74 75 72 6e 20 30 3b 0a 20 20 20 20 7d 0a 20  eturn 0;.    }. 
ce90: 20 20 20 61 73 73 65 72 74 28 20 70 53 74 65 70     assert( pStep
cea0: 21 3d 30 20 29 3b 0a 0a 20 20 20 20 73 77 69 74  !=0 );..    swit
ceb0: 63 68 28 20 61 63 74 69 6f 6e 20 29 7b 0a 20 20  ch( action ){.  
cec0: 20 20 20 20 63 61 73 65 20 4f 45 5f 52 65 73 74      case OE_Rest
ced0: 72 69 63 74 3a 0a 20 20 20 20 20 20 20 20 70 53  rict:.        pS
cee0: 74 65 70 2d 3e 6f 70 20 3d 20 54 4b 5f 53 45 4c  tep->op = TK_SEL
cef0: 45 43 54 3b 20 0a 20 20 20 20 20 20 20 20 62 72  ECT; .        br
cf00: 65 61 6b 3b 0a 20 20 20 20 20 20 63 61 73 65 20  eak;.      case 
cf10: 4f 45 5f 43 61 73 63 61 64 65 3a 20 0a 20 20 20  OE_Cascade: .   
cf20: 20 20 20 20 20 69 66 28 20 21 70 43 68 61 6e 67       if( !pChang
cf30: 65 73 20 29 7b 20 0a 20 20 20 20 20 20 20 20 20  es ){ .         
cf40: 20 70 53 74 65 70 2d 3e 6f 70 20 3d 20 54 4b 5f   pStep->op = TK_
cf50: 44 45 4c 45 54 45 3b 20 0a 20 20 20 20 20 20 20  DELETE; .       
cf60: 20 20 20 62 72 65 61 6b 3b 20 0a 20 20 20 20 20     break; .     
cf70: 20 20 20 7d 0a 20 20 20 20 20 20 64 65 66 61 75     }.      defau
cf80: 6c 74 3a 0a 20 20 20 20 20 20 20 20 70 53 74 65  lt:.        pSte
cf90: 70 2d 3e 6f 70 20 3d 20 54 4b 5f 55 50 44 41 54  p->op = TK_UPDAT
cfa0: 45 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 53 74  E;.    }.    pSt
cfb0: 65 70 2d 3e 70 54 72 69 67 20 3d 20 70 54 72 69  ep->pTrig = pTri
cfc0: 67 67 65 72 3b 0a 20 20 20 20 70 54 72 69 67 67  gger;.    pTrigg
cfd0: 65 72 2d 3e 70 53 63 68 65 6d 61 20 3d 20 70 54  er->pSchema = pT
cfe0: 61 62 2d 3e 70 53 63 68 65 6d 61 3b 0a 20 20 20  ab->pSchema;.   
cff0: 20 70 54 72 69 67 67 65 72 2d 3e 70 54 61 62 53   pTrigger->pTabS
d000: 63 68 65 6d 61 20 3d 20 70 54 61 62 2d 3e 70 53  chema = pTab->pS
d010: 63 68 65 6d 61 3b 0a 20 20 20 20 70 46 4b 65 79  chema;.    pFKey
d020: 2d 3e 61 70 54 72 69 67 67 65 72 5b 69 41 63 74  ->apTrigger[iAct
d030: 69 6f 6e 5d 20 3d 20 70 54 72 69 67 67 65 72 3b  ion] = pTrigger;
d040: 0a 20 20 20 20 70 54 72 69 67 67 65 72 2d 3e 6f  .    pTrigger->o
d050: 70 20 3d 20 28 70 43 68 61 6e 67 65 73 20 3f 20  p = (pChanges ? 
d060: 54 4b 5f 55 50 44 41 54 45 20 3a 20 54 4b 5f 44  TK_UPDATE : TK_D
d070: 45 4c 45 54 45 29 3b 0a 20 20 7d 0a 0a 20 20 72  ELETE);.  }..  r
d080: 65 74 75 72 6e 20 70 54 72 69 67 67 65 72 3b 0a  eturn pTrigger;.
d090: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75  }../*.** This fu
d0a0: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64  nction is called
d0b0: 20 77 68 65 6e 20 64 65 6c 65 74 69 6e 67 20 6f   when deleting o
d0c0: 72 20 75 70 64 61 74 69 6e 67 20 61 20 72 6f 77  r updating a row
d0d0: 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 0a 2a 2a   to implement.**
d0e0: 20 61 6e 79 20 72 65 71 75 69 72 65 64 20 43 41   any required CA
d0f0: 53 43 41 44 45 2c 20 53 45 54 20 4e 55 4c 4c 20  SCADE, SET NULL 
d100: 6f 72 20 53 45 54 20 44 45 46 41 55 4c 54 20 61  or SET DEFAULT a
d110: 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 76 6f 69 64 20  ctions..*/.void 
d120: 73 71 6c 69 74 65 33 46 6b 41 63 74 69 6f 6e 73  sqlite3FkActions
d130: 28 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73  (.  Parse *pPars
d140: 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  e,              
d150: 20 20 20 20 2f 2a 20 50 61 72 73 65 20 63 6f 6e      /* Parse con
d160: 74 65 78 74 20 2a 2f 0a 20 20 54 61 62 6c 65 20  text */.  Table 
d170: 2a 70 54 61 62 2c 20 20 20 20 20 20 20 20 20 20  *pTab,          
d180: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 62            /* Tab
d190: 6c 65 20 62 65 69 6e 67 20 75 70 64 61 74 65 64  le being updated
d1a0: 20 6f 72 20 64 65 6c 65 74 65 64 20 66 72 6f 6d   or deleted from
d1b0: 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a   */.  ExprList *
d1c0: 70 43 68 61 6e 67 65 73 2c 20 20 20 20 20 20 20  pChanges,       
d1d0: 20 20 20 20 20 20 2f 2a 20 43 68 61 6e 67 65 2d        /* Change-
d1e0: 6c 69 73 74 20 66 6f 72 20 55 50 44 41 54 45 2c  list for UPDATE,
d1f0: 20 4e 55 4c 4c 20 66 6f 72 20 44 45 4c 45 54 45   NULL for DELETE
d200: 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 4f 6c 64   */.  int regOld
d210: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
d220: 20 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73        /* Address
d230: 20 6f 66 20 61 72 72 61 79 20 63 6f 6e 74 61 69   of array contai
d240: 6e 69 6e 67 20 6f 6c 64 20 72 6f 77 20 2a 2f 0a  ning old row */.
d250: 20 20 69 6e 74 20 2a 61 43 68 61 6e 67 65 2c 20    int *aChange, 
d260: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
d270: 20 20 2f 2a 20 41 72 72 61 79 20 69 6e 64 69 63    /* Array indic
d280: 61 74 69 6e 67 20 55 50 44 41 54 45 64 20 63 6f  ating UPDATEd co
d290: 6c 75 6d 6e 73 20 28 6f 72 20 30 29 20 2a 2f 0a  lumns (or 0) */.
d2a0: 20 20 69 6e 74 20 62 43 68 6e 67 52 6f 77 69 64    int bChngRowid
d2b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
d2c0: 20 20 2f 2a 20 54 72 75 65 20 69 66 20 72 6f 77    /* True if row
d2d0: 69 64 20 69 73 20 55 50 44 41 54 45 64 20 2a 2f  id is UPDATEd */
d2e0: 0a 29 7b 0a 20 20 2f 2a 20 49 66 20 66 6f 72 65  .){.  /* If fore
d2f0: 69 67 6e 2d 6b 65 79 20 73 75 70 70 6f 72 74 20  ign-key support 
d300: 69 73 20 65 6e 61 62 6c 65 64 2c 20 69 74 65 72  is enabled, iter
d310: 61 74 65 20 74 68 72 6f 75 67 68 20 61 6c 6c 20  ate through all 
d320: 46 4b 73 20 74 68 61 74 20 0a 20 20 2a 2a 20 72  FKs that .  ** r
d330: 65 66 65 72 20 74 6f 20 74 61 62 6c 65 20 70 54  efer to table pT
d340: 61 62 2e 20 49 66 20 74 68 65 72 65 20 69 73 20  ab. If there is 
d350: 61 6e 20 61 63 74 69 6f 6e 20 61 73 73 6f 63 69  an action associ
d360: 61 74 65 64 20 77 69 74 68 20 74 68 65 20 46 4b  ated with the FK
d370: 20 0a 20 20 2a 2a 20 66 6f 72 20 74 68 69 73 20   .  ** for this 
d380: 6f 70 65 72 61 74 69 6f 6e 20 28 65 69 74 68 65  operation (eithe
d390: 72 20 75 70 64 61 74 65 20 6f 72 20 64 65 6c 65  r update or dele
d3a0: 74 65 29 2c 20 69 6e 76 6f 6b 65 20 74 68 65 20  te), invoke the 
d3b0: 61 73 73 6f 63 69 61 74 65 64 20 0a 20 20 2a 2a  associated .  **
d3c0: 20 74 72 69 67 67 65 72 20 73 75 62 2d 70 72 6f   trigger sub-pro
d3d0: 67 72 61 6d 2e 20 20 2a 2f 0a 20 20 69 66 28 20  gram.  */.  if( 
d3e0: 70 50 61 72 73 65 2d 3e 64 62 2d 3e 66 6c 61 67  pParse->db->flag
d3f0: 73 26 53 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e  s&SQLITE_Foreign
d400: 4b 65 79 73 20 29 7b 0a 20 20 20 20 46 4b 65 79  Keys ){.    FKey
d410: 20 2a 70 46 4b 65 79 3b 20 20 20 20 20 20 20 20   *pFKey;        
d420: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 74 65            /* Ite
d430: 72 61 74 6f 72 20 76 61 72 69 61 62 6c 65 20 2a  rator variable *
d440: 2f 0a 20 20 20 20 66 6f 72 28 70 46 4b 65 79 20  /.    for(pFKey 
d450: 3d 20 73 71 6c 69 74 65 33 46 6b 52 65 66 65 72  = sqlite3FkRefer
d460: 65 6e 63 65 73 28 70 54 61 62 29 3b 20 70 46 4b  ences(pTab); pFK
d470: 65 79 3b 20 70 46 4b 65 79 3d 70 46 4b 65 79 2d  ey; pFKey=pFKey-
d480: 3e 70 4e 65 78 74 54 6f 29 7b 0a 20 20 20 20 20  >pNextTo){.     
d490: 20 69 66 28 20 61 43 68 61 6e 67 65 3d 3d 30 20   if( aChange==0 
d4a0: 7c 7c 20 66 6b 50 61 72 65 6e 74 49 73 4d 6f 64  || fkParentIsMod
d4b0: 69 66 69 65 64 28 70 54 61 62 2c 20 70 46 4b 65  ified(pTab, pFKe
d4c0: 79 2c 20 61 43 68 61 6e 67 65 2c 20 62 43 68 6e  y, aChange, bChn
d4d0: 67 52 6f 77 69 64 29 20 29 7b 0a 20 20 20 20 20  gRowid) ){.     
d4e0: 20 20 20 54 72 69 67 67 65 72 20 2a 70 41 63 74     Trigger *pAct
d4f0: 20 3d 20 66 6b 41 63 74 69 6f 6e 54 72 69 67 67   = fkActionTrigg
d500: 65 72 28 70 50 61 72 73 65 2c 20 70 54 61 62 2c  er(pParse, pTab,
d510: 20 70 46 4b 65 79 2c 20 70 43 68 61 6e 67 65 73   pFKey, pChanges
d520: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70  );.        if( p
d530: 41 63 74 20 29 7b 0a 20 20 20 20 20 20 20 20 20  Act ){.         
d540: 20 73 71 6c 69 74 65 33 43 6f 64 65 52 6f 77 54   sqlite3CodeRowT
d550: 72 69 67 67 65 72 44 69 72 65 63 74 28 70 50 61  riggerDirect(pPa
d560: 72 73 65 2c 20 70 41 63 74 2c 20 70 54 61 62 2c  rse, pAct, pTab,
d570: 20 72 65 67 4f 6c 64 2c 20 4f 45 5f 41 62 6f 72   regOld, OE_Abor
d580: 74 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 7d  t, 0);.        }
d590: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
d5a0: 20 7d 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20   }.}..#endif /* 
d5b0: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
d5c0: 49 54 5f 54 52 49 47 47 45 52 20 2a 2f 0a 0a 2f  IT_TRIGGER */../
d5d0: 2a 0a 2a 2a 20 46 72 65 65 20 61 6c 6c 20 6d 65  *.** Free all me
d5e0: 6d 6f 72 79 20 61 73 73 6f 63 69 61 74 65 64 20  mory associated 
d5f0: 77 69 74 68 20 66 6f 72 65 69 67 6e 20 6b 65 79  with foreign key
d600: 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 61 74 74   definitions att
d610: 61 63 68 65 64 20 74 6f 0a 2a 2a 20 74 61 62 6c  ached to.** tabl
d620: 65 20 70 54 61 62 2e 20 52 65 6d 6f 76 65 20 74  e pTab. Remove t
d630: 68 65 20 64 65 6c 65 74 65 64 20 66 6f 72 65 69  he deleted forei
d640: 67 6e 20 6b 65 79 73 20 66 72 6f 6d 20 74 68 65  gn keys from the
d650: 20 53 63 68 65 6d 61 2e 66 6b 65 79 48 61 73 68   Schema.fkeyHash
d660: 0a 2a 2a 20 68 61 73 68 20 74 61 62 6c 65 2e 0a  .** hash table..
d670: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 46  */.void sqlite3F
d680: 6b 44 65 6c 65 74 65 28 73 71 6c 69 74 65 33 20  kDelete(sqlite3 
d690: 2a 64 62 2c 20 54 61 62 6c 65 20 2a 70 54 61 62  *db, Table *pTab
d6a0: 29 7b 0a 20 20 46 4b 65 79 20 2a 70 46 4b 65 79  ){.  FKey *pFKey
d6b0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
d6c0: 20 20 20 20 20 2f 2a 20 49 74 65 72 61 74 6f 72       /* Iterator
d6d0: 20 76 61 72 69 61 62 6c 65 20 2a 2f 0a 20 20 46   variable */.  F
d6e0: 4b 65 79 20 2a 70 4e 65 78 74 3b 20 20 20 20 20  Key *pNext;     
d6f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
d700: 2a 20 43 6f 70 79 20 6f 66 20 70 46 4b 65 79 2d  * Copy of pFKey-
d710: 3e 70 4e 65 78 74 46 72 6f 6d 20 2a 2f 0a 0a 20  >pNextFrom */.. 
d720: 20 61 73 73 65 72 74 28 20 64 62 3d 3d 30 20 7c   assert( db==0 |
d730: 7c 20 73 71 6c 69 74 65 33 53 63 68 65 6d 61 4d  | sqlite3SchemaM
d740: 75 74 65 78 48 65 6c 64 28 64 62 2c 20 30 2c 20  utexHeld(db, 0, 
d750: 70 54 61 62 2d 3e 70 53 63 68 65 6d 61 29 20 29  pTab->pSchema) )
d760: 3b 0a 20 20 66 6f 72 28 70 46 4b 65 79 3d 70 54  ;.  for(pFKey=pT
d770: 61 62 2d 3e 70 46 4b 65 79 3b 20 70 46 4b 65 79  ab->pFKey; pFKey
d780: 3b 20 70 46 4b 65 79 3d 70 4e 65 78 74 29 7b 0a  ; pFKey=pNext){.
d790: 0a 20 20 20 20 2f 2a 20 52 65 6d 6f 76 65 20 74  .    /* Remove t
d7a0: 68 65 20 46 4b 20 66 72 6f 6d 20 74 68 65 20 66  he FK from the f
d7b0: 6b 65 79 48 61 73 68 20 68 61 73 68 20 74 61 62  keyHash hash tab
d7c0: 6c 65 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 21  le. */.    if( !
d7d0: 64 62 20 7c 7c 20 64 62 2d 3e 70 6e 42 79 74 65  db || db->pnByte
d7e0: 73 46 72 65 65 64 3d 3d 30 20 29 7b 0a 20 20 20  sFreed==0 ){.   
d7f0: 20 20 20 69 66 28 20 70 46 4b 65 79 2d 3e 70 50     if( pFKey->pP
d800: 72 65 76 54 6f 20 29 7b 0a 20 20 20 20 20 20 20  revTo ){.       
d810: 20 70 46 4b 65 79 2d 3e 70 50 72 65 76 54 6f 2d   pFKey->pPrevTo-
d820: 3e 70 4e 65 78 74 54 6f 20 3d 20 70 46 4b 65 79  >pNextTo = pFKey
d830: 2d 3e 70 4e 65 78 74 54 6f 3b 0a 20 20 20 20 20  ->pNextTo;.     
d840: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
d850: 76 6f 69 64 20 2a 70 20 3d 20 28 76 6f 69 64 20  void *p = (void 
d860: 2a 29 70 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f  *)pFKey->pNextTo
d870: 3b 0a 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20  ;.        const 
d880: 63 68 61 72 20 2a 7a 20 3d 20 28 70 20 3f 20 70  char *z = (p ? p
d890: 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f 2d 3e 7a  FKey->pNextTo->z
d8a0: 54 6f 20 3a 20 70 46 4b 65 79 2d 3e 7a 54 6f 29  To : pFKey->zTo)
d8b0: 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  ;.        sqlite
d8c0: 33 48 61 73 68 49 6e 73 65 72 74 28 26 70 54 61  3HashInsert(&pTa
d8d0: 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 6b 65 79  b->pSchema->fkey
d8e0: 48 61 73 68 2c 20 7a 2c 20 70 29 3b 0a 20 20 20  Hash, z, p);.   
d8f0: 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 70     }.      if( p
d900: 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f 20 29 7b  FKey->pNextTo ){
d910: 0a 20 20 20 20 20 20 20 20 70 46 4b 65 79 2d 3e  .        pFKey->
d920: 70 4e 65 78 74 54 6f 2d 3e 70 50 72 65 76 54 6f  pNextTo->pPrevTo
d930: 20 3d 20 70 46 4b 65 79 2d 3e 70 50 72 65 76 54   = pFKey->pPrevT
d940: 6f 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d  o;.      }.    }
d950: 0a 0a 20 20 20 20 2f 2a 20 45 56 3a 20 52 2d 33  ..    /* EV: R-3
d960: 30 33 32 33 2d 32 31 39 31 37 20 45 61 63 68 20  0323-21917 Each 
d970: 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73  foreign key cons
d980: 74 72 61 69 6e 74 20 69 6e 20 53 51 4c 69 74 65  traint in SQLite
d990: 20 69 73 0a 20 20 20 20 2a 2a 20 63 6c 61 73 73   is.    ** class
d9a0: 69 66 69 65 64 20 61 73 20 65 69 74 68 65 72 20  ified as either 
d9b0: 69 6d 6d 65 64 69 61 74 65 20 6f 72 20 64 65 66  immediate or def
d9c0: 65 72 72 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20  erred..    */.  
d9d0: 20 20 61 73 73 65 72 74 28 20 70 46 4b 65 79 2d    assert( pFKey-
d9e0: 3e 69 73 44 65 66 65 72 72 65 64 3d 3d 30 20 7c  >isDeferred==0 |
d9f0: 7c 20 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 72  | pFKey->isDefer
da00: 72 65 64 3d 3d 31 20 29 3b 0a 0a 20 20 20 20 2f  red==1 );..    /
da10: 2a 20 44 65 6c 65 74 65 20 61 6e 79 20 74 72 69  * Delete any tri
da20: 67 67 65 72 73 20 63 72 65 61 74 65 64 20 74 6f  ggers created to
da30: 20 69 6d 70 6c 65 6d 65 6e 74 20 61 63 74 69 6f   implement actio
da40: 6e 73 20 66 6f 72 20 74 68 69 73 20 46 4b 2e 20  ns for this FK. 
da50: 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  */.#ifndef SQLIT
da60: 45 5f 4f 4d 49 54 5f 54 52 49 47 47 45 52 0a 20  E_OMIT_TRIGGER. 
da70: 20 20 20 66 6b 54 72 69 67 67 65 72 44 65 6c 65     fkTriggerDele
da80: 74 65 28 64 62 2c 20 70 46 4b 65 79 2d 3e 61 70  te(db, pFKey->ap
da90: 54 72 69 67 67 65 72 5b 30 5d 29 3b 0a 20 20 20  Trigger[0]);.   
daa0: 20 66 6b 54 72 69 67 67 65 72 44 65 6c 65 74 65   fkTriggerDelete
dab0: 28 64 62 2c 20 70 46 4b 65 79 2d 3e 61 70 54 72  (db, pFKey->apTr
dac0: 69 67 67 65 72 5b 31 5d 29 3b 0a 23 65 6e 64 69  igger[1]);.#endi
dad0: 66 0a 0a 20 20 20 20 70 4e 65 78 74 20 3d 20 70  f..    pNext = p
dae0: 46 4b 65 79 2d 3e 70 4e 65 78 74 46 72 6f 6d 3b  FKey->pNextFrom;
daf0: 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72  .    sqlite3DbFr
db00: 65 65 28 64 62 2c 20 70 46 4b 65 79 29 3b 0a 20  ee(db, pFKey);. 
db10: 20 7d 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 69   }.}.#endif /* i
db20: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
db30: 54 5f 46 4f 52 45 49 47 4e 5f 4b 45 59 20 2a 2f  T_FOREIGN_KEY */
db40: 0a                                               .