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 66 6f 72 20 61 20 he schema for a
17a0: 75 6e 69 71 75 65 20 69 6e 64 65 78 20 6f 6e 20 unique index on
17b0: 74 68 65 20 70 61 72 65 6e 74 20 6b 65 79 20 63 the parent key c
17c0: 6f 6c 75 6d 6e 73 2e 20 0a 2a 2a 0a 2a 2a 20 49 olumns. .**.** I
17d0: 66 20 73 75 63 63 65 73 73 66 75 6c 2c 20 7a 65 f successful, ze
17e0: 72 6f 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 ro is returned.
17f0: 49 66 20 74 68 65 20 70 61 72 65 6e 74 20 6b 65 If the parent ke
1800: 79 20 69 73 20 61 6e 20 49 4e 54 45 47 45 52 20 y is an INTEGER
1810: 50 52 49 4d 41 52 59 20 0a 2a 2a 20 4b 45 59 20 PRIMARY .** KEY
1820: 63 6f 6c 75 6d 6e 2c 20 74 68 65 6e 20 6f 75 74 column, then out
1830: 70 75 74 20 76 61 72 69 61 62 6c 65 20 2a 70 70 put variable *pp
1840: 49 64 78 20 69 73 20 73 65 74 20 74 6f 20 4e 55 Idx is set to NU
1850: 4c 4c 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 2a LL. Otherwise, *
1860: 70 70 49 64 78 20 0a 2a 2a 20 69 73 20 73 65 74 ppIdx .** is set
1870: 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 74 68 65 to point to the
1880: 20 75 6e 69 71 75 65 20 69 6e 64 65 78 2e 20 0a unique index. .
1890: 2a 2a 20 0a 2a 2a 20 49 66 20 74 68 65 20 70 61 ** .** If the pa
18a0: 72 65 6e 74 20 6b 65 79 20 63 6f 6e 73 69 73 74 rent key consist
18b0: 73 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 63 6f s of a single co
18c0: 6c 75 6d 6e 20 28 74 68 65 20 66 6f 72 65 69 67 lumn (the foreig
18d0: 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 n key constraint
18e0: 0a 2a 2a 20 69 73 20 6e 6f 74 20 61 20 63 6f 6d .** is not a com
18f0: 70 6f 73 69 74 65 20 66 6f 72 65 69 67 6e 20 6b posite foreign k
1900: 65 79 29 2c 20 6f 75 74 70 75 74 20 76 61 72 69 ey), output vari
1910: 61 62 6c 65 20 2a 70 61 69 43 6f 6c 20 69 73 20 able *paiCol is
1920: 73 65 74 20 74 6f 20 4e 55 4c 4c 2e 0a 2a 2a 20 set to NULL..**
1930: 4f 74 68 65 72 77 69 73 65 2c 20 69 74 20 69 73 Otherwise, it is
1940: 20 73 65 74 20 74 6f 20 70 6f 69 6e 74 20 74 6f set to point to
1950: 20 61 6e 20 61 6c 6c 6f 63 61 74 65 64 20 61 72 an allocated ar
1960: 72 61 79 20 6f 66 20 73 69 7a 65 20 4e 2c 20 77 ray of size N, w
1970: 68 65 72 65 0a 2a 2a 20 4e 20 69 73 20 74 68 65 here.** N is the
1980: 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d number of colum
1990: 6e 73 20 69 6e 20 74 68 65 20 70 61 72 65 6e 74 ns in the parent
19a0: 20 6b 65 79 2e 20 54 68 65 20 66 69 72 73 74 20 key. The first
19b0: 65 6c 65 6d 65 6e 74 20 6f 66 20 74 68 65 0a 2a element of the.*
19c0: 2a 20 61 72 72 61 79 20 69 73 20 74 68 65 20 69 * array is the i
19d0: 6e 64 65 78 20 6f 66 20 74 68 65 20 63 68 69 6c ndex of the chil
19e0: 64 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 74 d table column t
19f0: 68 61 74 20 69 73 20 6d 61 70 70 65 64 20 62 79 hat is mapped by
1a00: 20 74 68 65 20 46 4b 0a 2a 2a 20 63 6f 6e 73 74 the FK.** const
1a10: 72 61 69 6e 74 20 74 6f 20 74 68 65 20 70 61 72 raint to the par
1a20: 65 6e 74 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e ent table column
1a30: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 6c stored in the l
1a40: 65 66 74 2d 6d 6f 73 74 20 63 6f 6c 75 6d 6e 0a eft-most column.
1a50: 2a 2a 20 6f 66 20 69 6e 64 65 78 20 2a 70 70 49 ** of index *ppI
1a60: 64 78 2e 20 54 68 65 20 73 65 63 6f 6e 64 20 65 dx. The second e
1a70: 6c 65 6d 65 6e 74 20 6f 66 20 74 68 65 20 61 72 lement of the ar
1a80: 72 61 79 20 69 73 20 74 68 65 20 69 6e 64 65 78 ray is the index
1a90: 20 6f 66 20 74 68 65 0a 2a 2a 20 63 68 69 6c 64 of the.** child
1aa0: 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e 20 74 68 table column th
1ab0: 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 at corresponds t
1ac0: 6f 20 74 68 65 20 73 65 63 6f 6e 64 20 6c 65 66 o the second lef
1ad0: 74 2d 6d 6f 73 74 20 63 6f 6c 75 6d 6e 20 6f 66 t-most column of
1ae0: 0a 2a 2a 20 2a 70 70 49 64 78 2c 20 61 6e 64 20 .** *ppIdx, and
1af0: 73 6f 20 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 so on..**.** If
1b00: 74 68 65 20 72 65 71 75 69 72 65 64 20 69 6e 64 the required ind
1b10: 65 78 20 63 61 6e 6e 6f 74 20 62 65 20 66 6f 75 ex cannot be fou
1b20: 6e 64 2c 20 65 69 74 68 65 72 20 62 65 63 61 75 nd, either becau
1b30: 73 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 31 29 20 54 se:.**.** 1) T
1b40: 68 65 20 6e 61 6d 65 64 20 70 61 72 65 6e 74 20 he named parent
1b50: 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 64 6f 20 6e key columns do n
1b60: 6f 74 20 65 78 69 73 74 2c 20 6f 72 0a 2a 2a 0a ot exist, or.**.
1b70: 2a 2a 20 20 20 32 29 20 54 68 65 20 6e 61 6d 65 ** 2) The name
1b80: 64 20 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c d parent key col
1b90: 75 6d 6e 73 20 64 6f 20 65 78 69 73 74 2c 20 62 umns do exist, b
1ba0: 75 74 20 61 72 65 20 6e 6f 74 20 73 75 62 6a 65 ut are not subje
1bb0: 63 74 20 74 6f 20 61 0a 2a 2a 20 20 20 20 20 20 ct to a.**
1bc0: 55 4e 49 51 55 45 20 6f 72 20 50 52 49 4d 41 52 UNIQUE or PRIMAR
1bd0: 59 20 4b 45 59 20 63 6f 6e 73 74 72 61 69 6e 74 Y KEY constraint
1be0: 2c 20 6f 72 0a 2a 2a 0a 2a 2a 20 20 20 33 29 20 , or.**.** 3)
1bf0: 4e 6f 20 70 61 72 65 6e 74 20 6b 65 79 20 63 6f No parent key co
1c00: 6c 75 6d 6e 73 20 77 65 72 65 20 70 72 6f 76 69 lumns were provi
1c10: 64 65 64 20 65 78 70 6c 69 63 69 74 6c 79 20 61 ded explicitly a
1c20: 73 20 70 61 72 74 20 6f 66 20 74 68 65 0a 2a 2a s part of the.**
1c30: 20 20 20 20 20 20 66 6f 72 65 69 67 6e 20 6b 65 foreign ke
1c40: 79 20 64 65 66 69 6e 69 74 69 6f 6e 2c 20 61 6e y definition, an
1c50: 64 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 d the parent tab
1c60: 6c 65 20 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 le does not have
1c70: 20 61 0a 2a 2a 20 20 20 20 20 20 50 52 49 4d 41 a.** PRIMA
1c80: 52 59 20 4b 45 59 2c 20 6f 72 0a 2a 2a 0a 2a 2a RY KEY, or.**.**
1c90: 20 20 20 34 29 20 4e 6f 20 70 61 72 65 6e 74 20 4) No parent
1ca0: 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 77 65 72 65 key columns were
1cb0: 20 70 72 6f 76 69 64 65 64 20 65 78 70 6c 69 63 provided explic
1cc0: 69 74 6c 79 20 61 73 20 70 61 72 74 20 6f 66 20 itly as part of
1cd0: 74 68 65 0a 2a 2a 20 20 20 20 20 20 66 6f 72 65 the.** fore
1ce0: 69 67 6e 20 6b 65 79 20 64 65 66 69 6e 69 74 69 ign key definiti
1cf0: 6f 6e 2c 20 61 6e 64 20 74 68 65 20 50 52 49 4d on, and the PRIM
1d00: 41 52 59 20 4b 45 59 20 6f 66 20 74 68 65 20 70 ARY KEY of the p
1d10: 61 72 65 6e 74 20 74 61 62 6c 65 20 0a 2a 2a 20 arent table .**
1d20: 20 20 20 20 20 63 6f 6e 73 69 73 74 73 20 6f 66 consists of
1d30: 20 61 20 61 20 64 69 66 66 65 72 65 6e 74 20 6e a a different n
1d40: 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 umber of columns
1d50: 20 74 6f 20 74 68 65 20 63 68 69 6c 64 20 6b 65 to the child ke
1d60: 79 20 69 6e 20 0a 2a 2a 20 20 20 20 20 20 74 68 y in .** th
1d70: 65 20 63 68 69 6c 64 20 74 61 62 6c 65 2e 0a 2a e child table..*
1d80: 2a 0a 2a 2a 20 74 68 65 6e 20 6e 6f 6e 2d 7a 65 *.** then non-ze
1d90: 72 6f 20 69 73 20 72 65 74 75 72 6e 65 64 2c 20 ro is returned,
1da0: 61 6e 64 20 61 20 22 66 6f 72 65 69 67 6e 20 6b and a "foreign k
1db0: 65 79 20 6d 69 73 6d 61 74 63 68 22 20 65 72 72 ey mismatch" err
1dc0: 6f 72 20 6c 6f 61 64 65 64 0a 2a 2a 20 69 6e 74 or loaded.** int
1dd0: 6f 20 70 50 61 72 73 65 2e 20 49 66 20 61 6e 20 o pParse. If an
1de0: 4f 4f 4d 20 65 72 72 6f 72 20 6f 63 63 75 72 73 OOM error occurs
1df0: 2c 20 6e 6f 6e 2d 7a 65 72 6f 20 69 73 20 72 65 , non-zero is re
1e00: 74 75 72 6e 65 64 20 61 6e 64 20 74 68 65 0a 2a turned and the.*
1e10: 2a 20 70 50 61 72 73 65 2d 3e 64 62 2d 3e 6d 61 * pParse->db->ma
1e20: 6c 6c 6f 63 46 61 69 6c 65 64 20 66 6c 61 67 20 llocFailed flag
1e30: 69 73 20 73 65 74 2e 0a 2a 2f 0a 69 6e 74 20 73 is set..*/.int s
1e40: 71 6c 69 74 65 33 46 6b 4c 6f 63 61 74 65 49 6e qlite3FkLocateIn
1e50: 64 65 78 28 0a 20 20 50 61 72 73 65 20 2a 70 50 dex(. Parse *pP
1e60: 61 72 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 arse,
1e70: 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 65 20 /* Parse
1e80: 63 6f 6e 74 65 78 74 20 74 6f 20 73 74 6f 72 65 context to store
1e90: 20 61 6e 79 20 65 72 72 6f 72 20 69 6e 20 2a 2f any error in */
1ea0: 0a 20 20 54 61 62 6c 65 20 2a 70 50 61 72 65 6e . Table *pParen
1eb0: 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t,
1ec0: 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 74 61 62 /* Parent tab
1ed0: 6c 65 20 6f 66 20 46 4b 20 63 6f 6e 73 74 72 61 le of FK constra
1ee0: 69 6e 74 20 70 46 4b 65 79 20 2a 2f 0a 20 20 46 int pFKey */. F
1ef0: 4b 65 79 20 2a 70 46 4b 65 79 2c 20 20 20 20 20 Key *pFKey,
1f00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1f10: 2a 20 46 6f 72 65 69 67 6e 20 6b 65 79 20 74 6f * Foreign key to
1f20: 20 66 69 6e 64 20 69 6e 64 65 78 20 66 6f 72 20 find index for
1f30: 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 2a 70 70 49 */. Index **ppI
1f40: 64 78 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 dx,
1f50: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 55 6e 69 /* OUT: Uni
1f60: 71 75 65 20 69 6e 64 65 78 20 6f 6e 20 70 61 72 que index on par
1f70: 65 6e 74 20 74 61 62 6c 65 20 2a 2f 0a 20 20 69 ent table */. i
1f80: 6e 74 20 2a 2a 70 61 69 43 6f 6c 20 20 20 20 20 nt **paiCol
1f90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
1fa0: 2a 20 4f 55 54 3a 20 4d 61 70 20 6f 66 20 69 6e * OUT: Map of in
1fb0: 64 65 78 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 70 dex columns in p
1fc0: 46 4b 65 79 20 2a 2f 0a 29 7b 0a 20 20 49 6e 64 FKey */.){. Ind
1fd0: 65 78 20 2a 70 49 64 78 20 3d 20 30 3b 20 20 20 ex *pIdx = 0;
1fe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ff0: 20 2f 2a 20 56 61 6c 75 65 20 74 6f 20 72 65 74 /* Value to ret
2000: 75 72 6e 20 76 69 61 20 2a 70 70 49 64 78 20 2a urn via *ppIdx *
2010: 2f 0a 20 20 69 6e 74 20 2a 61 69 43 6f 6c 20 3d /. int *aiCol =
2020: 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 0;
2030: 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 /* Value
2040: 20 74 6f 20 72 65 74 75 72 6e 20 76 69 61 20 2a to return via *
2050: 70 61 69 43 6f 6c 20 2a 2f 0a 20 20 69 6e 74 20 paiCol */. int
2060: 6e 43 6f 6c 20 3d 20 70 46 4b 65 79 2d 3e 6e 43 nCol = pFKey->nC
2070: 6f 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ol;
2080: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c /* Number of col
2090: 75 6d 6e 73 20 69 6e 20 70 61 72 65 6e 74 20 6b umns in parent k
20a0: 65 79 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 4b ey */. char *zK
20b0: 65 79 20 3d 20 70 46 4b 65 79 2d 3e 61 43 6f 6c ey = pFKey->aCol
20c0: 5b 30 5d 2e 7a 43 6f 6c 3b 20 20 20 2f 2a 20 4e [0].zCol; /* N
20d0: 61 6d 65 20 6f 66 20 6c 65 66 74 2d 6d 6f 73 74 ame of left-most
20e0: 20 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 parent key colu
20f0: 6d 6e 20 2a 2f 0a 0a 20 20 2f 2a 20 54 68 65 20 mn */.. /* The
2100: 63 61 6c 6c 65 72 20 69 73 20 72 65 73 70 6f 6e caller is respon
2110: 73 69 62 6c 65 20 66 6f 72 20 7a 65 72 6f 69 6e sible for zeroin
2120: 67 20 6f 75 74 70 75 74 20 70 61 72 61 6d 65 74 g output paramet
2130: 65 72 73 2e 20 2a 2f 0a 20 20 61 73 73 65 72 74 ers. */. assert
2140: 28 20 70 70 49 64 78 20 26 26 20 2a 70 70 49 64 ( ppIdx && *ppId
2150: 78 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 x==0 );. assert
2160: 28 20 21 70 61 69 43 6f 6c 20 7c 7c 20 2a 70 61 ( !paiCol || *pa
2170: 69 43 6f 6c 3d 3d 30 20 29 3b 0a 20 20 61 73 73 iCol==0 );. ass
2180: 65 72 74 28 20 70 50 61 72 73 65 20 29 3b 0a 0a ert( pParse );..
2190: 20 20 2f 2a 20 49 66 20 74 68 69 73 20 69 73 20 /* If this is
21a0: 61 20 6e 6f 6e 2d 63 6f 6d 70 6f 73 69 74 65 20 a non-composite
21b0: 28 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e 29 20 (single column)
21c0: 66 6f 72 65 69 67 6e 20 6b 65 79 2c 20 63 68 65 foreign key, che
21d0: 63 6b 20 69 66 20 69 74 20 0a 20 20 2a 2a 20 6d ck if it . ** m
21e0: 61 70 73 20 74 6f 20 74 68 65 20 49 4e 54 45 47 aps to the INTEG
21f0: 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f ER PRIMARY KEY o
2200: 66 20 74 61 62 6c 65 20 70 50 61 72 65 6e 74 2e f table pParent.
2210: 20 49 66 20 73 6f 2c 20 6c 65 61 76 65 20 2a 70 If so, leave *p
2220: 70 49 64 78 20 0a 20 20 2a 2a 20 61 6e 64 20 2a pIdx . ** and *
2230: 70 61 69 43 6f 6c 20 73 65 74 20 74 6f 20 7a 65 paiCol set to ze
2240: 72 6f 20 61 6e 64 20 72 65 74 75 72 6e 20 65 61 ro and return ea
2250: 72 6c 79 2e 20 0a 20 20 2a 2a 0a 20 20 2a 2a 20 rly. . **. **
2260: 4f 74 68 65 72 77 69 73 65 2c 20 66 6f 72 20 61 Otherwise, for a
2270: 20 63 6f 6d 70 6f 73 69 74 65 20 66 6f 72 65 69 composite forei
2280: 67 6e 20 6b 65 79 20 28 6d 6f 72 65 20 74 68 61 gn key (more tha
2290: 6e 20 6f 6e 65 20 63 6f 6c 75 6d 6e 29 2c 20 61 n one column), a
22a0: 6c 6c 6f 63 61 74 65 0a 20 20 2a 2a 20 73 70 61 llocate. ** spa
22b0: 63 65 20 66 6f 72 20 74 68 65 20 61 69 43 6f 6c ce for the aiCol
22c0: 20 61 72 72 61 79 20 28 72 65 74 75 72 6e 65 64 array (returned
22d0: 20 76 69 61 20 6f 75 74 70 75 74 20 70 61 72 61 via output para
22e0: 6d 65 74 65 72 20 2a 70 61 69 43 6f 6c 29 2e 0a meter *paiCol)..
22f0: 20 20 2a 2a 20 4e 6f 6e 2d 63 6f 6d 70 6f 73 69 ** Non-composi
2300: 74 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 73 20 te foreign keys
2310: 64 6f 20 6e 6f 74 20 72 65 71 75 69 72 65 20 74 do not require t
2320: 68 65 20 61 69 43 6f 6c 20 61 72 72 61 79 2e 0a he aiCol array..
2330: 20 20 2a 2f 0a 20 20 69 66 28 20 6e 43 6f 6c 3d */. if( nCol=
2340: 3d 31 20 29 7b 0a 20 20 20 20 2f 2a 20 54 68 65 =1 ){. /* The
2350: 20 46 4b 20 6d 61 70 73 20 74 6f 20 74 68 65 20 FK maps to the
2360: 49 50 4b 20 69 66 20 61 6e 79 20 6f 66 20 74 68 IPK if any of th
2370: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 e following are
2380: 74 72 75 65 3a 0a 20 20 20 20 2a 2a 0a 20 20 20 true:. **.
2390: 20 2a 2a 20 20 20 31 29 20 54 68 65 72 65 20 69 ** 1) There i
23a0: 73 20 61 6e 20 49 4e 54 45 47 45 52 20 50 52 49 s an INTEGER PRI
23b0: 4d 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e 20 MARY KEY column
23c0: 61 6e 64 20 74 68 65 20 46 4b 20 69 73 20 69 6d and the FK is im
23d0: 70 6c 69 63 69 74 6c 79 20 0a 20 20 20 20 2a 2a plicitly . **
23e0: 20 20 20 20 20 20 6d 61 70 70 65 64 20 74 6f 20 mapped to
23f0: 74 68 65 20 70 72 69 6d 61 72 79 20 6b 65 79 20 the primary key
2400: 6f 66 20 74 61 62 6c 65 20 70 50 61 72 65 6e 74 of table pParent
2410: 2c 20 6f 72 0a 20 20 20 20 2a 2a 20 20 20 32 29 , or. ** 2)
2420: 20 54 68 65 20 46 4b 20 69 73 20 65 78 70 6c 69 The FK is expli
2430: 63 69 74 6c 79 20 6d 61 70 70 65 64 20 74 6f 20 citly mapped to
2440: 61 20 63 6f 6c 75 6d 6e 20 64 65 63 6c 61 72 65 a column declare
2450: 64 20 61 73 20 49 4e 54 45 47 45 52 0a 20 20 20 d as INTEGER.
2460: 20 2a 2a 20 20 20 20 20 20 50 52 49 4d 41 52 59 ** PRIMARY
2470: 20 4b 45 59 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 KEY.. */.
2480: 20 69 66 28 20 70 50 61 72 65 6e 74 2d 3e 69 50 if( pParent->iP
2490: 4b 65 79 3e 3d 30 20 29 7b 0a 20 20 20 20 20 20 Key>=0 ){.
24a0: 69 66 28 20 21 7a 4b 65 79 20 29 20 72 65 74 75 if( !zKey ) retu
24b0: 72 6e 20 30 3b 0a 20 20 20 20 20 20 69 66 28 20 rn 0;. if(
24c0: 21 73 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28 !sqlite3StrICmp(
24d0: 70 50 61 72 65 6e 74 2d 3e 61 43 6f 6c 5b 70 50 pParent->aCol[pP
24e0: 61 72 65 6e 74 2d 3e 69 50 4b 65 79 5d 2e 7a 4e arent->iPKey].zN
24f0: 61 6d 65 2c 20 7a 4b 65 79 29 20 29 20 72 65 74 ame, zKey) ) ret
2500: 75 72 6e 20 30 3b 0a 20 20 20 20 7d 0a 20 20 7d urn 0;. }. }
2510: 65 6c 73 65 20 69 66 28 20 70 61 69 43 6f 6c 20 else if( paiCol
2520: 29 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6e ){. assert( n
2530: 43 6f 6c 3e 31 20 29 3b 0a 20 20 20 20 61 69 43 Col>1 );. aiC
2540: 6f 6c 20 3d 20 28 69 6e 74 20 2a 29 73 71 6c 69 ol = (int *)sqli
2550: 74 65 33 44 62 4d 61 6c 6c 6f 63 52 61 77 28 70 te3DbMallocRaw(p
2560: 50 61 72 73 65 2d 3e 64 62 2c 20 6e 43 6f 6c 2a Parse->db, nCol*
2570: 73 69 7a 65 6f 66 28 69 6e 74 29 29 3b 0a 20 20 sizeof(int));.
2580: 20 20 69 66 28 20 21 61 69 43 6f 6c 20 29 20 72 if( !aiCol ) r
2590: 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 2a 70 61 eturn 1;. *pa
25a0: 69 43 6f 6c 20 3d 20 61 69 43 6f 6c 3b 0a 20 20 iCol = aiCol;.
25b0: 7d 0a 0a 20 20 66 6f 72 28 70 49 64 78 3d 70 50 }.. for(pIdx=pP
25c0: 61 72 65 6e 74 2d 3e 70 49 6e 64 65 78 3b 20 70 arent->pIndex; p
25d0: 49 64 78 3b 20 70 49 64 78 3d 70 49 64 78 2d 3e Idx; pIdx=pIdx->
25e0: 70 4e 65 78 74 29 7b 0a 20 20 20 20 69 66 28 20 pNext){. if(
25f0: 70 49 64 78 2d 3e 6e 43 6f 6c 75 6d 6e 3d 3d 6e pIdx->nColumn==n
2600: 43 6f 6c 20 26 26 20 70 49 64 78 2d 3e 6f 6e 45 Col && pIdx->onE
2610: 72 72 6f 72 21 3d 4f 45 5f 4e 6f 6e 65 20 29 7b rror!=OE_None ){
2620: 20 0a 20 20 20 20 20 20 2f 2a 20 70 49 64 78 20 . /* pIdx
2630: 69 73 20 61 20 55 4e 49 51 55 45 20 69 6e 64 65 is a UNIQUE inde
2640: 78 20 28 6f 72 20 61 20 50 52 49 4d 41 52 59 20 x (or a PRIMARY
2650: 4b 45 59 29 20 61 6e 64 20 68 61 73 20 74 68 65 KEY) and has the
2660: 20 72 69 67 68 74 20 6e 75 6d 62 65 72 0a 20 20 right number.
2670: 20 20 20 20 2a 2a 20 6f 66 20 63 6f 6c 75 6d 6e ** of column
2680: 73 2e 20 49 66 20 65 61 63 68 20 69 6e 64 65 78 s. If each index
2690: 65 64 20 63 6f 6c 75 6d 6e 20 63 6f 72 72 65 73 ed column corres
26a0: 70 6f 6e 64 73 20 74 6f 20 61 20 66 6f 72 65 69 ponds to a forei
26b0: 67 6e 20 6b 65 79 0a 20 20 20 20 20 20 2a 2a 20 gn key. **
26c0: 63 6f 6c 75 6d 6e 20 6f 66 20 70 46 4b 65 79 2c column of pFKey,
26d0: 20 74 68 65 6e 20 74 68 69 73 20 69 6e 64 65 78 then this index
26e0: 20 69 73 20 61 20 77 69 6e 6e 65 72 2e 20 20 2a is a winner. *
26f0: 2f 0a 0a 20 20 20 20 20 20 69 66 28 20 7a 4b 65 /.. if( zKe
2700: 79 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 y==0 ){.
2710: 2f 2a 20 49 66 20 7a 4b 65 79 20 69 73 20 4e 55 /* If zKey is NU
2720: 4c 4c 2c 20 74 68 65 6e 20 74 68 69 73 20 66 6f LL, then this fo
2730: 72 65 69 67 6e 20 6b 65 79 20 69 73 20 69 6d 70 reign key is imp
2740: 6c 69 63 69 74 6c 79 20 6d 61 70 70 65 64 20 74 licitly mapped t
2750: 6f 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 o . ** th
2760: 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 66 e PRIMARY KEY of
2770: 20 74 61 62 6c 65 20 70 50 61 72 65 6e 74 2e 20 table pParent.
2780: 54 68 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 The PRIMARY KEY
2790: 69 6e 64 65 78 20 6d 61 79 20 62 65 20 0a 20 20 index may be .
27a0: 20 20 20 20 20 20 2a 2a 20 69 64 65 6e 74 69 66 ** identif
27b0: 69 65 64 20 62 79 20 74 68 65 20 74 65 73 74 20 ied by the test
27c0: 28 49 6e 64 65 78 2e 61 75 74 6f 49 6e 64 65 78 (Index.autoIndex
27d0: 3d 3d 32 29 2e 20 20 2a 2f 0a 20 20 20 20 20 20 ==2). */.
27e0: 20 20 69 66 28 20 70 49 64 78 2d 3e 61 75 74 6f if( pIdx->auto
27f0: 49 6e 64 65 78 3d 3d 32 20 29 7b 0a 20 20 20 20 Index==2 ){.
2800: 20 20 20 20 20 20 69 66 28 20 61 69 43 6f 6c 20 if( aiCol
2810: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 ){. i
2820: 6e 74 20 69 3b 0a 20 20 20 20 20 20 20 20 20 20 nt i;.
2830: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 6f for(i=0; i<nCo
2840: 6c 3b 20 69 2b 2b 29 20 61 69 43 6f 6c 5b 69 5d l; i++) aiCol[i]
2850: 20 3d 20 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 69 = pFKey->aCol[i
2860: 5d 2e 69 46 72 6f 6d 3b 0a 20 20 20 20 20 20 20 ].iFrom;.
2870: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 62 }. b
2880: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a reak;. }.
2890: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
28a0: 20 20 20 20 20 2f 2a 20 49 66 20 7a 4b 65 79 20 /* If zKey
28b0: 69 73 20 6e 6f 6e 2d 4e 55 4c 4c 2c 20 74 68 65 is non-NULL, the
28c0: 6e 20 74 68 69 73 20 66 6f 72 65 69 67 6e 20 6b n this foreign k
28d0: 65 79 20 77 61 73 20 64 65 63 6c 61 72 65 64 20 ey was declared
28e0: 74 6f 0a 20 20 20 20 20 20 20 20 2a 2a 20 6d 61 to. ** ma
28f0: 70 20 74 6f 20 61 6e 20 65 78 70 6c 69 63 69 74 p to an explicit
2900: 20 6c 69 73 74 20 6f 66 20 63 6f 6c 75 6d 6e 73 list of columns
2910: 20 69 6e 20 74 61 62 6c 65 20 70 50 61 72 65 6e in table pParen
2920: 74 2e 20 43 68 65 63 6b 20 69 66 20 74 68 69 73 t. Check if this
2930: 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 6e 64 65 . ** inde
2940: 78 20 6d 61 74 63 68 65 73 20 74 68 6f 73 65 20 x matches those
2950: 63 6f 6c 75 6d 6e 73 2e 20 41 6c 73 6f 2c 20 63 columns. Also, c
2960: 68 65 63 6b 20 74 68 61 74 20 74 68 65 20 69 6e heck that the in
2970: 64 65 78 20 75 73 65 73 0a 20 20 20 20 20 20 20 dex uses.
2980: 20 2a 2a 20 74 68 65 20 64 65 66 61 75 6c 74 20 ** the default
2990: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e collation sequen
29a0: 63 65 73 20 66 6f 72 20 65 61 63 68 20 63 6f 6c ces for each col
29b0: 75 6d 6e 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 umn. */.
29c0: 69 6e 74 20 69 2c 20 6a 3b 0a 20 20 20 20 20 20 int i, j;.
29d0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 6f for(i=0; i<nCo
29e0: 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 l; i++){.
29f0: 20 20 20 69 6e 74 20 69 43 6f 6c 20 3d 20 70 49 int iCol = pI
2a00: 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 69 5d 3b dx->aiColumn[i];
2a10: 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 /* Index of
2a20: 20 63 6f 6c 75 6d 6e 20 69 6e 20 70 61 72 65 6e column in paren
2a30: 74 20 74 62 6c 20 2a 2f 0a 20 20 20 20 20 20 20 t tbl */.
2a40: 20 20 20 63 68 61 72 20 2a 7a 44 66 6c 74 43 6f char *zDfltCo
2a50: 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ll;
2a60: 20 20 20 20 20 2f 2a 20 44 65 66 2e 20 63 6f 6c /* Def. col
2a70: 6c 61 74 69 6f 6e 20 66 6f 72 20 63 6f 6c 75 6d lation for colum
2a80: 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 63 n */. c
2a90: 68 61 72 20 2a 7a 49 64 78 43 6f 6c 3b 20 20 20 har *zIdxCol;
2aa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2ab0: 20 2f 2a 20 4e 61 6d 65 20 6f 66 20 69 6e 64 65 /* Name of inde
2ac0: 78 65 64 20 63 6f 6c 75 6d 6e 20 2a 2f 0a 0a 20 xed column */..
2ad0: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 74 /* If t
2ae0: 68 65 20 69 6e 64 65 78 20 75 73 65 73 20 61 20 he index uses a
2af0: 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 6e collation sequen
2b00: 63 65 20 74 68 61 74 20 69 73 20 64 69 66 66 65 ce that is diffe
2b10: 72 65 6e 74 20 66 72 6f 6d 0a 20 20 20 20 20 20 rent from.
2b20: 20 20 20 20 2a 2a 20 74 68 65 20 64 65 66 61 75 ** the defau
2b30: 6c 74 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 lt collation seq
2b40: 75 65 6e 63 65 20 66 6f 72 20 74 68 65 20 63 6f uence for the co
2b50: 6c 75 6d 6e 2c 20 74 68 69 73 20 69 6e 64 65 78 lumn, this index
2b60: 20 69 73 0a 20 20 20 20 20 20 20 20 20 20 2a 2a is. **
2b70: 20 75 6e 75 73 61 62 6c 65 2e 20 42 61 69 6c 20 unusable. Bail
2b80: 6f 75 74 20 65 61 72 6c 79 20 69 6e 20 74 68 69 out early in thi
2b90: 73 20 63 61 73 65 2e 20 20 2a 2f 0a 20 20 20 20 s case. */.
2ba0: 20 20 20 20 20 20 7a 44 66 6c 74 43 6f 6c 6c 20 zDfltColl
2bb0: 3d 20 70 50 61 72 65 6e 74 2d 3e 61 43 6f 6c 5b = pParent->aCol[
2bc0: 69 43 6f 6c 5d 2e 7a 43 6f 6c 6c 3b 0a 20 20 20 iCol].zColl;.
2bd0: 20 20 20 20 20 20 20 69 66 28 20 21 7a 44 66 6c if( !zDfl
2be0: 74 43 6f 6c 6c 20 29 7b 0a 20 20 20 20 20 20 20 tColl ){.
2bf0: 20 20 20 20 20 7a 44 66 6c 74 43 6f 6c 6c 20 3d zDfltColl =
2c00: 20 22 42 49 4e 41 52 59 22 3b 0a 20 20 20 20 20 "BINARY";.
2c10: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
2c20: 20 69 66 28 20 73 71 6c 69 74 65 33 53 74 72 49 if( sqlite3StrI
2c30: 43 6d 70 28 70 49 64 78 2d 3e 61 7a 43 6f 6c 6c Cmp(pIdx->azColl
2c40: 5b 69 5d 2c 20 7a 44 66 6c 74 43 6f 6c 6c 29 20 [i], zDfltColl)
2c50: 29 20 62 72 65 61 6b 3b 0a 0a 20 20 20 20 20 20 ) break;..
2c60: 20 20 20 20 7a 49 64 78 43 6f 6c 20 3d 20 70 50 zIdxCol = pP
2c70: 61 72 65 6e 74 2d 3e 61 43 6f 6c 5b 69 43 6f 6c arent->aCol[iCol
2c80: 5d 2e 7a 4e 61 6d 65 3b 0a 20 20 20 20 20 20 20 ].zName;.
2c90: 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 6e 43 for(j=0; j<nC
2ca0: 6f 6c 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 ol; j++){.
2cb0: 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 if( sqlite
2cc0: 33 53 74 72 49 43 6d 70 28 70 46 4b 65 79 2d 3e 3StrICmp(pFKey->
2cd0: 61 43 6f 6c 5b 6a 5d 2e 7a 43 6f 6c 2c 20 7a 49 aCol[j].zCol, zI
2ce0: 64 78 43 6f 6c 29 3d 3d 30 20 29 7b 0a 20 20 20 dxCol)==0 ){.
2cf0: 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 61 if( a
2d00: 69 43 6f 6c 20 29 20 61 69 43 6f 6c 5b 69 5d 20 iCol ) aiCol[i]
2d10: 3d 20 70 46 4b 65 79 2d 3e 61 43 6f 6c 5b 6a 5d = pFKey->aCol[j]
2d20: 2e 69 46 72 6f 6d 3b 0a 20 20 20 20 20 20 20 20 .iFrom;.
2d30: 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 break;.
2d40: 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
2d50: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
2d60: 20 69 66 28 20 6a 3d 3d 6e 43 6f 6c 20 29 20 62 if( j==nCol ) b
2d70: 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a reak;. }.
2d80: 20 20 20 20 20 20 20 20 69 66 28 20 69 3d 3d 6e if( i==n
2d90: 43 6f 6c 20 29 20 62 72 65 61 6b 3b 20 20 20 20 Col ) break;
2da0: 20 20 2f 2a 20 70 49 64 78 20 69 73 20 75 73 61 /* pIdx is usa
2db0: 62 6c 65 20 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 ble */. }.
2dc0: 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 }. }.. if(
2dd0: 21 70 49 64 78 20 29 7b 0a 20 20 20 20 69 66 28 !pIdx ){. if(
2de0: 20 21 70 50 61 72 73 65 2d 3e 64 69 73 61 62 6c !pParse->disabl
2df0: 65 54 72 69 67 67 65 72 73 20 29 7b 0a 20 20 20 eTriggers ){.
2e00: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 4d sqlite3ErrorM
2e10: 73 67 28 70 50 61 72 73 65 2c 0a 20 20 20 20 20 sg(pParse,.
2e20: 20 20 20 20 20 20 22 66 6f 72 65 69 67 6e 20 6b "foreign k
2e30: 65 79 20 6d 69 73 6d 61 74 63 68 20 2d 20 5c 22 ey mismatch - \"
2e40: 25 77 5c 22 20 72 65 66 65 72 65 6e 63 69 6e 67 %w\" referencing
2e50: 20 5c 22 25 77 5c 22 22 2c 0a 20 20 20 20 20 20 \"%w\"",.
2e60: 20 20 20 20 20 70 46 4b 65 79 2d 3e 70 46 72 6f pFKey->pFro
2e70: 6d 2d 3e 7a 4e 61 6d 65 2c 20 70 46 4b 65 79 2d m->zName, pFKey-
2e80: 3e 7a 54 6f 29 3b 0a 20 20 20 20 7d 0a 20 20 20 >zTo);. }.
2e90: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 70 sqlite3DbFree(p
2ea0: 50 61 72 73 65 2d 3e 64 62 2c 20 61 69 43 6f 6c Parse->db, aiCol
2eb0: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 31 3b );. return 1;
2ec0: 0a 20 20 7d 0a 0a 20 20 2a 70 70 49 64 78 20 3d . }.. *ppIdx =
2ed0: 20 70 49 64 78 3b 0a 20 20 72 65 74 75 72 6e 20 pIdx;. return
2ee0: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 0;.}../*.** This
2ef0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c function is cal
2f00: 6c 65 64 20 77 68 65 6e 20 61 20 72 6f 77 20 69 led when a row i
2f10: 73 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 20 s inserted into
2f20: 6f 72 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 or deleted from
2f30: 74 68 65 20 0a 2a 2a 20 63 68 69 6c 64 20 74 61 the .** child ta
2f40: 62 6c 65 20 6f 66 20 66 6f 72 65 69 67 6e 20 6b ble of foreign k
2f50: 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 70 46 ey constraint pF
2f60: 4b 65 79 2e 20 49 66 20 61 6e 20 53 51 4c 20 55 Key. If an SQL U
2f70: 50 44 41 54 45 20 69 73 20 65 78 65 63 75 74 65 PDATE is execute
2f80: 64 20 0a 2a 2a 20 6f 6e 20 74 68 65 20 63 68 69 d .** on the chi
2f90: 6c 64 20 74 61 62 6c 65 20 6f 66 20 70 46 4b 65 ld table of pFKe
2fa0: 79 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e y, this function
2fb0: 20 69 73 20 69 6e 76 6f 6b 65 64 20 74 77 69 63 is invoked twic
2fc0: 65 20 66 6f 72 20 65 61 63 68 20 72 6f 77 0a 2a e for each row.*
2fd0: 2a 20 61 66 66 65 63 74 65 64 20 2d 20 6f 6e 63 * affected - onc
2fe0: 65 20 74 6f 20 22 64 65 6c 65 74 65 22 20 74 68 e to "delete" th
2ff0: 65 20 6f 6c 64 20 72 6f 77 2c 20 61 6e 64 20 74 e old row, and t
3000: 68 65 6e 20 61 67 61 69 6e 20 74 6f 20 22 69 6e hen again to "in
3010: 73 65 72 74 22 20 74 68 65 0a 2a 2a 20 6e 65 77 sert" the.** new
3020: 20 72 6f 77 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 row..**.** Each
3030: 20 74 69 6d 65 20 69 74 20 69 73 20 63 61 6c 6c time it is call
3040: 65 64 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f ed, this functio
3050: 6e 20 67 65 6e 65 72 61 74 65 73 20 56 44 42 45 n generates VDBE
3060: 20 63 6f 64 65 20 74 6f 20 6c 6f 63 61 74 65 20 code to locate
3070: 74 68 65 0a 2a 2a 20 72 6f 77 20 69 6e 20 74 68 the.** row in th
3080: 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 74 e parent table t
3090: 68 61 74 20 63 6f 72 72 65 73 70 6f 6e 64 73 20 hat corresponds
30a0: 74 6f 20 74 68 65 20 72 6f 77 20 62 65 69 6e 67 to the row being
30b0: 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 20 0a inserted into .
30c0: 2a 2a 20 6f 72 20 64 65 6c 65 74 65 64 20 66 72 ** or deleted fr
30d0: 6f 6d 20 74 68 65 20 63 68 69 6c 64 20 74 61 62 om the child tab
30e0: 6c 65 2e 20 49 66 20 74 68 65 20 70 61 72 65 6e le. If the paren
30f0: 74 20 72 6f 77 20 63 61 6e 20 62 65 20 66 6f 75 t row can be fou
3100: 6e 64 2c 20 6e 6f 20 0a 2a 2a 20 73 70 65 63 69 nd, no .** speci
3110: 61 6c 20 61 63 74 69 6f 6e 20 69 73 20 74 61 6b al action is tak
3120: 65 6e 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 en. Otherwise, i
3130: 66 20 74 68 65 20 70 61 72 65 6e 74 20 72 6f 77 f the parent row
3140: 20 63 61 6e 20 2a 6e 6f 74 2a 20 62 65 0a 2a 2a can *not* be.**
3150: 20 66 6f 75 6e 64 20 69 6e 20 74 68 65 20 70 61 found in the pa
3160: 72 65 6e 74 20 74 61 62 6c 65 3a 0a 2a 2a 0a 2a rent table:.**.*
3170: 2a 20 20 20 4f 70 65 72 61 74 69 6f 6e 20 7c 20 * Operation |
3180: 46 4b 20 74 79 70 65 20 20 20 7c 20 41 63 74 69 FK type | Acti
3190: 6f 6e 20 74 61 6b 65 6e 0a 2a 2a 20 20 20 2d 2d on taken.** --
31a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
31b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
31c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
31d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
31e0: 2d 2d 2d 2d 2d 2d 2d 2d 0a 2a 2a 20 20 20 49 4e --------.** IN
31f0: 53 45 52 54 20 20 20 20 20 20 69 6d 6d 65 64 69 SERT immedi
3200: 61 74 65 20 20 20 49 6e 63 72 65 6d 65 6e 74 20 ate Increment
3210: 74 68 65 20 22 69 6d 6d 65 64 69 61 74 65 20 63 the "immediate c
3220: 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e 74 65 onstraint counte
3230: 72 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 44 45 4c 45 r"..**.** DELE
3240: 54 45 20 20 20 20 20 20 69 6d 6d 65 64 69 61 74 TE immediat
3250: 65 20 20 20 44 65 63 72 65 6d 65 6e 74 20 74 68 e Decrement th
3260: 65 20 22 69 6d 6d 65 64 69 61 74 65 20 63 6f 6e e "immediate con
3270: 73 74 72 61 69 6e 74 20 63 6f 75 6e 74 65 72 22 straint counter"
3280: 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 4e 53 45 52 54 ..**.** INSERT
3290: 20 20 20 20 20 20 64 65 66 65 72 72 65 64 20 20 deferred
32a0: 20 20 49 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 Increment the
32b0: 22 64 65 66 65 72 72 65 64 20 63 6f 6e 73 74 72 "deferred constr
32c0: 61 69 6e 74 20 63 6f 75 6e 74 65 72 22 2e 0a 2a aint counter"..*
32d0: 2a 0a 2a 2a 20 20 20 44 45 4c 45 54 45 20 20 20 *.** DELETE
32e0: 20 20 20 64 65 66 65 72 72 65 64 20 20 20 20 44 deferred D
32f0: 65 63 72 65 6d 65 6e 74 20 74 68 65 20 22 64 65 ecrement the "de
3300: 66 65 72 72 65 64 20 63 6f 6e 73 74 72 61 69 6e ferred constrain
3310: 74 20 63 6f 75 6e 74 65 72 22 2e 0a 2a 2a 0a 2a t counter"..**.*
3320: 2a 20 54 68 65 73 65 20 6f 70 65 72 61 74 69 6f * These operatio
3330: 6e 73 20 61 72 65 20 69 64 65 6e 74 69 66 69 65 ns are identifie
3340: 64 20 69 6e 20 74 68 65 20 63 6f 6d 6d 65 6e 74 d in the comment
3350: 20 61 74 20 74 68 65 20 74 6f 70 20 6f 66 20 74 at the top of t
3360: 68 69 73 20 66 69 6c 65 20 0a 2a 2a 20 28 66 6b his file .** (fk
3370: 65 79 2e 63 29 20 61 73 20 22 49 2e 31 22 20 61 ey.c) as "I.1" a
3380: 6e 64 20 22 44 2e 31 22 2e 0a 2a 2f 0a 73 74 61 nd "D.1"..*/.sta
3390: 74 69 63 20 76 6f 69 64 20 66 6b 4c 6f 6f 6b 75 tic void fkLooku
33a0: 70 50 61 72 65 6e 74 28 0a 20 20 50 61 72 73 65 pParent(. Parse
33b0: 20 2a 70 50 61 72 73 65 2c 20 20 20 20 20 20 20 *pParse,
33c0: 20 2f 2a 20 50 61 72 73 65 20 63 6f 6e 74 65 78 /* Parse contex
33d0: 74 20 2a 2f 0a 20 20 69 6e 74 20 69 44 62 2c 20 t */. int iDb,
33e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
33f0: 49 6e 64 65 78 20 6f 66 20 64 61 74 61 62 61 73 Index of databas
3400: 65 20 68 6f 75 73 69 6e 67 20 70 54 61 62 20 2a e housing pTab *
3410: 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 2c /. Table *pTab,
3420: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 /* Par
3430: 65 6e 74 20 74 61 62 6c 65 20 6f 66 20 46 4b 20 ent table of FK
3440: 70 46 4b 65 79 20 2a 2f 0a 20 20 49 6e 64 65 78 pFKey */. Index
3450: 20 2a 70 49 64 78 2c 20 20 20 20 20 20 20 20 20 *pIdx,
3460: 20 2f 2a 20 55 6e 69 71 75 65 20 69 6e 64 65 78 /* Unique index
3470: 20 6f 6e 20 70 61 72 65 6e 74 20 6b 65 79 20 63 on parent key c
3480: 6f 6c 75 6d 6e 73 20 69 6e 20 70 54 61 62 20 2a olumns in pTab *
3490: 2f 0a 20 20 46 4b 65 79 20 2a 70 46 4b 65 79 2c /. FKey *pFKey,
34a0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6f 72 /* For
34b0: 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 eign key constra
34c0: 69 6e 74 20 2a 2f 0a 20 20 69 6e 74 20 2a 61 69 int */. int *ai
34d0: 43 6f 6c 2c 20 20 20 20 20 20 20 20 20 20 20 2f Col, /
34e0: 2a 20 4d 61 70 20 66 72 6f 6d 20 70 61 72 65 6e * Map from paren
34f0: 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 74 6f t key columns to
3500: 20 63 68 69 6c 64 20 74 61 62 6c 65 20 63 6f 6c child table col
3510: 75 6d 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 72 65 umns */. int re
3520: 67 44 61 74 61 2c 20 20 20 20 20 20 20 20 20 20 gData,
3530: 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 61 72 /* Address of ar
3540: 72 61 79 20 63 6f 6e 74 61 69 6e 69 6e 67 20 63 ray containing c
3550: 68 69 6c 64 20 74 61 62 6c 65 20 72 6f 77 20 2a hild table row *
3560: 2f 0a 20 20 69 6e 74 20 6e 49 6e 63 72 2c 20 20 /. int nIncr,
3570: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 63 /* Inc
3580: 72 65 6d 65 6e 74 20 63 6f 6e 73 74 72 61 69 6e rement constrain
3590: 74 20 63 6f 75 6e 74 65 72 20 62 79 20 74 68 69 t counter by thi
35a0: 73 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 67 6e s */. int isIgn
35b0: 6f 72 65 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ore /*
35c0: 49 66 20 74 72 75 65 2c 20 70 72 65 74 65 6e 64 If true, pretend
35d0: 20 70 54 61 62 20 63 6f 6e 74 61 69 6e 73 20 61 pTab contains a
35e0: 6c 6c 20 4e 55 4c 4c 20 76 61 6c 75 65 73 20 2a ll NULL values *
35f0: 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 3b 20 20 20 /.){. int i;
3600: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
3610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
3620: 20 2f 2a 20 49 74 65 72 61 74 6f 72 20 76 61 72 /* Iterator var
3630: 69 61 62 6c 65 20 2a 2f 0a 20 20 56 64 62 65 20 iable */. Vdbe
3640: 2a 76 20 3d 20 73 71 6c 69 74 65 33 47 65 74 56 *v = sqlite3GetV
3650: 64 62 65 28 70 50 61 72 73 65 29 3b 20 20 20 20 dbe(pParse);
3660: 20 20 20 20 20 2f 2a 20 56 64 62 65 20 74 6f 20 /* Vdbe to
3670: 61 64 64 20 63 6f 64 65 20 74 6f 20 2a 2f 0a 20 add code to */.
3680: 20 69 6e 74 20 69 43 75 72 20 3d 20 70 50 61 72 int iCur = pPar
3690: 73 65 2d 3e 6e 54 61 62 20 2d 20 31 3b 20 20 20 se->nTab - 1;
36a0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 /* Cu
36b0: 72 73 6f 72 20 6e 75 6d 62 65 72 20 74 6f 20 75 rsor number to u
36c0: 73 65 20 2a 2f 0a 20 20 69 6e 74 20 69 4f 6b 20 se */. int iOk
36d0: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b = sqlite3VdbeMak
36e0: 65 4c 61 62 65 6c 28 76 29 3b 20 20 20 20 20 20 eLabel(v);
36f0: 20 20 2f 2a 20 6a 75 6d 70 20 68 65 72 65 20 69 /* jump here i
3700: 66 20 70 61 72 65 6e 74 20 6b 65 79 20 66 6f 75 f parent key fou
3710: 6e 64 20 2a 2f 0a 0a 20 20 2f 2a 20 49 66 20 6e nd */.. /* If n
3720: 49 6e 63 72 20 69 73 20 6c 65 73 73 20 74 68 61 Incr is less tha
3730: 6e 20 7a 65 72 6f 2c 20 74 68 65 6e 20 63 68 65 n zero, then che
3740: 63 6b 20 61 74 20 72 75 6e 74 69 6d 65 20 69 66 ck at runtime if
3750: 20 74 68 65 72 65 20 61 72 65 20 61 6e 79 0a 20 there are any.
3760: 20 2a 2a 20 6f 75 74 73 74 61 6e 64 69 6e 67 20 ** outstanding
3770: 63 6f 6e 73 74 72 61 69 6e 74 73 20 74 6f 20 72 constraints to r
3780: 65 73 6f 6c 76 65 2e 20 49 66 20 74 68 65 72 65 esolve. If there
3790: 20 61 72 65 20 6e 6f 74 2c 20 74 68 65 72 65 20 are not, there
37a0: 69 73 20 6e 6f 20 6e 65 65 64 0a 20 20 2a 2a 20 is no need. **
37b0: 74 6f 20 63 68 65 63 6b 20 69 66 20 64 65 6c 65 to check if dele
37c0: 74 69 6e 67 20 74 68 69 73 20 72 6f 77 20 72 65 ting this row re
37d0: 73 6f 6c 76 65 73 20 61 6e 79 20 6f 75 74 73 74 solves any outst
37e0: 61 6e 64 69 6e 67 20 76 69 6f 6c 61 74 69 6f 6e anding violation
37f0: 73 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 43 68 65 s.. **. ** Che
3800: 63 6b 20 69 66 20 61 6e 79 20 6f 66 20 74 68 65 ck if any of the
3810: 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 key columns in
3820: 74 68 65 20 63 68 69 6c 64 20 74 61 62 6c 65 20 the child table
3830: 72 6f 77 20 61 72 65 20 4e 55 4c 4c 2e 20 49 66 row are NULL. If
3840: 20 0a 20 20 2a 2a 20 61 6e 79 20 61 72 65 2c 20 . ** any are,
3850: 74 68 65 6e 20 74 68 65 20 63 6f 6e 73 74 72 61 then the constra
3860: 69 6e 74 20 69 73 20 63 6f 6e 73 69 64 65 72 65 int is considere
3870: 64 20 73 61 74 69 73 66 69 65 64 2e 20 4e 6f 20 d satisfied. No
3880: 6e 65 65 64 20 74 6f 20 0a 20 20 2a 2a 20 73 65 need to . ** se
3890: 61 72 63 68 20 66 6f 72 20 61 20 6d 61 74 63 68 arch for a match
38a0: 69 6e 67 20 72 6f 77 20 69 6e 20 74 68 65 20 70 ing row in the p
38b0: 61 72 65 6e 74 20 74 61 62 6c 65 2e 20 20 2a 2f arent table. */
38c0: 0a 20 20 69 66 28 20 6e 49 6e 63 72 3c 30 20 29 . if( nIncr<0 )
38d0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 {. sqlite3Vdb
38e0: 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 46 6b eAddOp2(v, OP_Fk
38f0: 49 66 5a 65 72 6f 2c 20 70 46 4b 65 79 2d 3e 69 IfZero, pFKey->i
3900: 73 44 65 66 65 72 72 65 64 2c 20 69 4f 6b 29 3b sDeferred, iOk);
3910: 0a 20 20 7d 0a 20 20 66 6f 72 28 69 3d 30 3b 20 . }. for(i=0;
3920: 69 3c 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3b 20 69 i<pFKey->nCol; i
3930: 2b 2b 29 7b 0a 20 20 20 20 69 6e 74 20 69 52 65 ++){. int iRe
3940: 67 20 3d 20 61 69 43 6f 6c 5b 69 5d 20 2b 20 72 g = aiCol[i] + r
3950: 65 67 44 61 74 61 20 2b 20 31 3b 0a 20 20 20 20 egData + 1;.
3960: 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 sqlite3VdbeAddOp
3970: 32 28 76 2c 20 4f 50 5f 49 73 4e 75 6c 6c 2c 20 2(v, OP_IsNull,
3980: 69 52 65 67 2c 20 69 4f 6b 29 3b 0a 20 20 7d 0a iReg, iOk);. }.
3990: 0a 20 20 69 66 28 20 69 73 49 67 6e 6f 72 65 3d . if( isIgnore=
39a0: 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 70 49 =0 ){. if( pI
39b0: 64 78 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f dx==0 ){. /
39c0: 2a 20 49 66 20 70 49 64 78 20 69 73 20 4e 55 4c * If pIdx is NUL
39d0: 4c 2c 20 74 68 65 6e 20 74 68 65 20 70 61 72 65 L, then the pare
39e0: 6e 74 20 6b 65 79 20 69 73 20 74 68 65 20 49 4e nt key is the IN
39f0: 54 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 TEGER PRIMARY KE
3a00: 59 0a 20 20 20 20 20 20 2a 2a 20 63 6f 6c 75 6d Y. ** colum
3a10: 6e 20 6f 66 20 74 68 65 20 70 61 72 65 6e 74 20 n of the parent
3a20: 74 61 62 6c 65 20 28 74 61 62 6c 65 20 70 54 61 table (table pTa
3a30: 62 29 2e 20 20 2a 2f 0a 20 20 20 20 20 20 69 6e b). */. in
3a40: 74 20 69 4d 75 73 74 42 65 49 6e 74 3b 20 20 20 t iMustBeInt;
3a50: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
3a60: 64 64 72 65 73 73 20 6f 66 20 4d 75 73 74 42 65 ddress of MustBe
3a70: 49 6e 74 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 Int instruction
3a80: 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 72 65 67 */. int reg
3a90: 54 65 6d 70 20 3d 20 73 71 6c 69 74 65 33 47 65 Temp = sqlite3Ge
3aa0: 74 54 65 6d 70 52 65 67 28 70 50 61 72 73 65 29 tTempReg(pParse)
3ab0: 3b 0a 20 20 0a 20 20 20 20 20 20 2f 2a 20 49 6e ;. . /* In
3ac0: 76 6f 6b 65 20 4d 75 73 74 42 65 49 6e 74 20 74 voke MustBeInt t
3ad0: 6f 20 63 6f 65 72 63 65 20 74 68 65 20 63 68 69 o coerce the chi
3ae0: 6c 64 20 6b 65 79 20 76 61 6c 75 65 20 74 6f 20 ld key value to
3af0: 61 6e 20 69 6e 74 65 67 65 72 20 28 69 2e 65 2e an integer (i.e.
3b00: 20 0a 20 20 20 20 20 20 2a 2a 20 61 70 70 6c 79 . ** apply
3b10: 20 74 68 65 20 61 66 66 69 6e 69 74 79 20 6f 66 the affinity of
3b20: 20 74 68 65 20 70 61 72 65 6e 74 20 6b 65 79 29 the parent key)
3b30: 2e 20 49 66 20 74 68 69 73 20 66 61 69 6c 73 2c . If this fails,
3b40: 20 74 68 65 6e 20 74 68 65 72 65 0a 20 20 20 20 then there.
3b50: 20 20 2a 2a 20 69 73 20 6e 6f 20 6d 61 74 63 68 ** is no match
3b60: 69 6e 67 20 70 61 72 65 6e 74 20 6b 65 79 2e 20 ing parent key.
3b70: 42 65 66 6f 72 65 20 75 73 69 6e 67 20 4d 75 73 Before using Mus
3b80: 74 42 65 49 6e 74 2c 20 6d 61 6b 65 20 61 20 63 tBeInt, make a c
3b90: 6f 70 79 20 6f 66 0a 20 20 20 20 20 20 2a 2a 20 opy of. **
3ba0: 74 68 65 20 76 61 6c 75 65 2e 20 4f 74 68 65 72 the value. Other
3bb0: 77 69 73 65 2c 20 74 68 65 20 76 61 6c 75 65 20 wise, the value
3bc0: 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 20 74 68 inserted into th
3bd0: 65 20 63 68 69 6c 64 20 6b 65 79 20 63 6f 6c 75 e child key colu
3be0: 6d 6e 0a 20 20 20 20 20 20 2a 2a 20 77 69 6c 6c mn. ** will
3bf0: 20 68 61 76 65 20 49 4e 54 45 47 45 52 20 61 66 have INTEGER af
3c00: 66 69 6e 69 74 79 20 61 70 70 6c 69 65 64 20 74 finity applied t
3c10: 6f 20 69 74 2c 20 77 68 69 63 68 20 6d 61 79 20 o it, which may
3c20: 6e 6f 74 20 62 65 20 63 6f 72 72 65 63 74 2e 20 not be correct.
3c30: 20 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 */. sqlite
3c40: 33 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 3VdbeAddOp2(v, O
3c50: 50 5f 53 43 6f 70 79 2c 20 61 69 43 6f 6c 5b 30 P_SCopy, aiCol[0
3c60: 5d 2b 31 2b 72 65 67 44 61 74 61 2c 20 72 65 67 ]+1+regData, reg
3c70: 54 65 6d 70 29 3b 0a 20 20 20 20 20 20 69 4d 75 Temp);. iMu
3c80: 73 74 42 65 49 6e 74 20 3d 20 73 71 6c 69 74 65 stBeInt = sqlite
3c90: 33 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 3VdbeAddOp2(v, O
3ca0: 50 5f 4d 75 73 74 42 65 49 6e 74 2c 20 72 65 67 P_MustBeInt, reg
3cb0: 54 65 6d 70 2c 20 30 29 3b 0a 20 20 0a 20 20 20 Temp, 0);. .
3cc0: 20 20 20 2f 2a 20 49 66 20 74 68 65 20 70 61 72 /* If the par
3cd0: 65 6e 74 20 74 61 62 6c 65 20 69 73 20 74 68 65 ent table is the
3ce0: 20 73 61 6d 65 20 61 73 20 74 68 65 20 63 68 69 same as the chi
3cf0: 6c 64 20 74 61 62 6c 65 2c 20 61 6e 64 20 77 65 ld table, and we
3d00: 20 61 72 65 20 61 62 6f 75 74 0a 20 20 20 20 20 are about.
3d10: 20 2a 2a 20 74 6f 20 69 6e 63 72 65 6d 65 6e 74 ** to increment
3d20: 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 2d the constraint-
3d30: 63 6f 75 6e 74 65 72 20 28 69 2e 65 2e 20 74 68 counter (i.e. th
3d40: 69 73 20 69 73 20 61 6e 20 49 4e 53 45 52 54 20 is is an INSERT
3d50: 6f 70 65 72 61 74 69 6f 6e 29 2c 0a 20 20 20 20 operation),.
3d60: 20 20 2a 2a 20 74 68 65 6e 20 63 68 65 63 6b 20 ** then check
3d70: 69 66 20 74 68 65 20 72 6f 77 20 62 65 69 6e 67 if the row being
3d80: 20 69 6e 73 65 72 74 65 64 20 6d 61 74 63 68 65 inserted matche
3d90: 73 20 69 74 73 65 6c 66 2e 20 49 66 20 73 6f 2c s itself. If so,
3da0: 20 64 6f 20 6e 6f 74 0a 20 20 20 20 20 20 2a 2a do not. **
3db0: 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 20 63 increment the c
3dc0: 6f 6e 73 74 72 61 69 6e 74 2d 63 6f 75 6e 74 65 onstraint-counte
3dd0: 72 2e 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 r. */. if(
3de0: 20 70 54 61 62 3d 3d 70 46 4b 65 79 2d 3e 70 46 pTab==pFKey->pF
3df0: 72 6f 6d 20 26 26 20 6e 49 6e 63 72 3d 3d 31 20 rom && nIncr==1
3e00: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 ){. sqlit
3e10: 65 33 56 64 62 65 41 64 64 4f 70 33 28 76 2c 20 e3VdbeAddOp3(v,
3e20: 4f 50 5f 45 71 2c 20 72 65 67 44 61 74 61 2c 20 OP_Eq, regData,
3e30: 69 4f 6b 2c 20 72 65 67 54 65 6d 70 29 3b 0a 20 iOk, regTemp);.
3e40: 20 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 20 20 }. .
3e50: 73 71 6c 69 74 65 33 4f 70 65 6e 54 61 62 6c 65 sqlite3OpenTable
3e60: 28 70 50 61 72 73 65 2c 20 69 43 75 72 2c 20 69 (pParse, iCur, i
3e70: 44 62 2c 20 70 54 61 62 2c 20 4f 50 5f 4f 70 65 Db, pTab, OP_Ope
3e80: 6e 52 65 61 64 29 3b 0a 20 20 20 20 20 20 73 71 nRead);. sq
3e90: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 33 28 lite3VdbeAddOp3(
3ea0: 76 2c 20 4f 50 5f 4e 6f 74 45 78 69 73 74 73 2c v, OP_NotExists,
3eb0: 20 69 43 75 72 2c 20 30 2c 20 72 65 67 54 65 6d iCur, 0, regTem
3ec0: 70 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 p);. sqlite
3ed0: 33 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 3VdbeAddOp2(v, O
3ee0: 50 5f 47 6f 74 6f 2c 20 30 2c 20 69 4f 6b 29 3b P_Goto, 0, iOk);
3ef0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 . sqlite3Vd
3f00: 62 65 4a 75 6d 70 48 65 72 65 28 76 2c 20 73 71 beJumpHere(v, sq
3f10: 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 6e 74 lite3VdbeCurrent
3f20: 41 64 64 72 28 76 29 2d 32 29 3b 0a 20 20 20 20 Addr(v)-2);.
3f30: 20 20 73 71 6c 69 74 65 33 56 64 62 65 4a 75 6d sqlite3VdbeJum
3f40: 70 48 65 72 65 28 76 2c 20 69 4d 75 73 74 42 65 pHere(v, iMustBe
3f50: 49 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 Int);. sqli
3f60: 74 65 33 52 65 6c 65 61 73 65 54 65 6d 70 52 65 te3ReleaseTempRe
3f70: 67 28 70 50 61 72 73 65 2c 20 72 65 67 54 65 6d g(pParse, regTem
3f80: 70 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 p);. }else{.
3f90: 20 20 20 20 20 69 6e 74 20 6e 43 6f 6c 20 3d 20 int nCol =
3fa0: 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3b 0a 20 20 20 pFKey->nCol;.
3fb0: 20 20 20 69 6e 74 20 72 65 67 54 65 6d 70 20 3d int regTemp =
3fc0: 20 73 71 6c 69 74 65 33 47 65 74 54 65 6d 70 52 sqlite3GetTempR
3fd0: 61 6e 67 65 28 70 50 61 72 73 65 2c 20 6e 43 6f ange(pParse, nCo
3fe0: 6c 29 3b 0a 20 20 20 20 20 20 69 6e 74 20 72 65 l);. int re
3ff0: 67 52 65 63 20 3d 20 73 71 6c 69 74 65 33 47 65 gRec = sqlite3Ge
4000: 74 54 65 6d 70 52 65 67 28 70 50 61 72 73 65 29 tTempReg(pParse)
4010: 3b 0a 20 20 20 20 20 20 4b 65 79 49 6e 66 6f 20 ;. KeyInfo
4020: 2a 70 4b 65 79 20 3d 20 73 71 6c 69 74 65 33 49 *pKey = sqlite3I
4030: 6e 64 65 78 4b 65 79 69 6e 66 6f 28 70 50 61 72 ndexKeyinfo(pPar
4040: 73 65 2c 20 70 49 64 78 29 3b 0a 20 20 0a 20 20 se, pIdx);. .
4050: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 sqlite3VdbeA
4060: 64 64 4f 70 33 28 76 2c 20 4f 50 5f 4f 70 65 6e ddOp3(v, OP_Open
4070: 52 65 61 64 2c 20 69 43 75 72 2c 20 70 49 64 78 Read, iCur, pIdx
4080: 2d 3e 74 6e 75 6d 2c 20 69 44 62 29 3b 0a 20 20 ->tnum, iDb);.
4090: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 43 sqlite3VdbeC
40a0: 68 61 6e 67 65 50 34 28 76 2c 20 2d 31 2c 20 28 hangeP4(v, -1, (
40b0: 63 68 61 72 2a 29 70 4b 65 79 2c 20 50 34 5f 4b char*)pKey, P4_K
40c0: 45 59 49 4e 46 4f 5f 48 41 4e 44 4f 46 46 29 3b EYINFO_HANDOFF);
40d0: 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 . for(i=0;
40e0: 69 3c 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20 i<nCol; i++){.
40f0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 sqlite3Vdb
4100: 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 43 6f eAddOp2(v, OP_Co
4110: 70 79 2c 20 61 69 43 6f 6c 5b 69 5d 2b 31 2b 72 py, aiCol[i]+1+r
4120: 65 67 44 61 74 61 2c 20 72 65 67 54 65 6d 70 2b egData, regTemp+
4130: 69 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 0a 20 i);. }. .
4140: 20 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 70 /* If the p
4150: 61 72 65 6e 74 20 74 61 62 6c 65 20 69 73 20 74 arent table is t
4160: 68 65 20 73 61 6d 65 20 61 73 20 74 68 65 20 63 he same as the c
4170: 68 69 6c 64 20 74 61 62 6c 65 2c 20 61 6e 64 20 hild table, and
4180: 77 65 20 61 72 65 20 61 62 6f 75 74 0a 20 20 20 we are about.
4190: 20 20 20 2a 2a 20 74 6f 20 69 6e 63 72 65 6d 65 ** to increme
41a0: 6e 74 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e nt the constrain
41b0: 74 2d 63 6f 75 6e 74 65 72 20 28 69 2e 65 2e 20 t-counter (i.e.
41c0: 74 68 69 73 20 69 73 20 61 6e 20 49 4e 53 45 52 this is an INSER
41d0: 54 20 6f 70 65 72 61 74 69 6f 6e 29 2c 0a 20 20 T operation),.
41e0: 20 20 20 20 2a 2a 20 74 68 65 6e 20 63 68 65 63 ** then chec
41f0: 6b 20 69 66 20 74 68 65 20 72 6f 77 20 62 65 69 k if the row bei
4200: 6e 67 20 69 6e 73 65 72 74 65 64 20 6d 61 74 63 ng inserted matc
4210: 68 65 73 20 69 74 73 65 6c 66 2e 20 49 66 20 73 hes itself. If s
4220: 6f 2c 20 64 6f 20 6e 6f 74 0a 20 20 20 20 20 20 o, do not.
4230: 2a 2a 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 ** increment the
4240: 20 63 6f 6e 73 74 72 61 69 6e 74 2d 63 6f 75 6e constraint-coun
4250: 74 65 72 2e 20 0a 20 20 20 20 20 20 2a 2a 0a 20 ter. . **.
4260: 20 20 20 20 20 2a 2a 20 49 66 20 61 6e 79 20 6f ** If any o
4270: 66 20 74 68 65 20 70 61 72 65 6e 74 2d 6b 65 79 f the parent-key
4280: 20 76 61 6c 75 65 73 20 61 72 65 20 4e 55 4c 4c values are NULL
4290: 2c 20 74 68 65 6e 20 74 68 65 20 72 6f 77 20 63 , then the row c
42a0: 61 6e 6e 6f 74 20 6d 61 74 63 68 20 0a 20 20 20 annot match .
42b0: 20 20 20 2a 2a 20 69 74 73 65 6c 66 2e 20 53 6f ** itself. So
42c0: 20 73 65 74 20 4a 55 4d 50 49 46 4e 55 4c 4c 20 set JUMPIFNULL
42d0: 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 77 65 20 to make sure we
42e0: 64 6f 20 74 68 65 20 4f 50 5f 46 6f 75 6e 64 20 do the OP_Found
42f0: 69 66 20 61 6e 79 0a 20 20 20 20 20 20 2a 2a 20 if any. **
4300: 6f 66 20 74 68 65 20 70 61 72 65 6e 74 2d 6b 65 of the parent-ke
4310: 79 20 76 61 6c 75 65 73 20 61 72 65 20 4e 55 4c y values are NUL
4320: 4c 20 28 61 74 20 74 68 69 73 20 70 6f 69 6e 74 L (at this point
4330: 20 69 74 20 69 73 20 6b 6e 6f 77 6e 20 74 68 61 it is known tha
4340: 74 0a 20 20 20 20 20 20 2a 2a 20 6e 6f 6e 65 20 t. ** none
4350: 6f 66 20 74 68 65 20 63 68 69 6c 64 20 6b 65 79 of the child key
4360: 20 76 61 6c 75 65 73 20 61 72 65 29 2e 0a 20 20 values are)..
4370: 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 */. if(
4380: 20 70 54 61 62 3d 3d 70 46 4b 65 79 2d 3e 70 46 pTab==pFKey->pF
4390: 72 6f 6d 20 26 26 20 6e 49 6e 63 72 3d 3d 31 20 rom && nIncr==1
43a0: 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 69 ){. int i
43b0: 4a 75 6d 70 20 3d 20 73 71 6c 69 74 65 33 56 64 Jump = sqlite3Vd
43c0: 62 65 43 75 72 72 65 6e 74 41 64 64 72 28 76 29 beCurrentAddr(v)
43d0: 20 2b 20 6e 43 6f 6c 20 2b 20 31 3b 0a 20 20 20 + nCol + 1;.
43e0: 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c for(i=0; i<
43f0: 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 nCol; i++){.
4400: 20 20 20 20 20 20 69 6e 74 20 69 43 68 69 6c 64 int iChild
4410: 20 3d 20 61 69 43 6f 6c 5b 69 5d 2b 31 2b 72 65 = aiCol[i]+1+re
4420: 67 44 61 74 61 3b 0a 20 20 20 20 20 20 20 20 20 gData;.
4430: 20 69 6e 74 20 69 50 61 72 65 6e 74 20 3d 20 70 int iParent = p
4440: 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 69 5d Idx->aiColumn[i]
4450: 2b 31 2b 72 65 67 44 61 74 61 3b 0a 20 20 20 20 +1+regData;.
4460: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 61 69 assert( ai
4470: 43 6f 6c 5b 69 5d 21 3d 70 54 61 62 2d 3e 69 50 Col[i]!=pTab->iP
4480: 4b 65 79 20 29 3b 0a 20 20 20 20 20 20 20 20 20 Key );.
4490: 20 69 66 28 20 70 49 64 78 2d 3e 61 69 43 6f 6c if( pIdx->aiCol
44a0: 75 6d 6e 5b 69 5d 3d 3d 70 54 61 62 2d 3e 69 50 umn[i]==pTab->iP
44b0: 4b 65 79 20 29 7b 0a 20 20 20 20 20 20 20 20 20 Key ){.
44c0: 20 20 20 2f 2a 20 54 68 65 20 70 61 72 65 6e 74 /* The parent
44d0: 20 6b 65 79 20 69 73 20 61 20 63 6f 6d 70 6f 73 key is a compos
44e0: 69 74 65 20 6b 65 79 20 74 68 61 74 20 69 6e 63 ite key that inc
44f0: 6c 75 64 65 73 20 74 68 65 20 49 50 4b 20 63 6f ludes the IPK co
4500: 6c 75 6d 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 lumn */.
4510: 20 20 20 20 69 50 61 72 65 6e 74 20 3d 20 72 65 iParent = re
4520: 67 44 61 74 61 3b 0a 20 20 20 20 20 20 20 20 20 gData;.
4530: 20 7d 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c }. sql
4540: 69 74 65 33 56 64 62 65 41 64 64 4f 70 33 28 76 ite3VdbeAddOp3(v
4550: 2c 20 4f 50 5f 4e 65 2c 20 69 43 68 69 6c 64 2c , OP_Ne, iChild,
4560: 20 69 4a 75 6d 70 2c 20 69 50 61 72 65 6e 74 29 iJump, iParent)
4570: 3b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 ;. sqli
4580: 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 35 28 te3VdbeChangeP5(
4590: 76 2c 20 53 51 4c 49 54 45 5f 4a 55 4d 50 49 46 v, SQLITE_JUMPIF
45a0: 4e 55 4c 4c 29 3b 0a 20 20 20 20 20 20 20 20 7d NULL);. }
45b0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
45c0: 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 VdbeAddOp2(v, OP
45d0: 5f 47 6f 74 6f 2c 20 30 2c 20 69 4f 6b 29 3b 0a _Goto, 0, iOk);.
45e0: 20 20 20 20 20 20 7d 0a 20 20 0a 20 20 20 20 20 }. .
45f0: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f sqlite3VdbeAddO
4600: 70 33 28 76 2c 20 4f 50 5f 4d 61 6b 65 52 65 63 p3(v, OP_MakeRec
4610: 6f 72 64 2c 20 72 65 67 54 65 6d 70 2c 20 6e 43 ord, regTemp, nC
4620: 6f 6c 2c 20 72 65 67 52 65 63 29 3b 0a 20 20 20 ol, regRec);.
4630: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 43 68 sqlite3VdbeCh
4640: 61 6e 67 65 50 34 28 76 2c 20 2d 31 2c 20 73 71 angeP4(v, -1, sq
4650: 6c 69 74 65 33 49 6e 64 65 78 41 66 66 69 6e 69 lite3IndexAffini
4660: 74 79 53 74 72 28 76 2c 70 49 64 78 29 2c 20 50 tyStr(v,pIdx), P
4670: 34 5f 54 52 41 4e 53 49 45 4e 54 29 3b 0a 20 20 4_TRANSIENT);.
4680: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 sqlite3VdbeA
4690: 64 64 4f 70 34 49 6e 74 28 76 2c 20 4f 50 5f 46 ddOp4Int(v, OP_F
46a0: 6f 75 6e 64 2c 20 69 43 75 72 2c 20 69 4f 6b 2c ound, iCur, iOk,
46b0: 20 72 65 67 52 65 63 2c 20 30 29 3b 0a 20 20 0a regRec, 0);. .
46c0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 65 6c sqlite3Rel
46d0: 65 61 73 65 54 65 6d 70 52 65 67 28 70 50 61 72 easeTempReg(pPar
46e0: 73 65 2c 20 72 65 67 52 65 63 29 3b 0a 20 20 20 se, regRec);.
46f0: 20 20 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 sqlite3Releas
4700: 65 54 65 6d 70 52 61 6e 67 65 28 70 50 61 72 73 eTempRange(pPars
4710: 65 2c 20 72 65 67 54 65 6d 70 2c 20 6e 43 6f 6c e, regTemp, nCol
4720: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 );. }. }..
4730: 69 66 28 20 21 70 46 4b 65 79 2d 3e 69 73 44 65 if( !pFKey->isDe
4740: 66 65 72 72 65 64 20 26 26 20 21 70 50 61 72 73 ferred && !pPars
4750: 65 2d 3e 70 54 6f 70 6c 65 76 65 6c 20 26 26 20 e->pToplevel &&
4760: 21 70 50 61 72 73 65 2d 3e 69 73 4d 75 6c 74 69 !pParse->isMulti
4770: 57 72 69 74 65 20 29 7b 0a 20 20 20 20 2f 2a 20 Write ){. /*
4780: 53 70 65 63 69 61 6c 20 63 61 73 65 3a 20 49 66 Special case: If
4790: 20 74 68 69 73 20 69 73 20 61 6e 20 49 4e 53 45 this is an INSE
47a0: 52 54 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61 RT statement tha
47b0: 74 20 77 69 6c 6c 20 69 6e 73 65 72 74 20 65 78 t will insert ex
47c0: 61 63 74 6c 79 0a 20 20 20 20 2a 2a 20 6f 6e 65 actly. ** one
47d0: 20 72 6f 77 20 69 6e 74 6f 20 74 68 65 20 74 61 row into the ta
47e0: 62 6c 65 2c 20 72 61 69 73 65 20 61 20 63 6f 6e ble, raise a con
47f0: 73 74 72 61 69 6e 74 20 69 6d 6d 65 64 69 61 74 straint immediat
4800: 65 6c 79 20 69 6e 73 74 65 61 64 20 6f 66 0a 20 ely instead of.
4810: 20 20 20 2a 2a 20 69 6e 63 72 65 6d 65 6e 74 69 ** incrementi
4820: 6e 67 20 61 20 63 6f 75 6e 74 65 72 2e 20 54 68 ng a counter. Th
4830: 69 73 20 69 73 20 6e 65 63 65 73 73 61 72 79 20 is is necessary
4840: 61 73 20 74 68 65 20 56 4d 20 63 6f 64 65 20 69 as the VM code i
4850: 73 20 62 65 69 6e 67 0a 20 20 20 20 2a 2a 20 67 s being. ** g
4860: 65 6e 65 72 61 74 65 64 20 66 6f 72 20 77 69 6c enerated for wil
4870: 6c 20 6e 6f 74 20 6f 70 65 6e 20 61 20 73 74 61 l not open a sta
4880: 74 65 6d 65 6e 74 20 74 72 61 6e 73 61 63 74 69 tement transacti
4890: 6f 6e 2e 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 on. */. asse
48a0: 72 74 28 20 6e 49 6e 63 72 3d 3d 31 20 29 3b 0a rt( nIncr==1 );.
48b0: 20 20 20 20 73 71 6c 69 74 65 33 48 61 6c 74 43 sqlite3HaltC
48c0: 6f 6e 73 74 72 61 69 6e 74 28 0a 20 20 20 20 20 onstraint(.
48d0: 20 20 20 70 50 61 72 73 65 2c 20 4f 45 5f 41 62 pParse, OE_Ab
48e0: 6f 72 74 2c 20 22 66 6f 72 65 69 67 6e 20 6b 65 ort, "foreign ke
48f0: 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 66 61 69 y constraint fai
4900: 6c 65 64 22 2c 20 50 34 5f 53 54 41 54 49 43 0a led", P4_STATIC.
4910: 20 20 20 20 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a );. }else{.
4920: 20 20 20 20 69 66 28 20 6e 49 6e 63 72 3e 30 20 if( nIncr>0
4930: 26 26 20 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 && pFKey->isDefe
4940: 72 72 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20 20 rred==0 ){.
4950: 20 73 71 6c 69 74 65 33 50 61 72 73 65 54 6f 70 sqlite3ParseTop
4960: 6c 65 76 65 6c 28 70 50 61 72 73 65 29 2d 3e 6d level(pParse)->m
4970: 61 79 41 62 6f 72 74 20 3d 20 31 3b 0a 20 20 20 ayAbort = 1;.
4980: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 }. sqlite3Vd
4990: 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 46 beAddOp2(v, OP_F
49a0: 6b 43 6f 75 6e 74 65 72 2c 20 70 46 4b 65 79 2d kCounter, pFKey-
49b0: 3e 69 73 44 65 66 65 72 72 65 64 2c 20 6e 49 6e >isDeferred, nIn
49c0: 63 72 29 3b 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 cr);. }.. sqli
49d0: 74 65 33 56 64 62 65 52 65 73 6f 6c 76 65 4c 61 te3VdbeResolveLa
49e0: 62 65 6c 28 76 2c 20 69 4f 6b 29 3b 0a 20 20 73 bel(v, iOk);. s
49f0: 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 31 qlite3VdbeAddOp1
4a00: 28 76 2c 20 4f 50 5f 43 6c 6f 73 65 2c 20 69 43 (v, OP_Close, iC
4a10: 75 72 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 ur);.}../*.** Th
4a20: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 is function is c
4a30: 61 6c 6c 65 64 20 74 6f 20 67 65 6e 65 72 61 74 alled to generat
4a40: 65 20 63 6f 64 65 20 65 78 65 63 75 74 65 64 20 e code executed
4a50: 77 68 65 6e 20 61 20 72 6f 77 20 69 73 20 64 65 when a row is de
4a60: 6c 65 74 65 64 0a 2a 2a 20 66 72 6f 6d 20 74 68 leted.** from th
4a70: 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 6f e parent table o
4a80: 66 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f f foreign key co
4a90: 6e 73 74 72 61 69 6e 74 20 70 46 4b 65 79 20 61 nstraint pFKey a
4aa0: 6e 64 2c 20 69 66 20 70 46 4b 65 79 20 69 73 20 nd, if pFKey is
4ab0: 0a 2a 2a 20 64 65 66 65 72 72 65 64 2c 20 77 68 .** deferred, wh
4ac0: 65 6e 20 61 20 72 6f 77 20 69 73 20 69 6e 73 65 en a row is inse
4ad0: 72 74 65 64 20 69 6e 74 6f 20 74 68 65 20 73 61 rted into the sa
4ae0: 6d 65 20 74 61 62 6c 65 2e 20 57 68 65 6e 20 67 me table. When g
4af0: 65 6e 65 72 61 74 69 6e 67 0a 2a 2a 20 63 6f 64 enerating.** cod
4b00: 65 20 66 6f 72 20 61 6e 20 53 51 4c 20 55 50 44 e for an SQL UPD
4b10: 41 54 45 20 6f 70 65 72 61 74 69 6f 6e 2c 20 74 ATE operation, t
4b20: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 his function may
4b30: 20 62 65 20 63 61 6c 6c 65 64 20 74 77 69 63 65 be called twice
4b40: 20 2d 0a 2a 2a 20 6f 6e 63 65 20 74 6f 20 22 64 -.** once to "d
4b50: 65 6c 65 74 65 22 20 74 68 65 20 6f 6c 64 20 72 elete" the old r
4b60: 6f 77 20 61 6e 64 20 6f 6e 63 65 20 74 6f 20 22 ow and once to "
4b70: 69 6e 73 65 72 74 22 20 74 68 65 20 6e 65 77 20 insert" the new
4b80: 72 6f 77 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 row..**.** The c
4b90: 6f 64 65 20 67 65 6e 65 72 61 74 65 64 20 62 79 ode generated by
4ba0: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 this function s
4bb0: 63 61 6e 73 20 74 68 72 6f 75 67 68 20 74 68 65 cans through the
4bc0: 20 72 6f 77 73 20 69 6e 20 74 68 65 20 63 68 69 rows in the chi
4bd0: 6c 64 0a 2a 2a 20 74 61 62 6c 65 20 74 68 61 74 ld.** table that
4be0: 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 74 correspond to t
4bf0: 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 he parent table
4c00: 72 6f 77 20 62 65 69 6e 67 20 64 65 6c 65 74 65 row being delete
4c10: 64 20 6f 72 20 69 6e 73 65 72 74 65 64 2e 0a 2a d or inserted..*
4c20: 2a 20 46 6f 72 20 65 61 63 68 20 63 68 69 6c 64 * For each child
4c30: 20 72 6f 77 20 66 6f 75 6e 64 2c 20 6f 6e 65 20 row found, one
4c40: 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 of the following
4c50: 20 61 63 74 69 6f 6e 73 20 69 73 20 74 61 6b 65 actions is take
4c60: 6e 3a 0a 2a 2a 0a 2a 2a 20 20 20 4f 70 65 72 61 n:.**.** Opera
4c70: 74 69 6f 6e 20 7c 20 46 4b 20 74 79 70 65 20 20 tion | FK type
4c80: 20 7c 20 41 63 74 69 6f 6e 20 74 61 6b 65 6e 0a | Action taken.
4c90: 2a 2a 20 20 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ** -----------
4ca0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4cb0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4cc0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d ----------------
4cd0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a ---------------.
4ce0: 2a 2a 20 20 20 44 45 4c 45 54 45 20 20 20 20 20 ** DELETE
4cf0: 20 69 6d 6d 65 64 69 61 74 65 20 20 20 49 6e 63 immediate Inc
4d00: 72 65 6d 65 6e 74 20 74 68 65 20 22 69 6d 6d 65 rement the "imme
4d10: 64 69 61 74 65 20 63 6f 6e 73 74 72 61 69 6e 74 diate constraint
4d20: 20 63 6f 75 6e 74 65 72 22 2e 0a 2a 2a 20 20 20 counter"..**
4d30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4d40: 20 20 20 20 20 20 20 20 4f 72 2c 20 69 66 20 74 Or, if t
4d50: 68 65 20 4f 4e 20 28 55 50 44 41 54 45 7c 44 45 he ON (UPDATE|DE
4d60: 4c 45 54 45 29 20 61 63 74 69 6f 6e 20 69 73 20 LETE) action is
4d70: 52 45 53 54 52 49 43 54 2c 0a 2a 2a 20 20 20 20 RESTRICT,.**
4d80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4d90: 20 20 20 20 20 20 20 74 68 72 6f 77 20 61 20 22 throw a "
4da0: 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 foreign key cons
4db0: 74 72 61 69 6e 74 20 66 61 69 6c 65 64 22 20 65 traint failed" e
4dc0: 78 63 65 70 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 xception..**.**
4dd0: 20 20 49 4e 53 45 52 54 20 20 20 20 20 20 69 6d INSERT im
4de0: 6d 65 64 69 61 74 65 20 20 20 44 65 63 72 65 6d mediate Decrem
4df0: 65 6e 74 20 74 68 65 20 22 69 6d 6d 65 64 69 61 ent the "immedia
4e00: 74 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f te constraint co
4e10: 75 6e 74 65 72 22 2e 0a 2a 2a 0a 2a 2a 20 20 20 unter"..**.**
4e20: 44 45 4c 45 54 45 20 20 20 20 20 20 64 65 66 65 DELETE defe
4e30: 72 72 65 64 20 20 20 20 49 6e 63 72 65 6d 65 6e rred Incremen
4e40: 74 20 74 68 65 20 22 64 65 66 65 72 72 65 64 20 t the "deferred
4e50: 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e 74 constraint count
4e60: 65 72 22 2e 0a 2a 2a 20 20 20 20 20 20 20 20 20 er"..**
4e70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4e80: 20 20 4f 72 2c 20 69 66 20 74 68 65 20 4f 4e 20 Or, if the ON
4e90: 28 55 50 44 41 54 45 7c 44 45 4c 45 54 45 29 20 (UPDATE|DELETE)
4ea0: 61 63 74 69 6f 6e 20 69 73 20 52 45 53 54 52 49 action is RESTRI
4eb0: 43 54 2c 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 CT,.**
4ec0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
4ed0: 20 74 68 72 6f 77 20 61 20 22 66 6f 72 65 69 67 throw a "foreig
4ee0: 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 n key constraint
4ef0: 20 66 61 69 6c 65 64 22 20 65 78 63 65 70 74 69 failed" excepti
4f00: 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 20 20 49 4e 53 45 on..**.** INSE
4f10: 52 54 20 20 20 20 20 20 64 65 66 65 72 72 65 64 RT deferred
4f20: 20 20 20 20 44 65 63 72 65 6d 65 6e 74 20 74 68 Decrement th
4f30: 65 20 22 64 65 66 65 72 72 65 64 20 63 6f 6e 73 e "deferred cons
4f40: 74 72 61 69 6e 74 20 63 6f 75 6e 74 65 72 22 2e traint counter".
4f50: 0a 2a 2a 0a 2a 2a 20 54 68 65 73 65 20 6f 70 65 .**.** These ope
4f60: 72 61 74 69 6f 6e 73 20 61 72 65 20 69 64 65 6e rations are iden
4f70: 74 69 66 69 65 64 20 69 6e 20 74 68 65 20 63 6f tified in the co
4f80: 6d 6d 65 6e 74 20 61 74 20 74 68 65 20 74 6f 70 mment at the top
4f90: 20 6f 66 20 74 68 69 73 20 66 69 6c 65 20 0a 2a of this file .*
4fa0: 2a 20 28 66 6b 65 79 2e 63 29 20 61 73 20 22 49 * (fkey.c) as "I
4fb0: 2e 32 22 20 61 6e 64 20 22 44 2e 32 22 2e 0a 2a .2" and "D.2"..*
4fc0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 66 6b /.static void fk
4fd0: 53 63 61 6e 43 68 69 6c 64 72 65 6e 28 0a 20 20 ScanChildren(.
4fe0: 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 20 Parse *pParse,
4ff0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5000: 2f 2a 20 50 61 72 73 65 20 63 6f 6e 74 65 78 74 /* Parse context
5010: 20 2a 2f 0a 20 20 53 72 63 4c 69 73 74 20 2a 70 */. SrcList *p
5020: 53 72 63 2c 20 20 20 20 20 20 20 20 20 20 20 20 Src,
5030: 20 20 20 20 20 20 2f 2a 20 53 72 63 4c 69 73 74 /* SrcList
5040: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 containing the
5050: 74 61 62 6c 65 20 74 6f 20 73 63 61 6e 20 2a 2f table to scan */
5060: 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 2c 0a . Table *pTab,.
5070: 20 20 49 6e 64 65 78 20 2a 70 49 64 78 2c 20 20 Index *pIdx,
5080: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5090: 20 20 2f 2a 20 46 6f 72 65 69 67 6e 20 6b 65 79 /* Foreign key
50a0: 20 69 6e 64 65 78 20 2a 2f 0a 20 20 46 4b 65 79 index */. FKey
50b0: 20 2a 70 46 4b 65 79 2c 20 20 20 20 20 20 20 20 *pFKey,
50c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 /* F
50d0: 6f 72 65 69 67 6e 20 6b 65 79 20 72 65 6c 61 74 oreign key relat
50e0: 69 6f 6e 73 68 69 70 20 2a 2f 0a 20 20 69 6e 74 ionship */. int
50f0: 20 2a 61 69 43 6f 6c 2c 20 20 20 20 20 20 20 20 *aiCol,
5100: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
5110: 4d 61 70 20 66 72 6f 6d 20 70 49 64 78 20 63 6f Map from pIdx co
5120: 6c 73 20 74 6f 20 63 68 69 6c 64 20 74 61 62 6c ls to child tabl
5130: 65 20 63 6f 6c 73 20 2a 2f 0a 20 20 69 6e 74 20 e cols */. int
5140: 72 65 67 44 61 74 61 2c 20 20 20 20 20 20 20 20 regData,
5150: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
5160: 65 66 65 72 65 6e 63 65 64 20 74 61 62 6c 65 20 eferenced table
5170: 64 61 74 61 20 73 74 61 72 74 73 20 68 65 72 65 data starts here
5180: 20 2a 2f 0a 20 20 69 6e 74 20 6e 49 6e 63 72 20 */. int nIncr
5190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
51a0: 20 20 20 20 20 20 2f 2a 20 41 6d 6f 75 6e 74 20 /* Amount
51b0: 74 6f 20 69 6e 63 72 65 6d 65 6e 74 20 64 65 66 to increment def
51c0: 65 72 72 65 64 20 63 6f 75 6e 74 65 72 20 62 79 erred counter by
51d0: 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 */.){. sqlite3
51e0: 20 2a 64 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 *db = pParse->d
51f0: 62 3b 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 b; /* Data
5200: 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 base handle */.
5210: 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 int i;
5220: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5230: 20 2f 2a 20 49 74 65 72 61 74 6f 72 20 76 61 72 /* Iterator var
5240: 69 61 62 6c 65 20 2a 2f 0a 20 20 45 78 70 72 20 iable */. Expr
5250: 2a 70 57 68 65 72 65 20 3d 20 30 3b 20 20 20 20 *pWhere = 0;
5260: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 57 48 /* WH
5270: 45 52 45 20 63 6c 61 75 73 65 20 74 6f 20 73 63 ERE clause to sc
5280: 61 6e 20 77 69 74 68 20 2a 2f 0a 20 20 4e 61 6d an with */. Nam
5290: 65 43 6f 6e 74 65 78 74 20 73 4e 61 6d 65 43 6f eContext sNameCo
52a0: 6e 74 65 78 74 3b 20 20 20 20 20 20 20 2f 2a 20 ntext; /*
52b0: 43 6f 6e 74 65 78 74 20 75 73 65 64 20 74 6f 20 Context used to
52c0: 72 65 73 6f 6c 76 65 20 57 48 45 52 45 20 63 6c resolve WHERE cl
52d0: 61 75 73 65 20 2a 2f 0a 20 20 57 68 65 72 65 49 ause */. WhereI
52e0: 6e 66 6f 20 2a 70 57 49 6e 66 6f 3b 20 20 20 20 nfo *pWInfo;
52f0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e /* Con
5300: 74 65 78 74 20 75 73 65 64 20 62 79 20 73 71 6c text used by sql
5310: 69 74 65 33 57 68 65 72 65 58 58 58 28 29 20 2a ite3WhereXXX() *
5320: 2f 0a 20 20 69 6e 74 20 69 46 6b 49 66 5a 65 72 /. int iFkIfZer
5330: 6f 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 o = 0;
5340: 20 20 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f /* Address o
5350: 66 20 4f 50 5f 46 6b 49 66 5a 65 72 6f 20 2a 2f f OP_FkIfZero */
5360: 0a 20 20 56 64 62 65 20 2a 76 20 3d 20 73 71 6c . Vdbe *v = sql
5370: 69 74 65 33 47 65 74 56 64 62 65 28 70 50 61 72 ite3GetVdbe(pPar
5380: 73 65 29 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 se);.. assert(
5390: 21 70 49 64 78 20 7c 7c 20 70 49 64 78 2d 3e 70 !pIdx || pIdx->p
53a0: 54 61 62 6c 65 3d 3d 70 54 61 62 20 29 3b 0a 0a Table==pTab );..
53b0: 20 20 69 66 28 20 6e 49 6e 63 72 3c 30 20 29 7b if( nIncr<0 ){
53c0: 0a 20 20 20 20 69 46 6b 49 66 5a 65 72 6f 20 3d . iFkIfZero =
53d0: 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f sqlite3VdbeAddO
53e0: 70 32 28 76 2c 20 4f 50 5f 46 6b 49 66 5a 65 72 p2(v, OP_FkIfZer
53f0: 6f 2c 20 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 o, pFKey->isDefe
5400: 72 72 65 64 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20 rred, 0);. }..
5410: 20 2f 2a 20 43 72 65 61 74 65 20 61 6e 20 45 78 /* Create an Ex
5420: 70 72 20 6f 62 6a 65 63 74 20 72 65 70 72 65 73 pr object repres
5430: 65 6e 74 69 6e 67 20 61 6e 20 53 51 4c 20 65 78 enting an SQL ex
5440: 70 72 65 73 73 69 6f 6e 20 6c 69 6b 65 3a 0a 20 pression like:.
5450: 20 2a 2a 0a 20 20 2a 2a 20 20 20 3c 70 61 72 65 **. ** <pare
5460: 6e 74 2d 6b 65 79 31 3e 20 3d 20 3c 63 68 69 6c nt-key1> = <chil
5470: 64 2d 6b 65 79 31 3e 20 41 4e 44 20 3c 70 61 72 d-key1> AND <par
5480: 65 6e 74 2d 6b 65 79 32 3e 20 3d 20 3c 63 68 69 ent-key2> = <chi
5490: 6c 64 2d 6b 65 79 32 3e 20 2e 2e 2e 0a 20 20 2a ld-key2> .... *
54a0: 2a 0a 20 20 2a 2a 20 54 68 65 20 63 6f 6c 6c 61 *. ** The colla
54b0: 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 75 73 tion sequence us
54c0: 65 64 20 66 6f 72 20 74 68 65 20 63 6f 6d 70 61 ed for the compa
54d0: 72 69 73 6f 6e 20 73 68 6f 75 6c 64 20 62 65 20 rison should be
54e0: 74 68 61 74 20 6f 66 0a 20 20 2a 2a 20 74 68 65 that of. ** the
54f0: 20 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 parent key colu
5500: 6d 6e 73 2e 20 54 68 65 20 61 66 66 69 6e 69 74 mns. The affinit
5510: 79 20 6f 66 20 74 68 65 20 70 61 72 65 6e 74 20 y of the parent
5520: 6b 65 79 20 63 6f 6c 75 6d 6e 20 73 68 6f 75 6c key column shoul
5530: 64 0a 20 20 2a 2a 20 62 65 20 61 70 70 6c 69 65 d. ** be applie
5540: 64 20 74 6f 20 65 61 63 68 20 63 68 69 6c 64 20 d to each child
5550: 6b 65 79 20 76 61 6c 75 65 20 62 65 66 6f 72 65 key value before
5560: 20 74 68 65 20 63 6f 6d 70 61 72 69 73 6f 6e 20 the comparison
5570: 74 61 6b 65 73 20 70 6c 61 63 65 2e 0a 20 20 2a takes place.. *
5580: 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 /. for(i=0; i<p
5590: 46 4b 65 79 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29 FKey->nCol; i++)
55a0: 7b 0a 20 20 20 20 45 78 70 72 20 2a 70 4c 65 66 {. Expr *pLef
55b0: 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 t;
55c0: 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 66 72 6f /* Value fro
55d0: 6d 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 72 m parent table r
55e0: 6f 77 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a ow */. Expr *
55f0: 70 52 69 67 68 74 3b 20 20 20 20 20 20 20 20 20 pRight;
5600: 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d /* Colum
5610: 6e 20 72 65 66 20 74 6f 20 63 68 69 6c 64 20 74 n ref to child t
5620: 61 62 6c 65 20 2a 2f 0a 20 20 20 20 45 78 70 72 able */. Expr
5630: 20 2a 70 45 71 3b 20 20 20 20 20 20 20 20 20 20 *pEq;
5640: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 78 70 /* Exp
5650: 72 65 73 73 69 6f 6e 20 28 70 4c 65 66 74 20 3d ression (pLeft =
5660: 20 70 52 69 67 68 74 29 20 2a 2f 0a 20 20 20 20 pRight) */.
5670: 69 6e 74 20 69 43 6f 6c 3b 20 20 20 20 20 20 20 int iCol;
5680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
5690: 20 49 6e 64 65 78 20 6f 66 20 63 6f 6c 75 6d 6e Index of column
56a0: 20 69 6e 20 63 68 69 6c 64 20 74 61 62 6c 65 20 in child table
56b0: 2a 2f 20 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 */ . const ch
56c0: 61 72 20 2a 7a 43 6f 6c 3b 20 20 20 20 20 20 20 ar *zCol;
56d0: 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f 66 /* Name of
56e0: 20 63 6f 6c 75 6d 6e 20 69 6e 20 63 68 69 6c 64 column in child
56f0: 20 74 61 62 6c 65 20 2a 2f 0a 0a 20 20 20 20 70 table */.. p
5700: 4c 65 66 74 20 3d 20 73 71 6c 69 74 65 33 45 78 Left = sqlite3Ex
5710: 70 72 28 64 62 2c 20 54 4b 5f 52 45 47 49 53 54 pr(db, TK_REGIST
5720: 45 52 2c 20 30 29 3b 0a 20 20 20 20 69 66 28 20 ER, 0);. if(
5730: 70 4c 65 66 74 20 29 7b 0a 20 20 20 20 20 20 2f pLeft ){. /
5740: 2a 20 53 65 74 20 74 68 65 20 63 6f 6c 6c 61 74 * Set the collat
5750: 69 6f 6e 20 73 65 71 75 65 6e 63 65 20 61 6e 64 ion sequence and
5760: 20 61 66 66 69 6e 69 74 79 20 6f 66 20 74 68 65 affinity of the
5770: 20 4c 48 53 20 6f 66 20 65 61 63 68 20 54 4b 5f LHS of each TK_
5780: 45 51 0a 20 20 20 20 20 20 2a 2a 20 65 78 70 72 EQ. ** expr
5790: 65 73 73 69 6f 6e 20 74 6f 20 74 68 65 20 70 61 ession to the pa
57a0: 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 20 rent key column
57b0: 64 65 66 61 75 6c 74 73 2e 20 20 2a 2f 0a 20 20 defaults. */.
57c0: 20 20 20 20 69 66 28 20 70 49 64 78 20 29 7b 0a if( pIdx ){.
57d0: 20 20 20 20 20 20 20 20 43 6f 6c 75 6d 6e 20 2a Column *
57e0: 70 43 6f 6c 3b 0a 20 20 20 20 20 20 20 20 63 6f pCol;. co
57f0: 6e 73 74 20 63 68 61 72 20 2a 7a 43 6f 6c 6c 3b nst char *zColl;
5800: 0a 20 20 20 20 20 20 20 20 69 43 6f 6c 20 3d 20 . iCol =
5810: 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 69 pIdx->aiColumn[i
5820: 5d 3b 0a 20 20 20 20 20 20 20 20 70 43 6f 6c 20 ];. pCol
5830: 3d 20 26 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 43 = &pTab->aCol[iC
5840: 6f 6c 5d 3b 0a 20 20 20 20 20 20 20 20 69 66 28 ol];. if(
5850: 20 70 54 61 62 2d 3e 69 50 4b 65 79 3d 3d 69 43 pTab->iPKey==iC
5860: 6f 6c 20 29 20 69 43 6f 6c 20 3d 20 2d 31 3b 0a ol ) iCol = -1;.
5870: 20 20 20 20 20 20 20 20 70 4c 65 66 74 2d 3e 69 pLeft->i
5880: 54 61 62 6c 65 20 3d 20 72 65 67 44 61 74 61 2b Table = regData+
5890: 69 43 6f 6c 2b 31 3b 0a 20 20 20 20 20 20 20 20 iCol+1;.
58a0: 70 4c 65 66 74 2d 3e 61 66 66 69 6e 69 74 79 20 pLeft->affinity
58b0: 3d 20 70 43 6f 6c 2d 3e 61 66 66 69 6e 69 74 79 = pCol->affinity
58c0: 3b 0a 20 20 20 20 20 20 20 20 7a 43 6f 6c 6c 20 ;. zColl
58d0: 3d 20 70 43 6f 6c 2d 3e 7a 43 6f 6c 6c 3b 0a 20 = pCol->zColl;.
58e0: 20 20 20 20 20 20 20 69 66 28 20 7a 43 6f 6c 6c if( zColl
58f0: 3d 3d 30 20 29 20 7a 43 6f 6c 6c 20 3d 20 64 62 ==0 ) zColl = db
5900: 2d 3e 70 44 66 6c 74 43 6f 6c 6c 2d 3e 7a 4e 61 ->pDfltColl->zNa
5910: 6d 65 3b 0a 20 20 20 20 20 20 20 20 70 4c 65 66 me;. pLef
5920: 74 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 41 t = sqlite3ExprA
5930: 64 64 43 6f 6c 6c 61 74 65 53 74 72 69 6e 67 28 ddCollateString(
5940: 70 50 61 72 73 65 2c 20 70 4c 65 66 74 2c 20 7a pParse, pLeft, z
5950: 43 6f 6c 6c 29 3b 0a 20 20 20 20 20 20 7d 65 6c Coll);. }el
5960: 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4c 65 66 se{. pLef
5970: 74 2d 3e 69 54 61 62 6c 65 20 3d 20 72 65 67 44 t->iTable = regD
5980: 61 74 61 3b 0a 20 20 20 20 20 20 20 20 70 4c 65 ata;. pLe
5990: 66 74 2d 3e 61 66 66 69 6e 69 74 79 20 3d 20 53 ft->affinity = S
59a0: 51 4c 49 54 45 5f 41 46 46 5f 49 4e 54 45 47 45 QLITE_AFF_INTEGE
59b0: 52 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d R;. }. }
59c0: 0a 20 20 20 20 69 43 6f 6c 20 3d 20 61 69 43 6f . iCol = aiCo
59d0: 6c 20 3f 20 61 69 43 6f 6c 5b 69 5d 20 3a 20 70 l ? aiCol[i] : p
59e0: 46 4b 65 79 2d 3e 61 43 6f 6c 5b 30 5d 2e 69 46 FKey->aCol[0].iF
59f0: 72 6f 6d 3b 0a 20 20 20 20 61 73 73 65 72 74 28 rom;. assert(
5a00: 20 69 43 6f 6c 3e 3d 30 20 29 3b 0a 20 20 20 20 iCol>=0 );.
5a10: 7a 43 6f 6c 20 3d 20 70 46 4b 65 79 2d 3e 70 46 zCol = pFKey->pF
5a20: 72 6f 6d 2d 3e 61 43 6f 6c 5b 69 43 6f 6c 5d 2e rom->aCol[iCol].
5a30: 7a 4e 61 6d 65 3b 0a 20 20 20 20 70 52 69 67 68 zName;. pRigh
5a40: 74 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 28 t = sqlite3Expr(
5a50: 64 62 2c 20 54 4b 5f 49 44 2c 20 7a 43 6f 6c 29 db, TK_ID, zCol)
5a60: 3b 0a 20 20 20 20 70 45 71 20 3d 20 73 71 6c 69 ;. pEq = sqli
5a70: 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c te3PExpr(pParse,
5a80: 20 54 4b 5f 45 51 2c 20 70 4c 65 66 74 2c 20 70 TK_EQ, pLeft, p
5a90: 52 69 67 68 74 2c 20 30 29 3b 0a 20 20 20 20 70 Right, 0);. p
5aa0: 57 68 65 72 65 20 3d 20 73 71 6c 69 74 65 33 45 Where = sqlite3E
5ab0: 78 70 72 41 6e 64 28 64 62 2c 20 70 57 68 65 72 xprAnd(db, pWher
5ac0: 65 2c 20 70 45 71 29 3b 0a 20 20 7d 0a 0a 20 20 e, pEq);. }..
5ad0: 2f 2a 20 49 66 20 74 68 65 20 63 68 69 6c 64 20 /* If the child
5ae0: 74 61 62 6c 65 20 69 73 20 74 68 65 20 73 61 6d table is the sam
5af0: 65 20 61 73 20 74 68 65 20 70 61 72 65 6e 74 20 e as the parent
5b00: 74 61 62 6c 65 2c 20 61 6e 64 20 74 68 69 73 20 table, and this
5b10: 73 63 61 6e 0a 20 20 2a 2a 20 69 73 20 74 61 6b scan. ** is tak
5b20: 69 6e 67 20 70 6c 61 63 65 20 61 73 20 70 61 72 ing place as par
5b30: 74 20 6f 66 20 61 20 44 45 4c 45 54 45 20 6f 70 t of a DELETE op
5b40: 65 72 61 74 69 6f 6e 20 28 6f 70 65 72 61 74 69 eration (operati
5b50: 6f 6e 20 44 2e 32 29 2c 20 6f 6d 69 74 20 74 68 on D.2), omit th
5b60: 65 0a 20 20 2a 2a 20 72 6f 77 20 62 65 69 6e 67 e. ** row being
5b70: 20 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 74 68 deleted from th
5b80: 65 20 73 63 61 6e 20 62 79 20 61 64 64 69 6e 67 e scan by adding
5b90: 20 28 24 72 6f 77 69 64 20 21 3d 20 72 6f 77 69 ($rowid != rowi
5ba0: 64 29 20 74 6f 20 74 68 65 20 57 48 45 52 45 20 d) to the WHERE
5bb0: 0a 20 20 2a 2a 20 63 6c 61 75 73 65 2c 20 77 68 . ** clause, wh
5bc0: 65 72 65 20 24 72 6f 77 69 64 20 69 73 20 74 68 ere $rowid is th
5bd0: 65 20 72 6f 77 69 64 20 6f 66 20 74 68 65 20 72 e rowid of the r
5be0: 6f 77 20 62 65 69 6e 67 20 64 65 6c 65 74 65 64 ow being deleted
5bf0: 2e 20 20 2a 2f 0a 20 20 69 66 28 20 70 54 61 62 . */. if( pTab
5c00: 3d 3d 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 20 26 ==pFKey->pFrom &
5c10: 26 20 6e 49 6e 63 72 3e 30 20 29 7b 0a 20 20 20 & nIncr>0 ){.
5c20: 20 45 78 70 72 20 2a 70 45 71 3b 20 20 20 20 20 Expr *pEq;
5c30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
5c40: 2a 20 45 78 70 72 65 73 73 69 6f 6e 20 28 70 4c * Expression (pL
5c50: 65 66 74 20 3d 20 70 52 69 67 68 74 29 20 2a 2f eft = pRight) */
5c60: 0a 20 20 20 20 45 78 70 72 20 2a 70 4c 65 66 74 . Expr *pLeft
5c70: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
5c80: 20 20 20 2f 2a 20 56 61 6c 75 65 20 66 72 6f 6d /* Value from
5c90: 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 72 6f parent table ro
5ca0: 77 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 w */. Expr *p
5cb0: 52 69 67 68 74 3b 20 20 20 20 20 20 20 20 20 20 Right;
5cc0: 20 20 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e /* Column
5cd0: 20 72 65 66 20 74 6f 20 63 68 69 6c 64 20 74 61 ref to child ta
5ce0: 62 6c 65 20 2a 2f 0a 20 20 20 20 70 4c 65 66 74 ble */. pLeft
5cf0: 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 28 64 = sqlite3Expr(d
5d00: 62 2c 20 54 4b 5f 52 45 47 49 53 54 45 52 2c 20 b, TK_REGISTER,
5d10: 30 29 3b 0a 20 20 20 20 70 52 69 67 68 74 20 3d 0);. pRight =
5d20: 20 73 71 6c 69 74 65 33 45 78 70 72 28 64 62 2c sqlite3Expr(db,
5d30: 20 54 4b 5f 43 4f 4c 55 4d 4e 2c 20 30 29 3b 0a TK_COLUMN, 0);.
5d40: 20 20 20 20 69 66 28 20 70 4c 65 66 74 20 26 26 if( pLeft &&
5d50: 20 70 52 69 67 68 74 20 29 7b 0a 20 20 20 20 20 pRight ){.
5d60: 20 70 4c 65 66 74 2d 3e 69 54 61 62 6c 65 20 3d pLeft->iTable =
5d70: 20 72 65 67 44 61 74 61 3b 0a 20 20 20 20 20 20 regData;.
5d80: 70 4c 65 66 74 2d 3e 61 66 66 69 6e 69 74 79 20 pLeft->affinity
5d90: 3d 20 53 51 4c 49 54 45 5f 41 46 46 5f 49 4e 54 = SQLITE_AFF_INT
5da0: 45 47 45 52 3b 0a 20 20 20 20 20 20 70 52 69 67 EGER;. pRig
5db0: 68 74 2d 3e 69 54 61 62 6c 65 20 3d 20 70 53 72 ht->iTable = pSr
5dc0: 63 2d 3e 61 5b 30 5d 2e 69 43 75 72 73 6f 72 3b c->a[0].iCursor;
5dd0: 0a 20 20 20 20 20 20 70 52 69 67 68 74 2d 3e 69 . pRight->i
5de0: 43 6f 6c 75 6d 6e 20 3d 20 2d 31 3b 0a 20 20 20 Column = -1;.
5df0: 20 7d 0a 20 20 20 20 70 45 71 20 3d 20 73 71 6c }. pEq = sql
5e00: 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 ite3PExpr(pParse
5e10: 2c 20 54 4b 5f 4e 45 2c 20 70 4c 65 66 74 2c 20 , TK_NE, pLeft,
5e20: 70 52 69 67 68 74 2c 20 30 29 3b 0a 20 20 20 20 pRight, 0);.
5e30: 70 57 68 65 72 65 20 3d 20 73 71 6c 69 74 65 33 pWhere = sqlite3
5e40: 45 78 70 72 41 6e 64 28 64 62 2c 20 70 57 68 65 ExprAnd(db, pWhe
5e50: 72 65 2c 20 70 45 71 29 3b 0a 20 20 7d 0a 0a 20 re, pEq);. }..
5e60: 20 2f 2a 20 52 65 73 6f 6c 76 65 20 74 68 65 20 /* Resolve the
5e70: 72 65 66 65 72 65 6e 63 65 73 20 69 6e 20 74 68 references in th
5e80: 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 2e 20 e WHERE clause.
5e90: 2a 2f 0a 20 20 6d 65 6d 73 65 74 28 26 73 4e 61 */. memset(&sNa
5ea0: 6d 65 43 6f 6e 74 65 78 74 2c 20 30 2c 20 73 69 meContext, 0, si
5eb0: 7a 65 6f 66 28 4e 61 6d 65 43 6f 6e 74 65 78 74 zeof(NameContext
5ec0: 29 29 3b 0a 20 20 73 4e 61 6d 65 43 6f 6e 74 65 ));. sNameConte
5ed0: 78 74 2e 70 53 72 63 4c 69 73 74 20 3d 20 70 53 xt.pSrcList = pS
5ee0: 72 63 3b 0a 20 20 73 4e 61 6d 65 43 6f 6e 74 65 rc;. sNameConte
5ef0: 78 74 2e 70 50 61 72 73 65 20 3d 20 70 50 61 72 xt.pParse = pPar
5f00: 73 65 3b 0a 20 20 73 71 6c 69 74 65 33 52 65 73 se;. sqlite3Res
5f10: 6f 6c 76 65 45 78 70 72 4e 61 6d 65 73 28 26 73 olveExprNames(&s
5f20: 4e 61 6d 65 43 6f 6e 74 65 78 74 2c 20 70 57 68 NameContext, pWh
5f30: 65 72 65 29 3b 0a 0a 20 20 2f 2a 20 43 72 65 61 ere);.. /* Crea
5f40: 74 65 20 56 44 42 45 20 74 6f 20 6c 6f 6f 70 20 te VDBE to loop
5f50: 74 68 72 6f 75 67 68 20 74 68 65 20 65 6e 74 72 through the entr
5f60: 69 65 73 20 69 6e 20 70 53 72 63 20 74 68 61 74 ies in pSrc that
5f70: 20 6d 61 74 63 68 20 74 68 65 20 57 48 45 52 45 match the WHERE
5f80: 0a 20 20 2a 2a 20 63 6c 61 75 73 65 2e 20 49 66 . ** clause. If
5f90: 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 the constraint
5fa0: 69 73 20 6e 6f 74 20 64 65 66 65 72 72 65 64 2c is not deferred,
5fb0: 20 74 68 72 6f 77 20 61 6e 20 65 78 63 65 70 74 throw an except
5fc0: 69 6f 6e 20 66 6f 72 0a 20 20 2a 2a 20 65 61 63 ion for. ** eac
5fd0: 68 20 72 6f 77 20 66 6f 75 6e 64 2e 20 4f 74 68 h row found. Oth
5fe0: 65 72 77 69 73 65 2c 20 66 6f 72 20 64 65 66 65 erwise, for defe
5ff0: 72 72 65 64 20 63 6f 6e 73 74 72 61 69 6e 74 73 rred constraints
6000: 2c 20 69 6e 63 72 65 6d 65 6e 74 20 74 68 65 0a , increment the.
6010: 20 20 2a 2a 20 64 65 66 65 72 72 65 64 20 63 6f ** deferred co
6020: 6e 73 74 72 61 69 6e 74 20 63 6f 75 6e 74 65 72 nstraint counter
6030: 20 62 79 20 6e 49 6e 63 72 20 66 6f 72 20 65 61 by nIncr for ea
6040: 63 68 20 72 6f 77 20 73 65 6c 65 63 74 65 64 2e ch row selected.
6050: 20 20 2a 2f 0a 20 20 70 57 49 6e 66 6f 20 3d 20 */. pWInfo =
6060: 73 71 6c 69 74 65 33 57 68 65 72 65 42 65 67 69 sqlite3WhereBegi
6070: 6e 28 70 50 61 72 73 65 2c 20 70 53 72 63 2c 20 n(pParse, pSrc,
6080: 70 57 68 65 72 65 2c 20 30 2c 20 30 2c 20 30 2c pWhere, 0, 0, 0,
6090: 20 30 29 3b 0a 20 20 69 66 28 20 6e 49 6e 63 72 0);. if( nIncr
60a0: 3e 30 20 26 26 20 70 46 4b 65 79 2d 3e 69 73 44 >0 && pFKey->isD
60b0: 65 66 65 72 72 65 64 3d 3d 30 20 29 7b 0a 20 20 eferred==0 ){.
60c0: 20 20 73 71 6c 69 74 65 33 50 61 72 73 65 54 6f sqlite3ParseTo
60d0: 70 6c 65 76 65 6c 28 70 50 61 72 73 65 29 2d 3e plevel(pParse)->
60e0: 6d 61 79 41 62 6f 72 74 20 3d 20 31 3b 0a 20 20 mayAbort = 1;.
60f0: 7d 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 }. sqlite3VdbeA
6100: 64 64 4f 70 32 28 76 2c 20 4f 50 5f 46 6b 43 6f ddOp2(v, OP_FkCo
6110: 75 6e 74 65 72 2c 20 70 46 4b 65 79 2d 3e 69 73 unter, pFKey->is
6120: 44 65 66 65 72 72 65 64 2c 20 6e 49 6e 63 72 29 Deferred, nIncr)
6130: 3b 0a 20 20 69 66 28 20 70 57 49 6e 66 6f 20 29 ;. if( pWInfo )
6140: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 57 68 65 {. sqlite3Whe
6150: 72 65 45 6e 64 28 70 57 49 6e 66 6f 29 3b 0a 20 reEnd(pWInfo);.
6160: 20 7d 0a 0a 20 20 2f 2a 20 43 6c 65 61 6e 20 75 }.. /* Clean u
6170: 70 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 p the WHERE clau
6180: 73 65 20 63 6f 6e 73 74 72 75 63 74 65 64 20 61 se constructed a
6190: 62 6f 76 65 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 bove. */. sqlit
61a0: 65 33 45 78 70 72 44 65 6c 65 74 65 28 64 62 2c e3ExprDelete(db,
61b0: 20 70 57 68 65 72 65 29 3b 0a 20 20 69 66 28 20 pWhere);. if(
61c0: 69 46 6b 49 66 5a 65 72 6f 20 29 7b 0a 20 20 20 iFkIfZero ){.
61d0: 20 73 71 6c 69 74 65 33 56 64 62 65 4a 75 6d 70 sqlite3VdbeJump
61e0: 48 65 72 65 28 76 2c 20 69 46 6b 49 66 5a 65 72 Here(v, iFkIfZer
61f0: 6f 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a o);. }.}../*.**
6200: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 This function r
6210: 65 74 75 72 6e 73 20 61 20 70 6f 69 6e 74 65 72 eturns a pointer
6220: 20 74 6f 20 74 68 65 20 68 65 61 64 20 6f 66 20 to the head of
6230: 61 20 6c 69 6e 6b 65 64 20 6c 69 73 74 20 6f 66 a linked list of
6240: 20 46 4b 0a 2a 2a 20 63 6f 6e 73 74 72 61 69 6e FK.** constrain
6250: 74 73 20 66 6f 72 20 77 68 69 63 68 20 74 61 62 ts for which tab
6260: 6c 65 20 70 54 61 62 20 69 73 20 74 68 65 20 70 le pTab is the p
6270: 61 72 65 6e 74 20 74 61 62 6c 65 2e 20 46 6f 72 arent table. For
6280: 20 65 78 61 6d 70 6c 65 2c 0a 2a 2a 20 67 69 76 example,.** giv
6290: 65 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 en the following
62a0: 20 73 63 68 65 6d 61 3a 0a 2a 2a 0a 2a 2a 20 20 schema:.**.**
62b0: 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 74 31 CREATE TABLE t1
62c0: 28 61 20 50 52 49 4d 41 52 59 20 4b 45 59 29 3b (a PRIMARY KEY);
62d0: 0a 2a 2a 20 20 20 43 52 45 41 54 45 20 54 41 42 .** CREATE TAB
62e0: 4c 45 20 74 32 28 62 20 52 45 46 45 52 45 4e 43 LE t2(b REFERENC
62f0: 45 53 20 74 31 28 61 29 3b 0a 2a 2a 0a 2a 2a 20 ES t1(a);.**.**
6300: 43 61 6c 6c 69 6e 67 20 74 68 69 73 20 66 75 6e Calling this fun
6310: 63 74 69 6f 6e 20 77 69 74 68 20 74 61 62 6c 65 ction with table
6320: 20 22 74 31 22 20 61 73 20 61 6e 20 61 72 67 75 "t1" as an argu
6330: 6d 65 6e 74 20 72 65 74 75 72 6e 73 20 61 20 70 ment returns a p
6340: 6f 69 6e 74 65 72 0a 2a 2a 20 74 6f 20 74 68 65 ointer.** to the
6350: 20 46 4b 65 79 20 73 74 72 75 63 74 75 72 65 20 FKey structure
6360: 72 65 70 72 65 73 65 6e 74 69 6e 67 20 74 68 65 representing the
6370: 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e foreign key con
6380: 73 74 72 61 69 6e 74 20 6f 6e 20 74 61 62 6c 65 straint on table
6390: 0a 2a 2a 20 22 74 32 22 2e 20 43 61 6c 6c 69 6e .** "t2". Callin
63a0: 67 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 g this function
63b0: 77 69 74 68 20 22 74 32 22 20 61 73 20 74 68 65 with "t2" as the
63c0: 20 61 72 67 75 6d 65 6e 74 20 77 6f 75 6c 64 20 argument would
63d0: 72 65 74 75 72 6e 20 61 0a 2a 2a 20 4e 55 4c 4c return a.** NULL
63e0: 20 70 6f 69 6e 74 65 72 20 28 61 73 20 74 68 65 pointer (as the
63f0: 72 65 20 61 72 65 20 6e 6f 20 46 4b 20 63 6f 6e re are no FK con
6400: 73 74 72 61 69 6e 74 73 20 66 6f 72 20 77 68 69 straints for whi
6410: 63 68 20 74 32 20 69 73 20 74 68 65 20 70 61 72 ch t2 is the par
6420: 65 6e 74 0a 2a 2a 20 74 61 62 6c 65 29 2e 0a 2a ent.** table)..*
6430: 2f 0a 46 4b 65 79 20 2a 73 71 6c 69 74 65 33 46 /.FKey *sqlite3F
6440: 6b 52 65 66 65 72 65 6e 63 65 73 28 54 61 62 6c kReferences(Tabl
6450: 65 20 2a 70 54 61 62 29 7b 0a 20 20 69 6e 74 20 e *pTab){. int
6460: 6e 4e 61 6d 65 20 3d 20 73 71 6c 69 74 65 33 53 nName = sqlite3S
6470: 74 72 6c 65 6e 33 30 28 70 54 61 62 2d 3e 7a 4e trlen30(pTab->zN
6480: 61 6d 65 29 3b 0a 20 20 72 65 74 75 72 6e 20 28 ame);. return (
6490: 46 4b 65 79 20 2a 29 73 71 6c 69 74 65 33 48 61 FKey *)sqlite3Ha
64a0: 73 68 46 69 6e 64 28 26 70 54 61 62 2d 3e 70 53 shFind(&pTab->pS
64b0: 63 68 65 6d 61 2d 3e 66 6b 65 79 48 61 73 68 2c chema->fkeyHash,
64c0: 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20 6e 4e pTab->zName, nN
64d0: 61 6d 65 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 ame);.}../*.** T
64e0: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65 he second argume
64f0: 6e 74 20 69 73 20 61 20 54 72 69 67 67 65 72 20 nt is a Trigger
6500: 73 74 72 75 63 74 75 72 65 20 61 6c 6c 6f 63 61 structure alloca
6510: 74 65 64 20 62 79 20 74 68 65 20 0a 2a 2a 20 66 ted by the .** f
6520: 6b 41 63 74 69 6f 6e 54 72 69 67 67 65 72 28 29 kActionTrigger()
6530: 20 72 6f 75 74 69 6e 65 2e 20 54 68 69 73 20 66 routine. This f
6540: 75 6e 63 74 69 6f 6e 20 64 65 6c 65 74 65 73 20 unction deletes
6550: 74 68 65 20 54 72 69 67 67 65 72 20 73 74 72 75 the Trigger stru
6560: 63 74 75 72 65 0a 2a 2a 20 61 6e 64 20 61 6c 6c cture.** and all
6570: 20 6f 66 20 69 74 73 20 73 75 62 2d 63 6f 6d 70 of its sub-comp
6580: 6f 6e 65 6e 74 73 2e 0a 2a 2a 0a 2a 2a 20 54 68 onents..**.** Th
6590: 65 20 54 72 69 67 67 65 72 20 73 74 72 75 63 74 e Trigger struct
65a0: 75 72 65 20 6f 72 20 61 6e 79 20 6f 66 20 69 74 ure or any of it
65b0: 73 20 73 75 62 2d 63 6f 6d 70 6f 6e 65 6e 74 73 s sub-components
65c0: 20 6d 61 79 20 62 65 20 61 6c 6c 6f 63 61 74 65 may be allocate
65d0: 64 20 66 72 6f 6d 0a 2a 2a 20 74 68 65 20 6c 6f d from.** the lo
65e0: 6f 6b 61 73 69 64 65 20 62 75 66 66 65 72 20 62 okaside buffer b
65f0: 65 6c 6f 6e 67 69 6e 67 20 74 6f 20 64 61 74 61 elonging to data
6600: 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62 4d 65 base handle dbMe
6610: 6d 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 m..*/.static voi
6620: 64 20 66 6b 54 72 69 67 67 65 72 44 65 6c 65 74 d fkTriggerDelet
6630: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 4d 65 6d e(sqlite3 *dbMem
6640: 2c 20 54 72 69 67 67 65 72 20 2a 70 29 7b 0a 20 , Trigger *p){.
6650: 20 69 66 28 20 70 20 29 7b 0a 20 20 20 20 54 72 if( p ){. Tr
6660: 69 67 67 65 72 53 74 65 70 20 2a 70 53 74 65 70 iggerStep *pStep
6670: 20 3d 20 70 2d 3e 73 74 65 70 5f 6c 69 73 74 3b = p->step_list;
6680: 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 72 . sqlite3Expr
6690: 44 65 6c 65 74 65 28 64 62 4d 65 6d 2c 20 70 53 Delete(dbMem, pS
66a0: 74 65 70 2d 3e 70 57 68 65 72 65 29 3b 0a 20 20 tep->pWhere);.
66b0: 20 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 sqlite3ExprLis
66c0: 74 44 65 6c 65 74 65 28 64 62 4d 65 6d 2c 20 70 tDelete(dbMem, p
66d0: 53 74 65 70 2d 3e 70 45 78 70 72 4c 69 73 74 29 Step->pExprList)
66e0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 65 6c ;. sqlite3Sel
66f0: 65 63 74 44 65 6c 65 74 65 28 64 62 4d 65 6d 2c ectDelete(dbMem,
6700: 20 70 53 74 65 70 2d 3e 70 53 65 6c 65 63 74 29 pStep->pSelect)
6710: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 ;. sqlite3Exp
6720: 72 44 65 6c 65 74 65 28 64 62 4d 65 6d 2c 20 70 rDelete(dbMem, p
6730: 2d 3e 70 57 68 65 6e 29 3b 0a 20 20 20 20 73 71 ->pWhen);. sq
6740: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 4d 65 lite3DbFree(dbMe
6750: 6d 2c 20 70 29 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a m, p);. }.}../*
6760: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f .** This functio
6770: 6e 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20 67 n is called to g
6780: 65 6e 65 72 61 74 65 20 63 6f 64 65 20 74 68 61 enerate code tha
6790: 74 20 72 75 6e 73 20 77 68 65 6e 20 74 61 62 6c t runs when tabl
67a0: 65 20 70 54 61 62 20 69 73 0a 2a 2a 20 62 65 69 e pTab is.** bei
67b0: 6e 67 20 64 72 6f 70 70 65 64 20 66 72 6f 6d 20 ng dropped from
67c0: 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 54 68 the database. Th
67d0: 65 20 53 72 63 4c 69 73 74 20 70 61 73 73 65 64 e SrcList passed
67e0: 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 20 61 as the second a
67f0: 72 67 75 6d 65 6e 74 0a 2a 2a 20 74 6f 20 74 68 rgument.** to th
6800: 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 6f 6e 74 is function cont
6810: 61 69 6e 73 20 61 20 73 69 6e 67 6c 65 20 65 6e ains a single en
6820: 74 72 79 20 67 75 61 72 61 6e 74 65 65 64 20 74 try guaranteed t
6830: 6f 20 72 65 73 6f 6c 76 65 20 74 6f 0a 2a 2a 20 o resolve to.**
6840: 74 61 62 6c 65 20 70 54 61 62 2e 0a 2a 2a 0a 2a table pTab..**.*
6850: 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 6e 6f 20 63 * Normally, no c
6860: 6f 64 65 20 69 73 20 72 65 71 75 69 72 65 64 2e ode is required.
6870: 20 48 6f 77 65 76 65 72 2c 20 69 66 20 65 69 74 However, if eit
6880: 68 65 72 0a 2a 2a 0a 2a 2a 20 20 20 28 61 29 20 her.**.** (a)
6890: 54 68 65 20 74 61 62 6c 65 20 69 73 20 74 68 65 The table is the
68a0: 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 6f 66 parent table of
68b0: 20 61 20 46 4b 20 63 6f 6e 73 74 72 61 69 6e 74 a FK constraint
68c0: 2c 20 6f 72 0a 2a 2a 20 20 20 28 62 29 20 54 68 , or.** (b) Th
68d0: 65 20 74 61 62 6c 65 20 69 73 20 74 68 65 20 63 e table is the c
68e0: 68 69 6c 64 20 74 61 62 6c 65 20 6f 66 20 61 20 hild table of a
68f0: 64 65 66 65 72 72 65 64 20 46 4b 20 63 6f 6e 73 deferred FK cons
6900: 74 72 61 69 6e 74 20 61 6e 64 20 69 74 20 69 73 traint and it is
6910: 0a 2a 2a 20 20 20 20 20 20 20 64 65 74 65 72 6d .** determ
6920: 69 6e 65 64 20 61 74 20 72 75 6e 74 69 6d 65 20 ined at runtime
6930: 74 68 61 74 20 74 68 65 72 65 20 61 72 65 20 6f that there are o
6940: 75 74 73 74 61 6e 64 69 6e 67 20 64 65 66 65 72 utstanding defer
6950: 72 65 64 20 46 4b 20 0a 2a 2a 20 20 20 20 20 20 red FK .**
6960: 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c constraint viol
6970: 61 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 64 61 ations in the da
6980: 74 61 62 61 73 65 2c 0a 2a 2a 0a 2a 2a 20 74 68 tabase,.**.** th
6990: 65 6e 20 74 68 65 20 65 71 75 69 76 61 6c 65 6e en the equivalen
69a0: 74 20 6f 66 20 22 44 45 4c 45 54 45 20 46 52 4f t of "DELETE FRO
69b0: 4d 20 3c 74 62 6c 3e 22 20 69 73 20 65 78 65 63 M <tbl>" is exec
69c0: 75 74 65 64 20 62 65 66 6f 72 65 20 64 72 6f 70 uted before drop
69d0: 70 69 6e 67 0a 2a 2a 20 74 68 65 20 74 61 62 6c ping.** the tabl
69e0: 65 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 e from the datab
69f0: 61 73 65 2e 20 54 72 69 67 67 65 72 73 20 61 72 ase. Triggers ar
6a00: 65 20 64 69 73 61 62 6c 65 64 20 77 68 69 6c 65 e disabled while
6a10: 20 72 75 6e 6e 69 6e 67 20 74 68 69 73 0a 2a 2a running this.**
6a20: 20 44 45 4c 45 54 45 2c 20 62 75 74 20 66 6f 72 DELETE, but for
6a30: 65 69 67 6e 20 6b 65 79 20 61 63 74 69 6f 6e 73 eign key actions
6a40: 20 61 72 65 20 6e 6f 74 2e 0a 2a 2f 0a 76 6f 69 are not..*/.voi
6a50: 64 20 73 71 6c 69 74 65 33 46 6b 44 72 6f 70 54 d sqlite3FkDropT
6a60: 61 62 6c 65 28 50 61 72 73 65 20 2a 70 50 61 72 able(Parse *pPar
6a70: 73 65 2c 20 53 72 63 4c 69 73 74 20 2a 70 4e 61 se, SrcList *pNa
6a80: 6d 65 2c 20 54 61 62 6c 65 20 2a 70 54 61 62 29 me, Table *pTab)
6a90: 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 {. sqlite3 *db
6aa0: 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 = pParse->db;.
6ab0: 69 66 28 20 28 64 62 2d 3e 66 6c 61 67 73 26 53 if( (db->flags&S
6ac0: 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 QLITE_ForeignKey
6ad0: 73 29 20 26 26 20 21 49 73 56 69 72 74 75 61 6c s) && !IsVirtual
6ae0: 28 70 54 61 62 29 20 26 26 20 21 70 54 61 62 2d (pTab) && !pTab-
6af0: 3e 70 53 65 6c 65 63 74 20 29 7b 0a 20 20 20 20 >pSelect ){.
6b00: 69 6e 74 20 69 53 6b 69 70 20 3d 20 30 3b 0a 20 int iSkip = 0;.
6b10: 20 20 20 56 64 62 65 20 2a 76 20 3d 20 73 71 6c Vdbe *v = sql
6b20: 69 74 65 33 47 65 74 56 64 62 65 28 70 50 61 72 ite3GetVdbe(pPar
6b30: 73 65 29 3b 0a 0a 20 20 20 20 61 73 73 65 72 74 se);.. assert
6b40: 28 20 76 20 29 3b 20 20 20 20 20 20 20 20 20 20 ( v );
6b50: 20 20 20 20 20 20 20 20 2f 2a 20 56 44 42 45 20 /* VDBE
6b60: 68 61 73 20 61 6c 72 65 61 64 79 20 62 65 65 6e has already been
6b70: 20 61 6c 6c 6f 63 61 74 65 64 20 2a 2f 0a 20 20 allocated */.
6b80: 20 20 69 66 28 20 73 71 6c 69 74 65 33 46 6b 52 if( sqlite3FkR
6b90: 65 66 65 72 65 6e 63 65 73 28 70 54 61 62 29 3d eferences(pTab)=
6ba0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 53 =0 ){. /* S
6bb0: 65 61 72 63 68 20 66 6f 72 20 61 20 64 65 66 65 earch for a defe
6bc0: 72 72 65 64 20 66 6f 72 65 69 67 6e 20 6b 65 79 rred foreign key
6bd0: 20 63 6f 6e 73 74 72 61 69 6e 74 20 66 6f 72 20 constraint for
6be0: 77 68 69 63 68 20 74 68 69 73 20 74 61 62 6c 65 which this table
6bf0: 0a 20 20 20 20 20 20 2a 2a 20 69 73 20 74 68 65 . ** is the
6c00: 20 63 68 69 6c 64 20 74 61 62 6c 65 2e 20 49 66 child table. If
6c10: 20 6f 6e 65 20 63 61 6e 6e 6f 74 20 62 65 20 66 one cannot be f
6c20: 6f 75 6e 64 2c 20 72 65 74 75 72 6e 20 77 69 74 ound, return wit
6c30: 68 6f 75 74 20 0a 20 20 20 20 20 20 2a 2a 20 67 hout . ** g
6c40: 65 6e 65 72 61 74 69 6e 67 20 61 6e 79 20 56 44 enerating any VD
6c50: 42 45 20 63 6f 64 65 2e 20 49 66 20 6f 6e 65 20 BE code. If one
6c60: 63 61 6e 20 62 65 20 66 6f 75 6e 64 2c 20 74 68 can be found, th
6c70: 65 6e 20 6a 75 6d 70 20 6f 76 65 72 0a 20 20 20 en jump over.
6c80: 20 20 20 2a 2a 20 74 68 65 20 65 6e 74 69 72 65 ** the entire
6c90: 20 44 45 4c 45 54 45 20 69 66 20 74 68 65 72 65 DELETE if there
6ca0: 20 61 72 65 20 6e 6f 20 6f 75 74 73 74 61 6e 64 are no outstand
6cb0: 69 6e 67 20 64 65 66 65 72 72 65 64 20 63 6f 6e ing deferred con
6cc0: 73 74 72 61 69 6e 74 73 0a 20 20 20 20 20 20 2a straints. *
6cd0: 2a 20 77 68 65 6e 20 74 68 69 73 20 73 74 61 74 * when this stat
6ce0: 65 6d 65 6e 74 20 69 73 20 72 75 6e 2e 20 20 2a ement is run. *
6cf0: 2f 0a 20 20 20 20 20 20 46 4b 65 79 20 2a 70 3b /. FKey *p;
6d00: 0a 20 20 20 20 20 20 66 6f 72 28 70 3d 70 54 61 . for(p=pTa
6d10: 62 2d 3e 70 46 4b 65 79 3b 20 70 3b 20 70 3d 70 b->pFKey; p; p=p
6d20: 2d 3e 70 4e 65 78 74 46 72 6f 6d 29 7b 0a 20 20 ->pNextFrom){.
6d30: 20 20 20 20 20 20 69 66 28 20 70 2d 3e 69 73 44 if( p->isD
6d40: 65 66 65 72 72 65 64 20 29 20 62 72 65 61 6b 3b eferred ) break;
6d50: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
6d60: 66 28 20 21 70 20 29 20 72 65 74 75 72 6e 3b 0a f( !p ) return;.
6d70: 20 20 20 20 20 20 69 53 6b 69 70 20 3d 20 73 71 iSkip = sq
6d80: 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c 61 62 lite3VdbeMakeLab
6d90: 65 6c 28 76 29 3b 0a 20 20 20 20 20 20 73 71 6c el(v);. sql
6da0: 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28 76 ite3VdbeAddOp2(v
6db0: 2c 20 4f 50 5f 46 6b 49 66 5a 65 72 6f 2c 20 31 , OP_FkIfZero, 1
6dc0: 2c 20 69 53 6b 69 70 29 3b 0a 20 20 20 20 7d 0a , iSkip);. }.
6dd0: 0a 20 20 20 20 70 50 61 72 73 65 2d 3e 64 69 73 . pParse->dis
6de0: 61 62 6c 65 54 72 69 67 67 65 72 73 20 3d 20 31 ableTriggers = 1
6df0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 65 6c ;. sqlite3Del
6e00: 65 74 65 46 72 6f 6d 28 70 50 61 72 73 65 2c 20 eteFrom(pParse,
6e10: 73 71 6c 69 74 65 33 53 72 63 4c 69 73 74 44 75 sqlite3SrcListDu
6e20: 70 28 64 62 2c 20 70 4e 61 6d 65 2c 20 30 29 2c p(db, pName, 0),
6e30: 20 30 29 3b 0a 20 20 20 20 70 50 61 72 73 65 2d 0);. pParse-
6e40: 3e 64 69 73 61 62 6c 65 54 72 69 67 67 65 72 73 >disableTriggers
6e50: 20 3d 20 30 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 = 0;.. /* If
6e60: 20 74 68 65 20 44 45 4c 45 54 45 20 68 61 73 20 the DELETE has
6e70: 67 65 6e 65 72 61 74 65 64 20 69 6d 6d 65 64 69 generated immedi
6e80: 61 74 65 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 ate foreign key
6e90: 63 6f 6e 73 74 72 61 69 6e 74 20 0a 20 20 20 20 constraint .
6ea0: 2a 2a 20 76 69 6f 6c 61 74 69 6f 6e 73 2c 20 68 ** violations, h
6eb0: 61 6c 74 20 74 68 65 20 56 44 42 45 20 61 6e 64 alt the VDBE and
6ec0: 20 72 65 74 75 72 6e 20 61 6e 20 65 72 72 6f 72 return an error
6ed0: 20 61 74 20 74 68 69 73 20 70 6f 69 6e 74 2c 20 at this point,
6ee0: 62 65 66 6f 72 65 0a 20 20 20 20 2a 2a 20 61 6e before. ** an
6ef0: 79 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 73 20 y modifications
6f00: 74 6f 20 74 68 65 20 73 63 68 65 6d 61 20 61 72 to the schema ar
6f10: 65 20 6d 61 64 65 2e 20 54 68 69 73 20 69 73 20 e made. This is
6f20: 62 65 63 61 75 73 65 20 73 74 61 74 65 6d 65 6e because statemen
6f30: 74 0a 20 20 20 20 2a 2a 20 74 72 61 6e 73 61 63 t. ** transac
6f40: 74 69 6f 6e 73 20 61 72 65 20 6e 6f 74 20 61 62 tions are not ab
6f50: 6c 65 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 20 73 le to rollback s
6f60: 63 68 65 6d 61 20 63 68 61 6e 67 65 73 2e 20 20 chema changes.
6f70: 2a 2f 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 */. sqlite3Vd
6f80: 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 46 beAddOp2(v, OP_F
6f90: 6b 49 66 5a 65 72 6f 2c 20 30 2c 20 73 71 6c 69 kIfZero, 0, sqli
6fa0: 74 65 33 56 64 62 65 43 75 72 72 65 6e 74 41 64 te3VdbeCurrentAd
6fb0: 64 72 28 76 29 2b 32 29 3b 0a 20 20 20 20 73 71 dr(v)+2);. sq
6fc0: 6c 69 74 65 33 48 61 6c 74 43 6f 6e 73 74 72 61 lite3HaltConstra
6fd0: 69 6e 74 28 0a 20 20 20 20 20 20 20 20 70 50 61 int(. pPa
6fe0: 72 73 65 2c 20 4f 45 5f 41 62 6f 72 74 2c 20 22 rse, OE_Abort, "
6ff0: 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f 6e 73 foreign key cons
7000: 74 72 61 69 6e 74 20 66 61 69 6c 65 64 22 2c 20 traint failed",
7010: 50 34 5f 53 54 41 54 49 43 0a 20 20 20 20 29 3b P4_STATIC. );
7020: 0a 0a 20 20 20 20 69 66 28 20 69 53 6b 69 70 20 .. if( iSkip
7030: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
7040: 56 64 62 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c VdbeResolveLabel
7050: 28 76 2c 20 69 53 6b 69 70 29 3b 0a 20 20 20 20 (v, iSkip);.
7060: 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 }. }.}../*.** T
7070: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 his function is
7080: 63 61 6c 6c 65 64 20 77 68 65 6e 20 69 6e 73 65 called when inse
7090: 72 74 69 6e 67 2c 20 64 65 6c 65 74 69 6e 67 20 rting, deleting
70a0: 6f 72 20 75 70 64 61 74 69 6e 67 20 61 20 72 6f or updating a ro
70b0: 77 20 6f 66 0a 2a 2a 20 74 61 62 6c 65 20 70 54 w of.** table pT
70c0: 61 62 20 74 6f 20 67 65 6e 65 72 61 74 65 20 56 ab to generate V
70d0: 44 42 45 20 63 6f 64 65 20 74 6f 20 70 65 72 66 DBE code to perf
70e0: 6f 72 6d 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 orm foreign key
70f0: 63 6f 6e 73 74 72 61 69 6e 74 20 0a 2a 2a 20 70 constraint .** p
7100: 72 6f 63 65 73 73 69 6e 67 20 66 6f 72 20 74 68 rocessing for th
7110: 65 20 6f 70 65 72 61 74 69 6f 6e 2e 0a 2a 2a 0a e operation..**.
7120: 2a 2a 20 46 6f 72 20 61 20 44 45 4c 45 54 45 20 ** For a DELETE
7130: 6f 70 65 72 61 74 69 6f 6e 2c 20 70 61 72 61 6d operation, param
7140: 65 74 65 72 20 72 65 67 4f 6c 64 20 69 73 20 70 eter regOld is p
7150: 61 73 73 65 64 20 74 68 65 20 69 6e 64 65 78 20 assed the index
7160: 6f 66 20 74 68 65 0a 2a 2a 20 66 69 72 73 74 20 of the.** first
7170: 72 65 67 69 73 74 65 72 20 69 6e 20 61 6e 20 61 register in an a
7180: 72 72 61 79 20 6f 66 20 28 70 54 61 62 2d 3e 6e rray of (pTab->n
7190: 43 6f 6c 2b 31 29 20 72 65 67 69 73 74 65 72 73 Col+1) registers
71a0: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 0a containing the.
71b0: 2a 2a 20 72 6f 77 69 64 20 6f 66 20 74 68 65 20 ** rowid of the
71c0: 72 6f 77 20 62 65 69 6e 67 20 64 65 6c 65 74 65 row being delete
71d0: 64 2c 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 65 d, followed by e
71e0: 61 63 68 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d ach of the colum
71f0: 6e 20 76 61 6c 75 65 73 0a 2a 2a 20 6f 66 20 74 n values.** of t
7200: 68 65 20 72 6f 77 20 62 65 69 6e 67 20 64 65 6c he row being del
7210: 65 74 65 64 2c 20 66 72 6f 6d 20 6c 65 66 74 20 eted, from left
7220: 74 6f 20 72 69 67 68 74 2e 20 50 61 72 61 6d 65 to right. Parame
7230: 74 65 72 20 72 65 67 4e 65 77 20 69 73 20 70 61 ter regNew is pa
7240: 73 73 65 64 0a 2a 2a 20 7a 65 72 6f 20 69 6e 20 ssed.** zero in
7250: 74 68 69 73 20 63 61 73 65 2e 0a 2a 2a 0a 2a 2a this case..**.**
7260: 20 46 6f 72 20 61 6e 20 49 4e 53 45 52 54 20 6f For an INSERT o
7270: 70 65 72 61 74 69 6f 6e 2c 20 72 65 67 4f 6c 64 peration, regOld
7280: 20 69 73 20 70 61 73 73 65 64 20 7a 65 72 6f 20 is passed zero
7290: 61 6e 64 20 72 65 67 4e 65 77 20 69 73 20 70 61 and regNew is pa
72a0: 73 73 65 64 20 74 68 65 0a 2a 2a 20 66 69 72 73 ssed the.** firs
72b0: 74 20 72 65 67 69 73 74 65 72 20 6f 66 20 61 6e t register of an
72c0: 20 61 72 72 61 79 20 6f 66 20 28 70 54 61 62 2d array of (pTab-
72d0: 3e 6e 43 6f 6c 2b 31 29 20 72 65 67 69 73 74 65 >nCol+1) registe
72e0: 72 73 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 rs containing th
72f0: 65 20 6e 65 77 0a 2a 2a 20 72 6f 77 20 64 61 74 e new.** row dat
7300: 61 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 6e 20 a..**.** For an
7310: 55 50 44 41 54 45 20 6f 70 65 72 61 74 69 6f 6e UPDATE operation
7320: 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 , this function
7330: 69 73 20 63 61 6c 6c 65 64 20 74 77 69 63 65 2e is called twice.
7340: 20 4f 6e 63 65 20 62 65 66 6f 72 65 0a 2a 2a 20 Once before.**
7350: 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 72 65 63 the original rec
7360: 6f 72 64 20 69 73 20 64 65 6c 65 74 65 64 20 66 ord is deleted f
7370: 72 6f 6d 20 74 68 65 20 74 61 62 6c 65 20 75 73 rom the table us
7380: 69 6e 67 20 74 68 65 20 63 61 6c 6c 69 6e 67 20 ing the calling
7390: 63 6f 6e 76 65 6e 74 69 6f 6e 0a 2a 2a 20 64 65 convention.** de
73a0: 73 63 72 69 62 65 64 20 66 6f 72 20 44 45 4c 45 scribed for DELE
73b0: 54 45 2e 20 54 68 65 6e 20 61 67 61 69 6e 20 61 TE. Then again a
73c0: 66 74 65 72 20 74 68 65 20 6f 72 69 67 69 6e 61 fter the origina
73d0: 6c 20 72 65 63 6f 72 64 20 69 73 20 64 65 6c 65 l record is dele
73e0: 74 65 64 0a 2a 2a 20 62 75 74 20 62 65 66 6f 72 ted.** but befor
73f0: 65 20 74 68 65 20 6e 65 77 20 72 65 63 6f 72 64 e the new record
7400: 20 69 73 20 69 6e 73 65 72 74 65 64 20 75 73 69 is inserted usi
7410: 6e 67 20 74 68 65 20 49 4e 53 45 52 54 20 63 6f ng the INSERT co
7420: 6e 76 65 6e 74 69 6f 6e 2e 20 0a 2a 2f 0a 76 6f nvention. .*/.vo
7430: 69 64 20 73 71 6c 69 74 65 33 46 6b 43 68 65 63 id sqlite3FkChec
7440: 6b 28 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 k(. Parse *pPar
7450: 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 se,
7460: 20 20 20 20 20 2f 2a 20 50 61 72 73 65 20 63 6f /* Parse co
7470: 6e 74 65 78 74 20 2a 2f 0a 20 20 54 61 62 6c 65 ntext */. Table
7480: 20 2a 70 54 61 62 2c 20 20 20 20 20 20 20 20 20 *pTab,
7490: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 6f /* Ro
74a0: 77 20 69 73 20 62 65 69 6e 67 20 64 65 6c 65 74 w is being delet
74b0: 65 64 20 66 72 6f 6d 20 74 68 69 73 20 74 61 62 ed from this tab
74c0: 6c 65 20 2a 2f 20 0a 20 20 69 6e 74 20 72 65 67 le */ . int reg
74d0: 4f 6c 64 2c 20 20 20 20 20 20 20 20 20 20 20 20 Old,
74e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 72 65 76 /* Prev
74f0: 69 6f 75 73 20 72 6f 77 20 64 61 74 61 20 69 73 ious row data is
7500: 20 73 74 6f 72 65 64 20 68 65 72 65 20 2a 2f 0a stored here */.
7510: 20 20 69 6e 74 20 72 65 67 4e 65 77 20 20 20 20 int regNew
7520: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
7530: 20 20 2f 2a 20 4e 65 77 20 72 6f 77 20 64 61 74 /* New row dat
7540: 61 20 69 73 20 73 74 6f 72 65 64 20 68 65 72 65 a is stored here
7550: 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 */.){. sqlite3
7560: 20 2a 64 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 *db = pParse->d
7570: 62 3b 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 b; /* Data
7580: 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 base handle */.
7590: 20 46 4b 65 79 20 2a 70 46 4b 65 79 3b 20 20 20 FKey *pFKey;
75a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
75b0: 20 2f 2a 20 55 73 65 64 20 74 6f 20 69 74 65 72 /* Used to iter
75c0: 61 74 65 20 74 68 72 6f 75 67 68 20 46 4b 73 20 ate through FKs
75d0: 2a 2f 0a 20 20 69 6e 74 20 69 44 62 3b 20 20 20 */. int iDb;
75e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
75f0: 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 /* Index of
7600: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 74 61 69 database contai
7610: 6e 69 6e 67 20 70 54 61 62 20 2a 2f 0a 20 20 63 ning pTab */. c
7620: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 44 62 3b 20 onst char *zDb;
7630: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
7640: 2a 20 4e 61 6d 65 20 6f 66 20 64 61 74 61 62 61 * Name of databa
7650: 73 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 70 54 se containing pT
7660: 61 62 20 2a 2f 0a 20 20 69 6e 74 20 69 73 49 67 ab */. int isIg
7670: 6e 6f 72 65 45 72 72 6f 72 73 20 3d 20 70 50 61 noreErrors = pPa
7680: 72 73 65 2d 3e 64 69 73 61 62 6c 65 54 72 69 67 rse->disableTrig
7690: 67 65 72 73 3b 0a 0a 20 20 2f 2a 20 45 78 61 63 gers;.. /* Exac
76a0: 74 6c 79 20 6f 6e 65 20 6f 66 20 72 65 67 4f 6c tly one of regOl
76b0: 64 20 61 6e 64 20 72 65 67 4e 65 77 20 73 68 6f d and regNew sho
76c0: 75 6c 64 20 62 65 20 6e 6f 6e 2d 7a 65 72 6f 2e uld be non-zero.
76d0: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 28 72 */. assert( (r
76e0: 65 67 4f 6c 64 3d 3d 30 29 21 3d 28 72 65 67 4e egOld==0)!=(regN
76f0: 65 77 3d 3d 30 29 20 29 3b 0a 0a 20 20 2f 2a 20 ew==0) );.. /*
7700: 49 66 20 66 6f 72 65 69 67 6e 2d 6b 65 79 73 20 If foreign-keys
7710: 61 72 65 20 64 69 73 61 62 6c 65 64 2c 20 74 68 are disabled, th
7720: 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 is function is a
7730: 20 6e 6f 2d 6f 70 2e 20 2a 2f 0a 20 20 69 66 28 no-op. */. if(
7740: 20 28 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c 49 (db->flags&SQLI
7750: 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73 29 3d TE_ForeignKeys)=
7760: 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 0a 20 20 =0 ) return;..
7770: 69 44 62 20 3d 20 73 71 6c 69 74 65 33 53 63 68 iDb = sqlite3Sch
7780: 65 6d 61 54 6f 49 6e 64 65 78 28 64 62 2c 20 70 emaToIndex(db, p
7790: 54 61 62 2d 3e 70 53 63 68 65 6d 61 29 3b 0a 20 Tab->pSchema);.
77a0: 20 7a 44 62 20 3d 20 64 62 2d 3e 61 44 62 5b 69 zDb = db->aDb[i
77b0: 44 62 5d 2e 7a 4e 61 6d 65 3b 0a 0a 20 20 2f 2a Db].zName;.. /*
77c0: 20 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20 61 6c Loop through al
77d0: 6c 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65 l the foreign ke
77e0: 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 66 6f y constraints fo
77f0: 72 20 77 68 69 63 68 20 70 54 61 62 20 69 73 20 r which pTab is
7800: 74 68 65 0a 20 20 2a 2a 20 63 68 69 6c 64 20 74 the. ** child t
7810: 61 62 6c 65 20 28 74 68 65 20 74 61 62 6c 65 20 able (the table
7820: 74 68 61 74 20 74 68 65 20 66 6f 72 65 69 67 6e that the foreign
7830: 20 6b 65 79 20 64 65 66 69 6e 69 74 69 6f 6e 20 key definition
7840: 69 73 20 70 61 72 74 20 6f 66 29 2e 20 20 2a 2f is part of). */
7850: 0a 20 20 66 6f 72 28 70 46 4b 65 79 3d 70 54 61 . for(pFKey=pTa
7860: 62 2d 3e 70 46 4b 65 79 3b 20 70 46 4b 65 79 3b b->pFKey; pFKey;
7870: 20 70 46 4b 65 79 3d 70 46 4b 65 79 2d 3e 70 4e pFKey=pFKey->pN
7880: 65 78 74 46 72 6f 6d 29 7b 0a 20 20 20 20 54 61 extFrom){. Ta
7890: 62 6c 65 20 2a 70 54 6f 3b 20 20 20 20 20 20 20 ble *pTo;
78a0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
78b0: 61 72 65 6e 74 20 74 61 62 6c 65 20 6f 66 20 66 arent table of f
78c0: 6f 72 65 69 67 6e 20 6b 65 79 20 70 46 4b 65 79 oreign key pFKey
78d0: 20 2a 2f 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 */. Index *p
78e0: 49 64 78 20 3d 20 30 3b 20 20 20 20 20 20 20 20 Idx = 0;
78f0: 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f /* Index o
7900: 6e 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 69 6e n key columns in
7910: 20 70 54 6f 20 2a 2f 0a 20 20 20 20 69 6e 74 20 pTo */. int
7920: 2a 61 69 46 72 65 65 20 3d 20 30 3b 0a 20 20 20 *aiFree = 0;.
7930: 20 69 6e 74 20 2a 61 69 43 6f 6c 3b 0a 20 20 20 int *aiCol;.
7940: 20 69 6e 74 20 69 43 6f 6c 3b 0a 20 20 20 20 69 int iCol;. i
7950: 6e 74 20 69 3b 0a 20 20 20 20 69 6e 74 20 69 73 nt i;. int is
7960: 49 67 6e 6f 72 65 20 3d 20 30 3b 0a 0a 20 20 20 Ignore = 0;..
7970: 20 2f 2a 20 46 69 6e 64 20 74 68 65 20 70 61 72 /* Find the par
7980: 65 6e 74 20 74 61 62 6c 65 20 6f 66 20 74 68 69 ent table of thi
7990: 73 20 66 6f 72 65 69 67 6e 20 6b 65 79 2e 20 41 s foreign key. A
79a0: 6c 73 6f 20 66 69 6e 64 20 61 20 75 6e 69 71 75 lso find a uniqu
79b0: 65 20 69 6e 64 65 78 20 0a 20 20 20 20 2a 2a 20 e index . **
79c0: 6f 6e 20 74 68 65 20 70 61 72 65 6e 74 20 6b 65 on the parent ke
79d0: 79 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 y columns in the
79e0: 20 70 61 72 65 6e 74 20 74 61 62 6c 65 2e 20 49 parent table. I
79f0: 66 20 65 69 74 68 65 72 20 6f 66 20 74 68 65 73 f either of thes
7a00: 65 20 0a 20 20 20 20 2a 2a 20 73 63 68 65 6d 61 e . ** schema
7a10: 20 69 74 65 6d 73 20 63 61 6e 6e 6f 74 20 62 65 items cannot be
7a20: 20 6c 6f 63 61 74 65 64 2c 20 73 65 74 20 61 6e located, set an
7a30: 20 65 72 72 6f 72 20 69 6e 20 70 50 61 72 73 65 error in pParse
7a40: 20 61 6e 64 20 72 65 74 75 72 6e 20 0a 20 20 20 and return .
7a50: 20 2a 2a 20 65 61 72 6c 79 2e 20 20 2a 2f 0a 20 ** early. */.
7a60: 20 20 20 69 66 28 20 70 50 61 72 73 65 2d 3e 64 if( pParse->d
7a70: 69 73 61 62 6c 65 54 72 69 67 67 65 72 73 20 29 isableTriggers )
7a80: 7b 0a 20 20 20 20 20 20 70 54 6f 20 3d 20 73 71 {. pTo = sq
7a90: 6c 69 74 65 33 46 69 6e 64 54 61 62 6c 65 28 64 lite3FindTable(d
7aa0: 62 2c 20 70 46 4b 65 79 2d 3e 7a 54 6f 2c 20 7a b, pFKey->zTo, z
7ab0: 44 62 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a Db);. }else{.
7ac0: 20 20 20 20 20 20 70 54 6f 20 3d 20 73 71 6c 69 pTo = sqli
7ad0: 74 65 33 4c 6f 63 61 74 65 54 61 62 6c 65 28 70 te3LocateTable(p
7ae0: 50 61 72 73 65 2c 20 30 2c 20 70 46 4b 65 79 2d Parse, 0, pFKey-
7af0: 3e 7a 54 6f 2c 20 7a 44 62 29 3b 0a 20 20 20 20 >zTo, zDb);.
7b00: 7d 0a 20 20 20 20 69 66 28 20 21 70 54 6f 20 7c }. if( !pTo |
7b10: 7c 20 73 71 6c 69 74 65 33 46 6b 4c 6f 63 61 74 | sqlite3FkLocat
7b20: 65 49 6e 64 65 78 28 70 50 61 72 73 65 2c 20 70 eIndex(pParse, p
7b30: 54 6f 2c 20 70 46 4b 65 79 2c 20 26 70 49 64 78 To, pFKey, &pIdx
7b40: 2c 20 26 61 69 46 72 65 65 29 20 29 7b 0a 20 20 , &aiFree) ){.
7b50: 20 20 20 20 61 73 73 65 72 74 28 20 69 73 49 67 assert( isIg
7b60: 6e 6f 72 65 45 72 72 6f 72 73 3d 3d 30 20 7c 7c noreErrors==0 ||
7b70: 20 28 72 65 67 4f 6c 64 21 3d 30 20 26 26 20 72 (regOld!=0 && r
7b80: 65 67 4e 65 77 3d 3d 30 29 20 29 3b 0a 20 20 20 egNew==0) );.
7b90: 20 20 20 69 66 28 20 21 69 73 49 67 6e 6f 72 65 if( !isIgnore
7ba0: 45 72 72 6f 72 73 20 7c 7c 20 64 62 2d 3e 6d 61 Errors || db->ma
7bb0: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 20 72 65 74 llocFailed ) ret
7bc0: 75 72 6e 3b 0a 20 20 20 20 20 20 69 66 28 20 70 urn;. if( p
7bd0: 54 6f 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 To==0 ){.
7be0: 20 2f 2a 20 49 66 20 69 73 49 67 6e 6f 72 65 45 /* If isIgnoreE
7bf0: 72 72 6f 72 73 20 69 73 20 74 72 75 65 2c 20 74 rrors is true, t
7c00: 68 65 6e 20 61 20 74 61 62 6c 65 20 69 73 20 62 hen a table is b
7c10: 65 69 6e 67 20 64 72 6f 70 70 65 64 2e 20 49 6e eing dropped. In
7c20: 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 2a 2a this. **
7c30: 20 63 61 73 65 20 53 51 4c 69 74 65 20 72 75 6e case SQLite run
7c40: 73 20 61 20 22 44 45 4c 45 54 45 20 46 52 4f 4d s a "DELETE FROM
7c50: 20 78 78 78 22 20 6f 6e 20 74 68 65 20 74 61 62 xxx" on the tab
7c60: 6c 65 20 62 65 69 6e 67 20 64 72 6f 70 70 65 64 le being dropped
7c70: 0a 20 20 20 20 20 20 20 20 2a 2a 20 62 65 66 6f . ** befo
7c80: 72 65 20 61 63 74 75 61 6c 6c 79 20 64 72 6f 70 re actually drop
7c90: 70 69 6e 67 20 69 74 20 69 6e 20 6f 72 64 65 72 ping it in order
7ca0: 20 74 6f 20 63 68 65 63 6b 20 46 4b 20 63 6f 6e to check FK con
7cb0: 73 74 72 61 69 6e 74 73 2e 0a 20 20 20 20 20 20 straints..
7cc0: 20 20 2a 2a 20 49 66 20 74 68 65 20 70 61 72 65 ** If the pare
7cd0: 6e 74 20 74 61 62 6c 65 20 6f 66 20 61 6e 20 46 nt table of an F
7ce0: 4b 20 63 6f 6e 73 74 72 61 69 6e 74 20 6f 6e 20 K constraint on
7cf0: 74 68 65 20 63 75 72 72 65 6e 74 20 74 61 62 6c the current tabl
7d00: 65 20 69 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 e is. **
7d10: 6d 69 73 73 69 6e 67 2c 20 62 65 68 61 76 65 20 missing, behave
7d20: 61 73 20 69 66 20 69 74 20 69 73 20 65 6d 70 74 as if it is empt
7d30: 79 2e 20 69 2e 65 2e 20 64 65 63 72 65 6d 65 6e y. i.e. decremen
7d40: 74 20 74 68 65 20 72 65 6c 65 76 61 6e 74 0a 20 t the relevant.
7d50: 20 20 20 20 20 20 20 2a 2a 20 46 4b 20 63 6f 75 ** FK cou
7d60: 6e 74 65 72 20 66 6f 72 20 65 61 63 68 20 72 6f nter for each ro
7d70: 77 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e 74 w of the current
7d80: 20 74 61 62 6c 65 20 77 69 74 68 20 6e 6f 6e 2d table with non-
7d90: 4e 55 4c 4c 20 6b 65 79 73 2e 0a 20 20 20 20 20 NULL keys..
7da0: 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 56 64 */. Vd
7db0: 62 65 20 2a 76 20 3d 20 73 71 6c 69 74 65 33 47 be *v = sqlite3G
7dc0: 65 74 56 64 62 65 28 70 50 61 72 73 65 29 3b 0a etVdbe(pParse);.
7dd0: 20 20 20 20 20 20 20 20 69 6e 74 20 69 4a 75 6d int iJum
7de0: 70 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 43 p = sqlite3VdbeC
7df0: 75 72 72 65 6e 74 41 64 64 72 28 76 29 20 2b 20 urrentAddr(v) +
7e00: 70 46 4b 65 79 2d 3e 6e 43 6f 6c 20 2b 20 31 3b pFKey->nCol + 1;
7e10: 0a 20 20 20 20 20 20 20 20 66 6f 72 28 69 3d 30 . for(i=0
7e20: 3b 20 69 3c 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3b ; i<pFKey->nCol;
7e30: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 i++){.
7e40: 20 69 6e 74 20 69 52 65 67 20 3d 20 70 46 4b 65 int iReg = pFKe
7e50: 79 2d 3e 61 43 6f 6c 5b 69 5d 2e 69 46 72 6f 6d y->aCol[i].iFrom
7e60: 20 2b 20 72 65 67 4f 6c 64 20 2b 20 31 3b 0a 20 + regOld + 1;.
7e70: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
7e80: 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 VdbeAddOp2(v, OP
7e90: 5f 49 73 4e 75 6c 6c 2c 20 69 52 65 67 2c 20 69 _IsNull, iReg, i
7ea0: 4a 75 6d 70 29 3b 0a 20 20 20 20 20 20 20 20 7d Jump);. }
7eb0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
7ec0: 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 VdbeAddOp2(v, OP
7ed0: 5f 46 6b 43 6f 75 6e 74 65 72 2c 20 70 46 4b 65 _FkCounter, pFKe
7ee0: 79 2d 3e 69 73 44 65 66 65 72 72 65 64 2c 20 2d y->isDeferred, -
7ef0: 31 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 1);. }.
7f00: 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 continue;.
7f10: 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 46 }. assert( pF
7f20: 4b 65 79 2d 3e 6e 43 6f 6c 3d 3d 31 20 7c 7c 20 Key->nCol==1 ||
7f30: 28 61 69 46 72 65 65 20 26 26 20 70 49 64 78 29 (aiFree && pIdx)
7f40: 20 29 3b 0a 0a 20 20 20 20 69 66 28 20 61 69 46 );.. if( aiF
7f50: 72 65 65 20 29 7b 0a 20 20 20 20 20 20 61 69 43 ree ){. aiC
7f60: 6f 6c 20 3d 20 61 69 46 72 65 65 3b 0a 20 20 20 ol = aiFree;.
7f70: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 69 43 }else{. iC
7f80: 6f 6c 20 3d 20 70 46 4b 65 79 2d 3e 61 43 6f 6c ol = pFKey->aCol
7f90: 5b 30 5d 2e 69 46 72 6f 6d 3b 0a 20 20 20 20 20 [0].iFrom;.
7fa0: 20 61 69 43 6f 6c 20 3d 20 26 69 43 6f 6c 3b 0a aiCol = &iCol;.
7fb0: 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 69 3d }. for(i=
7fc0: 30 3b 20 69 3c 70 46 4b 65 79 2d 3e 6e 43 6f 6c 0; i<pFKey->nCol
7fd0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 ; i++){. if
7fe0: 28 20 61 69 43 6f 6c 5b 69 5d 3d 3d 70 54 61 62 ( aiCol[i]==pTab
7ff0: 2d 3e 69 50 4b 65 79 20 29 7b 0a 20 20 20 20 20 ->iPKey ){.
8000: 20 20 20 61 69 43 6f 6c 5b 69 5d 20 3d 20 2d 31 aiCol[i] = -1
8010: 3b 0a 20 20 20 20 20 20 7d 0a 23 69 66 6e 64 65 ;. }.#ifnde
8020: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 f SQLITE_OMIT_AU
8030: 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 20 20 THORIZATION.
8040: 20 20 2f 2a 20 52 65 71 75 65 73 74 20 70 65 72 /* Request per
8050: 6d 69 73 73 69 6f 6e 20 74 6f 20 72 65 61 64 20 mission to read
8060: 74 68 65 20 70 61 72 65 6e 74 20 6b 65 79 20 63 the parent key c
8070: 6f 6c 75 6d 6e 73 2e 20 49 66 20 74 68 65 20 0a olumns. If the .
8080: 20 20 20 20 20 20 2a 2a 20 61 75 74 68 6f 72 69 ** authori
8090: 7a 61 74 69 6f 6e 20 63 61 6c 6c 62 61 63 6b 20 zation callback
80a0: 72 65 74 75 72 6e 73 20 53 51 4c 49 54 45 5f 49 returns SQLITE_I
80b0: 47 4e 4f 52 45 2c 20 62 65 68 61 76 65 20 61 73 GNORE, behave as
80c0: 20 69 66 20 61 6e 79 0a 20 20 20 20 20 20 2a 2a if any. **
80d0: 20 76 61 6c 75 65 73 20 72 65 61 64 20 66 72 6f values read fro
80e0: 6d 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 m the parent tab
80f0: 6c 65 20 61 72 65 20 4e 55 4c 4c 2e 20 2a 2f 0a le are NULL. */.
8100: 20 20 20 20 20 20 69 66 28 20 64 62 2d 3e 78 41 if( db->xA
8110: 75 74 68 20 29 7b 0a 20 20 20 20 20 20 20 20 69 uth ){. i
8120: 6e 74 20 72 63 61 75 74 68 3b 0a 20 20 20 20 20 nt rcauth;.
8130: 20 20 20 63 68 61 72 20 2a 7a 43 6f 6c 20 3d 20 char *zCol =
8140: 70 54 6f 2d 3e 61 43 6f 6c 5b 70 49 64 78 20 3f pTo->aCol[pIdx ?
8150: 20 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b pIdx->aiColumn[
8160: 69 5d 20 3a 20 70 54 6f 2d 3e 69 50 4b 65 79 5d i] : pTo->iPKey]
8170: 2e 7a 4e 61 6d 65 3b 0a 20 20 20 20 20 20 20 20 .zName;.
8180: 72 63 61 75 74 68 20 3d 20 73 71 6c 69 74 65 33 rcauth = sqlite3
8190: 41 75 74 68 52 65 61 64 43 6f 6c 28 70 50 61 72 AuthReadCol(pPar
81a0: 73 65 2c 20 70 54 6f 2d 3e 7a 4e 61 6d 65 2c 20 se, pTo->zName,
81b0: 7a 43 6f 6c 2c 20 69 44 62 29 3b 0a 20 20 20 20 zCol, iDb);.
81c0: 20 20 20 20 69 73 49 67 6e 6f 72 65 20 3d 20 28 isIgnore = (
81d0: 72 63 61 75 74 68 3d 3d 53 51 4c 49 54 45 5f 49 rcauth==SQLITE_I
81e0: 47 4e 4f 52 45 29 3b 0a 20 20 20 20 20 20 7d 0a GNORE);. }.
81f0: 23 65 6e 64 69 66 0a 20 20 20 20 7d 0a 0a 20 20 #endif. }..
8200: 20 20 2f 2a 20 54 61 6b 65 20 61 20 73 68 61 72 /* Take a shar
8210: 65 64 2d 63 61 63 68 65 20 61 64 76 69 73 6f 72 ed-cache advisor
8220: 79 20 72 65 61 64 2d 6c 6f 63 6b 20 6f 6e 20 74 y read-lock on t
8230: 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 2e he parent table.
8240: 20 41 6c 6c 6f 63 61 74 65 20 0a 20 20 20 20 2a Allocate . *
8250: 2a 20 61 20 63 75 72 73 6f 72 20 74 6f 20 75 73 * a cursor to us
8260: 65 20 74 6f 20 73 65 61 72 63 68 20 74 68 65 20 e to search the
8270: 75 6e 69 71 75 65 20 69 6e 64 65 78 20 6f 6e 20 unique index on
8280: 74 68 65 20 70 61 72 65 6e 74 20 6b 65 79 20 63 the parent key c
8290: 6f 6c 75 6d 6e 73 20 0a 20 20 20 20 2a 2a 20 69 olumns . ** i
82a0: 6e 20 74 68 65 20 70 61 72 65 6e 74 20 74 61 62 n the parent tab
82b0: 6c 65 2e 20 20 2a 2f 0a 20 20 20 20 73 71 6c 69 le. */. sqli
82c0: 74 65 33 54 61 62 6c 65 4c 6f 63 6b 28 70 50 61 te3TableLock(pPa
82d0: 72 73 65 2c 20 69 44 62 2c 20 70 54 6f 2d 3e 74 rse, iDb, pTo->t
82e0: 6e 75 6d 2c 20 30 2c 20 70 54 6f 2d 3e 7a 4e 61 num, 0, pTo->zNa
82f0: 6d 65 29 3b 0a 20 20 20 20 70 50 61 72 73 65 2d me);. pParse-
8300: 3e 6e 54 61 62 2b 2b 3b 0a 0a 20 20 20 20 69 66 >nTab++;.. if
8310: 28 20 72 65 67 4f 6c 64 21 3d 30 20 29 7b 0a 20 ( regOld!=0 ){.
8320: 20 20 20 20 20 2f 2a 20 41 20 72 6f 77 20 69 73 /* A row is
8330: 20 62 65 69 6e 67 20 72 65 6d 6f 76 65 64 20 66 being removed f
8340: 72 6f 6d 20 74 68 65 20 63 68 69 6c 64 20 74 61 rom the child ta
8350: 62 6c 65 2e 20 53 65 61 72 63 68 20 66 6f 72 20 ble. Search for
8360: 74 68 65 20 70 61 72 65 6e 74 2e 0a 20 20 20 20 the parent..
8370: 20 20 2a 2a 20 49 66 20 74 68 65 20 70 61 72 65 ** If the pare
8380: 6e 74 20 64 6f 65 73 20 6e 6f 74 20 65 78 69 73 nt does not exis
8390: 74 2c 20 72 65 6d 6f 76 69 6e 67 20 74 68 65 20 t, removing the
83a0: 63 68 69 6c 64 20 72 6f 77 20 72 65 73 6f 6c 76 child row resolv
83b0: 65 73 20 61 6e 20 0a 20 20 20 20 20 20 2a 2a 20 es an . **
83c0: 6f 75 74 73 74 61 6e 64 69 6e 67 20 66 6f 72 65 outstanding fore
83d0: 69 67 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 ign key constrai
83e0: 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 2e 20 2a 2f nt violation. */
83f0: 0a 20 20 20 20 20 20 66 6b 4c 6f 6f 6b 75 70 50 . fkLookupP
8400: 61 72 65 6e 74 28 70 50 61 72 73 65 2c 20 69 44 arent(pParse, iD
8410: 62 2c 20 70 54 6f 2c 20 70 49 64 78 2c 20 70 46 b, pTo, pIdx, pF
8420: 4b 65 79 2c 20 61 69 43 6f 6c 2c 20 72 65 67 4f Key, aiCol, regO
8430: 6c 64 2c 20 2d 31 2c 69 73 49 67 6e 6f 72 65 29 ld, -1,isIgnore)
8440: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 ;. }. if(
8450: 72 65 67 4e 65 77 21 3d 30 20 29 7b 0a 20 20 20 regNew!=0 ){.
8460: 20 20 20 2f 2a 20 41 20 72 6f 77 20 69 73 20 62 /* A row is b
8470: 65 69 6e 67 20 61 64 64 65 64 20 74 6f 20 74 68 eing added to th
8480: 65 20 63 68 69 6c 64 20 74 61 62 6c 65 2e 20 49 e child table. I
8490: 66 20 61 20 70 61 72 65 6e 74 20 72 6f 77 20 63 f a parent row c
84a0: 61 6e 6e 6f 74 0a 20 20 20 20 20 20 2a 2a 20 62 annot. ** b
84b0: 65 20 66 6f 75 6e 64 2c 20 61 64 64 69 6e 67 20 e found, adding
84c0: 74 68 65 20 63 68 69 6c 64 20 72 6f 77 20 68 61 the child row ha
84d0: 73 20 76 69 6f 6c 61 74 65 64 20 74 68 65 20 46 s violated the F
84e0: 4b 20 63 6f 6e 73 74 72 61 69 6e 74 2e 20 2a 2f K constraint. */
84f0: 20 0a 20 20 20 20 20 20 66 6b 4c 6f 6f 6b 75 70 . fkLookup
8500: 50 61 72 65 6e 74 28 70 50 61 72 73 65 2c 20 69 Parent(pParse, i
8510: 44 62 2c 20 70 54 6f 2c 20 70 49 64 78 2c 20 70 Db, pTo, pIdx, p
8520: 46 4b 65 79 2c 20 61 69 43 6f 6c 2c 20 72 65 67 FKey, aiCol, reg
8530: 4e 65 77 2c 20 2b 31 2c 69 73 49 67 6e 6f 72 65 New, +1,isIgnore
8540: 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 73 71 );. }.. sq
8550: 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 lite3DbFree(db,
8560: 61 69 46 72 65 65 29 3b 0a 20 20 7d 0a 0a 20 20 aiFree);. }..
8570: 2f 2a 20 4c 6f 6f 70 20 74 68 72 6f 75 67 68 20 /* Loop through
8580: 61 6c 6c 20 74 68 65 20 66 6f 72 65 69 67 6e 20 all the foreign
8590: 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 key constraints
85a0: 74 68 61 74 20 72 65 66 65 72 20 74 6f 20 74 68 that refer to th
85b0: 69 73 20 74 61 62 6c 65 20 2a 2f 0a 20 20 66 6f is table */. fo
85c0: 72 28 70 46 4b 65 79 20 3d 20 73 71 6c 69 74 65 r(pFKey = sqlite
85d0: 33 46 6b 52 65 66 65 72 65 6e 63 65 73 28 70 54 3FkReferences(pT
85e0: 61 62 29 3b 20 70 46 4b 65 79 3b 20 70 46 4b 65 ab); pFKey; pFKe
85f0: 79 3d 70 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f y=pFKey->pNextTo
8600: 29 7b 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 49 ){. Index *pI
8610: 64 78 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 dx = 0;
8620: 20 20 20 20 20 2f 2a 20 46 6f 72 65 69 67 6e 20 /* Foreign
8630: 6b 65 79 20 69 6e 64 65 78 20 66 6f 72 20 70 46 key index for pF
8640: 4b 65 79 20 2a 2f 0a 20 20 20 20 53 72 63 4c 69 Key */. SrcLi
8650: 73 74 20 2a 70 53 72 63 3b 0a 20 20 20 20 69 6e st *pSrc;. in
8660: 74 20 2a 61 69 43 6f 6c 20 3d 20 30 3b 0a 0a 20 t *aiCol = 0;..
8670: 20 20 20 69 66 28 20 21 70 46 4b 65 79 2d 3e 69 if( !pFKey->i
8680: 73 44 65 66 65 72 72 65 64 20 26 26 20 21 70 50 sDeferred && !pP
8690: 61 72 73 65 2d 3e 70 54 6f 70 6c 65 76 65 6c 20 arse->pToplevel
86a0: 26 26 20 21 70 50 61 72 73 65 2d 3e 69 73 4d 75 && !pParse->isMu
86b0: 6c 74 69 57 72 69 74 65 20 29 7b 0a 20 20 20 20 ltiWrite ){.
86c0: 20 20 61 73 73 65 72 74 28 20 72 65 67 4f 6c 64 assert( regOld
86d0: 3d 3d 30 20 26 26 20 72 65 67 4e 65 77 21 3d 30 ==0 && regNew!=0
86e0: 20 29 3b 0a 20 20 20 20 20 20 2f 2a 20 49 6e 73 );. /* Ins
86f0: 65 72 74 69 6e 67 20 61 20 73 69 6e 67 6c 65 20 erting a single
8700: 72 6f 77 20 69 6e 74 6f 20 61 20 70 61 72 65 6e row into a paren
8710: 74 20 74 61 62 6c 65 20 63 61 6e 6e 6f 74 20 63 t table cannot c
8720: 61 75 73 65 20 61 6e 20 69 6d 6d 65 64 69 61 74 ause an immediat
8730: 65 0a 20 20 20 20 20 20 2a 2a 20 66 6f 72 65 69 e. ** forei
8740: 67 6e 20 6b 65 79 20 76 69 6f 6c 61 74 69 6f 6e gn key violation
8750: 2e 20 53 6f 20 64 6f 20 6e 6f 74 68 69 6e 67 20 . So do nothing
8760: 69 6e 20 74 68 69 73 20 63 61 73 65 2e 20 20 2a in this case. *
8770: 2f 0a 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 /. continue
8780: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28 ;. }.. if(
8790: 20 73 71 6c 69 74 65 33 46 6b 4c 6f 63 61 74 65 sqlite3FkLocate
87a0: 49 6e 64 65 78 28 70 50 61 72 73 65 2c 20 70 54 Index(pParse, pT
87b0: 61 62 2c 20 70 46 4b 65 79 2c 20 26 70 49 64 78 ab, pFKey, &pIdx
87c0: 2c 20 26 61 69 43 6f 6c 29 20 29 7b 0a 20 20 20 , &aiCol) ){.
87d0: 20 20 20 69 66 28 20 21 69 73 49 67 6e 6f 72 65 if( !isIgnore
87e0: 45 72 72 6f 72 73 20 7c 7c 20 64 62 2d 3e 6d 61 Errors || db->ma
87f0: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 20 72 65 74 llocFailed ) ret
8800: 75 72 6e 3b 0a 20 20 20 20 20 20 63 6f 6e 74 69 urn;. conti
8810: 6e 75 65 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 nue;. }. a
8820: 73 73 65 72 74 28 20 61 69 43 6f 6c 20 7c 7c 20 ssert( aiCol ||
8830: 70 46 4b 65 79 2d 3e 6e 43 6f 6c 3d 3d 31 20 29 pFKey->nCol==1 )
8840: 3b 0a 0a 20 20 20 20 2f 2a 20 43 72 65 61 74 65 ;.. /* Create
8850: 20 61 20 53 72 63 4c 69 73 74 20 73 74 72 75 63 a SrcList struc
8860: 74 75 72 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 ture containing
8870: 61 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 20 28 a single table (
8880: 74 68 65 20 74 61 62 6c 65 20 0a 20 20 20 20 2a the table . *
8890: 2a 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65 * the foreign ke
88a0: 79 20 74 68 61 74 20 72 65 66 65 72 73 20 74 6f y that refers to
88b0: 20 74 68 69 73 20 74 61 62 6c 65 20 69 73 20 61 this table is a
88c0: 74 74 61 63 68 65 64 20 74 6f 29 2e 20 54 68 69 ttached to). Thi
88d0: 73 0a 20 20 20 20 2a 2a 20 69 73 20 72 65 71 75 s. ** is requ
88e0: 69 72 65 64 20 66 6f 72 20 74 68 65 20 73 71 6c ired for the sql
88f0: 69 74 65 33 57 68 65 72 65 58 58 58 28 29 20 69 ite3WhereXXX() i
8900: 6e 74 65 72 66 61 63 65 2e 20 20 2a 2f 0a 20 20 nterface. */.
8910: 20 20 70 53 72 63 20 3d 20 73 71 6c 69 74 65 33 pSrc = sqlite3
8920: 53 72 63 4c 69 73 74 41 70 70 65 6e 64 28 64 62 SrcListAppend(db
8930: 2c 20 30 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 , 0, 0, 0);.
8940: 69 66 28 20 70 53 72 63 20 29 7b 0a 20 20 20 20 if( pSrc ){.
8950: 20 20 73 74 72 75 63 74 20 53 72 63 4c 69 73 74 struct SrcList
8960: 5f 69 74 65 6d 20 2a 70 49 74 65 6d 20 3d 20 70 _item *pItem = p
8970: 53 72 63 2d 3e 61 3b 0a 20 20 20 20 20 20 70 49 Src->a;. pI
8980: 74 65 6d 2d 3e 70 54 61 62 20 3d 20 70 46 4b 65 tem->pTab = pFKe
8990: 79 2d 3e 70 46 72 6f 6d 3b 0a 20 20 20 20 20 20 y->pFrom;.
89a0: 70 49 74 65 6d 2d 3e 7a 4e 61 6d 65 20 3d 20 70 pItem->zName = p
89b0: 46 4b 65 79 2d 3e 70 46 72 6f 6d 2d 3e 7a 4e 61 FKey->pFrom->zNa
89c0: 6d 65 3b 0a 20 20 20 20 20 20 70 49 74 65 6d 2d me;. pItem-
89d0: 3e 70 54 61 62 2d 3e 6e 52 65 66 2b 2b 3b 0a 20 >pTab->nRef++;.
89e0: 20 20 20 20 20 70 49 74 65 6d 2d 3e 69 43 75 72 pItem->iCur
89f0: 73 6f 72 20 3d 20 70 50 61 72 73 65 2d 3e 6e 54 sor = pParse->nT
8a00: 61 62 2b 2b 3b 0a 20 20 0a 20 20 20 20 20 20 69 ab++;. . i
8a10: 66 28 20 72 65 67 4e 65 77 21 3d 30 20 29 7b 0a f( regNew!=0 ){.
8a20: 20 20 20 20 20 20 20 20 66 6b 53 63 61 6e 43 68 fkScanCh
8a30: 69 6c 64 72 65 6e 28 70 50 61 72 73 65 2c 20 70 ildren(pParse, p
8a40: 53 72 63 2c 20 70 54 61 62 2c 20 70 49 64 78 2c Src, pTab, pIdx,
8a50: 20 70 46 4b 65 79 2c 20 61 69 43 6f 6c 2c 20 72 pFKey, aiCol, r
8a60: 65 67 4e 65 77 2c 20 2d 31 29 3b 0a 20 20 20 20 egNew, -1);.
8a70: 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 72 65 }. if( re
8a80: 67 4f 6c 64 21 3d 30 20 29 7b 0a 20 20 20 20 20 gOld!=0 ){.
8a90: 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 /* If there i
8aa0: 73 20 61 20 52 45 53 54 52 49 43 54 20 61 63 74 s a RESTRICT act
8ab0: 69 6f 6e 20 63 6f 6e 66 69 67 75 72 65 64 20 66 ion configured f
8ac0: 6f 72 20 74 68 65 20 63 75 72 72 65 6e 74 20 6f or the current o
8ad0: 70 65 72 61 74 69 6f 6e 0a 20 20 20 20 20 20 20 peration.
8ae0: 20 2a 2a 20 6f 6e 20 74 68 65 20 70 61 72 65 6e ** on the paren
8af0: 74 20 74 61 62 6c 65 20 6f 66 20 74 68 69 73 20 t table of this
8b00: 46 4b 2c 20 74 68 65 6e 20 74 68 72 6f 77 20 61 FK, then throw a
8b10: 6e 20 65 78 63 65 70 74 69 6f 6e 20 0a 20 20 20 n exception .
8b20: 20 20 20 20 20 2a 2a 20 69 6d 6d 65 64 69 61 74 ** immediat
8b30: 65 6c 79 20 69 66 20 74 68 65 20 46 4b 20 63 6f ely if the FK co
8b40: 6e 73 74 72 61 69 6e 74 20 69 73 20 76 69 6f 6c nstraint is viol
8b50: 61 74 65 64 2c 20 65 76 65 6e 20 69 66 20 74 68 ated, even if th
8b60: 69 73 20 69 73 20 61 0a 20 20 20 20 20 20 20 20 is is a.
8b70: 2a 2a 20 64 65 66 65 72 72 65 64 20 74 72 69 67 ** deferred trig
8b80: 67 65 72 2e 20 54 68 61 74 27 73 20 77 68 61 74 ger. That's what
8b90: 20 52 45 53 54 52 49 43 54 20 6d 65 61 6e 73 2e RESTRICT means.
8ba0: 20 54 6f 20 64 65 66 65 72 20 63 68 65 63 6b 69 To defer checki
8bb0: 6e 67 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 ng. ** th
8bc0: 65 20 63 6f 6e 73 74 72 61 69 6e 74 2c 20 74 68 e constraint, th
8bd0: 65 20 46 4b 20 73 68 6f 75 6c 64 20 73 70 65 63 e FK should spec
8be0: 69 66 79 20 4e 4f 20 41 43 54 49 4f 4e 20 28 72 ify NO ACTION (r
8bf0: 65 70 72 65 73 65 6e 74 65 64 0a 20 20 20 20 20 epresented.
8c00: 20 20 20 2a 2a 20 75 73 69 6e 67 20 4f 45 5f 4e ** using OE_N
8c10: 6f 6e 65 29 2e 20 4e 4f 20 41 43 54 49 4f 4e 20 one). NO ACTION
8c20: 69 73 20 74 68 65 20 64 65 66 61 75 6c 74 2e 20 is the default.
8c30: 20 2a 2f 0a 20 20 20 20 20 20 20 20 66 6b 53 63 */. fkSc
8c40: 61 6e 43 68 69 6c 64 72 65 6e 28 70 50 61 72 73 anChildren(pPars
8c50: 65 2c 20 70 53 72 63 2c 20 70 54 61 62 2c 20 70 e, pSrc, pTab, p
8c60: 49 64 78 2c 20 70 46 4b 65 79 2c 20 61 69 43 6f Idx, pFKey, aiCo
8c70: 6c 2c 20 72 65 67 4f 6c 64 2c 20 31 29 3b 0a 20 l, regOld, 1);.
8c80: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 49 74 }. pIt
8c90: 65 6d 2d 3e 7a 4e 61 6d 65 20 3d 20 30 3b 0a 20 em->zName = 0;.
8ca0: 20 20 20 20 20 73 71 6c 69 74 65 33 53 72 63 4c sqlite3SrcL
8cb0: 69 73 74 44 65 6c 65 74 65 28 64 62 2c 20 70 53 istDelete(db, pS
8cc0: 72 63 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 rc);. }. s
8cd0: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
8ce0: 20 61 69 43 6f 6c 29 3b 0a 20 20 7d 0a 7d 0a 0a aiCol);. }.}..
8cf0: 23 64 65 66 69 6e 65 20 43 4f 4c 55 4d 4e 5f 4d #define COLUMN_M
8d00: 41 53 4b 28 78 29 20 28 28 28 78 29 3e 33 31 29 ASK(x) (((x)>31)
8d10: 20 3f 20 30 78 66 66 66 66 66 66 66 66 20 3a 20 ? 0xffffffff :
8d20: 28 28 75 33 32 29 31 3c 3c 28 78 29 29 29 0a 0a ((u32)1<<(x)))..
8d30: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
8d40: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 62 65 ion is called be
8d50: 66 6f 72 65 20 67 65 6e 65 72 61 74 69 6e 67 20 fore generating
8d60: 63 6f 64 65 20 74 6f 20 75 70 64 61 74 65 20 6f code to update o
8d70: 72 20 64 65 6c 65 74 65 20 61 20 0a 2a 2a 20 72 r delete a .** r
8d80: 6f 77 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 ow contained in
8d90: 74 61 62 6c 65 20 70 54 61 62 2e 0a 2a 2f 0a 75 table pTab..*/.u
8da0: 33 32 20 73 71 6c 69 74 65 33 46 6b 4f 6c 64 6d 32 sqlite3FkOldm
8db0: 61 73 6b 28 0a 20 20 50 61 72 73 65 20 2a 70 50 ask(. Parse *pP
8dc0: 61 72 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 arse,
8dd0: 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 65 20 /* Parse
8de0: 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 54 61 62 context */. Tab
8df0: 6c 65 20 2a 70 54 61 62 20 20 20 20 20 20 20 20 le *pTab
8e00: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
8e10: 54 61 62 6c 65 20 62 65 69 6e 67 20 6d 6f 64 69 Table being modi
8e20: 66 69 65 64 20 2a 2f 0a 29 7b 0a 20 20 75 33 32 fied */.){. u32
8e30: 20 6d 61 73 6b 20 3d 20 30 3b 0a 20 20 69 66 28 mask = 0;. if(
8e40: 20 70 50 61 72 73 65 2d 3e 64 62 2d 3e 66 6c 61 pParse->db->fla
8e50: 67 73 26 53 51 4c 49 54 45 5f 46 6f 72 65 69 67 gs&SQLITE_Foreig
8e60: 6e 4b 65 79 73 20 29 7b 0a 20 20 20 20 46 4b 65 nKeys ){. FKe
8e70: 79 20 2a 70 3b 0a 20 20 20 20 69 6e 74 20 69 3b y *p;. int i;
8e80: 0a 20 20 20 20 66 6f 72 28 70 3d 70 54 61 62 2d . for(p=pTab-
8e90: 3e 70 46 4b 65 79 3b 20 70 3b 20 70 3d 70 2d 3e >pFKey; p; p=p->
8ea0: 70 4e 65 78 74 46 72 6f 6d 29 7b 0a 20 20 20 20 pNextFrom){.
8eb0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d 3e for(i=0; i<p->
8ec0: 6e 43 6f 6c 3b 20 69 2b 2b 29 20 6d 61 73 6b 20 nCol; i++) mask
8ed0: 7c 3d 20 43 4f 4c 55 4d 4e 5f 4d 41 53 4b 28 70 |= COLUMN_MASK(p
8ee0: 2d 3e 61 43 6f 6c 5b 69 5d 2e 69 46 72 6f 6d 29 ->aCol[i].iFrom)
8ef0: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 ;. }. for(
8f00: 70 3d 73 71 6c 69 74 65 33 46 6b 52 65 66 65 72 p=sqlite3FkRefer
8f10: 65 6e 63 65 73 28 70 54 61 62 29 3b 20 70 3b 20 ences(pTab); p;
8f20: 70 3d 70 2d 3e 70 4e 65 78 74 54 6f 29 7b 0a 20 p=p->pNextTo){.
8f30: 20 20 20 20 20 49 6e 64 65 78 20 2a 70 49 64 78 Index *pIdx
8f40: 20 3d 20 30 3b 0a 20 20 20 20 20 20 73 71 6c 69 = 0;. sqli
8f50: 74 65 33 46 6b 4c 6f 63 61 74 65 49 6e 64 65 78 te3FkLocateIndex
8f60: 28 70 50 61 72 73 65 2c 20 70 54 61 62 2c 20 70 (pParse, pTab, p
8f70: 2c 20 26 70 49 64 78 2c 20 30 29 3b 0a 20 20 20 , &pIdx, 0);.
8f80: 20 20 20 69 66 28 20 70 49 64 78 20 29 7b 0a 20 if( pIdx ){.
8f90: 20 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 for(i=0;
8fa0: 69 3c 70 49 64 78 2d 3e 6e 43 6f 6c 75 6d 6e 3b i<pIdx->nColumn;
8fb0: 20 69 2b 2b 29 20 6d 61 73 6b 20 7c 3d 20 43 4f i++) mask |= CO
8fc0: 4c 55 4d 4e 5f 4d 41 53 4b 28 70 49 64 78 2d 3e LUMN_MASK(pIdx->
8fd0: 61 69 43 6f 6c 75 6d 6e 5b 69 5d 29 3b 0a 20 20 aiColumn[i]);.
8fe0: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
8ff0: 20 20 72 65 74 75 72 6e 20 6d 61 73 6b 3b 0a 7d return mask;.}
9000: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
9010: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 ction is called
9020: 62 65 66 6f 72 65 20 67 65 6e 65 72 61 74 69 6e before generatin
9030: 67 20 63 6f 64 65 20 74 6f 20 75 70 64 61 74 65 g code to update
9040: 20 6f 72 20 64 65 6c 65 74 65 20 61 20 0a 2a 2a or delete a .**
9050: 20 72 6f 77 20 63 6f 6e 74 61 69 6e 65 64 20 69 row contained i
9060: 6e 20 74 61 62 6c 65 20 70 54 61 62 2e 20 49 66 n table pTab. If
9070: 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 20 69 the operation i
9080: 73 20 61 20 44 45 4c 45 54 45 2c 20 74 68 65 6e s a DELETE, then
9090: 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 20 61 43 .** parameter aC
90a0: 68 61 6e 67 65 20 69 73 20 70 61 73 73 65 64 20 hange is passed
90b0: 61 20 4e 55 4c 4c 20 76 61 6c 75 65 2e 20 46 6f a NULL value. Fo
90c0: 72 20 61 6e 20 55 50 44 41 54 45 2c 20 61 43 68 r an UPDATE, aCh
90d0: 61 6e 67 65 20 70 6f 69 6e 74 73 0a 2a 2a 20 74 ange points.** t
90e0: 6f 20 61 6e 20 61 72 72 61 79 20 6f 66 20 73 69 o an array of si
90f0: 7a 65 20 4e 2c 20 77 68 65 72 65 20 4e 20 69 73 ze N, where N is
9100: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 the number of c
9110: 6f 6c 75 6d 6e 73 20 69 6e 20 74 61 62 6c 65 20 olumns in table
9120: 70 54 61 62 2e 0a 2a 2a 20 49 66 20 74 68 65 20 pTab..** If the
9130: 69 27 74 68 20 63 6f 6c 75 6d 6e 20 69 73 20 6e i'th column is n
9140: 6f 74 20 6d 6f 64 69 66 69 65 64 20 62 79 20 74 ot modified by t
9150: 68 65 20 55 50 44 41 54 45 2c 20 74 68 65 6e 20 he UPDATE, then
9160: 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e the correspondin
9170: 67 20 0a 2a 2a 20 65 6e 74 72 79 20 69 6e 20 74 g .** entry in t
9180: 68 65 20 61 43 68 61 6e 67 65 5b 5d 20 61 72 72 he aChange[] arr
9190: 61 79 20 69 73 20 73 65 74 20 74 6f 20 2d 31 2e ay is set to -1.
91a0: 20 49 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20 69 If the column i
91b0: 73 20 6d 6f 64 69 66 69 65 64 2c 0a 2a 2a 20 74 s modified,.** t
91c0: 68 65 20 76 61 6c 75 65 20 69 73 20 30 20 6f 72 he value is 0 or
91d0: 20 67 72 65 61 74 65 72 2e 20 50 61 72 61 6d 65 greater. Parame
91e0: 74 65 72 20 63 68 6e 67 52 6f 77 69 64 20 69 73 ter chngRowid is
91f0: 20 73 65 74 20 74 6f 20 74 72 75 65 20 69 66 20 set to true if
9200: 74 68 65 0a 2a 2a 20 55 50 44 41 54 45 20 73 74 the.** UPDATE st
9210: 61 74 65 6d 65 6e 74 20 6d 6f 64 69 66 69 65 73 atement modifies
9220: 20 74 68 65 20 72 6f 77 69 64 20 66 69 65 6c 64 the rowid field
9230: 73 20 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 0a s of the table..
9240: 2a 2a 0a 2a 2a 20 49 66 20 61 6e 79 20 66 6f 72 **.** If any for
9250: 65 69 67 6e 20 6b 65 79 20 70 72 6f 63 65 73 73 eign key process
9260: 69 6e 67 20 77 69 6c 6c 20 62 65 20 72 65 71 75 ing will be requ
9270: 69 72 65 64 2c 20 74 68 69 73 20 66 75 6e 63 74 ired, this funct
9280: 69 6f 6e 20 72 65 74 75 72 6e 73 0a 2a 2a 20 74 ion returns.** t
9290: 72 75 65 2e 20 49 66 20 74 68 65 72 65 20 69 73 rue. If there is
92a0: 20 6e 6f 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 no foreign key
92b0: 72 65 6c 61 74 65 64 20 70 72 6f 63 65 73 73 69 related processi
92c0: 6e 67 2c 20 74 68 69 73 20 66 75 6e 63 74 69 6f ng, this functio
92d0: 6e 20 0a 2a 2a 20 72 65 74 75 72 6e 73 20 66 61 n .** returns fa
92e0: 6c 73 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 lse..*/.int sqli
92f0: 74 65 33 46 6b 52 65 71 75 69 72 65 64 28 0a 20 te3FkRequired(.
9300: 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 Parse *pParse,
9310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9320: 20 2f 2a 20 50 61 72 73 65 20 63 6f 6e 74 65 78 /* Parse contex
9330: 74 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 t */. Table *pT
9340: 61 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 ab,
9350: 20 20 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 /* Table
9360: 62 65 69 6e 67 20 6d 6f 64 69 66 69 65 64 20 2a being modified *
9370: 2f 0a 20 20 69 6e 74 20 2a 61 43 68 61 6e 67 65 /. int *aChange
9380: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
9390: 20 20 20 20 2f 2a 20 4e 6f 6e 2d 4e 55 4c 4c 20 /* Non-NULL
93a0: 66 6f 72 20 55 50 44 41 54 45 20 6f 70 65 72 61 for UPDATE opera
93b0: 74 69 6f 6e 73 20 2a 2f 0a 20 20 69 6e 74 20 63 tions */. int c
93c0: 68 6e 67 52 6f 77 69 64 20 20 20 20 20 20 20 20 hngRowid
93d0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 /* Tr
93e0: 75 65 20 66 6f 72 20 55 50 44 41 54 45 20 74 68 ue for UPDATE th
93f0: 61 74 20 61 66 66 65 63 74 73 20 72 6f 77 69 64 at affects rowid
9400: 20 2a 2f 0a 29 7b 0a 20 20 69 66 28 20 70 50 61 */.){. if( pPa
9410: 72 73 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 53 rse->db->flags&S
9420: 51 4c 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 QLITE_ForeignKey
9430: 73 20 29 7b 0a 20 20 20 20 69 66 28 20 21 61 43 s ){. if( !aC
9440: 68 61 6e 67 65 20 29 7b 0a 20 20 20 20 20 20 2f hange ){. /
9450: 2a 20 41 20 44 45 4c 45 54 45 20 6f 70 65 72 61 * A DELETE opera
9460: 74 69 6f 6e 2e 20 46 6f 72 65 69 67 6e 20 6b 65 tion. Foreign ke
9470: 79 20 70 72 6f 63 65 73 73 69 6e 67 20 69 73 20 y processing is
9480: 72 65 71 75 69 72 65 64 20 69 66 20 74 68 65 20 required if the
9490: 0a 20 20 20 20 20 20 2a 2a 20 74 61 62 6c 65 20 . ** table
94a0: 69 6e 20 71 75 65 73 74 69 6f 6e 20 69 73 20 65 in question is e
94b0: 69 74 68 65 72 20 74 68 65 20 63 68 69 6c 64 20 ither the child
94c0: 6f 72 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 or parent table
94d0: 66 6f 72 20 61 6e 79 20 0a 20 20 20 20 20 20 2a for any . *
94e0: 2a 20 66 6f 72 65 69 67 6e 20 6b 65 79 20 63 6f * foreign key co
94f0: 6e 73 74 72 61 69 6e 74 2e 20 20 2a 2f 0a 20 20 nstraint. */.
9500: 20 20 20 20 72 65 74 75 72 6e 20 28 73 71 6c 69 return (sqli
9510: 74 65 33 46 6b 52 65 66 65 72 65 6e 63 65 73 28 te3FkReferences(
9520: 70 54 61 62 29 20 7c 7c 20 70 54 61 62 2d 3e 70 pTab) || pTab->p
9530: 46 4b 65 79 29 3b 0a 20 20 20 20 7d 65 6c 73 65 FKey);. }else
9540: 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 {. /* This
9550: 69 73 20 61 6e 20 55 50 44 41 54 45 2e 20 46 6f is an UPDATE. Fo
9560: 72 65 69 67 6e 20 6b 65 79 20 70 72 6f 63 65 73 reign key proces
9570: 73 69 6e 67 20 69 73 20 6f 6e 6c 79 20 72 65 71 sing is only req
9580: 75 69 72 65 64 20 69 66 20 74 68 65 0a 20 20 20 uired if the.
9590: 20 20 20 2a 2a 20 6f 70 65 72 61 74 69 6f 6e 20 ** operation
95a0: 6d 6f 64 69 66 69 65 73 20 6f 6e 65 20 6f 72 20 modifies one or
95b0: 6d 6f 72 65 20 63 68 69 6c 64 20 6f 72 20 70 61 more child or pa
95c0: 72 65 6e 74 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 rent key columns
95d0: 2e 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 69 . */. int i
95e0: 3b 0a 20 20 20 20 20 20 46 4b 65 79 20 2a 70 3b ;. FKey *p;
95f0: 0a 0a 20 20 20 20 20 20 2f 2a 20 43 68 65 63 6b .. /* Check
9600: 20 69 66 20 61 6e 79 20 63 68 69 6c 64 20 6b 65 if any child ke
9610: 79 20 63 6f 6c 75 6d 6e 73 20 61 72 65 20 62 65 y columns are be
9620: 69 6e 67 20 6d 6f 64 69 66 69 65 64 2e 20 2a 2f ing modified. */
9630: 0a 20 20 20 20 20 20 66 6f 72 28 70 3d 70 54 61 . for(p=pTa
9640: 62 2d 3e 70 46 4b 65 79 3b 20 70 3b 20 70 3d 70 b->pFKey; p; p=p
9650: 2d 3e 70 4e 65 78 74 46 72 6f 6d 29 7b 0a 20 20 ->pNextFrom){.
9660: 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 for(i=0; i
9670: 3c 70 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a <p->nCol; i++){.
9680: 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 43 int iC
9690: 68 69 6c 64 4b 65 79 20 3d 20 70 2d 3e 61 43 6f hildKey = p->aCo
96a0: 6c 5b 69 5d 2e 69 46 72 6f 6d 3b 0a 20 20 20 20 l[i].iFrom;.
96b0: 20 20 20 20 20 20 69 66 28 20 61 43 68 61 6e 67 if( aChang
96c0: 65 5b 69 43 68 69 6c 64 4b 65 79 5d 3e 3d 30 20 e[iChildKey]>=0
96d0: 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 ) return 1;.
96e0: 20 20 20 20 20 20 69 66 28 20 69 43 68 69 6c 64 if( iChild
96f0: 4b 65 79 3d 3d 70 54 61 62 2d 3e 69 50 4b 65 79 Key==pTab->iPKey
9700: 20 26 26 20 63 68 6e 67 52 6f 77 69 64 20 29 20 && chngRowid )
9710: 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 20 20 return 1;.
9720: 20 20 7d 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 }. }..
9730: 20 20 20 2f 2a 20 43 68 65 63 6b 20 69 66 20 61 /* Check if a
9740: 6e 79 20 70 61 72 65 6e 74 20 6b 65 79 20 63 6f ny parent key co
9750: 6c 75 6d 6e 73 20 61 72 65 20 62 65 69 6e 67 20 lumns are being
9760: 6d 6f 64 69 66 69 65 64 2e 20 2a 2f 0a 20 20 20 modified. */.
9770: 20 20 20 66 6f 72 28 70 3d 73 71 6c 69 74 65 33 for(p=sqlite3
9780: 46 6b 52 65 66 65 72 65 6e 63 65 73 28 70 54 61 FkReferences(pTa
9790: 62 29 3b 20 70 3b 20 70 3d 70 2d 3e 70 4e 65 78 b); p; p=p->pNex
97a0: 74 54 6f 29 7b 0a 20 20 20 20 20 20 20 20 66 6f tTo){. fo
97b0: 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 43 6f 6c r(i=0; i<p->nCol
97c0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 ; i++){.
97d0: 20 20 63 68 61 72 20 2a 7a 4b 65 79 20 3d 20 70 char *zKey = p
97e0: 2d 3e 61 43 6f 6c 5b 69 5d 2e 7a 43 6f 6c 3b 0a ->aCol[i].zCol;.
97f0: 20 20 20 20 20 20 20 20 20 20 69 6e 74 20 69 4b int iK
9800: 65 79 3b 0a 20 20 20 20 20 20 20 20 20 20 66 6f ey;. fo
9810: 72 28 69 4b 65 79 3d 30 3b 20 69 4b 65 79 3c 70 r(iKey=0; iKey<p
9820: 54 61 62 2d 3e 6e 43 6f 6c 3b 20 69 4b 65 79 2b Tab->nCol; iKey+
9830: 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 +){.
9840: 43 6f 6c 75 6d 6e 20 2a 70 43 6f 6c 20 3d 20 26 Column *pCol = &
9850: 70 54 61 62 2d 3e 61 43 6f 6c 5b 69 4b 65 79 5d pTab->aCol[iKey]
9860: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 ;. if
9870: 28 20 28 7a 4b 65 79 20 3f 20 21 73 71 6c 69 74 ( (zKey ? !sqlit
9880: 65 33 53 74 72 49 43 6d 70 28 70 43 6f 6c 2d 3e e3StrICmp(pCol->
9890: 7a 4e 61 6d 65 2c 20 7a 4b 65 79 29 0a 20 20 20 zName, zKey).
98a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
98b0: 20 20 20 3a 20 28 70 43 6f 6c 2d 3e 63 6f 6c 46 : (pCol->colF
98c0: 6c 61 67 73 20 26 20 43 4f 4c 46 4c 41 47 5f 50 lags & COLFLAG_P
98d0: 52 49 4d 4b 45 59 29 21 3d 30 29 20 29 7b 0a 20 RIMKEY)!=0) ){.
98e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 if(
98f0: 20 61 43 68 61 6e 67 65 5b 69 4b 65 79 5d 3e 3d aChange[iKey]>=
9900: 30 20 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 0 ) return 1;.
9910: 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 if(
9920: 69 4b 65 79 3d 3d 70 54 61 62 2d 3e 69 50 4b 65 iKey==pTab->iPKe
9930: 79 20 26 26 20 63 68 6e 67 52 6f 77 69 64 20 29 y && chngRowid )
9940: 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 20 return 1;.
9950: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
9960: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 }. }.
9970: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d }. }. }
9980: 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a . return 0;.}..
9990: 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 /*.** This funct
99a0: 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 68 ion is called wh
99b0: 65 6e 20 61 6e 20 55 50 44 41 54 45 20 6f 72 20 en an UPDATE or
99c0: 44 45 4c 45 54 45 20 6f 70 65 72 61 74 69 6f 6e DELETE operation
99d0: 20 69 73 20 62 65 69 6e 67 20 0a 2a 2a 20 63 6f is being .** co
99e0: 6d 70 69 6c 65 64 20 6f 6e 20 74 61 62 6c 65 20 mpiled on table
99f0: 70 54 61 62 2c 20 77 68 69 63 68 20 69 73 20 74 pTab, which is t
9a00: 68 65 20 70 61 72 65 6e 74 20 74 61 62 6c 65 20 he parent table
9a10: 6f 66 20 66 6f 72 65 69 67 6e 2d 6b 65 79 20 70 of foreign-key p
9a20: 46 4b 65 79 2e 0a 2a 2a 20 49 66 20 74 68 65 20 FKey..** If the
9a30: 63 75 72 72 65 6e 74 20 6f 70 65 72 61 74 69 6f current operatio
9a40: 6e 20 69 73 20 61 6e 20 55 50 44 41 54 45 2c 20 n is an UPDATE,
9a50: 74 68 65 6e 20 74 68 65 20 70 43 68 61 6e 67 65 then the pChange
9a60: 73 20 70 61 72 61 6d 65 74 65 72 20 69 73 0a 2a s parameter is.*
9a70: 2a 20 70 61 73 73 65 64 20 61 20 70 6f 69 6e 74 * passed a point
9a80: 65 72 20 74 6f 20 74 68 65 20 6c 69 73 74 20 6f er to the list o
9a90: 66 20 63 6f 6c 75 6d 6e 73 20 62 65 69 6e 67 20 f columns being
9aa0: 6d 6f 64 69 66 69 65 64 2e 20 49 66 20 69 74 20 modified. If it
9ab0: 69 73 20 61 0a 2a 2a 20 44 45 4c 45 54 45 2c 20 is a.** DELETE,
9ac0: 70 43 68 61 6e 67 65 73 20 69 73 20 70 61 73 73 pChanges is pass
9ad0: 65 64 20 61 20 4e 55 4c 4c 20 70 6f 69 6e 74 65 ed a NULL pointe
9ae0: 72 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 72 65 74 75 r..**.** It retu
9af0: 72 6e 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f rns a pointer to
9b00: 20 61 20 54 72 69 67 67 65 72 20 73 74 72 75 63 a Trigger struc
9b10: 74 75 72 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 ture containing
9b20: 61 20 74 72 69 67 67 65 72 0a 2a 2a 20 65 71 75 a trigger.** equ
9b30: 69 76 61 6c 65 6e 74 20 74 6f 20 74 68 65 20 4f ivalent to the O
9b40: 4e 20 55 50 44 41 54 45 20 6f 72 20 4f 4e 20 44 N UPDATE or ON D
9b50: 45 4c 45 54 45 20 61 63 74 69 6f 6e 20 73 70 65 ELETE action spe
9b60: 63 69 66 69 65 64 20 62 79 20 70 46 4b 65 79 2e cified by pFKey.
9b70: 0a 2a 2a 20 49 66 20 74 68 65 20 61 63 74 69 6f .** If the actio
9b80: 6e 20 69 73 20 22 4e 4f 20 41 43 54 49 4f 4e 22 n is "NO ACTION"
9b90: 20 6f 72 20 22 52 45 53 54 52 49 43 54 22 2c 20 or "RESTRICT",
9ba0: 74 68 65 6e 20 61 20 4e 55 4c 4c 20 70 6f 69 6e then a NULL poin
9bb0: 74 65 72 20 69 73 0a 2a 2a 20 72 65 74 75 72 6e ter is.** return
9bc0: 65 64 20 28 74 68 65 73 65 20 61 63 74 69 6f 6e ed (these action
9bd0: 73 20 72 65 71 75 69 72 65 20 6e 6f 20 73 70 65 s require no spe
9be0: 63 69 61 6c 20 68 61 6e 64 6c 69 6e 67 20 62 79 cial handling by
9bf0: 20 74 68 65 20 74 72 69 67 67 65 72 73 0a 2a 2a the triggers.**
9c00: 20 73 75 62 2d 73 79 73 74 65 6d 2c 20 63 6f 64 sub-system, cod
9c10: 65 20 66 6f 72 20 74 68 65 6d 20 69 73 20 63 72 e for them is cr
9c20: 65 61 74 65 64 20 62 79 20 66 6b 53 63 61 6e 43 eated by fkScanC
9c30: 68 69 6c 64 72 65 6e 28 29 29 2e 0a 2a 2a 0a 2a hildren())..**.*
9c40: 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 * For example, i
9c50: 66 20 70 46 4b 65 79 20 69 73 20 74 68 65 20 66 f pFKey is the f
9c60: 6f 72 65 69 67 6e 20 6b 65 79 20 61 6e 64 20 70 oreign key and p
9c70: 54 61 62 20 69 73 20 74 61 62 6c 65 20 22 70 22 Tab is table "p"
9c80: 20 69 6e 20 0a 2a 2a 20 74 68 65 20 66 6f 6c 6c in .** the foll
9c90: 6f 77 69 6e 67 20 73 63 68 65 6d 61 3a 0a 2a 2a owing schema:.**
9ca0: 0a 2a 2a 20 20 20 43 52 45 41 54 45 20 54 41 42 .** CREATE TAB
9cb0: 4c 45 20 70 28 70 6b 20 50 52 49 4d 41 52 59 20 LE p(pk PRIMARY
9cc0: 4b 45 59 29 3b 0a 2a 2a 20 20 20 43 52 45 41 54 KEY);.** CREAT
9cd0: 45 20 54 41 42 4c 45 20 63 28 63 6b 20 52 45 46 E TABLE c(ck REF
9ce0: 45 52 45 4e 43 45 53 20 70 20 4f 4e 20 44 45 4c ERENCES p ON DEL
9cf0: 45 54 45 20 43 41 53 43 41 44 45 29 3b 0a 2a 2a ETE CASCADE);.**
9d00: 0a 2a 2a 20 74 68 65 6e 20 74 68 65 20 72 65 74 .** then the ret
9d10: 75 72 6e 65 64 20 74 72 69 67 67 65 72 20 73 74 urned trigger st
9d20: 72 75 63 74 75 72 65 20 69 73 20 65 71 75 69 76 ructure is equiv
9d30: 61 6c 65 6e 74 20 74 6f 3a 0a 2a 2a 0a 2a 2a 20 alent to:.**.**
9d40: 20 20 43 52 45 41 54 45 20 54 52 49 47 47 45 52 CREATE TRIGGER
9d50: 20 2e 2e 2e 20 44 45 4c 45 54 45 20 4f 4e 20 70 ... DELETE ON p
9d60: 20 42 45 47 49 4e 0a 2a 2a 20 20 20 20 20 44 45 BEGIN.** DE
9d70: 4c 45 54 45 20 46 52 4f 4d 20 63 20 57 48 45 52 LETE FROM c WHER
9d80: 45 20 63 6b 20 3d 20 6f 6c 64 2e 70 6b 3b 0a 2a E ck = old.pk;.*
9d90: 2a 20 20 20 45 4e 44 3b 0a 2a 2a 0a 2a 2a 20 54 * END;.**.** T
9da0: 68 65 20 72 65 74 75 72 6e 65 64 20 70 6f 69 6e he returned poin
9db0: 74 65 72 20 69 73 20 63 61 63 68 65 64 20 61 73 ter is cached as
9dc0: 20 70 61 72 74 20 6f 66 20 74 68 65 20 66 6f 72 part of the for
9dd0: 65 69 67 6e 20 6b 65 79 20 6f 62 6a 65 63 74 2e eign key object.
9de0: 20 49 74 0a 2a 2a 20 69 73 20 65 76 65 6e 74 75 It.** is eventu
9df0: 61 6c 6c 79 20 66 72 65 65 64 20 61 6c 6f 6e 67 ally freed along
9e00: 20 77 69 74 68 20 74 68 65 20 72 65 73 74 20 6f with the rest o
9e10: 66 20 74 68 65 20 66 6f 72 65 69 67 6e 20 6b 65 f the foreign ke
9e20: 79 20 6f 62 6a 65 63 74 20 62 79 20 0a 2a 2a 20 y object by .**
9e30: 73 71 6c 69 74 65 33 46 6b 44 65 6c 65 74 65 28 sqlite3FkDelete(
9e40: 29 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 54 72 69 )..*/.static Tri
9e50: 67 67 65 72 20 2a 66 6b 41 63 74 69 6f 6e 54 72 gger *fkActionTr
9e60: 69 67 67 65 72 28 0a 20 20 50 61 72 73 65 20 2a igger(. Parse *
9e70: 70 50 61 72 73 65 2c 20 20 20 20 20 20 20 20 20 pParse,
9e80: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 /* Pars
9e90: 65 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 54 e context */. T
9ea0: 61 62 6c 65 20 2a 70 54 61 62 2c 20 20 20 20 20 able *pTab,
9eb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
9ec0: 2a 20 54 61 62 6c 65 20 62 65 69 6e 67 20 75 70 * Table being up
9ed0: 64 61 74 65 64 20 6f 72 20 64 65 6c 65 74 65 64 dated or deleted
9ee0: 20 66 72 6f 6d 20 2a 2f 0a 20 20 46 4b 65 79 20 from */. FKey
9ef0: 2a 70 46 4b 65 79 2c 20 20 20 20 20 20 20 20 20 *pFKey,
9f00: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 6f /* Fo
9f10: 72 65 69 67 6e 20 6b 65 79 20 74 6f 20 67 65 74 reign key to get
9f20: 20 61 63 74 69 6f 6e 20 66 6f 72 20 2a 2f 0a 20 action for */.
9f30: 20 45 78 70 72 4c 69 73 74 20 2a 70 43 68 61 6e ExprList *pChan
9f40: 67 65 73 20 20 20 20 20 20 20 20 20 20 20 20 20 ges
9f50: 20 2f 2a 20 43 68 61 6e 67 65 2d 6c 69 73 74 20 /* Change-list
9f60: 66 6f 72 20 55 50 44 41 54 45 2c 20 4e 55 4c 4c for UPDATE, NULL
9f70: 20 66 6f 72 20 44 45 4c 45 54 45 20 2a 2f 0a 29 for DELETE */.)
9f80: 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 {. sqlite3 *db
9f90: 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 20 20 20 = pParse->db;
9fa0: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 /* Database
9fb0: 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 handle */. int
9fc0: 61 63 74 69 6f 6e 3b 20 20 20 20 20 20 20 20 20 action;
9fd0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
9fe0: 6e 65 20 6f 66 20 4f 45 5f 4e 6f 6e 65 2c 20 4f ne of OE_None, O
9ff0: 45 5f 43 61 73 63 61 64 65 20 65 74 63 2e 20 2a E_Cascade etc. *
a000: 2f 0a 20 20 54 72 69 67 67 65 72 20 2a 70 54 72 /. Trigger *pTr
a010: 69 67 67 65 72 3b 20 20 20 20 20 20 20 20 20 20 igger;
a020: 20 20 20 20 2f 2a 20 54 72 69 67 67 65 72 20 64 /* Trigger d
a030: 65 66 69 6e 69 74 69 6f 6e 20 74 6f 20 72 65 74 efinition to ret
a040: 75 72 6e 20 2a 2f 0a 20 20 69 6e 74 20 69 41 63 urn */. int iAc
a050: 74 69 6f 6e 20 3d 20 28 70 43 68 61 6e 67 65 73 tion = (pChanges
a060: 21 3d 30 29 3b 20 20 20 20 2f 2a 20 31 20 66 6f !=0); /* 1 fo
a070: 72 20 55 50 44 41 54 45 2c 20 30 20 66 6f 72 20 r UPDATE, 0 for
a080: 44 45 4c 45 54 45 20 2a 2f 0a 0a 20 20 61 63 74 DELETE */.. act
a090: 69 6f 6e 20 3d 20 70 46 4b 65 79 2d 3e 61 41 63 ion = pFKey->aAc
a0a0: 74 69 6f 6e 5b 69 41 63 74 69 6f 6e 5d 3b 0a 20 tion[iAction];.
a0b0: 20 70 54 72 69 67 67 65 72 20 3d 20 70 46 4b 65 pTrigger = pFKe
a0c0: 79 2d 3e 61 70 54 72 69 67 67 65 72 5b 69 41 63 y->apTrigger[iAc
a0d0: 74 69 6f 6e 5d 3b 0a 0a 20 20 69 66 28 20 61 63 tion];.. if( ac
a0e0: 74 69 6f 6e 21 3d 4f 45 5f 4e 6f 6e 65 20 26 26 tion!=OE_None &&
a0f0: 20 21 70 54 72 69 67 67 65 72 20 29 7b 0a 20 20 !pTrigger ){.
a100: 20 20 75 38 20 65 6e 61 62 6c 65 4c 6f 6f 6b 61 u8 enableLooka
a110: 73 69 64 65 3b 20 20 20 20 20 20 20 20 20 20 20 side;
a120: 2f 2a 20 43 6f 70 79 20 6f 66 20 64 62 2d 3e 6c /* Copy of db->l
a130: 6f 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 ookaside.bEnable
a140: 64 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 63 6f d */. char co
a150: 6e 73 74 20 2a 7a 46 72 6f 6d 3b 20 20 20 20 20 nst *zFrom;
a160: 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 20 6f /* Name o
a170: 66 20 63 68 69 6c 64 20 74 61 62 6c 65 20 2a 2f f child table */
a180: 0a 20 20 20 20 69 6e 74 20 6e 46 72 6f 6d 3b 20 . int nFrom;
a190: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
a1a0: 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 69 6e 20 /* Length in
a1b0: 62 79 74 65 73 20 6f 66 20 7a 46 72 6f 6d 20 2a bytes of zFrom *
a1c0: 2f 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 49 64 /. Index *pId
a1d0: 78 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 x = 0;
a1e0: 20 20 20 20 2f 2a 20 50 61 72 65 6e 74 20 6b 65 /* Parent ke
a1f0: 79 20 69 6e 64 65 78 20 66 6f 72 20 74 68 69 73 y index for this
a200: 20 46 4b 20 2a 2f 0a 20 20 20 20 69 6e 74 20 2a FK */. int *
a210: 61 69 43 6f 6c 20 3d 20 30 3b 20 20 20 20 20 20 aiCol = 0;
a220: 20 20 20 20 20 20 20 20 20 2f 2a 20 63 68 69 6c /* chil
a230: 64 20 74 61 62 6c 65 20 63 6f 6c 73 20 2d 3e 20 d table cols ->
a240: 70 61 72 65 6e 74 20 6b 65 79 20 63 6f 6c 73 20 parent key cols
a250: 2a 2f 0a 20 20 20 20 54 72 69 67 67 65 72 53 74 */. TriggerSt
a260: 65 70 20 2a 70 53 74 65 70 20 3d 20 30 3b 20 20 ep *pStep = 0;
a270: 20 20 20 20 20 20 2f 2a 20 46 69 72 73 74 20 28 /* First (
a280: 6f 6e 6c 79 29 20 73 74 65 70 20 6f 66 20 74 72 only) step of tr
a290: 69 67 67 65 72 20 70 72 6f 67 72 61 6d 20 2a 2f igger program */
a2a0: 0a 20 20 20 20 45 78 70 72 20 2a 70 57 68 65 72 . Expr *pWher
a2b0: 65 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 e = 0;
a2c0: 20 20 20 2f 2a 20 57 48 45 52 45 20 63 6c 61 75 /* WHERE clau
a2d0: 73 65 20 6f 66 20 74 72 69 67 67 65 72 20 73 74 se of trigger st
a2e0: 65 70 20 2a 2f 0a 20 20 20 20 45 78 70 72 4c 69 ep */. ExprLi
a2f0: 73 74 20 2a 70 4c 69 73 74 20 3d 20 30 3b 20 20 st *pList = 0;
a300: 20 20 20 20 20 20 20 20 2f 2a 20 43 68 61 6e 67 /* Chang
a310: 65 73 20 6c 69 73 74 20 69 66 20 4f 4e 20 55 50 es list if ON UP
a320: 44 41 54 45 20 43 41 53 43 41 44 45 20 2a 2f 0a DATE CASCADE */.
a330: 20 20 20 20 53 65 6c 65 63 74 20 2a 70 53 65 6c Select *pSel
a340: 65 63 74 20 3d 20 30 3b 20 20 20 20 20 20 20 20 ect = 0;
a350: 20 20 2f 2a 20 49 66 20 52 45 53 54 52 49 43 54 /* If RESTRICT
a360: 2c 20 22 53 45 4c 45 43 54 20 52 41 49 53 45 28 , "SELECT RAISE(
a370: 2e 2e 2e 29 22 20 2a 2f 0a 20 20 20 20 69 6e 74 ...)" */. int
a380: 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 i;
a390: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 74 /* It
a3a0: 65 72 61 74 6f 72 20 76 61 72 69 61 62 6c 65 20 erator variable
a3b0: 2a 2f 0a 20 20 20 20 45 78 70 72 20 2a 70 57 68 */. Expr *pWh
a3c0: 65 6e 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 en = 0;
a3d0: 20 20 20 20 20 2f 2a 20 57 48 45 4e 20 63 6c 61 /* WHEN cla
a3e0: 75 73 65 20 66 6f 72 20 74 68 65 20 74 72 69 67 use for the trig
a3f0: 67 65 72 20 2a 2f 0a 0a 20 20 20 20 69 66 28 20 ger */.. if(
a400: 73 71 6c 69 74 65 33 46 6b 4c 6f 63 61 74 65 49 sqlite3FkLocateI
a410: 6e 64 65 78 28 70 50 61 72 73 65 2c 20 70 54 61 ndex(pParse, pTa
a420: 62 2c 20 70 46 4b 65 79 2c 20 26 70 49 64 78 2c b, pFKey, &pIdx,
a430: 20 26 61 69 43 6f 6c 29 20 29 20 72 65 74 75 72 &aiCol) ) retur
a440: 6e 20 30 3b 0a 20 20 20 20 61 73 73 65 72 74 28 n 0;. assert(
a450: 20 61 69 43 6f 6c 20 7c 7c 20 70 46 4b 65 79 2d aiCol || pFKey-
a460: 3e 6e 43 6f 6c 3d 3d 31 20 29 3b 0a 0a 20 20 20 >nCol==1 );..
a470: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 46 4b 65 for(i=0; i<pFKe
a480: 79 2d 3e 6e 43 6f 6c 3b 20 69 2b 2b 29 7b 0a 20 y->nCol; i++){.
a490: 20 20 20 20 20 54 6f 6b 65 6e 20 74 4f 6c 64 20 Token tOld
a4a0: 3d 20 7b 20 22 6f 6c 64 22 2c 20 33 20 7d 3b 20 = { "old", 3 };
a4b0: 20 2f 2a 20 4c 69 74 65 72 61 6c 20 22 6f 6c 64 /* Literal "old
a4c0: 22 20 74 6f 6b 65 6e 20 2a 2f 0a 20 20 20 20 20 " token */.
a4d0: 20 54 6f 6b 65 6e 20 74 4e 65 77 20 3d 20 7b 20 Token tNew = {
a4e0: 22 6e 65 77 22 2c 20 33 20 7d 3b 20 20 2f 2a 20 "new", 3 }; /*
a4f0: 4c 69 74 65 72 61 6c 20 22 6e 65 77 22 20 74 6f Literal "new" to
a500: 6b 65 6e 20 2a 2f 0a 20 20 20 20 20 20 54 6f 6b ken */. Tok
a510: 65 6e 20 74 46 72 6f 6d 43 6f 6c 3b 20 20 20 20 en tFromCol;
a520: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 61 6d 65 /* Name
a530: 20 6f 66 20 63 6f 6c 75 6d 6e 20 69 6e 20 63 68 of column in ch
a540: 69 6c 64 20 74 61 62 6c 65 20 2a 2f 0a 20 20 20 ild table */.
a550: 20 20 20 54 6f 6b 65 6e 20 74 54 6f 43 6f 6c 3b Token tToCol;
a560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
a570: 2a 20 4e 61 6d 65 20 6f 66 20 63 6f 6c 75 6d 6e * Name of column
a580: 20 69 6e 20 70 61 72 65 6e 74 20 74 61 62 6c 65 in parent table
a590: 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 20 69 46 */. int iF
a5a0: 72 6f 6d 43 6f 6c 3b 20 20 20 20 20 20 20 20 20 romCol;
a5b0: 20 20 20 20 20 20 2f 2a 20 49 64 78 20 6f 66 20 /* Idx of
a5c0: 63 6f 6c 75 6d 6e 20 69 6e 20 63 68 69 6c 64 20 column in child
a5d0: 74 61 62 6c 65 20 2a 2f 0a 20 20 20 20 20 20 45 table */. E
a5e0: 78 70 72 20 2a 70 45 71 3b 20 20 20 20 20 20 20 xpr *pEq;
a5f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 74 46 /* tF
a600: 72 6f 6d 43 6f 6c 20 3d 20 4f 4c 44 2e 74 54 6f romCol = OLD.tTo
a610: 43 6f 6c 20 2a 2f 0a 0a 20 20 20 20 20 20 69 46 Col */.. iF
a620: 72 6f 6d 43 6f 6c 20 3d 20 61 69 43 6f 6c 20 3f romCol = aiCol ?
a630: 20 61 69 43 6f 6c 5b 69 5d 20 3a 20 70 46 4b 65 aiCol[i] : pFKe
a640: 79 2d 3e 61 43 6f 6c 5b 30 5d 2e 69 46 72 6f 6d y->aCol[0].iFrom
a650: 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 ;. assert(
a660: 69 46 72 6f 6d 43 6f 6c 3e 3d 30 20 29 3b 0a 20 iFromCol>=0 );.
a670: 20 20 20 20 20 74 54 6f 43 6f 6c 2e 7a 20 3d 20 tToCol.z =
a680: 70 49 64 78 20 3f 20 70 54 61 62 2d 3e 61 43 6f pIdx ? pTab->aCo
a690: 6c 5b 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e l[pIdx->aiColumn
a6a0: 5b 69 5d 5d 2e 7a 4e 61 6d 65 20 3a 20 22 6f 69 [i]].zName : "oi
a6b0: 64 22 3b 0a 20 20 20 20 20 20 74 46 72 6f 6d 43 d";. tFromC
a6c0: 6f 6c 2e 7a 20 3d 20 70 46 4b 65 79 2d 3e 70 46 ol.z = pFKey->pF
a6d0: 72 6f 6d 2d 3e 61 43 6f 6c 5b 69 46 72 6f 6d 43 rom->aCol[iFromC
a6e0: 6f 6c 5d 2e 7a 4e 61 6d 65 3b 0a 0a 20 20 20 20 ol].zName;..
a6f0: 20 20 74 54 6f 43 6f 6c 2e 6e 20 3d 20 73 71 6c tToCol.n = sql
a700: 69 74 65 33 53 74 72 6c 65 6e 33 30 28 74 54 6f ite3Strlen30(tTo
a710: 43 6f 6c 2e 7a 29 3b 0a 20 20 20 20 20 20 74 46 Col.z);. tF
a720: 72 6f 6d 43 6f 6c 2e 6e 20 3d 20 73 71 6c 69 74 romCol.n = sqlit
a730: 65 33 53 74 72 6c 65 6e 33 30 28 74 46 72 6f 6d e3Strlen30(tFrom
a740: 43 6f 6c 2e 7a 29 3b 0a 0a 20 20 20 20 20 20 2f Col.z);.. /
a750: 2a 20 43 72 65 61 74 65 20 74 68 65 20 65 78 70 * Create the exp
a760: 72 65 73 73 69 6f 6e 20 22 4f 4c 44 2e 7a 54 6f ression "OLD.zTo
a770: 43 6f 6c 20 3d 20 7a 46 72 6f 6d 43 6f 6c 22 2e Col = zFromCol".
a780: 20 49 74 20 69 73 20 69 6d 70 6f 72 74 61 6e 74 It is important
a790: 0a 20 20 20 20 20 20 2a 2a 20 74 68 61 74 20 74 . ** that t
a7a0: 68 65 20 22 4f 4c 44 2e 7a 54 6f 43 6f 6c 22 20 he "OLD.zToCol"
a7b0: 74 65 72 6d 20 69 73 20 6f 6e 20 74 68 65 20 4c term is on the L
a7c0: 48 53 20 6f 66 20 74 68 65 20 3d 20 6f 70 65 72 HS of the = oper
a7d0: 61 74 6f 72 2c 20 73 6f 0a 20 20 20 20 20 20 2a ator, so. *
a7e0: 2a 20 74 68 61 74 20 74 68 65 20 61 66 66 69 6e * that the affin
a7f0: 69 74 79 20 61 6e 64 20 63 6f 6c 6c 61 74 69 6f ity and collatio
a800: 6e 20 73 65 71 75 65 6e 63 65 20 61 73 73 6f 63 n sequence assoc
a810: 69 61 74 65 64 20 77 69 74 68 20 74 68 65 0a 20 iated with the.
a820: 20 20 20 20 20 2a 2a 20 70 61 72 65 6e 74 20 74 ** parent t
a830: 61 62 6c 65 20 61 72 65 20 75 73 65 64 20 66 6f able are used fo
a840: 72 20 74 68 65 20 63 6f 6d 70 61 72 69 73 6f 6e r the comparison
a850: 2e 20 2a 2f 0a 20 20 20 20 20 20 70 45 71 20 3d . */. pEq =
a860: 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 50 sqlite3PExpr(pP
a870: 61 72 73 65 2c 20 54 4b 5f 45 51 2c 0a 20 20 20 arse, TK_EQ,.
a880: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 45 sqlite3PE
a890: 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 44 xpr(pParse, TK_D
a8a0: 4f 54 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 OT, .
a8b0: 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 50 sqlite3PExpr(pP
a8c0: 61 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30 2c 20 arse, TK_ID, 0,
a8d0: 30 2c 20 26 74 4f 6c 64 29 2c 0a 20 20 20 20 20 0, &tOld),.
a8e0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 45 sqlite3PE
a8f0: 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 49 xpr(pParse, TK_I
a900: 44 2c 20 30 2c 20 30 2c 20 26 74 54 6f 43 6f 6c D, 0, 0, &tToCol
a910: 29 0a 20 20 20 20 20 20 20 20 20 20 2c 20 30 29 ). , 0)
a920: 2c 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 ,. sqli
a930: 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c te3PExpr(pParse,
a940: 20 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26 74 TK_ID, 0, 0, &t
a950: 46 72 6f 6d 43 6f 6c 29 0a 20 20 20 20 20 20 2c FromCol). ,
a960: 20 30 29 3b 0a 20 20 20 20 20 20 70 57 68 65 72 0);. pWher
a970: 65 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 41 e = sqlite3ExprA
a980: 6e 64 28 64 62 2c 20 70 57 68 65 72 65 2c 20 70 nd(db, pWhere, p
a990: 45 71 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 46 Eq);.. /* F
a9a0: 6f 72 20 4f 4e 20 55 50 44 41 54 45 2c 20 63 6f or ON UPDATE, co
a9b0: 6e 73 74 72 75 63 74 20 74 68 65 20 6e 65 78 74 nstruct the next
a9c0: 20 74 65 72 6d 20 6f 66 20 74 68 65 20 57 48 45 term of the WHE
a9d0: 4e 20 63 6c 61 75 73 65 2e 0a 20 20 20 20 20 20 N clause..
a9e0: 2a 2a 20 54 68 65 20 66 69 6e 61 6c 20 57 48 45 ** The final WHE
a9f0: 4e 20 63 6c 61 75 73 65 20 77 69 6c 6c 20 62 65 N clause will be
aa00: 20 6c 69 6b 65 20 74 68 69 73 3a 0a 20 20 20 20 like this:.
aa10: 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 20 20 **. **
aa20: 20 57 48 45 4e 20 4e 4f 54 28 6f 6c 64 2e 63 6f WHEN NOT(old.co
aa30: 6c 31 20 49 53 20 6e 65 77 2e 63 6f 6c 31 20 41 l1 IS new.col1 A
aa40: 4e 44 20 2e 2e 2e 20 41 4e 44 20 6f 6c 64 2e 63 ND ... AND old.c
aa50: 6f 6c 4e 20 49 53 20 6e 65 77 2e 63 6f 6c 4e 29 olN IS new.colN)
aa60: 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 . */.
aa70: 69 66 28 20 70 43 68 61 6e 67 65 73 20 29 7b 0a if( pChanges ){.
aa80: 20 20 20 20 20 20 20 20 70 45 71 20 3d 20 73 71 pEq = sq
aa90: 6c 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73 lite3PExpr(pPars
aaa0: 65 2c 20 54 4b 5f 49 53 2c 0a 20 20 20 20 20 20 e, TK_IS,.
aab0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 45 78 sqlite3PEx
aac0: 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 44 4f pr(pParse, TK_DO
aad0: 54 2c 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 T, .
aae0: 20 20 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 sqlite3PExpr(p
aaf0: 50 61 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30 2c Parse, TK_ID, 0,
ab00: 20 30 2c 20 26 74 4f 6c 64 29 2c 0a 20 20 20 20 0, &tOld),.
ab10: 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
ab20: 33 50 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 3PExpr(pParse, T
ab30: 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26 74 54 6f K_ID, 0, 0, &tTo
ab40: 43 6f 6c 29 2c 0a 20 20 20 20 20 20 20 20 20 20 Col),.
ab50: 20 20 20 20 30 29 2c 0a 20 20 20 20 20 20 20 20 0),.
ab60: 20 20 20 20 73 71 6c 69 74 65 33 50 45 78 70 72 sqlite3PExpr
ab70: 28 70 50 61 72 73 65 2c 20 54 4b 5f 44 4f 54 2c (pParse, TK_DOT,
ab80: 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
ab90: 73 71 6c 69 74 65 33 50 45 78 70 72 28 70 50 61 sqlite3PExpr(pPa
aba0: 72 73 65 2c 20 54 4b 5f 49 44 2c 20 30 2c 20 30 rse, TK_ID, 0, 0
abb0: 2c 20 26 74 4e 65 77 29 2c 0a 20 20 20 20 20 20 , &tNew),.
abc0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 sqlite3P
abd0: 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f Expr(pParse, TK_
abe0: 49 44 2c 20 30 2c 20 30 2c 20 26 74 54 6f 43 6f ID, 0, 0, &tToCo
abf0: 6c 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 l),.
ac00: 20 20 30 29 2c 0a 20 20 20 20 20 20 20 20 20 20 0),.
ac10: 20 20 30 29 3b 0a 20 20 20 20 20 20 20 20 70 57 0);. pW
ac20: 68 65 6e 20 3d 20 73 71 6c 69 74 65 33 45 78 70 hen = sqlite3Exp
ac30: 72 41 6e 64 28 64 62 2c 20 70 57 68 65 6e 2c 20 rAnd(db, pWhen,
ac40: 70 45 71 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 pEq);. }.
ac50: 0a 20 20 20 20 20 20 69 66 28 20 61 63 74 69 6f . if( actio
ac60: 6e 21 3d 4f 45 5f 52 65 73 74 72 69 63 74 20 26 n!=OE_Restrict &
ac70: 26 20 28 61 63 74 69 6f 6e 21 3d 4f 45 5f 43 61 & (action!=OE_Ca
ac80: 73 63 61 64 65 20 7c 7c 20 70 43 68 61 6e 67 65 scade || pChange
ac90: 73 29 20 29 7b 0a 20 20 20 20 20 20 20 20 45 78 s) ){. Ex
aca0: 70 72 20 2a 70 4e 65 77 3b 0a 20 20 20 20 20 20 pr *pNew;.
acb0: 20 20 69 66 28 20 61 63 74 69 6f 6e 3d 3d 4f 45 if( action==OE
acc0: 5f 43 61 73 63 61 64 65 20 29 7b 0a 20 20 20 20 _Cascade ){.
acd0: 20 20 20 20 20 20 70 4e 65 77 20 3d 20 73 71 6c pNew = sql
ace0: 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 ite3PExpr(pParse
acf0: 2c 20 54 4b 5f 44 4f 54 2c 20 0a 20 20 20 20 20 , TK_DOT, .
ad00: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 50 45 sqlite3PE
ad10: 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f 49 xpr(pParse, TK_I
ad20: 44 2c 20 30 2c 20 30 2c 20 26 74 4e 65 77 29 2c D, 0, 0, &tNew),
ad30: 0a 20 20 20 20 20 20 20 20 20 20 20 20 73 71 6c . sql
ad40: 69 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 ite3PExpr(pParse
ad50: 2c 20 54 4b 5f 49 44 2c 20 30 2c 20 30 2c 20 26 , TK_ID, 0, 0, &
ad60: 74 54 6f 43 6f 6c 29 0a 20 20 20 20 20 20 20 20 tToCol).
ad70: 20 20 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 , 0);.
ad80: 7d 65 6c 73 65 20 69 66 28 20 61 63 74 69 6f 6e }else if( action
ad90: 3d 3d 4f 45 5f 53 65 74 44 66 6c 74 20 29 7b 0a ==OE_SetDflt ){.
ada0: 20 20 20 20 20 20 20 20 20 20 45 78 70 72 20 2a Expr *
adb0: 70 44 66 6c 74 20 3d 20 70 46 4b 65 79 2d 3e 70 pDflt = pFKey->p
adc0: 46 72 6f 6d 2d 3e 61 43 6f 6c 5b 69 46 72 6f 6d From->aCol[iFrom
add0: 43 6f 6c 5d 2e 70 44 66 6c 74 3b 0a 20 20 20 20 Col].pDflt;.
ade0: 20 20 20 20 20 20 69 66 28 20 70 44 66 6c 74 20 if( pDflt
adf0: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 ){. p
ae00: 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 45 78 70 New = sqlite3Exp
ae10: 72 44 75 70 28 64 62 2c 20 70 44 66 6c 74 2c 20 rDup(db, pDflt,
ae20: 30 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 0);. }e
ae30: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 lse{.
ae40: 20 70 4e 65 77 20 3d 20 73 71 6c 69 74 65 33 50 pNew = sqlite3P
ae50: 45 78 70 72 28 70 50 61 72 73 65 2c 20 54 4b 5f Expr(pParse, TK_
ae60: 4e 55 4c 4c 2c 20 30 2c 20 30 2c 20 30 29 3b 0a NULL, 0, 0, 0);.
ae70: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
ae80: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
ae90: 20 20 20 20 20 70 4e 65 77 20 3d 20 73 71 6c 69 pNew = sqli
aea0: 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c te3PExpr(pParse,
aeb0: 20 54 4b 5f 4e 55 4c 4c 2c 20 30 2c 20 30 2c 20 TK_NULL, 0, 0,
aec0: 30 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 0);. }.
aed0: 20 20 20 20 20 20 70 4c 69 73 74 20 3d 20 73 71 pList = sq
aee0: 6c 69 74 65 33 45 78 70 72 4c 69 73 74 41 70 70 lite3ExprListApp
aef0: 65 6e 64 28 70 50 61 72 73 65 2c 20 70 4c 69 73 end(pParse, pLis
af00: 74 2c 20 70 4e 65 77 29 3b 0a 20 20 20 20 20 20 t, pNew);.
af10: 20 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 sqlite3ExprLis
af20: 74 53 65 74 4e 61 6d 65 28 70 50 61 72 73 65 2c tSetName(pParse,
af30: 20 70 4c 69 73 74 2c 20 26 74 46 72 6f 6d 43 6f pList, &tFromCo
af40: 6c 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 l, 0);. }.
af50: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
af60: 44 62 46 72 65 65 28 64 62 2c 20 61 69 43 6f 6c DbFree(db, aiCol
af70: 29 3b 0a 0a 20 20 20 20 7a 46 72 6f 6d 20 3d 20 );.. zFrom =
af80: 70 46 4b 65 79 2d 3e 70 46 72 6f 6d 2d 3e 7a 4e pFKey->pFrom->zN
af90: 61 6d 65 3b 0a 20 20 20 20 6e 46 72 6f 6d 20 3d ame;. nFrom =
afa0: 20 73 71 6c 69 74 65 33 53 74 72 6c 65 6e 33 30 sqlite3Strlen30
afb0: 28 7a 46 72 6f 6d 29 3b 0a 0a 20 20 20 20 69 66 (zFrom);.. if
afc0: 28 20 61 63 74 69 6f 6e 3d 3d 4f 45 5f 52 65 73 ( action==OE_Res
afd0: 74 72 69 63 74 20 29 7b 0a 20 20 20 20 20 20 54 trict ){. T
afe0: 6f 6b 65 6e 20 74 46 72 6f 6d 3b 0a 20 20 20 20 oken tFrom;.
aff0: 20 20 45 78 70 72 20 2a 70 52 61 69 73 65 3b 20 Expr *pRaise;
b000: 0a 0a 20 20 20 20 20 20 74 46 72 6f 6d 2e 7a 20 .. tFrom.z
b010: 3d 20 7a 46 72 6f 6d 3b 0a 20 20 20 20 20 20 74 = zFrom;. t
b020: 46 72 6f 6d 2e 6e 20 3d 20 6e 46 72 6f 6d 3b 0a From.n = nFrom;.
b030: 20 20 20 20 20 20 70 52 61 69 73 65 20 3d 20 73 pRaise = s
b040: 71 6c 69 74 65 33 45 78 70 72 28 64 62 2c 20 54 qlite3Expr(db, T
b050: 4b 5f 52 41 49 53 45 2c 20 22 66 6f 72 65 69 67 K_RAISE, "foreig
b060: 6e 20 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 n key constraint
b070: 20 66 61 69 6c 65 64 22 29 3b 0a 20 20 20 20 20 failed");.
b080: 20 69 66 28 20 70 52 61 69 73 65 20 29 7b 0a 20 if( pRaise ){.
b090: 20 20 20 20 20 20 20 70 52 61 69 73 65 2d 3e 61 pRaise->a
b0a0: 66 66 69 6e 69 74 79 20 3d 20 4f 45 5f 41 62 6f ffinity = OE_Abo
b0b0: 72 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 rt;. }.
b0c0: 20 20 70 53 65 6c 65 63 74 20 3d 20 73 71 6c 69 pSelect = sqli
b0d0: 74 65 33 53 65 6c 65 63 74 4e 65 77 28 70 50 61 te3SelectNew(pPa
b0e0: 72 73 65 2c 20 0a 20 20 20 20 20 20 20 20 20 20 rse, .
b0f0: 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73 74 41 sqlite3ExprListA
b100: 70 70 65 6e 64 28 70 50 61 72 73 65 2c 20 30 2c ppend(pParse, 0,
b110: 20 70 52 61 69 73 65 29 2c 0a 20 20 20 20 20 20 pRaise),.
b120: 20 20 20 20 73 71 6c 69 74 65 33 53 72 63 4c 69 sqlite3SrcLi
b130: 73 74 41 70 70 65 6e 64 28 64 62 2c 20 30 2c 20 stAppend(db, 0,
b140: 26 74 46 72 6f 6d 2c 20 30 29 2c 0a 20 20 20 20 &tFrom, 0),.
b150: 20 20 20 20 20 20 70 57 68 65 72 65 2c 0a 20 20 pWhere,.
b160: 20 20 20 20 20 20 20 20 30 2c 20 30 2c 20 30 2c 0, 0, 0,
b170: 20 30 2c 20 30 2c 20 30 0a 20 20 20 20 20 20 29 0, 0, 0. )
b180: 3b 0a 20 20 20 20 20 20 70 57 68 65 72 65 20 3d ;. pWhere =
b190: 20 30 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 0;. }.. /
b1a0: 2a 20 44 69 73 61 62 6c 65 20 6c 6f 6f 6b 61 73 * Disable lookas
b1b0: 69 64 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 ide memory alloc
b1c0: 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 65 6e 61 ation */. ena
b1d0: 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 20 3d 20 64 bleLookaside = d
b1e0: 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e b->lookaside.bEn
b1f0: 61 62 6c 65 64 3b 0a 20 20 20 20 64 62 2d 3e 6c abled;. db->l
b200: 6f 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 ookaside.bEnable
b210: 64 20 3d 20 30 3b 0a 0a 20 20 20 20 70 54 72 69 d = 0;.. pTri
b220: 67 67 65 72 20 3d 20 28 54 72 69 67 67 65 72 20 gger = (Trigger
b230: 2a 29 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f *)sqlite3DbMallo
b240: 63 5a 65 72 6f 28 64 62 2c 20 0a 20 20 20 20 20 cZero(db, .
b250: 20 20 20 73 69 7a 65 6f 66 28 54 72 69 67 67 65 sizeof(Trigge
b260: 72 29 20 2b 20 20 20 20 20 20 20 20 20 2f 2a 20 r) + /*
b270: 73 74 72 75 63 74 20 54 72 69 67 67 65 72 20 2a struct Trigger *
b280: 2f 0a 20 20 20 20 20 20 20 20 73 69 7a 65 6f 66 /. sizeof
b290: 28 54 72 69 67 67 65 72 53 74 65 70 29 20 2b 20 (TriggerStep) +
b2a0: 20 20 20 20 2f 2a 20 53 69 6e 67 6c 65 20 73 74 /* Single st
b2b0: 65 70 20 69 6e 20 74 72 69 67 67 65 72 20 70 72 ep in trigger pr
b2c0: 6f 67 72 61 6d 20 2a 2f 0a 20 20 20 20 20 20 20 ogram */.
b2d0: 20 6e 46 72 6f 6d 20 2b 20 31 20 20 20 20 20 20 nFrom + 1
b2e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 70 /* Sp
b2f0: 61 63 65 20 66 6f 72 20 70 53 74 65 70 2d 3e 74 ace for pStep->t
b300: 61 72 67 65 74 2e 7a 20 2a 2f 0a 20 20 20 20 29 arget.z */. )
b310: 3b 0a 20 20 20 20 69 66 28 20 70 54 72 69 67 67 ;. if( pTrigg
b320: 65 72 20 29 7b 0a 20 20 20 20 20 20 70 53 74 65 er ){. pSte
b330: 70 20 3d 20 70 54 72 69 67 67 65 72 2d 3e 73 74 p = pTrigger->st
b340: 65 70 5f 6c 69 73 74 20 3d 20 28 54 72 69 67 67 ep_list = (Trigg
b350: 65 72 53 74 65 70 20 2a 29 26 70 54 72 69 67 67 erStep *)&pTrigg
b360: 65 72 5b 31 5d 3b 0a 20 20 20 20 20 20 70 53 74 er[1];. pSt
b370: 65 70 2d 3e 74 61 72 67 65 74 2e 7a 20 3d 20 28 ep->target.z = (
b380: 63 68 61 72 20 2a 29 26 70 53 74 65 70 5b 31 5d char *)&pStep[1]
b390: 3b 0a 20 20 20 20 20 20 70 53 74 65 70 2d 3e 74 ;. pStep->t
b3a0: 61 72 67 65 74 2e 6e 20 3d 20 6e 46 72 6f 6d 3b arget.n = nFrom;
b3b0: 0a 20 20 20 20 20 20 6d 65 6d 63 70 79 28 28 63 . memcpy((c
b3c0: 68 61 72 20 2a 29 70 53 74 65 70 2d 3e 74 61 72 har *)pStep->tar
b3d0: 67 65 74 2e 7a 2c 20 7a 46 72 6f 6d 2c 20 6e 46 get.z, zFrom, nF
b3e0: 72 6f 6d 29 3b 0a 20 20 0a 20 20 20 20 20 20 70 rom);. . p
b3f0: 53 74 65 70 2d 3e 70 57 68 65 72 65 20 3d 20 73 Step->pWhere = s
b400: 71 6c 69 74 65 33 45 78 70 72 44 75 70 28 64 62 qlite3ExprDup(db
b410: 2c 20 70 57 68 65 72 65 2c 20 45 58 50 52 44 55 , pWhere, EXPRDU
b420: 50 5f 52 45 44 55 43 45 29 3b 0a 20 20 20 20 20 P_REDUCE);.
b430: 20 70 53 74 65 70 2d 3e 70 45 78 70 72 4c 69 73 pStep->pExprLis
b440: 74 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 4c t = sqlite3ExprL
b450: 69 73 74 44 75 70 28 64 62 2c 20 70 4c 69 73 74 istDup(db, pList
b460: 2c 20 45 58 50 52 44 55 50 5f 52 45 44 55 43 45 , EXPRDUP_REDUCE
b470: 29 3b 0a 20 20 20 20 20 20 70 53 74 65 70 2d 3e );. pStep->
b480: 70 53 65 6c 65 63 74 20 3d 20 73 71 6c 69 74 65 pSelect = sqlite
b490: 33 53 65 6c 65 63 74 44 75 70 28 64 62 2c 20 70 3SelectDup(db, p
b4a0: 53 65 6c 65 63 74 2c 20 45 58 50 52 44 55 50 5f Select, EXPRDUP_
b4b0: 52 45 44 55 43 45 29 3b 0a 20 20 20 20 20 20 69 REDUCE);. i
b4c0: 66 28 20 70 57 68 65 6e 20 29 7b 0a 20 20 20 20 f( pWhen ){.
b4d0: 20 20 20 20 70 57 68 65 6e 20 3d 20 73 71 6c 69 pWhen = sqli
b4e0: 74 65 33 50 45 78 70 72 28 70 50 61 72 73 65 2c te3PExpr(pParse,
b4f0: 20 54 4b 5f 4e 4f 54 2c 20 70 57 68 65 6e 2c 20 TK_NOT, pWhen,
b500: 30 2c 20 30 29 3b 0a 20 20 20 20 20 20 20 20 70 0, 0);. p
b510: 54 72 69 67 67 65 72 2d 3e 70 57 68 65 6e 20 3d Trigger->pWhen =
b520: 20 73 71 6c 69 74 65 33 45 78 70 72 44 75 70 28 sqlite3ExprDup(
b530: 64 62 2c 20 70 57 68 65 6e 2c 20 45 58 50 52 44 db, pWhen, EXPRD
b540: 55 50 5f 52 45 44 55 43 45 29 3b 0a 20 20 20 20 UP_REDUCE);.
b550: 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f }. }.. /
b560: 2a 20 52 65 2d 65 6e 61 62 6c 65 20 74 68 65 20 * Re-enable the
b570: 6c 6f 6f 6b 61 73 69 64 65 20 62 75 66 66 65 72 lookaside buffer
b580: 2c 20 69 66 20 69 74 20 77 61 73 20 64 69 73 61 , if it was disa
b590: 62 6c 65 64 20 65 61 72 6c 69 65 72 2e 20 2a 2f bled earlier. */
b5a0: 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 . db->lookasi
b5b0: 64 65 2e 62 45 6e 61 62 6c 65 64 20 3d 20 65 6e de.bEnabled = en
b5c0: 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 3b 0a 0a ableLookaside;..
b5d0: 20 20 20 20 73 71 6c 69 74 65 33 45 78 70 72 44 sqlite3ExprD
b5e0: 65 6c 65 74 65 28 64 62 2c 20 70 57 68 65 72 65 elete(db, pWhere
b5f0: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 78 );. sqlite3Ex
b600: 70 72 44 65 6c 65 74 65 28 64 62 2c 20 70 57 68 prDelete(db, pWh
b610: 65 6e 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 en);. sqlite3
b620: 45 78 70 72 4c 69 73 74 44 65 6c 65 74 65 28 64 ExprListDelete(d
b630: 62 2c 20 70 4c 69 73 74 29 3b 0a 20 20 20 20 73 b, pList);. s
b640: 71 6c 69 74 65 33 53 65 6c 65 63 74 44 65 6c 65 qlite3SelectDele
b650: 74 65 28 64 62 2c 20 70 53 65 6c 65 63 74 29 3b te(db, pSelect);
b660: 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c . if( db->mal
b670: 6c 6f 63 46 61 69 6c 65 64 3d 3d 31 20 29 7b 0a locFailed==1 ){.
b680: 20 20 20 20 20 20 66 6b 54 72 69 67 67 65 72 44 fkTriggerD
b690: 65 6c 65 74 65 28 64 62 2c 20 70 54 72 69 67 67 elete(db, pTrigg
b6a0: 65 72 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72 er);. retur
b6b0: 6e 20 30 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 n 0;. }. a
b6c0: 73 73 65 72 74 28 20 70 53 74 65 70 21 3d 30 20 ssert( pStep!=0
b6d0: 29 3b 0a 0a 20 20 20 20 73 77 69 74 63 68 28 20 );.. switch(
b6e0: 61 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20 action ){.
b6f0: 63 61 73 65 20 4f 45 5f 52 65 73 74 72 69 63 74 case OE_Restrict
b700: 3a 0a 20 20 20 20 20 20 20 20 70 53 74 65 70 2d :. pStep-
b710: 3e 6f 70 20 3d 20 54 4b 5f 53 45 4c 45 43 54 3b >op = TK_SELECT;
b720: 20 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b . break;
b730: 0a 20 20 20 20 20 20 63 61 73 65 20 4f 45 5f 43 . case OE_C
b740: 61 73 63 61 64 65 3a 20 0a 20 20 20 20 20 20 20 ascade: .
b750: 20 69 66 28 20 21 70 43 68 61 6e 67 65 73 20 29 if( !pChanges )
b760: 7b 20 0a 20 20 20 20 20 20 20 20 20 20 70 53 74 { . pSt
b770: 65 70 2d 3e 6f 70 20 3d 20 54 4b 5f 44 45 4c 45 ep->op = TK_DELE
b780: 54 45 3b 20 0a 20 20 20 20 20 20 20 20 20 20 62 TE; . b
b790: 72 65 61 6b 3b 20 0a 20 20 20 20 20 20 20 20 7d reak; . }
b7a0: 0a 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a 0a . default:.
b7b0: 20 20 20 20 20 20 20 20 70 53 74 65 70 2d 3e 6f pStep->o
b7c0: 70 20 3d 20 54 4b 5f 55 50 44 41 54 45 3b 0a 20 p = TK_UPDATE;.
b7d0: 20 20 20 7d 0a 20 20 20 20 70 53 74 65 70 2d 3e }. pStep->
b7e0: 70 54 72 69 67 20 3d 20 70 54 72 69 67 67 65 72 pTrig = pTrigger
b7f0: 3b 0a 20 20 20 20 70 54 72 69 67 67 65 72 2d 3e ;. pTrigger->
b800: 70 53 63 68 65 6d 61 20 3d 20 70 54 61 62 2d 3e pSchema = pTab->
b810: 70 53 63 68 65 6d 61 3b 0a 20 20 20 20 70 54 72 pSchema;. pTr
b820: 69 67 67 65 72 2d 3e 70 54 61 62 53 63 68 65 6d igger->pTabSchem
b830: 61 20 3d 20 70 54 61 62 2d 3e 70 53 63 68 65 6d a = pTab->pSchem
b840: 61 3b 0a 20 20 20 20 70 46 4b 65 79 2d 3e 61 70 a;. pFKey->ap
b850: 54 72 69 67 67 65 72 5b 69 41 63 74 69 6f 6e 5d Trigger[iAction]
b860: 20 3d 20 70 54 72 69 67 67 65 72 3b 0a 20 20 20 = pTrigger;.
b870: 20 70 54 72 69 67 67 65 72 2d 3e 6f 70 20 3d 20 pTrigger->op =
b880: 28 70 43 68 61 6e 67 65 73 20 3f 20 54 4b 5f 55 (pChanges ? TK_U
b890: 50 44 41 54 45 20 3a 20 54 4b 5f 44 45 4c 45 54 PDATE : TK_DELET
b8a0: 45 29 3b 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 E);. }.. retur
b8b0: 6e 20 70 54 72 69 67 67 65 72 3b 0a 7d 0a 0a 2f n pTrigger;.}../
b8c0: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 *.** This functi
b8d0: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 77 68 65 on is called whe
b8e0: 6e 20 64 65 6c 65 74 69 6e 67 20 6f 72 20 75 70 n deleting or up
b8f0: 64 61 74 69 6e 67 20 61 20 72 6f 77 20 74 6f 20 dating a row to
b900: 69 6d 70 6c 65 6d 65 6e 74 0a 2a 2a 20 61 6e 79 implement.** any
b910: 20 72 65 71 75 69 72 65 64 20 43 41 53 43 41 44 required CASCAD
b920: 45 2c 20 53 45 54 20 4e 55 4c 4c 20 6f 72 20 53 E, SET NULL or S
b930: 45 54 20 44 45 46 41 55 4c 54 20 61 63 74 69 6f ET DEFAULT actio
b940: 6e 73 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 ns..*/.void sqli
b950: 74 65 33 46 6b 41 63 74 69 6f 6e 73 28 0a 20 20 te3FkActions(.
b960: 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 20 Parse *pParse,
b970: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
b980: 2f 2a 20 50 61 72 73 65 20 63 6f 6e 74 65 78 74 /* Parse context
b990: 20 2a 2f 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 */. Table *pTa
b9a0: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b,
b9b0: 20 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 62 /* Table b
b9c0: 65 69 6e 67 20 75 70 64 61 74 65 64 20 6f 72 20 eing updated or
b9d0: 64 65 6c 65 74 65 64 20 66 72 6f 6d 20 2a 2f 0a deleted from */.
b9e0: 20 20 45 78 70 72 4c 69 73 74 20 2a 70 43 68 61 ExprList *pCha
b9f0: 6e 67 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 nges,
ba00: 20 20 2f 2a 20 43 68 61 6e 67 65 2d 6c 69 73 74 /* Change-list
ba10: 20 66 6f 72 20 55 50 44 41 54 45 2c 20 4e 55 4c for UPDATE, NUL
ba20: 4c 20 66 6f 72 20 44 45 4c 45 54 45 20 2a 2f 0a L for DELETE */.
ba30: 20 20 69 6e 74 20 72 65 67 4f 6c 64 20 20 20 20 int regOld
ba40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ba50: 20 20 2f 2a 20 41 64 64 72 65 73 73 20 6f 66 20 /* Address of
ba60: 61 72 72 61 79 20 63 6f 6e 74 61 69 6e 69 6e 67 array containing
ba70: 20 6f 6c 64 20 72 6f 77 20 2a 2f 0a 29 7b 0a 20 old row */.){.
ba80: 20 2f 2a 20 49 66 20 66 6f 72 65 69 67 6e 2d 6b /* If foreign-k
ba90: 65 79 20 73 75 70 70 6f 72 74 20 69 73 20 65 6e ey support is en
baa0: 61 62 6c 65 64 2c 20 69 74 65 72 61 74 65 20 74 abled, iterate t
bab0: 68 72 6f 75 67 68 20 61 6c 6c 20 46 4b 73 20 74 hrough all FKs t
bac0: 68 61 74 20 0a 20 20 2a 2a 20 72 65 66 65 72 20 hat . ** refer
bad0: 74 6f 20 74 61 62 6c 65 20 70 54 61 62 2e 20 49 to table pTab. I
bae0: 66 20 74 68 65 72 65 20 69 73 20 61 6e 20 61 63 f there is an ac
baf0: 74 69 6f 6e 20 61 73 73 6f 63 69 61 74 65 64 20 tion associated
bb00: 77 69 74 68 20 74 68 65 20 46 4b 20 0a 20 20 2a with the FK . *
bb10: 2a 20 66 6f 72 20 74 68 69 73 20 6f 70 65 72 61 * for this opera
bb20: 74 69 6f 6e 20 28 65 69 74 68 65 72 20 75 70 64 tion (either upd
bb30: 61 74 65 20 6f 72 20 64 65 6c 65 74 65 29 2c 20 ate or delete),
bb40: 69 6e 76 6f 6b 65 20 74 68 65 20 61 73 73 6f 63 invoke the assoc
bb50: 69 61 74 65 64 20 0a 20 20 2a 2a 20 74 72 69 67 iated . ** trig
bb60: 67 65 72 20 73 75 62 2d 70 72 6f 67 72 61 6d 2e ger sub-program.
bb70: 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 72 73 */. if( pPars
bb80: 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c e->db->flags&SQL
bb90: 49 54 45 5f 46 6f 72 65 69 67 6e 4b 65 79 73 20 ITE_ForeignKeys
bba0: 29 7b 0a 20 20 20 20 46 4b 65 79 20 2a 70 46 4b ){. FKey *pFK
bbb0: 65 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 ey;
bbc0: 20 20 20 20 20 2f 2a 20 49 74 65 72 61 74 6f 72 /* Iterator
bbd0: 20 76 61 72 69 61 62 6c 65 20 2a 2f 0a 20 20 20 variable */.
bbe0: 20 66 6f 72 28 70 46 4b 65 79 20 3d 20 73 71 6c for(pFKey = sql
bbf0: 69 74 65 33 46 6b 52 65 66 65 72 65 6e 63 65 73 ite3FkReferences
bc00: 28 70 54 61 62 29 3b 20 70 46 4b 65 79 3b 20 70 (pTab); pFKey; p
bc10: 46 4b 65 79 3d 70 46 4b 65 79 2d 3e 70 4e 65 78 FKey=pFKey->pNex
bc20: 74 54 6f 29 7b 0a 20 20 20 20 20 20 54 72 69 67 tTo){. Trig
bc30: 67 65 72 20 2a 70 41 63 74 69 6f 6e 20 3d 20 66 ger *pAction = f
bc40: 6b 41 63 74 69 6f 6e 54 72 69 67 67 65 72 28 70 kActionTrigger(p
bc50: 50 61 72 73 65 2c 20 70 54 61 62 2c 20 70 46 4b Parse, pTab, pFK
bc60: 65 79 2c 20 70 43 68 61 6e 67 65 73 29 3b 0a 20 ey, pChanges);.
bc70: 20 20 20 20 20 69 66 28 20 70 41 63 74 69 6f 6e if( pAction
bc80: 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 ){. sqli
bc90: 74 65 33 43 6f 64 65 52 6f 77 54 72 69 67 67 65 te3CodeRowTrigge
bca0: 72 44 69 72 65 63 74 28 70 50 61 72 73 65 2c 20 rDirect(pParse,
bcb0: 70 41 63 74 69 6f 6e 2c 20 70 54 61 62 2c 20 72 pAction, pTab, r
bcc0: 65 67 4f 6c 64 2c 20 4f 45 5f 41 62 6f 72 74 2c egOld, OE_Abort,
bcd0: 20 30 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 0);. }.
bce0: 20 7d 0a 20 20 7d 0a 7d 0a 0a 23 65 6e 64 69 66 }. }.}..#endif
bcf0: 20 2f 2a 20 69 66 6e 64 65 66 20 53 51 4c 49 54 /* ifndef SQLIT
bd00: 45 5f 4f 4d 49 54 5f 54 52 49 47 47 45 52 20 2a E_OMIT_TRIGGER *
bd10: 2f 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6c /../*.** Free al
bd20: 6c 20 6d 65 6d 6f 72 79 20 61 73 73 6f 63 69 61 l memory associa
bd30: 74 65 64 20 77 69 74 68 20 66 6f 72 65 69 67 6e ted with foreign
bd40: 20 6b 65 79 20 64 65 66 69 6e 69 74 69 6f 6e 73 key definitions
bd50: 20 61 74 74 61 63 68 65 64 20 74 6f 0a 2a 2a 20 attached to.**
bd60: 74 61 62 6c 65 20 70 54 61 62 2e 20 52 65 6d 6f table pTab. Remo
bd70: 76 65 20 74 68 65 20 64 65 6c 65 74 65 64 20 66 ve the deleted f
bd80: 6f 72 65 69 67 6e 20 6b 65 79 73 20 66 72 6f 6d oreign keys from
bd90: 20 74 68 65 20 53 63 68 65 6d 61 2e 66 6b 65 79 the Schema.fkey
bda0: 48 61 73 68 0a 2a 2a 20 68 61 73 68 20 74 61 62 Hash.** hash tab
bdb0: 6c 65 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 le..*/.void sqli
bdc0: 74 65 33 46 6b 44 65 6c 65 74 65 28 73 71 6c 69 te3FkDelete(sqli
bdd0: 74 65 33 20 2a 64 62 2c 20 54 61 62 6c 65 20 2a te3 *db, Table *
bde0: 70 54 61 62 29 7b 0a 20 20 46 4b 65 79 20 2a 70 pTab){. FKey *p
bdf0: 46 4b 65 79 3b 20 20 20 20 20 20 20 20 20 20 20 FKey;
be00: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 74 65 72 /* Iter
be10: 61 74 6f 72 20 76 61 72 69 61 62 6c 65 20 2a 2f ator variable */
be20: 0a 20 20 46 4b 65 79 20 2a 70 4e 65 78 74 3b 20 . FKey *pNext;
be30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
be40: 20 20 20 2f 2a 20 43 6f 70 79 20 6f 66 20 70 46 /* Copy of pF
be50: 4b 65 79 2d 3e 70 4e 65 78 74 46 72 6f 6d 20 2a Key->pNextFrom *
be60: 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 64 62 3d /.. assert( db=
be70: 3d 30 20 7c 7c 20 73 71 6c 69 74 65 33 53 63 68 =0 || sqlite3Sch
be80: 65 6d 61 4d 75 74 65 78 48 65 6c 64 28 64 62 2c emaMutexHeld(db,
be90: 20 30 2c 20 70 54 61 62 2d 3e 70 53 63 68 65 6d 0, pTab->pSchem
bea0: 61 29 20 29 3b 0a 20 20 66 6f 72 28 70 46 4b 65 a) );. for(pFKe
beb0: 79 3d 70 54 61 62 2d 3e 70 46 4b 65 79 3b 20 70 y=pTab->pFKey; p
bec0: 46 4b 65 79 3b 20 70 46 4b 65 79 3d 70 4e 65 78 FKey; pFKey=pNex
bed0: 74 29 7b 0a 0a 20 20 20 20 2f 2a 20 52 65 6d 6f t){.. /* Remo
bee0: 76 65 20 74 68 65 20 46 4b 20 66 72 6f 6d 20 74 ve the FK from t
bef0: 68 65 20 66 6b 65 79 48 61 73 68 20 68 61 73 68 he fkeyHash hash
bf00: 20 74 61 62 6c 65 2e 20 2a 2f 0a 20 20 20 20 69 table. */. i
bf10: 66 28 20 21 64 62 20 7c 7c 20 64 62 2d 3e 70 6e f( !db || db->pn
bf20: 42 79 74 65 73 46 72 65 65 64 3d 3d 30 20 29 7b BytesFreed==0 ){
bf30: 0a 20 20 20 20 20 20 69 66 28 20 70 46 4b 65 79 . if( pFKey
bf40: 2d 3e 70 50 72 65 76 54 6f 20 29 7b 0a 20 20 20 ->pPrevTo ){.
bf50: 20 20 20 20 20 70 46 4b 65 79 2d 3e 70 50 72 65 pFKey->pPre
bf60: 76 54 6f 2d 3e 70 4e 65 78 74 54 6f 20 3d 20 70 vTo->pNextTo = p
bf70: 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f 3b 0a 20 FKey->pNextTo;.
bf80: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
bf90: 20 20 20 20 76 6f 69 64 20 2a 70 20 3d 20 28 76 void *p = (v
bfa0: 6f 69 64 20 2a 29 70 46 4b 65 79 2d 3e 70 4e 65 oid *)pFKey->pNe
bfb0: 78 74 54 6f 3b 0a 20 20 20 20 20 20 20 20 63 6f xtTo;. co
bfc0: 6e 73 74 20 63 68 61 72 20 2a 7a 20 3d 20 28 70 nst char *z = (p
bfd0: 20 3f 20 70 46 4b 65 79 2d 3e 70 4e 65 78 74 54 ? pFKey->pNextT
bfe0: 6f 2d 3e 7a 54 6f 20 3a 20 70 46 4b 65 79 2d 3e o->zTo : pFKey->
bff0: 7a 54 6f 29 3b 0a 20 20 20 20 20 20 20 20 73 71 zTo);. sq
c000: 6c 69 74 65 33 48 61 73 68 49 6e 73 65 72 74 28 lite3HashInsert(
c010: 26 70 54 61 62 2d 3e 70 53 63 68 65 6d 61 2d 3e &pTab->pSchema->
c020: 66 6b 65 79 48 61 73 68 2c 20 7a 2c 20 73 71 6c fkeyHash, z, sql
c030: 69 74 65 33 53 74 72 6c 65 6e 33 30 28 7a 29 2c ite3Strlen30(z),
c040: 20 70 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 p);. }.
c050: 20 20 20 69 66 28 20 70 46 4b 65 79 2d 3e 70 4e if( pFKey->pN
c060: 65 78 74 54 6f 20 29 7b 0a 20 20 20 20 20 20 20 extTo ){.
c070: 20 70 46 4b 65 79 2d 3e 70 4e 65 78 74 54 6f 2d pFKey->pNextTo-
c080: 3e 70 50 72 65 76 54 6f 20 3d 20 70 46 4b 65 79 >pPrevTo = pFKey
c090: 2d 3e 70 50 72 65 76 54 6f 3b 0a 20 20 20 20 20 ->pPrevTo;.
c0a0: 20 7d 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a }. }.. /*
c0b0: 20 45 56 3a 20 52 2d 33 30 33 32 33 2d 32 31 39 EV: R-30323-219
c0c0: 31 37 20 45 61 63 68 20 66 6f 72 65 69 67 6e 20 17 Each foreign
c0d0: 6b 65 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 69 key constraint i
c0e0: 6e 20 53 51 4c 69 74 65 20 69 73 0a 20 20 20 20 n SQLite is.
c0f0: 2a 2a 20 63 6c 61 73 73 69 66 69 65 64 20 61 73 ** classified as
c100: 20 65 69 74 68 65 72 20 69 6d 6d 65 64 69 61 74 either immediat
c110: 65 20 6f 72 20 64 65 66 65 72 72 65 64 2e 0a 20 e or deferred..
c120: 20 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 */. assert
c130: 28 20 70 46 4b 65 79 2d 3e 69 73 44 65 66 65 72 ( pFKey->isDefer
c140: 72 65 64 3d 3d 30 20 7c 7c 20 70 46 4b 65 79 2d red==0 || pFKey-
c150: 3e 69 73 44 65 66 65 72 72 65 64 3d 3d 31 20 29 >isDeferred==1 )
c160: 3b 0a 0a 20 20 20 20 2f 2a 20 44 65 6c 65 74 65 ;.. /* Delete
c170: 20 61 6e 79 20 74 72 69 67 67 65 72 73 20 63 72 any triggers cr
c180: 65 61 74 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 eated to impleme
c190: 6e 74 20 61 63 74 69 6f 6e 73 20 66 6f 72 20 74 nt actions for t
c1a0: 68 69 73 20 46 4b 2e 20 2a 2f 0a 23 69 66 6e 64 his FK. */.#ifnd
c1b0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 ef SQLITE_OMIT_T
c1c0: 52 49 47 47 45 52 0a 20 20 20 20 66 6b 54 72 69 RIGGER. fkTri
c1d0: 67 67 65 72 44 65 6c 65 74 65 28 64 62 2c 20 70 ggerDelete(db, p
c1e0: 46 4b 65 79 2d 3e 61 70 54 72 69 67 67 65 72 5b FKey->apTrigger[
c1f0: 30 5d 29 3b 0a 20 20 20 20 66 6b 54 72 69 67 67 0]);. fkTrigg
c200: 65 72 44 65 6c 65 74 65 28 64 62 2c 20 70 46 4b erDelete(db, pFK
c210: 65 79 2d 3e 61 70 54 72 69 67 67 65 72 5b 31 5d ey->apTrigger[1]
c220: 29 3b 0a 23 65 6e 64 69 66 0a 0a 20 20 20 20 70 );.#endif.. p
c230: 4e 65 78 74 20 3d 20 70 46 4b 65 79 2d 3e 70 4e Next = pFKey->pN
c240: 65 78 74 46 72 6f 6d 3b 0a 20 20 20 20 73 71 6c extFrom;. sql
c250: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 ite3DbFree(db, p
c260: 46 4b 65 79 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6e FKey);. }.}.#en
c270: 64 69 66 20 2f 2a 20 69 66 6e 64 65 66 20 53 51 dif /* ifndef SQ
c280: 4c 49 54 45 5f 4f 4d 49 54 5f 46 4f 52 45 49 47 LITE_OMIT_FOREIG
c290: 4e 5f 4b 45 59 20 2a 2f 0a N_KEY */.