/ Hex Artifact Content
Login

Artifact 8b438b1fda586519f8bb398538447fb2592bf668:


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 20 53 51 4c 49 54 45 5f 43 4f 4e 53  ted, SQLITE_CONS
02f0: 54 52 41 49 4e 54 0a 2a 2a 20 69 73 20 72 65 74  TRAINT.** is ret
0300: 75 72 6e 65 64 20 61 6e 64 20 74 68 65 20 63 75  urned and the cu
0310: 72 72 65 6e 74 20 73 74 61 74 65 6d 65 6e 74 20  rrent statement 
0320: 74 72 61 6e 73 61 63 74 69 6f 6e 20 72 6f 6c 6c  transaction roll
0330: 65 64 20 62 61 63 6b 2e 20 49 66 20 61 20 0a 2a  ed back. If a .*
0340: 2a 20 64 65 66 65 72 72 65 64 20 66 6f 72 65 69  * deferred forei
0350: 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e  gn key constrain
0360: 74 20 69 73 20 76 69 6f 6c 61 74 65 64 2c 20 6e  t is violated, n
0370: 6f 20 61 63 74 69 6f 6e 20 69 73 20 74 61 6b 65  o action is take
0380: 6e 20 0a 2a 2a 20 69 6d 6d 65 64 69 61 74 65 6c  n .** immediatel
0390: 79 2e 20 48 6f 77 65 76 65 72 20 69 66 20 74 68  y. However if th
03a0: 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 61 74  e application at
03b0: 74 65 6d 70 74 73 20 74 6f 20 63 6f 6d 6d 69 74  tempts to commit
03c0: 20 74 68 65 20 0a 2a 2a 20 74 72 61 6e 73 61 63   the .** transac
03d0: 74 69 6f 6e 20 62 65 66 6f 72 65 20 66 69 78 69  tion before fixi
03e0: 6e 67 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e  ng the constrain
03f0: 74 20 76 69 6f 6c 61 74 69 6f 6e 2c 20 74 68 65  t violation, the
0400: 20 61 74 74 65 6d 70 74 20 66 61 69 6c 73 2e 0a   attempt fails..
0410: 2a 2a 0a 2a 2a 20 44 65 66 65 72 72 65 64 20 63  **.** Deferred c
0420: 6f 6e 73 74 72 61 69 6e 74 73 20 61 72 65 20 69  onstraints are i
0430: 6d 70 6c 65 6d 65 6e 74 65 64 20 75 73 69 6e 67  mplemented using
0440: 20 61 20 73 69 6d 70 6c 65 20 63 6f 75 6e 74 65   a simple counte
0450: 72 20 61 73 73 6f 63 69 61 74 65 64 0a 2a 2a 20  r associated.** 
0460: 77 69 74 68 20 74 68 65 20 64 61 74 61 62 61 73  with the databas
0470: 65 20 68 61 6e 64 6c 65 2e 20 54 68 65 20 63 6f  e handle. The co
0480: 75 6e 74 65 72 20 69 73 20 73 65 74 20 74 6f 20  unter is set to 
0490: 7a 65 72 6f 20 65 61 63 68 20 74 69 6d 65 20 61  zero each time a
04a0: 20 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 74 72   .** database tr
04b0: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6f 70 65  ansaction is ope
04c0: 6e 65 64 2e 20 45 61 63 68 20 74 69 6d 65 20 61  ned. Each time a
04d0: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 65 78   statement is ex
04e0: 65 63 75 74 65 64 20 0a 2a 2a 20 74 68 61 74 20  ecuted .** that 
04f0: 63 61 75 73 65 73 20 61 20 66 6f 72 65 69 67 6e  causes a foreign
0500: 20 6b 65 79 20 76 69 6f 6c 61 74 69 6f 6e 2c 20   key violation, 
0510: 74 68 65 20 63 6f 75 6e 74 65 72 20 69 73 20 69  the counter is i
0520: 6e 63 72 65 6d 65 6e 74 65 64 2e 20 45 61 63 68  ncremented. Each
0530: 0a 2a 2a 20 74 69 6d 65 20 61 20 73 74 61 74 65  .** time a state
0540: 6d 65 6e 74 20 69 73 20 65 78 65 63 75 74 65 64  ment is executed
0550: 20 74 68 61 74 20 72 65 6d 6f 76 65 73 20 61 6e   that removes an
0560: 20 65 78 69 73 74 69 6e 67 20 76 69 6f 6c 61 74   existing violat
0570: 69 6f 6e 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 20  ion from.** the 
0580: 64 61 74 61 62 61 73 65 2c 20 74 68 65 20 63 6f  database, the co
0590: 75 6e 74 65 72 20 69 73 20 64 65 63 72 65 6d 65  unter is decreme
05a0: 6e 74 65 64 2e 20 57 68 65 6e 20 74 68 65 20 74  nted. When the t
05b0: 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 0a 2a 2a  ransaction is.**
05c0: 20 63 6f 6d 6d 69 74 74 65 64 2c 20 74 68 65 20   committed, the 
05d0: 63 6f 6d 6d 69 74 20 66 61 69 6c 73 20 69 66 20  commit fails if 
05e0: 74 68 65 20 63 75 72 72 65 6e 74 20 76 61 6c 75  the current valu
05f0: 65 20 6f 66 20 74 68 65 20 63 6f 75 6e 74 65 72  e of the counter
0600: 20 69 73 0a 2a 2a 20 67 72 65 61 74 65 72 20 74   is.** greater t
0610: 68 61 6e 20 7a 65 72 6f 2e 20 54 68 69 73 20 73  han zero. This s
0620: 63 68 65 6d 65 20 68 61 73 20 74 77 6f 20 62 69  cheme has two bi
0630: 67 20 64 72 61 77 62 61 63 6b 73 3a 0a 2a 2a 0a  g drawbacks:.**.
0640: 2a 2a 20 20 20 2a 20 57 68 65 6e 20 61 20 63 6f  **   * When a co
0650: 6d 6d 69 74 20 66 61 69 6c 73 20 64 75 65 20 74  mmit fails due t
0660: 6f 20 61 20 64 65 66 65 72 72 65 64 20 66 6f 72  o a deferred for
0670: 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61  eign key constra
0680: 69 6e 74 2c 20 0a 2a 2a 20 20 20 20 20 74 68 65  int, .**     the
0690: 72 65 20 69 73 20 6e 6f 20 77 61 79 20 74 6f 20  re is no way to 
06a0: 74 65 6c 6c 20 77 68 69 63 68 20 66 6f 72 65 69  tell which forei
06b0: 67 6e 20 63 6f 6e 73 74 72 61 69 6e 74 20 69 73  gn constraint is
06c0: 20 6e 6f 74 20 73 61 74 69 73 66 69 65 64 2c 0a   not satisfied,.
06d0: 2a 2a 20 20 20 20 20 6f 72 20 77 68 69 63 68 20  **     or which 
06e0: 72 6f 77 20 69 74 20 69 73 20 6e 6f 74 20 73 61  row it is not sa
06f0: 74 69 73 66 69 65 64 20 66 6f 72 2e 0a 2a 2a 0a  tisfied for..**.
0700: 2a 2a 20 20 20 2a 20 49 66 20 74 68 65 20 64 61  **   * If the da
0710: 74 61 62 61 73 65 20 63 6f 6e 74 61 69 6e 73 20  tabase contains 
0720: 66 6f 72 65 69 67 6e 20 6b 65 79 20 76 69 6f 6c  foreign key viol
0730: 61 74 69 6f 6e 73 20 77 68 65 6e 20 74 68 65 20  ations when the 
0740: 0a 2a 2a 20 20 20 20 20 74 72 61 6e 73 61 63 74  .**     transact
0750: 69 6f 6e 20 69 73 20 6f 70 65 6e 65 64 2c 20 74  ion is opened, t
0760: 68 69 73 20 6d 61 79 20 63 61 75 73 65 20 74 68  his may cause th
0770: 65 20 6d 65 63 68 61 6e 69 73 6d 20 74 6f 20 6d  e mechanism to m
0780: 61 6c 66 75 6e 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a  alfunction..**.*
0790: 2a 20 44 65 73 70 69 74 65 20 74 68 65 73 65 20  * Despite these 
07a0: 70 72 6f 62 6c 65 6d 73 2c 20 74 68 69 73 20 61  problems, this a
07b0: 70 70 72 6f 61 63 68 20 69 73 20 61 64 6f 70 74  pproach is adopt
07c0: 65 64 20 61 73 20 69 74 20 73 65 65 6d 73 20 73  ed as it seems s
07d0: 69 6d 70 6c 65 72 0a 2a 2a 20 74 68 61 6e 20 74  impler.** than t
07e0: 68 65 20 61 6c 74 65 72 6e 61 74 69 76 65 73 2e  he alternatives.
07f0: 0a 2a 2a 0a 2a 2a 20 49 4e 53 45 52 54 20 6f 70  .**.** INSERT op
0800: 65 72 61 74 69 6f 6e 73 3a 0a 2a 2a 0a 2a 2a 20  erations:.**.** 
0810: 20 20 49 2e 31 29 20 46 6f 72 20 65 61 63 68 20    I.1) For each 
0820: 46 4b 20 66 6f 72 20 77 68 69 63 68 20 74 68 65  FK for which the
0830: 20 74 61 62 6c 65 20 69 73 20 74 68 65 20 63 68   table is the ch
0840: 69 6c 64 20 74 61 62 6c 65 2c 20 73 65 61 72 63  ild table, searc
0850: 68 0a 2a 2a 20 20 20 20 20 20 20 20 74 68 65 20  h.**        the 
0860: 70 61 72 65 6e 74 20 74 61 62 6c 65 20 66 6f 72  parent table for
0870: 20 61 20 6d 61 74 63 68 2e 20 49 66 20 6e 6f 6e   a match. If non
0880: 65 20 69 73 20 66 6f 75 6e 64 20 69 6e 63 72 65  e is found incre
0890: 6d 65 6e 74 20 74 68 65 0a 2a 2a 20 20 20 20 20  ment the.**     
08a0: 20 20 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f     constraint co
08b0: 75 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 20 20 49  unter..**.**   I
08c0: 2e 32 29 20 46 6f 72 20 65 61 63 68 20 46 4b 20  .2) For each FK 
08d0: 66 6f 72 20 77 68 69 63 68 20 74 68 65 20 74 61  for which the ta
08e0: 62 6c 65 20 69 73 20 74 68 65 20 70 61 72 65 6e  ble is the paren
08f0: 74 20 74 61 62 6c 65 2c 20 0a 2a 2a 20 20 20 20  t table, .**    
0900: 20 20 20 20 73 65 61 72 63 68 20 74 68 65 20 63      search the c
0910: 68 69 6c 64 20 74 61 62 6c 65 20 66 6f 72 20 72  hild table for r
0920: 6f 77 73 20 74 68 61 74 20 63 6f 72 72 65 73 70  ows that corresp
0930: 6f 6e 64 20 74 6f 20 74 68 65 20 6e 65 77 0a 2a  ond to the new.*
0940: 2a 20 20 20 20 20 20 20 20 72 6f 77 20 69 6e 20  *        row in 
0950: 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65  the parent table
0960: 2e 20 44 65 63 72 65 6d 65 6e 74 20 74 68 65 20  . Decrement the 
0970: 63 6f 75 6e 74 65 72 20 66 6f 72 20 65 61 63 68  counter for each
0980: 20 72 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20 66   row.**        f
0990: 6f 75 6e 64 20 28 61 73 20 74 68 65 20 63 6f 6e  ound (as the con
09a0: 73 74 72 61 69 6e 74 20 69 73 20 6e 6f 77 20 73  straint is now s
09b0: 61 74 69 73 66 69 65 64 29 2e 0a 2a 2a 0a 2a 2a  atisfied)..**.**
09c0: 20 44 45 4c 45 54 45 20 6f 70 65 72 61 74 69 6f   DELETE operatio
09d0: 6e 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 44 2e 31 29  ns:.**.**   D.1)
09e0: 20 46 6f 72 20 65 61 63 68 20 46 4b 20 66 6f 72   For each FK for
09f0: 20 77 68 69 63 68 20 74 68 65 20 74 61 62 6c 65   which the table
0a00: 20 69 73 20 74 68 65 20 63 68 69 6c 64 20 74 61   is the child ta
0a10: 62 6c 65 2c 20 0a 2a 2a 20 20 20 20 20 20 20 20  ble, .**        
0a20: 73 65 61 72 63 68 20 74 68 65 20 70 61 72 65 6e  search the paren
0a30: 74 20 74 61 62 6c 65 20 66 6f 72 20 61 20 72 6f  t table for a ro
0a40: 77 20 74 68 61 74 20 63 6f 72 72 65 73 70 6f 6e  w that correspon
0a50: 64 73 20 74 6f 20 74 68 65 20 0a 2a 2a 20 20 20  ds to the .**   
0a60: 20 20 20 20 20 64 65 6c 65 74 65 64 20 72 6f 77       deleted row
0a70: 20 69 6e 20 74 68 65 20 63 68 69 6c 64 20 74 61   in the child ta
0a80: 62 6c 65 2e 20 49 66 20 73 75 63 68 20 61 20 72  ble. If such a r
0a90: 6f 77 20 69 73 20 6e 6f 74 20 66 6f 75 6e 64 2c  ow is not found,
0aa0: 20 0a 2a 2a 20 20 20 20 20 20 20 20 64 65 63 72   .**        decr
0ab0: 65 6d 65 6e 74 20 74 68 65 20 63 6f 75 6e 74 65  ement the counte
0ac0: 72 2e 0a 2a 2a 0a 2a 2a 20 20 20 44 2e 32 29 20  r..**.**   D.2) 
0ad0: 46 6f 72 20 65 61 63 68 20 46 4b 20 66 6f 72 20  For each FK for 
0ae0: 77 68 69 63 68 20 74 68 65 20 74 61 62 6c 65 20  which the table 
0af0: 69 73 20 74 68 65 20 70 61 72 65 6e 74 20 74 61  is the parent ta
0b00: 62 6c 65 2c 20 73 65 61 72 63 68 20 0a 2a 2a 20  ble, search .** 
0b10: 20 20 20 20 20 20 20 74 68 65 20 63 68 69 6c 64         the child
0b20: 20 74 61 62 6c 65 20 66 6f 72 20 72 6f 77 73 20   table for rows 
0b30: 74 68 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 20  that correspond 
0b40: 74 6f 20 74 68 65 20 64 65 6c 65 74 65 64 20 72  to the deleted r
0b50: 6f 77 20 0a 2a 2a 20 20 20 20 20 20 20 20 69 6e  ow .**        in
0b60: 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c   the parent tabl
0b70: 65 2e 20 46 6f 72 20 65 61 63 68 20 66 6f 75 6e  e. For each foun
0b80: 64 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 20  d increment the 
0b90: 63 6f 75 6e 74 65 72 2e 0a 2a 2a 0a 2a 2a 20 55  counter..**.** U
0ba0: 50 44 41 54 45 20 6f 70 65 72 61 74 69 6f 6e 73  PDATE operations
0bb0: 3a 0a 2a 2a 0a 2a 2a 20 20 20 41 6e 20 55 50 44  :.**.**   An UPD
0bc0: 41 54 45 20 63 6f 6d 6d 61 6e 64 20 72 65 71 75  ATE command requ
0bd0: 69 72 65 73 20 74 68 61 74 20 61 6c 6c 20 34 20  ires that all 4 
0be0: 73 74 65 70 73 20 61 62 6f 76 65 20 61 72 65 20  steps above are 
0bf0: 74 61 6b 65 6e 2c 20 62 75 74 20 6f 6e 6c 79 0a  taken, but only.
0c00: 2a 2a 20 20 20 66 6f 72 20 46 4b 20 63 6f 6e 73  **   for FK cons
0c10: 74 72 61 69 6e 74 73 20 66 6f 72 20 77 68 69 63  traints for whic
0c20: 68 20 74 68 65 20 61 66 66 65 63 74 65 64 20 63  h the affected c
0c30: 6f 6c 75 6d 6e 73 20 61 72 65 20 61 63 74 75 61  olumns are actua
0c40: 6c 6c 79 20 0a 2a 2a 20 20 20 6d 6f 64 69 66 69  lly .**   modifi
0c50: 65 64 20 28 76 61 6c 75 65 73 20 6d 75 73 74 20  ed (values must 
0c60: 62 65 20 63 6f 6d 70 61 72 65 64 20 61 74 20 72  be compared at r
0c70: 75 6e 74 69 6d 65 29 2e 0a 2a 2a 0a 2a 2a 20 4e  untime)..**.** N
0c80: 6f 74 65 20 74 68 61 74 20 49 2e 31 20 61 6e 64  ote that I.1 and
0c90: 20 44 2e 31 20 61 72 65 20 76 65 72 79 20 73 69   D.1 are very si
0ca0: 6d 69 6c 61 72 20 6f 70 65 72 61 74 69 6f 6e 73  milar operations
0cb0: 2c 20 61 73 20 61 72 65 20 49 2e 32 20 61 6e 64  , as are I.2 and
0cc0: 20 44 2e 32 2e 0a 2a 2a 20 54 68 69 73 20 73 69   D.2..** This si
0cd0: 6d 70 6c 69 66 69 65 73 20 74 68 65 20 69 6d 70  mplifies the imp
0ce0: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 61 20 62 69  lementation a bi
0cf0: 74 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 74 68 65  t..**.** For the
0d00: 20 70 75 72 70 6f 73 65 73 20 6f 66 20 69 6d 6d   purposes of imm
0d10: 65 64 69 61 74 65 20 46 4b 20 63 6f 6e 73 74 72  ediate FK constr
0d20: 61 69 6e 74 73 2c 20 74 68 65 20 4f 52 20 52 45  aints, the OR RE
0d30: 50 4c 41 43 45 20 63 6f 6e 66 6c 69 63 74 0a 2a  PLACE conflict.*
0d40: 2a 20 72 65 73 6f 6c 75 74 69 6f 6e 20 69 73 20  * resolution is 
0d50: 63 6f 6e 73 69 64 65 72 65 64 20 74 6f 20 64 65  considered to de
0d60: 6c 65 74 65 20 72 6f 77 73 20 62 65 66 6f 72 65  lete rows before
0d70: 20 74 68 65 20 6e 65 77 20 72 6f 77 20 69 73 20   the new row is 
0d80: 69 6e 73 65 72 74 65 64 2e 0a 2a 2a 20 49 66 20  inserted..** If 
0d90: 61 20 64 65 6c 65 74 65 20 63 61 75 73 65 64 20  a delete caused 
0da0: 62 79 20 4f 52 20 52 45 50 4c 41 43 45 20 76 69  by OR REPLACE vi
0db0: 6f 6c 61 74 65 73 20 61 6e 20 46 4b 20 63 6f 6e  olates an FK con
0dc0: 73 74 72 61 69 6e 74 2c 20 61 6e 20 65 78 63 65  straint, an exce
0dd0: 70 74 69 6f 6e 0a 2a 2a 20 69 73 20 74 68 72 6f  ption.** is thro
0de0: 77 6e 2c 20 65 76 65 6e 20 69 66 20 74 68 65 20  wn, even if the 
0df0: 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74 20 77 6f  FK constraint wo
0e00: 75 6c 64 20 62 65 20 73 61 74 69 73 66 69 65 64  uld be satisfied
0e10: 20 61 66 74 65 72 20 74 68 65 20 6e 65 77 20 0a   after the new .
0e20: 2a 2a 20 72 6f 77 20 69 73 20 69 6e 73 65 72 74  ** row is insert
0e30: 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 6d 6d 65 64 69  ed..**.** Immedi
0e40: 61 74 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20  ate constraints 
0e50: 61 72 65 20 75 73 75 61 6c 6c 79 20 68 61 6e 64  are usually hand
0e60: 6c 65 64 20 73 69 6d 69 6c 61 72 6c 79 2e 20 54  led similarly. T
0e70: 68 65 20 6f 6e 6c 79 20 64 69 66 66 65 72 65 6e  he only differen
0e80: 63 65 20 0a 2a 2a 20 69 73 20 74 68 61 74 20 74  ce .** is that t
0e90: 68 65 20 63 6f 75 6e 74 65 72 20 75 73 65 64 20  he counter used 
0ea0: 69 73 20 73 74 6f 72 65 64 20 61 73 20 70 61 72  is stored as par
0eb0: 74 20 6f 66 20 65 61 63 68 20 69 6e 64 69 76 69  t of each indivi
0ec0: 64 75 61 6c 20 73 74 61 74 65 6d 65 6e 74 0a 2a  dual statement.*
0ed0: 2a 20 6f 62 6a 65 63 74 20 28 73 74 72 75 63 74  * object (struct
0ee0: 20 56 64 62 65 29 2e 20 49 66 2c 20 61 66 74 65   Vdbe). If, afte
0ef0: 72 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20  r the statement 
0f00: 68 61 73 20 72 75 6e 2c 20 69 74 73 20 69 6d 6d  has run, its imm
0f10: 65 64 69 61 74 65 0a 2a 2a 20 63 6f 6e 73 74 72  ediate.** constr
0f20: 61 69 6e 74 20 63 6f 75 6e 74 65 72 20 69 73 20  aint counter is 
0f30: 67 72 65 61 74 65 72 20 74 68 61 6e 20 7a 65 72  greater than zer
0f40: 6f 2c 20 69 74 20 72 65 74 75 72 6e 73 20 53 51  o, it returns SQ
0f50: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 0a  LITE_CONSTRAINT.
0f60: 2a 2a 20 61 6e 64 20 74 68 65 20 73 74 61 74 65  ** and the state
0f70: 6d 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e  ment transaction
0f80: 20 69 73 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e   is rolled back.
0f90: 20 41 6e 20 65 78 63 65 70 74 69 6f 6e 20 69 73   An exception is
0fa0: 20 61 6e 20 49 4e 53 45 52 54 0a 2a 2a 20 73 74   an INSERT.** st
0fb0: 61 74 65 6d 65 6e 74 20 74 68 61 74 20 69 6e 73  atement that ins
0fc0: 65 72 74 73 20 61 20 73 69 6e 67 6c 65 20 72 6f  erts a single ro
0fd0: 77 20 6f 6e 6c 79 20 28 6e 6f 20 74 72 69 67 67  w only (no trigg
0fe0: 65 72 73 29 2e 20 49 6e 20 74 68 69 73 20 63 61  ers). In this ca
0ff0: 73 65 2c 0a 2a 2a 20 69 6e 73 74 65 61 64 20 6f  se,.** instead o
1000: 66 20 75 73 69 6e 67 20 61 20 63 6f 75 6e 74 65  f using a counte
1010: 72 2c 20 61 6e 20 65 78 63 65 70 74 69 6f 6e 20  r, an exception 
1020: 69 73 20 74 68 72 6f 77 6e 20 69 6d 6d 65 64 69  is thrown immedi
1030: 61 74 65 6c 79 20 69 66 20 74 68 65 0a 2a 2a 20  ately if the.** 
1040: 49 4e 53 45 52 54 20 76 69 6f 6c 61 74 65 73 20  INSERT violates 
1050: 61 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f  a foreign key co
1060: 6e 73 74 72 61 69 6e 74 2e 20 54 68 69 73 20 69  nstraint. This i
1070: 73 20 6e 65 63 65 73 73 61 72 79 20 61 73 20 73  s necessary as s
1080: 75 63 68 0a 2a 2a 20 61 6e 20 49 4e 53 45 52 54  uch.** an INSERT
1090: 20 64 6f 65 73 20 6e 6f 74 20 6f 70 65 6e 20 61   does not open a
10a0: 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73   statement trans
10b0: 61 63 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 54 4f  action..**.** TO
10c0: 44 4f 3a 20 48 6f 77 20 73 68 6f 75 6c 64 20 64  DO: How should d
10d0: 72 6f 70 70 69 6e 67 20 61 20 74 61 62 6c 65 20  ropping a table 
10e0: 62 65 20 68 61 6e 64 6c 65 64 3f 20 48 6f 77 20  be handled? How 
10f0: 73 68 6f 75 6c 64 20 72 65 6e 61 6d 69 6e 67 20  should renaming 
1100: 61 20 0a 2a 2a 20 74 61 62 6c 65 20 62 65 20 68  a .** table be h
1110: 61 6e 64 6c 65 64 3f 0a 2a 2a 0a 2a 2a 0a 2a 2a  andled?.**.**.**
1120: 20 51 75 65 72 79 20 41 50 49 20 4e 6f 74 65 73   Query API Notes
1130: 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  .** ------------
1140: 2d 2d 2d 0a 2a 2a 0a 2a 2a 20 42 65 66 6f 72 65  ---.**.** Before
1150: 20 63 6f 64 69 6e 67 20 61 6e 20 55 50 44 41 54   coding an UPDAT
1160: 45 20 6f 72 20 44 45 4c 45 54 45 20 72 6f 77 20  E or DELETE row 
1170: 6f 70 65 72 61 74 69 6f 6e 2c 20 74 68 65 20 63  operation, the c
1180: 6f 64 65 2d 67 65 6e 65 72 61 74 6f 72 0a 2a 2a  ode-generator.**
1190: 20 66 6f 72 20 74 68 6f 73 65 20 74 77 6f 20 6f   for those two o
11a0: 70 65 72 61 74 69 6f 6e 73 20 6e 65 65 64 73 20  perations needs 
11b0: 74 6f 20 6b 6e 6f 77 20 77 68 65 74 68 65 72 20  to know whether 
11c0: 6f 72 20 6e 6f 74 20 74 68 65 20 6f 70 65 72 61  or not the opera
11d0: 74 69 6f 6e 0a 2a 2a 20 72 65 71 75 69 72 65 73  tion.** requires
11e0: 20 61 6e 79 20 46 4b 20 70 72 6f 63 65 73 73 69   any FK processi
11f0: 6e 67 20 61 6e 64 2c 20 69 66 20 73 6f 2c 20 77  ng and, if so, w
1200: 68 69 63 68 20 63 6f 6c 75 6d 6e 73 20 6f 66 20  hich columns of 
1210: 74 68 65 20 6f 72 69 67 69 6e 61 6c 0a 2a 2a 20  the original.** 
1220: 72 6f 77 20 61 72 65 20 72 65 71 75 69 72 65 64  row are required
1230: 20 62 79 20 74 68 65 20 46 4b 20 70 72 6f 63 65   by the FK proce
1240: 73 73 69 6e 67 20 56 44 42 45 20 63 6f 64 65 20  ssing VDBE code 
1250: 28 69 2e 65 2e 20 69 66 20 46 4b 73 20 77 65 72  (i.e. if FKs wer
1260: 65 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 65 64  e.** implemented
1270: 20 75 73 69 6e 67 20 74 72 69 67 67 65 72 73 2c   using triggers,
1280: 20 77 68 69 63 68 20 6f 66 20 74 68 65 20 6f 6c   which of the ol
1290: 64 2e 2a 20 63 6f 6c 75 6d 6e 73 20 77 6f 75 6c  d.* columns woul
12a0: 64 20 62 65 20 0a 2a 2a 20 61 63 63 65 73 73 65  d be .** accesse
12b0: 64 29 2e 20 4e 6f 20 69 6e 66 6f 72 6d 61 74 69  d). No informati
12c0: 6f 6e 20 69 73 20 72 65 71 75 69 72 65 64 20 62  on is required b
12d0: 79 20 74 68 65 20 63 6f 64 65 2d 67 65 6e 65 72  y the code-gener
12e0: 61 74 6f 72 20 62 65 66 6f 72 65 0a 2a 2a 20 63  ator before.** c
12f0: 6f 64 69 6e 67 20 61 6e 20 49 4e 53 45 52 54 20  oding an INSERT 
1300: 6f 70 65 72 61 74 69 6f 6e 2e 20 54 68 65 20 66  operation. The f
1310: 75 6e 63 74 69 6f 6e 73 20 75 73 65 64 20 62 79  unctions used by
1320: 20 74 68 65 20 55 50 44 41 54 45 2f 44 45 4c 45   the UPDATE/DELE
1330: 54 45 0a 2a 2a 20 67 65 6e 65 72 61 74 69 6f 6e  TE.** generation
1340: 20 63 6f 64 65 20 74 6f 20 71 75 65 72 79 20 66   code to query f
1350: 6f 72 20 74 68 69 73 20 69 6e 66 6f 72 6d 61 74  or this informat
1360: 69 6f 6e 20 61 72 65 3a 0a 2a 2a 0a 2a 2a 20 20  ion are:.**.**  
1370: 20 73 71 6c 69 74 65 33 46 6b 52 65 71 75 69 72   sqlite3FkRequir
1380: 65 64 28 29 20 2d 20 54 65 73 74 20 74 6f 20 73  ed() - Test to s
1390: 65 65 20 69 66 20 46 4b 20 70 72 6f 63 65 73 73  ee if FK process
13a0: 69 6e 67 20 69 73 20 72 65 71 75 69 72 65 64 2e  ing is required.
13b0: 0a 2a 2a 20 20 20 73 71 6c 69 74 65 33 46 6b 4f  .**   sqlite3FkO
13c0: 6c 64 6d 61 73 6b 28 29 20 20 2d 20 51 75 65 72  ldmask()  - Quer
13d0: 79 20 66 6f 72 20 74 68 65 20 73 65 74 20 6f 66  y for the set of
13e0: 20 72 65 71 75 69 72 65 64 20 6f 6c 64 2e 2a 20   required old.* 
13f0: 63 6f 6c 75 6d 6e 73 2e 0a 2a 2a 0a 2a 2a 0a 2a  columns..**.**.*
1400: 2a 20 45 78 74 65 72 6e 61 6c 6c 79 20 61 63 63  * Externally acc
1410: 65 73 73 69 62 6c 65 20 6d 6f 64 75 6c 65 20 66  essible module f
1420: 75 6e 63 74 69 6f 6e 73 0a 2a 2a 20 2d 2d 2d 2d  unctions.** ----
1430: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1440: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
1450: 2d 2d 0a 2a 2a 0a 2a 2a 20 20 20 73 71 6c 69 74  --.**.**   sqlit
1460: 65 33 46 6b 43 68 65 63 6b 28 29 20 20 20 20 2d  e3FkCheck()    -
1470: 20 43 68 65 63 6b 20 66 6f 72 20 66 6f 72 65 69   Check for forei
1480: 67 6e 20 6b 65 79 20 76 69 6f 6c 61 74 69 6f 6e  gn key violation
1490: 73 2e 0a 2a 2a 20 20 20 73 71 6c 69 74 65 33 46  s..**   sqlite3F
14a0: 6b 41 63 74 69 6f 6e 73 28 29 20 20 2d 20 43 6f  kActions()  - Co
14b0: 64 65 20 74 72 69 67 67 65 72 73 20 66 6f 72 20  de triggers for 
14c0: 4f 4e 20 55 50 44 41 54 45 2f 4f 4e 20 44 45 4c  ON UPDATE/ON DEL
14d0: 45 54 45 20 61 63 74 69 6f 6e 73 2e 0a 2a 2a 20  ETE actions..** 
14e0: 20 20 73 71 6c 69 74 65 33 46 6b 44 65 6c 65 74    sqlite3FkDelet
14f0: 65 28 29 20 20 20 2d 20 44 65 6c 65 74 65 20 61  e()   - Delete a
1500: 6e 20 46 4b 65 79 20 73 74 72 75 63 74 75 72 65  n FKey structure
1510: 2e 0a 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 56 44 42 45  ..*/../*.** VDBE
1520: 20 43 61 6c 6c 69 6e 67 20 43 6f 6e 76 65 6e 74   Calling Convent
1530: 69 6f 6e 0a 2a 2a 20 2d 2d 2d 2d 2d 2d 2d 2d 2d  ion.** ---------
1540: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a  --------------.*
1550: 2a 0a 2a 2a 20 45 78 61 6d 70 6c 65 3a 0a 2a 2a  *.** Example:.**
1560: 0a 2a 2a 20 20 20 46 6f 72 20 74 68 65 20 66 6f  .**   For the fo
1570: 6c 6c 6f 77 69 6e 67 20 49 4e 53 45 52 54 20 73  llowing INSERT s
1580: 74 61 74 65 6d 65 6e 74 3a 0a 2a 2a 0a 2a 2a 20  tatement:.**.** 
1590: 20 20 20 20 43 52 45 41 54 45 20 54 41 42 4c 45      CREATE TABLE
15a0: 20 74 31 28 61 2c 20 62 20 49 4e 54 45 47 45 52   t1(a, b INTEGER
15b0: 20 50 52 49 4d 41 52 59 20 4b 45 59 2c 20 63 29   PRIMARY KEY, c)
15c0: 3b 0a 2a 2a 20 20 20 20 20 49 4e 53 45 52 54 20  ;.**     INSERT 
15d0: 49 4e 54 4f 20 74 31 20 56 41 4c 55 45 53 28 31  INTO t1 VALUES(1
15e0: 2c 20 32 2c 20 33 2e 31 29 3b 0a 2a 2a 0a 2a 2a  , 2, 3.1);.**.**
15f0: 20 20 20 52 65 67 69 73 74 65 72 20 28 78 29 3a     Register (x):
1600: 20 20 20 20 20 20 20 20 32 20 20 20 20 28 74 79          2    (ty
1610: 70 65 20 69 6e 74 65 67 65 72 29 0a 2a 2a 20 20  pe integer).**  
1620: 20 52 65 67 69 73 74 65 72 20 28 78 2b 31 29 3a   Register (x+1):
1630: 20 20 20 20 20 20 31 20 20 20 20 28 74 79 70 65        1    (type
1640: 20 69 6e 74 65 67 65 72 29 0a 2a 2a 20 20 20 52   integer).**   R
1650: 65 67 69 73 74 65 72 20 28 78 2b 32 29 3a 20 20  egister (x+2):  
1660: 20 20 20 20 4e 55 4c 4c 20 28 74 79 70 65 20 4e      NULL (type N
1670: 55 4c 4c 29 0a 2a 2a 20 20 20 52 65 67 69 73 74  ULL).**   Regist
1680: 65 72 20 28 78 2b 33 29 3a 20 20 20 20 20 20 33  er (x+3):      3
1690: 2e 31 20 20 28 74 79 70 65 20 72 65 61 6c 29 0a  .1  (type real).
16a0: 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 20 66 6f 72 65  */../*.** A fore
16b0: 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69  ign key constrai
16c0: 6e 74 20 72 65 71 75 69 72 65 73 20 74 68 61 74  nt requires that
16d0: 20 74 68 65 20 6b 65 79 20 63 6f 6c 75 6d 6e 73   the key columns
16e0: 20 69 6e 20 74 68 65 20 70 61 72 65 6e 74 0a 2a   in the parent.*
16f0: 2a 20 74 61 62 6c 65 20 61 72 65 20 63 6f 6c 6c  * table are coll
1700: 65 63 74 69 76 65 6c 79 20 73 75 62 6a 65 63 74  ectively subject
1710: 20 74 6f 20 61 20 55 4e 49 51 55 45 20 6f 72 20   to a UNIQUE or 
1720: 50 52 49 4d 41 52 59 20 4b 45 59 20 63 6f 6e 73  PRIMARY KEY cons
1730: 74 72 61 69 6e 74 2e 0a 2a 2a 20 47 69 76 65 6e  traint..** Given
1740: 20 74 68 61 74 20 70 50 61 72 65 6e 74 20 69 73   that pParent is
1750: 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c   the parent tabl
1760: 65 20 66 6f 72 20 66 6f 72 65 69 67 6e 20 6b 65  e for foreign ke
1770: 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 70 46 4b  y constraint pFK
1780: 65 79 2c 20 0a 2a 2a 20 73 65 61 72 63 68 20 74  ey, .** search t
1790: 68 65 20 73 63 68 65 6d 61 20 61 20 75 6e 69 71  he schema a uniq
17a0: 75 65 20 69 6e 64 65 78 20 6f 6e 20 74 68 65 20  ue index on the 
17b0: 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d  parent key colum
17c0: 6e 73 2e 20 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75  ns. .**.** If su
17d0: 63 63 65 73 73 66 75 6c 2c 20 7a 65 72 6f 20 69  ccessful, zero i
17e0: 73 20 72 65 74 75 72 6e 65 64 2e 20 49 66 20 74  s returned. If t
17f0: 68 65 20 70 61 72 65 6e 74 20 6b 65 79 20 69 73  he parent key is
1800: 20 61 6e 20 49 4e 54 45 47 45 52 20 50 52 49 4d   an INTEGER PRIM
1810: 41 52 59 20 0a 2a 2a 20 4b 45 59 20 63 6f 6c 75  ARY .** KEY colu
1820: 6d 6e 2c 20 74 68 65 6e 20 6f 75 74 70 75 74 20  mn, then output 
1830: 76 61 72 69 61 62 6c 65 20 2a 70 70 49 64 78 20  variable *ppIdx 
1840: 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c 2e 20  is set to NULL. 
1850: 4f 74 68 65 72 77 69 73 65 2c 20 2a 70 70 49 64  Otherwise, *ppId
1860: 78 20 0a 2a 2a 20 69 73 20 73 65 74 20 74 6f 20  x .** is set to 
1870: 70 6f 69 6e 74 20 74 6f 20 74 68 65 20 75 6e 69  point to the uni
1880: 71 75 65 20 69 6e 64 65 78 2e 20 0a 2a 2a 20 0a  que index. .** .
1890: 2a 2a 20 49 66 20 74 68 65 20 70 61 72 65 6e 74  ** If the parent
18a0: 20 6b 65 79 20 63 6f 6e 73 69 73 74 73 20 6f 66   key consists of
18b0: 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e   a single column
18c0: 20 28 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65   (the foreign ke
18d0: 79 20 63 6f 6e 73 74 72 61 69 6e 74 0a 2a 2a 20  y constraint.** 
18e0: 69 73 20 6e 6f 74 20 61 20 63 6f 6d 70 6f 73 69  is not a composi
18f0: 74 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 29 2c  te foreign key),
1900: 20 6f 75 74 70 75 74 20 76 61 72 69 61 62 6c 65   output variable
1910: 20 2a 70 61 69 43 6f 6c 20 69 73 20 73 65 74 20   *paiCol is set 
1920: 74 6f 20 4e 55 4c 4c 2e 0a 2a 2a 20 4f 74 68 65  to NULL..** Othe
1930: 72 77 69 73 65 2c 20 69 74 20 69 73 20 73 65 74  rwise, it is set
1940: 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 61 6e 20   to point to an 
1950: 61 6c 6c 6f 63 61 74 65 64 20 61 72 72 61 79 20  allocated array 
1960: 6f 66 20 73 69 7a 65 20 4e 2c 20 77 68 65 72 65  of size N, where
1970: 0a 2a 2a 20 4e 20 69 73 20 74 68 65 20 6e 75 6d  .** N is the num
1980: 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69  ber of columns i
1990: 6e 20 74 68 65 20 70 61 72 65 6e 74 20 6b 65 79  n the parent key
19a0: 2e 20 54 68 65 20 66 69 72 73 74 20 65 6c 65 6d  . The first elem
19b0: 65 6e 74 20 6f 66 20 74 68 65 0a 2a 2a 20 61 72  ent of the.** ar
19c0: 72 61 79 20 69 73 20 74 68 65 20 69 6e 64 65 78  ray is the index
19d0: 20 6f 66 20 74 68 65 20 63 68 69 6c 64 20 74 61   of the child ta
19e0: 62 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20  ble column that 
19f0: 69 73 20 6d 61 70 70 65 64 20 62 79 20 74 68 65  is mapped by the
1a00: 20 46 4b 0a 2a 2a 20 63 6f 6e 73 74 72 61 69 6e   FK.** constrain
1a10: 74 20 74 6f 20 74 68 65 20 70 61 72 65 6e 74 20  t to the parent 
1a20: 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 73 74 6f  table column sto
1a30: 72 65 64 20 69 6e 20 74 68 65 20 6c 65 66 74 2d  red in the left-
1a40: 6d 6f 73 74 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f  most column.** o
1a50: 66 20 69 6e 64 65 78 20 2a 70 70 49 64 78 2e 20  f index *ppIdx. 
1a60: 54 68 65 20 73 65 63 6f 6e 64 20 65 6c 65 6d 65  The second eleme
1a70: 6e 74 20 6f 66 20 74 68 65 20 61 72 72 61 79 20  nt of the array 
1a80: 69 73 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20  is the index of 
1a90: 74 68 65 0a 2a 2a 20 63 68 69 6c 64 20 74 61 62  the.** child tab
1aa0: 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20 63  le column that c
1ab0: 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68  orresponds to th
1ac0: 65 20 73 65 63 6f 6e 64 20 6c 65 66 74 2d 6d 6f  e second left-mo
1ad0: 73 74 20 63 6f 6c 75 6d 6e 20 6f 66 0a 2a 2a 20  st column of.** 
1ae0: 2a 70 70 49 64 78 2c 20 61 6e 64 20 73 6f 20 6f  *ppIdx, and so o
1af0: 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20  n..**.** If the 
1b00: 72 65 71 75 69 72 65 64 20 69 6e 64 65 78 20 63  required index c
1b10: 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 2c 20  annot be found, 
1b20: 65 69 74 68 65 72 20 62 65 63 61 75 73 65 3a 0a  either because:.
1b30: 2a 2a 0a 2a 2a 20 20 20 31 29 20 54 68 65 20 6e  **.**   1) The n
1b40: 61 6d 65 64 20 70 61 72 65 6e 74 20 6b 65 79 20  amed parent key 
1b50: 63 6f 6c 75 6d 6e 73 20 64 6f 20 6e 6f 74 20 65  columns do not e
1b60: 78 69 73 74 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20  xist, or.**.**  
1b70: 20 32 29 20 54 68 65 20 6e 61 6d 65 64 20 70 61   2) The named pa
1b80: 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 73  rent key columns
1b90: 20 64 6f 20 65 78 69 73 74 2c 20 62 75 74 20 61   do exist, but a
1ba0: 72 65 20 6e 6f 74 20 73 75 62 6a 65 63 74 20 74  re not subject t
1bb0: 6f 20 61 0a 2a 2a 20 20 20 20 20 20 55 4e 49 51  o a.**      UNIQ
1bc0: 55 45 20 6f 72 20 50 52 49 4d 41 52 59 20 4b 45  UE or PRIMARY KE
1bd0: 59 20 63 6f 6e 73 74 72 61 69 6e 74 2c 20 6f 72  Y constraint, or
1be0: 0a 2a 2a 0a 2a 2a 20 20 20 33 29 20 4e 6f 20 70  .**.**   3) No p
1bf0: 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e  arent key column
1c00: 73 20 77 65 72 65 20 70 72 6f 76 69 64 65 64 20  s were provided 
1c10: 65 78 70 6c 69 63 69 74 6c 79 20 61 73 20 70 61  explicitly as pa
1c20: 72 74 20 6f 66 20 74 68 65 0a 2a 2a 20 20 20 20  rt of the.**    
1c30: 20 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 64 65    foreign key de
1c40: 66 69 6e 69 74 69 6f 6e 2c 20 61 6e 64 20 74 68  finition, and th
1c50: 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 64  e parent table d
1c60: 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 61 0a 2a  oes not have a.*
1c70: 2a 20 20 20 20 20 20 50 52 49 4d 41 52 59 20 4b  *      PRIMARY K
1c80: 45 59 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 34  EY, or.**.**   4
1c90: 29 20 4e 6f 20 70 61 72 65 6e 74 20 6b 65 79 20  ) No parent key 
1ca0: 63 6f 6c 75 6d 6e 73 20 77 65 72 65 20 70 72 6f  columns were pro
1cb0: 76 69 64 65 64 20 65 78 70 6c 69 63 69 74 6c 79  vided explicitly
1cc0: 20 61 73 20 70 61 72 74 20 6f 66 20 74 68 65 0a   as part of the.
1cd0: 2a 2a 20 20 20 20 20 20 66 6f 72 65 69 67 6e 20  **      foreign 
1ce0: 6b 65 79 20 64 65 66 69 6e 69 74 69 6f 6e 2c 20  key definition, 
1cf0: 61 6e 64 20 74 68 65 20 50 52 49 4d 41 52 59 20  and the PRIMARY 
1d00: 4b 45 59 20 6f 66 20 74 68 65 20 70 61 72 65 6e  KEY of the paren
1d10: 74 20 74 61 62 6c 65 20 0a 2a 2a 20 20 20 20 20  t table .**     
1d20: 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 61 20 61   consists of a a
1d30: 20 64 69 66 66 65 72 65 6e 74 20 6e 75 6d 62 65   different numbe
1d40: 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 74 6f 20  r of columns to 
1d50: 74 68 65 20 63 68 69 6c 64 20 6b 65 79 20 69 6e  the child key in
1d60: 20 0a 2a 2a 20 20 20 20 20 20 74 68 65 20 63 68   .**      the ch
1d70: 69 6c 64 20 74 61 62 6c 65 2e 0a 2a 2a 0a 2a 2a  ild table..**.**
1d80: 20 74 68 65 6e 20 6e 6f 6e 2d 7a 65 72 6f 20 69   then non-zero i
1d90: 73 20 72 65 74 75 72 6e 65 64 2c 20 61 6e 64 20  s returned, and 
1da0: 61 20 22 66 6f 72 65 69 67 6e 20 6b 65 79 20 6d  a "foreign key m
1db0: 69 73 6d 61 74 63 68 22 20 65 72 72 6f 72 20 6c  ismatch" error l
1dc0: 6f 61 64 65 64 0a 2a 2a 20 69 6e 74 6f 20 70 50  oaded.** into pP
1dd0: 61 72 73 65 2e 20 49 66 20 61 6e 20 4f 4f 4d 20  arse. If an OOM 
1de0: 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 6e 6f  error occurs, no
1df0: 6e 2d 7a 65 72 6f 20 69 73 20 72 65 74 75 72 6e  n-zero is return
1e00: 65 64 20 61 6e 64 20 74 68 65 0a 2a 2a 20 70 50  ed and the.** pP
1e10: 61 72 73 65 2d 3e 64 62 2d 3e 6d 61 6c 6c 6f 63  arse->db->malloc
1e20: 46 61 69 6c 65 64 20 66 6c 61 67 20 69 73 20 73  Failed flag is s
1e30: 65 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  et..*/.static in
1e40: 74 20 6c 6f 63 61 74 65 46 6b 65 79 49 6e 64 65  t locateFkeyInde
1e50: 78 28 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72  x(.  Parse *pPar
1e60: 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  se,             
1e70: 20 20 20 20 20 2f 2a 20 50 61 72 73 65 20 63 6f       /* Parse co
1e80: 6e 74 65 78 74 20 74 6f 20 73 74 6f 72 65 20 61  ntext to store a
1e90: 6e 79 20 65 72 72 6f 72 20 69 6e 20 2a 2f 0a 20  ny error in */. 
1ea0: 20 54 61 62 6c 65 20 2a 70 50 61 72 65 6e 74 2c   Table *pParent,
1eb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ec0: 20 2f 2a 20 50 61 72 65 6e 74 20 74 61 62 6c 65   /* Parent table
1ed0: 20 6f 66 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e   of FK constrain
1ee0: 74 20 70 46 4b 65 79 20 2a 2f 0a 20 20 46 4b 65  t pFKey */.  FKe
1ef0: 79 20 2a 70 46 4b 65 79 2c 20 20 20 20 20 20 20  y *pFKey,       
1f00: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1f10: 46 6f 72 65 69 67 6e 20 6b 65 79 20 74 6f 20 66  Foreign key to f
1f20: 69 6e 64 20 69 6e 64 65 78 20 66 6f 72 20 2a 2f  ind index for */
1f30: 0a 20 20 49 6e 64 65 78 20 2a 2a 70 70 49 64 78  .  Index **ppIdx
1f40: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
1f50: 20 20 20 2f 2a 20 4f 55 54 3a 20 55 6e 69 71 75     /* OUT: Uniqu
1f60: 65 20 69 6e 64 65 78 20 6f 6e 20 70 61 72 65 6e  e index on paren
1f70: 74 20 74 61 62 6c 65 20 2a 2f 0a 20 20 69 6e 74  t table */.  int
1f80: 20 2a 2a 70 61 69 43 6f 6c 20 20 20 20 20 20 20   **paiCol       
1f90: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1fa0: 4f 55 54 3a 20 4d 61 70 20 6f 66 20 69 6e 64 65  OUT: Map of inde
1fb0: 78 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 70 46 4b  x columns in pFK
1fc0: 65 79 20 2a 2f 0a 29 7b 0a 20 20 49 6e 64 65 78  ey */.){.  Index
1fd0: 20 2a 70 49 64 78 20 3d 20 30 3b 20 20 20 20 20   *pIdx = 0;     
1fe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1ff0: 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 74 75 72  * Value to retur
2000: 6e 20 76 69 61 20 2a 70 70 49 64 78 20 2a 2f 0a  n via *ppIdx */.
2010: 20 20 69 6e 74 20 2a 61 69 43 6f 6c 20 3d 20 30    int *aiCol = 0
2020: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
2030: 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 74        /* Value t
2040: 6f 20 72 65 74 75 72 6e 20 76 69 61 20 2a 70 61  o return via *pa
2050: 69 43 6f 6c 20 2a 2f 0a 20 20 69 6e 74 20 6e 43  iCol */.  int nC
2060: 6f 6c 20 3d 20 70 46 4b 65 79 2d 3e 6e 43 6f 6c  ol = pFKey->nCol
2070: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  ;             /*
2080: 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d   Number of colum
2090: 6e 73 20 69 6e 20 70 61 72 65 6e 74 20 6b 65 79  ns in parent key
20a0: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 4b 65 79   */.  char *zKey
20b0: 20 3d 20 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 30   = pFKey->aCol[0
20c0: 5d 2e 7a 43 6f 6c 3b 20 20 20 2f 2a 20 4e 61 6d  ].zCol;   /* Nam
20d0: 65 20 6f 66 20 6c 65 66 74 2d 6d 6f 73 74 20 70  e of left-most p
20e0: 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e  arent key column
20f0: 20 2a 2f 0a 0a 20 20 2f 2a 20 54 68 65 20 63 61   */..  /* The ca
2100: 6c 6c 65 72 20 69 73 20 72 65 73 70 6f 6e 73 69  ller is responsi
2110: 62 6c 65 20 66 6f 72 20 7a 65 72 6f 69 6e 67 20  ble for zeroing 
2120: 6f 75 74 70 75 74 20 70 61 72 61 6d 65 74 65 72  output parameter
2130: 73 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  s. */.  assert( 
2140: 70 70 49 64 78 20 26 26 20 2a 70 70 49 64 78 3d  ppIdx && *ppIdx=
2150: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  =0 );.  assert( 
2160: 21 70 61 69 43 6f 6c 20 7c 7c 20 2a 70 61 69 43  !paiCol || *paiC
2170: 6f 6c 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72  ol==0 );.  asser
2180: 74 28 20 70 50 61 72 73 65 20 29 3b 0a 0a 20 20  t( pParse );..  
2190: 2f 2a 20 49 66 20 74 68 69 73 20 69 73 20 61 20  /* If this is a 
21a0: 6e 6f 6e 2d 63 6f 6d 70 6f 73 69 74 65 20 28 73  non-composite (s
21b0: 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 29 20 66 6f  ingle column) fo
21c0: 72 65 69 67 6e 20 6b 65 79 2c 20 63 68 65 63 6b  reign key, check
21d0: 20 69 66 20 69 74 20 0a 20 20 2a 2a 20 6d 61 70   if it .  ** map
21e0: 73 20 74 6f 20 74 68 65 20 49 4e 54 45 47 45 52  s to the INTEGER
21f0: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 66 20   PRIMARY KEY of 
2200: 74 61 62 6c 65 20 70 50 61 72 65 6e 74 2e 20 49  table pParent. I
2210: 66 20 73 6f 2c 20 6c 65 61 76 65 20 2a 70 70 49  f so, leave *ppI
2220: 64 78 20 0a 20 20 2a 2a 20 61 6e 64 20 2a 70 61  dx .  ** and *pa
2230: 69 43 6f 6c 20 73 65 74 20 74 6f 20 7a 65 72 6f  iCol set to zero
2240: 20 61 6e 64 20 72 65 74 75 72 6e 20 65 61 72 6c   and return earl
2250: 79 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4f 74  y. .  **.  ** Ot
2260: 68 65 72 77 69 73 65 2c 20 66 6f 72 20 61 20 63  herwise, for a c
2270: 6f 6d 70 6f 73 69 74 65 20 66 6f 72 65 69 67 6e  omposite foreign
2280: 20 6b 65 79 20 28 6d 6f 72 65 20 74 68 61 6e 20   key (more than 
2290: 6f 6e 65 20 63 6f 6c 75 6d 6e 29 2c 20 61 6c 6c  one column), all
22a0: 6f 63 61 74 65 0a 20 20 2a 2a 20 73 70 61 63 65  ocate.  ** space
22b0: 20 66 6f 72 20 74 68 65 20 61 69 43 6f 6c 20 61   for the aiCol a
22c0: 72 72 61 79 20 28 72 65 74 75 72 6e 65 64 20 76  rray (returned v
22d0: 69 61 20 6f 75 74 70 75 74 20 70 61 72 61 6d 65  ia output parame
22e0: 74 65 72 20 2a 70 61 69 43 6f 6c 29 2e 0a 20 20  ter *paiCol)..  
22f0: 2a 2a 20 4e 6f 6e 2d 63 6f 6d 70 6f 73 69 74 65  ** Non-composite
2300: 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 20 64 6f   foreign keys do
2310: 20 6e 6f 74 20 72 65 71 75 69 72 65 20 74 68 65   not require the
2320: 20 61 69 43 6f 6c 20 61 72 72 61 79 2e 0a 20 20   aiCol array..  
2330: 2a 2f 0a 20 20 69 66 28 20 6e 43 6f 6c 3d 3d 31  */.  if( nCol==1
2340: 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 20 46   ){.    /* The F
2350: 4b 20 6d 61 70 73 20 74 6f 20 74 68 65 20 49 50  K maps to the IP
2360: 4b 20 69 66 20 61 6e 79 20 6f 66 20 74 68 65 20  K if any of the 
2370: 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 74 72  following are tr
2380: 75 65 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 20 2a  ue:.    **.    *
2390: 2a 20 20 20 31 29 20 54 68 65 72 65 20 69 73 20  *   1) There is 
23a0: 61 6e 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41  an INTEGER PRIMA
23b0: 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e 20 61 6e  RY KEY column an
23c0: 64 20 74 68 65 20 46 4b 20 69 73 20 69 6d 70 6c  d the FK is impl
23d0: 69 63 69 74 6c 79 20 0a 20 20 20 20 2a 2a 20 20  icitly .    **  
23e0: 20 20 20 20 6d 61 70 70 65 64 20 74 6f 20 74 68      mapped to th
23f0: 65 20 70 72 69 6d 61 72 79 20 6b 65 79 20 6f 66  e primary key of
2400: 20 74 61 62 6c 65 20 70 50 61 72 65 6e 74 2c 20   table pParent, 
2410: 6f 72 0a 20 20 20 20 2a 2a 20 20 20 32 29 20 54  or.    **   2) T
2420: 68 65 20 46 4b 20 69 73 20 65 78 70 6c 69 63 69  he FK is explici
2430: 74 6c 79 20 6d 61 70 70 65 64 20 74 6f 20 61 20  tly mapped to a 
2440: 63 6f 6c 75 6d 6e 20 64 65 63 6c 61 72 65 64 20  column declared 
2450: 61 73 20 49 4e 54 45 47 45 52 0a 20 20 20 20 2a  as INTEGER.    *
2460: 2a 20 20 20 20 20 20 50 52 49 4d 41 52 59 20 4b  *      PRIMARY K
2470: 45 59 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69  EY..    */.    i
2480: 66 28 20 70 50 61 72 65 6e 74 2d 3e 69 50 4b 65  f( pParent->iPKe
2490: 79 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 66  y>=0 ){.      if
24a0: 28 20 21 7a 4b 65 79 20 29 20 72 65 74 75 72 6e  ( !zKey ) return
24b0: 20 30 3b 0a 20 20 20 20 20 20 69 66 28 20 21 73   0;.      if( !s
24c0: 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28 70 50  qlite3StrICmp(pP
24d0: 61 72 65 6e 74 2d 3e 61 43 6f 6c 5b 70 50 61 72  arent->aCol[pPar
24e0: 65 6e 74 2d 3e 69 50 4b 65 79 5d 2e 7a 4e 61 6d  ent->iPKey].zNam
24f0: 65 2c 20 7a 4b 65 79 29 20 29 20 72 65 74 75 72  e, zKey) ) retur
2500: 6e 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c  n 0;.    }.  }el
2510: 73 65 20 69 66 28 20 70 61 69 43 6f 6c 20 29 7b  se if( paiCol ){
2520: 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e 43 6f  .    assert( nCo
2530: 6c 3e 31 20 29 3b 0a 20 20 20 20 61 69 43 6f 6c  l>1 );.    aiCol
2540: 20 3d 20 28 69 6e 74 20 2a 29 73 71 6c 69 74 65   = (int *)sqlite
2550: 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 70 50 61  3DbMallocRaw(pPa
2560: 72 73 65 2d 3e 64 62 2c 20 6e 43 6f 6c 2a 73 69  rse->db, nCol*si
2570: 7a 65 6f 66 28 69 6e 74 29 29 3b 0a 20 20 20 20  zeof(int));.    
2580: 69 66 28 20 21 61 69 43 6f 6c 20 29 20 72 65 74  if( !aiCol ) ret
2590: 75 72 6e 20 31 3b 0a 20 20 20 20 2a 70 61 69 43  urn 1;.    *paiC
25a0: 6f 6c 20 3d 20 61 69 43 6f 6c 3b 0a 20 20 7d 0a  ol = aiCol;.  }.
25b0: 0a 20 20 66 6f 72 28 70 49 64 78 3d 70 50 61 72  .  for(pIdx=pPar
25c0: 65 6e 74 2d 3e 70 49 6e 64 65 78 3b 20 70 49 64  ent->pIndex; pId
25d0: 78 3b 20 70 49 64 78 3d 70 49 64 78 2d 3e 70 4e  x; pIdx=pIdx->pN
25e0: 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 70 49  ext){.    if( pI
25f0: 64 78 2d 3e 6e 43 6f 6c 75 6d 6e 3d 3d 6e 43 6f  dx->nColumn==nCo
2600: 6c 20 26 26 20 70 49 64 78 2d 3e 6f 6e 45 72 72  l && pIdx->onErr
2610: 6f 72 21 3d 4f 45 5f 4e 6f 6e 65 20 29 7b 20 0a  or!=OE_None ){ .
2620: 20 20 20 20 20 20 2f 2a 20 70 49 64 78 20 69 73        /* pIdx is
2630: 20 61 20 55 4e 49 51 55 45 20 69 6e 64 65 78 20   a UNIQUE index 
2640: 28 6f 72 20 61 20 50 52 49 4d 41 52 59 20 4b 45  (or a PRIMARY KE
2650: 59 29 20 61 6e 64 20 68 61 73 20 74 68 65 20 72  Y) and has the r
2660: 69 67 68 74 20 6e 75 6d 62 65 72 0a 20 20 20 20  ight number.    
2670: 20 20 2a 2a 20 6f 66 20 63 6f 6c 75 6d 6e 73 2e    ** of columns.
2680: 20 49 66 20 65 61 63 68 20 69 6e 64 65 78 65 64   If each indexed
2690: 20 63 6f 6c 75 6d 6e 20 63 6f 72 72 65 73 70 6f   column correspo
26a0: 6e 64 73 20 74 6f 20 61 20 66 6f 72 65 69 67 6e  nds to a foreign
26b0: 20 6b 65 79 0a 20 20 20 20 20 20 2a 2a 20 63 6f   key.      ** co
26c0: 6c 75 6d 6e 20 6f 66 20 70 46 4b 65 79 2c 20 74  lumn of pFKey, t
26d0: 68 65 6e 20 74 68 69 73 20 69 6e 64 65 78 20 69  hen this index i
26e0: 73 20 61 20 77 69 6e 6e 65 72 2e 20 20 2a 2f 0a  s a winner.  */.
26f0: 0a 20 20 20 20 20 20 69 66 28 20 7a 4b 65 79 3d  .      if( zKey=
2700: 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a  =0 ){.        /*
2710: 20 49 66 20 7a 4b 65 79 20 69 73 20 4e 55 4c 4c   If zKey is NULL
2720: 2c 20 74 68 65 6e 20 74 68 69 73 20 66 6f 72 65  , then this fore
2730: 69 67 6e 20 6b 65 79 20 69 73 20 69 6d 70 6c 69  ign key is impli
2740: 63 69 74 6c 79 20 6d 61 70 70 65 64 20 74 6f 20  citly mapped to 
2750: 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20  .        ** the 
2760: 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 66 20 74  PRIMARY KEY of t
2770: 61 62 6c 65 20 70 50 61 72 65 6e 74 2e 20 54 68  able pParent. Th
2780: 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 69 6e  e PRIMARY KEY in
2790: 64 65 78 20 6d 61 79 20 62 65 20 0a 20 20 20 20  dex may be .    
27a0: 20 20 20 20 2a 2a 20 69 64 65 6e 74 69 66 69 65      ** identifie
27b0: 64 20 62 79 20 74 68 65 20 74 65 73 74 20 28 49  d by the test (I
27c0: 6e 64 65 78 2e 61 75 74 6f 49 6e 64 65 78 3d 3d  ndex.autoIndex==
27d0: 32 29 2e 20 20 2a 2f 0a 20 20 20 20 20 20 20 20  2).  */.        
27e0: 69 66 28 20 70 49 64 78 2d 3e 61 75 74 6f 49 6e  if( pIdx->autoIn
27f0: 64 65 78 3d 3d 32 20 29 7b 0a 20 20 20 20 20 20  dex==2 ){.      
2800: 20 20 20 20 69 66 28 20 61 69 43 6f 6c 20 29 7b      if( aiCol ){
2810: 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 6e 74  .            int
2820: 20 69 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20   i;.            
2830: 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 6f 6c 3b  for(i=0; i<nCol;
2840: 20 69 2b 2b 29 20 61 69 43 6f 6c 5b 69 5d 20 3d   i++) aiCol[i] =
2850: 20 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 69 5d 2e   pFKey->aCol[i].
2860: 69 46 72 6f 6d 3b 0a 20 20 20 20 20 20 20 20 20  iFrom;.         
2870: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 62 72 65   }.          bre
2880: 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ak;.        }.  
2890: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
28a0: 20 20 20 2f 2a 20 49 66 20 7a 4b 65 79 20 69 73     /* If zKey is
28b0: 20 6e 6f 6e 2d 4e 55 4c 4c 2c 20 74 68 65 6e 20   non-NULL, then 
28c0: 74 68 69 73 20 66 6f 72 65 69 67 6e 20 6b 65 79  this foreign key
28d0: 20 77 61 73 20 64 65 63 6c 61 72 65 64 20 74 6f   was declared to
28e0: 0a 20 20 20 20 20 20 20 20 2a 2a 20 6d 61 70 20  .        ** map 
28f0: 74 6f 20 61 6e 20 65 78 70 6c 69 63 69 74 20 6c  to an explicit l
2900: 69 73 74 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69  ist of columns i
2910: 6e 20 74 61 62 6c 65 20 70 50 61 72 65 6e 74 2e  n table pParent.
2920: 20 43 68 65 63 6b 20 69 66 20 74 68 69 73 0a 20   Check if this. 
2930: 20 20 20 20 20 20 20 2a 2a 20 69 6e 64 65 78 20         ** index 
2940: 6d 61 74 63 68 65 73 20 74 68 6f 73 65 20 63 6f  matches those co
2950: 6c 75 6d 6e 73 2e 20 41 6c 73 6f 2c 20 63 68 65  lumns. Also, che
2960: 63 6b 20 74 68 61 74 20 74 68 65 20 69 6e 64 65  ck that the inde
2970: 78 20 75 73 65 73 0a 20 20 20 20 20 20 20 20 2a  x uses.        *
2980: 2a 20 74 68 65 20 64 65 66 61 75 6c 74 20 63 6f  * the default co
2990: 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65  llation sequence
29a0: 73 20 66 6f 72 20 65 61 63 68 20 63 6f 6c 75 6d  s for each colum
29b0: 6e 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 6e  n. */.        in
29c0: 74 20 69 2c 20 6a 3b 0a 20 20 20 20 20 20 20 20  t i, j;.        
29d0: 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 6f 6c 3b  for(i=0; i<nCol;
29e0: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20   i++){.         
29f0: 20 69 6e 74 20 69 43 6f 6c 20 3d 20 70 49 64 78   int iCol = pIdx
2a00: 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 69 5d 3b 20 20  ->aiColumn[i];  
2a10: 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 63     /* Index of c
2a20: 6f 6c 75 6d 6e 20 69 6e 20 70 61 72 65 6e 74 20  olumn in parent 
2a30: 74 62 6c 20 2a 2f 0a 20 20 20 20 20 20 20 20 20  tbl */.         
2a40: 20 63 68 61 72 20 2a 7a 44 66 6c 74 43 6f 6c 6c   char *zDfltColl
2a50: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
2a60: 20 20 20 2f 2a 20 44 65 66 2e 20 63 6f 6c 6c 61     /* Def. colla
2a70: 74 69 6f 6e 20 66 6f 72 20 63 6f 6c 75 6d 6e 20  tion for column 
2a80: 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 63 68 61  */.          cha
2a90: 72 20 2a 7a 49 64 78 43 6f 6c 3b 20 20 20 20 20  r *zIdxCol;     
2aa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
2ab0: 2a 20 4e 61 6d 65 20 6f 66 20 69 6e 64 65 78 65  * Name of indexe
2ac0: 64 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 0a 20 20 20  d column */..   
2ad0: 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65         /* If the
2ae0: 20 69 6e 64 65 78 20 75 73 65 73 20 61 20 63 6f   index uses a co
2af0: 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65  llation sequence
2b00: 20 74 68 61 74 20 69 73 20 64 69 66 66 65 72 65   that is differe
2b10: 6e 74 20 66 72 6f 6d 0a 20 20 20 20 20 20 20 20  nt from.        
2b20: 20 20 2a 2a 20 74 68 65 20 64 65 66 61 75 6c 74    ** the default
2b30: 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65   collation seque
2b40: 6e 63 65 20 66 6f 72 20 74 68 65 20 63 6f 6c 75  nce for the colu
2b50: 6d 6e 2c 20 74 68 69 73 20 69 6e 64 65 78 20 69  mn, this index i
2b60: 73 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 75  s.          ** u
2b70: 6e 75 73 61 62 6c 65 2e 20 42 61 69 6c 20 6f 75  nusable. Bail ou
2b80: 74 20 65 61 72 6c 79 20 69 6e 20 74 68 69 73 20  t early in this 
2b90: 63 61 73 65 2e 20 20 2a 2f 0a 20 20 20 20 20 20  case.  */.      
2ba0: 20 20 20 20 7a 44 66 6c 74 43 6f 6c 6c 20 3d 20      zDfltColl = 
2bb0: 70 50 61 72 65 6e 74 2d 3e 61 43 6f 6c 5b 69 43  pParent->aCol[iC
2bc0: 6f 6c 5d 2e 7a 43 6f 6c 6c 3b 0a 20 20 20 20 20  ol].zColl;.     
2bd0: 20 20 20 20 20 69 66 28 20 21 7a 44 66 6c 74 43       if( !zDfltC
2be0: 6f 6c 6c 20 29 7b 0a 20 20 20 20 20 20 20 20 20  oll ){.         
2bf0: 20 20 20 7a 44 66 6c 74 43 6f 6c 6c 20 3d 20 22     zDfltColl = "
2c00: 42 49 4e 41 52 59 22 3b 0a 20 20 20 20 20 20 20  BINARY";.       
2c10: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69     }.          i
2c20: 66 28 20 73 71 6c 69 74 65 33 53 74 72 49 43 6d  f( sqlite3StrICm
2c30: 70 28 70 49 64 78 2d 3e 61 7a 43 6f 6c 6c 5b 69  p(pIdx->azColl[i
2c40: 5d 2c 20 7a 44 66 6c 74 43 6f 6c 6c 29 20 29 20  ], zDfltColl) ) 
2c50: 62 72 65 61 6b 3b 0a 0a 20 20 20 20 20 20 20 20  break;..        
2c60: 20 20 7a 49 64 78 43 6f 6c 20 3d 20 70 50 61 72    zIdxCol = pPar
2c70: 65 6e 74 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 2e  ent->aCol[iCol].
2c80: 7a 4e 61 6d 65 3b 0a 20 20 20 20 20 20 20 20 20  zName;.         
2c90: 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 6e 43 6f 6c   for(j=0; j<nCol
2ca0: 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20  ; j++){.        
2cb0: 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 53      if( sqlite3S
2cc0: 74 72 49 43 6d 70 28 70 46 4b 65 79 2d 3e 61 43  trICmp(pFKey->aC
2cd0: 6f 6c 5b 6a 5d 2e 7a 43 6f 6c 2c 20 7a 49 64 78  ol[j].zCol, zIdx
2ce0: 43 6f 6c 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20  Col)==0 ){.     
2cf0: 20 20 20 20 20 20 20 20 20 69 66 28 20 61 69 43           if( aiC
2d00: 6f 6c 20 29 20 61 69 43 6f 6c 5b 69 5d 20 3d 20  ol ) aiCol[i] = 
2d10: 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 6a 5d 2e 69  pFKey->aCol[j].i
2d20: 46 72 6f 6d 3b 0a 20 20 20 20 20 20 20 20 20 20  From;.          
2d30: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
2d40: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20         }.       
2d50: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 69     }.          i
2d60: 66 28 20 6a 3d 3d 6e 43 6f 6c 20 29 20 62 72 65  f( j==nCol ) bre
2d70: 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ak;.        }.  
2d80: 20 20 20 20 20 20 69 66 28 20 69 3d 3d 6e 43 6f        if( i==nCo
2d90: 6c 20 29 20 62 72 65 61 6b 3b 20 20 20 20 20 20  l ) break;      
2da0: 2f 2a 20 70 49 64 78 20 69 73 20 75 73 61 62 6c  /* pIdx is usabl
2db0: 65 20 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 20 20  e */.      }.   
2dc0: 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 21 70   }.  }..  if( !p
2dd0: 49 64 78 20 29 7b 0a 20 20 20 20 69 66 28 20 21  Idx ){.    if( !
2de0: 70 50 61 72 73 65 2d 3e 64 69 73 61 62 6c 65 54  pParse->disableT
2df0: 72 69 67 67 65 72 73 20 29 7b 0a 20 20 20 20 20  riggers ){.     
2e00: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 4d 73 67   sqlite3ErrorMsg
2e10: 28 70 50 61 72 73 65 2c 20 22 66 6f 72 65 69 67  (pParse, "foreig
2e20: 6e 20 6b 65 79 20 6d 69 73 6d 61 74 63 68 22 29  n key mismatch")
2e30: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69  ;.    }.    sqli
2e40: 74 65 33 44 62 46 72 65 65 28 70 50 61 72 73 65  te3DbFree(pParse
2e50: 2d 3e 64 62 2c 20 61 69 43 6f 6c 29 3b 0a 20 20  ->db, aiCol);.  
2e60: 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a    return 1;.  }.
2e70: 0a 20 20 2a 70 70 49 64 78 20 3d 20 70 49 64 78  .  *ppIdx = pIdx
2e80: 3b 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  ;.  return 0;.}.
2e90: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
2ea0: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77  tion is called w
2eb0: 68 65 6e 20 61 20 72 6f 77 20 69 73 20 69 6e 73  hen a row is ins
2ec0: 65 72 74 65 64 20 69 6e 74 6f 20 6f 72 20 64 65  erted into or de
2ed0: 6c 65 74 65 64 20 66 72 6f 6d 20 74 68 65 20 0a  leted from the .
2ee0: 2a 2a 20 63 68 69 6c 64 20 74 61 62 6c 65 20 6f  ** child table o
2ef0: 66 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f  f foreign key co
2f00: 6e 73 74 72 61 69 6e 74 20 70 46 4b 65 79 2e 20  nstraint pFKey. 
2f10: 49 66 20 61 6e 20 53 51 4c 20 55 50 44 41 54 45  If an SQL UPDATE
2f20: 20 69 73 20 65 78 65 63 75 74 65 64 20 0a 2a 2a   is executed .**
2f30: 20 6f 6e 20 74 68 65 20 63 68 69 6c 64 20 74 61   on the child ta
2f40: 62 6c 65 20 6f 66 20 70 46 4b 65 79 2c 20 74 68  ble of pFKey, th
2f50: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69  is function is i
2f60: 6e 76 6f 6b 65 64 20 74 77 69 63 65 20 66 6f 72  nvoked twice for
2f70: 20 65 61 63 68 20 72 6f 77 0a 2a 2a 20 61 66 66   each row.** aff
2f80: 65 63 74 65 64 20 2d 20 6f 6e 63 65 20 74 6f 20  ected - once to 
2f90: 22 64 65 6c 65 74 65 22 20 74 68 65 20 6f 6c 64  "delete" the old
2fa0: 20 72 6f 77 2c 20 61 6e 64 20 74 68 65 6e 20 61   row, and then a
2fb0: 67 61 69 6e 20 74 6f 20 22 69 6e 73 65 72 74 22  gain to "insert"
2fc0: 20 74 68 65 0a 2a 2a 20 6e 65 77 20 72 6f 77 2e   the.** new row.
2fd0: 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 74 69 6d 65  .**.** Each time
2fe0: 20 69 74 20 69 73 20 63 61 6c 6c 65 64 2c 20 74   it is called, t
2ff0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 67 65 6e  his function gen
3000: 65 72 61 74 65 73 20 56 44 42 45 20 63 6f 64 65  erates VDBE code
3010: 20 74 6f 20 6c 6f 63 61 74 65 20 74 68 65 0a 2a   to locate the.*
3020: 2a 20 72 6f 77 20 69 6e 20 74 68 65 20 70 61 72  * row in the par
3030: 65 6e 74 20 74 61 62 6c 65 20 74 68 61 74 20 63  ent table that c
3040: 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 68  orresponds to th
3050: 65 20 72 6f 77 20 62 65 69 6e 67 20 69 6e 73 65  e row being inse
3060: 72 74 65 64 20 69 6e 74 6f 20 0a 2a 2a 20 6f 72  rted into .** or
3070: 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 74 68   deleted from th
3080: 65 20 63 68 69 6c 64 20 74 61 62 6c 65 2e 20 49  e child table. I
3090: 66 20 74 68 65 20 70 61 72 65 6e 74 20 72 6f 77  f the parent row
30a0: 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 2c 20 6e   can be found, n
30b0: 6f 20 0a 2a 2a 20 73 70 65 63 69 61 6c 20 61 63  o .** special ac
30c0: 74 69 6f 6e 20 69 73 20 74 61 6b 65 6e 2e 20 4f  tion is taken. O
30d0: 74 68 65 72 77 69 73 65 2c 20 69 66 20 74 68 65  therwise, if the
30e0: 20 70 61 72 65 6e 74 20 72 6f 77 20 63 61 6e 20   parent row can 
30f0: 2a 6e 6f 74 2a 20 62 65 0a 2a 2a 20 66 6f 75 6e  *not* be.** foun
3100: 64 20 69 6e 20 74 68 65 20 70 61 72 65 6e 74 20  d in the parent 
3110: 74 61 62 6c 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 4f  table:.**.**   O
3120: 70 65 72 61 74 69 6f 6e 20 7c 20 46 4b 20 74 79  peration | FK ty
3130: 70 65 20 20 20 7c 20 41 63 74 69 6f 6e 20 74 61  pe   | Action ta
3140: 6b 65 6e 0a 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d  ken.**   -------
3150: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
3160: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
3170: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
3180: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
3190: 2d 2d 2d 0a 2a 2a 20 20 20 49 4e 53 45 52 54 20  ---.**   INSERT 
31a0: 20 20 20 20 20 69 6d 6d 65 64 69 61 74 65 20 20       immediate  
31b0: 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 22   Increment the "
31c0: 69 6d 6d 65 64 69 61 74 65 20 63 6f 6e 73 74 72  immediate constr
31d0: 61 69 6e 74 20 63 6f 75 6e 74 65 72 22 2e 0a 2a  aint counter"..*
31e0: 2a 0a 2a 2a 20 20 20 44 45 4c 45 54 45 20 20 20  *.**   DELETE   
31f0: 20 20 20 69 6d 6d 65 64 69 61 74 65 20 20 20 44     immediate   D
3200: 65 63 72 65 6d 65 6e 74 20 74 68 65 20 22 69 6d  ecrement the "im
3210: 6d 65 64 69 61 74 65 20 63 6f 6e 73 74 72 61 69  mediate constrai
3220: 6e 74 20 63 6f 75 6e 74 65 72 22 2e 0a 2a 2a 0a  nt counter"..**.
3230: 2a 2a 20 20 20 49 4e 53 45 52 54 20 20 20 20 20  **   INSERT     
3240: 20 64 65 66 65 72 72 65 64 20 20 20 20 49 6e 63   deferred    Inc
3250: 72 65 6d 65 6e 74 20 74 68 65 20 22 64 65 66 65  rement the "defe
3260: 72 72 65 64 20 63 6f 6e 73 74 72 61 69 6e 74 20  rred constraint 
3270: 63 6f 75 6e 74 65 72 22 2e 0a 2a 2a 0a 2a 2a 20  counter"..**.** 
3280: 20 20 44 45 4c 45 54 45 20 20 20 20 20 20 64 65    DELETE      de
3290: 66 65 72 72 65 64 20 20 20 20 44 65 63 72 65 6d  ferred    Decrem
32a0: 65 6e 74 20 74 68 65 20 22 64 65 66 65 72 72 65  ent the "deferre
32b0: 64 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75  d constraint cou
32c0: 6e 74 65 72 22 2e 0a 2a 2a 0a 2a 2a 20 54 68 65  nter"..**.** The
32d0: 73 65 20 6f 70 65 72 61 74 69 6f 6e 73 20 61 72  se operations ar
32e0: 65 20 69 64 65 6e 74 69 66 69 65 64 20 69 6e 20  e identified in 
32f0: 74 68 65 20 63 6f 6d 6d 65 6e 74 20 61 74 20 74  the comment at t
3300: 68 65 20 74 6f 70 20 6f 66 20 74 68 69 73 20 66  he top of this f
3310: 69 6c 65 20 0a 2a 2a 20 28 66 6b 65 79 2e 63 29  ile .** (fkey.c)
3320: 20 61 73 20 22 49 2e 31 22 20 61 6e 64 20 22 44   as "I.1" and "D
3330: 2e 31 22 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76  .1"..*/.static v
3340: 6f 69 64 20 66 6b 4c 6f 6f 6b 75 70 50 61 72 65  oid fkLookupPare
3350: 6e 74 28 0a 20 20 50 61 72 73 65 20 2a 70 50 61  nt(.  Parse *pPa
3360: 72 73 65 2c 20 20 20 20 20 20 20 20 2f 2a 20 50  rse,        /* P
3370: 61 72 73 65 20 63 6f 6e 74 65 78 74 20 2a 2f 0a  arse context */.
3380: 20 20 69 6e 74 20 69 44 62 2c 20 20 20 20 20 20    int iDb,      
3390: 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78          /* Index
33a0: 20 6f 66 20 64 61 74 61 62 61 73 65 20 68 6f 75   of database hou
33b0: 73 69 6e 67 20 70 54 61 62 20 2a 2f 0a 20 20 54  sing pTab */.  T
33c0: 61 62 6c 65 20 2a 70 54 61 62 2c 20 20 20 20 20  able *pTab,     
33d0: 20 20 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 74       /* Parent t
33e0: 61 62 6c 65 20 6f 66 20 46 4b 20 70 46 4b 65 79  able of FK pFKey
33f0: 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 70 49 64   */.  Index *pId
3400: 78 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55  x,          /* U
3410: 6e 69 71 75 65 20 69 6e 64 65 78 20 6f 6e 20 70  nique index on p
3420: 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e  arent key column
3430: 73 20 69 6e 20 70 54 61 62 20 2a 2f 0a 20 20 46  s in pTab */.  F
3440: 4b 65 79 20 2a 70 46 4b 65 79 2c 20 20 20 20 20  Key *pFKey,     
3450: 20 20 20 20 20 2f 2a 20 46 6f 72 65 69 67 6e 20       /* Foreign 
3460: 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a  key constraint *
3470: 2f 0a 20 20 69 6e 74 20 2a 61 69 43 6f 6c 2c 20  /.  int *aiCol, 
3480: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 70            /* Map
3490: 20 66 72 6f 6d 20 70 61 72 65 6e 74 20 6b 65 79   from parent key
34a0: 20 63 6f 6c 75 6d 6e 73 20 74 6f 20 63 68 69 6c   columns to chil
34b0: 64 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 73 20  d table columns 
34c0: 2a 2f 0a 20 20 69 6e 74 20 72 65 67 44 61 74 61  */.  int regData
34d0: 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64  ,          /* Ad
34e0: 64 72 65 73 73 20 6f 66 20 61 72 72 61 79 20 63  dress of array c
34f0: 6f 6e 74 61 69 6e 69 6e 67 20 63 68 69 6c 64 20  ontaining child 
3500: 74 61 62 6c 65 20 72 6f 77 20 2a 2f 0a 20 20 69  table row */.  i
3510: 6e 74 20 6e 49 6e 63 72 20 20 20 20 20 20 20 20  nt nIncr        
3520: 20 20 20 20 20 2f 2a 20 49 6e 63 72 65 6d 65 6e       /* Incremen
3530: 74 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75  t constraint cou
3540: 6e 74 65 72 20 62 79 20 74 68 69 73 20 2a 2f 0a  nter by this */.
3550: 29 7b 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20  ){.  int i;     
3560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3570: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
3580: 2a 20 49 74 65 72 61 74 6f 72 20 76 61 72 69 61  * Iterator varia
3590: 62 6c 65 20 2a 2f 0a 20 20 56 64 62 65 20 2a 76  ble */.  Vdbe *v
35a0: 20 3d 20 73 71 6c 69 74 65 33 47 65 74 56 64 62   = sqlite3GetVdb
35b0: 65 28 70 50 61 72 73 65 29 3b 20 20 20 20 20 20  e(pParse);      
35c0: 20 20 20 2f 2a 20 56 64 62 65 20 74 6f 20 61 64     /* Vdbe to ad
35d0: 64 20 63 6f 64 65 20 74 6f 20 2a 2f 0a 20 20 69  d code to */.  i
35e0: 6e 74 20 69 43 75 72 20 3d 20 70 50 61 72 73 65  nt iCur = pParse
35f0: 2d 3e 6e 54 61 62 20 2d 20 31 3b 20 20 20 20 20  ->nTab - 1;     
3600: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 73           /* Curs
3610: 6f 72 20 6e 75 6d 62 65 72 20 74 6f 20 75 73 65  or number to use
3620: 20 2a 2f 0a 20 20 69 6e 74 20 69 4f 6b 20 3d 20   */.  int iOk = 
3630: 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c  sqlite3VdbeMakeL
3640: 61 62 65 6c 28 76 29 3b 20 20 20 20 20 20 20 20  abel(v);        
3650: 2f 2a 20 6a 75 6d 70 20 68 65 72 65 20 69 66 20  /* jump here if 
3660: 70 61 72 65 6e 74 20 6b 65 79 20 66 6f 75 6e 64  parent key found
3670: 20 2a 2f 0a 0a 20 20 2f 2a 20 49 66 20 6e 49 6e   */..  /* If nIn
3680: 63 72 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20  cr is less than 
3690: 7a 65 72 6f 2c 20 74 68 65 6e 20 63 68 65 63 6b  zero, then check
36a0: 20 61 74 20 72 75 6e 74 69 6d 65 20 69 66 20 74   at runtime if t
36b0: 68 65 72 65 20 61 72 65 20 61 6e 79 0a 20 20 2a  here are any.  *
36c0: 2a 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 63 6f  * outstanding co
36d0: 6e 73 74 72 61 69 6e 74 73 20 74 6f 20 72 65 73  nstraints to res
36e0: 6f 6c 76 65 2e 20 49 66 20 74 68 65 72 65 20 61  olve. If there a
36f0: 72 65 20 6e 6f 74 2c 20 74 68 65 72 65 20 69 73  re not, there is
3700: 20 6e 6f 20 6e 65 65 64 0a 20 20 2a 2a 20 74 6f   no need.  ** to
3710: 20 63 68 65 63 6b 20 69 66 20 64 65 6c 65 74 69   check if deleti
3720: 6e 67 20 74 68 69 73 20 72 6f 77 20 72 65 73 6f  ng this row reso
3730: 6c 76 65 73 20 61 6e 79 20 6f 75 74 73 74 61 6e  lves any outstan
3740: 64 69 6e 67 20 76 69 6f 6c 61 74 69 6f 6e 73 2e  ding violations.
3750: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 43 68 65 63 6b  .  **.  ** Check
3760: 20 69 66 20 61 6e 79 20 6f 66 20 74 68 65 20 6b   if any of the k
3770: 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68  ey columns in th
3780: 65 20 63 68 69 6c 64 20 74 61 62 6c 65 20 72 6f  e child table ro
3790: 77 20 61 72 65 20 4e 55 4c 4c 2e 20 49 66 20 0a  w are NULL. If .
37a0: 20 20 2a 2a 20 61 6e 79 20 61 72 65 2c 20 74 68    ** any are, th
37b0: 65 6e 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e  en the constrain
37c0: 74 20 69 73 20 63 6f 6e 73 69 64 65 72 65 64 20  t is considered 
37d0: 73 61 74 69 73 66 69 65 64 2e 20 4e 6f 20 6e 65  satisfied. No ne
37e0: 65 64 20 74 6f 20 0a 20 20 2a 2a 20 73 65 61 72  ed to .  ** sear
37f0: 63 68 20 66 6f 72 20 61 20 6d 61 74 63 68 69 6e  ch for a matchin
3800: 67 20 72 6f 77 20 69 6e 20 74 68 65 20 70 61 72  g row in the par
3810: 65 6e 74 20 74 61 62 6c 65 2e 20 20 2a 2f 0a 20  ent table.  */. 
3820: 20 69 66 28 20 6e 49 6e 63 72 3c 30 20 29 7b 0a   if( nIncr<0 ){.
3830: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41      sqlite3VdbeA
3840: 64 64 4f 70 32 28 76 2c 20 4f 50 5f 46 6b 49 66  ddOp2(v, OP_FkIf
3850: 5a 65 72 6f 2c 20 70 46 4b 65 79 2d 3e 69 73 44  Zero, pFKey->isD
3860: 65 66 65 72 72 65 64 2c 20 69 4f 6b 29 3b 0a 20  eferred, iOk);. 
3870: 20 7d 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c   }.  for(i=0; i<
3880: 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b  pFKey->nCol; i++
3890: 29 7b 0a 20 20 20 20 69 6e 74 20 69 52 65 67 20  ){.    int iReg 
38a0: 3d 20 61 69 43 6f 6c 5b 69 5d 20 2b 20 72 65 67  = aiCol[i] + reg
38b0: 44 61 74 61 20 2b 20 31 3b 0a 20 20 20 20 73 71  Data + 1;.    sq
38c0: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28  lite3VdbeAddOp2(
38d0: 76 2c 20 4f 50 5f 49 73 4e 75 6c 6c 2c 20 69 52  v, OP_IsNull, iR
38e0: 65 67 2c 20 69 4f 6b 29 3b 0a 20 20 7d 0a 0a 20  eg, iOk);.  }.. 
38f0: 20 69 66 28 20 70 49 64 78 3d 3d 30 20 29 7b 0a   if( pIdx==0 ){.
3900: 20 20 20 20 2f 2a 20 49 66 20 70 49 64 78 20 69      /* If pIdx i
3910: 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 74 68 65  s NULL, then the
3920: 20 70 61 72 65 6e 74 20 6b 65 79 20 69 73 20 74   parent key is t
3930: 68 65 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41  he INTEGER PRIMA
3940: 52 59 20 4b 45 59 0a 20 20 20 20 2a 2a 20 63 6f  RY KEY.    ** co
3950: 6c 75 6d 6e 20 6f 66 20 74 68 65 20 70 61 72 65  lumn of the pare
3960: 6e 74 20 74 61 62 6c 65 20 28 74 61 62 6c 65 20  nt table (table 
3970: 70 54 61 62 29 2e 20 20 2a 2f 0a 20 20 20 20 69  pTab).  */.    i
3980: 6e 74 20 69 4d 75 73 74 42 65 49 6e 74 3b 20 20  nt iMustBeInt;  
3990: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
39a0: 41 64 64 72 65 73 73 20 6f 66 20 4d 75 73 74 42  Address of MustB
39b0: 65 49 6e 74 20 69 6e 73 74 72 75 63 74 69 6f 6e  eInt instruction
39c0: 20 2a 2f 0a 20 20 20 20 69 6e 74 20 72 65 67 54   */.    int regT
39d0: 65 6d 70 20 3d 20 73 71 6c 69 74 65 33 47 65 74  emp = sqlite3Get
39e0: 54 65 6d 70 52 65 67 28 70 50 61 72 73 65 29 3b  TempReg(pParse);
39f0: 0a 0a 20 20 20 20 2f 2a 20 49 6e 76 6f 6b 65 20  ..    /* Invoke 
3a00: 4d 75 73 74 42 65 49 6e 74 20 74 6f 20 63 6f 65  MustBeInt to coe
3a10: 72 63 65 20 74 68 65 20 63 68 69 6c 64 20 6b 65  rce the child ke
3a20: 79 20 76 61 6c 75 65 20 74 6f 20 61 6e 20 69 6e  y value to an in
3a30: 74 65 67 65 72 20 28 69 2e 65 2e 20 0a 20 20 20  teger (i.e. .   
3a40: 20 2a 2a 20 61 70 70 6c 79 20 74 68 65 20 61 66   ** apply the af
3a50: 66 69 6e 69 74 79 20 6f 66 20 74 68 65 20 70 61  finity of the pa
3a60: 72 65 6e 74 20 6b 65 79 29 2e 20 49 66 20 74 68  rent key). If th
3a70: 69 73 20 66 61 69 6c 73 2c 20 74 68 65 6e 20 74  is fails, then t
3a80: 68 65 72 65 0a 20 20 20 20 2a 2a 20 69 73 20 6e  here.    ** is n
3a90: 6f 20 6d 61 74 63 68 69 6e 67 20 70 61 72 65 6e  o matching paren
3aa0: 74 20 6b 65 79 2e 20 42 65 66 6f 72 65 20 75 73  t key. Before us
3ab0: 69 6e 67 20 4d 75 73 74 42 65 49 6e 74 2c 20 6d  ing MustBeInt, m
3ac0: 61 6b 65 20 61 20 63 6f 70 79 20 6f 66 0a 20 20  ake a copy of.  
3ad0: 20 20 2a 2a 20 74 68 65 20 76 61 6c 75 65 2e 20    ** the value. 
3ae0: 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 20 76  Otherwise, the v
3af0: 61 6c 75 65 20 69 6e 73 65 72 74 65 64 20 69 6e  alue inserted in
3b00: 74 6f 20 74 68 65 20 63 68 69 6c 64 20 6b 65 79  to the child key
3b10: 20 63 6f 6c 75 6d 6e 0a 20 20 20 20 2a 2a 20 77   column.    ** w
3b20: 69 6c 6c 20 68 61 76 65 20 49 4e 54 45 47 45 52  ill have INTEGER
3b30: 20 61 66 66 69 6e 69 74 79 20 61 70 70 6c 69 65   affinity applie
3b40: 64 20 74 6f 20 69 74 2c 20 77 68 69 63 68 20 6d  d to it, which m
3b50: 61 79 20 6e 6f 74 20 62 65 20 63 6f 72 72 65 63  ay not be correc
3b60: 74 2e 20 20 2a 2f 0a 20 20 20 20 73 71 6c 69 74  t.  */.    sqlit
3b70: 65 33 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20  e3VdbeAddOp2(v, 
3b80: 4f 50 5f 53 43 6f 70 79 2c 20 61 69 43 6f 6c 5b  OP_SCopy, aiCol[
3b90: 30 5d 2b 31 2b 72 65 67 44 61 74 61 2c 20 72 65  0]+1+regData, re
3ba0: 67 54 65 6d 70 29 3b 0a 20 20 20 20 69 4d 75 73  gTemp);.    iMus
3bb0: 74 42 65 49 6e 74 20 3d 20 73 71 6c 69 74 65 33  tBeInt = sqlite3
3bc0: 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50  VdbeAddOp2(v, OP
3bd0: 5f 4d 75 73 74 42 65 49 6e 74 2c 20 72 65 67 54  _MustBeInt, regT
3be0: 65 6d 70 2c 20 30 29 3b 0a 0a 20 20 20 20 2f 2a  emp, 0);..    /*
3bf0: 20 49 66 20 74 68 65 20 70 61 72 65 6e 74 20 74   If the parent t
3c00: 61 62 6c 65 20 69 73 20 74 68 65 20 73 61 6d 65  able is the same
3c10: 20 61 73 20 74 68 65 20 63 68 69 6c 64 20 74 61   as the child ta
3c20: 62 6c 65 2c 20 61 6e 64 20 77 65 20 61 72 65 20  ble, and we are 
3c30: 61 62 6f 75 74 0a 20 20 20 20 2a 2a 20 74 6f 20  about.    ** to 
3c40: 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 63 6f  increment the co
3c50: 6e 73 74 72 61 69 6e 74 2d 63 6f 75 6e 74 65 72  nstraint-counter
3c60: 20 28 69 2e 65 2e 20 74 68 69 73 20 69 73 20 61   (i.e. this is a
3c70: 6e 20 49 4e 53 45 52 54 20 6f 70 65 72 61 74 69  n INSERT operati
3c80: 6f 6e 29 2c 20 0a 20 20 20 20 2a 2a 20 74 68 65  on), .    ** the
3c90: 6e 20 63 68 65 63 6b 20 69 66 20 74 68 65 20 72  n check if the r
3ca0: 6f 77 20 62 65 69 6e 67 20 69 6e 73 65 72 74 65  ow being inserte
3cb0: 64 20 6d 61 74 63 68 65 73 20 69 74 73 65 6c 66  d matches itself
3cc0: 2e 20 49 66 20 73 6f 2c 20 64 6f 20 6e 6f 74 0a  . If so, do not.
3cd0: 20 20 20 20 2a 2a 20 69 6e 63 72 65 6d 65 6e 74      ** increment
3ce0: 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 2d   the constraint-
3cf0: 63 6f 75 6e 74 65 72 2e 20 20 2a 2f 0a 20 20 20  counter.  */.   
3d00: 20 69 66 28 20 70 54 61 62 3d 3d 70 46 4b 65 79   if( pTab==pFKey
3d10: 2d 3e 70 46 72 6f 6d 20 26 26 20 6e 49 6e 63 72  ->pFrom && nIncr
3d20: 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  ==1 ){.      sql
3d30: 69 74 65 33 56 64 62 65 41 64 64 4f 70 33 28 76  ite3VdbeAddOp3(v
3d40: 2c 20 4f 50 5f 45 71 2c 20 72 65 67 44 61 74 61  , OP_Eq, regData
3d50: 2c 20 69 4f 6b 2c 20 72 65 67 54 65 6d 70 29 3b  , iOk, regTemp);
3d60: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 73 71 6c 69  .    }..    sqli
3d70: 74 65 33 4f 70 65 6e 54 61 62 6c 65 28 70 50 61  te3OpenTable(pPa
3d80: 72 73 65 2c 20 69 43 75 72 2c 20 69 44 62 2c 20  rse, iCur, iDb, 
3d90: 70 54 61 62 2c 20 4f 50 5f 4f 70 65 6e 52 65 61  pTab, OP_OpenRea
3da0: 64 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56  d);.    sqlite3V
3db0: 64 62 65 41 64 64 4f 70 33 28 76 2c 20 4f 50 5f  dbeAddOp3(v, OP_
3dc0: 4e 6f 74 45 78 69 73 74 73 2c 20 69 43 75 72 2c  NotExists, iCur,
3dd0: 20 30 2c 20 72 65 67 54 65 6d 70 29 3b 0a 20 20   0, regTemp);.  
3de0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64    sqlite3VdbeAdd
3df0: 4f 70 32 28 76 2c 20 4f 50 5f 47 6f 74 6f 2c 20  Op2(v, OP_Goto, 
3e00: 30 2c 20 69 4f 6b 29 3b 0a 20 20 20 20 73 71 6c  0, iOk);.    sql
3e10: 69 74 65 33 56 64 62 65 4a 75 6d 70 48 65 72 65  ite3VdbeJumpHere
3e20: 28 76 2c 20 73 71 6c 69 74 65 33 56 64 62 65 43  (v, sqlite3VdbeC
3e30: 75 72 72 65 6e 74 41 64 64 72 28 76 29 2d 32 29  urrentAddr(v)-2)
3e40: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  ;.    sqlite3Vdb
3e50: 65 4a 75 6d 70 48 65 72 65 28 76 2c 20 69 4d 75  eJumpHere(v, iMu
3e60: 73 74 42 65 49 6e 74 29 3b 0a 20 20 20 20 73 71  stBeInt);.    sq
3e70: 6c 69 74 65 33 52 65 6c 65 61 73 65 54 65 6d 70  lite3ReleaseTemp
3e80: 52 65 67 28 70 50 61 72 73 65 2c 20 72 65 67 54  Reg(pParse, regT
3e90: 65 6d 70 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  emp);.  }else{. 
3ea0: 20 20 20 69 6e 74 20 6e 43 6f 6c 20 3d 20 70 46     int nCol = pF
3eb0: 4b 65 79 2d 3e 6e 43 6f 6c 3b 0a 20 20 20 20 69  Key->nCol;.    i
3ec0: 6e 74 20 72 65 67 54 65 6d 70 20 3d 20 73 71 6c  nt regTemp = sql
3ed0: 69 74 65 33 47 65 74 54 65 6d 70 52 61 6e 67 65  ite3GetTempRange
3ee0: 28 70 50 61 72 73 65 2c 20 6e 43 6f 6c 29 3b 0a  (pParse, nCol);.
3ef0: 20 20 20 20 69 6e 74 20 72 65 67 52 65 63 20 3d      int regRec =
3f00: 20 73 71 6c 69 74 65 33 47 65 74 54 65 6d 70 52   sqlite3GetTempR
3f10: 65 67 28 70 50 61 72 73 65 29 3b 0a 20 20 20 20  eg(pParse);.    
3f20: 4b 65 79 49 6e 66 6f 20 2a 70 4b 65 79 20 3d 20  KeyInfo *pKey = 
3f30: 73 71 6c 69 74 65 33 49 6e 64 65 78 4b 65 79 69  sqlite3IndexKeyi
3f40: 6e 66 6f 28 70 50 61 72 73 65 2c 20 70 49 64 78  nfo(pParse, pIdx
3f50: 29 3b 0a 0a 20 20 20 20 73 71 6c 69 74 65 33 56  );..    sqlite3V
3f60: 64 62 65 41 64 64 4f 70 33 28 76 2c 20 4f 50 5f  dbeAddOp3(v, OP_
3f70: 4f 70 65 6e 52 65 61 64 2c 20 69 43 75 72 2c 20  OpenRead, iCur, 
3f80: 70 49 64 78 2d 3e 74 6e 75 6d 2c 20 69 44 62 29  pIdx->tnum, iDb)
3f90: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  ;.    sqlite3Vdb
3fa0: 65 43 68 61 6e 67 65 50 34 28 76 2c 20 2d 31 2c  eChangeP4(v, -1,
3fb0: 20 28 63 68 61 72 2a 29 70 4b 65 79 2c 20 50 34   (char*)pKey, P4
3fc0: 5f 4b 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46 46  _KEYINFO_HANDOFF
3fd0: 29 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  );.    for(i=0; 
3fe0: 69 3c 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20  i<nCol; i++){.  
3ff0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41      sqlite3VdbeA
4000: 64 64 4f 70 32 28 76 2c 20 4f 50 5f 53 43 6f 70  ddOp2(v, OP_SCop
4010: 79 2c 20 61 69 43 6f 6c 5b 69 5d 2b 31 2b 72 65  y, aiCol[i]+1+re
4020: 67 44 61 74 61 2c 20 72 65 67 54 65 6d 70 2b 69  gData, regTemp+i
4030: 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a  );.    }..    /*
4040: 20 49 66 20 74 68 65 20 70 61 72 65 6e 74 20 74   If the parent t
4050: 61 62 6c 65 20 69 73 20 74 68 65 20 73 61 6d 65  able is the same
4060: 20 61 73 20 74 68 65 20 63 68 69 6c 64 20 74 61   as the child ta
4070: 62 6c 65 2c 20 61 6e 64 20 77 65 20 61 72 65 20  ble, and we are 
4080: 61 62 6f 75 74 0a 20 20 20 20 2a 2a 20 74 6f 20  about.    ** to 
4090: 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 63 6f  increment the co
40a0: 6e 73 74 72 61 69 6e 74 2d 63 6f 75 6e 74 65 72  nstraint-counter
40b0: 20 28 69 2e 65 2e 20 74 68 69 73 20 69 73 20 61   (i.e. this is a
40c0: 6e 20 49 4e 53 45 52 54 20 6f 70 65 72 61 74 69  n INSERT operati
40d0: 6f 6e 29 2c 20 0a 20 20 20 20 2a 2a 20 74 68 65  on), .    ** the
40e0: 6e 20 63 68 65 63 6b 20 69 66 20 74 68 65 20 72  n check if the r
40f0: 6f 77 20 62 65 69 6e 67 20 69 6e 73 65 72 74 65  ow being inserte
4100: 64 20 6d 61 74 63 68 65 73 20 69 74 73 65 6c 66  d matches itself
4110: 2e 20 49 66 20 73 6f 2c 20 64 6f 20 6e 6f 74 0a  . If so, do not.
4120: 20 20 20 20 2a 2a 20 69 6e 63 72 65 6d 65 6e 74      ** increment
4130: 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 2d   the constraint-
4140: 63 6f 75 6e 74 65 72 2e 20 20 2a 2f 0a 20 20 20  counter.  */.   
4150: 20 69 66 28 20 70 54 61 62 3d 3d 70 46 4b 65 79   if( pTab==pFKey
4160: 2d 3e 70 46 72 6f 6d 20 26 26 20 6e 49 6e 63 72  ->pFrom && nIncr
4170: 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20 69 6e 74  ==1 ){.      int
4180: 20 69 4a 75 6d 70 20 3d 20 73 71 6c 69 74 65 33   iJump = sqlite3
4190: 56 64 62 65 43 75 72 72 65 6e 74 41 64 64 72 28  VdbeCurrentAddr(
41a0: 76 29 20 2b 20 6e 43 6f 6c 20 2b 20 31 3b 0a 20  v) + nCol + 1;. 
41b0: 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c       for(i=0; i<
41c0: 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20  nCol; i++){.    
41d0: 20 20 20 20 69 6e 74 20 69 43 68 69 6c 64 20 3d      int iChild =
41e0: 20 61 69 43 6f 6c 5b 69 5d 2b 31 2b 72 65 67 44   aiCol[i]+1+regD
41f0: 61 74 61 3b 0a 20 20 20 20 20 20 20 20 69 6e 74  ata;.        int
4200: 20 69 50 61 72 65 6e 74 20 3d 20 70 49 64 78 2d   iParent = pIdx-
4210: 3e 61 69 43 6f 6c 75 6d 6e 5b 69 5d 2b 31 2b 72  >aiColumn[i]+1+r
4220: 65 67 44 61 74 61 3b 0a 20 20 20 20 20 20 20 20  egData;.        
4230: 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70  sqlite3VdbeAddOp
4240: 33 28 76 2c 20 4f 50 5f 4e 65 2c 20 69 43 68 69  3(v, OP_Ne, iChi
4250: 6c 64 2c 20 69 4a 75 6d 70 2c 20 69 50 61 72 65  ld, iJump, iPare
4260: 6e 74 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  nt);.      }.   
4270: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64     sqlite3VdbeAd
4280: 64 4f 70 32 28 76 2c 20 4f 50 5f 47 6f 74 6f 2c  dOp2(v, OP_Goto,
4290: 20 30 2c 20 69 4f 6b 29 3b 0a 20 20 20 20 7d 0a   0, iOk);.    }.
42a0: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
42b0: 41 64 64 4f 70 33 28 76 2c 20 4f 50 5f 4d 61 6b  AddOp3(v, OP_Mak
42c0: 65 52 65 63 6f 72 64 2c 20 72 65 67 54 65 6d 70  eRecord, regTemp
42d0: 2c 20 6e 43 6f 6c 2c 20 72 65 67 52 65 63 29 3b  , nCol, regRec);
42e0: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
42f0: 43 68 61 6e 67 65 50 34 28 76 2c 20 2d 31 2c 20  ChangeP4(v, -1, 
4300: 73 71 6c 69 74 65 33 49 6e 64 65 78 41 66 66 69  sqlite3IndexAffi
4310: 6e 69 74 79 53 74 72 28 76 2c 20 70 49 64 78 29  nityStr(v, pIdx)
4320: 2c 20 30 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  , 0);.    sqlite
4330: 33 56 64 62 65 41 64 64 4f 70 33 28 76 2c 20 4f  3VdbeAddOp3(v, O
4340: 50 5f 46 6f 75 6e 64 2c 20 69 43 75 72 2c 20 69  P_Found, iCur, i
4350: 4f 6b 2c 20 72 65 67 52 65 63 29 3b 0a 0a 20 20  Ok, regRec);..  
4360: 20 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 65    sqlite3Release
4370: 54 65 6d 70 52 65 67 28 70 50 61 72 73 65 2c 20  TempReg(pParse, 
4380: 72 65 67 52 65 63 29 3b 0a 20 20 20 20 73 71 6c  regRec);.    sql
4390: 69 74 65 33 52 65 6c 65 61 73 65 54 65 6d 70 52  ite3ReleaseTempR
43a0: 61 6e 67 65 28 70 50 61 72 73 65 2c 20 72 65 67  ange(pParse, reg
43b0: 54 65 6d 70 2c 20 6e 43 6f 6c 29 3b 0a 20 20 7d  Temp, nCol);.  }
43c0: 0a 0a 20 20 69 66 28 20 21 70 46 4b 65 79 2d 3e  ..  if( !pFKey->
43d0: 69 73 44 65 66 65 72 72 65 64 20 26 26 20 21 70  isDeferred && !p
43e0: 50 61 72 73 65 2d 3e 70 54 6f 70 6c 65 76 65 6c  Parse->pToplevel
43f0: 20 26 26 20 21 70 50 61 72 73 65 2d 3e 69 73 4d   && !pParse->isM
4400: 75 6c 74 69 57 72 69 74 65 20 29 7b 0a 20 20 20  ultiWrite ){.   
4410: 20 2f 2a 20 53 70 65 63 69 61 6c 20 63 61 73 65   /* Special case
4420: 3a 20 49 66 20 74 68 69 73 20 69 73 20 61 6e 20  : If this is an 
4430: 49 4e 53 45 52 54 20 73 74 61 74 65 6d 65 6e 74  INSERT statement
4440: 20 74 68 61 74 20 77 69 6c 6c 20 69 6e 73 65 72   that will inser
4450: 74 20 65 78 61 63 74 6c 79 0a 20 20 20 20 2a 2a  t exactly.    **
4460: 20 6f 6e 65 20 72 6f 77 20 69 6e 74 6f 20 74 68   one row into th
4470: 65 20 74 61 62 6c 65 2c 20 72 61 69 73 65 20 61  e table, raise a
4480: 20 63 6f 6e 73 74 72 61 69 6e 74 20 69 6d 6d 65   constraint imme
4490: 64 69 61 74 65 6c 79 20 69 6e 73 74 65 61 64 20  diately instead 
44a0: 6f 66 0a 20 20 20 20 2a 2a 20 69 6e 63 72 65 6d  of.    ** increm
44b0: 65 6e 74 69 6e 67 20 61 20 63 6f 75 6e 74 65 72  enting a counter
44c0: 2e 20 54 68 69 73 20 69 73 20 6e 65 63 65 73 73  . This is necess
44d0: 61 72 79 20 61 73 20 74 68 65 20 56 4d 20 63 6f  ary as the VM co
44e0: 64 65 20 69 73 20 62 65 69 6e 67 0a 20 20 20 20  de is being.    
44f0: 2a 2a 20 67 65 6e 65 72 61 74 65 64 20 66 6f 72  ** generated for
4500: 20 77 69 6c 6c 20 6e 6f 74 20 6f 70 65 6e 20 61   will not open a
4510: 20 73 74 61 74 65 6d 65 6e 74 20 74 72 61 6e 73   statement trans
4520: 61 63 74 69 6f 6e 2e 20 20 2a 2f 0a 20 20 20 20  action.  */.    
4530: 61 73 73 65 72 74 28 20 6e 49 6e 63 72 3d 3d 31  assert( nIncr==1
4540: 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 48   );.    sqlite3H
4550: 61 6c 74 43 6f 6e 73 74 72 61 69 6e 74 28 0a 20  altConstraint(. 
4560: 20 20 20 20 20 20 20 70 50 61 72 73 65 2c 20 4f         pParse, O
4570: 45 5f 41 62 6f 72 74 2c 20 22 66 6f 72 65 69 67  E_Abort, "foreig
4580: 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74  n key constraint
4590: 20 66 61 69 6c 65 64 22 2c 20 50 34 5f 53 54 41   failed", P4_STA
45a0: 54 49 43 0a 20 20 20 20 29 3b 0a 20 20 7d 65 6c  TIC.    );.  }el
45b0: 73 65 7b 0a 20 20 20 20 69 66 28 20 6e 49 6e 63  se{.    if( nInc
45c0: 72 3e 30 20 26 26 20 70 46 4b 65 79 2d 3e 69 73  r>0 && pFKey->is
45d0: 44 65 66 65 72 72 65 64 3d 3d 30 20 29 7b 0a 20  Deferred==0 ){. 
45e0: 20 20 20 20 20 73 71 6c 69 74 65 33 50 61 72 73       sqlite3Pars
45f0: 65 54 6f 70 6c 65 76 65 6c 28 70 50 61 72 73 65  eToplevel(pParse
4600: 29 2d 3e 6d 61 79 41 62 6f 72 74 20 3d 20 31 3b  )->mayAbort = 1;
4610: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
4620: 65 33 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20  e3VdbeAddOp2(v, 
4630: 4f 50 5f 46 6b 43 6f 75 6e 74 65 72 2c 20 70 46  OP_FkCounter, pF
4640: 4b 65 79 2d 3e 69 73 44 65 66 65 72 72 65 64 2c  Key->isDeferred,
4650: 20 6e 49 6e 63 72 29 3b 0a 20 20 7d 0a 0a 20 20   nIncr);.  }..  
4660: 73 71 6c 69 74 65 33 56 64 62 65 52 65 73 6f 6c  sqlite3VdbeResol
4670: 76 65 4c 61 62 65 6c 28 76 2c 20 69 4f 6b 29 3b  veLabel(v, iOk);
4680: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
4690: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
46a0: 64 20 74 6f 20 67 65 6e 65 72 61 74 65 20 63 6f  d to generate co
46b0: 64 65 20 65 78 65 63 75 74 65 64 20 77 68 65 6e  de executed when
46c0: 20 61 20 72 6f 77 20 69 73 20 64 65 6c 65 74 65   a row is delete
46d0: 64 0a 2a 2a 20 66 72 6f 6d 20 74 68 65 20 70 61  d.** from the pa
46e0: 72 65 6e 74 20 74 61 62 6c 65 20 6f 66 20 66 6f  rent table of fo
46f0: 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72  reign key constr
4700: 61 69 6e 74 20 70 46 4b 65 79 20 61 6e 64 2c 20  aint pFKey and, 
4710: 69 66 20 70 46 4b 65 79 20 69 73 20 0a 2a 2a 20  if pFKey is .** 
4720: 64 65 66 65 72 72 65 64 2c 20 77 68 65 6e 20 61  deferred, when a
4730: 20 72 6f 77 20 69 73 20 69 6e 73 65 72 74 65 64   row is inserted
4740: 20 69 6e 74 6f 20 74 68 65 20 73 61 6d 65 20 74   into the same t
4750: 61 62 6c 65 2e 20 57 68 65 6e 20 67 65 6e 65 72  able. When gener
4760: 61 74 69 6e 67 0a 2a 2a 20 63 6f 64 65 20 66 6f  ating.** code fo
4770: 72 20 61 6e 20 53 51 4c 20 55 50 44 41 54 45 20  r an SQL UPDATE 
4780: 6f 70 65 72 61 74 69 6f 6e 2c 20 74 68 69 73 20  operation, this 
4790: 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 62 65 20  function may be 
47a0: 63 61 6c 6c 65 64 20 74 77 69 63 65 20 2d 0a 2a  called twice -.*
47b0: 2a 20 6f 6e 63 65 20 74 6f 20 22 64 65 6c 65 74  * once to "delet
47c0: 65 22 20 74 68 65 20 6f 6c 64 20 72 6f 77 20 61  e" the old row a
47d0: 6e 64 20 6f 6e 63 65 20 74 6f 20 22 69 6e 73 65  nd once to "inse
47e0: 72 74 22 20 74 68 65 20 6e 65 77 20 72 6f 77 2e  rt" the new row.
47f0: 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 6f 64 65 20  .**.** The code 
4800: 67 65 6e 65 72 61 74 65 64 20 62 79 20 74 68 69  generated by thi
4810: 73 20 66 75 6e 63 74 69 6f 6e 20 73 63 61 6e 73  s function scans
4820: 20 74 68 72 6f 75 67 68 20 74 68 65 20 72 6f 77   through the row
4830: 73 20 69 6e 20 74 68 65 20 63 68 69 6c 64 0a 2a  s in the child.*
4840: 2a 20 74 61 62 6c 65 20 74 68 61 74 20 63 6f 72  * table that cor
4850: 72 65 73 70 6f 6e 64 20 74 6f 20 74 68 65 20 70  respond to the p
4860: 61 72 65 6e 74 20 74 61 62 6c 65 20 72 6f 77 20  arent table row 
4870: 62 65 69 6e 67 20 64 65 6c 65 74 65 64 20 6f 72  being deleted or
4880: 20 69 6e 73 65 72 74 65 64 2e 0a 2a 2a 20 46 6f   inserted..** Fo
4890: 72 20 65 61 63 68 20 63 68 69 6c 64 20 72 6f 77  r each child row
48a0: 20 66 6f 75 6e 64 2c 20 6f 6e 65 20 6f 66 20 74   found, one of t
48b0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 63 74  he following act
48c0: 69 6f 6e 73 20 69 73 20 74 61 6b 65 6e 3a 0a 2a  ions is taken:.*
48d0: 2a 0a 2a 2a 20 20 20 4f 70 65 72 61 74 69 6f 6e  *.**   Operation
48e0: 20 7c 20 46 4b 20 74 79 70 65 20 20 20 7c 20 41   | FK type   | A
48f0: 63 74 69 6f 6e 20 74 61 6b 65 6e 0a 2a 2a 20 20  ction taken.**  
4900: 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d   ---------------
4910: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4920: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4930: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
4940: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20  -----------.**  
4950: 20 44 45 4c 45 54 45 20 20 20 20 20 20 69 6d 6d   DELETE      imm
4960: 65 64 69 61 74 65 20 20 20 49 6e 63 72 65 6d 65  ediate   Increme
4970: 6e 74 20 74 68 65 20 22 69 6d 6d 65 64 69 61 74  nt the "immediat
4980: 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75  e constraint cou
4990: 6e 74 65 72 22 2e 0a 2a 2a 20 20 20 20 20 20 20  nter"..**       
49a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
49b0: 20 20 20 20 4f 72 2c 20 69 66 20 74 68 65 20 4f      Or, if the O
49c0: 4e 20 28 55 50 44 41 54 45 7c 44 45 4c 45 54 45  N (UPDATE|DELETE
49d0: 29 20 61 63 74 69 6f 6e 20 69 73 20 52 45 53 54  ) action is REST
49e0: 52 49 43 54 2c 0a 2a 2a 20 20 20 20 20 20 20 20  RICT,.**        
49f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4a00: 20 20 20 74 68 72 6f 77 20 61 20 22 66 6f 72 65     throw a "fore
4a10: 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69  ign key constrai
4a20: 6e 74 20 66 61 69 6c 65 64 22 20 65 78 63 65 70  nt failed" excep
4a30: 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 4e  tion..**.**   IN
4a40: 53 45 52 54 20 20 20 20 20 20 69 6d 6d 65 64 69  SERT      immedi
4a50: 61 74 65 20 20 20 44 65 63 72 65 6d 65 6e 74 20  ate   Decrement 
4a60: 74 68 65 20 22 69 6d 6d 65 64 69 61 74 65 20 63  the "immediate c
4a70: 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e 74 65  onstraint counte
4a80: 72 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 44 45 4c 45  r"..**.**   DELE
4a90: 54 45 20 20 20 20 20 20 64 65 66 65 72 72 65 64  TE      deferred
4aa0: 20 20 20 20 49 6e 63 72 65 6d 65 6e 74 20 74 68      Increment th
4ab0: 65 20 22 64 65 66 65 72 72 65 64 20 63 6f 6e 73  e "deferred cons
4ac0: 74 72 61 69 6e 74 20 63 6f 75 6e 74 65 72 22 2e  traint counter".
4ad0: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20  .**             
4ae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 4f 72                Or
4af0: 2c 20 69 66 20 74 68 65 20 4f 4e 20 28 55 50 44  , if the ON (UPD
4b00: 41 54 45 7c 44 45 4c 45 54 45 29 20 61 63 74 69  ATE|DELETE) acti
4b10: 6f 6e 20 69 73 20 52 45 53 54 52 49 43 54 2c 0a  on is RESTRICT,.
4b20: 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  **              
4b30: 20 20 20 20 20 20 20 20 20 20 20 20 20 74 68 72               thr
4b40: 6f 77 20 61 20 22 66 6f 72 65 69 67 6e 20 6b 65  ow a "foreign ke
4b50: 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 66 61 69  y constraint fai
4b60: 6c 65 64 22 20 65 78 63 65 70 74 69 6f 6e 2e 0a  led" exception..
4b70: 2a 2a 0a 2a 2a 20 20 20 49 4e 53 45 52 54 20 20  **.**   INSERT  
4b80: 20 20 20 20 64 65 66 65 72 72 65 64 20 20 20 20      deferred    
4b90: 44 65 63 72 65 6d 65 6e 74 20 74 68 65 20 22 64  Decrement the "d
4ba0: 65 66 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69  eferred constrai
4bb0: 6e 74 20 63 6f 75 6e 74 65 72 22 2e 0a 2a 2a 0a  nt counter"..**.
4bc0: 2a 2a 20 54 68 65 73 65 20 6f 70 65 72 61 74 69  ** These operati
4bd0: 6f 6e 73 20 61 72 65 20 69 64 65 6e 74 69 66 69  ons are identifi
4be0: 65 64 20 69 6e 20 74 68 65 20 63 6f 6d 6d 65 6e  ed in the commen
4bf0: 74 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20  t at the top of 
4c00: 74 68 69 73 20 66 69 6c 65 20 0a 2a 2a 20 28 66  this file .** (f
4c10: 6b 65 79 2e 63 29 20 61 73 20 22 49 2e 32 22 20  key.c) as "I.2" 
4c20: 61 6e 64 20 22 44 2e 32 22 2e 0a 2a 2f 0a 73 74  and "D.2"..*/.st
4c30: 61 74 69 63 20 76 6f 69 64 20 66 6b 53 63 61 6e  atic void fkScan
4c40: 43 68 69 6c 64 72 65 6e 28 0a 20 20 50 61 72 73  Children(.  Pars
4c50: 65 20 2a 70 50 61 72 73 65 2c 20 20 20 20 20 20  e *pParse,      
4c60: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50              /* P
4c70: 61 72 73 65 20 63 6f 6e 74 65 78 74 20 2a 2f 0a  arse context */.
4c80: 20 20 53 72 63 4c 69 73 74 20 2a 70 53 72 63 2c    SrcList *pSrc,
4c90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4ca0: 20 20 2f 2a 20 53 72 63 4c 69 73 74 20 63 6f 6e    /* SrcList con
4cb0: 74 61 69 6e 69 6e 67 20 74 68 65 20 74 61 62 6c  taining the tabl
4cc0: 65 20 74 6f 20 73 63 61 6e 20 2a 2f 0a 20 20 54  e to scan */.  T
4cd0: 61 62 6c 65 20 2a 70 54 61 62 2c 0a 20 20 49 6e  able *pTab,.  In
4ce0: 64 65 78 20 2a 70 49 64 78 2c 20 20 20 20 20 20  dex *pIdx,      
4cf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4d00: 20 46 6f 72 65 69 67 6e 20 6b 65 79 20 69 6e 64   Foreign key ind
4d10: 65 78 20 2a 2f 0a 20 20 46 4b 65 79 20 2a 70 46  ex */.  FKey *pF
4d20: 4b 65 79 2c 20 20 20 20 20 20 20 20 20 20 20 20  Key,            
4d30: 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 65 69          /* Forei
4d40: 67 6e 20 6b 65 79 20 72 65 6c 61 74 69 6f 6e 73  gn key relations
4d50: 68 69 70 20 2a 2f 0a 20 20 69 6e 74 20 2a 61 69  hip */.  int *ai
4d60: 43 6f 6c 2c 20 20 20 20 20 20 20 20 20 20 20 20  Col,            
4d70: 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 70 20           /* Map 
4d80: 66 72 6f 6d 20 70 49 64 78 20 63 6f 6c 73 20 74  from pIdx cols t
4d90: 6f 20 63 68 69 6c 64 20 74 61 62 6c 65 20 63 6f  o child table co
4da0: 6c 73 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 44  ls */.  int regD
4db0: 61 74 61 2c 20 20 20 20 20 20 20 20 20 20 20 20  ata,            
4dc0: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 66 65 72          /* Refer
4dd0: 65 6e 63 65 64 20 74 61 62 6c 65 20 64 61 74 61  enced table data
4de0: 20 73 74 61 72 74 73 20 68 65 72 65 20 2a 2f 0a   starts here */.
4df0: 20 20 69 6e 74 20 6e 49 6e 63 72 20 20 20 20 20    int nIncr     
4e00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4e10: 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 74 6f 20 69    /* Amount to i
4e20: 6e 63 72 65 6d 65 6e 74 20 64 65 66 65 72 72 65  ncrement deferre
4e30: 64 20 63 6f 75 6e 74 65 72 20 62 79 20 2a 2f 0a  d counter by */.
4e40: 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  ){.  sqlite3 *db
4e50: 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 20 20   = pParse->db;  
4e60: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
4e70: 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e 74   handle */.  int
4e80: 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20   i;             
4e90: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
4ea0: 49 74 65 72 61 74 6f 72 20 76 61 72 69 61 62 6c  Iterator variabl
4eb0: 65 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 57 68  e */.  Expr *pWh
4ec0: 65 72 65 20 3d 20 30 3b 20 20 20 20 20 20 20 20  ere = 0;        
4ed0: 20 20 20 20 20 20 20 2f 2a 20 57 48 45 52 45 20         /* WHERE 
4ee0: 63 6c 61 75 73 65 20 74 6f 20 73 63 61 6e 20 77  clause to scan w
4ef0: 69 74 68 20 2a 2f 0a 20 20 4e 61 6d 65 43 6f 6e  ith */.  NameCon
4f00: 74 65 78 74 20 73 4e 61 6d 65 43 6f 6e 74 65 78  text sNameContex
4f10: 74 3b 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74  t;       /* Cont
4f20: 65 78 74 20 75 73 65 64 20 74 6f 20 72 65 73 6f  ext used to reso
4f30: 6c 76 65 20 57 48 45 52 45 20 63 6c 61 75 73 65  lve WHERE clause
4f40: 20 2a 2f 0a 20 20 57 68 65 72 65 49 6e 66 6f 20   */.  WhereInfo 
4f50: 2a 70 57 49 6e 66 6f 3b 20 20 20 20 20 20 20 20  *pWInfo;        
4f60: 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65 78 74        /* Context
4f70: 20 75 73 65 64 20 62 79 20 73 71 6c 69 74 65 33   used by sqlite3
4f80: 57 68 65 72 65 58 58 58 28 29 20 2a 2f 0a 20 20  WhereXXX() */.  
4f90: 69 6e 74 20 69 46 6b 49 66 5a 65 72 6f 20 3d 20  int iFkIfZero = 
4fa0: 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0;              
4fb0: 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 4f 50  /* Address of OP
4fc0: 5f 46 6b 49 66 5a 65 72 6f 20 2a 2f 0a 20 20 56  _FkIfZero */.  V
4fd0: 64 62 65 20 2a 76 20 3d 20 73 71 6c 69 74 65 33  dbe *v = sqlite3
4fe0: 47 65 74 56 64 62 65 28 70 50 61 72 73 65 29 3b  GetVdbe(pParse);
4ff0: 0a 0a 20 20 61 73 73 65 72 74 28 20 21 70 49 64  ..  assert( !pId
5000: 78 20 7c 7c 20 70 49 64 78 2d 3e 70 54 61 62 6c  x || pIdx->pTabl
5010: 65 3d 3d 70 54 61 62 20 29 3b 0a 0a 20 20 69 66  e==pTab );..  if
5020: 28 20 6e 49 6e 63 72 3c 30 20 29 7b 0a 20 20 20  ( nIncr<0 ){.   
5030: 20 69 46 6b 49 66 5a 65 72 6f 20 3d 20 73 71 6c   iFkIfZero = sql
5040: 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28 76  ite3VdbeAddOp2(v
5050: 2c 20 4f 50 5f 46 6b 49 66 5a 65 72 6f 2c 20 70  , OP_FkIfZero, p
5060: 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 72 65 64  FKey->isDeferred
5070: 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20  , 0);.  }..  /* 
5080: 43 72 65 61 74 65 20 61 6e 20 45 78 70 72 20 6f  Create an Expr o
5090: 62 6a 65 63 74 20 72 65 70 72 65 73 65 6e 74 69  bject representi
50a0: 6e 67 20 61 6e 20 53 51 4c 20 65 78 70 72 65 73  ng an SQL expres
50b0: 73 69 6f 6e 20 6c 69 6b 65 3a 0a 20 20 2a 2a 0a  sion like:.  **.
50c0: 20 20 2a 2a 20 20 20 3c 70 61 72 65 6e 74 2d 6b    **   <parent-k
50d0: 65 79 31 3e 20 3d 20 3c 63 68 69 6c 64 2d 6b 65  ey1> = <child-ke
50e0: 79 31 3e 20 41 4e 44 20 3c 70 61 72 65 6e 74 2d  y1> AND <parent-
50f0: 6b 65 79 32 3e 20 3d 20 3c 63 68 69 6c 64 2d 6b  key2> = <child-k
5100: 65 79 32 3e 20 2e 2e 2e 0a 20 20 2a 2a 0a 20 20  ey2> ....  **.  
5110: 2a 2a 20 54 68 65 20 63 6f 6c 6c 61 74 69 6f 6e  ** The collation
5120: 20 73 65 71 75 65 6e 63 65 20 75 73 65 64 20 66   sequence used f
5130: 6f 72 20 74 68 65 20 63 6f 6d 70 61 72 69 73 6f  or the compariso
5140: 6e 20 73 68 6f 75 6c 64 20 62 65 20 74 68 61 74  n should be that
5150: 20 6f 66 0a 20 20 2a 2a 20 74 68 65 20 70 61 72   of.  ** the par
5160: 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 2e  ent key columns.
5170: 20 54 68 65 20 61 66 66 69 6e 69 74 79 20 6f 66   The affinity of
5180: 20 74 68 65 20 70 61 72 65 6e 74 20 6b 65 79 20   the parent key 
5190: 63 6f 6c 75 6d 6e 20 73 68 6f 75 6c 64 0a 20 20  column should.  
51a0: 2a 2a 20 62 65 20 61 70 70 6c 69 65 64 20 74 6f  ** be applied to
51b0: 20 65 61 63 68 20 63 68 69 6c 64 20 6b 65 79 20   each child key 
51c0: 76 61 6c 75 65 20 62 65 66 6f 72 65 20 74 68 65  value before the
51d0: 20 63 6f 6d 70 61 72 69 73 6f 6e 20 74 61 6b 65   comparison take
51e0: 73 20 70 6c 61 63 65 2e 0a 20 20 2a 2f 0a 20 20  s place..  */.  
51f0: 66 6f 72 28 69 3d 30 3b 20 69 3c 70 46 4b 65 79  for(i=0; i<pFKey
5200: 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20  ->nCol; i++){.  
5210: 20 20 45 78 70 72 20 2a 70 4c 65 66 74 3b 20 20    Expr *pLeft;  
5220: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5230: 2f 2a 20 56 61 6c 75 65 20 66 72 6f 6d 20 70 61  /* Value from pa
5240: 72 65 6e 74 20 74 61 62 6c 65 20 72 6f 77 20 2a  rent table row *
5250: 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 52 69 67  /.    Expr *pRig
5260: 68 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  ht;             
5270: 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 72 65      /* Column re
5280: 66 20 74 6f 20 63 68 69 6c 64 20 74 61 62 6c 65  f to child table
5290: 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 45   */.    Expr *pE
52a0: 71 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  q;              
52b0: 20 20 20 20 20 20 2f 2a 20 45 78 70 72 65 73 73        /* Express
52c0: 69 6f 6e 20 28 70 4c 65 66 74 20 3d 20 70 52 69  ion (pLeft = pRi
52d0: 67 68 74 29 20 2a 2f 0a 20 20 20 20 69 6e 74 20  ght) */.    int 
52e0: 69 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20  iCol;           
52f0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64            /* Ind
5300: 65 78 20 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e 20  ex of column in 
5310: 63 68 69 6c 64 20 74 61 62 6c 65 20 2a 2f 20 0a  child table */ .
5320: 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a      const char *
5330: 7a 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20  zCol;           
5340: 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 63 6f 6c    /* Name of col
5350: 75 6d 6e 20 69 6e 20 63 68 69 6c 64 20 74 61 62  umn in child tab
5360: 6c 65 20 2a 2f 0a 0a 20 20 20 20 70 4c 65 66 74  le */..    pLeft
5370: 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 28 64   = sqlite3Expr(d
5380: 62 2c 20 54 4b 5f 52 45 47 49 53 54 45 52 2c 20  b, TK_REGISTER, 
5390: 30 29 3b 0a 20 20 20 20 69 66 28 20 70 4c 65 66  0);.    if( pLef
53a0: 74 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 53 65  t ){.      /* Se
53b0: 74 20 74 68 65 20 63 6f 6c 6c 61 74 69 6f 6e 20  t the collation 
53c0: 73 65 71 75 65 6e 63 65 20 61 6e 64 20 61 66 66  sequence and aff
53d0: 69 6e 69 74 79 20 6f 66 20 74 68 65 20 4c 48 53  inity of the LHS
53e0: 20 6f 66 20 65 61 63 68 20 54 4b 5f 45 51 0a 20   of each TK_EQ. 
53f0: 20 20 20 20 20 2a 2a 20 65 78 70 72 65 73 73 69       ** expressi
5400: 6f 6e 20 74 6f 20 74 68 65 20 70 61 72 65 6e 74  on to the parent
5410: 20 6b 65 79 20 63 6f 6c 75 6d 6e 20 64 65 66 61   key column defa
5420: 75 6c 74 73 2e 20 20 2a 2f 0a 20 20 20 20 20 20  ults.  */.      
5430: 69 66 28 20 70 49 64 78 20 29 7b 0a 20 20 20 20  if( pIdx ){.    
5440: 20 20 20 20 69 6e 74 20 69 43 6f 6c 20 3d 20 70      int iCol = p
5450: 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 69 5d  Idx->aiColumn[i]
5460: 3b 0a 20 20 20 20 20 20 20 20 43 6f 6c 75 6d 6e  ;.        Column
5470: 20 2a 70 43 6f 6c 20 3d 20 26 70 49 64 78 2d 3e   *pCol = &pIdx->
5480: 70 54 61 62 6c 65 2d 3e 61 43 6f 6c 5b 69 43 6f  pTable->aCol[iCo
5490: 6c 5d 3b 0a 20 20 20 20 20 20 20 20 70 4c 65 66  l];.        pLef
54a0: 74 2d 3e 69 54 61 62 6c 65 20 3d 20 72 65 67 44  t->iTable = regD
54b0: 61 74 61 2b 69 43 6f 6c 2b 31 3b 0a 20 20 20 20  ata+iCol+1;.    
54c0: 20 20 20 20 70 4c 65 66 74 2d 3e 61 66 66 69 6e      pLeft->affin
54d0: 69 74 79 20 3d 20 70 43 6f 6c 2d 3e 61 66 66 69  ity = pCol->affi
54e0: 6e 69 74 79 3b 0a 20 20 20 20 20 20 20 20 70 4c  nity;.        pL
54f0: 65 66 74 2d 3e 70 43 6f 6c 6c 20 3d 20 73 71 6c  eft->pColl = sql
5500: 69 74 65 33 4c 6f 63 61 74 65 43 6f 6c 6c 53 65  ite3LocateCollSe
5510: 71 28 70 50 61 72 73 65 2c 20 70 43 6f 6c 2d 3e  q(pParse, pCol->
5520: 7a 43 6f 6c 6c 29 3b 0a 20 20 20 20 20 20 7d 65  zColl);.      }e
5530: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4c 65  lse{.        pLe
5540: 66 74 2d 3e 69 54 61 62 6c 65 20 3d 20 72 65 67  ft->iTable = reg
5550: 44 61 74 61 3b 0a 20 20 20 20 20 20 20 20 70 4c  Data;.        pL
5560: 65 66 74 2d 3e 61 66 66 69 6e 69 74 79 20 3d 20  eft->affinity = 
5570: 53 51 4c 49 54 45 5f 41 46 46 5f 49 4e 54 45 47  SQLITE_AFF_INTEG
5580: 45 52 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ER;.      }.    
5590: 7d 0a 20 20 20 20 69 43 6f 6c 20 3d 20 61 69 43  }.    iCol = aiC
55a0: 6f 6c 20 3f 20 61 69 43 6f 6c 5b 69 5d 20 3a 20  ol ? aiCol[i] : 
55b0: 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 30 5d 2e 69  pFKey->aCol[0].i
55c0: 46 72 6f 6d 3b 0a 20 20 20 20 61 73 73 65 72 74  From;.    assert
55d0: 28 20 69 43 6f 6c 3e 3d 30 20 29 3b 0a 20 20 20  ( iCol>=0 );.   
55e0: 20 7a 43 6f 6c 20 3d 20 70 46 4b 65 79 2d 3e 70   zCol = pFKey->p
55f0: 46 72 6f 6d 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d  From->aCol[iCol]
5600: 2e 7a 4e 61 6d 65 3b 0a 20 20 20 20 70 52 69 67  .zName;.    pRig
5610: 68 74 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72  ht = sqlite3Expr
5620: 28 64 62 2c 20 54 4b 5f 49 44 2c 20 7a 43 6f 6c  (db, TK_ID, zCol
5630: 29 3b 0a 20 20 20 20 70 45 71 20 3d 20 73 71 6c  );.    pEq = sql
5640: 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65  ite3PExpr(pParse
5650: 2c 20 54 4b 5f 45 51 2c 20 70 4c 65 66 74 2c 20  , TK_EQ, pLeft, 
5660: 70 52 69 67 68 74 2c 20 30 29 3b 0a 20 20 20 20  pRight, 0);.    
5670: 70 57 68 65 72 65 20 3d 20 73 71 6c 69 74 65 33  pWhere = sqlite3
5680: 45 78 70 72 41 6e 64 28 64 62 2c 20 70 57 68 65  ExprAnd(db, pWhe
5690: 72 65 2c 20 70 45 71 29 3b 0a 20 20 7d 0a 0a 20  re, pEq);.  }.. 
56a0: 20 2f 2a 20 49 66 20 74 68 65 20 63 68 69 6c 64   /* If the child
56b0: 20 74 61 62 6c 65 20 69 73 20 74 68 65 20 73 61   table is the sa
56c0: 6d 65 20 61 73 20 74 68 65 20 70 61 72 65 6e 74  me as the parent
56d0: 20 74 61 62 6c 65 2c 20 61 6e 64 20 74 68 69 73   table, and this
56e0: 20 73 63 61 6e 0a 20 20 2a 2a 20 69 73 20 74 61   scan.  ** is ta
56f0: 6b 69 6e 67 20 70 6c 61 63 65 20 61 73 20 70 61  king place as pa
5700: 72 74 20 6f 66 20 61 20 44 45 4c 45 54 45 20 6f  rt of a DELETE o
5710: 70 65 72 61 74 69 6f 6e 20 28 6f 70 65 72 61 74  peration (operat
5720: 69 6f 6e 20 44 2e 32 29 2c 20 6f 6d 69 74 20 74  ion D.2), omit t
5730: 68 65 0a 20 20 2a 2a 20 72 6f 77 20 62 65 69 6e  he.  ** row bein
5740: 67 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 74  g deleted from t
5750: 68 65 20 73 63 61 6e 20 62 79 20 61 64 64 69 6e  he scan by addin
5760: 67 20 28 24 72 6f 77 69 64 20 21 3d 20 72 6f 77  g ($rowid != row
5770: 69 64 29 20 74 6f 20 74 68 65 20 57 48 45 52 45  id) to the WHERE
5780: 20 0a 20 20 2a 2a 20 63 6c 61 75 73 65 2c 20 77   .  ** clause, w
5790: 68 65 72 65 20 24 72 6f 77 69 64 20 69 73 20 74  here $rowid is t
57a0: 68 65 20 72 6f 77 69 64 20 6f 66 20 74 68 65 20  he rowid of the 
57b0: 72 6f 77 20 62 65 69 6e 67 20 64 65 6c 65 74 65  row being delete
57c0: 64 2e 20 20 2a 2f 0a 20 20 69 66 28 20 70 54 61  d.  */.  if( pTa
57d0: 62 3d 3d 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 20  b==pFKey->pFrom 
57e0: 26 26 20 6e 49 6e 63 72 3e 30 20 29 7b 0a 20 20  && nIncr>0 ){.  
57f0: 20 20 45 78 70 72 20 2a 70 45 71 3b 20 20 20 20    Expr *pEq;    
5800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5810: 2f 2a 20 45 78 70 72 65 73 73 69 6f 6e 20 28 70  /* Expression (p
5820: 4c 65 66 74 20 3d 20 70 52 69 67 68 74 29 20 2a  Left = pRight) *
5830: 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 4c 65 66  /.    Expr *pLef
5840: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t;              
5850: 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 66 72 6f      /* Value fro
5860: 6d 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 72  m parent table r
5870: 6f 77 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a  ow */.    Expr *
5880: 70 52 69 67 68 74 3b 20 20 20 20 20 20 20 20 20  pRight;         
5890: 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d          /* Colum
58a0: 6e 20 72 65 66 20 74 6f 20 63 68 69 6c 64 20 74  n ref to child t
58b0: 61 62 6c 65 20 2a 2f 0a 20 20 20 20 70 4c 65 66  able */.    pLef
58c0: 74 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 28  t = sqlite3Expr(
58d0: 64 62 2c 20 54 4b 5f 52 45 47 49 53 54 45 52 2c  db, TK_REGISTER,
58e0: 20 30 29 3b 0a 20 20 20 20 70 52 69 67 68 74 20   0);.    pRight 
58f0: 3d 20 73 71 6c 69 74 65 33 45 78 70 72 28 64 62  = sqlite3Expr(db
5900: 2c 20 54 4b 5f 43 4f 4c 55 4d 4e 2c 20 30 29 3b  , TK_COLUMN, 0);
5910: 0a 20 20 20 20 69 66 28 20 70 4c 65 66 74 20 26  .    if( pLeft &
5920: 26 20 70 52 69 67 68 74 20 29 7b 0a 20 20 20 20  & pRight ){.    
5930: 20 20 70 4c 65 66 74 2d 3e 69 54 61 62 6c 65 20    pLeft->iTable 
5940: 3d 20 72 65 67 44 61 74 61 3b 0a 20 20 20 20 20  = regData;.     
5950: 20 70 4c 65 66 74 2d 3e 61 66 66 69 6e 69 74 79   pLeft->affinity
5960: 20 3d 20 53 51 4c 49 54 45 5f 41 46 46 5f 49 4e   = SQLITE_AFF_IN
5970: 54 45 47 45 52 3b 0a 20 20 20 20 20 20 70 52 69  TEGER;.      pRi
5980: 67 68 74 2d 3e 69 54 61 62 6c 65 20 3d 20 70 53  ght->iTable = pS
5990: 72 63 2d 3e 61 5b 30 5d 2e 69 43 75 72 73 6f 72  rc->a[0].iCursor
59a0: 3b 0a 20 20 20 20 20 20 70 52 69 67 68 74 2d 3e  ;.      pRight->
59b0: 69 43 6f 6c 75 6d 6e 20 3d 20 2d 31 3b 0a 20 20  iColumn = -1;.  
59c0: 20 20 7d 0a 20 20 20 20 70 45 71 20 3d 20 73 71    }.    pEq = sq
59d0: 6c 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73  lite3PExpr(pPars
59e0: 65 2c 20 54 4b 5f 4e 45 2c 20 70 4c 65 66 74 2c  e, TK_NE, pLeft,
59f0: 20 70 52 69 67 68 74 2c 20 30 29 3b 0a 20 20 20   pRight, 0);.   
5a00: 20 70 57 68 65 72 65 20 3d 20 73 71 6c 69 74 65   pWhere = sqlite
5a10: 33 45 78 70 72 41 6e 64 28 64 62 2c 20 70 57 68  3ExprAnd(db, pWh
5a20: 65 72 65 2c 20 70 45 71 29 3b 0a 20 20 7d 0a 0a  ere, pEq);.  }..
5a30: 20 20 2f 2a 20 52 65 73 6f 6c 76 65 20 74 68 65    /* Resolve the
5a40: 20 72 65 66 65 72 65 6e 63 65 73 20 69 6e 20 74   references in t
5a50: 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 2e  he WHERE clause.
5a60: 20 2a 2f 0a 20 20 6d 65 6d 73 65 74 28 26 73 4e   */.  memset(&sN
5a70: 61 6d 65 43 6f 6e 74 65 78 74 2c 20 30 2c 20 73  ameContext, 0, s
5a80: 69 7a 65 6f 66 28 4e 61 6d 65 43 6f 6e 74 65 78  izeof(NameContex
5a90: 74 29 29 3b 0a 20 20 73 4e 61 6d 65 43 6f 6e 74  t));.  sNameCont
5aa0: 65 78 74 2e 70 53 72 63 4c 69 73 74 20 3d 20 70  ext.pSrcList = p
5ab0: 53 72 63 3b 0a 20 20 73 4e 61 6d 65 43 6f 6e 74  Src;.  sNameCont
5ac0: 65 78 74 2e 70 50 61 72 73 65 20 3d 20 70 50 61  ext.pParse = pPa
5ad0: 72 73 65 3b 0a 20 20 73 71 6c 69 74 65 33 52 65  rse;.  sqlite3Re
5ae0: 73 6f 6c 76 65 45 78 70 72 4e 61 6d 65 73 28 26  solveExprNames(&
5af0: 73 4e 61 6d 65 43 6f 6e 74 65 78 74 2c 20 70 57  sNameContext, pW
5b00: 68 65 72 65 29 3b 0a 0a 20 20 2f 2a 20 43 72 65  here);..  /* Cre
5b10: 61 74 65 20 56 44 42 45 20 74 6f 20 6c 6f 6f 70  ate VDBE to loop
5b20: 20 74 68 72 6f 75 67 68 20 74 68 65 20 65 6e 74   through the ent
5b30: 72 69 65 73 20 69 6e 20 70 53 72 63 20 74 68 61  ries in pSrc tha
5b40: 74 20 6d 61 74 63 68 20 74 68 65 20 57 48 45 52  t match the WHER
5b50: 45 0a 20 20 2a 2a 20 63 6c 61 75 73 65 2e 20 49  E.  ** clause. I
5b60: 66 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74  f the constraint
5b70: 20 69 73 20 6e 6f 74 20 64 65 66 65 72 72 65 64   is not deferred
5b80: 2c 20 74 68 72 6f 77 20 61 6e 20 65 78 63 65 70  , throw an excep
5b90: 74 69 6f 6e 20 66 6f 72 0a 20 20 2a 2a 20 65 61  tion for.  ** ea
5ba0: 63 68 20 72 6f 77 20 66 6f 75 6e 64 2e 20 4f 74  ch row found. Ot
5bb0: 68 65 72 77 69 73 65 2c 20 66 6f 72 20 64 65 66  herwise, for def
5bc0: 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69 6e 74  erred constraint
5bd0: 73 2c 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 65  s, increment the
5be0: 0a 20 20 2a 2a 20 64 65 66 65 72 72 65 64 20 63  .  ** deferred c
5bf0: 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e 74 65  onstraint counte
5c00: 72 20 62 79 20 6e 49 6e 63 72 20 66 6f 72 20 65  r by nIncr for e
5c10: 61 63 68 20 72 6f 77 20 73 65 6c 65 63 74 65 64  ach row selected
5c20: 2e 20 20 2a 2f 0a 20 20 70 57 49 6e 66 6f 20 3d  .  */.  pWInfo =
5c30: 20 73 71 6c 69 74 65 33 57 68 65 72 65 42 65 67   sqlite3WhereBeg
5c40: 69 6e 28 70 50 61 72 73 65 2c 20 70 53 72 63 2c  in(pParse, pSrc,
5c50: 20 70 57 68 65 72 65 2c 20 30 2c 20 30 29 3b 0a   pWhere, 0, 0);.
5c60: 20 20 69 66 28 20 6e 49 6e 63 72 3e 30 20 26 26    if( nIncr>0 &&
5c70: 20 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 72   pFKey->isDeferr
5c80: 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c  ed==0 ){.    sql
5c90: 69 74 65 33 50 61 72 73 65 54 6f 70 6c 65 76 65  ite3ParseTopleve
5ca0: 6c 28 70 50 61 72 73 65 29 2d 3e 6d 61 79 41 62  l(pParse)->mayAb
5cb0: 6f 72 74 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 73  ort = 1;.  }.  s
5cc0: 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 32  qlite3VdbeAddOp2
5cd0: 28 76 2c 20 4f 50 5f 46 6b 43 6f 75 6e 74 65 72  (v, OP_FkCounter
5ce0: 2c 20 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 72  , pFKey->isDefer
5cf0: 72 65 64 2c 20 6e 49 6e 63 72 29 3b 0a 20 20 69  red, nIncr);.  i
5d00: 66 28 20 70 57 49 6e 66 6f 20 29 7b 0a 20 20 20  f( pWInfo ){.   
5d10: 20 73 71 6c 69 74 65 33 57 68 65 72 65 45 6e 64   sqlite3WhereEnd
5d20: 28 70 57 49 6e 66 6f 29 3b 0a 20 20 7d 0a 0a 20  (pWInfo);.  }.. 
5d30: 20 2f 2a 20 43 6c 65 61 6e 20 75 70 20 74 68 65   /* Clean up the
5d40: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 63 6f   WHERE clause co
5d50: 6e 73 74 72 75 63 74 65 64 20 61 62 6f 76 65 2e  nstructed above.
5d60: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 45 78 70   */.  sqlite3Exp
5d70: 72 44 65 6c 65 74 65 28 64 62 2c 20 70 57 68 65  rDelete(db, pWhe
5d80: 72 65 29 3b 0a 20 20 69 66 28 20 69 46 6b 49 66  re);.  if( iFkIf
5d90: 5a 65 72 6f 20 29 7b 0a 20 20 20 20 73 71 6c 69  Zero ){.    sqli
5da0: 74 65 33 56 64 62 65 4a 75 6d 70 48 65 72 65 28  te3VdbeJumpHere(
5db0: 76 2c 20 69 46 6b 49 66 5a 65 72 6f 29 3b 0a 20  v, iFkIfZero);. 
5dc0: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73   }.}../*.** This
5dd0: 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e   function return
5de0: 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74  s a pointer to t
5df0: 68 65 20 68 65 61 64 20 6f 66 20 61 20 6c 69 6e  he head of a lin
5e00: 6b 65 64 20 6c 69 73 74 20 6f 66 20 46 4b 0a 2a  ked list of FK.*
5e10: 2a 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 66 6f  * constraints fo
5e20: 72 20 77 68 69 63 68 20 74 61 62 6c 65 20 70 54  r which table pT
5e30: 61 62 20 69 73 20 74 68 65 20 70 61 72 65 6e 74  ab is the parent
5e40: 20 74 61 62 6c 65 2e 20 46 6f 72 20 65 78 61 6d   table. For exam
5e50: 70 6c 65 2c 0a 2a 2a 20 67 69 76 65 6e 20 74 68  ple,.** given th
5e60: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 63 68 65  e following sche
5e70: 6d 61 3a 0a 2a 2a 0a 2a 2a 20 20 20 43 52 45 41  ma:.**.**   CREA
5e80: 54 45 20 54 41 42 4c 45 20 74 31 28 61 20 50 52  TE TABLE t1(a PR
5e90: 49 4d 41 52 59 20 4b 45 59 29 3b 0a 2a 2a 20 20  IMARY KEY);.**  
5ea0: 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 74 32   CREATE TABLE t2
5eb0: 28 62 20 52 45 46 45 52 45 4e 43 45 53 20 74 31  (b REFERENCES t1
5ec0: 28 61 29 3b 0a 2a 2a 0a 2a 2a 20 43 61 6c 6c 69  (a);.**.** Calli
5ed0: 6e 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  ng this function
5ee0: 20 77 69 74 68 20 74 61 62 6c 65 20 22 74 31 22   with table "t1"
5ef0: 20 61 73 20 61 6e 20 61 72 67 75 6d 65 6e 74 20   as an argument 
5f00: 72 65 74 75 72 6e 73 20 61 20 70 6f 69 6e 74 65  returns a pointe
5f10: 72 0a 2a 2a 20 74 6f 20 74 68 65 20 46 4b 65 79  r.** to the FKey
5f20: 20 73 74 72 75 63 74 75 72 65 20 72 65 70 72 65   structure repre
5f30: 73 65 6e 74 69 6e 67 20 74 68 65 20 66 6f 72 65  senting the fore
5f40: 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69  ign key constrai
5f50: 6e 74 20 6f 6e 20 74 61 62 6c 65 0a 2a 2a 20 22  nt on table.** "
5f60: 74 32 22 2e 20 43 61 6c 6c 69 6e 67 20 74 68 69  t2". Calling thi
5f70: 73 20 66 75 6e 63 74 69 6f 6e 20 77 69 74 68 20  s function with 
5f80: 22 74 32 22 20 61 73 20 74 68 65 20 61 72 67 75  "t2" as the argu
5f90: 6d 65 6e 74 20 77 6f 75 6c 64 20 72 65 74 75 72  ment would retur
5fa0: 6e 20 61 0a 2a 2a 20 4e 55 4c 4c 20 70 6f 69 6e  n a.** NULL poin
5fb0: 74 65 72 20 28 61 73 20 74 68 65 72 65 20 61 72  ter (as there ar
5fc0: 65 20 6e 6f 20 46 4b 20 63 6f 6e 73 74 72 61 69  e no FK constrai
5fd0: 6e 74 73 20 66 6f 72 20 77 68 69 63 68 20 74 32  nts for which t2
5fe0: 20 69 73 20 74 68 65 20 70 61 72 65 6e 74 0a 2a   is the parent.*
5ff0: 2a 20 74 61 62 6c 65 29 2e 0a 2a 2f 0a 46 4b 65  * table)..*/.FKe
6000: 79 20 2a 73 71 6c 69 74 65 33 46 6b 52 65 66 65  y *sqlite3FkRefe
6010: 72 65 6e 63 65 73 28 54 61 62 6c 65 20 2a 70 54  rences(Table *pT
6020: 61 62 29 7b 0a 20 20 69 6e 74 20 6e 4e 61 6d 65  ab){.  int nName
6030: 20 3d 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e   = sqlite3Strlen
6040: 33 30 28 70 54 61 62 2d 3e 7a 4e 61 6d 65 29 3b  30(pTab->zName);
6050: 0a 20 20 72 65 74 75 72 6e 20 28 46 4b 65 79 20  .  return (FKey 
6060: 2a 29 73 71 6c 69 74 65 33 48 61 73 68 46 69 6e  *)sqlite3HashFin
6070: 64 28 26 70 54 61 62 2d 3e 70 53 63 68 65 6d 61  d(&pTab->pSchema
6080: 2d 3e 66 6b 65 79 48 61 73 68 2c 20 70 54 61 62  ->fkeyHash, pTab
6090: 2d 3e 7a 4e 61 6d 65 2c 20 6e 4e 61 6d 65 29 3b  ->zName, nName);
60a0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 65 20 73 65  .}../*.** The se
60b0: 63 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 69 73  cond argument is
60c0: 20 61 20 54 72 69 67 67 65 72 20 73 74 72 75 63   a Trigger struc
60d0: 74 75 72 65 20 61 6c 6c 6f 63 61 74 65 64 20 62  ture allocated b
60e0: 79 20 74 68 65 20 0a 2a 2a 20 66 6b 41 63 74 69  y the .** fkActi
60f0: 6f 6e 54 72 69 67 67 65 72 28 29 20 72 6f 75 74  onTrigger() rout
6100: 69 6e 65 2e 20 54 68 69 73 20 66 75 6e 63 74 69  ine. This functi
6110: 6f 6e 20 64 65 6c 65 74 65 73 20 74 68 65 20 54  on deletes the T
6120: 72 69 67 67 65 72 20 73 74 72 75 63 74 75 72 65  rigger structure
6130: 0a 2a 2a 20 61 6e 64 20 61 6c 6c 20 6f 66 20 69  .** and all of i
6140: 74 73 20 73 75 62 2d 63 6f 6d 70 6f 6e 65 6e 74  ts sub-component
6150: 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 54 72 69  s..**.** The Tri
6160: 67 67 65 72 20 73 74 72 75 63 74 75 72 65 20 6f  gger structure o
6170: 72 20 61 6e 79 20 6f 66 20 69 74 73 20 73 75 62  r any of its sub
6180: 2d 63 6f 6d 70 6f 6e 65 6e 74 73 20 6d 61 79 20  -components may 
6190: 62 65 20 61 6c 6c 6f 63 61 74 65 64 20 66 72 6f  be allocated fro
61a0: 6d 0a 2a 2a 20 74 68 65 20 6c 6f 6f 6b 61 73 69  m.** the lookasi
61b0: 64 65 20 62 75 66 66 65 72 20 62 65 6c 6f 6e 67  de buffer belong
61c0: 69 6e 67 20 74 6f 20 64 61 74 61 62 61 73 65 20  ing to database 
61d0: 68 61 6e 64 6c 65 20 64 62 4d 65 6d 2e 0a 2a 2f  handle dbMem..*/
61e0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 6b 54  .static void fkT
61f0: 72 69 67 67 65 72 44 65 6c 65 74 65 28 73 71 6c  riggerDelete(sql
6200: 69 74 65 33 20 2a 64 62 4d 65 6d 2c 20 54 72 69  ite3 *dbMem, Tri
6210: 67 67 65 72 20 2a 70 29 7b 0a 20 20 69 66 28 20  gger *p){.  if( 
6220: 70 20 29 7b 0a 20 20 20 20 54 72 69 67 67 65 72  p ){.    Trigger
6230: 53 74 65 70 20 2a 70 53 74 65 70 20 3d 20 70 2d  Step *pStep = p-
6240: 3e 73 74 65 70 5f 6c 69 73 74 3b 0a 20 20 20 20  >step_list;.    
6250: 73 71 6c 69 74 65 33 45 78 70 72 44 65 6c 65 74  sqlite3ExprDelet
6260: 65 28 64 62 4d 65 6d 2c 20 70 53 74 65 70 2d 3e  e(dbMem, pStep->
6270: 70 57 68 65 72 65 29 3b 0a 20 20 20 20 73 71 6c  pWhere);.    sql
6280: 69 74 65 33 45 78 70 72 4c 69 73 74 44 65 6c 65  ite3ExprListDele
6290: 74 65 28 64 62 4d 65 6d 2c 20 70 53 74 65 70 2d  te(dbMem, pStep-
62a0: 3e 70 45 78 70 72 4c 69 73 74 29 3b 0a 20 20 20  >pExprList);.   
62b0: 20 73 71 6c 69 74 65 33 53 65 6c 65 63 74 44 65   sqlite3SelectDe
62c0: 6c 65 74 65 28 64 62 4d 65 6d 2c 20 70 53 74 65  lete(dbMem, pSte
62d0: 70 2d 3e 70 53 65 6c 65 63 74 29 3b 0a 20 20 20  p->pSelect);.   
62e0: 20 73 71 6c 69 74 65 33 45 78 70 72 44 65 6c 65   sqlite3ExprDele
62f0: 74 65 28 64 62 4d 65 6d 2c 20 70 2d 3e 70 57 68  te(dbMem, p->pWh
6300: 65 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  en);.    sqlite3
6310: 44 62 46 72 65 65 28 64 62 4d 65 6d 2c 20 70 29  DbFree(dbMem, p)
6320: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  ;.  }.}../*.** T
6330: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
6340: 63 61 6c 6c 65 64 20 74 6f 20 67 65 6e 65 72 61  called to genera
6350: 74 65 20 63 6f 64 65 20 74 68 61 74 20 72 75 6e  te code that run
6360: 73 20 77 68 65 6e 20 74 61 62 6c 65 20 70 54 61  s when table pTa
6370: 62 20 69 73 0a 2a 2a 20 62 65 69 6e 67 20 64 72  b is.** being dr
6380: 6f 70 70 65 64 20 66 72 6f 6d 20 74 68 65 20 64  opped from the d
6390: 61 74 61 62 61 73 65 2e 20 54 68 65 20 53 72 63  atabase. The Src
63a0: 4c 69 73 74 20 70 61 73 73 65 64 20 61 73 20 74  List passed as t
63b0: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65  he second argume
63c0: 6e 74 0a 2a 2a 20 74 6f 20 74 68 69 73 20 66 75  nt.** to this fu
63d0: 6e 63 74 69 6f 6e 20 63 6f 6e 74 61 69 6e 73 20  nction contains 
63e0: 61 20 73 69 6e 67 6c 65 20 65 6e 74 72 79 20 67  a single entry g
63f0: 75 61 72 61 6e 74 65 65 64 20 74 6f 20 72 65 73  uaranteed to res
6400: 6f 6c 76 65 20 74 6f 0a 2a 2a 20 74 61 62 6c 65  olve to.** table
6410: 20 70 54 61 62 2e 0a 2a 2a 0a 2a 2a 20 4e 6f 72   pTab..**.** Nor
6420: 6d 61 6c 6c 79 2c 20 6e 6f 20 63 6f 64 65 20 69  mally, no code i
6430: 73 20 72 65 71 75 69 72 65 64 2e 20 48 6f 77 65  s required. Howe
6440: 76 65 72 2c 20 69 66 20 65 69 74 68 65 72 0a 2a  ver, if either.*
6450: 2a 0a 2a 2a 20 20 20 28 61 29 20 54 68 65 20 74  *.**   (a) The t
6460: 61 62 6c 65 20 69 73 20 74 68 65 20 70 61 72 65  able is the pare
6470: 6e 74 20 74 61 62 6c 65 20 6f 66 20 61 20 46 4b  nt table of a FK
6480: 20 63 6f 6e 73 74 72 61 69 6e 74 2c 20 6f 72 0a   constraint, or.
6490: 2a 2a 20 20 20 28 62 29 20 54 68 65 20 74 61 62  **   (b) The tab
64a0: 6c 65 20 69 73 20 74 68 65 20 63 68 69 6c 64 20  le is the child 
64b0: 74 61 62 6c 65 20 6f 66 20 61 20 64 65 66 65 72  table of a defer
64c0: 72 65 64 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e  red FK constrain
64d0: 74 20 61 6e 64 20 69 74 20 69 73 0a 2a 2a 20 20  t and it is.**  
64e0: 20 20 20 20 20 64 65 74 65 72 6d 69 6e 65 64 20       determined 
64f0: 61 74 20 72 75 6e 74 69 6d 65 20 74 68 61 74 20  at runtime that 
6500: 74 68 65 72 65 20 61 72 65 20 6f 75 74 73 74 61  there are outsta
6510: 6e 64 69 6e 67 20 64 65 66 65 72 72 65 64 20 46  nding deferred F
6520: 4b 20 0a 2a 2a 20 20 20 20 20 20 20 63 6f 6e 73  K .**       cons
6530: 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e  traint violation
6540: 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73  s in the databas
6550: 65 2c 0a 2a 2a 0a 2a 2a 20 74 68 65 6e 20 74 68  e,.**.** then th
6560: 65 20 65 71 75 69 76 61 6c 65 6e 74 20 6f 66 20  e equivalent of 
6570: 22 44 45 4c 45 54 45 20 46 52 4f 4d 20 3c 74 62  "DELETE FROM <tb
6580: 6c 3e 22 20 69 73 20 65 78 65 63 75 74 65 64 20  l>" is executed 
6590: 62 65 66 6f 72 65 20 64 72 6f 70 70 69 6e 67 0a  before dropping.
65a0: 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 66 72 6f  ** the table fro
65b0: 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20  m the database. 
65c0: 54 72 69 67 67 65 72 73 20 61 72 65 20 64 69 73  Triggers are dis
65d0: 61 62 6c 65 64 20 77 68 69 6c 65 20 72 75 6e 6e  abled while runn
65e0: 69 6e 67 20 74 68 69 73 0a 2a 2a 20 44 45 4c 45  ing this.** DELE
65f0: 54 45 2c 20 62 75 74 20 66 6f 72 65 69 67 6e 20  TE, but foreign 
6600: 6b 65 79 20 61 63 74 69 6f 6e 73 20 61 72 65 20  key actions are 
6610: 6e 6f 74 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c  not..*/.void sql
6620: 69 74 65 33 46 6b 44 72 6f 70 54 61 62 6c 65 28  ite3FkDropTable(
6630: 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 53  Parse *pParse, S
6640: 72 63 4c 69 73 74 20 2a 70 4e 61 6d 65 2c 20 54  rcList *pName, T
6650: 61 62 6c 65 20 2a 70 54 61 62 29 7b 0a 20 20 73  able *pTab){.  s
6660: 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 50 61  qlite3 *db = pPa
6670: 72 73 65 2d 3e 64 62 3b 0a 20 20 69 66 28 20 28  rse->db;.  if( (
6680: 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54 45  db->flags&SQLITE
6690: 5f 46 6f 72 65 69 67 6e 4b 65 79 73 29 20 26 26  _ForeignKeys) &&
66a0: 20 21 49 73 56 69 72 74 75 61 6c 28 70 54 61 62   !IsVirtual(pTab
66b0: 29 20 26 26 20 21 70 54 61 62 2d 3e 70 53 65 6c  ) && !pTab->pSel
66c0: 65 63 74 20 29 7b 0a 20 20 20 20 69 6e 74 20 69  ect ){.    int i
66d0: 53 6b 69 70 20 3d 20 30 3b 0a 20 20 20 20 56 64  Skip = 0;.    Vd
66e0: 62 65 20 2a 76 20 3d 20 73 71 6c 69 74 65 33 47  be *v = sqlite3G
66f0: 65 74 56 64 62 65 28 70 50 61 72 73 65 29 3b 0a  etVdbe(pParse);.
6700: 0a 20 20 20 20 61 73 73 65 72 74 28 20 76 20 29  .    assert( v )
6710: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
6720: 20 20 20 2f 2a 20 56 44 42 45 20 68 61 73 20 61     /* VDBE has a
6730: 6c 72 65 61 64 79 20 62 65 65 6e 20 61 6c 6c 6f  lready been allo
6740: 63 61 74 65 64 20 2a 2f 0a 20 20 20 20 69 66 28  cated */.    if(
6750: 20 73 71 6c 69 74 65 33 46 6b 52 65 66 65 72 65   sqlite3FkRefere
6760: 6e 63 65 73 28 70 54 61 62 29 3d 3d 30 20 29 7b  nces(pTab)==0 ){
6770: 0a 20 20 20 20 20 20 2f 2a 20 53 65 61 72 63 68  .      /* Search
6780: 20 66 6f 72 20 61 20 64 65 66 65 72 72 65 64 20   for a deferred 
6790: 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73  foreign key cons
67a0: 74 72 61 69 6e 74 20 66 6f 72 20 77 68 69 63 68  traint for which
67b0: 20 74 68 69 73 20 74 61 62 6c 65 0a 20 20 20 20   this table.    
67c0: 20 20 2a 2a 20 69 73 20 74 68 65 20 63 68 69 6c    ** is the chil
67d0: 64 20 74 61 62 6c 65 2e 20 49 66 20 6f 6e 65 20  d table. If one 
67e0: 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 6e 64 2c  cannot be found,
67f0: 20 72 65 74 75 72 6e 20 77 69 74 68 6f 75 74 20   return without 
6800: 0a 20 20 20 20 20 20 2a 2a 20 67 65 6e 65 72 61  .      ** genera
6810: 74 69 6e 67 20 61 6e 79 20 56 44 42 45 20 63 6f  ting any VDBE co
6820: 64 65 2e 20 49 66 20 6f 6e 65 20 63 61 6e 20 62  de. If one can b
6830: 65 20 66 6f 75 6e 64 2c 20 74 68 65 6e 20 6a 75  e found, then ju
6840: 6d 70 20 6f 76 65 72 0a 20 20 20 20 20 20 2a 2a  mp over.      **
6850: 20 74 68 65 20 65 6e 74 69 72 65 20 44 45 4c 45   the entire DELE
6860: 54 45 20 69 66 20 74 68 65 72 65 20 61 72 65 20  TE if there are 
6870: 6e 6f 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 64  no outstanding d
6880: 65 66 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69  eferred constrai
6890: 6e 74 73 0a 20 20 20 20 20 20 2a 2a 20 77 68 65  nts.      ** whe
68a0: 6e 20 74 68 69 73 20 73 74 61 74 65 6d 65 6e 74  n this statement
68b0: 20 69 73 20 72 75 6e 2e 20 20 2a 2f 0a 20 20 20   is run.  */.   
68c0: 20 20 20 46 4b 65 79 20 2a 70 3b 0a 20 20 20 20     FKey *p;.    
68d0: 20 20 66 6f 72 28 70 3d 70 54 61 62 2d 3e 70 46    for(p=pTab->pF
68e0: 4b 65 79 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65  Key; p; p=p->pNe
68f0: 78 74 46 72 6f 6d 29 7b 0a 20 20 20 20 20 20 20  xtFrom){.       
6900: 20 69 66 28 20 70 2d 3e 69 73 44 65 66 65 72 72   if( p->isDeferr
6910: 65 64 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20  ed ) break;.    
6920: 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 21 70    }.      if( !p
6930: 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 20 20 20   ) return;.     
6940: 20 69 53 6b 69 70 20 3d 20 73 71 6c 69 74 65 33   iSkip = sqlite3
6950: 56 64 62 65 4d 61 6b 65 4c 61 62 65 6c 28 76 29  VdbeMakeLabel(v)
6960: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  ;.      sqlite3V
6970: 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f  dbeAddOp2(v, OP_
6980: 46 6b 49 66 5a 65 72 6f 2c 20 31 2c 20 69 53 6b  FkIfZero, 1, iSk
6990: 69 70 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20  ip);.    }..    
69a0: 70 50 61 72 73 65 2d 3e 64 69 73 61 62 6c 65 54  pParse->disableT
69b0: 72 69 67 67 65 72 73 20 3d 20 31 3b 0a 20 20 20  riggers = 1;.   
69c0: 20 73 71 6c 69 74 65 33 44 65 6c 65 74 65 46 72   sqlite3DeleteFr
69d0: 6f 6d 28 70 50 61 72 73 65 2c 20 73 71 6c 69 74  om(pParse, sqlit
69e0: 65 33 53 72 63 4c 69 73 74 44 75 70 28 64 62 2c  e3SrcListDup(db,
69f0: 20 70 4e 61 6d 65 2c 20 30 29 2c 20 30 29 3b 0a   pName, 0), 0);.
6a00: 20 20 20 20 70 50 61 72 73 65 2d 3e 64 69 73 61      pParse->disa
6a10: 62 6c 65 54 72 69 67 67 65 72 73 20 3d 20 30 3b  bleTriggers = 0;
6a20: 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20  ..    /* If the 
6a30: 44 45 4c 45 54 45 20 68 61 73 20 67 65 6e 65 72  DELETE has gener
6a40: 61 74 65 64 20 69 6d 6d 65 64 69 61 74 65 20 66  ated immediate f
6a50: 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74  oreign key const
6a60: 72 61 69 6e 74 20 0a 20 20 20 20 2a 2a 20 76 69  raint .    ** vi
6a70: 6f 6c 61 74 69 6f 6e 73 2c 20 68 61 6c 74 20 74  olations, halt t
6a80: 68 65 20 56 44 42 45 20 61 6e 64 20 72 65 74 75  he VDBE and retu
6a90: 72 6e 20 61 6e 20 65 72 72 6f 72 20 61 74 20 74  rn an error at t
6aa0: 68 69 73 20 70 6f 69 6e 74 2c 20 62 65 66 6f 72  his point, befor
6ab0: 65 0a 20 20 20 20 2a 2a 20 61 6e 79 20 6d 6f 64  e.    ** any mod
6ac0: 69 66 69 63 61 74 69 6f 6e 73 20 74 6f 20 74 68  ifications to th
6ad0: 65 20 73 63 68 65 6d 61 20 61 72 65 20 6d 61 64  e schema are mad
6ae0: 65 2e 20 54 68 69 73 20 69 73 20 62 65 63 61 75  e. This is becau
6af0: 73 65 20 73 74 61 74 65 6d 65 6e 74 0a 20 20 20  se statement.   
6b00: 20 2a 2a 20 74 72 61 6e 73 61 63 74 69 6f 6e 73   ** transactions
6b10: 20 61 72 65 20 6e 6f 74 20 61 62 6c 65 20 74 6f   are not able to
6b20: 20 72 6f 6c 6c 62 61 63 6b 20 73 63 68 65 6d 61   rollback schema
6b30: 20 63 68 61 6e 67 65 73 2e 20 20 2a 2f 0a 20 20   changes.  */.  
6b40: 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64    sqlite3VdbeAdd
6b50: 4f 70 32 28 76 2c 20 4f 50 5f 46 6b 49 66 5a 65  Op2(v, OP_FkIfZe
6b60: 72 6f 2c 20 30 2c 20 73 71 6c 69 74 65 33 56 64  ro, 0, sqlite3Vd
6b70: 62 65 43 75 72 72 65 6e 74 41 64 64 72 28 76 29  beCurrentAddr(v)
6b80: 2b 32 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  +2);.    sqlite3
6b90: 48 61 6c 74 43 6f 6e 73 74 72 61 69 6e 74 28 0a  HaltConstraint(.
6ba0: 20 20 20 20 20 20 20 20 70 50 61 72 73 65 2c 20          pParse, 
6bb0: 4f 45 5f 41 62 6f 72 74 2c 20 22 66 6f 72 65 69  OE_Abort, "forei
6bc0: 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e  gn key constrain
6bd0: 74 20 66 61 69 6c 65 64 22 2c 20 50 34 5f 53 54  t failed", P4_ST
6be0: 41 54 49 43 0a 20 20 20 20 29 3b 0a 0a 20 20 20  ATIC.    );..   
6bf0: 20 69 66 28 20 69 53 6b 69 70 20 29 7b 0a 20 20   if( iSkip ){.  
6c00: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 52      sqlite3VdbeR
6c10: 65 73 6f 6c 76 65 4c 61 62 65 6c 28 76 2c 20 69  esolveLabel(v, i
6c20: 53 6b 69 70 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  Skip);.    }.  }
6c30: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
6c40: 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65  unction is calle
6c50: 64 20 77 68 65 6e 20 69 6e 73 65 72 74 69 6e 67  d when inserting
6c60: 2c 20 64 65 6c 65 74 69 6e 67 20 6f 72 20 75 70  , deleting or up
6c70: 64 61 74 69 6e 67 20 61 20 72 6f 77 20 6f 66 0a  dating a row of.
6c80: 2a 2a 20 74 61 62 6c 65 20 70 54 61 62 20 74 6f  ** table pTab to
6c90: 20 67 65 6e 65 72 61 74 65 20 56 44 42 45 20 63   generate VDBE c
6ca0: 6f 64 65 20 74 6f 20 70 65 72 66 6f 72 6d 20 66  ode to perform f
6cb0: 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74  oreign key const
6cc0: 72 61 69 6e 74 20 0a 2a 2a 20 70 72 6f 63 65 73  raint .** proces
6cd0: 73 69 6e 67 20 66 6f 72 20 74 68 65 20 6f 70 65  sing for the ope
6ce0: 72 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 46 6f  ration..**.** Fo
6cf0: 72 20 61 20 44 45 4c 45 54 45 20 6f 70 65 72 61  r a DELETE opera
6d00: 74 69 6f 6e 2c 20 70 61 72 61 6d 65 74 65 72 20  tion, parameter 
6d10: 72 65 67 4f 6c 64 20 69 73 20 70 61 73 73 65 64  regOld is passed
6d20: 20 74 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68   the index of th
6d30: 65 0a 2a 2a 20 66 69 72 73 74 20 72 65 67 69 73  e.** first regis
6d40: 74 65 72 20 69 6e 20 61 6e 20 61 72 72 61 79 20  ter in an array 
6d50: 6f 66 20 28 70 54 61 62 2d 3e 6e 43 6f 6c 2b 31  of (pTab->nCol+1
6d60: 29 20 72 65 67 69 73 74 65 72 73 20 63 6f 6e 74  ) registers cont
6d70: 61 69 6e 69 6e 67 20 74 68 65 0a 2a 2a 20 72 6f  aining the.** ro
6d80: 77 69 64 20 6f 66 20 74 68 65 20 72 6f 77 20 62  wid of the row b
6d90: 65 69 6e 67 20 64 65 6c 65 74 65 64 2c 20 66 6f  eing deleted, fo
6da0: 6c 6c 6f 77 65 64 20 62 79 20 65 61 63 68 20 6f  llowed by each o
6db0: 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 76 61 6c  f the column val
6dc0: 75 65 73 0a 2a 2a 20 6f 66 20 74 68 65 20 72 6f  ues.** of the ro
6dd0: 77 20 62 65 69 6e 67 20 64 65 6c 65 74 65 64 2c  w being deleted,
6de0: 20 66 72 6f 6d 20 6c 65 66 74 20 74 6f 20 72 69   from left to ri
6df0: 67 68 74 2e 20 50 61 72 61 6d 65 74 65 72 20 72  ght. Parameter r
6e00: 65 67 4e 65 77 20 69 73 20 70 61 73 73 65 64 0a  egNew is passed.
6e10: 2a 2a 20 7a 65 72 6f 20 69 6e 20 74 68 69 73 20  ** zero in this 
6e20: 63 61 73 65 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20  case..**.** For 
6e30: 61 6e 20 49 4e 53 45 52 54 20 6f 70 65 72 61 74  an INSERT operat
6e40: 69 6f 6e 2c 20 72 65 67 4f 6c 64 20 69 73 20 70  ion, regOld is p
6e50: 61 73 73 65 64 20 7a 65 72 6f 20 61 6e 64 20 72  assed zero and r
6e60: 65 67 4e 65 77 20 69 73 20 70 61 73 73 65 64 20  egNew is passed 
6e70: 74 68 65 0a 2a 2a 20 66 69 72 73 74 20 72 65 67  the.** first reg
6e80: 69 73 74 65 72 20 6f 66 20 61 6e 20 61 72 72 61  ister of an arra
6e90: 79 20 6f 66 20 28 70 54 61 62 2d 3e 6e 43 6f 6c  y of (pTab->nCol
6ea0: 2b 31 29 20 72 65 67 69 73 74 65 72 73 20 63 6f  +1) registers co
6eb0: 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 6e 65 77  ntaining the new
6ec0: 0a 2a 2a 20 72 6f 77 20 64 61 74 61 2e 0a 2a 2a  .** row data..**
6ed0: 0a 2a 2a 20 46 6f 72 20 61 6e 20 55 50 44 41 54  .** For an UPDAT
6ee0: 45 20 6f 70 65 72 61 74 69 6f 6e 2c 20 74 68 69  E operation, thi
6ef0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61  s function is ca
6f00: 6c 6c 65 64 20 74 77 69 63 65 2e 20 4f 6e 63 65  lled twice. Once
6f10: 20 62 65 66 6f 72 65 0a 2a 2a 20 74 68 65 20 6f   before.** the o
6f20: 72 69 67 69 6e 61 6c 20 72 65 63 6f 72 64 20 69  riginal record i
6f30: 73 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 74  s deleted from t
6f40: 68 65 20 74 61 62 6c 65 20 75 73 69 6e 67 20 74  he table using t
6f50: 68 65 20 63 61 6c 6c 69 6e 67 20 63 6f 6e 76 65  he calling conve
6f60: 6e 74 69 6f 6e 0a 2a 2a 20 64 65 73 63 72 69 62  ntion.** describ
6f70: 65 64 20 66 6f 72 20 44 45 4c 45 54 45 2e 20 54  ed for DELETE. T
6f80: 68 65 6e 20 61 67 61 69 6e 20 61 66 74 65 72 20  hen again after 
6f90: 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 72 65 63  the original rec
6fa0: 6f 72 64 20 69 73 20 64 65 6c 65 74 65 64 0a 2a  ord is deleted.*
6fb0: 2a 20 62 75 74 20 62 65 66 6f 72 65 20 74 68 65  * but before the
6fc0: 20 6e 65 77 20 72 65 63 6f 72 64 20 69 73 20 69   new record is i
6fd0: 6e 73 65 72 74 65 64 20 75 73 69 6e 67 20 74 68  nserted using th
6fe0: 65 20 49 4e 53 45 52 54 20 63 6f 6e 76 65 6e 74  e INSERT convent
6ff0: 69 6f 6e 2e 20 49 6e 0a 2a 2a 20 62 6f 74 68 20  ion. In.** both 
7000: 63 61 73 65 73 20 70 61 72 61 6d 65 74 65 72 20  cases parameter 
7010: 70 43 68 61 6e 67 65 73 20 69 73 20 70 61 73 73  pChanges is pass
7020: 65 64 20 74 68 65 20 6c 69 73 74 20 6f 66 20 63  ed the list of c
7030: 6f 6c 75 6d 6e 73 20 62 65 69 6e 67 20 0a 2a 2a  olumns being .**
7040: 20 75 70 64 61 74 65 64 20 62 79 20 74 68 65 20   updated by the 
7050: 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f  statement..*/.vo
7060: 69 64 20 73 71 6c 69 74 65 33 46 6b 43 68 65 63  id sqlite3FkChec
7070: 6b 28 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72  k(.  Parse *pPar
7080: 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  se,             
7090: 20 20 20 20 20 2f 2a 20 50 61 72 73 65 20 63 6f       /* Parse co
70a0: 6e 74 65 78 74 20 2a 2f 0a 20 20 54 61 62 6c 65  ntext */.  Table
70b0: 20 2a 70 54 61 62 2c 20 20 20 20 20 20 20 20 20   *pTab,         
70c0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f             /* Ro
70d0: 77 20 69 73 20 62 65 69 6e 67 20 64 65 6c 65 74  w is being delet
70e0: 65 64 20 66 72 6f 6d 20 74 68 69 73 20 74 61 62  ed from this tab
70f0: 6c 65 20 2a 2f 20 0a 20 20 45 78 70 72 4c 69 73  le */ .  ExprLis
7100: 74 20 2a 70 43 68 61 6e 67 65 73 2c 20 20 20 20  t *pChanges,    
7110: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 68 61 6e           /* Chan
7120: 67 65 64 20 63 6f 6c 75 6d 6e 73 20 69 66 20 74  ged columns if t
7130: 68 69 73 20 69 73 20 61 6e 20 55 50 44 41 54 45  his is an UPDATE
7140: 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 4f 6c 64   */.  int regOld
7150: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,               
7160: 20 20 20 20 20 20 2f 2a 20 50 72 65 76 69 6f 75        /* Previou
7170: 73 20 72 6f 77 20 64 61 74 61 20 69 73 20 73 74  s row data is st
7180: 6f 72 65 64 20 68 65 72 65 20 2a 2f 0a 20 20 69  ored here */.  i
7190: 6e 74 20 72 65 67 4e 65 77 20 20 20 20 20 20 20  nt regNew       
71a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
71b0: 2a 20 4e 65 77 20 72 6f 77 20 64 61 74 61 20 69  * New row data i
71c0: 73 20 73 74 6f 72 65 64 20 68 65 72 65 20 2a 2f  s stored here */
71d0: 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  .){.  sqlite3 *d
71e0: 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 20  b = pParse->db; 
71f0: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73        /* Databas
7200: 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 56 64  e handle */.  Vd
7210: 62 65 20 2a 76 3b 20 20 20 20 20 20 20 20 20 20  be *v;          
7220: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
7230: 20 56 4d 20 74 6f 20 77 72 69 74 65 20 63 6f 64   VM to write cod
7240: 65 20 74 6f 20 2a 2f 0a 20 20 46 4b 65 79 20 2a  e to */.  FKey *
7250: 70 46 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20  pFKey;          
7260: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 55 73 65            /* Use
7270: 64 20 74 6f 20 69 74 65 72 61 74 65 20 74 68 72  d to iterate thr
7280: 6f 75 67 68 20 46 4b 73 20 2a 2f 0a 20 20 69 6e  ough FKs */.  in
7290: 74 20 69 44 62 3b 20 20 20 20 20 20 20 20 20 20  t iDb;          
72a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
72b0: 20 49 6e 64 65 78 20 6f 66 20 64 61 74 61 62 61   Index of databa
72c0: 73 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 70 54  se containing pT
72d0: 61 62 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  ab */.  const ch
72e0: 61 72 20 2a 7a 44 62 3b 20 20 20 20 20 20 20 20  ar *zDb;        
72f0: 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20          /* Name 
7300: 6f 66 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74  of database cont
7310: 61 69 6e 69 6e 67 20 70 54 61 62 20 2a 2f 0a 20  aining pTab */. 
7320: 20 69 6e 74 20 69 73 49 67 6e 6f 72 65 45 72 72   int isIgnoreErr
7330: 6f 72 73 20 3d 20 70 50 61 72 73 65 2d 3e 64 69  ors = pParse->di
7340: 73 61 62 6c 65 54 72 69 67 67 65 72 73 3b 0a 0a  sableTriggers;..
7350: 20 20 2f 2a 20 45 78 61 63 74 6c 79 20 6f 6e 65    /* Exactly one
7360: 20 6f 66 20 72 65 67 4f 6c 64 20 61 6e 64 20 72   of regOld and r
7370: 65 67 4e 65 77 20 73 68 6f 75 6c 64 20 62 65 20  egNew should be 
7380: 6e 6f 6e 2d 7a 65 72 6f 2e 20 2a 2f 0a 20 20 61  non-zero. */.  a
7390: 73 73 65 72 74 28 20 28 72 65 67 4f 6c 64 3d 3d  ssert( (regOld==
73a0: 30 29 21 3d 28 72 65 67 4e 65 77 3d 3d 30 29 20  0)!=(regNew==0) 
73b0: 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 66 6f 72 65  );..  /* If fore
73c0: 69 67 6e 2d 6b 65 79 73 20 61 72 65 20 64 69 73  ign-keys are dis
73d0: 61 62 6c 65 64 2c 20 74 68 69 73 20 66 75 6e 63  abled, this func
73e0: 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 2e  tion is a no-op.
73f0: 20 2a 2f 0a 20 20 69 66 28 20 28 64 62 2d 3e 66   */.  if( (db->f
7400: 6c 61 67 73 26 53 51 4c 49 54 45 5f 46 6f 72 65  lags&SQLITE_Fore
7410: 69 67 6e 4b 65 79 73 29 3d 3d 30 20 29 20 72 65  ignKeys)==0 ) re
7420: 74 75 72 6e 3b 0a 0a 20 20 76 20 3d 20 73 71 6c  turn;..  v = sql
7430: 69 74 65 33 47 65 74 56 64 62 65 28 70 50 61 72  ite3GetVdbe(pPar
7440: 73 65 29 3b 0a 20 20 69 44 62 20 3d 20 73 71 6c  se);.  iDb = sql
7450: 69 74 65 33 53 63 68 65 6d 61 54 6f 49 6e 64 65  ite3SchemaToInde
7460: 78 28 64 62 2c 20 70 54 61 62 2d 3e 70 53 63 68  x(db, pTab->pSch
7470: 65 6d 61 29 3b 0a 20 20 7a 44 62 20 3d 20 64 62  ema);.  zDb = db
7480: 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65  ->aDb[iDb].zName
7490: 3b 0a 0a 20 20 2f 2a 20 4c 6f 6f 70 20 74 68 72  ;..  /* Loop thr
74a0: 6f 75 67 68 20 61 6c 6c 20 74 68 65 20 66 6f 72  ough all the for
74b0: 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61  eign key constra
74c0: 69 6e 74 73 20 66 6f 72 20 77 68 69 63 68 20 70  ints for which p
74d0: 54 61 62 20 69 73 20 74 68 65 0a 20 20 2a 2a 20  Tab is the.  ** 
74e0: 63 68 69 6c 64 20 74 61 62 6c 65 20 28 74 68 65  child table (the
74f0: 20 74 61 62 6c 65 20 74 68 61 74 20 74 68 65 20   table that the 
7500: 66 6f 72 65 69 67 6e 20 6b 65 79 20 64 65 66 69  foreign key defi
7510: 6e 69 74 69 6f 6e 20 69 73 20 70 61 72 74 20 6f  nition is part o
7520: 66 29 2e 20 20 2a 2f 0a 20 20 66 6f 72 28 70 46  f).  */.  for(pF
7530: 4b 65 79 3d 70 54 61 62 2d 3e 70 46 4b 65 79 3b  Key=pTab->pFKey;
7540: 20 70 46 4b 65 79 3b 20 70 46 4b 65 79 3d 70 46   pFKey; pFKey=pF
7550: 4b 65 79 2d 3e 70 4e 65 78 74 46 72 6f 6d 29 7b  Key->pNextFrom){
7560: 0a 20 20 20 20 54 61 62 6c 65 20 2a 70 54 6f 3b  .    Table *pTo;
7570: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
7580: 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 74 61 62     /* Parent tab
7590: 6c 65 20 6f 66 20 66 6f 72 65 69 67 6e 20 6b 65  le of foreign ke
75a0: 79 20 70 46 4b 65 79 20 2a 2f 0a 20 20 20 20 49  y pFKey */.    I
75b0: 6e 64 65 78 20 2a 70 49 64 78 20 3d 20 30 3b 20  ndex *pIdx = 0; 
75c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
75d0: 49 6e 64 65 78 20 6f 6e 20 6b 65 79 20 63 6f 6c  Index on key col
75e0: 75 6d 6e 73 20 69 6e 20 70 54 6f 20 2a 2f 0a 20  umns in pTo */. 
75f0: 20 20 20 69 6e 74 20 2a 61 69 46 72 65 65 20 3d     int *aiFree =
7600: 20 30 3b 0a 20 20 20 20 69 6e 74 20 2a 61 69 43   0;.    int *aiC
7610: 6f 6c 3b 0a 20 20 20 20 69 6e 74 20 69 43 6f 6c  ol;.    int iCol
7620: 3b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 0a 20 20  ;.    int i;..  
7630: 20 20 2f 2a 20 46 69 6e 64 20 74 68 65 20 70 61    /* Find the pa
7640: 72 65 6e 74 20 74 61 62 6c 65 20 6f 66 20 74 68  rent table of th
7650: 69 73 20 66 6f 72 65 69 67 6e 20 6b 65 79 2e 20  is foreign key. 
7660: 41 6c 73 6f 20 66 69 6e 64 20 61 20 75 6e 69 71  Also find a uniq
7670: 75 65 20 69 6e 64 65 78 20 0a 20 20 20 20 2a 2a  ue index .    **
7680: 20 6f 6e 20 74 68 65 20 70 61 72 65 6e 74 20 6b   on the parent k
7690: 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68  ey columns in th
76a0: 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 2e 20  e parent table. 
76b0: 49 66 20 65 69 74 68 65 72 20 6f 66 20 74 68 65  If either of the
76c0: 73 65 20 0a 20 20 20 20 2a 2a 20 73 63 68 65 6d  se .    ** schem
76d0: 61 20 69 74 65 6d 73 20 63 61 6e 6e 6f 74 20 62  a items cannot b
76e0: 65 20 6c 6f 63 61 74 65 64 2c 20 73 65 74 20 61  e located, set a
76f0: 6e 20 65 72 72 6f 72 20 69 6e 20 70 50 61 72 73  n error in pPars
7700: 65 20 61 6e 64 20 72 65 74 75 72 6e 20 0a 20 20  e and return .  
7710: 20 20 2a 2a 20 65 61 72 6c 79 2e 20 20 2a 2f 0a    ** early.  */.
7720: 20 20 20 20 69 66 28 20 70 50 61 72 73 65 2d 3e      if( pParse->
7730: 64 69 73 61 62 6c 65 54 72 69 67 67 65 72 73 20  disableTriggers 
7740: 29 7b 0a 20 20 20 20 20 20 70 54 6f 20 3d 20 73  ){.      pTo = s
7750: 71 6c 69 74 65 33 46 69 6e 64 54 61 62 6c 65 28  qlite3FindTable(
7760: 64 62 2c 20 70 46 4b 65 79 2d 3e 7a 54 6f 2c 20  db, pFKey->zTo, 
7770: 7a 44 62 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b  zDb);.    }else{
7780: 0a 20 20 20 20 20 20 70 54 6f 20 3d 20 73 71 6c  .      pTo = sql
7790: 69 74 65 33 4c 6f 63 61 74 65 54 61 62 6c 65 28  ite3LocateTable(
77a0: 70 50 61 72 73 65 2c 20 30 2c 20 70 46 4b 65 79  pParse, 0, pFKey
77b0: 2d 3e 7a 54 6f 2c 20 7a 44 62 29 3b 0a 20 20 20  ->zTo, zDb);.   
77c0: 20 7d 0a 20 20 20 20 69 66 28 20 21 70 54 6f 20   }.    if( !pTo 
77d0: 7c 7c 20 6c 6f 63 61 74 65 46 6b 65 79 49 6e 64  || locateFkeyInd
77e0: 65 78 28 70 50 61 72 73 65 2c 20 70 54 6f 2c 20  ex(pParse, pTo, 
77f0: 70 46 4b 65 79 2c 20 26 70 49 64 78 2c 20 26 61  pFKey, &pIdx, &a
7800: 69 46 72 65 65 29 20 29 7b 0a 20 20 20 20 20 20  iFree) ){.      
7810: 69 66 28 20 21 69 73 49 67 6e 6f 72 65 45 72 72  if( !isIgnoreErr
7820: 6f 72 73 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f  ors || db->mallo
7830: 63 46 61 69 6c 65 64 20 29 20 72 65 74 75 72 6e  cFailed ) return
7840: 3b 0a 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65  ;.      continue
7850: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65  ;.    }.    asse
7860: 72 74 28 20 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3d  rt( pFKey->nCol=
7870: 3d 31 20 7c 7c 20 28 61 69 46 72 65 65 20 26 26  =1 || (aiFree &&
7880: 20 70 49 64 78 29 20 29 3b 0a 0a 20 20 20 20 2f   pIdx) );..    /
7890: 2a 20 49 66 20 74 68 65 20 6b 65 79 20 64 6f 65  * If the key doe
78a0: 73 20 6e 6f 74 20 6f 76 65 72 6c 61 70 20 77 69  s not overlap wi
78b0: 74 68 20 74 68 65 20 70 43 68 61 6e 67 65 73 20  th the pChanges 
78c0: 6c 69 73 74 2c 20 73 6b 69 70 20 74 68 69 73 20  list, skip this 
78d0: 46 4b 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 70  FK. */.    if( p
78e0: 43 68 61 6e 67 65 73 20 29 7b 0a 20 20 20 20 20  Changes ){.     
78f0: 20 2f 2a 20 54 4f 44 4f 20 2a 2f 0a 20 20 20 20   /* TODO */.    
7900: 7d 0a 0a 20 20 20 20 69 66 28 20 61 69 46 72 65  }..    if( aiFre
7910: 65 20 29 7b 0a 20 20 20 20 20 20 61 69 43 6f 6c  e ){.      aiCol
7920: 20 3d 20 61 69 46 72 65 65 3b 0a 20 20 20 20 7d   = aiFree;.    }
7930: 65 6c 73 65 7b 0a 20 20 20 20 20 20 69 43 6f 6c  else{.      iCol
7940: 20 3d 20 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 30   = pFKey->aCol[0
7950: 5d 2e 69 46 72 6f 6d 3b 0a 20 20 20 20 20 20 61  ].iFrom;.      a
7960: 69 43 6f 6c 20 3d 20 26 69 43 6f 6c 3b 0a 20 20  iCol = &iCol;.  
7970: 20 20 7d 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b    }.    for(i=0;
7980: 20 69 3c 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3b 20   i<pFKey->nCol; 
7990: 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20  i++){.      if( 
79a0: 61 69 43 6f 6c 5b 69 5d 3d 3d 70 54 61 62 2d 3e  aiCol[i]==pTab->
79b0: 69 50 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 20  iPKey ){.       
79c0: 20 61 69 43 6f 6c 5b 69 5d 20 3d 20 2d 31 3b 0a   aiCol[i] = -1;.
79d0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20        }.    }.. 
79e0: 20 20 20 2f 2a 20 54 61 6b 65 20 61 20 73 68 61     /* Take a sha
79f0: 72 65 64 2d 63 61 63 68 65 20 61 64 76 69 73 6f  red-cache adviso
7a00: 72 79 20 72 65 61 64 2d 6c 6f 63 6b 20 6f 6e 20  ry read-lock on 
7a10: 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65  the parent table
7a20: 2e 20 41 6c 6c 6f 63 61 74 65 20 0a 20 20 20 20  . Allocate .    
7a30: 2a 2a 20 61 20 63 75 72 73 6f 72 20 74 6f 20 75  ** a cursor to u
7a40: 73 65 20 74 6f 20 73 65 61 72 63 68 20 74 68 65  se to search the
7a50: 20 75 6e 69 71 75 65 20 69 6e 64 65 78 20 6f 6e   unique index on
7a60: 20 74 68 65 20 70 61 72 65 6e 74 20 6b 65 79 20   the parent key 
7a70: 63 6f 6c 75 6d 6e 73 20 0a 20 20 20 20 2a 2a 20  columns .    ** 
7a80: 69 6e 20 74 68 65 20 70 61 72 65 6e 74 20 74 61  in the parent ta
7a90: 62 6c 65 2e 20 20 2a 2f 0a 20 20 20 20 73 71 6c  ble.  */.    sql
7aa0: 69 74 65 33 54 61 62 6c 65 4c 6f 63 6b 28 70 50  ite3TableLock(pP
7ab0: 61 72 73 65 2c 20 69 44 62 2c 20 70 54 6f 2d 3e  arse, iDb, pTo->
7ac0: 74 6e 75 6d 2c 20 30 2c 20 70 54 6f 2d 3e 7a 4e  tnum, 0, pTo->zN
7ad0: 61 6d 65 29 3b 0a 20 20 20 20 70 50 61 72 73 65  ame);.    pParse
7ae0: 2d 3e 6e 54 61 62 2b 2b 3b 0a 0a 20 20 20 20 69  ->nTab++;..    i
7af0: 66 28 20 72 65 67 4f 6c 64 21 3d 30 20 29 7b 0a  f( regOld!=0 ){.
7b00: 20 20 20 20 20 20 2f 2a 20 41 20 72 6f 77 20 69        /* A row i
7b10: 73 20 62 65 69 6e 67 20 72 65 6d 6f 76 65 64 20  s being removed 
7b20: 66 72 6f 6d 20 74 68 65 20 63 68 69 6c 64 20 74  from the child t
7b30: 61 62 6c 65 2e 20 53 65 61 72 63 68 20 66 6f 72  able. Search for
7b40: 20 74 68 65 20 70 61 72 65 6e 74 2e 0a 20 20 20   the parent..   
7b50: 20 20 20 2a 2a 20 49 66 20 74 68 65 20 70 61 72     ** If the par
7b60: 65 6e 74 20 64 6f 65 73 20 6e 6f 74 20 65 78 69  ent does not exi
7b70: 73 74 2c 20 72 65 6d 6f 76 69 6e 67 20 74 68 65  st, removing the
7b80: 20 63 68 69 6c 64 20 72 6f 77 20 72 65 73 6f 6c   child row resol
7b90: 76 65 73 20 61 6e 20 0a 20 20 20 20 20 20 2a 2a  ves an .      **
7ba0: 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 66 6f 72   outstanding for
7bb0: 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61  eign key constra
7bc0: 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 2e 20 2a  int violation. *
7bd0: 2f 0a 20 20 20 20 20 20 66 6b 4c 6f 6f 6b 75 70  /.      fkLookup
7be0: 50 61 72 65 6e 74 28 70 50 61 72 73 65 2c 20 69  Parent(pParse, i
7bf0: 44 62 2c 20 70 54 6f 2c 20 70 49 64 78 2c 20 70  Db, pTo, pIdx, p
7c00: 46 4b 65 79 2c 20 61 69 43 6f 6c 2c 20 72 65 67  FKey, aiCol, reg
7c10: 4f 6c 64 2c 20 2d 31 29 3b 0a 20 20 20 20 7d 0a  Old, -1);.    }.
7c20: 20 20 20 20 69 66 28 20 72 65 67 4e 65 77 21 3d      if( regNew!=
7c30: 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 41 20  0 ){.      /* A 
7c40: 72 6f 77 20 69 73 20 62 65 69 6e 67 20 61 64 64  row is being add
7c50: 65 64 20 74 6f 20 74 68 65 20 63 68 69 6c 64 20  ed to the child 
7c60: 74 61 62 6c 65 2e 20 49 66 20 61 20 70 61 72 65  table. If a pare
7c70: 6e 74 20 72 6f 77 20 63 61 6e 6e 6f 74 0a 20 20  nt row cannot.  
7c80: 20 20 20 20 2a 2a 20 62 65 20 66 6f 75 6e 64 2c      ** be found,
7c90: 20 61 64 64 69 6e 67 20 74 68 65 20 63 68 69 6c   adding the chil
7ca0: 64 20 72 6f 77 20 68 61 73 20 76 69 6f 6c 61 74  d row has violat
7cb0: 65 64 20 74 68 65 20 46 4b 20 63 6f 6e 73 74 72  ed the FK constr
7cc0: 61 69 6e 74 2e 20 2a 2f 20 0a 20 20 20 20 20 20  aint. */ .      
7cd0: 66 6b 4c 6f 6f 6b 75 70 50 61 72 65 6e 74 28 70  fkLookupParent(p
7ce0: 50 61 72 73 65 2c 20 69 44 62 2c 20 70 54 6f 2c  Parse, iDb, pTo,
7cf0: 20 70 49 64 78 2c 20 70 46 4b 65 79 2c 20 61 69   pIdx, pFKey, ai
7d00: 43 6f 6c 2c 20 72 65 67 4e 65 77 2c 20 2b 31 29  Col, regNew, +1)
7d10: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 73 71 6c  ;.    }..    sql
7d20: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 61  ite3DbFree(db, a
7d30: 69 46 72 65 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f  iFree);.  }..  /
7d40: 2a 20 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20 61  * Loop through a
7d50: 6c 6c 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b  ll the foreign k
7d60: 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 74  ey constraints t
7d70: 68 61 74 20 72 65 66 65 72 20 74 6f 20 74 68 69  hat refer to thi
7d80: 73 20 74 61 62 6c 65 20 2a 2f 0a 20 20 66 6f 72  s table */.  for
7d90: 28 70 46 4b 65 79 20 3d 20 73 71 6c 69 74 65 33  (pFKey = sqlite3
7da0: 46 6b 52 65 66 65 72 65 6e 63 65 73 28 70 54 61  FkReferences(pTa
7db0: 62 29 3b 20 70 46 4b 65 79 3b 20 70 46 4b 65 79  b); pFKey; pFKey
7dc0: 3d 70 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f 29  =pFKey->pNextTo)
7dd0: 7b 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 49 64  {.    Index *pId
7de0: 78 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20  x = 0;          
7df0: 20 20 20 20 2f 2a 20 46 6f 72 65 69 67 6e 20 6b      /* Foreign k
7e00: 65 79 20 69 6e 64 65 78 20 66 6f 72 20 70 46 4b  ey index for pFK
7e10: 65 79 20 2a 2f 0a 20 20 20 20 53 72 63 4c 69 73  ey */.    SrcLis
7e20: 74 20 2a 70 53 72 63 3b 0a 20 20 20 20 69 6e 74  t *pSrc;.    int
7e30: 20 2a 61 69 43 6f 6c 20 3d 20 30 3b 0a 0a 20 20   *aiCol = 0;..  
7e40: 20 20 69 66 28 20 21 70 46 4b 65 79 2d 3e 69 73    if( !pFKey->is
7e50: 44 65 66 65 72 72 65 64 20 26 26 20 21 70 50 61  Deferred && !pPa
7e60: 72 73 65 2d 3e 70 54 6f 70 6c 65 76 65 6c 20 26  rse->pToplevel &
7e70: 26 20 21 70 50 61 72 73 65 2d 3e 69 73 4d 75 6c  & !pParse->isMul
7e80: 74 69 57 72 69 74 65 20 29 7b 0a 20 20 20 20 20  tiWrite ){.     
7e90: 20 61 73 73 65 72 74 28 20 72 65 67 4f 6c 64 3d   assert( regOld=
7ea0: 3d 30 20 26 26 20 72 65 67 4e 65 77 21 3d 30 20  =0 && regNew!=0 
7eb0: 29 3b 0a 20 20 20 20 20 20 2f 2a 20 49 6e 73 65  );.      /* Inse
7ec0: 72 74 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 72  rting a single r
7ed0: 6f 77 20 69 6e 74 6f 20 61 20 70 61 72 65 6e 74  ow into a parent
7ee0: 20 74 61 62 6c 65 20 63 61 6e 6e 6f 74 20 63 61   table cannot ca
7ef0: 75 73 65 20 61 6e 20 69 6d 6d 65 64 69 61 74 65  use an immediate
7f00: 0a 20 20 20 20 20 20 2a 2a 20 66 6f 72 65 69 67  .      ** foreig
7f10: 6e 20 6b 65 79 20 76 69 6f 6c 61 74 69 6f 6e 2e  n key violation.
7f20: 20 53 6f 20 64 6f 20 6e 6f 74 68 69 6e 67 20 69   So do nothing i
7f30: 6e 20 74 68 69 73 20 63 61 73 65 2e 20 20 2a 2f  n this case.  */
7f40: 0a 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b  .      continue;
7f50: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 20  .    }..    if( 
7f60: 6c 6f 63 61 74 65 46 6b 65 79 49 6e 64 65 78 28  locateFkeyIndex(
7f70: 70 50 61 72 73 65 2c 20 70 54 61 62 2c 20 70 46  pParse, pTab, pF
7f80: 4b 65 79 2c 20 26 70 49 64 78 2c 20 26 61 69 43  Key, &pIdx, &aiC
7f90: 6f 6c 29 20 29 7b 0a 20 20 20 20 20 20 69 66 28  ol) ){.      if(
7fa0: 20 21 69 73 49 67 6e 6f 72 65 45 72 72 6f 72 73   !isIgnoreErrors
7fb0: 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61   || db->mallocFa
7fc0: 69 6c 65 64 20 29 20 72 65 74 75 72 6e 3b 0a 20  iled ) return;. 
7fd0: 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20       continue;. 
7fe0: 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28     }.    assert(
7ff0: 20 61 69 43 6f 6c 20 7c 7c 20 70 46 4b 65 79 2d   aiCol || pFKey-
8000: 3e 6e 43 6f 6c 3d 3d 31 20 29 3b 0a 0a 20 20 20  >nCol==1 );..   
8010: 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 74 68 69   /* Check if thi
8020: 73 20 75 70 64 61 74 65 20 73 74 61 74 65 6d 65  s update stateme
8030: 6e 74 20 68 61 73 20 6d 6f 64 69 66 69 65 64 20  nt has modified 
8040: 61 6e 79 20 6f 66 20 74 68 65 20 63 68 69 6c 64  any of the child
8050: 20 6b 65 79 20 0a 20 20 20 20 2a 2a 20 63 6f 6c   key .    ** col
8060: 75 6d 6e 73 20 66 6f 72 20 74 68 69 73 20 66 6f  umns for this fo
8070: 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72  reign key constr
8080: 61 69 6e 74 2e 20 49 66 20 69 74 20 68 61 73 20  aint. If it has 
8090: 6e 6f 74 2c 20 74 68 65 72 65 20 69 73 20 0a 20  not, there is . 
80a0: 20 20 20 2a 2a 20 6e 6f 20 6e 65 65 64 20 74 6f     ** no need to
80b0: 20 73 65 61 72 63 68 20 74 68 65 20 63 68 69 6c   search the chil
80c0: 64 20 74 61 62 6c 65 20 66 6f 72 20 72 6f 77 73  d table for rows
80d0: 20 69 6e 20 76 69 6f 6c 61 74 69 6f 6e 2e 20 54   in violation. T
80e0: 68 69 73 20 69 73 0a 20 20 20 20 2a 2a 20 6a 75  his is.    ** ju
80f0: 73 74 20 61 6e 20 6f 70 74 69 6d 69 7a 61 74 69  st an optimizati
8100: 6f 6e 2e 20 54 68 69 6e 67 73 20 77 6f 75 6c 64  on. Things would
8110: 20 77 6f 72 6b 20 66 69 6e 65 20 77 69 74 68 6f   work fine witho
8120: 75 74 20 74 68 69 73 20 63 68 65 63 6b 2e 20 20  ut this check.  
8130: 2a 2f 0a 20 20 20 20 69 66 28 20 70 43 68 61 6e  */.    if( pChan
8140: 67 65 73 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20  ges ){.      /* 
8150: 54 4f 44 4f 20 2a 2f 0a 20 20 20 20 7d 0a 0a 20  TODO */.    }.. 
8160: 20 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20 53     /* Create a S
8170: 72 63 4c 69 73 74 20 73 74 72 75 63 74 75 72 65  rcList structure
8180: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 61 20 73 69   containing a si
8190: 6e 67 6c 65 20 74 61 62 6c 65 20 28 74 68 65 20  ngle table (the 
81a0: 74 61 62 6c 65 20 0a 20 20 20 20 2a 2a 20 74 68  table .    ** th
81b0: 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 74 68  e foreign key th
81c0: 61 74 20 72 65 66 65 72 73 20 74 6f 20 74 68 69  at refers to thi
81d0: 73 20 74 61 62 6c 65 20 69 73 20 61 74 74 61 63  s table is attac
81e0: 68 65 64 20 74 6f 29 2e 20 54 68 69 73 0a 20 20  hed to). This.  
81f0: 20 20 2a 2a 20 69 73 20 72 65 71 75 69 72 65 64    ** is required
8200: 20 66 6f 72 20 74 68 65 20 73 71 6c 69 74 65 33   for the sqlite3
8210: 57 68 65 72 65 58 58 58 28 29 20 69 6e 74 65 72  WhereXXX() inter
8220: 66 61 63 65 2e 20 20 2a 2f 0a 20 20 20 20 70 53  face.  */.    pS
8230: 72 63 20 3d 20 73 71 6c 69 74 65 33 53 72 63 4c  rc = sqlite3SrcL
8240: 69 73 74 41 70 70 65 6e 64 28 64 62 2c 20 30 2c  istAppend(db, 0,
8250: 20 30 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20   0, 0);.    if( 
8260: 70 53 72 63 20 29 7b 0a 20 20 20 20 20 20 70 53  pSrc ){.      pS
8270: 72 63 2d 3e 61 2d 3e 70 54 61 62 20 3d 20 70 46  rc->a->pTab = pF
8280: 4b 65 79 2d 3e 70 46 72 6f 6d 3b 0a 20 20 20 20  Key->pFrom;.    
8290: 20 20 70 53 72 63 2d 3e 61 2d 3e 70 54 61 62 2d    pSrc->a->pTab-
82a0: 3e 6e 52 65 66 2b 2b 3b 0a 20 20 20 20 20 20 70  >nRef++;.      p
82b0: 53 72 63 2d 3e 61 2d 3e 69 43 75 72 73 6f 72 20  Src->a->iCursor 
82c0: 3d 20 70 50 61 72 73 65 2d 3e 6e 54 61 62 2b 2b  = pParse->nTab++
82d0: 3b 0a 20 20 0a 20 20 20 20 20 20 69 66 28 20 72  ;.  .      if( r
82e0: 65 67 4e 65 77 21 3d 30 20 29 7b 0a 20 20 20 20  egNew!=0 ){.    
82f0: 20 20 20 20 66 6b 53 63 61 6e 43 68 69 6c 64 72      fkScanChildr
8300: 65 6e 28 70 50 61 72 73 65 2c 20 70 53 72 63 2c  en(pParse, pSrc,
8310: 20 70 54 61 62 2c 20 70 49 64 78 2c 20 70 46 4b   pTab, pIdx, pFK
8320: 65 79 2c 20 61 69 43 6f 6c 2c 20 72 65 67 4e 65  ey, aiCol, regNe
8330: 77 2c 20 2d 31 29 3b 0a 20 20 20 20 20 20 7d 0a  w, -1);.      }.
8340: 20 20 20 20 20 20 69 66 28 20 72 65 67 4f 6c 64        if( regOld
8350: 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2f  !=0 ){.        /
8360: 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 61 20  * If there is a 
8370: 52 45 53 54 52 49 43 54 20 61 63 74 69 6f 6e 20  RESTRICT action 
8380: 63 6f 6e 66 69 67 75 72 65 64 20 66 6f 72 20 74  configured for t
8390: 68 65 20 63 75 72 72 65 6e 74 20 6f 70 65 72 61  he current opera
83a0: 74 69 6f 6e 0a 20 20 20 20 20 20 20 20 2a 2a 20  tion.        ** 
83b0: 6f 6e 20 74 68 65 20 70 61 72 65 6e 74 20 74 61  on the parent ta
83c0: 62 6c 65 20 6f 66 20 74 68 69 73 20 46 4b 2c 20  ble of this FK, 
83d0: 74 68 65 6e 20 74 68 72 6f 77 20 61 6e 20 65 78  then throw an ex
83e0: 63 65 70 74 69 6f 6e 20 0a 20 20 20 20 20 20 20  ception .       
83f0: 20 2a 2a 20 69 6d 6d 65 64 69 61 74 65 6c 79 20   ** immediately 
8400: 69 66 20 74 68 65 20 46 4b 20 63 6f 6e 73 74 72  if the FK constr
8410: 61 69 6e 74 20 69 73 20 76 69 6f 6c 61 74 65 64  aint is violated
8420: 2c 20 65 76 65 6e 20 69 66 20 74 68 69 73 20 69  , even if this i
8430: 73 20 61 0a 20 20 20 20 20 20 20 20 2a 2a 20 64  s a.        ** d
8440: 65 66 65 72 72 65 64 20 74 72 69 67 67 65 72 2e  eferred trigger.
8450: 20 54 68 61 74 27 73 20 77 68 61 74 20 52 45 53   That's what RES
8460: 54 52 49 43 54 20 6d 65 61 6e 73 2e 20 54 6f 20  TRICT means. To 
8470: 64 65 66 65 72 20 63 68 65 63 6b 69 6e 67 0a 20  defer checking. 
8480: 20 20 20 20 20 20 20 2a 2a 20 74 68 65 20 63 6f         ** the co
8490: 6e 73 74 72 61 69 6e 74 2c 20 74 68 65 20 46 4b  nstraint, the FK
84a0: 20 73 68 6f 75 6c 64 20 73 70 65 63 69 66 79 20   should specify 
84b0: 4e 4f 20 41 43 54 49 4f 4e 20 28 72 65 70 72 65  NO ACTION (repre
84c0: 73 65 6e 74 65 64 0a 20 20 20 20 20 20 20 20 2a  sented.        *
84d0: 2a 20 75 73 69 6e 67 20 4f 45 5f 4e 6f 6e 65 29  * using OE_None)
84e0: 2e 20 4e 4f 20 41 43 54 49 4f 4e 20 69 73 20 74  . NO ACTION is t
84f0: 68 65 20 64 65 66 61 75 6c 74 2e 20 20 2a 2f 0a  he default.  */.
8500: 20 20 20 20 20 20 20 20 66 6b 53 63 61 6e 43 68          fkScanCh
8510: 69 6c 64 72 65 6e 28 70 50 61 72 73 65 2c 20 70  ildren(pParse, p
8520: 53 72 63 2c 20 70 54 61 62 2c 20 70 49 64 78 2c  Src, pTab, pIdx,
8530: 20 70 46 4b 65 79 2c 20 61 69 43 6f 6c 2c 20 72   pFKey, aiCol, r
8540: 65 67 4f 6c 64 2c 20 31 29 3b 0a 20 20 20 20 20  egOld, 1);.     
8550: 20 7d 0a 20 20 0a 20 20 20 20 20 20 73 71 6c 69   }.  .      sqli
8560: 74 65 33 53 72 63 4c 69 73 74 44 65 6c 65 74 65  te3SrcListDelete
8570: 28 64 62 2c 20 70 53 72 63 29 3b 0a 20 20 20 20  (db, pSrc);.    
8580: 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 46  }.    sqlite3DbF
8590: 72 65 65 28 64 62 2c 20 61 69 43 6f 6c 29 3b 0a  ree(db, aiCol);.
85a0: 20 20 7d 0a 7d 0a 0a 23 64 65 66 69 6e 65 20 43    }.}..#define C
85b0: 4f 4c 55 4d 4e 5f 4d 41 53 4b 28 78 29 20 28 28  OLUMN_MASK(x) ((
85c0: 28 78 29 3e 33 31 29 20 3f 20 30 78 66 66 66 66  (x)>31) ? 0xffff
85d0: 66 66 66 66 20 3a 20 28 28 75 33 32 29 31 3c 3c  ffff : ((u32)1<<
85e0: 28 78 29 29 29 0a 0a 2f 2a 0a 2a 2a 20 54 68 69  (x)))../*.** Thi
85f0: 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61  s function is ca
8600: 6c 6c 65 64 20 62 65 66 6f 72 65 20 67 65 6e 65  lled before gene
8610: 72 61 74 69 6e 67 20 63 6f 64 65 20 74 6f 20 75  rating code to u
8620: 70 64 61 74 65 20 6f 72 20 64 65 6c 65 74 65 20  pdate or delete 
8630: 61 20 0a 2a 2a 20 72 6f 77 20 63 6f 6e 74 61 69  a .** row contai
8640: 6e 65 64 20 69 6e 20 74 61 62 6c 65 20 70 54 61  ned in table pTa
8650: 62 2e 20 49 66 20 74 68 65 20 6f 70 65 72 61 74  b. If the operat
8660: 69 6f 6e 20 69 73 20 61 6e 20 75 70 64 61 74 65  ion is an update
8670: 2c 20 74 68 65 6e 20 0a 2a 2a 20 70 43 68 61 6e  , then .** pChan
8680: 67 65 73 20 69 73 20 61 20 70 6f 69 6e 74 65 72  ges is a pointer
8690: 20 74 6f 20 74 68 65 20 6c 69 73 74 20 6f 66 20   to the list of 
86a0: 63 6f 6c 75 6d 6e 73 20 74 6f 20 6d 6f 64 69 66  columns to modif
86b0: 79 2e 20 49 66 20 74 68 69 73 20 69 73 20 61 20  y. If this is a 
86c0: 0a 2a 2a 20 64 65 6c 65 74 65 2c 20 74 68 65 6e  .** delete, then
86d0: 20 70 43 68 61 6e 67 65 73 20 69 73 20 4e 55 4c   pChanges is NUL
86e0: 4c 2e 0a 2a 2f 0a 75 33 32 20 73 71 6c 69 74 65  L..*/.u32 sqlite
86f0: 33 46 6b 4f 6c 64 6d 61 73 6b 28 0a 20 20 50 61  3FkOldmask(.  Pa
8700: 72 73 65 20 2a 70 50 61 72 73 65 2c 20 20 20 20  rse *pParse,    
8710: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
8720: 20 50 61 72 73 65 20 63 6f 6e 74 65 78 74 20 2a   Parse context *
8730: 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 2c  /.  Table *pTab,
8740: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
8750: 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 62 65 69      /* Table bei
8760: 6e 67 20 6d 6f 64 69 66 69 65 64 20 2a 2f 0a 20  ng modified */. 
8770: 20 45 78 70 72 4c 69 73 74 20 2a 70 43 68 61 6e   ExprList *pChan
8780: 67 65 73 20 20 20 20 20 20 20 20 20 20 20 20 20  ges             
8790: 20 2f 2a 20 4e 6f 6e 2d 4e 55 4c 4c 20 66 6f 72   /* Non-NULL for
87a0: 20 55 50 44 41 54 45 20 6f 70 65 72 61 74 69 6f   UPDATE operatio
87b0: 6e 73 20 2a 2f 0a 29 7b 0a 20 20 75 33 32 20 6d  ns */.){.  u32 m
87c0: 61 73 6b 20 3d 20 30 3b 0a 20 20 69 66 28 20 70  ask = 0;.  if( p
87d0: 50 61 72 73 65 2d 3e 64 62 2d 3e 66 6c 61 67 73  Parse->db->flags
87e0: 26 53 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b  &SQLITE_ForeignK
87f0: 65 79 73 20 29 7b 0a 20 20 20 20 46 4b 65 79 20  eys ){.    FKey 
8800: 2a 70 3b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20  *p;.    int i;. 
8810: 20 20 20 66 6f 72 28 70 3d 70 54 61 62 2d 3e 70     for(p=pTab->p
8820: 46 4b 65 79 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e  FKey; p; p=p->pN
8830: 65 78 74 46 72 6f 6d 29 7b 0a 20 20 20 20 20 20  extFrom){.      
8840: 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 43  for(i=0; i<p->nC
8850: 6f 6c 3b 20 69 2b 2b 29 20 6d 61 73 6b 20 7c 3d  ol; i++) mask |=
8860: 20 43 4f 4c 55 4d 4e 5f 4d 41 53 4b 28 70 2d 3e   COLUMN_MASK(p->
8870: 61 43 6f 6c 5b 69 5d 2e 69 46 72 6f 6d 29 3b 0a  aCol[i].iFrom);.
8880: 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 70 3d      }.    for(p=
8890: 73 71 6c 69 74 65 33 46 6b 52 65 66 65 72 65 6e  sqlite3FkReferen
88a0: 63 65 73 28 70 54 61 62 29 3b 20 70 3b 20 70 3d  ces(pTab); p; p=
88b0: 70 2d 3e 70 4e 65 78 74 54 6f 29 7b 0a 20 20 20  p->pNextTo){.   
88c0: 20 20 20 49 6e 64 65 78 20 2a 70 49 64 78 20 3d     Index *pIdx =
88d0: 20 30 3b 0a 20 20 20 20 20 20 6c 6f 63 61 74 65   0;.      locate
88e0: 46 6b 65 79 49 6e 64 65 78 28 70 50 61 72 73 65  FkeyIndex(pParse
88f0: 2c 20 70 54 61 62 2c 20 70 2c 20 26 70 49 64 78  , pTab, p, &pIdx
8900: 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20  , 0);.      if( 
8910: 70 49 64 78 20 29 7b 0a 20 20 20 20 20 20 20 20  pIdx ){.        
8920: 66 6f 72 28 69 3d 30 3b 20 69 3c 70 49 64 78 2d  for(i=0; i<pIdx-
8930: 3e 6e 43 6f 6c 75 6d 6e 3b 20 69 2b 2b 29 20 6d  >nColumn; i++) m
8940: 61 73 6b 20 7c 3d 20 43 4f 4c 55 4d 4e 5f 4d 41  ask |= COLUMN_MA
8950: 53 4b 28 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d  SK(pIdx->aiColum
8960: 6e 5b 69 5d 29 3b 0a 20 20 20 20 20 20 7d 0a 20  n[i]);.      }. 
8970: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72     }.  }.  retur
8980: 6e 20 6d 61 73 6b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  n mask;.}../*.**
8990: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69   This function i
89a0: 73 20 63 61 6c 6c 65 64 20 62 65 66 6f 72 65 20  s called before 
89b0: 67 65 6e 65 72 61 74 69 6e 67 20 63 6f 64 65 20  generating code 
89c0: 74 6f 20 75 70 64 61 74 65 20 6f 72 20 64 65 6c  to update or del
89d0: 65 74 65 20 61 20 0a 2a 2a 20 72 6f 77 20 63 6f  ete a .** row co
89e0: 6e 74 61 69 6e 65 64 20 69 6e 20 74 61 62 6c 65  ntained in table
89f0: 20 70 54 61 62 2e 20 49 66 20 74 68 65 20 6f 70   pTab. If the op
8a00: 65 72 61 74 69 6f 6e 20 69 73 20 61 6e 20 75 70  eration is an up
8a10: 64 61 74 65 2c 20 74 68 65 6e 20 0a 2a 2a 20 70  date, then .** p
8a20: 43 68 61 6e 67 65 73 20 69 73 20 61 20 70 6f 69  Changes is a poi
8a30: 6e 74 65 72 20 74 6f 20 74 68 65 20 6c 69 73 74  nter to the list
8a40: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 74 6f 20 6d   of columns to m
8a50: 6f 64 69 66 79 2e 20 49 66 20 74 68 69 73 20 69  odify. If this i
8a60: 73 20 61 20 0a 2a 2a 20 64 65 6c 65 74 65 2c 20  s a .** delete, 
8a70: 74 68 65 6e 20 70 43 68 61 6e 67 65 73 20 69 73  then pChanges is
8a80: 20 4e 55 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 49 66 20   NULL..**.** If 
8a90: 61 6e 79 20 66 6f 72 65 69 67 6e 20 6b 65 79 20  any foreign key 
8aa0: 70 72 6f 63 65 73 73 69 6e 67 20 77 69 6c 6c 20  processing will 
8ab0: 62 65 20 72 65 71 75 69 72 65 64 2c 20 74 68 69  be required, thi
8ac0: 73 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72  s function retur
8ad0: 6e 73 0a 2a 2a 20 74 72 75 65 2e 20 49 66 20 74  ns.** true. If t
8ae0: 68 65 72 65 20 69 73 20 6e 6f 20 66 6f 72 65 69  here is no forei
8af0: 67 6e 20 6b 65 79 20 72 65 6c 61 74 65 64 20 70  gn key related p
8b00: 72 6f 63 65 73 73 69 6e 67 2c 20 74 68 69 73 20  rocessing, this 
8b10: 66 75 6e 63 74 69 6f 6e 20 0a 2a 2a 20 72 65 74  function .** ret
8b20: 75 72 6e 73 20 66 61 6c 73 65 2e 0a 2a 2f 0a 69  urns false..*/.i
8b30: 6e 74 20 73 71 6c 69 74 65 33 46 6b 52 65 71 75  nt sqlite3FkRequ
8b40: 69 72 65 64 28 0a 20 20 50 61 72 73 65 20 2a 70  ired(.  Parse *p
8b50: 50 61 72 73 65 2c 20 20 20 20 20 20 20 20 20 20  Parse,          
8b60: 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 65          /* Parse
8b70: 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 54 61   context */.  Ta
8b80: 62 6c 65 20 2a 70 54 61 62 2c 20 20 20 20 20 20  ble *pTab,      
8b90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
8ba0: 20 54 61 62 6c 65 20 62 65 69 6e 67 20 6d 6f 64   Table being mod
8bb0: 69 66 69 65 64 20 2a 2f 0a 20 20 45 78 70 72 4c  ified */.  ExprL
8bc0: 69 73 74 20 2a 70 43 68 61 6e 67 65 73 20 20 20  ist *pChanges   
8bd0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 6f             /* No
8be0: 6e 2d 4e 55 4c 4c 20 66 6f 72 20 55 50 44 41 54  n-NULL for UPDAT
8bf0: 45 20 6f 70 65 72 61 74 69 6f 6e 73 20 2a 2f 0a  E operations */.
8c00: 29 7b 0a 20 20 69 66 28 20 70 50 61 72 73 65 2d  ){.  if( pParse-
8c10: 3e 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c 49 54  >db->flags&SQLIT
8c20: 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73 20 29 7b  E_ForeignKeys ){
8c30: 0a 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33  .    if( sqlite3
8c40: 46 6b 52 65 66 65 72 65 6e 63 65 73 28 70 54 61  FkReferences(pTa
8c50: 62 29 20 7c 7c 20 70 54 61 62 2d 3e 70 46 4b 65  b) || pTab->pFKe
8c60: 79 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20  y ) return 1;.  
8c70: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  }.  return 0;.}.
8c80: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63  ./*.** This func
8c90: 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77  tion is called w
8ca0: 68 65 6e 20 61 6e 20 55 50 44 41 54 45 20 6f 72  hen an UPDATE or
8cb0: 20 44 45 4c 45 54 45 20 6f 70 65 72 61 74 69 6f   DELETE operatio
8cc0: 6e 20 69 73 20 62 65 69 6e 67 20 0a 2a 2a 20 63  n is being .** c
8cd0: 6f 6d 70 69 6c 65 64 20 6f 6e 20 74 61 62 6c 65  ompiled on table
8ce0: 20 70 54 61 62 2c 20 77 68 69 63 68 20 69 73 20   pTab, which is 
8cf0: 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65  the parent table
8d00: 20 6f 66 20 66 6f 72 65 69 67 6e 2d 6b 65 79 20   of foreign-key 
8d10: 70 46 4b 65 79 2e 0a 2a 2a 20 49 66 20 74 68 65  pFKey..** If the
8d20: 20 63 75 72 72 65 6e 74 20 6f 70 65 72 61 74 69   current operati
8d30: 6f 6e 20 69 73 20 61 6e 20 55 50 44 41 54 45 2c  on is an UPDATE,
8d40: 20 74 68 65 6e 20 74 68 65 20 70 43 68 61 6e 67   then the pChang
8d50: 65 73 20 70 61 72 61 6d 65 74 65 72 20 69 73 0a  es parameter is.
8d60: 2a 2a 20 70 61 73 73 65 64 20 61 20 70 6f 69 6e  ** passed a poin
8d70: 74 65 72 20 74 6f 20 74 68 65 20 6c 69 73 74 20  ter to the list 
8d80: 6f 66 20 63 6f 6c 75 6d 6e 73 20 62 65 69 6e 67  of columns being
8d90: 20 6d 6f 64 69 66 69 65 64 2e 20 49 66 20 69 74   modified. If it
8da0: 20 69 73 20 61 0a 2a 2a 20 44 45 4c 45 54 45 2c   is a.** DELETE,
8db0: 20 70 43 68 61 6e 67 65 73 20 69 73 20 70 61 73   pChanges is pas
8dc0: 73 65 64 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74  sed a NULL point
8dd0: 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 72 65 74  er..**.** It ret
8de0: 75 72 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 74  urns a pointer t
8df0: 6f 20 61 20 54 72 69 67 67 65 72 20 73 74 72 75  o a Trigger stru
8e00: 63 74 75 72 65 20 63 6f 6e 74 61 69 6e 69 6e 67  cture containing
8e10: 20 61 20 74 72 69 67 67 65 72 0a 2a 2a 20 65 71   a trigger.** eq
8e20: 75 69 76 61 6c 65 6e 74 20 74 6f 20 74 68 65 20  uivalent to the 
8e30: 4f 4e 20 55 50 44 41 54 45 20 6f 72 20 4f 4e 20  ON UPDATE or ON 
8e40: 44 45 4c 45 54 45 20 61 63 74 69 6f 6e 20 73 70  DELETE action sp
8e50: 65 63 69 66 69 65 64 20 62 79 20 70 46 4b 65 79  ecified by pFKey
8e60: 2e 0a 2a 2a 20 49 66 20 74 68 65 20 61 63 74 69  ..** If the acti
8e70: 6f 6e 20 69 73 20 22 4e 4f 20 41 43 54 49 4f 4e  on is "NO ACTION
8e80: 22 20 6f 72 20 22 52 45 53 54 52 49 43 54 22 2c  " or "RESTRICT",
8e90: 20 74 68 65 6e 20 61 20 4e 55 4c 4c 20 70 6f 69   then a NULL poi
8ea0: 6e 74 65 72 20 69 73 0a 2a 2a 20 72 65 74 75 72  nter is.** retur
8eb0: 6e 65 64 20 28 74 68 65 73 65 20 61 63 74 69 6f  ned (these actio
8ec0: 6e 73 20 72 65 71 75 69 72 65 20 6e 6f 20 73 70  ns require no sp
8ed0: 65 63 69 61 6c 20 68 61 6e 64 6c 69 6e 67 20 62  ecial handling b
8ee0: 79 20 74 68 65 20 74 72 69 67 67 65 72 73 0a 2a  y the triggers.*
8ef0: 2a 20 73 75 62 2d 73 79 73 74 65 6d 2c 20 63 6f  * sub-system, co
8f00: 64 65 20 66 6f 72 20 74 68 65 6d 20 69 73 20 63  de for them is c
8f10: 72 65 61 74 65 64 20 62 79 20 66 6b 53 63 61 6e  reated by fkScan
8f20: 43 68 69 6c 64 72 65 6e 28 29 29 2e 0a 2a 2a 0a  Children())..**.
8f30: 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20  ** For example, 
8f40: 69 66 20 70 46 4b 65 79 20 69 73 20 74 68 65 20  if pFKey is the 
8f50: 66 6f 72 65 69 67 6e 20 6b 65 79 20 61 6e 64 20  foreign key and 
8f60: 70 54 61 62 20 69 73 20 74 61 62 6c 65 20 22 70  pTab is table "p
8f70: 22 20 69 6e 20 0a 2a 2a 20 74 68 65 20 66 6f 6c  " in .** the fol
8f80: 6c 6f 77 69 6e 67 20 73 63 68 65 6d 61 3a 0a 2a  lowing schema:.*
8f90: 2a 0a 2a 2a 20 20 20 43 52 45 41 54 45 20 54 41  *.**   CREATE TA
8fa0: 42 4c 45 20 70 28 70 6b 20 50 52 49 4d 41 52 59  BLE p(pk PRIMARY
8fb0: 20 4b 45 59 29 3b 0a 2a 2a 20 20 20 43 52 45 41   KEY);.**   CREA
8fc0: 54 45 20 54 41 42 4c 45 20 63 28 63 6b 20 52 45  TE TABLE c(ck RE
8fd0: 46 45 52 45 4e 43 45 53 20 70 20 4f 4e 20 44 45  FERENCES p ON DE
8fe0: 4c 45 54 45 20 43 41 53 43 41 44 45 29 3b 0a 2a  LETE CASCADE);.*
8ff0: 2a 0a 2a 2a 20 74 68 65 6e 20 74 68 65 20 72 65  *.** then the re
9000: 74 75 72 6e 65 64 20 74 72 69 67 67 65 72 20 73  turned trigger s
9010: 74 72 75 63 74 75 72 65 20 69 73 20 65 71 75 69  tructure is equi
9020: 76 61 6c 65 6e 74 20 74 6f 3a 0a 2a 2a 0a 2a 2a  valent to:.**.**
9030: 20 20 20 43 52 45 41 54 45 20 54 52 49 47 47 45     CREATE TRIGGE
9040: 52 20 2e 2e 2e 20 44 45 4c 45 54 45 20 4f 4e 20  R ... DELETE ON 
9050: 70 20 42 45 47 49 4e 0a 2a 2a 20 20 20 20 20 44  p BEGIN.**     D
9060: 45 4c 45 54 45 20 46 52 4f 4d 20 63 20 57 48 45  ELETE FROM c WHE
9070: 52 45 20 63 6b 20 3d 20 6f 6c 64 2e 70 6b 3b 0a  RE ck = old.pk;.
9080: 2a 2a 20 20 20 45 4e 44 3b 0a 2a 2a 0a 2a 2a 20  **   END;.**.** 
9090: 54 68 65 20 72 65 74 75 72 6e 65 64 20 70 6f 69  The returned poi
90a0: 6e 74 65 72 20 69 73 20 63 61 63 68 65 64 20 61  nter is cached a
90b0: 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 66 6f  s part of the fo
90c0: 72 65 69 67 6e 20 6b 65 79 20 6f 62 6a 65 63 74  reign key object
90d0: 2e 20 49 74 0a 2a 2a 20 69 73 20 65 76 65 6e 74  . It.** is event
90e0: 75 61 6c 6c 79 20 66 72 65 65 64 20 61 6c 6f 6e  ually freed alon
90f0: 67 20 77 69 74 68 20 74 68 65 20 72 65 73 74 20  g with the rest 
9100: 6f 66 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b  of the foreign k
9110: 65 79 20 6f 62 6a 65 63 74 20 62 79 20 0a 2a 2a  ey object by .**
9120: 20 73 71 6c 69 74 65 33 46 6b 44 65 6c 65 74 65   sqlite3FkDelete
9130: 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 54 72  ()..*/.static Tr
9140: 69 67 67 65 72 20 2a 66 6b 41 63 74 69 6f 6e 54  igger *fkActionT
9150: 72 69 67 67 65 72 28 0a 20 20 50 61 72 73 65 20  rigger(.  Parse 
9160: 2a 70 50 61 72 73 65 2c 20 20 20 20 20 20 20 20  *pParse,        
9170: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72            /* Par
9180: 73 65 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20  se context */.  
9190: 54 61 62 6c 65 20 2a 70 54 61 62 2c 20 20 20 20  Table *pTab,    
91a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
91b0: 2f 2a 20 54 61 62 6c 65 20 62 65 69 6e 67 20 75  /* Table being u
91c0: 70 64 61 74 65 64 20 6f 72 20 64 65 6c 65 74 65  pdated or delete
91d0: 64 20 66 72 6f 6d 20 2a 2f 0a 20 20 46 4b 65 79  d from */.  FKey
91e0: 20 2a 70 46 4b 65 79 2c 20 20 20 20 20 20 20 20   *pFKey,        
91f0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46              /* F
9200: 6f 72 65 69 67 6e 20 6b 65 79 20 74 6f 20 67 65  oreign key to ge
9210: 74 20 61 63 74 69 6f 6e 20 66 6f 72 20 2a 2f 0a  t action for */.
9220: 20 20 45 78 70 72 4c 69 73 74 20 2a 70 43 68 61    ExprList *pCha
9230: 6e 67 65 73 20 20 20 20 20 20 20 20 20 20 20 20  nges            
9240: 20 20 2f 2a 20 43 68 61 6e 67 65 2d 6c 69 73 74    /* Change-list
9250: 20 66 6f 72 20 55 50 44 41 54 45 2c 20 4e 55 4c   for UPDATE, NUL
9260: 4c 20 66 6f 72 20 44 45 4c 45 54 45 20 2a 2f 0a  L for DELETE */.
9270: 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  ){.  sqlite3 *db
9280: 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 20 20   = pParse->db;  
9290: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
92a0: 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e 74   handle */.  int
92b0: 20 61 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 20   action;        
92c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
92d0: 4f 6e 65 20 6f 66 20 4f 45 5f 4e 6f 6e 65 2c 20  One of OE_None, 
92e0: 4f 45 5f 43 61 73 63 61 64 65 20 65 74 63 2e 20  OE_Cascade etc. 
92f0: 2a 2f 0a 20 20 54 72 69 67 67 65 72 20 2a 70 54  */.  Trigger *pT
9300: 72 69 67 67 65 72 3b 20 20 20 20 20 20 20 20 20  rigger;         
9310: 20 20 20 20 20 2f 2a 20 54 72 69 67 67 65 72 20       /* Trigger 
9320: 64 65 66 69 6e 69 74 69 6f 6e 20 74 6f 20 72 65  definition to re
9330: 74 75 72 6e 20 2a 2f 0a 20 20 69 6e 74 20 69 41  turn */.  int iA
9340: 63 74 69 6f 6e 20 3d 20 28 70 43 68 61 6e 67 65  ction = (pChange
9350: 73 21 3d 30 29 3b 20 20 20 20 2f 2a 20 31 20 66  s!=0);    /* 1 f
9360: 6f 72 20 55 50 44 41 54 45 2c 20 30 20 66 6f 72  or UPDATE, 0 for
9370: 20 44 45 4c 45 54 45 20 2a 2f 0a 0a 20 20 61 63   DELETE */..  ac
9380: 74 69 6f 6e 20 3d 20 70 46 4b 65 79 2d 3e 61 41  tion = pFKey->aA
9390: 63 74 69 6f 6e 5b 69 41 63 74 69 6f 6e 5d 3b 0a  ction[iAction];.
93a0: 20 20 70 54 72 69 67 67 65 72 20 3d 20 70 46 4b    pTrigger = pFK
93b0: 65 79 2d 3e 61 70 54 72 69 67 67 65 72 5b 69 41  ey->apTrigger[iA
93c0: 63 74 69 6f 6e 5d 3b 0a 0a 20 20 69 66 28 20 61  ction];..  if( a
93d0: 63 74 69 6f 6e 21 3d 4f 45 5f 4e 6f 6e 65 20 26  ction!=OE_None &
93e0: 26 20 21 70 54 72 69 67 67 65 72 20 29 7b 0a 20  & !pTrigger ){. 
93f0: 20 20 20 75 38 20 65 6e 61 62 6c 65 4c 6f 6f 6b     u8 enableLook
9400: 61 73 69 64 65 3b 20 20 20 20 20 20 20 20 20 20  aside;          
9410: 20 2f 2a 20 43 6f 70 79 20 6f 66 20 64 62 2d 3e   /* Copy of db->
9420: 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c  lookaside.bEnabl
9430: 65 64 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 63  ed */.    char c
9440: 6f 6e 73 74 20 2a 7a 46 72 6f 6d 3b 20 20 20 20  onst *zFrom;    
9450: 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20          /* Name 
9460: 6f 66 20 63 68 69 6c 64 20 74 61 62 6c 65 20 2a  of child table *
9470: 2f 0a 20 20 20 20 69 6e 74 20 6e 46 72 6f 6d 3b  /.    int nFrom;
9480: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
9490: 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 69 6e      /* Length in
94a0: 20 62 79 74 65 73 20 6f 66 20 7a 46 72 6f 6d 20   bytes of zFrom 
94b0: 2a 2f 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 49  */.    Index *pI
94c0: 64 78 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20  dx = 0;         
94d0: 20 20 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 6b       /* Parent k
94e0: 65 79 20 69 6e 64 65 78 20 66 6f 72 20 74 68 69  ey index for thi
94f0: 73 20 46 4b 20 2a 2f 0a 20 20 20 20 69 6e 74 20  s FK */.    int 
9500: 2a 61 69 43 6f 6c 20 3d 20 30 3b 20 20 20 20 20  *aiCol = 0;     
9510: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 63 68 69            /* chi
9520: 6c 64 20 74 61 62 6c 65 20 63 6f 6c 73 20 2d 3e  ld table cols ->
9530: 20 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 73   parent key cols
9540: 20 2a 2f 0a 20 20 20 20 54 72 69 67 67 65 72 53   */.    TriggerS
9550: 74 65 70 20 2a 70 53 74 65 70 3b 20 20 20 20 20  tep *pStep;     
9560: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 28        /* First (
9570: 6f 6e 6c 79 29 20 73 74 65 70 20 6f 66 20 74 72  only) step of tr
9580: 69 67 67 65 72 20 70 72 6f 67 72 61 6d 20 2a 2f  igger program */
9590: 0a 20 20 20 20 45 78 70 72 20 2a 70 57 68 65 72  .    Expr *pWher
95a0: 65 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20  e = 0;          
95b0: 20 20 20 2f 2a 20 57 48 45 52 45 20 63 6c 61 75     /* WHERE clau
95c0: 73 65 20 6f 66 20 74 72 69 67 67 65 72 20 73 74  se of trigger st
95d0: 65 70 20 2a 2f 0a 20 20 20 20 45 78 70 72 4c 69  ep */.    ExprLi
95e0: 73 74 20 2a 70 4c 69 73 74 20 3d 20 30 3b 20 20  st *pList = 0;  
95f0: 20 20 20 20 20 20 20 20 2f 2a 20 43 68 61 6e 67          /* Chang
9600: 65 73 20 6c 69 73 74 20 69 66 20 4f 4e 20 55 50  es list if ON UP
9610: 44 41 54 45 20 43 41 53 43 41 44 45 20 2a 2f 0a  DATE CASCADE */.
9620: 20 20 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c      Select *pSel
9630: 65 63 74 20 3d 20 30 3b 20 20 20 20 20 20 20 20  ect = 0;        
9640: 20 20 2f 2a 20 49 66 20 52 45 53 54 52 49 43 54    /* If RESTRICT
9650: 2c 20 22 53 45 4c 45 43 54 20 52 41 49 53 45 28  , "SELECT RAISE(
9660: 2e 2e 2e 29 22 20 2a 2f 0a 20 20 20 20 69 6e 74  ...)" */.    int
9670: 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20   i;             
9680: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 74             /* It
9690: 65 72 61 74 6f 72 20 76 61 72 69 61 62 6c 65 20  erator variable 
96a0: 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 57 68  */.    Expr *pWh
96b0: 65 6e 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20  en = 0;         
96c0: 20 20 20 20 20 2f 2a 20 57 48 45 4e 20 63 6c 61       /* WHEN cla
96d0: 75 73 65 20 66 6f 72 20 74 68 65 20 74 72 69 67  use for the trig
96e0: 67 65 72 20 2a 2f 0a 0a 20 20 20 20 69 66 28 20  ger */..    if( 
96f0: 6c 6f 63 61 74 65 46 6b 65 79 49 6e 64 65 78 28  locateFkeyIndex(
9700: 70 50 61 72 73 65 2c 20 70 54 61 62 2c 20 70 46  pParse, pTab, pF
9710: 4b 65 79 2c 20 26 70 49 64 78 2c 20 26 61 69 43  Key, &pIdx, &aiC
9720: 6f 6c 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a  ol) ) return 0;.
9730: 20 20 20 20 61 73 73 65 72 74 28 20 61 69 43 6f      assert( aiCo
9740: 6c 20 7c 7c 20 70 46 4b 65 79 2d 3e 6e 43 6f 6c  l || pFKey->nCol
9750: 3d 3d 31 20 29 3b 0a 0a 20 20 20 20 66 6f 72 28  ==1 );..    for(
9760: 69 3d 30 3b 20 69 3c 70 46 4b 65 79 2d 3e 6e 43  i=0; i<pFKey->nC
9770: 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  ol; i++){.      
9780: 54 6f 6b 65 6e 20 74 4f 6c 64 20 3d 20 7b 20 22  Token tOld = { "
9790: 6f 6c 64 22 2c 20 33 20 7d 3b 20 20 2f 2a 20 4c  old", 3 };  /* L
97a0: 69 74 65 72 61 6c 20 22 6f 6c 64 22 20 74 6f 6b  iteral "old" tok
97b0: 65 6e 20 2a 2f 0a 20 20 20 20 20 20 54 6f 6b 65  en */.      Toke
97c0: 6e 20 74 4e 65 77 20 3d 20 7b 20 22 6e 65 77 22  n tNew = { "new"
97d0: 2c 20 33 20 7d 3b 20 20 2f 2a 20 4c 69 74 65 72  , 3 };  /* Liter
97e0: 61 6c 20 22 6e 65 77 22 20 74 6f 6b 65 6e 20 2a  al "new" token *
97f0: 2f 0a 20 20 20 20 20 20 54 6f 6b 65 6e 20 74 46  /.      Token tF
9800: 72 6f 6d 43 6f 6c 3b 20 20 20 20 20 20 20 20 20  romCol;         
9810: 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 63      /* Name of c
9820: 6f 6c 75 6d 6e 20 69 6e 20 63 68 69 6c 64 20 74  olumn in child t
9830: 61 62 6c 65 20 2a 2f 0a 20 20 20 20 20 20 54 6f  able */.      To
9840: 6b 65 6e 20 74 54 6f 43 6f 6c 3b 20 20 20 20 20  ken tToCol;     
9850: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d            /* Nam
9860: 65 20 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e 20 70  e of column in p
9870: 61 72 65 6e 74 20 74 61 62 6c 65 20 2a 2f 0a 20  arent table */. 
9880: 20 20 20 20 20 69 6e 74 20 69 46 72 6f 6d 43 6f       int iFromCo
9890: 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20  l;              
98a0: 20 2f 2a 20 49 64 78 20 6f 66 20 63 6f 6c 75 6d   /* Idx of colum
98b0: 6e 20 69 6e 20 63 68 69 6c 64 20 74 61 62 6c 65  n in child table
98c0: 20 2a 2f 0a 20 20 20 20 20 20 45 78 70 72 20 2a   */.      Expr *
98d0: 70 45 71 3b 20 20 20 20 20 20 20 20 20 20 20 20  pEq;            
98e0: 20 20 20 20 20 20 2f 2a 20 74 46 72 6f 6d 43 6f        /* tFromCo
98f0: 6c 20 3d 20 4f 4c 44 2e 74 54 6f 43 6f 6c 20 2a  l = OLD.tToCol *
9900: 2f 0a 0a 20 20 20 20 20 20 69 46 72 6f 6d 43 6f  /..      iFromCo
9910: 6c 20 3d 20 61 69 43 6f 6c 20 3f 20 61 69 43 6f  l = aiCol ? aiCo
9920: 6c 5b 69 5d 20 3a 20 70 46 4b 65 79 2d 3e 61 43  l[i] : pFKey->aC
9930: 6f 6c 5b 30 5d 2e 69 46 72 6f 6d 3b 0a 20 20 20  ol[0].iFrom;.   
9940: 20 20 20 61 73 73 65 72 74 28 20 69 46 72 6f 6d     assert( iFrom
9950: 43 6f 6c 3e 3d 30 20 29 3b 0a 20 20 20 20 20 20  Col>=0 );.      
9960: 74 54 6f 43 6f 6c 2e 7a 20 3d 20 70 49 64 78 20  tToCol.z = pIdx 
9970: 3f 20 70 54 61 62 2d 3e 61 43 6f 6c 5b 70 49 64  ? pTab->aCol[pId
9980: 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 69 5d 5d 2e  x->aiColumn[i]].
9990: 7a 4e 61 6d 65 20 3a 20 22 6f 69 64 22 3b 0a 20  zName : "oid";. 
99a0: 20 20 20 20 20 74 46 72 6f 6d 43 6f 6c 2e 7a 20       tFromCol.z 
99b0: 3d 20 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 2d 3e  = pFKey->pFrom->
99c0: 61 43 6f 6c 5b 69 46 72 6f 6d 43 6f 6c 5d 2e 7a  aCol[iFromCol].z
99d0: 4e 61 6d 65 3b 0a 0a 20 20 20 20 20 20 74 54 6f  Name;..      tTo
99e0: 43 6f 6c 2e 6e 20 3d 20 73 71 6c 69 74 65 33 53  Col.n = sqlite3S
99f0: 74 72 6c 65 6e 33 30 28 74 54 6f 43 6f 6c 2e 7a  trlen30(tToCol.z
9a00: 29 3b 0a 20 20 20 20 20 20 74 46 72 6f 6d 43 6f  );.      tFromCo
9a10: 6c 2e 6e 20 3d 20 73 71 6c 69 74 65 33 53 74 72  l.n = sqlite3Str
9a20: 6c 65 6e 33 30 28 74 46 72 6f 6d 43 6f 6c 2e 7a  len30(tFromCol.z
9a30: 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 43 72 65  );..      /* Cre
9a40: 61 74 65 20 74 68 65 20 65 78 70 72 65 73 73 69  ate the expressi
9a50: 6f 6e 20 22 4f 4c 44 2e 7a 54 6f 43 6f 6c 20 3d  on "OLD.zToCol =
9a60: 20 7a 46 72 6f 6d 43 6f 6c 22 2e 20 49 74 20 69   zFromCol". It i
9a70: 73 20 69 6d 70 6f 72 74 61 6e 74 0a 20 20 20 20  s important.    
9a80: 20 20 2a 2a 20 74 68 61 74 20 74 68 65 20 22 4f    ** that the "O
9a90: 4c 44 2e 7a 54 6f 43 6f 6c 22 20 74 65 72 6d 20  LD.zToCol" term 
9aa0: 69 73 20 6f 6e 20 74 68 65 20 4c 48 53 20 6f 66  is on the LHS of
9ab0: 20 74 68 65 20 3d 20 6f 70 65 72 61 74 6f 72 2c   the = operator,
9ac0: 20 73 6f 0a 20 20 20 20 20 20 2a 2a 20 74 68 61   so.      ** tha
9ad0: 74 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 61  t the affinity a
9ae0: 6e 64 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71  nd collation seq
9af0: 75 65 6e 63 65 20 61 73 73 6f 63 69 61 74 65 64  uence associated
9b00: 20 77 69 74 68 20 74 68 65 0a 20 20 20 20 20 20   with the.      
9b10: 2a 2a 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20  ** parent table 
9b20: 61 72 65 20 75 73 65 64 20 66 6f 72 20 74 68 65  are used for the
9b30: 20 63 6f 6d 70 61 72 69 73 6f 6e 2e 20 2a 2f 0a   comparison. */.
9b40: 20 20 20 20 20 20 70 45 71 20 3d 20 73 71 6c 69        pEq = sqli
9b50: 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c  te3PExpr(pParse,
9b60: 20 54 4b 5f 45 51 2c 0a 20 20 20 20 20 20 20 20   TK_EQ,.        
9b70: 20 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70    sqlite3PExpr(p
9b80: 50 61 72 73 65 2c 20 54 4b 5f 44 4f 54 2c 20 0a  Parse, TK_DOT, .
9b90: 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69              sqli
9ba0: 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c  te3PExpr(pParse,
9bb0: 20 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26 74   TK_ID, 0, 0, &t
9bc0: 4f 6c 64 29 2c 0a 20 20 20 20 20 20 20 20 20 20  Old),.          
9bd0: 20 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70    sqlite3PExpr(p
9be0: 50 61 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30 2c  Parse, TK_ID, 0,
9bf0: 20 30 2c 20 26 74 54 6f 43 6f 6c 29 0a 20 20 20   0, &tToCol).   
9c00: 20 20 20 20 20 20 20 2c 20 30 29 2c 0a 20 20 20         , 0),.   
9c10: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 45         sqlite3PE
9c20: 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 49  xpr(pParse, TK_I
9c30: 44 2c 20 30 2c 20 30 2c 20 26 74 46 72 6f 6d 43  D, 0, 0, &tFromC
9c40: 6f 6c 29 0a 20 20 20 20 20 20 2c 20 30 29 3b 0a  ol).      , 0);.
9c50: 20 20 20 20 20 20 70 57 68 65 72 65 20 3d 20 73        pWhere = s
9c60: 71 6c 69 74 65 33 45 78 70 72 41 6e 64 28 64 62  qlite3ExprAnd(db
9c70: 2c 20 70 57 68 65 72 65 2c 20 70 45 71 29 3b 0a  , pWhere, pEq);.
9c80: 0a 20 20 20 20 20 20 2f 2a 20 46 6f 72 20 4f 4e  .      /* For ON
9c90: 20 55 50 44 41 54 45 2c 20 63 6f 6e 73 74 72 75   UPDATE, constru
9ca0: 63 74 20 74 68 65 20 6e 65 78 74 20 74 65 72 6d  ct the next term
9cb0: 20 6f 66 20 74 68 65 20 57 48 45 4e 20 63 6c 61   of the WHEN cla
9cc0: 75 73 65 2e 0a 20 20 20 20 20 20 2a 2a 20 54 68  use..      ** Th
9cd0: 65 20 66 69 6e 61 6c 20 57 48 45 4e 20 63 6c 61  e final WHEN cla
9ce0: 75 73 65 20 77 69 6c 6c 20 62 65 20 6c 69 6b 65  use will be like
9cf0: 20 74 68 69 73 3a 0a 20 20 20 20 20 20 2a 2a 0a   this:.      **.
9d00: 20 20 20 20 20 20 2a 2a 20 20 20 20 57 48 45 4e        **    WHEN
9d10: 20 4e 4f 54 28 6f 6c 64 2e 63 6f 6c 31 20 49 53   NOT(old.col1 IS
9d20: 20 6e 65 77 2e 63 6f 6c 31 20 41 4e 44 20 2e 2e   new.col1 AND ..
9d30: 2e 20 41 4e 44 20 6f 6c 64 2e 63 6f 6c 4e 20 49  . AND old.colN I
9d40: 53 20 6e 65 77 2e 63 6f 6c 4e 29 0a 20 20 20 20  S new.colN).    
9d50: 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 70    */.      if( p
9d60: 43 68 61 6e 67 65 73 20 29 7b 0a 20 20 20 20 20  Changes ){.     
9d70: 20 20 20 70 45 71 20 3d 20 73 71 6c 69 74 65 33     pEq = sqlite3
9d80: 50 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b  PExpr(pParse, TK
9d90: 5f 49 53 2c 0a 20 20 20 20 20 20 20 20 20 20 20  _IS,.           
9da0: 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 50   sqlite3PExpr(pP
9db0: 61 72 73 65 2c 20 54 4b 5f 44 4f 54 2c 20 0a 20  arse, TK_DOT, . 
9dc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c               sql
9dd0: 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65  ite3PExpr(pParse
9de0: 2c 20 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26  , TK_ID, 0, 0, &
9df0: 74 4f 6c 64 29 2c 0a 20 20 20 20 20 20 20 20 20  tOld),.         
9e00: 20 20 20 20 20 73 71 6c 69 74 65 33 50 45 78 70       sqlite3PExp
9e10: 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 49 44 2c  r(pParse, TK_ID,
9e20: 20 30 2c 20 30 2c 20 26 74 54 6f 43 6f 6c 29 2c   0, 0, &tToCol),
9e30: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 30  .              0
9e40: 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 73  ),.            s
9e50: 71 6c 69 74 65 33 50 45 78 70 72 28 70 50 61 72  qlite3PExpr(pPar
9e60: 73 65 2c 20 54 4b 5f 44 4f 54 2c 20 0a 20 20 20  se, TK_DOT, .   
9e70: 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74             sqlit
9e80: 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c 20  e3PExpr(pParse, 
9e90: 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26 74 4e  TK_ID, 0, 0, &tN
9ea0: 65 77 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20  ew),.           
9eb0: 20 20 20 73 71 6c 69 74 65 33 50 45 78 70 72 28     sqlite3PExpr(
9ec0: 70 50 61 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30  pParse, TK_ID, 0
9ed0: 2c 20 30 2c 20 26 74 54 6f 43 6f 6c 29 2c 0a 20  , 0, &tToCol),. 
9ee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 30 29 2c               0),
9ef0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 30 29 3b  .            0);
9f00: 0a 20 20 20 20 20 20 20 20 70 57 68 65 6e 20 3d  .        pWhen =
9f10: 20 73 71 6c 69 74 65 33 45 78 70 72 41 6e 64 28   sqlite3ExprAnd(
9f20: 64 62 2c 20 70 57 68 65 6e 2c 20 70 45 71 29 3b  db, pWhen, pEq);
9f30: 0a 20 20 20 20 20 20 7d 0a 20 20 0a 20 20 20 20  .      }.  .    
9f40: 20 20 69 66 28 20 61 63 74 69 6f 6e 21 3d 4f 45    if( action!=OE
9f50: 5f 52 65 73 74 72 69 63 74 20 26 26 20 28 61 63  _Restrict && (ac
9f60: 74 69 6f 6e 21 3d 4f 45 5f 43 61 73 63 61 64 65  tion!=OE_Cascade
9f70: 20 7c 7c 20 70 43 68 61 6e 67 65 73 29 20 29 7b   || pChanges) ){
9f80: 0a 20 20 20 20 20 20 20 20 45 78 70 72 20 2a 70  .        Expr *p
9f90: 4e 65 77 3b 0a 20 20 20 20 20 20 20 20 69 66 28  New;.        if(
9fa0: 20 61 63 74 69 6f 6e 3d 3d 4f 45 5f 43 61 73 63   action==OE_Casc
9fb0: 61 64 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20  ade ){.         
9fc0: 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 50   pNew = sqlite3P
9fd0: 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f  Expr(pParse, TK_
9fe0: 44 4f 54 2c 20 0a 20 20 20 20 20 20 20 20 20 20  DOT, .          
9ff0: 20 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70    sqlite3PExpr(p
a000: 50 61 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30 2c  Parse, TK_ID, 0,
a010: 20 30 2c 20 26 74 4e 65 77 29 2c 0a 20 20 20 20   0, &tNew),.    
a020: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50          sqlite3P
a030: 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f  Expr(pParse, TK_
a040: 49 44 2c 20 30 2c 20 30 2c 20 26 74 54 6f 43 6f  ID, 0, 0, &tToCo
a050: 6c 29 0a 20 20 20 20 20 20 20 20 20 20 2c 20 30  l).          , 0
a060: 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65  );.        }else
a070: 20 69 66 28 20 61 63 74 69 6f 6e 3d 3d 4f 45 5f   if( action==OE_
a080: 53 65 74 44 66 6c 74 20 29 7b 0a 20 20 20 20 20  SetDflt ){.     
a090: 20 20 20 20 20 45 78 70 72 20 2a 70 44 66 6c 74       Expr *pDflt
a0a0: 20 3d 20 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 2d   = pFKey->pFrom-
a0b0: 3e 61 43 6f 6c 5b 69 46 72 6f 6d 43 6f 6c 5d 2e  >aCol[iFromCol].
a0c0: 70 44 66 6c 74 3b 0a 20 20 20 20 20 20 20 20 20  pDflt;.         
a0d0: 20 69 66 28 20 70 44 66 6c 74 20 29 7b 0a 20 20   if( pDflt ){.  
a0e0: 20 20 20 20 20 20 20 20 20 20 70 4e 65 77 20 3d            pNew =
a0f0: 20 73 71 6c 69 74 65 33 45 78 70 72 44 75 70 28   sqlite3ExprDup(
a100: 64 62 2c 20 70 44 66 6c 74 2c 20 30 29 3b 0a 20  db, pDflt, 0);. 
a110: 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a           }else{.
a120: 20 20 20 20 20 20 20 20 20 20 20 20 70 4e 65 77              pNew
a130: 20 3d 20 73 71 6c 69 74 65 33 50 45 78 70 72 28   = sqlite3PExpr(
a140: 70 50 61 72 73 65 2c 20 54 4b 5f 4e 55 4c 4c 2c  pParse, TK_NULL,
a150: 20 30 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 20   0, 0, 0);.     
a160: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d       }.        }
a170: 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20  else{.          
a180: 70 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 50 45  pNew = sqlite3PE
a190: 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 4e  xpr(pParse, TK_N
a1a0: 55 4c 4c 2c 20 30 2c 20 30 2c 20 30 29 3b 0a 20  ULL, 0, 0, 0);. 
a1b0: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20         }.       
a1c0: 20 70 4c 69 73 74 20 3d 20 73 71 6c 69 74 65 33   pList = sqlite3
a1d0: 45 78 70 72 4c 69 73 74 41 70 70 65 6e 64 28 70  ExprListAppend(p
a1e0: 50 61 72 73 65 2c 20 70 4c 69 73 74 2c 20 70 4e  Parse, pList, pN
a1f0: 65 77 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c  ew);.        sql
a200: 69 74 65 33 45 78 70 72 4c 69 73 74 53 65 74 4e  ite3ExprListSetN
a210: 61 6d 65 28 70 50 61 72 73 65 2c 20 70 4c 69 73  ame(pParse, pLis
a220: 74 2c 20 26 74 46 72 6f 6d 43 6f 6c 2c 20 30 29  t, &tFromCol, 0)
a230: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a  ;.      }.    }.
a240: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65      sqlite3DbFre
a250: 65 28 64 62 2c 20 61 69 43 6f 6c 29 3b 0a 0a 20  e(db, aiCol);.. 
a260: 20 20 20 7a 46 72 6f 6d 20 3d 20 70 46 4b 65 79     zFrom = pFKey
a270: 2d 3e 70 46 72 6f 6d 2d 3e 7a 4e 61 6d 65 3b 0a  ->pFrom->zName;.
a280: 20 20 20 20 6e 46 72 6f 6d 20 3d 20 73 71 6c 69      nFrom = sqli
a290: 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 46 72 6f  te3Strlen30(zFro
a2a0: 6d 29 3b 0a 0a 20 20 20 20 69 66 28 20 61 63 74  m);..    if( act
a2b0: 69 6f 6e 3d 3d 4f 45 5f 52 65 73 74 72 69 63 74  ion==OE_Restrict
a2c0: 20 29 7b 0a 20 20 20 20 20 20 54 6f 6b 65 6e 20   ){.      Token 
a2d0: 74 46 72 6f 6d 3b 0a 20 20 20 20 20 20 45 78 70  tFrom;.      Exp
a2e0: 72 20 2a 70 52 61 69 73 65 3b 20 0a 0a 20 20 20  r *pRaise; ..   
a2f0: 20 20 20 74 46 72 6f 6d 2e 7a 20 3d 20 7a 46 72     tFrom.z = zFr
a300: 6f 6d 3b 0a 20 20 20 20 20 20 74 46 72 6f 6d 2e  om;.      tFrom.
a310: 6e 20 3d 20 6e 46 72 6f 6d 3b 0a 20 20 20 20 20  n = nFrom;.     
a320: 20 70 52 61 69 73 65 20 3d 20 73 71 6c 69 74 65   pRaise = sqlite
a330: 33 45 78 70 72 28 64 62 2c 20 54 4b 5f 52 41 49  3Expr(db, TK_RAI
a340: 53 45 2c 20 22 66 6f 72 65 69 67 6e 20 6b 65 79  SE, "foreign key
a350: 20 63 6f 6e 73 74 72 61 69 6e 74 20 66 61 69 6c   constraint fail
a360: 65 64 22 29 3b 0a 20 20 20 20 20 20 69 66 28 20  ed");.      if( 
a370: 70 52 61 69 73 65 20 29 7b 0a 20 20 20 20 20 20  pRaise ){.      
a380: 20 20 70 52 61 69 73 65 2d 3e 61 66 66 69 6e 69    pRaise->affini
a390: 74 79 20 3d 20 4f 45 5f 41 62 6f 72 74 3b 0a 20  ty = OE_Abort;. 
a3a0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 53 65       }.      pSe
a3b0: 6c 65 63 74 20 3d 20 73 71 6c 69 74 65 33 53 65  lect = sqlite3Se
a3c0: 6c 65 63 74 4e 65 77 28 70 50 61 72 73 65 2c 20  lectNew(pParse, 
a3d0: 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74  .          sqlit
a3e0: 65 33 45 78 70 72 4c 69 73 74 41 70 70 65 6e 64  e3ExprListAppend
a3f0: 28 70 50 61 72 73 65 2c 20 30 2c 20 70 52 61 69  (pParse, 0, pRai
a400: 73 65 29 2c 0a 20 20 20 20 20 20 20 20 20 20 73  se),.          s
a410: 71 6c 69 74 65 33 53 72 63 4c 69 73 74 41 70 70  qlite3SrcListApp
a420: 65 6e 64 28 64 62 2c 20 30 2c 20 26 74 46 72 6f  end(db, 0, &tFro
a430: 6d 2c 20 30 29 2c 0a 20 20 20 20 20 20 20 20 20  m, 0),.         
a440: 20 70 57 68 65 72 65 2c 0a 20 20 20 20 20 20 20   pWhere,.       
a450: 20 20 20 30 2c 20 30 2c 20 30 2c 20 30 2c 20 30     0, 0, 0, 0, 0
a460: 2c 20 30 0a 20 20 20 20 20 20 29 3b 0a 20 20 20  , 0.      );.   
a470: 20 20 20 70 57 68 65 72 65 20 3d 20 30 3b 0a 20     pWhere = 0;. 
a480: 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 6e 20     }..    /* In 
a490: 74 68 65 20 63 75 72 72 65 6e 74 20 69 6d 70 6c  the current impl
a4a0: 65 6d 65 6e 74 61 74 69 6f 6e 2c 20 70 54 61 62  ementation, pTab
a4b0: 2d 3e 64 62 4d 65 6d 3d 3d 30 20 66 6f 72 20 61  ->dbMem==0 for a
a4c0: 6c 6c 20 74 61 62 6c 65 73 20 65 78 63 65 70 74  ll tables except
a4d0: 0a 20 20 20 20 2a 2a 20 66 6f 72 20 74 65 6d 70  .    ** for temp
a4e0: 6f 72 61 72 79 20 74 61 62 6c 65 73 20 75 73 65  orary tables use
a4f0: 64 20 74 6f 20 64 65 73 63 72 69 62 65 20 73 75  d to describe su
a500: 62 71 75 65 72 69 65 73 2e 20 20 41 6e 64 20 74  bqueries.  And t
a510: 65 6d 70 6f 72 61 72 79 0a 20 20 20 20 2a 2a 20  emporary.    ** 
a520: 74 61 62 6c 65 73 20 64 6f 20 6e 6f 74 20 68 61  tables do not ha
a530: 76 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63  ve foreign key c
a540: 6f 6e 73 74 72 61 69 6e 74 73 2e 20 20 48 65 6e  onstraints.  Hen
a550: 63 65 2c 20 70 54 61 62 2d 3e 64 62 4d 65 6d 0a  ce, pTab->dbMem.
a560: 20 20 20 20 2a 2a 20 73 68 6f 75 6c 64 20 61 6c      ** should al
a570: 77 61 79 73 20 62 65 20 30 20 74 68 65 72 65 2e  ways be 0 there.
a580: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 65 6e 61 62  .    */.    enab
a590: 6c 65 4c 6f 6f 6b 61 73 69 64 65 20 3d 20 64 62  leLookaside = db
a5a0: 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e 61  ->lookaside.bEna
a5b0: 62 6c 65 64 3b 0a 20 20 20 20 64 62 2d 3e 6c 6f  bled;.    db->lo
a5c0: 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 64  okaside.bEnabled
a5d0: 20 3d 20 30 3b 0a 0a 20 20 20 20 70 54 72 69 67   = 0;..    pTrig
a5e0: 67 65 72 20 3d 20 28 54 72 69 67 67 65 72 20 2a  ger = (Trigger *
a5f0: 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f 63  )sqlite3DbMalloc
a600: 5a 65 72 6f 28 64 62 2c 20 0a 20 20 20 20 20 20  Zero(db, .      
a610: 20 20 73 69 7a 65 6f 66 28 54 72 69 67 67 65 72    sizeof(Trigger
a620: 29 20 2b 20 20 20 20 20 20 20 20 20 2f 2a 20 73  ) +         /* s
a630: 74 72 75 63 74 20 54 72 69 67 67 65 72 20 2a 2f  truct Trigger */
a640: 0a 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66 28  .        sizeof(
a650: 54 72 69 67 67 65 72 53 74 65 70 29 20 2b 20 20  TriggerStep) +  
a660: 20 20 20 2f 2a 20 53 69 6e 67 6c 65 20 73 74 65     /* Single ste
a670: 70 20 69 6e 20 74 72 69 67 67 65 72 20 70 72 6f  p in trigger pro
a680: 67 72 61 6d 20 2a 2f 0a 20 20 20 20 20 20 20 20  gram */.        
a690: 6e 46 72 6f 6d 20 2b 20 31 20 20 20 20 20 20 20  nFrom + 1       
a6a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 70 61            /* Spa
a6b0: 63 65 20 66 6f 72 20 70 53 74 65 70 2d 3e 74 61  ce for pStep->ta
a6c0: 72 67 65 74 2e 7a 20 2a 2f 0a 20 20 20 20 29 3b  rget.z */.    );
a6d0: 0a 20 20 20 20 69 66 28 20 70 54 72 69 67 67 65  .    if( pTrigge
a6e0: 72 20 29 7b 0a 20 20 20 20 20 20 70 53 74 65 70  r ){.      pStep
a6f0: 20 3d 20 70 54 72 69 67 67 65 72 2d 3e 73 74 65   = pTrigger->ste
a700: 70 5f 6c 69 73 74 20 3d 20 28 54 72 69 67 67 65  p_list = (Trigge
a710: 72 53 74 65 70 20 2a 29 26 70 54 72 69 67 67 65  rStep *)&pTrigge
a720: 72 5b 31 5d 3b 0a 20 20 20 20 20 20 70 53 74 65  r[1];.      pSte
a730: 70 2d 3e 74 61 72 67 65 74 2e 7a 20 3d 20 28 63  p->target.z = (c
a740: 68 61 72 20 2a 29 26 70 53 74 65 70 5b 31 5d 3b  har *)&pStep[1];
a750: 0a 20 20 20 20 20 20 70 53 74 65 70 2d 3e 74 61  .      pStep->ta
a760: 72 67 65 74 2e 6e 20 3d 20 6e 46 72 6f 6d 3b 0a  rget.n = nFrom;.
a770: 20 20 20 20 20 20 6d 65 6d 63 70 79 28 28 63 68        memcpy((ch
a780: 61 72 20 2a 29 70 53 74 65 70 2d 3e 74 61 72 67  ar *)pStep->targ
a790: 65 74 2e 7a 2c 20 7a 46 72 6f 6d 2c 20 6e 46 72  et.z, zFrom, nFr
a7a0: 6f 6d 29 3b 0a 20 20 0a 20 20 20 20 20 20 70 53  om);.  .      pS
a7b0: 74 65 70 2d 3e 70 57 68 65 72 65 20 3d 20 73 71  tep->pWhere = sq
a7c0: 6c 69 74 65 33 45 78 70 72 44 75 70 28 64 62 2c  lite3ExprDup(db,
a7d0: 20 70 57 68 65 72 65 2c 20 45 58 50 52 44 55 50   pWhere, EXPRDUP
a7e0: 5f 52 45 44 55 43 45 29 3b 0a 20 20 20 20 20 20  _REDUCE);.      
a7f0: 70 53 74 65 70 2d 3e 70 45 78 70 72 4c 69 73 74  pStep->pExprList
a800: 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69   = sqlite3ExprLi
a810: 73 74 44 75 70 28 64 62 2c 20 70 4c 69 73 74 2c  stDup(db, pList,
a820: 20 45 58 50 52 44 55 50 5f 52 45 44 55 43 45 29   EXPRDUP_REDUCE)
a830: 3b 0a 20 20 20 20 20 20 70 53 74 65 70 2d 3e 70  ;.      pStep->p
a840: 53 65 6c 65 63 74 20 3d 20 73 71 6c 69 74 65 33  Select = sqlite3
a850: 53 65 6c 65 63 74 44 75 70 28 64 62 2c 20 70 53  SelectDup(db, pS
a860: 65 6c 65 63 74 2c 20 45 58 50 52 44 55 50 5f 52  elect, EXPRDUP_R
a870: 45 44 55 43 45 29 3b 0a 20 20 20 20 20 20 69 66  EDUCE);.      if
a880: 28 20 70 57 68 65 6e 20 29 7b 0a 20 20 20 20 20  ( pWhen ){.     
a890: 20 20 20 70 57 68 65 6e 20 3d 20 73 71 6c 69 74     pWhen = sqlit
a8a0: 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c 20  e3PExpr(pParse, 
a8b0: 54 4b 5f 4e 4f 54 2c 20 70 57 68 65 6e 2c 20 30  TK_NOT, pWhen, 0
a8c0: 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 70 54  , 0);.        pT
a8d0: 72 69 67 67 65 72 2d 3e 70 57 68 65 6e 20 3d 20  rigger->pWhen = 
a8e0: 73 71 6c 69 74 65 33 45 78 70 72 44 75 70 28 64  sqlite3ExprDup(d
a8f0: 62 2c 20 70 57 68 65 6e 2c 20 45 58 50 52 44 55  b, pWhen, EXPRDU
a900: 50 5f 52 45 44 55 43 45 29 3b 0a 20 20 20 20 20  P_REDUCE);.     
a910: 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a   }.    }..    /*
a920: 20 52 65 2d 65 6e 61 62 6c 65 20 74 68 65 20 6c   Re-enable the l
a930: 6f 6f 6b 61 73 69 64 65 20 62 75 66 66 65 72 2c  ookaside buffer,
a940: 20 69 66 20 69 74 20 77 61 73 20 64 69 73 61 62   if it was disab
a950: 6c 65 64 20 65 61 72 6c 69 65 72 2e 20 2a 2f 0a  led earlier. */.
a960: 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64      db->lookasid
a970: 65 2e 62 45 6e 61 62 6c 65 64 20 3d 20 65 6e 61  e.bEnabled = ena
a980: 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 3b 0a 0a 20  bleLookaside;.. 
a990: 20 20 20 73 71 6c 69 74 65 33 45 78 70 72 44 65     sqlite3ExprDe
a9a0: 6c 65 74 65 28 64 62 2c 20 70 57 68 65 72 65 29  lete(db, pWhere)
a9b0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 70  ;.    sqlite3Exp
a9c0: 72 44 65 6c 65 74 65 28 64 62 2c 20 70 57 68 65  rDelete(db, pWhe
a9d0: 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45  n);.    sqlite3E
a9e0: 78 70 72 4c 69 73 74 44 65 6c 65 74 65 28 64 62  xprListDelete(db
a9f0: 2c 20 70 4c 69 73 74 29 3b 0a 20 20 20 20 73 71  , pList);.    sq
aa00: 6c 69 74 65 33 53 65 6c 65 63 74 44 65 6c 65 74  lite3SelectDelet
aa10: 65 28 64 62 2c 20 70 53 65 6c 65 63 74 29 3b 0a  e(db, pSelect);.
aa20: 20 20 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c      if( db->mall
aa30: 6f 63 46 61 69 6c 65 64 3d 3d 31 20 29 7b 0a 20  ocFailed==1 ){. 
aa40: 20 20 20 20 20 66 6b 54 72 69 67 67 65 72 44 65       fkTriggerDe
aa50: 6c 65 74 65 28 64 62 2c 20 70 54 72 69 67 67 65  lete(db, pTrigge
aa60: 72 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 6e  r);.      return
aa70: 20 30 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 73   0;.    }..    s
aa80: 77 69 74 63 68 28 20 61 63 74 69 6f 6e 20 29 7b  witch( action ){
aa90: 0a 20 20 20 20 20 20 63 61 73 65 20 4f 45 5f 52  .      case OE_R
aaa0: 65 73 74 72 69 63 74 3a 0a 20 20 20 20 20 20 20  estrict:.       
aab0: 20 70 53 74 65 70 2d 3e 6f 70 20 3d 20 54 4b 5f   pStep->op = TK_
aac0: 53 45 4c 45 43 54 3b 20 0a 20 20 20 20 20 20 20  SELECT; .       
aad0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 63 61   break;.      ca
aae0: 73 65 20 4f 45 5f 43 61 73 63 61 64 65 3a 20 0a  se OE_Cascade: .
aaf0: 20 20 20 20 20 20 20 20 69 66 28 20 21 70 43 68          if( !pCh
ab00: 61 6e 67 65 73 20 29 7b 20 0a 20 20 20 20 20 20  anges ){ .      
ab10: 20 20 20 20 70 53 74 65 70 2d 3e 6f 70 20 3d 20      pStep->op = 
ab20: 54 4b 5f 44 45 4c 45 54 45 3b 20 0a 20 20 20 20  TK_DELETE; .    
ab30: 20 20 20 20 20 20 62 72 65 61 6b 3b 20 0a 20 20        break; .  
ab40: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 64 65        }.      de
ab50: 66 61 75 6c 74 3a 0a 20 20 20 20 20 20 20 20 70  fault:.        p
ab60: 53 74 65 70 2d 3e 6f 70 20 3d 20 54 4b 5f 55 50  Step->op = TK_UP
ab70: 44 41 54 45 3b 0a 20 20 20 20 7d 0a 20 20 20 20  DATE;.    }.    
ab80: 70 53 74 65 70 2d 3e 70 54 72 69 67 20 3d 20 70  pStep->pTrig = p
ab90: 54 72 69 67 67 65 72 3b 0a 20 20 20 20 70 54 72  Trigger;.    pTr
aba0: 69 67 67 65 72 2d 3e 70 53 63 68 65 6d 61 20 3d  igger->pSchema =
abb0: 20 70 54 61 62 2d 3e 70 53 63 68 65 6d 61 3b 0a   pTab->pSchema;.
abc0: 20 20 20 20 70 54 72 69 67 67 65 72 2d 3e 70 54      pTrigger->pT
abd0: 61 62 53 63 68 65 6d 61 20 3d 20 70 54 61 62 2d  abSchema = pTab-
abe0: 3e 70 53 63 68 65 6d 61 3b 0a 20 20 20 20 70 46  >pSchema;.    pF
abf0: 4b 65 79 2d 3e 61 70 54 72 69 67 67 65 72 5b 69  Key->apTrigger[i
ac00: 41 63 74 69 6f 6e 5d 20 3d 20 70 54 72 69 67 67  Action] = pTrigg
ac10: 65 72 3b 0a 20 20 20 20 70 54 72 69 67 67 65 72  er;.    pTrigger
ac20: 2d 3e 6f 70 20 3d 20 28 70 43 68 61 6e 67 65 73  ->op = (pChanges
ac30: 20 3f 20 54 4b 5f 55 50 44 41 54 45 20 3a 20 54   ? TK_UPDATE : T
ac40: 4b 5f 44 45 4c 45 54 45 29 3b 0a 20 20 7d 0a 0a  K_DELETE);.  }..
ac50: 20 20 72 65 74 75 72 6e 20 70 54 72 69 67 67 65    return pTrigge
ac60: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  r;.}../*.** This
ac70: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c   function is cal
ac80: 6c 65 64 20 77 68 65 6e 20 64 65 6c 65 74 69 6e  led when deletin
ac90: 67 20 6f 72 20 75 70 64 61 74 69 6e 67 20 61 20  g or updating a 
aca0: 72 6f 77 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74  row to implement
acb0: 0a 2a 2a 20 61 6e 79 20 72 65 71 75 69 72 65 64  .** any required
acc0: 20 43 41 53 43 41 44 45 2c 20 53 45 54 20 4e 55   CASCADE, SET NU
acd0: 4c 4c 20 6f 72 20 53 45 54 20 44 45 46 41 55 4c  LL or SET DEFAUL
ace0: 54 20 61 63 74 69 6f 6e 73 2e 0a 2a 2f 0a 76 6f  T actions..*/.vo
acf0: 69 64 20 73 71 6c 69 74 65 33 46 6b 41 63 74 69  id sqlite3FkActi
ad00: 6f 6e 73 28 0a 20 20 50 61 72 73 65 20 2a 70 50  ons(.  Parse *pP
ad10: 61 72 73 65 2c 20 20 20 20 20 20 20 20 20 20 20  arse,           
ad20: 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 65 20         /* Parse 
ad30: 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 54 61 62  context */.  Tab
ad40: 6c 65 20 2a 70 54 61 62 2c 20 20 20 20 20 20 20  le *pTab,       
ad50: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
ad60: 54 61 62 6c 65 20 62 65 69 6e 67 20 75 70 64 61  Table being upda
ad70: 74 65 64 20 6f 72 20 64 65 6c 65 74 65 64 20 66  ted or deleted f
ad80: 72 6f 6d 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73  rom */.  ExprLis
ad90: 74 20 2a 70 43 68 61 6e 67 65 73 2c 20 20 20 20  t *pChanges,    
ada0: 20 20 20 20 20 20 20 20 20 2f 2a 20 43 68 61 6e           /* Chan
adb0: 67 65 2d 6c 69 73 74 20 66 6f 72 20 55 50 44 41  ge-list for UPDA
adc0: 54 45 2c 20 4e 55 4c 4c 20 66 6f 72 20 44 45 4c  TE, NULL for DEL
add0: 45 54 45 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67  ETE */.  int reg
ade0: 4f 6c 64 20 20 20 20 20 20 20 20 20 20 20 20 20  Old             
adf0: 20 20 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72           /* Addr
ae00: 65 73 73 20 6f 66 20 61 72 72 61 79 20 63 6f 6e  ess of array con
ae10: 74 61 69 6e 69 6e 67 20 6f 6c 64 20 72 6f 77 20  taining old row 
ae20: 2a 2f 0a 29 7b 0a 20 20 2f 2a 20 49 66 20 66 6f  */.){.  /* If fo
ae30: 72 65 69 67 6e 2d 6b 65 79 20 73 75 70 70 6f 72  reign-key suppor
ae40: 74 20 69 73 20 65 6e 61 62 6c 65 64 2c 20 69 74  t is enabled, it
ae50: 65 72 61 74 65 20 74 68 72 6f 75 67 68 20 61 6c  erate through al
ae60: 6c 20 46 4b 73 20 74 68 61 74 20 0a 20 20 2a 2a  l FKs that .  **
ae70: 20 72 65 66 65 72 20 74 6f 20 74 61 62 6c 65 20   refer to table 
ae80: 70 54 61 62 2e 20 49 66 20 74 68 65 72 65 20 69  pTab. If there i
ae90: 73 20 61 6e 20 61 63 74 69 6f 6e 20 61 73 73 6f  s an action asso
aea0: 63 69 61 74 65 64 20 77 69 74 68 20 74 68 65 20  ciated with the 
aeb0: 46 4b 20 0a 20 20 2a 2a 20 66 6f 72 20 74 68 69  FK .  ** for thi
aec0: 73 20 6f 70 65 72 61 74 69 6f 6e 20 28 65 69 74  s operation (eit
aed0: 68 65 72 20 75 70 64 61 74 65 20 6f 72 20 64 65  her update or de
aee0: 6c 65 74 65 29 2c 20 69 6e 76 6f 6b 65 20 74 68  lete), invoke th
aef0: 65 20 61 73 73 6f 63 69 61 74 65 64 20 0a 20 20  e associated .  
af00: 2a 2a 20 74 72 69 67 67 65 72 20 73 75 62 2d 70  ** trigger sub-p
af10: 72 6f 67 72 61 6d 2e 20 20 2a 2f 0a 20 20 69 66  rogram.  */.  if
af20: 28 20 70 50 61 72 73 65 2d 3e 64 62 2d 3e 66 6c  ( pParse->db->fl
af30: 61 67 73 26 53 51 4c 49 54 45 5f 46 6f 72 65 69  ags&SQLITE_Forei
af40: 67 6e 4b 65 79 73 20 29 7b 0a 20 20 20 20 46 4b  gnKeys ){.    FK
af50: 65 79 20 2a 70 46 4b 65 79 3b 20 20 20 20 20 20  ey *pFKey;      
af60: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49              /* I
af70: 74 65 72 61 74 6f 72 20 76 61 72 69 61 62 6c 65  terator variable
af80: 20 2a 2f 0a 20 20 20 20 66 6f 72 28 70 46 4b 65   */.    for(pFKe
af90: 79 20 3d 20 73 71 6c 69 74 65 33 46 6b 52 65 66  y = sqlite3FkRef
afa0: 65 72 65 6e 63 65 73 28 70 54 61 62 29 3b 20 70  erences(pTab); p
afb0: 46 4b 65 79 3b 20 70 46 4b 65 79 3d 70 46 4b 65  FKey; pFKey=pFKe
afc0: 79 2d 3e 70 4e 65 78 74 54 6f 29 7b 0a 20 20 20  y->pNextTo){.   
afd0: 20 20 20 54 72 69 67 67 65 72 20 2a 70 41 63 74     Trigger *pAct
afe0: 69 6f 6e 20 3d 20 66 6b 41 63 74 69 6f 6e 54 72  ion = fkActionTr
aff0: 69 67 67 65 72 28 70 50 61 72 73 65 2c 20 70 54  igger(pParse, pT
b000: 61 62 2c 20 70 46 4b 65 79 2c 20 70 43 68 61 6e  ab, pFKey, pChan
b010: 67 65 73 29 3b 0a 20 20 20 20 20 20 69 66 28 20  ges);.      if( 
b020: 70 41 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20  pAction ){.     
b030: 20 20 20 73 71 6c 69 74 65 33 43 6f 64 65 52 6f     sqlite3CodeRo
b040: 77 54 72 69 67 67 65 72 44 69 72 65 63 74 28 70  wTriggerDirect(p
b050: 50 61 72 73 65 2c 20 70 41 63 74 69 6f 6e 2c 20  Parse, pAction, 
b060: 70 54 61 62 2c 20 72 65 67 4f 6c 64 2c 20 4f 45  pTab, regOld, OE
b070: 5f 41 62 6f 72 74 2c 20 30 29 3b 0a 20 20 20 20  _Abort, 0);.    
b080: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a    }.    }.  }.}.
b090: 0a 23 65 6e 64 69 66 20 2f 2a 20 69 66 6e 64 65  .#endif /* ifnde
b0a0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 52  f SQLITE_OMIT_TR
b0b0: 49 47 47 45 52 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20  IGGER */../*.** 
b0c0: 46 72 65 65 20 61 6c 6c 20 6d 65 6d 6f 72 79 20  Free all memory 
b0d0: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20  associated with 
b0e0: 66 6f 72 65 69 67 6e 20 6b 65 79 20 64 65 66 69  foreign key defi
b0f0: 6e 69 74 69 6f 6e 73 20 61 74 74 61 63 68 65 64  nitions attached
b100: 20 74 6f 0a 2a 2a 20 74 61 62 6c 65 20 70 54 61   to.** table pTa
b110: 62 2e 20 52 65 6d 6f 76 65 20 74 68 65 20 64 65  b. Remove the de
b120: 6c 65 74 65 64 20 66 6f 72 65 69 67 6e 20 6b 65  leted foreign ke
b130: 79 73 20 66 72 6f 6d 20 74 68 65 20 53 63 68 65  ys from the Sche
b140: 6d 61 2e 66 6b 65 79 48 61 73 68 0a 2a 2a 20 68  ma.fkeyHash.** h
b150: 61 73 68 20 74 61 62 6c 65 2e 0a 2a 2f 0a 76 6f  ash table..*/.vo
b160: 69 64 20 73 71 6c 69 74 65 33 46 6b 44 65 6c 65  id sqlite3FkDele
b170: 74 65 28 54 61 62 6c 65 20 2a 70 54 61 62 29 7b  te(Table *pTab){
b180: 0a 20 20 46 4b 65 79 20 2a 70 46 4b 65 79 3b 20  .  FKey *pFKey; 
b190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
b1a0: 20 20 20 2f 2a 20 49 74 65 72 61 74 6f 72 20 76     /* Iterator v
b1b0: 61 72 69 61 62 6c 65 20 2a 2f 0a 20 20 46 4b 65  ariable */.  FKe
b1c0: 79 20 2a 70 4e 65 78 74 3b 20 20 20 20 20 20 20  y *pNext;       
b1d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
b1e0: 43 6f 70 79 20 6f 66 20 70 46 4b 65 79 2d 3e 70  Copy of pFKey->p
b1f0: 4e 65 78 74 46 72 6f 6d 20 2a 2f 0a 0a 20 20 66  NextFrom */..  f
b200: 6f 72 28 70 46 4b 65 79 3d 70 54 61 62 2d 3e 70  or(pFKey=pTab->p
b210: 46 4b 65 79 3b 20 70 46 4b 65 79 3b 20 70 46 4b  FKey; pFKey; pFK
b220: 65 79 3d 70 4e 65 78 74 29 7b 0a 0a 20 20 20 20  ey=pNext){..    
b230: 2f 2a 20 52 65 6d 6f 76 65 20 74 68 65 20 46 4b  /* Remove the FK
b240: 20 66 72 6f 6d 20 74 68 65 20 66 6b 65 79 48 61   from the fkeyHa
b250: 73 68 20 68 61 73 68 20 74 61 62 6c 65 2e 20 2a  sh hash table. *
b260: 2f 0a 20 20 20 20 69 66 28 20 70 46 4b 65 79 2d  /.    if( pFKey-
b270: 3e 70 50 72 65 76 54 6f 20 29 7b 0a 20 20 20 20  >pPrevTo ){.    
b280: 20 20 70 46 4b 65 79 2d 3e 70 50 72 65 76 54 6f    pFKey->pPrevTo
b290: 2d 3e 70 4e 65 78 74 54 6f 20 3d 20 70 46 4b 65  ->pNextTo = pFKe
b2a0: 79 2d 3e 70 4e 65 78 74 54 6f 3b 0a 20 20 20 20  y->pNextTo;.    
b2b0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 76 6f 69  }else{.      voi
b2c0: 64 20 2a 64 61 74 61 20 3d 20 28 76 6f 69 64 20  d *data = (void 
b2d0: 2a 29 70 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f  *)pFKey->pNextTo
b2e0: 3b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68  ;.      const ch
b2f0: 61 72 20 2a 7a 20 3d 20 28 64 61 74 61 20 3f 20  ar *z = (data ? 
b300: 70 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f 2d 3e  pFKey->pNextTo->
b310: 7a 54 6f 20 3a 20 70 46 4b 65 79 2d 3e 7a 54 6f  zTo : pFKey->zTo
b320: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
b330: 48 61 73 68 49 6e 73 65 72 74 28 26 70 54 61 62  HashInsert(&pTab
b340: 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 6b 65 79 48  ->pSchema->fkeyH
b350: 61 73 68 2c 20 7a 2c 20 73 71 6c 69 74 65 33 53  ash, z, sqlite3S
b360: 74 72 6c 65 6e 33 30 28 7a 29 2c 20 64 61 74 61  trlen30(z), data
b370: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28  );.    }.    if(
b380: 20 70 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f 20   pFKey->pNextTo 
b390: 29 7b 0a 20 20 20 20 20 20 70 46 4b 65 79 2d 3e  ){.      pFKey->
b3a0: 70 4e 65 78 74 54 6f 2d 3e 70 50 72 65 76 54 6f  pNextTo->pPrevTo
b3b0: 20 3d 20 70 46 4b 65 79 2d 3e 70 50 72 65 76 54   = pFKey->pPrevT
b3c0: 6f 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a  o;.    }..    /*
b3d0: 20 44 65 6c 65 74 65 20 61 6e 79 20 74 72 69 67   Delete any trig
b3e0: 67 65 72 73 20 63 72 65 61 74 65 64 20 74 6f 20  gers created to 
b3f0: 69 6d 70 6c 65 6d 65 6e 74 20 61 63 74 69 6f 6e  implement action
b400: 73 20 66 6f 72 20 74 68 69 73 20 46 4b 2e 20 2a  s for this FK. *
b410: 2f 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  /.#ifndef SQLITE
b420: 5f 4f 4d 49 54 5f 54 52 49 47 47 45 52 0a 20 20  _OMIT_TRIGGER.  
b430: 20 20 66 6b 54 72 69 67 67 65 72 44 65 6c 65 74    fkTriggerDelet
b440: 65 28 70 54 61 62 2d 3e 64 62 4d 65 6d 2c 20 70  e(pTab->dbMem, p
b450: 46 4b 65 79 2d 3e 61 70 54 72 69 67 67 65 72 5b  FKey->apTrigger[
b460: 30 5d 29 3b 0a 20 20 20 20 66 6b 54 72 69 67 67  0]);.    fkTrigg
b470: 65 72 44 65 6c 65 74 65 28 70 54 61 62 2d 3e 64  erDelete(pTab->d
b480: 62 4d 65 6d 2c 20 70 46 4b 65 79 2d 3e 61 70 54  bMem, pFKey->apT
b490: 72 69 67 67 65 72 5b 31 5d 29 3b 0a 23 65 6e 64  rigger[1]);.#end
b4a0: 69 66 0a 0a 20 20 20 20 2f 2a 20 44 65 6c 65 74  if..    /* Delet
b4b0: 65 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c  e the memory all
b4c0: 6f 63 61 74 65 64 20 66 6f 72 20 74 68 65 20 46  ocated for the F
b4d0: 4b 20 73 74 72 75 63 74 75 72 65 2e 20 2a 2f 0a  K structure. */.
b4e0: 20 20 20 20 70 4e 65 78 74 20 3d 20 70 46 4b 65      pNext = pFKe
b4f0: 79 2d 3e 70 4e 65 78 74 46 72 6f 6d 3b 0a 20 20  y->pNextFrom;.  
b500: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28    sqlite3DbFree(
b510: 70 54 61 62 2d 3e 64 62 4d 65 6d 2c 20 70 46 4b  pTab->dbMem, pFK
b520: 65 79 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69  ey);.  }.}.#endi
b530: 66 20 2f 2a 20 69 66 6e 64 65 66 20 53 51 4c 49  f /* ifndef SQLI
b540: 54 45 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 4e 5f  TE_OMIT_FOREIGN_
b550: 4b 45 59 20 2a 2f 0a                             KEY */.