0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68 mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..**
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..**
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.***
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 54 68 69 73 20 6d ******.** This m
0180: 6f 64 75 6c 65 20 63 6f 6e 74 61 69 6e 73 20 43 odule contains C
0190: 20 63 6f 64 65 20 74 68 61 74 20 67 65 6e 65 72 code that gener
01a0: 61 74 65 73 20 56 44 42 45 20 63 6f 64 65 20 75 ates VDBE code u
01b0: 73 65 64 20 74 6f 20 70 72 6f 63 65 73 73 0a 2a sed to process.*
01c0: 2a 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 * the WHERE clau
01d0: 73 65 20 6f 66 20 53 51 4c 20 73 74 61 74 65 6d se of SQL statem
01e0: 65 6e 74 73 2e 20 20 54 68 69 73 20 6d 6f 64 75 ents. This modu
01f0: 6c 65 20 69 73 20 72 65 73 70 6f 6e 73 69 62 6c le is responsibl
0200: 65 20 66 6f 72 0a 2a 2a 20 67 65 6e 65 72 61 74 e for.** generat
0210: 69 6e 67 20 74 68 65 20 63 6f 64 65 20 74 68 61 ing the code tha
0220: 74 20 6c 6f 6f 70 73 20 74 68 72 6f 75 67 68 20 t loops through
0230: 61 20 74 61 62 6c 65 20 6c 6f 6f 6b 69 6e 67 20 a table looking
0240: 66 6f 72 20 61 70 70 6c 69 63 61 62 6c 65 0a 2a for applicable.*
0250: 2a 20 72 6f 77 73 2e 20 20 49 6e 64 69 63 65 73 * rows. Indices
0260: 20 61 72 65 20 73 65 6c 65 63 74 65 64 20 61 6e are selected an
0270: 64 20 75 73 65 64 20 74 6f 20 73 70 65 65 64 20 d used to speed
0280: 74 68 65 20 73 65 61 72 63 68 20 77 68 65 6e 20 the search when
0290: 64 6f 69 6e 67 0a 2a 2a 20 73 6f 20 69 73 20 61 doing.** so is a
02a0: 70 70 6c 69 63 61 62 6c 65 2e 20 20 42 65 63 61 pplicable. Beca
02b0: 75 73 65 20 74 68 69 73 20 6d 6f 64 75 6c 65 20 use this module
02c0: 69 73 20 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 is responsible f
02d0: 6f 72 20 73 65 6c 65 63 74 69 6e 67 0a 2a 2a 20 or selecting.**
02e0: 69 6e 64 69 63 65 73 2c 20 79 6f 75 20 6d 69 67 indices, you mig
02f0: 68 74 20 61 6c 73 6f 20 74 68 69 6e 6b 20 6f 66 ht also think of
0300: 20 74 68 69 73 20 6d 6f 64 75 6c 65 20 61 73 20 this module as
0310: 74 68 65 20 22 71 75 65 72 79 20 6f 70 74 69 6d the "query optim
0320: 69 7a 65 72 22 2e 0a 2a 2f 0a 23 69 6e 63 6c 75 izer"..*/.#inclu
0330: 64 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 de "sqliteInt.h"
0340: 0a 23 69 6e 63 6c 75 64 65 20 22 77 68 65 72 65 .#include "where
0350: 49 6e 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 45 78 Int.h"../*.** Ex
0360: 74 72 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 tra information
0370: 61 70 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20 appended to the
0380: 65 6e 64 20 6f 66 20 73 71 6c 69 74 65 33 5f 69 end of sqlite3_i
0390: 6e 64 65 78 5f 69 6e 66 6f 20 62 75 74 20 6e 6f ndex_info but no
03a0: 74 0a 2a 2a 20 76 69 73 69 62 6c 65 20 74 6f 20 t.** visible to
03b0: 74 68 65 20 78 42 65 73 74 49 6e 64 65 78 20 66 the xBestIndex f
03c0: 75 6e 63 74 69 6f 6e 2c 20 61 74 20 6c 65 61 73 unction, at leas
03d0: 74 20 6e 6f 74 20 64 69 72 65 63 74 6c 79 2e 20 t not directly.
03e0: 20 54 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33 5f The.** sqlite3_
03f0: 76 74 61 62 5f 63 6f 6c 6c 61 74 69 6f 6e 28 29 vtab_collation()
0400: 20 69 6e 74 65 72 66 61 63 65 20 6b 6e 6f 77 73 interface knows
0410: 20 68 6f 77 20 74 6f 20 72 65 61 63 68 20 69 74 how to reach it
0420: 2c 20 68 6f 77 65 76 65 72 2e 0a 2a 2a 0a 2a 2a , however..**.**
0430: 20 54 68 69 73 20 6f 62 6a 65 63 74 20 69 73 20 This object is
0440: 6e 6f 74 20 61 6e 20 41 50 49 20 61 6e 64 20 63 not an API and c
0450: 61 6e 20 62 65 20 63 68 61 6e 67 65 64 20 66 72 an be changed fr
0460: 6f 6d 20 6f 6e 65 20 72 65 6c 65 61 73 65 20 74 om one release t
0470: 6f 20 74 68 65 0a 2a 2a 20 6e 65 78 74 2e 20 20 o the.** next.
0480: 41 73 20 6c 6f 6e 67 20 61 73 20 61 6c 6c 6f 63 As long as alloc
0490: 61 74 65 49 6e 64 65 78 49 6e 66 6f 28 29 20 61 ateIndexInfo() a
04a0: 6e 64 20 73 71 6c 69 74 65 33 5f 76 74 61 62 5f nd sqlite3_vtab_
04b0: 63 6f 6c 6c 61 74 69 6f 6e 28 29 0a 2a 2a 20 61 collation().** a
04c0: 67 72 65 65 20 6f 6e 20 74 68 65 20 73 74 72 75 gree on the stru
04d0: 63 74 75 72 65 2c 20 61 6c 6c 20 77 69 6c 6c 20 cture, all will
04e0: 62 65 20 77 65 6c 6c 2e 0a 2a 2f 0a 74 79 70 65 be well..*/.type
04f0: 64 65 66 20 73 74 72 75 63 74 20 48 69 64 64 65 def struct Hidde
0500: 6e 49 6e 64 65 78 49 6e 66 6f 20 48 69 64 64 65 nIndexInfo Hidde
0510: 6e 49 6e 64 65 78 49 6e 66 6f 3b 0a 73 74 72 75 nIndexInfo;.stru
0520: 63 74 20 48 69 64 64 65 6e 49 6e 64 65 78 49 6e ct HiddenIndexIn
0530: 66 6f 20 7b 0a 20 20 57 68 65 72 65 43 6c 61 75 fo {. WhereClau
0540: 73 65 20 2a 70 57 43 3b 20 20 20 2f 2a 20 54 68 se *pWC; /* Th
0550: 65 20 57 68 65 72 65 20 63 6c 61 75 73 65 20 62 e Where clause b
0560: 65 69 6e 67 20 61 6e 61 6c 79 7a 65 64 20 2a 2f eing analyzed */
0570: 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 . Parse *pParse
0580: 3b 20 20 20 20 20 20 2f 2a 20 54 68 65 20 70 61 ; /* The pa
0590: 72 73 69 6e 67 20 63 6f 6e 74 65 78 74 20 2a 2f rsing context */
05a0: 0a 7d 3b 0a 0a 2f 2a 20 46 6f 72 77 61 72 64 20 .};../* Forward
05b0: 64 65 63 6c 61 72 61 74 69 6f 6e 20 6f 66 20 6d declaration of m
05c0: 65 74 68 6f 64 73 20 2a 2f 0a 73 74 61 74 69 63 ethods */.static
05d0: 20 69 6e 74 20 77 68 65 72 65 4c 6f 6f 70 52 65 int whereLoopRe
05e0: 73 69 7a 65 28 73 71 6c 69 74 65 33 2a 2c 20 57 size(sqlite3*, W
05f0: 68 65 72 65 4c 6f 6f 70 2a 2c 20 69 6e 74 29 3b hereLoop*, int);
0600: 0a 0a 2f 2a 20 54 65 73 74 20 76 61 72 69 61 62 ../* Test variab
0610: 6c 65 20 74 68 61 74 20 63 61 6e 20 62 65 20 73 le that can be s
0620: 65 74 20 74 6f 20 65 6e 61 62 6c 65 20 57 48 45 et to enable WHE
0630: 52 45 20 74 72 61 63 69 6e 67 20 2a 2f 0a 23 69 RE tracing */.#i
0640: 66 20 64 65 66 69 6e 65 64 28 53 51 4c 49 54 45 f defined(SQLITE
0650: 5f 54 45 53 54 29 20 7c 7c 20 64 65 66 69 6e 65 _TEST) || define
0660: 64 28 53 51 4c 49 54 45 5f 44 45 42 55 47 29 0a d(SQLITE_DEBUG).
0670: 2f 2a 2a 2a 2f 20 69 6e 74 20 73 71 6c 69 74 65 /***/ int sqlite
0680: 33 57 68 65 72 65 54 72 61 63 65 20 3d 20 30 3b 3WhereTrace = 0;
0690: 0a 23 65 6e 64 69 66 0a 0a 0a 2f 2a 0a 2a 2a 20 .#endif.../*.**
06a0: 52 65 74 75 72 6e 20 74 68 65 20 65 73 74 69 6d Return the estim
06b0: 61 74 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6f ated number of o
06c0: 75 74 70 75 74 20 72 6f 77 73 20 66 72 6f 6d 20 utput rows from
06d0: 61 20 57 48 45 52 45 20 63 6c 61 75 73 65 0a 2a a WHERE clause.*
06e0: 2f 0a 4c 6f 67 45 73 74 20 73 71 6c 69 74 65 33 /.LogEst sqlite3
06f0: 57 68 65 72 65 4f 75 74 70 75 74 52 6f 77 43 6f WhereOutputRowCo
0700: 75 6e 74 28 57 68 65 72 65 49 6e 66 6f 20 2a 70 unt(WhereInfo *p
0710: 57 49 6e 66 6f 29 7b 0a 20 20 72 65 74 75 72 6e WInfo){. return
0720: 20 70 57 49 6e 66 6f 2d 3e 6e 52 6f 77 4f 75 74 pWInfo->nRowOut
0730: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 ;.}../*.** Retur
0740: 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 57 48 45 n one of the WHE
0750: 52 45 5f 44 49 53 54 49 4e 43 54 5f 78 78 78 78 RE_DISTINCT_xxxx
0760: 78 20 76 61 6c 75 65 73 20 74 6f 20 69 6e 64 69 x values to indi
0770: 63 61 74 65 20 68 6f 77 20 74 68 69 73 0a 2a 2a cate how this.**
0780: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 72 65 WHERE clause re
0790: 74 75 72 6e 73 20 6f 75 74 70 75 74 73 20 66 6f turns outputs fo
07a0: 72 20 44 49 53 54 49 4e 43 54 20 70 72 6f 63 65 r DISTINCT proce
07b0: 73 73 69 6e 67 2e 0a 2a 2f 0a 69 6e 74 20 73 71 ssing..*/.int sq
07c0: 6c 69 74 65 33 57 68 65 72 65 49 73 44 69 73 74 lite3WhereIsDist
07d0: 69 6e 63 74 28 57 68 65 72 65 49 6e 66 6f 20 2a inct(WhereInfo *
07e0: 70 57 49 6e 66 6f 29 7b 0a 20 20 72 65 74 75 72 pWInfo){. retur
07f0: 6e 20 70 57 49 6e 66 6f 2d 3e 65 44 69 73 74 69 n pWInfo->eDisti
0800: 6e 63 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 nct;.}../*.** Re
0810: 74 75 72 6e 20 54 52 55 45 20 69 66 20 74 68 65 turn TRUE if the
0820: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 72 65 WHERE clause re
0830: 74 75 72 6e 73 20 72 6f 77 73 20 69 6e 20 4f 52 turns rows in OR
0840: 44 45 52 20 42 59 20 6f 72 64 65 72 2e 0a 2a 2a DER BY order..**
0850: 20 52 65 74 75 72 6e 20 46 41 4c 53 45 20 69 66 Return FALSE if
0860: 20 74 68 65 20 6f 75 74 70 75 74 20 6e 65 65 64 the output need
0870: 73 20 74 6f 20 62 65 20 73 6f 72 74 65 64 2e 0a s to be sorted..
0880: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 */.int sqlite3Wh
0890: 65 72 65 49 73 4f 72 64 65 72 65 64 28 57 68 65 ereIsOrdered(Whe
08a0: 72 65 49 6e 66 6f 20 2a 70 57 49 6e 66 6f 29 7b reInfo *pWInfo){
08b0: 0a 20 20 72 65 74 75 72 6e 20 70 57 49 6e 66 6f . return pWInfo
08c0: 2d 3e 6e 4f 42 53 61 74 3b 0a 7d 0a 0a 2f 2a 0a ->nOBSat;.}../*.
08d0: 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 ** Return TRUE i
08e0: 66 20 74 68 65 20 69 6e 6e 65 72 6d 6f 73 74 20 f the innermost
08f0: 6c 6f 6f 70 20 6f 66 20 74 68 65 20 57 48 45 52 loop of the WHER
0900: 45 20 63 6c 61 75 73 65 20 69 6d 70 6c 65 6d 65 E clause impleme
0910: 6e 74 61 74 69 6f 6e 0a 2a 2a 20 72 65 74 75 72 ntation.** retur
0920: 6e 73 20 72 6f 77 73 20 69 6e 20 4f 52 44 45 52 ns rows in ORDER
0930: 20 42 59 20 6f 72 64 65 72 20 66 6f 72 20 63 6f BY order for co
0940: 6d 70 6c 65 74 65 20 72 75 6e 20 6f 66 20 74 68 mplete run of th
0950: 65 20 69 6e 6e 65 72 20 6c 6f 6f 70 2e 0a 2a 2a e inner loop..**
0960: 0a 2a 2a 20 41 63 72 6f 73 73 20 6d 75 6c 74 69 .** Across multi
0970: 70 6c 65 20 69 74 65 72 61 74 69 6f 6e 73 20 6f ple iterations o
0980: 66 20 6f 75 74 65 72 20 6c 6f 6f 70 73 2c 20 74 f outer loops, t
0990: 68 65 20 6f 75 74 70 75 74 20 72 6f 77 73 20 6e he output rows n
09a0: 65 65 64 20 6e 6f 74 20 62 65 0a 2a 2a 20 73 6f eed not be.** so
09b0: 72 74 65 64 2e 20 20 41 73 20 6c 6f 6e 67 20 61 rted. As long a
09c0: 73 20 72 6f 77 73 20 61 72 65 20 73 6f 72 74 65 s rows are sorte
09d0: 64 20 66 6f 72 20 6a 75 73 74 20 74 68 65 20 69 d for just the i
09e0: 6e 6e 65 72 6d 6f 73 74 20 6c 6f 6f 70 2c 20 74 nnermost loop, t
09f0: 68 69 73 0a 2a 2a 20 72 6f 75 74 69 6e 65 20 63 his.** routine c
0a00: 61 6e 20 72 65 74 75 72 6e 20 54 52 55 45 2e 0a an return TRUE..
0a10: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 57 68 */.int sqlite3Wh
0a20: 65 72 65 4f 72 64 65 72 65 64 49 6e 6e 65 72 4c ereOrderedInnerL
0a30: 6f 6f 70 28 57 68 65 72 65 49 6e 66 6f 20 2a 70 oop(WhereInfo *p
0a40: 57 49 6e 66 6f 29 7b 0a 20 20 72 65 74 75 72 6e WInfo){. return
0a50: 20 70 57 49 6e 66 6f 2d 3e 62 4f 72 64 65 72 65 pWInfo->bOrdere
0a60: 64 49 6e 6e 65 72 4c 6f 6f 70 3b 0a 7d 0a 0a 2f dInnerLoop;.}../
0a70: 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 *.** Return the
0a80: 56 44 42 45 20 61 64 64 72 65 73 73 20 6f 72 20 VDBE address or
0a90: 6c 61 62 65 6c 20 74 6f 20 6a 75 6d 70 20 74 6f label to jump to
0aa0: 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 63 6f 6e in order to con
0ab0: 74 69 6e 75 65 0a 2a 2a 20 69 6d 6d 65 64 69 61 tinue.** immedia
0ac0: 74 65 6c 79 20 77 69 74 68 20 74 68 65 20 6e 65 tely with the ne
0ad0: 78 74 20 72 6f 77 20 6f 66 20 61 20 57 48 45 52 xt row of a WHER
0ae0: 45 20 63 6c 61 75 73 65 2e 0a 2a 2f 0a 69 6e 74 E clause..*/.int
0af0: 20 73 71 6c 69 74 65 33 57 68 65 72 65 43 6f 6e sqlite3WhereCon
0b00: 74 69 6e 75 65 4c 61 62 65 6c 28 57 68 65 72 65 tinueLabel(Where
0b10: 49 6e 66 6f 20 2a 70 57 49 6e 66 6f 29 7b 0a 20 Info *pWInfo){.
0b20: 20 61 73 73 65 72 74 28 20 70 57 49 6e 66 6f 2d assert( pWInfo-
0b30: 3e 69 43 6f 6e 74 69 6e 75 65 21 3d 30 20 29 3b >iContinue!=0 );
0b40: 0a 20 20 72 65 74 75 72 6e 20 70 57 49 6e 66 6f . return pWInfo
0b50: 2d 3e 69 43 6f 6e 74 69 6e 75 65 3b 0a 7d 0a 0a ->iContinue;.}..
0b60: 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
0b70: 20 56 44 42 45 20 61 64 64 72 65 73 73 20 6f 72 VDBE address or
0b80: 20 6c 61 62 65 6c 20 74 6f 20 6a 75 6d 70 20 74 label to jump t
0b90: 6f 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 62 72 o in order to br
0ba0: 65 61 6b 0a 2a 2a 20 6f 75 74 20 6f 66 20 61 20 eak.** out of a
0bb0: 57 48 45 52 45 20 6c 6f 6f 70 2e 0a 2a 2f 0a 69 WHERE loop..*/.i
0bc0: 6e 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 42 nt sqlite3WhereB
0bd0: 72 65 61 6b 4c 61 62 65 6c 28 57 68 65 72 65 49 reakLabel(WhereI
0be0: 6e 66 6f 20 2a 70 57 49 6e 66 6f 29 7b 0a 20 20 nfo *pWInfo){.
0bf0: 72 65 74 75 72 6e 20 70 57 49 6e 66 6f 2d 3e 69 return pWInfo->i
0c00: 42 72 65 61 6b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 Break;.}../*.**
0c10: 52 65 74 75 72 6e 20 4f 4e 45 50 41 53 53 5f 4f Return ONEPASS_O
0c20: 46 46 20 28 30 29 20 69 66 20 61 6e 20 55 50 44 FF (0) if an UPD
0c30: 41 54 45 20 6f 72 20 44 45 4c 45 54 45 20 73 74 ATE or DELETE st
0c40: 61 74 65 6d 65 6e 74 20 69 73 20 75 6e 61 62 6c atement is unabl
0c50: 65 20 74 6f 0a 2a 2a 20 6f 70 65 72 61 74 65 20 e to.** operate
0c60: 64 69 72 65 63 74 6c 79 20 6f 6e 20 74 68 65 20 directly on the
0c70: 72 6f 77 69 73 20 72 65 74 75 72 6e 65 64 20 62 rowis returned b
0c80: 79 20 61 20 57 48 45 52 45 20 63 6c 61 75 73 65 y a WHERE clause
0c90: 2e 20 20 52 65 74 75 72 6e 0a 2a 2a 20 4f 4e 45 . Return.** ONE
0ca0: 50 41 53 53 5f 53 49 4e 47 4c 45 20 28 31 29 20 PASS_SINGLE (1)
0cb0: 69 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 if the statement
0cc0: 20 63 61 6e 20 6f 70 65 72 61 74 69 6f 6e 20 64 can operation d
0cd0: 69 72 65 63 74 6c 79 20 62 65 63 61 75 73 65 20 irectly because
0ce0: 6f 6e 6c 79 0a 2a 2a 20 61 20 73 69 6e 67 6c 65 only.** a single
0cf0: 20 72 6f 77 20 69 73 20 74 6f 20 62 65 20 63 68 row is to be ch
0d00: 61 6e 67 65 64 2e 20 20 52 65 74 75 72 6e 20 4f anged. Return O
0d10: 4e 45 50 41 53 53 5f 4d 55 4c 54 49 20 28 32 29 NEPASS_MULTI (2)
0d20: 20 69 66 20 74 68 65 20 6f 6e 65 2d 70 61 73 73 if the one-pass
0d30: 0a 2a 2a 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e .** optimization
0d40: 20 63 61 6e 20 62 65 20 75 73 65 64 20 6f 6e 20 can be used on
0d50: 6d 75 6c 74 69 70 6c 65 20 0a 2a 2a 0a 2a 2a 20 multiple .**.**
0d60: 49 66 20 74 68 65 20 4f 4e 45 50 41 53 53 20 6f If the ONEPASS o
0d70: 70 74 69 6d 69 7a 61 74 69 6f 6e 20 69 73 20 75 ptimization is u
0d80: 73 65 64 20 28 69 66 20 74 68 69 73 20 72 6f 75 sed (if this rou
0d90: 74 69 6e 65 20 72 65 74 75 72 6e 73 20 74 72 75 tine returns tru
0da0: 65 29 0a 2a 2a 20 74 68 65 6e 20 61 6c 73 6f 20 e).** then also
0db0: 77 72 69 74 65 20 74 68 65 20 69 6e 64 69 63 65 write the indice
0dc0: 73 20 6f 66 20 6f 70 65 6e 20 63 75 72 73 6f 72 s of open cursor
0dd0: 73 20 75 73 65 64 20 62 79 20 4f 4e 45 50 41 53 s used by ONEPAS
0de0: 53 0a 2a 2a 20 69 6e 74 6f 20 61 69 43 75 72 5b S.** into aiCur[
0df0: 30 5d 20 61 6e 64 20 61 69 43 75 72 5b 31 5d 2e 0] and aiCur[1].
0e00: 20 20 69 61 43 75 72 5b 30 5d 20 67 65 74 73 20 iaCur[0] gets
0e10: 74 68 65 20 63 75 72 73 6f 72 20 6f 66 20 74 68 the cursor of th
0e20: 65 20 64 61 74 61 0a 2a 2a 20 74 61 62 6c 65 20 e data.** table
0e30: 61 6e 64 20 69 61 43 75 72 5b 31 5d 20 67 65 74 and iaCur[1] get
0e40: 73 20 74 68 65 20 63 75 72 73 6f 72 20 75 73 65 s the cursor use
0e50: 64 20 62 79 20 61 6e 20 61 75 78 69 6c 69 61 72 d by an auxiliar
0e60: 79 20 69 6e 64 65 78 2e 0a 2a 2a 20 45 69 74 68 y index..** Eith
0e70: 65 72 20 76 61 6c 75 65 20 6d 61 79 20 62 65 20 er value may be
0e80: 2d 31 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 74 -1, indicating t
0e90: 68 61 74 20 63 75 72 73 6f 72 20 69 73 20 6e 6f hat cursor is no
0ea0: 74 20 75 73 65 64 2e 0a 2a 2a 20 41 6e 79 20 63 t used..** Any c
0eb0: 75 72 73 6f 72 73 20 72 65 74 75 72 6e 65 64 20 ursors returned
0ec0: 77 69 6c 6c 20 68 61 76 65 20 62 65 65 6e 20 6f will have been o
0ed0: 70 65 6e 65 64 20 66 6f 72 20 77 72 69 74 69 6e pened for writin
0ee0: 67 2e 0a 2a 2a 0a 2a 2a 20 61 69 43 75 72 5b 30 g..**.** aiCur[0
0ef0: 5d 20 61 6e 64 20 61 69 43 75 72 5b 31 5d 20 62 ] and aiCur[1] b
0f00: 6f 74 68 20 67 65 74 20 2d 31 20 69 66 20 74 68 oth get -1 if th
0f10: 65 20 77 68 65 72 65 2d 63 6c 61 75 73 65 20 6c e where-clause l
0f20: 6f 67 69 63 20 69 73 0a 2a 2a 20 75 6e 61 62 6c ogic is.** unabl
0f30: 65 20 74 6f 20 75 73 65 20 74 68 65 20 4f 4e 45 e to use the ONE
0f40: 50 41 53 53 20 6f 70 74 69 6d 69 7a 61 74 69 6f PASS optimizatio
0f50: 6e 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 n..*/.int sqlite
0f60: 33 57 68 65 72 65 4f 6b 4f 6e 65 50 61 73 73 28 3WhereOkOnePass(
0f70: 57 68 65 72 65 49 6e 66 6f 20 2a 70 57 49 6e 66 WhereInfo *pWInf
0f80: 6f 2c 20 69 6e 74 20 2a 61 69 43 75 72 29 7b 0a o, int *aiCur){.
0f90: 20 20 6d 65 6d 63 70 79 28 61 69 43 75 72 2c 20 memcpy(aiCur,
0fa0: 70 57 49 6e 66 6f 2d 3e 61 69 43 75 72 4f 6e 65 pWInfo->aiCurOne
0fb0: 50 61 73 73 2c 20 73 69 7a 65 6f 66 28 69 6e 74 Pass, sizeof(int
0fc0: 29 2a 32 29 3b 0a 23 69 66 64 65 66 20 57 48 45 )*2);.#ifdef WHE
0fd0: 52 45 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 0a RETRACE_ENABLED.
0fe0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 57 68 65 if( sqlite3Whe
0ff0: 72 65 54 72 61 63 65 20 26 26 20 70 57 49 6e 66 reTrace && pWInf
1000: 6f 2d 3e 65 4f 6e 65 50 61 73 73 21 3d 4f 4e 45 o->eOnePass!=ONE
1010: 50 41 53 53 5f 4f 46 46 20 29 7b 0a 20 20 20 20 PASS_OFF ){.
1020: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e sqlite3DebugPrin
1030: 74 66 28 22 25 73 20 63 75 72 73 6f 72 73 3a 20 tf("%s cursors:
1040: 25 64 20 25 64 5c 6e 22 2c 0a 20 20 20 20 20 20 %d %d\n",.
1050: 20 20 20 70 57 49 6e 66 6f 2d 3e 65 4f 6e 65 50 pWInfo->eOneP
1060: 61 73 73 3d 3d 4f 4e 45 50 41 53 53 5f 53 49 4e ass==ONEPASS_SIN
1070: 47 4c 45 20 3f 20 22 4f 4e 45 50 41 53 53 5f 53 GLE ? "ONEPASS_S
1080: 49 4e 47 4c 45 22 20 3a 20 22 4f 4e 45 50 41 53 INGLE" : "ONEPAS
1090: 53 5f 4d 55 4c 54 49 22 2c 0a 20 20 20 20 20 20 S_MULTI",.
10a0: 20 20 20 61 69 43 75 72 5b 30 5d 2c 20 61 69 43 aiCur[0], aiC
10b0: 75 72 5b 31 5d 29 3b 0a 20 20 7d 0a 23 65 6e 64 ur[1]);. }.#end
10c0: 69 66 0a 20 20 72 65 74 75 72 6e 20 70 57 49 6e if. return pWIn
10d0: 66 6f 2d 3e 65 4f 6e 65 50 61 73 73 3b 0a 7d 0a fo->eOnePass;.}.
10e0: 0a 2f 2a 0a 2a 2a 20 4d 6f 76 65 20 74 68 65 20 ./*.** Move the
10f0: 63 6f 6e 74 65 6e 74 20 6f 66 20 70 53 72 63 20 content of pSrc
1100: 69 6e 74 6f 20 70 44 65 73 74 0a 2a 2f 0a 73 74 into pDest.*/.st
1110: 61 74 69 63 20 76 6f 69 64 20 77 68 65 72 65 4f atic void whereO
1120: 72 4d 6f 76 65 28 57 68 65 72 65 4f 72 53 65 74 rMove(WhereOrSet
1130: 20 2a 70 44 65 73 74 2c 20 57 68 65 72 65 4f 72 *pDest, WhereOr
1140: 53 65 74 20 2a 70 53 72 63 29 7b 0a 20 20 70 44 Set *pSrc){. pD
1150: 65 73 74 2d 3e 6e 20 3d 20 70 53 72 63 2d 3e 6e est->n = pSrc->n
1160: 3b 0a 20 20 6d 65 6d 63 70 79 28 70 44 65 73 74 ;. memcpy(pDest
1170: 2d 3e 61 2c 20 70 53 72 63 2d 3e 61 2c 20 70 44 ->a, pSrc->a, pD
1180: 65 73 74 2d 3e 6e 2a 73 69 7a 65 6f 66 28 70 44 est->n*sizeof(pD
1190: 65 73 74 2d 3e 61 5b 30 5d 29 29 3b 0a 7d 0a 0a est->a[0]));.}..
11a0: 2f 2a 0a 2a 2a 20 54 72 79 20 74 6f 20 69 6e 73 /*.** Try to ins
11b0: 65 72 74 20 61 20 6e 65 77 20 70 72 65 72 65 71 ert a new prereq
11c0: 75 69 73 69 74 65 2f 63 6f 73 74 20 65 6e 74 72 uisite/cost entr
11d0: 79 20 69 6e 74 6f 20 74 68 65 20 57 68 65 72 65 y into the Where
11e0: 4f 72 53 65 74 20 70 53 65 74 2e 0a 2a 2a 0a 2a OrSet pSet..**.*
11f0: 2a 20 54 68 65 20 6e 65 77 20 65 6e 74 72 79 20 * The new entry
1200: 6d 69 67 68 74 20 6f 76 65 72 77 72 69 74 65 20 might overwrite
1210: 61 6e 20 65 78 69 73 74 69 6e 67 20 65 6e 74 72 an existing entr
1220: 79 2c 20 6f 72 20 69 74 20 6d 69 67 68 74 20 62 y, or it might b
1230: 65 0a 2a 2a 20 61 70 70 65 6e 64 65 64 2c 20 6f e.** appended, o
1240: 72 20 69 74 20 6d 69 67 68 74 20 62 65 20 64 69 r it might be di
1250: 73 63 61 72 64 65 64 2e 20 20 44 6f 20 77 68 61 scarded. Do wha
1260: 74 65 76 65 72 20 69 73 20 74 68 65 20 72 69 67 tever is the rig
1270: 68 74 20 74 68 69 6e 67 0a 2a 2a 20 73 6f 20 74 ht thing.** so t
1280: 68 61 74 20 70 53 65 74 20 6b 65 65 70 73 20 74 hat pSet keeps t
1290: 68 65 20 4e 5f 4f 52 5f 43 4f 53 54 20 62 65 73 he N_OR_COST bes
12a0: 74 20 65 6e 74 72 69 65 73 20 73 65 65 6e 20 73 t entries seen s
12b0: 6f 20 66 61 72 2e 0a 2a 2f 0a 73 74 61 74 69 63 o far..*/.static
12c0: 20 69 6e 74 20 77 68 65 72 65 4f 72 49 6e 73 65 int whereOrInse
12d0: 72 74 28 0a 20 20 57 68 65 72 65 4f 72 53 65 74 rt(. WhereOrSet
12e0: 20 2a 70 53 65 74 2c 20 20 20 20 20 20 2f 2a 20 *pSet, /*
12f0: 54 68 65 20 57 68 65 72 65 4f 72 53 65 74 20 74 The WhereOrSet t
1300: 6f 20 62 65 20 75 70 64 61 74 65 64 20 2a 2f 0a o be updated */.
1310: 20 20 42 69 74 6d 61 73 6b 20 70 72 65 72 65 71 Bitmask prereq
1320: 2c 20 20 20 20 20 20 20 20 2f 2a 20 50 72 65 72 , /* Prer
1330: 65 71 75 69 73 69 74 65 73 20 6f 66 20 74 68 65 equisites of the
1340: 20 6e 65 77 20 65 6e 74 72 79 20 2a 2f 0a 20 20 new entry */.
1350: 4c 6f 67 45 73 74 20 72 52 75 6e 2c 20 20 20 20 LogEst rRun,
1360: 20 20 20 20 20 20 20 2f 2a 20 52 75 6e 2d 63 6f /* Run-co
1370: 73 74 20 6f 66 20 74 68 65 20 6e 65 77 20 65 6e st of the new en
1380: 74 72 79 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 try */. LogEst
1390: 6e 4f 75 74 20 20 20 20 20 20 20 20 20 20 20 20 nOut
13a0: 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 6f 75 74 /* Number of out
13b0: 70 75 74 73 20 66 6f 72 20 74 68 65 20 6e 65 77 puts for the new
13c0: 20 65 6e 74 72 79 20 2a 2f 0a 29 7b 0a 20 20 75 entry */.){. u
13d0: 31 36 20 69 3b 0a 20 20 57 68 65 72 65 4f 72 43 16 i;. WhereOrC
13e0: 6f 73 74 20 2a 70 3b 0a 20 20 66 6f 72 28 69 3d ost *p;. for(i=
13f0: 70 53 65 74 2d 3e 6e 2c 20 70 3d 70 53 65 74 2d pSet->n, p=pSet-
1400: 3e 61 3b 20 69 3e 30 3b 20 69 2d 2d 2c 20 70 2b >a; i>0; i--, p+
1410: 2b 29 7b 0a 20 20 20 20 69 66 28 20 72 52 75 6e +){. if( rRun
1420: 3c 3d 70 2d 3e 72 52 75 6e 20 26 26 20 28 70 72 <=p->rRun && (pr
1430: 65 72 65 71 20 26 20 70 2d 3e 70 72 65 72 65 71 ereq & p->prereq
1440: 29 3d 3d 70 72 65 72 65 71 20 29 7b 0a 20 20 20 )==prereq ){.
1450: 20 20 20 67 6f 74 6f 20 77 68 65 72 65 4f 72 49 goto whereOrI
1460: 6e 73 65 72 74 5f 64 6f 6e 65 3b 0a 20 20 20 20 nsert_done;.
1470: 7d 0a 20 20 20 20 69 66 28 20 70 2d 3e 72 52 75 }. if( p->rRu
1480: 6e 3c 3d 72 52 75 6e 20 26 26 20 28 70 2d 3e 70 n<=rRun && (p->p
1490: 72 65 72 65 71 20 26 20 70 72 65 72 65 71 29 3d rereq & prereq)=
14a0: 3d 70 2d 3e 70 72 65 72 65 71 20 29 7b 0a 20 20 =p->prereq ){.
14b0: 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 return 0;.
14c0: 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 53 }. }. if( pS
14d0: 65 74 2d 3e 6e 3c 4e 5f 4f 52 5f 43 4f 53 54 20 et->n<N_OR_COST
14e0: 29 7b 0a 20 20 20 20 70 20 3d 20 26 70 53 65 74 ){. p = &pSet
14f0: 2d 3e 61 5b 70 53 65 74 2d 3e 6e 2b 2b 5d 3b 0a ->a[pSet->n++];.
1500: 20 20 20 20 70 2d 3e 6e 4f 75 74 20 3d 20 6e 4f p->nOut = nO
1510: 75 74 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 ut;. }else{.
1520: 20 70 20 3d 20 70 53 65 74 2d 3e 61 3b 0a 20 20 p = pSet->a;.
1530: 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c 70 53 65 for(i=1; i<pSe
1540: 74 2d 3e 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 t->n; i++){.
1550: 20 20 69 66 28 20 70 2d 3e 72 52 75 6e 3e 70 53 if( p->rRun>pS
1560: 65 74 2d 3e 61 5b 69 5d 2e 72 52 75 6e 20 29 20 et->a[i].rRun )
1570: 70 20 3d 20 70 53 65 74 2d 3e 61 20 2b 20 69 3b p = pSet->a + i;
1580: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 70 . }. if( p
1590: 2d 3e 72 52 75 6e 3c 3d 72 52 75 6e 20 29 20 72 ->rRun<=rRun ) r
15a0: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 77 68 65 eturn 0;. }.whe
15b0: 72 65 4f 72 49 6e 73 65 72 74 5f 64 6f 6e 65 3a reOrInsert_done:
15c0: 0a 20 20 70 2d 3e 70 72 65 72 65 71 20 3d 20 70 . p->prereq = p
15d0: 72 65 72 65 71 3b 0a 20 20 70 2d 3e 72 52 75 6e rereq;. p->rRun
15e0: 20 3d 20 72 52 75 6e 3b 0a 20 20 69 66 28 20 70 = rRun;. if( p
15f0: 2d 3e 6e 4f 75 74 3e 6e 4f 75 74 20 29 20 70 2d ->nOut>nOut ) p-
1600: 3e 6e 4f 75 74 20 3d 20 6e 4f 75 74 3b 0a 20 20 >nOut = nOut;.
1610: 72 65 74 75 72 6e 20 31 3b 0a 7d 0a 0a 2f 2a 0a return 1;.}../*.
1620: 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 20 62 69 ** Return the bi
1630: 74 6d 61 73 6b 20 66 6f 72 20 74 68 65 20 67 69 tmask for the gi
1640: 76 65 6e 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 ven cursor numbe
1650: 72 2e 20 20 52 65 74 75 72 6e 20 30 20 69 66 0a r. Return 0 if.
1660: 2a 2a 20 69 43 75 72 73 6f 72 20 69 73 20 6e 6f ** iCursor is no
1670: 74 20 69 6e 20 74 68 65 20 73 65 74 2e 0a 2a 2f t in the set..*/
1680: 0a 42 69 74 6d 61 73 6b 20 73 71 6c 69 74 65 33 .Bitmask sqlite3
1690: 57 68 65 72 65 47 65 74 4d 61 73 6b 28 57 68 65 WhereGetMask(Whe
16a0: 72 65 4d 61 73 6b 53 65 74 20 2a 70 4d 61 73 6b reMaskSet *pMask
16b0: 53 65 74 2c 20 69 6e 74 20 69 43 75 72 73 6f 72 Set, int iCursor
16c0: 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 61 73 ){. int i;. as
16d0: 73 65 72 74 28 20 70 4d 61 73 6b 53 65 74 2d 3e sert( pMaskSet->
16e0: 6e 3c 3d 28 69 6e 74 29 73 69 7a 65 6f 66 28 42 n<=(int)sizeof(B
16f0: 69 74 6d 61 73 6b 29 2a 38 20 29 3b 0a 20 20 66 itmask)*8 );. f
1700: 6f 72 28 69 3d 30 3b 20 69 3c 70 4d 61 73 6b 53 or(i=0; i<pMaskS
1710: 65 74 2d 3e 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20 et->n; i++){.
1720: 20 69 66 28 20 70 4d 61 73 6b 53 65 74 2d 3e 69 if( pMaskSet->i
1730: 78 5b 69 5d 3d 3d 69 43 75 72 73 6f 72 20 29 7b x[i]==iCursor ){
1740: 0a 20 20 20 20 20 20 72 65 74 75 72 6e 20 4d 41 . return MA
1750: 53 4b 42 49 54 28 69 29 3b 0a 20 20 20 20 7d 0a SKBIT(i);. }.
1760: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a }. return 0;.
1770: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 72 65 61 74 65 20 }../*.** Create
1780: 61 20 6e 65 77 20 6d 61 73 6b 20 66 6f 72 20 63 a new mask for c
1790: 75 72 73 6f 72 20 69 43 75 72 73 6f 72 2e 0a 2a ursor iCursor..*
17a0: 2a 0a 2a 2a 20 54 68 65 72 65 20 69 73 20 6f 6e *.** There is on
17b0: 65 20 63 75 72 73 6f 72 20 70 65 72 20 74 61 62 e cursor per tab
17c0: 6c 65 20 69 6e 20 74 68 65 20 46 52 4f 4d 20 63 le in the FROM c
17d0: 6c 61 75 73 65 2e 20 20 54 68 65 20 6e 75 6d 62 lause. The numb
17e0: 65 72 20 6f 66 0a 2a 2a 20 74 61 62 6c 65 73 20 er of.** tables
17f0: 69 6e 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 in the FROM clau
1800: 73 65 20 69 73 20 6c 69 6d 69 74 65 64 20 62 79 se is limited by
1810: 20 61 20 74 65 73 74 20 65 61 72 6c 79 20 69 6e a test early in
1820: 20 74 68 65 0a 2a 2a 20 73 71 6c 69 74 65 33 57 the.** sqlite3W
1830: 68 65 72 65 42 65 67 69 6e 28 29 20 72 6f 75 74 hereBegin() rout
1840: 69 6e 65 2e 20 20 53 6f 20 77 65 20 6b 6e 6f 77 ine. So we know
1850: 20 74 68 61 74 20 74 68 65 20 70 4d 61 73 6b 53 that the pMaskS
1860: 65 74 2d 3e 69 78 5b 5d 0a 2a 2a 20 61 72 72 61 et->ix[].** arra
1870: 79 20 77 69 6c 6c 20 6e 65 76 65 72 20 6f 76 65 y will never ove
1880: 72 66 6c 6f 77 2e 0a 2a 2f 0a 73 74 61 74 69 63 rflow..*/.static
1890: 20 76 6f 69 64 20 63 72 65 61 74 65 4d 61 73 6b void createMask
18a0: 28 57 68 65 72 65 4d 61 73 6b 53 65 74 20 2a 70 (WhereMaskSet *p
18b0: 4d 61 73 6b 53 65 74 2c 20 69 6e 74 20 69 43 75 MaskSet, int iCu
18c0: 72 73 6f 72 29 7b 0a 20 20 61 73 73 65 72 74 28 rsor){. assert(
18d0: 20 70 4d 61 73 6b 53 65 74 2d 3e 6e 20 3c 20 41 pMaskSet->n < A
18e0: 72 72 61 79 53 69 7a 65 28 70 4d 61 73 6b 53 65 rraySize(pMaskSe
18f0: 74 2d 3e 69 78 29 20 29 3b 0a 20 20 70 4d 61 73 t->ix) );. pMas
1900: 6b 53 65 74 2d 3e 69 78 5b 70 4d 61 73 6b 53 65 kSet->ix[pMaskSe
1910: 74 2d 3e 6e 2b 2b 5d 20 3d 20 69 43 75 72 73 6f t->n++] = iCurso
1920: 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 76 61 r;.}../*.** Adva
1930: 6e 63 65 20 74 6f 20 74 68 65 20 6e 65 78 74 20 nce to the next
1940: 57 68 65 72 65 54 65 72 6d 20 74 68 61 74 20 6d WhereTerm that m
1950: 61 74 63 68 65 73 20 61 63 63 6f 72 64 69 6e 67 atches according
1960: 20 74 6f 20 74 68 65 20 63 72 69 74 65 72 69 61 to the criteria
1970: 0a 2a 2a 20 65 73 74 61 62 6c 69 73 68 65 64 20 .** established
1980: 77 68 65 6e 20 74 68 65 20 70 53 63 61 6e 20 6f when the pScan o
1990: 62 6a 65 63 74 20 77 61 73 20 69 6e 69 74 69 61 bject was initia
19a0: 6c 69 7a 65 64 20 62 79 20 77 68 65 72 65 53 63 lized by whereSc
19b0: 61 6e 49 6e 69 74 28 29 2e 0a 2a 2a 20 52 65 74 anInit()..** Ret
19c0: 75 72 6e 20 4e 55 4c 4c 20 69 66 20 74 68 65 72 urn NULL if ther
19d0: 65 20 61 72 65 20 6e 6f 20 6d 6f 72 65 20 6d 61 e are no more ma
19e0: 74 63 68 69 6e 67 20 57 68 65 72 65 54 65 72 6d tching WhereTerm
19f0: 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 57 68 65 s..*/.static Whe
1a00: 72 65 54 65 72 6d 20 2a 77 68 65 72 65 53 63 61 reTerm *whereSca
1a10: 6e 4e 65 78 74 28 57 68 65 72 65 53 63 61 6e 20 nNext(WhereScan
1a20: 2a 70 53 63 61 6e 29 7b 0a 20 20 69 6e 74 20 69 *pScan){. int i
1a30: 43 75 72 3b 20 20 20 20 20 20 20 20 20 20 20 20 Cur;
1a40: 2f 2a 20 54 68 65 20 63 75 72 73 6f 72 20 6f 6e /* The cursor on
1a50: 20 74 68 65 20 4c 48 53 20 6f 66 20 74 68 65 20 the LHS of the
1a60: 74 65 72 6d 20 2a 2f 0a 20 20 69 31 36 20 69 43 term */. i16 iC
1a70: 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 20 20 20 2f olumn; /
1a80: 2a 20 54 68 65 20 63 6f 6c 75 6d 6e 20 6f 6e 20 * The column on
1a90: 74 68 65 20 4c 48 53 20 6f 66 20 74 68 65 20 74 the LHS of the t
1aa0: 65 72 6d 2e 20 20 2d 31 20 66 6f 72 20 49 50 4b erm. -1 for IPK
1ab0: 20 2a 2f 0a 20 20 45 78 70 72 20 2a 70 58 3b 20 */. Expr *pX;
1ac0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 6e /* An
1ad0: 20 65 78 70 72 65 73 73 69 6f 6e 20 62 65 69 6e expression bein
1ae0: 67 20 74 65 73 74 65 64 20 2a 2f 0a 20 20 57 68 g tested */. Wh
1af0: 65 72 65 43 6c 61 75 73 65 20 2a 70 57 43 3b 20 ereClause *pWC;
1b00: 20 20 20 2f 2a 20 53 68 6f 72 74 68 61 6e 64 20 /* Shorthand
1b10: 66 6f 72 20 70 53 63 61 6e 2d 3e 70 57 43 20 2a for pScan->pWC *
1b20: 2f 0a 20 20 57 68 65 72 65 54 65 72 6d 20 2a 70 /. WhereTerm *p
1b30: 54 65 72 6d 3b 20 20 20 20 2f 2a 20 54 68 65 20 Term; /* The
1b40: 74 65 72 6d 20 62 65 69 6e 67 20 74 65 73 74 65 term being teste
1b50: 64 20 2a 2f 0a 20 20 69 6e 74 20 6b 20 3d 20 70 d */. int k = p
1b60: 53 63 61 6e 2d 3e 6b 3b 20 20 20 20 2f 2a 20 57 Scan->k; /* W
1b70: 68 65 72 65 20 74 6f 20 73 74 61 72 74 20 73 63 here to start sc
1b80: 61 6e 6e 69 6e 67 20 2a 2f 0a 0a 20 20 61 73 73 anning */.. ass
1b90: 65 72 74 28 20 70 53 63 61 6e 2d 3e 69 45 71 75 ert( pScan->iEqu
1ba0: 69 76 3c 3d 70 53 63 61 6e 2d 3e 6e 45 71 75 69 iv<=pScan->nEqui
1bb0: 76 20 29 3b 0a 20 20 70 57 43 20 3d 20 70 53 63 v );. pWC = pSc
1bc0: 61 6e 2d 3e 70 57 43 3b 0a 20 20 77 68 69 6c 65 an->pWC;. while
1bd0: 28 31 29 7b 0a 20 20 20 20 69 43 6f 6c 75 6d 6e (1){. iColumn
1be0: 20 3d 20 70 53 63 61 6e 2d 3e 61 69 43 6f 6c 75 = pScan->aiColu
1bf0: 6d 6e 5b 70 53 63 61 6e 2d 3e 69 45 71 75 69 76 mn[pScan->iEquiv
1c00: 2d 31 5d 3b 0a 20 20 20 20 69 43 75 72 20 3d 20 -1];. iCur =
1c10: 70 53 63 61 6e 2d 3e 61 69 43 75 72 5b 70 53 63 pScan->aiCur[pSc
1c20: 61 6e 2d 3e 69 45 71 75 69 76 2d 31 5d 3b 0a 20 an->iEquiv-1];.
1c30: 20 20 20 61 73 73 65 72 74 28 20 70 57 43 21 3d assert( pWC!=
1c40: 30 20 29 3b 0a 20 20 20 20 64 6f 7b 0a 20 20 20 0 );. do{.
1c50: 20 20 20 66 6f 72 28 70 54 65 72 6d 3d 70 57 43 for(pTerm=pWC
1c60: 2d 3e 61 2b 6b 3b 20 6b 3c 70 57 43 2d 3e 6e 54 ->a+k; k<pWC->nT
1c70: 65 72 6d 3b 20 6b 2b 2b 2c 20 70 54 65 72 6d 2b erm; k++, pTerm+
1c80: 2b 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 +){. if(
1c90: 70 54 65 72 6d 2d 3e 6c 65 66 74 43 75 72 73 6f pTerm->leftCurso
1ca0: 72 3d 3d 69 43 75 72 0a 20 20 20 20 20 20 20 20 r==iCur.
1cb0: 20 26 26 20 70 54 65 72 6d 2d 3e 75 2e 6c 65 66 && pTerm->u.lef
1cc0: 74 43 6f 6c 75 6d 6e 3d 3d 69 43 6f 6c 75 6d 6e tColumn==iColumn
1cd0: 0a 20 20 20 20 20 20 20 20 20 26 26 20 28 69 43 . && (iC
1ce0: 6f 6c 75 6d 6e 21 3d 58 4e 5f 45 58 50 52 0a 20 olumn!=XN_EXPR.
1cf0: 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 73 || s
1d00: 71 6c 69 74 65 33 45 78 70 72 43 6f 6d 70 61 72 qlite3ExprCompar
1d10: 65 53 6b 69 70 28 70 54 65 72 6d 2d 3e 70 45 78 eSkip(pTerm->pEx
1d20: 70 72 2d 3e 70 4c 65 66 74 2c 0a 20 20 20 20 20 pr->pLeft,.
1d30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d50: 20 20 70 53 63 61 6e 2d 3e 70 49 64 78 45 78 70 pScan->pIdxExp
1d60: 72 2c 69 43 75 72 29 3d 3d 30 29 0a 20 20 20 20 r,iCur)==0).
1d70: 20 20 20 20 20 26 26 20 28 70 53 63 61 6e 2d 3e && (pScan->
1d80: 69 45 71 75 69 76 3c 3d 31 20 7c 7c 20 21 45 78 iEquiv<=1 || !Ex
1d90: 70 72 48 61 73 50 72 6f 70 65 72 74 79 28 70 54 prHasProperty(pT
1da0: 65 72 6d 2d 3e 70 45 78 70 72 2c 20 45 50 5f 46 erm->pExpr, EP_F
1db0: 72 6f 6d 4a 6f 69 6e 29 29 0a 20 20 20 20 20 20 romJoin)).
1dc0: 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 ){. i
1dd0: 66 28 20 28 70 54 65 72 6d 2d 3e 65 4f 70 65 72 f( (pTerm->eOper
1de0: 61 74 6f 72 20 26 20 57 4f 5f 45 51 55 49 56 29 ator & WO_EQUIV)
1df0: 21 3d 30 0a 20 20 20 20 20 20 20 20 20 20 20 26 !=0. &
1e00: 26 20 70 53 63 61 6e 2d 3e 6e 45 71 75 69 76 3c & pScan->nEquiv<
1e10: 41 72 72 61 79 53 69 7a 65 28 70 53 63 61 6e 2d ArraySize(pScan-
1e20: 3e 61 69 43 75 72 29 0a 20 20 20 20 20 20 20 20 >aiCur).
1e30: 20 20 20 26 26 20 28 70 58 20 3d 20 73 71 6c 69 && (pX = sqli
1e40: 74 65 33 45 78 70 72 53 6b 69 70 43 6f 6c 6c 61 te3ExprSkipColla
1e50: 74 65 28 70 54 65 72 6d 2d 3e 70 45 78 70 72 2d te(pTerm->pExpr-
1e60: 3e 70 52 69 67 68 74 29 29 2d 3e 6f 70 3d 3d 54 >pRight))->op==T
1e70: 4b 5f 43 4f 4c 55 4d 4e 0a 20 20 20 20 20 20 20 K_COLUMN.
1e80: 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ){.
1e90: 20 20 69 6e 74 20 6a 3b 0a 20 20 20 20 20 20 20 int j;.
1ea0: 20 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c for(j=0; j<
1eb0: 70 53 63 61 6e 2d 3e 6e 45 71 75 69 76 3b 20 6a pScan->nEquiv; j
1ec0: 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 ++){.
1ed0: 20 20 20 69 66 28 20 70 53 63 61 6e 2d 3e 61 69 if( pScan->ai
1ee0: 43 75 72 5b 6a 5d 3d 3d 70 58 2d 3e 69 54 61 62 Cur[j]==pX->iTab
1ef0: 6c 65 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 le.
1f00: 20 20 26 26 20 70 53 63 61 6e 2d 3e 61 69 43 6f && pScan->aiCo
1f10: 6c 75 6d 6e 5b 6a 5d 3d 3d 70 58 2d 3e 69 43 6f lumn[j]==pX->iCo
1f20: 6c 75 6d 6e 20 29 7b 0a 20 20 20 20 20 20 20 20 lumn ){.
1f30: 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
1f40: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 7d . }
1f50: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 . }.
1f60: 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 6a if( j
1f70: 3d 3d 70 53 63 61 6e 2d 3e 6e 45 71 75 69 76 20 ==pScan->nEquiv
1f80: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ){.
1f90: 20 70 53 63 61 6e 2d 3e 61 69 43 75 72 5b 6a 5d pScan->aiCur[j]
1fa0: 20 3d 20 70 58 2d 3e 69 54 61 62 6c 65 3b 0a 20 = pX->iTable;.
1fb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 70 53 63 pSc
1fc0: 61 6e 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 6a 5d 20 an->aiColumn[j]
1fd0: 3d 20 70 58 2d 3e 69 43 6f 6c 75 6d 6e 3b 0a 20 = pX->iColumn;.
1fe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 70 53 63 pSc
1ff0: 61 6e 2d 3e 6e 45 71 75 69 76 2b 2b 3b 0a 20 20 an->nEquiv++;.
2000: 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 }.
2010: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
2020: 20 20 69 66 28 20 28 70 54 65 72 6d 2d 3e 65 4f if( (pTerm->eO
2030: 70 65 72 61 74 6f 72 20 26 20 70 53 63 61 6e 2d perator & pScan-
2040: 3e 6f 70 4d 61 73 6b 29 21 3d 30 20 29 7b 0a 20 >opMask)!=0 ){.
2050: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 65 /* Ve
2060: 72 69 66 79 20 74 68 65 20 61 66 66 69 6e 69 74 rify the affinit
2070: 79 20 61 6e 64 20 63 6f 6c 6c 61 74 69 6e 67 20 y and collating
2080: 73 65 71 75 65 6e 63 65 20 6d 61 74 63 68 20 2a sequence match *
2090: 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 /. if
20a0: 28 20 70 53 63 61 6e 2d 3e 7a 43 6f 6c 6c 4e 61 ( pScan->zCollNa
20b0: 6d 65 20 26 26 20 28 70 54 65 72 6d 2d 3e 65 4f me && (pTerm->eO
20c0: 70 65 72 61 74 6f 72 20 26 20 57 4f 5f 49 53 4e perator & WO_ISN
20d0: 55 4c 4c 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 ULL)==0 ){.
20e0: 20 20 20 20 20 20 20 20 20 43 6f 6c 6c 53 65 71 CollSeq
20f0: 20 2a 70 43 6f 6c 6c 3b 0a 20 20 20 20 20 20 20 *pColl;.
2100: 20 20 20 20 20 20 20 50 61 72 73 65 20 2a 70 50 Parse *pP
2110: 61 72 73 65 20 3d 20 70 57 43 2d 3e 70 57 49 6e arse = pWC->pWIn
2120: 66 6f 2d 3e 70 50 61 72 73 65 3b 0a 20 20 20 20 fo->pParse;.
2130: 20 20 20 20 20 20 20 20 20 20 70 58 20 3d 20 70 pX = p
2140: 54 65 72 6d 2d 3e 70 45 78 70 72 3b 0a 20 20 20 Term->pExpr;.
2150: 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 21 if( !
2160: 73 71 6c 69 74 65 33 49 6e 64 65 78 41 66 66 69 sqlite3IndexAffi
2170: 6e 69 74 79 4f 6b 28 70 58 2c 20 70 53 63 61 6e nityOk(pX, pScan
2180: 2d 3e 69 64 78 61 66 66 29 20 29 7b 0a 20 20 20 ->idxaff) ){.
2190: 20 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e con
21a0: 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 20 tinue;.
21b0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
21c0: 20 20 20 20 20 61 73 73 65 72 74 28 70 58 2d 3e assert(pX->
21d0: 70 4c 65 66 74 29 3b 0a 20 20 20 20 20 20 20 20 pLeft);.
21e0: 20 20 20 20 20 20 70 43 6f 6c 6c 20 3d 20 73 71 pColl = sq
21f0: 6c 69 74 65 33 42 69 6e 61 72 79 43 6f 6d 70 61 lite3BinaryCompa
2200: 72 65 43 6f 6c 6c 53 65 71 28 70 50 61 72 73 65 reCollSeq(pParse
2210: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
2220: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2230: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2240: 20 20 20 20 70 58 2d 3e 70 4c 65 66 74 2c 20 70 pX->pLeft, p
2250: 58 2d 3e 70 52 69 67 68 74 29 3b 0a 20 20 20 20 X->pRight);.
2260: 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 43 if( pC
2270: 6f 6c 6c 3d 3d 30 20 29 20 70 43 6f 6c 6c 20 3d oll==0 ) pColl =
2280: 20 70 50 61 72 73 65 2d 3e 64 62 2d 3e 70 44 66 pParse->db->pDf
2290: 6c 74 43 6f 6c 6c 3b 0a 20 20 20 20 20 20 20 20 ltColl;.
22a0: 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 if( sqlite
22b0: 33 53 74 72 49 43 6d 70 28 70 43 6f 6c 6c 2d 3e 3StrICmp(pColl->
22c0: 7a 4e 61 6d 65 2c 20 70 53 63 61 6e 2d 3e 7a 43 zName, pScan->zC
22d0: 6f 6c 6c 4e 61 6d 65 29 20 29 7b 0a 20 20 20 20 ollName) ){.
22e0: 20 20 20 20 20 20 20 20 20 20 20 20 63 6f 6e 74 cont
22f0: 69 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 20 20 inue;.
2300: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 }.
2310: 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 }.
2320: 69 66 28 20 28 70 54 65 72 6d 2d 3e 65 4f 70 65 if( (pTerm->eOpe
2330: 72 61 74 6f 72 20 26 20 28 57 4f 5f 45 51 7c 57 rator & (WO_EQ|W
2340: 4f 5f 49 53 29 29 21 3d 30 0a 20 20 20 20 20 20 O_IS))!=0.
2350: 20 20 20 20 20 20 20 26 26 20 28 70 58 20 3d 20 && (pX =
2360: 70 54 65 72 6d 2d 3e 70 45 78 70 72 2d 3e 70 52 pTerm->pExpr->pR
2370: 69 67 68 74 29 2d 3e 6f 70 3d 3d 54 4b 5f 43 4f ight)->op==TK_CO
2380: 4c 55 4d 4e 0a 20 20 20 20 20 20 20 20 20 20 20 LUMN.
2390: 20 20 26 26 20 70 58 2d 3e 69 54 61 62 6c 65 3d && pX->iTable=
23a0: 3d 70 53 63 61 6e 2d 3e 61 69 43 75 72 5b 30 5d =pScan->aiCur[0]
23b0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 26 26 . &&
23c0: 20 70 58 2d 3e 69 43 6f 6c 75 6d 6e 3d 3d 70 53 pX->iColumn==pS
23d0: 63 61 6e 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 30 5d can->aiColumn[0]
23e0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 29 7b 0a . ){.
23f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 74 65 te
2400: 73 74 63 61 73 65 28 20 70 54 65 72 6d 2d 3e 65 stcase( pTerm->e
2410: 4f 70 65 72 61 74 6f 72 20 26 20 57 4f 5f 49 53 Operator & WO_IS
2420: 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 );.
2430: 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 continue;.
2440: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
2450: 20 20 20 20 20 20 70 53 63 61 6e 2d 3e 70 57 43 pScan->pWC
2460: 20 3d 20 70 57 43 3b 0a 20 20 20 20 20 20 20 20 = pWC;.
2470: 20 20 20 20 70 53 63 61 6e 2d 3e 6b 20 3d 20 6b pScan->k = k
2480: 2b 31 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 +1;.
2490: 72 65 74 75 72 6e 20 70 54 65 72 6d 3b 0a 20 20 return pTerm;.
24a0: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
24b0: 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 }. }.
24c0: 20 20 70 57 43 20 3d 20 70 57 43 2d 3e 70 4f 75 pWC = pWC->pOu
24d0: 74 65 72 3b 0a 20 20 20 20 20 20 6b 20 3d 20 30 ter;. k = 0
24e0: 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 70 57 ;. }while( pW
24f0: 43 21 3d 30 20 29 3b 0a 20 20 20 20 69 66 28 20 C!=0 );. if(
2500: 70 53 63 61 6e 2d 3e 69 45 71 75 69 76 3e 3d 70 pScan->iEquiv>=p
2510: 53 63 61 6e 2d 3e 6e 45 71 75 69 76 20 29 20 62 Scan->nEquiv ) b
2520: 72 65 61 6b 3b 0a 20 20 20 20 70 57 43 20 3d 20 reak;. pWC =
2530: 70 53 63 61 6e 2d 3e 70 4f 72 69 67 57 43 3b 0a pScan->pOrigWC;.
2540: 20 20 20 20 6b 20 3d 20 30 3b 0a 20 20 20 20 70 k = 0;. p
2550: 53 63 61 6e 2d 3e 69 45 71 75 69 76 2b 2b 3b 0a Scan->iEquiv++;.
2560: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a }. return 0;.
2570: 7d 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c }../*.** Initial
2580: 69 7a 65 20 61 20 57 48 45 52 45 20 63 6c 61 75 ize a WHERE clau
2590: 73 65 20 73 63 61 6e 6e 65 72 20 6f 62 6a 65 63 se scanner objec
25a0: 74 2e 20 20 52 65 74 75 72 6e 20 61 20 70 6f 69 t. Return a poi
25b0: 6e 74 65 72 20 74 6f 20 74 68 65 0a 2a 2a 20 66 nter to the.** f
25c0: 69 72 73 74 20 6d 61 74 63 68 2e 20 20 52 65 74 irst match. Ret
25d0: 75 72 6e 20 4e 55 4c 4c 20 69 66 20 74 68 65 72 urn NULL if ther
25e0: 65 20 61 72 65 20 6e 6f 20 6d 61 74 63 68 65 73 e are no matches
25f0: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 73 63 61 6e ..**.** The scan
2600: 6e 65 72 20 77 69 6c 6c 20 62 65 20 73 65 61 72 ner will be sear
2610: 63 68 69 6e 67 20 74 68 65 20 57 48 45 52 45 20 ching the WHERE
2620: 63 6c 61 75 73 65 20 70 57 43 2e 20 20 49 74 20 clause pWC. It
2630: 77 69 6c 6c 20 6c 6f 6f 6b 0a 2a 2a 20 66 6f 72 will look.** for
2640: 20 74 65 72 6d 73 20 6f 66 20 74 68 65 20 66 6f terms of the fo
2650: 72 6d 20 22 58 20 3c 6f 70 3e 20 3c 65 78 70 72 rm "X <op> <expr
2660: 3e 22 20 77 68 65 72 65 20 58 20 69 73 20 63 6f >" where X is co
2670: 6c 75 6d 6e 20 69 43 6f 6c 75 6d 6e 20 6f 66 20 lumn iColumn of
2680: 74 61 62 6c 65 0a 2a 2a 20 69 43 75 72 2e 20 20 table.** iCur.
2690: 20 4f 72 20 69 66 20 70 49 64 78 21 3d 30 20 74 Or if pIdx!=0 t
26a0: 68 65 6e 20 58 20 69 73 20 63 6f 6c 75 6d 6e 20 hen X is column
26b0: 69 43 6f 6c 75 6d 6e 20 6f 66 20 69 6e 64 65 78 iColumn of index
26c0: 20 70 49 64 78 2e 20 20 70 49 64 78 0a 2a 2a 20 pIdx. pIdx.**
26d0: 6d 75 73 74 20 62 65 20 6f 6e 65 20 6f 66 20 74 must be one of t
26e0: 68 65 20 69 6e 64 65 78 65 73 20 6f 66 20 74 61 he indexes of ta
26f0: 62 6c 65 20 69 43 75 72 2e 0a 2a 2a 0a 2a 2a 20 ble iCur..**.**
2700: 54 68 65 20 3c 6f 70 3e 20 6d 75 73 74 20 62 65 The <op> must be
2710: 20 6f 6e 65 20 6f 66 20 74 68 65 20 6f 70 65 72 one of the oper
2720: 61 74 6f 72 73 20 64 65 73 63 72 69 62 65 64 20 ators described
2730: 62 79 20 6f 70 4d 61 73 6b 2e 0a 2a 2a 0a 2a 2a by opMask..**.**
2740: 20 49 66 20 74 68 65 20 73 65 61 72 63 68 20 69 If the search i
2750: 73 20 66 6f 72 20 58 20 61 6e 64 20 74 68 65 20 s for X and the
2760: 57 48 45 52 45 20 63 6c 61 75 73 65 20 63 6f 6e WHERE clause con
2770: 74 61 69 6e 73 20 74 65 72 6d 73 20 6f 66 20 74 tains terms of t
2780: 68 65 0a 2a 2a 20 66 6f 72 6d 20 58 3d 59 20 74 he.** form X=Y t
2790: 68 65 6e 20 74 68 69 73 20 72 6f 75 74 69 6e 65 hen this routine
27a0: 20 6d 69 67 68 74 20 61 6c 73 6f 20 72 65 74 75 might also retu
27b0: 72 6e 20 74 65 72 6d 73 20 6f 66 20 74 68 65 20 rn terms of the
27c0: 66 6f 72 6d 0a 2a 2a 20 22 59 20 3c 6f 70 3e 20 form.** "Y <op>
27d0: 3c 65 78 70 72 3e 22 2e 20 20 54 68 65 20 6e 75 <expr>". The nu
27e0: 6d 62 65 72 20 6f 66 20 6c 65 76 65 6c 73 20 6f mber of levels o
27f0: 66 20 74 72 61 6e 73 69 74 69 76 69 74 79 20 69 f transitivity i
2800: 73 20 6c 69 6d 69 74 65 64 2c 0a 2a 2a 20 62 75 s limited,.** bu
2810: 74 20 69 73 20 65 6e 6f 75 67 68 20 74 6f 20 68 t is enough to h
2820: 61 6e 64 6c 65 20 6d 6f 73 74 20 63 6f 6d 6d 6f andle most commo
2830: 6e 6c 79 20 6f 63 63 75 72 72 69 6e 67 20 53 51 nly occurring SQ
2840: 4c 20 73 74 61 74 65 6d 65 6e 74 73 2e 0a 2a 2a L statements..**
2850: 0a 2a 2a 20 49 66 20 58 20 69 73 20 6e 6f 74 20 .** If X is not
2860: 74 68 65 20 49 4e 54 45 47 45 52 20 50 52 49 4d the INTEGER PRIM
2870: 41 52 59 20 4b 45 59 20 74 68 65 6e 20 58 20 6d ARY KEY then X m
2880: 75 73 74 20 62 65 20 63 6f 6d 70 61 74 69 62 6c ust be compatibl
2890: 65 20 77 69 74 68 0a 2a 2a 20 69 6e 64 65 78 20 e with.** index
28a0: 70 49 64 78 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 pIdx..*/.static
28b0: 57 68 65 72 65 54 65 72 6d 20 2a 77 68 65 72 65 WhereTerm *where
28c0: 53 63 61 6e 49 6e 69 74 28 0a 20 20 57 68 65 72 ScanInit(. Wher
28d0: 65 53 63 61 6e 20 2a 70 53 63 61 6e 2c 20 20 20 eScan *pScan,
28e0: 20 20 20 20 2f 2a 20 54 68 65 20 57 68 65 72 65 /* The Where
28f0: 53 63 61 6e 20 6f 62 6a 65 63 74 20 62 65 69 6e Scan object bein
2900: 67 20 69 6e 69 74 69 61 6c 69 7a 65 64 20 2a 2f g initialized */
2910: 0a 20 20 57 68 65 72 65 43 6c 61 75 73 65 20 2a . WhereClause *
2920: 70 57 43 2c 20 20 20 20 20 20 20 2f 2a 20 54 68 pWC, /* Th
2930: 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 74 e WHERE clause t
2940: 6f 20 62 65 20 73 63 61 6e 6e 65 64 20 2a 2f 0a o be scanned */.
2950: 20 20 69 6e 74 20 69 43 75 72 2c 20 20 20 20 20 int iCur,
2960: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 72 /* Cur
2970: 73 6f 72 20 74 6f 20 73 63 61 6e 20 66 6f 72 20 sor to scan for
2980: 2a 2f 0a 20 20 69 6e 74 20 69 43 6f 6c 75 6d 6e */. int iColumn
2990: 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 , /*
29a0: 43 6f 6c 75 6d 6e 20 74 6f 20 73 63 61 6e 20 66 Column to scan f
29b0: 6f 72 20 2a 2f 0a 20 20 75 33 32 20 6f 70 4d 61 or */. u32 opMa
29c0: 73 6b 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 sk,
29d0: 2f 2a 20 4f 70 65 72 61 74 6f 72 28 73 29 20 74 /* Operator(s) t
29e0: 6f 20 73 63 61 6e 20 66 6f 72 20 2a 2f 0a 20 20 o scan for */.
29f0: 49 6e 64 65 78 20 2a 70 49 64 78 20 20 20 20 20 Index *pIdx
2a00: 20 20 20 20 20 20 20 20 2f 2a 20 4d 75 73 74 20 /* Must
2a10: 62 65 20 63 6f 6d 70 61 74 69 62 6c 65 20 77 69 be compatible wi
2a20: 74 68 20 74 68 69 73 20 69 6e 64 65 78 20 2a 2f th this index */
2a30: 0a 29 7b 0a 20 20 70 53 63 61 6e 2d 3e 70 4f 72 .){. pScan->pOr
2a40: 69 67 57 43 20 3d 20 70 57 43 3b 0a 20 20 70 53 igWC = pWC;. pS
2a50: 63 61 6e 2d 3e 70 57 43 20 3d 20 70 57 43 3b 0a can->pWC = pWC;.
2a60: 20 20 70 53 63 61 6e 2d 3e 70 49 64 78 45 78 70 pScan->pIdxExp
2a70: 72 20 3d 20 30 3b 0a 20 20 70 53 63 61 6e 2d 3e r = 0;. pScan->
2a80: 69 64 78 61 66 66 20 3d 20 30 3b 0a 20 20 70 53 idxaff = 0;. pS
2a90: 63 61 6e 2d 3e 7a 43 6f 6c 6c 4e 61 6d 65 20 3d can->zCollName =
2aa0: 20 30 3b 0a 20 20 69 66 28 20 70 49 64 78 20 29 0;. if( pIdx )
2ab0: 7b 0a 20 20 20 20 69 6e 74 20 6a 20 3d 20 69 43 {. int j = iC
2ac0: 6f 6c 75 6d 6e 3b 0a 20 20 20 20 69 43 6f 6c 75 olumn;. iColu
2ad0: 6d 6e 20 3d 20 70 49 64 78 2d 3e 61 69 43 6f 6c mn = pIdx->aiCol
2ae0: 75 6d 6e 5b 6a 5d 3b 0a 20 20 20 20 69 66 28 20 umn[j];. if(
2af0: 69 43 6f 6c 75 6d 6e 3d 3d 58 4e 5f 45 58 50 52 iColumn==XN_EXPR
2b00: 20 29 7b 0a 20 20 20 20 20 20 70 53 63 61 6e 2d ){. pScan-
2b10: 3e 70 49 64 78 45 78 70 72 20 3d 20 70 49 64 78 >pIdxExpr = pIdx
2b20: 2d 3e 61 43 6f 6c 45 78 70 72 2d 3e 61 5b 6a 5d ->aColExpr->a[j]
2b30: 2e 70 45 78 70 72 3b 0a 20 20 20 20 20 20 70 53 .pExpr;. pS
2b40: 63 61 6e 2d 3e 7a 43 6f 6c 6c 4e 61 6d 65 20 3d can->zCollName =
2b50: 20 70 49 64 78 2d 3e 61 7a 43 6f 6c 6c 5b 6a 5d pIdx->azColl[j]
2b60: 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 ;. }else if(
2b70: 69 43 6f 6c 75 6d 6e 3d 3d 70 49 64 78 2d 3e 70 iColumn==pIdx->p
2b80: 54 61 62 6c 65 2d 3e 69 50 4b 65 79 20 29 7b 0a Table->iPKey ){.
2b90: 20 20 20 20 20 20 69 43 6f 6c 75 6d 6e 20 3d 20 iColumn =
2ba0: 58 4e 5f 52 4f 57 49 44 3b 0a 20 20 20 20 7d 65 XN_ROWID;. }e
2bb0: 6c 73 65 20 69 66 28 20 69 43 6f 6c 75 6d 6e 3e lse if( iColumn>
2bc0: 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 53 63 61 =0 ){. pSca
2bd0: 6e 2d 3e 69 64 78 61 66 66 20 3d 20 70 49 64 78 n->idxaff = pIdx
2be0: 2d 3e 70 54 61 62 6c 65 2d 3e 61 43 6f 6c 5b 69 ->pTable->aCol[i
2bf0: 43 6f 6c 75 6d 6e 5d 2e 61 66 66 69 6e 69 74 79 Column].affinity
2c00: 3b 0a 20 20 20 20 20 20 70 53 63 61 6e 2d 3e 7a ;. pScan->z
2c10: 43 6f 6c 6c 4e 61 6d 65 20 3d 20 70 49 64 78 2d CollName = pIdx-
2c20: 3e 61 7a 43 6f 6c 6c 5b 6a 5d 3b 0a 20 20 20 20 >azColl[j];.
2c30: 7d 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 69 43 }. }else if( iC
2c40: 6f 6c 75 6d 6e 3d 3d 58 4e 5f 45 58 50 52 20 29 olumn==XN_EXPR )
2c50: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a {. return 0;.
2c60: 20 20 7d 0a 20 20 70 53 63 61 6e 2d 3e 6f 70 4d }. pScan->opM
2c70: 61 73 6b 20 3d 20 6f 70 4d 61 73 6b 3b 0a 20 20 ask = opMask;.
2c80: 70 53 63 61 6e 2d 3e 6b 20 3d 20 30 3b 0a 20 20 pScan->k = 0;.
2c90: 70 53 63 61 6e 2d 3e 61 69 43 75 72 5b 30 5d 20 pScan->aiCur[0]
2ca0: 3d 20 69 43 75 72 3b 0a 20 20 70 53 63 61 6e 2d = iCur;. pScan-
2cb0: 3e 61 69 43 6f 6c 75 6d 6e 5b 30 5d 20 3d 20 69 >aiColumn[0] = i
2cc0: 43 6f 6c 75 6d 6e 3b 0a 20 20 70 53 63 61 6e 2d Column;. pScan-
2cd0: 3e 6e 45 71 75 69 76 20 3d 20 31 3b 0a 20 20 70 >nEquiv = 1;. p
2ce0: 53 63 61 6e 2d 3e 69 45 71 75 69 76 20 3d 20 31 Scan->iEquiv = 1
2cf0: 3b 0a 20 20 72 65 74 75 72 6e 20 77 68 65 72 65 ;. return where
2d00: 53 63 61 6e 4e 65 78 74 28 70 53 63 61 6e 29 3b ScanNext(pScan);
2d10: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 53 65 61 72 63 68 .}../*.** Search
2d20: 20 66 6f 72 20 61 20 74 65 72 6d 20 69 6e 20 74 for a term in t
2d30: 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 he WHERE clause
2d40: 74 68 61 74 20 69 73 20 6f 66 20 74 68 65 20 66 that is of the f
2d50: 6f 72 6d 20 22 58 20 3c 6f 70 3e 20 3c 65 78 70 orm "X <op> <exp
2d60: 72 3e 22 0a 2a 2a 20 77 68 65 72 65 20 58 20 69 r>".** where X i
2d70: 73 20 61 20 72 65 66 65 72 65 6e 63 65 20 74 6f s a reference to
2d80: 20 74 68 65 20 69 43 6f 6c 75 6d 6e 20 6f 66 20 the iColumn of
2d90: 74 61 62 6c 65 20 69 43 75 72 20 6f 72 20 6f 66 table iCur or of
2da0: 20 69 6e 64 65 78 20 70 49 64 78 0a 2a 2a 20 69 index pIdx.** i
2db0: 66 20 70 49 64 78 21 3d 30 20 61 6e 64 20 3c 6f f pIdx!=0 and <o
2dc0: 70 3e 20 69 73 20 6f 6e 65 20 6f 66 20 74 68 65 p> is one of the
2dd0: 20 57 4f 5f 78 78 20 6f 70 65 72 61 74 6f 72 20 WO_xx operator
2de0: 63 6f 64 65 73 20 73 70 65 63 69 66 69 65 64 20 codes specified
2df0: 62 79 0a 2a 2a 20 74 68 65 20 6f 70 20 70 61 72 by.** the op par
2e00: 61 6d 65 74 65 72 2e 20 20 52 65 74 75 72 6e 20 ameter. Return
2e10: 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 a pointer to the
2e20: 20 74 65 72 6d 2e 20 20 52 65 74 75 72 6e 20 30 term. Return 0
2e30: 20 69 66 20 6e 6f 74 20 66 6f 75 6e 64 2e 0a 2a if not found..*
2e40: 2a 0a 2a 2a 20 49 66 20 70 49 64 78 21 3d 30 20 *.** If pIdx!=0
2e50: 74 68 65 6e 20 69 74 20 6d 75 73 74 20 62 65 20 then it must be
2e60: 6f 6e 65 20 6f 66 20 74 68 65 20 69 6e 64 65 78 one of the index
2e70: 65 73 20 6f 66 20 74 61 62 6c 65 20 69 43 75 72 es of table iCur
2e80: 2e 20 20 0a 2a 2a 20 53 65 61 72 63 68 20 66 6f . .** Search fo
2e90: 72 20 74 65 72 6d 73 20 6d 61 74 63 68 69 6e 67 r terms matching
2ea0: 20 74 68 65 20 69 43 6f 6c 75 6d 6e 2d 74 68 20 the iColumn-th
2eb0: 63 6f 6c 75 6d 6e 20 6f 66 20 70 49 64 78 0a 2a column of pIdx.*
2ec0: 2a 20 72 61 74 68 65 72 20 74 68 61 6e 20 74 68 * rather than th
2ed0: 65 20 69 43 6f 6c 75 6d 6e 2d 74 68 20 63 6f 6c e iColumn-th col
2ee0: 75 6d 6e 20 6f 66 20 74 61 62 6c 65 20 69 43 75 umn of table iCu
2ef0: 72 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 74 65 72 r..**.** The ter
2f00: 6d 20 72 65 74 75 72 6e 65 64 20 6d 69 67 68 74 m returned might
2f10: 20 62 79 20 59 3d 3c 65 78 70 72 3e 20 69 66 20 by Y=<expr> if
2f20: 74 68 65 72 65 20 69 73 20 61 6e 6f 74 68 65 72 there is another
2f30: 20 63 6f 6e 73 74 72 61 69 6e 74 20 69 6e 0a 2a constraint in.*
2f40: 2a 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 * the WHERE clau
2f50: 73 65 20 74 68 61 74 20 73 70 65 63 69 66 69 65 se that specifie
2f60: 73 20 74 68 61 74 20 58 3d 59 2e 20 20 41 6e 79 s that X=Y. Any
2f70: 20 73 75 63 68 20 63 6f 6e 73 74 72 61 69 6e 74 such constraint
2f80: 73 20 77 69 6c 6c 20 62 65 0a 2a 2a 20 69 64 65 s will be.** ide
2f90: 6e 74 69 66 69 65 64 20 62 79 20 74 68 65 20 57 ntified by the W
2fa0: 4f 5f 45 51 55 49 56 20 62 69 74 20 69 6e 20 74 O_EQUIV bit in t
2fb0: 68 65 20 70 54 65 72 6d 2d 3e 65 4f 70 65 72 61 he pTerm->eOpera
2fc0: 74 6f 72 20 66 69 65 6c 64 2e 20 20 54 68 65 0a tor field. The.
2fd0: 2a 2a 20 61 69 43 75 72 5b 5d 2f 69 61 43 6f 6c ** aiCur[]/iaCol
2fe0: 75 6d 6e 5b 5d 20 61 72 72 61 79 73 20 68 6f 6c umn[] arrays hol
2ff0: 64 20 58 20 61 6e 64 20 61 6c 6c 20 69 74 73 20 d X and all its
3000: 65 71 75 69 76 61 6c 65 6e 74 73 2e 20 54 68 65 equivalents. The
3010: 72 65 20 61 72 65 20 31 31 0a 2a 2a 20 73 6c 6f re are 11.** slo
3020: 74 73 20 69 6e 20 61 69 43 75 72 5b 5d 2f 61 69 ts in aiCur[]/ai
3030: 43 6f 6c 75 6d 6e 5b 5d 20 73 6f 20 74 68 61 74 Column[] so that
3040: 20 6d 65 61 6e 73 20 77 65 20 63 61 6e 20 6c 6f means we can lo
3050: 6f 6b 20 66 6f 72 20 58 20 70 6c 75 73 20 75 70 ok for X plus up
3060: 20 74 6f 20 31 30 0a 2a 2a 20 6f 74 68 65 72 20 to 10.** other
3070: 65 71 75 69 76 61 6c 65 6e 74 20 76 61 6c 75 65 equivalent value
3080: 73 2e 20 20 48 65 6e 63 65 20 61 20 73 65 61 72 s. Hence a sear
3090: 63 68 20 66 6f 72 20 58 20 77 69 6c 6c 20 72 65 ch for X will re
30a0: 74 75 72 6e 20 3c 65 78 70 72 3e 20 69 66 20 58 turn <expr> if X
30b0: 3d 41 31 0a 2a 2a 20 61 6e 64 20 41 31 3d 41 32 =A1.** and A1=A2
30c0: 20 61 6e 64 20 41 32 3d 41 33 20 61 6e 64 20 2e and A2=A3 and .
30d0: 2e 2e 20 61 6e 64 20 41 39 3d 41 31 30 20 61 6e .. and A9=A10 an
30e0: 64 20 41 31 30 3d 3c 65 78 70 72 3e 2e 0a 2a 2a d A10=<expr>..**
30f0: 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 .** If there are
3100: 20 6d 75 6c 74 69 70 6c 65 20 74 65 72 6d 73 20 multiple terms
3110: 69 6e 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 in the WHERE cla
3120: 75 73 65 20 6f 66 20 74 68 65 20 66 6f 72 6d 20 use of the form
3130: 22 58 20 3c 6f 70 3e 20 3c 65 78 70 72 3e 22 0a "X <op> <expr>".
3140: 2a 2a 20 74 68 65 6e 20 74 72 79 20 66 6f 72 20 ** then try for
3150: 74 68 65 20 6f 6e 65 20 77 69 74 68 20 6e 6f 20 the one with no
3160: 64 65 70 65 6e 64 65 6e 63 69 65 73 20 6f 6e 20 dependencies on
3170: 3c 65 78 70 72 3e 20 2d 20 69 6e 20 6f 74 68 65 <expr> - in othe
3180: 72 20 77 6f 72 64 73 20 77 68 65 72 65 0a 2a 2a r words where.**
3190: 20 3c 65 78 70 72 3e 20 69 73 20 61 20 63 6f 6e <expr> is a con
31a0: 73 74 61 6e 74 20 65 78 70 72 65 73 73 69 6f 6e stant expression
31b0: 20 6f 66 20 73 6f 6d 65 20 6b 69 6e 64 2e 20 20 of some kind.
31c0: 4f 6e 6c 79 20 72 65 74 75 72 6e 20 65 6e 74 72 Only return entr
31d0: 69 65 73 20 6f 66 0a 2a 2a 20 74 68 65 20 66 6f ies of.** the fo
31e0: 72 6d 20 22 58 20 3c 6f 70 3e 20 59 22 20 77 68 rm "X <op> Y" wh
31f0: 65 72 65 20 59 20 69 73 20 61 20 63 6f 6c 75 6d ere Y is a colum
3200: 6e 20 69 6e 20 61 6e 6f 74 68 65 72 20 74 61 62 n in another tab
3210: 6c 65 20 69 66 20 6e 6f 20 74 65 72 6d 73 20 6f le if no terms o
3220: 66 0a 2a 2a 20 74 68 65 20 66 6f 72 6d 20 22 58 f.** the form "X
3230: 20 3c 6f 70 3e 20 3c 63 6f 6e 73 74 2d 65 78 70 <op> <const-exp
3240: 72 3e 22 20 65 78 69 73 74 2e 20 20 20 49 66 20 r>" exist. If
3250: 6e 6f 20 74 65 72 6d 73 20 77 69 74 68 20 61 20 no terms with a
3260: 63 6f 6e 73 74 61 6e 74 20 52 48 53 0a 2a 2a 20 constant RHS.**
3270: 65 78 69 73 74 2c 20 74 72 79 20 74 6f 20 72 65 exist, try to re
3280: 74 75 72 6e 20 61 20 74 65 72 6d 20 74 68 61 74 turn a term that
3290: 20 64 6f 65 73 20 6e 6f 74 20 75 73 65 20 57 4f does not use WO
32a0: 5f 45 51 55 49 56 2e 0a 2a 2f 0a 57 68 65 72 65 _EQUIV..*/.Where
32b0: 54 65 72 6d 20 2a 73 71 6c 69 74 65 33 57 68 65 Term *sqlite3Whe
32c0: 72 65 46 69 6e 64 54 65 72 6d 28 0a 20 20 57 68 reFindTerm(. Wh
32d0: 65 72 65 43 6c 61 75 73 65 20 2a 70 57 43 2c 20 ereClause *pWC,
32e0: 20 20 20 20 2f 2a 20 54 68 65 20 57 48 45 52 45 /* The WHERE
32f0: 20 63 6c 61 75 73 65 20 74 6f 20 62 65 20 73 65 clause to be se
3300: 61 72 63 68 65 64 20 2a 2f 0a 20 20 69 6e 74 20 arched */. int
3310: 69 43 75 72 2c 20 20 20 20 20 20 20 20 20 20 20 iCur,
3320: 20 20 2f 2a 20 43 75 72 73 6f 72 20 6e 75 6d 62 /* Cursor numb
3330: 65 72 20 6f 66 20 4c 48 53 20 2a 2f 0a 20 20 69 er of LHS */. i
3340: 6e 74 20 69 43 6f 6c 75 6d 6e 2c 20 20 20 20 20 nt iColumn,
3350: 20 20 20 20 20 2f 2a 20 43 6f 6c 75 6d 6e 20 6e /* Column n
3360: 75 6d 62 65 72 20 6f 66 20 4c 48 53 20 2a 2f 0a umber of LHS */.
3370: 20 20 42 69 74 6d 61 73 6b 20 6e 6f 74 52 65 61 Bitmask notRea
3380: 64 79 2c 20 20 20 20 20 2f 2a 20 52 48 53 20 6d dy, /* RHS m
3390: 75 73 74 20 6e 6f 74 20 6f 76 65 72 6c 61 70 20 ust not overlap
33a0: 77 69 74 68 20 74 68 69 73 20 6d 61 73 6b 20 2a with this mask *
33b0: 2f 0a 20 20 75 33 32 20 6f 70 2c 20 20 20 20 20 /. u32 op,
33c0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 /* Mas
33d0: 6b 20 6f 66 20 57 4f 5f 78 78 20 76 61 6c 75 65 k of WO_xx value
33e0: 73 20 64 65 73 63 72 69 62 69 6e 67 20 6f 70 65 s describing ope
33f0: 72 61 74 6f 72 20 2a 2f 0a 20 20 49 6e 64 65 78 rator */. Index
3400: 20 2a 70 49 64 78 20 20 20 20 20 20 20 20 20 20 *pIdx
3410: 20 2f 2a 20 4d 75 73 74 20 62 65 20 63 6f 6d 70 /* Must be comp
3420: 61 74 69 62 6c 65 20 77 69 74 68 20 74 68 69 73 atible with this
3430: 20 69 6e 64 65 78 2c 20 69 66 20 6e 6f 74 20 4e index, if not N
3440: 55 4c 4c 20 2a 2f 0a 29 7b 0a 20 20 57 68 65 72 ULL */.){. Wher
3450: 65 54 65 72 6d 20 2a 70 52 65 73 75 6c 74 20 3d eTerm *pResult =
3460: 20 30 3b 0a 20 20 57 68 65 72 65 54 65 72 6d 20 0;. WhereTerm
3470: 2a 70 3b 0a 20 20 57 68 65 72 65 53 63 61 6e 20 *p;. WhereScan
3480: 73 63 61 6e 3b 0a 0a 20 20 70 20 3d 20 77 68 65 scan;.. p = whe
3490: 72 65 53 63 61 6e 49 6e 69 74 28 26 73 63 61 6e reScanInit(&scan
34a0: 2c 20 70 57 43 2c 20 69 43 75 72 2c 20 69 43 6f , pWC, iCur, iCo
34b0: 6c 75 6d 6e 2c 20 6f 70 2c 20 70 49 64 78 29 3b lumn, op, pIdx);
34c0: 0a 20 20 6f 70 20 26 3d 20 57 4f 5f 45 51 7c 57 . op &= WO_EQ|W
34d0: 4f 5f 49 53 3b 0a 20 20 77 68 69 6c 65 28 20 70 O_IS;. while( p
34e0: 20 29 7b 0a 20 20 20 20 69 66 28 20 28 70 2d 3e ){. if( (p->
34f0: 70 72 65 72 65 71 52 69 67 68 74 20 26 20 6e 6f prereqRight & no
3500: 74 52 65 61 64 79 29 3d 3d 30 20 29 7b 0a 20 20 tReady)==0 ){.
3510: 20 20 20 20 69 66 28 20 70 2d 3e 70 72 65 72 65 if( p->prere
3520: 71 52 69 67 68 74 3d 3d 30 20 26 26 20 28 70 2d qRight==0 && (p-
3530: 3e 65 4f 70 65 72 61 74 6f 72 26 6f 70 29 21 3d >eOperator&op)!=
3540: 30 20 29 7b 0a 20 20 20 20 20 20 20 20 74 65 73 0 ){. tes
3550: 74 63 61 73 65 28 20 70 2d 3e 65 4f 70 65 72 61 tcase( p->eOpera
3560: 74 6f 72 20 26 20 57 4f 5f 49 53 20 29 3b 0a 20 tor & WO_IS );.
3570: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 70 3b return p;
3580: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 . }. i
3590: 66 28 20 70 52 65 73 75 6c 74 3d 3d 30 20 29 20 f( pResult==0 )
35a0: 70 52 65 73 75 6c 74 20 3d 20 70 3b 0a 20 20 20 pResult = p;.
35b0: 20 7d 0a 20 20 20 20 70 20 3d 20 77 68 65 72 65 }. p = where
35c0: 53 63 61 6e 4e 65 78 74 28 26 73 63 61 6e 29 3b ScanNext(&scan);
35d0: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 52 . }. return pR
35e0: 65 73 75 6c 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 esult;.}../*.**
35f0: 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 73 65 This function se
3600: 61 72 63 68 65 73 20 70 4c 69 73 74 20 66 6f 72 arches pList for
3610: 20 61 6e 20 65 6e 74 72 79 20 74 68 61 74 20 6d an entry that m
3620: 61 74 63 68 65 73 20 74 68 65 20 69 43 6f 6c 2d atches the iCol-
3630: 74 68 20 63 6f 6c 75 6d 6e 0a 2a 2a 20 6f 66 20 th column.** of
3640: 69 6e 64 65 78 20 70 49 64 78 2e 0a 2a 2a 0a 2a index pIdx..**.*
3650: 2a 20 49 66 20 73 75 63 68 20 61 6e 20 65 78 70 * If such an exp
3660: 72 65 73 73 69 6f 6e 20 69 73 20 66 6f 75 6e 64 ression is found
3670: 2c 20 69 74 73 20 69 6e 64 65 78 20 69 6e 20 70 , its index in p
3680: 4c 69 73 74 2d 3e 61 5b 5d 20 69 73 20 72 65 74 List->a[] is ret
3690: 75 72 6e 65 64 2e 20 49 66 0a 2a 2a 20 6e 6f 20 urned. If.** no
36a0: 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 66 6f expression is fo
36b0: 75 6e 64 2c 20 2d 31 20 69 73 20 72 65 74 75 72 und, -1 is retur
36c0: 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 ned..*/.static i
36d0: 6e 74 20 66 69 6e 64 49 6e 64 65 78 43 6f 6c 28 nt findIndexCol(
36e0: 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 . Parse *pParse
36f0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
3700: 20 20 20 2f 2a 20 50 61 72 73 65 20 63 6f 6e 74 /* Parse cont
3710: 65 78 74 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 ext */. ExprLis
3720: 74 20 2a 70 4c 69 73 74 2c 20 20 20 20 20 20 20 t *pList,
3730: 20 20 20 20 20 20 20 20 20 2f 2a 20 45 78 70 72 /* Expr
3740: 65 73 73 69 6f 6e 20 6c 69 73 74 20 74 6f 20 73 ession list to s
3750: 65 61 72 63 68 20 2a 2f 0a 20 20 69 6e 74 20 69 earch */. int i
3760: 42 61 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 Base,
3770: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 75 /* Cu
3780: 72 73 6f 72 20 66 6f 72 20 74 61 62 6c 65 20 61 rsor for table a
3790: 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 20 70 ssociated with p
37a0: 49 64 78 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a Idx */. Index *
37b0: 70 49 64 78 2c 20 20 20 20 20 20 20 20 20 20 20 pIdx,
37c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 /* Inde
37d0: 78 20 74 6f 20 6d 61 74 63 68 20 63 6f 6c 75 6d x to match colum
37e0: 6e 20 6f 66 20 2a 2f 0a 20 20 69 6e 74 20 69 43 n of */. int iC
37f0: 6f 6c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ol
3800: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6c /* Col
3810: 75 6d 6e 20 6f 66 20 69 6e 64 65 78 20 74 6f 20 umn of index to
3820: 6d 61 74 63 68 20 2a 2f 0a 29 7b 0a 20 20 69 6e match */.){. in
3830: 74 20 69 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 t i;. const cha
3840: 72 20 2a 7a 43 6f 6c 6c 20 3d 20 70 49 64 78 2d r *zColl = pIdx-
3850: 3e 61 7a 43 6f 6c 6c 5b 69 43 6f 6c 5d 3b 0a 0a >azColl[iCol];..
3860: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 4c 69 for(i=0; i<pLi
3870: 73 74 2d 3e 6e 45 78 70 72 3b 20 69 2b 2b 29 7b st->nExpr; i++){
3880: 0a 20 20 20 20 45 78 70 72 20 2a 70 20 3d 20 73 . Expr *p = s
3890: 71 6c 69 74 65 33 45 78 70 72 53 6b 69 70 43 6f qlite3ExprSkipCo
38a0: 6c 6c 61 74 65 28 70 4c 69 73 74 2d 3e 61 5b 69 llate(pList->a[i
38b0: 5d 2e 70 45 78 70 72 29 3b 0a 20 20 20 20 69 66 ].pExpr);. if
38c0: 28 20 70 2d 3e 6f 70 3d 3d 54 4b 5f 43 4f 4c 55 ( p->op==TK_COLU
38d0: 4d 4e 0a 20 20 20 20 20 26 26 20 70 2d 3e 69 43 MN. && p->iC
38e0: 6f 6c 75 6d 6e 3d 3d 70 49 64 78 2d 3e 61 69 43 olumn==pIdx->aiC
38f0: 6f 6c 75 6d 6e 5b 69 43 6f 6c 5d 0a 20 20 20 20 olumn[iCol].
3900: 20 26 26 20 70 2d 3e 69 54 61 62 6c 65 3d 3d 69 && p->iTable==i
3910: 42 61 73 65 0a 20 20 20 20 29 7b 0a 20 20 20 20 Base. ){.
3920: 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c CollSeq *pColl
3930: 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 4e 4e = sqlite3ExprNN
3940: 43 6f 6c 6c 53 65 71 28 70 50 61 72 73 65 2c 20 CollSeq(pParse,
3950: 70 4c 69 73 74 2d 3e 61 5b 69 5d 2e 70 45 78 70 pList->a[i].pExp
3960: 72 29 3b 0a 20 20 20 20 20 20 69 66 28 20 30 3d r);. if( 0=
3970: 3d 73 71 6c 69 74 65 33 53 74 72 49 43 6d 70 28 =sqlite3StrICmp(
3980: 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 2c 20 7a 43 pColl->zName, zC
3990: 6f 6c 6c 29 20 29 7b 0a 20 20 20 20 20 20 20 20 oll) ){.
39a0: 72 65 74 75 72 6e 20 69 3b 0a 20 20 20 20 20 20 return i;.
39b0: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 }. }. }.. r
39c0: 65 74 75 72 6e 20 2d 31 3b 0a 7d 0a 0a 2f 2a 0a eturn -1;.}../*.
39d0: 2a 2a 20 52 65 74 75 72 6e 20 54 52 55 45 20 69 ** Return TRUE i
39e0: 66 20 74 68 65 20 69 43 6f 6c 2d 74 68 20 63 6f f the iCol-th co
39f0: 6c 75 6d 6e 20 6f 66 20 69 6e 64 65 78 20 70 49 lumn of index pI
3a00: 64 78 20 69 73 20 4e 4f 54 20 4e 55 4c 4c 0a 2a dx is NOT NULL.*
3a10: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 69 6e 64 /.static int ind
3a20: 65 78 43 6f 6c 75 6d 6e 4e 6f 74 4e 75 6c 6c 28 exColumnNotNull(
3a30: 49 6e 64 65 78 20 2a 70 49 64 78 2c 20 69 6e 74 Index *pIdx, int
3a40: 20 69 43 6f 6c 29 7b 0a 20 20 69 6e 74 20 6a 3b iCol){. int j;
3a50: 0a 20 20 61 73 73 65 72 74 28 20 70 49 64 78 21 . assert( pIdx!
3a60: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
3a70: 69 43 6f 6c 3e 3d 30 20 26 26 20 69 43 6f 6c 3c iCol>=0 && iCol<
3a80: 70 49 64 78 2d 3e 6e 43 6f 6c 75 6d 6e 20 29 3b pIdx->nColumn );
3a90: 0a 20 20 6a 20 3d 20 70 49 64 78 2d 3e 61 69 43 . j = pIdx->aiC
3aa0: 6f 6c 75 6d 6e 5b 69 43 6f 6c 5d 3b 0a 20 20 69 olumn[iCol];. i
3ab0: 66 28 20 6a 3e 3d 30 20 29 7b 0a 20 20 20 20 72 f( j>=0 ){. r
3ac0: 65 74 75 72 6e 20 70 49 64 78 2d 3e 70 54 61 62 eturn pIdx->pTab
3ad0: 6c 65 2d 3e 61 43 6f 6c 5b 6a 5d 2e 6e 6f 74 4e le->aCol[j].notN
3ae0: 75 6c 6c 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 ull;. }else if(
3af0: 20 6a 3d 3d 28 2d 31 29 20 29 7b 0a 20 20 20 20 j==(-1) ){.
3b00: 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 65 6c 73 return 1;. }els
3b10: 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 6a e{. assert( j
3b20: 3d 3d 28 2d 32 29 20 29 3b 0a 20 20 20 20 72 65 ==(-2) );. re
3b30: 74 75 72 6e 20 30 3b 20 20 2f 2a 20 41 73 73 75 turn 0; /* Assu
3b40: 6d 65 20 61 6e 20 69 6e 64 65 78 65 64 20 65 78 me an indexed ex
3b50: 70 72 65 73 73 69 6f 6e 20 63 61 6e 20 61 6c 77 pression can alw
3b60: 61 79 73 20 79 69 65 6c 64 20 61 20 4e 55 4c 4c ays yield a NULL
3b70: 20 2a 2f 0a 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a */.. }.}../*.*
3b80: 2a 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 66 * Return true if
3b90: 20 74 68 65 20 44 49 53 54 49 4e 43 54 20 65 78 the DISTINCT ex
3ba0: 70 72 65 73 73 69 6f 6e 2d 6c 69 73 74 20 70 61 pression-list pa
3bb0: 73 73 65 64 20 61 73 20 74 68 65 20 74 68 69 72 ssed as the thir
3bc0: 64 20 61 72 67 75 6d 65 6e 74 0a 2a 2a 20 69 73 d argument.** is
3bd0: 20 72 65 64 75 6e 64 61 6e 74 2e 0a 2a 2a 0a 2a redundant..**.*
3be0: 2a 20 41 20 44 49 53 54 49 4e 43 54 20 6c 69 73 * A DISTINCT lis
3bf0: 74 20 69 73 20 72 65 64 75 6e 64 61 6e 74 20 69 t is redundant i
3c00: 66 20 61 6e 79 20 73 75 62 73 65 74 20 6f 66 20 f any subset of
3c10: 74 68 65 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 the columns in t
3c20: 68 65 0a 2a 2a 20 44 49 53 54 49 4e 43 54 20 6c he.** DISTINCT l
3c30: 69 73 74 20 61 72 65 20 63 6f 6c 6c 65 63 74 69 ist are collecti
3c40: 76 65 6c 79 20 75 6e 69 71 75 65 20 61 6e 64 20 vely unique and
3c50: 69 6e 64 69 76 69 64 75 61 6c 6c 79 20 6e 6f 6e individually non
3c60: 2d 6e 75 6c 6c 2e 0a 2a 2f 0a 73 74 61 74 69 63 -null..*/.static
3c70: 20 69 6e 74 20 69 73 44 69 73 74 69 6e 63 74 52 int isDistinctR
3c80: 65 64 75 6e 64 61 6e 74 28 0a 20 20 50 61 72 73 edundant(. Pars
3c90: 65 20 2a 70 50 61 72 73 65 2c 20 20 20 20 20 20 e *pParse,
3ca0: 20 20 20 20 20 20 2f 2a 20 50 61 72 73 69 6e 67 /* Parsing
3cb0: 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 53 72 context */. Sr
3cc0: 63 4c 69 73 74 20 2a 70 54 61 62 4c 69 73 74 2c cList *pTabList,
3cd0: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 46 /* The F
3ce0: 52 4f 4d 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 ROM clause */.
3cf0: 57 68 65 72 65 43 6c 61 75 73 65 20 2a 70 57 43 WhereClause *pWC
3d00: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 , /* The
3d10: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 2a 2f WHERE clause */
3d20: 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 44 69 . ExprList *pDi
3d30: 73 74 69 6e 63 74 20 20 20 20 20 20 20 2f 2a 20 stinct /*
3d40: 54 68 65 20 72 65 73 75 6c 74 20 73 65 74 20 74 The result set t
3d50: 68 61 74 20 6e 65 65 64 73 20 74 6f 20 62 65 20 hat needs to be
3d60: 44 49 53 54 49 4e 43 54 20 2a 2f 0a 29 7b 0a 20 DISTINCT */.){.
3d70: 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20 Table *pTab;.
3d80: 49 6e 64 65 78 20 2a 70 49 64 78 3b 0a 20 20 69 Index *pIdx;. i
3d90: 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 nt i;
3da0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a .
3db0: 20 20 69 6e 74 20 69 42 61 73 65 3b 0a 0a 20 20 int iBase;..
3dc0: 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 6d /* If there is m
3dd0: 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 74 61 62 ore than one tab
3de0: 6c 65 20 6f 72 20 73 75 62 2d 73 65 6c 65 63 74 le or sub-select
3df0: 20 69 6e 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 in the FROM cla
3e00: 75 73 65 20 6f 66 0a 20 20 2a 2a 20 74 68 69 73 use of. ** this
3e10: 20 71 75 65 72 79 2c 20 74 68 65 6e 20 69 74 20 query, then it
3e20: 77 69 6c 6c 20 6e 6f 74 20 62 65 20 70 6f 73 73 will not be poss
3e30: 69 62 6c 65 20 74 6f 20 73 68 6f 77 20 74 68 61 ible to show tha
3e40: 74 20 74 68 65 20 44 49 53 54 49 4e 43 54 20 0a t the DISTINCT .
3e50: 20 20 2a 2a 20 63 6c 61 75 73 65 20 69 73 20 72 ** clause is r
3e60: 65 64 75 6e 64 61 6e 74 2e 20 2a 2f 0a 20 20 69 edundant. */. i
3e70: 66 28 20 70 54 61 62 4c 69 73 74 2d 3e 6e 53 72 f( pTabList->nSr
3e80: 63 21 3d 31 20 29 20 72 65 74 75 72 6e 20 30 3b c!=1 ) return 0;
3e90: 0a 20 20 69 42 61 73 65 20 3d 20 70 54 61 62 4c . iBase = pTabL
3ea0: 69 73 74 2d 3e 61 5b 30 5d 2e 69 43 75 72 73 6f ist->a[0].iCurso
3eb0: 72 3b 0a 20 20 70 54 61 62 20 3d 20 70 54 61 62 r;. pTab = pTab
3ec0: 4c 69 73 74 2d 3e 61 5b 30 5d 2e 70 54 61 62 3b List->a[0].pTab;
3ed0: 0a 0a 20 20 2f 2a 20 49 66 20 61 6e 79 20 6f 66 .. /* If any of
3ee0: 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73 the expressions
3ef0: 20 69 73 20 61 6e 20 49 50 4b 20 63 6f 6c 75 6d is an IPK colum
3f00: 6e 20 6f 6e 20 74 61 62 6c 65 20 69 42 61 73 65 n on table iBase
3f10: 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 0a 20 , then return .
3f20: 20 2a 2a 20 74 72 75 65 2e 20 4e 6f 74 65 3a 20 ** true. Note:
3f30: 54 68 65 20 28 70 2d 3e 69 54 61 62 6c 65 3d 3d The (p->iTable==
3f40: 69 42 61 73 65 29 20 70 61 72 74 20 6f 66 20 74 iBase) part of t
3f50: 68 69 73 20 74 65 73 74 20 6d 61 79 20 62 65 20 his test may be
3f60: 66 61 6c 73 65 20 69 66 20 74 68 65 0a 20 20 2a false if the. *
3f70: 2a 20 63 75 72 72 65 6e 74 20 53 45 4c 45 43 54 * current SELECT
3f80: 20 69 73 20 61 20 63 6f 72 72 65 6c 61 74 65 64 is a correlated
3f90: 20 73 75 62 2d 71 75 65 72 79 2e 0a 20 20 2a 2f sub-query.. */
3fa0: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 44 . for(i=0; i<pD
3fb0: 69 73 74 69 6e 63 74 2d 3e 6e 45 78 70 72 3b 20 istinct->nExpr;
3fc0: 69 2b 2b 29 7b 0a 20 20 20 20 45 78 70 72 20 2a i++){. Expr *
3fd0: 70 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 53 p = sqlite3ExprS
3fe0: 6b 69 70 43 6f 6c 6c 61 74 65 28 70 44 69 73 74 kipCollate(pDist
3ff0: 69 6e 63 74 2d 3e 61 5b 69 5d 2e 70 45 78 70 72 inct->a[i].pExpr
4000: 29 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 6f 70 );. if( p->op
4010: 3d 3d 54 4b 5f 43 4f 4c 55 4d 4e 20 26 26 20 70 ==TK_COLUMN && p
4020: 2d 3e 69 54 61 62 6c 65 3d 3d 69 42 61 73 65 20 ->iTable==iBase
4030: 26 26 20 70 2d 3e 69 43 6f 6c 75 6d 6e 3c 30 20 && p->iColumn<0
4040: 29 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a ) return 1;. }.
4050: 0a 20 20 2f 2a 20 4c 6f 6f 70 20 74 68 72 6f 75 . /* Loop throu
4060: 67 68 20 61 6c 6c 20 69 6e 64 69 63 65 73 20 6f gh all indices o
4070: 6e 20 74 68 65 20 74 61 62 6c 65 2c 20 63 68 65 n the table, che
4080: 63 6b 69 6e 67 20 65 61 63 68 20 74 6f 20 73 65 cking each to se
4090: 65 20 69 66 20 69 74 20 6d 61 6b 65 73 0a 20 20 e if it makes.
40a0: 2a 2a 20 74 68 65 20 44 49 53 54 49 4e 43 54 20 ** the DISTINCT
40b0: 71 75 61 6c 69 66 69 65 72 20 72 65 64 75 6e 64 qualifier redund
40c0: 61 6e 74 2e 20 49 74 20 64 6f 65 73 20 73 6f 20 ant. It does so
40d0: 69 66 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 if:. **. **
40e0: 31 2e 20 54 68 65 20 69 6e 64 65 78 20 69 73 20 1. The index is
40f0: 69 74 73 65 6c 66 20 55 4e 49 51 55 45 2c 20 61 itself UNIQUE, a
4100: 6e 64 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 32 nd. **. ** 2
4110: 2e 20 41 6c 6c 20 6f 66 20 74 68 65 20 63 6f 6c . All of the col
4120: 75 6d 6e 73 20 69 6e 20 74 68 65 20 69 6e 64 65 umns in the inde
4130: 78 20 61 72 65 20 65 69 74 68 65 72 20 70 61 72 x are either par
4140: 74 20 6f 66 20 74 68 65 20 70 44 69 73 74 69 6e t of the pDistin
4150: 63 74 0a 20 20 2a 2a 20 20 20 20 20 20 6c 69 73 ct. ** lis
4160: 74 2c 20 6f 72 20 65 6c 73 65 20 74 68 65 20 57 t, or else the W
4170: 48 45 52 45 20 63 6c 61 75 73 65 20 63 6f 6e 74 HERE clause cont
4180: 61 69 6e 73 20 61 20 74 65 72 6d 20 6f 66 20 74 ains a term of t
4190: 68 65 20 66 6f 72 6d 20 22 63 6f 6c 3d 58 22 2c he form "col=X",
41a0: 0a 20 20 2a 2a 20 20 20 20 20 20 77 68 65 72 65 . ** where
41b0: 20 58 20 69 73 20 61 20 63 6f 6e 73 74 61 6e 74 X is a constant
41c0: 20 76 61 6c 75 65 2e 20 54 68 65 20 63 6f 6c 6c value. The coll
41d0: 61 74 69 6f 6e 20 73 65 71 75 65 6e 63 65 73 20 ation sequences
41e0: 6f 66 20 74 68 65 0a 20 20 2a 2a 20 20 20 20 20 of the. **
41f0: 20 63 6f 6d 70 61 72 69 73 6f 6e 20 61 6e 64 20 comparison and
4200: 73 65 6c 65 63 74 2d 6c 69 73 74 20 65 78 70 72 select-list expr
4210: 65 73 73 69 6f 6e 73 20 6d 75 73 74 20 6d 61 74 essions must mat
4220: 63 68 20 74 68 6f 73 65 20 6f 66 20 74 68 65 20 ch those of the
4230: 69 6e 64 65 78 2e 0a 20 20 2a 2a 0a 20 20 2a 2a index.. **. **
4240: 20 20 20 33 2e 20 41 6c 6c 20 6f 66 20 74 68 6f 3. All of tho
4250: 73 65 20 69 6e 64 65 78 20 63 6f 6c 75 6d 6e 73 se index columns
4260: 20 66 6f 72 20 77 68 69 63 68 20 74 68 65 20 57 for which the W
4270: 48 45 52 45 20 63 6c 61 75 73 65 20 64 6f 65 73 HERE clause does
4280: 20 6e 6f 74 0a 20 20 2a 2a 20 20 20 20 20 20 63 not. ** c
4290: 6f 6e 74 61 69 6e 20 61 20 22 63 6f 6c 3d 58 22 ontain a "col=X"
42a0: 20 74 65 72 6d 20 61 72 65 20 73 75 62 6a 65 63 term are subjec
42b0: 74 20 74 6f 20 61 20 4e 4f 54 20 4e 55 4c 4c 20 t to a NOT NULL
42c0: 63 6f 6e 73 74 72 61 69 6e 74 2e 0a 20 20 2a 2f constraint.. */
42d0: 0a 20 20 66 6f 72 28 70 49 64 78 3d 70 54 61 62 . for(pIdx=pTab
42e0: 2d 3e 70 49 6e 64 65 78 3b 20 70 49 64 78 3b 20 ->pIndex; pIdx;
42f0: 70 49 64 78 3d 70 49 64 78 2d 3e 70 4e 65 78 74 pIdx=pIdx->pNext
4300: 29 7b 0a 20 20 20 20 69 66 28 20 21 49 73 55 6e ){. if( !IsUn
4310: 69 71 75 65 49 6e 64 65 78 28 70 49 64 78 29 20 iqueIndex(pIdx)
4320: 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 ) continue;.
4330: 66 6f 72 28 69 3d 30 3b 20 69 3c 70 49 64 78 2d for(i=0; i<pIdx-
4340: 3e 6e 4b 65 79 43 6f 6c 3b 20 69 2b 2b 29 7b 0a >nKeyCol; i++){.
4350: 20 20 20 20 20 20 69 66 28 20 30 3d 3d 73 71 6c if( 0==sql
4360: 69 74 65 33 57 68 65 72 65 46 69 6e 64 54 65 72 ite3WhereFindTer
4370: 6d 28 70 57 43 2c 20 69 42 61 73 65 2c 20 69 2c m(pWC, iBase, i,
4380: 20 7e 28 42 69 74 6d 61 73 6b 29 30 2c 20 57 4f ~(Bitmask)0, WO
4390: 5f 45 51 2c 20 70 49 64 78 29 20 29 7b 0a 20 20 _EQ, pIdx) ){.
43a0: 20 20 20 20 20 20 69 66 28 20 66 69 6e 64 49 6e if( findIn
43b0: 64 65 78 43 6f 6c 28 70 50 61 72 73 65 2c 20 70 dexCol(pParse, p
43c0: 44 69 73 74 69 6e 63 74 2c 20 69 42 61 73 65 2c Distinct, iBase,
43d0: 20 70 49 64 78 2c 20 69 29 3c 30 20 29 20 62 72 pIdx, i)<0 ) br
43e0: 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 69 66 28 eak;. if(
43f0: 20 69 6e 64 65 78 43 6f 6c 75 6d 6e 4e 6f 74 4e indexColumnNotN
4400: 75 6c 6c 28 70 49 64 78 2c 20 69 29 3d 3d 30 20 ull(pIdx, i)==0
4410: 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d ) break;. }
4420: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 69 . }. if( i
4430: 3d 3d 70 49 64 78 2d 3e 6e 4b 65 79 43 6f 6c 20 ==pIdx->nKeyCol
4440: 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73 ){. /* This
4450: 20 69 6e 64 65 78 20 69 6d 70 6c 69 65 73 20 74 index implies t
4460: 68 61 74 20 74 68 65 20 44 49 53 54 49 4e 43 54 hat the DISTINCT
4470: 20 71 75 61 6c 69 66 69 65 72 20 69 73 20 72 65 qualifier is re
4480: 64 75 6e 64 61 6e 74 2e 20 2a 2f 0a 20 20 20 20 dundant. */.
4490: 20 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 return 1;.
44a0: 7d 0a 20 20 7d 0a 0a 20 20 72 65 74 75 72 6e 20 }. }.. return
44b0: 30 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 45 73 74 0;.}.../*.** Est
44c0: 69 6d 61 74 65 20 74 68 65 20 6c 6f 67 61 72 69 imate the logari
44d0: 74 68 6d 20 6f 66 20 74 68 65 20 69 6e 70 75 74 thm of the input
44e0: 20 76 61 6c 75 65 20 74 6f 20 62 61 73 65 20 32 value to base 2
44f0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 4c 6f 67 45 ..*/.static LogE
4500: 73 74 20 65 73 74 4c 6f 67 28 4c 6f 67 45 73 74 st estLog(LogEst
4510: 20 4e 29 7b 0a 20 20 72 65 74 75 72 6e 20 4e 3c N){. return N<
4520: 3d 31 30 20 3f 20 30 20 3a 20 73 71 6c 69 74 65 =10 ? 0 : sqlite
4530: 33 4c 6f 67 45 73 74 28 4e 29 20 2d 20 33 33 3b 3LogEst(N) - 33;
4540: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 .}../*.** Conver
4550: 74 20 4f 50 5f 43 6f 6c 75 6d 6e 20 6f 70 63 6f t OP_Column opco
4560: 64 65 73 20 74 6f 20 4f 50 5f 43 6f 70 79 20 69 des to OP_Copy i
4570: 6e 20 70 72 65 76 69 6f 75 73 6c 79 20 67 65 6e n previously gen
4580: 65 72 61 74 65 64 20 63 6f 64 65 2e 0a 2a 2a 0a erated code..**.
4590: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
45a0: 72 75 6e 73 20 6f 76 65 72 20 67 65 6e 65 72 61 runs over genera
45b0: 74 65 64 20 56 44 42 45 20 63 6f 64 65 20 61 6e ted VDBE code an
45c0: 64 20 74 72 61 6e 73 6c 61 74 65 73 20 4f 50 5f d translates OP_
45d0: 43 6f 6c 75 6d 6e 0a 2a 2a 20 6f 70 63 6f 64 65 Column.** opcode
45e0: 73 20 69 6e 74 6f 20 4f 50 5f 43 6f 70 79 20 77 s into OP_Copy w
45f0: 68 65 6e 20 74 68 65 20 74 61 62 6c 65 20 69 73 hen the table is
4600: 20 62 65 69 6e 67 20 61 63 63 65 73 73 65 64 20 being accessed
4610: 76 69 61 20 63 6f 2d 72 6f 75 74 69 6e 65 20 0a via co-routine .
4620: 2a 2a 20 69 6e 73 74 65 61 64 20 6f 66 20 76 69 ** instead of vi
4630: 61 20 74 61 62 6c 65 20 6c 6f 6f 6b 75 70 2e 0a a table lookup..
4640: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 62 49 6e **.** If the bIn
4650: 63 72 52 6f 77 69 64 20 70 61 72 61 6d 65 74 65 crRowid paramete
4660: 72 20 69 73 20 30 2c 20 74 68 65 6e 20 61 6e 79 r is 0, then any
4670: 20 4f 50 5f 52 6f 77 69 64 20 69 6e 73 74 72 75 OP_Rowid instru
4680: 63 74 69 6f 6e 73 20 6f 6e 0a 2a 2a 20 63 75 72 ctions on.** cur
4690: 73 6f 72 20 69 54 61 62 43 75 72 20 61 72 65 20 sor iTabCur are
46a0: 74 72 61 6e 73 66 6f 72 6d 65 64 20 69 6e 74 6f transformed into
46b0: 20 4f 50 5f 4e 75 6c 6c 2e 20 4f 72 2c 20 69 66 OP_Null. Or, if
46c0: 20 62 49 6e 63 72 52 6f 77 69 64 20 69 73 20 6e bIncrRowid is n
46d0: 6f 6e 2d 7a 65 72 6f 2c 0a 2a 2a 20 74 68 65 6e on-zero,.** then
46e0: 20 65 61 63 68 20 4f 50 5f 52 6f 77 69 64 20 69 each OP_Rowid i
46f0: 73 20 74 72 61 6e 73 66 6f 72 6d 65 64 20 69 6e s transformed in
4700: 74 6f 20 61 6e 20 69 6e 73 74 72 75 63 74 69 6f to an instructio
4710: 6e 20 74 6f 20 69 6e 63 72 65 6d 65 6e 74 20 74 n to increment t
4720: 68 65 0a 2a 2a 20 76 61 6c 75 65 20 73 74 6f 72 he.** value stor
4730: 65 64 20 69 6e 20 69 74 73 20 6f 75 74 70 75 74 ed in its output
4740: 20 72 65 67 69 73 74 65 72 2e 0a 2a 2f 0a 73 74 register..*/.st
4750: 61 74 69 63 20 76 6f 69 64 20 74 72 61 6e 73 6c atic void transl
4760: 61 74 65 43 6f 6c 75 6d 6e 54 6f 43 6f 70 79 28 ateColumnToCopy(
4770: 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 . Parse *pParse
4780: 2c 20 20 20 20 20 20 2f 2a 20 50 61 72 73 69 6e , /* Parsin
4790: 67 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 69 g context */. i
47a0: 6e 74 20 69 53 74 61 72 74 2c 20 20 20 20 20 20 nt iStart,
47b0: 20 20 20 2f 2a 20 54 72 61 6e 73 6c 61 74 65 20 /* Translate
47c0: 66 72 6f 6d 20 74 68 69 73 20 6f 70 63 6f 64 65 from this opcode
47d0: 20 74 6f 20 74 68 65 20 65 6e 64 20 2a 2f 0a 20 to the end */.
47e0: 20 69 6e 74 20 69 54 61 62 43 75 72 2c 20 20 20 int iTabCur,
47f0: 20 20 20 20 20 2f 2a 20 4f 50 5f 43 6f 6c 75 6d /* OP_Colum
4800: 6e 2f 4f 50 5f 52 6f 77 69 64 20 72 65 66 65 72 n/OP_Rowid refer
4810: 65 6e 63 65 73 20 74 6f 20 74 68 69 73 20 74 61 ences to this ta
4820: 62 6c 65 20 2a 2f 0a 20 20 69 6e 74 20 69 52 65 ble */. int iRe
4830: 67 69 73 74 65 72 2c 20 20 20 20 20 20 2f 2a 20 gister, /*
4840: 54 68 65 20 66 69 72 73 74 20 63 6f 6c 75 6d 6e The first column
4850: 20 69 73 20 69 6e 20 74 68 69 73 20 72 65 67 69 is in this regi
4860: 73 74 65 72 20 2a 2f 0a 20 20 69 6e 74 20 62 49 ster */. int bI
4870: 6e 63 72 52 6f 77 69 64 20 20 20 20 20 20 2f 2a ncrRowid /*
4880: 20 49 66 20 6e 6f 6e 2d 7a 65 72 6f 2c 20 74 72 If non-zero, tr
4890: 61 6e 73 66 6f 72 6d 20 4f 50 5f 72 6f 77 69 64 ansform OP_rowid
48a0: 20 74 6f 20 4f 50 5f 41 64 64 49 6d 6d 28 31 29 to OP_AddImm(1)
48b0: 20 2a 2f 0a 29 7b 0a 20 20 56 64 62 65 20 2a 76 */.){. Vdbe *v
48c0: 20 3d 20 70 50 61 72 73 65 2d 3e 70 56 64 62 65 = pParse->pVdbe
48d0: 3b 0a 20 20 56 64 62 65 4f 70 20 2a 70 4f 70 20 ;. VdbeOp *pOp
48e0: 3d 20 73 71 6c 69 74 65 33 56 64 62 65 47 65 74 = sqlite3VdbeGet
48f0: 4f 70 28 76 2c 20 69 53 74 61 72 74 29 3b 0a 20 Op(v, iStart);.
4900: 20 69 6e 74 20 69 45 6e 64 20 3d 20 73 71 6c 69 int iEnd = sqli
4910: 74 65 33 56 64 62 65 43 75 72 72 65 6e 74 41 64 te3VdbeCurrentAd
4920: 64 72 28 76 29 3b 0a 20 20 69 66 28 20 70 50 61 dr(v);. if( pPa
4930: 72 73 65 2d 3e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 rse->db->mallocF
4940: 61 69 6c 65 64 20 29 20 72 65 74 75 72 6e 3b 0a ailed ) return;.
4950: 20 20 66 6f 72 28 3b 20 69 53 74 61 72 74 3c 69 for(; iStart<i
4960: 45 6e 64 3b 20 69 53 74 61 72 74 2b 2b 2c 20 70 End; iStart++, p
4970: 4f 70 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 70 Op++){. if( p
4980: 4f 70 2d 3e 70 31 21 3d 69 54 61 62 43 75 72 20 Op->p1!=iTabCur
4990: 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 ) continue;.
49a0: 69 66 28 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d if( pOp->opcode=
49b0: 3d 4f 50 5f 43 6f 6c 75 6d 6e 20 29 7b 0a 20 20 =OP_Column ){.
49c0: 20 20 20 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 20 pOp->opcode
49d0: 3d 20 4f 50 5f 43 6f 70 79 3b 0a 20 20 20 20 20 = OP_Copy;.
49e0: 20 70 4f 70 2d 3e 70 31 20 3d 20 70 4f 70 2d 3e pOp->p1 = pOp->
49f0: 70 32 20 2b 20 69 52 65 67 69 73 74 65 72 3b 0a p2 + iRegister;.
4a00: 20 20 20 20 20 20 70 4f 70 2d 3e 70 32 20 3d 20 pOp->p2 =
4a10: 70 4f 70 2d 3e 70 33 3b 0a 20 20 20 20 20 20 70 pOp->p3;. p
4a20: 4f 70 2d 3e 70 33 20 3d 20 30 3b 0a 20 20 20 20 Op->p3 = 0;.
4a30: 7d 65 6c 73 65 20 69 66 28 20 70 4f 70 2d 3e 6f }else if( pOp->o
4a40: 70 63 6f 64 65 3d 3d 4f 50 5f 52 6f 77 69 64 20 pcode==OP_Rowid
4a50: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 62 49 6e ){. if( bIn
4a60: 63 72 52 6f 77 69 64 20 29 7b 0a 20 20 20 20 20 crRowid ){.
4a70: 20 20 20 2f 2a 20 49 6e 63 72 65 6d 65 6e 74 20 /* Increment
4a80: 74 68 65 20 76 61 6c 75 65 20 73 74 6f 72 65 64 the value stored
4a90: 20 69 6e 20 74 68 65 20 50 32 20 6f 70 65 72 61 in the P2 opera
4aa0: 6e 64 20 6f 66 20 74 68 65 20 4f 50 5f 52 6f 77 nd of the OP_Row
4ab0: 69 64 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 70 id. */. p
4ac0: 4f 70 2d 3e 6f 70 63 6f 64 65 20 3d 20 4f 50 5f Op->opcode = OP_
4ad0: 41 64 64 49 6d 6d 3b 0a 20 20 20 20 20 20 20 20 AddImm;.
4ae0: 70 4f 70 2d 3e 70 31 20 3d 20 70 4f 70 2d 3e 70 pOp->p1 = pOp->p
4af0: 32 3b 0a 20 20 20 20 20 20 20 20 70 4f 70 2d 3e 2;. pOp->
4b00: 70 32 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 65 p2 = 1;. }e
4b10: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 4f 70 lse{. pOp
4b20: 2d 3e 6f 70 63 6f 64 65 20 3d 20 4f 50 5f 4e 75 ->opcode = OP_Nu
4b30: 6c 6c 3b 0a 20 20 20 20 20 20 20 20 70 4f 70 2d ll;. pOp-
4b40: 3e 70 31 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 >p1 = 0;.
4b50: 20 70 4f 70 2d 3e 70 33 20 3d 20 30 3b 0a 20 20 pOp->p3 = 0;.
4b60: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a }. }. }.
4b70: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 77 6f 20 72 6f 75 }../*.** Two rou
4b80: 74 69 6e 65 73 20 66 6f 72 20 70 72 69 6e 74 69 tines for printi
4b90: 6e 67 20 74 68 65 20 63 6f 6e 74 65 6e 74 20 6f ng the content o
4ba0: 66 20 61 6e 20 73 71 6c 69 74 65 33 5f 69 6e 64 f an sqlite3_ind
4bb0: 65 78 5f 69 6e 66 6f 0a 2a 2a 20 73 74 72 75 63 ex_info.** struc
4bc0: 74 75 72 65 2e 20 20 55 73 65 64 20 66 6f 72 20 ture. Used for
4bd0: 74 65 73 74 69 6e 67 20 61 6e 64 20 64 65 62 75 testing and debu
4be0: 67 67 69 6e 67 20 6f 6e 6c 79 2e 20 20 49 66 20 gging only. If
4bf0: 6e 65 69 74 68 65 72 0a 2a 2a 20 53 51 4c 49 54 neither.** SQLIT
4c00: 45 5f 54 45 53 54 20 6f 72 20 53 51 4c 49 54 45 E_TEST or SQLITE
4c10: 5f 44 45 42 55 47 20 61 72 65 20 64 65 66 69 6e _DEBUG are defin
4c20: 65 64 2c 20 74 68 65 6e 20 74 68 65 73 65 20 72 ed, then these r
4c30: 6f 75 74 69 6e 65 73 0a 2a 2a 20 61 72 65 20 6e outines.** are n
4c40: 6f 2d 6f 70 73 2e 0a 2a 2f 0a 23 69 66 20 21 64 o-ops..*/.#if !d
4c50: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4f 4d efined(SQLITE_OM
4c60: 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 29 IT_VIRTUALTABLE)
4c70: 20 26 26 20 64 65 66 69 6e 65 64 28 57 48 45 52 && defined(WHER
4c80: 45 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 29 0a ETRACE_ENABLED).
4c90: 73 74 61 74 69 63 20 76 6f 69 64 20 54 52 41 43 static void TRAC
4ca0: 45 5f 49 44 58 5f 49 4e 50 55 54 53 28 73 71 6c E_IDX_INPUTS(sql
4cb0: 69 74 65 33 5f 69 6e 64 65 78 5f 69 6e 66 6f 20 ite3_index_info
4cc0: 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 *p){. int i;.
4cd0: 69 66 28 20 21 73 71 6c 69 74 65 33 57 68 65 72 if( !sqlite3Wher
4ce0: 65 54 72 61 63 65 20 29 20 72 65 74 75 72 6e 3b eTrace ) return;
4cf0: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d . for(i=0; i<p-
4d00: 3e 6e 43 6f 6e 73 74 72 61 69 6e 74 3b 20 69 2b >nConstraint; i+
4d10: 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 +){. sqlite3D
4d20: 65 62 75 67 50 72 69 6e 74 66 28 22 20 20 63 6f ebugPrintf(" co
4d30: 6e 73 74 72 61 69 6e 74 5b 25 64 5d 3a 20 63 6f nstraint[%d]: co
4d40: 6c 3d 25 64 20 74 65 72 6d 69 64 3d 25 64 20 6f l=%d termid=%d o
4d50: 70 3d 25 64 20 75 73 61 62 6c 65 64 3d 25 64 5c p=%d usabled=%d\
4d60: 6e 22 2c 0a 20 20 20 20 20 20 20 69 2c 0a 20 20 n",. i,.
4d70: 20 20 20 20 20 70 2d 3e 61 43 6f 6e 73 74 72 61 p->aConstra
4d80: 69 6e 74 5b 69 5d 2e 69 43 6f 6c 75 6d 6e 2c 0a int[i].iColumn,.
4d90: 20 20 20 20 20 20 20 70 2d 3e 61 43 6f 6e 73 74 p->aConst
4da0: 72 61 69 6e 74 5b 69 5d 2e 69 54 65 72 6d 4f 66 raint[i].iTermOf
4db0: 66 73 65 74 2c 0a 20 20 20 20 20 20 20 70 2d 3e fset,. p->
4dc0: 61 43 6f 6e 73 74 72 61 69 6e 74 5b 69 5d 2e 6f aConstraint[i].o
4dd0: 70 2c 0a 20 20 20 20 20 20 20 70 2d 3e 61 43 6f p,. p->aCo
4de0: 6e 73 74 72 61 69 6e 74 5b 69 5d 2e 75 73 61 62 nstraint[i].usab
4df0: 6c 65 29 3b 0a 20 20 7d 0a 20 20 66 6f 72 28 69 le);. }. for(i
4e00: 3d 30 3b 20 69 3c 70 2d 3e 6e 4f 72 64 65 72 42 =0; i<p->nOrderB
4e10: 79 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c y; i++){. sql
4e20: 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 ite3DebugPrintf(
4e30: 22 20 20 6f 72 64 65 72 62 79 5b 25 64 5d 3a 20 " orderby[%d]:
4e40: 63 6f 6c 3d 25 64 20 64 65 73 63 3d 25 64 5c 6e col=%d desc=%d\n
4e50: 22 2c 0a 20 20 20 20 20 20 20 69 2c 0a 20 20 20 ",. i,.
4e60: 20 20 20 20 70 2d 3e 61 4f 72 64 65 72 42 79 5b p->aOrderBy[
4e70: 69 5d 2e 69 43 6f 6c 75 6d 6e 2c 0a 20 20 20 20 i].iColumn,.
4e80: 20 20 20 70 2d 3e 61 4f 72 64 65 72 42 79 5b 69 p->aOrderBy[i
4e90: 5d 2e 64 65 73 63 29 3b 0a 20 20 7d 0a 7d 0a 73 ].desc);. }.}.s
4ea0: 74 61 74 69 63 20 76 6f 69 64 20 54 52 41 43 45 tatic void TRACE
4eb0: 5f 49 44 58 5f 4f 55 54 50 55 54 53 28 73 71 6c _IDX_OUTPUTS(sql
4ec0: 69 74 65 33 5f 69 6e 64 65 78 5f 69 6e 66 6f 20 ite3_index_info
4ed0: 2a 70 29 7b 0a 20 20 69 6e 74 20 69 3b 0a 20 20 *p){. int i;.
4ee0: 69 66 28 20 21 73 71 6c 69 74 65 33 57 68 65 72 if( !sqlite3Wher
4ef0: 65 54 72 61 63 65 20 29 20 72 65 74 75 72 6e 3b eTrace ) return;
4f00: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d . for(i=0; i<p-
4f10: 3e 6e 43 6f 6e 73 74 72 61 69 6e 74 3b 20 69 2b >nConstraint; i+
4f20: 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 +){. sqlite3D
4f30: 65 62 75 67 50 72 69 6e 74 66 28 22 20 20 75 73 ebugPrintf(" us
4f40: 61 67 65 5b 25 64 5d 3a 20 61 72 67 76 49 64 78 age[%d]: argvIdx
4f50: 3d 25 64 20 6f 6d 69 74 3d 25 64 5c 6e 22 2c 0a =%d omit=%d\n",.
4f60: 20 20 20 20 20 20 20 69 2c 0a 20 20 20 20 20 20 i,.
4f70: 20 70 2d 3e 61 43 6f 6e 73 74 72 61 69 6e 74 55 p->aConstraintU
4f80: 73 61 67 65 5b 69 5d 2e 61 72 67 76 49 6e 64 65 sage[i].argvInde
4f90: 78 2c 0a 20 20 20 20 20 20 20 70 2d 3e 61 43 6f x,. p->aCo
4fa0: 6e 73 74 72 61 69 6e 74 55 73 61 67 65 5b 69 5d nstraintUsage[i]
4fb0: 2e 6f 6d 69 74 29 3b 0a 20 20 7d 0a 20 20 73 71 .omit);. }. sq
4fc0: 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 lite3DebugPrintf
4fd0: 28 22 20 20 69 64 78 4e 75 6d 3d 25 64 5c 6e 22 (" idxNum=%d\n"
4fe0: 2c 20 70 2d 3e 69 64 78 4e 75 6d 29 3b 0a 20 20 , p->idxNum);.
4ff0: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e sqlite3DebugPrin
5000: 74 66 28 22 20 20 69 64 78 53 74 72 3d 25 73 5c tf(" idxStr=%s\
5010: 6e 22 2c 20 70 2d 3e 69 64 78 53 74 72 29 3b 0a n", p->idxStr);.
5020: 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 sqlite3DebugPr
5030: 69 6e 74 66 28 22 20 20 6f 72 64 65 72 42 79 43 intf(" orderByC
5040: 6f 6e 73 75 6d 65 64 3d 25 64 5c 6e 22 2c 20 70 onsumed=%d\n", p
5050: 2d 3e 6f 72 64 65 72 42 79 43 6f 6e 73 75 6d 65 ->orderByConsume
5060: 64 29 3b 0a 20 20 73 71 6c 69 74 65 33 44 65 62 d);. sqlite3Deb
5070: 75 67 50 72 69 6e 74 66 28 22 20 20 65 73 74 69 ugPrintf(" esti
5080: 6d 61 74 65 64 43 6f 73 74 3d 25 67 5c 6e 22 2c matedCost=%g\n",
5090: 20 70 2d 3e 65 73 74 69 6d 61 74 65 64 43 6f 73 p->estimatedCos
50a0: 74 29 3b 0a 20 20 73 71 6c 69 74 65 33 44 65 62 t);. sqlite3Deb
50b0: 75 67 50 72 69 6e 74 66 28 22 20 20 65 73 74 69 ugPrintf(" esti
50c0: 6d 61 74 65 64 52 6f 77 73 3d 25 6c 6c 64 5c 6e matedRows=%lld\n
50d0: 22 2c 20 70 2d 3e 65 73 74 69 6d 61 74 65 64 52 ", p->estimatedR
50e0: 6f 77 73 29 3b 0a 7d 0a 23 65 6c 73 65 0a 23 64 ows);.}.#else.#d
50f0: 65 66 69 6e 65 20 54 52 41 43 45 5f 49 44 58 5f efine TRACE_IDX_
5100: 49 4e 50 55 54 53 28 41 29 0a 23 64 65 66 69 6e INPUTS(A).#defin
5110: 65 20 54 52 41 43 45 5f 49 44 58 5f 4f 55 54 50 e TRACE_IDX_OUTP
5120: 55 54 53 28 41 29 0a 23 65 6e 64 69 66 0a 0a 23 UTS(A).#endif..#
5130: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
5140: 49 54 5f 41 55 54 4f 4d 41 54 49 43 5f 49 4e 44 IT_AUTOMATIC_IND
5150: 45 58 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 EX./*.** Return
5160: 54 52 55 45 20 69 66 20 74 68 65 20 57 48 45 52 TRUE if the WHER
5170: 45 20 63 6c 61 75 73 65 20 74 65 72 6d 20 70 54 E clause term pT
5180: 65 72 6d 20 69 73 20 6f 66 20 61 20 66 6f 72 6d erm is of a form
5190: 20 77 68 65 72 65 20 69 74 0a 2a 2a 20 63 6f 75 where it.** cou
51a0: 6c 64 20 62 65 20 75 73 65 64 20 77 69 74 68 20 ld be used with
51b0: 61 6e 20 69 6e 64 65 78 20 74 6f 20 61 63 63 65 an index to acce
51c0: 73 73 20 70 53 72 63 2c 20 61 73 73 75 6d 69 6e ss pSrc, assumin
51d0: 67 20 61 6e 20 61 70 70 72 6f 70 72 69 61 74 65 g an appropriate
51e0: 0a 2a 2a 20 69 6e 64 65 78 20 65 78 69 73 74 65 .** index existe
51f0: 64 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 d..*/.static int
5200: 20 74 65 72 6d 43 61 6e 44 72 69 76 65 49 6e 64 termCanDriveInd
5210: 65 78 28 0a 20 20 57 68 65 72 65 54 65 72 6d 20 ex(. WhereTerm
5220: 2a 70 54 65 72 6d 2c 20 20 20 20 20 20 20 20 20 *pTerm,
5230: 20 20 20 20 20 2f 2a 20 57 48 45 52 45 20 63 6c /* WHERE cl
5240: 61 75 73 65 20 74 65 72 6d 20 74 6f 20 63 68 65 ause term to che
5250: 63 6b 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 53 ck */. struct S
5260: 72 63 4c 69 73 74 5f 69 74 65 6d 20 2a 70 53 72 rcList_item *pSr
5270: 63 2c 20 20 20 20 20 2f 2a 20 54 61 62 6c 65 20 c, /* Table
5280: 77 65 20 61 72 65 20 74 72 79 69 6e 67 20 74 6f we are trying to
5290: 20 61 63 63 65 73 73 20 2a 2f 0a 20 20 42 69 74 access */. Bit
52a0: 6d 61 73 6b 20 6e 6f 74 52 65 61 64 79 20 20 20 mask notReady
52b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
52c0: 61 62 6c 65 73 20 69 6e 20 6f 75 74 65 72 20 6c ables in outer l
52d0: 6f 6f 70 73 20 6f 66 20 74 68 65 20 6a 6f 69 6e oops of the join
52e0: 20 2a 2f 0a 29 7b 0a 20 20 63 68 61 72 20 61 66 */.){. char af
52f0: 66 3b 0a 20 20 69 66 28 20 70 54 65 72 6d 2d 3e f;. if( pTerm->
5300: 6c 65 66 74 43 75 72 73 6f 72 21 3d 70 53 72 63 leftCursor!=pSrc
5310: 2d 3e 69 43 75 72 73 6f 72 20 29 20 72 65 74 75 ->iCursor ) retu
5320: 72 6e 20 30 3b 0a 20 20 69 66 28 20 28 70 54 65 rn 0;. if( (pTe
5330: 72 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 rm->eOperator &
5340: 28 57 4f 5f 45 51 7c 57 4f 5f 49 53 29 29 3d 3d (WO_EQ|WO_IS))==
5350: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 0 ) return 0;.
5360: 69 66 28 20 28 70 53 72 63 2d 3e 66 67 2e 6a 6f if( (pSrc->fg.jo
5370: 69 6e 74 79 70 65 20 26 20 4a 54 5f 4c 45 46 54 intype & JT_LEFT
5380: 29 20 0a 20 20 20 26 26 20 21 45 78 70 72 48 61 ) . && !ExprHa
5390: 73 50 72 6f 70 65 72 74 79 28 70 54 65 72 6d 2d sProperty(pTerm-
53a0: 3e 70 45 78 70 72 2c 20 45 50 5f 46 72 6f 6d 4a >pExpr, EP_FromJ
53b0: 6f 69 6e 29 0a 20 20 20 26 26 20 28 70 54 65 72 oin). && (pTer
53c0: 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 57 m->eOperator & W
53d0: 4f 5f 49 53 29 0a 20 20 29 7b 0a 20 20 20 20 2f O_IS). ){. /
53e0: 2a 20 43 61 6e 6e 6f 74 20 75 73 65 20 61 6e 20 * Cannot use an
53f0: 49 53 20 74 65 72 6d 20 66 72 6f 6d 20 74 68 65 IS term from the
5400: 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 61 73 WHERE clause as
5410: 20 61 6e 20 69 6e 64 65 78 20 64 72 69 76 65 72 an index driver
5420: 20 66 6f 72 0a 20 20 20 20 2a 2a 20 74 68 65 20 for. ** the
5430: 52 48 53 20 6f 66 20 61 20 4c 45 46 54 20 4a 4f RHS of a LEFT JO
5440: 49 4e 2e 20 53 75 63 68 20 61 20 74 65 72 6d 20 IN. Such a term
5450: 63 61 6e 20 6f 6e 6c 79 20 62 65 20 75 73 65 64 can only be used
5460: 20 69 66 20 69 74 20 69 73 20 66 72 6f 6d 0a 20 if it is from.
5470: 20 20 20 2a 2a 20 74 68 65 20 4f 4e 20 63 6c 61 ** the ON cla
5480: 75 73 65 2e 20 20 2a 2f 0a 20 20 20 20 72 65 74 use. */. ret
5490: 75 72 6e 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 urn 0;. }. if(
54a0: 20 28 70 54 65 72 6d 2d 3e 70 72 65 72 65 71 52 (pTerm->prereqR
54b0: 69 67 68 74 20 26 20 6e 6f 74 52 65 61 64 79 29 ight & notReady)
54c0: 21 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a !=0 ) return 0;.
54d0: 20 20 69 66 28 20 70 54 65 72 6d 2d 3e 75 2e 6c if( pTerm->u.l
54e0: 65 66 74 43 6f 6c 75 6d 6e 3c 30 20 29 20 72 65 eftColumn<0 ) re
54f0: 74 75 72 6e 20 30 3b 0a 20 20 61 66 66 20 3d 20 turn 0;. aff =
5500: 70 53 72 63 2d 3e 70 54 61 62 2d 3e 61 43 6f 6c pSrc->pTab->aCol
5510: 5b 70 54 65 72 6d 2d 3e 75 2e 6c 65 66 74 43 6f [pTerm->u.leftCo
5520: 6c 75 6d 6e 5d 2e 61 66 66 69 6e 69 74 79 3b 0a lumn].affinity;.
5530: 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 49 6e if( !sqlite3In
5540: 64 65 78 41 66 66 69 6e 69 74 79 4f 6b 28 70 54 dexAffinityOk(pT
5550: 65 72 6d 2d 3e 70 45 78 70 72 2c 20 61 66 66 29 erm->pExpr, aff)
5560: 20 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 74 ) return 0;. t
5570: 65 73 74 63 61 73 65 28 20 70 54 65 72 6d 2d 3e estcase( pTerm->
5580: 70 45 78 70 72 2d 3e 6f 70 3d 3d 54 4b 5f 49 53 pExpr->op==TK_IS
5590: 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 31 3b 0a );. return 1;.
55a0: 7d 0a 23 65 6e 64 69 66 0a 0a 0a 23 69 66 6e 64 }.#endif...#ifnd
55b0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
55c0: 55 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58 0a 2f UTOMATIC_INDEX./
55d0: 2a 0a 2a 2a 20 47 65 6e 65 72 61 74 65 20 63 6f *.** Generate co
55e0: 64 65 20 74 6f 20 63 6f 6e 73 74 72 75 63 74 20 de to construct
55f0: 74 68 65 20 49 6e 64 65 78 20 6f 62 6a 65 63 74 the Index object
5600: 20 66 6f 72 20 61 6e 20 61 75 74 6f 6d 61 74 69 for an automati
5610: 63 20 69 6e 64 65 78 0a 2a 2a 20 61 6e 64 20 74 c index.** and t
5620: 6f 20 73 65 74 20 75 70 20 74 68 65 20 57 68 65 o set up the Whe
5630: 72 65 4c 65 76 65 6c 20 6f 62 6a 65 63 74 20 70 reLevel object p
5640: 4c 65 76 65 6c 20 73 6f 20 74 68 61 74 20 74 68 Level so that th
5650: 65 20 63 6f 64 65 20 67 65 6e 65 72 61 74 6f 72 e code generator
5660: 0a 2a 2a 20 6d 61 6b 65 73 20 75 73 65 20 6f 66 .** makes use of
5670: 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63 20 69 the automatic i
5680: 6e 64 65 78 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 ndex..*/.static
5690: 76 6f 69 64 20 63 6f 6e 73 74 72 75 63 74 41 75 void constructAu
56a0: 74 6f 6d 61 74 69 63 49 6e 64 65 78 28 0a 20 20 tomaticIndex(.
56b0: 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 20 Parse *pParse,
56c0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 /* T
56d0: 68 65 20 70 61 72 73 69 6e 67 20 63 6f 6e 74 65 he parsing conte
56e0: 78 74 20 2a 2f 0a 20 20 57 68 65 72 65 43 6c 61 xt */. WhereCla
56f0: 75 73 65 20 2a 70 57 43 2c 20 20 20 20 20 20 20 use *pWC,
5700: 20 20 20 20 2f 2a 20 54 68 65 20 57 48 45 52 45 /* The WHERE
5710: 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 73 74 72 clause */. str
5720: 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 6d uct SrcList_item
5730: 20 2a 70 53 72 63 2c 20 20 2f 2a 20 54 68 65 20 *pSrc, /* The
5740: 46 52 4f 4d 20 63 6c 61 75 73 65 20 74 65 72 6d FROM clause term
5750: 20 74 6f 20 67 65 74 20 74 68 65 20 6e 65 78 74 to get the next
5760: 20 69 6e 64 65 78 20 2a 2f 0a 20 20 42 69 74 6d index */. Bitm
5770: 61 73 6b 20 6e 6f 74 52 65 61 64 79 2c 20 20 20 ask notReady,
5780: 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20 /* Mask
5790: 6f 66 20 63 75 72 73 6f 72 73 20 74 68 61 74 20 of cursors that
57a0: 61 72 65 20 6e 6f 74 20 61 76 61 69 6c 61 62 6c are not availabl
57b0: 65 20 2a 2f 0a 20 20 57 68 65 72 65 4c 65 76 65 e */. WhereLeve
57c0: 6c 20 2a 70 4c 65 76 65 6c 20 20 20 20 20 20 20 l *pLevel
57d0: 20 20 20 2f 2a 20 57 72 69 74 65 20 6e 65 77 20 /* Write new
57e0: 69 6e 64 65 78 20 68 65 72 65 20 2a 2f 0a 29 7b index here */.){
57f0: 0a 20 20 69 6e 74 20 6e 4b 65 79 43 6f 6c 3b 20 . int nKeyCol;
5800: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
5810: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 * Number of colu
5820: 6d 6e 73 20 69 6e 20 74 68 65 20 63 6f 6e 73 74 mns in the const
5830: 72 75 63 74 65 64 20 69 6e 64 65 78 20 2a 2f 0a ructed index */.
5840: 20 20 57 68 65 72 65 54 65 72 6d 20 2a 70 54 65 WhereTerm *pTe
5850: 72 6d 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a rm; /*
5860: 20 41 20 73 69 6e 67 6c 65 20 74 65 72 6d 20 6f A single term o
5870: 66 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 f the WHERE clau
5880: 73 65 20 2a 2f 0a 20 20 57 68 65 72 65 54 65 72 se */. WhereTer
5890: 6d 20 2a 70 57 43 45 6e 64 3b 20 20 20 20 20 20 m *pWCEnd;
58a0: 20 20 20 20 2f 2a 20 45 6e 64 20 6f 66 20 70 57 /* End of pW
58b0: 43 2d 3e 61 5b 5d 20 2a 2f 0a 20 20 49 6e 64 65 C->a[] */. Inde
58c0: 78 20 2a 70 49 64 78 3b 20 20 20 20 20 20 20 20 x *pIdx;
58d0: 20 20 20 20 20 20 20 20 2f 2a 20 4f 62 6a 65 63 /* Objec
58e0: 74 20 64 65 73 63 72 69 62 69 6e 67 20 74 68 65 t describing the
58f0: 20 74 72 61 6e 73 69 65 6e 74 20 69 6e 64 65 78 transient index
5900: 20 2a 2f 0a 20 20 56 64 62 65 20 2a 76 3b 20 20 */. Vdbe *v;
5910: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5920: 20 20 2f 2a 20 50 72 65 70 61 72 65 64 20 73 74 /* Prepared st
5930: 61 74 65 6d 65 6e 74 20 75 6e 64 65 72 20 63 6f atement under co
5940: 6e 73 74 72 75 63 74 69 6f 6e 20 2a 2f 0a 20 20 nstruction */.
5950: 69 6e 74 20 61 64 64 72 49 6e 69 74 3b 20 20 20 int addrInit;
5960: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 /* A
5970: 64 64 72 65 73 73 20 6f 66 20 74 68 65 20 69 6e ddress of the in
5980: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 62 79 70 itialization byp
5990: 61 73 73 20 6a 75 6d 70 20 2a 2f 0a 20 20 54 61 ass jump */. Ta
59a0: 62 6c 65 20 2a 70 54 61 62 6c 65 3b 20 20 20 20 ble *pTable;
59b0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 /* The
59c0: 20 74 61 62 6c 65 20 62 65 69 6e 67 20 69 6e 64 table being ind
59d0: 65 78 65 64 20 2a 2f 0a 20 20 69 6e 74 20 61 64 exed */. int ad
59e0: 64 72 54 6f 70 3b 20 20 20 20 20 20 20 20 20 20 drTop;
59f0: 20 20 20 20 20 20 2f 2a 20 54 6f 70 20 6f 66 20 /* Top of
5a00: 74 68 65 20 69 6e 64 65 78 20 66 69 6c 6c 20 6c the index fill l
5a10: 6f 6f 70 20 2a 2f 0a 20 20 69 6e 74 20 72 65 67 oop */. int reg
5a20: 52 65 63 6f 72 64 3b 20 20 20 20 20 20 20 20 20 Record;
5a30: 20 20 20 20 20 2f 2a 20 52 65 67 69 73 74 65 72 /* Register
5a40: 20 68 6f 6c 64 69 6e 67 20 61 6e 20 69 6e 64 65 holding an inde
5a50: 78 20 72 65 63 6f 72 64 20 2a 2f 0a 20 20 69 6e x record */. in
5a60: 74 20 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 t n;
5a70: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6c /* Col
5a80: 75 6d 6e 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 20 umn counter */.
5a90: 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 20 20 int i;
5aa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
5ab0: 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a Loop counter */.
5ac0: 20 20 69 6e 74 20 6d 78 42 69 74 43 6f 6c 3b 20 int mxBitCol;
5ad0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
5ae0: 20 4d 61 78 69 6d 75 6d 20 63 6f 6c 75 6d 6e 20 Maximum column
5af0: 69 6e 20 70 53 72 63 2d 3e 63 6f 6c 55 73 65 64 in pSrc->colUsed
5b00: 20 2a 2f 0a 20 20 43 6f 6c 6c 53 65 71 20 2a 70 */. CollSeq *p
5b10: 43 6f 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 Coll;
5b20: 20 20 2f 2a 20 43 6f 6c 6c 61 74 69 6e 67 20 73 /* Collating s
5b30: 65 71 75 65 6e 63 65 20 74 6f 20 6f 6e 20 61 20 equence to on a
5b40: 63 6f 6c 75 6d 6e 20 2a 2f 0a 20 20 57 68 65 72 column */. Wher
5b50: 65 4c 6f 6f 70 20 2a 70 4c 6f 6f 70 3b 20 20 20 eLoop *pLoop;
5b60: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 4c /* The L
5b70: 6f 6f 70 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 oop object */.
5b80: 63 68 61 72 20 2a 7a 4e 6f 74 55 73 65 64 3b 20 char *zNotUsed;
5b90: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 45 /* E
5ba0: 78 74 72 61 20 73 70 61 63 65 20 6f 6e 20 74 68 xtra space on th
5bb0: 65 20 65 6e 64 20 6f 66 20 70 49 64 78 20 2a 2f e end of pIdx */
5bc0: 0a 20 20 42 69 74 6d 61 73 6b 20 69 64 78 43 6f . Bitmask idxCo
5bd0: 6c 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f ls; /
5be0: 2a 20 42 69 74 6d 61 70 20 6f 66 20 63 6f 6c 75 * Bitmap of colu
5bf0: 6d 6e 73 20 75 73 65 64 20 66 6f 72 20 69 6e 64 mns used for ind
5c00: 65 78 69 6e 67 20 2a 2f 0a 20 20 42 69 74 6d 61 exing */. Bitma
5c10: 73 6b 20 65 78 74 72 61 43 6f 6c 73 3b 20 20 20 sk extraCols;
5c20: 20 20 20 20 20 20 20 2f 2a 20 42 69 74 6d 61 70 /* Bitmap
5c30: 20 6f 66 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 of additional c
5c40: 6f 6c 75 6d 6e 73 20 2a 2f 0a 20 20 75 38 20 73 olumns */. u8 s
5c50: 65 6e 74 57 61 72 6e 69 6e 67 20 3d 20 30 3b 20 entWarning = 0;
5c60: 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 /* True
5c70: 69 66 20 61 20 77 61 72 6e 6e 69 6e 67 20 68 61 if a warnning ha
5c80: 73 20 62 65 65 6e 20 69 73 73 75 65 64 20 2a 2f s been issued */
5c90: 0a 20 20 45 78 70 72 20 2a 70 50 61 72 74 69 61 . Expr *pPartia
5ca0: 6c 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 2f l = 0; /
5cb0: 2a 20 50 61 72 74 69 61 6c 20 49 6e 64 65 78 20 * Partial Index
5cc0: 45 78 70 72 65 73 73 69 6f 6e 20 2a 2f 0a 20 20 Expression */.
5cd0: 69 6e 74 20 69 43 6f 6e 74 69 6e 75 65 20 3d 20 int iContinue =
5ce0: 30 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4a 0; /* J
5cf0: 75 6d 70 20 68 65 72 65 20 74 6f 20 73 6b 69 70 ump here to skip
5d00: 20 65 78 63 6c 75 64 65 64 20 72 6f 77 73 20 2a excluded rows *
5d10: 2f 0a 20 20 73 74 72 75 63 74 20 53 72 63 4c 69 /. struct SrcLi
5d20: 73 74 5f 69 74 65 6d 20 2a 70 54 61 62 49 74 65 st_item *pTabIte
5d30: 6d 3b 20 20 2f 2a 20 46 52 4f 4d 20 63 6c 61 75 m; /* FROM clau
5d40: 73 65 20 74 65 72 6d 20 62 65 69 6e 67 20 69 6e se term being in
5d50: 64 65 78 65 64 20 2a 2f 0a 20 20 69 6e 74 20 61 dexed */. int a
5d60: 64 64 72 43 6f 75 6e 74 65 72 20 3d 20 30 3b 20 ddrCounter = 0;
5d70: 20 20 20 20 20 20 20 2f 2a 20 41 64 64 72 65 73 /* Addres
5d80: 73 20 77 68 65 72 65 20 69 6e 74 65 67 65 72 20 s where integer
5d90: 63 6f 75 6e 74 65 72 20 69 73 20 69 6e 69 74 69 counter is initi
5da0: 61 6c 69 7a 65 64 20 2a 2f 0a 20 20 69 6e 74 20 alized */. int
5db0: 72 65 67 42 61 73 65 3b 20 20 20 20 20 20 20 20 regBase;
5dc0: 20 20 20 20 20 20 20 20 2f 2a 20 41 72 72 61 79 /* Array
5dd0: 20 6f 66 20 72 65 67 69 73 74 65 72 73 20 77 68 of registers wh
5de0: 65 72 65 20 72 65 63 6f 72 64 20 69 73 20 61 73 ere record is as
5df0: 73 65 6d 62 6c 65 64 20 2a 2f 0a 0a 20 20 2f 2a sembled */.. /*
5e00: 20 47 65 6e 65 72 61 74 65 20 63 6f 64 65 20 74 Generate code t
5e10: 6f 20 73 6b 69 70 20 6f 76 65 72 20 74 68 65 20 o skip over the
5e20: 63 72 65 61 74 69 6f 6e 20 61 6e 64 20 69 6e 69 creation and ini
5e30: 74 69 61 6c 69 7a 61 74 69 6f 6e 20 6f 66 20 74 tialization of t
5e40: 68 65 0a 20 20 2a 2a 20 74 72 61 6e 73 69 65 6e he. ** transien
5e50: 74 20 69 6e 64 65 78 20 6f 6e 20 32 6e 64 20 61 t index on 2nd a
5e60: 6e 64 20 73 75 62 73 65 71 75 65 6e 74 20 69 74 nd subsequent it
5e70: 65 72 61 74 69 6f 6e 73 20 6f 66 20 74 68 65 20 erations of the
5e80: 6c 6f 6f 70 2e 20 2a 2f 0a 20 20 76 20 3d 20 70 loop. */. v = p
5e90: 50 61 72 73 65 2d 3e 70 56 64 62 65 3b 0a 20 20 Parse->pVdbe;.
5ea0: 61 73 73 65 72 74 28 20 76 21 3d 30 20 29 3b 0a assert( v!=0 );.
5eb0: 20 20 61 64 64 72 49 6e 69 74 20 3d 20 73 71 6c addrInit = sql
5ec0: 69 74 65 33 56 64 62 65 41 64 64 4f 70 30 28 76 ite3VdbeAddOp0(v
5ed0: 2c 20 4f 50 5f 4f 6e 63 65 29 3b 20 56 64 62 65 , OP_Once); Vdbe
5ee0: 43 6f 76 65 72 61 67 65 28 76 29 3b 0a 0a 20 20 Coverage(v);..
5ef0: 2f 2a 20 43 6f 75 6e 74 20 74 68 65 20 6e 75 6d /* Count the num
5f00: 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 74 ber of columns t
5f10: 68 61 74 20 77 69 6c 6c 20 62 65 20 61 64 64 65 hat will be adde
5f20: 64 20 74 6f 20 74 68 65 20 69 6e 64 65 78 0a 20 d to the index.
5f30: 20 2a 2a 20 61 6e 64 20 75 73 65 64 20 74 6f 20 ** and used to
5f40: 6d 61 74 63 68 20 57 48 45 52 45 20 63 6c 61 75 match WHERE clau
5f50: 73 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a se constraints *
5f60: 2f 0a 20 20 6e 4b 65 79 43 6f 6c 20 3d 20 30 3b /. nKeyCol = 0;
5f70: 0a 20 20 70 54 61 62 6c 65 20 3d 20 70 53 72 63 . pTable = pSrc
5f80: 2d 3e 70 54 61 62 3b 0a 20 20 70 57 43 45 6e 64 ->pTab;. pWCEnd
5f90: 20 3d 20 26 70 57 43 2d 3e 61 5b 70 57 43 2d 3e = &pWC->a[pWC->
5fa0: 6e 54 65 72 6d 5d 3b 0a 20 20 70 4c 6f 6f 70 20 nTerm];. pLoop
5fb0: 3d 20 70 4c 65 76 65 6c 2d 3e 70 57 4c 6f 6f 70 = pLevel->pWLoop
5fc0: 3b 0a 20 20 69 64 78 43 6f 6c 73 20 3d 20 30 3b ;. idxCols = 0;
5fd0: 0a 20 20 66 6f 72 28 70 54 65 72 6d 3d 70 57 43 . for(pTerm=pWC
5fe0: 2d 3e 61 3b 20 70 54 65 72 6d 3c 70 57 43 45 6e ->a; pTerm<pWCEn
5ff0: 64 3b 20 70 54 65 72 6d 2b 2b 29 7b 0a 20 20 20 d; pTerm++){.
6000: 20 45 78 70 72 20 2a 70 45 78 70 72 20 3d 20 70 Expr *pExpr = p
6010: 54 65 72 6d 2d 3e 70 45 78 70 72 3b 0a 20 20 20 Term->pExpr;.
6020: 20 61 73 73 65 72 74 28 20 21 45 78 70 72 48 61 assert( !ExprHa
6030: 73 50 72 6f 70 65 72 74 79 28 70 45 78 70 72 2c sProperty(pExpr,
6040: 20 45 50 5f 46 72 6f 6d 4a 6f 69 6e 29 20 20 20 EP_FromJoin)
6050: 20 2f 2a 20 70 72 65 72 65 71 20 61 6c 77 61 79 /* prereq alway
6060: 73 20 6e 6f 6e 2d 7a 65 72 6f 20 2a 2f 0a 20 20 s non-zero */.
6070: 20 20 20 20 20 20 20 7c 7c 20 70 45 78 70 72 2d || pExpr-
6080: 3e 69 52 69 67 68 74 4a 6f 69 6e 54 61 62 6c 65 >iRightJoinTable
6090: 21 3d 70 53 72 63 2d 3e 69 43 75 72 73 6f 72 20 !=pSrc->iCursor
60a0: 20 20 2f 2a 20 20 20 66 6f 72 20 74 68 65 20 72 /* for the r
60b0: 69 67 68 74 2d 68 61 6e 64 20 20 20 2a 2f 0a 20 ight-hand */.
60c0: 20 20 20 20 20 20 20 20 7c 7c 20 70 4c 6f 6f 70 || pLoop
60d0: 2d 3e 70 72 65 72 65 71 21 3d 30 20 29 3b 20 20 ->prereq!=0 );
60e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
60f0: 20 20 20 2f 2a 20 20 20 74 61 62 6c 65 20 6f 66 /* table of
6100: 20 61 20 4c 45 46 54 20 4a 4f 49 4e 20 2a 2f 0a a LEFT JOIN */.
6110: 20 20 20 20 69 66 28 20 70 4c 6f 6f 70 2d 3e 70 if( pLoop->p
6120: 72 65 72 65 71 3d 3d 30 0a 20 20 20 20 20 26 26 rereq==0. &&
6130: 20 28 70 54 65 72 6d 2d 3e 77 74 46 6c 61 67 73 (pTerm->wtFlags
6140: 20 26 20 54 45 52 4d 5f 56 49 52 54 55 41 4c 29 & TERM_VIRTUAL)
6150: 3d 3d 30 0a 20 20 20 20 20 26 26 20 21 45 78 70 ==0. && !Exp
6160: 72 48 61 73 50 72 6f 70 65 72 74 79 28 70 45 78 rHasProperty(pEx
6170: 70 72 2c 20 45 50 5f 46 72 6f 6d 4a 6f 69 6e 29 pr, EP_FromJoin)
6180: 0a 20 20 20 20 20 26 26 20 73 71 6c 69 74 65 33 . && sqlite3
6190: 45 78 70 72 49 73 54 61 62 6c 65 43 6f 6e 73 74 ExprIsTableConst
61a0: 61 6e 74 28 70 45 78 70 72 2c 20 70 53 72 63 2d ant(pExpr, pSrc-
61b0: 3e 69 43 75 72 73 6f 72 29 20 29 7b 0a 20 20 20 >iCursor) ){.
61c0: 20 20 20 70 50 61 72 74 69 61 6c 20 3d 20 73 71 pPartial = sq
61d0: 6c 69 74 65 33 45 78 70 72 41 6e 64 28 70 50 61 lite3ExprAnd(pPa
61e0: 72 73 65 2d 3e 64 62 2c 20 70 50 61 72 74 69 61 rse->db, pPartia
61f0: 6c 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 l,.
6200: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6210: 20 20 20 73 71 6c 69 74 65 33 45 78 70 72 44 75 sqlite3ExprDu
6220: 70 28 70 50 61 72 73 65 2d 3e 64 62 2c 20 70 45 p(pParse->db, pE
6230: 78 70 72 2c 20 30 29 29 3b 0a 20 20 20 20 7d 0a xpr, 0));. }.
6240: 20 20 20 20 69 66 28 20 74 65 72 6d 43 61 6e 44 if( termCanD
6250: 72 69 76 65 49 6e 64 65 78 28 70 54 65 72 6d 2c riveIndex(pTerm,
6260: 20 70 53 72 63 2c 20 6e 6f 74 52 65 61 64 79 29 pSrc, notReady)
6270: 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 69 43 ){. int iC
6280: 6f 6c 20 3d 20 70 54 65 72 6d 2d 3e 75 2e 6c 65 ol = pTerm->u.le
6290: 66 74 43 6f 6c 75 6d 6e 3b 0a 20 20 20 20 20 20 ftColumn;.
62a0: 42 69 74 6d 61 73 6b 20 63 4d 61 73 6b 20 3d 20 Bitmask cMask =
62b0: 69 43 6f 6c 3e 3d 42 4d 53 20 3f 20 4d 41 53 4b iCol>=BMS ? MASK
62c0: 42 49 54 28 42 4d 53 2d 31 29 20 3a 20 4d 41 53 BIT(BMS-1) : MAS
62d0: 4b 42 49 54 28 69 43 6f 6c 29 3b 0a 20 20 20 20 KBIT(iCol);.
62e0: 20 20 74 65 73 74 63 61 73 65 28 20 69 43 6f 6c testcase( iCol
62f0: 3d 3d 42 4d 53 20 29 3b 0a 20 20 20 20 20 20 74 ==BMS );. t
6300: 65 73 74 63 61 73 65 28 20 69 43 6f 6c 3d 3d 42 estcase( iCol==B
6310: 4d 53 2d 31 20 29 3b 0a 20 20 20 20 20 20 69 66 MS-1 );. if
6320: 28 20 21 73 65 6e 74 57 61 72 6e 69 6e 67 20 29 ( !sentWarning )
6330: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 {. sqlite
6340: 33 5f 6c 6f 67 28 53 51 4c 49 54 45 5f 57 41 52 3_log(SQLITE_WAR
6350: 4e 49 4e 47 5f 41 55 54 4f 49 4e 44 45 58 2c 0a NING_AUTOINDEX,.
6360: 20 20 20 20 20 20 20 20 20 20 20 20 22 61 75 74 "aut
6370: 6f 6d 61 74 69 63 20 69 6e 64 65 78 20 6f 6e 20 omatic index on
6380: 25 73 28 25 73 29 22 2c 20 70 54 61 62 6c 65 2d %s(%s)", pTable-
6390: 3e 7a 4e 61 6d 65 2c 0a 20 20 20 20 20 20 20 20 >zName,.
63a0: 20 20 20 20 70 54 61 62 6c 65 2d 3e 61 43 6f 6c pTable->aCol
63b0: 5b 69 43 6f 6c 5d 2e 7a 4e 61 6d 65 29 3b 0a 20 [iCol].zName);.
63c0: 20 20 20 20 20 20 20 73 65 6e 74 57 61 72 6e 69 sentWarni
63d0: 6e 67 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a ng = 1;. }.
63e0: 20 20 20 20 20 20 69 66 28 20 28 69 64 78 43 6f if( (idxCo
63f0: 6c 73 20 26 20 63 4d 61 73 6b 29 3d 3d 30 20 29 ls & cMask)==0 )
6400: 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 77 68 {. if( wh
6410: 65 72 65 4c 6f 6f 70 52 65 73 69 7a 65 28 70 50 ereLoopResize(pP
6420: 61 72 73 65 2d 3e 64 62 2c 20 70 4c 6f 6f 70 2c arse->db, pLoop,
6430: 20 6e 4b 65 79 43 6f 6c 2b 31 29 20 29 7b 0a 20 nKeyCol+1) ){.
6440: 20 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e goto en
6450: 64 5f 61 75 74 6f 5f 69 6e 64 65 78 5f 63 72 65 d_auto_index_cre
6460: 61 74 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 ate;. }.
6470: 20 20 20 20 20 20 20 70 4c 6f 6f 70 2d 3e 61 4c pLoop->aL
6480: 54 65 72 6d 5b 6e 4b 65 79 43 6f 6c 2b 2b 5d 20 Term[nKeyCol++]
6490: 3d 20 70 54 65 72 6d 3b 0a 20 20 20 20 20 20 20 = pTerm;.
64a0: 20 69 64 78 43 6f 6c 73 20 7c 3d 20 63 4d 61 73 idxCols |= cMas
64b0: 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d k;. }. }
64c0: 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 6e . }. assert( n
64d0: 4b 65 79 43 6f 6c 3e 30 20 29 3b 0a 20 20 70 4c KeyCol>0 );. pL
64e0: 6f 6f 70 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 71 oop->u.btree.nEq
64f0: 20 3d 20 70 4c 6f 6f 70 2d 3e 6e 4c 54 65 72 6d = pLoop->nLTerm
6500: 20 3d 20 6e 4b 65 79 43 6f 6c 3b 0a 20 20 70 4c = nKeyCol;. pL
6510: 6f 6f 70 2d 3e 77 73 46 6c 61 67 73 20 3d 20 57 oop->wsFlags = W
6520: 48 45 52 45 5f 43 4f 4c 55 4d 4e 5f 45 51 20 7c HERE_COLUMN_EQ |
6530: 20 57 48 45 52 45 5f 49 44 58 5f 4f 4e 4c 59 20 WHERE_IDX_ONLY
6540: 7c 20 57 48 45 52 45 5f 49 4e 44 45 58 45 44 0a | WHERE_INDEXED.
6550: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6560: 20 20 20 20 20 7c 20 57 48 45 52 45 5f 41 55 54 | WHERE_AUT
6570: 4f 5f 49 4e 44 45 58 3b 0a 0a 20 20 2f 2a 20 43 O_INDEX;.. /* C
6580: 6f 75 6e 74 20 74 68 65 20 6e 75 6d 62 65 72 20 ount the number
6590: 6f 66 20 61 64 64 69 74 69 6f 6e 61 6c 20 63 6f of additional co
65a0: 6c 75 6d 6e 73 20 6e 65 65 64 65 64 20 74 6f 20 lumns needed to
65b0: 63 72 65 61 74 65 20 61 0a 20 20 2a 2a 20 63 6f create a. ** co
65c0: 76 65 72 69 6e 67 20 69 6e 64 65 78 2e 20 20 41 vering index. A
65d0: 20 22 63 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 "covering index
65e0: 22 20 69 73 20 61 6e 20 69 6e 64 65 78 20 74 68 " is an index th
65f0: 61 74 20 63 6f 6e 74 61 69 6e 73 20 61 6c 6c 0a at contains all.
6600: 20 20 2a 2a 20 63 6f 6c 75 6d 6e 73 20 74 68 61 ** columns tha
6610: 74 20 61 72 65 20 6e 65 65 64 65 64 20 62 79 20 t are needed by
6620: 74 68 65 20 71 75 65 72 79 2e 20 20 57 69 74 68 the query. With
6630: 20 61 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 65 a covering inde
6640: 78 2c 20 74 68 65 0a 20 20 2a 2a 20 6f 72 69 67 x, the. ** orig
6650: 69 6e 61 6c 20 74 61 62 6c 65 20 6e 65 76 65 72 inal table never
6660: 20 6e 65 65 64 73 20 74 6f 20 62 65 20 61 63 63 needs to be acc
6670: 65 73 73 65 64 2e 20 20 41 75 74 6f 6d 61 74 69 essed. Automati
6680: 63 20 69 6e 64 69 63 65 73 20 6d 75 73 74 0a 20 c indices must.
6690: 20 2a 2a 20 62 65 20 61 20 63 6f 76 65 72 69 6e ** be a coverin
66a0: 67 20 69 6e 64 65 78 20 62 65 63 61 75 73 65 20 g index because
66b0: 74 68 65 20 69 6e 64 65 78 20 77 69 6c 6c 20 6e the index will n
66c0: 6f 74 20 62 65 20 75 70 64 61 74 65 64 20 69 66 ot be updated if
66d0: 20 74 68 65 0a 20 20 2a 2a 20 6f 72 69 67 69 6e the. ** origin
66e0: 61 6c 20 74 61 62 6c 65 20 63 68 61 6e 67 65 73 al table changes
66f0: 20 61 6e 64 20 74 68 65 20 69 6e 64 65 78 20 61 and the index a
6700: 6e 64 20 74 61 62 6c 65 20 63 61 6e 6e 6f 74 20 nd table cannot
6710: 62 6f 74 68 20 62 65 20 75 73 65 64 0a 20 20 2a both be used. *
6720: 2a 20 69 66 20 74 68 65 79 20 67 6f 20 6f 75 74 * if they go out
6730: 20 6f 66 20 73 79 6e 63 2e 0a 20 20 2a 2f 0a 20 of sync.. */.
6740: 20 65 78 74 72 61 43 6f 6c 73 20 3d 20 70 53 72 extraCols = pSr
6750: 63 2d 3e 63 6f 6c 55 73 65 64 20 26 20 28 7e 69 c->colUsed & (~i
6760: 64 78 43 6f 6c 73 20 7c 20 4d 41 53 4b 42 49 54 dxCols | MASKBIT
6770: 28 42 4d 53 2d 31 29 29 3b 0a 20 20 6d 78 42 69 (BMS-1));. mxBi
6780: 74 43 6f 6c 20 3d 20 4d 49 4e 28 42 4d 53 2d 31 tCol = MIN(BMS-1
6790: 2c 70 54 61 62 6c 65 2d 3e 6e 43 6f 6c 29 3b 0a ,pTable->nCol);.
67a0: 20 20 74 65 73 74 63 61 73 65 28 20 70 54 61 62 testcase( pTab
67b0: 6c 65 2d 3e 6e 43 6f 6c 3d 3d 42 4d 53 2d 31 20 le->nCol==BMS-1
67c0: 29 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 70 );. testcase( p
67d0: 54 61 62 6c 65 2d 3e 6e 43 6f 6c 3d 3d 42 4d 53 Table->nCol==BMS
67e0: 2d 32 20 29 3b 0a 20 20 66 6f 72 28 69 3d 30 3b -2 );. for(i=0;
67f0: 20 69 3c 6d 78 42 69 74 43 6f 6c 3b 20 69 2b 2b i<mxBitCol; i++
6800: 29 7b 0a 20 20 20 20 69 66 28 20 65 78 74 72 61 ){. if( extra
6810: 43 6f 6c 73 20 26 20 4d 41 53 4b 42 49 54 28 69 Cols & MASKBIT(i
6820: 29 20 29 20 6e 4b 65 79 43 6f 6c 2b 2b 3b 0a 20 ) ) nKeyCol++;.
6830: 20 7d 0a 20 20 69 66 28 20 70 53 72 63 2d 3e 63 }. if( pSrc->c
6840: 6f 6c 55 73 65 64 20 26 20 4d 41 53 4b 42 49 54 olUsed & MASKBIT
6850: 28 42 4d 53 2d 31 29 20 29 7b 0a 20 20 20 20 6e (BMS-1) ){. n
6860: 4b 65 79 43 6f 6c 20 2b 3d 20 70 54 61 62 6c 65 KeyCol += pTable
6870: 2d 3e 6e 43 6f 6c 20 2d 20 42 4d 53 20 2b 20 31 ->nCol - BMS + 1
6880: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 6f 6e 73 ;. }.. /* Cons
6890: 74 72 75 63 74 20 74 68 65 20 49 6e 64 65 78 20 truct the Index
68a0: 6f 62 6a 65 63 74 20 74 6f 20 64 65 73 63 72 69 object to descri
68b0: 62 65 20 74 68 69 73 20 69 6e 64 65 78 20 2a 2f be this index */
68c0: 0a 20 20 70 49 64 78 20 3d 20 73 71 6c 69 74 65 . pIdx = sqlite
68d0: 33 41 6c 6c 6f 63 61 74 65 49 6e 64 65 78 4f 62 3AllocateIndexOb
68e0: 6a 65 63 74 28 70 50 61 72 73 65 2d 3e 64 62 2c ject(pParse->db,
68f0: 20 6e 4b 65 79 43 6f 6c 2b 31 2c 20 30 2c 20 26 nKeyCol+1, 0, &
6900: 7a 4e 6f 74 55 73 65 64 29 3b 0a 20 20 69 66 28 zNotUsed);. if(
6910: 20 70 49 64 78 3d 3d 30 20 29 20 67 6f 74 6f 20 pIdx==0 ) goto
6920: 65 6e 64 5f 61 75 74 6f 5f 69 6e 64 65 78 5f 63 end_auto_index_c
6930: 72 65 61 74 65 3b 0a 20 20 70 4c 6f 6f 70 2d 3e reate;. pLoop->
6940: 75 2e 62 74 72 65 65 2e 70 49 6e 64 65 78 20 3d u.btree.pIndex =
6950: 20 70 49 64 78 3b 0a 20 20 70 49 64 78 2d 3e 7a pIdx;. pIdx->z
6960: 4e 61 6d 65 20 3d 20 22 61 75 74 6f 2d 69 6e 64 Name = "auto-ind
6970: 65 78 22 3b 0a 20 20 70 49 64 78 2d 3e 70 54 61 ex";. pIdx->pTa
6980: 62 6c 65 20 3d 20 70 54 61 62 6c 65 3b 0a 20 20 ble = pTable;.
6990: 6e 20 3d 20 30 3b 0a 20 20 69 64 78 43 6f 6c 73 n = 0;. idxCols
69a0: 20 3d 20 30 3b 0a 20 20 66 6f 72 28 70 54 65 72 = 0;. for(pTer
69b0: 6d 3d 70 57 43 2d 3e 61 3b 20 70 54 65 72 6d 3c m=pWC->a; pTerm<
69c0: 70 57 43 45 6e 64 3b 20 70 54 65 72 6d 2b 2b 29 pWCEnd; pTerm++)
69d0: 7b 0a 20 20 20 20 69 66 28 20 74 65 72 6d 43 61 {. if( termCa
69e0: 6e 44 72 69 76 65 49 6e 64 65 78 28 70 54 65 72 nDriveIndex(pTer
69f0: 6d 2c 20 70 53 72 63 2c 20 6e 6f 74 52 65 61 64 m, pSrc, notRead
6a00: 79 29 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 y) ){. int
6a10: 69 43 6f 6c 20 3d 20 70 54 65 72 6d 2d 3e 75 2e iCol = pTerm->u.
6a20: 6c 65 66 74 43 6f 6c 75 6d 6e 3b 0a 20 20 20 20 leftColumn;.
6a30: 20 20 42 69 74 6d 61 73 6b 20 63 4d 61 73 6b 20 Bitmask cMask
6a40: 3d 20 69 43 6f 6c 3e 3d 42 4d 53 20 3f 20 4d 41 = iCol>=BMS ? MA
6a50: 53 4b 42 49 54 28 42 4d 53 2d 31 29 20 3a 20 4d SKBIT(BMS-1) : M
6a60: 41 53 4b 42 49 54 28 69 43 6f 6c 29 3b 0a 20 20 ASKBIT(iCol);.
6a70: 20 20 20 20 74 65 73 74 63 61 73 65 28 20 69 43 testcase( iC
6a80: 6f 6c 3d 3d 42 4d 53 2d 31 20 29 3b 0a 20 20 20 ol==BMS-1 );.
6a90: 20 20 20 74 65 73 74 63 61 73 65 28 20 69 43 6f testcase( iCo
6aa0: 6c 3d 3d 42 4d 53 20 29 3b 0a 20 20 20 20 20 20 l==BMS );.
6ab0: 69 66 28 20 28 69 64 78 43 6f 6c 73 20 26 20 63 if( (idxCols & c
6ac0: 4d 61 73 6b 29 3d 3d 30 20 29 7b 0a 20 20 20 20 Mask)==0 ){.
6ad0: 20 20 20 20 45 78 70 72 20 2a 70 58 20 3d 20 70 Expr *pX = p
6ae0: 54 65 72 6d 2d 3e 70 45 78 70 72 3b 0a 20 20 20 Term->pExpr;.
6af0: 20 20 20 20 20 69 64 78 43 6f 6c 73 20 7c 3d 20 idxCols |=
6b00: 63 4d 61 73 6b 3b 0a 20 20 20 20 20 20 20 20 70 cMask;. p
6b10: 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 6e 5d Idx->aiColumn[n]
6b20: 20 3d 20 70 54 65 72 6d 2d 3e 75 2e 6c 65 66 74 = pTerm->u.left
6b30: 43 6f 6c 75 6d 6e 3b 0a 20 20 20 20 20 20 20 20 Column;.
6b40: 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 42 pColl = sqlite3B
6b50: 69 6e 61 72 79 43 6f 6d 70 61 72 65 43 6f 6c 6c inaryCompareColl
6b60: 53 65 71 28 70 50 61 72 73 65 2c 20 70 58 2d 3e Seq(pParse, pX->
6b70: 70 4c 65 66 74 2c 20 70 58 2d 3e 70 52 69 67 68 pLeft, pX->pRigh
6b80: 74 29 3b 0a 20 20 20 20 20 20 20 20 70 49 64 78 t);. pIdx
6b90: 2d 3e 61 7a 43 6f 6c 6c 5b 6e 5d 20 3d 20 70 43 ->azColl[n] = pC
6ba0: 6f 6c 6c 20 3f 20 70 43 6f 6c 6c 2d 3e 7a 4e 61 oll ? pColl->zNa
6bb0: 6d 65 20 3a 20 73 71 6c 69 74 65 33 53 74 72 42 me : sqlite3StrB
6bc0: 49 4e 41 52 59 3b 0a 20 20 20 20 20 20 20 20 6e INARY;. n
6bd0: 2b 2b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ++;. }.
6be0: 7d 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 }. }. assert(
6bf0: 28 75 33 32 29 6e 3d 3d 70 4c 6f 6f 70 2d 3e 75 (u32)n==pLoop->u
6c00: 2e 62 74 72 65 65 2e 6e 45 71 20 29 3b 0a 0a 20 .btree.nEq );..
6c10: 20 2f 2a 20 41 64 64 20 61 64 64 69 74 69 6f 6e /* Add addition
6c20: 61 6c 20 63 6f 6c 75 6d 6e 73 20 6e 65 65 64 65 al columns neede
6c30: 64 20 74 6f 20 6d 61 6b 65 20 74 68 65 20 61 75 d to make the au
6c40: 74 6f 6d 61 74 69 63 20 69 6e 64 65 78 20 69 6e tomatic index in
6c50: 74 6f 0a 20 20 2a 2a 20 61 20 63 6f 76 65 72 69 to. ** a coveri
6c60: 6e 67 20 69 6e 64 65 78 20 2a 2f 0a 20 20 66 6f ng index */. fo
6c70: 72 28 69 3d 30 3b 20 69 3c 6d 78 42 69 74 43 6f r(i=0; i<mxBitCo
6c80: 6c 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 l; i++){. if(
6c90: 20 65 78 74 72 61 43 6f 6c 73 20 26 20 4d 41 53 extraCols & MAS
6ca0: 4b 42 49 54 28 69 29 20 29 7b 0a 20 20 20 20 20 KBIT(i) ){.
6cb0: 20 70 49 64 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b pIdx->aiColumn[
6cc0: 6e 5d 20 3d 20 69 3b 0a 20 20 20 20 20 20 70 49 n] = i;. pI
6cd0: 64 78 2d 3e 61 7a 43 6f 6c 6c 5b 6e 5d 20 3d 20 dx->azColl[n] =
6ce0: 73 71 6c 69 74 65 33 53 74 72 42 49 4e 41 52 59 sqlite3StrBINARY
6cf0: 3b 0a 20 20 20 20 20 20 6e 2b 2b 3b 0a 20 20 20 ;. n++;.
6d00: 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 53 72 }. }. if( pSr
6d10: 63 2d 3e 63 6f 6c 55 73 65 64 20 26 20 4d 41 53 c->colUsed & MAS
6d20: 4b 42 49 54 28 42 4d 53 2d 31 29 20 29 7b 0a 20 KBIT(BMS-1) ){.
6d30: 20 20 20 66 6f 72 28 69 3d 42 4d 53 2d 31 3b 20 for(i=BMS-1;
6d40: 69 3c 70 54 61 62 6c 65 2d 3e 6e 43 6f 6c 3b 20 i<pTable->nCol;
6d50: 69 2b 2b 29 7b 0a 20 20 20 20 20 20 70 49 64 78 i++){. pIdx
6d60: 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 6e 5d 20 3d 20 ->aiColumn[n] =
6d70: 69 3b 0a 20 20 20 20 20 20 70 49 64 78 2d 3e 61 i;. pIdx->a
6d80: 7a 43 6f 6c 6c 5b 6e 5d 20 3d 20 73 71 6c 69 74 zColl[n] = sqlit
6d90: 65 33 53 74 72 42 49 4e 41 52 59 3b 0a 20 20 20 e3StrBINARY;.
6da0: 20 20 20 6e 2b 2b 3b 0a 20 20 20 20 7d 0a 20 20 n++;. }.
6db0: 7d 0a 20 20 61 73 73 65 72 74 28 20 6e 3d 3d 6e }. assert( n==n
6dc0: 4b 65 79 43 6f 6c 20 29 3b 0a 20 20 70 49 64 78 KeyCol );. pIdx
6dd0: 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 6e 5d 20 3d 20 ->aiColumn[n] =
6de0: 58 4e 5f 52 4f 57 49 44 3b 0a 20 20 70 49 64 78 XN_ROWID;. pIdx
6df0: 2d 3e 61 7a 43 6f 6c 6c 5b 6e 5d 20 3d 20 73 71 ->azColl[n] = sq
6e00: 6c 69 74 65 33 53 74 72 42 49 4e 41 52 59 3b 0a lite3StrBINARY;.
6e10: 0a 20 20 2f 2a 20 43 72 65 61 74 65 20 74 68 65 . /* Create the
6e20: 20 61 75 74 6f 6d 61 74 69 63 20 69 6e 64 65 78 automatic index
6e30: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 70 4c */. assert( pL
6e40: 65 76 65 6c 2d 3e 69 49 64 78 43 75 72 3e 3d 30 evel->iIdxCur>=0
6e50: 20 29 3b 0a 20 20 70 4c 65 76 65 6c 2d 3e 69 49 );. pLevel->iI
6e60: 64 78 43 75 72 20 3d 20 70 50 61 72 73 65 2d 3e dxCur = pParse->
6e70: 6e 54 61 62 2b 2b 3b 0a 20 20 73 71 6c 69 74 65 nTab++;. sqlite
6e80: 33 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 3VdbeAddOp2(v, O
6e90: 50 5f 4f 70 65 6e 41 75 74 6f 69 6e 64 65 78 2c P_OpenAutoindex,
6ea0: 20 70 4c 65 76 65 6c 2d 3e 69 49 64 78 43 75 72 pLevel->iIdxCur
6eb0: 2c 20 6e 4b 65 79 43 6f 6c 2b 31 29 3b 0a 20 20 , nKeyCol+1);.
6ec0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 50 34 sqlite3VdbeSetP4
6ed0: 4b 65 79 49 6e 66 6f 28 70 50 61 72 73 65 2c 20 KeyInfo(pParse,
6ee0: 70 49 64 78 29 3b 0a 20 20 56 64 62 65 43 6f 6d pIdx);. VdbeCom
6ef0: 6d 65 6e 74 28 28 76 2c 20 22 66 6f 72 20 25 73 ment((v, "for %s
6f00: 22 2c 20 70 54 61 62 6c 65 2d 3e 7a 4e 61 6d 65 ", pTable->zName
6f10: 29 29 3b 0a 0a 20 20 2f 2a 20 46 69 6c 6c 20 74 ));.. /* Fill t
6f20: 68 65 20 61 75 74 6f 6d 61 74 69 63 20 69 6e 64 he automatic ind
6f30: 65 78 20 77 69 74 68 20 63 6f 6e 74 65 6e 74 20 ex with content
6f40: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 45 78 70 72 */. sqlite3Expr
6f50: 43 61 63 68 65 50 75 73 68 28 70 50 61 72 73 65 CachePush(pParse
6f60: 29 3b 0a 20 20 70 54 61 62 49 74 65 6d 20 3d 20 );. pTabItem =
6f70: 26 70 57 43 2d 3e 70 57 49 6e 66 6f 2d 3e 70 54 &pWC->pWInfo->pT
6f80: 61 62 4c 69 73 74 2d 3e 61 5b 70 4c 65 76 65 6c abList->a[pLevel
6f90: 2d 3e 69 46 72 6f 6d 5d 3b 0a 20 20 69 66 28 20 ->iFrom];. if(
6fa0: 70 54 61 62 49 74 65 6d 2d 3e 66 67 2e 76 69 61 pTabItem->fg.via
6fb0: 43 6f 72 6f 75 74 69 6e 65 20 29 7b 0a 20 20 20 Coroutine ){.
6fc0: 20 69 6e 74 20 72 65 67 59 69 65 6c 64 20 3d 20 int regYield =
6fd0: 70 54 61 62 49 74 65 6d 2d 3e 72 65 67 52 65 74 pTabItem->regRet
6fe0: 75 72 6e 3b 0a 20 20 20 20 61 64 64 72 43 6f 75 urn;. addrCou
6ff0: 6e 74 65 72 20 3d 20 73 71 6c 69 74 65 33 56 64 nter = sqlite3Vd
7000: 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 49 beAddOp2(v, OP_I
7010: 6e 74 65 67 65 72 2c 20 30 2c 20 30 29 3b 0a 20 nteger, 0, 0);.
7020: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 41 64 sqlite3VdbeAd
7030: 64 4f 70 33 28 76 2c 20 4f 50 5f 49 6e 69 74 43 dOp3(v, OP_InitC
7040: 6f 72 6f 75 74 69 6e 65 2c 20 72 65 67 59 69 65 oroutine, regYie
7050: 6c 64 2c 20 30 2c 20 70 54 61 62 49 74 65 6d 2d ld, 0, pTabItem-
7060: 3e 61 64 64 72 46 69 6c 6c 53 75 62 29 3b 0a 20 >addrFillSub);.
7070: 20 20 20 61 64 64 72 54 6f 70 20 3d 20 20 73 71 addrTop = sq
7080: 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 31 28 lite3VdbeAddOp1(
7090: 76 2c 20 4f 50 5f 59 69 65 6c 64 2c 20 72 65 67 v, OP_Yield, reg
70a0: 59 69 65 6c 64 29 3b 0a 20 20 20 20 56 64 62 65 Yield);. Vdbe
70b0: 43 6f 76 65 72 61 67 65 28 76 29 3b 0a 20 20 20 Coverage(v);.
70c0: 20 56 64 62 65 43 6f 6d 6d 65 6e 74 28 28 76 2c VdbeComment((v,
70d0: 20 22 6e 65 78 74 20 72 6f 77 20 6f 66 20 5c 22 "next row of \"
70e0: 25 73 5c 22 22 2c 20 70 54 61 62 49 74 65 6d 2d %s\"", pTabItem-
70f0: 3e 70 54 61 62 2d 3e 7a 4e 61 6d 65 29 29 3b 0a >pTab->zName));.
7100: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 64 64 }else{. add
7110: 72 54 6f 70 20 3d 20 73 71 6c 69 74 65 33 56 64 rTop = sqlite3Vd
7120: 62 65 41 64 64 4f 70 31 28 76 2c 20 4f 50 5f 52 beAddOp1(v, OP_R
7130: 65 77 69 6e 64 2c 20 70 4c 65 76 65 6c 2d 3e 69 ewind, pLevel->i
7140: 54 61 62 43 75 72 29 3b 20 56 64 62 65 43 6f 76 TabCur); VdbeCov
7150: 65 72 61 67 65 28 76 29 3b 0a 20 20 7d 0a 20 20 erage(v);. }.
7160: 69 66 28 20 70 50 61 72 74 69 61 6c 20 29 7b 0a if( pPartial ){.
7170: 20 20 20 20 69 43 6f 6e 74 69 6e 75 65 20 3d 20 iContinue =
7180: 73 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c sqlite3VdbeMakeL
7190: 61 62 65 6c 28 76 29 3b 0a 20 20 20 20 73 71 6c abel(v);. sql
71a0: 69 74 65 33 45 78 70 72 49 66 46 61 6c 73 65 28 ite3ExprIfFalse(
71b0: 70 50 61 72 73 65 2c 20 70 50 61 72 74 69 61 6c pParse, pPartial
71c0: 2c 20 69 43 6f 6e 74 69 6e 75 65 2c 20 53 51 4c , iContinue, SQL
71d0: 49 54 45 5f 4a 55 4d 50 49 46 4e 55 4c 4c 29 3b ITE_JUMPIFNULL);
71e0: 0a 20 20 20 20 70 4c 6f 6f 70 2d 3e 77 73 46 6c . pLoop->wsFl
71f0: 61 67 73 20 7c 3d 20 57 48 45 52 45 5f 50 41 52 ags |= WHERE_PAR
7200: 54 49 41 4c 49 44 58 3b 0a 20 20 7d 0a 20 20 72 TIALIDX;. }. r
7210: 65 67 52 65 63 6f 72 64 20 3d 20 73 71 6c 69 74 egRecord = sqlit
7220: 65 33 47 65 74 54 65 6d 70 52 65 67 28 70 50 61 e3GetTempReg(pPa
7230: 72 73 65 29 3b 0a 20 20 72 65 67 42 61 73 65 20 rse);. regBase
7240: 3d 20 73 71 6c 69 74 65 33 47 65 6e 65 72 61 74 = sqlite3Generat
7250: 65 49 6e 64 65 78 4b 65 79 28 0a 20 20 20 20 20 eIndexKey(.
7260: 20 70 50 61 72 73 65 2c 20 70 49 64 78 2c 20 70 pParse, pIdx, p
7270: 4c 65 76 65 6c 2d 3e 69 54 61 62 43 75 72 2c 20 Level->iTabCur,
7280: 72 65 67 52 65 63 6f 72 64 2c 20 30 2c 20 30 2c regRecord, 0, 0,
7290: 20 30 2c 20 30 0a 20 20 29 3b 0a 20 20 73 71 6c 0, 0. );. sql
72a0: 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 28 76 ite3VdbeAddOp2(v
72b0: 2c 20 4f 50 5f 49 64 78 49 6e 73 65 72 74 2c 20 , OP_IdxInsert,
72c0: 70 4c 65 76 65 6c 2d 3e 69 49 64 78 43 75 72 2c pLevel->iIdxCur,
72d0: 20 72 65 67 52 65 63 6f 72 64 29 3b 0a 20 20 73 regRecord);. s
72e0: 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e 67 65 qlite3VdbeChange
72f0: 50 35 28 76 2c 20 4f 50 46 4c 41 47 5f 55 53 45 P5(v, OPFLAG_USE
7300: 53 45 45 4b 52 45 53 55 4c 54 29 3b 0a 20 20 69 SEEKRESULT);. i
7310: 66 28 20 70 50 61 72 74 69 61 6c 20 29 20 73 71 f( pPartial ) sq
7320: 6c 69 74 65 33 56 64 62 65 52 65 73 6f 6c 76 65 lite3VdbeResolve
7330: 4c 61 62 65 6c 28 76 2c 20 69 43 6f 6e 74 69 6e Label(v, iContin
7340: 75 65 29 3b 0a 20 20 69 66 28 20 70 54 61 62 49 ue);. if( pTabI
7350: 74 65 6d 2d 3e 66 67 2e 76 69 61 43 6f 72 6f 75 tem->fg.viaCorou
7360: 74 69 6e 65 20 29 7b 0a 20 20 20 20 73 71 6c 69 tine ){. sqli
7370: 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 32 28 te3VdbeChangeP2(
7380: 76 2c 20 61 64 64 72 43 6f 75 6e 74 65 72 2c 20 v, addrCounter,
7390: 72 65 67 42 61 73 65 2b 6e 29 3b 0a 20 20 20 20 regBase+n);.
73a0: 74 65 73 74 63 61 73 65 28 20 70 50 61 72 73 65 testcase( pParse
73b0: 2d 3e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c ->db->mallocFail
73c0: 65 64 20 29 3b 0a 20 20 20 20 74 72 61 6e 73 6c ed );. transl
73d0: 61 74 65 43 6f 6c 75 6d 6e 54 6f 43 6f 70 79 28 ateColumnToCopy(
73e0: 70 50 61 72 73 65 2c 20 61 64 64 72 54 6f 70 2c pParse, addrTop,
73f0: 20 70 4c 65 76 65 6c 2d 3e 69 54 61 62 43 75 72 pLevel->iTabCur
7400: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
7410: 20 20 20 20 20 20 20 20 20 20 20 20 70 54 61 62 pTab
7420: 49 74 65 6d 2d 3e 72 65 67 52 65 73 75 6c 74 2c Item->regResult,
7430: 20 31 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 1);. sqlite3
7440: 56 64 62 65 47 6f 74 6f 28 76 2c 20 61 64 64 72 VdbeGoto(v, addr
7450: 54 6f 70 29 3b 0a 20 20 20 20 70 54 61 62 49 74 Top);. pTabIt
7460: 65 6d 2d 3e 66 67 2e 76 69 61 43 6f 72 6f 75 74 em->fg.viaCorout
7470: 69 6e 65 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 ine = 0;. }else
7480: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 {. sqlite3Vdb
7490: 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 4e 65 eAddOp2(v, OP_Ne
74a0: 78 74 2c 20 70 4c 65 76 65 6c 2d 3e 69 54 61 62 xt, pLevel->iTab
74b0: 43 75 72 2c 20 61 64 64 72 54 6f 70 2b 31 29 3b Cur, addrTop+1);
74c0: 20 56 64 62 65 43 6f 76 65 72 61 67 65 28 76 29 VdbeCoverage(v)
74d0: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 56 ;. }. sqlite3V
74e0: 64 62 65 43 68 61 6e 67 65 50 35 28 76 2c 20 53 dbeChangeP5(v, S
74f0: 51 4c 49 54 45 5f 53 54 4d 54 53 54 41 54 55 53 QLITE_STMTSTATUS
7500: 5f 41 55 54 4f 49 4e 44 45 58 29 3b 0a 20 20 73 _AUTOINDEX);. s
7510: 71 6c 69 74 65 33 56 64 62 65 4a 75 6d 70 48 65 qlite3VdbeJumpHe
7520: 72 65 28 76 2c 20 61 64 64 72 54 6f 70 29 3b 0a re(v, addrTop);.
7530: 20 20 73 71 6c 69 74 65 33 52 65 6c 65 61 73 65 sqlite3Release
7540: 54 65 6d 70 52 65 67 28 70 50 61 72 73 65 2c 20 TempReg(pParse,
7550: 72 65 67 52 65 63 6f 72 64 29 3b 0a 20 20 73 71 regRecord);. sq
7560: 6c 69 74 65 33 45 78 70 72 43 61 63 68 65 50 6f lite3ExprCachePo
7570: 70 28 70 50 61 72 73 65 29 3b 0a 20 20 0a 20 20 p(pParse);. .
7580: 2f 2a 20 4a 75 6d 70 20 68 65 72 65 20 77 68 65 /* Jump here whe
7590: 6e 20 73 6b 69 70 70 69 6e 67 20 74 68 65 20 69 n skipping the i
75a0: 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 2a 2f nitialization */
75b0: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 4a 75 . sqlite3VdbeJu
75c0: 6d 70 48 65 72 65 28 76 2c 20 61 64 64 72 49 6e mpHere(v, addrIn
75d0: 69 74 29 3b 0a 0a 65 6e 64 5f 61 75 74 6f 5f 69 it);..end_auto_i
75e0: 6e 64 65 78 5f 63 72 65 61 74 65 3a 0a 20 20 73 ndex_create:. s
75f0: 71 6c 69 74 65 33 45 78 70 72 44 65 6c 65 74 65 qlite3ExprDelete
7600: 28 70 50 61 72 73 65 2d 3e 64 62 2c 20 70 50 61 (pParse->db, pPa
7610: 72 74 69 61 6c 29 3b 0a 7d 0a 23 65 6e 64 69 66 rtial);.}.#endif
7620: 20 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f /* SQLITE_OMIT_
7630: 41 55 54 4f 4d 41 54 49 43 5f 49 4e 44 45 58 20 AUTOMATIC_INDEX
7640: 2a 2f 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 */..#ifndef SQLI
7650: 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 TE_OMIT_VIRTUALT
7660: 41 42 4c 45 0a 2f 2a 0a 2a 2a 20 41 6c 6c 6f 63 ABLE./*.** Alloc
7670: 61 74 65 20 61 6e 64 20 70 6f 70 75 6c 61 74 65 ate and populate
7680: 20 61 6e 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 an sqlite3_inde
7690: 78 5f 69 6e 66 6f 20 73 74 72 75 63 74 75 72 65 x_info structure
76a0: 2e 20 49 74 20 69 73 20 74 68 65 20 0a 2a 2a 20 . It is the .**
76b0: 72 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f responsibility o
76c0: 66 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 f the caller to
76d0: 65 76 65 6e 74 75 61 6c 6c 79 20 72 65 6c 65 61 eventually relea
76e0: 73 65 20 74 68 65 20 73 74 72 75 63 74 75 72 65 se the structure
76f0: 0a 2a 2a 20 62 79 20 70 61 73 73 69 6e 67 20 74 .** by passing t
7700: 68 65 20 70 6f 69 6e 74 65 72 20 72 65 74 75 72 he pointer retur
7710: 6e 65 64 20 62 79 20 74 68 69 73 20 66 75 6e 63 ned by this func
7720: 74 69 6f 6e 20 74 6f 20 73 71 6c 69 74 65 33 5f tion to sqlite3_
7730: 66 72 65 65 28 29 2e 0a 2a 2f 0a 73 74 61 74 69 free()..*/.stati
7740: 63 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f c sqlite3_index_
7750: 69 6e 66 6f 20 2a 61 6c 6c 6f 63 61 74 65 49 6e info *allocateIn
7760: 64 65 78 49 6e 66 6f 28 0a 20 20 50 61 72 73 65 dexInfo(. Parse
7770: 20 2a 70 50 61 72 73 65 2c 20 20 20 20 20 20 20 *pParse,
7780: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
7790: 65 20 70 61 72 73 69 6e 67 20 63 6f 6e 74 65 78 e parsing contex
77a0: 74 20 2a 2f 0a 20 20 57 68 65 72 65 43 6c 61 75 t */. WhereClau
77b0: 73 65 20 2a 70 57 43 2c 20 20 20 20 20 20 20 20 se *pWC,
77c0: 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 57 48 /* The WH
77d0: 45 52 45 20 63 6c 61 75 73 65 20 62 65 69 6e 67 ERE clause being
77e0: 20 61 6e 61 6c 79 7a 65 64 20 2a 2f 0a 20 20 42 analyzed */. B
77f0: 69 74 6d 61 73 6b 20 6d 55 6e 75 73 61 62 6c 65 itmask mUnusable
7800: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
7810: 2a 20 49 67 6e 6f 72 65 20 74 65 72 6d 73 20 77 * Ignore terms w
7820: 69 74 68 20 74 68 65 73 65 20 70 72 65 72 65 71 ith these prereq
7830: 73 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 53 72 s */. struct Sr
7840: 63 4c 69 73 74 5f 69 74 65 6d 20 2a 70 53 72 63 cList_item *pSrc
7850: 2c 20 20 20 20 20 20 2f 2a 20 54 68 65 20 46 52 , /* The FR
7860: 4f 4d 20 63 6c 61 75 73 65 20 74 65 72 6d 20 74 OM clause term t
7870: 68 61 74 20 69 73 20 74 68 65 20 76 74 61 62 20 hat is the vtab
7880: 2a 2f 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 */. ExprList *p
7890: 4f 72 64 65 72 42 79 2c 20 20 20 20 20 20 20 20 OrderBy,
78a0: 20 20 20 20 20 2f 2a 20 54 68 65 20 4f 52 44 45 /* The ORDE
78b0: 52 20 42 59 20 63 6c 61 75 73 65 20 2a 2f 0a 20 R BY clause */.
78c0: 20 75 31 36 20 2a 70 6d 4e 6f 4f 6d 69 74 20 20 u16 *pmNoOmit
78d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
78e0: 20 2f 2a 20 4d 61 73 6b 20 6f 66 20 74 65 72 6d /* Mask of term
78f0: 73 20 6e 6f 74 20 74 6f 20 6f 6d 69 74 20 2a 2f s not to omit */
7900: 0a 29 7b 0a 20 20 69 6e 74 20 69 2c 20 6a 3b 0a .){. int i, j;.
7910: 20 20 69 6e 74 20 6e 54 65 72 6d 3b 0a 20 20 73 int nTerm;. s
7920: 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 69 6e truct sqlite3_in
7930: 64 65 78 5f 63 6f 6e 73 74 72 61 69 6e 74 20 2a dex_constraint *
7940: 70 49 64 78 43 6f 6e 73 3b 0a 20 20 73 74 72 75 pIdxCons;. stru
7950: 63 74 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 ct sqlite3_index
7960: 5f 6f 72 64 65 72 62 79 20 2a 70 49 64 78 4f 72 _orderby *pIdxOr
7970: 64 65 72 42 79 3b 0a 20 20 73 74 72 75 63 74 20 derBy;. struct
7980: 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 63 6f sqlite3_index_co
7990: 6e 73 74 72 61 69 6e 74 5f 75 73 61 67 65 20 2a nstraint_usage *
79a0: 70 55 73 61 67 65 3b 0a 20 20 73 74 72 75 63 74 pUsage;. struct
79b0: 20 48 69 64 64 65 6e 49 6e 64 65 78 49 6e 66 6f HiddenIndexInfo
79c0: 20 2a 70 48 69 64 64 65 6e 3b 0a 20 20 57 68 65 *pHidden;. Whe
79d0: 72 65 54 65 72 6d 20 2a 70 54 65 72 6d 3b 0a 20 reTerm *pTerm;.
79e0: 20 69 6e 74 20 6e 4f 72 64 65 72 42 79 3b 0a 20 int nOrderBy;.
79f0: 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 69 sqlite3_index_i
7a00: 6e 66 6f 20 2a 70 49 64 78 49 6e 66 6f 3b 0a 20 nfo *pIdxInfo;.
7a10: 20 75 31 36 20 6d 4e 6f 4f 6d 69 74 20 3d 20 30 u16 mNoOmit = 0
7a20: 3b 0a 0a 20 20 2f 2a 20 43 6f 75 6e 74 20 74 68 ;.. /* Count th
7a30: 65 20 6e 75 6d 62 65 72 20 6f 66 20 70 6f 73 73 e number of poss
7a40: 69 62 6c 65 20 57 48 45 52 45 20 63 6c 61 75 73 ible WHERE claus
7a50: 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 72 65 e constraints re
7a60: 66 65 72 72 69 6e 67 0a 20 20 2a 2a 20 74 6f 20 ferring. ** to
7a70: 74 68 69 73 20 76 69 72 74 75 61 6c 20 74 61 62 this virtual tab
7a80: 6c 65 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 6e 54 le */. for(i=nT
7a90: 65 72 6d 3d 30 2c 20 70 54 65 72 6d 3d 70 57 43 erm=0, pTerm=pWC
7aa0: 2d 3e 61 3b 20 69 3c 70 57 43 2d 3e 6e 54 65 72 ->a; i<pWC->nTer
7ab0: 6d 3b 20 69 2b 2b 2c 20 70 54 65 72 6d 2b 2b 29 m; i++, pTerm++)
7ac0: 7b 0a 20 20 20 20 69 66 28 20 70 54 65 72 6d 2d {. if( pTerm-
7ad0: 3e 6c 65 66 74 43 75 72 73 6f 72 20 21 3d 20 70 >leftCursor != p
7ae0: 53 72 63 2d 3e 69 43 75 72 73 6f 72 20 29 20 63 Src->iCursor ) c
7af0: 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69 66 28 ontinue;. if(
7b00: 20 70 54 65 72 6d 2d 3e 70 72 65 72 65 71 52 69 pTerm->prereqRi
7b10: 67 68 74 20 26 20 6d 55 6e 75 73 61 62 6c 65 20 ght & mUnusable
7b20: 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 ) continue;.
7b30: 61 73 73 65 72 74 28 20 49 73 50 6f 77 65 72 4f assert( IsPowerO
7b40: 66 54 77 6f 28 70 54 65 72 6d 2d 3e 65 4f 70 65 fTwo(pTerm->eOpe
7b50: 72 61 74 6f 72 20 26 20 7e 57 4f 5f 45 51 55 49 rator & ~WO_EQUI
7b60: 56 29 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 V) );. testca
7b70: 73 65 28 20 70 54 65 72 6d 2d 3e 65 4f 70 65 72 se( pTerm->eOper
7b80: 61 74 6f 72 20 26 20 57 4f 5f 49 4e 20 29 3b 0a ator & WO_IN );.
7b90: 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 54 testcase( pT
7ba0: 65 72 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 erm->eOperator &
7bb0: 20 57 4f 5f 49 53 4e 55 4c 4c 20 29 3b 0a 20 20 WO_ISNULL );.
7bc0: 20 20 74 65 73 74 63 61 73 65 28 20 70 54 65 72 testcase( pTer
7bd0: 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 57 m->eOperator & W
7be0: 4f 5f 49 53 20 29 3b 0a 20 20 20 20 74 65 73 74 O_IS );. test
7bf0: 63 61 73 65 28 20 70 54 65 72 6d 2d 3e 65 4f 70 case( pTerm->eOp
7c00: 65 72 61 74 6f 72 20 26 20 57 4f 5f 41 4c 4c 20 erator & WO_ALL
7c10: 29 3b 0a 20 20 20 20 69 66 28 20 28 70 54 65 72 );. if( (pTer
7c20: 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 7e m->eOperator & ~
7c30: 28 57 4f 5f 45 51 55 49 56 29 29 3d 3d 30 20 29 (WO_EQUIV))==0 )
7c40: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69 continue;. i
7c50: 66 28 20 70 54 65 72 6d 2d 3e 77 74 46 6c 61 67 f( pTerm->wtFlag
7c60: 73 20 26 20 54 45 52 4d 5f 56 4e 55 4c 4c 20 29 s & TERM_VNULL )
7c70: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 61 continue;. a
7c80: 73 73 65 72 74 28 20 70 54 65 72 6d 2d 3e 75 2e ssert( pTerm->u.
7c90: 6c 65 66 74 43 6f 6c 75 6d 6e 3e 3d 28 2d 31 29 leftColumn>=(-1)
7ca0: 20 29 3b 0a 20 20 20 20 6e 54 65 72 6d 2b 2b 3b );. nTerm++;
7cb0: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 . }.. /* If th
7cc0: 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 e ORDER BY claus
7cd0: 65 20 63 6f 6e 74 61 69 6e 73 20 6f 6e 6c 79 20 e contains only
7ce0: 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 63 columns in the c
7cf0: 75 72 72 65 6e 74 20 0a 20 20 2a 2a 20 76 69 72 urrent . ** vir
7d00: 74 75 61 6c 20 74 61 62 6c 65 20 74 68 65 6e 20 tual table then
7d10: 61 6c 6c 6f 63 61 74 65 20 73 70 61 63 65 20 66 allocate space f
7d20: 6f 72 20 74 68 65 20 61 4f 72 64 65 72 42 79 20 or the aOrderBy
7d30: 70 61 72 74 20 6f 66 0a 20 20 2a 2a 20 74 68 65 part of. ** the
7d40: 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 69 sqlite3_index_i
7d50: 6e 66 6f 20 73 74 72 75 63 74 75 72 65 2e 0a 20 nfo structure..
7d60: 20 2a 2f 0a 20 20 6e 4f 72 64 65 72 42 79 20 3d */. nOrderBy =
7d70: 20 30 3b 0a 20 20 69 66 28 20 70 4f 72 64 65 72 0;. if( pOrder
7d80: 42 79 20 29 7b 0a 20 20 20 20 69 6e 74 20 6e 20 By ){. int n
7d90: 3d 20 70 4f 72 64 65 72 42 79 2d 3e 6e 45 78 70 = pOrderBy->nExp
7da0: 72 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 r;. for(i=0;
7db0: 69 3c 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 i<n; i++){.
7dc0: 20 45 78 70 72 20 2a 70 45 78 70 72 20 3d 20 70 Expr *pExpr = p
7dd0: 4f 72 64 65 72 42 79 2d 3e 61 5b 69 5d 2e 70 45 OrderBy->a[i].pE
7de0: 78 70 72 3b 0a 20 20 20 20 20 20 69 66 28 20 70 xpr;. if( p
7df0: 45 78 70 72 2d 3e 6f 70 21 3d 54 4b 5f 43 4f 4c Expr->op!=TK_COL
7e00: 55 4d 4e 20 7c 7c 20 70 45 78 70 72 2d 3e 69 54 UMN || pExpr->iT
7e10: 61 62 6c 65 21 3d 70 53 72 63 2d 3e 69 43 75 72 able!=pSrc->iCur
7e20: 73 6f 72 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 sor ) break;.
7e30: 20 7d 0a 20 20 20 20 69 66 28 20 69 3d 3d 6e 29 }. if( i==n)
7e40: 7b 0a 20 20 20 20 20 20 6e 4f 72 64 65 72 42 79 {. nOrderBy
7e50: 20 3d 20 6e 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a = n;. }. }.
7e60: 0a 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 20 74 . /* Allocate t
7e70: 68 65 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 he sqlite3_index
7e80: 5f 69 6e 66 6f 20 73 74 72 75 63 74 75 72 65 0a _info structure.
7e90: 20 20 2a 2f 0a 20 20 70 49 64 78 49 6e 66 6f 20 */. pIdxInfo
7ea0: 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f = sqlite3DbMallo
7eb0: 63 5a 65 72 6f 28 70 50 61 72 73 65 2d 3e 64 62 cZero(pParse->db
7ec0: 2c 20 73 69 7a 65 6f 66 28 2a 70 49 64 78 49 6e , sizeof(*pIdxIn
7ed0: 66 6f 29 0a 20 20 20 20 20 20 20 20 20 20 20 20 fo).
7ee0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2b +
7ef0: 20 28 73 69 7a 65 6f 66 28 2a 70 49 64 78 43 6f (sizeof(*pIdxCo
7f00: 6e 73 29 20 2b 20 73 69 7a 65 6f 66 28 2a 70 55 ns) + sizeof(*pU
7f10: 73 61 67 65 29 29 2a 6e 54 65 72 6d 0a 20 20 20 sage))*nTerm.
7f20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
7f30: 20 20 20 20 20 20 20 20 2b 20 73 69 7a 65 6f 66 + sizeof
7f40: 28 2a 70 49 64 78 4f 72 64 65 72 42 79 29 2a 6e (*pIdxOrderBy)*n
7f50: 4f 72 64 65 72 42 79 20 2b 20 73 69 7a 65 6f 66 OrderBy + sizeof
7f60: 28 2a 70 48 69 64 64 65 6e 29 20 29 3b 0a 20 20 (*pHidden) );.
7f70: 69 66 28 20 70 49 64 78 49 6e 66 6f 3d 3d 30 20 if( pIdxInfo==0
7f80: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 ){. sqlite3Er
7f90: 72 6f 72 4d 73 67 28 70 50 61 72 73 65 2c 20 22 rorMsg(pParse, "
7fa0: 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 22 29 3b out of memory");
7fb0: 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 . return 0;.
7fc0: 20 7d 0a 0a 20 20 2f 2a 20 49 6e 69 74 69 61 6c }.. /* Initial
7fd0: 69 7a 65 20 74 68 65 20 73 74 72 75 63 74 75 72 ize the structur
7fe0: 65 2e 20 20 54 68 65 20 73 71 6c 69 74 65 33 5f e. The sqlite3_
7ff0: 69 6e 64 65 78 5f 69 6e 66 6f 20 73 74 72 75 63 index_info struc
8000: 74 75 72 65 20 63 6f 6e 74 61 69 6e 73 0a 20 20 ture contains.
8010: 2a 2a 20 6d 61 6e 79 20 66 69 65 6c 64 73 20 74 ** many fields t
8020: 68 61 74 20 61 72 65 20 64 65 63 6c 61 72 65 64 hat are declared
8030: 20 22 63 6f 6e 73 74 22 20 74 6f 20 70 72 65 76 "const" to prev
8040: 65 6e 74 20 78 42 65 73 74 49 6e 64 65 78 20 66 ent xBestIndex f
8050: 72 6f 6d 0a 20 20 2a 2a 20 63 68 61 6e 67 69 6e rom. ** changin
8060: 67 20 74 68 65 6d 2e 20 20 57 65 20 68 61 76 65 g them. We have
8070: 20 74 6f 20 64 6f 20 73 6f 6d 65 20 66 75 6e 6b to do some funk
8080: 79 20 63 61 73 74 69 6e 67 20 69 6e 20 6f 72 64 y casting in ord
8090: 65 72 20 74 6f 0a 20 20 2a 2a 20 69 6e 69 74 69 er to. ** initi
80a0: 61 6c 69 7a 65 20 74 68 6f 73 65 20 66 69 65 6c alize those fiel
80b0: 64 73 2e 0a 20 20 2a 2f 0a 20 20 70 48 69 64 64 ds.. */. pHidd
80c0: 65 6e 20 3d 20 28 73 74 72 75 63 74 20 48 69 64 en = (struct Hid
80d0: 64 65 6e 49 6e 64 65 78 49 6e 66 6f 2a 29 26 70 denIndexInfo*)&p
80e0: 49 64 78 49 6e 66 6f 5b 31 5d 3b 0a 20 20 70 49 IdxInfo[1];. pI
80f0: 64 78 43 6f 6e 73 20 3d 20 28 73 74 72 75 63 74 dxCons = (struct
8100: 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 63 sqlite3_index_c
8110: 6f 6e 73 74 72 61 69 6e 74 2a 29 26 70 48 69 64 onstraint*)&pHid
8120: 64 65 6e 5b 31 5d 3b 0a 20 20 70 49 64 78 4f 72 den[1];. pIdxOr
8130: 64 65 72 42 79 20 3d 20 28 73 74 72 75 63 74 20 derBy = (struct
8140: 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 6f 72 sqlite3_index_or
8150: 64 65 72 62 79 2a 29 26 70 49 64 78 43 6f 6e 73 derby*)&pIdxCons
8160: 5b 6e 54 65 72 6d 5d 3b 0a 20 20 70 55 73 61 67 [nTerm];. pUsag
8170: 65 20 3d 20 28 73 74 72 75 63 74 20 73 71 6c 69 e = (struct sqli
8180: 74 65 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 74 72 te3_index_constr
8190: 61 69 6e 74 5f 75 73 61 67 65 2a 29 26 70 49 64 aint_usage*)&pId
81a0: 78 4f 72 64 65 72 42 79 5b 6e 4f 72 64 65 72 42 xOrderBy[nOrderB
81b0: 79 5d 3b 0a 20 20 2a 28 69 6e 74 2a 29 26 70 49 y];. *(int*)&pI
81c0: 64 78 49 6e 66 6f 2d 3e 6e 43 6f 6e 73 74 72 61 dxInfo->nConstra
81d0: 69 6e 74 20 3d 20 6e 54 65 72 6d 3b 0a 20 20 2a int = nTerm;. *
81e0: 28 69 6e 74 2a 29 26 70 49 64 78 49 6e 66 6f 2d (int*)&pIdxInfo-
81f0: 3e 6e 4f 72 64 65 72 42 79 20 3d 20 6e 4f 72 64 >nOrderBy = nOrd
8200: 65 72 42 79 3b 0a 20 20 2a 28 73 74 72 75 63 74 erBy;. *(struct
8210: 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 63 sqlite3_index_c
8220: 6f 6e 73 74 72 61 69 6e 74 2a 2a 29 26 70 49 64 onstraint**)&pId
8230: 78 49 6e 66 6f 2d 3e 61 43 6f 6e 73 74 72 61 69 xInfo->aConstrai
8240: 6e 74 20 3d 20 70 49 64 78 43 6f 6e 73 3b 0a 20 nt = pIdxCons;.
8250: 20 2a 28 73 74 72 75 63 74 20 73 71 6c 69 74 65 *(struct sqlite
8260: 33 5f 69 6e 64 65 78 5f 6f 72 64 65 72 62 79 2a 3_index_orderby*
8270: 2a 29 26 70 49 64 78 49 6e 66 6f 2d 3e 61 4f 72 *)&pIdxInfo->aOr
8280: 64 65 72 42 79 20 3d 20 70 49 64 78 4f 72 64 65 derBy = pIdxOrde
8290: 72 42 79 3b 0a 20 20 2a 28 73 74 72 75 63 74 20 rBy;. *(struct
82a0: 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 63 6f sqlite3_index_co
82b0: 6e 73 74 72 61 69 6e 74 5f 75 73 61 67 65 2a 2a nstraint_usage**
82c0: 29 26 70 49 64 78 49 6e 66 6f 2d 3e 61 43 6f 6e )&pIdxInfo->aCon
82d0: 73 74 72 61 69 6e 74 55 73 61 67 65 20 3d 0a 20 straintUsage =.
82e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
82f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8300: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8310: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
8320: 20 20 70 55 73 61 67 65 3b 0a 0a 20 20 70 48 69 pUsage;.. pHi
8330: 64 64 65 6e 2d 3e 70 57 43 20 3d 20 70 57 43 3b dden->pWC = pWC;
8340: 0a 20 20 70 48 69 64 64 65 6e 2d 3e 70 50 61 72 . pHidden->pPar
8350: 73 65 20 3d 20 70 50 61 72 73 65 3b 0a 20 20 66 se = pParse;. f
8360: 6f 72 28 69 3d 6a 3d 30 2c 20 70 54 65 72 6d 3d or(i=j=0, pTerm=
8370: 70 57 43 2d 3e 61 3b 20 69 3c 70 57 43 2d 3e 6e pWC->a; i<pWC->n
8380: 54 65 72 6d 3b 20 69 2b 2b 2c 20 70 54 65 72 6d Term; i++, pTerm
8390: 2b 2b 29 7b 0a 20 20 20 20 75 31 36 20 6f 70 3b ++){. u16 op;
83a0: 0a 20 20 20 20 69 66 28 20 70 54 65 72 6d 2d 3e . if( pTerm->
83b0: 6c 65 66 74 43 75 72 73 6f 72 20 21 3d 20 70 53 leftCursor != pS
83c0: 72 63 2d 3e 69 43 75 72 73 6f 72 20 29 20 63 6f rc->iCursor ) co
83d0: 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69 66 28 20 ntinue;. if(
83e0: 70 54 65 72 6d 2d 3e 70 72 65 72 65 71 52 69 67 pTerm->prereqRig
83f0: 68 74 20 26 20 6d 55 6e 75 73 61 62 6c 65 20 29 ht & mUnusable )
8400: 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 61 continue;. a
8410: 73 73 65 72 74 28 20 49 73 50 6f 77 65 72 4f 66 ssert( IsPowerOf
8420: 54 77 6f 28 70 54 65 72 6d 2d 3e 65 4f 70 65 72 Two(pTerm->eOper
8430: 61 74 6f 72 20 26 20 7e 57 4f 5f 45 51 55 49 56 ator & ~WO_EQUIV
8440: 29 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 73 ) );. testcas
8450: 65 28 20 70 54 65 72 6d 2d 3e 65 4f 70 65 72 61 e( pTerm->eOpera
8460: 74 6f 72 20 26 20 57 4f 5f 49 4e 20 29 3b 0a 20 tor & WO_IN );.
8470: 20 20 20 74 65 73 74 63 61 73 65 28 20 70 54 65 testcase( pTe
8480: 72 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 rm->eOperator &
8490: 57 4f 5f 49 53 20 29 3b 0a 20 20 20 20 74 65 73 WO_IS );. tes
84a0: 74 63 61 73 65 28 20 70 54 65 72 6d 2d 3e 65 4f tcase( pTerm->eO
84b0: 70 65 72 61 74 6f 72 20 26 20 57 4f 5f 49 53 4e perator & WO_ISN
84c0: 55 4c 4c 20 29 3b 0a 20 20 20 20 74 65 73 74 63 ULL );. testc
84d0: 61 73 65 28 20 70 54 65 72 6d 2d 3e 65 4f 70 65 ase( pTerm->eOpe
84e0: 72 61 74 6f 72 20 26 20 57 4f 5f 41 4c 4c 20 29 rator & WO_ALL )
84f0: 3b 0a 20 20 20 20 69 66 28 20 28 70 54 65 72 6d ;. if( (pTerm
8500: 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 7e 28 ->eOperator & ~(
8510: 57 4f 5f 45 51 55 49 56 29 29 3d 3d 30 20 29 20 WO_EQUIV))==0 )
8520: 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69 66 continue;. if
8530: 28 20 70 54 65 72 6d 2d 3e 77 74 46 6c 61 67 73 ( pTerm->wtFlags
8540: 20 26 20 54 45 52 4d 5f 56 4e 55 4c 4c 20 29 20 & TERM_VNULL )
8550: 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 61 73 continue;. as
8560: 73 65 72 74 28 20 70 54 65 72 6d 2d 3e 75 2e 6c sert( pTerm->u.l
8570: 65 66 74 43 6f 6c 75 6d 6e 3e 3d 28 2d 31 29 20 eftColumn>=(-1)
8580: 29 3b 0a 20 20 20 20 70 49 64 78 43 6f 6e 73 5b );. pIdxCons[
8590: 6a 5d 2e 69 43 6f 6c 75 6d 6e 20 3d 20 70 54 65 j].iColumn = pTe
85a0: 72 6d 2d 3e 75 2e 6c 65 66 74 43 6f 6c 75 6d 6e rm->u.leftColumn
85b0: 3b 0a 20 20 20 20 70 49 64 78 43 6f 6e 73 5b 6a ;. pIdxCons[j
85c0: 5d 2e 69 54 65 72 6d 4f 66 66 73 65 74 20 3d 20 ].iTermOffset =
85d0: 69 3b 0a 20 20 20 20 6f 70 20 3d 20 70 54 65 72 i;. op = pTer
85e0: 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 57 m->eOperator & W
85f0: 4f 5f 41 4c 4c 3b 0a 20 20 20 20 69 66 28 20 6f O_ALL;. if( o
8600: 70 3d 3d 57 4f 5f 49 4e 20 29 20 6f 70 20 3d 20 p==WO_IN ) op =
8610: 57 4f 5f 45 51 3b 0a 20 20 20 20 69 66 28 20 6f WO_EQ;. if( o
8620: 70 3d 3d 57 4f 5f 41 55 58 20 29 7b 0a 20 20 20 p==WO_AUX ){.
8630: 20 20 20 70 49 64 78 43 6f 6e 73 5b 6a 5d 2e 6f pIdxCons[j].o
8640: 70 20 3d 20 70 54 65 72 6d 2d 3e 65 4d 61 74 63 p = pTerm->eMatc
8650: 68 4f 70 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 hOp;. }else i
8660: 66 28 20 6f 70 20 26 20 28 57 4f 5f 49 53 4e 55 f( op & (WO_ISNU
8670: 4c 4c 7c 57 4f 5f 49 53 29 20 29 7b 0a 20 20 20 LL|WO_IS) ){.
8680: 20 20 20 69 66 28 20 6f 70 3d 3d 57 4f 5f 49 53 if( op==WO_IS
8690: 4e 55 4c 4c 20 29 7b 0a 20 20 20 20 20 20 20 20 NULL ){.
86a0: 70 49 64 78 43 6f 6e 73 5b 6a 5d 2e 6f 70 20 3d pIdxCons[j].op =
86b0: 20 53 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f SQLITE_INDEX_CO
86c0: 4e 53 54 52 41 49 4e 54 5f 49 53 4e 55 4c 4c 3b NSTRAINT_ISNULL;
86d0: 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 . }else{.
86e0: 20 20 20 20 20 20 70 49 64 78 43 6f 6e 73 5b 6a pIdxCons[j
86f0: 5d 2e 6f 70 20 3d 20 53 51 4c 49 54 45 5f 49 4e ].op = SQLITE_IN
8700: 44 45 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 49 DEX_CONSTRAINT_I
8710: 53 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d S;. }. }
8720: 65 6c 73 65 7b 0a 20 20 20 20 20 20 70 49 64 78 else{. pIdx
8730: 43 6f 6e 73 5b 6a 5d 2e 6f 70 20 3d 20 28 75 38 Cons[j].op = (u8
8740: 29 6f 70 3b 0a 20 20 20 20 20 20 2f 2a 20 54 68 )op;. /* Th
8750: 65 20 64 69 72 65 63 74 20 61 73 73 69 67 6e 6d e direct assignm
8760: 65 6e 74 20 69 6e 20 74 68 65 20 70 72 65 76 69 ent in the previ
8770: 6f 75 73 20 6c 69 6e 65 20 69 73 20 70 6f 73 73 ous line is poss
8780: 69 62 6c 65 20 6f 6e 6c 79 20 62 65 63 61 75 73 ible only becaus
8790: 65 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 57 e. ** the W
87a0: 4f 5f 20 61 6e 64 20 53 51 4c 49 54 45 5f 49 4e O_ and SQLITE_IN
87b0: 44 45 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 20 DEX_CONSTRAINT_
87c0: 63 6f 64 65 73 20 61 72 65 20 69 64 65 6e 74 69 codes are identi
87d0: 63 61 6c 2e 20 20 54 68 65 0a 20 20 20 20 20 20 cal. The.
87e0: 2a 2a 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 73 73 ** following ass
87f0: 65 72 74 73 20 76 65 72 69 66 79 20 74 68 69 73 erts verify this
8800: 20 66 61 63 74 2e 20 2a 2f 0a 20 20 20 20 20 20 fact. */.
8810: 61 73 73 65 72 74 28 20 57 4f 5f 45 51 3d 3d 53 assert( WO_EQ==S
8820: 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 QLITE_INDEX_CONS
8830: 54 52 41 49 4e 54 5f 45 51 20 29 3b 0a 20 20 20 TRAINT_EQ );.
8840: 20 20 20 61 73 73 65 72 74 28 20 57 4f 5f 4c 54 assert( WO_LT
8850: 3d 3d 53 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 ==SQLITE_INDEX_C
8860: 4f 4e 53 54 52 41 49 4e 54 5f 4c 54 20 29 3b 0a ONSTRAINT_LT );.
8870: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 57 4f assert( WO
8880: 5f 4c 45 3d 3d 53 51 4c 49 54 45 5f 49 4e 44 45 _LE==SQLITE_INDE
8890: 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 4c 45 20 X_CONSTRAINT_LE
88a0: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
88b0: 20 57 4f 5f 47 54 3d 3d 53 51 4c 49 54 45 5f 49 WO_GT==SQLITE_I
88c0: 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f NDEX_CONSTRAINT_
88d0: 47 54 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 GT );. asse
88e0: 72 74 28 20 57 4f 5f 47 45 3d 3d 53 51 4c 49 54 rt( WO_GE==SQLIT
88f0: 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49 E_INDEX_CONSTRAI
8900: 4e 54 5f 47 45 20 29 3b 0a 20 20 20 20 20 20 61 NT_GE );. a
8910: 73 73 65 72 74 28 20 70 54 65 72 6d 2d 3e 65 4f ssert( pTerm->eO
8920: 70 65 72 61 74 6f 72 26 28 57 4f 5f 49 4e 7c 57 perator&(WO_IN|W
8930: 4f 5f 45 51 7c 57 4f 5f 4c 54 7c 57 4f 5f 4c 45 O_EQ|WO_LT|WO_LE
8940: 7c 57 4f 5f 47 54 7c 57 4f 5f 47 45 7c 57 4f 5f |WO_GT|WO_GE|WO_
8950: 41 55 58 29 20 29 3b 0a 0a 20 20 20 20 20 20 69 AUX) );.. i
8960: 66 28 20 6f 70 20 26 20 28 57 4f 5f 4c 54 7c 57 f( op & (WO_LT|W
8970: 4f 5f 4c 45 7c 57 4f 5f 47 54 7c 57 4f 5f 47 45 O_LE|WO_GT|WO_GE
8980: 29 0a 20 20 20 20 20 20 20 26 26 20 73 71 6c 69 ). && sqli
8990: 74 65 33 45 78 70 72 49 73 56 65 63 74 6f 72 28 te3ExprIsVector(
89a0: 70 54 65 72 6d 2d 3e 70 45 78 70 72 2d 3e 70 52 pTerm->pExpr->pR
89b0: 69 67 68 74 29 20 0a 20 20 20 20 20 20 29 7b 0a ight) . ){.
89c0: 20 20 20 20 20 20 20 20 69 66 28 20 69 3c 31 36 if( i<16
89d0: 20 29 20 6d 4e 6f 4f 6d 69 74 20 7c 3d 20 28 31 ) mNoOmit |= (1
89e0: 20 3c 3c 20 69 29 3b 0a 20 20 20 20 20 20 20 20 << i);.
89f0: 69 66 28 20 6f 70 3d 3d 57 4f 5f 4c 54 20 29 20 if( op==WO_LT )
8a00: 70 49 64 78 43 6f 6e 73 5b 6a 5d 2e 6f 70 20 3d pIdxCons[j].op =
8a10: 20 57 4f 5f 4c 45 3b 0a 20 20 20 20 20 20 20 20 WO_LE;.
8a20: 69 66 28 20 6f 70 3d 3d 57 4f 5f 47 54 20 29 20 if( op==WO_GT )
8a30: 70 49 64 78 43 6f 6e 73 5b 6a 5d 2e 6f 70 20 3d pIdxCons[j].op =
8a40: 20 57 4f 5f 47 45 3b 0a 20 20 20 20 20 20 7d 0a WO_GE;. }.
8a50: 20 20 20 20 7d 0a 0a 20 20 20 20 6a 2b 2b 3b 0a }.. j++;.
8a60: 20 20 7d 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 }. for(i=0; i
8a70: 3c 6e 4f 72 64 65 72 42 79 3b 20 69 2b 2b 29 7b <nOrderBy; i++){
8a80: 0a 20 20 20 20 45 78 70 72 20 2a 70 45 78 70 72 . Expr *pExpr
8a90: 20 3d 20 70 4f 72 64 65 72 42 79 2d 3e 61 5b 69 = pOrderBy->a[i
8aa0: 5d 2e 70 45 78 70 72 3b 0a 20 20 20 20 70 49 64 ].pExpr;. pId
8ab0: 78 4f 72 64 65 72 42 79 5b 69 5d 2e 69 43 6f 6c xOrderBy[i].iCol
8ac0: 75 6d 6e 20 3d 20 70 45 78 70 72 2d 3e 69 43 6f umn = pExpr->iCo
8ad0: 6c 75 6d 6e 3b 0a 20 20 20 20 70 49 64 78 4f 72 lumn;. pIdxOr
8ae0: 64 65 72 42 79 5b 69 5d 2e 64 65 73 63 20 3d 20 derBy[i].desc =
8af0: 70 4f 72 64 65 72 42 79 2d 3e 61 5b 69 5d 2e 73 pOrderBy->a[i].s
8b00: 6f 72 74 4f 72 64 65 72 3b 0a 20 20 7d 0a 0a 20 ortOrder;. }..
8b10: 20 2a 70 6d 4e 6f 4f 6d 69 74 20 3d 20 6d 4e 6f *pmNoOmit = mNo
8b20: 4f 6d 69 74 3b 0a 20 20 72 65 74 75 72 6e 20 70 Omit;. return p
8b30: 49 64 78 49 6e 66 6f 3b 0a 7d 0a 0a 2f 2a 0a 2a IdxInfo;.}../*.*
8b40: 2a 20 54 68 65 20 74 61 62 6c 65 20 6f 62 6a 65 * The table obje
8b50: 63 74 20 72 65 66 65 72 65 6e 63 65 20 70 61 73 ct reference pas
8b60: 73 65 64 20 61 73 20 74 68 65 20 73 65 63 6f 6e sed as the secon
8b70: 64 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 d argument to th
8b80: 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 6d is function.** m
8b90: 75 73 74 20 72 65 70 72 65 73 65 6e 74 20 61 20 ust represent a
8ba0: 76 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 20 54 virtual table. T
8bb0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 6e 76 his function inv
8bc0: 6f 6b 65 73 20 74 68 65 20 78 42 65 73 74 49 6e okes the xBestIn
8bd0: 64 65 78 28 29 0a 2a 2a 20 6d 65 74 68 6f 64 20 dex().** method
8be0: 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 74 of the virtual t
8bf0: 61 62 6c 65 20 77 69 74 68 20 74 68 65 20 73 71 able with the sq
8c00: 6c 69 74 65 33 5f 69 6e 64 65 78 5f 69 6e 66 6f lite3_index_info
8c10: 20 6f 62 6a 65 63 74 20 74 68 61 74 0a 2a 2a 20 object that.**
8c20: 63 6f 6d 65 73 20 69 6e 20 61 73 20 74 68 65 20 comes in as the
8c30: 33 72 64 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 3rd argument to
8c40: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 0a 2a this function..*
8c50: 2a 0a 2a 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 *.** If an error
8c60: 20 6f 63 63 75 72 73 2c 20 70 50 61 72 73 65 20 occurs, pParse
8c70: 69 73 20 70 6f 70 75 6c 61 74 65 64 20 77 69 74 is populated wit
8c80: 68 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 h an error messa
8c90: 67 65 20 61 6e 64 20 61 0a 2a 2a 20 6e 6f 6e 2d ge and a.** non-
8ca0: 7a 65 72 6f 20 76 61 6c 75 65 20 69 73 20 72 65 zero value is re
8cb0: 74 75 72 6e 65 64 2e 20 4f 74 68 65 72 77 69 73 turned. Otherwis
8cc0: 65 2c 20 30 20 69 73 20 72 65 74 75 72 6e 65 64 e, 0 is returned
8cd0: 20 61 6e 64 20 74 68 65 20 6f 75 74 70 75 74 0a and the output.
8ce0: 2a 2a 20 70 61 72 74 20 6f 66 20 74 68 65 20 73 ** part of the s
8cf0: 71 6c 69 74 65 33 5f 69 6e 64 65 78 5f 69 6e 66 qlite3_index_inf
8d00: 6f 20 73 74 72 75 63 74 75 72 65 20 69 73 20 6c o structure is l
8d10: 65 66 74 20 70 6f 70 75 6c 61 74 65 64 2e 0a 2a eft populated..*
8d20: 2a 0a 2a 2a 20 57 68 65 74 68 65 72 20 6f 72 20 *.** Whether or
8d30: 6e 6f 74 20 61 6e 20 65 72 72 6f 72 20 69 73 20 not an error is
8d40: 72 65 74 75 72 6e 65 64 2c 20 69 74 20 69 73 20 returned, it is
8d50: 74 68 65 20 72 65 73 70 6f 6e 73 69 62 69 6c 69 the responsibili
8d60: 74 79 20 6f 66 20 74 68 65 0a 2a 2a 20 63 61 6c ty of the.** cal
8d70: 6c 65 72 20 74 6f 20 65 76 65 6e 74 75 61 6c 6c ler to eventuall
8d80: 79 20 66 72 65 65 20 70 2d 3e 69 64 78 53 74 72 y free p->idxStr
8d90: 20 69 66 20 70 2d 3e 6e 65 65 64 54 6f 46 72 65 if p->needToFre
8da0: 65 49 64 78 53 74 72 20 69 6e 64 69 63 61 74 65 eIdxStr indicate
8db0: 73 0a 2a 2a 20 74 68 61 74 20 74 68 69 73 20 69 s.** that this i
8dc0: 73 20 72 65 71 75 69 72 65 64 2e 0a 2a 2f 0a 73 s required..*/.s
8dd0: 74 61 74 69 63 20 69 6e 74 20 76 74 61 62 42 65 tatic int vtabBe
8de0: 73 74 49 6e 64 65 78 28 50 61 72 73 65 20 2a 70 stIndex(Parse *p
8df0: 50 61 72 73 65 2c 20 54 61 62 6c 65 20 2a 70 54 Parse, Table *pT
8e00: 61 62 2c 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 ab, sqlite3_inde
8e10: 78 5f 69 6e 66 6f 20 2a 70 29 7b 0a 20 20 73 71 x_info *p){. sq
8e20: 6c 69 74 65 33 5f 76 74 61 62 20 2a 70 56 74 61 lite3_vtab *pVta
8e30: 62 20 3d 20 73 71 6c 69 74 65 33 47 65 74 56 54 b = sqlite3GetVT
8e40: 61 62 6c 65 28 70 50 61 72 73 65 2d 3e 64 62 2c able(pParse->db,
8e50: 20 70 54 61 62 29 2d 3e 70 56 74 61 62 3b 0a 20 pTab)->pVtab;.
8e60: 20 69 6e 74 20 72 63 3b 0a 0a 20 20 54 52 41 43 int rc;.. TRAC
8e70: 45 5f 49 44 58 5f 49 4e 50 55 54 53 28 70 29 3b E_IDX_INPUTS(p);
8e80: 0a 20 20 72 63 20 3d 20 70 56 74 61 62 2d 3e 70 . rc = pVtab->p
8e90: 4d 6f 64 75 6c 65 2d 3e 78 42 65 73 74 49 6e 64 Module->xBestInd
8ea0: 65 78 28 70 56 74 61 62 2c 20 70 29 3b 0a 20 20 ex(pVtab, p);.
8eb0: 54 52 41 43 45 5f 49 44 58 5f 4f 55 54 50 55 54 TRACE_IDX_OUTPUT
8ec0: 53 28 70 29 3b 0a 0a 20 20 69 66 28 20 72 63 21 S(p);.. if( rc!
8ed0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
8ee0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
8ef0: 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 _NOMEM ){.
8f00: 73 71 6c 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28 sqlite3OomFault(
8f10: 70 50 61 72 73 65 2d 3e 64 62 29 3b 0a 20 20 20 pParse->db);.
8f20: 20 7d 65 6c 73 65 20 69 66 28 20 21 70 56 74 61 }else if( !pVta
8f30: 62 2d 3e 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 b->zErrMsg ){.
8f40: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 sqlite3Error
8f50: 4d 73 67 28 70 50 61 72 73 65 2c 20 22 25 73 22 Msg(pParse, "%s"
8f60: 2c 20 73 71 6c 69 74 65 33 45 72 72 53 74 72 28 , sqlite3ErrStr(
8f70: 72 63 29 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b rc));. }else{
8f80: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 . sqlite3Er
8f90: 72 6f 72 4d 73 67 28 70 50 61 72 73 65 2c 20 22 rorMsg(pParse, "
8fa0: 25 73 22 2c 20 70 56 74 61 62 2d 3e 7a 45 72 72 %s", pVtab->zErr
8fb0: 4d 73 67 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a Msg);. }. }.
8fc0: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
8fd0: 56 74 61 62 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a Vtab->zErrMsg);.
8fe0: 20 20 70 56 74 61 62 2d 3e 7a 45 72 72 4d 73 67 pVtab->zErrMsg
8ff0: 20 3d 20 30 3b 0a 0a 23 69 66 20 30 0a 20 20 2f = 0;..#if 0. /
9000: 2a 20 54 68 69 73 20 65 72 72 6f 72 20 69 73 20 * This error is
9010: 6e 6f 77 20 63 61 75 67 68 74 20 62 79 20 74 68 now caught by th
9020: 65 20 63 61 6c 6c 65 72 2e 0a 20 20 2a 2a 20 53 e caller.. ** S
9030: 65 61 72 63 68 20 66 6f 72 20 22 78 42 65 73 74 earch for "xBest
9040: 49 6e 64 65 78 20 6d 61 6c 66 75 6e 63 74 69 6f Index malfunctio
9050: 6e 22 20 62 65 6c 6f 77 20 2a 2f 0a 20 20 66 6f n" below */. fo
9060: 72 28 69 3d 30 3b 20 69 3c 70 2d 3e 6e 43 6f 6e r(i=0; i<p->nCon
9070: 73 74 72 61 69 6e 74 3b 20 69 2b 2b 29 7b 0a 20 straint; i++){.
9080: 20 20 20 69 66 28 20 21 70 2d 3e 61 43 6f 6e 73 if( !p->aCons
9090: 74 72 61 69 6e 74 5b 69 5d 2e 75 73 61 62 6c 65 traint[i].usable
90a0: 20 26 26 20 70 2d 3e 61 43 6f 6e 73 74 72 61 69 && p->aConstrai
90b0: 6e 74 55 73 61 67 65 5b 69 5d 2e 61 72 67 76 49 ntUsage[i].argvI
90c0: 6e 64 65 78 3e 30 20 29 7b 0a 20 20 20 20 20 20 ndex>0 ){.
90d0: 73 71 6c 69 74 65 33 45 72 72 6f 72 4d 73 67 28 sqlite3ErrorMsg(
90e0: 70 50 61 72 73 65 2c 20 0a 20 20 20 20 20 20 20 pParse, .
90f0: 20 20 20 22 74 61 62 6c 65 20 25 73 3a 20 78 42 "table %s: xB
9100: 65 73 74 49 6e 64 65 78 20 72 65 74 75 72 6e 65 estIndex returne
9110: 64 20 61 6e 20 69 6e 76 61 6c 69 64 20 70 6c 61 d an invalid pla
9120: 6e 22 2c 20 70 54 61 62 2d 3e 7a 4e 61 6d 65 29 n", pTab->zName)
9130: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 ;. }. }.#end
9140: 69 66 0a 0a 20 20 72 65 74 75 72 6e 20 70 50 61 if.. return pPa
9150: 72 73 65 2d 3e 6e 45 72 72 3b 0a 7d 0a 23 65 6e rse->nErr;.}.#en
9160: 64 69 66 20 2f 2a 20 21 64 65 66 69 6e 65 64 28 dif /* !defined(
9170: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 SQLITE_OMIT_VIRT
9180: 55 41 4c 54 41 42 4c 45 29 20 2a 2f 0a 0a 23 69 UALTABLE) */..#i
9190: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
91a0: 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 LE_STAT3_OR_STAT
91b0: 34 0a 2f 2a 0a 2a 2a 20 45 73 74 69 6d 61 74 65 4./*.** Estimate
91c0: 20 74 68 65 20 6c 6f 63 61 74 69 6f 6e 20 6f 66 the location of
91d0: 20 61 20 70 61 72 74 69 63 75 6c 61 72 20 6b 65 a particular ke
91e0: 79 20 61 6d 6f 6e 67 20 61 6c 6c 20 6b 65 79 73 y among all keys
91f0: 20 69 6e 20 61 6e 0a 2a 2a 20 69 6e 64 65 78 2e in an.** index.
9200: 20 20 53 74 6f 72 65 20 74 68 65 20 72 65 73 75 Store the resu
9210: 6c 74 73 20 69 6e 20 61 53 74 61 74 20 61 73 20 lts in aStat as
9220: 66 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 follows:.**.**
9230: 20 20 61 53 74 61 74 5b 30 5d 20 20 20 20 20 20 aStat[0]
9240: 45 73 74 2e 20 6e 75 6d 62 65 72 20 6f 66 20 72 Est. number of r
9250: 6f 77 73 20 6c 65 73 73 20 74 68 61 6e 20 70 52 ows less than pR
9260: 65 63 0a 2a 2a 20 20 20 20 61 53 74 61 74 5b 31 ec.** aStat[1
9270: 5d 20 20 20 20 20 20 45 73 74 2e 20 6e 75 6d 62 ] Est. numb
9280: 65 72 20 6f 66 20 72 6f 77 73 20 65 71 75 61 6c er of rows equal
9290: 20 74 6f 20 70 52 65 63 0a 2a 2a 0a 2a 2a 20 52 to pRec.**.** R
92a0: 65 74 75 72 6e 20 74 68 65 20 69 6e 64 65 78 20 eturn the index
92b0: 6f 66 20 74 68 65 20 73 61 6d 70 6c 65 20 74 68 of the sample th
92c0: 61 74 20 69 73 20 74 68 65 20 73 6d 61 6c 6c 65 at is the smalle
92d0: 73 74 20 73 61 6d 70 6c 65 20 74 68 61 74 0a 2a st sample that.*
92e0: 2a 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 * is greater tha
92f0: 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 70 52 n or equal to pR
9300: 65 63 2e 20 4e 6f 74 65 20 74 68 61 74 20 74 68 ec. Note that th
9310: 69 73 20 69 6e 64 65 78 20 69 73 20 6e 6f 74 20 is index is not
9320: 61 6e 20 69 6e 64 65 78 0a 2a 2a 20 69 6e 74 6f an index.** into
9330: 20 74 68 65 20 61 53 61 6d 70 6c 65 5b 5d 20 61 the aSample[] a
9340: 72 72 61 79 20 2d 20 69 74 20 69 73 20 61 6e 20 rray - it is an
9350: 69 6e 64 65 78 20 69 6e 74 6f 20 61 20 76 69 72 index into a vir
9360: 74 75 61 6c 20 73 65 74 20 6f 66 20 73 61 6d 70 tual set of samp
9370: 6c 65 73 0a 2a 2a 20 62 61 73 65 64 20 6f 6e 20 les.** based on
9380: 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 6f 66 20 the contents of
9390: 61 53 61 6d 70 6c 65 5b 5d 20 61 6e 64 20 74 68 aSample[] and th
93a0: 65 20 6e 75 6d 62 65 72 20 6f 66 20 66 69 65 6c e number of fiel
93b0: 64 73 20 69 6e 20 72 65 63 6f 72 64 20 0a 2a 2a ds in record .**
93c0: 20 70 52 65 63 2e 20 0a 2a 2f 0a 73 74 61 74 69 pRec. .*/.stati
93d0: 63 20 69 6e 74 20 77 68 65 72 65 4b 65 79 53 74 c int whereKeySt
93e0: 61 74 73 28 0a 20 20 50 61 72 73 65 20 2a 70 50 ats(. Parse *pP
93f0: 61 72 73 65 2c 20 20 20 20 20 20 20 20 20 20 20 arse,
9400: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 63 /* Database c
9410: 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 49 onnection */. I
9420: 6e 64 65 78 20 2a 70 49 64 78 2c 20 20 20 20 20 ndex *pIdx,
9430: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e /* In
9440: 64 65 78 20 74 6f 20 63 6f 6e 73 69 64 65 72 20 dex to consider
9450: 64 6f 6d 61 69 6e 20 6f 66 20 2a 2f 0a 20 20 55 domain of */. U
9460: 6e 70 61 63 6b 65 64 52 65 63 6f 72 64 20 2a 70 npackedRecord *p
9470: 52 65 63 2c 20 20 20 20 20 20 20 2f 2a 20 56 65 Rec, /* Ve
9480: 63 74 6f 72 20 6f 66 20 76 61 6c 75 65 73 20 74 ctor of values t
9490: 6f 20 63 6f 6e 73 69 64 65 72 20 2a 2f 0a 20 20 o consider */.
94a0: 69 6e 74 20 72 6f 75 6e 64 55 70 2c 20 20 20 20 int roundUp,
94b0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 /* R
94c0: 6f 75 6e 64 20 75 70 20 69 66 20 74 72 75 65 2e ound up if true.
94d0: 20 20 52 6f 75 6e 64 20 64 6f 77 6e 20 69 66 20 Round down if
94e0: 66 61 6c 73 65 20 2a 2f 0a 20 20 74 52 6f 77 63 false */. tRowc
94f0: 6e 74 20 2a 61 53 74 61 74 20 20 20 20 20 20 20 nt *aStat
9500: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 73 /* OUT: s
9510: 74 61 74 73 20 77 72 69 74 74 65 6e 20 68 65 72 tats written her
9520: 65 20 2a 2f 0a 29 7b 0a 20 20 49 6e 64 65 78 53 e */.){. IndexS
9530: 61 6d 70 6c 65 20 2a 61 53 61 6d 70 6c 65 20 3d ample *aSample =
9540: 20 70 49 64 78 2d 3e 61 53 61 6d 70 6c 65 3b 0a pIdx->aSample;.
9550: 20 20 69 6e 74 20 69 43 6f 6c 3b 20 20 20 20 20 int iCol;
9560: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
9570: 20 49 6e 64 65 78 20 6f 66 20 72 65 71 75 69 72 Index of requir
9580: 65 64 20 73 74 61 74 73 20 69 6e 20 61 6e 45 71 ed stats in anEq
9590: 5b 5d 20 65 74 63 2e 20 2a 2f 0a 20 20 69 6e 74 [] etc. */. int
95a0: 20 69 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 i;
95b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 /* Inde
95c0: 78 20 6f 66 20 66 69 72 73 74 20 73 61 6d 70 6c x of first sampl
95d0: 65 20 3e 3d 20 70 52 65 63 20 2a 2f 0a 20 20 69 e >= pRec */. i
95e0: 6e 74 20 69 53 61 6d 70 6c 65 3b 20 20 20 20 20 nt iSample;
95f0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 6d /* Sm
9600: 61 6c 6c 65 73 74 20 73 61 6d 70 6c 65 20 6c 61 allest sample la
9610: 72 67 65 72 20 74 68 61 6e 20 6f 72 20 65 71 75 rger than or equ
9620: 61 6c 20 74 6f 20 70 52 65 63 20 2a 2f 0a 20 20 al to pRec */.
9630: 69 6e 74 20 69 4d 69 6e 20 3d 20 30 3b 20 20 20 int iMin = 0;
9640: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 /* S
9650: 6d 61 6c 6c 65 73 74 20 73 61 6d 70 6c 65 20 6e mallest sample n
9660: 6f 74 20 79 65 74 20 74 65 73 74 65 64 20 2a 2f ot yet tested */
9670: 0a 20 20 69 6e 74 20 69 54 65 73 74 3b 20 20 20 . int iTest;
9680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
9690: 2a 20 4e 65 78 74 20 73 61 6d 70 6c 65 20 74 6f * Next sample to
96a0: 20 74 65 73 74 20 2a 2f 0a 20 20 69 6e 74 20 72 test */. int r
96b0: 65 73 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 es;
96c0: 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74 /* Result
96d0: 20 6f 66 20 63 6f 6d 70 61 72 69 73 6f 6e 20 6f of comparison o
96e0: 70 65 72 61 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e peration */. in
96f0: 74 20 6e 46 69 65 6c 64 3b 20 20 20 20 20 20 20 t nField;
9700: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
9710: 62 65 72 20 6f 66 20 66 69 65 6c 64 73 20 69 6e ber of fields in
9720: 20 70 52 65 63 20 2a 2f 0a 20 20 74 52 6f 77 63 pRec */. tRowc
9730: 6e 74 20 69 4c 6f 77 65 72 20 3d 20 30 3b 20 20 nt iLower = 0;
9740: 20 20 20 20 20 20 20 2f 2a 20 61 6e 4c 74 5b 5d /* anLt[]
9750: 20 2b 20 61 6e 45 71 5b 5d 20 6f 66 20 6c 61 72 + anEq[] of lar
9760: 67 65 73 74 20 73 61 6d 70 6c 65 20 70 52 65 63 gest sample pRec
9770: 20 69 73 20 3e 20 2a 2f 0a 0a 23 69 66 6e 64 65 is > */..#ifnde
9780: 66 20 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 f SQLITE_DEBUG.
9790: 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 UNUSED_PARAMETE
97a0: 52 28 20 70 50 61 72 73 65 20 29 3b 0a 23 65 6e R( pParse );.#en
97b0: 64 69 66 0a 20 20 61 73 73 65 72 74 28 20 70 52 dif. assert( pR
97c0: 65 63 21 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 ec!=0 );. asser
97d0: 74 28 20 70 49 64 78 2d 3e 6e 53 61 6d 70 6c 65 t( pIdx->nSample
97e0: 3e 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 >0 );. assert(
97f0: 70 52 65 63 2d 3e 6e 46 69 65 6c 64 3e 30 20 26 pRec->nField>0 &
9800: 26 20 70 52 65 63 2d 3e 6e 46 69 65 6c 64 3c 3d & pRec->nField<=
9810: 70 49 64 78 2d 3e 6e 53 61 6d 70 6c 65 43 6f 6c pIdx->nSampleCol
9820: 20 29 3b 0a 0a 20 20 2f 2a 20 44 6f 20 61 20 62 );.. /* Do a b
9830: 69 6e 61 72 79 20 73 65 61 72 63 68 20 74 6f 20 inary search to
9840: 66 69 6e 64 20 74 68 65 20 66 69 72 73 74 20 73 find the first s
9850: 61 6d 70 6c 65 20 67 72 65 61 74 65 72 20 74 68 ample greater th
9860: 61 6e 20 6f 72 20 65 71 75 61 6c 0a 20 20 2a 2a an or equal. **
9870: 20 74 6f 20 70 52 65 63 2e 20 49 66 20 70 52 65 to pRec. If pRe
9880: 63 20 63 6f 6e 74 61 69 6e 73 20 61 20 73 69 6e c contains a sin
9890: 67 6c 65 20 66 69 65 6c 64 2c 20 74 68 65 20 73 gle field, the s
98a0: 65 74 20 6f 66 20 73 61 6d 70 6c 65 73 20 74 6f et of samples to
98b0: 20 73 65 61 72 63 68 0a 20 20 2a 2a 20 69 73 20 search. ** is
98c0: 73 69 6d 70 6c 79 20 74 68 65 20 61 53 61 6d 70 simply the aSamp
98d0: 6c 65 5b 5d 20 61 72 72 61 79 2e 20 49 66 20 74 le[] array. If t
98e0: 68 65 20 73 61 6d 70 6c 65 73 20 69 6e 20 61 53 he samples in aS
98f0: 61 6d 70 6c 65 5b 5d 20 63 6f 6e 74 61 69 6e 20 ample[] contain
9900: 6d 6f 72 65 0a 20 20 2a 2a 20 74 68 61 6e 20 6f more. ** than o
9910: 6e 65 20 66 69 65 6c 64 73 2c 20 61 6c 6c 20 66 ne fields, all f
9920: 69 65 6c 64 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 ields following
9930: 74 68 65 20 66 69 72 73 74 20 61 72 65 20 69 67 the first are ig
9940: 6e 6f 72 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a 2a nored.. **. **
9950: 20 49 66 20 70 52 65 63 20 63 6f 6e 74 61 69 6e If pRec contain
9960: 73 20 4e 20 66 69 65 6c 64 73 2c 20 77 68 65 72 s N fields, wher
9970: 65 20 4e 20 69 73 20 6d 6f 72 65 20 74 68 61 6e e N is more than
9980: 20 6f 6e 65 2c 20 74 68 65 6e 20 61 73 20 77 65 one, then as we
9990: 6c 6c 20 61 73 20 74 68 65 0a 20 20 2a 2a 20 73 ll as the. ** s
99a0: 61 6d 70 6c 65 73 20 69 6e 20 61 53 61 6d 70 6c amples in aSampl
99b0: 65 5b 5d 20 28 74 72 75 6e 63 61 74 65 64 20 74 e[] (truncated t
99c0: 6f 20 4e 20 66 69 65 6c 64 73 29 2c 20 74 68 65 o N fields), the
99d0: 20 73 65 61 72 63 68 20 61 6c 73 6f 20 68 61 73 search also has
99e0: 20 74 6f 0a 20 20 2a 2a 20 63 6f 6e 73 69 64 65 to. ** conside
99f0: 72 20 70 72 65 66 69 78 65 73 20 6f 66 20 74 68 r prefixes of th
9a00: 6f 73 65 20 73 61 6d 70 6c 65 73 2e 20 46 6f 72 ose samples. For
9a10: 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 74 68 65 example, if the
9a20: 20 73 65 74 20 6f 66 20 73 61 6d 70 6c 65 73 0a set of samples.
9a30: 20 20 2a 2a 20 69 6e 20 61 53 61 6d 70 6c 65 20 ** in aSample
9a40: 69 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 is:. **. **
9a50: 20 20 61 53 61 6d 70 6c 65 5b 30 5d 20 3d 20 28 aSample[0] = (
9a60: 61 2c 20 35 29 20 0a 20 20 2a 2a 20 20 20 20 20 a, 5) . **
9a70: 61 53 61 6d 70 6c 65 5b 31 5d 20 3d 20 28 61 2c aSample[1] = (a,
9a80: 20 31 30 29 20 0a 20 20 2a 2a 20 20 20 20 20 61 10) . ** a
9a90: 53 61 6d 70 6c 65 5b 32 5d 20 3d 20 28 62 2c 20 Sample[2] = (b,
9aa0: 35 29 20 0a 20 20 2a 2a 20 20 20 20 20 61 53 61 5) . ** aSa
9ab0: 6d 70 6c 65 5b 33 5d 20 3d 20 28 63 2c 20 31 30 mple[3] = (c, 10
9ac0: 30 29 20 0a 20 20 2a 2a 20 20 20 20 20 61 53 61 0) . ** aSa
9ad0: 6d 70 6c 65 5b 34 5d 20 3d 20 28 63 2c 20 31 30 mple[4] = (c, 10
9ae0: 35 29 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 5). **. ** The
9af0: 6e 20 74 68 65 20 73 65 61 72 63 68 20 73 70 61 n the search spa
9b00: 63 65 20 73 68 6f 75 6c 64 20 69 64 65 61 6c 6c ce should ideall
9b10: 79 20 62 65 20 74 68 65 20 73 61 6d 70 6c 65 73 y be the samples
9b20: 20 61 62 6f 76 65 20 61 6e 64 20 74 68 65 20 0a above and the .
9b30: 20 20 2a 2a 20 75 6e 69 71 75 65 20 70 72 65 66 ** unique pref
9b40: 69 78 65 73 20 5b 61 5d 2c 20 5b 62 5d 20 61 6e ixes [a], [b] an
9b50: 64 20 5b 63 5d 2e 20 42 75 74 20 73 69 6e 63 65 d [c]. But since
9b60: 20 74 68 61 74 20 69 73 20 68 61 72 64 20 74 6f that is hard to
9b70: 20 6f 72 67 61 6e 69 7a 65 2c 20 0a 20 20 2a 2a organize, . **
9b80: 20 74 68 65 20 63 6f 64 65 20 61 63 74 75 61 6c the code actual
9b90: 6c 79 20 73 65 61 72 63 68 65 73 20 74 68 69 73 ly searches this
9ba0: 20 73 65 74 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 set:. **. **
9bb0: 20 20 20 20 30 3a 20 28 61 29 20 0a 20 20 2a 2a 0: (a) . **
9bc0: 20 20 20 20 20 31 3a 20 28 61 2c 20 35 29 20 0a 1: (a, 5) .
9bd0: 20 20 2a 2a 20 20 20 20 20 32 3a 20 28 61 2c 20 ** 2: (a,
9be0: 31 30 29 20 0a 20 20 2a 2a 20 20 20 20 20 33 3a 10) . ** 3:
9bf0: 20 28 61 2c 20 31 30 29 20 0a 20 20 2a 2a 20 20 (a, 10) . **
9c00: 20 20 20 34 3a 20 28 62 29 20 0a 20 20 2a 2a 20 4: (b) . **
9c10: 20 20 20 20 35 3a 20 28 62 2c 20 35 29 20 0a 20 5: (b, 5) .
9c20: 20 2a 2a 20 20 20 20 20 36 3a 20 28 63 29 20 0a ** 6: (c) .
9c30: 20 20 2a 2a 20 20 20 20 20 37 3a 20 28 63 2c 20 ** 7: (c,
9c40: 31 30 30 29 20 0a 20 20 2a 2a 20 20 20 20 20 38 100) . ** 8
9c50: 3a 20 28 63 2c 20 31 30 35 29 0a 20 20 2a 2a 20 : (c, 105). **
9c60: 20 20 20 20 39 3a 20 28 63 2c 20 31 30 35 29 0a 9: (c, 105).
9c70: 20 20 2a 2a 0a 20 20 2a 2a 20 46 6f 72 20 65 61 **. ** For ea
9c80: 63 68 20 73 61 6d 70 6c 65 20 69 6e 20 74 68 65 ch sample in the
9c90: 20 61 53 61 6d 70 6c 65 5b 5d 20 61 72 72 61 79 aSample[] array
9ca0: 2c 20 4e 20 73 61 6d 70 6c 65 73 20 61 72 65 20 , N samples are
9cb0: 70 72 65 73 65 6e 74 20 69 6e 20 74 68 65 0a 20 present in the.
9cc0: 20 2a 2a 20 65 66 66 65 63 74 69 76 65 20 73 61 ** effective sa
9cd0: 6d 70 6c 65 20 61 72 72 61 79 2e 20 49 6e 20 74 mple array. In t
9ce0: 68 65 20 61 62 6f 76 65 2c 20 73 61 6d 70 6c 65 he above, sample
9cf0: 73 20 30 20 61 6e 64 20 31 20 61 72 65 20 62 61 s 0 and 1 are ba
9d00: 73 65 64 20 6f 6e 20 0a 20 20 2a 2a 20 73 61 6d sed on . ** sam
9d10: 70 6c 65 20 61 53 61 6d 70 6c 65 5b 30 5d 2e 20 ple aSample[0].
9d20: 53 61 6d 70 6c 65 73 20 32 20 61 6e 64 20 33 20 Samples 2 and 3
9d30: 6f 6e 20 61 53 61 6d 70 6c 65 5b 31 5d 20 65 74 on aSample[1] et
9d40: 63 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4f 66 74 c.. **. ** Oft
9d50: 65 6e 2c 20 73 61 6d 70 6c 65 20 69 20 6f 66 20 en, sample i of
9d60: 65 61 63 68 20 62 6c 6f 63 6b 20 6f 66 20 4e 20 each block of N
9d70: 65 66 66 65 63 74 69 76 65 20 73 61 6d 70 6c 65 effective sample
9d80: 73 20 68 61 73 20 28 69 2b 31 29 20 66 69 65 6c s has (i+1) fiel
9d90: 64 73 2e 0a 20 20 2a 2a 20 45 78 63 65 70 74 2c ds.. ** Except,
9da0: 20 65 61 63 68 20 73 61 6d 70 6c 65 20 6d 61 79 each sample may
9db0: 20 62 65 20 65 78 74 65 6e 64 65 64 20 74 6f 20 be extended to
9dc0: 65 6e 73 75 72 65 20 74 68 61 74 20 69 74 20 69 ensure that it i
9dd0: 73 20 67 72 65 61 74 65 72 20 74 68 61 6e 20 6f s greater than o
9de0: 72 0a 20 20 2a 2a 20 65 71 75 61 6c 20 74 6f 20 r. ** equal to
9df0: 74 68 65 20 70 72 65 76 69 6f 75 73 20 73 61 6d the previous sam
9e00: 70 6c 65 20 69 6e 20 74 68 65 20 61 72 72 61 79 ple in the array
9e10: 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 69 . For example, i
9e20: 6e 20 74 68 65 20 61 62 6f 76 65 2c 20 0a 20 20 n the above, .
9e30: 2a 2a 20 73 61 6d 70 6c 65 20 32 20 69 73 20 74 ** sample 2 is t
9e40: 68 65 20 66 69 72 73 74 20 73 61 6d 70 6c 65 20 he first sample
9e50: 6f 66 20 61 20 62 6c 6f 63 6b 20 6f 66 20 4e 20 of a block of N
9e60: 73 61 6d 70 6c 65 73 2c 20 73 6f 20 61 74 20 66 samples, so at f
9e70: 69 72 73 74 20 69 74 20 0a 20 20 2a 2a 20 61 70 irst it . ** ap
9e80: 70 65 61 72 73 20 74 68 61 74 20 69 74 20 73 68 pears that it sh
9e90: 6f 75 6c 64 20 62 65 20 31 20 66 69 65 6c 64 20 ould be 1 field
9ea0: 69 6e 20 73 69 7a 65 2e 20 48 6f 77 65 76 65 72 in size. However
9eb0: 2c 20 74 68 61 74 20 77 6f 75 6c 64 20 6d 61 6b , that would mak
9ec0: 65 20 69 74 20 0a 20 20 2a 2a 20 73 6d 61 6c 6c e it . ** small
9ed0: 65 72 20 74 68 61 6e 20 73 61 6d 70 6c 65 20 31 er than sample 1
9ee0: 2c 20 73 6f 20 74 68 65 20 62 69 6e 61 72 79 20 , so the binary
9ef0: 73 65 61 72 63 68 20 77 6f 75 6c 64 20 6e 6f 74 search would not
9f00: 20 77 6f 72 6b 2e 20 41 73 20 61 20 72 65 73 75 work. As a resu
9f10: 6c 74 2c 20 0a 20 20 2a 2a 20 69 74 20 69 73 20 lt, . ** it is
9f20: 65 78 74 65 6e 64 65 64 20 74 6f 20 74 77 6f 20 extended to two
9f30: 66 69 65 6c 64 73 2e 20 54 68 65 20 64 75 70 6c fields. The dupl
9f40: 69 63 61 74 65 73 20 74 68 61 74 20 74 68 69 73 icates that this
9f50: 20 63 72 65 61 74 65 73 20 64 6f 20 6e 6f 74 20 creates do not
9f60: 0a 20 20 2a 2a 20 63 61 75 73 65 20 61 6e 79 20 . ** cause any
9f70: 70 72 6f 62 6c 65 6d 73 2e 0a 20 20 2a 2f 0a 20 problems.. */.
9f80: 20 6e 46 69 65 6c 64 20 3d 20 70 52 65 63 2d 3e nField = pRec->
9f90: 6e 46 69 65 6c 64 3b 0a 20 20 69 43 6f 6c 20 3d nField;. iCol =
9fa0: 20 30 3b 0a 20 20 69 53 61 6d 70 6c 65 20 3d 20 0;. iSample =
9fb0: 70 49 64 78 2d 3e 6e 53 61 6d 70 6c 65 20 2a 20 pIdx->nSample *
9fc0: 6e 46 69 65 6c 64 3b 0a 20 20 64 6f 7b 0a 20 20 nField;. do{.
9fd0: 20 20 69 6e 74 20 69 53 61 6d 70 3b 20 20 20 20 int iSamp;
9fe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
9ff0: 2f 2a 20 49 6e 64 65 78 20 69 6e 20 61 53 61 6d /* Index in aSam
a000: 70 6c 65 5b 5d 20 6f 66 20 74 65 73 74 20 73 61 ple[] of test sa
a010: 6d 70 6c 65 20 2a 2f 0a 20 20 20 20 69 6e 74 20 mple */. int
a020: 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 n;
a030: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
a040: 62 65 72 20 6f 66 20 66 69 65 6c 64 73 20 69 6e ber of fields in
a050: 20 74 65 73 74 20 73 61 6d 70 6c 65 20 2a 2f 0a test sample */.
a060: 0a 20 20 20 20 69 54 65 73 74 20 3d 20 28 69 4d . iTest = (iM
a070: 69 6e 2b 69 53 61 6d 70 6c 65 29 2f 32 3b 0a 20 in+iSample)/2;.
a080: 20 20 20 69 53 61 6d 70 20 3d 20 69 54 65 73 74 iSamp = iTest
a090: 20 2f 20 6e 46 69 65 6c 64 3b 0a 20 20 20 20 69 / nField;. i
a0a0: 66 28 20 69 53 61 6d 70 3e 30 20 29 7b 0a 20 20 f( iSamp>0 ){.
a0b0: 20 20 20 20 2f 2a 20 54 68 65 20 70 72 6f 70 6f /* The propo
a0c0: 73 65 64 20 65 66 66 65 63 74 69 76 65 20 73 61 sed effective sa
a0d0: 6d 70 6c 65 20 69 73 20 61 20 70 72 65 66 69 78 mple is a prefix
a0e0: 20 6f 66 20 73 61 6d 70 6c 65 20 61 53 61 6d 70 of sample aSamp
a0f0: 6c 65 5b 69 53 61 6d 70 5d 2e 0a 20 20 20 20 20 le[iSamp]..
a100: 20 2a 2a 20 53 70 65 63 69 66 69 63 61 6c 6c 79 ** Specifically
a110: 2c 20 74 68 65 20 73 68 6f 72 74 65 73 74 20 70 , the shortest p
a120: 72 65 66 69 78 20 6f 66 20 61 74 20 6c 65 61 73 refix of at leas
a130: 74 20 28 31 20 2b 20 69 54 65 73 74 25 6e 46 69 t (1 + iTest%nFi
a140: 65 6c 64 29 20 0a 20 20 20 20 20 20 2a 2a 20 66 eld) . ** f
a150: 69 65 6c 64 73 20 74 68 61 74 20 69 73 20 67 72 ields that is gr
a160: 65 61 74 65 72 20 74 68 61 6e 20 74 68 65 20 70 eater than the p
a170: 72 65 76 69 6f 75 73 20 65 66 66 65 63 74 69 76 revious effectiv
a180: 65 20 73 61 6d 70 6c 65 2e 20 20 2a 2f 0a 20 20 e sample. */.
a190: 20 20 20 20 66 6f 72 28 6e 3d 28 69 54 65 73 74 for(n=(iTest
a1a0: 20 25 20 6e 46 69 65 6c 64 29 20 2b 20 31 3b 20 % nField) + 1;
a1b0: 6e 3c 6e 46 69 65 6c 64 3b 20 6e 2b 2b 29 7b 0a n<nField; n++){.
a1c0: 20 20 20 20 20 20 20 20 69 66 28 20 61 53 61 6d if( aSam
a1d0: 70 6c 65 5b 69 53 61 6d 70 2d 31 5d 2e 61 6e 4c ple[iSamp-1].anL
a1e0: 74 5b 6e 2d 31 5d 21 3d 61 53 61 6d 70 6c 65 5b t[n-1]!=aSample[
a1f0: 69 53 61 6d 70 5d 2e 61 6e 4c 74 5b 6e 2d 31 5d iSamp].anLt[n-1]
a200: 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 ) break;.
a210: 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
a220: 20 20 20 6e 20 3d 20 69 54 65 73 74 20 2b 20 31 n = iTest + 1
a230: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 70 52 65 ;. }.. pRe
a240: 63 2d 3e 6e 46 69 65 6c 64 20 3d 20 6e 3b 0a 20 c->nField = n;.
a250: 20 20 20 72 65 73 20 3d 20 73 71 6c 69 74 65 33 res = sqlite3
a260: 56 64 62 65 52 65 63 6f 72 64 43 6f 6d 70 61 72 VdbeRecordCompar
a270: 65 28 61 53 61 6d 70 6c 65 5b 69 53 61 6d 70 5d e(aSample[iSamp]
a280: 2e 6e 2c 20 61 53 61 6d 70 6c 65 5b 69 53 61 6d .n, aSample[iSam
a290: 70 5d 2e 70 2c 20 70 52 65 63 29 3b 0a 20 20 20 p].p, pRec);.
a2a0: 20 69 66 28 20 72 65 73 3c 30 20 29 7b 0a 20 20 if( res<0 ){.
a2b0: 20 20 20 20 69 4c 6f 77 65 72 20 3d 20 61 53 61 iLower = aSa
a2c0: 6d 70 6c 65 5b 69 53 61 6d 70 5d 2e 61 6e 4c 74 mple[iSamp].anLt
a2d0: 5b 6e 2d 31 5d 20 2b 20 61 53 61 6d 70 6c 65 5b [n-1] + aSample[
a2e0: 69 53 61 6d 70 5d 2e 61 6e 45 71 5b 6e 2d 31 5d iSamp].anEq[n-1]
a2f0: 3b 0a 20 20 20 20 20 20 69 4d 69 6e 20 3d 20 69 ;. iMin = i
a300: 54 65 73 74 2b 31 3b 0a 20 20 20 20 7d 65 6c 73 Test+1;. }els
a310: 65 20 69 66 28 20 72 65 73 3d 3d 30 20 26 26 20 e if( res==0 &&
a320: 6e 3c 6e 46 69 65 6c 64 20 29 7b 0a 20 20 20 20 n<nField ){.
a330: 20 20 69 4c 6f 77 65 72 20 3d 20 61 53 61 6d 70 iLower = aSamp
a340: 6c 65 5b 69 53 61 6d 70 5d 2e 61 6e 4c 74 5b 6e le[iSamp].anLt[n
a350: 2d 31 5d 3b 0a 20 20 20 20 20 20 69 4d 69 6e 20 -1];. iMin
a360: 3d 20 69 54 65 73 74 2b 31 3b 0a 20 20 20 20 20 = iTest+1;.
a370: 20 72 65 73 20 3d 20 2d 31 3b 0a 20 20 20 20 7d res = -1;. }
a380: 65 6c 73 65 7b 0a 20 20 20 20 20 20 69 53 61 6d else{. iSam
a390: 70 6c 65 20 3d 20 69 54 65 73 74 3b 0a 20 20 20 ple = iTest;.
a3a0: 20 20 20 69 43 6f 6c 20 3d 20 6e 2d 31 3b 0a 20 iCol = n-1;.
a3b0: 20 20 20 7d 0a 20 20 7d 77 68 69 6c 65 28 20 72 }. }while( r
a3c0: 65 73 20 26 26 20 69 4d 69 6e 3c 69 53 61 6d 70 es && iMin<iSamp
a3d0: 6c 65 20 29 3b 0a 20 20 69 20 3d 20 69 53 61 6d le );. i = iSam
a3e0: 70 6c 65 20 2f 20 6e 46 69 65 6c 64 3b 0a 0a 23 ple / nField;..#
a3f0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 ifdef SQLITE_DEB
a400: 55 47 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c UG. /* The foll
a410: 6f 77 69 6e 67 20 61 73 73 65 72 74 20 73 74 61 owing assert sta
a420: 74 65 6d 65 6e 74 73 20 63 68 65 63 6b 20 74 68 tements check th
a430: 61 74 20 74 68 65 20 62 69 6e 61 72 79 20 73 65 at the binary se
a440: 61 72 63 68 20 63 6f 64 65 0a 20 20 2a 2a 20 61 arch code. ** a
a450: 62 6f 76 65 20 66 6f 75 6e 64 20 74 68 65 20 72 bove found the r
a460: 69 67 68 74 20 61 6e 73 77 65 72 2e 20 54 68 69 ight answer. Thi
a470: 73 20 62 6c 6f 63 6b 20 73 65 72 76 65 73 20 6e s block serves n
a480: 6f 20 70 75 72 70 6f 73 65 20 6f 74 68 65 72 0a o purpose other.
a490: 20 20 2a 2a 20 74 68 61 6e 20 74 6f 20 69 6e 76 ** than to inv
a4a0: 6f 6b 65 20 74 68 65 20 61 73 73 65 72 74 73 2e oke the asserts.
a4b0: 20 20 2a 2f 0a 20 20 69 66 28 20 70 50 61 72 73 */. if( pPars
a4c0: 65 2d 3e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 e->db->mallocFai
a4d0: 6c 65 64 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 led==0 ){. if
a4e0: 28 20 72 65 73 3d 3d 30 20 29 7b 0a 20 20 20 20 ( res==0 ){.
a4f0: 20 20 2f 2a 20 49 66 20 28 72 65 73 3d 3d 30 29 /* If (res==0)
a500: 20 69 73 20 74 72 75 65 2c 20 74 68 65 6e 20 70 is true, then p
a510: 52 65 63 20 6d 75 73 74 20 62 65 20 65 71 75 61 Rec must be equa
a520: 6c 20 74 6f 20 73 61 6d 70 6c 65 20 69 2e 20 2a l to sample i. *
a530: 2f 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 /. assert(
a540: 69 3c 70 49 64 78 2d 3e 6e 53 61 6d 70 6c 65 20 i<pIdx->nSample
a550: 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 );. assert(
a560: 20 69 43 6f 6c 3d 3d 6e 46 69 65 6c 64 2d 31 20 iCol==nField-1
a570: 29 3b 0a 20 20 20 20 20 20 70 52 65 63 2d 3e 6e );. pRec->n
a580: 46 69 65 6c 64 20 3d 20 6e 46 69 65 6c 64 3b 0a Field = nField;.
a590: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 30 3d assert( 0=
a5a0: 3d 73 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f =sqlite3VdbeReco
a5b0: 72 64 43 6f 6d 70 61 72 65 28 61 53 61 6d 70 6c rdCompare(aSampl
a5c0: 65 5b 69 5d 2e 6e 2c 20 61 53 61 6d 70 6c 65 5b e[i].n, aSample[
a5d0: 69 5d 2e 70 2c 20 70 52 65 63 29 20 0a 20 20 20 i].p, pRec) .
a5e0: 20 20 20 20 20 20 20 20 7c 7c 20 70 50 61 72 73 || pPars
a5f0: 65 2d 3e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 e->db->mallocFai
a600: 6c 65 64 20 0a 20 20 20 20 20 20 29 3b 0a 20 20 led . );.
a610: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f }else{. /
a620: 2a 20 55 6e 6c 65 73 73 20 69 3d 3d 70 49 64 78 * Unless i==pIdx
a630: 2d 3e 6e 53 61 6d 70 6c 65 2c 20 69 6e 64 69 63 ->nSample, indic
a640: 61 74 69 6e 67 20 74 68 61 74 20 70 52 65 63 20 ating that pRec
a650: 69 73 20 6c 61 72 67 65 72 20 74 68 61 6e 0a 20 is larger than.
a660: 20 20 20 20 20 2a 2a 20 61 6c 6c 20 73 61 6d 70 ** all samp
a670: 6c 65 73 20 69 6e 20 74 68 65 20 61 53 61 6d 70 les in the aSamp
a680: 6c 65 5b 5d 20 61 72 72 61 79 2c 20 70 52 65 63 le[] array, pRec
a690: 20 6d 75 73 74 20 62 65 20 73 6d 61 6c 6c 65 72 must be smaller
a6a0: 20 74 68 61 6e 20 74 68 65 0a 20 20 20 20 20 20 than the.
a6b0: 2a 2a 20 28 69 43 6f 6c 2b 31 29 20 66 69 65 6c ** (iCol+1) fiel
a6c0: 64 20 70 72 65 66 69 78 20 6f 66 20 73 61 6d 70 d prefix of samp
a6d0: 6c 65 20 69 2e 20 20 2a 2f 0a 20 20 20 20 20 20 le i. */.
a6e0: 61 73 73 65 72 74 28 20 69 3c 3d 70 49 64 78 2d assert( i<=pIdx-
a6f0: 3e 6e 53 61 6d 70 6c 65 20 26 26 20 69 3e 3d 30 >nSample && i>=0
a700: 20 29 3b 0a 20 20 20 20 20 20 70 52 65 63 2d 3e );. pRec->
a710: 6e 46 69 65 6c 64 20 3d 20 69 43 6f 6c 2b 31 3b nField = iCol+1;
a720: 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 69 . assert( i
a730: 3d 3d 70 49 64 78 2d 3e 6e 53 61 6d 70 6c 65 20 ==pIdx->nSample
a740: 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 73 . || s
a750: 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 qlite3VdbeRecord
a760: 43 6f 6d 70 61 72 65 28 61 53 61 6d 70 6c 65 5b Compare(aSample[
a770: 69 5d 2e 6e 2c 20 61 53 61 6d 70 6c 65 5b 69 5d i].n, aSample[i]
a780: 2e 70 2c 20 70 52 65 63 29 3e 30 0a 20 20 20 20 .p, pRec)>0.
a790: 20 20 20 20 20 20 20 7c 7c 20 70 50 61 72 73 65 || pParse
a7a0: 2d 3e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c ->db->mallocFail
a7b0: 65 64 20 29 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 ed );.. /*
a7c0: 69 66 20 69 3d 3d 30 20 61 6e 64 20 69 43 6f 6c if i==0 and iCol
a7d0: 3d 3d 30 2c 20 74 68 65 6e 20 72 65 63 6f 72 64 ==0, then record
a7e0: 20 70 52 65 63 20 69 73 20 73 6d 61 6c 6c 65 72 pRec is smaller
a7f0: 20 74 68 61 6e 20 61 6c 6c 20 73 61 6d 70 6c 65 than all sample
a800: 73 0a 20 20 20 20 20 20 2a 2a 20 69 6e 20 74 68 s. ** in th
a810: 65 20 61 53 61 6d 70 6c 65 5b 5d 20 61 72 72 61 e aSample[] arra
a820: 79 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 y. Otherwise, if
a830: 20 28 69 43 6f 6c 3e 30 29 20 74 68 65 6e 20 70 (iCol>0) then p
a840: 52 65 63 20 6d 75 73 74 0a 20 20 20 20 20 20 2a Rec must. *
a850: 2a 20 62 65 20 67 72 65 61 74 65 72 20 74 68 61 * be greater tha
a860: 6e 20 6f 72 20 65 71 75 61 6c 20 74 6f 20 74 68 n or equal to th
a870: 65 20 28 69 43 6f 6c 29 20 66 69 65 6c 64 20 70 e (iCol) field p
a880: 72 65 66 69 78 20 6f 66 20 73 61 6d 70 6c 65 20 refix of sample
a890: 69 2e 0a 20 20 20 20 20 20 2a 2a 20 49 66 20 28 i.. ** If (
a8a0: 69 3e 30 29 2c 20 74 68 65 6e 20 70 52 65 63 20 i>0), then pRec
a8b0: 6d 75 73 74 20 61 6c 73 6f 20 62 65 20 67 72 65 must also be gre
a8c0: 61 74 65 72 20 74 68 61 6e 20 73 61 6d 70 6c 65 ater than sample
a8d0: 20 28 69 2d 31 29 2e 20 20 2a 2f 0a 20 20 20 20 (i-1). */.
a8e0: 20 20 69 66 28 20 69 43 6f 6c 3e 30 20 29 7b 0a if( iCol>0 ){.
a8f0: 20 20 20 20 20 20 20 20 70 52 65 63 2d 3e 6e 46 pRec->nF
a900: 69 65 6c 64 20 3d 20 69 43 6f 6c 3b 0a 20 20 20 ield = iCol;.
a910: 20 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c assert( sql
a920: 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 43 6f ite3VdbeRecordCo
a930: 6d 70 61 72 65 28 61 53 61 6d 70 6c 65 5b 69 5d mpare(aSample[i]
a940: 2e 6e 2c 20 61 53 61 6d 70 6c 65 5b 69 5d 2e 70 .n, aSample[i].p
a950: 2c 20 70 52 65 63 29 3c 3d 30 0a 20 20 20 20 20 , pRec)<=0.
a960: 20 20 20 20 20 20 20 20 7c 7c 20 70 50 61 72 73 || pPars
a970: 65 2d 3e 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 e->db->mallocFai
a980: 6c 65 64 20 29 3b 0a 20 20 20 20 20 20 7d 0a 20 led );. }.
a990: 20 20 20 20 20 69 66 28 20 69 3e 30 20 29 7b 0a if( i>0 ){.
a9a0: 20 20 20 20 20 20 20 20 70 52 65 63 2d 3e 6e 46 pRec->nF
a9b0: 69 65 6c 64 20 3d 20 6e 46 69 65 6c 64 3b 0a 20 ield = nField;.
a9c0: 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 73 assert( s
a9d0: 71 6c 69 74 65 33 56 64 62 65 52 65 63 6f 72 64 qlite3VdbeRecord
a9e0: 43 6f 6d 70 61 72 65 28 61 53 61 6d 70 6c 65 5b Compare(aSample[
a9f0: 69 2d 31 5d 2e 6e 2c 20 61 53 61 6d 70 6c 65 5b i-1].n, aSample[
aa00: 69 2d 31 5d 2e 70 2c 20 70 52 65 63 29 3c 30 0a i-1].p, pRec)<0.
aa10: 20 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 ||
aa20: 70 50 61 72 73 65 2d 3e 64 62 2d 3e 6d 61 6c 6c pParse->db->mall
aa30: 6f 63 46 61 69 6c 65 64 20 29 3b 0a 20 20 20 20 ocFailed );.
aa40: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 }. }. }.#e
aa50: 6e 64 69 66 20 2f 2a 20 69 66 64 65 66 20 53 51 ndif /* ifdef SQ
aa60: 4c 49 54 45 5f 44 45 42 55 47 20 2a 2f 0a 0a 20 LITE_DEBUG */..
aa70: 20 69 66 28 20 72 65 73 3d 3d 30 20 29 7b 0a 20 if( res==0 ){.
aa80: 20 20 20 2f 2a 20 52 65 63 6f 72 64 20 70 52 65 /* Record pRe
aa90: 63 20 69 73 20 65 71 75 61 6c 20 74 6f 20 73 61 c is equal to sa
aaa0: 6d 70 6c 65 20 69 20 2a 2f 0a 20 20 20 20 61 73 mple i */. as
aab0: 73 65 72 74 28 20 69 43 6f 6c 3d 3d 6e 46 69 65 sert( iCol==nFie
aac0: 6c 64 2d 31 20 29 3b 0a 20 20 20 20 61 53 74 61 ld-1 );. aSta
aad0: 74 5b 30 5d 20 3d 20 61 53 61 6d 70 6c 65 5b 69 t[0] = aSample[i
aae0: 5d 2e 61 6e 4c 74 5b 69 43 6f 6c 5d 3b 0a 20 20 ].anLt[iCol];.
aaf0: 20 20 61 53 74 61 74 5b 31 5d 20 3d 20 61 53 61 aStat[1] = aSa
ab00: 6d 70 6c 65 5b 69 5d 2e 61 6e 45 71 5b 69 43 6f mple[i].anEq[iCo
ab10: 6c 5d 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 l];. }else{.
ab20: 20 2f 2a 20 41 74 20 74 68 69 73 20 70 6f 69 6e /* At this poin
ab30: 74 2c 20 74 68 65 20 28 69 43 6f 6c 2b 31 29 20 t, the (iCol+1)
ab40: 66 69 65 6c 64 20 70 72 65 66 69 78 20 6f 66 20 field prefix of
ab50: 61 53 61 6d 70 6c 65 5b 69 5d 20 69 73 20 74 68 aSample[i] is th
ab60: 65 20 66 69 72 73 74 20 0a 20 20 20 20 2a 2a 20 e first . **
ab70: 73 61 6d 70 6c 65 20 74 68 61 74 20 69 73 20 67 sample that is g
ab80: 72 65 61 74 65 72 20 74 68 61 6e 20 70 52 65 63 reater than pRec
ab90: 2e 20 4f 72 2c 20 69 66 20 69 3d 3d 70 49 64 78 . Or, if i==pIdx
aba0: 2d 3e 6e 53 61 6d 70 6c 65 20 74 68 65 6e 20 70 ->nSample then p
abb0: 52 65 63 0a 20 20 20 20 2a 2a 20 69 73 20 6c 61 Rec. ** is la
abc0: 72 67 65 72 20 74 68 61 6e 20 61 6c 6c 20 73 61 rger than all sa
abd0: 6d 70 6c 65 73 20 69 6e 20 74 68 65 20 61 72 72 mples in the arr
abe0: 61 79 2e 20 2a 2f 0a 20 20 20 20 74 52 6f 77 63 ay. */. tRowc
abf0: 6e 74 20 69 55 70 70 65 72 2c 20 69 47 61 70 3b nt iUpper, iGap;
ac00: 0a 20 20 20 20 69 66 28 20 69 3e 3d 70 49 64 78 . if( i>=pIdx
ac10: 2d 3e 6e 53 61 6d 70 6c 65 20 29 7b 0a 20 20 20 ->nSample ){.
ac20: 20 20 20 69 55 70 70 65 72 20 3d 20 73 71 6c 69 iUpper = sqli
ac30: 74 65 33 4c 6f 67 45 73 74 54 6f 49 6e 74 28 70 te3LogEstToInt(p
ac40: 49 64 78 2d 3e 61 69 52 6f 77 4c 6f 67 45 73 74 Idx->aiRowLogEst
ac50: 5b 30 5d 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b [0]);. }else{
ac60: 0a 20 20 20 20 20 20 69 55 70 70 65 72 20 3d 20 . iUpper =
ac70: 61 53 61 6d 70 6c 65 5b 69 5d 2e 61 6e 4c 74 5b aSample[i].anLt[
ac80: 69 43 6f 6c 5d 3b 0a 20 20 20 20 7d 0a 0a 20 20 iCol];. }..
ac90: 20 20 69 66 28 20 69 4c 6f 77 65 72 3e 3d 69 55 if( iLower>=iU
aca0: 70 70 65 72 20 29 7b 0a 20 20 20 20 20 20 69 47 pper ){. iG
acb0: 61 70 20 3d 20 30 3b 0a 20 20 20 20 7d 65 6c 73 ap = 0;. }els
acc0: 65 7b 0a 20 20 20 20 20 20 69 47 61 70 20 3d 20 e{. iGap =
acd0: 69 55 70 70 65 72 20 2d 20 69 4c 6f 77 65 72 3b iUpper - iLower;
ace0: 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 28 20 72 . }. if( r
acf0: 6f 75 6e 64 55 70 20 29 7b 0a 20 20 20 20 20 20 oundUp ){.
ad00: 69 47 61 70 20 3d 20 28 69 47 61 70 2a 32 29 2f iGap = (iGap*2)/
ad10: 33 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 3;. }else{.
ad20: 20 20 20 20 69 47 61 70 20 3d 20 69 47 61 70 2f iGap = iGap/
ad30: 33 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 53 74 3;. }. aSt
ad40: 61 74 5b 30 5d 20 3d 20 69 4c 6f 77 65 72 20 2b at[0] = iLower +
ad50: 20 69 47 61 70 3b 0a 20 20 20 20 61 53 74 61 74 iGap;. aStat
ad60: 5b 31 5d 20 3d 20 70 49 64 78 2d 3e 61 41 76 67 [1] = pIdx->aAvg
ad70: 45 71 5b 6e 46 69 65 6c 64 2d 31 5d 3b 0a 20 20 Eq[nField-1];.
ad80: 7d 0a 0a 20 20 2f 2a 20 52 65 73 74 6f 72 65 20 }.. /* Restore
ad90: 74 68 65 20 70 52 65 63 2d 3e 6e 46 69 65 6c 64 the pRec->nField
ada0: 20 76 61 6c 75 65 20 62 65 66 6f 72 65 20 72 65 value before re
adb0: 74 75 72 6e 69 6e 67 2e 20 20 2a 2f 0a 20 20 70 turning. */. p
adc0: 52 65 63 2d 3e 6e 46 69 65 6c 64 20 3d 20 6e 46 Rec->nField = nF
add0: 69 65 6c 64 3b 0a 20 20 72 65 74 75 72 6e 20 69 ield;. return i
ade0: 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 ;.}.#endif /* SQ
adf0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 LITE_ENABLE_STAT
ae00: 33 5f 4f 52 5f 53 54 41 54 34 20 2a 2f 0a 0a 2f 3_OR_STAT4 */../
ae10: 2a 0a 2a 2a 20 49 66 20 69 74 20 69 73 20 6e 6f *.** If it is no
ae20: 74 20 4e 55 4c 4c 2c 20 70 54 65 72 6d 20 69 73 t NULL, pTerm is
ae30: 20 61 20 74 65 72 6d 20 74 68 61 74 20 70 72 6f a term that pro
ae40: 76 69 64 65 73 20 61 6e 20 75 70 70 65 72 20 6f vides an upper o
ae50: 72 20 6c 6f 77 65 72 0a 2a 2a 20 62 6f 75 6e 64 r lower.** bound
ae60: 20 6f 6e 20 61 20 72 61 6e 67 65 20 73 63 61 6e on a range scan
ae70: 2e 20 57 69 74 68 6f 75 74 20 63 6f 6e 73 69 64 . Without consid
ae80: 65 72 69 6e 67 20 70 54 65 72 6d 2c 20 69 74 20 ering pTerm, it
ae90: 69 73 20 65 73 74 69 6d 61 74 65 64 20 0a 2a 2a is estimated .**
aea0: 20 74 68 61 74 20 74 68 65 20 73 63 61 6e 20 77 that the scan w
aeb0: 69 6c 6c 20 76 69 73 69 74 20 6e 4e 65 77 20 72 ill visit nNew r
aec0: 6f 77 73 2e 20 54 68 69 73 20 66 75 6e 63 74 69 ows. This functi
aed0: 6f 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 6e on returns the n
aee0: 75 6d 62 65 72 0a 2a 2a 20 65 73 74 69 6d 61 74 umber.** estimat
aef0: 65 64 20 74 6f 20 62 65 20 76 69 73 69 74 65 64 ed to be visited
af00: 20 61 66 74 65 72 20 74 61 6b 69 6e 67 20 70 54 after taking pT
af10: 65 72 6d 20 69 6e 74 6f 20 61 63 63 6f 75 6e 74 erm into account
af20: 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 75 ..**.** If the u
af30: 73 65 72 20 65 78 70 6c 69 63 69 74 6c 79 20 73 ser explicitly s
af40: 70 65 63 69 66 69 65 64 20 61 20 6c 69 6b 65 6c pecified a likel
af50: 69 68 6f 6f 64 28 29 20 76 61 6c 75 65 20 66 6f ihood() value fo
af60: 72 20 74 68 69 73 20 74 65 72 6d 2c 0a 2a 2a 20 r this term,.**
af70: 74 68 65 6e 20 74 68 65 20 72 65 74 75 72 6e 20 then the return
af80: 76 61 6c 75 65 20 69 73 20 74 68 65 20 6c 69 6b value is the lik
af90: 65 6c 69 68 6f 6f 64 20 6d 75 6c 74 69 70 6c 69 elihood multipli
afa0: 65 64 20 62 79 20 74 68 65 20 6e 75 6d 62 65 72 ed by the number
afb0: 20 6f 66 0a 2a 2a 20 69 6e 70 75 74 20 72 6f 77 of.** input row
afc0: 73 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68 s. Otherwise, th
afd0: 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 75 is function assu
afe0: 6d 65 73 20 74 68 61 74 20 61 6e 20 22 49 53 20 mes that an "IS
aff0: 4e 4f 54 20 4e 55 4c 4c 22 20 74 65 72 6d 0a 2a NOT NULL" term.*
b000: 2a 20 68 61 73 20 61 20 6c 69 6b 65 6c 69 68 6f * has a likeliho
b010: 6f 64 20 6f 66 20 30 2e 35 30 2c 20 61 6e 64 20 od of 0.50, and
b020: 61 6e 79 20 6f 74 68 65 72 20 74 65 72 6d 20 61 any other term a
b030: 20 6c 69 6b 65 6c 69 68 6f 6f 64 20 6f 66 20 30 likelihood of 0
b040: 2e 32 35 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 4c .25..*/.static L
b050: 6f 67 45 73 74 20 77 68 65 72 65 52 61 6e 67 65 ogEst whereRange
b060: 41 64 6a 75 73 74 28 57 68 65 72 65 54 65 72 6d Adjust(WhereTerm
b070: 20 2a 70 54 65 72 6d 2c 20 4c 6f 67 45 73 74 20 *pTerm, LogEst
b080: 6e 4e 65 77 29 7b 0a 20 20 4c 6f 67 45 73 74 20 nNew){. LogEst
b090: 6e 52 65 74 20 3d 20 6e 4e 65 77 3b 0a 20 20 69 nRet = nNew;. i
b0a0: 66 28 20 70 54 65 72 6d 20 29 7b 0a 20 20 20 20 f( pTerm ){.
b0b0: 69 66 28 20 70 54 65 72 6d 2d 3e 74 72 75 74 68 if( pTerm->truth
b0c0: 50 72 6f 62 3c 3d 30 20 29 7b 0a 20 20 20 20 20 Prob<=0 ){.
b0d0: 20 6e 52 65 74 20 2b 3d 20 70 54 65 72 6d 2d 3e nRet += pTerm->
b0e0: 74 72 75 74 68 50 72 6f 62 3b 0a 20 20 20 20 7d truthProb;. }
b0f0: 65 6c 73 65 20 69 66 28 20 28 70 54 65 72 6d 2d else if( (pTerm-
b100: 3e 77 74 46 6c 61 67 73 20 26 20 54 45 52 4d 5f >wtFlags & TERM_
b110: 56 4e 55 4c 4c 29 3d 3d 30 20 29 7b 0a 20 20 20 VNULL)==0 ){.
b120: 20 20 20 6e 52 65 74 20 2d 3d 20 32 30 3b 20 20 nRet -= 20;
b130: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 32 30 assert( 20
b140: 3d 3d 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 28 ==sqlite3LogEst(
b150: 34 29 20 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 4) );. }. }.
b160: 20 20 72 65 74 75 72 6e 20 6e 52 65 74 3b 0a 7d return nRet;.}
b170: 0a 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 ...#ifdef SQLITE
b180: 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 _ENABLE_STAT3_OR
b190: 5f 53 54 41 54 34 0a 2f 2a 0a 2a 2a 20 52 65 74 _STAT4./*.** Ret
b1a0: 75 72 6e 20 74 68 65 20 61 66 66 69 6e 69 74 79 urn the affinity
b1b0: 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 20 63 6f for a single co
b1c0: 6c 75 6d 6e 20 6f 66 20 61 6e 20 69 6e 64 65 78 lumn of an index
b1d0: 2e 0a 2a 2f 0a 63 68 61 72 20 73 71 6c 69 74 65 ..*/.char sqlite
b1e0: 33 49 6e 64 65 78 43 6f 6c 75 6d 6e 41 66 66 69 3IndexColumnAffi
b1f0: 6e 69 74 79 28 73 71 6c 69 74 65 33 20 2a 64 62 nity(sqlite3 *db
b200: 2c 20 49 6e 64 65 78 20 2a 70 49 64 78 2c 20 69 , Index *pIdx, i
b210: 6e 74 20 69 43 6f 6c 29 7b 0a 20 20 61 73 73 65 nt iCol){. asse
b220: 72 74 28 20 69 43 6f 6c 3e 3d 30 20 26 26 20 69 rt( iCol>=0 && i
b230: 43 6f 6c 3c 70 49 64 78 2d 3e 6e 43 6f 6c 75 6d Col<pIdx->nColum
b240: 6e 20 29 3b 0a 20 20 69 66 28 20 21 70 49 64 78 n );. if( !pIdx
b250: 2d 3e 7a 43 6f 6c 41 66 66 20 29 7b 0a 20 20 20 ->zColAff ){.
b260: 20 69 66 28 20 73 71 6c 69 74 65 33 49 6e 64 65 if( sqlite3Inde
b270: 78 41 66 66 69 6e 69 74 79 53 74 72 28 64 62 2c xAffinityStr(db,
b280: 20 70 49 64 78 29 3d 3d 30 20 29 20 72 65 74 75 pIdx)==0 ) retu
b290: 72 6e 20 53 51 4c 49 54 45 5f 41 46 46 5f 42 4c rn SQLITE_AFF_BL
b2a0: 4f 42 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e OB;. }. return
b2b0: 20 70 49 64 78 2d 3e 7a 43 6f 6c 41 66 66 5b 69 pIdx->zColAff[i
b2c0: 43 6f 6c 5d 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a Col];.}.#endif..
b2d0: 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 .#ifdef SQLITE_E
b2e0: 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 NABLE_STAT3_OR_S
b2f0: 54 41 54 34 0a 2f 2a 20 0a 2a 2a 20 54 68 69 73 TAT4./* .** This
b300: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c function is cal
b310: 6c 65 64 20 74 6f 20 65 73 74 69 6d 61 74 65 20 led to estimate
b320: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f the number of ro
b330: 77 73 20 76 69 73 69 74 65 64 20 62 79 20 61 0a ws visited by a.
b340: 2a 2a 20 72 61 6e 67 65 2d 73 63 61 6e 20 6f 6e ** range-scan on
b350: 20 61 20 73 6b 69 70 2d 73 63 61 6e 20 69 6e 64 a skip-scan ind
b360: 65 78 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a ex. For example:
b370: 0a 2a 2a 0a 2a 2a 20 20 20 43 52 45 41 54 45 20 .**.** CREATE
b380: 49 4e 44 45 58 20 69 31 20 4f 4e 20 74 31 28 61 INDEX i1 ON t1(a
b390: 2c 20 62 2c 20 63 29 3b 0a 2a 2a 20 20 20 53 45 , b, c);.** SE
b3a0: 4c 45 43 54 20 2a 20 46 52 4f 4d 20 74 31 20 57 LECT * FROM t1 W
b3b0: 48 45 52 45 20 61 3d 3f 20 41 4e 44 20 63 20 42 HERE a=? AND c B
b3c0: 45 54 57 45 45 4e 20 3f 20 41 4e 44 20 3f 3b 0a ETWEEN ? AND ?;.
b3d0: 2a 2a 0a 2a 2a 20 56 61 6c 75 65 20 70 4c 6f 6f **.** Value pLoo
b3e0: 70 2d 3e 6e 4f 75 74 20 69 73 20 63 75 72 72 65 p->nOut is curre
b3f0: 6e 74 6c 79 20 73 65 74 20 74 6f 20 74 68 65 20 ntly set to the
b400: 65 73 74 69 6d 61 74 65 64 20 6e 75 6d 62 65 72 estimated number
b410: 20 6f 66 20 72 6f 77 73 20 0a 2a 2a 20 76 69 73 of rows .** vis
b420: 69 74 65 64 20 66 6f 72 20 73 63 61 6e 6e 69 6e ited for scannin
b430: 67 20 28 61 3d 3f 20 41 4e 44 20 62 3d 3f 29 2e g (a=? AND b=?).
b440: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 This function r
b450: 65 64 75 63 65 73 20 74 68 61 74 20 65 73 74 69 educes that esti
b460: 6d 61 74 65 20 0a 2a 2a 20 62 79 20 73 6f 6d 65 mate .** by some
b470: 20 66 61 63 74 6f 72 20 74 6f 20 61 63 63 6f 75 factor to accou
b480: 6e 74 20 66 6f 72 20 74 68 65 20 28 63 20 42 45 nt for the (c BE
b490: 54 57 45 45 4e 20 3f 20 41 4e 44 20 3f 29 20 65 TWEEN ? AND ?) e
b4a0: 78 70 72 65 73 73 69 6f 6e 20 62 61 73 65 64 0a xpression based.
b4b0: 2a 2a 20 6f 6e 20 74 68 65 20 73 74 61 74 34 20 ** on the stat4
b4c0: 64 61 74 61 20 66 6f 72 20 74 68 65 20 69 6e 64 data for the ind
b4d0: 65 78 2e 20 74 68 69 73 20 73 63 61 6e 20 77 69 ex. this scan wi
b4e0: 6c 6c 20 62 65 20 70 65 66 6f 72 6d 65 64 20 6d ll be peformed m
b4f0: 75 6c 74 69 70 6c 65 20 0a 2a 2a 20 74 69 6d 65 ultiple .** time
b500: 73 20 28 6f 6e 63 65 20 66 6f 72 20 65 61 63 68 s (once for each
b510: 20 28 61 2c 62 29 20 63 6f 6d 62 69 6e 61 74 69 (a,b) combinati
b520: 6f 6e 20 74 68 61 74 20 6d 61 74 63 68 65 73 20 on that matches
b530: 61 3d 3f 29 20 69 73 20 64 65 61 6c 74 20 77 69 a=?) is dealt wi
b540: 74 68 20 0a 2a 2a 20 62 79 20 74 68 65 20 63 61 th .** by the ca
b550: 6c 6c 65 72 2e 0a 2a 2a 0a 2a 2a 20 49 74 20 64 ller..**.** It d
b560: 6f 65 73 20 74 68 69 73 20 62 79 20 73 63 61 6e oes this by scan
b570: 6e 69 6e 67 20 74 68 72 6f 75 67 68 20 61 6c 6c ning through all
b580: 20 73 74 61 74 34 20 73 61 6d 70 6c 65 73 2c 20 stat4 samples,
b590: 63 6f 6d 70 61 72 69 6e 67 20 76 61 6c 75 65 73 comparing values
b5a0: 0a 2a 2a 20 65 78 74 72 61 63 74 65 64 20 66 72 .** extracted fr
b5b0: 6f 6d 20 70 4c 6f 77 65 72 20 61 6e 64 20 70 55 om pLower and pU
b5c0: 70 70 65 72 20 77 69 74 68 20 74 68 65 20 63 6f pper with the co
b5d0: 72 72 65 73 70 6f 6e 64 69 6e 67 20 63 6f 6c 75 rresponding colu
b5e0: 6d 6e 20 69 6e 20 65 61 63 68 0a 2a 2a 20 73 61 mn in each.** sa
b5f0: 6d 70 6c 65 2e 20 49 66 20 4c 20 61 6e 64 20 55 mple. If L and U
b600: 20 61 72 65 20 74 68 65 20 6e 75 6d 62 65 72 20 are the number
b610: 6f 66 20 73 61 6d 70 6c 65 73 20 66 6f 75 6e 64 of samples found
b620: 20 74 6f 20 62 65 20 6c 65 73 73 20 74 68 61 6e to be less than
b630: 20 6f 72 0a 2a 2a 20 65 71 75 61 6c 20 74 6f 20 or.** equal to
b640: 74 68 65 20 76 61 6c 75 65 73 20 65 78 74 72 61 the values extra
b650: 63 74 65 64 20 66 72 6f 6d 20 70 4c 6f 77 65 72 cted from pLower
b660: 20 61 6e 64 20 70 55 70 70 65 72 20 72 65 73 70 and pUpper resp
b670: 65 63 74 69 76 65 6c 79 2c 20 61 6e 64 0a 2a 2a ectively, and.**
b680: 20 4e 20 69 73 20 74 68 65 20 74 6f 74 61 6c 20 N is the total
b690: 6e 75 6d 62 65 72 20 6f 66 20 73 61 6d 70 6c 65 number of sample
b6a0: 73 2c 20 74 68 65 20 70 4c 6f 6f 70 2d 3e 6e 4f s, the pLoop->nO
b6b0: 75 74 20 76 61 6c 75 65 20 69 73 20 61 64 6a 75 ut value is adju
b6c0: 73 74 65 64 0a 2a 2a 20 61 73 20 66 6f 6c 6c 6f sted.** as follo
b6d0: 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 6e 4f 75 74 ws:.**.** nOut
b6e0: 20 3d 20 6e 4f 75 74 20 2a 20 28 20 6d 69 6e 28 = nOut * ( min(
b6f0: 55 20 2d 20 4c 2c 20 31 29 20 2f 20 4e 20 29 0a U - L, 1) / N ).
b700: 2a 2a 0a 2a 2a 20 49 66 20 70 4c 6f 77 65 72 20 **.** If pLower
b710: 69 73 20 4e 55 4c 4c 2c 20 6f 72 20 61 20 76 61 is NULL, or a va
b720: 6c 75 65 20 63 61 6e 6e 6f 74 20 62 65 20 65 78 lue cannot be ex
b730: 74 72 61 63 74 65 64 20 66 72 6f 6d 20 74 68 65 tracted from the
b740: 20 74 65 72 6d 2c 20 4c 20 69 73 0a 2a 2a 20 73 term, L is.** s
b750: 65 74 20 74 6f 20 7a 65 72 6f 2e 20 49 66 20 70 et to zero. If p
b760: 55 70 70 65 72 20 69 73 20 4e 55 4c 4c 2c 20 6f Upper is NULL, o
b770: 72 20 61 20 76 61 6c 75 65 20 63 61 6e 6e 6f 74 r a value cannot
b780: 20 62 65 20 65 78 74 72 61 63 74 65 64 20 66 72 be extracted fr
b790: 6f 6d 20 69 74 2c 0a 2a 2a 20 55 20 69 73 20 73 om it,.** U is s
b7a0: 65 74 20 74 6f 20 4e 2e 0a 2a 2a 0a 2a 2a 20 4e et to N..**.** N
b7b0: 6f 72 6d 61 6c 6c 79 2c 20 74 68 69 73 20 66 75 ormally, this fu
b7c0: 6e 63 74 69 6f 6e 20 73 65 74 73 20 2a 70 62 44 nction sets *pbD
b7d0: 6f 6e 65 20 74 6f 20 31 20 62 65 66 6f 72 65 20 one to 1 before
b7e0: 72 65 74 75 72 6e 69 6e 67 2e 20 48 6f 77 65 76 returning. Howev
b7f0: 65 72 2c 0a 2a 2a 20 69 66 20 6e 6f 20 76 61 6c er,.** if no val
b800: 75 65 20 63 61 6e 20 62 65 20 65 78 74 72 61 63 ue can be extrac
b810: 74 65 64 20 66 72 6f 6d 20 65 69 74 68 65 72 20 ted from either
b820: 70 4c 6f 77 65 72 20 6f 72 20 70 55 70 70 65 72 pLower or pUpper
b830: 20 28 61 6e 64 20 73 6f 20 74 68 65 0a 2a 2a 20 (and so the.**
b840: 65 73 74 69 6d 61 74 65 20 6f 66 20 74 68 65 20 estimate of the
b850: 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 64 number of rows d
b860: 65 6c 69 76 65 72 65 64 20 72 65 6d 61 69 6e 73 elivered remains
b870: 20 75 6e 63 68 61 6e 67 65 64 29 2c 20 2a 70 62 unchanged), *pb
b880: 44 6f 6e 65 0a 2a 2a 20 69 73 20 6c 65 66 74 20 Done.** is left
b890: 61 73 20 69 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 as is..**.** If
b8a0: 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c an error occurs,
b8b0: 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72 an SQLite error
b8c0: 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 code is returne
b8d0: 64 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 0a 2a d. Otherwise, .*
b8e0: 2a 20 53 51 4c 49 54 45 5f 4f 4b 2e 0a 2a 2f 0a * SQLITE_OK..*/.
b8f0: 73 74 61 74 69 63 20 69 6e 74 20 77 68 65 72 65 static int where
b900: 52 61 6e 67 65 53 6b 69 70 53 63 61 6e 45 73 74 RangeSkipScanEst
b910: 28 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 (. Parse *pPars
b920: 65 2c 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 e, /* Pars
b930: 69 6e 67 20 26 20 63 6f 64 65 20 67 65 6e 65 72 ing & code gener
b940: 61 74 69 6e 67 20 63 6f 6e 74 65 78 74 20 2a 2f ating context */
b950: 0a 20 20 57 68 65 72 65 54 65 72 6d 20 2a 70 4c . WhereTerm *pL
b960: 6f 77 65 72 2c 20 20 20 2f 2a 20 4c 6f 77 65 72 ower, /* Lower
b970: 20 62 6f 75 6e 64 20 6f 6e 20 74 68 65 20 72 61 bound on the ra
b980: 6e 67 65 2e 20 65 78 3a 20 22 78 3e 31 32 33 22 nge. ex: "x>123"
b990: 20 4d 69 67 68 74 20 62 65 20 4e 55 4c 4c 20 2a Might be NULL *
b9a0: 2f 0a 20 20 57 68 65 72 65 54 65 72 6d 20 2a 70 /. WhereTerm *p
b9b0: 55 70 70 65 72 2c 20 20 20 2f 2a 20 55 70 70 65 Upper, /* Uppe
b9c0: 72 20 62 6f 75 6e 64 20 6f 6e 20 74 68 65 20 72 r bound on the r
b9d0: 61 6e 67 65 2e 20 65 78 3a 20 22 78 3c 34 35 35 ange. ex: "x<455
b9e0: 22 20 4d 69 67 68 74 20 62 65 20 4e 55 4c 4c 20 " Might be NULL
b9f0: 2a 2f 0a 20 20 57 68 65 72 65 4c 6f 6f 70 20 2a */. WhereLoop *
ba00: 70 4c 6f 6f 70 2c 20 20 20 20 2f 2a 20 55 70 64 pLoop, /* Upd
ba10: 61 74 65 20 74 68 65 20 2e 6e 4f 75 74 20 76 61 ate the .nOut va
ba20: 6c 75 65 20 6f 66 20 74 68 69 73 20 6c 6f 6f 70 lue of this loop
ba30: 20 2a 2f 0a 20 20 69 6e 74 20 2a 70 62 44 6f 6e */. int *pbDon
ba40: 65 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 65 e /* Se
ba50: 74 20 74 6f 20 74 72 75 65 20 69 66 20 61 74 20 t to true if at
ba60: 6c 65 61 73 74 20 6f 6e 65 20 65 78 70 72 2e 20 least one expr.
ba70: 76 61 6c 75 65 20 65 78 74 72 61 63 74 65 64 20 value extracted
ba80: 2a 2f 0a 29 7b 0a 20 20 49 6e 64 65 78 20 2a 70 */.){. Index *p
ba90: 20 3d 20 70 4c 6f 6f 70 2d 3e 75 2e 62 74 72 65 = pLoop->u.btre
baa0: 65 2e 70 49 6e 64 65 78 3b 0a 20 20 69 6e 74 20 e.pIndex;. int
bab0: 6e 45 71 20 3d 20 70 4c 6f 6f 70 2d 3e 75 2e 62 nEq = pLoop->u.b
bac0: 74 72 65 65 2e 6e 45 71 3b 0a 20 20 73 71 6c 69 tree.nEq;. sqli
bad0: 74 65 33 20 2a 64 62 20 3d 20 70 50 61 72 73 65 te3 *db = pParse
bae0: 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 6e 4c 6f 77 ->db;. int nLow
baf0: 65 72 20 3d 20 2d 31 3b 0a 20 20 69 6e 74 20 6e er = -1;. int n
bb00: 55 70 70 65 72 20 3d 20 70 2d 3e 6e 53 61 6d 70 Upper = p->nSamp
bb10: 6c 65 2b 31 3b 0a 20 20 69 6e 74 20 72 63 20 3d le+1;. int rc =
bb20: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 75 38 SQLITE_OK;. u8
bb30: 20 61 66 66 20 3d 20 73 71 6c 69 74 65 33 49 6e aff = sqlite3In
bb40: 64 65 78 43 6f 6c 75 6d 6e 41 66 66 69 6e 69 74 dexColumnAffinit
bb50: 79 28 64 62 2c 20 70 2c 20 6e 45 71 29 3b 0a 20 y(db, p, nEq);.
bb60: 20 43 6f 6c 6c 53 65 71 20 2a 70 43 6f 6c 6c 3b CollSeq *pColl;
bb70: 0a 20 20 0a 20 20 73 71 6c 69 74 65 33 5f 76 61 . . sqlite3_va
bb80: 6c 75 65 20 2a 70 31 20 3d 20 30 3b 20 20 20 20 lue *p1 = 0;
bb90: 20 20 20 20 20 20 2f 2a 20 56 61 6c 75 65 20 65 /* Value e
bba0: 78 74 72 61 63 74 65 64 20 66 72 6f 6d 20 70 4c xtracted from pL
bbb0: 6f 77 65 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 ower */. sqlite
bbc0: 33 5f 76 61 6c 75 65 20 2a 70 32 20 3d 20 30 3b 3_value *p2 = 0;
bbd0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 56 61 6c /* Val
bbe0: 75 65 20 65 78 74 72 61 63 74 65 64 20 66 72 6f ue extracted fro
bbf0: 6d 20 70 55 70 70 65 72 20 2a 2f 0a 20 20 73 71 m pUpper */. sq
bc00: 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 70 56 61 lite3_value *pVa
bc10: 6c 20 3d 20 30 3b 20 20 20 20 20 20 20 20 2f 2a l = 0; /*
bc20: 20 56 61 6c 75 65 20 65 78 74 72 61 63 74 65 64 Value extracted
bc30: 20 66 72 6f 6d 20 72 65 63 6f 72 64 20 2a 2f 0a from record */.
bc40: 0a 20 20 70 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 . pColl = sqlit
bc50: 65 33 4c 6f 63 61 74 65 43 6f 6c 6c 53 65 71 28 e3LocateCollSeq(
bc60: 70 50 61 72 73 65 2c 20 70 2d 3e 61 7a 43 6f 6c pParse, p->azCol
bc70: 6c 5b 6e 45 71 5d 29 3b 0a 20 20 69 66 28 20 70 l[nEq]);. if( p
bc80: 4c 6f 77 65 72 20 29 7b 0a 20 20 20 20 72 63 20 Lower ){. rc
bc90: 3d 20 73 71 6c 69 74 65 33 53 74 61 74 34 56 61 = sqlite3Stat4Va
bca0: 6c 75 65 46 72 6f 6d 45 78 70 72 28 70 50 61 72 lueFromExpr(pPar
bcb0: 73 65 2c 20 70 4c 6f 77 65 72 2d 3e 70 45 78 70 se, pLower->pExp
bcc0: 72 2d 3e 70 52 69 67 68 74 2c 20 61 66 66 2c 20 r->pRight, aff,
bcd0: 26 70 31 29 3b 0a 20 20 20 20 6e 4c 6f 77 65 72 &p1);. nLower
bce0: 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 69 66 28 20 = 0;. }. if(
bcf0: 70 55 70 70 65 72 20 26 26 20 72 63 3d 3d 53 51 pUpper && rc==SQ
bd00: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 LITE_OK ){. r
bd10: 63 20 3d 20 73 71 6c 69 74 65 33 53 74 61 74 34 c = sqlite3Stat4
bd20: 56 61 6c 75 65 46 72 6f 6d 45 78 70 72 28 70 50 ValueFromExpr(pP
bd30: 61 72 73 65 2c 20 70 55 70 70 65 72 2d 3e 70 45 arse, pUpper->pE
bd40: 78 70 72 2d 3e 70 52 69 67 68 74 2c 20 61 66 66 xpr->pRight, aff
bd50: 2c 20 26 70 32 29 3b 0a 20 20 20 20 6e 55 70 70 , &p2);. nUpp
bd60: 65 72 20 3d 20 70 32 20 3f 20 30 20 3a 20 70 2d er = p2 ? 0 : p-
bd70: 3e 6e 53 61 6d 70 6c 65 3b 0a 20 20 7d 0a 0a 20 >nSample;. }..
bd80: 20 69 66 28 20 70 31 20 7c 7c 20 70 32 20 29 7b if( p1 || p2 ){
bd90: 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 . int i;.
bda0: 69 6e 74 20 6e 44 69 66 66 3b 0a 20 20 20 20 66 int nDiff;. f
bdb0: 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 or(i=0; rc==SQLI
bdc0: 54 45 5f 4f 4b 20 26 26 20 69 3c 70 2d 3e 6e 53 TE_OK && i<p->nS
bdd0: 61 6d 70 6c 65 3b 20 69 2b 2b 29 7b 0a 20 20 20 ample; i++){.
bde0: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 53 rc = sqlite3S
bdf0: 74 61 74 34 43 6f 6c 75 6d 6e 28 64 62 2c 20 70 tat4Column(db, p
be00: 2d 3e 61 53 61 6d 70 6c 65 5b 69 5d 2e 70 2c 20 ->aSample[i].p,
be10: 70 2d 3e 61 53 61 6d 70 6c 65 5b 69 5d 2e 6e 2c p->aSample[i].n,
be20: 20 6e 45 71 2c 20 26 70 56 61 6c 29 3b 0a 20 20 nEq, &pVal);.
be30: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 if( rc==SQLI
be40: 54 45 5f 4f 4b 20 26 26 20 70 31 20 29 7b 0a 20 TE_OK && p1 ){.
be50: 20 20 20 20 20 20 20 69 6e 74 20 72 65 73 20 3d int res =
be60: 20 73 71 6c 69 74 65 33 4d 65 6d 43 6f 6d 70 61 sqlite3MemCompa
be70: 72 65 28 70 31 2c 20 70 56 61 6c 2c 20 70 43 6f re(p1, pVal, pCo
be80: 6c 6c 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 ll);. if(
be90: 20 72 65 73 3e 3d 30 20 29 20 6e 4c 6f 77 65 72 res>=0 ) nLower
bea0: 2b 2b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ++;. }.
beb0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
bec0: 5f 4f 4b 20 26 26 20 70 32 20 29 7b 0a 20 20 20 _OK && p2 ){.
bed0: 20 20 20 20 20 69 6e 74 20 72 65 73 20 3d 20 73 int res = s
bee0: 71 6c 69 74 65 33 4d 65 6d 43 6f 6d 70 61 72 65 qlite3MemCompare
bef0: 28 70 32 2c 20 70 56 61 6c 2c 20 70 43 6f 6c 6c (p2, pVal, pColl
bf00: 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 );. if( r
bf10: 65 73 3e 3d 30 20 29 20 6e 55 70 70 65 72 2b 2b es>=0 ) nUpper++
bf20: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
bf30: 20 20 20 20 6e 44 69 66 66 20 3d 20 28 6e 55 70 nDiff = (nUp
bf40: 70 65 72 20 2d 20 6e 4c 6f 77 65 72 29 3b 0a 20 per - nLower);.
bf50: 20 20 20 69 66 28 20 6e 44 69 66 66 3c 3d 30 20 if( nDiff<=0
bf60: 29 20 6e 44 69 66 66 20 3d 20 31 3b 0a 0a 20 20 ) nDiff = 1;..
bf70: 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73 /* If there is
bf80: 20 62 6f 74 68 20 61 6e 20 75 70 70 65 72 20 61 both an upper a
bf90: 6e 64 20 6c 6f 77 65 72 20 62 6f 75 6e 64 20 73 nd lower bound s
bfa0: 70 65 63 69 66 69 65 64 2c 20 61 6e 64 20 74 68 pecified, and th
bfb0: 65 20 0a 20 20 20 20 2a 2a 20 63 6f 6d 70 61 72 e . ** compar
bfc0: 69 73 6f 6e 73 20 69 6e 64 69 63 61 74 65 20 74 isons indicate t
bfd0: 68 61 74 20 74 68 65 79 20 61 72 65 20 63 6c 6f hat they are clo
bfe0: 73 65 20 74 6f 67 65 74 68 65 72 2c 20 75 73 65 se together, use
bff0: 20 74 68 65 20 66 61 6c 6c 62 61 63 6b 0a 20 20 the fallback.
c000: 20 20 2a 2a 20 6d 65 74 68 6f 64 20 28 61 73 73 ** method (ass
c010: 75 6d 65 20 74 68 61 74 20 74 68 65 20 73 63 61 ume that the sca
c020: 6e 20 76 69 73 69 74 73 20 31 2f 36 34 20 6f 66 n visits 1/64 of
c030: 20 74 68 65 20 72 6f 77 73 29 20 66 6f 72 20 65 the rows) for e
c040: 73 74 69 6d 61 74 69 6e 67 0a 20 20 20 20 2a 2a stimating. **
c050: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 the number of r
c060: 6f 77 73 20 76 69 73 69 74 65 64 2e 20 4f 74 68 ows visited. Oth
c070: 65 72 77 69 73 65 2c 20 65 73 74 69 6d 61 74 65 erwise, estimate
c080: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 the number of r
c090: 6f 77 73 0a 20 20 20 20 2a 2a 20 75 73 69 6e 67 ows. ** using
c0a0: 20 74 68 65 20 6d 65 74 68 6f 64 20 64 65 73 63 the method desc
c0b0: 72 69 62 65 64 20 69 6e 20 74 68 65 20 68 65 61 ribed in the hea
c0c0: 64 65 72 20 63 6f 6d 6d 65 6e 74 20 66 6f 72 20 der comment for
c0d0: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 2e 20 2a this function. *
c0e0: 2f 0a 20 20 20 20 69 66 28 20 6e 44 69 66 66 21 /. if( nDiff!
c0f0: 3d 31 20 7c 7c 20 70 55 70 70 65 72 3d 3d 30 20 =1 || pUpper==0
c100: 7c 7c 20 70 4c 6f 77 65 72 3d 3d 30 20 29 7b 0a || pLower==0 ){.
c110: 20 20 20 20 20 20 69 6e 74 20 6e 41 64 6a 75 73 int nAdjus
c120: 74 20 3d 20 28 73 71 6c 69 74 65 33 4c 6f 67 45 t = (sqlite3LogE
c130: 73 74 28 70 2d 3e 6e 53 61 6d 70 6c 65 29 20 2d st(p->nSample) -
c140: 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 28 6e sqlite3LogEst(n
c150: 44 69 66 66 29 29 3b 0a 20 20 20 20 20 20 70 4c Diff));. pL
c160: 6f 6f 70 2d 3e 6e 4f 75 74 20 2d 3d 20 6e 41 64 oop->nOut -= nAd
c170: 6a 75 73 74 3b 0a 20 20 20 20 20 20 2a 70 62 44 just;. *pbD
c180: 6f 6e 65 20 3d 20 31 3b 0a 20 20 20 20 20 20 57 one = 1;. W
c190: 48 45 52 45 54 52 41 43 45 28 30 78 31 30 2c 20 HERETRACE(0x10,
c1a0: 28 22 72 61 6e 67 65 20 73 6b 69 70 2d 73 63 61 ("range skip-sca
c1b0: 6e 20 72 65 67 69 6f 6e 73 3a 20 25 75 2e 2e 25 n regions: %u..%
c1c0: 75 20 20 61 64 6a 75 73 74 3d 25 64 20 65 73 74 u adjust=%d est
c1d0: 3d 25 64 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 =%d\n",.
c1e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c1f0: 20 20 20 6e 4c 6f 77 65 72 2c 20 6e 55 70 70 65 nLower, nUppe
c200: 72 2c 20 6e 41 64 6a 75 73 74 2a 2d 31 2c 20 70 r, nAdjust*-1, p
c210: 4c 6f 6f 70 2d 3e 6e 4f 75 74 29 29 3b 0a 20 20 Loop->nOut));.
c220: 20 20 7d 0a 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 }.. }else{.
c230: 20 20 61 73 73 65 72 74 28 20 2a 70 62 44 6f 6e assert( *pbDon
c240: 65 3d 3d 30 20 29 3b 0a 20 20 7d 0a 0a 20 20 73 e==0 );. }.. s
c250: 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 qlite3ValueFree(
c260: 70 31 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 61 p1);. sqlite3Va
c270: 6c 75 65 46 72 65 65 28 70 32 29 3b 0a 20 20 73 lueFree(p2);. s
c280: 71 6c 69 74 65 33 56 61 6c 75 65 46 72 65 65 28 qlite3ValueFree(
c290: 70 56 61 6c 29 3b 0a 0a 20 20 72 65 74 75 72 6e pVal);.. return
c2a0: 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a rc;.}.#endif /*
c2b0: 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 SQLITE_ENABLE_S
c2c0: 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 20 2a 2f TAT3_OR_STAT4 */
c2d0: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e ../*.** This fun
c2e0: 63 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f ction is used to
c2f0: 20 65 73 74 69 6d 61 74 65 20 74 68 65 20 6e 75 estimate the nu
c300: 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 74 68 61 mber of rows tha
c310: 74 20 77 69 6c 6c 20 62 65 20 76 69 73 69 74 65 t will be visite
c320: 64 0a 2a 2a 20 62 79 20 73 63 61 6e 6e 69 6e 67 d.** by scanning
c330: 20 61 6e 20 69 6e 64 65 78 20 66 6f 72 20 61 20 an index for a
c340: 72 61 6e 67 65 20 6f 66 20 76 61 6c 75 65 73 2e range of values.
c350: 20 54 68 65 20 72 61 6e 67 65 20 6d 61 79 20 68 The range may h
c360: 61 76 65 20 61 6e 20 75 70 70 65 72 0a 2a 2a 20 ave an upper.**
c370: 62 6f 75 6e 64 2c 20 61 20 6c 6f 77 65 72 20 62 bound, a lower b
c380: 6f 75 6e 64 2c 20 6f 72 20 62 6f 74 68 2e 20 54 ound, or both. T
c390: 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 he WHERE clause
c3a0: 74 65 72 6d 73 20 74 68 61 74 20 73 65 74 20 74 terms that set t
c3b0: 68 65 20 75 70 70 65 72 0a 2a 2a 20 61 6e 64 20 he upper.** and
c3c0: 6c 6f 77 65 72 20 62 6f 75 6e 64 73 20 61 72 65 lower bounds are
c3d0: 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 20 represented by
c3e0: 70 4c 6f 77 65 72 20 61 6e 64 20 70 55 70 70 65 pLower and pUppe
c3f0: 72 20 72 65 73 70 65 63 74 69 76 65 6c 79 2e 20 r respectively.
c400: 46 6f 72 0a 2a 2a 20 65 78 61 6d 70 6c 65 2c 20 For.** example,
c410: 61 73 73 75 6d 69 6e 67 20 74 68 61 74 20 69 6e assuming that in
c420: 64 65 78 20 70 20 69 73 20 6f 6e 20 74 31 28 61 dex p is on t1(a
c430: 29 3a 0a 2a 2a 0a 2a 2a 20 20 20 2e 2e 2e 20 46 ):.**.** ... F
c440: 52 4f 4d 20 74 31 20 57 48 45 52 45 20 61 20 3e ROM t1 WHERE a >
c450: 20 3f 20 41 4e 44 20 61 20 3c 20 3f 20 2e 2e 2e ? AND a < ? ...
c460: 0a 2a 2a 20 20 20 20 20 20 20 20 20 20 20 20 20 .**
c470: 20 20 20 20 20 20 20 7c 5f 5f 5f 5f 5f 7c 20 20 |_____|
c480: 20 7c 5f 5f 5f 5f 5f 7c 0a 2a 2a 20 20 20 20 20 |_____|.**
c490: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c4a0: 20 20 7c 20 20 20 20 20 20 20 20 20 7c 0a 2a 2a | |.**
c4b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
c4c0: 20 20 20 20 20 70 4c 6f 77 65 72 20 20 20 20 70 pLower p
c4d0: 55 70 70 65 72 0a 2a 2a 0a 2a 2a 20 49 66 20 65 Upper.**.** If e
c4e0: 69 74 68 65 72 20 6f 66 20 74 68 65 20 75 70 70 ither of the upp
c4f0: 65 72 20 6f 72 20 6c 6f 77 65 72 20 62 6f 75 6e er or lower boun
c500: 64 20 69 73 20 6e 6f 74 20 70 72 65 73 65 6e 74 d is not present
c510: 2c 20 74 68 65 6e 20 4e 55 4c 4c 20 69 73 20 70 , then NULL is p
c520: 61 73 73 65 64 20 69 6e 0a 2a 2a 20 70 6c 61 63 assed in.** plac
c530: 65 20 6f 66 20 74 68 65 20 63 6f 72 72 65 73 70 e of the corresp
c540: 6f 6e 64 69 6e 67 20 57 68 65 72 65 54 65 72 6d onding WhereTerm
c550: 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 76 61 6c 75 ..**.** The valu
c560: 65 20 69 6e 20 28 70 42 75 69 6c 64 65 72 2d 3e e in (pBuilder->
c570: 70 4e 65 77 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 pNew->u.btree.nE
c580: 71 29 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 q) is the number
c590: 20 6f 66 20 74 68 65 20 69 6e 64 65 78 0a 2a 2a of the index.**
c5a0: 20 63 6f 6c 75 6d 6e 20 73 75 62 6a 65 63 74 20 column subject
c5b0: 74 6f 20 74 68 65 20 72 61 6e 67 65 20 63 6f 6e to the range con
c5c0: 73 74 72 61 69 6e 74 2e 20 4f 72 2c 20 65 71 75 straint. Or, equ
c5d0: 69 76 61 6c 65 6e 74 6c 79 2c 20 74 68 65 20 6e ivalently, the n
c5e0: 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 65 71 75 61 umber of.** equa
c5f0: 6c 69 74 79 20 63 6f 6e 73 74 72 61 69 6e 74 73 lity constraints
c600: 20 6f 70 74 69 6d 69 7a 65 64 20 62 79 20 74 68 optimized by th
c610: 65 20 70 72 6f 70 6f 73 65 64 20 69 6e 64 65 78 e proposed index
c620: 20 73 63 61 6e 2e 20 46 6f 72 20 65 78 61 6d 70 scan. For examp
c630: 6c 65 2c 0a 2a 2a 20 61 73 73 75 6d 69 6e 67 20 le,.** assuming
c640: 69 6e 64 65 78 20 70 20 69 73 20 6f 6e 20 74 31 index p is on t1
c650: 28 61 2c 20 62 29 2c 20 61 6e 64 20 74 68 65 20 (a, b), and the
c660: 53 51 4c 20 71 75 65 72 79 20 69 73 3a 0a 2a 2a SQL query is:.**
c670: 0a 2a 2a 20 20 20 2e 2e 2e 20 46 52 4f 4d 20 74 .** ... FROM t
c680: 31 20 57 48 45 52 45 20 61 20 3d 20 3f 20 41 4e 1 WHERE a = ? AN
c690: 44 20 62 20 3e 20 3f 20 41 4e 44 20 62 20 3c 20 D b > ? AND b <
c6a0: 3f 20 2e 2e 2e 0a 2a 2a 0a 2a 2a 20 74 68 65 6e ? ....**.** then
c6b0: 20 6e 45 71 20 69 73 20 73 65 74 20 74 6f 20 31 nEq is set to 1
c6c0: 20 28 61 73 20 74 68 65 20 72 61 6e 67 65 20 72 (as the range r
c6d0: 65 73 74 72 69 63 74 65 64 20 63 6f 6c 75 6d 6e estricted column
c6e0: 2c 20 62 2c 20 69 73 20 74 68 65 20 73 65 63 6f , b, is the seco
c6f0: 6e 64 20 0a 2a 2a 20 6c 65 66 74 2d 6d 6f 73 74 nd .** left-most
c700: 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 69 column of the i
c710: 6e 64 65 78 29 2e 20 4f 72 2c 20 69 66 20 74 68 ndex). Or, if th
c720: 65 20 71 75 65 72 79 20 69 73 3a 0a 2a 2a 0a 2a e query is:.**.*
c730: 2a 20 20 20 2e 2e 2e 20 46 52 4f 4d 20 74 31 20 * ... FROM t1
c740: 57 48 45 52 45 20 61 20 3e 20 3f 20 41 4e 44 20 WHERE a > ? AND
c750: 61 20 3c 20 3f 20 2e 2e 2e 0a 2a 2a 0a 2a 2a 20 a < ? ....**.**
c760: 74 68 65 6e 20 6e 45 71 20 69 73 20 73 65 74 20 then nEq is set
c770: 74 6f 20 30 2e 0a 2a 2a 0a 2a 2a 20 57 68 65 6e to 0..**.** When
c780: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 this function i
c790: 73 20 63 61 6c 6c 65 64 2c 20 2a 70 6e 4f 75 74 s called, *pnOut
c7a0: 20 69 73 20 73 65 74 20 74 6f 20 74 68 65 20 73 is set to the s
c7b0: 71 6c 69 74 65 33 4c 6f 67 45 73 74 28 29 20 6f qlite3LogEst() o
c7c0: 66 20 74 68 65 0a 2a 2a 20 6e 75 6d 62 65 72 20 f the.** number
c7d0: 6f 66 20 72 6f 77 73 20 74 68 61 74 20 74 68 65 of rows that the
c7e0: 20 69 6e 64 65 78 20 73 63 61 6e 20 69 73 20 65 index scan is e
c7f0: 78 70 65 63 74 65 64 20 74 6f 20 76 69 73 69 74 xpected to visit
c800: 20 77 69 74 68 6f 75 74 20 0a 2a 2a 20 63 6f 6e without .** con
c810: 73 69 64 65 72 69 6e 67 20 74 68 65 20 72 61 6e sidering the ran
c820: 67 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 2e 20 ge constraints.
c830: 49 66 20 6e 45 71 20 69 73 20 30 2c 20 74 68 65 If nEq is 0, the
c840: 6e 20 2a 70 6e 4f 75 74 20 69 73 20 74 68 65 20 n *pnOut is the
c850: 6e 75 6d 62 65 72 20 6f 66 20 0a 2a 2a 20 72 6f number of .** ro
c860: 77 73 20 69 6e 20 74 68 65 20 69 6e 64 65 78 2e ws in the index.
c870: 20 41 73 73 75 6d 69 6e 67 20 6e 6f 20 65 72 72 Assuming no err
c880: 6f 72 20 6f 63 63 75 72 73 2c 20 2a 70 6e 4f 75 or occurs, *pnOu
c890: 74 20 69 73 20 61 64 6a 75 73 74 65 64 20 28 72 t is adjusted (r
c8a0: 65 64 75 63 65 64 29 0a 2a 2a 20 74 6f 20 61 63 educed).** to ac
c8b0: 63 6f 75 6e 74 20 66 6f 72 20 74 68 65 20 72 61 count for the ra
c8c0: 6e 67 65 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 nge constraints
c8d0: 70 4c 6f 77 65 72 20 61 6e 64 20 70 55 70 70 65 pLower and pUppe
c8e0: 72 2e 0a 2a 2a 20 0a 2a 2a 20 49 6e 20 74 68 65 r..** .** In the
c8f0: 20 61 62 73 65 6e 63 65 20 6f 66 20 73 71 6c 69 absence of sqli
c900: 74 65 5f 73 74 61 74 34 20 41 4e 41 4c 59 5a 45 te_stat4 ANALYZE
c910: 20 64 61 74 61 2c 20 6f 72 20 69 66 20 73 75 63 data, or if suc
c920: 68 20 64 61 74 61 20 63 61 6e 6e 6f 74 20 62 65 h data cannot be
c930: 0a 2a 2a 20 75 73 65 64 2c 20 61 20 73 69 6e 67 .** used, a sing
c940: 6c 65 20 72 61 6e 67 65 20 69 6e 65 71 75 61 6c le range inequal
c950: 69 74 79 20 72 65 64 75 63 65 73 20 74 68 65 20 ity reduces the
c960: 73 65 61 72 63 68 20 73 70 61 63 65 20 62 79 20 search space by
c970: 61 20 66 61 63 74 6f 72 20 6f 66 20 34 2e 20 0a a factor of 4. .
c980: 2a 2a 20 61 6e 64 20 61 20 70 61 69 72 20 6f 66 ** and a pair of
c990: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 28 78 3e constraints (x>
c9a0: 3f 20 41 4e 44 20 78 3c 3f 29 20 72 65 64 75 63 ? AND x<?) reduc
c9b0: 65 73 20 74 68 65 20 65 78 70 65 63 74 65 64 20 es the expected
c9c0: 6e 75 6d 62 65 72 20 6f 66 0a 2a 2a 20 72 6f 77 number of.** row
c9d0: 73 20 76 69 73 69 74 65 64 20 62 79 20 61 20 66 s visited by a f
c9e0: 61 63 74 6f 72 20 6f 66 20 36 34 2e 0a 2a 2f 0a actor of 64..*/.
c9f0: 73 74 61 74 69 63 20 69 6e 74 20 77 68 65 72 65 static int where
ca00: 52 61 6e 67 65 53 63 61 6e 45 73 74 28 0a 20 20 RangeScanEst(.
ca10: 50 61 72 73 65 20 2a 70 50 61 72 73 65 2c 20 20 Parse *pParse,
ca20: 20 20 20 20 20 2f 2a 20 50 61 72 73 69 6e 67 20 /* Parsing
ca30: 26 20 63 6f 64 65 20 67 65 6e 65 72 61 74 69 6e & code generatin
ca40: 67 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 57 g context */. W
ca50: 68 65 72 65 4c 6f 6f 70 42 75 69 6c 64 65 72 20 hereLoopBuilder
ca60: 2a 70 42 75 69 6c 64 65 72 2c 0a 20 20 57 68 65 *pBuilder,. Whe
ca70: 72 65 54 65 72 6d 20 2a 70 4c 6f 77 65 72 2c 20 reTerm *pLower,
ca80: 20 20 2f 2a 20 4c 6f 77 65 72 20 62 6f 75 6e 64 /* Lower bound
ca90: 20 6f 6e 20 74 68 65 20 72 61 6e 67 65 2e 20 65 on the range. e
caa0: 78 3a 20 22 78 3e 31 32 33 22 20 4d 69 67 68 74 x: "x>123" Might
cab0: 20 62 65 20 4e 55 4c 4c 20 2a 2f 0a 20 20 57 68 be NULL */. Wh
cac0: 65 72 65 54 65 72 6d 20 2a 70 55 70 70 65 72 2c ereTerm *pUpper,
cad0: 20 20 20 2f 2a 20 55 70 70 65 72 20 62 6f 75 6e /* Upper boun
cae0: 64 20 6f 6e 20 74 68 65 20 72 61 6e 67 65 2e 20 d on the range.
caf0: 65 78 3a 20 22 78 3c 34 35 35 22 20 4d 69 67 68 ex: "x<455" Migh
cb00: 74 20 62 65 20 4e 55 4c 4c 20 2a 2f 0a 20 20 57 t be NULL */. W
cb10: 68 65 72 65 4c 6f 6f 70 20 2a 70 4c 6f 6f 70 20 hereLoop *pLoop
cb20: 20 20 20 20 2f 2a 20 4d 6f 64 69 66 79 20 74 68 /* Modify th
cb30: 65 20 2e 6e 4f 75 74 20 61 6e 64 20 6d 61 79 62 e .nOut and mayb
cb40: 65 20 2e 72 52 75 6e 20 66 69 65 6c 64 73 20 2a e .rRun fields *
cb50: 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 /.){. int rc =
cb60: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74 SQLITE_OK;. int
cb70: 20 6e 4f 75 74 20 3d 20 70 4c 6f 6f 70 2d 3e 6e nOut = pLoop->n
cb80: 4f 75 74 3b 0a 20 20 4c 6f 67 45 73 74 20 6e 4e Out;. LogEst nN
cb90: 65 77 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 ew;..#ifdef SQLI
cba0: 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f TE_ENABLE_STAT3_
cbb0: 4f 52 5f 53 54 41 54 34 0a 20 20 49 6e 64 65 78 OR_STAT4. Index
cbc0: 20 2a 70 20 3d 20 70 4c 6f 6f 70 2d 3e 75 2e 62 *p = pLoop->u.b
cbd0: 74 72 65 65 2e 70 49 6e 64 65 78 3b 0a 20 20 69 tree.pIndex;. i
cbe0: 6e 74 20 6e 45 71 20 3d 20 70 4c 6f 6f 70 2d 3e nt nEq = pLoop->
cbf0: 75 2e 62 74 72 65 65 2e 6e 45 71 3b 0a 0a 20 20 u.btree.nEq;..
cc00: 69 66 28 20 70 2d 3e 6e 53 61 6d 70 6c 65 3e 30 if( p->nSample>0
cc10: 20 26 26 20 6e 45 71 3c 70 2d 3e 6e 53 61 6d 70 && nEq<p->nSamp
cc20: 6c 65 43 6f 6c 20 29 7b 0a 20 20 20 20 69 66 28 leCol ){. if(
cc30: 20 6e 45 71 3d 3d 70 42 75 69 6c 64 65 72 2d 3e nEq==pBuilder->
cc40: 6e 52 65 63 56 61 6c 69 64 20 29 7b 0a 20 20 20 nRecValid ){.
cc50: 20 20 20 55 6e 70 61 63 6b 65 64 52 65 63 6f 72 UnpackedRecor
cc60: 64 20 2a 70 52 65 63 20 3d 20 70 42 75 69 6c 64 d *pRec = pBuild
cc70: 65 72 2d 3e 70 52 65 63 3b 0a 20 20 20 20 20 20 er->pRec;.
cc80: 74 52 6f 77 63 6e 74 20 61 5b 32 5d 3b 0a 20 20 tRowcnt a[2];.
cc90: 20 20 20 20 69 6e 74 20 6e 42 74 6d 20 3d 20 70 int nBtm = p
cca0: 4c 6f 6f 70 2d 3e 75 2e 62 74 72 65 65 2e 6e 42 Loop->u.btree.nB
ccb0: 74 6d 3b 0a 20 20 20 20 20 20 69 6e 74 20 6e 54 tm;. int nT
ccc0: 6f 70 20 3d 20 70 4c 6f 6f 70 2d 3e 75 2e 62 74 op = pLoop->u.bt
ccd0: 72 65 65 2e 6e 54 6f 70 3b 0a 0a 20 20 20 20 20 ree.nTop;..
cce0: 20 2f 2a 20 56 61 72 69 61 62 6c 65 20 69 4c 6f /* Variable iLo
ccf0: 77 65 72 20 77 69 6c 6c 20 62 65 20 73 65 74 20 wer will be set
cd00: 74 6f 20 74 68 65 20 65 73 74 69 6d 61 74 65 20 to the estimate
cd10: 6f 66 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 of the number of
cd20: 20 72 6f 77 73 20 69 6e 20 0a 20 20 20 20 20 20 rows in .
cd30: 2a 2a 20 74 68 65 20 69 6e 64 65 78 20 74 68 61 ** the index tha
cd40: 74 20 61 72 65 20 6c 65 73 73 20 74 68 61 6e 20 t are less than
cd50: 74 68 65 20 6c 6f 77 65 72 20 62 6f 75 6e 64 20 the lower bound
cd60: 6f 66 20 74 68 65 20 72 61 6e 67 65 20 71 75 65 of the range que
cd70: 72 79 2e 20 54 68 65 0a 20 20 20 20 20 20 2a 2a ry. The. **
cd80: 20 6c 6f 77 65 72 20 62 6f 75 6e 64 20 62 65 69 lower bound bei
cd90: 6e 67 20 74 68 65 20 63 6f 6e 63 61 74 65 6e 61 ng the concatena
cda0: 74 69 6f 6e 20 6f 66 20 24 50 20 61 6e 64 20 24 tion of $P and $
cdb0: 4c 2c 20 77 68 65 72 65 20 24 50 20 69 73 20 74 L, where $P is t
cdc0: 68 65 0a 20 20 20 20 20 20 2a 2a 20 6b 65 79 2d he. ** key-
cdd0: 70 72 65 66 69 78 20 66 6f 72 6d 65 64 20 62 79 prefix formed by
cde0: 20 74 68 65 20 6e 45 71 20 76 61 6c 75 65 73 20 the nEq values
cdf0: 6d 61 74 63 68 65 64 20 61 67 61 69 6e 73 74 20 matched against
ce00: 74 68 65 20 6e 45 71 20 6c 65 66 74 2d 6d 6f 73 the nEq left-mos
ce10: 74 0a 20 20 20 20 20 20 2a 2a 20 63 6f 6c 75 6d t. ** colum
ce20: 6e 73 20 6f 66 20 74 68 65 20 69 6e 64 65 78 2c ns of the index,
ce30: 20 61 6e 64 20 24 4c 20 69 73 20 74 68 65 20 76 and $L is the v
ce40: 61 6c 75 65 20 69 6e 20 70 4c 6f 77 65 72 2e 0a alue in pLower..
ce50: 20 20 20 20 20 20 2a 2a 0a 20 20 20 20 20 20 2a **. *
ce60: 2a 20 4f 72 2c 20 69 66 20 70 4c 6f 77 65 72 20 * Or, if pLower
ce70: 69 73 20 4e 55 4c 4c 20 6f 72 20 24 4c 20 63 61 is NULL or $L ca
ce80: 6e 6e 6f 74 20 62 65 20 65 78 74 72 61 63 74 65 nnot be extracte
ce90: 64 20 66 72 6f 6d 20 69 74 20 28 62 65 63 61 75 d from it (becau
cea0: 73 65 20 69 74 0a 20 20 20 20 20 20 2a 2a 20 69 se it. ** i
ceb0: 73 20 6e 6f 74 20 61 20 73 69 6d 70 6c 65 20 76 s not a simple v
cec0: 61 72 69 61 62 6c 65 20 6f 72 20 6c 69 74 65 72 ariable or liter
ced0: 61 6c 20 76 61 6c 75 65 29 2c 20 74 68 65 20 6c al value), the l
cee0: 6f 77 65 72 20 62 6f 75 6e 64 20 6f 66 20 74 68 ower bound of th
cef0: 65 0a 20 20 20 20 20 20 2a 2a 20 72 61 6e 67 65 e. ** range
cf00: 20 69 73 20 24 50 2e 20 44 75 65 20 74 6f 20 61 is $P. Due to a
cf10: 20 71 75 69 72 6b 20 69 6e 20 74 68 65 20 77 61 quirk in the wa
cf20: 79 20 77 68 65 72 65 4b 65 79 53 74 61 74 73 28 y whereKeyStats(
cf30: 29 20 77 6f 72 6b 73 2c 20 65 76 65 6e 0a 20 20 ) works, even.
cf40: 20 20 20 20 2a 2a 20 69 66 20 24 4c 20 69 73 20 ** if $L is
cf50: 61 76 61 69 6c 61 62 6c 65 2c 20 77 68 65 72 65 available, where
cf60: 4b 65 79 53 74 61 74 73 28 29 20 69 73 20 63 61 KeyStats() is ca
cf70: 6c 6c 65 64 20 66 6f 72 20 62 6f 74 68 20 28 24 lled for both ($
cf80: 50 29 20 61 6e 64 20 0a 20 20 20 20 20 20 2a 2a P) and . **
cf90: 20 28 24 50 3a 24 4c 29 20 61 6e 64 20 74 68 65 ($P:$L) and the
cfa0: 20 6c 61 72 67 65 72 20 6f 66 20 74 68 65 20 74 larger of the t
cfb0: 77 6f 20 72 65 74 75 72 6e 65 64 20 76 61 6c 75 wo returned valu
cfc0: 65 73 20 69 73 20 75 73 65 64 2e 0a 20 20 20 20 es is used..
cfd0: 20 20 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 53 69 **. ** Si
cfe0: 6d 69 6c 61 72 6c 79 2c 20 69 55 70 70 65 72 20 milarly, iUpper
cff0: 69 73 20 74 6f 20 62 65 20 73 65 74 20 74 6f 20 is to be set to
d000: 74 68 65 20 65 73 74 69 6d 61 74 65 20 6f 66 20 the estimate of
d010: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f the number of ro
d020: 77 73 0a 20 20 20 20 20 20 2a 2a 20 6c 65 73 73 ws. ** less
d030: 20 74 68 61 6e 20 74 68 65 20 75 70 70 65 72 20 than the upper
d040: 62 6f 75 6e 64 20 6f 66 20 74 68 65 20 72 61 6e bound of the ran
d050: 67 65 20 71 75 65 72 79 2e 20 57 68 65 72 65 20 ge query. Where
d060: 74 68 65 20 75 70 70 65 72 20 62 6f 75 6e 64 0a the upper bound.
d070: 20 20 20 20 20 20 2a 2a 20 69 73 20 65 69 74 68 ** is eith
d080: 65 72 20 28 24 50 29 20 6f 72 20 28 24 50 3a 24 er ($P) or ($P:$
d090: 55 29 2e 20 41 67 61 69 6e 2c 20 65 76 65 6e 20 U). Again, even
d0a0: 69 66 20 24 55 20 69 73 20 61 76 61 69 6c 61 62 if $U is availab
d0b0: 6c 65 2c 20 62 6f 74 68 20 76 61 6c 75 65 73 0a le, both values.
d0c0: 20 20 20 20 20 20 2a 2a 20 6f 66 20 69 55 70 70 ** of iUpp
d0d0: 65 72 20 61 72 65 20 72 65 71 75 65 73 74 65 64 er are requested
d0e0: 20 6f 66 20 77 68 65 72 65 4b 65 79 53 74 61 74 of whereKeyStat
d0f0: 73 28 29 20 61 6e 64 20 74 68 65 20 73 6d 61 6c s() and the smal
d100: 6c 65 72 20 75 73 65 64 2e 0a 20 20 20 20 20 20 ler used..
d110: 2a 2a 0a 20 20 20 20 20 20 2a 2a 20 54 68 65 20 **. ** The
d120: 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 62 number of rows b
d130: 65 74 77 65 65 6e 20 74 68 65 20 74 77 6f 20 62 etween the two b
d140: 6f 75 6e 64 73 20 69 73 20 74 68 65 6e 20 6a 75 ounds is then ju
d150: 73 74 20 69 55 70 70 65 72 2d 69 4c 6f 77 65 72 st iUpper-iLower
d160: 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 .. */.
d170: 20 74 52 6f 77 63 6e 74 20 69 4c 6f 77 65 72 3b tRowcnt iLower;
d180: 20 20 20 20 20 2f 2a 20 52 6f 77 73 20 6c 65 73 /* Rows les
d190: 73 20 74 68 61 6e 20 74 68 65 20 6c 6f 77 65 72 s than the lower
d1a0: 20 62 6f 75 6e 64 20 2a 2f 0a 20 20 20 20 20 20 bound */.
d1b0: 74 52 6f 77 63 6e 74 20 69 55 70 70 65 72 3b 20 tRowcnt iUpper;
d1c0: 20 20 20 20 2f 2a 20 52 6f 77 73 20 6c 65 73 73 /* Rows less
d1d0: 20 74 68 61 6e 20 74 68 65 20 75 70 70 65 72 20 than the upper
d1e0: 62 6f 75 6e 64 20 2a 2f 0a 20 20 20 20 20 20 69 bound */. i
d1f0: 6e 74 20 69 4c 77 72 49 64 78 20 3d 20 2d 32 3b nt iLwrIdx = -2;
d200: 20 20 20 2f 2a 20 61 53 61 6d 70 6c 65 5b 5d 20 /* aSample[]
d210: 66 6f 72 20 74 68 65 20 6c 6f 77 65 72 20 62 6f for the lower bo
d220: 75 6e 64 20 2a 2f 0a 20 20 20 20 20 20 69 6e 74 und */. int
d230: 20 69 55 70 72 49 64 78 20 3d 20 2d 31 3b 20 20 iUprIdx = -1;
d240: 20 2f 2a 20 61 53 61 6d 70 6c 65 5b 5d 20 66 6f /* aSample[] fo
d250: 72 20 74 68 65 20 75 70 70 65 72 20 62 6f 75 6e r the upper boun
d260: 64 20 2a 2f 0a 0a 20 20 20 20 20 20 69 66 28 20 d */.. if(
d270: 70 52 65 63 20 29 7b 0a 20 20 20 20 20 20 20 20 pRec ){.
d280: 74 65 73 74 63 61 73 65 28 20 70 52 65 63 2d 3e testcase( pRec->
d290: 6e 46 69 65 6c 64 21 3d 70 42 75 69 6c 64 65 72 nField!=pBuilder
d2a0: 2d 3e 6e 52 65 63 56 61 6c 69 64 20 29 3b 0a 20 ->nRecValid );.
d2b0: 20 20 20 20 20 20 20 70 52 65 63 2d 3e 6e 46 69 pRec->nFi
d2c0: 65 6c 64 20 3d 20 70 42 75 69 6c 64 65 72 2d 3e eld = pBuilder->
d2d0: 6e 52 65 63 56 61 6c 69 64 3b 0a 20 20 20 20 20 nRecValid;.
d2e0: 20 7d 0a 20 20 20 20 20 20 2f 2a 20 44 65 74 65 }. /* Dete
d2f0: 72 6d 69 6e 65 20 69 4c 6f 77 65 72 20 61 6e 64 rmine iLower and
d300: 20 69 55 70 70 65 72 20 75 73 69 6e 67 20 28 24 iUpper using ($
d310: 50 29 20 6f 6e 6c 79 2e 20 2a 2f 0a 20 20 20 20 P) only. */.
d320: 20 20 69 66 28 20 6e 45 71 3d 3d 30 20 29 7b 0a if( nEq==0 ){.
d330: 20 20 20 20 20 20 20 20 69 4c 6f 77 65 72 20 3d iLower =
d340: 20 30 3b 0a 20 20 20 20 20 20 20 20 69 55 70 70 0;. iUpp
d350: 65 72 20 3d 20 70 2d 3e 6e 52 6f 77 45 73 74 30 er = p->nRowEst0
d360: 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 ;. }else{.
d370: 20 20 20 20 20 20 20 2f 2a 20 4e 6f 74 65 3a 20 /* Note:
d380: 74 68 69 73 20 63 61 6c 6c 20 63 6f 75 6c 64 20 this call could
d390: 62 65 20 6f 70 74 69 6d 69 7a 65 64 20 61 77 61 be optimized awa
d3a0: 79 20 2d 20 73 69 6e 63 65 20 74 68 65 20 73 61 y - since the sa
d3b0: 6d 65 20 76 61 6c 75 65 73 20 6d 75 73 74 20 0a me values must .
d3c0: 20 20 20 20 20 20 20 20 2a 2a 20 68 61 76 65 20 ** have
d3d0: 62 65 65 6e 20 72 65 71 75 65 73 74 65 64 20 77 been requested w
d3e0: 68 65 6e 20 74 65 73 74 69 6e 67 20 6b 65 79 20 hen testing key
d3f0: 24 50 20 69 6e 20 77 68 65 72 65 45 71 75 61 6c $P in whereEqual
d400: 53 63 61 6e 45 73 74 28 29 2e 20 20 2a 2f 0a 20 ScanEst(). */.
d410: 20 20 20 20 20 20 20 77 68 65 72 65 4b 65 79 53 whereKeyS
d420: 74 61 74 73 28 70 50 61 72 73 65 2c 20 70 2c 20 tats(pParse, p,
d430: 70 52 65 63 2c 20 30 2c 20 61 29 3b 0a 20 20 20 pRec, 0, a);.
d440: 20 20 20 20 20 69 4c 6f 77 65 72 20 3d 20 61 5b iLower = a[
d450: 30 5d 3b 0a 20 20 20 20 20 20 20 20 69 55 70 70 0];. iUpp
d460: 65 72 20 3d 20 61 5b 30 5d 20 2b 20 61 5b 31 5d er = a[0] + a[1]
d470: 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 ;. }..
d480: 20 61 73 73 65 72 74 28 20 70 4c 6f 77 65 72 3d assert( pLower=
d490: 3d 30 20 7c 7c 20 28 70 4c 6f 77 65 72 2d 3e 65 =0 || (pLower->e
d4a0: 4f 70 65 72 61 74 6f 72 20 26 20 28 57 4f 5f 47 Operator & (WO_G
d4b0: 54 7c 57 4f 5f 47 45 29 29 21 3d 30 20 29 3b 0a T|WO_GE))!=0 );.
d4c0: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 70 55 assert( pU
d4d0: 70 70 65 72 3d 3d 30 20 7c 7c 20 28 70 55 70 70 pper==0 || (pUpp
d4e0: 65 72 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 er->eOperator &
d4f0: 28 57 4f 5f 4c 54 7c 57 4f 5f 4c 45 29 29 21 3d (WO_LT|WO_LE))!=
d500: 30 20 29 3b 0a 20 20 20 20 20 20 61 73 73 65 72 0 );. asser
d510: 74 28 20 70 2d 3e 61 53 6f 72 74 4f 72 64 65 72 t( p->aSortOrder
d520: 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 69 66 28 !=0 );. if(
d530: 20 70 2d 3e 61 53 6f 72 74 4f 72 64 65 72 5b 6e p->aSortOrder[n
d540: 45 71 5d 20 29 7b 0a 20 20 20 20 20 20 20 20 2f Eq] ){. /
d550: 2a 20 54 68 65 20 72 6f 6c 65 73 20 6f 66 20 70 * The roles of p
d560: 4c 6f 77 65 72 20 61 6e 64 20 70 55 70 70 65 72 Lower and pUpper
d570: 20 61 72 65 20 73 77 61 70 70 65 64 20 66 6f 72 are swapped for
d580: 20 61 20 44 45 53 43 20 69 6e 64 65 78 20 2a 2f a DESC index */
d590: 0a 20 20 20 20 20 20 20 20 53 57 41 50 28 57 68 . SWAP(Wh
d5a0: 65 72 65 54 65 72 6d 2a 2c 20 70 4c 6f 77 65 72 ereTerm*, pLower
d5b0: 2c 20 70 55 70 70 65 72 29 3b 0a 20 20 20 20 20 , pUpper);.
d5c0: 20 20 20 53 57 41 50 28 69 6e 74 2c 20 6e 42 74 SWAP(int, nBt
d5d0: 6d 2c 20 6e 54 6f 70 29 3b 0a 20 20 20 20 20 20 m, nTop);.
d5e0: 7d 0a 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 70 }.. /* If p
d5f0: 6f 73 73 69 62 6c 65 2c 20 69 6d 70 72 6f 76 65 ossible, improve
d600: 20 6f 6e 20 74 68 65 20 69 4c 6f 77 65 72 20 65 on the iLower e
d610: 73 74 69 6d 61 74 65 20 75 73 69 6e 67 20 28 24 stimate using ($
d620: 50 3a 24 4c 29 2e 20 2a 2f 0a 20 20 20 20 20 20 P:$L). */.
d630: 69 66 28 20 70 4c 6f 77 65 72 20 29 7b 0a 20 20 if( pLower ){.
d640: 20 20 20 20 20 20 69 6e 74 20 6e 3b 20 20 20 20 int n;
d650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
d660: 2f 2a 20 56 61 6c 75 65 73 20 65 78 74 72 61 63 /* Values extrac
d670: 74 65 64 20 66 72 6f 6d 20 70 45 78 70 72 20 2a ted from pExpr *
d680: 2f 0a 20 20 20 20 20 20 20 20 45 78 70 72 20 2a /. Expr *
d690: 70 45 78 70 72 20 3d 20 70 4c 6f 77 65 72 2d 3e pExpr = pLower->
d6a0: 70 45 78 70 72 2d 3e 70 52 69 67 68 74 3b 0a 20 pExpr->pRight;.
d6b0: 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 rc = sqli
d6c0: 74 65 33 53 74 61 74 34 50 72 6f 62 65 53 65 74 te3Stat4ProbeSet
d6d0: 56 61 6c 75 65 28 70 50 61 72 73 65 2c 20 70 2c Value(pParse, p,
d6e0: 20 26 70 52 65 63 2c 20 70 45 78 70 72 2c 20 6e &pRec, pExpr, n
d6f0: 42 74 6d 2c 20 6e 45 71 2c 20 26 6e 29 3b 0a 20 Btm, nEq, &n);.
d700: 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 if( rc==S
d710: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 6e 20 29 7b QLITE_OK && n ){
d720: 0a 20 20 20 20 20 20 20 20 20 20 74 52 6f 77 63 . tRowc
d730: 6e 74 20 69 4e 65 77 3b 0a 20 20 20 20 20 20 20 nt iNew;.
d740: 20 20 20 75 31 36 20 6d 61 73 6b 20 3d 20 57 4f u16 mask = WO
d750: 5f 47 54 7c 57 4f 5f 4c 45 3b 0a 20 20 20 20 20 _GT|WO_LE;.
d760: 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 if( sqlite3
d770: 45 78 70 72 56 65 63 74 6f 72 53 69 7a 65 28 70 ExprVectorSize(p
d780: 45 78 70 72 29 3e 6e 20 29 20 6d 61 73 6b 20 3d Expr)>n ) mask =
d790: 20 28 57 4f 5f 4c 45 7c 57 4f 5f 4c 54 29 3b 0a (WO_LE|WO_LT);.
d7a0: 20 20 20 20 20 20 20 20 20 20 69 4c 77 72 49 64 iLwrId
d7b0: 78 20 3d 20 77 68 65 72 65 4b 65 79 53 74 61 74 x = whereKeyStat
d7c0: 73 28 70 50 61 72 73 65 2c 20 70 2c 20 70 52 65 s(pParse, p, pRe
d7d0: 63 2c 20 30 2c 20 61 29 3b 0a 20 20 20 20 20 20 c, 0, a);.
d7e0: 20 20 20 20 69 4e 65 77 20 3d 20 61 5b 30 5d 20 iNew = a[0]
d7f0: 2b 20 28 28 70 4c 6f 77 65 72 2d 3e 65 4f 70 65 + ((pLower->eOpe
d800: 72 61 74 6f 72 20 26 20 6d 61 73 6b 29 20 3f 20 rator & mask) ?
d810: 61 5b 31 5d 20 3a 20 30 29 3b 0a 20 20 20 20 20 a[1] : 0);.
d820: 20 20 20 20 20 69 66 28 20 69 4e 65 77 3e 69 4c if( iNew>iL
d830: 6f 77 65 72 20 29 20 69 4c 6f 77 65 72 20 3d 20 ower ) iLower =
d840: 69 4e 65 77 3b 0a 20 20 20 20 20 20 20 20 20 20 iNew;.
d850: 6e 4f 75 74 2d 2d 3b 0a 20 20 20 20 20 20 20 20 nOut--;.
d860: 20 20 70 4c 6f 77 65 72 20 3d 20 30 3b 0a 20 20 pLower = 0;.
d870: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
d880: 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 70 6f 73 . /* If pos
d890: 73 69 62 6c 65 2c 20 69 6d 70 72 6f 76 65 20 6f sible, improve o
d8a0: 6e 20 74 68 65 20 69 55 70 70 65 72 20 65 73 74 n the iUpper est
d8b0: 69 6d 61 74 65 20 75 73 69 6e 67 20 28 24 50 3a imate using ($P:
d8c0: 24 55 29 2e 20 2a 2f 0a 20 20 20 20 20 20 69 66 $U). */. if
d8d0: 28 20 70 55 70 70 65 72 20 29 7b 0a 20 20 20 20 ( pUpper ){.
d8e0: 20 20 20 20 69 6e 74 20 6e 3b 20 20 20 20 20 20 int n;
d8f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
d900: 20 56 61 6c 75 65 73 20 65 78 74 72 61 63 74 65 Values extracte
d910: 64 20 66 72 6f 6d 20 70 45 78 70 72 20 2a 2f 0a d from pExpr */.
d920: 20 20 20 20 20 20 20 20 45 78 70 72 20 2a 70 45 Expr *pE
d930: 78 70 72 20 3d 20 70 55 70 70 65 72 2d 3e 70 45 xpr = pUpper->pE
d940: 78 70 72 2d 3e 70 52 69 67 68 74 3b 0a 20 20 20 xpr->pRight;.
d950: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 rc = sqlite
d960: 33 53 74 61 74 34 50 72 6f 62 65 53 65 74 56 61 3Stat4ProbeSetVa
d970: 6c 75 65 28 70 50 61 72 73 65 2c 20 70 2c 20 26 lue(pParse, p, &
d980: 70 52 65 63 2c 20 70 45 78 70 72 2c 20 6e 54 6f pRec, pExpr, nTo
d990: 70 2c 20 6e 45 71 2c 20 26 6e 29 3b 0a 20 20 20 p, nEq, &n);.
d9a0: 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
d9b0: 49 54 45 5f 4f 4b 20 26 26 20 6e 20 29 7b 0a 20 ITE_OK && n ){.
d9c0: 20 20 20 20 20 20 20 20 20 74 52 6f 77 63 6e 74 tRowcnt
d9d0: 20 69 4e 65 77 3b 0a 20 20 20 20 20 20 20 20 20 iNew;.
d9e0: 20 75 31 36 20 6d 61 73 6b 20 3d 20 57 4f 5f 47 u16 mask = WO_G
d9f0: 54 7c 57 4f 5f 4c 45 3b 0a 20 20 20 20 20 20 20 T|WO_LE;.
da00: 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 45 78 if( sqlite3Ex
da10: 70 72 56 65 63 74 6f 72 53 69 7a 65 28 70 45 78 prVectorSize(pEx
da20: 70 72 29 3e 6e 20 29 20 6d 61 73 6b 20 3d 20 28 pr)>n ) mask = (
da30: 57 4f 5f 4c 45 7c 57 4f 5f 4c 54 29 3b 0a 20 20 WO_LE|WO_LT);.
da40: 20 20 20 20 20 20 20 20 69 55 70 72 49 64 78 20 iUprIdx
da50: 3d 20 77 68 65 72 65 4b 65 79 53 74 61 74 73 28 = whereKeyStats(
da60: 70 50 61 72 73 65 2c 20 70 2c 20 70 52 65 63 2c pParse, p, pRec,
da70: 20 31 2c 20 61 29 3b 0a 20 20 20 20 20 20 20 20 1, a);.
da80: 20 20 69 4e 65 77 20 3d 20 61 5b 30 5d 20 2b 20 iNew = a[0] +
da90: 28 28 70 55 70 70 65 72 2d 3e 65 4f 70 65 72 61 ((pUpper->eOpera
daa0: 74 6f 72 20 26 20 6d 61 73 6b 29 20 3f 20 61 5b tor & mask) ? a[
dab0: 31 5d 20 3a 20 30 29 3b 0a 20 20 20 20 20 20 20 1] : 0);.
dac0: 20 20 20 69 66 28 20 69 4e 65 77 3c 69 55 70 70 if( iNew<iUpp
dad0: 65 72 20 29 20 69 55 70 70 65 72 20 3d 20 69 4e er ) iUpper = iN
dae0: 65 77 3b 0a 20 20 20 20 20 20 20 20 20 20 6e 4f ew;. nO
daf0: 75 74 2d 2d 3b 0a 20 20 20 20 20 20 20 20 20 20 ut--;.
db00: 70 55 70 70 65 72 20 3d 20 30 3b 0a 20 20 20 20 pUpper = 0;.
db10: 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 0a 20 }. }..
db20: 20 20 20 20 20 70 42 75 69 6c 64 65 72 2d 3e 70 pBuilder->p
db30: 52 65 63 20 3d 20 70 52 65 63 3b 0a 20 20 20 20 Rec = pRec;.
db40: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
db50: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 69 _OK ){. i
db60: 66 28 20 69 55 70 70 65 72 3e 69 4c 6f 77 65 72 f( iUpper>iLower
db70: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 6e 4e ){. nN
db80: 65 77 20 3d 20 73 71 6c 69 74 65 33 4c 6f 67 45 ew = sqlite3LogE
db90: 73 74 28 69 55 70 70 65 72 20 2d 20 69 4c 6f 77 st(iUpper - iLow
dba0: 65 72 29 3b 0a 20 20 20 20 20 20 20 20 20 20 2f er);. /
dbb0: 2a 20 54 55 4e 49 4e 47 3a 20 20 49 66 20 62 6f * TUNING: If bo
dbc0: 74 68 20 69 55 70 70 65 72 20 61 6e 64 20 69 4c th iUpper and iL
dbd0: 6f 77 65 72 20 61 72 65 20 64 65 72 69 76 65 64 ower are derived
dbe0: 20 66 72 6f 6d 20 74 68 65 20 73 61 6d 65 0a 20 from the same.
dbf0: 20 20 20 20 20 20 20 20 20 2a 2a 20 73 61 6d 70 ** samp
dc00: 6c 65 2c 20 74 68 65 6e 20 61 73 73 75 6d 65 20 le, then assume
dc10: 74 68 65 79 20 61 72 65 20 34 78 20 6d 6f 72 65 they are 4x more
dc20: 20 73 65 6c 65 63 74 69 76 65 2e 20 20 54 68 69 selective. Thi
dc30: 73 20 62 72 69 6e 67 73 0a 20 20 20 20 20 20 20 s brings.
dc40: 20 20 20 2a 2a 20 74 68 65 20 65 73 74 69 6d 61 ** the estima
dc50: 74 65 64 20 73 65 6c 65 63 74 69 76 69 74 79 20 ted selectivity
dc60: 6d 6f 72 65 20 69 6e 20 6c 69 6e 65 20 77 69 74 more in line wit
dc70: 68 20 77 68 61 74 20 69 74 20 77 6f 75 6c 64 20 h what it would
dc80: 62 65 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 be. **
dc90: 69 66 20 65 73 74 69 6d 61 74 65 64 20 77 69 74 if estimated wit
dca0: 68 6f 75 74 20 74 68 65 20 75 73 65 20 6f 66 20 hout the use of
dcb0: 53 54 41 54 33 2f 34 20 74 61 62 6c 65 73 2e 20 STAT3/4 tables.
dcc0: 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 */. if(
dcd0: 20 69 4c 77 72 49 64 78 3d 3d 69 55 70 72 49 64 iLwrIdx==iUprId
dce0: 78 20 29 20 6e 4e 65 77 20 2d 3d 20 32 30 3b 20 x ) nNew -= 20;
dcf0: 20 61 73 73 65 72 74 28 20 32 30 3d 3d 73 71 6c assert( 20==sql
dd00: 69 74 65 33 4c 6f 67 45 73 74 28 34 29 20 29 3b ite3LogEst(4) );
dd10: 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a . }else{.
dd20: 20 20 20 20 20 20 20 20 20 20 6e 4e 65 77 20 3d nNew =
dd30: 20 31 30 3b 20 20 20 20 20 20 20 20 61 73 73 65 10; asse
dd40: 72 74 28 20 31 30 3d 3d 73 71 6c 69 74 65 33 4c rt( 10==sqlite3L
dd50: 6f 67 45 73 74 28 32 29 20 29 3b 0a 20 20 20 20 ogEst(2) );.
dd60: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 69 66 }. if
dd70: 28 20 6e 4e 65 77 3c 6e 4f 75 74 20 29 7b 0a 20 ( nNew<nOut ){.
dd80: 20 20 20 20 20 20 20 20 20 6e 4f 75 74 20 3d 20 nOut =
dd90: 6e 4e 65 77 3b 0a 20 20 20 20 20 20 20 20 7d 0a nNew;. }.
dda0: 20 20 20 20 20 20 20 20 57 48 45 52 45 54 52 41 WHERETRA
ddb0: 43 45 28 30 78 31 30 2c 20 28 22 53 54 41 54 34 CE(0x10, ("STAT4
ddc0: 20 72 61 6e 67 65 20 73 63 61 6e 3a 20 25 75 2e range scan: %u.
ddd0: 2e 25 75 20 20 65 73 74 3d 25 64 5c 6e 22 2c 0a .%u est=%d\n",.
dde0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
ddf0: 20 20 20 20 20 20 20 20 20 20 20 28 75 33 32 29 (u32)
de00: 69 4c 6f 77 65 72 2c 20 28 75 33 32 29 69 55 70 iLower, (u32)iUp
de10: 70 65 72 2c 20 6e 4f 75 74 29 29 3b 0a 20 20 20 per, nOut));.
de20: 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a }. }else{.
de30: 20 20 20 20 20 20 69 6e 74 20 62 44 6f 6e 65 20 int bDone
de40: 3d 20 30 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 = 0;. rc =
de50: 77 68 65 72 65 52 61 6e 67 65 53 6b 69 70 53 63 whereRangeSkipSc
de60: 61 6e 45 73 74 28 70 50 61 72 73 65 2c 20 70 4c anEst(pParse, pL
de70: 6f 77 65 72 2c 20 70 55 70 70 65 72 2c 20 70 4c ower, pUpper, pL
de80: 6f 6f 70 2c 20 26 62 44 6f 6e 65 29 3b 0a 20 20 oop, &bDone);.
de90: 20 20 20 20 69 66 28 20 62 44 6f 6e 65 20 29 20 if( bDone )
dea0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d return rc;. }
deb0: 0a 20 20 7d 0a 23 65 6c 73 65 0a 20 20 55 4e 55 . }.#else. UNU
dec0: 53 45 44 5f 50 41 52 41 4d 45 54 45 52 28 70 50 SED_PARAMETER(pP
ded0: 61 72 73 65 29 3b 0a 20 20 55 4e 55 53 45 44 5f arse);. UNUSED_
dee0: 50 41 52 41 4d 45 54 45 52 28 70 42 75 69 6c 64 PARAMETER(pBuild
def0: 65 72 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 er);. assert( p
df00: 4c 6f 77 65 72 20 7c 7c 20 70 55 70 70 65 72 20 Lower || pUpper
df10: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 61 73 73 65 );.#endif. asse
df20: 72 74 28 20 70 55 70 70 65 72 3d 3d 30 20 7c 7c rt( pUpper==0 ||
df30: 20 28 70 55 70 70 65 72 2d 3e 77 74 46 6c 61 67 (pUpper->wtFlag
df40: 73 20 26 20 54 45 52 4d 5f 56 4e 55 4c 4c 29 3d s & TERM_VNULL)=
df50: 3d 30 20 29 3b 0a 20 20 6e 4e 65 77 20 3d 20 77 =0 );. nNew = w
df60: 68 65 72 65 52 61 6e 67 65 41 64 6a 75 73 74 28 hereRangeAdjust(
df70: 70 4c 6f 77 65 72 2c 20 6e 4f 75 74 29 3b 0a 20 pLower, nOut);.
df80: 20 6e 4e 65 77 20 3d 20 77 68 65 72 65 52 61 6e nNew = whereRan
df90: 67 65 41 64 6a 75 73 74 28 70 55 70 70 65 72 2c geAdjust(pUpper,
dfa0: 20 6e 4e 65 77 29 3b 0a 0a 20 20 2f 2a 20 54 55 nNew);.. /* TU
dfb0: 4e 49 4e 47 3a 20 49 66 20 74 68 65 72 65 20 69 NING: If there i
dfc0: 73 20 62 6f 74 68 20 61 6e 20 75 70 70 65 72 20 s both an upper
dfd0: 61 6e 64 20 6c 6f 77 65 72 20 6c 69 6d 69 74 20 and lower limit
dfe0: 61 6e 64 20 6e 65 69 74 68 65 72 20 6c 69 6d 69 and neither limi
dff0: 74 0a 20 20 2a 2a 20 68 61 73 20 61 6e 20 61 70 t. ** has an ap
e000: 70 6c 69 63 61 74 69 6f 6e 2d 64 65 66 69 6e 65 plication-define
e010: 64 20 6c 69 6b 65 6c 69 68 6f 6f 64 28 29 2c 20 d likelihood(),
e020: 61 73 73 75 6d 65 20 74 68 65 20 72 61 6e 67 65 assume the range
e030: 20 69 73 0a 20 20 2a 2a 20 72 65 64 75 63 65 64 is. ** reduced
e040: 20 62 79 20 61 6e 20 61 64 64 69 74 69 6f 6e 61 by an additiona
e050: 6c 20 37 35 25 2e 20 54 68 69 73 20 6d 65 61 6e l 75%. This mean
e060: 73 20 74 68 61 74 2c 20 62 79 20 64 65 66 61 75 s that, by defau
e070: 6c 74 2c 20 61 6e 20 6f 70 65 6e 2d 65 6e 64 65 lt, an open-ende
e080: 64 0a 20 20 2a 2a 20 72 61 6e 67 65 20 71 75 65 d. ** range que
e090: 72 79 20 28 65 2e 67 2e 20 63 6f 6c 20 3e 20 3f ry (e.g. col > ?
e0a0: 29 20 69 73 20 61 73 73 75 6d 65 64 20 74 6f 20 ) is assumed to
e0b0: 6d 61 74 63 68 20 31 2f 34 20 6f 66 20 74 68 65 match 1/4 of the
e0c0: 20 72 6f 77 73 20 69 6e 20 74 68 65 0a 20 20 2a rows in the. *
e0d0: 2a 20 69 6e 64 65 78 2e 20 57 68 69 6c 65 20 61 * index. While a
e0e0: 20 63 6c 6f 73 65 64 20 72 61 6e 67 65 20 28 65 closed range (e
e0f0: 2e 67 2e 20 63 6f 6c 20 42 45 54 57 45 45 4e 20 .g. col BETWEEN
e100: 3f 20 41 4e 44 20 3f 29 20 69 73 20 65 73 74 69 ? AND ?) is esti
e110: 6d 61 74 65 64 20 74 6f 0a 20 20 2a 2a 20 6d 61 mated to. ** ma
e120: 74 63 68 20 31 2f 36 34 20 6f 66 20 74 68 65 20 tch 1/64 of the
e130: 69 6e 64 65 78 2e 20 2a 2f 20 0a 20 20 69 66 28 index. */ . if(
e140: 20 70 4c 6f 77 65 72 20 26 26 20 70 4c 6f 77 65 pLower && pLowe
e150: 72 2d 3e 74 72 75 74 68 50 72 6f 62 3e 30 20 26 r->truthProb>0 &
e160: 26 20 70 55 70 70 65 72 20 26 26 20 70 55 70 70 & pUpper && pUpp
e170: 65 72 2d 3e 74 72 75 74 68 50 72 6f 62 3e 30 20 er->truthProb>0
e180: 29 7b 0a 20 20 20 20 6e 4e 65 77 20 2d 3d 20 32 ){. nNew -= 2
e190: 30 3b 0a 20 20 7d 0a 0a 20 20 6e 4f 75 74 20 2d 0;. }.. nOut -
e1a0: 3d 20 28 70 4c 6f 77 65 72 21 3d 30 29 20 2b 20 = (pLower!=0) +
e1b0: 28 70 55 70 70 65 72 21 3d 30 29 3b 0a 20 20 69 (pUpper!=0);. i
e1c0: 66 28 20 6e 4e 65 77 3c 31 30 20 29 20 6e 4e 65 f( nNew<10 ) nNe
e1d0: 77 20 3d 20 31 30 3b 0a 20 20 69 66 28 20 6e 4e w = 10;. if( nN
e1e0: 65 77 3c 6e 4f 75 74 20 29 20 6e 4f 75 74 20 3d ew<nOut ) nOut =
e1f0: 20 6e 4e 65 77 3b 0a 23 69 66 20 64 65 66 69 6e nNew;.#if defin
e200: 65 64 28 57 48 45 52 45 54 52 41 43 45 5f 45 4e ed(WHERETRACE_EN
e210: 41 42 4c 45 44 29 0a 20 20 69 66 28 20 70 4c 6f ABLED). if( pLo
e220: 6f 70 2d 3e 6e 4f 75 74 3e 6e 4f 75 74 20 29 7b op->nOut>nOut ){
e230: 0a 20 20 20 20 57 48 45 52 45 54 52 41 43 45 28 . WHERETRACE(
e240: 30 78 31 30 2c 28 22 52 61 6e 67 65 20 73 63 61 0x10,("Range sca
e250: 6e 20 6c 6f 77 65 72 73 20 6e 4f 75 74 20 66 72 n lowers nOut fr
e260: 6f 6d 20 25 64 20 74 6f 20 25 64 5c 6e 22 2c 0a om %d to %d\n",.
e270: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e280: 20 20 20 20 70 4c 6f 6f 70 2d 3e 6e 4f 75 74 2c pLoop->nOut,
e290: 20 6e 4f 75 74 29 29 3b 0a 20 20 7d 0a 23 65 6e nOut));. }.#en
e2a0: 64 69 66 0a 20 20 70 4c 6f 6f 70 2d 3e 6e 4f 75 dif. pLoop->nOu
e2b0: 74 20 3d 20 28 4c 6f 67 45 73 74 29 6e 4f 75 74 t = (LogEst)nOut
e2c0: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
e2d0: 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f ..#ifdef SQLITE_
e2e0: 45 4e 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f ENABLE_STAT3_OR_
e2f0: 53 54 41 54 34 0a 2f 2a 0a 2a 2a 20 45 73 74 69 STAT4./*.** Esti
e300: 6d 61 74 65 20 74 68 65 20 6e 75 6d 62 65 72 20 mate the number
e310: 6f 66 20 72 6f 77 73 20 74 68 61 74 20 77 69 6c of rows that wil
e320: 6c 20 62 65 20 72 65 74 75 72 6e 65 64 20 62 61 l be returned ba
e330: 73 65 64 20 6f 6e 0a 2a 2a 20 61 6e 20 65 71 75 sed on.** an equ
e340: 61 6c 69 74 79 20 63 6f 6e 73 74 72 61 69 6e 74 ality constraint
e350: 20 78 3d 56 41 4c 55 45 20 61 6e 64 20 77 68 65 x=VALUE and whe
e360: 72 65 20 74 68 61 74 20 56 41 4c 55 45 20 6f 63 re that VALUE oc
e370: 63 75 72 73 20 69 6e 0a 2a 2a 20 74 68 65 20 68 curs in.** the h
e380: 69 73 74 6f 67 72 61 6d 20 64 61 74 61 2e 20 20 istogram data.
e390: 54 68 69 73 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 This only works
e3a0: 77 68 65 6e 20 78 20 69 73 20 74 68 65 20 6c 65 when x is the le
e3b0: 66 74 2d 6d 6f 73 74 0a 2a 2a 20 63 6f 6c 75 6d ft-most.** colum
e3c0: 6e 20 6f 66 20 61 6e 20 69 6e 64 65 78 20 61 6e n of an index an
e3d0: 64 20 73 71 6c 69 74 65 5f 73 74 61 74 33 20 68 d sqlite_stat3 h
e3e0: 69 73 74 6f 67 72 61 6d 20 64 61 74 61 20 69 73 istogram data is
e3f0: 20 61 76 61 69 6c 61 62 6c 65 0a 2a 2a 20 66 6f available.** fo
e400: 72 20 74 68 61 74 20 69 6e 64 65 78 2e 20 20 57 r that index. W
e410: 68 65 6e 20 70 45 78 70 72 3d 3d 4e 55 4c 4c 20 hen pExpr==NULL
e420: 74 68 61 74 20 6d 65 61 6e 73 20 74 68 65 20 63 that means the c
e430: 6f 6e 73 74 72 61 69 6e 74 20 69 73 0a 2a 2a 20 onstraint is.**
e440: 22 78 20 49 53 20 4e 55 4c 4c 22 20 69 6e 73 74 "x IS NULL" inst
e450: 65 61 64 20 6f 66 20 22 78 3d 56 41 4c 55 45 22 ead of "x=VALUE"
e460: 2e 0a 2a 2a 0a 2a 2a 20 57 72 69 74 65 20 74 68 ..**.** Write th
e470: 65 20 65 73 74 69 6d 61 74 65 64 20 72 6f 77 20 e estimated row
e480: 63 6f 75 6e 74 20 69 6e 74 6f 20 2a 70 6e 52 6f count into *pnRo
e490: 77 20 61 6e 64 20 72 65 74 75 72 6e 20 53 51 4c w and return SQL
e4a0: 49 54 45 5f 4f 4b 2e 20 0a 2a 2a 20 49 66 20 75 ITE_OK. .** If u
e4b0: 6e 61 62 6c 65 20 74 6f 20 6d 61 6b 65 20 61 6e nable to make an
e4c0: 20 65 73 74 69 6d 61 74 65 2c 20 6c 65 61 76 65 estimate, leave
e4d0: 20 2a 70 6e 52 6f 77 20 75 6e 63 68 61 6e 67 65 *pnRow unchange
e4e0: 64 20 61 6e 64 20 72 65 74 75 72 6e 0a 2a 2a 20 d and return.**
e4f0: 6e 6f 6e 2d 7a 65 72 6f 2e 0a 2a 2a 0a 2a 2a 20 non-zero..**.**
e500: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 63 61 6e This routine can
e510: 20 66 61 69 6c 20 69 66 20 69 74 20 69 73 20 75 fail if it is u
e520: 6e 61 62 6c 65 20 74 6f 20 6c 6f 61 64 20 61 20 nable to load a
e530: 63 6f 6c 6c 61 74 69 6e 67 20 73 65 71 75 65 6e collating sequen
e540: 63 65 0a 2a 2a 20 72 65 71 75 69 72 65 64 20 66 ce.** required f
e550: 6f 72 20 73 74 72 69 6e 67 20 63 6f 6d 70 61 72 or string compar
e560: 69 73 6f 6e 2c 20 6f 72 20 69 66 20 75 6e 61 62 ison, or if unab
e570: 6c 65 20 74 6f 20 61 6c 6c 6f 63 61 74 65 20 6d le to allocate m
e580: 65 6d 6f 72 79 0a 2a 2a 20 66 6f 72 20 61 20 55 emory.** for a U
e590: 54 46 20 63 6f 6e 76 65 72 73 69 6f 6e 20 72 65 TF conversion re
e5a0: 71 75 69 72 65 64 20 66 6f 72 20 63 6f 6d 70 61 quired for compa
e5b0: 72 69 73 6f 6e 2e 20 20 54 68 65 20 65 72 72 6f rison. The erro
e5c0: 72 20 69 73 20 73 74 6f 72 65 64 0a 2a 2a 20 69 r is stored.** i
e5d0: 6e 20 74 68 65 20 70 50 61 72 73 65 20 73 74 72 n the pParse str
e5e0: 75 63 74 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 ucture..*/.stati
e5f0: 63 20 69 6e 74 20 77 68 65 72 65 45 71 75 61 6c c int whereEqual
e600: 53 63 61 6e 45 73 74 28 0a 20 20 50 61 72 73 65 ScanEst(. Parse
e610: 20 2a 70 50 61 72 73 65 2c 20 20 20 20 20 20 20 *pParse,
e620: 2f 2a 20 50 61 72 73 69 6e 67 20 26 20 63 6f 64 /* Parsing & cod
e630: 65 20 67 65 6e 65 72 61 74 69 6e 67 20 63 6f 6e e generating con
e640: 74 65 78 74 20 2a 2f 0a 20 20 57 68 65 72 65 4c text */. WhereL
e650: 6f 6f 70 42 75 69 6c 64 65 72 20 2a 70 42 75 69 oopBuilder *pBui
e660: 6c 64 65 72 2c 0a 20 20 45 78 70 72 20 2a 70 45 lder,. Expr *pE
e670: 78 70 72 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 xpr, /*
e680: 45 78 70 72 65 73 73 69 6f 6e 20 66 6f 72 20 56 Expression for V
e690: 41 4c 55 45 20 69 6e 20 74 68 65 20 78 3d 56 41 ALUE in the x=VA
e6a0: 4c 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a LUE constraint *
e6b0: 2f 0a 20 20 74 52 6f 77 63 6e 74 20 2a 70 6e 52 /. tRowcnt *pnR
e6c0: 6f 77 20 20 20 20 20 20 20 2f 2a 20 57 72 69 74 ow /* Writ
e6d0: 65 20 74 68 65 20 72 65 76 69 73 65 64 20 72 6f e the revised ro
e6e0: 77 20 65 73 74 69 6d 61 74 65 20 68 65 72 65 20 w estimate here
e6f0: 2a 2f 0a 29 7b 0a 20 20 49 6e 64 65 78 20 2a 70 */.){. Index *p
e700: 20 3d 20 70 42 75 69 6c 64 65 72 2d 3e 70 4e 65 = pBuilder->pNe
e710: 77 2d 3e 75 2e 62 74 72 65 65 2e 70 49 6e 64 65 w->u.btree.pInde
e720: 78 3b 0a 20 20 69 6e 74 20 6e 45 71 20 3d 20 70 x;. int nEq = p
e730: 42 75 69 6c 64 65 72 2d 3e 70 4e 65 77 2d 3e 75 Builder->pNew->u
e740: 2e 62 74 72 65 65 2e 6e 45 71 3b 0a 20 20 55 6e .btree.nEq;. Un
e750: 70 61 63 6b 65 64 52 65 63 6f 72 64 20 2a 70 52 packedRecord *pR
e760: 65 63 20 3d 20 70 42 75 69 6c 64 65 72 2d 3e 70 ec = pBuilder->p
e770: 52 65 63 3b 0a 20 20 69 6e 74 20 72 63 3b 20 20 Rec;. int rc;
e780: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
e790: 20 2f 2a 20 53 75 62 66 75 6e 63 74 69 6f 6e 20 /* Subfunction
e7a0: 72 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 return code */.
e7b0: 20 74 52 6f 77 63 6e 74 20 61 5b 32 5d 3b 20 20 tRowcnt a[2];
e7c0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 74 /* St
e7d0: 61 74 69 73 74 69 63 73 20 2a 2f 0a 20 20 69 6e atistics */. in
e7e0: 74 20 62 4f 6b 3b 0a 0a 20 20 61 73 73 65 72 74 t bOk;.. assert
e7f0: 28 20 6e 45 71 3e 3d 31 20 29 3b 0a 20 20 61 73 ( nEq>=1 );. as
e800: 73 65 72 74 28 20 6e 45 71 3c 3d 70 2d 3e 6e 43 sert( nEq<=p->nC
e810: 6f 6c 75 6d 6e 20 29 3b 0a 20 20 61 73 73 65 72 olumn );. asser
e820: 74 28 20 70 2d 3e 61 53 61 6d 70 6c 65 21 3d 30 t( p->aSample!=0
e830: 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 70 2d );. assert( p-
e840: 3e 6e 53 61 6d 70 6c 65 3e 30 20 29 3b 0a 20 20 >nSample>0 );.
e850: 61 73 73 65 72 74 28 20 70 42 75 69 6c 64 65 72 assert( pBuilder
e860: 2d 3e 6e 52 65 63 56 61 6c 69 64 3c 6e 45 71 20 ->nRecValid<nEq
e870: 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 76 61 6c 75 );.. /* If valu
e880: 65 73 20 61 72 65 20 6e 6f 74 20 61 76 61 69 6c es are not avail
e890: 61 62 6c 65 20 66 6f 72 20 61 6c 6c 20 66 69 65 able for all fie
e8a0: 6c 64 73 20 6f 66 20 74 68 65 20 69 6e 64 65 78 lds of the index
e8b0: 20 74 6f 20 74 68 65 20 6c 65 66 74 0a 20 20 2a to the left. *
e8c0: 2a 20 6f 66 20 74 68 69 73 20 6f 6e 65 2c 20 6e * of this one, n
e8d0: 6f 20 65 73 74 69 6d 61 74 65 20 63 61 6e 20 62 o estimate can b
e8e0: 65 20 6d 61 64 65 2e 20 52 65 74 75 72 6e 20 53 e made. Return S
e8f0: 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 2e 20 QLITE_NOTFOUND.
e900: 2a 2f 0a 20 20 69 66 28 20 70 42 75 69 6c 64 65 */. if( pBuilde
e910: 72 2d 3e 6e 52 65 63 56 61 6c 69 64 3c 28 6e 45 r->nRecValid<(nE
e920: 71 2d 31 29 20 29 7b 0a 20 20 20 20 72 65 74 75 q-1) ){. retu
e930: 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 rn SQLITE_NOTFOU
e940: 4e 44 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 68 ND;. }.. /* Th
e950: 69 73 20 69 73 20 61 6e 20 6f 70 74 69 6d 69 7a is is an optimiz
e960: 61 74 69 6f 6e 20 6f 6e 6c 79 2e 20 54 68 65 20 ation only. The
e970: 63 61 6c 6c 20 74 6f 20 73 71 6c 69 74 65 33 53 call to sqlite3S
e980: 74 61 74 34 50 72 6f 62 65 53 65 74 56 61 6c 75 tat4ProbeSetValu
e990: 65 28 29 0a 20 20 2a 2a 20 62 65 6c 6f 77 20 77 e(). ** below w
e9a0: 6f 75 6c 64 20 72 65 74 75 72 6e 20 74 68 65 20 ould return the
e9b0: 73 61 6d 65 20 76 61 6c 75 65 2e 20 20 2a 2f 0a same value. */.
e9c0: 20 20 69 66 28 20 6e 45 71 3e 3d 70 2d 3e 6e 43 if( nEq>=p->nC
e9d0: 6f 6c 75 6d 6e 20 29 7b 0a 20 20 20 20 2a 70 6e olumn ){. *pn
e9e0: 52 6f 77 20 3d 20 31 3b 0a 20 20 20 20 72 65 74 Row = 1;. ret
e9f0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 urn SQLITE_OK;.
ea00: 20 7d 0a 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 }.. rc = sqlit
ea10: 65 33 53 74 61 74 34 50 72 6f 62 65 53 65 74 56 e3Stat4ProbeSetV
ea20: 61 6c 75 65 28 70 50 61 72 73 65 2c 20 70 2c 20 alue(pParse, p,
ea30: 26 70 52 65 63 2c 20 70 45 78 70 72 2c 20 31 2c &pRec, pExpr, 1,
ea40: 20 6e 45 71 2d 31 2c 20 26 62 4f 6b 29 3b 0a 20 nEq-1, &bOk);.
ea50: 20 70 42 75 69 6c 64 65 72 2d 3e 70 52 65 63 20 pBuilder->pRec
ea60: 3d 20 70 52 65 63 3b 0a 20 20 69 66 28 20 72 63 = pRec;. if( rc
ea70: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 65 !=SQLITE_OK ) re
ea80: 74 75 72 6e 20 72 63 3b 0a 20 20 69 66 28 20 62 turn rc;. if( b
ea90: 4f 6b 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 Ok==0 ) return S
eaa0: 51 4c 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 3b 0a QLITE_NOTFOUND;.
eab0: 20 20 70 42 75 69 6c 64 65 72 2d 3e 6e 52 65 63 pBuilder->nRec
eac0: 56 61 6c 69 64 20 3d 20 6e 45 71 3b 0a 0a 20 20 Valid = nEq;..
ead0: 77 68 65 72 65 4b 65 79 53 74 61 74 73 28 70 50 whereKeyStats(pP
eae0: 61 72 73 65 2c 20 70 2c 20 70 52 65 63 2c 20 30 arse, p, pRec, 0
eaf0: 2c 20 61 29 3b 0a 20 20 57 48 45 52 45 54 52 41 , a);. WHERETRA
eb00: 43 45 28 30 78 31 30 2c 28 22 65 71 75 61 6c 69 CE(0x10,("equali
eb10: 74 79 20 73 63 61 6e 20 72 65 67 69 6f 6e 73 20 ty scan regions
eb20: 25 73 28 25 64 29 3a 20 25 64 5c 6e 22 2c 0a 20 %s(%d): %d\n",.
eb30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
eb40: 20 20 70 2d 3e 7a 4e 61 6d 65 2c 20 6e 45 71 2d p->zName, nEq-
eb50: 31 2c 20 28 69 6e 74 29 61 5b 31 5d 29 29 3b 0a 1, (int)a[1]));.
eb60: 20 20 2a 70 6e 52 6f 77 20 3d 20 61 5b 31 5d 3b *pnRow = a[1];
eb70: 0a 20 20 0a 20 20 72 65 74 75 72 6e 20 72 63 3b . . return rc;
eb80: 0a 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c .}.#endif /* SQL
eb90: 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 33 ITE_ENABLE_STAT3
eba0: 5f 4f 52 5f 53 54 41 54 34 20 2a 2f 0a 0a 23 69 _OR_STAT4 */..#i
ebb0: 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
ebc0: 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 LE_STAT3_OR_STAT
ebd0: 34 0a 2f 2a 0a 2a 2a 20 45 73 74 69 6d 61 74 65 4./*.** Estimate
ebe0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 the number of r
ebf0: 6f 77 73 20 74 68 61 74 20 77 69 6c 6c 20 62 65 ows that will be
ec00: 20 72 65 74 75 72 6e 65 64 20 62 61 73 65 64 20 returned based
ec10: 6f 6e 0a 2a 2a 20 61 6e 20 49 4e 20 63 6f 6e 73 on.** an IN cons
ec20: 74 72 61 69 6e 74 20 77 68 65 72 65 20 74 68 65 traint where the
ec30: 20 72 69 67 68 74 2d 68 61 6e 64 20 73 69 64 65 right-hand side
ec40: 20 6f 66 20 74 68 65 20 49 4e 20 6f 70 65 72 61 of the IN opera
ec50: 74 6f 72 0a 2a 2a 20 69 73 20 61 20 6c 69 73 74 tor.** is a list
ec60: 20 6f 66 20 76 61 6c 75 65 73 2e 20 20 45 78 61 of values. Exa
ec70: 6d 70 6c 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 mple:.**.**
ec80: 20 20 20 57 48 45 52 45 20 78 20 49 4e 20 28 31 WHERE x IN (1
ec90: 2c 32 2c 33 2c 34 29 0a 2a 2a 0a 2a 2a 20 57 72 ,2,3,4).**.** Wr
eca0: 69 74 65 20 74 68 65 20 65 73 74 69 6d 61 74 65 ite the estimate
ecb0: 64 20 72 6f 77 20 63 6f 75 6e 74 20 69 6e 74 6f d row count into
ecc0: 20 2a 70 6e 52 6f 77 20 61 6e 64 20 72 65 74 75 *pnRow and retu
ecd0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 0a 2a rn SQLITE_OK. .*
ece0: 2a 20 49 66 20 75 6e 61 62 6c 65 20 74 6f 20 6d * If unable to m
ecf0: 61 6b 65 20 61 6e 20 65 73 74 69 6d 61 74 65 2c ake an estimate,
ed00: 20 6c 65 61 76 65 20 2a 70 6e 52 6f 77 20 75 6e leave *pnRow un
ed10: 63 68 61 6e 67 65 64 20 61 6e 64 20 72 65 74 75 changed and retu
ed20: 72 6e 0a 2a 2a 20 6e 6f 6e 2d 7a 65 72 6f 2e 0a rn.** non-zero..
ed30: 2a 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 **.** This routi
ed40: 6e 65 20 63 61 6e 20 66 61 69 6c 20 69 66 20 69 ne can fail if i
ed50: 74 20 69 73 20 75 6e 61 62 6c 65 20 74 6f 20 6c t is unable to l
ed60: 6f 61 64 20 61 20 63 6f 6c 6c 61 74 69 6e 67 20 oad a collating
ed70: 73 65 71 75 65 6e 63 65 0a 2a 2a 20 72 65 71 75 sequence.** requ
ed80: 69 72 65 64 20 66 6f 72 20 73 74 72 69 6e 67 20 ired for string
ed90: 63 6f 6d 70 61 72 69 73 6f 6e 2c 20 6f 72 20 69 comparison, or i
eda0: 66 20 75 6e 61 62 6c 65 20 74 6f 20 61 6c 6c 6f f unable to allo
edb0: 63 61 74 65 20 6d 65 6d 6f 72 79 0a 2a 2a 20 66 cate memory.** f
edc0: 6f 72 20 61 20 55 54 46 20 63 6f 6e 76 65 72 73 or a UTF convers
edd0: 69 6f 6e 20 72 65 71 75 69 72 65 64 20 66 6f 72 ion required for
ede0: 20 63 6f 6d 70 61 72 69 73 6f 6e 2e 20 20 54 68 comparison. Th
edf0: 65 20 65 72 72 6f 72 20 69 73 20 73 74 6f 72 65 e error is store
ee00: 64 0a 2a 2a 20 69 6e 20 74 68 65 20 70 50 61 72 d.** in the pPar
ee10: 73 65 20 73 74 72 75 63 74 75 72 65 2e 0a 2a 2f se structure..*/
ee20: 0a 73 74 61 74 69 63 20 69 6e 74 20 77 68 65 72 .static int wher
ee30: 65 49 6e 53 63 61 6e 45 73 74 28 0a 20 20 50 61 eInScanEst(. Pa
ee40: 72 73 65 20 2a 70 50 61 72 73 65 2c 20 20 20 20 rse *pParse,
ee50: 20 20 20 2f 2a 20 50 61 72 73 69 6e 67 20 26 20 /* Parsing &
ee60: 63 6f 64 65 20 67 65 6e 65 72 61 74 69 6e 67 20 code generating
ee70: 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 57 68 65 context */. Whe
ee80: 72 65 4c 6f 6f 70 42 75 69 6c 64 65 72 20 2a 70 reLoopBuilder *p
ee90: 42 75 69 6c 64 65 72 2c 0a 20 20 45 78 70 72 4c Builder,. ExprL
eea0: 69 73 74 20 2a 70 4c 69 73 74 2c 20 20 20 20 20 ist *pList,
eeb0: 2f 2a 20 54 68 65 20 76 61 6c 75 65 20 6c 69 73 /* The value lis
eec0: 74 20 6f 6e 20 74 68 65 20 52 48 53 20 6f 66 20 t on the RHS of
eed0: 22 78 20 49 4e 20 28 76 31 2c 76 32 2c 76 33 2c "x IN (v1,v2,v3,
eee0: 2e 2e 2e 29 22 20 2a 2f 0a 20 20 74 52 6f 77 63 ...)" */. tRowc
eef0: 6e 74 20 2a 70 6e 52 6f 77 20 20 20 20 20 20 20 nt *pnRow
ef00: 2f 2a 20 57 72 69 74 65 20 74 68 65 20 72 65 76 /* Write the rev
ef10: 69 73 65 64 20 72 6f 77 20 65 73 74 69 6d 61 74 ised row estimat
ef20: 65 20 68 65 72 65 20 2a 2f 0a 29 7b 0a 20 20 49 e here */.){. I
ef30: 6e 64 65 78 20 2a 70 20 3d 20 70 42 75 69 6c 64 ndex *p = pBuild
ef40: 65 72 2d 3e 70 4e 65 77 2d 3e 75 2e 62 74 72 65 er->pNew->u.btre
ef50: 65 2e 70 49 6e 64 65 78 3b 0a 20 20 69 36 34 20 e.pIndex;. i64
ef60: 6e 52 6f 77 30 20 3d 20 73 71 6c 69 74 65 33 4c nRow0 = sqlite3L
ef70: 6f 67 45 73 74 54 6f 49 6e 74 28 70 2d 3e 61 69 ogEstToInt(p->ai
ef80: 52 6f 77 4c 6f 67 45 73 74 5b 30 5d 29 3b 0a 20 RowLogEst[0]);.
ef90: 20 69 6e 74 20 6e 52 65 63 56 61 6c 69 64 20 3d int nRecValid =
efa0: 20 70 42 75 69 6c 64 65 72 2d 3e 6e 52 65 63 56 pBuilder->nRecV
efb0: 61 6c 69 64 3b 0a 20 20 69 6e 74 20 72 63 20 3d alid;. int rc =
efc0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 SQLITE_OK;
efd0: 2f 2a 20 53 75 62 66 75 6e 63 74 69 6f 6e 20 72 /* Subfunction r
efe0: 65 74 75 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 eturn code */.
eff0: 74 52 6f 77 63 6e 74 20 6e 45 73 74 3b 20 20 20 tRowcnt nEst;
f000: 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 /* Numbe
f010: 72 20 6f 66 20 72 6f 77 73 20 66 6f 72 20 61 20 r of rows for a
f020: 73 69 6e 67 6c 65 20 74 65 72 6d 20 2a 2f 0a 20 single term */.
f030: 20 74 52 6f 77 63 6e 74 20 6e 52 6f 77 45 73 74 tRowcnt nRowEst
f040: 20 3d 20 30 3b 20 20 20 20 2f 2a 20 4e 65 77 20 = 0; /* New
f050: 65 73 74 69 6d 61 74 65 20 6f 66 20 74 68 65 20 estimate of the
f060: 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 2a number of rows *
f070: 2f 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 /. int i;
f080: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c /* L
f090: 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a 0a oop counter */..
f0a0: 20 20 61 73 73 65 72 74 28 20 70 2d 3e 61 53 61 assert( p->aSa
f0b0: 6d 70 6c 65 21 3d 30 20 29 3b 0a 20 20 66 6f 72 mple!=0 );. for
f0c0: 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 (i=0; rc==SQLITE
f0d0: 5f 4f 4b 20 26 26 20 69 3c 70 4c 69 73 74 2d 3e _OK && i<pList->
f0e0: 6e 45 78 70 72 3b 20 69 2b 2b 29 7b 0a 20 20 20 nExpr; i++){.
f0f0: 20 6e 45 73 74 20 3d 20 6e 52 6f 77 30 3b 0a 20 nEst = nRow0;.
f100: 20 20 20 72 63 20 3d 20 77 68 65 72 65 45 71 75 rc = whereEqu
f110: 61 6c 53 63 61 6e 45 73 74 28 70 50 61 72 73 65 alScanEst(pParse
f120: 2c 20 70 42 75 69 6c 64 65 72 2c 20 70 4c 69 73 , pBuilder, pLis
f130: 74 2d 3e 61 5b 69 5d 2e 70 45 78 70 72 2c 20 26 t->a[i].pExpr, &
f140: 6e 45 73 74 29 3b 0a 20 20 20 20 6e 52 6f 77 45 nEst);. nRowE
f150: 73 74 20 2b 3d 20 6e 45 73 74 3b 0a 20 20 20 20 st += nEst;.
f160: 70 42 75 69 6c 64 65 72 2d 3e 6e 52 65 63 56 61 pBuilder->nRecVa
f170: 6c 69 64 20 3d 20 6e 52 65 63 56 61 6c 69 64 3b lid = nRecValid;
f180: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 72 63 3d 3d . }.. if( rc==
f190: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 SQLITE_OK ){.
f1a0: 20 69 66 28 20 6e 52 6f 77 45 73 74 20 3e 20 6e if( nRowEst > n
f1b0: 52 6f 77 30 20 29 20 6e 52 6f 77 45 73 74 20 3d Row0 ) nRowEst =
f1c0: 20 6e 52 6f 77 30 3b 0a 20 20 20 20 2a 70 6e 52 nRow0;. *pnR
f1d0: 6f 77 20 3d 20 6e 52 6f 77 45 73 74 3b 0a 20 20 ow = nRowEst;.
f1e0: 20 20 57 48 45 52 45 54 52 41 43 45 28 30 78 31 WHERETRACE(0x1
f1f0: 30 2c 28 22 49 4e 20 72 6f 77 20 65 73 74 69 6d 0,("IN row estim
f200: 61 74 65 3a 20 65 73 74 3d 25 64 5c 6e 22 2c 20 ate: est=%d\n",
f210: 6e 52 6f 77 45 73 74 29 29 3b 0a 20 20 7d 0a 20 nRowEst));. }.
f220: 20 61 73 73 65 72 74 28 20 70 42 75 69 6c 64 65 assert( pBuilde
f230: 72 2d 3e 6e 52 65 63 56 61 6c 69 64 3d 3d 6e 52 r->nRecValid==nR
f240: 65 63 56 61 6c 69 64 20 29 3b 0a 20 20 72 65 74 ecValid );. ret
f250: 75 72 6e 20 72 63 3b 0a 7d 0a 23 65 6e 64 69 66 urn rc;.}.#endif
f260: 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c /* SQLITE_ENABL
f270: 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 E_STAT3_OR_STAT4
f280: 20 2a 2f 0a 0a 0a 23 69 66 64 65 66 20 57 48 45 */...#ifdef WHE
f290: 52 45 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 0a RETRACE_ENABLED.
f2a0: 2f 2a 0a 2a 2a 20 50 72 69 6e 74 20 74 68 65 20 /*.** Print the
f2b0: 63 6f 6e 74 65 6e 74 20 6f 66 20 61 20 57 68 65 content of a Whe
f2c0: 72 65 54 65 72 6d 20 6f 62 6a 65 63 74 0a 2a 2f reTerm object.*/
f2d0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 77 68 65 .static void whe
f2e0: 72 65 54 65 72 6d 50 72 69 6e 74 28 57 68 65 72 reTermPrint(Wher
f2f0: 65 54 65 72 6d 20 2a 70 54 65 72 6d 2c 20 69 6e eTerm *pTerm, in
f300: 74 20 69 54 65 72 6d 29 7b 0a 20 20 69 66 28 20 t iTerm){. if(
f310: 70 54 65 72 6d 3d 3d 30 20 29 7b 0a 20 20 20 20 pTerm==0 ){.
f320: 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e sqlite3DebugPrin
f330: 74 66 28 22 54 45 52 4d 2d 25 2d 33 64 20 4e 55 tf("TERM-%-3d NU
f340: 4c 4c 5c 6e 22 2c 20 69 54 65 72 6d 29 3b 0a 20 LL\n", iTerm);.
f350: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 63 68 61 72 }else{. char
f360: 20 7a 54 79 70 65 5b 34 5d 3b 0a 20 20 20 20 63 zType[4];. c
f370: 68 61 72 20 7a 4c 65 66 74 5b 35 30 5d 3b 0a 20 har zLeft[50];.
f380: 20 20 20 6d 65 6d 63 70 79 28 7a 54 79 70 65 2c memcpy(zType,
f390: 20 22 2e 2e 2e 22 2c 20 34 29 3b 0a 20 20 20 20 "...", 4);.
f3a0: 69 66 28 20 70 54 65 72 6d 2d 3e 77 74 46 6c 61 if( pTerm->wtFla
f3b0: 67 73 20 26 20 54 45 52 4d 5f 56 49 52 54 55 41 gs & TERM_VIRTUA
f3c0: 4c 20 29 20 7a 54 79 70 65 5b 30 5d 20 3d 20 27 L ) zType[0] = '
f3d0: 56 27 3b 0a 20 20 20 20 69 66 28 20 70 54 65 72 V';. if( pTer
f3e0: 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 57 m->eOperator & W
f3f0: 4f 5f 45 51 55 49 56 20 20 29 20 7a 54 79 70 65 O_EQUIV ) zType
f400: 5b 31 5d 20 3d 20 27 45 27 3b 0a 20 20 20 20 69 [1] = 'E';. i
f410: 66 28 20 45 78 70 72 48 61 73 50 72 6f 70 65 72 f( ExprHasProper
f420: 74 79 28 70 54 65 72 6d 2d 3e 70 45 78 70 72 2c ty(pTerm->pExpr,
f430: 20 45 50 5f 46 72 6f 6d 4a 6f 69 6e 29 20 29 20 EP_FromJoin) )
f440: 7a 54 79 70 65 5b 32 5d 20 3d 20 27 4c 27 3b 0a zType[2] = 'L';.
f450: 20 20 20 20 69 66 28 20 70 54 65 72 6d 2d 3e 65 if( pTerm->e
f460: 4f 70 65 72 61 74 6f 72 20 26 20 57 4f 5f 53 49 Operator & WO_SI
f470: 4e 47 4c 45 20 29 7b 0a 20 20 20 20 20 20 73 71 NGLE ){. sq
f480: 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 73 lite3_snprintf(s
f490: 69 7a 65 6f 66 28 7a 4c 65 66 74 29 2c 7a 4c 65 izeof(zLeft),zLe
f4a0: 66 74 2c 22 6c 65 66 74 3d 7b 25 64 3a 25 64 7d ft,"left={%d:%d}
f4b0: 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ",.
f4c0: 20 20 20 20 20 20 20 20 20 20 70 54 65 72 6d 2d pTerm-
f4d0: 3e 6c 65 66 74 43 75 72 73 6f 72 2c 20 70 54 65 >leftCursor, pTe
f4e0: 72 6d 2d 3e 75 2e 6c 65 66 74 43 6f 6c 75 6d 6e rm->u.leftColumn
f4f0: 29 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 );. }else if(
f500: 20 28 70 54 65 72 6d 2d 3e 65 4f 70 65 72 61 74 (pTerm->eOperat
f510: 6f 72 20 26 20 57 4f 5f 4f 52 29 21 3d 30 20 26 or & WO_OR)!=0 &
f520: 26 20 70 54 65 72 6d 2d 3e 75 2e 70 4f 72 49 6e & pTerm->u.pOrIn
f530: 66 6f 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 fo!=0 ){. s
f540: 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 qlite3_snprintf(
f550: 73 69 7a 65 6f 66 28 7a 4c 65 66 74 29 2c 7a 4c sizeof(zLeft),zL
f560: 65 66 74 2c 22 69 6e 64 65 78 61 62 6c 65 3d 30 eft,"indexable=0
f570: 78 25 6c 6c 64 22 2c 20 0a 20 20 20 20 20 20 20 x%lld", .
f580: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
f590: 70 54 65 72 6d 2d 3e 75 2e 70 4f 72 49 6e 66 6f pTerm->u.pOrInfo
f5a0: 2d 3e 69 6e 64 65 78 61 62 6c 65 29 3b 0a 20 20 ->indexable);.
f5b0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 }else{. s
f5c0: 71 6c 69 74 65 33 5f 73 6e 70 72 69 6e 74 66 28 qlite3_snprintf(
f5d0: 73 69 7a 65 6f 66 28 7a 4c 65 66 74 29 2c 7a 4c sizeof(zLeft),zL
f5e0: 65 66 74 2c 22 6c 65 66 74 3d 25 64 22 2c 20 70 eft,"left=%d", p
f5f0: 54 65 72 6d 2d 3e 6c 65 66 74 43 75 72 73 6f 72 Term->leftCursor
f600: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c );. }. sql
f610: 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 ite3DebugPrintf(
f620: 0a 20 20 20 20 20 20 20 22 54 45 52 4d 2d 25 2d . "TERM-%-
f630: 33 64 20 25 70 20 25 73 20 25 2d 31 32 73 20 70 3d %p %s %-12s p
f640: 72 6f 62 3d 25 2d 33 64 20 6f 70 3d 30 78 25 30 rob=%-3d op=0x%0
f650: 33 78 20 77 74 46 6c 61 67 73 3d 30 78 25 30 34 3x wtFlags=0x%04
f660: 78 22 2c 0a 20 20 20 20 20 20 20 69 54 65 72 6d x",. iTerm
f670: 2c 20 70 54 65 72 6d 2c 20 7a 54 79 70 65 2c 20 , pTerm, zType,
f680: 7a 4c 65 66 74 2c 20 70 54 65 72 6d 2d 3e 74 72 zLeft, pTerm->tr
f690: 75 74 68 50 72 6f 62 2c 0a 20 20 20 20 20 20 20 uthProb,.
f6a0: 70 54 65 72 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 pTerm->eOperator
f6b0: 2c 20 70 54 65 72 6d 2d 3e 77 74 46 6c 61 67 73 , pTerm->wtFlags
f6c0: 29 3b 0a 20 20 20 20 69 66 28 20 70 54 65 72 6d );. if( pTerm
f6d0: 2d 3e 69 46 69 65 6c 64 20 29 7b 0a 20 20 20 20 ->iField ){.
f6e0: 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 sqlite3DebugPr
f6f0: 69 6e 74 66 28 22 20 69 46 69 65 6c 64 3d 25 64 intf(" iField=%d
f700: 5c 6e 22 2c 20 70 54 65 72 6d 2d 3e 69 46 69 65 \n", pTerm->iFie
f710: 6c 64 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a ld);. }else{.
f720: 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 65 62 sqlite3Deb
f730: 75 67 50 72 69 6e 74 66 28 22 5c 6e 22 29 3b 0a ugPrintf("\n");.
f740: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 }. sqlite
f750: 33 54 72 65 65 56 69 65 77 45 78 70 72 28 30 2c 3TreeViewExpr(0,
f760: 20 70 54 65 72 6d 2d 3e 70 45 78 70 72 2c 20 30 pTerm->pExpr, 0
f770: 29 3b 0a 20 20 7d 0a 7d 0a 23 65 6e 64 69 66 0a );. }.}.#endif.
f780: 0a 23 69 66 64 65 66 20 57 48 45 52 45 54 52 41 .#ifdef WHERETRA
f790: 43 45 5f 45 4e 41 42 4c 45 44 0a 2f 2a 0a 2a 2a CE_ENABLED./*.**
f7a0: 20 53 68 6f 77 20 74 68 65 20 63 6f 6d 70 6c 65 Show the comple
f7b0: 74 65 20 63 6f 6e 74 65 6e 74 20 6f 66 20 61 20 te content of a
f7c0: 57 68 65 72 65 43 6c 61 75 73 65 0a 2a 2f 0a 76 WhereClause.*/.v
f7d0: 6f 69 64 20 73 71 6c 69 74 65 33 57 68 65 72 65 oid sqlite3Where
f7e0: 43 6c 61 75 73 65 50 72 69 6e 74 28 57 68 65 72 ClausePrint(Wher
f7f0: 65 43 6c 61 75 73 65 20 2a 70 57 43 29 7b 0a 20 eClause *pWC){.
f800: 20 69 6e 74 20 69 3b 0a 20 20 66 6f 72 28 69 3d int i;. for(i=
f810: 30 3b 20 69 3c 70 57 43 2d 3e 6e 54 65 72 6d 3b 0; i<pWC->nTerm;
f820: 20 69 2b 2b 29 7b 0a 20 20 20 20 77 68 65 72 65 i++){. where
f830: 54 65 72 6d 50 72 69 6e 74 28 26 70 57 43 2d 3e TermPrint(&pWC->
f840: 61 5b 69 5d 2c 20 69 29 3b 0a 20 20 7d 0a 7d 0a a[i], i);. }.}.
f850: 23 65 6e 64 69 66 0a 0a 23 69 66 64 65 66 20 57 #endif..#ifdef W
f860: 48 45 52 45 54 52 41 43 45 5f 45 4e 41 42 4c 45 HERETRACE_ENABLE
f870: 44 0a 2f 2a 0a 2a 2a 20 50 72 69 6e 74 20 61 20 D./*.** Print a
f880: 57 68 65 72 65 4c 6f 6f 70 20 6f 62 6a 65 63 74 WhereLoop object
f890: 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 20 70 for debugging p
f8a0: 75 72 70 6f 73 65 73 0a 2a 2f 0a 73 74 61 74 69 urposes.*/.stati
f8b0: 63 20 76 6f 69 64 20 77 68 65 72 65 4c 6f 6f 70 c void whereLoop
f8c0: 50 72 69 6e 74 28 57 68 65 72 65 4c 6f 6f 70 20 Print(WhereLoop
f8d0: 2a 70 2c 20 57 68 65 72 65 43 6c 61 75 73 65 20 *p, WhereClause
f8e0: 2a 70 57 43 29 7b 0a 20 20 57 68 65 72 65 49 6e *pWC){. WhereIn
f8f0: 66 6f 20 2a 70 57 49 6e 66 6f 20 3d 20 70 57 43 fo *pWInfo = pWC
f900: 2d 3e 70 57 49 6e 66 6f 3b 0a 20 20 69 6e 74 20 ->pWInfo;. int
f910: 6e 62 20 3d 20 31 2b 28 70 57 49 6e 66 6f 2d 3e nb = 1+(pWInfo->
f920: 70 54 61 62 4c 69 73 74 2d 3e 6e 53 72 63 2b 33 pTabList->nSrc+3
f930: 29 2f 34 3b 0a 20 20 73 74 72 75 63 74 20 53 72 )/4;. struct Sr
f940: 63 4c 69 73 74 5f 69 74 65 6d 20 2a 70 49 74 65 cList_item *pIte
f950: 6d 20 3d 20 70 57 49 6e 66 6f 2d 3e 70 54 61 62 m = pWInfo->pTab
f960: 4c 69 73 74 2d 3e 61 20 2b 20 70 2d 3e 69 54 61 List->a + p->iTa
f970: 62 3b 0a 20 20 54 61 62 6c 65 20 2a 70 54 61 62 b;. Table *pTab
f980: 20 3d 20 70 49 74 65 6d 2d 3e 70 54 61 62 3b 0a = pItem->pTab;.
f990: 20 20 42 69 74 6d 61 73 6b 20 6d 41 6c 6c 20 3d Bitmask mAll =
f9a0: 20 28 28 28 42 69 74 6d 61 73 6b 29 31 29 3c 3c (((Bitmask)1)<<
f9b0: 28 6e 62 2a 34 29 29 20 2d 20 31 3b 0a 20 20 73 (nb*4)) - 1;. s
f9c0: 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 qlite3DebugPrint
f9d0: 66 28 22 25 63 25 32 64 2e 25 30 2a 6c 6c 78 2e f("%c%2d.%0*llx.
f9e0: 25 30 2a 6c 6c 78 22 2c 20 70 2d 3e 63 49 64 2c %0*llx", p->cId,
f9f0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
fa00: 20 20 20 20 20 20 70 2d 3e 69 54 61 62 2c 20 6e p->iTab, n
fa10: 62 2c 20 70 2d 3e 6d 61 73 6b 53 65 6c 66 2c 20 b, p->maskSelf,
fa20: 6e 62 2c 20 70 2d 3e 70 72 65 72 65 71 20 26 20 nb, p->prereq &
fa30: 6d 41 6c 6c 29 3b 0a 20 20 73 71 6c 69 74 65 33 mAll);. sqlite3
fa40: 44 65 62 75 67 50 72 69 6e 74 66 28 22 20 25 31 DebugPrintf(" %1
fa50: 32 73 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 2s",.
fa60: 20 20 20 20 20 20 20 20 20 20 70 49 74 65 6d 2d pItem-
fa70: 3e 7a 41 6c 69 61 73 20 3f 20 70 49 74 65 6d 2d >zAlias ? pItem-
fa80: 3e 7a 41 6c 69 61 73 20 3a 20 70 54 61 62 2d 3e >zAlias : pTab->
fa90: 7a 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 28 70 zName);. if( (p
faa0: 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 ->wsFlags & WHER
fab0: 45 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 29 3d E_VIRTUALTABLE)=
fac0: 3d 30 20 29 7b 0a 20 20 20 20 63 6f 6e 73 74 20 =0 ){. const
fad0: 63 68 61 72 20 2a 7a 4e 61 6d 65 3b 0a 20 20 20 char *zName;.
fae0: 20 69 66 28 20 70 2d 3e 75 2e 62 74 72 65 65 2e if( p->u.btree.
faf0: 70 49 6e 64 65 78 20 26 26 20 28 7a 4e 61 6d 65 pIndex && (zName
fb00: 20 3d 20 70 2d 3e 75 2e 62 74 72 65 65 2e 70 49 = p->u.btree.pI
fb10: 6e 64 65 78 2d 3e 7a 4e 61 6d 65 29 21 3d 30 20 ndex->zName)!=0
fb20: 29 7b 0a 20 20 20 20 20 20 69 66 28 20 73 74 72 ){. if( str
fb30: 6e 63 6d 70 28 7a 4e 61 6d 65 2c 20 22 73 71 6c ncmp(zName, "sql
fb40: 69 74 65 5f 61 75 74 6f 69 6e 64 65 78 5f 22 2c ite_autoindex_",
fb50: 20 31 37 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 17)==0 ){.
fb60: 20 20 20 69 6e 74 20 69 20 3d 20 73 71 6c 69 74 int i = sqlit
fb70: 65 33 53 74 72 6c 65 6e 33 30 28 7a 4e 61 6d 65 e3Strlen30(zName
fb80: 29 20 2d 20 31 3b 0a 20 20 20 20 20 20 20 20 77 ) - 1;. w
fb90: 68 69 6c 65 28 20 7a 4e 61 6d 65 5b 69 5d 21 3d hile( zName[i]!=
fba0: 27 5f 27 20 29 20 69 2d 2d 3b 0a 20 20 20 20 20 '_' ) i--;.
fbb0: 20 20 20 7a 4e 61 6d 65 20 2b 3d 20 69 3b 0a 20 zName += i;.
fbc0: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c }. sql
fbd0: 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 ite3DebugPrintf(
fbe0: 22 2e 25 2d 31 36 73 20 25 32 64 22 2c 20 7a 4e ".%-16s %2d", zN
fbf0: 61 6d 65 2c 20 70 2d 3e 75 2e 62 74 72 65 65 2e ame, p->u.btree.
fc00: 6e 45 71 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b nEq);. }else{
fc10: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 65 . sqlite3De
fc20: 62 75 67 50 72 69 6e 74 66 28 22 25 32 30 73 22 bugPrintf("%20s"
fc30: 2c 22 22 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 ,"");. }. }e
fc40: 6c 73 65 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a lse{. char *z
fc50: 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 75 2e 76 ;. if( p->u.v
fc60: 74 61 62 2e 69 64 78 53 74 72 20 29 7b 0a 20 20 tab.idxStr ){.
fc70: 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f z = sqlite3_
fc80: 6d 70 72 69 6e 74 66 28 22 28 25 64 2c 5c 22 25 mprintf("(%d,\"%
fc90: 73 5c 22 2c 25 78 29 22 2c 0a 20 20 20 20 20 20 s\",%x)",.
fca0: 20 20 20 20 20 20 20 20 20 20 70 2d 3e 75 2e 76 p->u.v
fcb0: 74 61 62 2e 69 64 78 4e 75 6d 2c 20 70 2d 3e 75 tab.idxNum, p->u
fcc0: 2e 76 74 61 62 2e 69 64 78 53 74 72 2c 20 70 2d .vtab.idxStr, p-
fcd0: 3e 75 2e 76 74 61 62 2e 6f 6d 69 74 4d 61 73 6b >u.vtab.omitMask
fce0: 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 );. }else{.
fcf0: 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 5f z = sqlite3_
fd00: 6d 70 72 69 6e 74 66 28 22 28 25 64 2c 25 78 29 mprintf("(%d,%x)
fd10: 22 2c 20 70 2d 3e 75 2e 76 74 61 62 2e 69 64 78 ", p->u.vtab.idx
fd20: 4e 75 6d 2c 20 70 2d 3e 75 2e 76 74 61 62 2e 6f Num, p->u.vtab.o
fd30: 6d 69 74 4d 61 73 6b 29 3b 0a 20 20 20 20 7d 0a mitMask);. }.
fd40: 20 20 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 sqlite3Debug
fd50: 50 72 69 6e 74 66 28 22 20 25 2d 31 39 73 22 2c Printf(" %-19s",
fd60: 20 7a 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 z);. sqlite3
fd70: 5f 66 72 65 65 28 7a 29 3b 0a 20 20 7d 0a 20 20 _free(z);. }.
fd80: 69 66 28 20 70 2d 3e 77 73 46 6c 61 67 73 20 26 if( p->wsFlags &
fd90: 20 57 48 45 52 45 5f 53 4b 49 50 53 43 41 4e 20 WHERE_SKIPSCAN
fda0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 65 ){. sqlite3De
fdb0: 62 75 67 50 72 69 6e 74 66 28 22 20 66 20 25 30 bugPrintf(" f %0
fdc0: 35 78 20 25 64 2d 25 64 22 2c 20 70 2d 3e 77 73 5x %d-%d", p->ws
fdd0: 46 6c 61 67 73 2c 20 70 2d 3e 6e 4c 54 65 72 6d Flags, p->nLTerm
fde0: 2c 70 2d 3e 6e 53 6b 69 70 29 3b 0a 20 20 7d 65 ,p->nSkip);. }e
fdf0: 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 lse{. sqlite3
fe00: 44 65 62 75 67 50 72 69 6e 74 66 28 22 20 66 20 DebugPrintf(" f
fe10: 25 30 35 78 20 4e 20 25 64 22 2c 20 70 2d 3e 77 %05x N %d", p->w
fe20: 73 46 6c 61 67 73 2c 20 70 2d 3e 6e 4c 54 65 72 sFlags, p->nLTer
fe30: 6d 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 m);. }. sqlite
fe40: 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 20 63 3DebugPrintf(" c
fe50: 6f 73 74 20 25 64 2c 25 64 2c 25 64 5c 6e 22 2c ost %d,%d,%d\n",
fe60: 20 70 2d 3e 72 53 65 74 75 70 2c 20 70 2d 3e 72 p->rSetup, p->r
fe70: 52 75 6e 2c 20 70 2d 3e 6e 4f 75 74 29 3b 0a 20 Run, p->nOut);.
fe80: 20 69 66 28 20 70 2d 3e 6e 4c 54 65 72 6d 20 26 if( p->nLTerm &
fe90: 26 20 28 73 71 6c 69 74 65 33 57 68 65 72 65 54 & (sqlite3WhereT
fea0: 72 61 63 65 20 26 20 30 78 31 30 30 29 21 3d 30 race & 0x100)!=0
feb0: 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 3b 0a 20 ){. int i;.
fec0: 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 2d for(i=0; i<p-
fed0: 3e 6e 4c 54 65 72 6d 3b 20 69 2b 2b 29 7b 0a 20 >nLTerm; i++){.
fee0: 20 20 20 20 20 77 68 65 72 65 54 65 72 6d 50 72 whereTermPr
fef0: 69 6e 74 28 70 2d 3e 61 4c 54 65 72 6d 5b 69 5d int(p->aLTerm[i]
ff00: 2c 20 69 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a , i);. }. }.
ff10: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20 }.#endif../*.**
ff20: 43 6f 6e 76 65 72 74 20 62 75 6c 6b 20 6d 65 6d Convert bulk mem
ff30: 6f 72 79 20 69 6e 74 6f 20 61 20 76 61 6c 69 64 ory into a valid
ff40: 20 57 68 65 72 65 4c 6f 6f 70 20 74 68 61 74 20 WhereLoop that
ff50: 63 61 6e 20 62 65 20 70 61 73 73 65 64 0a 2a 2a can be passed.**
ff60: 20 74 6f 20 77 68 65 72 65 4c 6f 6f 70 43 6c 65 to whereLoopCle
ff70: 61 72 20 68 61 72 6d 6c 65 73 73 6c 79 2e 0a 2a ar harmlessly..*
ff80: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 77 68 /.static void wh
ff90: 65 72 65 4c 6f 6f 70 49 6e 69 74 28 57 68 65 72 ereLoopInit(Wher
ffa0: 65 4c 6f 6f 70 20 2a 70 29 7b 0a 20 20 70 2d 3e eLoop *p){. p->
ffb0: 61 4c 54 65 72 6d 20 3d 20 70 2d 3e 61 4c 54 65 aLTerm = p->aLTe
ffc0: 72 6d 53 70 61 63 65 3b 0a 20 20 70 2d 3e 6e 4c rmSpace;. p->nL
ffd0: 54 65 72 6d 20 3d 20 30 3b 0a 20 20 70 2d 3e 6e Term = 0;. p->n
ffe0: 4c 53 6c 6f 74 20 3d 20 41 72 72 61 79 53 69 7a LSlot = ArraySiz
fff0: 65 28 70 2d 3e 61 4c 54 65 72 6d 53 70 61 63 65 e(p->aLTermSpace
10000 29 3b 0a 20 20 70 2d 3e 77 73 46 6c 61 67 73 20 );. p->wsFlags
10010 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6c = 0;.}../*.** Cl
10020 65 61 72 20 74 68 65 20 57 68 65 72 65 4c 6f 6f ear the WhereLoo
10030 70 2e 75 20 75 6e 69 6f 6e 2e 20 20 4c 65 61 76 p.u union. Leav
10040 65 20 57 68 65 72 65 4c 6f 6f 70 2e 70 4c 54 65 e WhereLoop.pLTe
10050 72 6d 20 69 6e 74 61 63 74 2e 0a 2a 2f 0a 73 74 rm intact..*/.st
10060 61 74 69 63 20 76 6f 69 64 20 77 68 65 72 65 4c atic void whereL
10070 6f 6f 70 43 6c 65 61 72 55 6e 69 6f 6e 28 73 71 oopClearUnion(sq
10080 6c 69 74 65 33 20 2a 64 62 2c 20 57 68 65 72 65 lite3 *db, Where
10090 4c 6f 6f 70 20 2a 70 29 7b 0a 20 20 69 66 28 20 Loop *p){. if(
100a0 70 2d 3e 77 73 46 6c 61 67 73 20 26 20 28 57 48 p->wsFlags & (WH
100b0 45 52 45 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 ERE_VIRTUALTABLE
100c0 7c 57 48 45 52 45 5f 41 55 54 4f 5f 49 4e 44 45 |WHERE_AUTO_INDE
100d0 58 29 20 29 7b 0a 20 20 20 20 69 66 28 20 28 70 X) ){. if( (p
100e0 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 ->wsFlags & WHER
100f0 45 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 29 21 E_VIRTUALTABLE)!
10100 3d 30 20 26 26 20 70 2d 3e 75 2e 76 74 61 62 2e =0 && p->u.vtab.
10110 6e 65 65 64 46 72 65 65 20 29 7b 0a 20 20 20 20 needFree ){.
10120 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 sqlite3_free(p
10130 2d 3e 75 2e 76 74 61 62 2e 69 64 78 53 74 72 29 ->u.vtab.idxStr)
10140 3b 0a 20 20 20 20 20 20 70 2d 3e 75 2e 76 74 61 ;. p->u.vta
10150 62 2e 6e 65 65 64 46 72 65 65 20 3d 20 30 3b 0a b.needFree = 0;.
10160 20 20 20 20 20 20 70 2d 3e 75 2e 76 74 61 62 2e p->u.vtab.
10170 69 64 78 53 74 72 20 3d 20 30 3b 0a 20 20 20 20 idxStr = 0;.
10180 7d 65 6c 73 65 20 69 66 28 20 28 70 2d 3e 77 73 }else if( (p->ws
10190 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f 41 55 Flags & WHERE_AU
101a0 54 4f 5f 49 4e 44 45 58 29 21 3d 30 20 26 26 20 TO_INDEX)!=0 &&
101b0 70 2d 3e 75 2e 62 74 72 65 65 2e 70 49 6e 64 65 p->u.btree.pInde
101c0 78 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 73 71 x!=0 ){. sq
101d0 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 lite3DbFree(db,
101e0 70 2d 3e 75 2e 62 74 72 65 65 2e 70 49 6e 64 65 p->u.btree.pInde
101f0 78 2d 3e 7a 43 6f 6c 41 66 66 29 3b 0a 20 20 20 x->zColAff);.
10200 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 sqlite3DbFree
10210 4e 4e 28 64 62 2c 20 70 2d 3e 75 2e 62 74 72 65 NN(db, p->u.btre
10220 65 2e 70 49 6e 64 65 78 29 3b 0a 20 20 20 20 20 e.pIndex);.
10230 20 70 2d 3e 75 2e 62 74 72 65 65 2e 70 49 6e 64 p->u.btree.pInd
10240 65 78 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20 20 ex = 0;. }.
10250 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 44 65 61 6c 6c }.}../*.** Deall
10260 6f 63 61 74 65 20 69 6e 74 65 72 6e 61 6c 20 6d ocate internal m
10270 65 6d 6f 72 79 20 75 73 65 64 20 62 79 20 61 20 emory used by a
10280 57 68 65 72 65 4c 6f 6f 70 20 6f 62 6a 65 63 74 WhereLoop object
10290 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
102a0 77 68 65 72 65 4c 6f 6f 70 43 6c 65 61 72 28 73 whereLoopClear(s
102b0 71 6c 69 74 65 33 20 2a 64 62 2c 20 57 68 65 72 qlite3 *db, Wher
102c0 65 4c 6f 6f 70 20 2a 70 29 7b 0a 20 20 69 66 28 eLoop *p){. if(
102d0 20 70 2d 3e 61 4c 54 65 72 6d 21 3d 70 2d 3e 61 p->aLTerm!=p->a
102e0 4c 54 65 72 6d 53 70 61 63 65 20 29 20 73 71 6c LTermSpace ) sql
102f0 69 74 65 33 44 62 46 72 65 65 4e 4e 28 64 62 2c ite3DbFreeNN(db,
10300 20 70 2d 3e 61 4c 54 65 72 6d 29 3b 0a 20 20 77 p->aLTerm);. w
10310 68 65 72 65 4c 6f 6f 70 43 6c 65 61 72 55 6e 69 hereLoopClearUni
10320 6f 6e 28 64 62 2c 20 70 29 3b 0a 20 20 77 68 65 on(db, p);. whe
10330 72 65 4c 6f 6f 70 49 6e 69 74 28 70 29 3b 0a 7d reLoopInit(p);.}
10340 0a 0a 2f 2a 0a 2a 2a 20 49 6e 63 72 65 61 73 65 ../*.** Increase
10350 20 74 68 65 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f the memory allo
10360 63 61 74 69 6f 6e 20 66 6f 72 20 70 4c 6f 6f 70 cation for pLoop
10370 2d 3e 61 4c 54 65 72 6d 5b 5d 20 74 6f 20 62 65 ->aLTerm[] to be
10380 20 61 74 20 6c 65 61 73 74 20 6e 2e 0a 2a 2f 0a at least n..*/.
10390 73 74 61 74 69 63 20 69 6e 74 20 77 68 65 72 65 static int where
103a0 4c 6f 6f 70 52 65 73 69 7a 65 28 73 71 6c 69 74 LoopResize(sqlit
103b0 65 33 20 2a 64 62 2c 20 57 68 65 72 65 4c 6f 6f e3 *db, WhereLoo
103c0 70 20 2a 70 2c 20 69 6e 74 20 6e 29 7b 0a 20 20 p *p, int n){.
103d0 57 68 65 72 65 54 65 72 6d 20 2a 2a 70 61 4e 65 WhereTerm **paNe
103e0 77 3b 0a 20 20 69 66 28 20 70 2d 3e 6e 4c 53 6c w;. if( p->nLSl
103f0 6f 74 3e 3d 6e 20 29 20 72 65 74 75 72 6e 20 53 ot>=n ) return S
10400 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 6e 20 3d 20 QLITE_OK;. n =
10410 28 6e 2b 37 29 26 7e 37 3b 0a 20 20 70 61 4e 65 (n+7)&~7;. paNe
10420 77 20 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c w = sqlite3DbMal
10430 6c 6f 63 52 61 77 4e 4e 28 64 62 2c 20 73 69 7a locRawNN(db, siz
10440 65 6f 66 28 70 2d 3e 61 4c 54 65 72 6d 5b 30 5d eof(p->aLTerm[0]
10450 29 2a 6e 29 3b 0a 20 20 69 66 28 20 70 61 4e 65 )*n);. if( paNe
10460 77 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 w==0 ) return SQ
10470 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
10480 0a 20 20 6d 65 6d 63 70 79 28 70 61 4e 65 77 2c . memcpy(paNew,
10490 20 70 2d 3e 61 4c 54 65 72 6d 2c 20 73 69 7a 65 p->aLTerm, size
104a0 6f 66 28 70 2d 3e 61 4c 54 65 72 6d 5b 30 5d 29 of(p->aLTerm[0])
104b0 2a 70 2d 3e 6e 4c 53 6c 6f 74 29 3b 0a 20 20 69 *p->nLSlot);. i
104c0 66 28 20 70 2d 3e 61 4c 54 65 72 6d 21 3d 70 2d f( p->aLTerm!=p-
104d0 3e 61 4c 54 65 72 6d 53 70 61 63 65 20 29 20 73 >aLTermSpace ) s
104e0 71 6c 69 74 65 33 44 62 46 72 65 65 4e 4e 28 64 qlite3DbFreeNN(d
104f0 62 2c 20 70 2d 3e 61 4c 54 65 72 6d 29 3b 0a 20 b, p->aLTerm);.
10500 20 70 2d 3e 61 4c 54 65 72 6d 20 3d 20 70 61 4e p->aLTerm = paN
10510 65 77 3b 0a 20 20 70 2d 3e 6e 4c 53 6c 6f 74 20 ew;. p->nLSlot
10520 3d 20 6e 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 = n;. return SQ
10530 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a LITE_OK;.}../*.*
10540 2a 20 54 72 61 6e 73 66 65 72 20 63 6f 6e 74 65 * Transfer conte
10550 6e 74 20 66 72 6f 6d 20 74 68 65 20 73 65 63 6f nt from the seco
10560 6e 64 20 70 4c 6f 6f 70 20 69 6e 74 6f 20 74 68 nd pLoop into th
10570 65 20 66 69 72 73 74 2e 0a 2a 2f 0a 73 74 61 74 e first..*/.stat
10580 69 63 20 69 6e 74 20 77 68 65 72 65 4c 6f 6f 70 ic int whereLoop
10590 58 66 65 72 28 73 71 6c 69 74 65 33 20 2a 64 62 Xfer(sqlite3 *db
105a0 2c 20 57 68 65 72 65 4c 6f 6f 70 20 2a 70 54 6f , WhereLoop *pTo
105b0 2c 20 57 68 65 72 65 4c 6f 6f 70 20 2a 70 46 72 , WhereLoop *pFr
105c0 6f 6d 29 7b 0a 20 20 77 68 65 72 65 4c 6f 6f 70 om){. whereLoop
105d0 43 6c 65 61 72 55 6e 69 6f 6e 28 64 62 2c 20 70 ClearUnion(db, p
105e0 54 6f 29 3b 0a 20 20 69 66 28 20 77 68 65 72 65 To);. if( where
105f0 4c 6f 6f 70 52 65 73 69 7a 65 28 64 62 2c 20 70 LoopResize(db, p
10600 54 6f 2c 20 70 46 72 6f 6d 2d 3e 6e 4c 54 65 72 To, pFrom->nLTer
10610 6d 29 20 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74 m) ){. memset
10620 28 26 70 54 6f 2d 3e 75 2c 20 30 2c 20 73 69 7a (&pTo->u, 0, siz
10630 65 6f 66 28 70 54 6f 2d 3e 75 29 29 3b 0a 20 20 eof(pTo->u));.
10640 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f return SQLITE_
10650 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a NOMEM_BKPT;. }.
10660 20 20 6d 65 6d 63 70 79 28 70 54 6f 2c 20 70 46 memcpy(pTo, pF
10670 72 6f 6d 2c 20 57 48 45 52 45 5f 4c 4f 4f 50 5f rom, WHERE_LOOP_
10680 58 46 45 52 5f 53 5a 29 3b 0a 20 20 6d 65 6d 63 XFER_SZ);. memc
10690 70 79 28 70 54 6f 2d 3e 61 4c 54 65 72 6d 2c 20 py(pTo->aLTerm,
106a0 70 46 72 6f 6d 2d 3e 61 4c 54 65 72 6d 2c 20 70 pFrom->aLTerm, p
106b0 54 6f 2d 3e 6e 4c 54 65 72 6d 2a 73 69 7a 65 6f To->nLTerm*sizeo
106c0 66 28 70 54 6f 2d 3e 61 4c 54 65 72 6d 5b 30 5d f(pTo->aLTerm[0]
106d0 29 29 3b 0a 20 20 69 66 28 20 70 46 72 6f 6d 2d ));. if( pFrom-
106e0 3e 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 45 >wsFlags & WHERE
106f0 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 20 29 7b _VIRTUALTABLE ){
10700 0a 20 20 20 20 70 46 72 6f 6d 2d 3e 75 2e 76 74 . pFrom->u.vt
10710 61 62 2e 6e 65 65 64 46 72 65 65 20 3d 20 30 3b ab.needFree = 0;
10720 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 28 70 46 . }else if( (pF
10730 72 6f 6d 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 rom->wsFlags & W
10740 48 45 52 45 5f 41 55 54 4f 5f 49 4e 44 45 58 29 HERE_AUTO_INDEX)
10750 21 3d 30 20 29 7b 0a 20 20 20 20 70 46 72 6f 6d !=0 ){. pFrom
10760 2d 3e 75 2e 62 74 72 65 65 2e 70 49 6e 64 65 78 ->u.btree.pIndex
10770 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 = 0;. }. retu
10780 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a rn SQLITE_OK;.}.
10790 0a 2f 2a 0a 2a 2a 20 44 65 6c 65 74 65 20 61 20 ./*.** Delete a
107a0 57 68 65 72 65 4c 6f 6f 70 20 6f 62 6a 65 63 74 WhereLoop object
107b0 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 .*/.static void
107c0 77 68 65 72 65 4c 6f 6f 70 44 65 6c 65 74 65 28 whereLoopDelete(
107d0 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 57 68 65 sqlite3 *db, Whe
107e0 72 65 4c 6f 6f 70 20 2a 70 29 7b 0a 20 20 77 68 reLoop *p){. wh
107f0 65 72 65 4c 6f 6f 70 43 6c 65 61 72 28 64 62 2c ereLoopClear(db,
10800 20 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 44 62 p);. sqlite3Db
10810 46 72 65 65 4e 4e 28 64 62 2c 20 70 29 3b 0a 7d FreeNN(db, p);.}
10820 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 20 57 ../*.** Free a W
10830 68 65 72 65 49 6e 66 6f 20 73 74 72 75 63 74 75 hereInfo structu
10840 72 65 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 re.*/.static voi
10850 64 20 77 68 65 72 65 49 6e 66 6f 46 72 65 65 28 d whereInfoFree(
10860 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 57 68 65 sqlite3 *db, Whe
10870 72 65 49 6e 66 6f 20 2a 70 57 49 6e 66 6f 29 7b reInfo *pWInfo){
10880 0a 20 20 69 6e 74 20 69 3b 0a 20 20 61 73 73 65 . int i;. asse
10890 72 74 28 20 70 57 49 6e 66 6f 21 3d 30 20 29 3b rt( pWInfo!=0 );
108a0 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 70 57 . for(i=0; i<pW
108b0 49 6e 66 6f 2d 3e 6e 4c 65 76 65 6c 3b 20 69 2b Info->nLevel; i+
108c0 2b 29 7b 0a 20 20 20 20 57 68 65 72 65 4c 65 76 +){. WhereLev
108d0 65 6c 20 2a 70 4c 65 76 65 6c 20 3d 20 26 70 57 el *pLevel = &pW
108e0 49 6e 66 6f 2d 3e 61 5b 69 5d 3b 0a 20 20 20 20 Info->a[i];.
108f0 69 66 28 20 70 4c 65 76 65 6c 2d 3e 70 57 4c 6f if( pLevel->pWLo
10900 6f 70 20 26 26 20 28 70 4c 65 76 65 6c 2d 3e 70 op && (pLevel->p
10910 57 4c 6f 6f 70 2d 3e 77 73 46 6c 61 67 73 20 26 WLoop->wsFlags &
10920 20 57 48 45 52 45 5f 49 4e 5f 41 42 4c 45 29 20 WHERE_IN_ABLE)
10930 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
10940 44 62 46 72 65 65 28 64 62 2c 20 70 4c 65 76 65 DbFree(db, pLeve
10950 6c 2d 3e 75 2e 69 6e 2e 61 49 6e 4c 6f 6f 70 29 l->u.in.aInLoop)
10960 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 73 71 ;. }. }. sq
10970 6c 69 74 65 33 57 68 65 72 65 43 6c 61 75 73 65 lite3WhereClause
10980 43 6c 65 61 72 28 26 70 57 49 6e 66 6f 2d 3e 73 Clear(&pWInfo->s
10990 57 43 29 3b 0a 20 20 77 68 69 6c 65 28 20 70 57 WC);. while( pW
109a0 49 6e 66 6f 2d 3e 70 4c 6f 6f 70 73 20 29 7b 0a Info->pLoops ){.
109b0 20 20 20 20 57 68 65 72 65 4c 6f 6f 70 20 2a 70 WhereLoop *p
109c0 20 3d 20 70 57 49 6e 66 6f 2d 3e 70 4c 6f 6f 70 = pWInfo->pLoop
109d0 73 3b 0a 20 20 20 20 70 57 49 6e 66 6f 2d 3e 70 s;. pWInfo->p
109e0 4c 6f 6f 70 73 20 3d 20 70 2d 3e 70 4e 65 78 74 Loops = p->pNext
109f0 4c 6f 6f 70 3b 0a 20 20 20 20 77 68 65 72 65 4c Loop;. whereL
10a00 6f 6f 70 44 65 6c 65 74 65 28 64 62 2c 20 70 29 oopDelete(db, p)
10a10 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 44 ;. }. sqlite3D
10a20 62 46 72 65 65 4e 4e 28 64 62 2c 20 70 57 49 6e bFreeNN(db, pWIn
10a30 66 6f 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 fo);.}../*.** Re
10a40 74 75 72 6e 20 54 52 55 45 20 69 66 20 61 6c 6c turn TRUE if all
10a50 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e of the followin
10a60 67 20 61 72 65 20 74 72 75 65 3a 0a 2a 2a 0a 2a g are true:.**.*
10a70 2a 20 20 20 28 31 29 20 20 58 20 68 61 73 20 74 * (1) X has t
10a80 68 65 20 73 61 6d 65 20 6f 72 20 6c 6f 77 65 72 he same or lower
10a90 20 63 6f 73 74 20 74 68 61 74 20 59 0a 2a 2a 20 cost that Y.**
10aa0 20 20 28 32 29 20 20 58 20 75 73 65 73 20 66 65 (2) X uses fe
10ab0 77 65 72 20 57 48 45 52 45 20 63 6c 61 75 73 65 wer WHERE clause
10ac0 20 74 65 72 6d 73 20 74 68 61 6e 20 59 0a 2a 2a terms than Y.**
10ad0 20 20 20 28 33 29 20 20 45 76 65 72 79 20 57 48 (3) Every WH
10ae0 45 52 45 20 63 6c 61 75 73 65 20 74 65 72 6d 20 ERE clause term
10af0 75 73 65 64 20 62 79 20 58 20 69 73 20 61 6c 73 used by X is als
10b00 6f 20 75 73 65 64 20 62 79 20 59 0a 2a 2a 20 20 o used by Y.**
10b10 20 28 34 29 20 20 58 20 73 6b 69 70 73 20 61 74 (4) X skips at
10b20 20 6c 65 61 73 74 20 61 73 20 6d 61 6e 79 20 63 least as many c
10b30 6f 6c 75 6d 6e 73 20 61 73 20 59 0a 2a 2a 20 20 olumns as Y.**
10b40 20 28 35 29 20 20 49 66 20 58 20 69 73 20 61 20 (5) If X is a
10b50 63 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 2c 20 covering index,
10b60 74 68 61 6e 20 59 20 69 73 20 74 6f 6f 0a 2a 2a than Y is too.**
10b70 0a 2a 2a 20 43 6f 6e 64 69 74 69 6f 6e 73 20 28 .** Conditions (
10b80 32 29 20 61 6e 64 20 28 33 29 20 6d 65 61 6e 20 2) and (3) mean
10b90 74 68 61 74 20 58 20 69 73 20 61 20 22 70 72 6f that X is a "pro
10ba0 70 65 72 20 73 75 62 73 65 74 22 20 6f 66 20 59 per subset" of Y
10bb0 2e 0a 2a 2a 20 49 66 20 58 20 69 73 20 61 20 70 ..** If X is a p
10bc0 72 6f 70 65 72 20 73 75 62 73 65 74 20 6f 66 20 roper subset of
10bd0 59 20 74 68 65 6e 20 59 20 69 73 20 61 20 62 65 Y then Y is a be
10be0 74 74 65 72 20 63 68 6f 69 63 65 20 61 6e 64 20 tter choice and
10bf0 6f 75 67 68 74 0a 2a 2a 20 74 6f 20 68 61 76 65 ought.** to have
10c00 20 61 20 6c 6f 77 65 72 20 63 6f 73 74 2e 20 20 a lower cost.
10c10 54 68 69 73 20 72 6f 75 74 69 6e 65 20 72 65 74 This routine ret
10c20 75 72 6e 73 20 54 52 55 45 20 77 68 65 6e 20 74 urns TRUE when t
10c30 68 61 74 20 63 6f 73 74 20 0a 2a 2a 20 72 65 6c hat cost .** rel
10c40 61 74 69 6f 6e 73 68 69 70 20 69 73 20 69 6e 76 ationship is inv
10c50 65 72 74 65 64 20 61 6e 64 20 6e 65 65 64 73 20 erted and needs
10c60 74 6f 20 62 65 20 61 64 6a 75 73 74 65 64 2e 20 to be adjusted.
10c70 20 43 6f 6e 73 74 72 61 69 6e 74 20 28 34 29 0a Constraint (4).
10c80 2a 2a 20 77 61 73 20 61 64 64 65 64 20 62 65 63 ** was added bec
10c90 61 75 73 65 20 69 66 20 58 20 75 73 65 73 20 73 ause if X uses s
10ca0 6b 69 70 2d 73 63 61 6e 20 6c 65 73 73 20 74 68 kip-scan less th
10cb0 61 6e 20 59 20 69 74 20 73 74 69 6c 6c 20 6d 69 an Y it still mi
10cc0 67 68 74 0a 2a 2a 20 64 65 73 65 72 76 65 20 61 ght.** deserve a
10cd0 20 6c 6f 77 65 72 20 63 6f 73 74 20 65 76 65 6e lower cost even
10ce0 20 69 66 20 69 74 20 69 73 20 61 20 70 72 6f 70 if it is a prop
10cf0 65 72 20 73 75 62 73 65 74 20 6f 66 20 59 2e 20 er subset of Y.
10d00 20 43 6f 6e 73 74 72 61 69 6e 74 20 28 35 29 0a Constraint (5).
10d10 2a 2a 20 77 61 73 20 61 64 64 65 64 20 62 65 63 ** was added bec
10d20 61 75 73 65 20 61 20 63 6f 76 65 72 69 6e 67 20 ause a covering
10d30 69 6e 64 65 78 20 70 72 6f 62 61 62 6c 79 20 64 index probably d
10d40 65 73 65 72 76 65 73 20 74 6f 20 68 61 76 65 20 eserves to have
10d50 61 20 6c 6f 77 65 72 20 63 6f 73 74 0a 2a 2a 20 a lower cost.**
10d60 74 68 61 6e 20 61 20 6e 6f 6e 2d 63 6f 76 65 72 than a non-cover
10d70 69 6e 67 20 69 6e 64 65 78 20 65 76 65 6e 20 69 ing index even i
10d80 66 20 69 74 20 69 73 20 61 20 70 72 6f 70 65 72 f it is a proper
10d90 20 73 75 62 73 65 74 2e 0a 2a 2f 0a 73 74 61 74 subset..*/.stat
10da0 69 63 20 69 6e 74 20 77 68 65 72 65 4c 6f 6f 70 ic int whereLoop
10db0 43 68 65 61 70 65 72 50 72 6f 70 65 72 53 75 62 CheaperProperSub
10dc0 73 65 74 28 0a 20 20 63 6f 6e 73 74 20 57 68 65 set(. const Whe
10dd0 72 65 4c 6f 6f 70 20 2a 70 58 2c 20 20 20 20 20 reLoop *pX,
10de0 20 20 2f 2a 20 46 69 72 73 74 20 57 68 65 72 65 /* First Where
10df0 4c 6f 6f 70 20 74 6f 20 63 6f 6d 70 61 72 65 20 Loop to compare
10e00 2a 2f 0a 20 20 63 6f 6e 73 74 20 57 68 65 72 65 */. const Where
10e10 4c 6f 6f 70 20 2a 70 59 20 20 20 20 20 20 20 20 Loop *pY
10e20 2f 2a 20 43 6f 6d 70 61 72 65 20 61 67 61 69 6e /* Compare again
10e30 73 74 20 74 68 69 73 20 57 68 65 72 65 4c 6f 6f st this WhereLoo
10e40 70 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 69 2c p */.){. int i,
10e50 20 6a 3b 0a 20 20 69 66 28 20 70 58 2d 3e 6e 4c j;. if( pX->nL
10e60 54 65 72 6d 2d 70 58 2d 3e 6e 53 6b 69 70 20 3e Term-pX->nSkip >
10e70 3d 20 70 59 2d 3e 6e 4c 54 65 72 6d 2d 70 59 2d = pY->nLTerm-pY-
10e80 3e 6e 53 6b 69 70 20 29 7b 0a 20 20 20 20 72 65 >nSkip ){. re
10e90 74 75 72 6e 20 30 3b 20 2f 2a 20 58 20 69 73 20 turn 0; /* X is
10ea0 6e 6f 74 20 61 20 73 75 62 73 65 74 20 6f 66 20 not a subset of
10eb0 59 20 2a 2f 0a 20 20 7d 0a 20 20 69 66 28 20 70 Y */. }. if( p
10ec0 59 2d 3e 6e 53 6b 69 70 20 3e 20 70 58 2d 3e 6e Y->nSkip > pX->n
10ed0 53 6b 69 70 20 29 20 72 65 74 75 72 6e 20 30 3b Skip ) return 0;
10ee0 0a 20 20 69 66 28 20 70 58 2d 3e 72 52 75 6e 20 . if( pX->rRun
10ef0 3e 3d 20 70 59 2d 3e 72 52 75 6e 20 29 7b 0a 20 >= pY->rRun ){.
10f00 20 20 20 69 66 28 20 70 58 2d 3e 72 52 75 6e 20 if( pX->rRun
10f10 3e 20 70 59 2d 3e 72 52 75 6e 20 29 20 72 65 74 > pY->rRun ) ret
10f20 75 72 6e 20 30 3b 20 20 20 20 2f 2a 20 58 20 63 urn 0; /* X c
10f30 6f 73 74 73 20 6d 6f 72 65 20 74 68 61 6e 20 59 osts more than Y
10f40 20 2a 2f 0a 20 20 20 20 69 66 28 20 70 58 2d 3e */. if( pX->
10f50 6e 4f 75 74 20 3e 20 70 59 2d 3e 6e 4f 75 74 20 nOut > pY->nOut
10f60 29 20 72 65 74 75 72 6e 20 30 3b 20 20 20 20 2f ) return 0; /
10f70 2a 20 58 20 63 6f 73 74 73 20 6d 6f 72 65 20 74 * X costs more t
10f80 68 61 6e 20 59 20 2a 2f 0a 20 20 7d 0a 20 20 66 han Y */. }. f
10f90 6f 72 28 69 3d 70 58 2d 3e 6e 4c 54 65 72 6d 2d or(i=pX->nLTerm-
10fa0 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 29 7b 0a 20 1; i>=0; i--){.
10fb0 20 20 20 69 66 28 20 70 58 2d 3e 61 4c 54 65 72 if( pX->aLTer
10fc0 6d 5b 69 5d 3d 3d 30 20 29 20 63 6f 6e 74 69 6e m[i]==0 ) contin
10fd0 75 65 3b 0a 20 20 20 20 66 6f 72 28 6a 3d 70 59 ue;. for(j=pY
10fe0 2d 3e 6e 4c 54 65 72 6d 2d 31 3b 20 6a 3e 3d 30 ->nLTerm-1; j>=0
10ff0 3b 20 6a 2d 2d 29 7b 0a 20 20 20 20 20 20 69 66 ; j--){. if
11000 28 20 70 59 2d 3e 61 4c 54 65 72 6d 5b 6a 5d 3d ( pY->aLTerm[j]=
11010 3d 70 58 2d 3e 61 4c 54 65 72 6d 5b 69 5d 20 29 =pX->aLTerm[i] )
11020 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 break;. }.
11030 20 20 69 66 28 20 6a 3c 30 20 29 20 72 65 74 75 if( j<0 ) retu
11040 72 6e 20 30 3b 20 20 2f 2a 20 58 20 6e 6f 74 20 rn 0; /* X not
11050 61 20 73 75 62 73 65 74 20 6f 66 20 59 20 73 69 a subset of Y si
11060 6e 63 65 20 74 65 72 6d 20 58 5b 69 5d 20 6e 6f nce term X[i] no
11070 74 20 75 73 65 64 20 62 79 20 59 20 2a 2f 0a 20 t used by Y */.
11080 20 7d 0a 20 20 69 66 28 20 28 70 58 2d 3e 77 73 }. if( (pX->ws
11090 46 6c 61 67 73 26 57 48 45 52 45 5f 49 44 58 5f Flags&WHERE_IDX_
110a0 4f 4e 4c 59 29 21 3d 30 20 0a 20 20 20 26 26 20 ONLY)!=0 . &&
110b0 28 70 59 2d 3e 77 73 46 6c 61 67 73 26 57 48 45 (pY->wsFlags&WHE
110c0 52 45 5f 49 44 58 5f 4f 4e 4c 59 29 3d 3d 30 20 RE_IDX_ONLY)==0
110d0 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 30 3b ){. return 0;
110e0 20 20 2f 2a 20 43 6f 6e 73 74 72 61 69 6e 74 20 /* Constraint
110f0 28 35 29 20 2a 2f 0a 20 20 7d 0a 20 20 72 65 74 (5) */. }. ret
11100 75 72 6e 20 31 3b 20 20 2f 2a 20 41 6c 6c 20 63 urn 1; /* All c
11110 6f 6e 64 69 74 69 6f 6e 73 20 6d 65 65 74 20 2a onditions meet *
11120 2f 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72 79 20 74 /.}../*.** Try t
11130 6f 20 61 64 6a 75 73 74 20 74 68 65 20 63 6f 73 o adjust the cos
11140 74 20 6f 66 20 57 68 65 72 65 4c 6f 6f 70 20 70 t of WhereLoop p
11150 54 65 6d 70 6c 61 74 65 20 75 70 77 61 72 64 73 Template upwards
11160 20 6f 72 20 64 6f 77 6e 77 61 72 64 73 20 73 6f or downwards so
11170 0a 2a 2a 20 74 68 61 74 3a 0a 2a 2a 0a 2a 2a 20 .** that:.**.**
11180 20 20 28 31 29 20 70 54 65 6d 70 6c 61 74 65 20 (1) pTemplate
11190 63 6f 73 74 73 20 6c 65 73 73 20 74 68 61 6e 20 costs less than
111a0 61 6e 79 20 6f 74 68 65 72 20 57 68 65 72 65 4c any other WhereL
111b0 6f 6f 70 73 20 74 68 61 74 20 61 72 65 20 61 20 oops that are a
111c0 70 72 6f 70 65 72 0a 2a 2a 20 20 20 20 20 20 20 proper.**
111d0 73 75 62 73 65 74 20 6f 66 20 70 54 65 6d 70 6c subset of pTempl
111e0 61 74 65 0a 2a 2a 0a 2a 2a 20 20 20 28 32 29 20 ate.**.** (2)
111f0 70 54 65 6d 70 6c 61 74 65 20 63 6f 73 74 73 20 pTemplate costs
11200 6d 6f 72 65 20 74 68 61 6e 20 61 6e 79 20 6f 74 more than any ot
11210 68 65 72 20 57 68 65 72 65 4c 6f 6f 70 73 20 66 her WhereLoops f
11220 6f 72 20 77 68 69 63 68 20 70 54 65 6d 70 6c 61 or which pTempla
11230 74 65 0a 2a 2a 20 20 20 20 20 20 20 69 73 20 61 te.** is a
11240 20 70 72 6f 70 65 72 20 73 75 62 73 65 74 2e 0a proper subset..
11250 2a 2a 0a 2a 2a 20 54 6f 20 73 61 79 20 22 57 68 **.** To say "Wh
11260 65 72 65 4c 6f 6f 70 20 58 20 69 73 20 61 20 70 ereLoop X is a p
11270 72 6f 70 65 72 20 73 75 62 73 65 74 20 6f 66 20 roper subset of
11280 59 22 20 6d 65 61 6e 73 20 74 68 61 74 20 58 20 Y" means that X
11290 75 73 65 73 20 66 65 77 65 72 0a 2a 2a 20 57 48 uses fewer.** WH
112a0 45 52 45 20 63 6c 61 75 73 65 20 74 65 72 6d 73 ERE clause terms
112b0 20 74 68 61 6e 20 59 20 61 6e 64 20 74 68 61 74 than Y and that
112c0 20 65 76 65 72 79 20 57 48 45 52 45 20 63 6c 61 every WHERE cla
112d0 75 73 65 20 74 65 72 6d 20 75 73 65 64 20 62 79 use term used by
112e0 20 58 20 69 73 0a 2a 2a 20 61 6c 73 6f 20 75 73 X is.** also us
112f0 65 64 20 62 79 20 59 2e 0a 2a 2f 0a 73 74 61 74 ed by Y..*/.stat
11300 69 63 20 76 6f 69 64 20 77 68 65 72 65 4c 6f 6f ic void whereLoo
11310 70 41 64 6a 75 73 74 43 6f 73 74 28 63 6f 6e 73 pAdjustCost(cons
11320 74 20 57 68 65 72 65 4c 6f 6f 70 20 2a 70 2c 20 t WhereLoop *p,
11330 57 68 65 72 65 4c 6f 6f 70 20 2a 70 54 65 6d 70 WhereLoop *pTemp
11340 6c 61 74 65 29 7b 0a 20 20 69 66 28 20 28 70 54 late){. if( (pT
11350 65 6d 70 6c 61 74 65 2d 3e 77 73 46 6c 61 67 73 emplate->wsFlags
11360 20 26 20 57 48 45 52 45 5f 49 4e 44 45 58 45 44 & WHERE_INDEXED
11370 29 3d 3d 30 20 29 20 72 65 74 75 72 6e 3b 0a 20 )==0 ) return;.
11380 20 66 6f 72 28 3b 20 70 3b 20 70 3d 70 2d 3e 70 for(; p; p=p->p
11390 4e 65 78 74 4c 6f 6f 70 29 7b 0a 20 20 20 20 69 NextLoop){. i
113a0 66 28 20 70 2d 3e 69 54 61 62 21 3d 70 54 65 6d f( p->iTab!=pTem
113b0 70 6c 61 74 65 2d 3e 69 54 61 62 20 29 20 63 6f plate->iTab ) co
113c0 6e 74 69 6e 75 65 3b 0a 20 20 20 20 69 66 28 20 ntinue;. if(
113d0 28 70 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 48 (p->wsFlags & WH
113e0 45 52 45 5f 49 4e 44 45 58 45 44 29 3d 3d 30 20 ERE_INDEXED)==0
113f0 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 ) continue;.
11400 69 66 28 20 77 68 65 72 65 4c 6f 6f 70 43 68 65 if( whereLoopChe
11410 61 70 65 72 50 72 6f 70 65 72 53 75 62 73 65 74 aperProperSubset
11420 28 70 2c 20 70 54 65 6d 70 6c 61 74 65 29 20 29 (p, pTemplate) )
11430 7b 0a 20 20 20 20 20 20 2f 2a 20 41 64 6a 75 73 {. /* Adjus
11440 74 20 70 54 65 6d 70 6c 61 74 65 20 63 6f 73 74 t pTemplate cost
11450 20 64 6f 77 6e 77 61 72 64 20 73 6f 20 74 68 61 downward so tha
11460 74 20 69 74 20 69 73 20 63 68 65 61 70 65 72 20 t it is cheaper
11470 74 68 61 6e 20 69 74 73 20 0a 20 20 20 20 20 20 than its .
11480 2a 2a 20 73 75 62 73 65 74 20 70 2e 20 2a 2f 0a ** subset p. */.
11490 20 20 20 20 20 20 57 48 45 52 45 54 52 41 43 45 WHERETRACE
114a0 28 30 78 38 30 2c 28 22 73 75 62 73 65 74 20 63 (0x80,("subset c
114b0 6f 73 74 20 61 64 6a 75 73 74 6d 65 6e 74 20 25 ost adjustment %
114c0 64 2c 25 64 20 74 6f 20 25 64 2c 25 64 5c 6e 22 d,%d to %d,%d\n"
114d0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
114e0 20 20 20 20 20 20 20 20 20 70 54 65 6d 70 6c 61 pTempla
114f0 74 65 2d 3e 72 52 75 6e 2c 20 70 54 65 6d 70 6c te->rRun, pTempl
11500 61 74 65 2d 3e 6e 4f 75 74 2c 20 70 2d 3e 72 52 ate->nOut, p->rR
11510 75 6e 2c 20 70 2d 3e 6e 4f 75 74 2d 31 29 29 3b un, p->nOut-1));
11520 0a 20 20 20 20 20 20 70 54 65 6d 70 6c 61 74 65 . pTemplate
11530 2d 3e 72 52 75 6e 20 3d 20 70 2d 3e 72 52 75 6e ->rRun = p->rRun
11540 3b 0a 20 20 20 20 20 20 70 54 65 6d 70 6c 61 74 ;. pTemplat
11550 65 2d 3e 6e 4f 75 74 20 3d 20 70 2d 3e 6e 4f 75 e->nOut = p->nOu
11560 74 20 2d 20 31 3b 0a 20 20 20 20 7d 65 6c 73 65 t - 1;. }else
11570 20 69 66 28 20 77 68 65 72 65 4c 6f 6f 70 43 68 if( whereLoopCh
11580 65 61 70 65 72 50 72 6f 70 65 72 53 75 62 73 65 eaperProperSubse
11590 74 28 70 54 65 6d 70 6c 61 74 65 2c 20 70 29 20 t(pTemplate, p)
115a0 29 7b 0a 20 20 20 20 20 20 2f 2a 20 41 64 6a 75 ){. /* Adju
115b0 73 74 20 70 54 65 6d 70 6c 61 74 65 20 63 6f 73 st pTemplate cos
115c0 74 20 75 70 77 61 72 64 20 73 6f 20 74 68 61 74 t upward so that
115d0 20 69 74 20 69 73 20 63 6f 73 74 6c 69 65 72 20 it is costlier
115e0 74 68 61 6e 20 70 20 73 69 6e 63 65 0a 20 20 20 than p since.
115f0 20 20 20 2a 2a 20 70 54 65 6d 70 6c 61 74 65 20 ** pTemplate
11600 69 73 20 61 20 70 72 6f 70 65 72 20 73 75 62 73 is a proper subs
11610 65 74 20 6f 66 20 70 20 2a 2f 0a 20 20 20 20 20 et of p */.
11620 20 57 48 45 52 45 54 52 41 43 45 28 30 78 38 30 WHERETRACE(0x80
11630 2c 28 22 73 75 62 73 65 74 20 63 6f 73 74 20 61 ,("subset cost a
11640 64 6a 75 73 74 6d 65 6e 74 20 25 64 2c 25 64 20 djustment %d,%d
11650 74 6f 20 25 64 2c 25 64 5c 6e 22 2c 0a 20 20 20 to %d,%d\n",.
11660 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
11670 20 20 20 20 70 54 65 6d 70 6c 61 74 65 2d 3e 72 pTemplate->r
11680 52 75 6e 2c 20 70 54 65 6d 70 6c 61 74 65 2d 3e Run, pTemplate->
11690 6e 4f 75 74 2c 20 70 2d 3e 72 52 75 6e 2c 20 70 nOut, p->rRun, p
116a0 2d 3e 6e 4f 75 74 2b 31 29 29 3b 0a 20 20 20 20 ->nOut+1));.
116b0 20 20 70 54 65 6d 70 6c 61 74 65 2d 3e 72 52 75 pTemplate->rRu
116c0 6e 20 3d 20 70 2d 3e 72 52 75 6e 3b 0a 20 20 20 n = p->rRun;.
116d0 20 20 20 70 54 65 6d 70 6c 61 74 65 2d 3e 6e 4f pTemplate->nO
116e0 75 74 20 3d 20 70 2d 3e 6e 4f 75 74 20 2b 20 31 ut = p->nOut + 1
116f0 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f ;. }. }.}../
11700 2a 0a 2a 2a 20 53 65 61 72 63 68 20 74 68 65 20 *.** Search the
11710 6c 69 73 74 20 6f 66 20 57 68 65 72 65 4c 6f 6f list of WhereLoo
11720 70 73 20 69 6e 20 2a 70 70 50 72 65 76 20 6c 6f ps in *ppPrev lo
11730 6f 6b 69 6e 67 20 66 6f 72 20 6f 6e 65 20 74 68 oking for one th
11740 61 74 20 63 61 6e 20 62 65 0a 2a 2a 20 72 65 70 at can be.** rep
11750 6c 61 63 65 64 20 62 79 20 70 54 65 6d 70 6c 61 laced by pTempla
11760 74 65 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e te..**.** Return
11770 20 4e 55 4c 4c 20 69 66 20 70 54 65 6d 70 6c 61 NULL if pTempla
11780 74 65 20 64 6f 65 73 20 6e 6f 74 20 62 65 6c 6f te does not belo
11790 6e 67 20 6f 6e 20 74 68 65 20 57 68 65 72 65 4c ng on the WhereL
117a0 6f 6f 70 20 6c 69 73 74 2e 0a 2a 2a 20 49 6e 20 oop list..** In
117b0 6f 74 68 65 72 20 77 6f 72 64 73 20 69 66 20 70 other words if p
117c0 54 65 6d 70 6c 61 74 65 20 6f 75 67 68 74 20 74 Template ought t
117d0 6f 20 62 65 20 64 72 6f 70 70 65 64 20 66 72 6f o be dropped fro
117e0 6d 20 66 75 72 74 68 65 72 20 63 6f 6e 73 69 64 m further consid
117f0 65 72 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 49 eration..**.** I
11800 66 20 70 58 20 69 73 20 61 20 57 68 65 72 65 4c f pX is a WhereL
11810 6f 6f 70 20 74 68 61 74 20 70 54 65 6d 70 6c 61 oop that pTempla
11820 74 65 20 63 61 6e 20 72 65 70 6c 61 63 65 2c 20 te can replace,
11830 74 68 65 6e 20 72 65 74 75 72 6e 20 74 68 65 0a then return the.
11840 2a 2a 20 6c 69 6e 6b 20 74 68 61 74 20 70 6f 69 ** link that poi
11850 6e 74 73 20 74 6f 20 70 58 2e 0a 2a 2a 0a 2a 2a nts to pX..**.**
11860 20 49 66 20 70 54 65 6d 70 6c 61 74 65 20 63 61 If pTemplate ca
11870 6e 6e 6f 74 20 72 65 70 6c 61 63 65 20 61 6e 79 nnot replace any
11880 20 65 78 69 73 74 69 6e 67 20 65 6c 65 6d 65 6e existing elemen
11890 74 20 6f 66 20 74 68 65 20 6c 69 73 74 20 62 75 t of the list bu
118a0 74 20 6e 65 65 64 73 0a 2a 2a 20 74 6f 20 62 65 t needs.** to be
118b0 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 6c 69 added to the li
118c0 73 74 20 61 73 20 61 20 6e 65 77 20 65 6e 74 72 st as a new entr
118d0 79 2c 20 74 68 65 6e 20 72 65 74 75 72 6e 20 61 y, then return a
118e0 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 0a pointer to the.
118f0 2a 2a 20 74 61 69 6c 20 6f 66 20 74 68 65 20 6c ** tail of the l
11900 69 73 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 57 ist..*/.static W
11910 68 65 72 65 4c 6f 6f 70 20 2a 2a 77 68 65 72 65 hereLoop **where
11920 4c 6f 6f 70 46 69 6e 64 4c 65 73 73 65 72 28 0a LoopFindLesser(.
11930 20 20 57 68 65 72 65 4c 6f 6f 70 20 2a 2a 70 70 WhereLoop **pp
11940 50 72 65 76 2c 0a 20 20 63 6f 6e 73 74 20 57 68 Prev,. const Wh
11950 65 72 65 4c 6f 6f 70 20 2a 70 54 65 6d 70 6c 61 ereLoop *pTempla
11960 74 65 0a 29 7b 0a 20 20 57 68 65 72 65 4c 6f 6f te.){. WhereLoo
11970 70 20 2a 70 3b 0a 20 20 66 6f 72 28 70 3d 28 2a p *p;. for(p=(*
11980 70 70 50 72 65 76 29 3b 20 70 3b 20 70 70 50 72 ppPrev); p; ppPr
11990 65 76 3d 26 70 2d 3e 70 4e 65 78 74 4c 6f 6f 70 ev=&p->pNextLoop
119a0 2c 20 70 3d 2a 70 70 50 72 65 76 29 7b 0a 20 20 , p=*ppPrev){.
119b0 20 20 69 66 28 20 70 2d 3e 69 54 61 62 21 3d 70 if( p->iTab!=p
119c0 54 65 6d 70 6c 61 74 65 2d 3e 69 54 61 62 20 7c Template->iTab |
119d0 7c 20 70 2d 3e 69 53 6f 72 74 49 64 78 21 3d 70 | p->iSortIdx!=p
119e0 54 65 6d 70 6c 61 74 65 2d 3e 69 53 6f 72 74 49 Template->iSortI
119f0 64 78 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 49 dx ){. /* I
11a00 66 20 65 69 74 68 65 72 20 74 68 65 20 69 54 61 f either the iTa
11a10 62 20 6f 72 20 69 53 6f 72 74 49 64 78 20 76 61 b or iSortIdx va
11a20 6c 75 65 73 20 66 6f 72 20 74 77 6f 20 57 68 65 lues for two Whe
11a30 72 65 4c 6f 6f 70 20 61 72 65 20 64 69 66 66 65 reLoop are diffe
11a40 72 65 6e 74 0a 20 20 20 20 20 20 2a 2a 20 74 68 rent. ** th
11a50 65 6e 20 74 68 6f 73 65 20 57 68 65 72 65 4c 6f en those WhereLo
11a60 6f 70 73 20 6e 65 65 64 20 74 6f 20 62 65 20 63 ops need to be c
11a70 6f 6e 73 69 64 65 72 65 64 20 73 65 70 61 72 61 onsidered separa
11a80 74 65 6c 79 2e 20 20 4e 65 69 74 68 65 72 20 69 tely. Neither i
11a90 73 0a 20 20 20 20 20 20 2a 2a 20 61 20 63 61 6e s. ** a can
11aa0 64 69 64 61 74 65 20 74 6f 20 72 65 70 6c 61 63 didate to replac
11ab0 65 20 74 68 65 20 6f 74 68 65 72 2e 20 2a 2f 0a e the other. */.
11ac0 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a continue;.
11ad0 20 20 20 20 7d 0a 20 20 20 20 2f 2a 20 49 6e 20 }. /* In
11ae0 74 68 65 20 63 75 72 72 65 6e 74 20 69 6d 70 6c the current impl
11af0 65 6d 65 6e 74 61 74 69 6f 6e 2c 20 74 68 65 20 ementation, the
11b00 72 53 65 74 75 70 20 76 61 6c 75 65 20 69 73 20 rSetup value is
11b10 65 69 74 68 65 72 20 7a 65 72 6f 0a 20 20 20 20 either zero.
11b20 2a 2a 20 6f 72 20 74 68 65 20 63 6f 73 74 20 6f ** or the cost o
11b30 66 20 62 75 69 6c 64 69 6e 67 20 61 6e 20 61 75 f building an au
11b40 74 6f 6d 61 74 69 63 20 69 6e 64 65 78 20 28 4e tomatic index (N
11b50 6c 6f 67 4e 29 20 61 6e 64 20 74 68 65 20 4e 6c logN) and the Nl
11b60 6f 67 4e 0a 20 20 20 20 2a 2a 20 69 73 20 74 68 ogN. ** is th
11b70 65 20 73 61 6d 65 20 66 6f 72 20 63 6f 6d 70 61 e same for compa
11b80 74 69 62 6c 65 20 57 68 65 72 65 4c 6f 6f 70 73 tible WhereLoops
11b90 2e 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 . */. assert(
11ba0 20 70 2d 3e 72 53 65 74 75 70 3d 3d 30 20 7c 7c p->rSetup==0 ||
11bb0 20 70 54 65 6d 70 6c 61 74 65 2d 3e 72 53 65 74 pTemplate->rSet
11bc0 75 70 3d 3d 30 20 0a 20 20 20 20 20 20 20 20 20 up==0 .
11bd0 20 20 20 20 20 20 20 20 7c 7c 20 70 2d 3e 72 53 || p->rS
11be0 65 74 75 70 3d 3d 70 54 65 6d 70 6c 61 74 65 2d etup==pTemplate-
11bf0 3e 72 53 65 74 75 70 20 29 3b 0a 0a 20 20 20 20 >rSetup );..
11c00 2f 2a 20 77 68 65 72 65 4c 6f 6f 70 41 64 64 42 /* whereLoopAddB
11c10 74 72 65 65 28 29 20 61 6c 77 61 79 73 20 67 65 tree() always ge
11c20 6e 65 72 61 74 65 73 20 61 6e 64 20 69 6e 73 65 nerates and inse
11c30 72 74 73 20 74 68 65 20 61 75 74 6f 6d 61 74 69 rts the automati
11c40 63 20 69 6e 64 65 78 0a 20 20 20 20 2a 2a 20 63 c index. ** c
11c50 61 73 65 20 66 69 72 73 74 2e 20 20 48 65 6e 63 ase first. Henc
11c60 65 20 63 6f 6d 70 61 74 69 62 6c 65 20 63 61 6e e compatible can
11c70 64 69 64 61 74 65 20 57 68 65 72 65 4c 6f 6f 70 didate WhereLoop
11c80 73 20 6e 65 76 65 72 20 68 61 76 65 20 61 20 6c s never have a l
11c90 61 72 67 65 72 0a 20 20 20 20 2a 2a 20 72 53 65 arger. ** rSe
11ca0 74 75 70 2e 20 43 61 6c 6c 20 74 68 69 73 20 53 tup. Call this S
11cb0 45 54 55 50 2d 49 4e 56 41 52 49 41 4e 54 20 2a ETUP-INVARIANT *
11cc0 2f 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 2d /. assert( p-
11cd0 3e 72 53 65 74 75 70 3e 3d 70 54 65 6d 70 6c 61 >rSetup>=pTempla
11ce0 74 65 2d 3e 72 53 65 74 75 70 20 29 3b 0a 0a 20 te->rSetup );..
11cf0 20 20 20 2f 2a 20 41 6e 79 20 6c 6f 6f 70 20 75 /* Any loop u
11d00 73 69 6e 67 20 61 6e 20 61 70 70 6c 69 61 74 69 sing an appliati
11d10 6f 6e 2d 64 65 66 69 6e 65 64 20 69 6e 64 65 78 on-defined index
11d20 20 28 6f 72 20 50 52 49 4d 41 52 59 20 4b 45 59 (or PRIMARY KEY
11d30 20 6f 72 0a 20 20 20 20 2a 2a 20 55 4e 49 51 55 or. ** UNIQU
11d40 45 20 63 6f 6e 73 74 72 61 69 6e 74 29 20 77 69 E constraint) wi
11d50 74 68 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 3d th one or more =
11d60 3d 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 69 73 = constraints is
11d70 20 62 65 74 74 65 72 0a 20 20 20 20 2a 2a 20 74 better. ** t
11d80 68 61 6e 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 han an automatic
11d90 20 69 6e 64 65 78 2e 20 55 6e 6c 65 73 73 20 69 index. Unless i
11da0 74 20 69 73 20 61 20 73 6b 69 70 2d 73 63 61 6e t is a skip-scan
11db0 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20 28 70 2d . */. if( (p-
11dc0 3e 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 45 >wsFlags & WHERE
11dd0 5f 41 55 54 4f 5f 49 4e 44 45 58 29 21 3d 30 0a _AUTO_INDEX)!=0.
11de0 20 20 20 20 20 26 26 20 28 70 54 65 6d 70 6c 61 && (pTempla
11df0 74 65 2d 3e 6e 53 6b 69 70 29 3d 3d 30 0a 20 20 te->nSkip)==0.
11e00 20 20 20 26 26 20 28 70 54 65 6d 70 6c 61 74 65 && (pTemplate
11e10 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 ->wsFlags & WHER
11e20 45 5f 49 4e 44 45 58 45 44 29 21 3d 30 0a 20 20 E_INDEXED)!=0.
11e30 20 20 20 26 26 20 28 70 54 65 6d 70 6c 61 74 65 && (pTemplate
11e40 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 ->wsFlags & WHER
11e50 45 5f 43 4f 4c 55 4d 4e 5f 45 51 29 21 3d 30 0a E_COLUMN_EQ)!=0.
11e60 20 20 20 20 20 26 26 20 28 70 2d 3e 70 72 65 72 && (p->prer
11e70 65 71 20 26 20 70 54 65 6d 70 6c 61 74 65 2d 3e eq & pTemplate->
11e80 70 72 65 72 65 71 29 3d 3d 70 54 65 6d 70 6c 61 prereq)==pTempla
11e90 74 65 2d 3e 70 72 65 72 65 71 0a 20 20 20 20 29 te->prereq. )
11ea0 7b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 {. break;.
11eb0 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 }.. /* If
11ec0 65 78 69 73 74 69 6e 67 20 57 68 65 72 65 4c 6f existing WhereLo
11ed0 6f 70 20 70 20 69 73 20 62 65 74 74 65 72 20 74 op p is better t
11ee0 68 61 6e 20 70 54 65 6d 70 6c 61 74 65 2c 20 70 han pTemplate, p
11ef0 54 65 6d 70 6c 61 74 65 20 63 61 6e 20 62 65 0a Template can be.
11f00 20 20 20 20 2a 2a 20 64 69 73 63 61 72 64 65 64 ** discarded
11f10 2e 20 20 57 68 65 72 65 4c 6f 6f 70 20 70 20 69 . WhereLoop p i
11f20 73 20 62 65 74 74 65 72 20 69 66 3a 0a 20 20 20 s better if:.
11f30 20 2a 2a 20 20 20 28 31 29 20 20 70 20 68 61 73 ** (1) p has
11f40 20 6e 6f 20 6d 6f 72 65 20 64 65 70 65 6e 64 65 no more depende
11f50 6e 63 69 65 73 20 74 68 61 6e 20 70 54 65 6d 70 ncies than pTemp
11f60 6c 61 74 65 2c 20 61 6e 64 0a 20 20 20 20 2a 2a late, and. **
11f70 20 20 20 28 32 29 20 20 70 20 68 61 73 20 61 6e (2) p has an
11f80 20 65 71 75 61 6c 20 6f 72 20 6c 6f 77 65 72 20 equal or lower
11f90 63 6f 73 74 20 74 68 61 6e 20 70 54 65 6d 70 6c cost than pTempl
11fa0 61 74 65 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 ate. */. i
11fb0 66 28 20 28 70 2d 3e 70 72 65 72 65 71 20 26 20 f( (p->prereq &
11fc0 70 54 65 6d 70 6c 61 74 65 2d 3e 70 72 65 72 65 pTemplate->prere
11fd0 71 29 3d 3d 70 2d 3e 70 72 65 72 65 71 20 20 20 q)==p->prereq
11fe0 20 2f 2a 20 28 31 29 20 20 2a 2f 0a 20 20 20 20 /* (1) */.
11ff0 20 26 26 20 70 2d 3e 72 53 65 74 75 70 3c 3d 70 && p->rSetup<=p
12000 54 65 6d 70 6c 61 74 65 2d 3e 72 53 65 74 75 70 Template->rSetup
12010 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12020 20 20 2f 2a 20 28 32 61 29 20 2a 2f 0a 20 20 20 /* (2a) */.
12030 20 20 26 26 20 70 2d 3e 72 52 75 6e 3c 3d 70 54 && p->rRun<=pT
12040 65 6d 70 6c 61 74 65 2d 3e 72 52 75 6e 20 20 20 emplate->rRun
12050 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12060 20 20 20 2f 2a 20 28 32 62 29 20 2a 2f 0a 20 20 /* (2b) */.
12070 20 20 20 26 26 20 70 2d 3e 6e 4f 75 74 3c 3d 70 && p->nOut<=p
12080 54 65 6d 70 6c 61 74 65 2d 3e 6e 4f 75 74 20 20 Template->nOut
12090 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
120a0 20 20 20 20 2f 2a 20 28 32 63 29 20 2a 2f 0a 20 /* (2c) */.
120b0 20 20 20 29 7b 0a 20 20 20 20 20 20 72 65 74 75 ){. retu
120c0 72 6e 20 30 3b 20 20 2f 2a 20 44 69 73 63 61 72 rn 0; /* Discar
120d0 64 20 70 54 65 6d 70 6c 61 74 65 20 2a 2f 0a 20 d pTemplate */.
120e0 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 }.. /* If
120f0 70 54 65 6d 70 6c 61 74 65 20 69 73 20 61 6c 77 pTemplate is alw
12100 61 79 73 20 62 65 74 74 65 72 20 74 68 61 6e 20 ays better than
12110 70 2c 20 74 68 65 6e 20 63 61 75 73 65 20 70 20 p, then cause p
12120 74 6f 20 62 65 20 6f 76 65 72 77 72 69 74 74 65 to be overwritte
12130 6e 0a 20 20 20 20 2a 2a 20 77 69 74 68 20 70 54 n. ** with pT
12140 65 6d 70 6c 61 74 65 2e 20 20 70 54 65 6d 70 6c emplate. pTempl
12150 61 74 65 20 69 73 20 62 65 74 74 65 72 20 74 68 ate is better th
12160 61 6e 20 70 20 69 66 3a 0a 20 20 20 20 2a 2a 20 an p if:. **
12170 20 20 28 31 29 20 20 70 54 65 6d 70 6c 61 74 65 (1) pTemplate
12180 20 68 61 73 20 6e 6f 20 6d 6f 72 65 20 64 65 70 has no more dep
12190 65 6e 64 65 6e 63 65 73 20 74 68 61 6e 20 70 2c endences than p,
121a0 20 61 6e 64 0a 20 20 20 20 2a 2a 20 20 20 28 32 and. ** (2
121b0 29 20 20 70 54 65 6d 70 6c 61 74 65 20 68 61 73 ) pTemplate has
121c0 20 61 6e 20 65 71 75 61 6c 20 6f 72 20 6c 6f 77 an equal or low
121d0 65 72 20 63 6f 73 74 20 74 68 61 6e 20 70 2e 0a er cost than p..
121e0 20 20 20 20 2a 2f 0a 20 20 20 20 69 66 28 20 28 */. if( (
121f0 70 2d 3e 70 72 65 72 65 71 20 26 20 70 54 65 6d p->prereq & pTem
12200 70 6c 61 74 65 2d 3e 70 72 65 72 65 71 29 3d 3d plate->prereq)==
12210 70 54 65 6d 70 6c 61 74 65 2d 3e 70 72 65 72 65 pTemplate->prere
12220 71 20 20 20 2f 2a 20 28 31 29 20 20 2a 2f 0a 20 q /* (1) */.
12230 20 20 20 20 26 26 20 70 2d 3e 72 52 75 6e 3e 3d && p->rRun>=
12240 70 54 65 6d 70 6c 61 74 65 2d 3e 72 52 75 6e 20 pTemplate->rRun
12250 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
12260 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 28 /* (
12270 32 61 29 20 2a 2f 0a 20 20 20 20 20 26 26 20 70 2a) */. && p
12280 2d 3e 6e 4f 75 74 3e 3d 70 54 65 6d 70 6c 61 74 ->nOut>=pTemplat
12290 65 2d 3e 6e 4f 75 74 20 20 20 20 20 20 20 20 20 e->nOut
122a0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
122b0 20 20 20 20 2f 2a 20 28 32 62 29 20 2a 2f 0a 20 /* (2b) */.
122c0 20 20 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 ){. asse
122d0 72 74 28 20 70 2d 3e 72 53 65 74 75 70 3e 3d 70 rt( p->rSetup>=p
122e0 54 65 6d 70 6c 61 74 65 2d 3e 72 53 65 74 75 70 Template->rSetup
122f0 20 29 3b 20 2f 2a 20 53 45 54 55 50 2d 49 4e 56 ); /* SETUP-INV
12300 41 52 49 41 4e 54 20 61 62 6f 76 65 20 2a 2f 0a ARIANT above */.
12310 20 20 20 20 20 20 62 72 65 61 6b 3b 20 20 20 2f break; /
12320 2a 20 43 61 75 73 65 20 70 20 74 6f 20 62 65 20 * Cause p to be
12330 6f 76 65 72 77 72 69 74 74 65 6e 20 62 79 20 70 overwritten by p
12340 54 65 6d 70 6c 61 74 65 20 2a 2f 0a 20 20 20 20 Template */.
12350 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 70 }. }. return p
12360 70 50 72 65 76 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 pPrev;.}../*.**
12370 49 6e 73 65 72 74 20 6f 72 20 72 65 70 6c 61 63 Insert or replac
12380 65 20 61 20 57 68 65 72 65 4c 6f 6f 70 20 65 6e e a WhereLoop en
12390 74 72 79 20 75 73 69 6e 67 20 74 68 65 20 74 65 try using the te
123a0 6d 70 6c 61 74 65 20 73 75 70 70 6c 69 65 64 2e mplate supplied.
123b0 0a 2a 2a 0a 2a 2a 20 41 6e 20 65 78 69 73 74 69 .**.** An existi
123c0 6e 67 20 57 68 65 72 65 4c 6f 6f 70 20 65 6e 74 ng WhereLoop ent
123d0 72 79 20 6d 69 67 68 74 20 62 65 20 6f 76 65 72 ry might be over
123e0 77 72 69 74 74 65 6e 20 69 66 20 74 68 65 20 6e written if the n
123f0 65 77 20 74 65 6d 70 6c 61 74 65 0a 2a 2a 20 69 ew template.** i
12400 73 20 62 65 74 74 65 72 20 61 6e 64 20 68 61 73 s better and has
12410 20 66 65 77 65 72 20 64 65 70 65 6e 64 65 6e 63 fewer dependenc
12420 69 65 73 2e 20 20 4f 72 20 74 68 65 20 74 65 6d ies. Or the tem
12430 70 6c 61 74 65 20 77 69 6c 6c 20 62 65 20 69 67 plate will be ig
12440 6e 6f 72 65 64 0a 2a 2a 20 61 6e 64 20 6e 6f 20 nored.** and no
12450 69 6e 73 65 72 74 20 77 69 6c 6c 20 6f 63 63 75 insert will occu
12460 72 20 69 66 20 61 6e 20 65 78 69 73 74 69 6e 67 r if an existing
12470 20 57 68 65 72 65 4c 6f 6f 70 20 69 73 20 66 61 WhereLoop is fa
12480 73 74 65 72 20 61 6e 64 20 68 61 73 0a 2a 2a 20 ster and has.**
12490 66 65 77 65 72 20 64 65 70 65 6e 64 65 6e 63 69 fewer dependenci
124a0 65 73 20 74 68 61 6e 20 74 68 65 20 74 65 6d 70 es than the temp
124b0 6c 61 74 65 2e 20 20 4f 74 68 65 72 77 69 73 65 late. Otherwise
124c0 20 61 20 6e 65 77 20 57 68 65 72 65 4c 6f 6f 70 a new WhereLoop
124d0 20 69 73 0a 2a 2a 20 61 64 64 65 64 20 62 61 73 is.** added bas
124e0 65 64 20 6f 6e 20 74 68 65 20 74 65 6d 70 6c 61 ed on the templa
124f0 74 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 42 75 te..**.** If pBu
12500 69 6c 64 65 72 2d 3e 70 4f 72 53 65 74 20 69 73 ilder->pOrSet is
12510 20 6e 6f 74 20 4e 55 4c 4c 20 74 68 65 6e 20 77 not NULL then w
12520 65 20 63 61 72 65 20 61 62 6f 75 74 20 6f 6e 6c e care about onl
12530 79 20 74 68 65 0a 2a 2a 20 70 72 65 72 65 71 75 y the.** prerequ
12540 69 73 69 74 65 73 20 61 6e 64 20 72 52 75 6e 20 isites and rRun
12550 61 6e 64 20 6e 4f 75 74 20 63 6f 73 74 73 20 6f and nOut costs o
12560 66 20 74 68 65 20 4e 20 62 65 73 74 20 6c 6f 6f f the N best loo
12570 70 73 2e 20 20 54 68 61 74 0a 2a 2a 20 69 6e 66 ps. That.** inf
12580 6f 72 6d 61 74 69 6f 6e 20 69 73 20 67 61 74 68 ormation is gath
12590 65 72 65 64 20 69 6e 20 74 68 65 20 70 42 75 69 ered in the pBui
125a0 6c 64 65 72 2d 3e 70 4f 72 53 65 74 20 6f 62 6a lder->pOrSet obj
125b0 65 63 74 2e 20 20 54 68 69 73 20 73 70 65 63 69 ect. This speci
125c0 61 6c 0a 2a 2a 20 70 72 6f 63 65 73 73 69 6e 67 al.** processing
125d0 20 6d 6f 64 65 20 69 73 20 75 73 65 64 20 6f 6e mode is used on
125e0 6c 79 20 66 6f 72 20 4f 52 20 63 6c 61 75 73 65 ly for OR clause
125f0 20 70 72 6f 63 65 73 73 69 6e 67 2e 0a 2a 2a 0a processing..**.
12600 2a 2a 20 57 68 65 6e 20 61 63 63 75 6d 75 6c 61 ** When accumula
12610 74 69 6e 67 20 6d 75 6c 74 69 70 6c 65 20 6c 6f ting multiple lo
12620 6f 70 73 20 28 77 68 65 6e 20 70 42 75 69 6c 64 ops (when pBuild
12630 65 72 2d 3e 70 4f 72 53 65 74 20 69 73 20 4e 55 er->pOrSet is NU
12640 4c 4c 29 20 77 65 0a 2a 2a 20 73 74 69 6c 6c 20 LL) we.** still
12650 6d 69 67 68 74 20 6f 76 65 72 77 72 69 74 65 20 might overwrite
12660 73 69 6d 69 6c 61 72 20 6c 6f 6f 70 73 20 77 69 similar loops wi
12670 74 68 20 74 68 65 20 6e 65 77 20 74 65 6d 70 6c th the new templ
12680 61 74 65 20 69 66 20 74 68 65 0a 2a 2a 20 6e 65 ate if the.** ne
12690 77 20 74 65 6d 70 6c 61 74 65 20 69 73 20 62 65 w template is be
126a0 74 74 65 72 2e 20 20 4c 6f 6f 70 73 20 6d 61 79 tter. Loops may
126b0 20 62 65 20 6f 76 65 72 77 72 69 74 74 65 6e 20 be overwritten
126c0 69 66 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 if the following
126d0 20 0a 2a 2a 20 63 6f 6e 64 69 74 69 6f 6e 73 20 .** conditions
126e0 61 72 65 20 6d 65 74 3a 0a 2a 2a 0a 2a 2a 20 20 are met:.**.**
126f0 20 20 28 31 29 20 20 54 68 65 79 20 68 61 76 65 (1) They have
12700 20 74 68 65 20 73 61 6d 65 20 69 54 61 62 2e 0a the same iTab..
12710 2a 2a 20 20 20 20 28 32 29 20 20 54 68 65 79 20 ** (2) They
12720 68 61 76 65 20 74 68 65 20 73 61 6d 65 20 69 53 have the same iS
12730 6f 72 74 49 64 78 2e 0a 2a 2a 20 20 20 20 28 33 ortIdx..** (3
12740 29 20 20 54 68 65 20 74 65 6d 70 6c 61 74 65 20 ) The template
12750 68 61 73 20 73 61 6d 65 20 6f 72 20 66 65 77 65 has same or fewe
12760 72 20 64 65 70 65 6e 64 65 6e 63 69 65 73 20 74 r dependencies t
12770 68 61 6e 20 74 68 65 20 63 75 72 72 65 6e 74 20 han the current
12780 6c 6f 6f 70 0a 2a 2a 20 20 20 20 28 34 29 20 20 loop.** (4)
12790 54 68 65 20 74 65 6d 70 6c 61 74 65 20 68 61 73 The template has
127a0 20 74 68 65 20 73 61 6d 65 20 6f 72 20 6c 6f 77 the same or low
127b0 65 72 20 63 6f 73 74 20 74 68 61 6e 20 74 68 65 er cost than the
127c0 20 63 75 72 72 65 6e 74 20 6c 6f 6f 70 0a 2a 2f current loop.*/
127d0 0a 73 74 61 74 69 63 20 69 6e 74 20 77 68 65 72 .static int wher
127e0 65 4c 6f 6f 70 49 6e 73 65 72 74 28 57 68 65 72 eLoopInsert(Wher
127f0 65 4c 6f 6f 70 42 75 69 6c 64 65 72 20 2a 70 42 eLoopBuilder *pB
12800 75 69 6c 64 65 72 2c 20 57 68 65 72 65 4c 6f 6f uilder, WhereLoo
12810 70 20 2a 70 54 65 6d 70 6c 61 74 65 29 7b 0a 20 p *pTemplate){.
12820 20 57 68 65 72 65 4c 6f 6f 70 20 2a 2a 70 70 50 WhereLoop **ppP
12830 72 65 76 2c 20 2a 70 3b 0a 20 20 57 68 65 72 65 rev, *p;. Where
12840 49 6e 66 6f 20 2a 70 57 49 6e 66 6f 20 3d 20 70 Info *pWInfo = p
12850 42 75 69 6c 64 65 72 2d 3e 70 57 49 6e 66 6f 3b Builder->pWInfo;
12860 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d . sqlite3 *db =
12870 20 70 57 49 6e 66 6f 2d 3e 70 50 61 72 73 65 2d pWInfo->pParse-
12880 3e 64 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a >db;. int rc;..
12890 20 20 2f 2a 20 49 66 20 70 42 75 69 6c 64 65 72 /* If pBuilder
128a0 2d 3e 70 4f 72 53 65 74 20 69 73 20 64 65 66 69 ->pOrSet is defi
128b0 6e 65 64 2c 20 74 68 65 6e 20 6f 6e 6c 79 20 6b ned, then only k
128c0 65 65 70 20 74 72 61 63 6b 20 6f 66 20 74 68 65 eep track of the
128d0 20 63 6f 73 74 73 0a 20 20 2a 2a 20 61 6e 64 20 costs. ** and
128e0 70 72 65 72 65 71 73 2e 0a 20 20 2a 2f 0a 20 20 prereqs.. */.
128f0 69 66 28 20 70 42 75 69 6c 64 65 72 2d 3e 70 4f if( pBuilder->pO
12900 72 53 65 74 21 3d 30 20 29 7b 0a 20 20 20 20 69 rSet!=0 ){. i
12910 66 28 20 70 54 65 6d 70 6c 61 74 65 2d 3e 6e 4c f( pTemplate->nL
12920 54 65 72 6d 20 29 7b 0a 23 69 66 20 57 48 45 52 Term ){.#if WHER
12930 45 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 0a 20 ETRACE_ENABLED.
12940 20 20 20 20 20 75 31 36 20 6e 20 3d 20 70 42 75 u16 n = pBu
12950 69 6c 64 65 72 2d 3e 70 4f 72 53 65 74 2d 3e 6e ilder->pOrSet->n
12960 3b 0a 20 20 20 20 20 20 69 6e 74 20 78 20 3d 0a ;. int x =.
12970 23 65 6e 64 69 66 0a 20 20 20 20 20 20 77 68 65 #endif. whe
12980 72 65 4f 72 49 6e 73 65 72 74 28 70 42 75 69 6c reOrInsert(pBuil
12990 64 65 72 2d 3e 70 4f 72 53 65 74 2c 20 70 54 65 der->pOrSet, pTe
129a0 6d 70 6c 61 74 65 2d 3e 70 72 65 72 65 71 2c 20 mplate->prereq,
129b0 70 54 65 6d 70 6c 61 74 65 2d 3e 72 52 75 6e 2c pTemplate->rRun,
129c0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
129d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
129e0 20 20 20 20 20 70 54 65 6d 70 6c 61 74 65 2d 3e pTemplate->
129f0 6e 4f 75 74 29 3b 0a 23 69 66 20 57 48 45 52 45 nOut);.#if WHERE
12a00 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 20 2f 2a TRACE_ENABLED /*
12a10 20 30 78 38 20 2a 2f 0a 20 20 20 20 20 20 69 66 0x8 */. if
12a20 28 20 73 71 6c 69 74 65 33 57 68 65 72 65 54 72 ( sqlite3WhereTr
12a30 61 63 65 20 26 20 30 78 38 20 29 7b 0a 20 20 20 ace & 0x8 ){.
12a40 20 20 20 20 20 73 71 6c 69 74 65 33 44 65 62 75 sqlite3Debu
12a50 67 50 72 69 6e 74 66 28 78 3f 22 20 20 20 6f 72 gPrintf(x?" or
12a60 2d 25 64 3a 20 20 22 3a 22 20 20 20 6f 72 2d 58 -%d: ":" or-X
12a70 3a 20 20 22 2c 20 6e 29 3b 0a 20 20 20 20 20 20 : ", n);.
12a80 20 20 77 68 65 72 65 4c 6f 6f 70 50 72 69 6e 74 whereLoopPrint
12a90 28 70 54 65 6d 70 6c 61 74 65 2c 20 70 42 75 69 (pTemplate, pBui
12aa0 6c 64 65 72 2d 3e 70 57 43 29 3b 0a 20 20 20 20 lder->pWC);.
12ab0 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d }.#endif. }
12ac0 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 . return SQLI
12ad0 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a TE_OK;. }.. /*
12ae0 20 4c 6f 6f 6b 20 66 6f 72 20 61 6e 20 65 78 69 Look for an exi
12af0 73 74 69 6e 67 20 57 68 65 72 65 4c 6f 6f 70 20 sting WhereLoop
12b00 74 6f 20 72 65 70 6c 61 63 65 20 77 69 74 68 20 to replace with
12b10 70 54 65 6d 70 6c 61 74 65 0a 20 20 2a 2f 0a 20 pTemplate. */.
12b20 20 77 68 65 72 65 4c 6f 6f 70 41 64 6a 75 73 74 whereLoopAdjust
12b30 43 6f 73 74 28 70 57 49 6e 66 6f 2d 3e 70 4c 6f Cost(pWInfo->pLo
12b40 6f 70 73 2c 20 70 54 65 6d 70 6c 61 74 65 29 3b ops, pTemplate);
12b50 0a 20 20 70 70 50 72 65 76 20 3d 20 77 68 65 72 . ppPrev = wher
12b60 65 4c 6f 6f 70 46 69 6e 64 4c 65 73 73 65 72 28 eLoopFindLesser(
12b70 26 70 57 49 6e 66 6f 2d 3e 70 4c 6f 6f 70 73 2c &pWInfo->pLoops,
12b80 20 70 54 65 6d 70 6c 61 74 65 29 3b 0a 0a 20 20 pTemplate);..
12b90 69 66 28 20 70 70 50 72 65 76 3d 3d 30 20 29 7b if( ppPrev==0 ){
12ba0 0a 20 20 20 20 2f 2a 20 54 68 65 72 65 20 61 6c . /* There al
12bb0 72 65 61 64 79 20 65 78 69 73 74 73 20 61 20 57 ready exists a W
12bc0 68 65 72 65 4c 6f 6f 70 20 6f 6e 20 74 68 65 20 hereLoop on the
12bd0 6c 69 73 74 20 74 68 61 74 20 69 73 20 62 65 74 list that is bet
12be0 74 65 72 0a 20 20 20 20 2a 2a 20 74 68 61 6e 20 ter. ** than
12bf0 70 54 65 6d 70 6c 61 74 65 2c 20 73 6f 20 6a 75 pTemplate, so ju
12c00 73 74 20 69 67 6e 6f 72 65 20 70 54 65 6d 70 6c st ignore pTempl
12c10 61 74 65 20 2a 2f 0a 23 69 66 20 57 48 45 52 45 ate */.#if WHERE
12c20 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 20 2f 2a TRACE_ENABLED /*
12c30 20 30 78 38 20 2a 2f 0a 20 20 20 20 69 66 28 20 0x8 */. if(
12c40 73 71 6c 69 74 65 33 57 68 65 72 65 54 72 61 63 sqlite3WhereTrac
12c50 65 20 26 20 30 78 38 20 29 7b 0a 20 20 20 20 20 e & 0x8 ){.
12c60 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 sqlite3DebugPri
12c70 6e 74 66 28 22 20 20 20 73 6b 69 70 3a 20 22 29 ntf(" skip: ")
12c80 3b 0a 20 20 20 20 20 20 77 68 65 72 65 4c 6f 6f ;. whereLoo
12c90 70 50 72 69 6e 74 28 70 54 65 6d 70 6c 61 74 65 pPrint(pTemplate
12ca0 2c 20 70 42 75 69 6c 64 65 72 2d 3e 70 57 43 29 , pBuilder->pWC)
12cb0 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 ;. }.#endif.
12cc0 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 return SQLITE
12cd0 5f 4f 4b 3b 20 20 0a 20 20 7d 65 6c 73 65 7b 0a _OK; . }else{.
12ce0 20 20 20 20 70 20 3d 20 2a 70 70 50 72 65 76 3b p = *ppPrev;
12cf0 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 77 65 . }.. /* If we
12d00 20 72 65 61 63 68 20 74 68 69 73 20 70 6f 69 6e reach this poin
12d10 74 20 69 74 20 6d 65 61 6e 73 20 74 68 61 74 20 t it means that
12d20 65 69 74 68 65 72 20 70 5b 5d 20 73 68 6f 75 6c either p[] shoul
12d30 64 20 62 65 20 6f 76 65 72 77 72 69 74 74 65 6e d be overwritten
12d40 0a 20 20 2a 2a 20 77 69 74 68 20 70 54 65 6d 70 . ** with pTemp
12d50 6c 61 74 65 5b 5d 20 69 66 20 70 5b 5d 20 65 78 late[] if p[] ex
12d60 69 73 74 73 2c 20 6f 72 20 69 66 20 70 3d 3d 4e ists, or if p==N
12d70 55 4c 4c 20 74 68 65 6e 20 61 6c 6c 6f 63 61 74 ULL then allocat
12d80 65 20 61 20 6e 65 77 0a 20 20 2a 2a 20 57 68 65 e a new. ** Whe
12d90 72 65 4c 6f 6f 70 20 61 6e 64 20 69 6e 73 65 72 reLoop and inser
12da0 74 20 69 74 2e 0a 20 20 2a 2f 0a 23 69 66 20 57 t it.. */.#if W
12db0 48 45 52 45 54 52 41 43 45 5f 45 4e 41 42 4c 45 HERETRACE_ENABLE
12dc0 44 20 2f 2a 20 30 78 38 20 2a 2f 0a 20 20 69 66 D /* 0x8 */. if
12dd0 28 20 73 71 6c 69 74 65 33 57 68 65 72 65 54 72 ( sqlite3WhereTr
12de0 61 63 65 20 26 20 30 78 38 20 29 7b 0a 20 20 20 ace & 0x8 ){.
12df0 20 69 66 28 20 70 21 3d 30 20 29 7b 0a 20 20 20 if( p!=0 ){.
12e00 20 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 sqlite3DebugP
12e10 72 69 6e 74 66 28 22 72 65 70 6c 61 63 65 3a 20 rintf("replace:
12e20 22 29 3b 0a 20 20 20 20 20 20 77 68 65 72 65 4c ");. whereL
12e30 6f 6f 70 50 72 69 6e 74 28 70 2c 20 70 42 75 69 oopPrint(p, pBui
12e40 6c 64 65 72 2d 3e 70 57 43 29 3b 0a 20 20 20 20 lder->pWC);.
12e50 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 sqlite3DebugPr
12e60 69 6e 74 66 28 22 20 20 20 77 69 74 68 3a 20 22 intf(" with: "
12e70 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 );. }else{.
12e80 20 20 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 sqlite3Debug
12e90 50 72 69 6e 74 66 28 22 20 20 20 20 61 64 64 3a Printf(" add:
12ea0 20 22 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 77 ");. }. w
12eb0 68 65 72 65 4c 6f 6f 70 50 72 69 6e 74 28 70 54 hereLoopPrint(pT
12ec0 65 6d 70 6c 61 74 65 2c 20 70 42 75 69 6c 64 65 emplate, pBuilde
12ed0 72 2d 3e 70 57 43 29 3b 0a 20 20 7d 0a 23 65 6e r->pWC);. }.#en
12ee0 64 69 66 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 dif. if( p==0 )
12ef0 7b 0a 20 20 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 {. /* Allocat
12f00 65 20 61 20 6e 65 77 20 57 68 65 72 65 4c 6f 6f e a new WhereLoo
12f10 70 20 74 6f 20 61 64 64 20 74 6f 20 74 68 65 20 p to add to the
12f20 65 6e 64 20 6f 66 20 74 68 65 20 6c 69 73 74 20 end of the list
12f30 2a 2f 0a 20 20 20 20 2a 70 70 50 72 65 76 20 3d */. *ppPrev =
12f40 20 70 20 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 p = sqlite3DbMa
12f50 6c 6c 6f 63 52 61 77 4e 4e 28 64 62 2c 20 73 69 llocRawNN(db, si
12f60 7a 65 6f 66 28 57 68 65 72 65 4c 6f 6f 70 29 29 zeof(WhereLoop))
12f70 3b 0a 20 20 20 20 69 66 28 20 70 3d 3d 30 20 29 ;. if( p==0 )
12f80 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
12f90 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 77 OMEM_BKPT;. w
12fa0 68 65 72 65 4c 6f 6f 70 49 6e 69 74 28 70 29 3b hereLoopInit(p);
12fb0 0a 20 20 20 20 70 2d 3e 70 4e 65 78 74 4c 6f 6f . p->pNextLoo
12fc0 70 20 3d 20 30 3b 0a 20 20 7d 65 6c 73 65 7b 0a p = 0;. }else{.
12fd0 20 20 20 20 2f 2a 20 57 65 20 77 69 6c 6c 20 62 /* We will b
12fe0 65 20 6f 76 65 72 77 72 69 74 69 6e 67 20 57 68 e overwriting Wh
12ff0 65 72 65 4c 6f 6f 70 20 70 5b 5d 2e 20 20 42 75 ereLoop p[]. Bu
13000 74 20 62 65 66 6f 72 65 20 77 65 20 64 6f 2c 20 t before we do,
13010 66 69 72 73 74 0a 20 20 20 20 2a 2a 20 67 6f 20 first. ** go
13020 74 68 72 6f 75 67 68 20 74 68 65 20 72 65 73 74 through the rest
13030 20 6f 66 20 74 68 65 20 6c 69 73 74 20 61 6e 64 of the list and
13040 20 64 65 6c 65 74 65 20 61 6e 79 20 6f 74 68 65 delete any othe
13050 72 20 65 6e 74 72 69 65 73 20 62 65 73 69 64 65 r entries beside
13060 73 0a 20 20 20 20 2a 2a 20 70 5b 5d 20 74 68 61 s. ** p[] tha
13070 74 20 61 72 65 20 61 6c 73 6f 20 73 75 70 70 6c t are also suppl
13080 61 74 65 64 20 62 79 20 70 54 65 6d 70 6c 61 74 ated by pTemplat
13090 65 20 2a 2f 0a 20 20 20 20 57 68 65 72 65 4c 6f e */. WhereLo
130a0 6f 70 20 2a 2a 70 70 54 61 69 6c 20 3d 20 26 70 op **ppTail = &p
130b0 2d 3e 70 4e 65 78 74 4c 6f 6f 70 3b 0a 20 20 20 ->pNextLoop;.
130c0 20 57 68 65 72 65 4c 6f 6f 70 20 2a 70 54 6f 44 WhereLoop *pToD
130d0 65 6c 3b 0a 20 20 20 20 77 68 69 6c 65 28 20 2a el;. while( *
130e0 70 70 54 61 69 6c 20 29 7b 0a 20 20 20 20 20 20 ppTail ){.
130f0 70 70 54 61 69 6c 20 3d 20 77 68 65 72 65 4c 6f ppTail = whereLo
13100 6f 70 46 69 6e 64 4c 65 73 73 65 72 28 70 70 54 opFindLesser(ppT
13110 61 69 6c 2c 20 70 54 65 6d 70 6c 61 74 65 29 3b ail, pTemplate);
13120 0a 20 20 20 20 20 20 69 66 28 20 70 70 54 61 69 . if( ppTai
13130 6c 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 l==0 ) break;.
13140 20 20 20 20 70 54 6f 44 65 6c 20 3d 20 2a 70 70 pToDel = *pp
13150 54 61 69 6c 3b 0a 20 20 20 20 20 20 69 66 28 20 Tail;. if(
13160 70 54 6f 44 65 6c 3d 3d 30 20 29 20 62 72 65 61 pToDel==0 ) brea
13170 6b 3b 0a 20 20 20 20 20 20 2a 70 70 54 61 69 6c k;. *ppTail
13180 20 3d 20 70 54 6f 44 65 6c 2d 3e 70 4e 65 78 74 = pToDel->pNext
13190 4c 6f 6f 70 3b 0a 23 69 66 20 57 48 45 52 45 54 Loop;.#if WHERET
131a0 52 41 43 45 5f 45 4e 41 42 4c 45 44 20 2f 2a 20 RACE_ENABLED /*
131b0 30 78 38 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 0x8 */. if(
131c0 20 73 71 6c 69 74 65 33 57 68 65 72 65 54 72 61 sqlite3WhereTra
131d0 63 65 20 26 20 30 78 38 20 29 7b 0a 20 20 20 20 ce & 0x8 ){.
131e0 20 20 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 sqlite3Debug
131f0 50 72 69 6e 74 66 28 22 20 64 65 6c 65 74 65 3a Printf(" delete:
13200 20 22 29 3b 0a 20 20 20 20 20 20 20 20 77 68 65 ");. whe
13210 72 65 4c 6f 6f 70 50 72 69 6e 74 28 70 54 6f 44 reLoopPrint(pToD
13220 65 6c 2c 20 70 42 75 69 6c 64 65 72 2d 3e 70 57 el, pBuilder->pW
13230 43 29 3b 0a 20 20 20 20 20 20 7d 0a 23 65 6e 64 C);. }.#end
13240 69 66 0a 20 20 20 20 20 20 77 68 65 72 65 4c 6f if. whereLo
13250 6f 70 44 65 6c 65 74 65 28 64 62 2c 20 70 54 6f opDelete(db, pTo
13260 44 65 6c 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a Del);. }. }.
13270 20 20 72 63 20 3d 20 77 68 65 72 65 4c 6f 6f 70 rc = whereLoop
13280 58 66 65 72 28 64 62 2c 20 70 2c 20 70 54 65 6d Xfer(db, p, pTem
13290 70 6c 61 74 65 29 3b 0a 20 20 69 66 28 20 28 70 plate);. if( (p
132a0 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 ->wsFlags & WHER
132b0 45 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 29 3d E_VIRTUALTABLE)=
132c0 3d 30 20 29 7b 0a 20 20 20 20 49 6e 64 65 78 20 =0 ){. Index
132d0 2a 70 49 6e 64 65 78 20 3d 20 70 2d 3e 75 2e 62 *pIndex = p->u.b
132e0 74 72 65 65 2e 70 49 6e 64 65 78 3b 0a 20 20 20 tree.pIndex;.
132f0 20 69 66 28 20 70 49 6e 64 65 78 20 26 26 20 70 if( pIndex && p
13300 49 6e 64 65 78 2d 3e 74 6e 75 6d 3d 3d 30 20 29 Index->tnum==0 )
13310 7b 0a 20 20 20 20 20 20 70 2d 3e 75 2e 62 74 72 {. p->u.btr
13320 65 65 2e 70 49 6e 64 65 78 20 3d 20 30 3b 0a 20 ee.pIndex = 0;.
13330 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 }. }. retur
13340 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 n rc;.}../*.** A
13350 64 6a 75 73 74 20 74 68 65 20 57 68 65 72 65 4c djust the WhereL
13360 6f 6f 70 2e 6e 4f 75 74 20 76 61 6c 75 65 20 64 oop.nOut value d
13370 6f 77 6e 77 61 72 64 20 74 6f 20 61 63 63 6f 75 ownward to accou
13380 6e 74 20 66 6f 72 20 74 65 72 6d 73 20 6f 66 20 nt for terms of
13390 74 68 65 0a 2a 2a 20 57 48 45 52 45 20 63 6c 61 the.** WHERE cla
133a0 75 73 65 20 74 68 61 74 20 72 65 66 65 72 65 6e use that referen
133b0 63 65 20 74 68 65 20 6c 6f 6f 70 20 62 75 74 20 ce the loop but
133c0 77 68 69 63 68 20 61 72 65 20 6e 6f 74 20 75 73 which are not us
133d0 65 64 20 62 79 20 61 6e 0a 2a 2a 20 69 6e 64 65 ed by an.** inde
133e0 78 2e 0a 2a 0a 2a 2a 20 46 6f 72 20 65 76 65 72 x..*.** For ever
133f0 79 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 74 y WHERE clause t
13400 65 72 6d 20 74 68 61 74 20 69 73 20 6e 6f 74 20 erm that is not
13410 75 73 65 64 20 62 79 20 74 68 65 20 69 6e 64 65 used by the inde
13420 78 0a 2a 2a 20 61 6e 64 20 77 68 69 63 68 20 68 x.** and which h
13430 61 73 20 61 20 74 72 75 74 68 20 70 72 6f 62 61 as a truth proba
13440 62 69 6c 69 74 79 20 61 73 73 69 67 6e 65 64 20 bility assigned
13450 62 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 6c 69 by one of the li
13460 6b 65 6c 69 68 6f 6f 64 28 29 2c 0a 2a 2a 20 6c kelihood(),.** l
13470 69 6b 65 6c 79 28 29 2c 20 6f 72 20 75 6e 6c 69 ikely(), or unli
13480 6b 65 6c 79 28 29 20 53 51 4c 20 66 75 6e 63 74 kely() SQL funct
13490 69 6f 6e 73 2c 20 72 65 64 75 63 65 20 74 68 65 ions, reduce the
134a0 20 65 73 74 69 6d 61 74 65 64 20 6e 75 6d 62 65 estimated numbe
134b0 72 0a 2a 2a 20 6f 66 20 6f 75 74 70 75 74 20 72 r.** of output r
134c0 6f 77 73 20 62 79 20 74 68 65 20 70 72 6f 62 61 ows by the proba
134d0 62 69 6c 69 74 79 20 73 70 65 63 69 66 69 65 64 bility specified
134e0 2e 0a 2a 2a 0a 2a 2a 20 54 55 4e 49 4e 47 3a 20 ..**.** TUNING:
134f0 20 46 6f 72 20 65 76 65 72 79 20 57 48 45 52 45 For every WHERE
13500 20 63 6c 61 75 73 65 20 74 65 72 6d 20 74 68 61 clause term tha
13510 74 20 69 73 20 6e 6f 74 20 75 73 65 64 20 62 79 t is not used by
13520 20 74 68 65 20 69 6e 64 65 78 0a 2a 2a 20 61 6e the index.** an
13530 64 20 77 68 69 63 68 20 64 6f 65 73 20 6e 6f 74 d which does not
13540 20 68 61 76 65 20 61 6e 20 61 73 73 69 67 6e 65 have an assigne
13550 64 20 74 72 75 74 68 20 70 72 6f 62 61 62 69 6c d truth probabil
13560 69 74 79 2c 20 68 65 75 72 69 73 74 69 63 73 0a ity, heuristics.
13570 2a 2a 20 64 65 73 63 72 69 62 65 64 20 62 65 6c ** described bel
13580 6f 77 20 61 72 65 20 75 73 65 64 20 74 6f 20 74 ow are used to t
13590 72 79 20 74 6f 20 65 73 74 69 6d 61 74 65 20 74 ry to estimate t
135a0 68 65 20 74 72 75 74 68 20 70 72 6f 62 61 62 69 he truth probabi
135b0 6c 69 74 79 2e 0a 2a 2a 20 54 4f 44 4f 20 2d 2d lity..** TODO --
135c0 3e 20 50 65 72 68 61 70 73 20 74 68 69 73 20 69 > Perhaps this i
135d0 73 20 73 6f 6d 65 74 68 69 6e 67 20 74 68 61 74 s something that
135e0 20 63 6f 75 6c 64 20 62 65 20 69 6d 70 72 6f 76 could be improv
135f0 65 64 20 62 79 20 62 65 74 74 65 72 0a 2a 2a 20 ed by better.**
13600 74 61 62 6c 65 20 73 74 61 74 69 73 74 69 63 73 table statistics
13610 2e 0a 2a 2a 0a 2a 2a 20 48 65 75 72 69 73 74 69 ..**.** Heuristi
13620 63 20 31 3a 20 20 45 73 74 69 6d 61 74 65 20 74 c 1: Estimate t
13630 68 65 20 74 72 75 74 68 20 70 72 6f 62 61 62 69 he truth probabi
13640 6c 69 74 79 20 61 73 20 39 33 2e 37 35 25 2e 20 lity as 93.75%.
13650 20 54 68 65 20 39 33 2e 37 35 25 0a 2a 2a 20 76 The 93.75%.** v
13660 61 6c 75 65 20 63 6f 72 72 65 73 70 6f 6e 64 73 alue corresponds
13670 20 74 6f 20 2d 31 20 69 6e 20 4c 6f 67 45 73 74 to -1 in LogEst
13680 20 6e 6f 74 61 74 69 6f 6e 2c 20 73 6f 20 74 68 notation, so th
13690 69 73 20 6d 65 61 6e 73 20 64 65 63 72 65 6d 65 is means decreme
136a0 6e 74 0a 2a 2a 20 74 68 65 20 57 68 65 72 65 4c nt.** the WhereL
136b0 6f 6f 70 2e 6e 4f 75 74 20 66 69 65 6c 64 20 66 oop.nOut field f
136c0 6f 72 20 65 76 65 72 79 20 73 75 63 68 20 57 48 or every such WH
136d0 45 52 45 20 63 6c 61 75 73 65 20 74 65 72 6d 2e ERE clause term.
136e0 0a 2a 2a 0a 2a 2a 20 48 65 75 72 69 73 74 69 63 .**.** Heuristic
136f0 20 32 3a 20 20 49 66 20 74 68 65 72 65 20 65 78 2: If there ex
13700 69 73 74 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 ists one or more
13710 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 74 65 WHERE clause te
13720 72 6d 73 20 6f 66 20 74 68 65 0a 2a 2a 20 66 6f rms of the.** fo
13730 72 6d 20 22 78 3d 3d 45 58 50 52 22 20 61 6e 64 rm "x==EXPR" and
13740 20 45 58 50 52 20 69 73 20 6e 6f 74 20 61 20 63 EXPR is not a c
13750 6f 6e 73 74 61 6e 74 20 30 20 6f 72 20 31 2c 20 onstant 0 or 1,
13760 74 68 65 6e 20 6d 61 6b 65 20 73 75 72 65 20 74 then make sure t
13770 68 65 0a 2a 2a 20 66 69 6e 61 6c 20 6f 75 74 70 he.** final outp
13780 75 74 20 72 6f 77 20 65 73 74 69 6d 61 74 65 20 ut row estimate
13790 69 73 20 6e 6f 20 67 72 65 61 74 65 72 20 74 68 is no greater th
137a0 61 6e 20 31 2f 34 20 6f 66 20 74 68 65 20 74 6f an 1/4 of the to
137b0 74 61 6c 20 6e 75 6d 62 65 72 0a 2a 2a 20 6f 66 tal number.** of
137c0 20 72 6f 77 73 20 69 6e 20 74 68 65 20 74 61 62 rows in the tab
137d0 6c 65 2e 20 20 49 6e 20 6f 74 68 65 72 20 77 6f le. In other wo
137e0 72 64 73 2c 20 61 73 73 75 6d 65 20 74 68 61 74 rds, assume that
137f0 20 78 3d 3d 45 58 50 52 20 77 69 6c 6c 20 66 69 x==EXPR will fi
13800 6c 74 65 72 0a 2a 2a 20 6f 75 74 20 61 74 20 6c lter.** out at l
13810 65 61 73 74 20 33 20 6f 75 74 20 6f 66 20 34 20 east 3 out of 4
13820 72 6f 77 73 2e 20 20 49 66 20 45 58 50 52 20 69 rows. If EXPR i
13830 73 20 2d 31 20 6f 72 20 30 20 6f 72 20 31 2c 20 s -1 or 0 or 1,
13840 74 68 65 6e 20 6d 61 79 62 65 20 74 68 65 0a 2a then maybe the.*
13850 2a 20 22 78 22 20 63 6f 6c 75 6d 6e 20 69 73 20 * "x" column is
13860 62 6f 6f 6c 65 61 6e 20 6f 72 20 65 6c 73 65 20 boolean or else
13870 2d 31 20 6f 72 20 30 20 6f 72 20 31 20 69 73 20 -1 or 0 or 1 is
13880 61 20 63 6f 6d 6d 6f 6e 20 64 65 66 61 75 6c 74 a common default
13890 20 76 61 6c 75 65 0a 2a 2a 20 6f 6e 20 74 68 65 value.** on the
138a0 20 22 78 22 20 63 6f 6c 75 6d 6e 20 61 6e 64 20 "x" column and
138b0 73 6f 20 69 6e 20 74 68 61 74 20 63 61 73 65 20 so in that case
138c0 6f 6e 6c 79 20 63 61 70 20 74 68 65 20 6f 75 74 only cap the out
138d0 70 75 74 20 72 6f 77 20 65 73 74 69 6d 61 74 65 put row estimate
138e0 0a 2a 2a 20 61 74 20 31 2f 32 20 69 6e 73 74 65 .** at 1/2 inste
138f0 61 64 20 6f 66 20 31 2f 34 2e 0a 2a 2f 0a 73 74 ad of 1/4..*/.st
13900 61 74 69 63 20 76 6f 69 64 20 77 68 65 72 65 4c atic void whereL
13910 6f 6f 70 4f 75 74 70 75 74 41 64 6a 75 73 74 28 oopOutputAdjust(
13920 0a 20 20 57 68 65 72 65 43 6c 61 75 73 65 20 2a . WhereClause *
13930 70 57 43 2c 20 20 20 20 20 20 2f 2a 20 54 68 65 pWC, /* The
13940 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 2a 2f WHERE clause */
13950 0a 20 20 57 68 65 72 65 4c 6f 6f 70 20 2a 70 4c . WhereLoop *pL
13960 6f 6f 70 2c 20 20 20 20 20 20 2f 2a 20 54 68 65 oop, /* The
13970 20 6c 6f 6f 70 20 74 6f 20 61 64 6a 75 73 74 20 loop to adjust
13980 64 6f 77 6e 77 61 72 64 20 2a 2f 0a 20 20 4c 6f downward */. Lo
13990 67 45 73 74 20 6e 52 6f 77 20 20 20 20 20 20 20 gEst nRow
139a0 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
139b0 66 20 72 6f 77 73 20 69 6e 20 74 68 65 20 65 6e f rows in the en
139c0 74 69 72 65 20 74 61 62 6c 65 20 2a 2f 0a 29 7b tire table */.){
139d0 0a 20 20 57 68 65 72 65 54 65 72 6d 20 2a 70 54 . WhereTerm *pT
139e0 65 72 6d 2c 20 2a 70 58 3b 0a 20 20 42 69 74 6d erm, *pX;. Bitm
139f0 61 73 6b 20 6e 6f 74 41 6c 6c 6f 77 65 64 20 3d ask notAllowed =
13a00 20 7e 28 70 4c 6f 6f 70 2d 3e 70 72 65 72 65 71 ~(pLoop->prereq
13a10 7c 70 4c 6f 6f 70 2d 3e 6d 61 73 6b 53 65 6c 66 |pLoop->maskSelf
13a20 29 3b 0a 20 20 69 6e 74 20 69 2c 20 6a 2c 20 6b );. int i, j, k
13a30 3b 0a 20 20 4c 6f 67 45 73 74 20 69 52 65 64 75 ;. LogEst iRedu
13a40 63 65 20 3d 20 30 3b 20 20 20 20 2f 2a 20 70 4c ce = 0; /* pL
13a50 6f 6f 70 2d 3e 6e 4f 75 74 20 73 68 6f 75 6c 64 oop->nOut should
13a60 20 6e 6f 74 20 65 78 63 65 65 64 20 6e 52 6f 77 not exceed nRow
13a70 2d 69 52 65 64 75 63 65 20 2a 2f 0a 0a 20 20 61 -iReduce */.. a
13a80 73 73 65 72 74 28 20 28 70 4c 6f 6f 70 2d 3e 77 ssert( (pLoop->w
13a90 73 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f 41 sFlags & WHERE_A
13aa0 55 54 4f 5f 49 4e 44 45 58 29 3d 3d 30 20 29 3b UTO_INDEX)==0 );
13ab0 0a 20 20 66 6f 72 28 69 3d 70 57 43 2d 3e 6e 54 . for(i=pWC->nT
13ac0 65 72 6d 2c 20 70 54 65 72 6d 3d 70 57 43 2d 3e erm, pTerm=pWC->
13ad0 61 3b 20 69 3e 30 3b 20 69 2d 2d 2c 20 70 54 65 a; i>0; i--, pTe
13ae0 72 6d 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 28 rm++){. if( (
13af0 70 54 65 72 6d 2d 3e 77 74 46 6c 61 67 73 20 26 pTerm->wtFlags &
13b00 20 54 45 52 4d 5f 56 49 52 54 55 41 4c 29 21 3d TERM_VIRTUAL)!=
13b10 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 69 0 ) break;. i
13b20 66 28 20 28 70 54 65 72 6d 2d 3e 70 72 65 72 65 f( (pTerm->prere
13b30 71 41 6c 6c 20 26 20 70 4c 6f 6f 70 2d 3e 6d 61 qAll & pLoop->ma
13b40 73 6b 53 65 6c 66 29 3d 3d 30 20 29 20 63 6f 6e skSelf)==0 ) con
13b50 74 69 6e 75 65 3b 0a 20 20 20 20 69 66 28 20 28 tinue;. if( (
13b60 70 54 65 72 6d 2d 3e 70 72 65 72 65 71 41 6c 6c pTerm->prereqAll
13b70 20 26 20 6e 6f 74 41 6c 6c 6f 77 65 64 29 21 3d & notAllowed)!=
13b80 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 0 ) continue;.
13b90 20 20 66 6f 72 28 6a 3d 70 4c 6f 6f 70 2d 3e 6e for(j=pLoop->n
13ba0 4c 54 65 72 6d 2d 31 3b 20 6a 3e 3d 30 3b 20 6a LTerm-1; j>=0; j
13bb0 2d 2d 29 7b 0a 20 20 20 20 20 20 70 58 20 3d 20 --){. pX =
13bc0 70 4c 6f 6f 70 2d 3e 61 4c 54 65 72 6d 5b 6a 5d pLoop->aLTerm[j]
13bd0 3b 0a 20 20 20 20 20 20 69 66 28 20 70 58 3d 3d ;. if( pX==
13be0 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 0 ) continue;.
13bf0 20 20 20 20 69 66 28 20 70 58 3d 3d 70 54 65 72 if( pX==pTer
13c00 6d 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 m ) break;.
13c10 20 69 66 28 20 70 58 2d 3e 69 50 61 72 65 6e 74 if( pX->iParent
13c20 3e 3d 30 20 26 26 20 28 26 70 57 43 2d 3e 61 5b >=0 && (&pWC->a[
13c30 70 58 2d 3e 69 50 61 72 65 6e 74 5d 29 3d 3d 70 pX->iParent])==p
13c40 54 65 72 6d 20 29 20 62 72 65 61 6b 3b 0a 20 20 Term ) break;.
13c50 20 20 7d 0a 20 20 20 20 69 66 28 20 6a 3c 30 20 }. if( j<0
13c60 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 54 65 ){. if( pTe
13c70 72 6d 2d 3e 74 72 75 74 68 50 72 6f 62 3c 3d 30 rm->truthProb<=0
13c80 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 49 ){. /* I
13c90 66 20 61 20 74 72 75 74 68 20 70 72 6f 62 61 62 f a truth probab
13ca0 69 6c 69 74 79 20 69 73 20 73 70 65 63 69 66 69 ility is specifi
13cb0 65 64 20 75 73 69 6e 67 20 74 68 65 20 6c 69 6b ed using the lik
13cc0 65 6c 69 68 6f 6f 64 28 29 20 68 69 6e 74 73 2c elihood() hints,
13cd0 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65 6e . ** then
13ce0 20 75 73 65 20 74 68 65 20 70 72 6f 62 61 62 69 use the probabi
13cf0 6c 69 74 79 20 70 72 6f 76 69 64 65 64 20 62 79 lity provided by
13d00 20 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e the application
13d10 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 70 4c 6f . */. pLo
13d20 6f 70 2d 3e 6e 4f 75 74 20 2b 3d 20 70 54 65 72 op->nOut += pTer
13d30 6d 2d 3e 74 72 75 74 68 50 72 6f 62 3b 0a 20 20 m->truthProb;.
13d40 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
13d50 20 20 20 2f 2a 20 49 6e 20 74 68 65 20 61 62 73 /* In the abs
13d60 65 6e 63 65 20 6f 66 20 65 78 70 6c 69 63 69 74 ence of explicit
13d70 20 74 72 75 74 68 20 70 72 6f 62 61 62 69 6c 69 truth probabili
13d80 74 69 65 73 2c 20 75 73 65 20 68 65 75 72 69 73 ties, use heuris
13d90 74 69 63 73 20 74 6f 0a 20 20 20 20 20 20 20 20 tics to.
13da0 2a 2a 20 67 75 65 73 73 20 61 20 72 65 61 73 6f ** guess a reaso
13db0 6e 61 62 6c 65 20 74 72 75 74 68 20 70 72 6f 62 nable truth prob
13dc0 61 62 69 6c 69 74 79 2e 20 2a 2f 0a 20 20 20 20 ability. */.
13dd0 20 20 20 20 70 4c 6f 6f 70 2d 3e 6e 4f 75 74 2d pLoop->nOut-
13de0 2d 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 -;. if( p
13df0 54 65 72 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 26 Term->eOperator&
13e00 28 57 4f 5f 45 51 7c 57 4f 5f 49 53 29 20 29 7b (WO_EQ|WO_IS) ){
13e10 0a 20 20 20 20 20 20 20 20 20 20 45 78 70 72 20 . Expr
13e20 2a 70 52 69 67 68 74 20 3d 20 70 54 65 72 6d 2d *pRight = pTerm-
13e30 3e 70 45 78 70 72 2d 3e 70 52 69 67 68 74 3b 0a >pExpr->pRight;.
13e40 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 61 testca
13e50 73 65 28 20 70 54 65 72 6d 2d 3e 70 45 78 70 72 se( pTerm->pExpr
13e60 2d 3e 6f 70 3d 3d 54 4b 5f 49 53 20 29 3b 0a 20 ->op==TK_IS );.
13e70 20 20 20 20 20 20 20 20 20 69 66 28 20 73 71 6c if( sql
13e80 69 74 65 33 45 78 70 72 49 73 49 6e 74 65 67 65 ite3ExprIsIntege
13e90 72 28 70 52 69 67 68 74 2c 20 26 6b 29 20 26 26 r(pRight, &k) &&
13ea0 20 6b 3e 3d 28 2d 31 29 20 26 26 20 6b 3c 3d 31 k>=(-1) && k<=1
13eb0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
13ec0 6b 20 3d 20 31 30 3b 0a 20 20 20 20 20 20 20 20 k = 10;.
13ed0 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 }else{.
13ee0 20 20 20 20 20 6b 20 3d 20 32 30 3b 0a 20 20 20 k = 20;.
13ef0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
13f00 20 20 20 69 66 28 20 69 52 65 64 75 63 65 3c 6b if( iReduce<k
13f10 20 29 20 69 52 65 64 75 63 65 20 3d 20 6b 3b 0a ) iReduce = k;.
13f20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
13f30 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 }. }. }. if
13f40 28 20 70 4c 6f 6f 70 2d 3e 6e 4f 75 74 20 3e 20 ( pLoop->nOut >
13f50 6e 52 6f 77 2d 69 52 65 64 75 63 65 20 29 20 20 nRow-iReduce )
13f60 70 4c 6f 6f 70 2d 3e 6e 4f 75 74 20 3d 20 6e 52 pLoop->nOut = nR
13f70 6f 77 20 2d 20 69 52 65 64 75 63 65 3b 0a 7d 0a ow - iReduce;.}.
13f80 0a 2f 2a 20 0a 2a 2a 20 54 65 72 6d 20 70 54 65 ./* .** Term pTe
13f90 72 6d 20 69 73 20 61 20 76 65 63 74 6f 72 20 72 rm is a vector r
13fa0 61 6e 67 65 20 63 6f 6d 70 61 72 69 73 6f 6e 20 ange comparison
13fb0 6f 70 65 72 61 74 69 6f 6e 2e 20 54 68 65 20 66 operation. The f
13fc0 69 72 73 74 20 63 6f 6d 70 61 72 69 73 6f 6e 0a irst comparison.
13fd0 2a 2a 20 69 6e 20 74 68 65 20 76 65 63 74 6f 72 ** in the vector
13fe0 20 63 61 6e 20 62 65 20 6f 70 74 69 6d 69 7a 65 can be optimize
13ff0 64 20 75 73 69 6e 67 20 63 6f 6c 75 6d 6e 20 6e d using column n
14000 45 71 20 6f 66 20 74 68 65 20 69 6e 64 65 78 2e Eq of the index.
14010 20 54 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f This.** functio
14020 6e 20 72 65 74 75 72 6e 73 20 74 68 65 20 74 6f n returns the to
14030 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 20 76 65 tal number of ve
14040 63 74 6f 72 20 65 6c 65 6d 65 6e 74 73 20 74 68 ctor elements th
14050 61 74 20 63 61 6e 20 62 65 20 75 73 65 64 0a 2a at can be used.*
14060 2a 20 61 73 20 70 61 72 74 20 6f 66 20 74 68 65 * as part of the
14070 20 72 61 6e 67 65 20 63 6f 6d 70 61 72 69 73 6f range compariso
14080 6e 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 65 78 61 n..**.** For exa
14090 6d 70 6c 65 2c 20 69 66 20 74 68 65 20 71 75 65 mple, if the que
140a0 72 79 20 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 57 ry is:.**.** W
140b0 48 45 52 45 20 61 20 3d 20 3f 20 41 4e 44 20 28 HERE a = ? AND (
140c0 62 2c 20 63 2c 20 64 29 20 3e 20 28 3f 2c 20 3f b, c, d) > (?, ?
140d0 2c 20 3f 29 0a 2a 2a 0a 2a 2a 20 61 6e 64 20 74 , ?).**.** and t
140e0 68 65 20 69 6e 64 65 78 3a 0a 2a 2a 0a 2a 2a 20 he index:.**.**
140f0 20 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 2e CREATE INDEX .
14100 2e 2e 20 4f 4e 20 28 61 2c 20 62 2c 20 63 2c 20 .. ON (a, b, c,
14110 64 2c 20 65 29 0a 2a 2a 0a 2a 2a 20 74 68 65 6e d, e).**.** then
14120 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 77 this function w
14130 6f 75 6c 64 20 62 65 20 69 6e 76 6f 6b 65 64 20 ould be invoked
14140 77 69 74 68 20 6e 45 71 3d 31 2e 20 54 68 65 20 with nEq=1. The
14150 76 61 6c 75 65 20 72 65 74 75 72 6e 65 64 20 69 value returned i
14160 6e 0a 2a 2a 20 74 68 69 73 20 63 61 73 65 20 69 n.** this case i
14170 73 20 33 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 s 3..*/.static i
14180 6e 74 20 77 68 65 72 65 52 61 6e 67 65 56 65 63 nt whereRangeVec
14190 74 6f 72 4c 65 6e 28 0a 20 20 50 61 72 73 65 20 torLen(. Parse
141a0 2a 70 50 61 72 73 65 2c 20 20 20 20 20 20 20 2f *pParse, /
141b0 2a 20 50 61 72 73 69 6e 67 20 63 6f 6e 74 65 78 * Parsing contex
141c0 74 20 2a 2f 0a 20 20 69 6e 74 20 69 43 75 72 2c t */. int iCur,
141d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 43 /* C
141e0 75 72 73 6f 72 20 6f 70 65 6e 20 6f 6e 20 70 49 ursor open on pI
141f0 64 78 20 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 70 dx */. Index *p
14200 49 64 78 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 Idx, /*
14210 54 68 65 20 69 6e 64 65 78 20 74 6f 20 62 65 20 The index to be
14220 75 73 65 64 20 66 6f 72 20 61 20 69 6e 65 71 75 used for a inequ
14230 61 6c 69 74 79 20 63 6f 6e 73 74 72 61 69 6e 74 ality constraint
14240 20 2a 2f 0a 20 20 69 6e 74 20 6e 45 71 2c 20 20 */. int nEq,
14250 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 /* Nu
14260 6d 62 65 72 20 6f 66 20 70 72 69 6f 72 20 65 71 mber of prior eq
14270 75 61 6c 69 74 79 20 63 6f 6e 73 74 72 61 69 6e uality constrain
14280 74 73 20 6f 6e 20 73 61 6d 65 20 69 6e 64 65 78 ts on same index
14290 20 2a 2f 0a 20 20 57 68 65 72 65 54 65 72 6d 20 */. WhereTerm
142a0 2a 70 54 65 72 6d 20 20 20 20 20 2f 2a 20 54 68 *pTerm /* Th
142b0 65 20 76 65 63 74 6f 72 20 69 6e 65 71 75 61 6c e vector inequal
142c0 69 74 79 20 63 6f 6e 73 74 72 61 69 6e 74 20 2a ity constraint *
142d0 2f 0a 29 7b 0a 20 20 69 6e 74 20 6e 43 6d 70 20 /.){. int nCmp
142e0 3d 20 73 71 6c 69 74 65 33 45 78 70 72 56 65 63 = sqlite3ExprVec
142f0 74 6f 72 53 69 7a 65 28 70 54 65 72 6d 2d 3e 70 torSize(pTerm->p
14300 45 78 70 72 2d 3e 70 4c 65 66 74 29 3b 0a 20 20 Expr->pLeft);.
14310 69 6e 74 20 69 3b 0a 0a 20 20 6e 43 6d 70 20 3d int i;.. nCmp =
14320 20 4d 49 4e 28 6e 43 6d 70 2c 20 28 70 49 64 78 MIN(nCmp, (pIdx
14330 2d 3e 6e 43 6f 6c 75 6d 6e 20 2d 20 6e 45 71 29 ->nColumn - nEq)
14340 29 3b 0a 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c );. for(i=1; i<
14350 6e 43 6d 70 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 nCmp; i++){.
14360 2f 2a 20 54 65 73 74 20 69 66 20 63 6f 6d 70 61 /* Test if compa
14370 72 69 73 6f 6e 20 69 20 6f 66 20 70 54 65 72 6d rison i of pTerm
14380 20 69 73 20 63 6f 6d 70 61 74 69 62 6c 65 20 77 is compatible w
14390 69 74 68 20 63 6f 6c 75 6d 6e 20 28 69 2b 6e 45 ith column (i+nE
143a0 71 29 20 0a 20 20 20 20 2a 2a 20 6f 66 20 74 68 q) . ** of th
143b0 65 20 69 6e 64 65 78 2e 20 49 66 20 6e 6f 74 2c e index. If not,
143c0 20 65 78 69 74 20 74 68 65 20 6c 6f 6f 70 2e 20 exit the loop.
143d0 20 2a 2f 0a 20 20 20 20 63 68 61 72 20 61 66 66 */. char aff
143e0 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;
143f0 20 20 20 20 20 20 2f 2a 20 43 6f 6d 70 61 72 69 /* Compari
14400 73 6f 6e 20 61 66 66 69 6e 69 74 79 20 2a 2f 0a son affinity */.
14410 20 20 20 20 63 68 61 72 20 69 64 78 61 66 66 20 char idxaff
14420 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20 = 0;
14430 20 20 2f 2a 20 49 6e 64 65 78 65 64 20 63 6f 6c /* Indexed col
14440 75 6d 6e 73 20 61 66 66 69 6e 69 74 79 20 2a 2f umns affinity */
14450 0a 20 20 20 20 43 6f 6c 6c 53 65 71 20 2a 70 43 . CollSeq *pC
14460 6f 6c 6c 3b 20 20 20 20 20 20 20 20 20 20 20 20 oll;
14470 20 20 20 2f 2a 20 43 6f 6d 70 61 72 69 73 6f 6e /* Comparison
14480 20 63 6f 6c 6c 61 74 69 6f 6e 20 73 65 71 75 65 collation seque
14490 6e 63 65 20 2a 2f 0a 20 20 20 20 45 78 70 72 20 nce */. Expr
144a0 2a 70 4c 68 73 20 3d 20 70 54 65 72 6d 2d 3e 70 *pLhs = pTerm->p
144b0 45 78 70 72 2d 3e 70 4c 65 66 74 2d 3e 78 2e 70 Expr->pLeft->x.p
144c0 4c 69 73 74 2d 3e 61 5b 69 5d 2e 70 45 78 70 72 List->a[i].pExpr
144d0 3b 0a 20 20 20 20 45 78 70 72 20 2a 70 52 68 73 ;. Expr *pRhs
144e0 20 3d 20 70 54 65 72 6d 2d 3e 70 45 78 70 72 2d = pTerm->pExpr-
144f0 3e 70 52 69 67 68 74 3b 0a 20 20 20 20 69 66 28 >pRight;. if(
14500 20 70 52 68 73 2d 3e 66 6c 61 67 73 20 26 20 45 pRhs->flags & E
14510 50 5f 78 49 73 53 65 6c 65 63 74 20 29 7b 0a 20 P_xIsSelect ){.
14520 20 20 20 20 20 70 52 68 73 20 3d 20 70 52 68 73 pRhs = pRhs
14530 2d 3e 78 2e 70 53 65 6c 65 63 74 2d 3e 70 45 4c ->x.pSelect->pEL
14540 69 73 74 2d 3e 61 5b 69 5d 2e 70 45 78 70 72 3b ist->a[i].pExpr;
14550 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
14560 20 20 70 52 68 73 20 3d 20 70 52 68 73 2d 3e 78 pRhs = pRhs->x
14570 2e 70 4c 69 73 74 2d 3e 61 5b 69 5d 2e 70 45 78 .pList->a[i].pEx
14580 70 72 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f pr;. }.. /
14590 2a 20 43 68 65 63 6b 20 74 68 61 74 20 74 68 65 * Check that the
145a0 20 4c 48 53 20 6f 66 20 74 68 65 20 63 6f 6d 70 LHS of the comp
145b0 61 72 69 73 6f 6e 20 69 73 20 61 20 63 6f 6c 75 arison is a colu
145c0 6d 6e 20 72 65 66 65 72 65 6e 63 65 20 74 6f 0a mn reference to.
145d0 20 20 20 20 2a 2a 20 74 68 65 20 72 69 67 68 74 ** the right
145e0 20 63 6f 6c 75 6d 6e 20 6f 66 20 74 68 65 20 72 column of the r
145f0 69 67 68 74 20 73 6f 75 72 63 65 20 74 61 62 6c ight source tabl
14600 65 2e 20 41 6e 64 20 74 68 61 74 20 74 68 65 20 e. And that the
14610 73 6f 72 74 0a 20 20 20 20 2a 2a 20 6f 72 64 65 sort. ** orde
14620 72 20 6f 66 20 74 68 65 20 69 6e 64 65 78 20 63 r of the index c
14630 6f 6c 75 6d 6e 20 69 73 20 74 68 65 20 73 61 6d olumn is the sam
14640 65 20 61 73 20 74 68 65 20 73 6f 72 74 20 6f 72 e as the sort or
14650 64 65 72 20 6f 66 20 74 68 65 0a 20 20 20 20 2a der of the. *
14660 2a 20 6c 65 66 74 6d 6f 73 74 20 69 6e 64 65 78 * leftmost index
14670 20 63 6f 6c 75 6d 6e 2e 20 20 2a 2f 0a 20 20 20 column. */.
14680 20 69 66 28 20 70 4c 68 73 2d 3e 6f 70 21 3d 54 if( pLhs->op!=T
14690 4b 5f 43 4f 4c 55 4d 4e 20 0a 20 20 20 20 20 7c K_COLUMN . |
146a0 7c 20 70 4c 68 73 2d 3e 69 54 61 62 6c 65 21 3d | pLhs->iTable!=
146b0 69 43 75 72 20 0a 20 20 20 20 20 7c 7c 20 70 4c iCur . || pL
146c0 68 73 2d 3e 69 43 6f 6c 75 6d 6e 21 3d 70 49 64 hs->iColumn!=pId
146d0 78 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 69 2b 6e 45 x->aiColumn[i+nE
146e0 71 5d 20 0a 20 20 20 20 20 7c 7c 20 70 49 64 78 q] . || pIdx
146f0 2d 3e 61 53 6f 72 74 4f 72 64 65 72 5b 69 2b 6e ->aSortOrder[i+n
14700 45 71 5d 21 3d 70 49 64 78 2d 3e 61 53 6f 72 74 Eq]!=pIdx->aSort
14710 4f 72 64 65 72 5b 6e 45 71 5d 0a 20 20 20 20 29 Order[nEq]. )
14720 7b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 {. break;.
14730 20 20 20 7d 0a 0a 20 20 20 20 74 65 73 74 63 61 }.. testca
14740 73 65 28 20 70 4c 68 73 2d 3e 69 43 6f 6c 75 6d se( pLhs->iColum
14750 6e 3d 3d 58 4e 5f 52 4f 57 49 44 20 29 3b 0a 20 n==XN_ROWID );.
14760 20 20 20 61 66 66 20 3d 20 73 71 6c 69 74 65 33 aff = sqlite3
14770 43 6f 6d 70 61 72 65 41 66 66 69 6e 69 74 79 28 CompareAffinity(
14780 70 52 68 73 2c 20 73 71 6c 69 74 65 33 45 78 70 pRhs, sqlite3Exp
14790 72 41 66 66 69 6e 69 74 79 28 70 4c 68 73 29 29 rAffinity(pLhs))
147a0 3b 0a 20 20 20 20 69 64 78 61 66 66 20 3d 20 73 ;. idxaff = s
147b0 71 6c 69 74 65 33 54 61 62 6c 65 43 6f 6c 75 6d qlite3TableColum
147c0 6e 41 66 66 69 6e 69 74 79 28 70 49 64 78 2d 3e nAffinity(pIdx->
147d0 70 54 61 62 6c 65 2c 20 70 4c 68 73 2d 3e 69 43 pTable, pLhs->iC
147e0 6f 6c 75 6d 6e 29 3b 0a 20 20 20 20 69 66 28 20 olumn);. if(
147f0 61 66 66 21 3d 69 64 78 61 66 66 20 29 20 62 72 aff!=idxaff ) br
14800 65 61 6b 3b 0a 0a 20 20 20 20 70 43 6f 6c 6c 20 eak;.. pColl
14810 3d 20 73 71 6c 69 74 65 33 42 69 6e 61 72 79 43 = sqlite3BinaryC
14820 6f 6d 70 61 72 65 43 6f 6c 6c 53 65 71 28 70 50 ompareCollSeq(pP
14830 61 72 73 65 2c 20 70 4c 68 73 2c 20 70 52 68 73 arse, pLhs, pRhs
14840 29 3b 0a 20 20 20 20 69 66 28 20 70 43 6f 6c 6c );. if( pColl
14850 3d 3d 30 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 ==0 ) break;.
14860 20 69 66 28 20 73 71 6c 69 74 65 33 53 74 72 49 if( sqlite3StrI
14870 43 6d 70 28 70 43 6f 6c 6c 2d 3e 7a 4e 61 6d 65 Cmp(pColl->zName
14880 2c 20 70 49 64 78 2d 3e 61 7a 43 6f 6c 6c 5b 69 , pIdx->azColl[i
14890 2b 6e 45 71 5d 29 20 29 20 62 72 65 61 6b 3b 0a +nEq]) ) break;.
148a0 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a }. return i;.
148b0 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 6a 75 73 74 20 }../*.** Adjust
148c0 74 68 65 20 63 6f 73 74 20 43 20 62 79 20 74 68 the cost C by th
148d0 65 20 63 6f 73 74 4d 75 6c 74 20 66 61 63 74 65 e costMult facte
148e0 72 20 54 2e 20 20 54 68 69 73 20 6f 6e 6c 79 20 r T. This only
148f0 6f 63 63 75 72 73 20 69 66 0a 2a 2a 20 63 6f 6d occurs if.** com
14900 70 69 6c 65 64 20 77 69 74 68 20 2d 44 53 51 4c piled with -DSQL
14910 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 53 54 4d ITE_ENABLE_COSTM
14920 55 4c 54 0a 2a 2f 0a 23 69 66 64 65 66 20 53 51 ULT.*/.#ifdef SQ
14930 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 43 4f 53 54 LITE_ENABLE_COST
14940 4d 55 4c 54 0a 23 20 64 65 66 69 6e 65 20 41 70 MULT.# define Ap
14950 70 6c 79 43 6f 73 74 4d 75 6c 74 69 70 6c 69 65 plyCostMultiplie
14960 72 28 43 2c 54 29 20 20 43 20 2b 3d 20 54 0a 23 r(C,T) C += T.#
14970 65 6c 73 65 0a 23 20 64 65 66 69 6e 65 20 41 70 else.# define Ap
14980 70 6c 79 43 6f 73 74 4d 75 6c 74 69 70 6c 69 65 plyCostMultiplie
14990 72 28 43 2c 54 29 0a 23 65 6e 64 69 66 0a 0a 2f r(C,T).#endif../
149a0 2a 0a 2a 2a 20 57 65 20 68 61 76 65 20 73 6f 20 *.** We have so
149b0 66 61 72 20 6d 61 74 63 68 65 64 20 70 42 75 69 far matched pBui
149c0 6c 64 65 72 2d 3e 70 4e 65 77 2d 3e 75 2e 62 74 lder->pNew->u.bt
149d0 72 65 65 2e 6e 45 71 20 74 65 72 6d 73 20 6f 66 ree.nEq terms of
149e0 20 74 68 65 20 0a 2a 2a 20 69 6e 64 65 78 20 70 the .** index p
149f0 49 6e 64 65 78 2e 20 54 72 79 20 74 6f 20 6d 61 Index. Try to ma
14a00 74 63 68 20 6f 6e 65 20 6d 6f 72 65 2e 0a 2a 2a tch one more..**
14a10 0a 2a 2a 20 57 68 65 6e 20 74 68 69 73 20 66 75 .** When this fu
14a20 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
14a30 2c 20 70 42 75 69 6c 64 65 72 2d 3e 70 4e 65 77 , pBuilder->pNew
14a40 2d 3e 6e 4f 75 74 20 63 6f 6e 74 61 69 6e 73 20 ->nOut contains
14a50 74 68 65 20 0a 2a 2a 20 6e 75 6d 62 65 72 20 6f the .** number o
14a60 66 20 72 6f 77 73 20 65 78 70 65 63 74 65 64 20 f rows expected
14a70 74 6f 20 62 65 20 76 69 73 69 74 65 64 20 62 79 to be visited by
14a80 20 66 69 6c 74 65 72 69 6e 67 20 75 73 69 6e 67 filtering using
14a90 20 74 68 65 20 6e 45 71 20 0a 2a 2a 20 74 65 72 the nEq .** ter
14aa0 6d 73 20 6f 6e 6c 79 2e 20 49 66 20 69 74 20 69 ms only. If it i
14ab0 73 20 6d 6f 64 69 66 69 65 64 2c 20 74 68 69 73 s modified, this
14ac0 20 76 61 6c 75 65 20 69 73 20 72 65 73 74 6f 72 value is restor
14ad0 65 64 20 62 65 66 6f 72 65 20 74 68 69 73 20 0a ed before this .
14ae0 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 ** function retu
14af0 72 6e 73 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 70 50 rns..**.** If pP
14b00 72 6f 62 65 2d 3e 74 6e 75 6d 3d 3d 30 2c 20 74 robe->tnum==0, t
14b10 68 61 74 20 6d 65 61 6e 73 20 70 49 6e 64 65 78 hat means pIndex
14b20 20 69 73 20 61 20 66 61 6b 65 20 69 6e 64 65 78 is a fake index
14b30 20 75 73 65 64 20 66 6f 72 20 74 68 65 0a 2a 2a used for the.**
14b40 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59 INTEGER PRIMARY
14b50 20 4b 45 59 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 KEY..*/.static
14b60 69 6e 74 20 77 68 65 72 65 4c 6f 6f 70 41 64 64 int whereLoopAdd
14b70 42 74 72 65 65 49 6e 64 65 78 28 0a 20 20 57 68 BtreeIndex(. Wh
14b80 65 72 65 4c 6f 6f 70 42 75 69 6c 64 65 72 20 2a ereLoopBuilder *
14b90 70 42 75 69 6c 64 65 72 2c 20 20 20 20 20 2f 2a pBuilder, /*
14ba0 20 54 68 65 20 57 68 65 72 65 4c 6f 6f 70 20 66 The WhereLoop f
14bb0 61 63 74 6f 72 79 20 2a 2f 0a 20 20 73 74 72 75 actory */. stru
14bc0 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 ct SrcList_item
14bd0 2a 70 53 72 63 2c 20 20 20 20 20 20 2f 2a 20 46 *pSrc, /* F
14be0 52 4f 4d 20 63 6c 61 75 73 65 20 74 65 72 6d 20 ROM clause term
14bf0 62 65 69 6e 67 20 61 6e 61 6c 79 7a 65 64 20 2a being analyzed *
14c00 2f 0a 20 20 49 6e 64 65 78 20 2a 70 50 72 6f 62 /. Index *pProb
14c10 65 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e,
14c20 20 20 20 20 2f 2a 20 41 6e 20 69 6e 64 65 78 20 /* An index
14c30 6f 6e 20 70 53 72 63 20 2a 2f 0a 20 20 4c 6f 67 on pSrc */. Log
14c40 45 73 74 20 6e 49 6e 4d 75 6c 20 20 20 20 20 20 Est nInMul
14c50 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
14c60 6c 6f 67 28 4e 75 6d 62 65 72 20 6f 66 20 69 74 log(Number of it
14c70 65 72 61 74 69 6f 6e 73 20 64 75 65 20 74 6f 20 erations due to
14c80 49 4e 29 20 2a 2f 0a 29 7b 0a 20 20 57 68 65 72 IN) */.){. Wher
14c90 65 49 6e 66 6f 20 2a 70 57 49 6e 66 6f 20 3d 20 eInfo *pWInfo =
14ca0 70 42 75 69 6c 64 65 72 2d 3e 70 57 49 6e 66 6f pBuilder->pWInfo
14cb0 3b 20 20 2f 2a 20 57 48 45 52 45 20 61 6e 61 6c ; /* WHERE anal
14cc0 79 73 65 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 yse context */.
14cd0 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 20 3d Parse *pParse =
14ce0 20 70 57 49 6e 66 6f 2d 3e 70 50 61 72 73 65 3b pWInfo->pParse;
14cf0 20 20 20 20 20 20 20 20 2f 2a 20 50 61 72 73 69 /* Parsi
14d00 6e 67 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 ng context */.
14d10 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 50 sqlite3 *db = pP
14d20 61 72 73 65 2d 3e 64 62 3b 20 20 20 20 20 20 20 arse->db;
14d30 2f 2a 20 44 61 74 61 62 61 73 65 20 63 6f 6e 6e /* Database conn
14d40 65 63 74 69 6f 6e 20 6d 61 6c 6c 6f 63 20 63 6f ection malloc co
14d50 6e 74 65 78 74 20 2a 2f 0a 20 20 57 68 65 72 65 ntext */. Where
14d60 4c 6f 6f 70 20 2a 70 4e 65 77 3b 20 20 20 20 20 Loop *pNew;
14d70 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 /* Te
14d80 6d 70 6c 61 74 65 20 57 68 65 72 65 4c 6f 6f 70 mplate WhereLoop
14d90 20 75 6e 64 65 72 20 63 6f 6e 73 74 72 75 63 74 under construct
14da0 69 6f 6e 20 2a 2f 0a 20 20 57 68 65 72 65 54 65 ion */. WhereTe
14db0 72 6d 20 2a 70 54 65 72 6d 3b 20 20 20 20 20 20 rm *pTerm;
14dc0 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 57 68 /* A Wh
14dd0 65 72 65 54 65 72 6d 20 75 6e 64 65 72 20 63 6f ereTerm under co
14de0 6e 73 69 64 65 72 61 74 69 6f 6e 20 2a 2f 0a 20 nsideration */.
14df0 20 69 6e 74 20 6f 70 4d 61 73 6b 3b 20 20 20 20 int opMask;
14e00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14e10 20 2f 2a 20 56 61 6c 69 64 20 6f 70 65 72 61 74 /* Valid operat
14e20 6f 72 73 20 66 6f 72 20 63 6f 6e 73 74 72 61 69 ors for constrai
14e30 6e 74 73 20 2a 2f 0a 20 20 57 68 65 72 65 53 63 nts */. WhereSc
14e40 61 6e 20 73 63 61 6e 3b 20 20 20 20 20 20 20 20 an scan;
14e50 20 20 20 20 20 20 20 20 20 2f 2a 20 49 74 65 72 /* Iter
14e60 61 74 6f 72 20 66 6f 72 20 57 48 45 52 45 20 74 ator for WHERE t
14e70 65 72 6d 73 20 2a 2f 0a 20 20 42 69 74 6d 61 73 erms */. Bitmas
14e80 6b 20 73 61 76 65 64 5f 70 72 65 72 65 71 3b 20 k saved_prereq;
14e90 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 72 69 /* Ori
14ea0 67 69 6e 61 6c 20 76 61 6c 75 65 20 6f 66 20 70 ginal value of p
14eb0 4e 65 77 2d 3e 70 72 65 72 65 71 20 2a 2f 0a 20 New->prereq */.
14ec0 20 75 31 36 20 73 61 76 65 64 5f 6e 4c 54 65 72 u16 saved_nLTer
14ed0 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 m;
14ee0 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 76 61 6c /* Original val
14ef0 75 65 20 6f 66 20 70 4e 65 77 2d 3e 6e 4c 54 65 ue of pNew->nLTe
14f00 72 6d 20 2a 2f 0a 20 20 75 31 36 20 73 61 76 65 rm */. u16 save
14f10 64 5f 6e 45 71 3b 20 20 20 20 20 20 20 20 20 20 d_nEq;
14f20 20 20 20 20 20 20 20 20 2f 2a 20 4f 72 69 67 69 /* Origi
14f30 6e 61 6c 20 76 61 6c 75 65 20 6f 66 20 70 4e 65 nal value of pNe
14f40 77 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 71 20 2a w->u.btree.nEq *
14f50 2f 0a 20 20 75 31 36 20 73 61 76 65 64 5f 6e 42 /. u16 saved_nB
14f60 74 6d 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 tm;
14f70 20 20 20 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 /* Original
14f80 76 61 6c 75 65 20 6f 66 20 70 4e 65 77 2d 3e 75 value of pNew->u
14f90 2e 62 74 72 65 65 2e 6e 42 74 6d 20 2a 2f 0a 20 .btree.nBtm */.
14fa0 20 75 31 36 20 73 61 76 65 64 5f 6e 54 6f 70 3b u16 saved_nTop;
14fb0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
14fc0 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 76 61 6c /* Original val
14fd0 75 65 20 6f 66 20 70 4e 65 77 2d 3e 75 2e 62 74 ue of pNew->u.bt
14fe0 72 65 65 2e 6e 54 6f 70 20 2a 2f 0a 20 20 75 31 ree.nTop */. u1
14ff0 36 20 73 61 76 65 64 5f 6e 53 6b 69 70 3b 20 20 6 saved_nSkip;
15000 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
15010 20 4f 72 69 67 69 6e 61 6c 20 76 61 6c 75 65 20 Original value
15020 6f 66 20 70 4e 65 77 2d 3e 6e 53 6b 69 70 20 2a of pNew->nSkip *
15030 2f 0a 20 20 75 33 32 20 73 61 76 65 64 5f 77 73 /. u32 saved_ws
15040 46 6c 61 67 73 3b 20 20 20 20 20 20 20 20 20 20 Flags;
15050 20 20 20 20 2f 2a 20 4f 72 69 67 69 6e 61 6c 20 /* Original
15060 76 61 6c 75 65 20 6f 66 20 70 4e 65 77 2d 3e 77 value of pNew->w
15070 73 46 6c 61 67 73 20 2a 2f 0a 20 20 4c 6f 67 45 sFlags */. LogE
15080 73 74 20 73 61 76 65 64 5f 6e 4f 75 74 3b 20 20 st saved_nOut;
15090 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4f /* O
150a0 72 69 67 69 6e 61 6c 20 76 61 6c 75 65 20 6f 66 riginal value of
150b0 20 70 4e 65 77 2d 3e 6e 4f 75 74 20 2a 2f 0a 20 pNew->nOut */.
150c0 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 int rc = SQLITE
150d0 5f 4f 4b 3b 20 20 20 20 20 20 20 20 20 20 20 20 _OK;
150e0 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64 65 20 /* Return code
150f0 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 72 53 69 7a */. LogEst rSiz
15100 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 e;
15110 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
15120 66 20 72 6f 77 73 20 69 6e 20 74 68 65 20 74 61 f rows in the ta
15130 62 6c 65 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 ble */. LogEst
15140 72 4c 6f 67 53 69 7a 65 3b 20 20 20 20 20 20 20 rLogSize;
15150 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 67 61 /* Loga
15160 72 69 74 68 6d 20 6f 66 20 74 61 62 6c 65 20 73 rithm of table s
15170 69 7a 65 20 2a 2f 0a 20 20 57 68 65 72 65 54 65 ize */. WhereTe
15180 72 6d 20 2a 70 54 6f 70 20 3d 20 30 2c 20 2a 70 rm *pTop = 0, *p
15190 42 74 6d 20 3d 20 30 3b 20 2f 2a 20 54 6f 70 20 Btm = 0; /* Top
151a0 61 6e 64 20 62 6f 74 74 6f 6d 20 72 61 6e 67 65 and bottom range
151b0 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a constraints */.
151c0 0a 20 20 70 4e 65 77 20 3d 20 70 42 75 69 6c 64 . pNew = pBuild
151d0 65 72 2d 3e 70 4e 65 77 3b 0a 20 20 69 66 28 20 er->pNew;. if(
151e0 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
151f0 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 ) return SQLITE
15200 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 57 _NOMEM_BKPT;. W
15210 48 45 52 45 54 52 41 43 45 28 30 78 38 30 30 2c HERETRACE(0x800,
15220 20 28 22 42 45 47 49 4e 20 25 73 2e 61 64 64 42 ("BEGIN %s.addB
15230 74 72 65 65 49 64 78 28 25 73 29 2c 20 6e 45 71 treeIdx(%s), nEq
15240 3d 25 64 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 =%d\n",.
15250 20 20 20 20 20 20 20 20 20 20 20 20 20 70 50 72 pPr
15260 6f 62 65 2d 3e 70 54 61 62 6c 65 2d 3e 7a 4e 61 obe->pTable->zNa
15270 6d 65 2c 70 50 72 6f 62 65 2d 3e 7a 4e 61 6d 65 me,pProbe->zName
15280 2c 20 70 4e 65 77 2d 3e 75 2e 62 74 72 65 65 2e , pNew->u.btree.
15290 6e 45 71 29 29 3b 0a 0a 20 20 61 73 73 65 72 74 nEq));.. assert
152a0 28 20 28 70 4e 65 77 2d 3e 77 73 46 6c 61 67 73 ( (pNew->wsFlags
152b0 20 26 20 57 48 45 52 45 5f 56 49 52 54 55 41 4c & WHERE_VIRTUAL
152c0 54 41 42 4c 45 29 3d 3d 30 20 29 3b 0a 20 20 61 TABLE)==0 );. a
152d0 73 73 65 72 74 28 20 28 70 4e 65 77 2d 3e 77 73 ssert( (pNew->ws
152e0 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f 54 4f Flags & WHERE_TO
152f0 50 5f 4c 49 4d 49 54 29 3d 3d 30 20 29 3b 0a 20 P_LIMIT)==0 );.
15300 20 69 66 28 20 70 4e 65 77 2d 3e 77 73 46 6c 61 if( pNew->wsFla
15310 67 73 20 26 20 57 48 45 52 45 5f 42 54 4d 5f 4c gs & WHERE_BTM_L
15320 49 4d 49 54 20 29 7b 0a 20 20 20 20 6f 70 4d 61 IMIT ){. opMa
15330 73 6b 20 3d 20 57 4f 5f 4c 54 7c 57 4f 5f 4c 45 sk = WO_LT|WO_LE
15340 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 61 ;. }else{. a
15350 73 73 65 72 74 28 20 70 4e 65 77 2d 3e 75 2e 62 ssert( pNew->u.b
15360 74 72 65 65 2e 6e 42 74 6d 3d 3d 30 20 29 3b 0a tree.nBtm==0 );.
15370 20 20 20 20 6f 70 4d 61 73 6b 20 3d 20 57 4f 5f opMask = WO_
15380 45 51 7c 57 4f 5f 49 4e 7c 57 4f 5f 47 54 7c 57 EQ|WO_IN|WO_GT|W
15390 4f 5f 47 45 7c 57 4f 5f 4c 54 7c 57 4f 5f 4c 45 O_GE|WO_LT|WO_LE
153a0 7c 57 4f 5f 49 53 4e 55 4c 4c 7c 57 4f 5f 49 53 |WO_ISNULL|WO_IS
153b0 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 72 6f ;. }. if( pPro
153c0 62 65 2d 3e 62 55 6e 6f 72 64 65 72 65 64 20 29 be->bUnordered )
153d0 20 6f 70 4d 61 73 6b 20 26 3d 20 7e 28 57 4f 5f opMask &= ~(WO_
153e0 47 54 7c 57 4f 5f 47 45 7c 57 4f 5f 4c 54 7c 57 GT|WO_GE|WO_LT|W
153f0 4f 5f 4c 45 29 3b 0a 0a 20 20 61 73 73 65 72 74 O_LE);.. assert
15400 28 20 70 4e 65 77 2d 3e 75 2e 62 74 72 65 65 2e ( pNew->u.btree.
15410 6e 45 71 3c 70 50 72 6f 62 65 2d 3e 6e 43 6f 6c nEq<pProbe->nCol
15420 75 6d 6e 20 29 3b 0a 0a 20 20 73 61 76 65 64 5f umn );.. saved_
15430 6e 45 71 20 3d 20 70 4e 65 77 2d 3e 75 2e 62 74 nEq = pNew->u.bt
15440 72 65 65 2e 6e 45 71 3b 0a 20 20 73 61 76 65 64 ree.nEq;. saved
15450 5f 6e 42 74 6d 20 3d 20 70 4e 65 77 2d 3e 75 2e _nBtm = pNew->u.
15460 62 74 72 65 65 2e 6e 42 74 6d 3b 0a 20 20 73 61 btree.nBtm;. sa
15470 76 65 64 5f 6e 54 6f 70 20 3d 20 70 4e 65 77 2d ved_nTop = pNew-
15480 3e 75 2e 62 74 72 65 65 2e 6e 54 6f 70 3b 0a 20 >u.btree.nTop;.
15490 20 73 61 76 65 64 5f 6e 53 6b 69 70 20 3d 20 70 saved_nSkip = p
154a0 4e 65 77 2d 3e 6e 53 6b 69 70 3b 0a 20 20 73 61 New->nSkip;. sa
154b0 76 65 64 5f 6e 4c 54 65 72 6d 20 3d 20 70 4e 65 ved_nLTerm = pNe
154c0 77 2d 3e 6e 4c 54 65 72 6d 3b 0a 20 20 73 61 76 w->nLTerm;. sav
154d0 65 64 5f 77 73 46 6c 61 67 73 20 3d 20 70 4e 65 ed_wsFlags = pNe
154e0 77 2d 3e 77 73 46 6c 61 67 73 3b 0a 20 20 73 61 w->wsFlags;. sa
154f0 76 65 64 5f 70 72 65 72 65 71 20 3d 20 70 4e 65 ved_prereq = pNe
15500 77 2d 3e 70 72 65 72 65 71 3b 0a 20 20 73 61 76 w->prereq;. sav
15510 65 64 5f 6e 4f 75 74 20 3d 20 70 4e 65 77 2d 3e ed_nOut = pNew->
15520 6e 4f 75 74 3b 0a 20 20 70 54 65 72 6d 20 3d 20 nOut;. pTerm =
15530 77 68 65 72 65 53 63 61 6e 49 6e 69 74 28 26 73 whereScanInit(&s
15540 63 61 6e 2c 20 70 42 75 69 6c 64 65 72 2d 3e 70 can, pBuilder->p
15550 57 43 2c 20 70 53 72 63 2d 3e 69 43 75 72 73 6f WC, pSrc->iCurso
15560 72 2c 20 73 61 76 65 64 5f 6e 45 71 2c 0a 20 20 r, saved_nEq,.
15570 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
15580 20 20 20 20 20 20 6f 70 4d 61 73 6b 2c 20 70 50 opMask, pP
15590 72 6f 62 65 29 3b 0a 20 20 70 4e 65 77 2d 3e 72 robe);. pNew->r
155a0 53 65 74 75 70 20 3d 20 30 3b 0a 20 20 72 53 69 Setup = 0;. rSi
155b0 7a 65 20 3d 20 70 50 72 6f 62 65 2d 3e 61 69 52 ze = pProbe->aiR
155c0 6f 77 4c 6f 67 45 73 74 5b 30 5d 3b 0a 20 20 72 owLogEst[0];. r
155d0 4c 6f 67 53 69 7a 65 20 3d 20 65 73 74 4c 6f 67 LogSize = estLog
155e0 28 72 53 69 7a 65 29 3b 0a 20 20 66 6f 72 28 3b (rSize);. for(;
155f0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
15600 26 20 70 54 65 72 6d 21 3d 30 3b 20 70 54 65 72 & pTerm!=0; pTer
15610 6d 20 3d 20 77 68 65 72 65 53 63 61 6e 4e 65 78 m = whereScanNex
15620 74 28 26 73 63 61 6e 29 29 7b 0a 20 20 20 20 75 t(&scan)){. u
15630 31 36 20 65 4f 70 20 3d 20 70 54 65 72 6d 2d 3e 16 eOp = pTerm->
15640 65 4f 70 65 72 61 74 6f 72 3b 20 20 20 2f 2a 20 eOperator; /*
15650 53 68 6f 72 74 68 61 6e 64 20 66 6f 72 20 70 54 Shorthand for pT
15660 65 72 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 2a erm->eOperator *
15670 2f 0a 20 20 20 20 4c 6f 67 45 73 74 20 72 43 6f /. LogEst rCo
15680 73 74 49 64 78 3b 0a 20 20 20 20 4c 6f 67 45 73 stIdx;. LogEs
15690 74 20 6e 4f 75 74 55 6e 61 64 6a 75 73 74 65 64 t nOutUnadjusted
156a0 3b 20 20 20 20 20 20 20 20 2f 2a 20 6e 4f 75 74 ; /* nOut
156b0 20 62 65 66 6f 72 65 20 49 4e 28 29 20 61 6e 64 before IN() and
156c0 20 57 48 45 52 45 20 61 64 6a 75 73 74 6d 65 6e WHERE adjustmen
156d0 74 73 20 2a 2f 0a 20 20 20 20 69 6e 74 20 6e 49 ts */. int nI
156e0 6e 20 3d 20 30 3b 0a 23 69 66 64 65 66 20 53 51 n = 0;.#ifdef SQ
156f0 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 LITE_ENABLE_STAT
15700 33 5f 4f 52 5f 53 54 41 54 34 0a 20 20 20 20 69 3_OR_STAT4. i
15710 6e 74 20 6e 52 65 63 56 61 6c 69 64 20 3d 20 70 nt nRecValid = p
15720 42 75 69 6c 64 65 72 2d 3e 6e 52 65 63 56 61 6c Builder->nRecVal
15730 69 64 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 id;.#endif. i
15740 66 28 20 28 65 4f 70 3d 3d 57 4f 5f 49 53 4e 55 f( (eOp==WO_ISNU
15750 4c 4c 20 7c 7c 20 28 70 54 65 72 6d 2d 3e 77 74 LL || (pTerm->wt
15760 46 6c 61 67 73 26 54 45 52 4d 5f 56 4e 55 4c 4c Flags&TERM_VNULL
15770 29 21 3d 30 29 0a 20 20 20 20 20 26 26 20 69 6e )!=0). && in
15780 64 65 78 43 6f 6c 75 6d 6e 4e 6f 74 4e 75 6c 6c dexColumnNotNull
15790 28 70 50 72 6f 62 65 2c 20 73 61 76 65 64 5f 6e (pProbe, saved_n
157a0 45 71 29 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 Eq). ){.
157b0 20 63 6f 6e 74 69 6e 75 65 3b 20 2f 2a 20 69 67 continue; /* ig
157c0 6e 6f 72 65 20 49 53 20 5b 4e 4f 54 5d 20 4e 55 nore IS [NOT] NU
157d0 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 6f LL constraints o
157e0 6e 20 4e 4f 54 20 4e 55 4c 4c 20 63 6f 6c 75 6d n NOT NULL colum
157f0 6e 73 20 2a 2f 0a 20 20 20 20 7d 0a 20 20 20 20 ns */. }.
15800 69 66 28 20 70 54 65 72 6d 2d 3e 70 72 65 72 65 if( pTerm->prere
15810 71 52 69 67 68 74 20 26 20 70 4e 65 77 2d 3e 6d qRight & pNew->m
15820 61 73 6b 53 65 6c 66 20 29 20 63 6f 6e 74 69 6e askSelf ) contin
15830 75 65 3b 0a 0a 20 20 20 20 2f 2a 20 44 6f 20 6e ue;.. /* Do n
15840 6f 74 20 61 6c 6c 6f 77 20 74 68 65 20 75 70 70 ot allow the upp
15850 65 72 20 62 6f 75 6e 64 20 6f 66 20 61 20 4c 49 er bound of a LI
15860 4b 45 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 KE optimization
15870 72 61 6e 67 65 20 63 6f 6e 73 74 72 61 69 6e 74 range constraint
15880 0a 20 20 20 20 2a 2a 20 74 6f 20 6d 69 78 20 77 . ** to mix w
15890 69 74 68 20 61 20 6c 6f 77 65 72 20 72 61 6e 67 ith a lower rang
158a0 65 20 62 6f 75 6e 64 20 66 72 6f 6d 20 73 6f 6d e bound from som
158b0 65 20 6f 74 68 65 72 20 73 6f 75 72 63 65 20 2a e other source *
158c0 2f 0a 20 20 20 20 69 66 28 20 70 54 65 72 6d 2d /. if( pTerm-
158d0 3e 77 74 46 6c 61 67 73 20 26 20 54 45 52 4d 5f >wtFlags & TERM_
158e0 4c 49 4b 45 4f 50 54 20 26 26 20 70 54 65 72 6d LIKEOPT && pTerm
158f0 2d 3e 65 4f 70 65 72 61 74 6f 72 3d 3d 57 4f 5f ->eOperator==WO_
15900 4c 54 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 0a LT ) continue;..
15910 20 20 20 20 2f 2a 20 44 6f 20 6e 6f 74 20 61 6c /* Do not al
15920 6c 6f 77 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 low constraints
15930 66 72 6f 6d 20 74 68 65 20 57 48 45 52 45 20 63 from the WHERE c
15940 6c 61 75 73 65 20 74 6f 20 62 65 20 75 73 65 64 lause to be used
15950 20 62 79 20 74 68 65 0a 20 20 20 20 2a 2a 20 72 by the. ** r
15960 69 67 68 74 20 74 61 62 6c 65 20 6f 66 20 61 20 ight table of a
15970 4c 45 46 54 20 4a 4f 49 4e 2e 20 20 4f 6e 6c 79 LEFT JOIN. Only
15980 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 69 6e 20 constraints in
15990 74 68 65 20 4f 4e 20 63 6c 61 75 73 65 20 61 72 the ON clause ar
159a0 65 0a 20 20 20 20 2a 2a 20 61 6c 6c 6f 77 65 64 e. ** allowed
159b0 20 2a 2f 0a 20 20 20 20 69 66 28 20 28 70 53 72 */. if( (pSr
159c0 63 2d 3e 66 67 2e 6a 6f 69 6e 74 79 70 65 20 26 c->fg.jointype &
159d0 20 4a 54 5f 4c 45 46 54 29 21 3d 30 0a 20 20 20 JT_LEFT)!=0.
159e0 20 20 26 26 20 21 45 78 70 72 48 61 73 50 72 6f && !ExprHasPro
159f0 70 65 72 74 79 28 70 54 65 72 6d 2d 3e 70 45 78 perty(pTerm->pEx
15a00 70 72 2c 20 45 50 5f 46 72 6f 6d 4a 6f 69 6e 29 pr, EP_FromJoin)
15a10 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 63 6f . ){. co
15a20 6e 74 69 6e 75 65 3b 0a 20 20 20 20 7d 0a 0a 20 ntinue;. }..
15a30 20 20 20 69 66 28 20 49 73 55 6e 69 71 75 65 49 if( IsUniqueI
15a40 6e 64 65 78 28 70 50 72 6f 62 65 29 20 26 26 20 ndex(pProbe) &&
15a50 73 61 76 65 64 5f 6e 45 71 3d 3d 70 50 72 6f 62 saved_nEq==pProb
15a60 65 2d 3e 6e 4b 65 79 43 6f 6c 2d 31 20 29 7b 0a e->nKeyCol-1 ){.
15a70 20 20 20 20 20 20 70 42 75 69 6c 64 65 72 2d 3e pBuilder->
15a80 62 6c 64 46 6c 61 67 73 20 7c 3d 20 53 51 4c 49 bldFlags |= SQLI
15a90 54 45 5f 42 4c 44 46 5f 55 4e 49 51 55 45 3b 0a TE_BLDF_UNIQUE;.
15aa0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
15ab0 20 70 42 75 69 6c 64 65 72 2d 3e 62 6c 64 46 6c pBuilder->bldFl
15ac0 61 67 73 20 7c 3d 20 53 51 4c 49 54 45 5f 42 4c ags |= SQLITE_BL
15ad0 44 46 5f 49 4e 44 45 58 45 44 3b 0a 20 20 20 20 DF_INDEXED;.
15ae0 7d 0a 20 20 20 20 70 4e 65 77 2d 3e 77 73 46 6c }. pNew->wsFl
15af0 61 67 73 20 3d 20 73 61 76 65 64 5f 77 73 46 6c ags = saved_wsFl
15b00 61 67 73 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 75 ags;. pNew->u
15b10 2e 62 74 72 65 65 2e 6e 45 71 20 3d 20 73 61 76 .btree.nEq = sav
15b20 65 64 5f 6e 45 71 3b 0a 20 20 20 20 70 4e 65 77 ed_nEq;. pNew
15b30 2d 3e 75 2e 62 74 72 65 65 2e 6e 42 74 6d 20 3d ->u.btree.nBtm =
15b40 20 73 61 76 65 64 5f 6e 42 74 6d 3b 0a 20 20 20 saved_nBtm;.
15b50 20 70 4e 65 77 2d 3e 75 2e 62 74 72 65 65 2e 6e pNew->u.btree.n
15b60 54 6f 70 20 3d 20 73 61 76 65 64 5f 6e 54 6f 70 Top = saved_nTop
15b70 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 6e 4c 54 65 ;. pNew->nLTe
15b80 72 6d 20 3d 20 73 61 76 65 64 5f 6e 4c 54 65 72 rm = saved_nLTer
15b90 6d 3b 0a 20 20 20 20 69 66 28 20 77 68 65 72 65 m;. if( where
15ba0 4c 6f 6f 70 52 65 73 69 7a 65 28 64 62 2c 20 70 LoopResize(db, p
15bb0 4e 65 77 2c 20 70 4e 65 77 2d 3e 6e 4c 54 65 72 New, pNew->nLTer
15bc0 6d 2b 31 29 20 29 20 62 72 65 61 6b 3b 20 2f 2a m+1) ) break; /*
15bd0 20 4f 4f 4d 20 2a 2f 0a 20 20 20 20 70 4e 65 77 OOM */. pNew
15be0 2d 3e 61 4c 54 65 72 6d 5b 70 4e 65 77 2d 3e 6e ->aLTerm[pNew->n
15bf0 4c 54 65 72 6d 2b 2b 5d 20 3d 20 70 54 65 72 6d LTerm++] = pTerm
15c00 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 70 72 65 72 ;. pNew->prer
15c10 65 71 20 3d 20 28 73 61 76 65 64 5f 70 72 65 72 eq = (saved_prer
15c20 65 71 20 7c 20 70 54 65 72 6d 2d 3e 70 72 65 72 eq | pTerm->prer
15c30 65 71 52 69 67 68 74 29 20 26 20 7e 70 4e 65 77 eqRight) & ~pNew
15c40 2d 3e 6d 61 73 6b 53 65 6c 66 3b 0a 0a 20 20 20 ->maskSelf;..
15c50 20 61 73 73 65 72 74 28 20 6e 49 6e 4d 75 6c 3d assert( nInMul=
15c60 3d 30 0a 20 20 20 20 20 20 20 20 7c 7c 20 28 70 =0. || (p
15c70 4e 65 77 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 New->wsFlags & W
15c80 48 45 52 45 5f 43 4f 4c 55 4d 4e 5f 4e 55 4c 4c HERE_COLUMN_NULL
15c90 29 21 3d 30 20 0a 20 20 20 20 20 20 20 20 7c 7c )!=0 . ||
15ca0 20 28 70 4e 65 77 2d 3e 77 73 46 6c 61 67 73 20 (pNew->wsFlags
15cb0 26 20 57 48 45 52 45 5f 43 4f 4c 55 4d 4e 5f 49 & WHERE_COLUMN_I
15cc0 4e 29 21 3d 30 20 0a 20 20 20 20 20 20 20 20 7c N)!=0 . |
15cd0 7c 20 28 70 4e 65 77 2d 3e 77 73 46 6c 61 67 73 | (pNew->wsFlags
15ce0 20 26 20 57 48 45 52 45 5f 53 4b 49 50 53 43 41 & WHERE_SKIPSCA
15cf0 4e 29 21 3d 30 20 0a 20 20 20 20 29 3b 0a 0a 20 N)!=0 . );..
15d00 20 20 20 69 66 28 20 65 4f 70 20 26 20 57 4f 5f if( eOp & WO_
15d10 49 4e 20 29 7b 0a 20 20 20 20 20 20 45 78 70 72 IN ){. Expr
15d20 20 2a 70 45 78 70 72 20 3d 20 70 54 65 72 6d 2d *pExpr = pTerm-
15d30 3e 70 45 78 70 72 3b 0a 20 20 20 20 20 20 70 4e >pExpr;. pN
15d40 65 77 2d 3e 77 73 46 6c 61 67 73 20 7c 3d 20 57 ew->wsFlags |= W
15d50 48 45 52 45 5f 43 4f 4c 55 4d 4e 5f 49 4e 3b 0a HERE_COLUMN_IN;.
15d60 20 20 20 20 20 20 69 66 28 20 45 78 70 72 48 61 if( ExprHa
15d70 73 50 72 6f 70 65 72 74 79 28 70 45 78 70 72 2c sProperty(pExpr,
15d80 20 45 50 5f 78 49 73 53 65 6c 65 63 74 29 20 29 EP_xIsSelect) )
15d90 7b 0a 20 20 20 20 20 20 20 20 2f 2a 20 22 78 20 {. /* "x
15da0 49 4e 20 28 53 45 4c 45 43 54 20 2e 2e 2e 29 22 IN (SELECT ...)"
15db0 3a 20 20 54 55 4e 49 4e 47 3a 20 74 68 65 20 53 : TUNING: the S
15dc0 45 4c 45 43 54 20 72 65 74 75 72 6e 73 20 32 35 ELECT returns 25
15dd0 20 72 6f 77 73 20 2a 2f 0a 20 20 20 20 20 20 20 rows */.
15de0 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 20 20 int i;.
15df0 6e 49 6e 20 3d 20 34 36 3b 20 20 61 73 73 65 72 nIn = 46; asser
15e00 74 28 20 34 36 3d 3d 73 71 6c 69 74 65 33 4c 6f t( 46==sqlite3Lo
15e10 67 45 73 74 28 32 35 29 20 29 3b 0a 0a 20 20 20 gEst(25) );..
15e20 20 20 20 20 20 2f 2a 20 54 68 65 20 65 78 70 72 /* The expr
15e30 65 73 73 69 6f 6e 20 6d 61 79 20 61 63 74 75 61 ession may actua
15e40 6c 6c 79 20 62 65 20 6f 66 20 74 68 65 20 66 6f lly be of the fo
15e50 72 6d 20 28 78 2c 20 79 29 20 49 4e 20 28 53 45 rm (x, y) IN (SE
15e60 4c 45 43 54 2e 2e 2e 29 2e 0a 20 20 20 20 20 20 LECT...)..
15e70 20 20 2a 2a 20 49 6e 20 74 68 69 73 20 63 61 73 ** In this cas
15e80 65 20 74 68 65 72 65 20 69 73 20 61 20 73 65 70 e there is a sep
15e90 61 72 61 74 65 20 74 65 72 6d 20 66 6f 72 20 65 arate term for e
15ea0 61 63 68 20 6f 66 20 28 78 29 20 61 6e 64 20 28 ach of (x) and (
15eb0 79 29 2e 0a 20 20 20 20 20 20 20 20 2a 2a 20 48 y).. ** H
15ec0 6f 77 65 76 65 72 2c 20 74 68 65 20 6e 49 6e 20 owever, the nIn
15ed0 6d 75 6c 74 69 70 6c 69 65 72 20 73 68 6f 75 6c multiplier shoul
15ee0 64 20 6f 6e 6c 79 20 62 65 20 61 70 70 6c 69 65 d only be applie
15ef0 64 20 6f 6e 63 65 2c 20 6e 6f 74 20 6f 6e 63 65 d once, not once
15f00 0a 20 20 20 20 20 20 20 20 2a 2a 20 66 6f 72 20 . ** for
15f10 65 61 63 68 20 73 75 63 68 20 74 65 72 6d 2e 20 each such term.
15f20 54 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6c 6f The following lo
15f30 6f 70 20 63 68 65 63 6b 73 20 74 68 61 74 20 70 op checks that p
15f40 54 65 72 6d 20 69 73 20 74 68 65 0a 20 20 20 20 Term is the.
15f50 20 20 20 20 2a 2a 20 66 69 72 73 74 20 73 75 63 ** first suc
15f60 68 20 74 65 72 6d 20 69 6e 20 75 73 65 2c 20 61 h term in use, a
15f70 6e 64 20 73 65 74 73 20 6e 49 6e 20 62 61 63 6b nd sets nIn back
15f80 20 74 6f 20 30 20 69 66 20 69 74 20 69 73 20 6e to 0 if it is n
15f90 6f 74 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 66 ot. */. f
15fa0 6f 72 28 69 3d 30 3b 20 69 3c 70 4e 65 77 2d 3e or(i=0; i<pNew->
15fb0 6e 4c 54 65 72 6d 2d 31 3b 20 69 2b 2b 29 7b 0a nLTerm-1; i++){.
15fc0 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 4e if( pN
15fd0 65 77 2d 3e 61 4c 54 65 72 6d 5b 69 5d 20 26 26 ew->aLTerm[i] &&
15fe0 20 70 4e 65 77 2d 3e 61 4c 54 65 72 6d 5b 69 5d pNew->aLTerm[i]
15ff0 2d 3e 70 45 78 70 72 3d 3d 70 45 78 70 72 20 29 ->pExpr==pExpr )
16000 20 6e 49 6e 20 3d 20 30 3b 0a 20 20 20 20 20 20 nIn = 0;.
16010 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65 20 }. }else
16020 69 66 28 20 41 4c 57 41 59 53 28 70 45 78 70 72 if( ALWAYS(pExpr
16030 2d 3e 78 2e 70 4c 69 73 74 20 26 26 20 70 45 78 ->x.pList && pEx
16040 70 72 2d 3e 78 2e 70 4c 69 73 74 2d 3e 6e 45 78 pr->x.pList->nEx
16050 70 72 29 20 29 7b 0a 20 20 20 20 20 20 20 20 2f pr) ){. /
16060 2a 20 22 78 20 49 4e 20 28 76 61 6c 75 65 2c 20 * "x IN (value,
16070 76 61 6c 75 65 2c 20 2e 2e 2e 29 22 20 2a 2f 0a value, ...)" */.
16080 20 20 20 20 20 20 20 20 6e 49 6e 20 3d 20 73 71 nIn = sq
16090 6c 69 74 65 33 4c 6f 67 45 73 74 28 70 45 78 70 lite3LogEst(pExp
160a0 72 2d 3e 78 2e 70 4c 69 73 74 2d 3e 6e 45 78 70 r->x.pList->nExp
160b0 72 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 r);. asse
160c0 72 74 28 20 6e 49 6e 3e 30 20 29 3b 20 20 2f 2a rt( nIn>0 ); /*
160d0 20 52 48 53 20 61 6c 77 61 79 73 20 68 61 73 20 RHS always has
160e0 32 20 6f 72 20 6d 6f 72 65 20 74 65 72 6d 73 2e 2 or more terms.
160f0 2e 2e 20 20 54 68 65 20 70 61 72 73 65 72 0a 20 .. The parser.
16100 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16110 20 20 20 20 20 20 20 20 20 2a 2a 20 63 68 61 6e ** chan
16120 67 65 73 20 22 78 20 49 4e 20 28 3f 29 22 20 69 ges "x IN (?)" i
16130 6e 74 6f 20 22 78 3d 3f 22 2e 20 2a 2f 0a 20 20 nto "x=?". */.
16140 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 20 }. }else
16150 69 66 28 20 65 4f 70 20 26 20 28 57 4f 5f 45 51 if( eOp & (WO_EQ
16160 7c 57 4f 5f 49 53 29 20 29 7b 0a 20 20 20 20 20 |WO_IS) ){.
16170 20 69 6e 74 20 69 43 6f 6c 20 3d 20 70 50 72 6f int iCol = pPro
16180 62 65 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 73 61 76 be->aiColumn[sav
16190 65 64 5f 6e 45 71 5d 3b 0a 20 20 20 20 20 20 70 ed_nEq];. p
161a0 4e 65 77 2d 3e 77 73 46 6c 61 67 73 20 7c 3d 20 New->wsFlags |=
161b0 57 48 45 52 45 5f 43 4f 4c 55 4d 4e 5f 45 51 3b WHERE_COLUMN_EQ;
161c0 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 73 . assert( s
161d0 61 76 65 64 5f 6e 45 71 3d 3d 70 4e 65 77 2d 3e aved_nEq==pNew->
161e0 75 2e 62 74 72 65 65 2e 6e 45 71 20 29 3b 0a 20 u.btree.nEq );.
161f0 20 20 20 20 20 69 66 28 20 69 43 6f 6c 3d 3d 58 if( iCol==X
16200 4e 5f 52 4f 57 49 44 20 0a 20 20 20 20 20 20 20 N_ROWID .
16210 7c 7c 20 28 69 43 6f 6c 3e 3d 30 20 26 26 20 6e || (iCol>=0 && n
16220 49 6e 4d 75 6c 3d 3d 30 20 26 26 20 73 61 76 65 InMul==0 && save
16230 64 5f 6e 45 71 3d 3d 70 50 72 6f 62 65 2d 3e 6e d_nEq==pProbe->n
16240 4b 65 79 43 6f 6c 2d 31 29 0a 20 20 20 20 20 20 KeyCol-1).
16250 29 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 ){. if( i
16260 43 6f 6c 3d 3d 58 4e 5f 52 4f 57 49 44 20 7c 7c Col==XN_ROWID ||
16270 20 70 50 72 6f 62 65 2d 3e 75 6e 69 71 4e 6f 74 pProbe->uniqNot
16280 4e 75 6c 6c 20 0a 20 20 20 20 20 20 20 20 20 7c Null . |
16290 7c 20 28 70 50 72 6f 62 65 2d 3e 6e 4b 65 79 43 | (pProbe->nKeyC
162a0 6f 6c 3d 3d 31 20 26 26 20 70 50 72 6f 62 65 2d ol==1 && pProbe-
162b0 3e 6f 6e 45 72 72 6f 72 20 26 26 20 65 4f 70 3d >onError && eOp=
162c0 3d 57 4f 5f 45 51 29 20 0a 20 20 20 20 20 20 20 =WO_EQ) .
162d0 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 70 4e ){. pN
162e0 65 77 2d 3e 77 73 46 6c 61 67 73 20 7c 3d 20 57 ew->wsFlags |= W
162f0 48 45 52 45 5f 4f 4e 45 52 4f 57 3b 0a 20 20 20 HERE_ONEROW;.
16300 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
16310 20 20 20 20 20 20 70 4e 65 77 2d 3e 77 73 46 6c pNew->wsFl
16320 61 67 73 20 7c 3d 20 57 48 45 52 45 5f 55 4e 51 ags |= WHERE_UNQ
16330 5f 57 41 4e 54 45 44 3b 0a 20 20 20 20 20 20 20 _WANTED;.
16340 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d }. }. }
16350 65 6c 73 65 20 69 66 28 20 65 4f 70 20 26 20 57 else if( eOp & W
16360 4f 5f 49 53 4e 55 4c 4c 20 29 7b 0a 20 20 20 20 O_ISNULL ){.
16370 20 20 70 4e 65 77 2d 3e 77 73 46 6c 61 67 73 20 pNew->wsFlags
16380 7c 3d 20 57 48 45 52 45 5f 43 4f 4c 55 4d 4e 5f |= WHERE_COLUMN_
16390 4e 55 4c 4c 3b 0a 20 20 20 20 7d 65 6c 73 65 20 NULL;. }else
163a0 69 66 28 20 65 4f 70 20 26 20 28 57 4f 5f 47 54 if( eOp & (WO_GT
163b0 7c 57 4f 5f 47 45 29 20 29 7b 0a 20 20 20 20 20 |WO_GE) ){.
163c0 20 74 65 73 74 63 61 73 65 28 20 65 4f 70 20 26 testcase( eOp &
163d0 20 57 4f 5f 47 54 20 29 3b 0a 20 20 20 20 20 20 WO_GT );.
163e0 74 65 73 74 63 61 73 65 28 20 65 4f 70 20 26 20 testcase( eOp &
163f0 57 4f 5f 47 45 20 29 3b 0a 20 20 20 20 20 20 70 WO_GE );. p
16400 4e 65 77 2d 3e 77 73 46 6c 61 67 73 20 7c 3d 20 New->wsFlags |=
16410 57 48 45 52 45 5f 43 4f 4c 55 4d 4e 5f 52 41 4e WHERE_COLUMN_RAN
16420 47 45 7c 57 48 45 52 45 5f 42 54 4d 5f 4c 49 4d GE|WHERE_BTM_LIM
16430 49 54 3b 0a 20 20 20 20 20 20 70 4e 65 77 2d 3e IT;. pNew->
16440 75 2e 62 74 72 65 65 2e 6e 42 74 6d 20 3d 20 77 u.btree.nBtm = w
16450 68 65 72 65 52 61 6e 67 65 56 65 63 74 6f 72 4c hereRangeVectorL
16460 65 6e 28 0a 20 20 20 20 20 20 20 20 20 20 70 50 en(. pP
16470 61 72 73 65 2c 20 70 53 72 63 2d 3e 69 43 75 72 arse, pSrc->iCur
16480 73 6f 72 2c 20 70 50 72 6f 62 65 2c 20 73 61 76 sor, pProbe, sav
16490 65 64 5f 6e 45 71 2c 20 70 54 65 72 6d 0a 20 20 ed_nEq, pTerm.
164a0 20 20 20 20 29 3b 0a 20 20 20 20 20 20 70 42 74 );. pBt
164b0 6d 20 3d 20 70 54 65 72 6d 3b 0a 20 20 20 20 20 m = pTerm;.
164c0 20 70 54 6f 70 20 3d 20 30 3b 0a 20 20 20 20 20 pTop = 0;.
164d0 20 69 66 28 20 70 54 65 72 6d 2d 3e 77 74 46 6c if( pTerm->wtFl
164e0 61 67 73 20 26 20 54 45 52 4d 5f 4c 49 4b 45 4f ags & TERM_LIKEO
164f0 50 54 20 29 7b 0a 20 20 20 20 20 20 20 20 2f 2a PT ){. /*
16500 20 52 61 6e 67 65 20 63 6f 6e 74 72 61 69 6e 74 Range contraint
16510 73 20 74 68 61 74 20 63 6f 6d 65 20 66 72 6f 6d s that come from
16520 20 74 68 65 20 4c 49 4b 45 20 6f 70 74 69 6d 69 the LIKE optimi
16530 7a 61 74 69 6f 6e 20 61 72 65 0a 20 20 20 20 20 zation are.
16540 20 20 20 2a 2a 20 61 6c 77 61 79 73 20 75 73 65 ** always use
16550 64 20 69 6e 20 70 61 69 72 73 2e 20 2a 2f 0a 20 d in pairs. */.
16560 20 20 20 20 20 20 20 70 54 6f 70 20 3d 20 26 70 pTop = &p
16570 54 65 72 6d 5b 31 5d 3b 0a 20 20 20 20 20 20 20 Term[1];.
16580 20 61 73 73 65 72 74 28 20 28 70 54 6f 70 2d 28 assert( (pTop-(
16590 70 54 65 72 6d 2d 3e 70 57 43 2d 3e 61 29 29 3c pTerm->pWC->a))<
165a0 70 54 65 72 6d 2d 3e 70 57 43 2d 3e 6e 54 65 72 pTerm->pWC->nTer
165b0 6d 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 m );. ass
165c0 65 72 74 28 20 70 54 6f 70 2d 3e 77 74 46 6c 61 ert( pTop->wtFla
165d0 67 73 20 26 20 54 45 52 4d 5f 4c 49 4b 45 4f 50 gs & TERM_LIKEOP
165e0 54 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 T );. ass
165f0 65 72 74 28 20 70 54 6f 70 2d 3e 65 4f 70 65 72 ert( pTop->eOper
16600 61 74 6f 72 3d 3d 57 4f 5f 4c 54 20 29 3b 0a 20 ator==WO_LT );.
16610 20 20 20 20 20 20 20 69 66 28 20 77 68 65 72 65 if( where
16620 4c 6f 6f 70 52 65 73 69 7a 65 28 64 62 2c 20 70 LoopResize(db, p
16630 4e 65 77 2c 20 70 4e 65 77 2d 3e 6e 4c 54 65 72 New, pNew->nLTer
16640 6d 2b 31 29 20 29 20 62 72 65 61 6b 3b 20 2f 2a m+1) ) break; /*
16650 20 4f 4f 4d 20 2a 2f 0a 20 20 20 20 20 20 20 20 OOM */.
16660 70 4e 65 77 2d 3e 61 4c 54 65 72 6d 5b 70 4e 65 pNew->aLTerm[pNe
16670 77 2d 3e 6e 4c 54 65 72 6d 2b 2b 5d 20 3d 20 70 w->nLTerm++] = p
16680 54 6f 70 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 Top;. pNe
16690 77 2d 3e 77 73 46 6c 61 67 73 20 7c 3d 20 57 48 w->wsFlags |= WH
166a0 45 52 45 5f 54 4f 50 5f 4c 49 4d 49 54 3b 0a 20 ERE_TOP_LIMIT;.
166b0 20 20 20 20 20 20 20 70 4e 65 77 2d 3e 75 2e 62 pNew->u.b
166c0 74 72 65 65 2e 6e 54 6f 70 20 3d 20 31 3b 0a 20 tree.nTop = 1;.
166d0 20 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 }. }else
166e0 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 28 20 {. assert(
166f0 65 4f 70 20 26 20 28 57 4f 5f 4c 54 7c 57 4f 5f eOp & (WO_LT|WO_
16700 4c 45 29 20 29 3b 0a 20 20 20 20 20 20 74 65 73 LE) );. tes
16710 74 63 61 73 65 28 20 65 4f 70 20 26 20 57 4f 5f tcase( eOp & WO_
16720 4c 54 20 29 3b 0a 20 20 20 20 20 20 74 65 73 74 LT );. test
16730 63 61 73 65 28 20 65 4f 70 20 26 20 57 4f 5f 4c case( eOp & WO_L
16740 45 20 29 3b 0a 20 20 20 20 20 20 70 4e 65 77 2d E );. pNew-
16750 3e 77 73 46 6c 61 67 73 20 7c 3d 20 57 48 45 52 >wsFlags |= WHER
16760 45 5f 43 4f 4c 55 4d 4e 5f 52 41 4e 47 45 7c 57 E_COLUMN_RANGE|W
16770 48 45 52 45 5f 54 4f 50 5f 4c 49 4d 49 54 3b 0a HERE_TOP_LIMIT;.
16780 20 20 20 20 20 20 70 4e 65 77 2d 3e 75 2e 62 74 pNew->u.bt
16790 72 65 65 2e 6e 54 6f 70 20 3d 20 77 68 65 72 65 ree.nTop = where
167a0 52 61 6e 67 65 56 65 63 74 6f 72 4c 65 6e 28 0a RangeVectorLen(.
167b0 20 20 20 20 20 20 20 20 20 20 70 50 61 72 73 65 pParse
167c0 2c 20 70 53 72 63 2d 3e 69 43 75 72 73 6f 72 2c , pSrc->iCursor,
167d0 20 70 50 72 6f 62 65 2c 20 73 61 76 65 64 5f 6e pProbe, saved_n
167e0 45 71 2c 20 70 54 65 72 6d 0a 20 20 20 20 20 20 Eq, pTerm.
167f0 29 3b 0a 20 20 20 20 20 20 70 54 6f 70 20 3d 20 );. pTop =
16800 70 54 65 72 6d 3b 0a 20 20 20 20 20 20 70 42 74 pTerm;. pBt
16810 6d 20 3d 20 28 70 4e 65 77 2d 3e 77 73 46 6c 61 m = (pNew->wsFla
16820 67 73 20 26 20 57 48 45 52 45 5f 42 54 4d 5f 4c gs & WHERE_BTM_L
16830 49 4d 49 54 29 21 3d 30 20 3f 0a 20 20 20 20 20 IMIT)!=0 ?.
16840 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
16850 70 4e 65 77 2d 3e 61 4c 54 65 72 6d 5b 70 4e 65 pNew->aLTerm[pNe
16860 77 2d 3e 6e 4c 54 65 72 6d 2d 32 5d 20 3a 20 30 w->nLTerm-2] : 0
16870 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
16880 41 74 20 74 68 69 73 20 70 6f 69 6e 74 20 70 4e At this point pN
16890 65 77 2d 3e 6e 4f 75 74 20 69 73 20 73 65 74 20 ew->nOut is set
168a0 74 6f 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 to the number of
168b0 20 72 6f 77 73 20 65 78 70 65 63 74 65 64 20 74 rows expected t
168c0 6f 0a 20 20 20 20 2a 2a 20 62 65 20 76 69 73 69 o. ** be visi
168d0 74 65 64 20 62 79 20 74 68 65 20 69 6e 64 65 78 ted by the index
168e0 20 73 63 61 6e 20 62 65 66 6f 72 65 20 63 6f 6e scan before con
168f0 73 69 64 65 72 69 6e 67 20 74 65 72 6d 20 70 54 sidering term pT
16900 65 72 6d 2c 20 6f 72 20 74 68 65 0a 20 20 20 20 erm, or the.
16910 2a 2a 20 76 61 6c 75 65 73 20 6f 66 20 6e 49 6e ** values of nIn
16920 20 61 6e 64 20 6e 49 6e 4d 75 6c 2e 20 49 6e 20 and nInMul. In
16930 6f 74 68 65 72 20 77 6f 72 64 73 2c 20 61 73 73 other words, ass
16940 75 6d 69 6e 67 20 74 68 61 74 20 61 6c 6c 20 0a uming that all .
16950 20 20 20 20 2a 2a 20 22 78 20 49 4e 28 2e 2e 2e ** "x IN(...
16960 29 22 20 74 65 72 6d 73 20 61 72 65 20 72 65 70 )" terms are rep
16970 6c 61 63 65 64 20 77 69 74 68 20 22 78 20 3d 20 laced with "x =
16980 3f 22 2e 20 54 68 69 73 20 62 6c 6f 63 6b 20 75 ?". This block u
16990 70 64 61 74 65 73 0a 20 20 20 20 2a 2a 20 74 68 pdates. ** th
169a0 65 20 76 61 6c 75 65 20 6f 66 20 70 4e 65 77 2d e value of pNew-
169b0 3e 6e 4f 75 74 20 74 6f 20 61 63 63 6f 75 6e 74 >nOut to account
169c0 20 66 6f 72 20 70 54 65 72 6d 20 28 62 75 74 20 for pTerm (but
169d0 6e 6f 74 20 6e 49 6e 2f 6e 49 6e 4d 75 6c 29 2e not nIn/nInMul).
169e0 20 20 2a 2f 0a 20 20 20 20 61 73 73 65 72 74 28 */. assert(
169f0 20 70 4e 65 77 2d 3e 6e 4f 75 74 3d 3d 73 61 76 pNew->nOut==sav
16a00 65 64 5f 6e 4f 75 74 20 29 3b 0a 20 20 20 20 69 ed_nOut );. i
16a10 66 28 20 70 4e 65 77 2d 3e 77 73 46 6c 61 67 73 f( pNew->wsFlags
16a20 20 26 20 57 48 45 52 45 5f 43 4f 4c 55 4d 4e 5f & WHERE_COLUMN_
16a30 52 41 4e 47 45 20 29 7b 0a 20 20 20 20 20 20 2f RANGE ){. /
16a40 2a 20 41 64 6a 75 73 74 20 6e 4f 75 74 20 75 73 * Adjust nOut us
16a50 69 6e 67 20 73 74 61 74 33 2f 73 74 61 74 34 20 ing stat3/stat4
16a60 64 61 74 61 2e 20 4f 72 2c 20 69 66 20 74 68 65 data. Or, if the
16a70 72 65 20 69 73 20 6e 6f 20 73 74 61 74 33 2f 73 re is no stat3/s
16a80 74 61 74 34 0a 20 20 20 20 20 20 2a 2a 20 64 61 tat4. ** da
16a90 74 61 2c 20 75 73 69 6e 67 20 73 6f 6d 65 20 6f ta, using some o
16aa0 74 68 65 72 20 65 73 74 69 6d 61 74 65 2e 20 20 ther estimate.
16ab0 2a 2f 0a 20 20 20 20 20 20 77 68 65 72 65 52 61 */. whereRa
16ac0 6e 67 65 53 63 61 6e 45 73 74 28 70 50 61 72 73 ngeScanEst(pPars
16ad0 65 2c 20 70 42 75 69 6c 64 65 72 2c 20 70 42 74 e, pBuilder, pBt
16ae0 6d 2c 20 70 54 6f 70 2c 20 70 4e 65 77 29 3b 0a m, pTop, pNew);.
16af0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
16b00 20 69 6e 74 20 6e 45 71 20 3d 20 2b 2b 70 4e 65 int nEq = ++pNe
16b10 77 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 71 3b 0a w->u.btree.nEq;.
16b20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 65 4f assert( eO
16b30 70 20 26 20 28 57 4f 5f 49 53 4e 55 4c 4c 7c 57 p & (WO_ISNULL|W
16b40 4f 5f 45 51 7c 57 4f 5f 49 4e 7c 57 4f 5f 49 53 O_EQ|WO_IN|WO_IS
16b50 29 20 29 3b 0a 0a 20 20 20 20 20 20 61 73 73 65 ) );.. asse
16b60 72 74 28 20 70 4e 65 77 2d 3e 6e 4f 75 74 3d 3d rt( pNew->nOut==
16b70 73 61 76 65 64 5f 6e 4f 75 74 20 29 3b 0a 20 20 saved_nOut );.
16b80 20 20 20 20 69 66 28 20 70 54 65 72 6d 2d 3e 74 if( pTerm->t
16b90 72 75 74 68 50 72 6f 62 3c 3d 30 20 26 26 20 70 ruthProb<=0 && p
16ba0 50 72 6f 62 65 2d 3e 61 69 43 6f 6c 75 6d 6e 5b Probe->aiColumn[
16bb0 73 61 76 65 64 5f 6e 45 71 5d 3e 3d 30 20 29 7b saved_nEq]>=0 ){
16bc0 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
16bd0 20 28 65 4f 70 20 26 20 57 4f 5f 49 4e 29 20 7c (eOp & WO_IN) |
16be0 7c 20 6e 49 6e 3d 3d 30 20 29 3b 0a 20 20 20 20 | nIn==0 );.
16bf0 20 20 20 20 74 65 73 74 63 61 73 65 28 20 65 4f testcase( eO
16c00 70 20 26 20 57 4f 5f 49 4e 20 29 3b 0a 20 20 20 p & WO_IN );.
16c10 20 20 20 20 20 70 4e 65 77 2d 3e 6e 4f 75 74 20 pNew->nOut
16c20 2b 3d 20 70 54 65 72 6d 2d 3e 74 72 75 74 68 50 += pTerm->truthP
16c30 72 6f 62 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 rob;. pNe
16c40 77 2d 3e 6e 4f 75 74 20 2d 3d 20 6e 49 6e 3b 0a w->nOut -= nIn;.
16c50 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 23 69 66 }else{.#if
16c60 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
16c70 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 41 54 34 E_STAT3_OR_STAT4
16c80 0a 20 20 20 20 20 20 20 20 74 52 6f 77 63 6e 74 . tRowcnt
16c90 20 6e 4f 75 74 20 3d 20 30 3b 0a 20 20 20 20 20 nOut = 0;.
16ca0 20 20 20 69 66 28 20 6e 49 6e 4d 75 6c 3d 3d 30 if( nInMul==0
16cb0 20 0a 20 20 20 20 20 20 20 20 20 26 26 20 70 50 . && pP
16cc0 72 6f 62 65 2d 3e 6e 53 61 6d 70 6c 65 20 0a 20 robe->nSample .
16cd0 20 20 20 20 20 20 20 20 26 26 20 70 4e 65 77 2d && pNew-
16ce0 3e 75 2e 62 74 72 65 65 2e 6e 45 71 3c 3d 70 50 >u.btree.nEq<=pP
16cf0 72 6f 62 65 2d 3e 6e 53 61 6d 70 6c 65 43 6f 6c robe->nSampleCol
16d00 0a 20 20 20 20 20 20 20 20 20 26 26 20 28 28 65 . && ((e
16d10 4f 70 20 26 20 57 4f 5f 49 4e 29 3d 3d 30 20 7c Op & WO_IN)==0 |
16d20 7c 20 21 45 78 70 72 48 61 73 50 72 6f 70 65 72 | !ExprHasProper
16d30 74 79 28 70 54 65 72 6d 2d 3e 70 45 78 70 72 2c ty(pTerm->pExpr,
16d40 20 45 50 5f 78 49 73 53 65 6c 65 63 74 29 29 0a EP_xIsSelect)).
16d50 20 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 ){.
16d60 20 20 20 20 20 45 78 70 72 20 2a 70 45 78 70 72 Expr *pExpr
16d70 20 3d 20 70 54 65 72 6d 2d 3e 70 45 78 70 72 3b = pTerm->pExpr;
16d80 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 28 . if( (
16d90 65 4f 70 20 26 20 28 57 4f 5f 45 51 7c 57 4f 5f eOp & (WO_EQ|WO_
16da0 49 53 4e 55 4c 4c 7c 57 4f 5f 49 53 29 29 21 3d ISNULL|WO_IS))!=
16db0 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 0 ){.
16dc0 20 74 65 73 74 63 61 73 65 28 20 65 4f 70 20 26 testcase( eOp &
16dd0 20 57 4f 5f 45 51 20 29 3b 0a 20 20 20 20 20 20 WO_EQ );.
16de0 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
16df0 65 4f 70 20 26 20 57 4f 5f 49 53 20 29 3b 0a 20 eOp & WO_IS );.
16e00 20 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 testc
16e10 61 73 65 28 20 65 4f 70 20 26 20 57 4f 5f 49 53 ase( eOp & WO_IS
16e20 4e 55 4c 4c 20 29 3b 0a 20 20 20 20 20 20 20 20 NULL );.
16e30 20 20 20 20 72 63 20 3d 20 77 68 65 72 65 45 71 rc = whereEq
16e40 75 61 6c 53 63 61 6e 45 73 74 28 70 50 61 72 73 ualScanEst(pPars
16e50 65 2c 20 70 42 75 69 6c 64 65 72 2c 20 70 45 78 e, pBuilder, pEx
16e60 70 72 2d 3e 70 52 69 67 68 74 2c 20 26 6e 4f 75 pr->pRight, &nOu
16e70 74 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 t);. }e
16e80 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 lse{.
16e90 20 72 63 20 3d 20 77 68 65 72 65 49 6e 53 63 61 rc = whereInSca
16ea0 6e 45 73 74 28 70 50 61 72 73 65 2c 20 70 42 75 nEst(pParse, pBu
16eb0 69 6c 64 65 72 2c 20 70 45 78 70 72 2d 3e 78 2e ilder, pExpr->x.
16ec0 70 4c 69 73 74 2c 20 26 6e 4f 75 74 29 3b 0a 20 pList, &nOut);.
16ed0 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
16ee0 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
16ef0 49 54 45 5f 4e 4f 54 46 4f 55 4e 44 20 29 20 72 ITE_NOTFOUND ) r
16f00 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 c = SQLITE_OK;.
16f10 20 20 20 20 20 20 20 20 20 69 66 28 20 72 63 21 if( rc!
16f20 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 62 72 65 =SQLITE_OK ) bre
16f30 61 6b 3b 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ak; /*
16f40 4a 75 6d 70 20 6f 75 74 20 6f 66 20 74 68 65 20 Jump out of the
16f50 70 54 65 72 6d 20 6c 6f 6f 70 20 2a 2f 0a 20 20 pTerm loop */.
16f60 20 20 20 20 20 20 20 20 69 66 28 20 6e 4f 75 74 if( nOut
16f70 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ){.
16f80 70 4e 65 77 2d 3e 6e 4f 75 74 20 3d 20 73 71 6c pNew->nOut = sql
16f90 69 74 65 33 4c 6f 67 45 73 74 28 6e 4f 75 74 29 ite3LogEst(nOut)
16fa0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 ;. if
16fb0 28 20 70 4e 65 77 2d 3e 6e 4f 75 74 3e 73 61 76 ( pNew->nOut>sav
16fc0 65 64 5f 6e 4f 75 74 20 29 20 70 4e 65 77 2d 3e ed_nOut ) pNew->
16fd0 6e 4f 75 74 20 3d 20 73 61 76 65 64 5f 6e 4f 75 nOut = saved_nOu
16fe0 74 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 t;. p
16ff0 4e 65 77 2d 3e 6e 4f 75 74 20 2d 3d 20 6e 49 6e New->nOut -= nIn
17000 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
17010 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
17020 69 66 28 20 6e 4f 75 74 3d 3d 30 20 29 0a 23 65 if( nOut==0 ).#e
17030 6e 64 69 66 0a 20 20 20 20 20 20 20 20 7b 0a 20 ndif. {.
17040 20 20 20 20 20 20 20 20 20 70 4e 65 77 2d 3e 6e pNew->n
17050 4f 75 74 20 2b 3d 20 28 70 50 72 6f 62 65 2d 3e Out += (pProbe->
17060 61 69 52 6f 77 4c 6f 67 45 73 74 5b 6e 45 71 5d aiRowLogEst[nEq]
17070 20 2d 20 70 50 72 6f 62 65 2d 3e 61 69 52 6f 77 - pProbe->aiRow
17080 4c 6f 67 45 73 74 5b 6e 45 71 2d 31 5d 29 3b 0a LogEst[nEq-1]);.
17090 20 20 20 20 20 20 20 20 20 20 69 66 28 20 65 4f if( eO
170a0 70 20 26 20 57 4f 5f 49 53 4e 55 4c 4c 20 29 7b p & WO_ISNULL ){
170b0 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 . /*
170c0 54 55 4e 49 4e 47 3a 20 49 66 20 74 68 65 72 65 TUNING: If there
170d0 20 69 73 20 6e 6f 20 6c 69 6b 65 6c 69 68 6f 6f is no likelihoo
170e0 64 28 29 20 76 61 6c 75 65 2c 20 61 73 73 75 6d d() value, assum
170f0 65 20 74 68 61 74 20 61 20 0a 20 20 20 20 20 20 e that a .
17100 20 20 20 20 20 20 2a 2a 20 22 63 6f 6c 20 49 53 ** "col IS
17110 20 4e 55 4c 4c 22 20 65 78 70 72 65 73 73 69 6f NULL" expressio
17120 6e 20 6d 61 74 63 68 65 73 20 74 77 69 63 65 20 n matches twice
17130 61 73 20 6d 61 6e 79 20 72 6f 77 73 20 0a 20 20 as many rows .
17140 20 20 20 20 20 20 20 20 20 20 2a 2a 20 61 73 20 ** as
17150 28 63 6f 6c 3d 3f 29 2e 20 2a 2f 0a 20 20 20 20 (col=?). */.
17160 20 20 20 20 20 20 20 20 70 4e 65 77 2d 3e 6e 4f pNew->nO
17170 75 74 20 2b 3d 20 31 30 3b 0a 20 20 20 20 20 20 ut += 10;.
17180 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a }. }.
17190 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 20 }. }..
171a0 20 20 20 2f 2a 20 53 65 74 20 72 43 6f 73 74 49 /* Set rCostI
171b0 64 78 20 74 6f 20 74 68 65 20 63 6f 73 74 20 6f dx to the cost o
171c0 66 20 76 69 73 69 74 69 6e 67 20 73 65 6c 65 63 f visiting selec
171d0 74 65 64 20 72 6f 77 73 20 69 6e 20 69 6e 64 65 ted rows in inde
171e0 78 2e 20 41 64 64 0a 20 20 20 20 2a 2a 20 69 74 x. Add. ** it
171f0 20 74 6f 20 70 4e 65 77 2d 3e 72 52 75 6e 2c 20 to pNew->rRun,
17200 77 68 69 63 68 20 69 73 20 63 75 72 72 65 6e 74 which is current
17210 6c 79 20 73 65 74 20 74 6f 20 74 68 65 20 63 6f ly set to the co
17220 73 74 20 6f 66 20 74 68 65 20 69 6e 64 65 78 0a st of the index.
17230 20 20 20 20 2a 2a 20 73 65 65 6b 20 6f 6e 6c 79 ** seek only
17240 2e 20 54 68 65 6e 2c 20 69 66 20 74 68 69 73 20 . Then, if this
17250 69 73 20 61 20 6e 6f 6e 2d 63 6f 76 65 72 69 6e is a non-coverin
17260 67 20 69 6e 64 65 78 2c 20 61 64 64 20 74 68 65 g index, add the
17270 20 63 6f 73 74 20 6f 66 0a 20 20 20 20 2a 2a 20 cost of. **
17280 76 69 73 69 74 69 6e 67 20 74 68 65 20 72 6f 77 visiting the row
17290 73 20 69 6e 20 74 68 65 20 6d 61 69 6e 20 74 61 s in the main ta
172a0 62 6c 65 2e 20 20 2a 2f 0a 20 20 20 20 72 43 6f ble. */. rCo
172b0 73 74 49 64 78 20 3d 20 70 4e 65 77 2d 3e 6e 4f stIdx = pNew->nO
172c0 75 74 20 2b 20 31 20 2b 20 28 31 35 2a 70 50 72 ut + 1 + (15*pPr
172d0 6f 62 65 2d 3e 73 7a 49 64 78 52 6f 77 29 2f 70 obe->szIdxRow)/p
172e0 53 72 63 2d 3e 70 54 61 62 2d 3e 73 7a 54 61 62 Src->pTab->szTab
172f0 52 6f 77 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 72 Row;. pNew->r
17300 52 75 6e 20 3d 20 73 71 6c 69 74 65 33 4c 6f 67 Run = sqlite3Log
17310 45 73 74 41 64 64 28 72 4c 6f 67 53 69 7a 65 2c EstAdd(rLogSize,
17320 20 72 43 6f 73 74 49 64 78 29 3b 0a 20 20 20 20 rCostIdx);.
17330 69 66 28 20 28 70 4e 65 77 2d 3e 77 73 46 6c 61 if( (pNew->wsFla
17340 67 73 20 26 20 28 57 48 45 52 45 5f 49 44 58 5f gs & (WHERE_IDX_
17350 4f 4e 4c 59 7c 57 48 45 52 45 5f 49 50 4b 29 29 ONLY|WHERE_IPK))
17360 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 70 4e 65 ==0 ){. pNe
17370 77 2d 3e 72 52 75 6e 20 3d 20 73 71 6c 69 74 65 w->rRun = sqlite
17380 33 4c 6f 67 45 73 74 41 64 64 28 70 4e 65 77 2d 3LogEstAdd(pNew-
17390 3e 72 52 75 6e 2c 20 70 4e 65 77 2d 3e 6e 4f 75 >rRun, pNew->nOu
173a0 74 20 2b 20 31 36 29 3b 0a 20 20 20 20 7d 0a 20 t + 16);. }.
173b0 20 20 20 41 70 70 6c 79 43 6f 73 74 4d 75 6c 74 ApplyCostMult
173c0 69 70 6c 69 65 72 28 70 4e 65 77 2d 3e 72 52 75 iplier(pNew->rRu
173d0 6e 2c 20 70 50 72 6f 62 65 2d 3e 70 54 61 62 6c n, pProbe->pTabl
173e0 65 2d 3e 63 6f 73 74 4d 75 6c 74 29 3b 0a 0a 20 e->costMult);..
173f0 20 20 20 6e 4f 75 74 55 6e 61 64 6a 75 73 74 65 nOutUnadjuste
17400 64 20 3d 20 70 4e 65 77 2d 3e 6e 4f 75 74 3b 0a d = pNew->nOut;.
17410 20 20 20 20 70 4e 65 77 2d 3e 72 52 75 6e 20 2b pNew->rRun +
17420 3d 20 6e 49 6e 4d 75 6c 20 2b 20 6e 49 6e 3b 0a = nInMul + nIn;.
17430 20 20 20 20 70 4e 65 77 2d 3e 6e 4f 75 74 20 2b pNew->nOut +
17440 3d 20 6e 49 6e 4d 75 6c 20 2b 20 6e 49 6e 3b 0a = nInMul + nIn;.
17450 20 20 20 20 77 68 65 72 65 4c 6f 6f 70 4f 75 74 whereLoopOut
17460 70 75 74 41 64 6a 75 73 74 28 70 42 75 69 6c 64 putAdjust(pBuild
17470 65 72 2d 3e 70 57 43 2c 20 70 4e 65 77 2c 20 72 er->pWC, pNew, r
17480 53 69 7a 65 29 3b 0a 20 20 20 20 72 63 20 3d 20 Size);. rc =
17490 77 68 65 72 65 4c 6f 6f 70 49 6e 73 65 72 74 28 whereLoopInsert(
174a0 70 42 75 69 6c 64 65 72 2c 20 70 4e 65 77 29 3b pBuilder, pNew);
174b0 0a 0a 20 20 20 20 69 66 28 20 70 4e 65 77 2d 3e .. if( pNew->
174c0 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f wsFlags & WHERE_
174d0 43 4f 4c 55 4d 4e 5f 52 41 4e 47 45 20 29 7b 0a COLUMN_RANGE ){.
174e0 20 20 20 20 20 20 70 4e 65 77 2d 3e 6e 4f 75 74 pNew->nOut
174f0 20 3d 20 73 61 76 65 64 5f 6e 4f 75 74 3b 0a 20 = saved_nOut;.
17500 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
17510 70 4e 65 77 2d 3e 6e 4f 75 74 20 3d 20 6e 4f 75 pNew->nOut = nOu
17520 74 55 6e 61 64 6a 75 73 74 65 64 3b 0a 20 20 20 tUnadjusted;.
17530 20 7d 0a 0a 20 20 20 20 69 66 28 20 28 70 4e 65 }.. if( (pNe
17540 77 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 48 45 w->wsFlags & WHE
17550 52 45 5f 54 4f 50 5f 4c 49 4d 49 54 29 3d 3d 30 RE_TOP_LIMIT)==0
17560 0a 20 20 20 20 20 26 26 20 70 4e 65 77 2d 3e 75 . && pNew->u
17570 2e 62 74 72 65 65 2e 6e 45 71 3c 70 50 72 6f 62 .btree.nEq<pProb
17580 65 2d 3e 6e 43 6f 6c 75 6d 6e 0a 20 20 20 20 29 e->nColumn. )
17590 7b 0a 20 20 20 20 20 20 77 68 65 72 65 4c 6f 6f {. whereLoo
175a0 70 41 64 64 42 74 72 65 65 49 6e 64 65 78 28 70 pAddBtreeIndex(p
175b0 42 75 69 6c 64 65 72 2c 20 70 53 72 63 2c 20 70 Builder, pSrc, p
175c0 50 72 6f 62 65 2c 20 6e 49 6e 4d 75 6c 2b 6e 49 Probe, nInMul+nI
175d0 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 4e n);. }. pN
175e0 65 77 2d 3e 6e 4f 75 74 20 3d 20 73 61 76 65 64 ew->nOut = saved
175f0 5f 6e 4f 75 74 3b 0a 23 69 66 64 65 66 20 53 51 _nOut;.#ifdef SQ
17600 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 53 54 41 54 LITE_ENABLE_STAT
17610 33 5f 4f 52 5f 53 54 41 54 34 0a 20 20 20 20 70 3_OR_STAT4. p
17620 42 75 69 6c 64 65 72 2d 3e 6e 52 65 63 56 61 6c Builder->nRecVal
17630 69 64 20 3d 20 6e 52 65 63 56 61 6c 69 64 3b 0a id = nRecValid;.
17640 23 65 6e 64 69 66 0a 20 20 7d 0a 20 20 70 4e 65 #endif. }. pNe
17650 77 2d 3e 70 72 65 72 65 71 20 3d 20 73 61 76 65 w->prereq = save
17660 64 5f 70 72 65 72 65 71 3b 0a 20 20 70 4e 65 77 d_prereq;. pNew
17670 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 71 20 3d 20 ->u.btree.nEq =
17680 73 61 76 65 64 5f 6e 45 71 3b 0a 20 20 70 4e 65 saved_nEq;. pNe
17690 77 2d 3e 75 2e 62 74 72 65 65 2e 6e 42 74 6d 20 w->u.btree.nBtm
176a0 3d 20 73 61 76 65 64 5f 6e 42 74 6d 3b 0a 20 20 = saved_nBtm;.
176b0 70 4e 65 77 2d 3e 75 2e 62 74 72 65 65 2e 6e 54 pNew->u.btree.nT
176c0 6f 70 20 3d 20 73 61 76 65 64 5f 6e 54 6f 70 3b op = saved_nTop;
176d0 0a 20 20 70 4e 65 77 2d 3e 6e 53 6b 69 70 20 3d . pNew->nSkip =
176e0 20 73 61 76 65 64 5f 6e 53 6b 69 70 3b 0a 20 20 saved_nSkip;.
176f0 70 4e 65 77 2d 3e 77 73 46 6c 61 67 73 20 3d 20 pNew->wsFlags =
17700 73 61 76 65 64 5f 77 73 46 6c 61 67 73 3b 0a 20 saved_wsFlags;.
17710 20 70 4e 65 77 2d 3e 6e 4f 75 74 20 3d 20 73 61 pNew->nOut = sa
17720 76 65 64 5f 6e 4f 75 74 3b 0a 20 20 70 4e 65 77 ved_nOut;. pNew
17730 2d 3e 6e 4c 54 65 72 6d 20 3d 20 73 61 76 65 64 ->nLTerm = saved
17740 5f 6e 4c 54 65 72 6d 3b 0a 0a 20 20 2f 2a 20 43 _nLTerm;.. /* C
17750 6f 6e 73 69 64 65 72 20 75 73 69 6e 67 20 61 20 onsider using a
17760 73 6b 69 70 2d 73 63 61 6e 20 69 66 20 74 68 65 skip-scan if the
17770 72 65 20 61 72 65 20 6e 6f 20 57 48 45 52 45 20 re are no WHERE
17780 63 6c 61 75 73 65 20 63 6f 6e 73 74 72 61 69 6e clause constrain
17790 74 73 0a 20 20 2a 2a 20 61 76 61 69 6c 61 62 6c ts. ** availabl
177a0 65 20 66 6f 72 20 74 68 65 20 6c 65 66 74 2d 6d e for the left-m
177b0 6f 73 74 20 74 65 72 6d 73 20 6f 66 20 74 68 65 ost terms of the
177c0 20 69 6e 64 65 78 2c 20 61 6e 64 20 69 66 20 74 index, and if t
177d0 68 65 20 61 76 65 72 61 67 65 0a 20 20 2a 2a 20 he average. **
177e0 6e 75 6d 62 65 72 20 6f 66 20 72 65 70 65 61 74 number of repeat
177f0 73 20 69 6e 20 74 68 65 20 6c 65 66 74 2d 6d 6f s in the left-mo
17800 73 74 20 74 65 72 6d 73 20 69 73 20 61 74 20 6c st terms is at l
17810 65 61 73 74 20 31 38 2e 20 0a 20 20 2a 2a 0a 20 east 18. . **.
17820 20 2a 2a 20 54 68 65 20 6d 61 67 69 63 20 6e 75 ** The magic nu
17830 6d 62 65 72 20 31 38 20 69 73 20 73 65 6c 65 63 mber 18 is selec
17840 74 65 64 20 6f 6e 20 74 68 65 20 62 61 73 69 73 ted on the basis
17850 20 74 68 61 74 20 73 63 61 6e 6e 69 6e 67 20 31 that scanning 1
17860 37 20 72 6f 77 73 0a 20 20 2a 2a 20 69 73 20 61 7 rows. ** is a
17870 6c 6d 6f 73 74 20 61 6c 77 61 79 73 20 71 75 69 lmost always qui
17880 63 6b 65 72 20 74 68 61 6e 20 61 6e 20 69 6e 64 cker than an ind
17890 65 78 20 73 65 65 6b 20 28 65 76 65 6e 20 74 68 ex seek (even th
178a0 6f 75 67 68 20 69 66 20 74 68 65 20 69 6e 64 65 ough if the inde
178b0 78 0a 20 20 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 x. ** contains
178c0 66 65 77 65 72 20 74 68 61 6e 20 32 5e 31 37 20 fewer than 2^17
178d0 72 6f 77 73 20 77 65 20 61 73 73 75 6d 65 20 6f rows we assume o
178e0 74 68 65 72 77 69 73 65 20 69 6e 20 6f 74 68 65 therwise in othe
178f0 72 20 70 61 72 74 73 20 6f 66 0a 20 20 2a 2a 20 r parts of. **
17900 74 68 65 20 63 6f 64 65 29 2e 20 41 6e 64 2c 20 the code). And,
17910 65 76 65 6e 20 69 66 20 69 74 20 69 73 20 6e 6f even if it is no
17920 74 2c 20 69 74 20 73 68 6f 75 6c 64 20 6e 6f 74 t, it should not
17930 20 62 65 20 74 6f 6f 20 6d 75 63 68 20 73 6c 6f be too much slo
17940 77 65 72 2e 20 0a 20 20 2a 2a 20 4f 6e 20 74 68 wer. . ** On th
17950 65 20 6f 74 68 65 72 20 68 61 6e 64 2c 20 74 68 e other hand, th
17960 65 20 65 78 74 72 61 20 73 65 65 6b 73 20 63 6f e extra seeks co
17970 75 6c 64 20 65 6e 64 20 75 70 20 62 65 69 6e 67 uld end up being
17980 20 73 69 67 6e 69 66 69 63 61 6e 74 6c 79 0a 20 significantly.
17990 20 2a 2a 20 6d 6f 72 65 20 65 78 70 65 6e 73 69 ** more expensi
179a0 76 65 2e 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 ve. */. assert
179b0 28 20 34 32 3d 3d 73 71 6c 69 74 65 33 4c 6f 67 ( 42==sqlite3Log
179c0 45 73 74 28 31 38 29 20 29 3b 0a 20 20 69 66 28 Est(18) );. if(
179d0 20 73 61 76 65 64 5f 6e 45 71 3d 3d 73 61 76 65 saved_nEq==save
179e0 64 5f 6e 53 6b 69 70 0a 20 20 20 26 26 20 73 61 d_nSkip. && sa
179f0 76 65 64 5f 6e 45 71 2b 31 3c 70 50 72 6f 62 65 ved_nEq+1<pProbe
17a00 2d 3e 6e 4b 65 79 43 6f 6c 0a 20 20 20 26 26 20 ->nKeyCol. &&
17a10 70 50 72 6f 62 65 2d 3e 6e 6f 53 6b 69 70 53 63 pProbe->noSkipSc
17a20 61 6e 3d 3d 30 0a 20 20 20 26 26 20 70 50 72 6f an==0. && pPro
17a30 62 65 2d 3e 61 69 52 6f 77 4c 6f 67 45 73 74 5b be->aiRowLogEst[
17a40 73 61 76 65 64 5f 6e 45 71 2b 31 5d 3e 3d 34 32 saved_nEq+1]>=42
17a50 20 20 2f 2a 20 54 55 4e 49 4e 47 3a 20 4d 69 6e /* TUNING: Min
17a60 69 6d 75 6d 20 66 6f 72 20 73 6b 69 70 2d 73 63 imum for skip-sc
17a70 61 6e 20 2a 2f 0a 20 20 20 26 26 20 28 72 63 20 an */. && (rc
17a80 3d 20 77 68 65 72 65 4c 6f 6f 70 52 65 73 69 7a = whereLoopResiz
17a90 65 28 64 62 2c 20 70 4e 65 77 2c 20 70 4e 65 77 e(db, pNew, pNew
17aa0 2d 3e 6e 4c 54 65 72 6d 2b 31 29 29 3d 3d 53 51 ->nLTerm+1))==SQ
17ab0 4c 49 54 45 5f 4f 4b 0a 20 20 29 7b 0a 20 20 20 LITE_OK. ){.
17ac0 20 4c 6f 67 45 73 74 20 6e 49 74 65 72 3b 0a 20 LogEst nIter;.
17ad0 20 20 20 70 4e 65 77 2d 3e 75 2e 62 74 72 65 65 pNew->u.btree
17ae0 2e 6e 45 71 2b 2b 3b 0a 20 20 20 20 70 4e 65 77 .nEq++;. pNew
17af0 2d 3e 6e 53 6b 69 70 2b 2b 3b 0a 20 20 20 20 70 ->nSkip++;. p
17b00 4e 65 77 2d 3e 61 4c 54 65 72 6d 5b 70 4e 65 77 New->aLTerm[pNew
17b10 2d 3e 6e 4c 54 65 72 6d 2b 2b 5d 20 3d 20 30 3b ->nLTerm++] = 0;
17b20 0a 20 20 20 20 70 4e 65 77 2d 3e 77 73 46 6c 61 . pNew->wsFla
17b30 67 73 20 7c 3d 20 57 48 45 52 45 5f 53 4b 49 50 gs |= WHERE_SKIP
17b40 53 43 41 4e 3b 0a 20 20 20 20 6e 49 74 65 72 20 SCAN;. nIter
17b50 3d 20 70 50 72 6f 62 65 2d 3e 61 69 52 6f 77 4c = pProbe->aiRowL
17b60 6f 67 45 73 74 5b 73 61 76 65 64 5f 6e 45 71 5d ogEst[saved_nEq]
17b70 20 2d 20 70 50 72 6f 62 65 2d 3e 61 69 52 6f 77 - pProbe->aiRow
17b80 4c 6f 67 45 73 74 5b 73 61 76 65 64 5f 6e 45 71 LogEst[saved_nEq
17b90 2b 31 5d 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 6e +1];. pNew->n
17ba0 4f 75 74 20 2d 3d 20 6e 49 74 65 72 3b 0a 20 20 Out -= nIter;.
17bb0 20 20 2f 2a 20 54 55 4e 49 4e 47 3a 20 20 42 65 /* TUNING: Be
17bc0 63 61 75 73 65 20 75 6e 63 65 72 74 61 69 6e 74 cause uncertaint
17bd0 69 65 73 20 69 6e 20 74 68 65 20 65 73 74 69 6d ies in the estim
17be0 61 74 65 73 20 66 6f 72 20 73 6b 69 70 2d 73 63 ates for skip-sc
17bf0 61 6e 20 71 75 65 72 69 65 73 2c 0a 20 20 20 20 an queries,.
17c00 2a 2a 20 61 64 64 20 61 20 31 2e 33 37 35 20 66 ** add a 1.375 f
17c10 75 64 67 65 20 66 61 63 74 6f 72 20 74 6f 20 6d udge factor to m
17c20 61 6b 65 20 73 6b 69 70 2d 73 63 61 6e 20 73 6c ake skip-scan sl
17c30 69 67 68 74 6c 79 20 6c 65 73 73 20 6c 69 6b 65 ightly less like
17c40 6c 79 2e 20 2a 2f 0a 20 20 20 20 6e 49 74 65 72 ly. */. nIter
17c50 20 2b 3d 20 35 3b 0a 20 20 20 20 77 68 65 72 65 += 5;. where
17c60 4c 6f 6f 70 41 64 64 42 74 72 65 65 49 6e 64 65 LoopAddBtreeInde
17c70 78 28 70 42 75 69 6c 64 65 72 2c 20 70 53 72 63 x(pBuilder, pSrc
17c80 2c 20 70 50 72 6f 62 65 2c 20 6e 49 74 65 72 20 , pProbe, nIter
17c90 2b 20 6e 49 6e 4d 75 6c 29 3b 0a 20 20 20 20 70 + nInMul);. p
17ca0 4e 65 77 2d 3e 6e 4f 75 74 20 3d 20 73 61 76 65 New->nOut = save
17cb0 64 5f 6e 4f 75 74 3b 0a 20 20 20 20 70 4e 65 77 d_nOut;. pNew
17cc0 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 71 20 3d 20 ->u.btree.nEq =
17cd0 73 61 76 65 64 5f 6e 45 71 3b 0a 20 20 20 20 70 saved_nEq;. p
17ce0 4e 65 77 2d 3e 6e 53 6b 69 70 20 3d 20 73 61 76 New->nSkip = sav
17cf0 65 64 5f 6e 53 6b 69 70 3b 0a 20 20 20 20 70 4e ed_nSkip;. pN
17d00 65 77 2d 3e 77 73 46 6c 61 67 73 20 3d 20 73 61 ew->wsFlags = sa
17d10 76 65 64 5f 77 73 46 6c 61 67 73 3b 0a 20 20 7d ved_wsFlags;. }
17d20 0a 0a 20 20 57 48 45 52 45 54 52 41 43 45 28 30 .. WHERETRACE(0
17d30 78 38 30 30 2c 20 28 22 45 4e 44 20 25 73 2e 61 x800, ("END %s.a
17d40 64 64 42 74 72 65 65 49 64 78 28 25 73 29 2c 20 ddBtreeIdx(%s),
17d50 6e 45 71 3d 25 64 2c 20 72 63 3d 25 64 5c 6e 22 nEq=%d, rc=%d\n"
17d60 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
17d70 20 20 20 20 20 20 20 20 70 50 72 6f 62 65 2d 3e pProbe->
17d80 70 54 61 62 6c 65 2d 3e 7a 4e 61 6d 65 2c 20 70 pTable->zName, p
17d90 50 72 6f 62 65 2d 3e 7a 4e 61 6d 65 2c 20 73 61 Probe->zName, sa
17da0 76 65 64 5f 6e 45 71 2c 20 72 63 29 29 3b 0a 20 ved_nEq, rc));.
17db0 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
17dc0 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 72 75 65 *.** Return True
17dd0 20 69 66 20 69 74 20 69 73 20 70 6f 73 73 69 62 if it is possib
17de0 6c 65 20 74 68 61 74 20 70 49 6e 64 65 78 20 6d le that pIndex m
17df0 69 67 68 74 20 62 65 20 75 73 65 66 75 6c 20 69 ight be useful i
17e00 6e 0a 2a 2a 20 69 6d 70 6c 65 6d 65 6e 74 69 6e n.** implementin
17e10 67 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 g the ORDER BY c
17e20 6c 61 75 73 65 20 69 6e 20 70 42 75 69 6c 64 65 lause in pBuilde
17e30 72 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 r..**.** Return
17e40 46 61 6c 73 65 20 69 66 20 70 42 75 69 6c 64 65 False if pBuilde
17e50 72 20 64 6f 65 73 20 6e 6f 74 20 63 6f 6e 74 61 r does not conta
17e60 69 6e 20 61 6e 20 4f 52 44 45 52 20 42 59 20 63 in an ORDER BY c
17e70 6c 61 75 73 65 20 6f 72 0a 2a 2a 20 69 66 20 74 lause or.** if t
17e80 68 65 72 65 20 69 73 20 6e 6f 20 77 61 79 20 66 here is no way f
17e90 6f 72 20 70 49 6e 64 65 78 20 74 6f 20 62 65 20 or pIndex to be
17ea0 75 73 65 66 75 6c 20 69 6e 20 69 6d 70 6c 65 6d useful in implem
17eb0 65 6e 74 69 6e 67 20 74 68 61 74 0a 2a 2a 20 4f enting that.** O
17ec0 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 2e 0a RDER BY clause..
17ed0 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 69 6e */.static int in
17ee0 64 65 78 4d 69 67 68 74 48 65 6c 70 57 69 74 68 dexMightHelpWith
17ef0 4f 72 64 65 72 42 79 28 0a 20 20 57 68 65 72 65 OrderBy(. Where
17f00 4c 6f 6f 70 42 75 69 6c 64 65 72 20 2a 70 42 75 LoopBuilder *pBu
17f10 69 6c 64 65 72 2c 0a 20 20 49 6e 64 65 78 20 2a ilder,. Index *
17f20 70 49 6e 64 65 78 2c 0a 20 20 69 6e 74 20 69 43 pIndex,. int iC
17f30 75 72 73 6f 72 0a 29 7b 0a 20 20 45 78 70 72 4c ursor.){. ExprL
17f40 69 73 74 20 2a 70 4f 42 3b 0a 20 20 45 78 70 72 ist *pOB;. Expr
17f50 4c 69 73 74 20 2a 61 43 6f 6c 45 78 70 72 3b 0a List *aColExpr;.
17f60 20 20 69 6e 74 20 69 69 2c 20 6a 6a 3b 0a 0a 20 int ii, jj;..
17f70 20 69 66 28 20 70 49 6e 64 65 78 2d 3e 62 55 6e if( pIndex->bUn
17f80 6f 72 64 65 72 65 64 20 29 20 72 65 74 75 72 6e ordered ) return
17f90 20 30 3b 0a 20 20 69 66 28 20 28 70 4f 42 20 3d 0;. if( (pOB =
17fa0 20 70 42 75 69 6c 64 65 72 2d 3e 70 57 49 6e 66 pBuilder->pWInf
17fb0 6f 2d 3e 70 4f 72 64 65 72 42 79 29 3d 3d 30 20 o->pOrderBy)==0
17fc0 29 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 66 6f ) return 0;. fo
17fd0 72 28 69 69 3d 30 3b 20 69 69 3c 70 4f 42 2d 3e r(ii=0; ii<pOB->
17fe0 6e 45 78 70 72 3b 20 69 69 2b 2b 29 7b 0a 20 20 nExpr; ii++){.
17ff0 20 20 45 78 70 72 20 2a 70 45 78 70 72 20 3d 20 Expr *pExpr =
18000 73 71 6c 69 74 65 33 45 78 70 72 53 6b 69 70 43 sqlite3ExprSkipC
18010 6f 6c 6c 61 74 65 28 70 4f 42 2d 3e 61 5b 69 69 ollate(pOB->a[ii
18020 5d 2e 70 45 78 70 72 29 3b 0a 20 20 20 20 69 66 ].pExpr);. if
18030 28 20 70 45 78 70 72 2d 3e 6f 70 3d 3d 54 4b 5f ( pExpr->op==TK_
18040 43 4f 4c 55 4d 4e 20 26 26 20 70 45 78 70 72 2d COLUMN && pExpr-
18050 3e 69 54 61 62 6c 65 3d 3d 69 43 75 72 73 6f 72 >iTable==iCursor
18060 20 29 7b 0a 20 20 20 20 20 20 69 66 28 20 70 45 ){. if( pE
18070 78 70 72 2d 3e 69 43 6f 6c 75 6d 6e 3c 30 20 29 xpr->iColumn<0 )
18080 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 20 return 1;.
18090 20 66 6f 72 28 6a 6a 3d 30 3b 20 6a 6a 3c 70 49 for(jj=0; jj<pI
180a0 6e 64 65 78 2d 3e 6e 4b 65 79 43 6f 6c 3b 20 6a ndex->nKeyCol; j
180b0 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 69 66 j++){. if
180c0 28 20 70 45 78 70 72 2d 3e 69 43 6f 6c 75 6d 6e ( pExpr->iColumn
180d0 3d 3d 70 49 6e 64 65 78 2d 3e 61 69 43 6f 6c 75 ==pIndex->aiColu
180e0 6d 6e 5b 6a 6a 5d 20 29 20 72 65 74 75 72 6e 20 mn[jj] ) return
180f0 31 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 1;. }. }
18100 65 6c 73 65 20 69 66 28 20 28 61 43 6f 6c 45 78 else if( (aColEx
18110 70 72 20 3d 20 70 49 6e 64 65 78 2d 3e 61 43 6f pr = pIndex->aCo
18120 6c 45 78 70 72 29 21 3d 30 20 29 7b 0a 20 20 20 lExpr)!=0 ){.
18130 20 20 20 66 6f 72 28 6a 6a 3d 30 3b 20 6a 6a 3c for(jj=0; jj<
18140 70 49 6e 64 65 78 2d 3e 6e 4b 65 79 43 6f 6c 3b pIndex->nKeyCol;
18150 20 6a 6a 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 jj++){.
18160 69 66 28 20 70 49 6e 64 65 78 2d 3e 61 69 43 6f if( pIndex->aiCo
18170 6c 75 6d 6e 5b 6a 6a 5d 21 3d 58 4e 5f 45 58 50 lumn[jj]!=XN_EXP
18180 52 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 R ) continue;.
18190 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 if( sqlite
181a0 33 45 78 70 72 43 6f 6d 70 61 72 65 53 6b 69 70 3ExprCompareSkip
181b0 28 70 45 78 70 72 2c 61 43 6f 6c 45 78 70 72 2d (pExpr,aColExpr-
181c0 3e 61 5b 6a 6a 5d 2e 70 45 78 70 72 2c 69 43 75 >a[jj].pExpr,iCu
181d0 72 73 6f 72 29 3d 3d 30 20 29 7b 0a 20 20 20 20 rsor)==0 ){.
181e0 20 20 20 20 20 20 72 65 74 75 72 6e 20 31 3b 0a return 1;.
181f0 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
18200 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 }. }. }. re
18210 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a turn 0;.}../*.**
18220 20 52 65 74 75 72 6e 20 61 20 62 69 74 6d 61 73 Return a bitmas
18230 6b 20 77 68 65 72 65 20 31 73 20 69 6e 64 69 63 k where 1s indic
18240 61 74 65 20 74 68 61 74 20 74 68 65 20 63 6f 72 ate that the cor
18250 72 65 73 70 6f 6e 64 69 6e 67 20 63 6f 6c 75 6d responding colum
18260 6e 20 6f 66 0a 2a 2a 20 74 68 65 20 74 61 62 6c n of.** the tabl
18270 65 20 69 73 20 75 73 65 64 20 62 79 20 61 6e 20 e is used by an
18280 69 6e 64 65 78 2e 20 20 4f 6e 6c 79 20 74 68 65 index. Only the
18290 20 66 69 72 73 74 20 36 33 20 63 6f 6c 75 6d 6e first 63 column
182a0 73 20 61 72 65 20 63 6f 6e 73 69 64 65 72 65 64 s are considered
182b0 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 42 69 74 6d ..*/.static Bitm
182c0 61 73 6b 20 63 6f 6c 75 6d 6e 73 49 6e 49 6e 64 ask columnsInInd
182d0 65 78 28 49 6e 64 65 78 20 2a 70 49 64 78 29 7b ex(Index *pIdx){
182e0 0a 20 20 42 69 74 6d 61 73 6b 20 6d 20 3d 20 30 . Bitmask m = 0
182f0 3b 0a 20 20 69 6e 74 20 6a 3b 0a 20 20 66 6f 72 ;. int j;. for
18300 28 6a 3d 70 49 64 78 2d 3e 6e 43 6f 6c 75 6d 6e (j=pIdx->nColumn
18310 2d 31 3b 20 6a 3e 3d 30 3b 20 6a 2d 2d 29 7b 0a -1; j>=0; j--){.
18320 20 20 20 20 69 6e 74 20 78 20 3d 20 70 49 64 78 int x = pIdx
18330 2d 3e 61 69 43 6f 6c 75 6d 6e 5b 6a 5d 3b 0a 20 ->aiColumn[j];.
18340 20 20 20 69 66 28 20 78 3e 3d 30 20 29 7b 0a 20 if( x>=0 ){.
18350 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 78 testcase( x
18360 3d 3d 42 4d 53 2d 31 20 29 3b 0a 20 20 20 20 20 ==BMS-1 );.
18370 20 74 65 73 74 63 61 73 65 28 20 78 3d 3d 42 4d testcase( x==BM
18380 53 2d 32 20 29 3b 0a 20 20 20 20 20 20 69 66 28 S-2 );. if(
18390 20 78 3c 42 4d 53 2d 31 20 29 20 6d 20 7c 3d 20 x<BMS-1 ) m |=
183a0 4d 41 53 4b 42 49 54 28 78 29 3b 0a 20 20 20 20 MASKBIT(x);.
183b0 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 6d }. }. return m
183c0 3b 0a 7d 0a 0a 2f 2a 20 43 68 65 63 6b 20 74 6f ;.}../* Check to
183d0 20 73 65 65 20 69 66 20 61 20 70 61 72 74 69 61 see if a partia
183e0 6c 20 69 6e 64 65 78 20 77 69 74 68 20 70 50 61 l index with pPa
183f0 72 74 49 6e 64 65 78 57 68 65 72 65 20 63 61 6e rtIndexWhere can
18400 20 62 65 20 75 73 65 64 0a 2a 2a 20 69 6e 20 74 be used.** in t
18410 68 65 20 63 75 72 72 65 6e 74 20 71 75 65 72 79 he current query
18420 2e 20 20 52 65 74 75 72 6e 20 74 72 75 65 20 69 . Return true i
18430 66 20 69 74 20 63 61 6e 20 62 65 20 61 6e 64 20 f it can be and
18440 66 61 6c 73 65 20 69 66 20 6e 6f 74 2e 0a 2a 2f false if not..*/
18450 0a 73 74 61 74 69 63 20 69 6e 74 20 77 68 65 72 .static int wher
18460 65 55 73 61 62 6c 65 50 61 72 74 69 61 6c 49 6e eUsablePartialIn
18470 64 65 78 28 69 6e 74 20 69 54 61 62 2c 20 57 68 dex(int iTab, Wh
18480 65 72 65 43 6c 61 75 73 65 20 2a 70 57 43 2c 20 ereClause *pWC,
18490 45 78 70 72 20 2a 70 57 68 65 72 65 29 7b 0a 20 Expr *pWhere){.
184a0 20 69 6e 74 20 69 3b 0a 20 20 57 68 65 72 65 54 int i;. WhereT
184b0 65 72 6d 20 2a 70 54 65 72 6d 3b 0a 20 20 50 61 erm *pTerm;. Pa
184c0 72 73 65 20 2a 70 50 61 72 73 65 20 3d 20 70 57 rse *pParse = pW
184d0 43 2d 3e 70 57 49 6e 66 6f 2d 3e 70 50 61 72 73 C->pWInfo->pPars
184e0 65 3b 0a 20 20 77 68 69 6c 65 28 20 70 57 68 65 e;. while( pWhe
184f0 72 65 2d 3e 6f 70 3d 3d 54 4b 5f 41 4e 44 20 29 re->op==TK_AND )
18500 7b 0a 20 20 20 20 69 66 28 20 21 77 68 65 72 65 {. if( !where
18510 55 73 61 62 6c 65 50 61 72 74 69 61 6c 49 6e 64 UsablePartialInd
18520 65 78 28 69 54 61 62 2c 70 57 43 2c 70 57 68 65 ex(iTab,pWC,pWhe
18530 72 65 2d 3e 70 4c 65 66 74 29 20 29 20 72 65 74 re->pLeft) ) ret
18540 75 72 6e 20 30 3b 0a 20 20 20 20 70 57 68 65 72 urn 0;. pWher
18550 65 20 3d 20 70 57 68 65 72 65 2d 3e 70 52 69 67 e = pWhere->pRig
18560 68 74 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 50 ht;. }. if( pP
18570 61 72 73 65 2d 3e 64 62 2d 3e 66 6c 61 67 73 20 arse->db->flags
18580 26 20 53 51 4c 49 54 45 5f 45 6e 61 62 6c 65 51 & SQLITE_EnableQ
18590 50 53 47 20 29 20 70 50 61 72 73 65 20 3d 20 30 PSG ) pParse = 0
185a0 3b 0a 20 20 66 6f 72 28 69 3d 30 2c 20 70 54 65 ;. for(i=0, pTe
185b0 72 6d 3d 70 57 43 2d 3e 61 3b 20 69 3c 70 57 43 rm=pWC->a; i<pWC
185c0 2d 3e 6e 54 65 72 6d 3b 20 69 2b 2b 2c 20 70 54 ->nTerm; i++, pT
185d0 65 72 6d 2b 2b 29 7b 0a 20 20 20 20 45 78 70 72 erm++){. Expr
185e0 20 2a 70 45 78 70 72 20 3d 20 70 54 65 72 6d 2d *pExpr = pTerm-
185f0 3e 70 45 78 70 72 3b 0a 20 20 20 20 69 66 28 20 >pExpr;. if(
18600 28 21 45 78 70 72 48 61 73 50 72 6f 70 65 72 74 (!ExprHasPropert
18610 79 28 70 45 78 70 72 2c 20 45 50 5f 46 72 6f 6d y(pExpr, EP_From
18620 4a 6f 69 6e 29 20 7c 7c 20 70 45 78 70 72 2d 3e Join) || pExpr->
18630 69 52 69 67 68 74 4a 6f 69 6e 54 61 62 6c 65 3d iRightJoinTable=
18640 3d 69 54 61 62 29 0a 20 20 20 20 20 26 26 20 73 =iTab). && s
18650 71 6c 69 74 65 33 45 78 70 72 49 6d 70 6c 69 65 qlite3ExprImplie
18660 73 45 78 70 72 28 70 50 61 72 73 65 2c 20 70 45 sExpr(pParse, pE
18670 78 70 72 2c 20 70 57 68 65 72 65 2c 20 69 54 61 xpr, pWhere, iTa
18680 62 29 20 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 b) . ){.
18690 20 72 65 74 75 72 6e 20 31 3b 0a 20 20 20 20 7d return 1;. }
186a0 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b . }. return 0;
186b0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 61 6c .}../*.** Add al
186c0 6c 20 57 68 65 72 65 4c 6f 6f 70 20 6f 62 6a 65 l WhereLoop obje
186d0 63 74 73 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 cts for a single
186e0 20 74 61 62 6c 65 20 6f 66 20 74 68 65 20 6a 6f table of the jo
186f0 69 6e 20 77 68 65 72 65 20 74 68 65 20 74 61 62 in where the tab
18700 6c 65 0a 2a 2a 20 69 73 20 69 64 65 6e 74 69 66 le.** is identif
18710 69 65 64 20 62 79 20 70 42 75 69 6c 64 65 72 2d ied by pBuilder-
18720 3e 70 4e 65 77 2d 3e 69 54 61 62 2e 20 20 54 68 >pNew->iTab. Th
18730 61 74 20 74 61 62 6c 65 20 69 73 20 67 75 61 72 at table is guar
18740 61 6e 74 65 65 64 20 74 6f 20 62 65 0a 2a 2a 20 anteed to be.**
18750 61 20 62 2d 74 72 65 65 20 74 61 62 6c 65 2c 20 a b-tree table,
18760 6e 6f 74 20 61 20 76 69 72 74 75 61 6c 20 74 61 not a virtual ta
18770 62 6c 65 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 63 ble..**.** The c
18780 6f 73 74 73 20 28 57 68 65 72 65 4c 6f 6f 70 2e osts (WhereLoop.
18790 72 52 75 6e 29 20 6f 66 20 74 68 65 20 62 2d 74 rRun) of the b-t
187a0 72 65 65 20 6c 6f 6f 70 73 20 61 64 64 65 64 20 ree loops added
187b0 62 79 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e by this function
187c0 0a 2a 2a 20 61 72 65 20 63 61 6c 63 75 6c 61 74 .** are calculat
187d0 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 2a ed as follows:.*
187e0 2a 0a 2a 2a 20 46 6f 72 20 61 20 66 75 6c 6c 20 *.** For a full
187f0 73 63 61 6e 2c 20 61 73 73 75 6d 69 6e 67 20 74 scan, assuming t
18800 68 65 20 74 61 62 6c 65 20 28 6f 72 20 69 6e 64 he table (or ind
18810 65 78 29 20 63 6f 6e 74 61 69 6e 73 20 6e 52 6f ex) contains nRo
18820 77 20 72 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 w rows:.**.**
18830 20 20 63 6f 73 74 20 3d 20 6e 52 6f 77 20 2a 20 cost = nRow *
18840 33 2e 30 20 20 20 20 20 20 20 20 20 20 20 20 20 3.0
18850 20 20 20 20 20 20 20 2f 2f 20 66 75 6c 6c 2d 74 // full-t
18860 61 62 6c 65 20 73 63 61 6e 0a 2a 2a 20 20 20 20 able scan.**
18870 20 63 6f 73 74 20 3d 20 6e 52 6f 77 20 2a 20 4b cost = nRow * K
18880 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
18890 20 20 20 20 20 20 2f 2f 20 73 63 61 6e 20 6f 66 // scan of
188a0 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 0a covering index.
188b0 2a 2a 20 20 20 20 20 63 6f 73 74 20 3d 20 6e 52 ** cost = nR
188c0 6f 77 20 2a 20 28 4b 2b 33 2e 30 29 20 20 20 20 ow * (K+3.0)
188d0 20 20 20 20 20 20 20 20 20 20 20 20 2f 2f 20 73 // s
188e0 63 61 6e 20 6f 66 20 6e 6f 6e 2d 63 6f 76 65 72 can of non-cover
188f0 69 6e 67 20 69 6e 64 65 78 0a 2a 2a 0a 2a 2a 20 ing index.**.**
18900 77 68 65 72 65 20 4b 20 69 73 20 61 20 76 61 6c where K is a val
18910 75 65 20 62 65 74 77 65 65 6e 20 31 2e 31 20 61 ue between 1.1 a
18920 6e 64 20 33 2e 30 20 73 65 74 20 62 61 73 65 64 nd 3.0 set based
18930 20 6f 6e 20 74 68 65 20 72 65 6c 61 74 69 76 65 on the relative
18940 20 0a 2a 2a 20 65 73 74 69 6d 61 74 65 64 20 61 .** estimated a
18950 76 65 72 61 67 65 20 73 69 7a 65 20 6f 66 20 74 verage size of t
18960 68 65 20 69 6e 64 65 78 20 61 6e 64 20 74 61 62 he index and tab
18970 6c 65 20 72 65 63 6f 72 64 73 2e 0a 2a 2a 0a 2a le records..**.*
18980 2a 20 46 6f 72 20 61 6e 20 69 6e 64 65 78 20 73 * For an index s
18990 63 61 6e 2c 20 77 68 65 72 65 20 6e 56 69 73 69 can, where nVisi
189a0 74 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 t is the number
189b0 6f 66 20 69 6e 64 65 78 20 72 6f 77 73 20 76 69 of index rows vi
189c0 73 69 74 65 64 0a 2a 2a 20 62 79 20 74 68 65 20 sited.** by the
189d0 73 63 61 6e 2c 20 61 6e 64 20 6e 53 65 65 6b 20 scan, and nSeek
189e0 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 is the number of
189f0 20 73 65 65 6b 20 6f 70 65 72 61 74 69 6f 6e 73 seek operations
18a00 20 72 65 71 75 69 72 65 64 20 6f 6e 20 0a 2a 2a required on .**
18a10 20 74 68 65 20 69 6e 64 65 78 20 62 2d 74 72 65 the index b-tre
18a20 65 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 63 6f 73 e:.**.** cos
18a30 74 20 3d 20 6e 53 65 65 6b 20 2a 20 28 6c 6f 67 t = nSeek * (log
18a40 28 6e 52 6f 77 29 20 2b 20 4b 20 2a 20 6e 56 69 (nRow) + K * nVi
18a50 73 69 74 29 20 20 20 20 20 20 20 20 20 20 2f 2f sit) //
18a60 20 63 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 0a covering index.
18a70 2a 2a 20 20 20 20 20 63 6f 73 74 20 3d 20 6e 53 ** cost = nS
18a80 65 65 6b 20 2a 20 28 6c 6f 67 28 6e 52 6f 77 29 eek * (log(nRow)
18a90 20 2b 20 28 4b 2b 33 2e 30 29 20 2a 20 6e 56 69 + (K+3.0) * nVi
18aa0 73 69 74 29 20 20 20 20 2f 2f 20 6e 6f 6e 2d 63 sit) // non-c
18ab0 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 0a 2a 2a overing index.**
18ac0 0a 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 6e 53 .** Normally, nS
18ad0 65 65 6b 20 69 73 20 31 2e 20 6e 53 65 65 6b 20 eek is 1. nSeek
18ae0 76 61 6c 75 65 73 20 67 72 65 61 74 65 72 20 74 values greater t
18af0 68 61 6e 20 31 20 63 6f 6d 65 20 61 62 6f 75 74 han 1 come about
18b00 20 69 66 20 74 68 65 20 0a 2a 2a 20 57 48 45 52 if the .** WHER
18b10 45 20 63 6c 61 75 73 65 20 69 6e 63 6c 75 64 65 E clause include
18b20 73 20 22 78 20 49 4e 20 28 2e 2e 2e 2e 29 22 20 s "x IN (....)"
18b30 74 65 72 6d 73 20 75 73 65 64 20 69 6e 20 70 6c terms used in pl
18b40 61 63 65 20 6f 66 20 22 78 3d 3f 22 2e 20 4f 72 ace of "x=?". Or
18b50 20 77 68 65 6e 20 0a 2a 2a 20 69 6d 70 6c 69 63 when .** implic
18b60 69 74 20 22 78 20 49 4e 20 28 53 45 4c 45 43 54 it "x IN (SELECT
18b70 20 78 20 46 52 4f 4d 20 74 62 6c 29 22 20 74 65 x FROM tbl)" te
18b80 72 6d 73 20 61 72 65 20 61 64 64 65 64 20 66 6f rms are added fo
18b90 72 20 73 6b 69 70 2d 73 63 61 6e 73 2e 0a 2a 2a r skip-scans..**
18ba0 0a 2a 2a 20 54 68 65 20 65 73 74 69 6d 61 74 65 .** The estimate
18bb0 64 20 76 61 6c 75 65 73 20 28 6e 52 6f 77 2c 20 d values (nRow,
18bc0 6e 56 69 73 69 74 2c 20 6e 53 65 65 6b 29 20 6f nVisit, nSeek) o
18bd0 66 74 65 6e 20 63 6f 6e 74 61 69 6e 20 61 20 6c ften contain a l
18be0 61 72 67 65 20 61 6d 6f 75 6e 74 0a 2a 2a 20 6f arge amount.** o
18bf0 66 20 75 6e 63 65 72 74 61 69 6e 74 79 2e 20 20 f uncertainty.
18c00 46 6f 72 20 74 68 69 73 20 72 65 61 73 6f 6e 2c For this reason,
18c10 20 73 63 6f 72 69 6e 67 20 69 73 20 64 65 73 69 scoring is desi
18c20 67 6e 65 64 20 74 6f 20 70 69 63 6b 20 70 6c 61 gned to pick pla
18c30 6e 73 20 74 68 61 74 0a 2a 2a 20 22 64 6f 20 74 ns that.** "do t
18c40 68 65 20 6c 65 61 73 74 20 68 61 72 6d 22 20 69 he least harm" i
18c50 66 20 74 68 65 20 65 73 74 69 6d 61 74 65 73 20 f the estimates
18c60 61 72 65 20 69 6e 61 63 63 75 72 61 74 65 2e 20 are inaccurate.
18c70 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 61 0a For example, a.
18c80 2a 2a 20 6c 6f 67 28 6e 52 6f 77 29 20 66 61 63 ** log(nRow) fac
18c90 74 6f 72 20 69 73 20 6f 6d 69 74 74 65 64 20 66 tor is omitted f
18ca0 72 6f 6d 20 61 20 6e 6f 6e 2d 63 6f 76 65 72 69 rom a non-coveri
18cb0 6e 67 20 69 6e 64 65 78 20 73 63 61 6e 20 69 6e ng index scan in
18cc0 20 6f 72 64 65 72 20 74 6f 0a 2a 2a 20 62 69 61 order to.** bia
18cd0 73 20 74 68 65 20 73 63 6f 72 69 6e 67 20 69 6e s the scoring in
18ce0 20 66 61 76 6f 72 20 6f 66 20 75 73 69 6e 67 20 favor of using
18cf0 61 6e 20 69 6e 64 65 78 2c 20 73 69 6e 63 65 20 an index, since
18d00 74 68 65 20 77 6f 72 73 74 2d 63 61 73 65 0a 2a the worst-case.*
18d10 2a 20 70 65 72 66 6f 72 6d 61 6e 63 65 20 6f 66 * performance of
18d20 20 75 73 69 6e 67 20 61 6e 20 69 6e 64 65 78 20 using an index
18d30 69 73 20 66 61 72 20 62 65 74 74 65 72 20 74 68 is far better th
18d40 61 6e 20 74 68 65 20 77 6f 72 73 74 2d 63 61 73 an the worst-cas
18d50 65 20 70 65 72 66 6f 72 6d 61 6e 63 65 0a 2a 2a e performance.**
18d60 20 6f 66 20 61 20 66 75 6c 6c 20 74 61 62 6c 65 of a full table
18d70 20 73 63 61 6e 2e 0a 2a 2f 0a 73 74 61 74 69 63 scan..*/.static
18d80 20 69 6e 74 20 77 68 65 72 65 4c 6f 6f 70 41 64 int whereLoopAd
18d90 64 42 74 72 65 65 28 0a 20 20 57 68 65 72 65 4c dBtree(. WhereL
18da0 6f 6f 70 42 75 69 6c 64 65 72 20 2a 70 42 75 69 oopBuilder *pBui
18db0 6c 64 65 72 2c 20 2f 2a 20 57 48 45 52 45 20 63 lder, /* WHERE c
18dc0 6c 61 75 73 65 20 69 6e 66 6f 72 6d 61 74 69 6f lause informatio
18dd0 6e 20 2a 2f 0a 20 20 42 69 74 6d 61 73 6b 20 6d n */. Bitmask m
18de0 50 72 65 72 65 71 20 20 20 20 20 20 20 20 20 20 Prereq
18df0 20 20 20 2f 2a 20 45 78 74 72 61 20 70 72 65 72 /* Extra prer
18e00 65 71 75 65 73 69 74 65 73 20 66 6f 72 20 75 73 equesites for us
18e10 69 6e 67 20 74 68 69 73 20 74 61 62 6c 65 20 2a ing this table *
18e20 2f 0a 29 7b 0a 20 20 57 68 65 72 65 49 6e 66 6f /.){. WhereInfo
18e30 20 2a 70 57 49 6e 66 6f 3b 20 20 20 20 20 20 20 *pWInfo;
18e40 20 20 20 2f 2a 20 57 48 45 52 45 20 61 6e 61 6c /* WHERE anal
18e50 79 73 69 73 20 63 6f 6e 74 65 78 74 20 2a 2f 0a ysis context */.
18e60 20 20 49 6e 64 65 78 20 2a 70 50 72 6f 62 65 3b Index *pProbe;
18e70 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
18e80 20 41 6e 20 69 6e 64 65 78 20 77 65 20 61 72 65 An index we are
18e90 20 65 76 61 6c 75 61 74 69 6e 67 20 2a 2f 0a 20 evaluating */.
18ea0 20 49 6e 64 65 78 20 73 50 6b 3b 20 20 20 20 20 Index sPk;
18eb0 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
18ec0 41 20 66 61 6b 65 20 69 6e 64 65 78 20 6f 62 6a A fake index obj
18ed0 65 63 74 20 66 6f 72 20 74 68 65 20 70 72 69 6d ect for the prim
18ee0 61 72 79 20 6b 65 79 20 2a 2f 0a 20 20 4c 6f 67 ary key */. Log
18ef0 45 73 74 20 61 69 52 6f 77 45 73 74 50 6b 5b 32 Est aiRowEstPk[2
18f00 5d 3b 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 ]; /* The
18f10 61 69 52 6f 77 4c 6f 67 45 73 74 5b 5d 20 76 61 aiRowLogEst[] va
18f20 6c 75 65 20 66 6f 72 20 74 68 65 20 73 50 6b 20 lue for the sPk
18f30 69 6e 64 65 78 20 2a 2f 0a 20 20 69 31 36 20 61 index */. i16 a
18f40 69 43 6f 6c 75 6d 6e 50 6b 20 3d 20 2d 31 3b 20 iColumnPk = -1;
18f50 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 61 43 /* The aC
18f60 6f 6c 75 6d 6e 5b 5d 20 76 61 6c 75 65 20 66 6f olumn[] value fo
18f70 72 20 74 68 65 20 73 50 6b 20 69 6e 64 65 78 20 r the sPk index
18f80 2a 2f 0a 20 20 53 72 63 4c 69 73 74 20 2a 70 54 */. SrcList *pT
18f90 61 62 4c 69 73 74 3b 20 20 20 20 20 20 20 20 20 abList;
18fa0 20 2f 2a 20 54 68 65 20 46 52 4f 4d 20 63 6c 61 /* The FROM cla
18fb0 75 73 65 20 2a 2f 0a 20 20 73 74 72 75 63 74 20 use */. struct
18fc0 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 2a 70 53 SrcList_item *pS
18fd0 72 63 3b 20 20 2f 2a 20 54 68 65 20 46 52 4f 4d rc; /* The FROM
18fe0 20 63 6c 61 75 73 65 20 62 74 72 65 65 20 74 65 clause btree te
18ff0 72 6d 20 74 6f 20 61 64 64 20 2a 2f 0a 20 20 57 rm to add */. W
19000 68 65 72 65 4c 6f 6f 70 20 2a 70 4e 65 77 3b 20 hereLoop *pNew;
19010 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 65 /* Te
19020 6d 70 6c 61 74 65 20 57 68 65 72 65 4c 6f 6f 70 mplate WhereLoop
19030 20 6f 62 6a 65 63 74 20 2a 2f 0a 20 20 69 6e 74 object */. int
19040 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
19050 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
19060 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 rn code */. int
19070 20 69 53 6f 72 74 49 64 78 20 3d 20 31 3b 20 20 iSortIdx = 1;
19080 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 /* Inde
19090 78 20 6e 75 6d 62 65 72 20 2a 2f 0a 20 20 69 6e x number */. in
190a0 74 20 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 t b;
190b0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 62 /* A b
190c0 6f 6f 6c 65 61 6e 20 76 61 6c 75 65 20 2a 2f 0a oolean value */.
190d0 20 20 4c 6f 67 45 73 74 20 72 53 69 7a 65 3b 20 LogEst rSize;
190e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
190f0 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 number of rows
19100 69 6e 20 74 68 65 20 74 61 62 6c 65 20 2a 2f 0a in the table */.
19110 20 20 4c 6f 67 45 73 74 20 72 4c 6f 67 53 69 7a LogEst rLogSiz
19120 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e; /*
19130 20 4c 6f 67 61 72 69 74 68 6d 20 6f 66 20 74 68 Logarithm of th
19140 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 e number of rows
19150 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20 2a 2f in the table */
19160 0a 20 20 57 68 65 72 65 43 6c 61 75 73 65 20 2a . WhereClause *
19170 70 57 43 3b 20 20 20 20 20 20 20 20 20 20 20 2f pWC; /
19180 2a 20 54 68 65 20 70 61 72 73 65 64 20 57 48 45 * The parsed WHE
19190 52 45 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 54 RE clause */. T
191a0 61 62 6c 65 20 2a 70 54 61 62 3b 20 20 20 20 20 able *pTab;
191b0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 61 /* Ta
191c0 62 6c 65 20 62 65 69 6e 67 20 71 75 65 72 69 65 ble being querie
191d0 64 20 2a 2f 0a 20 20 0a 20 20 70 4e 65 77 20 3d d */. . pNew =
191e0 20 70 42 75 69 6c 64 65 72 2d 3e 70 4e 65 77 3b pBuilder->pNew;
191f0 0a 20 20 70 57 49 6e 66 6f 20 3d 20 70 42 75 69 . pWInfo = pBui
19200 6c 64 65 72 2d 3e 70 57 49 6e 66 6f 3b 0a 20 20 lder->pWInfo;.
19210 70 54 61 62 4c 69 73 74 20 3d 20 70 57 49 6e 66 pTabList = pWInf
19220 6f 2d 3e 70 54 61 62 4c 69 73 74 3b 0a 20 20 70 o->pTabList;. p
19230 53 72 63 20 3d 20 70 54 61 62 4c 69 73 74 2d 3e Src = pTabList->
19240 61 20 2b 20 70 4e 65 77 2d 3e 69 54 61 62 3b 0a a + pNew->iTab;.
19250 20 20 70 54 61 62 20 3d 20 70 53 72 63 2d 3e 70 pTab = pSrc->p
19260 54 61 62 3b 0a 20 20 70 57 43 20 3d 20 70 42 75 Tab;. pWC = pBu
19270 69 6c 64 65 72 2d 3e 70 57 43 3b 0a 20 20 61 73 ilder->pWC;. as
19280 73 65 72 74 28 20 21 49 73 56 69 72 74 75 61 6c sert( !IsVirtual
19290 28 70 53 72 63 2d 3e 70 54 61 62 29 20 29 3b 0a (pSrc->pTab) );.
192a0 0a 20 20 69 66 28 20 70 53 72 63 2d 3e 70 49 42 . if( pSrc->pIB
192b0 49 6e 64 65 78 20 29 7b 0a 20 20 20 20 2f 2a 20 Index ){. /*
192c0 41 6e 20 49 4e 44 45 58 45 44 20 42 59 20 63 6c An INDEXED BY cl
192d0 61 75 73 65 20 73 70 65 63 69 66 69 65 73 20 61 ause specifies a
192e0 20 70 61 72 74 69 63 75 6c 61 72 20 69 6e 64 65 particular inde
192f0 78 20 74 6f 20 75 73 65 20 2a 2f 0a 20 20 20 20 x to use */.
19300 70 50 72 6f 62 65 20 3d 20 70 53 72 63 2d 3e 70 pProbe = pSrc->p
19310 49 42 49 6e 64 65 78 3b 0a 20 20 7d 65 6c 73 65 IBIndex;. }else
19320 20 69 66 28 20 21 48 61 73 52 6f 77 69 64 28 70 if( !HasRowid(p
19330 54 61 62 29 20 29 7b 0a 20 20 20 20 70 50 72 6f Tab) ){. pPro
19340 62 65 20 3d 20 70 54 61 62 2d 3e 70 49 6e 64 65 be = pTab->pInde
19350 78 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 x;. }else{.
19360 2f 2a 20 54 68 65 72 65 20 69 73 20 6e 6f 20 49 /* There is no I
19370 4e 44 45 58 45 44 20 42 59 20 63 6c 61 75 73 65 NDEXED BY clause
19380 2e 20 20 43 72 65 61 74 65 20 61 20 66 61 6b 65 . Create a fake
19390 20 49 6e 64 65 78 20 6f 62 6a 65 63 74 20 69 6e Index object in
193a0 20 6c 6f 63 61 6c 0a 20 20 20 20 2a 2a 20 76 61 local. ** va
193b0 72 69 61 62 6c 65 20 73 50 6b 20 74 6f 20 72 65 riable sPk to re
193c0 70 72 65 73 65 6e 74 20 74 68 65 20 72 6f 77 69 present the rowi
193d0 64 20 70 72 69 6d 61 72 79 20 6b 65 79 20 69 6e d primary key in
193e0 64 65 78 2e 20 20 4d 61 6b 65 20 74 68 69 73 0a dex. Make this.
193f0 20 20 20 20 2a 2a 20 66 61 6b 65 20 69 6e 64 65 ** fake inde
19400 78 20 74 68 65 20 66 69 72 73 74 20 69 6e 20 61 x the first in a
19410 20 63 68 61 69 6e 20 6f 66 20 49 6e 64 65 78 20 chain of Index
19420 6f 62 6a 65 63 74 73 20 77 69 74 68 20 61 6c 6c objects with all
19430 20 6f 66 20 74 68 65 20 72 65 61 6c 0a 20 20 20 of the real.
19440 20 2a 2a 20 69 6e 64 69 63 65 73 20 74 6f 20 66 ** indices to f
19450 6f 6c 6c 6f 77 20 2a 2f 0a 20 20 20 20 49 6e 64 ollow */. Ind
19460 65 78 20 2a 70 46 69 72 73 74 3b 20 20 20 20 20 ex *pFirst;
19470 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
19480 46 69 72 73 74 20 6f 66 20 72 65 61 6c 20 69 6e First of real in
19490 64 69 63 65 73 20 6f 6e 20 74 68 65 20 74 61 62 dices on the tab
194a0 6c 65 20 2a 2f 0a 20 20 20 20 6d 65 6d 73 65 74 le */. memset
194b0 28 26 73 50 6b 2c 20 30 2c 20 73 69 7a 65 6f 66 (&sPk, 0, sizeof
194c0 28 49 6e 64 65 78 29 29 3b 0a 20 20 20 20 73 50 (Index));. sP
194d0 6b 2e 6e 4b 65 79 43 6f 6c 20 3d 20 31 3b 0a 20 k.nKeyCol = 1;.
194e0 20 20 20 73 50 6b 2e 6e 43 6f 6c 75 6d 6e 20 3d sPk.nColumn =
194f0 20 31 3b 0a 20 20 20 20 73 50 6b 2e 61 69 43 6f 1;. sPk.aiCo
19500 6c 75 6d 6e 20 3d 20 26 61 69 43 6f 6c 75 6d 6e lumn = &aiColumn
19510 50 6b 3b 0a 20 20 20 20 73 50 6b 2e 61 69 52 6f Pk;. sPk.aiRo
19520 77 4c 6f 67 45 73 74 20 3d 20 61 69 52 6f 77 45 wLogEst = aiRowE
19530 73 74 50 6b 3b 0a 20 20 20 20 73 50 6b 2e 6f 6e stPk;. sPk.on
19540 45 72 72 6f 72 20 3d 20 4f 45 5f 52 65 70 6c 61 Error = OE_Repla
19550 63 65 3b 0a 20 20 20 20 73 50 6b 2e 70 54 61 62 ce;. sPk.pTab
19560 6c 65 20 3d 20 70 54 61 62 3b 0a 20 20 20 20 73 le = pTab;. s
19570 50 6b 2e 73 7a 49 64 78 52 6f 77 20 3d 20 70 54 Pk.szIdxRow = pT
19580 61 62 2d 3e 73 7a 54 61 62 52 6f 77 3b 0a 20 20 ab->szTabRow;.
19590 20 20 61 69 52 6f 77 45 73 74 50 6b 5b 30 5d 20 aiRowEstPk[0]
195a0 3d 20 70 54 61 62 2d 3e 6e 52 6f 77 4c 6f 67 45 = pTab->nRowLogE
195b0 73 74 3b 0a 20 20 20 20 61 69 52 6f 77 45 73 74 st;. aiRowEst
195c0 50 6b 5b 31 5d 20 3d 20 30 3b 0a 20 20 20 20 70 Pk[1] = 0;. p
195d0 46 69 72 73 74 20 3d 20 70 53 72 63 2d 3e 70 54 First = pSrc->pT
195e0 61 62 2d 3e 70 49 6e 64 65 78 3b 0a 20 20 20 20 ab->pIndex;.
195f0 69 66 28 20 70 53 72 63 2d 3e 66 67 2e 6e 6f 74 if( pSrc->fg.not
19600 49 6e 64 65 78 65 64 3d 3d 30 20 29 7b 0a 20 20 Indexed==0 ){.
19610 20 20 20 20 2f 2a 20 54 68 65 20 72 65 61 6c 20 /* The real
19620 69 6e 64 69 63 65 73 20 6f 66 20 74 68 65 20 74 indices of the t
19630 61 62 6c 65 20 61 72 65 20 6f 6e 6c 79 20 63 6f able are only co
19640 6e 73 69 64 65 72 65 64 20 69 66 20 74 68 65 0a nsidered if the.
19650 20 20 20 20 20 20 2a 2a 20 4e 4f 54 20 49 4e 44 ** NOT IND
19660 45 58 45 44 20 71 75 61 6c 69 66 69 65 72 20 69 EXED qualifier i
19670 73 20 6f 6d 69 74 74 65 64 20 66 72 6f 6d 20 74 s omitted from t
19680 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 2a he FROM clause *
19690 2f 0a 20 20 20 20 20 20 73 50 6b 2e 70 4e 65 78 /. sPk.pNex
196a0 74 20 3d 20 70 46 69 72 73 74 3b 0a 20 20 20 20 t = pFirst;.
196b0 7d 0a 20 20 20 20 70 50 72 6f 62 65 20 3d 20 26 }. pProbe = &
196c0 73 50 6b 3b 0a 20 20 7d 0a 20 20 72 53 69 7a 65 sPk;. }. rSize
196d0 20 3d 20 70 54 61 62 2d 3e 6e 52 6f 77 4c 6f 67 = pTab->nRowLog
196e0 45 73 74 3b 0a 20 20 72 4c 6f 67 53 69 7a 65 20 Est;. rLogSize
196f0 3d 20 65 73 74 4c 6f 67 28 72 53 69 7a 65 29 3b = estLog(rSize);
19700 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
19710 5f 4f 4d 49 54 5f 41 55 54 4f 4d 41 54 49 43 5f _OMIT_AUTOMATIC_
19720 49 4e 44 45 58 0a 20 20 2f 2a 20 41 75 74 6f 6d INDEX. /* Autom
19730 61 74 69 63 20 69 6e 64 65 78 65 73 20 2a 2f 0a atic indexes */.
19740 20 20 69 66 28 20 21 70 42 75 69 6c 64 65 72 2d if( !pBuilder-
19750 3e 70 4f 72 53 65 74 20 20 20 20 20 20 2f 2a 20 >pOrSet /*
19760 4e 6f 74 20 70 61 72 74 20 6f 66 20 61 6e 20 4f Not part of an O
19770 52 20 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 20 2a R optimization *
19780 2f 0a 20 20 20 26 26 20 28 70 57 49 6e 66 6f 2d /. && (pWInfo-
19790 3e 77 63 74 72 6c 46 6c 61 67 73 20 26 20 57 48 >wctrlFlags & WH
197a0 45 52 45 5f 4f 52 5f 53 55 42 43 4c 41 55 53 45 ERE_OR_SUBCLAUSE
197b0 29 3d 3d 30 0a 20 20 20 26 26 20 28 70 57 49 6e )==0. && (pWIn
197c0 66 6f 2d 3e 70 50 61 72 73 65 2d 3e 64 62 2d 3e fo->pParse->db->
197d0 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 41 flags & SQLITE_A
197e0 75 74 6f 49 6e 64 65 78 29 21 3d 30 0a 20 20 20 utoIndex)!=0.
197f0 26 26 20 70 53 72 63 2d 3e 70 49 42 49 6e 64 65 && pSrc->pIBInde
19800 78 3d 3d 30 20 20 20 20 20 20 2f 2a 20 48 61 73 x==0 /* Has
19810 20 6e 6f 20 49 4e 44 45 58 45 44 20 42 59 20 63 no INDEXED BY c
19820 6c 61 75 73 65 20 2a 2f 0a 20 20 20 26 26 20 21 lause */. && !
19830 70 53 72 63 2d 3e 66 67 2e 6e 6f 74 49 6e 64 65 pSrc->fg.notInde
19840 78 65 64 20 20 20 2f 2a 20 48 61 73 20 6e 6f 20 xed /* Has no
19850 4e 4f 54 20 49 4e 44 45 58 45 44 20 63 6c 61 75 NOT INDEXED clau
19860 73 65 20 2a 2f 0a 20 20 20 26 26 20 48 61 73 52 se */. && HasR
19870 6f 77 69 64 28 70 54 61 62 29 20 20 20 20 20 20 owid(pTab)
19880 20 20 20 2f 2a 20 4e 6f 74 20 57 49 54 48 4f 55 /* Not WITHOU
19890 54 20 52 4f 57 49 44 20 74 61 62 6c 65 2e 20 28 T ROWID table. (
198a0 46 49 58 4d 45 3a 20 57 68 79 20 6e 6f 74 3f 29 FIXME: Why not?)
198b0 20 2a 2f 0a 20 20 20 26 26 20 21 70 53 72 63 2d */. && !pSrc-
198c0 3e 66 67 2e 69 73 43 6f 72 72 65 6c 61 74 65 64 >fg.isCorrelated
198d0 20 2f 2a 20 4e 6f 74 20 61 20 63 6f 72 72 65 6c /* Not a correl
198e0 61 74 65 64 20 73 75 62 71 75 65 72 79 20 2a 2f ated subquery */
198f0 0a 20 20 20 26 26 20 21 70 53 72 63 2d 3e 66 67 . && !pSrc->fg
19900 2e 69 73 52 65 63 75 72 73 69 76 65 20 20 2f 2a .isRecursive /*
19910 20 4e 6f 74 20 61 20 72 65 63 75 72 73 69 76 65 Not a recursive
19920 20 63 6f 6d 6d 6f 6e 20 74 61 62 6c 65 20 65 78 common table ex
19930 70 72 65 73 73 69 6f 6e 2e 20 2a 2f 0a 20 20 29 pression. */. )
19940 7b 0a 20 20 20 20 2f 2a 20 47 65 6e 65 72 61 74 {. /* Generat
19950 65 20 61 75 74 6f 2d 69 6e 64 65 78 20 57 68 65 e auto-index Whe
19960 72 65 4c 6f 6f 70 73 20 2a 2f 0a 20 20 20 20 57 reLoops */. W
19970 68 65 72 65 54 65 72 6d 20 2a 70 54 65 72 6d 3b hereTerm *pTerm;
19980 0a 20 20 20 20 57 68 65 72 65 54 65 72 6d 20 2a . WhereTerm *
19990 70 57 43 45 6e 64 20 3d 20 70 57 43 2d 3e 61 20 pWCEnd = pWC->a
199a0 2b 20 70 57 43 2d 3e 6e 54 65 72 6d 3b 0a 20 20 + pWC->nTerm;.
199b0 20 20 66 6f 72 28 70 54 65 72 6d 3d 70 57 43 2d for(pTerm=pWC-
199c0 3e 61 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f >a; rc==SQLITE_O
199d0 4b 20 26 26 20 70 54 65 72 6d 3c 70 57 43 45 6e K && pTerm<pWCEn
199e0 64 3b 20 70 54 65 72 6d 2b 2b 29 7b 0a 20 20 20 d; pTerm++){.
199f0 20 20 20 69 66 28 20 70 54 65 72 6d 2d 3e 70 72 if( pTerm->pr
19a00 65 72 65 71 52 69 67 68 74 20 26 20 70 4e 65 77 ereqRight & pNew
19a10 2d 3e 6d 61 73 6b 53 65 6c 66 20 29 20 63 6f 6e ->maskSelf ) con
19a20 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 69 66 28 tinue;. if(
19a30 20 74 65 72 6d 43 61 6e 44 72 69 76 65 49 6e 64 termCanDriveInd
19a40 65 78 28 70 54 65 72 6d 2c 20 70 53 72 63 2c 20 ex(pTerm, pSrc,
19a50 30 29 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4e 0) ){. pN
19a60 65 77 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 71 20 ew->u.btree.nEq
19a70 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 = 1;. pNe
19a80 77 2d 3e 6e 53 6b 69 70 20 3d 20 30 3b 0a 20 20 w->nSkip = 0;.
19a90 20 20 20 20 20 20 70 4e 65 77 2d 3e 75 2e 62 74 pNew->u.bt
19aa0 72 65 65 2e 70 49 6e 64 65 78 20 3d 20 30 3b 0a ree.pIndex = 0;.
19ab0 20 20 20 20 20 20 20 20 70 4e 65 77 2d 3e 6e 4c pNew->nL
19ac0 54 65 72 6d 20 3d 20 31 3b 0a 20 20 20 20 20 20 Term = 1;.
19ad0 20 20 70 4e 65 77 2d 3e 61 4c 54 65 72 6d 5b 30 pNew->aLTerm[0
19ae0 5d 20 3d 20 70 54 65 72 6d 3b 0a 20 20 20 20 20 ] = pTerm;.
19af0 20 20 20 2f 2a 20 54 55 4e 49 4e 47 3a 20 4f 6e /* TUNING: On
19b00 65 2d 74 69 6d 65 20 63 6f 73 74 20 66 6f 72 20 e-time cost for
19b10 63 6f 6d 70 75 74 69 6e 67 20 74 68 65 20 61 75 computing the au
19b20 74 6f 6d 61 74 69 63 20 69 6e 64 65 78 20 69 73 tomatic index is
19b30 0a 20 20 20 20 20 20 20 20 2a 2a 20 65 73 74 69 . ** esti
19b40 6d 61 74 65 64 20 74 6f 20 62 65 20 58 2a 4e 2a mated to be X*N*
19b50 6c 6f 67 32 28 4e 29 20 77 68 65 72 65 20 4e 20 log2(N) where N
19b60 69 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 is the number of
19b70 20 72 6f 77 73 20 69 6e 0a 20 20 20 20 20 20 20 rows in.
19b80 20 2a 2a 20 74 68 65 20 74 61 62 6c 65 20 62 65 ** the table be
19b90 69 6e 67 20 69 6e 64 65 78 65 64 20 61 6e 64 20 ing indexed and
19ba0 77 68 65 72 65 20 58 20 69 73 20 37 20 28 4c 6f where X is 7 (Lo
19bb0 67 45 73 74 3d 32 38 29 20 66 6f 72 20 6e 6f 72 gEst=28) for nor
19bc0 6d 61 6c 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 mal. ** t
19bd0 61 62 6c 65 73 20 6f 72 20 31 2e 33 37 35 20 28 ables or 1.375 (
19be0 4c 6f 67 45 73 74 3d 34 29 20 66 6f 72 20 76 69 LogEst=4) for vi
19bf0 65 77 73 20 61 6e 64 20 73 75 62 71 75 65 72 69 ews and subqueri
19c00 65 73 2e 20 20 54 68 65 20 76 61 6c 75 65 0a 20 es. The value.
19c10 20 20 20 20 20 20 20 2a 2a 20 6f 66 20 58 20 69 ** of X i
19c20 73 20 73 6d 61 6c 6c 65 72 20 66 6f 72 20 76 69 s smaller for vi
19c30 65 77 73 20 61 6e 64 20 73 75 62 71 75 65 72 69 ews and subqueri
19c40 65 73 20 73 6f 20 74 68 61 74 20 74 68 65 20 71 es so that the q
19c50 75 65 72 79 20 70 6c 61 6e 6e 65 72 0a 20 20 20 uery planner.
19c60 20 20 20 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20 ** will be
19c70 6d 6f 72 65 20 61 67 67 72 65 73 73 69 76 65 20 more aggressive
19c80 61 62 6f 75 74 20 67 65 6e 65 72 61 74 69 6e 67 about generating
19c90 20 61 75 74 6f 6d 61 74 69 63 20 69 6e 64 65 78 automatic index
19ca0 65 73 20 66 6f 72 0a 20 20 20 20 20 20 20 20 2a es for. *
19cb0 2a 20 74 68 6f 73 65 20 6f 62 6a 65 63 74 73 2c * those objects,
19cc0 20 73 69 6e 63 65 20 74 68 65 72 65 20 69 73 20 since there is
19cd0 6e 6f 20 6f 70 70 6f 72 74 75 6e 69 74 79 20 74 no opportunity t
19ce0 6f 20 61 64 64 20 73 63 68 65 6d 61 0a 20 20 20 o add schema.
19cf0 20 20 20 20 20 2a 2a 20 69 6e 64 65 78 65 73 20 ** indexes
19d00 6f 6e 20 73 75 62 71 75 65 72 69 65 73 20 61 6e on subqueries an
19d10 64 20 76 69 65 77 73 2e 20 2a 2f 0a 20 20 20 20 d views. */.
19d20 20 20 20 20 70 4e 65 77 2d 3e 72 53 65 74 75 70 pNew->rSetup
19d30 20 3d 20 72 4c 6f 67 53 69 7a 65 20 2b 20 72 53 = rLogSize + rS
19d40 69 7a 65 20 2b 20 34 3b 0a 20 20 20 20 20 20 20 ize + 4;.
19d50 20 69 66 28 20 70 54 61 62 2d 3e 70 53 65 6c 65 if( pTab->pSele
19d60 63 74 3d 3d 30 20 26 26 20 28 70 54 61 62 2d 3e ct==0 && (pTab->
19d70 74 61 62 46 6c 61 67 73 20 26 20 54 46 5f 45 70 tabFlags & TF_Ep
19d80 68 65 6d 65 72 61 6c 29 3d 3d 30 20 29 7b 0a 20 hemeral)==0 ){.
19d90 20 20 20 20 20 20 20 20 20 70 4e 65 77 2d 3e 72 pNew->r
19da0 53 65 74 75 70 20 2b 3d 20 32 34 3b 0a 20 20 20 Setup += 24;.
19db0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 41 }. A
19dc0 70 70 6c 79 43 6f 73 74 4d 75 6c 74 69 70 6c 69 pplyCostMultipli
19dd0 65 72 28 70 4e 65 77 2d 3e 72 53 65 74 75 70 2c er(pNew->rSetup,
19de0 20 70 54 61 62 2d 3e 63 6f 73 74 4d 75 6c 74 29 pTab->costMult)
19df0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 4e ;. if( pN
19e00 65 77 2d 3e 72 53 65 74 75 70 3c 30 20 29 20 70 ew->rSetup<0 ) p
19e10 4e 65 77 2d 3e 72 53 65 74 75 70 20 3d 20 30 3b New->rSetup = 0;
19e20 0a 20 20 20 20 20 20 20 20 2f 2a 20 54 55 4e 49 . /* TUNI
19e30 4e 47 3a 20 45 61 63 68 20 69 6e 64 65 78 20 6c NG: Each index l
19e40 6f 6f 6b 75 70 20 79 69 65 6c 64 73 20 32 30 20 ookup yields 20
19e50 72 6f 77 73 20 69 6e 20 74 68 65 20 74 61 62 6c rows in the tabl
19e60 65 2e 20 20 54 68 69 73 0a 20 20 20 20 20 20 20 e. This.
19e70 20 2a 2a 20 69 73 20 6d 6f 72 65 20 74 68 61 6e ** is more than
19e80 20 74 68 65 20 75 73 75 61 6c 20 67 75 65 73 73 the usual guess
19e90 20 6f 66 20 31 30 20 72 6f 77 73 2c 20 73 69 6e of 10 rows, sin
19ea0 63 65 20 77 65 20 68 61 76 65 20 6e 6f 20 77 61 ce we have no wa
19eb0 79 0a 20 20 20 20 20 20 20 20 2a 2a 20 6f 66 20 y. ** of
19ec0 6b 6e 6f 77 69 6e 67 20 68 6f 77 20 73 65 6c 65 knowing how sele
19ed0 63 74 69 76 65 20 74 68 65 20 69 6e 64 65 78 20 ctive the index
19ee0 77 69 6c 6c 20 75 6c 74 69 6d 61 74 65 6c 79 20 will ultimately
19ef0 62 65 2e 20 20 49 74 20 77 6f 75 6c 64 0a 20 20 be. It would.
19f00 20 20 20 20 20 20 2a 2a 20 6e 6f 74 20 62 65 20 ** not be
19f10 75 6e 72 65 61 73 6f 6e 61 62 6c 65 20 74 6f 20 unreasonable to
19f20 6d 61 6b 65 20 74 68 69 73 20 76 61 6c 75 65 20 make this value
19f30 6d 75 63 68 20 6c 61 72 67 65 72 2e 20 2a 2f 0a much larger. */.
19f40 20 20 20 20 20 20 20 20 70 4e 65 77 2d 3e 6e 4f pNew->nO
19f50 75 74 20 3d 20 34 33 3b 20 20 61 73 73 65 72 74 ut = 43; assert
19f60 28 20 34 33 3d 3d 73 71 6c 69 74 65 33 4c 6f 67 ( 43==sqlite3Log
19f70 45 73 74 28 32 30 29 20 29 3b 0a 20 20 20 20 20 Est(20) );.
19f80 20 20 20 70 4e 65 77 2d 3e 72 52 75 6e 20 3d 20 pNew->rRun =
19f90 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 41 64 64 sqlite3LogEstAdd
19fa0 28 72 4c 6f 67 53 69 7a 65 2c 70 4e 65 77 2d 3e (rLogSize,pNew->
19fb0 6e 4f 75 74 29 3b 0a 20 20 20 20 20 20 20 20 70 nOut);. p
19fc0 4e 65 77 2d 3e 77 73 46 6c 61 67 73 20 3d 20 57 New->wsFlags = W
19fd0 48 45 52 45 5f 41 55 54 4f 5f 49 4e 44 45 58 3b HERE_AUTO_INDEX;
19fe0 0a 20 20 20 20 20 20 20 20 70 4e 65 77 2d 3e 70 . pNew->p
19ff0 72 65 72 65 71 20 3d 20 6d 50 72 65 72 65 71 20 rereq = mPrereq
1a000 7c 20 70 54 65 72 6d 2d 3e 70 72 65 72 65 71 52 | pTerm->prereqR
1a010 69 67 68 74 3b 0a 20 20 20 20 20 20 20 20 72 63 ight;. rc
1a020 20 3d 20 77 68 65 72 65 4c 6f 6f 70 49 6e 73 65 = whereLoopInse
1a030 72 74 28 70 42 75 69 6c 64 65 72 2c 20 70 4e 65 rt(pBuilder, pNe
1a040 77 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 w);. }.
1a050 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 20 2f 2a 20 }. }.#endif /*
1a060 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54 4f SQLITE_OMIT_AUTO
1a070 4d 41 54 49 43 5f 49 4e 44 45 58 20 2a 2f 0a 0a MATIC_INDEX */..
1a080 20 20 2f 2a 20 4c 6f 6f 70 20 6f 76 65 72 20 61 /* Loop over a
1a090 6c 6c 20 69 6e 64 69 63 65 73 2e 20 49 66 20 74 ll indices. If t
1a0a0 68 65 72 65 20 77 61 73 20 61 6e 20 49 4e 44 45 here was an INDE
1a0b0 58 45 44 20 42 59 20 63 6c 61 75 73 65 2c 20 74 XED BY clause, t
1a0c0 68 65 6e 20 6f 6e 6c 79 20 0a 20 20 2a 2a 20 63 hen only . ** c
1a0d0 6f 6e 73 69 64 65 72 20 69 6e 64 65 78 20 70 50 onsider index pP
1a0e0 72 6f 62 65 2e 20 20 2a 2f 0a 20 20 66 6f 72 28 robe. */. for(
1a0f0 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ; rc==SQLITE_OK
1a100 26 26 20 70 50 72 6f 62 65 3b 20 0a 20 20 20 20 && pProbe; .
1a110 20 20 70 50 72 6f 62 65 3d 28 70 53 72 63 2d 3e pProbe=(pSrc->
1a120 70 49 42 49 6e 64 65 78 20 3f 20 30 20 3a 20 70 pIBIndex ? 0 : p
1a130 50 72 6f 62 65 2d 3e 70 4e 65 78 74 29 2c 20 69 Probe->pNext), i
1a140 53 6f 72 74 49 64 78 2b 2b 0a 20 20 29 7b 0a 20 SortIdx++. ){.
1a150 20 20 20 69 66 28 20 70 50 72 6f 62 65 2d 3e 70 if( pProbe->p
1a160 50 61 72 74 49 64 78 57 68 65 72 65 21 3d 30 0a PartIdxWhere!=0.
1a170 20 20 20 20 20 26 26 20 21 77 68 65 72 65 55 73 && !whereUs
1a180 61 62 6c 65 50 61 72 74 69 61 6c 49 6e 64 65 78 ablePartialIndex
1a190 28 70 53 72 63 2d 3e 69 43 75 72 73 6f 72 2c 20 (pSrc->iCursor,
1a1a0 70 57 43 2c 20 70 50 72 6f 62 65 2d 3e 70 50 61 pWC, pProbe->pPa
1a1b0 72 74 49 64 78 57 68 65 72 65 29 20 29 7b 0a 20 rtIdxWhere) ){.
1a1c0 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 testcase( p
1a1d0 4e 65 77 2d 3e 69 54 61 62 21 3d 70 53 72 63 2d New->iTab!=pSrc-
1a1e0 3e 69 43 75 72 73 6f 72 20 29 3b 20 20 2f 2a 20 >iCursor ); /*
1a1f0 53 65 65 20 74 69 63 6b 65 74 20 5b 39 38 64 39 See ticket [98d9
1a200 37 33 62 38 66 35 5d 20 2a 2f 0a 20 20 20 20 20 73b8f5] */.
1a210 20 63 6f 6e 74 69 6e 75 65 3b 20 20 2f 2a 20 50 continue; /* P
1a220 61 72 74 69 61 6c 20 69 6e 64 65 78 20 69 6e 61 artial index ina
1a230 70 70 72 6f 70 72 69 61 74 65 20 66 6f 72 20 74 ppropriate for t
1a240 68 69 73 20 71 75 65 72 79 20 2a 2f 0a 20 20 20 his query */.
1a250 20 7d 0a 20 20 20 20 69 66 28 20 70 50 72 6f 62 }. if( pProb
1a260 65 2d 3e 62 4e 6f 51 75 65 72 79 20 29 20 63 6f e->bNoQuery ) co
1a270 6e 74 69 6e 75 65 3b 0a 20 20 20 20 72 53 69 7a ntinue;. rSiz
1a280 65 20 3d 20 70 50 72 6f 62 65 2d 3e 61 69 52 6f e = pProbe->aiRo
1a290 77 4c 6f 67 45 73 74 5b 30 5d 3b 0a 20 20 20 20 wLogEst[0];.
1a2a0 70 4e 65 77 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 pNew->u.btree.nE
1a2b0 71 20 3d 20 30 3b 0a 20 20 20 20 70 4e 65 77 2d q = 0;. pNew-
1a2c0 3e 75 2e 62 74 72 65 65 2e 6e 42 74 6d 20 3d 20 >u.btree.nBtm =
1a2d0 30 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 75 2e 62 0;. pNew->u.b
1a2e0 74 72 65 65 2e 6e 54 6f 70 20 3d 20 30 3b 0a 20 tree.nTop = 0;.
1a2f0 20 20 20 70 4e 65 77 2d 3e 6e 53 6b 69 70 20 3d pNew->nSkip =
1a300 20 30 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 6e 4c 0;. pNew->nL
1a310 54 65 72 6d 20 3d 20 30 3b 0a 20 20 20 20 70 4e Term = 0;. pN
1a320 65 77 2d 3e 69 53 6f 72 74 49 64 78 20 3d 20 30 ew->iSortIdx = 0
1a330 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 72 53 65 74 ;. pNew->rSet
1a340 75 70 20 3d 20 30 3b 0a 20 20 20 20 70 4e 65 77 up = 0;. pNew
1a350 2d 3e 70 72 65 72 65 71 20 3d 20 6d 50 72 65 72 ->prereq = mPrer
1a360 65 71 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 6e 4f eq;. pNew->nO
1a370 75 74 20 3d 20 72 53 69 7a 65 3b 0a 20 20 20 20 ut = rSize;.
1a380 70 4e 65 77 2d 3e 75 2e 62 74 72 65 65 2e 70 49 pNew->u.btree.pI
1a390 6e 64 65 78 20 3d 20 70 50 72 6f 62 65 3b 0a 20 ndex = pProbe;.
1a3a0 20 20 20 62 20 3d 20 69 6e 64 65 78 4d 69 67 68 b = indexMigh
1a3b0 74 48 65 6c 70 57 69 74 68 4f 72 64 65 72 42 79 tHelpWithOrderBy
1a3c0 28 70 42 75 69 6c 64 65 72 2c 20 70 50 72 6f 62 (pBuilder, pProb
1a3d0 65 2c 20 70 53 72 63 2d 3e 69 43 75 72 73 6f 72 e, pSrc->iCursor
1a3e0 29 3b 0a 20 20 20 20 2f 2a 20 54 68 65 20 4f 4e );. /* The ON
1a3f0 45 50 41 53 53 5f 44 45 53 49 52 45 44 20 66 6c EPASS_DESIRED fl
1a400 61 67 73 20 6e 65 76 65 72 20 6f 63 63 75 72 73 ags never occurs
1a410 20 74 6f 67 65 74 68 65 72 20 77 69 74 68 20 4f together with O
1a420 52 44 45 52 20 42 59 20 2a 2f 0a 20 20 20 20 61 RDER BY */. a
1a430 73 73 65 72 74 28 20 28 70 57 49 6e 66 6f 2d 3e ssert( (pWInfo->
1a440 77 63 74 72 6c 46 6c 61 67 73 20 26 20 57 48 45 wctrlFlags & WHE
1a450 52 45 5f 4f 4e 45 50 41 53 53 5f 44 45 53 49 52 RE_ONEPASS_DESIR
1a460 45 44 29 3d 3d 30 20 7c 7c 20 62 3d 3d 30 20 29 ED)==0 || b==0 )
1a470 3b 0a 20 20 20 20 69 66 28 20 70 50 72 6f 62 65 ;. if( pProbe
1a480 2d 3e 74 6e 75 6d 3c 3d 30 20 29 7b 0a 20 20 20 ->tnum<=0 ){.
1a490 20 20 20 2f 2a 20 49 6e 74 65 67 65 72 20 70 72 /* Integer pr
1a4a0 69 6d 61 72 79 20 6b 65 79 20 69 6e 64 65 78 20 imary key index
1a4b0 2a 2f 0a 20 20 20 20 20 20 70 4e 65 77 2d 3e 77 */. pNew->w
1a4c0 73 46 6c 61 67 73 20 3d 20 57 48 45 52 45 5f 49 sFlags = WHERE_I
1a4d0 50 4b 3b 0a 0a 20 20 20 20 20 20 2f 2a 20 46 75 PK;.. /* Fu
1a4e0 6c 6c 20 74 61 62 6c 65 20 73 63 61 6e 20 2a 2f ll table scan */
1a4f0 0a 20 20 20 20 20 20 70 4e 65 77 2d 3e 69 53 6f . pNew->iSo
1a500 72 74 49 64 78 20 3d 20 62 20 3f 20 69 53 6f 72 rtIdx = b ? iSor
1a510 74 49 64 78 20 3a 20 30 3b 0a 20 20 20 20 20 20 tIdx : 0;.
1a520 2f 2a 20 54 55 4e 49 4e 47 3a 20 43 6f 73 74 20 /* TUNING: Cost
1a530 6f 66 20 66 75 6c 6c 20 74 61 62 6c 65 20 73 63 of full table sc
1a540 61 6e 20 69 73 20 28 4e 2a 33 2e 30 29 2e 20 2a an is (N*3.0). *
1a550 2f 0a 20 20 20 20 20 20 70 4e 65 77 2d 3e 72 52 /. pNew->rR
1a560 75 6e 20 3d 20 72 53 69 7a 65 20 2b 20 31 36 3b un = rSize + 16;
1a570 0a 20 20 20 20 20 20 41 70 70 6c 79 43 6f 73 74 . ApplyCost
1a580 4d 75 6c 74 69 70 6c 69 65 72 28 70 4e 65 77 2d Multiplier(pNew-
1a590 3e 72 52 75 6e 2c 20 70 54 61 62 2d 3e 63 6f 73 >rRun, pTab->cos
1a5a0 74 4d 75 6c 74 29 3b 0a 20 20 20 20 20 20 77 68 tMult);. wh
1a5b0 65 72 65 4c 6f 6f 70 4f 75 74 70 75 74 41 64 6a ereLoopOutputAdj
1a5c0 75 73 74 28 70 57 43 2c 20 70 4e 65 77 2c 20 72 ust(pWC, pNew, r
1a5d0 53 69 7a 65 29 3b 0a 20 20 20 20 20 20 72 63 20 Size);. rc
1a5e0 3d 20 77 68 65 72 65 4c 6f 6f 70 49 6e 73 65 72 = whereLoopInser
1a5f0 74 28 70 42 75 69 6c 64 65 72 2c 20 70 4e 65 77 t(pBuilder, pNew
1a600 29 3b 0a 20 20 20 20 20 20 70 4e 65 77 2d 3e 6e );. pNew->n
1a610 4f 75 74 20 3d 20 72 53 69 7a 65 3b 0a 20 20 20 Out = rSize;.
1a620 20 20 20 69 66 28 20 72 63 20 29 20 62 72 65 61 if( rc ) brea
1a630 6b 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 k;. }else{.
1a640 20 20 20 20 42 69 74 6d 61 73 6b 20 6d 3b 0a 20 Bitmask m;.
1a650 20 20 20 20 20 69 66 28 20 70 50 72 6f 62 65 2d if( pProbe-
1a660 3e 69 73 43 6f 76 65 72 69 6e 67 20 29 7b 0a 20 >isCovering ){.
1a670 20 20 20 20 20 20 20 70 4e 65 77 2d 3e 77 73 46 pNew->wsF
1a680 6c 61 67 73 20 3d 20 57 48 45 52 45 5f 49 44 58 lags = WHERE_IDX
1a690 5f 4f 4e 4c 59 20 7c 20 57 48 45 52 45 5f 49 4e _ONLY | WHERE_IN
1a6a0 44 45 58 45 44 3b 0a 20 20 20 20 20 20 20 20 6d DEXED;. m
1a6b0 20 3d 20 30 3b 0a 20 20 20 20 20 20 7d 65 6c 73 = 0;. }els
1a6c0 65 7b 0a 20 20 20 20 20 20 20 20 6d 20 3d 20 70 e{. m = p
1a6d0 53 72 63 2d 3e 63 6f 6c 55 73 65 64 20 26 20 7e Src->colUsed & ~
1a6e0 63 6f 6c 75 6d 6e 73 49 6e 49 6e 64 65 78 28 70 columnsInIndex(p
1a6f0 50 72 6f 62 65 29 3b 0a 20 20 20 20 20 20 20 20 Probe);.
1a700 70 4e 65 77 2d 3e 77 73 46 6c 61 67 73 20 3d 20 pNew->wsFlags =
1a710 28 6d 3d 3d 30 29 20 3f 20 28 57 48 45 52 45 5f (m==0) ? (WHERE_
1a720 49 44 58 5f 4f 4e 4c 59 7c 57 48 45 52 45 5f 49 IDX_ONLY|WHERE_I
1a730 4e 44 45 58 45 44 29 20 3a 20 57 48 45 52 45 5f NDEXED) : WHERE_
1a740 49 4e 44 45 58 45 44 3b 0a 20 20 20 20 20 20 7d INDEXED;. }
1a750 0a 0a 20 20 20 20 20 20 2f 2a 20 46 75 6c 6c 20 .. /* Full
1a760 73 63 61 6e 20 76 69 61 20 69 6e 64 65 78 20 2a scan via index *
1a770 2f 0a 20 20 20 20 20 20 69 66 28 20 62 0a 20 20 /. if( b.
1a780 20 20 20 20 20 7c 7c 20 21 48 61 73 52 6f 77 69 || !HasRowi
1a790 64 28 70 54 61 62 29 0a 20 20 20 20 20 20 20 7c d(pTab). |
1a7a0 7c 20 70 50 72 6f 62 65 2d 3e 70 50 61 72 74 49 | pProbe->pPartI
1a7b0 64 78 57 68 65 72 65 21 3d 30 0a 20 20 20 20 20 dxWhere!=0.
1a7c0 20 20 7c 7c 20 28 20 6d 3d 3d 30 0a 20 20 20 20 || ( m==0.
1a7d0 20 20 20 20 20 26 26 20 70 50 72 6f 62 65 2d 3e && pProbe->
1a7e0 62 55 6e 6f 72 64 65 72 65 64 3d 3d 30 0a 20 20 bUnordered==0.
1a7f0 20 20 20 20 20 20 20 26 26 20 28 70 50 72 6f 62 && (pProb
1a800 65 2d 3e 73 7a 49 64 78 52 6f 77 3c 70 54 61 62 e->szIdxRow<pTab
1a810 2d 3e 73 7a 54 61 62 52 6f 77 29 0a 20 20 20 20 ->szTabRow).
1a820 20 20 20 20 20 26 26 20 28 70 57 49 6e 66 6f 2d && (pWInfo-
1a830 3e 77 63 74 72 6c 46 6c 61 67 73 20 26 20 57 48 >wctrlFlags & WH
1a840 45 52 45 5f 4f 4e 45 50 41 53 53 5f 44 45 53 49 ERE_ONEPASS_DESI
1a850 52 45 44 29 3d 3d 30 0a 20 20 20 20 20 20 20 20 RED)==0.
1a860 20 26 26 20 73 71 6c 69 74 65 33 47 6c 6f 62 61 && sqlite3Globa
1a870 6c 43 6f 6e 66 69 67 2e 62 55 73 65 43 69 73 0a lConfig.bUseCis.
1a880 20 20 20 20 20 20 20 20 20 26 26 20 4f 70 74 69 && Opti
1a890 6d 69 7a 61 74 69 6f 6e 45 6e 61 62 6c 65 64 28 mizationEnabled(
1a8a0 70 57 49 6e 66 6f 2d 3e 70 50 61 72 73 65 2d 3e pWInfo->pParse->
1a8b0 64 62 2c 20 53 51 4c 49 54 45 5f 43 6f 76 65 72 db, SQLITE_Cover
1a8c0 49 64 78 53 63 61 6e 29 0a 20 20 20 20 20 20 20 IdxScan).
1a8d0 20 20 20 29 0a 20 20 20 20 20 20 29 7b 0a 20 20 ). ){.
1a8e0 20 20 20 20 20 20 70 4e 65 77 2d 3e 69 53 6f 72 pNew->iSor
1a8f0 74 49 64 78 20 3d 20 62 20 3f 20 69 53 6f 72 74 tIdx = b ? iSort
1a900 49 64 78 20 3a 20 30 3b 0a 0a 20 20 20 20 20 20 Idx : 0;..
1a910 20 20 2f 2a 20 54 68 65 20 63 6f 73 74 20 6f 66 /* The cost of
1a920 20 76 69 73 69 74 69 6e 67 20 74 68 65 20 69 6e visiting the in
1a930 64 65 78 20 72 6f 77 73 20 69 73 20 4e 2a 4b 2c dex rows is N*K,
1a940 20 77 68 65 72 65 20 4b 20 69 73 0a 20 20 20 20 where K is.
1a950 20 20 20 20 2a 2a 20 62 65 74 77 65 65 6e 20 31 ** between 1
1a960 2e 31 20 61 6e 64 20 33 2e 30 2c 20 64 65 70 65 .1 and 3.0, depe
1a970 6e 64 69 6e 67 20 6f 6e 20 74 68 65 20 72 65 6c nding on the rel
1a980 61 74 69 76 65 20 73 69 7a 65 73 20 6f 66 20 74 ative sizes of t
1a990 68 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 69 6e he. ** in
1a9a0 64 65 78 20 61 6e 64 20 74 61 62 6c 65 20 72 6f dex and table ro
1a9b0 77 73 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 70 ws. */. p
1a9c0 4e 65 77 2d 3e 72 52 75 6e 20 3d 20 72 53 69 7a New->rRun = rSiz
1a9d0 65 20 2b 20 31 20 2b 20 28 31 35 2a 70 50 72 6f e + 1 + (15*pPro
1a9e0 62 65 2d 3e 73 7a 49 64 78 52 6f 77 29 2f 70 54 be->szIdxRow)/pT
1a9f0 61 62 2d 3e 73 7a 54 61 62 52 6f 77 3b 0a 20 20 ab->szTabRow;.
1aa00 20 20 20 20 20 20 69 66 28 20 6d 21 3d 30 20 29 if( m!=0 )
1aa10 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 {. /* I
1aa20 66 20 74 68 69 73 20 69 73 20 61 20 6e 6f 6e 2d f this is a non-
1aa30 63 6f 76 65 72 69 6e 67 20 69 6e 64 65 78 20 73 covering index s
1aa40 63 61 6e 2c 20 61 64 64 20 69 6e 20 74 68 65 20 can, add in the
1aa50 63 6f 73 74 20 6f 66 0a 20 20 20 20 20 20 20 20 cost of.
1aa60 20 20 2a 2a 20 64 6f 69 6e 67 20 74 61 62 6c 65 ** doing table
1aa70 20 6c 6f 6f 6b 75 70 73 2e 20 20 54 68 65 20 63 lookups. The c
1aa80 6f 73 74 20 77 69 6c 6c 20 62 65 20 33 78 20 74 ost will be 3x t
1aa90 68 65 20 6e 75 6d 62 65 72 20 6f 66 0a 20 20 20 he number of.
1aaa0 20 20 20 20 20 20 20 2a 2a 20 6c 6f 6f 6b 75 70 ** lookup
1aab0 73 2e 20 20 54 61 6b 65 20 69 6e 74 6f 20 61 63 s. Take into ac
1aac0 63 6f 75 6e 74 20 57 48 45 52 45 20 63 6c 61 75 count WHERE clau
1aad0 73 65 20 74 65 72 6d 73 20 74 68 61 74 20 63 61 se terms that ca
1aae0 6e 20 62 65 0a 20 20 20 20 20 20 20 20 20 20 2a n be. *
1aaf0 2a 20 73 61 74 69 73 66 69 65 64 20 75 73 69 6e * satisfied usin
1ab00 67 20 6a 75 73 74 20 74 68 65 20 69 6e 64 65 78 g just the index
1ab10 2c 20 61 6e 64 20 74 68 61 74 20 64 6f 20 6e 6f , and that do no
1ab20 74 20 72 65 71 75 69 72 65 20 61 0a 20 20 20 20 t require a.
1ab30 20 20 20 20 20 20 2a 2a 20 74 61 62 6c 65 20 6c ** table l
1ab40 6f 6f 6b 75 70 2e 20 2a 2f 0a 20 20 20 20 20 20 ookup. */.
1ab50 20 20 20 20 4c 6f 67 45 73 74 20 6e 4c 6f 6f 6b LogEst nLook
1ab60 75 70 20 3d 20 72 53 69 7a 65 20 2b 20 31 36 3b up = rSize + 16;
1ab70 20 20 2f 2a 20 42 61 73 65 20 63 6f 73 74 3a 20 /* Base cost:
1ab80 20 4e 2a 33 20 2a 2f 0a 20 20 20 20 20 20 20 20 N*3 */.
1ab90 20 20 69 6e 74 20 69 69 3b 0a 20 20 20 20 20 20 int ii;.
1aba0 20 20 20 20 69 6e 74 20 69 43 75 72 20 3d 20 70 int iCur = p
1abb0 53 72 63 2d 3e 69 43 75 72 73 6f 72 3b 0a 20 20 Src->iCursor;.
1abc0 20 20 20 20 20 20 20 20 57 68 65 72 65 43 6c 61 WhereCla
1abd0 75 73 65 20 2a 70 57 43 32 20 3d 20 26 70 57 49 use *pWC2 = &pWI
1abe0 6e 66 6f 2d 3e 73 57 43 3b 0a 20 20 20 20 20 20 nfo->sWC;.
1abf0 20 20 20 20 66 6f 72 28 69 69 3d 30 3b 20 69 69 for(ii=0; ii
1ac00 3c 70 57 43 32 2d 3e 6e 54 65 72 6d 3b 20 69 69 <pWC2->nTerm; ii
1ac10 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 ++){.
1ac20 20 57 68 65 72 65 54 65 72 6d 20 2a 70 54 65 72 WhereTerm *pTer
1ac30 6d 20 3d 20 26 70 57 43 32 2d 3e 61 5b 69 69 5d m = &pWC2->a[ii]
1ac40 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 ;. if
1ac50 28 20 21 73 71 6c 69 74 65 33 45 78 70 72 43 6f ( !sqlite3ExprCo
1ac60 76 65 72 65 64 42 79 49 6e 64 65 78 28 70 54 65 veredByIndex(pTe
1ac70 72 6d 2d 3e 70 45 78 70 72 2c 20 69 43 75 72 2c rm->pExpr, iCur,
1ac80 20 70 50 72 6f 62 65 29 20 29 7b 0a 20 20 20 20 pProbe) ){.
1ac90 20 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b break;
1aca0 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 . }.
1acb0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 70 54 /* pT
1acc0 65 72 6d 20 63 61 6e 20 62 65 20 65 76 61 6c 75 erm can be evalu
1acd0 61 74 65 64 20 75 73 69 6e 67 20 6a 75 73 74 20 ated using just
1ace0 74 68 65 20 69 6e 64 65 78 2e 20 20 53 6f 20 72 the index. So r
1acf0 65 64 75 63 65 0a 20 20 20 20 20 20 20 20 20 20 educe.
1ad00 20 20 2a 2a 20 74 68 65 20 65 78 70 65 63 74 65 ** the expecte
1ad10 64 20 6e 75 6d 62 65 72 20 6f 66 20 74 61 62 6c d number of tabl
1ad20 65 20 6c 6f 6f 6b 75 70 73 20 61 63 63 6f 72 64 e lookups accord
1ad30 69 6e 67 6c 79 20 2a 2f 0a 20 20 20 20 20 20 20 ingly */.
1ad40 20 20 20 20 20 69 66 28 20 70 54 65 72 6d 2d 3e if( pTerm->
1ad50 74 72 75 74 68 50 72 6f 62 3c 3d 30 20 29 7b 0a truthProb<=0 ){.
1ad60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 6e 4c nL
1ad70 6f 6f 6b 75 70 20 2b 3d 20 70 54 65 72 6d 2d 3e ookup += pTerm->
1ad80 74 72 75 74 68 50 72 6f 62 3b 0a 20 20 20 20 20 truthProb;.
1ad90 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
1ada0 20 20 20 20 20 20 20 20 20 20 20 20 6e 4c 6f 6f nLoo
1adb0 6b 75 70 2d 2d 3b 0a 20 20 20 20 20 20 20 20 20 kup--;.
1adc0 20 20 20 20 20 69 66 28 20 70 54 65 72 6d 2d 3e if( pTerm->
1add0 65 4f 70 65 72 61 74 6f 72 20 26 20 28 57 4f 5f eOperator & (WO_
1ade0 45 51 7c 57 4f 5f 49 53 29 20 29 20 6e 4c 6f 6f EQ|WO_IS) ) nLoo
1adf0 6b 75 70 20 2d 3d 20 31 39 3b 0a 20 20 20 20 20 kup -= 19;.
1ae00 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
1ae10 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 0a }. .
1ae20 20 20 20 20 20 20 20 20 20 20 70 4e 65 77 2d 3e pNew->
1ae30 72 52 75 6e 20 3d 20 73 71 6c 69 74 65 33 4c 6f rRun = sqlite3Lo
1ae40 67 45 73 74 41 64 64 28 70 4e 65 77 2d 3e 72 52 gEstAdd(pNew->rR
1ae50 75 6e 2c 20 6e 4c 6f 6f 6b 75 70 29 3b 0a 20 20 un, nLookup);.
1ae60 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 }.
1ae70 41 70 70 6c 79 43 6f 73 74 4d 75 6c 74 69 70 6c ApplyCostMultipl
1ae80 69 65 72 28 70 4e 65 77 2d 3e 72 52 75 6e 2c 20 ier(pNew->rRun,
1ae90 70 54 61 62 2d 3e 63 6f 73 74 4d 75 6c 74 29 3b pTab->costMult);
1aea0 0a 20 20 20 20 20 20 20 20 77 68 65 72 65 4c 6f . whereLo
1aeb0 6f 70 4f 75 74 70 75 74 41 64 6a 75 73 74 28 70 opOutputAdjust(p
1aec0 57 43 2c 20 70 4e 65 77 2c 20 72 53 69 7a 65 29 WC, pNew, rSize)
1aed0 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 77 ;. rc = w
1aee0 68 65 72 65 4c 6f 6f 70 49 6e 73 65 72 74 28 70 hereLoopInsert(p
1aef0 42 75 69 6c 64 65 72 2c 20 70 4e 65 77 29 3b 0a Builder, pNew);.
1af00 20 20 20 20 20 20 20 20 70 4e 65 77 2d 3e 6e 4f pNew->nO
1af10 75 74 20 3d 20 72 53 69 7a 65 3b 0a 20 20 20 20 ut = rSize;.
1af20 20 20 20 20 69 66 28 20 72 63 20 29 20 62 72 65 if( rc ) bre
1af30 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 ak;. }.
1af40 7d 0a 0a 20 20 20 20 70 42 75 69 6c 64 65 72 2d }.. pBuilder-
1af50 3e 62 6c 64 46 6c 61 67 73 20 3d 20 30 3b 0a 20 >bldFlags = 0;.
1af60 20 20 20 72 63 20 3d 20 77 68 65 72 65 4c 6f 6f rc = whereLoo
1af70 70 41 64 64 42 74 72 65 65 49 6e 64 65 78 28 70 pAddBtreeIndex(p
1af80 42 75 69 6c 64 65 72 2c 20 70 53 72 63 2c 20 70 Builder, pSrc, p
1af90 50 72 6f 62 65 2c 20 30 29 3b 0a 20 20 20 20 69 Probe, 0);. i
1afa0 66 28 20 70 42 75 69 6c 64 65 72 2d 3e 62 6c 64 f( pBuilder->bld
1afb0 46 6c 61 67 73 3d 3d 53 51 4c 49 54 45 5f 42 4c Flags==SQLITE_BL
1afc0 44 46 5f 49 4e 44 45 58 45 44 20 29 7b 0a 20 20 DF_INDEXED ){.
1afd0 20 20 20 20 2f 2a 20 49 66 20 61 20 6e 6f 6e 2d /* If a non-
1afe0 75 6e 69 71 75 65 20 69 6e 64 65 78 20 69 73 20 unique index is
1aff0 75 73 65 64 2c 20 6f 72 20 69 66 20 61 20 70 72 used, or if a pr
1b000 65 66 69 78 20 6f 66 20 74 68 65 20 6b 65 79 20 efix of the key
1b010 66 6f 72 0a 20 20 20 20 20 20 2a 2a 20 75 6e 69 for. ** uni
1b020 71 75 65 20 69 6e 64 65 78 20 69 73 20 75 73 65 que index is use
1b030 64 20 28 6d 61 6b 69 6e 67 20 74 68 65 20 69 6e d (making the in
1b040 64 65 78 20 66 75 6e 63 74 69 6f 6e 61 6c 6c 79 dex functionally
1b050 20 6e 6f 6e 2d 75 6e 69 71 75 65 29 0a 20 20 20 non-unique).
1b060 20 20 20 2a 2a 20 74 68 65 6e 20 74 68 65 20 73 ** then the s
1b070 71 6c 69 74 65 5f 73 74 61 74 31 20 64 61 74 61 qlite_stat1 data
1b080 20 62 65 63 6f 6d 65 73 20 69 6d 70 6f 72 74 61 becomes importa
1b090 6e 74 20 66 6f 72 20 73 63 6f 72 69 6e 67 20 74 nt for scoring t
1b0a0 68 65 0a 20 20 20 20 20 20 2a 2a 20 70 6c 61 6e he. ** plan
1b0b0 20 2a 2f 0a 20 20 20 20 20 20 70 54 61 62 2d 3e */. pTab->
1b0c0 74 61 62 46 6c 61 67 73 20 7c 3d 20 54 46 5f 53 tabFlags |= TF_S
1b0d0 74 61 74 73 55 73 65 64 3b 0a 20 20 20 20 7d 0a tatsUsed;. }.
1b0e0 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
1b0f0 41 42 4c 45 5f 53 54 41 54 33 5f 4f 52 5f 53 54 ABLE_STAT3_OR_ST
1b100 41 54 34 0a 20 20 20 20 73 71 6c 69 74 65 33 53 AT4. sqlite3S
1b110 74 61 74 34 50 72 6f 62 65 46 72 65 65 28 70 42 tat4ProbeFree(pB
1b120 75 69 6c 64 65 72 2d 3e 70 52 65 63 29 3b 0a 20 uilder->pRec);.
1b130 20 20 20 70 42 75 69 6c 64 65 72 2d 3e 6e 52 65 pBuilder->nRe
1b140 63 56 61 6c 69 64 20 3d 20 30 3b 0a 20 20 20 20 cValid = 0;.
1b150 70 42 75 69 6c 64 65 72 2d 3e 70 52 65 63 20 3d pBuilder->pRec =
1b160 20 30 3b 0a 23 65 6e 64 69 66 0a 20 20 7d 0a 20 0;.#endif. }.
1b170 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 return rc;.}..#
1b180 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
1b190 49 54 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 0a IT_VIRTUALTABLE.
1b1a0 0a 2f 2a 0a 2a 2a 20 41 72 67 75 6d 65 6e 74 20 ./*.** Argument
1b1b0 70 49 64 78 49 6e 66 6f 20 69 73 20 61 6c 72 65 pIdxInfo is alre
1b1c0 61 64 79 20 70 6f 70 75 6c 61 74 65 64 20 77 69 ady populated wi
1b1d0 74 68 20 61 6c 6c 20 63 6f 6e 73 74 72 61 69 6e th all constrain
1b1e0 74 73 20 74 68 61 74 20 6d 61 79 0a 2a 2a 20 62 ts that may.** b
1b1f0 65 20 75 73 65 64 20 62 79 20 74 68 65 20 76 69 e used by the vi
1b200 72 74 75 61 6c 20 74 61 62 6c 65 20 69 64 65 6e rtual table iden
1b210 74 69 66 69 65 64 20 62 79 20 70 42 75 69 6c 64 tified by pBuild
1b220 65 72 2d 3e 70 4e 65 77 2d 3e 69 54 61 62 2e 20 er->pNew->iTab.
1b230 54 68 69 73 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e This.** function
1b240 20 6d 61 72 6b 73 20 61 20 73 75 62 73 65 74 20 marks a subset
1b250 6f 66 20 74 68 6f 73 65 20 63 6f 6e 73 74 72 61 of those constra
1b260 69 6e 74 73 20 75 73 61 62 6c 65 2c 20 69 6e 76 ints usable, inv
1b270 6f 6b 65 73 20 74 68 65 0a 2a 2a 20 78 42 65 73 okes the.** xBes
1b280 74 49 6e 64 65 78 20 6d 65 74 68 6f 64 20 61 6e tIndex method an
1b290 64 20 61 64 64 73 20 74 68 65 20 72 65 74 75 72 d adds the retur
1b2a0 6e 65 64 20 70 6c 61 6e 20 74 6f 20 70 42 75 69 ned plan to pBui
1b2b0 6c 64 65 72 2e 0a 2a 2a 0a 2a 2a 20 41 20 63 6f lder..**.** A co
1b2c0 6e 73 74 72 61 69 6e 74 20 69 73 20 6d 61 72 6b nstraint is mark
1b2d0 65 64 20 75 73 61 62 6c 65 20 69 66 3a 0a 2a 2a ed usable if:.**
1b2e0 0a 2a 2a 20 20 20 2a 20 41 72 67 75 6d 65 6e 74 .** * Argument
1b2f0 20 6d 55 73 61 62 6c 65 20 69 6e 64 69 63 61 74 mUsable indicat
1b300 65 73 20 74 68 61 74 20 69 74 73 20 70 72 65 72 es that its prer
1b310 65 71 75 69 73 69 74 65 73 20 61 72 65 20 61 76 equisites are av
1b320 61 69 6c 61 62 6c 65 2c 20 61 6e 64 0a 2a 2a 0a ailable, and.**.
1b330 2a 2a 20 20 20 2a 20 49 74 20 69 73 20 6e 6f 74 ** * It is not
1b340 20 6f 6e 65 20 6f 66 20 74 68 65 20 6f 70 65 72 one of the oper
1b350 61 74 6f 72 73 20 73 70 65 63 69 66 69 65 64 20 ators specified
1b360 69 6e 20 74 68 65 20 6d 45 78 63 6c 75 64 65 20 in the mExclude
1b370 6d 61 73 6b 20 70 61 73 73 65 64 0a 2a 2a 20 20 mask passed.**
1b380 20 20 20 61 73 20 74 68 65 20 66 6f 75 72 74 68 as the fourth
1b390 20 61 72 67 75 6d 65 6e 74 20 28 77 68 69 63 68 argument (which
1b3a0 20 69 6e 20 70 72 61 63 74 69 63 65 20 69 73 20 in practice is
1b3b0 65 69 74 68 65 72 20 57 4f 5f 49 4e 20 6f 72 20 either WO_IN or
1b3c0 30 29 2e 0a 2a 2a 0a 2a 2a 20 41 72 67 75 6d 65 0)..**.** Argume
1b3d0 6e 74 20 6d 50 72 65 72 65 71 20 69 73 20 61 20 nt mPrereq is a
1b3e0 6d 61 73 6b 20 6f 66 20 74 61 62 6c 65 73 20 74 mask of tables t
1b3f0 68 61 74 20 6d 75 73 74 20 62 65 20 73 63 61 6e hat must be scan
1b400 6e 65 64 20 62 65 66 6f 72 65 20 74 68 65 0a 2a ned before the.*
1b410 2a 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 * virtual table
1b420 69 6e 20 71 75 65 73 74 69 6f 6e 2e 20 54 68 65 in question. The
1b430 73 65 20 61 72 65 20 61 64 64 65 64 20 74 6f 20 se are added to
1b440 74 68 65 20 70 6c 61 6e 73 20 70 72 65 72 65 71 the plans prereq
1b450 75 69 73 69 74 65 73 0a 2a 2a 20 62 65 66 6f 72 uisites.** befor
1b460 65 20 69 74 20 69 73 20 61 64 64 65 64 20 74 6f e it is added to
1b470 20 70 42 75 69 6c 64 65 72 2e 0a 2a 2a 0a 2a 2a pBuilder..**.**
1b480 20 4f 75 74 70 75 74 20 70 61 72 61 6d 65 74 65 Output paramete
1b490 72 20 2a 70 62 49 6e 20 69 73 20 73 65 74 20 74 r *pbIn is set t
1b4a0 6f 20 74 72 75 65 20 69 66 20 74 68 65 20 70 6c o true if the pl
1b4b0 61 6e 20 61 64 64 65 64 20 74 6f 20 70 42 75 69 an added to pBui
1b4c0 6c 64 65 72 0a 2a 2a 20 75 73 65 73 20 6f 6e 65 lder.** uses one
1b4d0 20 6f 72 20 6d 6f 72 65 20 57 4f 5f 49 4e 20 74 or more WO_IN t
1b4e0 65 72 6d 73 2c 20 6f 72 20 66 61 6c 73 65 20 6f erms, or false o
1b4f0 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 73 74 61 therwise..*/.sta
1b500 74 69 63 20 69 6e 74 20 77 68 65 72 65 4c 6f 6f tic int whereLoo
1b510 70 41 64 64 56 69 72 74 75 61 6c 4f 6e 65 28 0a pAddVirtualOne(.
1b520 20 20 57 68 65 72 65 4c 6f 6f 70 42 75 69 6c 64 WhereLoopBuild
1b530 65 72 20 2a 70 42 75 69 6c 64 65 72 2c 0a 20 20 er *pBuilder,.
1b540 42 69 74 6d 61 73 6b 20 6d 50 72 65 72 65 71 2c Bitmask mPrereq,
1b550 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b560 2f 2a 20 4d 61 73 6b 20 6f 66 20 74 61 62 6c 65 /* Mask of table
1b570 73 20 74 68 61 74 20 6d 75 73 74 20 62 65 20 75 s that must be u
1b580 73 65 64 2e 20 2a 2f 0a 20 20 42 69 74 6d 61 73 sed. */. Bitmas
1b590 6b 20 6d 55 73 61 62 6c 65 2c 20 20 20 20 20 20 k mUsable,
1b5a0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 /* Mas
1b5b0 6b 20 6f 66 20 75 73 61 62 6c 65 20 74 61 62 6c k of usable tabl
1b5c0 65 73 20 2a 2f 0a 20 20 75 31 36 20 6d 45 78 63 es */. u16 mExc
1b5d0 6c 75 64 65 2c 20 20 20 20 20 20 20 20 20 20 20 lude,
1b5e0 20 20 20 20 20 20 20 20 2f 2a 20 45 78 63 6c 75 /* Exclu
1b5f0 64 65 20 74 65 72 6d 73 20 75 73 69 6e 67 20 74 de terms using t
1b600 68 65 73 65 20 6f 70 65 72 61 74 6f 72 73 20 2a hese operators *
1b610 2f 0a 20 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 /. sqlite3_inde
1b620 78 5f 69 6e 66 6f 20 2a 70 49 64 78 49 6e 66 6f x_info *pIdxInfo
1b630 2c 20 20 20 2f 2a 20 50 6f 70 75 6c 61 74 65 64 , /* Populated
1b640 20 6f 62 6a 65 63 74 20 66 6f 72 20 78 42 65 73 object for xBes
1b650 74 49 6e 64 65 78 20 2a 2f 0a 20 20 75 31 36 20 tIndex */. u16
1b660 6d 4e 6f 4f 6d 69 74 2c 20 20 20 20 20 20 20 20 mNoOmit,
1b670 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 /* D
1b680 6f 20 6e 6f 74 20 6f 6d 69 74 20 74 68 65 73 65 o not omit these
1b690 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 2a 2f 0a constraints */.
1b6a0 20 20 69 6e 74 20 2a 70 62 49 6e 20 20 20 20 20 int *pbIn
1b6b0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1b6c0 20 20 2f 2a 20 4f 55 54 3a 20 54 72 75 65 20 69 /* OUT: True i
1b6d0 66 20 70 6c 61 6e 20 75 73 65 73 20 61 6e 20 49 f plan uses an I
1b6e0 4e 28 2e 2e 2e 29 20 6f 70 20 2a 2f 0a 29 7b 0a N(...) op */.){.
1b6f0 20 20 57 68 65 72 65 43 6c 61 75 73 65 20 2a 70 WhereClause *p
1b700 57 43 20 3d 20 70 42 75 69 6c 64 65 72 2d 3e 70 WC = pBuilder->p
1b710 57 43 3b 0a 20 20 73 74 72 75 63 74 20 73 71 6c WC;. struct sql
1b720 69 74 65 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 74 ite3_index_const
1b730 72 61 69 6e 74 20 2a 70 49 64 78 43 6f 6e 73 3b raint *pIdxCons;
1b740 0a 20 20 73 74 72 75 63 74 20 73 71 6c 69 74 65 . struct sqlite
1b750 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 74 72 61 69 3_index_constrai
1b760 6e 74 5f 75 73 61 67 65 20 2a 70 55 73 61 67 65 nt_usage *pUsage
1b770 20 3d 20 70 49 64 78 49 6e 66 6f 2d 3e 61 43 6f = pIdxInfo->aCo
1b780 6e 73 74 72 61 69 6e 74 55 73 61 67 65 3b 0a 20 nstraintUsage;.
1b790 20 69 6e 74 20 69 3b 0a 20 20 69 6e 74 20 6d 78 int i;. int mx
1b7a0 54 65 72 6d 3b 0a 20 20 69 6e 74 20 72 63 20 3d Term;. int rc =
1b7b0 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 57 68 SQLITE_OK;. Wh
1b7c0 65 72 65 4c 6f 6f 70 20 2a 70 4e 65 77 20 3d 20 ereLoop *pNew =
1b7d0 70 42 75 69 6c 64 65 72 2d 3e 70 4e 65 77 3b 0a pBuilder->pNew;.
1b7e0 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 20 Parse *pParse
1b7f0 3d 20 70 42 75 69 6c 64 65 72 2d 3e 70 57 49 6e = pBuilder->pWIn
1b800 66 6f 2d 3e 70 50 61 72 73 65 3b 0a 20 20 73 74 fo->pParse;. st
1b810 72 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 ruct SrcList_ite
1b820 6d 20 2a 70 53 72 63 20 3d 20 26 70 42 75 69 6c m *pSrc = &pBuil
1b830 64 65 72 2d 3e 70 57 49 6e 66 6f 2d 3e 70 54 61 der->pWInfo->pTa
1b840 62 4c 69 73 74 2d 3e 61 5b 70 4e 65 77 2d 3e 69 bList->a[pNew->i
1b850 54 61 62 5d 3b 0a 20 20 69 6e 74 20 6e 43 6f 6e Tab];. int nCon
1b860 73 74 72 61 69 6e 74 20 3d 20 70 49 64 78 49 6e straint = pIdxIn
1b870 66 6f 2d 3e 6e 43 6f 6e 73 74 72 61 69 6e 74 3b fo->nConstraint;
1b880 0a 0a 20 20 61 73 73 65 72 74 28 20 28 6d 55 73 .. assert( (mUs
1b890 61 62 6c 65 20 26 20 6d 50 72 65 72 65 71 29 3d able & mPrereq)=
1b8a0 3d 6d 50 72 65 72 65 71 20 29 3b 0a 20 20 2a 70 =mPrereq );. *p
1b8b0 62 49 6e 20 3d 20 30 3b 0a 20 20 70 4e 65 77 2d bIn = 0;. pNew-
1b8c0 3e 70 72 65 72 65 71 20 3d 20 6d 50 72 65 72 65 >prereq = mPrere
1b8d0 71 3b 0a 0a 20 20 2f 2a 20 53 65 74 20 74 68 65 q;.. /* Set the
1b8e0 20 75 73 61 62 6c 65 20 66 6c 61 67 20 6f 6e 20 usable flag on
1b8f0 74 68 65 20 73 75 62 73 65 74 20 6f 66 20 63 6f the subset of co
1b900 6e 73 74 72 61 69 6e 74 73 20 69 64 65 6e 74 69 nstraints identi
1b910 66 69 65 64 20 62 79 20 0a 20 20 2a 2a 20 61 72 fied by . ** ar
1b920 67 75 6d 65 6e 74 73 20 6d 55 73 61 62 6c 65 20 guments mUsable
1b930 61 6e 64 20 6d 45 78 63 6c 75 64 65 2e 20 2a 2f and mExclude. */
1b940 0a 20 20 70 49 64 78 43 6f 6e 73 20 3d 20 2a 28 . pIdxCons = *(
1b950 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 69 struct sqlite3_i
1b960 6e 64 65 78 5f 63 6f 6e 73 74 72 61 69 6e 74 2a ndex_constraint*
1b970 2a 29 26 70 49 64 78 49 6e 66 6f 2d 3e 61 43 6f *)&pIdxInfo->aCo
1b980 6e 73 74 72 61 69 6e 74 3b 0a 20 20 66 6f 72 28 nstraint;. for(
1b990 69 3d 30 3b 20 69 3c 6e 43 6f 6e 73 74 72 61 69 i=0; i<nConstrai
1b9a0 6e 74 3b 20 69 2b 2b 2c 20 70 49 64 78 43 6f 6e nt; i++, pIdxCon
1b9b0 73 2b 2b 29 7b 0a 20 20 20 20 57 68 65 72 65 54 s++){. WhereT
1b9c0 65 72 6d 20 2a 70 54 65 72 6d 20 3d 20 26 70 57 erm *pTerm = &pW
1b9d0 43 2d 3e 61 5b 70 49 64 78 43 6f 6e 73 2d 3e 69 C->a[pIdxCons->i
1b9e0 54 65 72 6d 4f 66 66 73 65 74 5d 3b 0a 20 20 20 TermOffset];.
1b9f0 20 70 49 64 78 43 6f 6e 73 2d 3e 75 73 61 62 6c pIdxCons->usabl
1ba00 65 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 28 e = 0;. if( (
1ba10 70 54 65 72 6d 2d 3e 70 72 65 72 65 71 52 69 67 pTerm->prereqRig
1ba20 68 74 20 26 20 6d 55 73 61 62 6c 65 29 3d 3d 70 ht & mUsable)==p
1ba30 54 65 72 6d 2d 3e 70 72 65 72 65 71 52 69 67 68 Term->prereqRigh
1ba40 74 20 0a 20 20 20 20 20 26 26 20 28 70 54 65 72 t . && (pTer
1ba50 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 6d m->eOperator & m
1ba60 45 78 63 6c 75 64 65 29 3d 3d 30 0a 20 20 20 20 Exclude)==0.
1ba70 29 7b 0a 20 20 20 20 20 20 70 49 64 78 43 6f 6e ){. pIdxCon
1ba80 73 2d 3e 75 73 61 62 6c 65 20 3d 20 31 3b 0a 20 s->usable = 1;.
1ba90 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49 }. }.. /* I
1baa0 6e 69 74 69 61 6c 69 7a 65 20 74 68 65 20 6f 75 nitialize the ou
1bab0 74 70 75 74 20 66 69 65 6c 64 73 20 6f 66 20 74 tput fields of t
1bac0 68 65 20 73 71 6c 69 74 65 33 5f 69 6e 64 65 78 he sqlite3_index
1bad0 5f 69 6e 66 6f 20 73 74 72 75 63 74 75 72 65 20 _info structure
1bae0 2a 2f 0a 20 20 6d 65 6d 73 65 74 28 70 55 73 61 */. memset(pUsa
1baf0 67 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 55 ge, 0, sizeof(pU
1bb00 73 61 67 65 5b 30 5d 29 2a 6e 43 6f 6e 73 74 72 sage[0])*nConstr
1bb10 61 69 6e 74 29 3b 0a 20 20 61 73 73 65 72 74 28 aint);. assert(
1bb20 20 70 49 64 78 49 6e 66 6f 2d 3e 6e 65 65 64 54 pIdxInfo->needT
1bb30 6f 46 72 65 65 49 64 78 53 74 72 3d 3d 30 20 29 oFreeIdxStr==0 )
1bb40 3b 0a 20 20 70 49 64 78 49 6e 66 6f 2d 3e 69 64 ;. pIdxInfo->id
1bb50 78 53 74 72 20 3d 20 30 3b 0a 20 20 70 49 64 78 xStr = 0;. pIdx
1bb60 49 6e 66 6f 2d 3e 69 64 78 4e 75 6d 20 3d 20 30 Info->idxNum = 0
1bb70 3b 0a 20 20 70 49 64 78 49 6e 66 6f 2d 3e 6f 72 ;. pIdxInfo->or
1bb80 64 65 72 42 79 43 6f 6e 73 75 6d 65 64 20 3d 20 derByConsumed =
1bb90 30 3b 0a 20 20 70 49 64 78 49 6e 66 6f 2d 3e 65 0;. pIdxInfo->e
1bba0 73 74 69 6d 61 74 65 64 43 6f 73 74 20 3d 20 53 stimatedCost = S
1bbb0 51 4c 49 54 45 5f 42 49 47 5f 44 42 4c 20 2f 20 QLITE_BIG_DBL /
1bbc0 28 64 6f 75 62 6c 65 29 32 3b 0a 20 20 70 49 64 (double)2;. pId
1bbd0 78 49 6e 66 6f 2d 3e 65 73 74 69 6d 61 74 65 64 xInfo->estimated
1bbe0 52 6f 77 73 20 3d 20 32 35 3b 0a 20 20 70 49 64 Rows = 25;. pId
1bbf0 78 49 6e 66 6f 2d 3e 69 64 78 46 6c 61 67 73 20 xInfo->idxFlags
1bc00 3d 20 30 3b 0a 20 20 70 49 64 78 49 6e 66 6f 2d = 0;. pIdxInfo-
1bc10 3e 63 6f 6c 55 73 65 64 20 3d 20 28 73 71 6c 69 >colUsed = (sqli
1bc20 74 65 33 5f 69 6e 74 36 34 29 70 53 72 63 2d 3e te3_int64)pSrc->
1bc30 63 6f 6c 55 73 65 64 3b 0a 0a 20 20 2f 2a 20 49 colUsed;.. /* I
1bc40 6e 76 6f 6b 65 20 74 68 65 20 76 69 72 74 75 61 nvoke the virtua
1bc50 6c 20 74 61 62 6c 65 20 78 42 65 73 74 49 6e 64 l table xBestInd
1bc60 65 78 28 29 20 6d 65 74 68 6f 64 20 2a 2f 0a 20 ex() method */.
1bc70 20 72 63 20 3d 20 76 74 61 62 42 65 73 74 49 6e rc = vtabBestIn
1bc80 64 65 78 28 70 50 61 72 73 65 2c 20 70 53 72 63 dex(pParse, pSrc
1bc90 2d 3e 70 54 61 62 2c 20 70 49 64 78 49 6e 66 6f ->pTab, pIdxInfo
1bca0 29 3b 0a 20 20 69 66 28 20 72 63 20 29 20 72 65 );. if( rc ) re
1bcb0 74 75 72 6e 20 72 63 3b 0a 0a 20 20 6d 78 54 65 turn rc;.. mxTe
1bcc0 72 6d 20 3d 20 2d 31 3b 0a 20 20 61 73 73 65 72 rm = -1;. asser
1bcd0 74 28 20 70 4e 65 77 2d 3e 6e 4c 53 6c 6f 74 3e t( pNew->nLSlot>
1bce0 3d 6e 43 6f 6e 73 74 72 61 69 6e 74 20 29 3b 0a =nConstraint );.
1bcf0 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e 43 6f for(i=0; i<nCo
1bd00 6e 73 74 72 61 69 6e 74 3b 20 69 2b 2b 29 20 70 nstraint; i++) p
1bd10 4e 65 77 2d 3e 61 4c 54 65 72 6d 5b 69 5d 20 3d New->aLTerm[i] =
1bd20 20 30 3b 0a 20 20 70 4e 65 77 2d 3e 75 2e 76 74 0;. pNew->u.vt
1bd30 61 62 2e 6f 6d 69 74 4d 61 73 6b 20 3d 20 30 3b ab.omitMask = 0;
1bd40 0a 20 20 70 49 64 78 43 6f 6e 73 20 3d 20 2a 28 . pIdxCons = *(
1bd50 73 74 72 75 63 74 20 73 71 6c 69 74 65 33 5f 69 struct sqlite3_i
1bd60 6e 64 65 78 5f 63 6f 6e 73 74 72 61 69 6e 74 2a ndex_constraint*
1bd70 2a 29 26 70 49 64 78 49 6e 66 6f 2d 3e 61 43 6f *)&pIdxInfo->aCo
1bd80 6e 73 74 72 61 69 6e 74 3b 0a 20 20 66 6f 72 28 nstraint;. for(
1bd90 69 3d 30 3b 20 69 3c 6e 43 6f 6e 73 74 72 61 69 i=0; i<nConstrai
1bda0 6e 74 3b 20 69 2b 2b 2c 20 70 49 64 78 43 6f 6e nt; i++, pIdxCon
1bdb0 73 2b 2b 29 7b 0a 20 20 20 20 69 6e 74 20 69 54 s++){. int iT
1bdc0 65 72 6d 3b 0a 20 20 20 20 69 66 28 20 28 69 54 erm;. if( (iT
1bdd0 65 72 6d 20 3d 20 70 55 73 61 67 65 5b 69 5d 2e erm = pUsage[i].
1bde0 61 72 67 76 49 6e 64 65 78 20 2d 20 31 29 3e 3d argvIndex - 1)>=
1bdf0 30 20 29 7b 0a 20 20 20 20 20 20 57 68 65 72 65 0 ){. Where
1be00 54 65 72 6d 20 2a 70 54 65 72 6d 3b 0a 20 20 20 Term *pTerm;.
1be10 20 20 20 69 6e 74 20 6a 20 3d 20 70 49 64 78 43 int j = pIdxC
1be20 6f 6e 73 2d 3e 69 54 65 72 6d 4f 66 66 73 65 74 ons->iTermOffset
1be30 3b 0a 20 20 20 20 20 20 69 66 28 20 69 54 65 72 ;. if( iTer
1be40 6d 3e 3d 6e 43 6f 6e 73 74 72 61 69 6e 74 0a 20 m>=nConstraint.
1be50 20 20 20 20 20 20 7c 7c 20 6a 3c 30 0a 20 20 20 || j<0.
1be60 20 20 20 20 7c 7c 20 6a 3e 3d 70 57 43 2d 3e 6e || j>=pWC->n
1be70 54 65 72 6d 0a 20 20 20 20 20 20 20 7c 7c 20 70 Term. || p
1be80 4e 65 77 2d 3e 61 4c 54 65 72 6d 5b 69 54 65 72 New->aLTerm[iTer
1be90 6d 5d 21 3d 30 0a 20 20 20 20 20 20 20 7c 7c 20 m]!=0. ||
1bea0 70 49 64 78 43 6f 6e 73 2d 3e 75 73 61 62 6c 65 pIdxCons->usable
1beb0 3d 3d 30 0a 20 20 20 20 20 20 29 7b 0a 20 20 20 ==0. ){.
1bec0 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f sqlite3Erro
1bed0 72 4d 73 67 28 70 50 61 72 73 65 2c 22 25 73 2e rMsg(pParse,"%s.
1bee0 78 42 65 73 74 49 6e 64 65 78 20 6d 61 6c 66 75 xBestIndex malfu
1bef0 6e 63 74 69 6f 6e 22 2c 70 53 72 63 2d 3e 70 54 nction",pSrc->pT
1bf00 61 62 2d 3e 7a 4e 61 6d 65 29 3b 0a 20 20 20 20 ab->zName);.
1bf10 20 20 20 20 74 65 73 74 63 61 73 65 28 20 70 49 testcase( pI
1bf20 64 78 49 6e 66 6f 2d 3e 6e 65 65 64 54 6f 46 72 dxInfo->needToFr
1bf30 65 65 49 64 78 53 74 72 20 29 3b 0a 20 20 20 20 eeIdxStr );.
1bf40 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
1bf50 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 7d E_ERROR;. }
1bf60 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 . testcase(
1bf70 20 69 54 65 72 6d 3d 3d 6e 43 6f 6e 73 74 72 61 iTerm==nConstra
1bf80 69 6e 74 2d 31 20 29 3b 0a 20 20 20 20 20 20 74 int-1 );. t
1bf90 65 73 74 63 61 73 65 28 20 6a 3d 3d 30 20 29 3b estcase( j==0 );
1bfa0 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 . testcase(
1bfb0 20 6a 3d 3d 70 57 43 2d 3e 6e 54 65 72 6d 2d 31 j==pWC->nTerm-1
1bfc0 20 29 3b 0a 20 20 20 20 20 20 70 54 65 72 6d 20 );. pTerm
1bfd0 3d 20 26 70 57 43 2d 3e 61 5b 6a 5d 3b 0a 20 20 = &pWC->a[j];.
1bfe0 20 20 20 20 70 4e 65 77 2d 3e 70 72 65 72 65 71 pNew->prereq
1bff0 20 7c 3d 20 70 54 65 72 6d 2d 3e 70 72 65 72 65 |= pTerm->prere
1c000 71 52 69 67 68 74 3b 0a 20 20 20 20 20 20 61 73 qRight;. as
1c010 73 65 72 74 28 20 69 54 65 72 6d 3c 70 4e 65 77 sert( iTerm<pNew
1c020 2d 3e 6e 4c 53 6c 6f 74 20 29 3b 0a 20 20 20 20 ->nLSlot );.
1c030 20 20 70 4e 65 77 2d 3e 61 4c 54 65 72 6d 5b 69 pNew->aLTerm[i
1c040 54 65 72 6d 5d 20 3d 20 70 54 65 72 6d 3b 0a 20 Term] = pTerm;.
1c050 20 20 20 20 20 69 66 28 20 69 54 65 72 6d 3e 6d if( iTerm>m
1c060 78 54 65 72 6d 20 29 20 6d 78 54 65 72 6d 20 3d xTerm ) mxTerm =
1c070 20 69 54 65 72 6d 3b 0a 20 20 20 20 20 20 74 65 iTerm;. te
1c080 73 74 63 61 73 65 28 20 69 54 65 72 6d 3d 3d 31 stcase( iTerm==1
1c090 35 20 29 3b 0a 20 20 20 20 20 20 74 65 73 74 63 5 );. testc
1c0a0 61 73 65 28 20 69 54 65 72 6d 3d 3d 31 36 20 29 ase( iTerm==16 )
1c0b0 3b 0a 20 20 20 20 20 20 69 66 28 20 69 54 65 72 ;. if( iTer
1c0c0 6d 3c 31 36 20 26 26 20 70 55 73 61 67 65 5b 69 m<16 && pUsage[i
1c0d0 5d 2e 6f 6d 69 74 20 29 20 70 4e 65 77 2d 3e 75 ].omit ) pNew->u
1c0e0 2e 76 74 61 62 2e 6f 6d 69 74 4d 61 73 6b 20 7c .vtab.omitMask |
1c0f0 3d 20 31 3c 3c 69 54 65 72 6d 3b 0a 20 20 20 20 = 1<<iTerm;.
1c100 20 20 69 66 28 20 28 70 54 65 72 6d 2d 3e 65 4f if( (pTerm->eO
1c110 70 65 72 61 74 6f 72 20 26 20 57 4f 5f 49 4e 29 perator & WO_IN)
1c120 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 2f !=0 ){. /
1c130 2a 20 41 20 76 69 72 74 75 61 6c 20 74 61 62 6c * A virtual tabl
1c140 65 20 74 68 61 74 20 69 73 20 63 6f 6e 73 74 72 e that is constr
1c150 61 69 6e 65 64 20 62 79 20 61 6e 20 49 4e 20 63 ained by an IN c
1c160 6c 61 75 73 65 20 6d 61 79 20 6e 6f 74 0a 20 20 lause may not.
1c170 20 20 20 20 20 20 2a 2a 20 63 6f 6e 73 75 6d 65 ** consume
1c180 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c the ORDER BY cl
1c190 61 75 73 65 20 62 65 63 61 75 73 65 20 28 31 29 ause because (1)
1c1a0 20 74 68 65 20 6f 72 64 65 72 20 6f 66 20 49 4e the order of IN
1c1b0 20 74 65 72 6d 73 0a 20 20 20 20 20 20 20 20 2a terms. *
1c1c0 2a 20 69 73 20 6e 6f 74 20 6e 65 63 65 73 73 61 * is not necessa
1c1d0 72 69 6c 79 20 72 65 6c 61 74 65 64 20 74 6f 20 rily related to
1c1e0 74 68 65 20 6f 72 64 65 72 20 6f 66 20 6f 75 74 the order of out
1c1f0 70 75 74 20 74 65 72 6d 73 20 61 6e 64 0a 20 20 put terms and.
1c200 20 20 20 20 20 20 2a 2a 20 28 32 29 20 4d 75 6c ** (2) Mul
1c210 74 69 70 6c 65 20 6f 75 74 70 75 74 73 20 66 72 tiple outputs fr
1c220 6f 6d 20 61 20 73 69 6e 67 6c 65 20 49 4e 20 76 om a single IN v
1c230 61 6c 75 65 20 77 69 6c 6c 20 6e 6f 74 20 6d 65 alue will not me
1c240 72 67 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 rge. ** t
1c250 6f 67 65 74 68 65 72 2e 20 20 2a 2f 0a 20 20 20 ogether. */.
1c260 20 20 20 20 20 70 49 64 78 49 6e 66 6f 2d 3e 6f pIdxInfo->o
1c270 72 64 65 72 42 79 43 6f 6e 73 75 6d 65 64 20 3d rderByConsumed =
1c280 20 30 3b 0a 20 20 20 20 20 20 20 20 70 49 64 78 0;. pIdx
1c290 49 6e 66 6f 2d 3e 69 64 78 46 6c 61 67 73 20 26 Info->idxFlags &
1c2a0 3d 20 7e 53 51 4c 49 54 45 5f 49 4e 44 45 58 5f = ~SQLITE_INDEX_
1c2b0 53 43 41 4e 5f 55 4e 49 51 55 45 3b 0a 20 20 20 SCAN_UNIQUE;.
1c2c0 20 20 20 20 20 2a 70 62 49 6e 20 3d 20 31 3b 20 *pbIn = 1;
1c2d0 61 73 73 65 72 74 28 20 28 6d 45 78 63 6c 75 64 assert( (mExclud
1c2e0 65 20 26 20 57 4f 5f 49 4e 29 3d 3d 30 20 29 3b e & WO_IN)==0 );
1c2f0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 . }. }.
1c300 20 7d 0a 20 20 70 4e 65 77 2d 3e 75 2e 76 74 61 }. pNew->u.vta
1c310 62 2e 6f 6d 69 74 4d 61 73 6b 20 26 3d 20 7e 6d b.omitMask &= ~m
1c320 4e 6f 4f 6d 69 74 3b 0a 0a 20 20 70 4e 65 77 2d NoOmit;.. pNew-
1c330 3e 6e 4c 54 65 72 6d 20 3d 20 6d 78 54 65 72 6d >nLTerm = mxTerm
1c340 2b 31 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 +1;. for(i=0; i
1c350 3c 3d 6d 78 54 65 72 6d 3b 20 69 2b 2b 29 7b 0a <=mxTerm; i++){.
1c360 20 20 20 20 69 66 28 20 70 4e 65 77 2d 3e 61 4c if( pNew->aL
1c370 54 65 72 6d 5b 69 5d 3d 3d 30 20 29 7b 0a 20 20 Term[i]==0 ){.
1c380 20 20 20 20 2f 2a 20 54 68 65 20 6e 6f 6e 2d 7a /* The non-z
1c390 65 72 6f 20 61 72 67 76 49 64 78 20 76 61 6c 75 ero argvIdx valu
1c3a0 65 73 20 6d 75 73 74 20 62 65 20 63 6f 6e 74 69 es must be conti
1c3b0 67 75 6f 75 73 2e 20 20 52 61 69 73 65 20 61 6e guous. Raise an
1c3c0 0a 20 20 20 20 20 20 2a 2a 20 65 72 72 6f 72 20 . ** error
1c3d0 69 66 20 74 68 65 79 20 61 72 65 20 6e 6f 74 20 if they are not
1c3e0 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 */. sqlite3
1c3f0 45 72 72 6f 72 4d 73 67 28 70 50 61 72 73 65 2c ErrorMsg(pParse,
1c400 22 25 73 2e 78 42 65 73 74 49 6e 64 65 78 20 6d "%s.xBestIndex m
1c410 61 6c 66 75 6e 63 74 69 6f 6e 22 2c 70 53 72 63 alfunction",pSrc
1c420 2d 3e 70 54 61 62 2d 3e 7a 4e 61 6d 65 29 3b 0a ->pTab->zName);.
1c430 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
1c440 70 49 64 78 49 6e 66 6f 2d 3e 6e 65 65 64 54 6f pIdxInfo->needTo
1c450 46 72 65 65 49 64 78 53 74 72 20 29 3b 0a 20 20 FreeIdxStr );.
1c460 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
1c470 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 7d 0a 20 E_ERROR;. }.
1c480 20 7d 0a 20 20 61 73 73 65 72 74 28 20 70 4e 65 }. assert( pNe
1c490 77 2d 3e 6e 4c 54 65 72 6d 3c 3d 70 4e 65 77 2d w->nLTerm<=pNew-
1c4a0 3e 6e 4c 53 6c 6f 74 20 29 3b 0a 20 20 70 4e 65 >nLSlot );. pNe
1c4b0 77 2d 3e 75 2e 76 74 61 62 2e 69 64 78 4e 75 6d w->u.vtab.idxNum
1c4c0 20 3d 20 70 49 64 78 49 6e 66 6f 2d 3e 69 64 78 = pIdxInfo->idx
1c4d0 4e 75 6d 3b 0a 20 20 70 4e 65 77 2d 3e 75 2e 76 Num;. pNew->u.v
1c4e0 74 61 62 2e 6e 65 65 64 46 72 65 65 20 3d 20 70 tab.needFree = p
1c4f0 49 64 78 49 6e 66 6f 2d 3e 6e 65 65 64 54 6f 46 IdxInfo->needToF
1c500 72 65 65 49 64 78 53 74 72 3b 0a 20 20 70 49 64 reeIdxStr;. pId
1c510 78 49 6e 66 6f 2d 3e 6e 65 65 64 54 6f 46 72 65 xInfo->needToFre
1c520 65 49 64 78 53 74 72 20 3d 20 30 3b 0a 20 20 70 eIdxStr = 0;. p
1c530 4e 65 77 2d 3e 75 2e 76 74 61 62 2e 69 64 78 53 New->u.vtab.idxS
1c540 74 72 20 3d 20 70 49 64 78 49 6e 66 6f 2d 3e 69 tr = pIdxInfo->i
1c550 64 78 53 74 72 3b 0a 20 20 70 4e 65 77 2d 3e 75 dxStr;. pNew->u
1c560 2e 76 74 61 62 2e 69 73 4f 72 64 65 72 65 64 20 .vtab.isOrdered
1c570 3d 20 28 69 38 29 28 70 49 64 78 49 6e 66 6f 2d = (i8)(pIdxInfo-
1c580 3e 6f 72 64 65 72 42 79 43 6f 6e 73 75 6d 65 64 >orderByConsumed
1c590 20 3f 0a 20 20 20 20 20 20 70 49 64 78 49 6e 66 ?. pIdxInf
1c5a0 6f 2d 3e 6e 4f 72 64 65 72 42 79 20 3a 20 30 29 o->nOrderBy : 0)
1c5b0 3b 0a 20 20 70 4e 65 77 2d 3e 72 53 65 74 75 70 ;. pNew->rSetup
1c5c0 20 3d 20 30 3b 0a 20 20 70 4e 65 77 2d 3e 72 52 = 0;. pNew->rR
1c5d0 75 6e 20 3d 20 73 71 6c 69 74 65 33 4c 6f 67 45 un = sqlite3LogE
1c5e0 73 74 46 72 6f 6d 44 6f 75 62 6c 65 28 70 49 64 stFromDouble(pId
1c5f0 78 49 6e 66 6f 2d 3e 65 73 74 69 6d 61 74 65 64 xInfo->estimated
1c600 43 6f 73 74 29 3b 0a 20 20 70 4e 65 77 2d 3e 6e Cost);. pNew->n
1c610 4f 75 74 20 3d 20 73 71 6c 69 74 65 33 4c 6f 67 Out = sqlite3Log
1c620 45 73 74 28 70 49 64 78 49 6e 66 6f 2d 3e 65 73 Est(pIdxInfo->es
1c630 74 69 6d 61 74 65 64 52 6f 77 73 29 3b 0a 0a 20 timatedRows);..
1c640 20 2f 2a 20 53 65 74 20 74 68 65 20 57 48 45 52 /* Set the WHER
1c650 45 5f 4f 4e 45 52 4f 57 20 66 6c 61 67 20 69 66 E_ONEROW flag if
1c660 20 74 68 65 20 78 42 65 73 74 49 6e 64 65 78 28 the xBestIndex(
1c670 29 20 6d 65 74 68 6f 64 20 69 6e 64 69 63 61 74 ) method indicat
1c680 65 64 0a 20 20 2a 2a 20 74 68 61 74 20 74 68 65 ed. ** that the
1c690 20 73 63 61 6e 20 77 69 6c 6c 20 76 69 73 69 74 scan will visit
1c6a0 20 61 74 20 6d 6f 73 74 20 6f 6e 65 20 72 6f 77 at most one row
1c6b0 2e 20 43 6c 65 61 72 20 69 74 20 6f 74 68 65 72 . Clear it other
1c6c0 77 69 73 65 2e 20 2a 2f 0a 20 20 69 66 28 20 70 wise. */. if( p
1c6d0 49 64 78 49 6e 66 6f 2d 3e 69 64 78 46 6c 61 67 IdxInfo->idxFlag
1c6e0 73 20 26 20 53 51 4c 49 54 45 5f 49 4e 44 45 58 s & SQLITE_INDEX
1c6f0 5f 53 43 41 4e 5f 55 4e 49 51 55 45 20 29 7b 0a _SCAN_UNIQUE ){.
1c700 20 20 20 20 70 4e 65 77 2d 3e 77 73 46 6c 61 67 pNew->wsFlag
1c710 73 20 7c 3d 20 57 48 45 52 45 5f 4f 4e 45 52 4f s |= WHERE_ONERO
1c720 57 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 W;. }else{.
1c730 70 4e 65 77 2d 3e 77 73 46 6c 61 67 73 20 26 3d pNew->wsFlags &=
1c740 20 7e 57 48 45 52 45 5f 4f 4e 45 52 4f 57 3b 0a ~WHERE_ONEROW;.
1c750 20 20 7d 0a 20 20 72 63 20 3d 20 77 68 65 72 65 }. rc = where
1c760 4c 6f 6f 70 49 6e 73 65 72 74 28 70 42 75 69 6c LoopInsert(pBuil
1c770 64 65 72 2c 20 70 4e 65 77 29 3b 0a 20 20 69 66 der, pNew);. if
1c780 28 20 70 4e 65 77 2d 3e 75 2e 76 74 61 62 2e 6e ( pNew->u.vtab.n
1c790 65 65 64 46 72 65 65 20 29 7b 0a 20 20 20 20 73 eedFree ){. s
1c7a0 71 6c 69 74 65 33 5f 66 72 65 65 28 70 4e 65 77 qlite3_free(pNew
1c7b0 2d 3e 75 2e 76 74 61 62 2e 69 64 78 53 74 72 29 ->u.vtab.idxStr)
1c7c0 3b 0a 20 20 20 20 70 4e 65 77 2d 3e 75 2e 76 74 ;. pNew->u.vt
1c7d0 61 62 2e 6e 65 65 64 46 72 65 65 20 3d 20 30 3b ab.needFree = 0;
1c7e0 0a 20 20 7d 0a 20 20 57 48 45 52 45 54 52 41 43 . }. WHERETRAC
1c7f0 45 28 30 78 66 66 66 66 2c 20 28 22 20 20 62 49 E(0xffff, (" bI
1c800 6e 3d 25 64 20 70 72 65 72 65 71 49 6e 3d 25 30 n=%d prereqIn=%0
1c810 34 6c 6c 78 20 70 72 65 72 65 71 4f 75 74 3d 25 4llx prereqOut=%
1c820 30 34 6c 6c 78 5c 6e 22 2c 0a 20 20 20 20 20 20 04llx\n",.
1c830 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c840 2a 70 62 49 6e 2c 20 28 73 71 6c 69 74 65 33 5f *pbIn, (sqlite3_
1c850 75 69 6e 74 36 34 29 6d 50 72 65 72 65 71 2c 0a uint64)mPrereq,.
1c860 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1c870 20 20 20 20 20 20 28 73 71 6c 69 74 65 33 5f 75 (sqlite3_u
1c880 69 6e 74 36 34 29 28 70 4e 65 77 2d 3e 70 72 65 int64)(pNew->pre
1c890 72 65 71 20 26 20 7e 6d 50 72 65 72 65 71 29 29 req & ~mPrereq))
1c8a0 29 3b 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b );.. return rc;
1c8b0 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 66 20 74 68 69 .}../*.** If thi
1c8c0 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 69 6e s function is in
1c8d0 76 6f 6b 65 64 20 66 72 6f 6d 20 77 69 74 68 69 voked from withi
1c8e0 6e 20 61 6e 20 78 42 65 73 74 49 6e 64 65 78 28 n an xBestIndex(
1c8f0 29 20 63 61 6c 6c 62 61 63 6b 2c 20 69 74 0a 2a ) callback, it.*
1c900 2a 20 72 65 74 75 72 6e 73 20 61 20 70 6f 69 6e * returns a poin
1c910 74 65 72 20 74 6f 20 61 20 62 75 66 66 65 72 20 ter to a buffer
1c920 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20 6e containing the n
1c930 61 6d 65 20 6f 66 20 74 68 65 20 63 6f 6c 6c 61 ame of the colla
1c940 74 69 6f 6e 0a 2a 2a 20 73 65 71 75 65 6e 63 65 tion.** sequence
1c950 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
1c960 20 65 6c 65 6d 65 6e 74 20 69 43 6f 6e 73 20 6f element iCons o
1c970 66 20 74 68 65 20 73 71 6c 69 74 65 33 5f 69 6e f the sqlite3_in
1c980 64 65 78 5f 69 6e 66 6f 2e 61 43 6f 6e 73 74 72 dex_info.aConstr
1c990 61 69 6e 74 0a 2a 2a 20 61 72 72 61 79 2e 20 4f aint.** array. O
1c9a0 72 2c 20 69 66 20 69 43 6f 6e 73 20 69 73 20 6f r, if iCons is o
1c9b0 75 74 20 6f 66 20 72 61 6e 67 65 20 6f 72 20 74 ut of range or t
1c9c0 68 65 72 65 20 69 73 20 6e 6f 20 61 63 74 69 76 here is no activ
1c9d0 65 20 78 42 65 73 74 49 6e 64 65 78 0a 2a 2a 20 e xBestIndex.**
1c9e0 63 61 6c 6c 2c 20 72 65 74 75 72 6e 20 4e 55 4c call, return NUL
1c9f0 4c 2e 0a 2a 2f 0a 63 6f 6e 73 74 20 63 68 61 72 L..*/.const char
1ca00 20 2a 73 71 6c 69 74 65 33 5f 76 74 61 62 5f 63 *sqlite3_vtab_c
1ca10 6f 6c 6c 61 74 69 6f 6e 28 73 71 6c 69 74 65 33 ollation(sqlite3
1ca20 5f 69 6e 64 65 78 5f 69 6e 66 6f 20 2a 70 49 64 _index_info *pId
1ca30 78 49 6e 66 6f 2c 20 69 6e 74 20 69 43 6f 6e 73 xInfo, int iCons
1ca40 29 7b 0a 20 20 48 69 64 64 65 6e 49 6e 64 65 78 ){. HiddenIndex
1ca50 49 6e 66 6f 20 2a 70 48 69 64 64 65 6e 20 3d 20 Info *pHidden =
1ca60 28 48 69 64 64 65 6e 49 6e 64 65 78 49 6e 66 6f (HiddenIndexInfo
1ca70 2a 29 26 70 49 64 78 49 6e 66 6f 5b 31 5d 3b 0a *)&pIdxInfo[1];.
1ca80 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 52 const char *zR
1ca90 65 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 69 43 et = 0;. if( iC
1caa0 6f 6e 73 3e 3d 30 20 26 26 20 69 43 6f 6e 73 3c ons>=0 && iCons<
1cab0 70 49 64 78 49 6e 66 6f 2d 3e 6e 43 6f 6e 73 74 pIdxInfo->nConst
1cac0 72 61 69 6e 74 20 29 7b 0a 20 20 20 20 43 6f 6c raint ){. Col
1cad0 6c 53 65 71 20 2a 70 43 20 3d 20 30 3b 0a 20 20 lSeq *pC = 0;.
1cae0 20 20 69 6e 74 20 69 54 65 72 6d 20 3d 20 70 49 int iTerm = pI
1caf0 64 78 49 6e 66 6f 2d 3e 61 43 6f 6e 73 74 72 61 dxInfo->aConstra
1cb00 69 6e 74 5b 69 43 6f 6e 73 5d 2e 69 54 65 72 6d int[iCons].iTerm
1cb10 4f 66 66 73 65 74 3b 0a 20 20 20 20 45 78 70 72 Offset;. Expr
1cb20 20 2a 70 58 20 3d 20 70 48 69 64 64 65 6e 2d 3e *pX = pHidden->
1cb30 70 57 43 2d 3e 61 5b 69 54 65 72 6d 5d 2e 70 45 pWC->a[iTerm].pE
1cb40 78 70 72 3b 0a 20 20 20 20 69 66 28 20 70 58 2d xpr;. if( pX-
1cb50 3e 70 4c 65 66 74 20 29 7b 0a 20 20 20 20 20 20 >pLeft ){.
1cb60 70 43 20 3d 20 73 71 6c 69 74 65 33 42 69 6e 61 pC = sqlite3Bina
1cb70 72 79 43 6f 6d 70 61 72 65 43 6f 6c 6c 53 65 71 ryCompareCollSeq
1cb80 28 70 48 69 64 64 65 6e 2d 3e 70 50 61 72 73 65 (pHidden->pParse
1cb90 2c 20 70 58 2d 3e 70 4c 65 66 74 2c 20 70 58 2d , pX->pLeft, pX-
1cba0 3e 70 52 69 67 68 74 29 3b 0a 20 20 20 20 7d 0a >pRight);. }.
1cbb0 20 20 20 20 7a 52 65 74 20 3d 20 28 70 43 20 3f zRet = (pC ?
1cbc0 20 70 43 2d 3e 7a 4e 61 6d 65 20 3a 20 22 42 49 pC->zName : "BI
1cbd0 4e 41 52 59 22 29 3b 0a 20 20 7d 0a 20 20 72 65 NARY");. }. re
1cbe0 74 75 72 6e 20 7a 52 65 74 3b 0a 7d 0a 0a 2f 2a turn zRet;.}../*
1cbf0 0a 2a 2a 20 41 64 64 20 61 6c 6c 20 57 68 65 72 .** Add all Wher
1cc00 65 4c 6f 6f 70 20 6f 62 6a 65 63 74 73 20 66 6f eLoop objects fo
1cc10 72 20 61 20 74 61 62 6c 65 20 6f 66 20 74 68 65 r a table of the
1cc20 20 6a 6f 69 6e 20 69 64 65 6e 74 69 66 69 65 64 join identified
1cc30 20 62 79 0a 2a 2a 20 70 42 75 69 6c 64 65 72 2d by.** pBuilder-
1cc40 3e 70 4e 65 77 2d 3e 69 54 61 62 2e 20 20 54 68 >pNew->iTab. Th
1cc50 61 74 20 74 61 62 6c 65 20 69 73 20 67 75 61 72 at table is guar
1cc60 61 6e 74 65 65 64 20 74 6f 20 62 65 20 61 20 76 anteed to be a v
1cc70 69 72 74 75 61 6c 20 74 61 62 6c 65 2e 0a 2a 2a irtual table..**
1cc80 0a 2a 2a 20 49 66 20 74 68 65 72 65 20 61 72 65 .** If there are
1cc90 20 6e 6f 20 4c 45 46 54 20 6f 72 20 43 52 4f 53 no LEFT or CROS
1cca0 53 20 4a 4f 49 4e 20 6a 6f 69 6e 73 20 69 6e 20 S JOIN joins in
1ccb0 74 68 65 20 71 75 65 72 79 2c 20 62 6f 74 68 20 the query, both
1ccc0 6d 50 72 65 72 65 71 20 61 6e 64 0a 2a 2a 20 6d mPrereq and.** m
1ccd0 55 6e 75 73 61 62 6c 65 20 61 72 65 20 73 65 74 Unusable are set
1cce0 20 74 6f 20 30 2e 20 4f 74 68 65 72 77 69 73 65 to 0. Otherwise
1ccf0 2c 20 6d 50 72 65 72 65 71 20 69 73 20 61 20 6d , mPrereq is a m
1cd00 61 73 6b 20 6f 66 20 61 6c 6c 20 46 52 4f 4d 20 ask of all FROM
1cd10 63 6c 61 75 73 65 0a 2a 2a 20 65 6e 74 72 69 65 clause.** entrie
1cd20 73 20 74 68 61 74 20 6f 63 63 75 72 20 62 65 66 s that occur bef
1cd30 6f 72 65 20 74 68 65 20 76 69 72 74 75 61 6c 20 ore the virtual
1cd40 74 61 62 6c 65 20 69 6e 20 74 68 65 20 46 52 4f table in the FRO
1cd50 4d 20 63 6c 61 75 73 65 20 61 6e 64 20 61 72 65 M clause and are
1cd60 0a 2a 2a 20 73 65 70 61 72 61 74 65 64 20 66 72 .** separated fr
1cd70 6f 6d 20 69 74 20 62 79 20 61 74 20 6c 65 61 73 om it by at leas
1cd80 74 20 6f 6e 65 20 4c 45 46 54 20 6f 72 20 43 52 t one LEFT or CR
1cd90 4f 53 53 20 4a 4f 49 4e 2e 20 53 69 6d 69 6c 61 OSS JOIN. Simila
1cda0 72 6c 79 2c 20 74 68 65 0a 2a 2a 20 6d 55 6e 75 rly, the.** mUnu
1cdb0 73 61 62 6c 65 20 6d 61 73 6b 20 63 6f 6e 74 61 sable mask conta
1cdc0 69 6e 73 20 61 6c 6c 20 46 52 4f 4d 20 63 6c 61 ins all FROM cla
1cdd0 75 73 65 20 65 6e 74 72 69 65 73 20 74 68 61 74 use entries that
1cde0 20 6f 63 63 75 72 20 61 66 74 65 72 20 74 68 65 occur after the
1cdf0 0a 2a 2a 20 76 69 72 74 75 61 6c 20 74 61 62 6c .** virtual tabl
1ce00 65 20 61 6e 64 20 61 72 65 20 73 65 70 61 72 61 e and are separa
1ce10 74 65 64 20 66 72 6f 6d 20 69 74 20 62 79 20 61 ted from it by a
1ce20 74 20 6c 65 61 73 74 20 6f 6e 65 20 4c 45 46 54 t least one LEFT
1ce30 20 6f 72 20 0a 2a 2a 20 43 52 4f 53 53 20 4a 4f or .** CROSS JO
1ce40 49 4e 2e 20 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 65 IN. .**.** For e
1ce50 78 61 6d 70 6c 65 2c 20 69 66 20 74 68 65 20 71 xample, if the q
1ce60 75 65 72 79 20 77 65 72 65 3a 0a 2a 2a 0a 2a 2a uery were:.**.**
1ce70 20 20 20 2e 2e 2e 20 46 52 4f 4d 20 74 31 2c 20 ... FROM t1,
1ce80 74 32 20 4c 45 46 54 20 4a 4f 49 4e 20 74 33 2c t2 LEFT JOIN t3,
1ce90 20 74 34 2c 20 76 74 20 43 52 4f 53 53 20 4a 4f t4, vt CROSS JO
1cea0 49 4e 20 74 35 2c 20 74 36 3b 0a 2a 2a 0a 2a 2a IN t5, t6;.**.**
1ceb0 20 74 68 65 6e 20 6d 50 72 65 72 65 71 20 63 6f then mPrereq co
1cec0 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 28 74 31 rresponds to (t1
1ced0 2c 20 74 32 29 20 61 6e 64 20 6d 55 6e 75 73 61 , t2) and mUnusa
1cee0 62 6c 65 20 74 6f 20 28 74 35 2c 20 74 36 29 2e ble to (t5, t6).
1cef0 0a 2a 2a 0a 2a 2a 20 41 6c 6c 20 74 68 65 20 74 .**.** All the t
1cf00 61 62 6c 65 73 20 69 6e 20 6d 50 72 65 72 65 71 ables in mPrereq
1cf10 20 6d 75 73 74 20 62 65 20 73 63 61 6e 6e 65 64 must be scanned
1cf20 20 62 65 66 6f 72 65 20 74 68 65 20 63 75 72 72 before the curr
1cf30 65 6e 74 20 76 69 72 74 75 61 6c 20 0a 2a 2a 20 ent virtual .**
1cf40 74 61 62 6c 65 2e 20 53 6f 20 61 6e 79 20 74 65 table. So any te
1cf50 72 6d 73 20 66 6f 72 20 77 68 69 63 68 20 61 6c rms for which al
1cf60 6c 20 70 72 65 72 65 71 75 69 73 69 74 65 73 20 l prerequisites
1cf70 61 72 65 20 73 61 74 69 73 66 69 65 64 20 62 79 are satisfied by
1cf80 20 0a 2a 2a 20 6d 50 72 65 72 65 71 20 6d 61 79 .** mPrereq may
1cf90 20 62 65 20 73 70 65 63 69 66 69 65 64 20 61 73 be specified as
1cfa0 20 22 75 73 61 62 6c 65 22 20 69 6e 20 61 6c 6c "usable" in all
1cfb0 20 63 61 6c 6c 73 20 74 6f 20 78 42 65 73 74 49 calls to xBestI
1cfc0 6e 64 65 78 2e 20 0a 2a 2a 20 43 6f 6e 76 65 72 ndex. .** Conver
1cfd0 73 65 6c 79 2c 20 61 6c 6c 20 74 61 62 6c 65 73 sely, all tables
1cfe0 20 69 6e 20 6d 55 6e 75 73 61 62 6c 65 20 6d 75 in mUnusable mu
1cff0 73 74 20 62 65 20 73 63 61 6e 6e 65 64 20 61 66 st be scanned af
1d000 74 65 72 20 74 68 65 20 63 75 72 72 65 6e 74 0a ter the current.
1d010 2a 2a 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 ** virtual table
1d020 2c 20 73 6f 20 61 6e 79 20 74 65 72 6d 73 20 66 , so any terms f
1d030 6f 72 20 77 68 69 63 68 20 74 68 65 20 70 72 65 or which the pre
1d040 72 65 71 75 69 73 69 74 65 73 20 6f 76 65 72 6c requisites overl
1d050 61 70 20 77 69 74 68 0a 2a 2a 20 6d 55 6e 75 73 ap with.** mUnus
1d060 61 62 6c 65 20 73 68 6f 75 6c 64 20 61 6c 77 61 able should alwa
1d070 79 73 20 62 65 20 63 6f 6e 66 69 67 75 72 65 64 ys be configured
1d080 20 61 73 20 22 6e 6f 74 2d 75 73 61 62 6c 65 22 as "not-usable"
1d090 20 66 6f 72 20 78 42 65 73 74 49 6e 64 65 78 2e for xBestIndex.
1d0a0 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 77 .*/.static int w
1d0b0 68 65 72 65 4c 6f 6f 70 41 64 64 56 69 72 74 75 hereLoopAddVirtu
1d0c0 61 6c 28 0a 20 20 57 68 65 72 65 4c 6f 6f 70 42 al(. WhereLoopB
1d0d0 75 69 6c 64 65 72 20 2a 70 42 75 69 6c 64 65 72 uilder *pBuilder
1d0e0 2c 20 20 2f 2a 20 57 48 45 52 45 20 63 6c 61 75 , /* WHERE clau
1d0f0 73 65 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 2a se information *
1d100 2f 0a 20 20 42 69 74 6d 61 73 6b 20 6d 50 72 65 /. Bitmask mPre
1d110 72 65 71 2c 20 20 20 20 20 20 20 20 20 20 20 20 req,
1d120 20 2f 2a 20 54 61 62 6c 65 73 20 74 68 61 74 20 /* Tables that
1d130 6d 75 73 74 20 62 65 20 73 63 61 6e 6e 65 64 20 must be scanned
1d140 62 65 66 6f 72 65 20 74 68 69 73 20 6f 6e 65 20 before this one
1d150 2a 2f 0a 20 20 42 69 74 6d 61 73 6b 20 6d 55 6e */. Bitmask mUn
1d160 75 73 61 62 6c 65 20 20 20 20 20 20 20 20 20 20 usable
1d170 20 20 2f 2a 20 54 61 62 6c 65 73 20 74 68 61 74 /* Tables that
1d180 20 6d 75 73 74 20 62 65 20 73 63 61 6e 6e 65 64 must be scanned
1d190 20 61 66 74 65 72 20 74 68 69 73 20 6f 6e 65 20 after this one
1d1a0 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d */.){. int rc =
1d1b0 20 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 SQLITE_OK;
1d1c0 20 20 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 /* Return c
1d1d0 6f 64 65 20 2a 2f 0a 20 20 57 68 65 72 65 49 6e ode */. WhereIn
1d1e0 66 6f 20 2a 70 57 49 6e 66 6f 3b 20 20 20 20 20 fo *pWInfo;
1d1f0 20 20 20 20 20 20 2f 2a 20 57 48 45 52 45 20 61 /* WHERE a
1d200 6e 61 6c 79 73 69 73 20 63 6f 6e 74 65 78 74 20 nalysis context
1d210 2a 2f 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 */. Parse *pPar
1d220 73 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 se;
1d230 20 20 2f 2a 20 54 68 65 20 70 61 72 73 69 6e 67 /* The parsing
1d240 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 57 68 context */. Wh
1d250 65 72 65 43 6c 61 75 73 65 20 2a 70 57 43 3b 20 ereClause *pWC;
1d260 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 68 /* Th
1d270 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 2a e WHERE clause *
1d280 2f 0a 20 20 73 74 72 75 63 74 20 53 72 63 4c 69 /. struct SrcLi
1d290 73 74 5f 69 74 65 6d 20 2a 70 53 72 63 3b 20 20 st_item *pSrc;
1d2a0 20 2f 2a 20 54 68 65 20 46 52 4f 4d 20 63 6c 61 /* The FROM cla
1d2b0 75 73 65 20 74 65 72 6d 20 74 6f 20 73 65 61 72 use term to sear
1d2c0 63 68 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f ch */. sqlite3_
1d2d0 69 6e 64 65 78 5f 69 6e 66 6f 20 2a 70 3b 20 20 index_info *p;
1d2e0 20 20 20 20 20 2f 2a 20 4f 62 6a 65 63 74 20 74 /* Object t
1d2f0 6f 20 70 61 73 73 20 74 6f 20 78 42 65 73 74 49 o pass to xBestI
1d300 6e 64 65 78 28 29 20 2a 2f 0a 20 20 69 6e 74 20 ndex() */. int
1d310 6e 43 6f 6e 73 74 72 61 69 6e 74 3b 20 20 20 20 nConstraint;
1d320 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
1d330 65 72 20 6f 66 20 63 6f 6e 73 74 72 61 69 6e 74 er of constraint
1d340 73 20 69 6e 20 70 20 2a 2f 0a 20 20 69 6e 74 20 s in p */. int
1d350 62 49 6e 3b 20 20 20 20 20 20 20 20 20 20 20 20 bIn;
1d360 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
1d370 20 69 66 20 70 6c 61 6e 20 75 73 65 73 20 49 4e if plan uses IN
1d380 28 2e 2e 2e 29 20 6f 70 65 72 61 74 6f 72 20 2a (...) operator *
1d390 2f 0a 20 20 57 68 65 72 65 4c 6f 6f 70 20 2a 70 /. WhereLoop *p
1d3a0 4e 65 77 3b 0a 20 20 42 69 74 6d 61 73 6b 20 6d New;. Bitmask m
1d3b0 42 65 73 74 3b 20 20 20 20 20 20 20 20 20 20 20 Best;
1d3c0 20 20 20 20 2f 2a 20 54 61 62 6c 65 73 20 75 73 /* Tables us
1d3d0 65 64 20 62 79 20 62 65 73 74 20 70 6f 73 73 69 ed by best possi
1d3e0 62 6c 65 20 70 6c 61 6e 20 2a 2f 0a 20 20 75 31 ble plan */. u1
1d3f0 36 20 6d 4e 6f 4f 6d 69 74 3b 0a 0a 20 20 61 73 6 mNoOmit;.. as
1d400 73 65 72 74 28 20 28 6d 50 72 65 72 65 71 20 26 sert( (mPrereq &
1d410 20 6d 55 6e 75 73 61 62 6c 65 29 3d 3d 30 20 29 mUnusable)==0 )
1d420 3b 0a 20 20 70 57 49 6e 66 6f 20 3d 20 70 42 75 ;. pWInfo = pBu
1d430 69 6c 64 65 72 2d 3e 70 57 49 6e 66 6f 3b 0a 20 ilder->pWInfo;.
1d440 20 70 50 61 72 73 65 20 3d 20 70 57 49 6e 66 6f pParse = pWInfo
1d450 2d 3e 70 50 61 72 73 65 3b 0a 20 20 70 57 43 20 ->pParse;. pWC
1d460 3d 20 70 42 75 69 6c 64 65 72 2d 3e 70 57 43 3b = pBuilder->pWC;
1d470 0a 20 20 70 4e 65 77 20 3d 20 70 42 75 69 6c 64 . pNew = pBuild
1d480 65 72 2d 3e 70 4e 65 77 3b 0a 20 20 70 53 72 63 er->pNew;. pSrc
1d490 20 3d 20 26 70 57 49 6e 66 6f 2d 3e 70 54 61 62 = &pWInfo->pTab
1d4a0 4c 69 73 74 2d 3e 61 5b 70 4e 65 77 2d 3e 69 54 List->a[pNew->iT
1d4b0 61 62 5d 3b 0a 20 20 61 73 73 65 72 74 28 20 49 ab];. assert( I
1d4c0 73 56 69 72 74 75 61 6c 28 70 53 72 63 2d 3e 70 sVirtual(pSrc->p
1d4d0 54 61 62 29 20 29 3b 0a 20 20 70 20 3d 20 61 6c Tab) );. p = al
1d4e0 6c 6f 63 61 74 65 49 6e 64 65 78 49 6e 66 6f 28 locateIndexInfo(
1d4f0 70 50 61 72 73 65 2c 20 70 57 43 2c 20 6d 55 6e pParse, pWC, mUn
1d500 75 73 61 62 6c 65 2c 20 70 53 72 63 2c 20 70 42 usable, pSrc, pB
1d510 75 69 6c 64 65 72 2d 3e 70 4f 72 64 65 72 42 79 uilder->pOrderBy
1d520 2c 20 0a 20 20 20 20 20 20 26 6d 4e 6f 4f 6d 69 , . &mNoOmi
1d530 74 29 3b 0a 20 20 69 66 28 20 70 3d 3d 30 20 29 t);. if( p==0 )
1d540 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e return SQLITE_N
1d550 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 70 4e 65 OMEM_BKPT;. pNe
1d560 77 2d 3e 72 53 65 74 75 70 20 3d 20 30 3b 0a 20 w->rSetup = 0;.
1d570 20 70 4e 65 77 2d 3e 77 73 46 6c 61 67 73 20 3d pNew->wsFlags =
1d580 20 57 48 45 52 45 5f 56 49 52 54 55 41 4c 54 41 WHERE_VIRTUALTA
1d590 42 4c 45 3b 0a 20 20 70 4e 65 77 2d 3e 6e 4c 54 BLE;. pNew->nLT
1d5a0 65 72 6d 20 3d 20 30 3b 0a 20 20 70 4e 65 77 2d erm = 0;. pNew-
1d5b0 3e 75 2e 76 74 61 62 2e 6e 65 65 64 46 72 65 65 >u.vtab.needFree
1d5c0 20 3d 20 30 3b 0a 20 20 6e 43 6f 6e 73 74 72 61 = 0;. nConstra
1d5d0 69 6e 74 20 3d 20 70 2d 3e 6e 43 6f 6e 73 74 72 int = p->nConstr
1d5e0 61 69 6e 74 3b 0a 20 20 69 66 28 20 77 68 65 72 aint;. if( wher
1d5f0 65 4c 6f 6f 70 52 65 73 69 7a 65 28 70 50 61 72 eLoopResize(pPar
1d600 73 65 2d 3e 64 62 2c 20 70 4e 65 77 2c 20 6e 43 se->db, pNew, nC
1d610 6f 6e 73 74 72 61 69 6e 74 29 20 29 7b 0a 20 20 onstraint) ){.
1d620 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
1d630 70 50 61 72 73 65 2d 3e 64 62 2c 20 70 29 3b 0a pParse->db, p);.
1d640 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 return SQLIT
1d650 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 E_NOMEM_BKPT;.
1d660 7d 0a 0a 20 20 2f 2a 20 46 69 72 73 74 20 63 61 }.. /* First ca
1d670 6c 6c 20 78 42 65 73 74 49 6e 64 65 78 28 29 20 ll xBestIndex()
1d680 77 69 74 68 20 61 6c 6c 20 63 6f 6e 73 74 72 61 with all constra
1d690 69 6e 74 73 20 75 73 61 62 6c 65 2e 20 2a 2f 0a ints usable. */.
1d6a0 20 20 57 48 45 52 45 54 52 41 43 45 28 30 78 38 WHERETRACE(0x8
1d6b0 30 30 2c 20 28 22 42 45 47 49 4e 20 25 73 2e 61 00, ("BEGIN %s.a
1d6c0 64 64 56 69 72 74 75 61 6c 28 29 5c 6e 22 2c 20 ddVirtual()\n",
1d6d0 70 53 72 63 2d 3e 70 54 61 62 2d 3e 7a 4e 61 6d pSrc->pTab->zNam
1d6e0 65 29 29 3b 0a 20 20 57 48 45 52 45 54 52 41 43 e));. WHERETRAC
1d6f0 45 28 30 78 34 30 2c 20 28 22 20 20 56 69 72 74 E(0x40, (" Virt
1d700 75 61 6c 4f 6e 65 3a 20 61 6c 6c 20 75 73 61 62 ualOne: all usab
1d710 6c 65 5c 6e 22 29 29 3b 0a 20 20 72 63 20 3d 20 le\n"));. rc =
1d720 77 68 65 72 65 4c 6f 6f 70 41 64 64 56 69 72 74 whereLoopAddVirt
1d730 75 61 6c 4f 6e 65 28 70 42 75 69 6c 64 65 72 2c ualOne(pBuilder,
1d740 20 6d 50 72 65 72 65 71 2c 20 41 4c 4c 42 49 54 mPrereq, ALLBIT
1d750 53 2c 20 30 2c 20 70 2c 20 6d 4e 6f 4f 6d 69 74 S, 0, p, mNoOmit
1d760 2c 20 26 62 49 6e 29 3b 0a 0a 20 20 2f 2a 20 49 , &bIn);.. /* I
1d770 66 20 74 68 65 20 63 61 6c 6c 20 74 6f 20 78 42 f the call to xB
1d780 65 73 74 49 6e 64 65 78 28 29 20 77 69 74 68 20 estIndex() with
1d790 61 6c 6c 20 74 65 72 6d 73 20 65 6e 61 62 6c 65 all terms enable
1d7a0 64 20 70 72 6f 64 75 63 65 64 20 61 20 70 6c 61 d produced a pla
1d7b0 6e 0a 20 20 2a 2a 20 74 68 61 74 20 64 6f 65 73 n. ** that does
1d7c0 20 6e 6f 74 20 72 65 71 75 69 72 65 20 61 6e 79 not require any
1d7d0 20 73 6f 75 72 63 65 20 74 61 62 6c 65 73 20 28 source tables (
1d7e0 49 4f 57 3a 20 61 20 70 6c 61 6e 20 77 69 74 68 IOW: a plan with
1d7f0 20 6d 42 65 73 74 3d 3d 30 29 2c 0a 20 20 2a 2a mBest==0),. **
1d800 20 74 68 65 6e 20 74 68 65 72 65 20 69 73 20 6e then there is n
1d810 6f 20 70 6f 69 6e 74 20 69 6e 20 6d 61 6b 69 6e o point in makin
1d820 67 20 61 6e 79 20 66 75 72 74 68 65 72 20 63 61 g any further ca
1d830 6c 6c 73 20 74 6f 20 78 42 65 73 74 49 6e 64 65 lls to xBestInde
1d840 78 28 29 20 0a 20 20 2a 2a 20 73 69 6e 63 65 20 x() . ** since
1d850 74 68 65 79 20 77 69 6c 6c 20 61 6c 6c 20 72 65 they will all re
1d860 74 75 72 6e 20 74 68 65 20 73 61 6d 65 20 72 65 turn the same re
1d870 73 75 6c 74 20 28 69 66 20 74 68 65 20 78 42 65 sult (if the xBe
1d880 73 74 49 6e 64 65 78 28 29 0a 20 20 2a 2a 20 69 stIndex(). ** i
1d890 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 69 73 mplementation is
1d8a0 20 73 61 6e 65 29 2e 20 2a 2f 0a 20 20 69 66 28 sane). */. if(
1d8b0 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 rc==SQLITE_OK &
1d8c0 26 20 28 6d 42 65 73 74 20 3d 20 28 70 4e 65 77 & (mBest = (pNew
1d8d0 2d 3e 70 72 65 72 65 71 20 26 20 7e 6d 50 72 65 ->prereq & ~mPre
1d8e0 72 65 71 29 29 21 3d 30 20 29 7b 0a 20 20 20 20 req))!=0 ){.
1d8f0 69 6e 74 20 73 65 65 6e 5a 65 72 6f 20 3d 20 30 int seenZero = 0
1d900 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
1d910 20 54 72 75 65 20 69 66 20 61 20 70 6c 61 6e 20 True if a plan
1d920 77 69 74 68 20 6e 6f 20 70 72 65 72 65 71 73 20 with no prereqs
1d930 73 65 65 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 seen */. int
1d940 73 65 65 6e 5a 65 72 6f 4e 6f 49 4e 20 3d 20 30 seenZeroNoIN = 0
1d950 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6c 61 ; /* Pla
1d960 6e 20 77 69 74 68 20 6e 6f 20 70 72 65 72 65 71 n with no prereq
1d970 73 20 61 6e 64 20 6e 6f 20 49 4e 28 2e 2e 2e 29 s and no IN(...)
1d980 20 73 65 65 6e 20 2a 2f 0a 20 20 20 20 42 69 74 seen */. Bit
1d990 6d 61 73 6b 20 6d 50 72 65 76 20 3d 20 30 3b 0a mask mPrev = 0;.
1d9a0 20 20 20 20 42 69 74 6d 61 73 6b 20 6d 42 65 73 Bitmask mBes
1d9b0 74 4e 6f 49 6e 20 3d 20 30 3b 0a 0a 20 20 20 20 tNoIn = 0;..
1d9c0 2f 2a 20 49 66 20 74 68 65 20 70 6c 61 6e 20 70 /* If the plan p
1d9d0 72 6f 64 75 63 65 64 20 62 79 20 74 68 65 20 65 roduced by the e
1d9e0 61 72 6c 69 65 72 20 63 61 6c 6c 20 75 73 65 73 arlier call uses
1d9f0 20 61 6e 20 49 4e 28 2e 2e 2e 29 20 74 65 72 6d an IN(...) term
1da00 2c 20 63 61 6c 6c 0a 20 20 20 20 2a 2a 20 78 42 , call. ** xB
1da10 65 73 74 49 6e 64 65 78 20 61 67 61 69 6e 2c 20 estIndex again,
1da20 74 68 69 73 20 74 69 6d 65 20 77 69 74 68 20 49 this time with I
1da30 4e 28 2e 2e 2e 29 20 74 65 72 6d 73 20 64 69 73 N(...) terms dis
1da40 61 62 6c 65 64 2e 20 2a 2f 0a 20 20 20 20 69 66 abled. */. if
1da50 28 20 62 49 6e 20 29 7b 0a 20 20 20 20 20 20 57 ( bIn ){. W
1da60 48 45 52 45 54 52 41 43 45 28 30 78 34 30 2c 20 HERETRACE(0x40,
1da70 28 22 20 20 56 69 72 74 75 61 6c 4f 6e 65 3a 20 (" VirtualOne:
1da80 61 6c 6c 20 75 73 61 62 6c 65 20 77 2f 6f 20 49 all usable w/o I
1da90 4e 5c 6e 22 29 29 3b 0a 20 20 20 20 20 20 72 63 N\n"));. rc
1daa0 20 3d 20 77 68 65 72 65 4c 6f 6f 70 41 64 64 56 = whereLoopAddV
1dab0 69 72 74 75 61 6c 4f 6e 65 28 0a 20 20 20 20 20 irtualOne(.
1dac0 20 20 20 20 20 70 42 75 69 6c 64 65 72 2c 20 6d pBuilder, m
1dad0 50 72 65 72 65 71 2c 20 41 4c 4c 42 49 54 53 2c Prereq, ALLBITS,
1dae0 20 57 4f 5f 49 4e 2c 20 70 2c 20 6d 4e 6f 4f 6d WO_IN, p, mNoOm
1daf0 69 74 2c 20 26 62 49 6e 29 3b 0a 20 20 20 20 20 it, &bIn);.
1db00 20 61 73 73 65 72 74 28 20 62 49 6e 3d 3d 30 20 assert( bIn==0
1db10 29 3b 0a 20 20 20 20 20 20 6d 42 65 73 74 4e 6f );. mBestNo
1db20 49 6e 20 3d 20 70 4e 65 77 2d 3e 70 72 65 72 65 In = pNew->prere
1db30 71 20 26 20 7e 6d 50 72 65 72 65 71 3b 0a 20 20 q & ~mPrereq;.
1db40 20 20 20 20 69 66 28 20 6d 42 65 73 74 4e 6f 49 if( mBestNoI
1db50 6e 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 n==0 ){.
1db60 73 65 65 6e 5a 65 72 6f 20 3d 20 31 3b 0a 20 20 seenZero = 1;.
1db70 20 20 20 20 20 20 73 65 65 6e 5a 65 72 6f 4e 6f seenZeroNo
1db80 49 4e 20 3d 20 31 3b 0a 20 20 20 20 20 20 7d 0a IN = 1;. }.
1db90 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 43 61 }.. /* Ca
1dba0 6c 6c 20 78 42 65 73 74 49 6e 64 65 78 20 6f 6e ll xBestIndex on
1dbb0 63 65 20 66 6f 72 20 65 61 63 68 20 64 69 73 74 ce for each dist
1dbc0 69 6e 63 74 20 76 61 6c 75 65 20 6f 66 20 28 70 inct value of (p
1dbd0 72 65 72 65 71 52 69 67 68 74 20 26 20 7e 6d 50 rereqRight & ~mP
1dbe0 72 65 72 65 71 29 20 0a 20 20 20 20 2a 2a 20 69 rereq) . ** i
1dbf0 6e 20 74 68 65 20 73 65 74 20 6f 66 20 74 65 72 n the set of ter
1dc00 6d 73 20 74 68 61 74 20 61 70 70 6c 79 20 74 6f ms that apply to
1dc10 20 74 68 65 20 63 75 72 72 65 6e 74 20 76 69 72 the current vir
1dc20 74 75 61 6c 20 74 61 62 6c 65 2e 20 20 2a 2f 0a tual table. */.
1dc30 20 20 20 20 77 68 69 6c 65 28 20 72 63 3d 3d 53 while( rc==S
1dc40 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1dc50 20 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 42 int i;. B
1dc60 69 74 6d 61 73 6b 20 6d 4e 65 78 74 20 3d 20 41 itmask mNext = A
1dc70 4c 4c 42 49 54 53 3b 0a 20 20 20 20 20 20 61 73 LLBITS;. as
1dc80 73 65 72 74 28 20 6d 4e 65 78 74 3e 30 20 29 3b sert( mNext>0 );
1dc90 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 . for(i=0;
1dca0 69 3c 6e 43 6f 6e 73 74 72 61 69 6e 74 3b 20 69 i<nConstraint; i
1dcb0 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 42 69 74 ++){. Bit
1dcc0 6d 61 73 6b 20 6d 54 68 69 73 20 3d 20 28 0a 20 mask mThis = (.
1dcd0 20 20 20 20 20 20 20 20 20 20 20 70 57 43 2d 3e pWC->
1dce0 61 5b 70 2d 3e 61 43 6f 6e 73 74 72 61 69 6e 74 a[p->aConstraint
1dcf0 5b 69 5d 2e 69 54 65 72 6d 4f 66 66 73 65 74 5d [i].iTermOffset]
1dd00 2e 70 72 65 72 65 71 52 69 67 68 74 20 26 20 7e .prereqRight & ~
1dd10 6d 50 72 65 72 65 71 0a 20 20 20 20 20 20 20 20 mPrereq.
1dd20 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 6d );. if( m
1dd30 54 68 69 73 3e 6d 50 72 65 76 20 26 26 20 6d 54 This>mPrev && mT
1dd40 68 69 73 3c 6d 4e 65 78 74 20 29 20 6d 4e 65 78 his<mNext ) mNex
1dd50 74 20 3d 20 6d 54 68 69 73 3b 0a 20 20 20 20 20 t = mThis;.
1dd60 20 7d 0a 20 20 20 20 20 20 6d 50 72 65 76 20 3d }. mPrev =
1dd70 20 6d 4e 65 78 74 3b 0a 20 20 20 20 20 20 69 66 mNext;. if
1dd80 28 20 6d 4e 65 78 74 3d 3d 41 4c 4c 42 49 54 53 ( mNext==ALLBITS
1dd90 20 29 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 ) break;.
1dda0 69 66 28 20 6d 4e 65 78 74 3d 3d 6d 42 65 73 74 if( mNext==mBest
1ddb0 20 7c 7c 20 6d 4e 65 78 74 3d 3d 6d 42 65 73 74 || mNext==mBest
1ddc0 4e 6f 49 6e 20 29 20 63 6f 6e 74 69 6e 75 65 3b NoIn ) continue;
1ddd0 0a 20 20 20 20 20 20 57 48 45 52 45 54 52 41 43 . WHERETRAC
1dde0 45 28 30 78 34 30 2c 20 28 22 20 20 56 69 72 74 E(0x40, (" Virt
1ddf0 75 61 6c 4f 6e 65 3a 20 6d 50 72 65 76 3d 25 30 ualOne: mPrev=%0
1de00 34 6c 6c 78 20 6d 4e 65 78 74 3d 25 30 34 6c 6c 4llx mNext=%04ll
1de10 78 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 x\n",.
1de20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 73 71 (sq
1de30 6c 69 74 65 33 5f 75 69 6e 74 36 34 29 6d 50 72 lite3_uint64)mPr
1de40 65 76 2c 20 28 73 71 6c 69 74 65 33 5f 75 69 6e ev, (sqlite3_uin
1de50 74 36 34 29 6d 4e 65 78 74 29 29 3b 0a 20 20 20 t64)mNext));.
1de60 20 20 20 72 63 20 3d 20 77 68 65 72 65 4c 6f 6f rc = whereLoo
1de70 70 41 64 64 56 69 72 74 75 61 6c 4f 6e 65 28 0a pAddVirtualOne(.
1de80 20 20 20 20 20 20 20 20 20 20 70 42 75 69 6c 64 pBuild
1de90 65 72 2c 20 6d 50 72 65 72 65 71 2c 20 6d 4e 65 er, mPrereq, mNe
1dea0 78 74 7c 6d 50 72 65 72 65 71 2c 20 30 2c 20 70 xt|mPrereq, 0, p
1deb0 2c 20 6d 4e 6f 4f 6d 69 74 2c 20 26 62 49 6e 29 , mNoOmit, &bIn)
1dec0 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4e 65 77 ;. if( pNew
1ded0 2d 3e 70 72 65 72 65 71 3d 3d 6d 50 72 65 72 65 ->prereq==mPrere
1dee0 71 20 29 7b 0a 20 20 20 20 20 20 20 20 73 65 65 q ){. see
1def0 6e 5a 65 72 6f 20 3d 20 31 3b 0a 20 20 20 20 20 nZero = 1;.
1df00 20 20 20 69 66 28 20 62 49 6e 3d 3d 30 20 29 20 if( bIn==0 )
1df10 73 65 65 6e 5a 65 72 6f 4e 6f 49 4e 20 3d 20 31 seenZeroNoIN = 1
1df20 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a ;. }. }.
1df30 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65 20 63 . /* If the c
1df40 61 6c 6c 73 20 74 6f 20 78 42 65 73 74 49 6e 64 alls to xBestInd
1df50 65 78 28 29 20 69 6e 20 74 68 65 20 61 62 6f 76 ex() in the abov
1df60 65 20 6c 6f 6f 70 20 64 69 64 20 6e 6f 74 20 66 e loop did not f
1df70 69 6e 64 20 61 20 70 6c 61 6e 0a 20 20 20 20 2a ind a plan. *
1df80 2a 20 74 68 61 74 20 72 65 71 75 69 72 65 73 20 * that requires
1df90 6e 6f 20 73 6f 75 72 63 65 20 74 61 62 6c 65 73 no source tables
1dfa0 20 61 74 20 61 6c 6c 20 28 69 2e 65 2e 20 6f 6e at all (i.e. on
1dfb0 65 20 67 75 61 72 61 6e 74 65 65 64 20 74 6f 20 e guaranteed to
1dfc0 62 65 0a 20 20 20 20 2a 2a 20 75 73 61 62 6c 65 be. ** usable
1dfd0 29 2c 20 6d 61 6b 65 20 61 20 63 61 6c 6c 20 68 ), make a call h
1dfe0 65 72 65 20 77 69 74 68 20 61 6c 6c 20 73 6f 75 ere with all sou
1dff0 72 63 65 20 74 61 62 6c 65 73 20 64 69 73 61 62 rce tables disab
1e000 6c 65 64 20 2a 2f 0a 20 20 20 20 69 66 28 20 72 led */. if( r
1e010 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
1e020 73 65 65 6e 5a 65 72 6f 3d 3d 30 20 29 7b 0a 20 seenZero==0 ){.
1e030 20 20 20 20 20 57 48 45 52 45 54 52 41 43 45 28 WHERETRACE(
1e040 30 78 34 30 2c 20 28 22 20 20 56 69 72 74 75 61 0x40, (" Virtua
1e050 6c 4f 6e 65 3a 20 61 6c 6c 20 64 69 73 61 62 6c lOne: all disabl
1e060 65 64 5c 6e 22 29 29 3b 0a 20 20 20 20 20 20 72 ed\n"));. r
1e070 63 20 3d 20 77 68 65 72 65 4c 6f 6f 70 41 64 64 c = whereLoopAdd
1e080 56 69 72 74 75 61 6c 4f 6e 65 28 0a 20 20 20 20 VirtualOne(.
1e090 20 20 20 20 20 20 70 42 75 69 6c 64 65 72 2c 20 pBuilder,
1e0a0 6d 50 72 65 72 65 71 2c 20 6d 50 72 65 72 65 71 mPrereq, mPrereq
1e0b0 2c 20 30 2c 20 70 2c 20 6d 4e 6f 4f 6d 69 74 2c , 0, p, mNoOmit,
1e0c0 20 26 62 49 6e 29 3b 0a 20 20 20 20 20 20 69 66 &bIn);. if
1e0d0 28 20 62 49 6e 3d 3d 30 20 29 20 73 65 65 6e 5a ( bIn==0 ) seenZ
1e0e0 65 72 6f 4e 6f 49 4e 20 3d 20 31 3b 0a 20 20 20 eroNoIN = 1;.
1e0f0 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 }.. /* If th
1e100 65 20 63 61 6c 6c 73 20 74 6f 20 78 42 65 73 74 e calls to xBest
1e110 49 6e 64 65 78 28 29 20 68 61 76 65 20 73 6f 20 Index() have so
1e120 66 61 72 20 66 61 69 6c 65 64 20 74 6f 20 66 69 far failed to fi
1e130 6e 64 20 61 20 70 6c 61 6e 0a 20 20 20 20 2a 2a nd a plan. **
1e140 20 74 68 61 74 20 72 65 71 75 69 72 65 73 20 6e that requires n
1e150 6f 20 73 6f 75 72 63 65 20 74 61 62 6c 65 73 20 o source tables
1e160 61 74 20 61 6c 6c 20 61 6e 64 20 64 6f 65 73 20 at all and does
1e170 6e 6f 74 20 75 73 65 20 61 6e 20 49 4e 28 2e 2e not use an IN(..
1e180 2e 29 0a 20 20 20 20 2a 2a 20 6f 70 65 72 61 74 .). ** operat
1e190 6f 72 2c 20 6d 61 6b 65 20 61 20 66 69 6e 61 6c or, make a final
1e1a0 20 63 61 6c 6c 20 74 6f 20 6f 62 74 61 69 6e 20 call to obtain
1e1b0 6f 6e 65 20 68 65 72 65 2e 20 20 2a 2f 0a 20 20 one here. */.
1e1c0 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1e1d0 5f 4f 4b 20 26 26 20 73 65 65 6e 5a 65 72 6f 4e _OK && seenZeroN
1e1e0 6f 49 4e 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 oIN==0 ){.
1e1f0 57 48 45 52 45 54 52 41 43 45 28 30 78 34 30 2c WHERETRACE(0x40,
1e200 20 28 22 20 20 56 69 72 74 75 61 6c 4f 6e 65 3a (" VirtualOne:
1e210 20 61 6c 6c 20 64 69 73 61 62 6c 65 64 20 61 6e all disabled an
1e220 64 20 77 2f 6f 20 49 4e 5c 6e 22 29 29 3b 0a 20 d w/o IN\n"));.
1e230 20 20 20 20 20 72 63 20 3d 20 77 68 65 72 65 4c rc = whereL
1e240 6f 6f 70 41 64 64 56 69 72 74 75 61 6c 4f 6e 65 oopAddVirtualOne
1e250 28 0a 20 20 20 20 20 20 20 20 20 20 70 42 75 69 (. pBui
1e260 6c 64 65 72 2c 20 6d 50 72 65 72 65 71 2c 20 6d lder, mPrereq, m
1e270 50 72 65 72 65 71 2c 20 57 4f 5f 49 4e 2c 20 70 Prereq, WO_IN, p
1e280 2c 20 6d 4e 6f 4f 6d 69 74 2c 20 26 62 49 6e 29 , mNoOmit, &bIn)
1e290 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 69 ;. }. }.. i
1e2a0 66 28 20 70 2d 3e 6e 65 65 64 54 6f 46 72 65 65 f( p->needToFree
1e2b0 49 64 78 53 74 72 20 29 20 73 71 6c 69 74 65 33 IdxStr ) sqlite3
1e2c0 5f 66 72 65 65 28 70 2d 3e 69 64 78 53 74 72 29 _free(p->idxStr)
1e2d0 3b 0a 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 ;. sqlite3DbFre
1e2e0 65 4e 4e 28 70 50 61 72 73 65 2d 3e 64 62 2c 20 eNN(pParse->db,
1e2f0 70 29 3b 0a 20 20 57 48 45 52 45 54 52 41 43 45 p);. WHERETRACE
1e300 28 30 78 38 30 30 2c 20 28 22 45 4e 44 20 25 73 (0x800, ("END %s
1e310 2e 61 64 64 56 69 72 74 75 61 6c 28 29 2c 20 72 .addVirtual(), r
1e320 63 3d 25 64 5c 6e 22 2c 20 70 53 72 63 2d 3e 70 c=%d\n", pSrc->p
1e330 54 61 62 2d 3e 7a 4e 61 6d 65 2c 20 72 63 29 29 Tab->zName, rc))
1e340 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
1e350 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
1e360 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 E_OMIT_VIRTUALTA
1e370 42 4c 45 20 2a 2f 0a 0a 2f 2a 0a 2a 2a 20 41 64 BLE */../*.** Ad
1e380 64 20 57 68 65 72 65 4c 6f 6f 70 20 65 6e 74 72 d WhereLoop entr
1e390 69 65 73 20 74 6f 20 68 61 6e 64 6c 65 20 4f 52 ies to handle OR
1e3a0 20 74 65 72 6d 73 2e 20 20 54 68 69 73 20 77 6f terms. This wo
1e3b0 72 6b 73 20 66 6f 72 20 65 69 74 68 65 72 0a 2a rks for either.*
1e3c0 2a 20 62 74 72 65 65 73 20 6f 72 20 76 69 72 74 * btrees or virt
1e3d0 75 61 6c 20 74 61 62 6c 65 73 2e 0a 2a 2f 0a 73 ual tables..*/.s
1e3e0 74 61 74 69 63 20 69 6e 74 20 77 68 65 72 65 4c tatic int whereL
1e3f0 6f 6f 70 41 64 64 4f 72 28 0a 20 20 57 68 65 72 oopAddOr(. Wher
1e400 65 4c 6f 6f 70 42 75 69 6c 64 65 72 20 2a 70 42 eLoopBuilder *pB
1e410 75 69 6c 64 65 72 2c 20 0a 20 20 42 69 74 6d 61 uilder, . Bitma
1e420 73 6b 20 6d 50 72 65 72 65 71 2c 20 0a 20 20 42 sk mPrereq, . B
1e430 69 74 6d 61 73 6b 20 6d 55 6e 75 73 61 62 6c 65 itmask mUnusable
1e440 0a 29 7b 0a 20 20 57 68 65 72 65 49 6e 66 6f 20 .){. WhereInfo
1e450 2a 70 57 49 6e 66 6f 20 3d 20 70 42 75 69 6c 64 *pWInfo = pBuild
1e460 65 72 2d 3e 70 57 49 6e 66 6f 3b 0a 20 20 57 68 er->pWInfo;. Wh
1e470 65 72 65 43 6c 61 75 73 65 20 2a 70 57 43 3b 0a ereClause *pWC;.
1e480 20 20 57 68 65 72 65 4c 6f 6f 70 20 2a 70 4e 65 WhereLoop *pNe
1e490 77 3b 0a 20 20 57 68 65 72 65 54 65 72 6d 20 2a w;. WhereTerm *
1e4a0 70 54 65 72 6d 2c 20 2a 70 57 43 45 6e 64 3b 0a pTerm, *pWCEnd;.
1e4b0 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
1e4c0 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 69 43 75 72 E_OK;. int iCur
1e4d0 3b 0a 20 20 57 68 65 72 65 43 6c 61 75 73 65 20 ;. WhereClause
1e4e0 74 65 6d 70 57 43 3b 0a 20 20 57 68 65 72 65 4c tempWC;. WhereL
1e4f0 6f 6f 70 42 75 69 6c 64 65 72 20 73 53 75 62 42 oopBuilder sSubB
1e500 75 69 6c 64 3b 0a 20 20 57 68 65 72 65 4f 72 53 uild;. WhereOrS
1e510 65 74 20 73 53 75 6d 2c 20 73 43 75 72 3b 0a 20 et sSum, sCur;.
1e520 20 73 74 72 75 63 74 20 53 72 63 4c 69 73 74 5f struct SrcList_
1e530 69 74 65 6d 20 2a 70 49 74 65 6d 3b 0a 20 20 0a item *pItem;. .
1e540 20 20 70 57 43 20 3d 20 70 42 75 69 6c 64 65 72 pWC = pBuilder
1e550 2d 3e 70 57 43 3b 0a 20 20 70 57 43 45 6e 64 20 ->pWC;. pWCEnd
1e560 3d 20 70 57 43 2d 3e 61 20 2b 20 70 57 43 2d 3e = pWC->a + pWC->
1e570 6e 54 65 72 6d 3b 0a 20 20 70 4e 65 77 20 3d 20 nTerm;. pNew =
1e580 70 42 75 69 6c 64 65 72 2d 3e 70 4e 65 77 3b 0a pBuilder->pNew;.
1e590 20 20 6d 65 6d 73 65 74 28 26 73 53 75 6d 2c 20 memset(&sSum,
1e5a0 30 2c 20 73 69 7a 65 6f 66 28 73 53 75 6d 29 29 0, sizeof(sSum))
1e5b0 3b 0a 20 20 70 49 74 65 6d 20 3d 20 70 57 49 6e ;. pItem = pWIn
1e5c0 66 6f 2d 3e 70 54 61 62 4c 69 73 74 2d 3e 61 20 fo->pTabList->a
1e5d0 2b 20 70 4e 65 77 2d 3e 69 54 61 62 3b 0a 20 20 + pNew->iTab;.
1e5e0 69 43 75 72 20 3d 20 70 49 74 65 6d 2d 3e 69 43 iCur = pItem->iC
1e5f0 75 72 73 6f 72 3b 0a 0a 20 20 66 6f 72 28 70 54 ursor;.. for(pT
1e600 65 72 6d 3d 70 57 43 2d 3e 61 3b 20 70 54 65 72 erm=pWC->a; pTer
1e610 6d 3c 70 57 43 45 6e 64 20 26 26 20 72 63 3d 3d m<pWCEnd && rc==
1e620 53 51 4c 49 54 45 5f 4f 4b 3b 20 70 54 65 72 6d SQLITE_OK; pTerm
1e630 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 28 70 54 ++){. if( (pT
1e640 65 72 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 26 erm->eOperator &
1e650 20 57 4f 5f 4f 52 29 21 3d 30 0a 20 20 20 20 20 WO_OR)!=0.
1e660 26 26 20 28 70 54 65 72 6d 2d 3e 75 2e 70 4f 72 && (pTerm->u.pOr
1e670 49 6e 66 6f 2d 3e 69 6e 64 65 78 61 62 6c 65 20 Info->indexable
1e680 26 20 70 4e 65 77 2d 3e 6d 61 73 6b 53 65 6c 66 & pNew->maskSelf
1e690 29 21 3d 30 20 0a 20 20 20 20 29 7b 0a 20 20 20 )!=0 . ){.
1e6a0 20 20 20 57 68 65 72 65 43 6c 61 75 73 65 20 2a WhereClause *
1e6b0 20 63 6f 6e 73 74 20 70 4f 72 57 43 20 3d 20 26 const pOrWC = &
1e6c0 70 54 65 72 6d 2d 3e 75 2e 70 4f 72 49 6e 66 6f pTerm->u.pOrInfo
1e6d0 2d 3e 77 63 3b 0a 20 20 20 20 20 20 57 68 65 72 ->wc;. Wher
1e6e0 65 54 65 72 6d 20 2a 20 63 6f 6e 73 74 20 70 4f eTerm * const pO
1e6f0 72 57 43 45 6e 64 20 3d 20 26 70 4f 72 57 43 2d rWCEnd = &pOrWC-
1e700 3e 61 5b 70 4f 72 57 43 2d 3e 6e 54 65 72 6d 5d >a[pOrWC->nTerm]
1e710 3b 0a 20 20 20 20 20 20 57 68 65 72 65 54 65 72 ;. WhereTer
1e720 6d 20 2a 70 4f 72 54 65 72 6d 3b 0a 20 20 20 20 m *pOrTerm;.
1e730 20 20 69 6e 74 20 6f 6e 63 65 20 3d 20 31 3b 0a int once = 1;.
1e740 20 20 20 20 20 20 69 6e 74 20 69 2c 20 6a 3b 0a int i, j;.
1e750 20 20 20 20 0a 20 20 20 20 20 20 73 53 75 62 42 . sSubB
1e760 75 69 6c 64 20 3d 20 2a 70 42 75 69 6c 64 65 72 uild = *pBuilder
1e770 3b 0a 20 20 20 20 20 20 73 53 75 62 42 75 69 6c ;. sSubBuil
1e780 64 2e 70 4f 72 64 65 72 42 79 20 3d 20 30 3b 0a d.pOrderBy = 0;.
1e790 20 20 20 20 20 20 73 53 75 62 42 75 69 6c 64 2e sSubBuild.
1e7a0 70 4f 72 53 65 74 20 3d 20 26 73 43 75 72 3b 0a pOrSet = &sCur;.
1e7b0 0a 20 20 20 20 20 20 57 48 45 52 45 54 52 41 43 . WHERETRAC
1e7c0 45 28 30 78 32 30 30 2c 20 28 22 42 65 67 69 6e E(0x200, ("Begin
1e7d0 20 70 72 6f 63 65 73 73 69 6e 67 20 4f 52 2d 63 processing OR-c
1e7e0 6c 61 75 73 65 20 25 70 5c 6e 22 2c 20 70 54 65 lause %p\n", pTe
1e7f0 72 6d 29 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 rm));. for(
1e800 70 4f 72 54 65 72 6d 3d 70 4f 72 57 43 2d 3e 61 pOrTerm=pOrWC->a
1e810 3b 20 70 4f 72 54 65 72 6d 3c 70 4f 72 57 43 45 ; pOrTerm<pOrWCE
1e820 6e 64 3b 20 70 4f 72 54 65 72 6d 2b 2b 29 7b 0a nd; pOrTerm++){.
1e830 20 20 20 20 20 20 20 20 69 66 28 20 28 70 4f 72 if( (pOr
1e840 54 65 72 6d 2d 3e 65 4f 70 65 72 61 74 6f 72 20 Term->eOperator
1e850 26 20 57 4f 5f 41 4e 44 29 21 3d 30 20 29 7b 0a & WO_AND)!=0 ){.
1e860 20 20 20 20 20 20 20 20 20 20 73 53 75 62 42 75 sSubBu
1e870 69 6c 64 2e 70 57 43 20 3d 20 26 70 4f 72 54 65 ild.pWC = &pOrTe
1e880 72 6d 2d 3e 75 2e 70 41 6e 64 49 6e 66 6f 2d 3e rm->u.pAndInfo->
1e890 77 63 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 wc;. }els
1e8a0 65 20 69 66 28 20 70 4f 72 54 65 72 6d 2d 3e 6c e if( pOrTerm->l
1e8b0 65 66 74 43 75 72 73 6f 72 3d 3d 69 43 75 72 20 eftCursor==iCur
1e8c0 29 7b 0a 20 20 20 20 20 20 20 20 20 20 74 65 6d ){. tem
1e8d0 70 57 43 2e 70 57 49 6e 66 6f 20 3d 20 70 57 43 pWC.pWInfo = pWC
1e8e0 2d 3e 70 57 49 6e 66 6f 3b 0a 20 20 20 20 20 20 ->pWInfo;.
1e8f0 20 20 20 20 74 65 6d 70 57 43 2e 70 4f 75 74 65 tempWC.pOute
1e900 72 20 3d 20 70 57 43 3b 0a 20 20 20 20 20 20 20 r = pWC;.
1e910 20 20 20 74 65 6d 70 57 43 2e 6f 70 20 3d 20 54 tempWC.op = T
1e920 4b 5f 41 4e 44 3b 0a 20 20 20 20 20 20 20 20 20 K_AND;.
1e930 20 74 65 6d 70 57 43 2e 6e 54 65 72 6d 20 3d 20 tempWC.nTerm =
1e940 31 3b 0a 20 20 20 20 20 20 20 20 20 20 74 65 6d 1;. tem
1e950 70 57 43 2e 61 20 3d 20 70 4f 72 54 65 72 6d 3b pWC.a = pOrTerm;
1e960 0a 20 20 20 20 20 20 20 20 20 20 73 53 75 62 42 . sSubB
1e970 75 69 6c 64 2e 70 57 43 20 3d 20 26 74 65 6d 70 uild.pWC = &temp
1e980 57 43 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 WC;. }els
1e990 65 7b 0a 20 20 20 20 20 20 20 20 20 20 63 6f 6e e{. con
1e9a0 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 7d tinue;. }
1e9b0 0a 20 20 20 20 20 20 20 20 73 43 75 72 2e 6e 20 . sCur.n
1e9c0 3d 20 30 3b 0a 23 69 66 64 65 66 20 57 48 45 52 = 0;.#ifdef WHER
1e9d0 45 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 0a 20 ETRACE_ENABLED.
1e9e0 20 20 20 20 20 20 20 57 48 45 52 45 54 52 41 43 WHERETRAC
1e9f0 45 28 30 78 32 30 30 2c 20 28 22 4f 52 2d 74 65 E(0x200, ("OR-te
1ea00 72 6d 20 25 64 20 6f 66 20 25 70 20 68 61 73 20 rm %d of %p has
1ea10 25 64 20 73 75 62 74 65 72 6d 73 3a 5c 6e 22 2c %d subterms:\n",
1ea20 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
1ea30 20 20 20 20 20 28 69 6e 74 29 28 70 4f 72 54 65 (int)(pOrTe
1ea40 72 6d 2d 70 4f 72 57 43 2d 3e 61 29 2c 20 70 54 rm-pOrWC->a), pT
1ea50 65 72 6d 2c 20 73 53 75 62 42 75 69 6c 64 2e 70 erm, sSubBuild.p
1ea60 57 43 2d 3e 6e 54 65 72 6d 29 29 3b 0a 20 20 20 WC->nTerm));.
1ea70 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 33 if( sqlite3
1ea80 57 68 65 72 65 54 72 61 63 65 20 26 20 30 78 34 WhereTrace & 0x4
1ea90 30 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 00 ){.
1eaa0 73 71 6c 69 74 65 33 57 68 65 72 65 43 6c 61 75 sqlite3WhereClau
1eab0 73 65 50 72 69 6e 74 28 73 53 75 62 42 75 69 6c sePrint(sSubBuil
1eac0 64 2e 70 57 43 29 3b 0a 20 20 20 20 20 20 20 20 d.pWC);.
1ead0 7d 0a 23 65 6e 64 69 66 0a 23 69 66 6e 64 65 66 }.#endif.#ifndef
1eae0 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 SQLITE_OMIT_VIR
1eaf0 54 55 41 4c 54 41 42 4c 45 0a 20 20 20 20 20 20 TUALTABLE.
1eb00 20 20 69 66 28 20 49 73 56 69 72 74 75 61 6c 28 if( IsVirtual(
1eb10 70 49 74 65 6d 2d 3e 70 54 61 62 29 20 29 7b 0a pItem->pTab) ){.
1eb20 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 77 rc = w
1eb30 68 65 72 65 4c 6f 6f 70 41 64 64 56 69 72 74 75 hereLoopAddVirtu
1eb40 61 6c 28 26 73 53 75 62 42 75 69 6c 64 2c 20 6d al(&sSubBuild, m
1eb50 50 72 65 72 65 71 2c 20 6d 55 6e 75 73 61 62 6c Prereq, mUnusabl
1eb60 65 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 e);. }els
1eb70 65 0a 23 65 6e 64 69 66 0a 20 20 20 20 20 20 20 e.#endif.
1eb80 20 7b 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 {. rc
1eb90 3d 20 77 68 65 72 65 4c 6f 6f 70 41 64 64 42 74 = whereLoopAddBt
1eba0 72 65 65 28 26 73 53 75 62 42 75 69 6c 64 2c 20 ree(&sSubBuild,
1ebb0 6d 50 72 65 72 65 71 29 3b 0a 20 20 20 20 20 20 mPrereq);.
1ebc0 20 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 }. if(
1ebd0 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b rc==SQLITE_OK ){
1ebe0 0a 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 . rc =
1ebf0 77 68 65 72 65 4c 6f 6f 70 41 64 64 4f 72 28 26 whereLoopAddOr(&
1ec00 73 53 75 62 42 75 69 6c 64 2c 20 6d 50 72 65 72 sSubBuild, mPrer
1ec10 65 71 2c 20 6d 55 6e 75 73 61 62 6c 65 29 3b 0a eq, mUnusable);.
1ec20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
1ec30 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 assert( rc==SQ
1ec40 4c 49 54 45 5f 4f 4b 20 7c 7c 20 73 43 75 72 2e LITE_OK || sCur.
1ec50 6e 3d 3d 30 20 29 3b 0a 20 20 20 20 20 20 20 20 n==0 );.
1ec60 69 66 28 20 73 43 75 72 2e 6e 3d 3d 30 20 29 7b if( sCur.n==0 ){
1ec70 0a 20 20 20 20 20 20 20 20 20 20 73 53 75 6d 2e . sSum.
1ec80 6e 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 n = 0;.
1ec90 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 break;.
1eca0 7d 65 6c 73 65 20 69 66 28 20 6f 6e 63 65 20 29 }else if( once )
1ecb0 7b 0a 20 20 20 20 20 20 20 20 20 20 77 68 65 72 {. wher
1ecc0 65 4f 72 4d 6f 76 65 28 26 73 53 75 6d 2c 20 26 eOrMove(&sSum, &
1ecd0 73 43 75 72 29 3b 0a 20 20 20 20 20 20 20 20 20 sCur);.
1ece0 20 6f 6e 63 65 20 3d 20 30 3b 0a 20 20 20 20 20 once = 0;.
1ecf0 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
1ed00 20 20 20 20 57 68 65 72 65 4f 72 53 65 74 20 73 WhereOrSet s
1ed10 50 72 65 76 3b 0a 20 20 20 20 20 20 20 20 20 20 Prev;.
1ed20 77 68 65 72 65 4f 72 4d 6f 76 65 28 26 73 50 72 whereOrMove(&sPr
1ed30 65 76 2c 20 26 73 53 75 6d 29 3b 0a 20 20 20 20 ev, &sSum);.
1ed40 20 20 20 20 20 20 73 53 75 6d 2e 6e 20 3d 20 30 sSum.n = 0
1ed50 3b 0a 20 20 20 20 20 20 20 20 20 20 66 6f 72 28 ;. for(
1ed60 69 3d 30 3b 20 69 3c 73 50 72 65 76 2e 6e 3b 20 i=0; i<sPrev.n;
1ed70 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 i++){.
1ed80 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 73 43 75 for(j=0; j<sCu
1ed90 72 2e 6e 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 20 r.n; j++){.
1eda0 20 20 20 20 20 20 20 20 20 77 68 65 72 65 4f 72 whereOr
1edb0 49 6e 73 65 72 74 28 26 73 53 75 6d 2c 20 73 50 Insert(&sSum, sP
1edc0 72 65 76 2e 61 5b 69 5d 2e 70 72 65 72 65 71 20 rev.a[i].prereq
1edd0 7c 20 73 43 75 72 2e 61 5b 6a 5d 2e 70 72 65 72 | sCur.a[j].prer
1ede0 65 71 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 eq,.
1edf0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1ee00 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 41 64 64 sqlite3LogEstAdd
1ee10 28 73 50 72 65 76 2e 61 5b 69 5d 2e 72 52 75 6e (sPrev.a[i].rRun
1ee20 2c 20 73 43 75 72 2e 61 5b 6a 5d 2e 72 52 75 6e , sCur.a[j].rRun
1ee30 29 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ),.
1ee40 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 73 s
1ee50 71 6c 69 74 65 33 4c 6f 67 45 73 74 41 64 64 28 qlite3LogEstAdd(
1ee60 73 50 72 65 76 2e 61 5b 69 5d 2e 6e 4f 75 74 2c sPrev.a[i].nOut,
1ee70 20 73 43 75 72 2e 61 5b 6a 5d 2e 6e 4f 75 74 29 sCur.a[j].nOut)
1ee80 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d );. }
1ee90 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 . }.
1eea0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 }. }.
1eeb0 20 20 20 20 20 70 4e 65 77 2d 3e 6e 4c 54 65 72 pNew->nLTer
1eec0 6d 20 3d 20 31 3b 0a 20 20 20 20 20 20 70 4e 65 m = 1;. pNe
1eed0 77 2d 3e 61 4c 54 65 72 6d 5b 30 5d 20 3d 20 70 w->aLTerm[0] = p
1eee0 54 65 72 6d 3b 0a 20 20 20 20 20 20 70 4e 65 77 Term;. pNew
1eef0 2d 3e 77 73 46 6c 61 67 73 20 3d 20 57 48 45 52 ->wsFlags = WHER
1ef00 45 5f 4d 55 4c 54 49 5f 4f 52 3b 0a 20 20 20 20 E_MULTI_OR;.
1ef10 20 20 70 4e 65 77 2d 3e 72 53 65 74 75 70 20 3d pNew->rSetup =
1ef20 20 30 3b 0a 20 20 20 20 20 20 70 4e 65 77 2d 3e 0;. pNew->
1ef30 69 53 6f 72 74 49 64 78 20 3d 20 30 3b 0a 20 20 iSortIdx = 0;.
1ef40 20 20 20 20 6d 65 6d 73 65 74 28 26 70 4e 65 77 memset(&pNew
1ef50 2d 3e 75 2c 20 30 2c 20 73 69 7a 65 6f 66 28 70 ->u, 0, sizeof(p
1ef60 4e 65 77 2d 3e 75 29 29 3b 0a 20 20 20 20 20 20 New->u));.
1ef70 66 6f 72 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c for(i=0; rc==SQL
1ef80 49 54 45 5f 4f 4b 20 26 26 20 69 3c 73 53 75 6d ITE_OK && i<sSum
1ef90 2e 6e 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 .n; i++){.
1efa0 20 20 2f 2a 20 54 55 4e 49 4e 47 3a 20 43 75 72 /* TUNING: Cur
1efb0 72 65 6e 74 6c 79 20 73 53 75 6d 2e 61 5b 69 5d rently sSum.a[i]
1efc0 2e 72 52 75 6e 20 69 73 20 73 65 74 20 74 6f 20 .rRun is set to
1efd0 74 68 65 20 73 75 6d 20 6f 66 20 74 68 65 20 63 the sum of the c
1efe0 6f 73 74 73 0a 20 20 20 20 20 20 20 20 2a 2a 20 osts. **
1eff0 6f 66 20 61 6c 6c 20 73 75 62 2d 73 63 61 6e 73 of all sub-scans
1f000 20 72 65 71 75 69 72 65 64 20 62 79 20 74 68 65 required by the
1f010 20 4f 52 2d 73 63 61 6e 2e 20 48 6f 77 65 76 65 OR-scan. Howeve
1f020 72 2c 20 64 75 65 20 74 6f 20 72 6f 75 6e 64 69 r, due to roundi
1f030 6e 67 0a 20 20 20 20 20 20 20 20 2a 2a 20 65 72 ng. ** er
1f040 72 6f 72 73 2c 20 69 74 20 6d 61 79 20 62 65 20 rors, it may be
1f050 74 68 61 74 20 74 68 65 20 63 6f 73 74 20 6f 66 that the cost of
1f060 20 74 68 65 20 4f 52 2d 73 63 61 6e 20 69 73 20 the OR-scan is
1f070 65 71 75 61 6c 20 74 6f 20 69 74 73 0a 20 20 20 equal to its.
1f080 20 20 20 20 20 2a 2a 20 6d 6f 73 74 20 65 78 70 ** most exp
1f090 65 6e 73 69 76 65 20 73 75 62 2d 73 63 61 6e 2e ensive sub-scan.
1f0a0 20 41 64 64 20 74 68 65 20 73 6d 61 6c 6c 65 73 Add the smalles
1f0b0 74 20 70 6f 73 73 69 62 6c 65 20 70 65 6e 61 6c t possible penal
1f0c0 74 79 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 28 ty . ** (
1f0d0 65 71 75 69 76 61 6c 65 6e 74 20 74 6f 20 6d 75 equivalent to mu
1f0e0 6c 74 69 70 6c 79 69 6e 67 20 74 68 65 20 63 6f ltiplying the co
1f0f0 73 74 20 62 79 20 31 2e 30 37 29 20 74 6f 20 65 st by 1.07) to e
1f100 6e 73 75 72 65 20 74 68 61 74 20 0a 20 20 20 20 nsure that .
1f110 20 20 20 20 2a 2a 20 74 68 69 73 20 64 6f 65 73 ** this does
1f120 20 6e 6f 74 20 68 61 70 70 65 6e 2e 20 4f 74 68 not happen. Oth
1f130 65 72 77 69 73 65 2c 20 66 6f 72 20 57 48 45 52 erwise, for WHER
1f140 45 20 63 6c 61 75 73 65 73 20 73 75 63 68 20 61 E clauses such a
1f150 73 20 74 68 65 0a 20 20 20 20 20 20 20 20 2a 2a s the. **
1f160 20 66 6f 6c 6c 6f 77 69 6e 67 20 77 68 65 72 65 following where
1f170 20 74 68 65 72 65 20 69 73 20 61 6e 20 69 6e 64 there is an ind
1f180 65 78 20 6f 6e 20 22 79 22 3a 0a 20 20 20 20 20 ex on "y":.
1f190 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a **. **
1f1a0 20 20 20 20 20 57 48 45 52 45 20 6c 69 6b 65 6c WHERE likel
1f1b0 69 68 6f 6f 64 28 78 3d 3f 2c 20 30 2e 39 39 29 ihood(x=?, 0.99)
1f1c0 20 4f 52 20 79 3d 3f 0a 20 20 20 20 20 20 20 20 OR y=?.
1f1d0 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 **. ** th
1f1e0 65 20 70 6c 61 6e 6e 65 72 20 6d 61 79 20 65 6c e planner may el
1f1f0 65 63 74 20 74 6f 20 22 4f 52 22 20 74 6f 67 65 ect to "OR" toge
1f200 74 68 65 72 20 61 20 66 75 6c 6c 2d 74 61 62 6c ther a full-tabl
1f210 65 20 73 63 61 6e 20 61 6e 64 20 61 6e 0a 20 20 e scan and an.
1f220 20 20 20 20 20 20 2a 2a 20 69 6e 64 65 78 20 6c ** index l
1f230 6f 6f 6b 75 70 2e 20 41 6e 64 20 6f 74 68 65 72 ookup. And other
1f240 20 73 69 6d 69 6c 61 72 6c 79 20 6f 64 64 20 72 similarly odd r
1f250 65 73 75 6c 74 73 2e 20 20 2a 2f 0a 20 20 20 20 esults. */.
1f260 20 20 20 20 70 4e 65 77 2d 3e 72 52 75 6e 20 3d pNew->rRun =
1f270 20 73 53 75 6d 2e 61 5b 69 5d 2e 72 52 75 6e 20 sSum.a[i].rRun
1f280 2b 20 31 3b 0a 20 20 20 20 20 20 20 20 70 4e 65 + 1;. pNe
1f290 77 2d 3e 6e 4f 75 74 20 3d 20 73 53 75 6d 2e 61 w->nOut = sSum.a
1f2a0 5b 69 5d 2e 6e 4f 75 74 3b 0a 20 20 20 20 20 20 [i].nOut;.
1f2b0 20 20 70 4e 65 77 2d 3e 70 72 65 72 65 71 20 3d pNew->prereq =
1f2c0 20 73 53 75 6d 2e 61 5b 69 5d 2e 70 72 65 72 65 sSum.a[i].prere
1f2d0 71 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 q;. rc =
1f2e0 77 68 65 72 65 4c 6f 6f 70 49 6e 73 65 72 74 28 whereLoopInsert(
1f2f0 70 42 75 69 6c 64 65 72 2c 20 70 4e 65 77 29 3b pBuilder, pNew);
1f300 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 57 . }. W
1f310 48 45 52 45 54 52 41 43 45 28 30 78 32 30 30 2c HERETRACE(0x200,
1f320 20 28 22 45 6e 64 20 70 72 6f 63 65 73 73 69 6e ("End processin
1f330 67 20 4f 52 2d 63 6c 61 75 73 65 20 25 70 5c 6e g OR-clause %p\n
1f340 22 2c 20 70 54 65 72 6d 29 29 3b 0a 20 20 20 20 ", pTerm));.
1f350 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 }. }. return r
1f360 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 41 64 64 20 c;.}../*.** Add
1f370 61 6c 6c 20 57 68 65 72 65 4c 6f 6f 70 20 6f 62 all WhereLoop ob
1f380 6a 65 63 74 73 20 66 6f 72 20 61 6c 6c 20 74 61 jects for all ta
1f390 62 6c 65 73 20 0a 2a 2f 0a 73 74 61 74 69 63 20 bles .*/.static
1f3a0 69 6e 74 20 77 68 65 72 65 4c 6f 6f 70 41 64 64 int whereLoopAdd
1f3b0 41 6c 6c 28 57 68 65 72 65 4c 6f 6f 70 42 75 69 All(WhereLoopBui
1f3c0 6c 64 65 72 20 2a 70 42 75 69 6c 64 65 72 29 7b lder *pBuilder){
1f3d0 0a 20 20 57 68 65 72 65 49 6e 66 6f 20 2a 70 57 . WhereInfo *pW
1f3e0 49 6e 66 6f 20 3d 20 70 42 75 69 6c 64 65 72 2d Info = pBuilder-
1f3f0 3e 70 57 49 6e 66 6f 3b 0a 20 20 42 69 74 6d 61 >pWInfo;. Bitma
1f400 73 6b 20 6d 50 72 65 72 65 71 20 3d 20 30 3b 0a sk mPrereq = 0;.
1f410 20 20 42 69 74 6d 61 73 6b 20 6d 50 72 69 6f 72 Bitmask mPrior
1f420 20 3d 20 30 3b 0a 20 20 69 6e 74 20 69 54 61 62 = 0;. int iTab
1f430 3b 0a 20 20 53 72 63 4c 69 73 74 20 2a 70 54 61 ;. SrcList *pTa
1f440 62 4c 69 73 74 20 3d 20 70 57 49 6e 66 6f 2d 3e bList = pWInfo->
1f450 70 54 61 62 4c 69 73 74 3b 0a 20 20 73 74 72 75 pTabList;. stru
1f460 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 ct SrcList_item
1f470 2a 70 49 74 65 6d 3b 0a 20 20 73 74 72 75 63 74 *pItem;. struct
1f480 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 2a 70 SrcList_item *p
1f490 45 6e 64 20 3d 20 26 70 54 61 62 4c 69 73 74 2d End = &pTabList-
1f4a0 3e 61 5b 70 57 49 6e 66 6f 2d 3e 6e 4c 65 76 65 >a[pWInfo->nLeve
1f4b0 6c 5d 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 l];. sqlite3 *d
1f4c0 62 20 3d 20 70 57 49 6e 66 6f 2d 3e 70 50 61 72 b = pWInfo->pPar
1f4d0 73 65 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 72 63 se->db;. int rc
1f4e0 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
1f4f0 57 68 65 72 65 4c 6f 6f 70 20 2a 70 4e 65 77 3b WhereLoop *pNew;
1f500 0a 20 20 75 38 20 70 72 69 6f 72 4a 6f 69 6e 74 . u8 priorJoint
1f510 79 70 65 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 4c ype = 0;.. /* L
1f520 6f 6f 70 20 6f 76 65 72 20 74 68 65 20 74 61 62 oop over the tab
1f530 6c 65 73 20 69 6e 20 74 68 65 20 6a 6f 69 6e 2c les in the join,
1f540 20 66 72 6f 6d 20 6c 65 66 74 20 74 6f 20 72 69 from left to ri
1f550 67 68 74 20 2a 2f 0a 20 20 70 4e 65 77 20 3d 20 ght */. pNew =
1f560 70 42 75 69 6c 64 65 72 2d 3e 70 4e 65 77 3b 0a pBuilder->pNew;.
1f570 20 20 77 68 65 72 65 4c 6f 6f 70 49 6e 69 74 28 whereLoopInit(
1f580 70 4e 65 77 29 3b 0a 20 20 66 6f 72 28 69 54 61 pNew);. for(iTa
1f590 62 3d 30 2c 20 70 49 74 65 6d 3d 70 54 61 62 4c b=0, pItem=pTabL
1f5a0 69 73 74 2d 3e 61 3b 20 70 49 74 65 6d 3c 70 45 ist->a; pItem<pE
1f5b0 6e 64 3b 20 69 54 61 62 2b 2b 2c 20 70 49 74 65 nd; iTab++, pIte
1f5c0 6d 2b 2b 29 7b 0a 20 20 20 20 42 69 74 6d 61 73 m++){. Bitmas
1f5d0 6b 20 6d 55 6e 75 73 61 62 6c 65 20 3d 20 30 3b k mUnusable = 0;
1f5e0 0a 20 20 20 20 70 4e 65 77 2d 3e 69 54 61 62 20 . pNew->iTab
1f5f0 3d 20 69 54 61 62 3b 0a 20 20 20 20 70 4e 65 77 = iTab;. pNew
1f600 2d 3e 6d 61 73 6b 53 65 6c 66 20 3d 20 73 71 6c ->maskSelf = sql
1f610 69 74 65 33 57 68 65 72 65 47 65 74 4d 61 73 6b ite3WhereGetMask
1f620 28 26 70 57 49 6e 66 6f 2d 3e 73 4d 61 73 6b 53 (&pWInfo->sMaskS
1f630 65 74 2c 20 70 49 74 65 6d 2d 3e 69 43 75 72 73 et, pItem->iCurs
1f640 6f 72 29 3b 0a 20 20 20 20 69 66 28 20 28 28 70 or);. if( ((p
1f650 49 74 65 6d 2d 3e 66 67 2e 6a 6f 69 6e 74 79 70 Item->fg.jointyp
1f660 65 7c 70 72 69 6f 72 4a 6f 69 6e 74 79 70 65 29 e|priorJointype)
1f670 20 26 20 28 4a 54 5f 4c 45 46 54 7c 4a 54 5f 43 & (JT_LEFT|JT_C
1f680 52 4f 53 53 29 29 21 3d 30 20 29 7b 0a 20 20 20 ROSS))!=0 ){.
1f690 20 20 20 2f 2a 20 54 68 69 73 20 63 6f 6e 64 69 /* This condi
1f6a0 74 69 6f 6e 20 69 73 20 74 72 75 65 20 77 68 65 tion is true whe
1f6b0 6e 20 70 49 74 65 6d 20 69 73 20 74 68 65 20 46 n pItem is the F
1f6c0 52 4f 4d 20 63 6c 61 75 73 65 20 74 65 72 6d 20 ROM clause term
1f6d0 6f 6e 20 74 68 65 0a 20 20 20 20 20 20 2a 2a 20 on the. **
1f6e0 72 69 67 68 74 2d 68 61 6e 64 2d 73 69 64 65 20 right-hand-side
1f6f0 6f 66 20 61 20 4c 45 46 54 20 6f 72 20 43 52 4f of a LEFT or CRO
1f700 53 53 20 4a 4f 49 4e 2e 20 20 2a 2f 0a 20 20 20 SS JOIN. */.
1f710 20 20 20 6d 50 72 65 72 65 71 20 3d 20 6d 50 72 mPrereq = mPr
1f720 69 6f 72 3b 0a 20 20 20 20 7d 0a 20 20 20 20 70 ior;. }. p
1f730 72 69 6f 72 4a 6f 69 6e 74 79 70 65 20 3d 20 70 riorJointype = p
1f740 49 74 65 6d 2d 3e 66 67 2e 6a 6f 69 6e 74 79 70 Item->fg.jointyp
1f750 65 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 e;.#ifndef SQLIT
1f760 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 E_OMIT_VIRTUALTA
1f770 42 4c 45 0a 20 20 20 20 69 66 28 20 49 73 56 69 BLE. if( IsVi
1f780 72 74 75 61 6c 28 70 49 74 65 6d 2d 3e 70 54 61 rtual(pItem->pTa
1f790 62 29 20 29 7b 0a 20 20 20 20 20 20 73 74 72 75 b) ){. stru
1f7a0 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 ct SrcList_item
1f7b0 2a 70 3b 0a 20 20 20 20 20 20 66 6f 72 28 70 3d *p;. for(p=
1f7c0 26 70 49 74 65 6d 5b 31 5d 3b 20 70 3c 70 45 6e &pItem[1]; p<pEn
1f7d0 64 3b 20 70 2b 2b 29 7b 0a 20 20 20 20 20 20 20 d; p++){.
1f7e0 20 69 66 28 20 6d 55 6e 75 73 61 62 6c 65 20 7c if( mUnusable |
1f7f0 7c 20 28 70 2d 3e 66 67 2e 6a 6f 69 6e 74 79 70 | (p->fg.jointyp
1f800 65 20 26 20 28 4a 54 5f 4c 45 46 54 7c 4a 54 5f e & (JT_LEFT|JT_
1f810 43 52 4f 53 53 29 29 20 29 7b 0a 20 20 20 20 20 CROSS)) ){.
1f820 20 20 20 20 20 6d 55 6e 75 73 61 62 6c 65 20 7c mUnusable |
1f830 3d 20 73 71 6c 69 74 65 33 57 68 65 72 65 47 65 = sqlite3WhereGe
1f840 74 4d 61 73 6b 28 26 70 57 49 6e 66 6f 2d 3e 73 tMask(&pWInfo->s
1f850 4d 61 73 6b 53 65 74 2c 20 70 2d 3e 69 43 75 72 MaskSet, p->iCur
1f860 73 6f 72 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a sor);. }.
1f870 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 72 63 }. rc
1f880 20 3d 20 77 68 65 72 65 4c 6f 6f 70 41 64 64 56 = whereLoopAddV
1f890 69 72 74 75 61 6c 28 70 42 75 69 6c 64 65 72 2c irtual(pBuilder,
1f8a0 20 6d 50 72 65 72 65 71 2c 20 6d 55 6e 75 73 61 mPrereq, mUnusa
1f8b0 62 6c 65 29 3b 0a 20 20 20 20 7d 65 6c 73 65 0a ble);. }else.
1f8c0 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 #endif /* SQLITE
1f8d0 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 42 _OMIT_VIRTUALTAB
1f8e0 4c 45 20 2a 2f 0a 20 20 20 20 7b 0a 20 20 20 20 LE */. {.
1f8f0 20 20 72 63 20 3d 20 77 68 65 72 65 4c 6f 6f 70 rc = whereLoop
1f900 41 64 64 42 74 72 65 65 28 70 42 75 69 6c 64 65 AddBtree(pBuilde
1f910 72 2c 20 6d 50 72 65 72 65 71 29 3b 0a 20 20 20 r, mPrereq);.
1f920 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 }. if( rc==S
1f930 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 QLITE_OK ){.
1f940 20 20 72 63 20 3d 20 77 68 65 72 65 4c 6f 6f 70 rc = whereLoop
1f950 41 64 64 4f 72 28 70 42 75 69 6c 64 65 72 2c 20 AddOr(pBuilder,
1f960 6d 50 72 65 72 65 71 2c 20 6d 55 6e 75 73 61 62 mPrereq, mUnusab
1f970 6c 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6d le);. }. m
1f980 50 72 69 6f 72 20 7c 3d 20 70 4e 65 77 2d 3e 6d Prior |= pNew->m
1f990 61 73 6b 53 65 6c 66 3b 0a 20 20 20 20 69 66 28 askSelf;. if(
1f9a0 20 72 63 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f rc || db->mallo
1f9b0 63 46 61 69 6c 65 64 20 29 20 62 72 65 61 6b 3b cFailed ) break;
1f9c0 0a 20 20 7d 0a 0a 20 20 77 68 65 72 65 4c 6f 6f . }.. whereLoo
1f9d0 70 43 6c 65 61 72 28 64 62 2c 20 70 4e 65 77 29 pClear(db, pNew)
1f9e0 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
1f9f0 0a 0a 2f 2a 0a 2a 2a 20 45 78 61 6d 69 6e 65 20 ../*.** Examine
1fa00 61 20 57 68 65 72 65 50 61 74 68 20 28 77 69 74 a WherePath (wit
1fa10 68 20 74 68 65 20 61 64 64 69 74 69 6f 6e 20 6f h the addition o
1fa20 66 20 74 68 65 20 65 78 74 72 61 20 57 68 65 72 f the extra Wher
1fa30 65 4c 6f 6f 70 20 6f 66 20 74 68 65 20 36 74 68 eLoop of the 6th
1fa40 0a 2a 2a 20 70 61 72 61 6d 65 74 65 72 73 29 20 .** parameters)
1fa50 74 6f 20 73 65 65 20 69 66 20 69 74 20 6f 75 74 to see if it out
1fa60 70 75 74 73 20 72 6f 77 73 20 69 6e 20 74 68 65 puts rows in the
1fa70 20 72 65 71 75 65 73 74 65 64 20 4f 52 44 45 52 requested ORDER
1fa80 20 42 59 0a 2a 2a 20 28 6f 72 20 47 52 4f 55 50 BY.** (or GROUP
1fa90 20 42 59 29 20 77 69 74 68 6f 75 74 20 72 65 71 BY) without req
1faa0 75 69 72 69 6e 67 20 61 20 73 65 70 61 72 61 74 uiring a separat
1fab0 65 20 73 6f 72 74 20 6f 70 65 72 61 74 69 6f 6e e sort operation
1fac0 2e 20 20 52 65 74 75 72 6e 20 4e 3a 0a 2a 2a 20 . Return N:.**
1fad0 0a 2a 2a 20 20 20 4e 3e 30 3a 20 20 20 4e 20 74 .** N>0: N t
1fae0 65 72 6d 73 20 6f 66 20 74 68 65 20 4f 52 44 45 erms of the ORDE
1faf0 52 20 42 59 20 63 6c 61 75 73 65 20 61 72 65 20 R BY clause are
1fb00 73 61 74 69 73 66 69 65 64 0a 2a 2a 20 20 20 4e satisfied.** N
1fb10 3d 3d 30 3a 20 20 4e 6f 20 74 65 72 6d 73 20 6f ==0: No terms o
1fb20 66 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 f the ORDER BY c
1fb30 6c 61 75 73 65 20 61 72 65 20 73 61 74 69 73 66 lause are satisf
1fb40 69 65 64 0a 2a 2a 20 20 20 4e 3c 30 3a 20 20 20 ied.** N<0:
1fb50 55 6e 6b 6e 6f 77 6e 20 79 65 74 20 68 6f 77 20 Unknown yet how
1fb60 6d 61 6e 79 20 74 65 72 6d 73 20 6f 66 20 4f 52 many terms of OR
1fb70 44 45 52 20 42 59 20 6d 69 67 68 74 20 62 65 20 DER BY might be
1fb80 73 61 74 69 73 66 69 65 64 2e 20 20 20 0a 2a 2a satisfied. .**
1fb90 0a 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 70 72 .** Note that pr
1fba0 6f 63 65 73 73 69 6e 67 20 66 6f 72 20 57 48 45 ocessing for WHE
1fbb0 52 45 5f 47 52 4f 55 50 42 59 20 61 6e 64 20 57 RE_GROUPBY and W
1fbc0 48 45 52 45 5f 44 49 53 54 49 4e 43 54 42 59 20 HERE_DISTINCTBY
1fbd0 69 73 20 6e 6f 74 20 61 73 0a 2a 2a 20 73 74 72 is not as.** str
1fbe0 69 63 74 2e 20 20 57 69 74 68 20 47 52 4f 55 50 ict. With GROUP
1fbf0 20 42 59 20 61 6e 64 20 44 49 53 54 49 4e 43 54 BY and DISTINCT
1fc00 20 74 68 65 20 6f 6e 6c 79 20 72 65 71 75 69 72 the only requir
1fc10 65 6d 65 6e 74 20 69 73 20 74 68 61 74 0a 2a 2a ement is that.**
1fc20 20 65 71 75 69 76 61 6c 65 6e 74 20 72 6f 77 73 equivalent rows
1fc30 20 61 70 70 65 61 72 20 69 6d 6d 65 64 69 61 74 appear immediat
1fc40 65 6c 79 20 61 64 6a 61 63 65 6e 74 20 74 6f 20 ely adjacent to
1fc50 6f 6e 65 20 61 6e 6f 74 68 65 72 2e 20 20 47 52 one another. GR
1fc60 4f 55 50 20 42 59 0a 2a 2a 20 61 6e 64 20 44 49 OUP BY.** and DI
1fc70 53 54 49 4e 43 54 20 64 6f 20 6e 6f 74 20 72 65 STINCT do not re
1fc80 71 75 69 72 65 20 72 6f 77 73 20 74 6f 20 61 70 quire rows to ap
1fc90 70 65 61 72 20 69 6e 20 61 6e 79 20 70 61 72 74 pear in any part
1fca0 69 63 75 6c 61 72 20 6f 72 64 65 72 20 61 73 20 icular order as
1fcb0 6c 6f 6e 67 0a 2a 2a 20 61 73 20 65 71 75 69 76 long.** as equiv
1fcc0 61 6c 65 6e 74 20 72 6f 77 73 20 61 72 65 20 67 alent rows are g
1fcd0 72 6f 75 70 65 64 20 74 6f 67 65 74 68 65 72 2e rouped together.
1fce0 20 20 54 68 75 73 20 66 6f 72 20 47 52 4f 55 50 Thus for GROUP
1fcf0 20 42 59 20 61 6e 64 20 44 49 53 54 49 4e 43 54 BY and DISTINCT
1fd00 0a 2a 2a 20 74 68 65 20 70 4f 72 64 65 72 42 79 .** the pOrderBy
1fd10 20 74 65 72 6d 73 20 63 61 6e 20 62 65 20 6d 61 terms can be ma
1fd20 74 63 68 65 64 20 69 6e 20 61 6e 79 20 6f 72 64 tched in any ord
1fd30 65 72 2e 20 20 57 69 74 68 20 4f 52 44 45 52 20 er. With ORDER
1fd40 42 59 2c 20 74 68 65 20 0a 2a 2a 20 70 4f 72 64 BY, the .** pOrd
1fd50 65 72 42 79 20 74 65 72 6d 73 20 6d 75 73 74 20 erBy terms must
1fd60 62 65 20 6d 61 74 63 68 65 64 20 69 6e 20 73 74 be matched in st
1fd70 72 69 63 74 20 6c 65 66 74 2d 74 6f 2d 72 69 67 rict left-to-rig
1fd80 68 74 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 74 61 ht order..*/.sta
1fd90 74 69 63 20 69 38 20 77 68 65 72 65 50 61 74 68 tic i8 wherePath
1fda0 53 61 74 69 73 66 69 65 73 4f 72 64 65 72 42 79 SatisfiesOrderBy
1fdb0 28 0a 20 20 57 68 65 72 65 49 6e 66 6f 20 2a 70 (. WhereInfo *p
1fdc0 57 49 6e 66 6f 2c 20 20 20 20 2f 2a 20 54 68 65 WInfo, /* The
1fdd0 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 2a 2f WHERE clause */
1fde0 0a 20 20 45 78 70 72 4c 69 73 74 20 2a 70 4f 72 . ExprList *pOr
1fdf0 64 65 72 42 79 2c 20 20 20 2f 2a 20 4f 52 44 45 derBy, /* ORDE
1fe00 52 20 42 59 20 6f 72 20 47 52 4f 55 50 20 42 59 R BY or GROUP BY
1fe10 20 6f 72 20 44 49 53 54 49 4e 43 54 20 63 6c 61 or DISTINCT cla
1fe20 75 73 65 20 74 6f 20 63 68 65 63 6b 20 2a 2f 0a use to check */.
1fe30 20 20 57 68 65 72 65 50 61 74 68 20 2a 70 50 61 WherePath *pPa
1fe40 74 68 2c 20 20 20 20 20 2f 2a 20 54 68 65 20 57 th, /* The W
1fe50 68 65 72 65 50 61 74 68 20 74 6f 20 63 68 65 63 herePath to chec
1fe60 6b 20 2a 2f 0a 20 20 75 31 36 20 77 63 74 72 6c k */. u16 wctrl
1fe70 46 6c 61 67 73 2c 20 20 20 20 20 20 20 2f 2a 20 Flags, /*
1fe80 57 48 45 52 45 5f 47 52 4f 55 50 42 59 20 6f 72 WHERE_GROUPBY or
1fe90 20 5f 44 49 53 54 49 4e 43 54 42 59 20 6f 72 20 _DISTINCTBY or
1fea0 5f 4f 52 44 45 52 42 59 5f 4c 49 4d 49 54 20 2a _ORDERBY_LIMIT *
1feb0 2f 0a 20 20 75 31 36 20 6e 4c 6f 6f 70 2c 20 20 /. u16 nLoop,
1fec0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d /* Num
1fed0 62 65 72 20 6f 66 20 65 6e 74 72 69 65 73 20 69 ber of entries i
1fee0 6e 20 70 50 61 74 68 2d 3e 61 4c 6f 6f 70 5b 5d n pPath->aLoop[]
1fef0 20 2a 2f 0a 20 20 57 68 65 72 65 4c 6f 6f 70 20 */. WhereLoop
1ff00 2a 70 4c 61 73 74 2c 20 20 20 20 20 2f 2a 20 41 *pLast, /* A
1ff10 64 64 20 74 68 69 73 20 57 68 65 72 65 4c 6f 6f dd this WhereLoo
1ff20 70 20 74 6f 20 74 68 65 20 65 6e 64 20 6f 66 20 p to the end of
1ff30 70 50 61 74 68 2d 3e 61 4c 6f 6f 70 5b 5d 20 2a pPath->aLoop[] *
1ff40 2f 0a 20 20 42 69 74 6d 61 73 6b 20 2a 70 52 65 /. Bitmask *pRe
1ff50 76 4d 61 73 6b 20 20 20 20 20 2f 2a 20 4f 55 54 vMask /* OUT
1ff60 3a 20 4d 61 73 6b 20 6f 66 20 57 68 65 72 65 4c : Mask of WhereL
1ff70 6f 6f 70 73 20 74 6f 20 72 75 6e 20 69 6e 20 72 oops to run in r
1ff80 65 76 65 72 73 65 20 6f 72 64 65 72 20 2a 2f 0a everse order */.
1ff90 29 7b 0a 20 20 75 38 20 72 65 76 53 65 74 3b 20 ){. u8 revSet;
1ffa0 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 /* Tr
1ffb0 75 65 20 69 66 20 72 65 76 20 69 73 20 6b 6e 6f ue if rev is kno
1ffc0 77 6e 20 2a 2f 0a 20 20 75 38 20 72 65 76 3b 20 wn */. u8 rev;
1ffd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
1ffe0 20 43 6f 6d 70 6f 73 69 74 65 20 73 6f 72 74 20 Composite sort
1fff0 6f 72 64 65 72 20 2a 2f 0a 20 20 75 38 20 72 65 order */. u8 re
20000 76 49 64 78 3b 20 20 20 20 20 20 20 20 20 20 20 vIdx;
20010 20 2f 2a 20 49 6e 64 65 78 20 73 6f 72 74 20 6f /* Index sort o
20020 72 64 65 72 20 2a 2f 0a 20 20 75 38 20 69 73 4f rder */. u8 isO
20030 72 64 65 72 44 69 73 74 69 6e 63 74 3b 20 20 20 rderDistinct;
20040 2f 2a 20 41 6c 6c 20 70 72 69 6f 72 20 57 68 65 /* All prior Whe
20050 72 65 4c 6f 6f 70 73 20 61 72 65 20 6f 72 64 65 reLoops are orde
20060 72 2d 64 69 73 74 69 6e 63 74 20 2a 2f 0a 20 20 r-distinct */.
20070 75 38 20 64 69 73 74 69 6e 63 74 43 6f 6c 75 6d u8 distinctColum
20080 6e 73 3b 20 20 20 2f 2a 20 54 72 75 65 20 69 66 ns; /* True if
20090 20 74 68 65 20 6c 6f 6f 70 20 68 61 73 20 55 4e the loop has UN
200a0 49 51 55 45 20 4e 4f 54 20 4e 55 4c 4c 20 63 6f IQUE NOT NULL co
200b0 6c 75 6d 6e 73 20 2a 2f 0a 20 20 75 38 20 69 73 lumns */. u8 is
200c0 4d 61 74 63 68 3b 20 20 20 20 20 20 20 20 20 20 Match;
200d0 20 2f 2a 20 69 43 6f 6c 75 6d 6e 20 6d 61 74 63 /* iColumn matc
200e0 68 65 73 20 61 20 74 65 72 6d 20 6f 66 20 74 68 hes a term of th
200f0 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 e ORDER BY claus
20100 65 20 2a 2f 0a 20 20 75 31 36 20 65 71 4f 70 4d e */. u16 eqOpM
20110 61 73 6b 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 ask; /*
20120 41 6c 6c 6f 77 65 64 20 65 71 75 61 6c 69 74 79 Allowed equality
20130 20 6f 70 65 72 61 74 6f 72 73 20 2a 2f 0a 20 20 operators */.
20140 75 31 36 20 6e 4b 65 79 43 6f 6c 3b 20 20 20 20 u16 nKeyCol;
20150 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 /* Number
20160 6f 66 20 6b 65 79 20 63 6f 6c 75 6d 6e 73 20 69 of key columns i
20170 6e 20 70 49 6e 64 65 78 20 2a 2f 0a 20 20 75 31 n pIndex */. u1
20180 36 20 6e 43 6f 6c 75 6d 6e 3b 20 20 20 20 20 20 6 nColumn;
20190 20 20 20 20 2f 2a 20 54 6f 74 61 6c 20 6e 75 6d /* Total num
201a0 62 65 72 20 6f 66 20 6f 72 64 65 72 65 64 20 63 ber of ordered c
201b0 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 69 6e olumns in the in
201c0 64 65 78 20 2a 2f 0a 20 20 75 31 36 20 6e 4f 72 dex */. u16 nOr
201d0 64 65 72 42 79 3b 20 20 20 20 20 20 20 20 20 2f derBy; /
201e0 2a 20 4e 75 6d 62 65 72 20 74 65 72 6d 73 20 69 * Number terms i
201f0 6e 20 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 n the ORDER BY c
20200 6c 61 75 73 65 20 2a 2f 0a 20 20 69 6e 74 20 69 lause */. int i
20210 4c 6f 6f 70 3b 20 20 20 20 20 20 20 20 20 20 20 Loop;
20220 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 57 68 65 /* Index of Whe
20230 72 65 4c 6f 6f 70 20 69 6e 20 70 50 61 74 68 20 reLoop in pPath
20240 62 65 69 6e 67 20 70 72 6f 63 65 73 73 65 64 20 being processed
20250 2a 2f 0a 20 20 69 6e 74 20 69 2c 20 6a 3b 20 20 */. int i, j;
20260 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f /* Lo
20270 6f 70 20 63 6f 75 6e 74 65 72 73 20 2a 2f 0a 20 op counters */.
20280 20 69 6e 74 20 69 43 75 72 3b 20 20 20 20 20 20 int iCur;
20290 20 20 20 20 20 20 20 2f 2a 20 43 75 72 73 6f 72 /* Cursor
202a0 20 6e 75 6d 62 65 72 20 66 6f 72 20 63 75 72 72 number for curr
202b0 65 6e 74 20 57 68 65 72 65 4c 6f 6f 70 20 2a 2f ent WhereLoop */
202c0 0a 20 20 69 6e 74 20 69 43 6f 6c 75 6d 6e 3b 20 . int iColumn;
202d0 20 20 20 20 20 20 20 20 20 2f 2a 20 41 20 63 6f /* A co
202e0 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 77 69 74 68 lumn number with
202f0 69 6e 20 74 61 62 6c 65 20 69 43 75 72 20 2a 2f in table iCur */
20300 0a 20 20 57 68 65 72 65 4c 6f 6f 70 20 2a 70 4c . WhereLoop *pL
20310 6f 6f 70 20 3d 20 30 3b 20 2f 2a 20 43 75 72 72 oop = 0; /* Curr
20320 65 6e 74 20 57 68 65 72 65 4c 6f 6f 70 20 62 65 ent WhereLoop be
20330 69 6e 67 20 70 72 6f 63 65 73 73 65 64 2e 20 2a ing processed. *
20340 2f 0a 20 20 57 68 65 72 65 54 65 72 6d 20 2a 70 /. WhereTerm *p
20350 54 65 72 6d 3b 20 20 20 20 20 2f 2a 20 41 20 73 Term; /* A s
20360 69 6e 67 6c 65 20 74 65 72 6d 20 6f 66 20 74 68 ingle term of th
20370 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 2a e WHERE clause *
20380 2f 0a 20 20 45 78 70 72 20 2a 70 4f 42 45 78 70 /. Expr *pOBExp
20390 72 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 6e 20 r; /* An
203a0 65 78 70 72 65 73 73 69 6f 6e 20 66 72 6f 6d 20 expression from
203b0 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 the ORDER BY cla
203c0 75 73 65 20 2a 2f 0a 20 20 43 6f 6c 6c 53 65 71 use */. CollSeq
203d0 20 2a 70 43 6f 6c 6c 3b 20 20 20 20 20 20 20 2f *pColl; /
203e0 2a 20 43 4f 4c 4c 41 54 45 20 66 75 6e 63 74 69 * COLLATE functi
203f0 6f 6e 20 66 72 6f 6d 20 61 6e 20 4f 52 44 45 52 on from an ORDER
20400 20 42 59 20 63 6c 61 75 73 65 20 74 65 72 6d 20 BY clause term
20410 2a 2f 0a 20 20 49 6e 64 65 78 20 2a 70 49 6e 64 */. Index *pInd
20420 65 78 3b 20 20 20 20 20 20 20 20 2f 2a 20 54 68 ex; /* Th
20430 65 20 69 6e 64 65 78 20 61 73 73 6f 63 69 61 74 e index associat
20440 65 64 20 77 69 74 68 20 70 4c 6f 6f 70 20 2a 2f ed with pLoop */
20450 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d . sqlite3 *db =
20460 20 70 57 49 6e 66 6f 2d 3e 70 50 61 72 73 65 2d pWInfo->pParse-
20470 3e 64 62 3b 20 20 2f 2a 20 44 61 74 61 62 61 73 >db; /* Databas
20480 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a e connection */.
20490 20 20 42 69 74 6d 61 73 6b 20 6f 62 53 61 74 20 Bitmask obSat
204a0 3d 20 30 3b 20 20 20 20 2f 2a 20 4d 61 73 6b 20 = 0; /* Mask
204b0 6f 66 20 4f 52 44 45 52 20 42 59 20 74 65 72 6d of ORDER BY term
204c0 73 20 73 61 74 69 73 66 69 65 64 20 73 6f 20 66 s satisfied so f
204d0 61 72 20 2a 2f 0a 20 20 42 69 74 6d 61 73 6b 20 ar */. Bitmask
204e0 6f 62 44 6f 6e 65 3b 20 20 20 20 20 20 20 2f 2a obDone; /*
204f0 20 4d 61 73 6b 20 6f 66 20 61 6c 6c 20 4f 52 44 Mask of all ORD
20500 45 52 20 42 59 20 74 65 72 6d 73 20 2a 2f 0a 20 ER BY terms */.
20510 20 42 69 74 6d 61 73 6b 20 6f 72 64 65 72 44 69 Bitmask orderDi
20520 73 74 69 6e 63 74 4d 61 73 6b 3b 20 20 2f 2a 20 stinctMask; /*
20530 4d 61 73 6b 20 6f 66 20 61 6c 6c 20 77 65 6c 6c Mask of all well
20540 2d 6f 72 64 65 72 65 64 20 6c 6f 6f 70 73 20 2a -ordered loops *
20550 2f 0a 20 20 42 69 74 6d 61 73 6b 20 72 65 61 64 /. Bitmask read
20560 79 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 y;
20570 2f 2a 20 4d 61 73 6b 20 6f 66 20 69 6e 6e 65 72 /* Mask of inner
20580 20 6c 6f 6f 70 73 20 2a 2f 0a 0a 20 20 2f 2a 0a loops */.. /*.
20590 20 20 2a 2a 20 57 65 20 73 61 79 20 74 68 65 20 ** We say the
205a0 57 68 65 72 65 4c 6f 6f 70 20 69 73 20 22 6f 6e WhereLoop is "on
205b0 65 2d 72 6f 77 22 20 69 66 20 69 74 20 67 65 6e e-row" if it gen
205c0 65 72 61 74 65 73 20 6e 6f 20 6d 6f 72 65 20 74 erates no more t
205d0 68 61 6e 20 6f 6e 65 0a 20 20 2a 2a 20 72 6f 77 han one. ** row
205e0 20 6f 66 20 6f 75 74 70 75 74 2e 20 20 41 20 57 of output. A W
205f0 68 65 72 65 4c 6f 6f 70 20 69 73 20 6f 6e 65 2d hereLoop is one-
20600 72 6f 77 20 69 66 20 61 6c 6c 20 6f 66 20 74 68 row if all of th
20610 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 61 72 65 20 e following are
20620 74 72 75 65 3a 0a 20 20 2a 2a 20 20 28 61 29 20 true:. ** (a)
20630 41 6c 6c 20 69 6e 64 65 78 20 63 6f 6c 75 6d 6e All index column
20640 73 20 6d 61 74 63 68 20 77 69 74 68 20 57 48 45 s match with WHE
20650 52 45 5f 43 4f 4c 55 4d 4e 5f 45 51 2e 0a 20 20 RE_COLUMN_EQ..
20660 2a 2a 20 20 28 62 29 20 54 68 65 20 69 6e 64 65 ** (b) The inde
20670 78 20 69 73 20 75 6e 69 71 75 65 0a 20 20 2a 2a x is unique. **
20680 20 41 6e 79 20 57 68 65 72 65 4c 6f 6f 70 20 77 Any WhereLoop w
20690 69 74 68 20 61 6e 20 57 48 45 52 45 5f 43 4f 4c ith an WHERE_COL
206a0 55 4d 4e 5f 45 51 20 63 6f 6e 73 74 72 61 69 6e UMN_EQ constrain
206b0 74 20 6f 6e 20 74 68 65 20 72 6f 77 69 64 20 69 t on the rowid i
206c0 73 20 6f 6e 65 2d 72 6f 77 2e 0a 20 20 2a 2a 20 s one-row.. **
206d0 45 76 65 72 79 20 6f 6e 65 2d 72 6f 77 20 57 68 Every one-row Wh
206e0 65 72 65 4c 6f 6f 70 20 77 69 6c 6c 20 68 61 76 ereLoop will hav
206f0 65 20 74 68 65 20 57 48 45 52 45 5f 4f 4e 45 52 e the WHERE_ONER
20700 4f 57 20 62 69 74 20 73 65 74 20 69 6e 20 77 73 OW bit set in ws
20710 46 6c 61 67 73 2e 0a 20 20 2a 2a 0a 20 20 2a 2a Flags.. **. **
20720 20 57 65 20 73 61 79 20 74 68 65 20 57 68 65 72 We say the Wher
20730 65 4c 6f 6f 70 20 69 73 20 22 6f 72 64 65 72 2d eLoop is "order-
20740 64 69 73 74 69 6e 63 74 22 20 69 66 20 74 68 65 distinct" if the
20750 20 73 65 74 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 set of columns
20760 66 72 6f 6d 0a 20 20 2a 2a 20 74 68 61 74 20 57 from. ** that W
20770 68 65 72 65 4c 6f 6f 70 20 74 68 61 74 20 61 72 hereLoop that ar
20780 65 20 69 6e 20 74 68 65 20 4f 52 44 45 52 20 42 e in the ORDER B
20790 59 20 63 6c 61 75 73 65 20 61 72 65 20 64 69 66 Y clause are dif
207a0 66 65 72 65 6e 74 20 66 6f 72 20 65 76 65 72 79 ferent for every
207b0 0a 20 20 2a 2a 20 72 6f 77 20 6f 66 20 74 68 65 . ** row of the
207c0 20 57 68 65 72 65 4c 6f 6f 70 2e 20 20 45 76 65 WhereLoop. Eve
207d0 72 79 20 6f 6e 65 2d 72 6f 77 20 57 68 65 72 65 ry one-row Where
207e0 4c 6f 6f 70 20 69 73 20 61 75 74 6f 6d 61 74 69 Loop is automati
207f0 63 61 6c 6c 79 0a 20 20 2a 2a 20 6f 72 64 65 72 cally. ** order
20800 2d 64 69 73 74 69 6e 63 74 2e 20 20 20 41 20 57 -distinct. A W
20810 68 65 72 65 4c 6f 6f 70 20 74 68 61 74 20 68 61 hereLoop that ha
20820 73 20 6e 6f 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 s no columns in
20830 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 the ORDER BY cla
20840 75 73 65 0a 20 20 2a 2a 20 69 73 20 6e 6f 74 20 use. ** is not
20850 6f 72 64 65 72 2d 64 69 73 74 69 6e 63 74 2e 20 order-distinct.
20860 54 6f 20 62 65 20 6f 72 64 65 72 2d 64 69 73 74 To be order-dist
20870 69 6e 63 74 20 69 73 20 6e 6f 74 20 71 75 69 74 inct is not quit
20880 65 20 74 68 65 20 73 61 6d 65 20 61 73 20 62 65 e the same as be
20890 69 6e 67 0a 20 20 2a 2a 20 55 4e 49 51 55 45 20 ing. ** UNIQUE
208a0 73 69 6e 63 65 20 61 20 55 4e 49 51 55 45 20 63 since a UNIQUE c
208b0 6f 6c 75 6d 6e 20 6f 72 20 69 6e 64 65 78 20 63 olumn or index c
208c0 61 6e 20 68 61 76 65 20 6d 75 6c 74 69 70 6c 65 an have multiple
208d0 20 72 6f 77 73 20 74 68 61 74 20 0a 20 20 2a 2a rows that . **
208e0 20 61 72 65 20 4e 55 4c 4c 20 61 6e 64 20 4e 55 are NULL and NU
208f0 4c 4c 20 76 61 6c 75 65 73 20 61 72 65 20 65 71 LL values are eq
20900 75 69 76 61 6c 65 6e 74 20 66 6f 72 20 74 68 65 uivalent for the
20910 20 70 75 72 70 6f 73 65 20 6f 66 20 6f 72 64 65 purpose of orde
20920 72 2d 64 69 73 74 69 6e 63 74 2e 0a 20 20 2a 2a r-distinct.. **
20930 20 54 6f 20 62 65 20 6f 72 64 65 72 2d 64 69 73 To be order-dis
20940 74 69 6e 63 74 2c 20 74 68 65 20 63 6f 6c 75 6d tinct, the colum
20950 6e 73 20 6d 75 73 74 20 62 65 20 55 4e 49 51 55 ns must be UNIQU
20960 45 20 61 6e 64 20 4e 4f 54 20 4e 55 4c 4c 2e 0a E and NOT NULL..
20970 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 72 6f **. ** The ro
20980 77 69 64 20 66 6f 72 20 61 20 74 61 62 6c 65 20 wid for a table
20990 69 73 20 61 6c 77 61 79 73 20 55 4e 49 51 55 45 is always UNIQUE
209a0 20 61 6e 64 20 4e 4f 54 20 4e 55 4c 4c 20 73 6f and NOT NULL so
209b0 20 77 68 65 6e 65 76 65 72 20 74 68 65 0a 20 20 whenever the.
209c0 2a 2a 20 72 6f 77 69 64 20 61 70 70 65 61 72 73 ** rowid appears
209d0 20 69 6e 20 74 68 65 20 4f 52 44 45 52 20 42 59 in the ORDER BY
209e0 20 63 6c 61 75 73 65 2c 20 74 68 65 20 63 6f 72 clause, the cor
209f0 72 65 73 70 6f 6e 64 69 6e 67 20 57 68 65 72 65 responding Where
20a00 4c 6f 6f 70 20 69 73 0a 20 20 2a 2a 20 61 75 74 Loop is. ** aut
20a10 6f 6d 61 74 69 63 61 6c 6c 79 20 6f 72 64 65 72 omatically order
20a20 2d 64 69 73 74 69 6e 63 74 2e 0a 20 20 2a 2f 0a -distinct.. */.
20a30 0a 20 20 61 73 73 65 72 74 28 20 70 4f 72 64 65 . assert( pOrde
20a40 72 42 79 21 3d 30 20 29 3b 0a 20 20 69 66 28 20 rBy!=0 );. if(
20a50 6e 4c 6f 6f 70 20 26 26 20 4f 70 74 69 6d 69 7a nLoop && Optimiz
20a60 61 74 69 6f 6e 44 69 73 61 62 6c 65 64 28 64 62 ationDisabled(db
20a70 2c 20 53 51 4c 49 54 45 5f 4f 72 64 65 72 42 79 , SQLITE_OrderBy
20a80 49 64 78 4a 6f 69 6e 29 20 29 20 72 65 74 75 72 IdxJoin) ) retur
20a90 6e 20 30 3b 0a 0a 20 20 6e 4f 72 64 65 72 42 79 n 0;.. nOrderBy
20aa0 20 3d 20 70 4f 72 64 65 72 42 79 2d 3e 6e 45 78 = pOrderBy->nEx
20ab0 70 72 3b 0a 20 20 74 65 73 74 63 61 73 65 28 20 pr;. testcase(
20ac0 6e 4f 72 64 65 72 42 79 3d 3d 42 4d 53 2d 31 20 nOrderBy==BMS-1
20ad0 29 3b 0a 20 20 69 66 28 20 6e 4f 72 64 65 72 42 );. if( nOrderB
20ae0 79 3e 42 4d 53 2d 31 20 29 20 72 65 74 75 72 6e y>BMS-1 ) return
20af0 20 30 3b 20 20 2f 2a 20 43 61 6e 6e 6f 74 20 6f 0; /* Cannot o
20b00 70 74 69 6d 69 7a 65 20 6f 76 65 72 6c 79 20 6c ptimize overly l
20b10 61 72 67 65 20 4f 52 44 45 52 20 42 59 73 20 2a arge ORDER BYs *
20b20 2f 0a 20 20 69 73 4f 72 64 65 72 44 69 73 74 69 /. isOrderDisti
20b30 6e 63 74 20 3d 20 31 3b 0a 20 20 6f 62 44 6f 6e nct = 1;. obDon
20b40 65 20 3d 20 4d 41 53 4b 42 49 54 28 6e 4f 72 64 e = MASKBIT(nOrd
20b50 65 72 42 79 29 2d 31 3b 0a 20 20 6f 72 64 65 72 erBy)-1;. order
20b60 44 69 73 74 69 6e 63 74 4d 61 73 6b 20 3d 20 30 DistinctMask = 0
20b70 3b 0a 20 20 72 65 61 64 79 20 3d 20 30 3b 0a 20 ;. ready = 0;.
20b80 20 65 71 4f 70 4d 61 73 6b 20 3d 20 57 4f 5f 45 eqOpMask = WO_E
20b90 51 20 7c 20 57 4f 5f 49 53 20 7c 20 57 4f 5f 49 Q | WO_IS | WO_I
20ba0 53 4e 55 4c 4c 3b 0a 20 20 69 66 28 20 77 63 74 SNULL;. if( wct
20bb0 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f rlFlags & WHERE_
20bc0 4f 52 44 45 52 42 59 5f 4c 49 4d 49 54 20 29 20 ORDERBY_LIMIT )
20bd0 65 71 4f 70 4d 61 73 6b 20 7c 3d 20 57 4f 5f 49 eqOpMask |= WO_I
20be0 4e 3b 0a 20 20 66 6f 72 28 69 4c 6f 6f 70 3d 30 N;. for(iLoop=0
20bf0 3b 20 69 73 4f 72 64 65 72 44 69 73 74 69 6e 63 ; isOrderDistinc
20c00 74 20 26 26 20 6f 62 53 61 74 3c 6f 62 44 6f 6e t && obSat<obDon
20c10 65 20 26 26 20 69 4c 6f 6f 70 3c 3d 6e 4c 6f 6f e && iLoop<=nLoo
20c20 70 3b 20 69 4c 6f 6f 70 2b 2b 29 7b 0a 20 20 20 p; iLoop++){.
20c30 20 69 66 28 20 69 4c 6f 6f 70 3e 30 20 29 20 72 if( iLoop>0 ) r
20c40 65 61 64 79 20 7c 3d 20 70 4c 6f 6f 70 2d 3e 6d eady |= pLoop->m
20c50 61 73 6b 53 65 6c 66 3b 0a 20 20 20 20 69 66 28 askSelf;. if(
20c60 20 69 4c 6f 6f 70 3c 6e 4c 6f 6f 70 20 29 7b 0a iLoop<nLoop ){.
20c70 20 20 20 20 20 20 70 4c 6f 6f 70 20 3d 20 70 50 pLoop = pP
20c80 61 74 68 2d 3e 61 4c 6f 6f 70 5b 69 4c 6f 6f 70 ath->aLoop[iLoop
20c90 5d 3b 0a 20 20 20 20 20 20 69 66 28 20 77 63 74 ];. if( wct
20ca0 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f rlFlags & WHERE_
20cb0 4f 52 44 45 52 42 59 5f 4c 49 4d 49 54 20 29 20 ORDERBY_LIMIT )
20cc0 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 7d 65 continue;. }e
20cd0 6c 73 65 7b 0a 20 20 20 20 20 20 70 4c 6f 6f 70 lse{. pLoop
20ce0 20 3d 20 70 4c 61 73 74 3b 0a 20 20 20 20 7d 0a = pLast;. }.
20cf0 20 20 20 20 69 66 28 20 70 4c 6f 6f 70 2d 3e 77 if( pLoop->w
20d00 73 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f 56 sFlags & WHERE_V
20d10 49 52 54 55 41 4c 54 41 42 4c 45 20 29 7b 0a 20 IRTUALTABLE ){.
20d20 20 20 20 20 20 69 66 28 20 70 4c 6f 6f 70 2d 3e if( pLoop->
20d30 75 2e 76 74 61 62 2e 69 73 4f 72 64 65 72 65 64 u.vtab.isOrdered
20d40 20 29 20 6f 62 53 61 74 20 3d 20 6f 62 44 6f 6e ) obSat = obDon
20d50 65 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a e;. break;.
20d60 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
20d70 20 70 4c 6f 6f 70 2d 3e 75 2e 62 74 72 65 65 2e pLoop->u.btree.
20d80 6e 49 64 78 43 6f 6c 20 3d 20 30 3b 0a 20 20 20 nIdxCol = 0;.
20d90 20 7d 0a 20 20 20 20 69 43 75 72 20 3d 20 70 57 }. iCur = pW
20da0 49 6e 66 6f 2d 3e 70 54 61 62 4c 69 73 74 2d 3e Info->pTabList->
20db0 61 5b 70 4c 6f 6f 70 2d 3e 69 54 61 62 5d 2e 69 a[pLoop->iTab].i
20dc0 43 75 72 73 6f 72 3b 0a 0a 20 20 20 20 2f 2a 20 Cursor;.. /*
20dd0 4d 61 72 6b 20 6f 66 66 20 61 6e 79 20 4f 52 44 Mark off any ORD
20de0 45 52 20 42 59 20 74 65 72 6d 20 58 20 74 68 61 ER BY term X tha
20df0 74 20 69 73 20 61 20 63 6f 6c 75 6d 6e 20 69 6e t is a column in
20e00 20 74 68 65 20 74 61 62 6c 65 20 6f 66 0a 20 20 the table of.
20e10 20 20 2a 2a 20 74 68 65 20 63 75 72 72 65 6e 74 ** the current
20e20 20 6c 6f 6f 70 20 66 6f 72 20 77 68 69 63 68 20 loop for which
20e30 74 68 65 72 65 20 69 73 20 74 65 72 6d 20 69 6e there is term in
20e40 20 74 68 65 20 57 48 45 52 45 0a 20 20 20 20 2a the WHERE. *
20e50 2a 20 63 6c 61 75 73 65 20 6f 66 20 74 68 65 20 * clause of the
20e60 66 6f 72 6d 20 58 20 49 53 20 4e 55 4c 4c 20 6f form X IS NULL o
20e70 72 20 58 3d 3f 20 74 68 61 74 20 72 65 66 65 72 r X=? that refer
20e80 65 6e 63 65 20 6f 6e 6c 79 20 6f 75 74 65 72 0a ence only outer.
20e90 20 20 20 20 2a 2a 20 6c 6f 6f 70 73 2e 0a 20 20 ** loops..
20ea0 20 20 2a 2f 0a 20 20 20 20 66 6f 72 28 69 3d 30 */. for(i=0
20eb0 3b 20 69 3c 6e 4f 72 64 65 72 42 79 3b 20 69 2b ; i<nOrderBy; i+
20ec0 2b 29 7b 0a 20 20 20 20 20 20 69 66 28 20 4d 41 +){. if( MA
20ed0 53 4b 42 49 54 28 69 29 20 26 20 6f 62 53 61 74 SKBIT(i) & obSat
20ee0 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 ) continue;.
20ef0 20 20 20 70 4f 42 45 78 70 72 20 3d 20 73 71 6c pOBExpr = sql
20f00 69 74 65 33 45 78 70 72 53 6b 69 70 43 6f 6c 6c ite3ExprSkipColl
20f10 61 74 65 28 70 4f 72 64 65 72 42 79 2d 3e 61 5b ate(pOrderBy->a[
20f20 69 5d 2e 70 45 78 70 72 29 3b 0a 20 20 20 20 20 i].pExpr);.
20f30 20 69 66 28 20 70 4f 42 45 78 70 72 2d 3e 6f 70 if( pOBExpr->op
20f40 21 3d 54 4b 5f 43 4f 4c 55 4d 4e 20 29 20 63 6f !=TK_COLUMN ) co
20f50 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 69 66 ntinue;. if
20f60 28 20 70 4f 42 45 78 70 72 2d 3e 69 54 61 62 6c ( pOBExpr->iTabl
20f70 65 21 3d 69 43 75 72 20 29 20 63 6f 6e 74 69 6e e!=iCur ) contin
20f80 75 65 3b 0a 20 20 20 20 20 20 70 54 65 72 6d 20 ue;. pTerm
20f90 3d 20 73 71 6c 69 74 65 33 57 68 65 72 65 46 69 = sqlite3WhereFi
20fa0 6e 64 54 65 72 6d 28 26 70 57 49 6e 66 6f 2d 3e ndTerm(&pWInfo->
20fb0 73 57 43 2c 20 69 43 75 72 2c 20 70 4f 42 45 78 sWC, iCur, pOBEx
20fc0 70 72 2d 3e 69 43 6f 6c 75 6d 6e 2c 0a 20 20 20 pr->iColumn,.
20fd0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
20fe0 20 20 20 20 7e 72 65 61 64 79 2c 20 65 71 4f 70 ~ready, eqOp
20ff0 4d 61 73 6b 2c 20 30 29 3b 0a 20 20 20 20 20 20 Mask, 0);.
21000 69 66 28 20 70 54 65 72 6d 3d 3d 30 20 29 20 63 if( pTerm==0 ) c
21010 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 69 ontinue;. i
21020 66 28 20 70 54 65 72 6d 2d 3e 65 4f 70 65 72 61 f( pTerm->eOpera
21030 74 6f 72 3d 3d 57 4f 5f 49 4e 20 29 7b 0a 20 20 tor==WO_IN ){.
21040 20 20 20 20 20 20 2f 2a 20 49 4e 20 74 65 72 6d /* IN term
21050 73 20 61 72 65 20 6f 6e 6c 79 20 76 61 6c 69 64 s are only valid
21060 20 66 6f 72 20 73 6f 72 74 69 6e 67 20 69 6e 20 for sorting in
21070 74 68 65 20 4f 52 44 45 52 20 42 59 20 4c 49 4d the ORDER BY LIM
21080 49 54 20 0a 20 20 20 20 20 20 20 20 2a 2a 20 6f IT . ** o
21090 70 74 69 6d 69 7a 61 74 69 6f 6e 2c 20 61 6e 64 ptimization, and
210a0 20 74 68 65 6e 20 6f 6e 6c 79 20 69 66 20 74 68 then only if th
210b0 65 79 20 61 72 65 20 61 63 74 75 61 6c 6c 79 20 ey are actually
210c0 75 73 65 64 0a 20 20 20 20 20 20 20 20 2a 2a 20 used. **
210d0 62 79 20 74 68 65 20 71 75 65 72 79 20 70 6c 61 by the query pla
210e0 6e 20 2a 2f 0a 20 20 20 20 20 20 20 20 61 73 73 n */. ass
210f0 65 72 74 28 20 77 63 74 72 6c 46 6c 61 67 73 20 ert( wctrlFlags
21100 26 20 57 48 45 52 45 5f 4f 52 44 45 52 42 59 5f & WHERE_ORDERBY_
21110 4c 49 4d 49 54 20 29 3b 0a 20 20 20 20 20 20 20 LIMIT );.
21120 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 70 4c 6f 6f for(j=0; j<pLoo
21130 70 2d 3e 6e 4c 54 65 72 6d 20 26 26 20 70 54 65 p->nLTerm && pTe
21140 72 6d 21 3d 70 4c 6f 6f 70 2d 3e 61 4c 54 65 72 rm!=pLoop->aLTer
21150 6d 5b 6a 5d 3b 20 6a 2b 2b 29 7b 7d 0a 20 20 20 m[j]; j++){}.
21160 20 20 20 20 20 69 66 28 20 6a 3e 3d 70 4c 6f 6f if( j>=pLoo
21170 70 2d 3e 6e 4c 54 65 72 6d 20 29 20 63 6f 6e 74 p->nLTerm ) cont
21180 69 6e 75 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 inue;. }.
21190 20 20 20 20 69 66 28 20 28 70 54 65 72 6d 2d 3e if( (pTerm->
211a0 65 4f 70 65 72 61 74 6f 72 26 28 57 4f 5f 45 51 eOperator&(WO_EQ
211b0 7c 57 4f 5f 49 53 29 29 21 3d 30 20 26 26 20 70 |WO_IS))!=0 && p
211c0 4f 42 45 78 70 72 2d 3e 69 43 6f 6c 75 6d 6e 3e OBExpr->iColumn>
211d0 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66 =0 ){. if
211e0 28 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 6c ( sqlite3ExprCol
211f0 6c 53 65 71 4d 61 74 63 68 28 70 57 49 6e 66 6f lSeqMatch(pWInfo
21200 2d 3e 70 50 61 72 73 65 2c 20 0a 20 20 20 20 20 ->pParse, .
21210 20 20 20 20 20 20 20 20 20 20 20 20 20 70 4f 72 pOr
21220 64 65 72 42 79 2d 3e 61 5b 69 5d 2e 70 45 78 70 derBy->a[i].pExp
21230 72 2c 20 70 54 65 72 6d 2d 3e 70 45 78 70 72 29 r, pTerm->pExpr)
21240 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 ==0 ){.
21250 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 continue;.
21260 20 20 20 7d 0a 20 20 20 20 20 20 20 20 74 65 73 }. tes
21270 74 63 61 73 65 28 20 70 54 65 72 6d 2d 3e 70 45 tcase( pTerm->pE
21280 78 70 72 2d 3e 6f 70 3d 3d 54 4b 5f 49 53 20 29 xpr->op==TK_IS )
21290 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
212a0 6f 62 53 61 74 20 7c 3d 20 4d 41 53 4b 42 49 54 obSat |= MASKBIT
212b0 28 69 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 (i);. }..
212c0 69 66 28 20 28 70 4c 6f 6f 70 2d 3e 77 73 46 6c if( (pLoop->wsFl
212d0 61 67 73 20 26 20 57 48 45 52 45 5f 4f 4e 45 52 ags & WHERE_ONER
212e0 4f 57 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 OW)==0 ){.
212f0 69 66 28 20 70 4c 6f 6f 70 2d 3e 77 73 46 6c 61 if( pLoop->wsFla
21300 67 73 20 26 20 57 48 45 52 45 5f 49 50 4b 20 29 gs & WHERE_IPK )
21310 7b 0a 20 20 20 20 20 20 20 20 70 49 6e 64 65 78 {. pIndex
21320 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 6e 4b = 0;. nK
21330 65 79 43 6f 6c 20 3d 20 30 3b 0a 20 20 20 20 20 eyCol = 0;.
21340 20 20 20 6e 43 6f 6c 75 6d 6e 20 3d 20 31 3b 0a nColumn = 1;.
21350 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 }else if(
21360 28 70 49 6e 64 65 78 20 3d 20 70 4c 6f 6f 70 2d (pIndex = pLoop-
21370 3e 75 2e 62 74 72 65 65 2e 70 49 6e 64 65 78 29 >u.btree.pIndex)
21380 3d 3d 30 20 7c 7c 20 70 49 6e 64 65 78 2d 3e 62 ==0 || pIndex->b
21390 55 6e 6f 72 64 65 72 65 64 20 29 7b 0a 20 20 20 Unordered ){.
213a0 20 20 20 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 return 0;.
213b0 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
213c0 20 20 20 20 6e 4b 65 79 43 6f 6c 20 3d 20 70 49 nKeyCol = pI
213d0 6e 64 65 78 2d 3e 6e 4b 65 79 43 6f 6c 3b 0a 20 ndex->nKeyCol;.
213e0 20 20 20 20 20 20 20 6e 43 6f 6c 75 6d 6e 20 3d nColumn =
213f0 20 70 49 6e 64 65 78 2d 3e 6e 43 6f 6c 75 6d 6e pIndex->nColumn
21400 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 ;. assert
21410 28 20 6e 43 6f 6c 75 6d 6e 3d 3d 6e 4b 65 79 43 ( nColumn==nKeyC
21420 6f 6c 2b 31 20 7c 7c 20 21 48 61 73 52 6f 77 69 ol+1 || !HasRowi
21430 64 28 70 49 6e 64 65 78 2d 3e 70 54 61 62 6c 65 d(pIndex->pTable
21440 29 20 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 ) );. ass
21450 65 72 74 28 20 70 49 6e 64 65 78 2d 3e 61 69 43 ert( pIndex->aiC
21460 6f 6c 75 6d 6e 5b 6e 43 6f 6c 75 6d 6e 2d 31 5d olumn[nColumn-1]
21470 3d 3d 58 4e 5f 52 4f 57 49 44 0a 20 20 20 20 20 ==XN_ROWID.
21480 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
21490 20 20 20 20 20 7c 7c 20 21 48 61 73 52 6f 77 69 || !HasRowi
214a0 64 28 70 49 6e 64 65 78 2d 3e 70 54 61 62 6c 65 d(pIndex->pTable
214b0 29 29 3b 0a 20 20 20 20 20 20 20 20 69 73 4f 72 ));. isOr
214c0 64 65 72 44 69 73 74 69 6e 63 74 20 3d 20 49 73 derDistinct = Is
214d0 55 6e 69 71 75 65 49 6e 64 65 78 28 70 49 6e 64 UniqueIndex(pInd
214e0 65 78 29 3b 0a 20 20 20 20 20 20 7d 0a 0a 20 20 ex);. }..
214f0 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 74 68 72 6f /* Loop thro
21500 75 67 68 20 61 6c 6c 20 63 6f 6c 75 6d 6e 73 20 ugh all columns
21510 6f 66 20 74 68 65 20 69 6e 64 65 78 20 61 6e 64 of the index and
21520 20 64 65 61 6c 20 77 69 74 68 20 74 68 65 20 6f deal with the o
21530 6e 65 73 0a 20 20 20 20 20 20 2a 2a 20 74 68 61 nes. ** tha
21540 74 20 61 72 65 20 6e 6f 74 20 63 6f 6e 73 74 72 t are not constr
21550 61 69 6e 65 64 20 62 79 20 3d 3d 20 6f 72 20 49 ained by == or I
21560 4e 2e 0a 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 N.. */.
21570 20 20 72 65 76 20 3d 20 72 65 76 53 65 74 20 3d rev = revSet =
21580 20 30 3b 0a 20 20 20 20 20 20 64 69 73 74 69 6e 0;. distin
21590 63 74 43 6f 6c 75 6d 6e 73 20 3d 20 30 3b 0a 20 ctColumns = 0;.
215a0 20 20 20 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c for(j=0; j<
215b0 6e 43 6f 6c 75 6d 6e 3b 20 6a 2b 2b 29 7b 0a 20 nColumn; j++){.
215c0 20 20 20 20 20 20 20 75 38 20 62 4f 6e 63 65 20 u8 bOnce
215d0 3d 20 31 3b 20 2f 2a 20 54 72 75 65 20 74 6f 20 = 1; /* True to
215e0 72 75 6e 20 74 68 65 20 4f 52 44 45 52 20 42 59 run the ORDER BY
215f0 20 73 65 61 72 63 68 20 6c 6f 6f 70 20 2a 2f 0a search loop */.
21600 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 . assert(
21610 20 6a 3e 3d 70 4c 6f 6f 70 2d 3e 75 2e 62 74 72 j>=pLoop->u.btr
21620 65 65 2e 6e 45 71 20 0a 20 20 20 20 20 20 20 20 ee.nEq .
21630 20 20 20 20 7c 7c 20 28 70 4c 6f 6f 70 2d 3e 61 || (pLoop->a
21640 4c 54 65 72 6d 5b 6a 5d 3d 3d 30 29 3d 3d 28 6a LTerm[j]==0)==(j
21650 3c 70 4c 6f 6f 70 2d 3e 6e 53 6b 69 70 29 0a 20 <pLoop->nSkip).
21660 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 );.
21670 20 20 69 66 28 20 6a 3c 70 4c 6f 6f 70 2d 3e 75 if( j<pLoop->u
21680 2e 62 74 72 65 65 2e 6e 45 71 20 26 26 20 6a 3e .btree.nEq && j>
21690 3d 70 4c 6f 6f 70 2d 3e 6e 53 6b 69 70 20 29 7b =pLoop->nSkip ){
216a0 0a 20 20 20 20 20 20 20 20 20 20 75 31 36 20 65 . u16 e
216b0 4f 70 20 3d 20 70 4c 6f 6f 70 2d 3e 61 4c 54 65 Op = pLoop->aLTe
216c0 72 6d 5b 6a 5d 2d 3e 65 4f 70 65 72 61 74 6f 72 rm[j]->eOperator
216d0 3b 0a 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 ;.. /*
216e0 53 6b 69 70 20 6f 76 65 72 20 3d 3d 20 61 6e 64 Skip over == and
216f0 20 49 53 20 61 6e 64 20 49 53 4e 55 4c 4c 20 74 IS and ISNULL t
21700 65 72 6d 73 2e 20 20 28 41 6c 73 6f 20 73 6b 69 erms. (Also ski
21710 70 20 49 4e 20 74 65 72 6d 73 20 77 68 65 6e 0a p IN terms when.
21720 20 20 20 20 20 20 20 20 20 20 2a 2a 20 64 6f 69 ** doi
21730 6e 67 20 57 48 45 52 45 5f 4f 52 44 45 52 42 59 ng WHERE_ORDERBY
21740 5f 4c 49 4d 49 54 20 70 72 6f 63 65 73 73 69 6e _LIMIT processin
21750 67 29 2e 20 0a 20 20 20 20 20 20 20 20 20 20 2a g). . *
21760 2a 0a 20 20 20 20 20 20 20 20 20 20 2a 2a 20 49 *. ** I
21770 66 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 65 f the current te
21780 72 6d 20 69 73 20 61 20 63 6f 6c 75 6d 6e 20 6f rm is a column o
21790 66 20 61 6e 20 28 28 3f 2c 3f 29 20 49 4e 20 28 f an ((?,?) IN (
217a0 53 45 4c 45 43 54 2e 2e 2e 29 29 20 0a 20 20 20 SELECT...)) .
217b0 20 20 20 20 20 20 20 2a 2a 20 65 78 70 72 65 73 ** expres
217c0 73 69 6f 6e 20 66 6f 72 20 77 68 69 63 68 20 74 sion for which t
217d0 68 65 20 53 45 4c 45 43 54 20 72 65 74 75 72 6e he SELECT return
217e0 73 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 s more than one
217f0 63 6f 6c 75 6d 6e 2c 0a 20 20 20 20 20 20 20 20 column,.
21800 20 20 2a 2a 20 63 68 65 63 6b 20 74 68 61 74 20 ** check that
21810 69 74 20 69 73 20 74 68 65 20 6f 6e 6c 79 20 63 it is the only c
21820 6f 6c 75 6d 6e 20 75 73 65 64 20 62 79 20 74 68 olumn used by th
21830 69 73 20 6c 6f 6f 70 2e 20 4f 74 68 65 72 77 69 is loop. Otherwi
21840 73 65 2c 0a 20 20 20 20 20 20 20 20 20 20 2a 2a se,. **
21850 20 69 66 20 69 74 20 69 73 20 6f 6e 65 20 6f 66 if it is one of
21860 20 74 77 6f 20 6f 72 20 6d 6f 72 65 2c 20 6e 6f two or more, no
21870 6e 65 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e ne of the column
21880 73 20 63 61 6e 20 62 65 0a 20 20 20 20 20 20 20 s can be.
21890 20 20 20 2a 2a 20 63 6f 6e 73 69 64 65 72 65 64 ** considered
218a0 20 74 6f 20 6d 61 74 63 68 20 61 6e 20 4f 52 44 to match an ORD
218b0 45 52 20 42 59 20 74 65 72 6d 2e 20 20 2a 2f 0a ER BY term. */.
218c0 20 20 20 20 20 20 20 20 20 20 69 66 28 20 28 65 if( (e
218d0 4f 70 20 26 20 65 71 4f 70 4d 61 73 6b 29 21 3d Op & eqOpMask)!=
218e0 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 0 ){.
218f0 20 69 66 28 20 65 4f 70 20 26 20 57 4f 5f 49 53 if( eOp & WO_IS
21900 4e 55 4c 4c 20 29 7b 0a 20 20 20 20 20 20 20 20 NULL ){.
21910 20 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 testcase(
21920 69 73 4f 72 64 65 72 44 69 73 74 69 6e 63 74 20 isOrderDistinct
21930 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 );.
21940 20 69 73 4f 72 64 65 72 44 69 73 74 69 6e 63 74 isOrderDistinct
21950 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 = 0;.
21960 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 20 20 }.
21970 63 6f 6e 74 69 6e 75 65 3b 20 20 0a 20 20 20 20 continue; .
21980 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 }else if(
21990 41 4c 57 41 59 53 28 65 4f 70 20 26 20 57 4f 5f ALWAYS(eOp & WO_
219a0 49 4e 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 IN) ){.
219b0 20 20 20 2f 2a 20 41 4c 57 41 59 53 28 29 20 6a /* ALWAYS() j
219c0 75 73 74 69 66 69 63 61 74 69 6f 6e 3a 20 65 4f ustification: eO
219d0 70 20 69 73 20 61 6e 20 65 71 75 61 6c 69 74 79 p is an equality
219e0 20 6f 70 65 72 61 74 6f 72 20 64 75 65 20 74 6f operator due to
219f0 20 74 68 65 0a 20 20 20 20 20 20 20 20 20 20 20 the.
21a00 20 2a 2a 20 6a 3c 70 4c 6f 6f 70 2d 3e 75 2e 62 ** j<pLoop->u.b
21a10 74 72 65 65 2e 6e 45 71 20 63 6f 6e 73 74 72 61 tree.nEq constra
21a20 69 6e 74 20 61 62 6f 76 65 2e 20 20 41 6e 79 20 int above. Any
21a30 65 71 75 61 6c 69 74 79 20 6f 74 68 65 72 0a 20 equality other.
21a40 20 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 ** th
21a50 61 6e 20 57 4f 5f 49 4e 20 69 73 20 63 61 70 74 an WO_IN is capt
21a60 75 72 65 64 20 62 79 20 74 68 65 20 70 72 65 76 ured by the prev
21a70 69 6f 75 73 20 22 69 66 22 2e 20 20 53 6f 20 74 ious "if". So t
21a80 68 69 73 20 6f 6e 65 0a 20 20 20 20 20 20 20 20 his one.
21a90 20 20 20 20 2a 2a 20 61 6c 77 61 79 73 20 68 61 ** always ha
21aa0 73 20 74 6f 20 62 65 20 57 4f 5f 49 4e 2e 20 2a s to be WO_IN. *
21ab0 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 45 78 /. Ex
21ac0 70 72 20 2a 70 58 20 3d 20 70 4c 6f 6f 70 2d 3e pr *pX = pLoop->
21ad0 61 4c 54 65 72 6d 5b 6a 5d 2d 3e 70 45 78 70 72 aLTerm[j]->pExpr
21ae0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 66 6f ;. fo
21af0 72 28 69 3d 6a 2b 31 3b 20 69 3c 70 4c 6f 6f 70 r(i=j+1; i<pLoop
21b00 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 71 3b 20 69 ->u.btree.nEq; i
21b10 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 ++){.
21b20 20 20 20 69 66 28 20 70 4c 6f 6f 70 2d 3e 61 4c if( pLoop->aL
21b30 54 65 72 6d 5b 69 5d 2d 3e 70 45 78 70 72 3d 3d Term[i]->pExpr==
21b40 70 58 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 pX ){.
21b50 20 20 20 20 20 20 61 73 73 65 72 74 28 20 28 70 assert( (p
21b60 4c 6f 6f 70 2d 3e 61 4c 54 65 72 6d 5b 69 5d 2d Loop->aLTerm[i]-
21b70 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 57 4f 5f >eOperator & WO_
21b80 49 4e 29 20 29 3b 0a 20 20 20 20 20 20 20 20 20 IN) );.
21b90 20 20 20 20 20 20 20 62 4f 6e 63 65 20 3d 20 30 bOnce = 0
21ba0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ;.
21bb0 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 break;.
21bc0 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
21bd0 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
21be0 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 }. }..
21bf0 20 20 20 20 20 20 2f 2a 20 47 65 74 20 74 68 65 /* Get the
21c00 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 20 69 column number i
21c10 6e 20 74 68 65 20 74 61 62 6c 65 20 28 69 43 6f n the table (iCo
21c20 6c 75 6d 6e 29 20 61 6e 64 20 73 6f 72 74 20 6f lumn) and sort o
21c30 72 64 65 72 0a 20 20 20 20 20 20 20 20 2a 2a 20 rder. **
21c40 28 72 65 76 49 64 78 29 20 66 6f 72 20 74 68 65 (revIdx) for the
21c50 20 6a 2d 74 68 20 63 6f 6c 75 6d 6e 20 6f 66 20 j-th column of
21c60 74 68 65 20 69 6e 64 65 78 2e 0a 20 20 20 20 20 the index..
21c70 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 66 */. if
21c80 28 20 70 49 6e 64 65 78 20 29 7b 0a 20 20 20 20 ( pIndex ){.
21c90 20 20 20 20 20 20 69 43 6f 6c 75 6d 6e 20 3d 20 iColumn =
21ca0 70 49 6e 64 65 78 2d 3e 61 69 43 6f 6c 75 6d 6e pIndex->aiColumn
21cb0 5b 6a 5d 3b 0a 20 20 20 20 20 20 20 20 20 20 72 [j];. r
21cc0 65 76 49 64 78 20 3d 20 70 49 6e 64 65 78 2d 3e evIdx = pIndex->
21cd0 61 53 6f 72 74 4f 72 64 65 72 5b 6a 5d 3b 0a 20 aSortOrder[j];.
21ce0 20 20 20 20 20 20 20 20 20 69 66 28 20 69 43 6f if( iCo
21cf0 6c 75 6d 6e 3d 3d 70 49 6e 64 65 78 2d 3e 70 54 lumn==pIndex->pT
21d00 61 62 6c 65 2d 3e 69 50 4b 65 79 20 29 20 69 43 able->iPKey ) iC
21d10 6f 6c 75 6d 6e 20 3d 20 58 4e 5f 52 4f 57 49 44 olumn = XN_ROWID
21d20 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b ;. }else{
21d30 0a 20 20 20 20 20 20 20 20 20 20 69 43 6f 6c 75 . iColu
21d40 6d 6e 20 3d 20 58 4e 5f 52 4f 57 49 44 3b 0a 20 mn = XN_ROWID;.
21d50 20 20 20 20 20 20 20 20 20 72 65 76 49 64 78 20 revIdx
21d60 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 7d 0a 0a = 0;. }..
21d70 20 20 20 20 20 20 20 20 2f 2a 20 41 6e 20 75 6e /* An un
21d80 63 6f 6e 73 74 72 61 69 6e 65 64 20 63 6f 6c 75 constrained colu
21d90 6d 6e 20 74 68 61 74 20 6d 69 67 68 74 20 62 65 mn that might be
21da0 20 4e 55 4c 4c 20 6d 65 61 6e 73 20 74 68 61 74 NULL means that
21db0 20 74 68 69 73 0a 20 20 20 20 20 20 20 20 2a 2a this. **
21dc0 20 57 68 65 72 65 4c 6f 6f 70 20 69 73 20 6e 6f WhereLoop is no
21dd0 74 20 77 65 6c 6c 2d 6f 72 64 65 72 65 64 0a 20 t well-ordered.
21de0 20 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 */.
21df0 20 20 69 66 28 20 69 73 4f 72 64 65 72 44 69 73 if( isOrderDis
21e00 74 69 6e 63 74 0a 20 20 20 20 20 20 20 20 20 26 tinct. &
21e10 26 20 69 43 6f 6c 75 6d 6e 3e 3d 30 0a 20 20 20 & iColumn>=0.
21e20 20 20 20 20 20 20 26 26 20 6a 3e 3d 70 4c 6f 6f && j>=pLoo
21e30 70 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 71 0a 20 p->u.btree.nEq.
21e40 20 20 20 20 20 20 20 20 26 26 20 70 49 6e 64 65 && pInde
21e50 78 2d 3e 70 54 61 62 6c 65 2d 3e 61 43 6f 6c 5b x->pTable->aCol[
21e60 69 43 6f 6c 75 6d 6e 5d 2e 6e 6f 74 4e 75 6c 6c iColumn].notNull
21e70 3d 3d 30 0a 20 20 20 20 20 20 20 20 29 7b 0a 20 ==0. ){.
21e80 20 20 20 20 20 20 20 20 20 69 73 4f 72 64 65 72 isOrder
21e90 44 69 73 74 69 6e 63 74 20 3d 20 30 3b 0a 20 20 Distinct = 0;.
21ea0 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 20 }..
21eb0 20 2f 2a 20 46 69 6e 64 20 74 68 65 20 4f 52 44 /* Find the ORD
21ec0 45 52 20 42 59 20 74 65 72 6d 20 74 68 61 74 20 ER BY term that
21ed0 63 6f 72 72 65 73 70 6f 6e 64 73 20 74 6f 20 74 corresponds to t
21ee0 68 65 20 6a 2d 74 68 20 63 6f 6c 75 6d 6e 0a 20 he j-th column.
21ef0 20 20 20 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 ** of the
21f00 20 69 6e 64 65 78 20 61 6e 64 20 6d 61 72 6b 20 index and mark
21f10 74 68 61 74 20 4f 52 44 45 52 20 42 59 20 74 65 that ORDER BY te
21f20 72 6d 20 6f 66 66 20 0a 20 20 20 20 20 20 20 20 rm off .
21f30 2a 2f 0a 20 20 20 20 20 20 20 20 69 73 4d 61 74 */. isMat
21f40 63 68 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 ch = 0;.
21f50 66 6f 72 28 69 3d 30 3b 20 62 4f 6e 63 65 20 26 for(i=0; bOnce &
21f60 26 20 69 3c 6e 4f 72 64 65 72 42 79 3b 20 69 2b & i<nOrderBy; i+
21f70 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 +){. if
21f80 28 20 4d 41 53 4b 42 49 54 28 69 29 20 26 20 6f ( MASKBIT(i) & o
21f90 62 53 61 74 20 29 20 63 6f 6e 74 69 6e 75 65 3b bSat ) continue;
21fa0 0a 20 20 20 20 20 20 20 20 20 20 70 4f 42 45 78 . pOBEx
21fb0 70 72 20 3d 20 73 71 6c 69 74 65 33 45 78 70 72 pr = sqlite3Expr
21fc0 53 6b 69 70 43 6f 6c 6c 61 74 65 28 70 4f 72 64 SkipCollate(pOrd
21fd0 65 72 42 79 2d 3e 61 5b 69 5d 2e 70 45 78 70 72 erBy->a[i].pExpr
21fe0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 74 65 73 );. tes
21ff0 74 63 61 73 65 28 20 77 63 74 72 6c 46 6c 61 67 tcase( wctrlFlag
22000 73 20 26 20 57 48 45 52 45 5f 47 52 4f 55 50 42 s & WHERE_GROUPB
22010 59 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 74 Y );. t
22020 65 73 74 63 61 73 65 28 20 77 63 74 72 6c 46 6c estcase( wctrlFl
22030 61 67 73 20 26 20 57 48 45 52 45 5f 44 49 53 54 ags & WHERE_DIST
22040 49 4e 43 54 42 59 20 29 3b 0a 20 20 20 20 20 20 INCTBY );.
22050 20 20 20 20 69 66 28 20 28 77 63 74 72 6c 46 6c if( (wctrlFl
22060 61 67 73 20 26 20 28 57 48 45 52 45 5f 47 52 4f ags & (WHERE_GRO
22070 55 50 42 59 7c 57 48 45 52 45 5f 44 49 53 54 49 UPBY|WHERE_DISTI
22080 4e 43 54 42 59 29 29 3d 3d 30 20 29 20 62 4f 6e NCTBY))==0 ) bOn
22090 63 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 20 ce = 0;.
220a0 20 20 69 66 28 20 69 43 6f 6c 75 6d 6e 3e 3d 58 if( iColumn>=X
220b0 4e 5f 52 4f 57 49 44 20 29 7b 0a 20 20 20 20 20 N_ROWID ){.
220c0 20 20 20 20 20 20 20 69 66 28 20 70 4f 42 45 78 if( pOBEx
220d0 70 72 2d 3e 6f 70 21 3d 54 4b 5f 43 4f 4c 55 4d pr->op!=TK_COLUM
220e0 4e 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 N ) continue;.
220f0 20 20 20 20 20 20 20 20 20 20 69 66 28 20 70 4f if( pO
22100 42 45 78 70 72 2d 3e 69 54 61 62 6c 65 21 3d 69 BExpr->iTable!=i
22110 43 75 72 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a Cur ) continue;.
22120 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 if(
22130 70 4f 42 45 78 70 72 2d 3e 69 43 6f 6c 75 6d 6e pOBExpr->iColumn
22140 21 3d 69 43 6f 6c 75 6d 6e 20 29 20 63 6f 6e 74 !=iColumn ) cont
22150 69 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 20 20 inue;.
22160 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 }else{.
22170 20 20 20 45 78 70 72 20 2a 70 49 64 78 45 78 70 Expr *pIdxExp
22180 72 20 3d 20 70 49 6e 64 65 78 2d 3e 61 43 6f 6c r = pIndex->aCol
22190 45 78 70 72 2d 3e 61 5b 6a 5d 2e 70 45 78 70 72 Expr->a[j].pExpr
221a0 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 ;. if
221b0 28 20 73 71 6c 69 74 65 33 45 78 70 72 43 6f 6d ( sqlite3ExprCom
221c0 70 61 72 65 53 6b 69 70 28 70 4f 42 45 78 70 72 pareSkip(pOBExpr
221d0 2c 20 70 49 64 78 45 78 70 72 2c 20 69 43 75 72 , pIdxExpr, iCur
221e0 29 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 ) ){.
221f0 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 continue;.
22200 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
22210 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
22220 20 69 66 28 20 69 43 6f 6c 75 6d 6e 21 3d 58 4e if( iColumn!=XN
22230 5f 52 4f 57 49 44 20 29 7b 0a 20 20 20 20 20 20 _ROWID ){.
22240 20 20 20 20 20 20 70 43 6f 6c 6c 20 3d 20 73 71 pColl = sq
22250 6c 69 74 65 33 45 78 70 72 4e 4e 43 6f 6c 6c 53 lite3ExprNNCollS
22260 65 71 28 70 57 49 6e 66 6f 2d 3e 70 50 61 72 73 eq(pWInfo->pPars
22270 65 2c 20 70 4f 72 64 65 72 42 79 2d 3e 61 5b 69 e, pOrderBy->a[i
22280 5d 2e 70 45 78 70 72 29 3b 0a 20 20 20 20 20 20 ].pExpr);.
22290 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 74 65 if( sqlite
222a0 33 53 74 72 49 43 6d 70 28 70 43 6f 6c 6c 2d 3e 3StrICmp(pColl->
222b0 7a 4e 61 6d 65 2c 20 70 49 6e 64 65 78 2d 3e 61 zName, pIndex->a
222c0 7a 43 6f 6c 6c 5b 6a 5d 29 21 3d 30 20 29 20 63 zColl[j])!=0 ) c
222d0 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 20 ontinue;.
222e0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 20 70 }. p
222f0 4c 6f 6f 70 2d 3e 75 2e 62 74 72 65 65 2e 6e 49 Loop->u.btree.nI
22300 64 78 43 6f 6c 20 3d 20 6a 2b 31 3b 0a 20 20 20 dxCol = j+1;.
22310 20 20 20 20 20 20 20 69 73 4d 61 74 63 68 20 3d isMatch =
22320 20 31 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 1;. br
22330 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 eak;. }.
22340 20 20 20 20 20 20 20 69 66 28 20 69 73 4d 61 74 if( isMat
22350 63 68 20 26 26 20 28 77 63 74 72 6c 46 6c 61 67 ch && (wctrlFlag
22360 73 20 26 20 57 48 45 52 45 5f 47 52 4f 55 50 42 s & WHERE_GROUPB
22370 59 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 Y)==0 ){.
22380 20 20 20 2f 2a 20 4d 61 6b 65 20 73 75 72 65 20 /* Make sure
22390 74 68 65 20 73 6f 72 74 20 6f 72 64 65 72 20 69 the sort order i
223a0 73 20 63 6f 6d 70 61 74 69 62 6c 65 20 69 6e 20 s compatible in
223b0 61 6e 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 an ORDER BY clau
223c0 73 65 2e 0a 20 20 20 20 20 20 20 20 20 20 2a 2a se.. **
223d0 20 53 6f 72 74 20 6f 72 64 65 72 20 69 73 20 69 Sort order is i
223e0 72 72 65 6c 65 76 61 6e 74 20 66 6f 72 20 61 20 rrelevant for a
223f0 47 52 4f 55 50 20 42 59 20 63 6c 61 75 73 65 2e GROUP BY clause.
22400 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 69 66 */. if
22410 28 20 72 65 76 53 65 74 20 29 7b 0a 20 20 20 20 ( revSet ){.
22420 20 20 20 20 20 20 20 20 69 66 28 20 28 72 65 76 if( (rev
22430 20 5e 20 72 65 76 49 64 78 29 21 3d 70 4f 72 64 ^ revIdx)!=pOrd
22440 65 72 42 79 2d 3e 61 5b 69 5d 2e 73 6f 72 74 4f erBy->a[i].sortO
22450 72 64 65 72 20 29 20 69 73 4d 61 74 63 68 20 3d rder ) isMatch =
22460 20 30 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 65 0;. }e
22470 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 20 lse{.
22480 20 72 65 76 20 3d 20 72 65 76 49 64 78 20 5e 20 rev = revIdx ^
22490 70 4f 72 64 65 72 42 79 2d 3e 61 5b 69 5d 2e 73 pOrderBy->a[i].s
224a0 6f 72 74 4f 72 64 65 72 3b 0a 20 20 20 20 20 20 ortOrder;.
224b0 20 20 20 20 20 20 69 66 28 20 72 65 76 20 29 20 if( rev )
224c0 2a 70 52 65 76 4d 61 73 6b 20 7c 3d 20 4d 41 53 *pRevMask |= MAS
224d0 4b 42 49 54 28 69 4c 6f 6f 70 29 3b 0a 20 20 20 KBIT(iLoop);.
224e0 20 20 20 20 20 20 20 20 20 72 65 76 53 65 74 20 revSet
224f0 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 20 20 7d = 1;. }
22500 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
22510 20 20 20 69 66 28 20 69 73 4d 61 74 63 68 20 29 if( isMatch )
22520 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 {. if(
22530 69 43 6f 6c 75 6d 6e 3d 3d 58 4e 5f 52 4f 57 49 iColumn==XN_ROWI
22540 44 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 D ){.
22550 20 74 65 73 74 63 61 73 65 28 20 64 69 73 74 69 testcase( disti
22560 6e 63 74 43 6f 6c 75 6d 6e 73 3d 3d 30 20 29 3b nctColumns==0 );
22570 0a 20 20 20 20 20 20 20 20 20 20 20 20 64 69 73 . dis
22580 74 69 6e 63 74 43 6f 6c 75 6d 6e 73 20 3d 20 31 tinctColumns = 1
22590 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
225a0 20 20 20 20 20 20 20 20 6f 62 53 61 74 20 7c 3d obSat |=
225b0 20 4d 41 53 4b 42 49 54 28 69 29 3b 0a 20 20 20 MASKBIT(i);.
225c0 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
225d0 20 20 20 20 20 20 2f 2a 20 4e 6f 20 6d 61 74 63 /* No matc
225e0 68 20 66 6f 75 6e 64 20 2a 2f 0a 20 20 20 20 20 h found */.
225f0 20 20 20 20 20 69 66 28 20 6a 3d 3d 30 20 7c 7c if( j==0 ||
22600 20 6a 3c 6e 4b 65 79 43 6f 6c 20 29 7b 0a 20 20 j<nKeyCol ){.
22610 20 20 20 20 20 20 20 20 20 20 74 65 73 74 63 61 testca
22620 73 65 28 20 69 73 4f 72 64 65 72 44 69 73 74 69 se( isOrderDisti
22630 6e 63 74 21 3d 30 20 29 3b 0a 20 20 20 20 20 20 nct!=0 );.
22640 20 20 20 20 20 20 69 73 4f 72 64 65 72 44 69 73 isOrderDis
22650 74 69 6e 63 74 20 3d 20 30 3b 0a 20 20 20 20 20 tinct = 0;.
22660 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 20 }.
22670 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 break;.
22680 7d 0a 20 20 20 20 20 20 7d 20 2f 2a 20 65 6e 64 }. } /* end
22690 20 4c 6f 6f 70 20 6f 76 65 72 20 61 6c 6c 20 69 Loop over all i
226a0 6e 64 65 78 20 63 6f 6c 75 6d 6e 73 20 2a 2f 0a ndex columns */.
226b0 20 20 20 20 20 20 69 66 28 20 64 69 73 74 69 6e if( distin
226c0 63 74 43 6f 6c 75 6d 6e 73 20 29 7b 0a 20 20 20 ctColumns ){.
226d0 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 69 testcase( i
226e0 73 4f 72 64 65 72 44 69 73 74 69 6e 63 74 3d 3d sOrderDistinct==
226f0 30 20 29 3b 0a 20 20 20 20 20 20 20 20 69 73 4f 0 );. isO
22700 72 64 65 72 44 69 73 74 69 6e 63 74 20 3d 20 31 rderDistinct = 1
22710 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 20 ;. }. }
22720 2f 2a 20 65 6e 64 2d 69 66 20 6e 6f 74 20 6f 6e /* end-if not on
22730 65 2d 72 6f 77 20 2a 2f 0a 0a 20 20 20 20 2f 2a e-row */.. /*
22740 20 4d 61 72 6b 20 6f 66 66 20 61 6e 79 20 6f 74 Mark off any ot
22750 68 65 72 20 4f 52 44 45 52 20 42 59 20 74 65 72 her ORDER BY ter
22760 6d 73 20 74 68 61 74 20 72 65 66 65 72 65 6e 63 ms that referenc
22770 65 20 70 4c 6f 6f 70 20 2a 2f 0a 20 20 20 20 69 e pLoop */. i
22780 66 28 20 69 73 4f 72 64 65 72 44 69 73 74 69 6e f( isOrderDistin
22790 63 74 20 29 7b 0a 20 20 20 20 20 20 6f 72 64 65 ct ){. orde
227a0 72 44 69 73 74 69 6e 63 74 4d 61 73 6b 20 7c 3d rDistinctMask |=
227b0 20 70 4c 6f 6f 70 2d 3e 6d 61 73 6b 53 65 6c 66 pLoop->maskSelf
227c0 3b 0a 20 20 20 20 20 20 66 6f 72 28 69 3d 30 3b ;. for(i=0;
227d0 20 69 3c 6e 4f 72 64 65 72 42 79 3b 20 69 2b 2b i<nOrderBy; i++
227e0 29 7b 0a 20 20 20 20 20 20 20 20 45 78 70 72 20 ){. Expr
227f0 2a 70 3b 0a 20 20 20 20 20 20 20 20 42 69 74 6d *p;. Bitm
22800 61 73 6b 20 6d 54 65 72 6d 3b 0a 20 20 20 20 20 ask mTerm;.
22810 20 20 20 69 66 28 20 4d 41 53 4b 42 49 54 28 69 if( MASKBIT(i
22820 29 20 26 20 6f 62 53 61 74 20 29 20 63 6f 6e 74 ) & obSat ) cont
22830 69 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 70 20 inue;. p
22840 3d 20 70 4f 72 64 65 72 42 79 2d 3e 61 5b 69 5d = pOrderBy->a[i]
22850 2e 70 45 78 70 72 3b 0a 20 20 20 20 20 20 20 20 .pExpr;.
22860 6d 54 65 72 6d 20 3d 20 73 71 6c 69 74 65 33 57 mTerm = sqlite3W
22870 68 65 72 65 45 78 70 72 55 73 61 67 65 28 26 70 hereExprUsage(&p
22880 57 49 6e 66 6f 2d 3e 73 4d 61 73 6b 53 65 74 2c WInfo->sMaskSet,
22890 70 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 p);. if(
228a0 6d 54 65 72 6d 3d 3d 30 20 26 26 20 21 73 71 6c mTerm==0 && !sql
228b0 69 74 65 33 45 78 70 72 49 73 43 6f 6e 73 74 61 ite3ExprIsConsta
228c0 6e 74 28 70 29 20 29 20 63 6f 6e 74 69 6e 75 65 nt(p) ) continue
228d0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 28 6d ;. if( (m
228e0 54 65 72 6d 26 7e 6f 72 64 65 72 44 69 73 74 69 Term&~orderDisti
228f0 6e 63 74 4d 61 73 6b 29 3d 3d 30 20 29 7b 0a 20 nctMask)==0 ){.
22900 20 20 20 20 20 20 20 20 20 6f 62 53 61 74 20 7c obSat |
22910 3d 20 4d 41 53 4b 42 49 54 28 69 29 3b 0a 20 20 = MASKBIT(i);.
22920 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
22930 20 20 20 20 7d 0a 20 20 7d 20 2f 2a 20 45 6e 64 }. } /* End
22940 20 74 68 65 20 6c 6f 6f 70 20 6f 76 65 72 20 61 the loop over a
22950 6c 6c 20 57 68 65 72 65 4c 6f 6f 70 73 20 66 72 ll WhereLoops fr
22960 6f 6d 20 6f 75 74 65 72 2d 6d 6f 73 74 20 64 6f om outer-most do
22970 77 6e 20 74 6f 20 69 6e 6e 65 72 2d 6d 6f 73 74 wn to inner-most
22980 20 2a 2f 0a 20 20 69 66 28 20 6f 62 53 61 74 3d */. if( obSat=
22990 3d 6f 62 44 6f 6e 65 20 29 20 72 65 74 75 72 6e =obDone ) return
229a0 20 28 69 38 29 6e 4f 72 64 65 72 42 79 3b 0a 20 (i8)nOrderBy;.
229b0 20 69 66 28 20 21 69 73 4f 72 64 65 72 44 69 73 if( !isOrderDis
229c0 74 69 6e 63 74 20 29 7b 0a 20 20 20 20 66 6f 72 tinct ){. for
229d0 28 69 3d 6e 4f 72 64 65 72 42 79 2d 31 3b 20 69 (i=nOrderBy-1; i
229e0 3e 30 3b 20 69 2d 2d 29 7b 0a 20 20 20 20 20 20 >0; i--){.
229f0 42 69 74 6d 61 73 6b 20 6d 20 3d 20 4d 41 53 4b Bitmask m = MASK
22a00 42 49 54 28 69 29 20 2d 20 31 3b 0a 20 20 20 20 BIT(i) - 1;.
22a10 20 20 69 66 28 20 28 6f 62 53 61 74 26 6d 29 3d if( (obSat&m)=
22a20 3d 6d 20 29 20 72 65 74 75 72 6e 20 69 3b 0a 20 =m ) return i;.
22a30 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 }. return
22a40 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 0;. }. return
22a50 2d 31 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 49 66 -1;.}.../*.** If
22a60 20 74 68 65 20 57 48 45 52 45 5f 47 52 4f 55 50 the WHERE_GROUP
22a70 42 59 20 66 6c 61 67 20 69 73 20 73 65 74 20 69 BY flag is set i
22a80 6e 20 74 68 65 20 6d 61 73 6b 20 70 61 73 73 65 n the mask passe
22a90 64 20 74 6f 20 73 71 6c 69 74 65 33 57 68 65 72 d to sqlite3Wher
22aa0 65 42 65 67 69 6e 28 29 2c 0a 2a 2a 20 74 68 65 eBegin(),.** the
22ab0 20 70 6c 61 6e 6e 65 72 20 61 73 73 75 6d 65 73 planner assumes
22ac0 20 74 68 61 74 20 74 68 65 20 73 70 65 63 69 66 that the specif
22ad0 69 65 64 20 70 4f 72 64 65 72 42 79 20 6c 69 73 ied pOrderBy lis
22ae0 74 20 69 73 20 61 63 74 75 61 6c 6c 79 20 61 20 t is actually a
22af0 47 52 4f 55 50 0a 2a 2a 20 42 59 20 63 6c 61 75 GROUP.** BY clau
22b00 73 65 20 2d 20 61 6e 64 20 73 6f 20 61 6e 79 20 se - and so any
22b10 6f 72 64 65 72 20 74 68 61 74 20 67 72 6f 75 70 order that group
22b20 73 20 72 6f 77 73 20 61 73 20 72 65 71 75 69 72 s rows as requir
22b30 65 64 20 73 61 74 69 73 66 69 65 73 20 74 68 65 ed satisfies the
22b40 0a 2a 2a 20 72 65 71 75 65 73 74 2e 0a 2a 2a 0a .** request..**.
22b50 2a 2a 20 4e 6f 72 6d 61 6c 6c 79 2c 20 69 6e 20 ** Normally, in
22b60 74 68 69 73 20 63 61 73 65 20 69 74 20 69 73 20 this case it is
22b70 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 not possible for
22b80 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 64 the caller to d
22b90 65 74 65 72 6d 69 6e 65 0a 2a 2a 20 77 68 65 74 etermine.** whet
22ba0 68 65 72 20 6f 72 20 6e 6f 74 20 74 68 65 20 72 her or not the r
22bb0 6f 77 73 20 61 72 65 20 72 65 61 6c 6c 79 20 62 ows are really b
22bc0 65 69 6e 67 20 64 65 6c 69 76 65 72 65 64 20 69 eing delivered i
22bd0 6e 20 73 6f 72 74 65 64 20 6f 72 64 65 72 2c 20 n sorted order,
22be0 6f 72 0a 2a 2a 20 6a 75 73 74 20 69 6e 20 73 6f or.** just in so
22bf0 6d 65 20 6f 74 68 65 72 20 6f 72 64 65 72 20 74 me other order t
22c00 68 61 74 20 70 72 6f 76 69 64 65 73 20 74 68 65 hat provides the
22c10 20 72 65 71 75 69 72 65 64 20 67 72 6f 75 70 69 required groupi
22c20 6e 67 2e 20 48 6f 77 65 76 65 72 2c 0a 2a 2a 20 ng. However,.**
22c30 69 66 20 74 68 65 20 57 48 45 52 45 5f 53 4f 52 if the WHERE_SOR
22c40 54 42 59 47 52 4f 55 50 20 66 6c 61 67 20 69 73 TBYGROUP flag is
22c50 20 61 6c 73 6f 20 70 61 73 73 65 64 20 74 6f 20 also passed to
22c60 73 71 6c 69 74 65 33 57 68 65 72 65 42 65 67 69 sqlite3WhereBegi
22c70 6e 28 29 2c 20 74 68 65 6e 0a 2a 2a 20 74 68 69 n(), then.** thi
22c80 73 20 66 75 6e 63 74 69 6f 6e 20 6d 61 79 20 62 s function may b
22c90 65 20 63 61 6c 6c 65 64 20 6f 6e 20 74 68 65 20 e called on the
22ca0 72 65 74 75 72 6e 65 64 20 57 68 65 72 65 49 6e returned WhereIn
22cb0 66 6f 20 6f 62 6a 65 63 74 2e 20 49 74 20 72 65 fo object. It re
22cc0 74 75 72 6e 73 0a 2a 2a 20 74 72 75 65 20 69 66 turns.** true if
22cd0 20 74 68 65 20 72 6f 77 73 20 72 65 61 6c 6c 79 the rows really
22ce0 20 77 69 6c 6c 20 62 65 20 73 6f 72 74 65 64 20 will be sorted
22cf0 69 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 64 in the specified
22d00 20 6f 72 64 65 72 2c 20 6f 72 20 66 61 6c 73 65 order, or false
22d10 0a 2a 2a 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a .** otherwise..*
22d20 2a 0a 2a 2a 20 46 6f 72 20 65 78 61 6d 70 6c 65 *.** For example
22d30 2c 20 61 73 73 75 6d 69 6e 67 3a 0a 2a 2a 0a 2a , assuming:.**.*
22d40 2a 20 20 20 43 52 45 41 54 45 20 49 4e 44 45 58 * CREATE INDEX
22d50 20 69 31 20 4f 4e 20 74 31 28 78 2c 20 59 29 3b i1 ON t1(x, Y);
22d60 0a 2a 2a 0a 2a 2a 20 74 68 65 6e 0a 2a 2a 0a 2a .**.** then.**.*
22d70 2a 20 20 20 53 45 4c 45 43 54 20 2a 20 46 52 4f * SELECT * FRO
22d80 4d 20 74 31 20 47 52 4f 55 50 20 42 59 20 78 2c M t1 GROUP BY x,
22d90 79 20 4f 52 44 45 52 20 42 59 20 78 2c 79 3b 20 y ORDER BY x,y;
22da0 20 20 2d 2d 20 49 73 53 6f 72 74 65 64 28 29 3d -- IsSorted()=
22db0 3d 31 0a 2a 2a 20 20 20 53 45 4c 45 43 54 20 2a =1.** SELECT *
22dc0 20 46 52 4f 4d 20 74 31 20 47 52 4f 55 50 20 42 FROM t1 GROUP B
22dd0 59 20 79 2c 78 20 4f 52 44 45 52 20 42 59 20 79 Y y,x ORDER BY y
22de0 2c 78 3b 20 20 20 2d 2d 20 49 73 53 6f 72 74 65 ,x; -- IsSorte
22df0 64 28 29 3d 3d 30 0a 2a 2f 0a 69 6e 74 20 73 71 d()==0.*/.int sq
22e00 6c 69 74 65 33 57 68 65 72 65 49 73 53 6f 72 74 lite3WhereIsSort
22e10 65 64 28 57 68 65 72 65 49 6e 66 6f 20 2a 70 57 ed(WhereInfo *pW
22e20 49 6e 66 6f 29 7b 0a 20 20 61 73 73 65 72 74 28 Info){. assert(
22e30 20 70 57 49 6e 66 6f 2d 3e 77 63 74 72 6c 46 6c pWInfo->wctrlFl
22e40 61 67 73 20 26 20 57 48 45 52 45 5f 47 52 4f 55 ags & WHERE_GROU
22e50 50 42 59 20 29 3b 0a 20 20 61 73 73 65 72 74 28 PBY );. assert(
22e60 20 70 57 49 6e 66 6f 2d 3e 77 63 74 72 6c 46 6c pWInfo->wctrlFl
22e70 61 67 73 20 26 20 57 48 45 52 45 5f 53 4f 52 54 ags & WHERE_SORT
22e80 42 59 47 52 4f 55 50 20 29 3b 0a 20 20 72 65 74 BYGROUP );. ret
22e90 75 72 6e 20 70 57 49 6e 66 6f 2d 3e 73 6f 72 74 urn pWInfo->sort
22ea0 65 64 3b 0a 7d 0a 0a 23 69 66 64 65 66 20 57 48 ed;.}..#ifdef WH
22eb0 45 52 45 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 ERETRACE_ENABLED
22ec0 0a 2f 2a 20 46 6f 72 20 64 65 62 75 67 67 69 6e ./* For debuggin
22ed0 67 20 75 73 65 20 6f 6e 6c 79 3a 20 2a 2f 0a 73 g use only: */.s
22ee0 74 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 tatic const char
22ef0 20 2a 77 68 65 72 65 50 61 74 68 4e 61 6d 65 28 *wherePathName(
22f00 57 68 65 72 65 50 61 74 68 20 2a 70 50 61 74 68 WherePath *pPath
22f10 2c 20 69 6e 74 20 6e 4c 6f 6f 70 2c 20 57 68 65 , int nLoop, Whe
22f20 72 65 4c 6f 6f 70 20 2a 70 4c 61 73 74 29 7b 0a reLoop *pLast){.
22f30 20 20 73 74 61 74 69 63 20 63 68 61 72 20 7a 4e static char zN
22f40 61 6d 65 5b 36 35 5d 3b 0a 20 20 69 6e 74 20 69 ame[65];. int i
22f50 3b 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 6e ;. for(i=0; i<n
22f60 4c 6f 6f 70 3b 20 69 2b 2b 29 7b 20 7a 4e 61 6d Loop; i++){ zNam
22f70 65 5b 69 5d 20 3d 20 70 50 61 74 68 2d 3e 61 4c e[i] = pPath->aL
22f80 6f 6f 70 5b 69 5d 2d 3e 63 49 64 3b 20 7d 0a 20 oop[i]->cId; }.
22f90 20 69 66 28 20 70 4c 61 73 74 20 29 20 7a 4e 61 if( pLast ) zNa
22fa0 6d 65 5b 69 2b 2b 5d 20 3d 20 70 4c 61 73 74 2d me[i++] = pLast-
22fb0 3e 63 49 64 3b 0a 20 20 7a 4e 61 6d 65 5b 69 5d >cId;. zName[i]
22fc0 20 3d 20 30 3b 0a 20 20 72 65 74 75 72 6e 20 7a = 0;. return z
22fd0 4e 61 6d 65 3b 0a 7d 0a 23 65 6e 64 69 66 0a 0a Name;.}.#endif..
22fe0 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 74 68 65 /*.** Return the
22ff0 20 63 6f 73 74 20 6f 66 20 73 6f 72 74 69 6e 67 cost of sorting
23000 20 6e 52 6f 77 20 72 6f 77 73 2c 20 61 73 73 75 nRow rows, assu
23010 6d 69 6e 67 20 74 68 61 74 20 74 68 65 20 6b 65 ming that the ke
23020 79 73 20 68 61 76 65 20 0a 2a 2a 20 6e 4f 72 64 ys have .** nOrd
23030 65 72 62 79 20 63 6f 6c 75 6d 6e 73 20 61 6e 64 erby columns and
23040 20 74 68 61 74 20 74 68 65 20 66 69 72 73 74 20 that the first
23050 6e 53 6f 72 74 65 64 20 63 6f 6c 75 6d 6e 73 20 nSorted columns
23060 61 72 65 20 61 6c 72 65 61 64 79 20 69 6e 0a 2a are already in.*
23070 2a 20 6f 72 64 65 72 2e 0a 2a 2f 0a 73 74 61 74 * order..*/.stat
23080 69 63 20 4c 6f 67 45 73 74 20 77 68 65 72 65 53 ic LogEst whereS
23090 6f 72 74 69 6e 67 43 6f 73 74 28 0a 20 20 57 68 ortingCost(. Wh
230a0 65 72 65 49 6e 66 6f 20 2a 70 57 49 6e 66 6f 2c ereInfo *pWInfo,
230b0 0a 20 20 4c 6f 67 45 73 74 20 6e 52 6f 77 2c 0a . LogEst nRow,.
230c0 20 20 69 6e 74 20 6e 4f 72 64 65 72 42 79 2c 0a int nOrderBy,.
230d0 20 20 69 6e 74 20 6e 53 6f 72 74 65 64 0a 29 7b int nSorted.){
230e0 0a 20 20 2f 2a 20 54 55 4e 49 4e 47 3a 20 45 73 . /* TUNING: Es
230f0 74 69 6d 61 74 65 64 20 63 6f 73 74 20 6f 66 20 timated cost of
23100 61 20 66 75 6c 6c 20 65 78 74 65 72 6e 61 6c 20 a full external
23110 73 6f 72 74 2c 20 77 68 65 72 65 20 4e 20 69 73 sort, where N is
23120 20 0a 20 20 2a 2a 20 74 68 65 20 6e 75 6d 62 65 . ** the numbe
23130 72 20 6f 66 20 72 6f 77 73 20 74 6f 20 73 6f 72 r of rows to sor
23140 74 20 69 73 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 t is:. **. **
23150 20 20 63 6f 73 74 20 3d 20 28 33 2e 30 20 2a 20 cost = (3.0 *
23160 4e 20 2a 20 6c 6f 67 28 4e 29 29 2e 0a 20 20 2a N * log(N)).. *
23170 2a 20 0a 20 20 2a 2a 20 4f 72 2c 20 69 66 20 74 * . ** Or, if t
23180 68 65 20 6f 72 64 65 72 2d 62 79 20 63 6c 61 75 he order-by clau
23190 73 65 20 68 61 73 20 58 20 74 65 72 6d 73 20 62 se has X terms b
231a0 75 74 20 6f 6e 6c 79 20 74 68 65 20 6c 61 73 74 ut only the last
231b0 20 59 20 0a 20 20 2a 2a 20 74 65 72 6d 73 20 61 Y . ** terms a
231c0 72 65 20 6f 75 74 20 6f 66 20 6f 72 64 65 72 2c re out of order,
231d0 20 74 68 65 6e 20 62 6c 6f 63 6b 2d 73 6f 72 74 then block-sort
231e0 69 6e 67 20 77 69 6c 6c 20 72 65 64 75 63 65 20 ing will reduce
231f0 74 68 65 20 0a 20 20 2a 2a 20 73 6f 72 74 69 6e the . ** sortin
23200 67 20 63 6f 73 74 20 74 6f 3a 0a 20 20 2a 2a 0a g cost to:. **.
23210 20 20 2a 2a 20 20 20 63 6f 73 74 20 3d 20 28 33 ** cost = (3
23220 2e 30 20 2a 20 4e 20 2a 20 6c 6f 67 28 4e 29 29 .0 * N * log(N))
23230 20 2a 20 28 59 2f 58 29 0a 20 20 2a 2a 0a 20 20 * (Y/X). **.
23240 2a 2a 20 54 68 65 20 28 59 2f 58 29 20 74 65 72 ** The (Y/X) ter
23250 6d 20 69 73 20 69 6d 70 6c 65 6d 65 6e 74 65 64 m is implemented
23260 20 75 73 69 6e 67 20 73 74 61 63 6b 20 76 61 72 using stack var
23270 69 61 62 6c 65 20 72 53 63 61 6c 65 0a 20 20 2a iable rScale. *
23280 2a 20 62 65 6c 6f 77 2e 20 20 2a 2f 0a 20 20 4c * below. */. L
23290 6f 67 45 73 74 20 72 53 63 61 6c 65 2c 20 72 53 ogEst rScale, rS
232a0 6f 72 74 43 6f 73 74 3b 0a 20 20 61 73 73 65 72 ortCost;. asser
232b0 74 28 20 6e 4f 72 64 65 72 42 79 3e 30 20 26 26 t( nOrderBy>0 &&
232c0 20 36 36 3d 3d 73 71 6c 69 74 65 33 4c 6f 67 45 66==sqlite3LogE
232d0 73 74 28 31 30 30 29 20 29 3b 0a 20 20 72 53 63 st(100) );. rSc
232e0 61 6c 65 20 3d 20 73 71 6c 69 74 65 33 4c 6f 67 ale = sqlite3Log
232f0 45 73 74 28 28 6e 4f 72 64 65 72 42 79 2d 6e 53 Est((nOrderBy-nS
23300 6f 72 74 65 64 29 2a 31 30 30 2f 6e 4f 72 64 65 orted)*100/nOrde
23310 72 42 79 29 20 2d 20 36 36 3b 0a 20 20 72 53 6f rBy) - 66;. rSo
23320 72 74 43 6f 73 74 20 3d 20 6e 52 6f 77 20 2b 20 rtCost = nRow +
23330 72 53 63 61 6c 65 20 2b 20 31 36 3b 0a 0a 20 20 rScale + 16;..
23340 2f 2a 20 4d 75 6c 74 69 70 6c 65 20 62 79 20 6c /* Multiple by l
23350 6f 67 28 4d 29 20 77 68 65 72 65 20 4d 20 69 73 og(M) where M is
23360 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 6f the number of o
23370 75 74 70 75 74 20 72 6f 77 73 2e 0a 20 20 2a 2a utput rows.. **
23380 20 55 73 65 20 74 68 65 20 4c 49 4d 49 54 20 66 Use the LIMIT f
23390 6f 72 20 4d 20 69 66 20 69 74 20 69 73 20 73 6d or M if it is sm
233a0 61 6c 6c 65 72 20 2a 2f 0a 20 20 69 66 28 20 28 aller */. if( (
233b0 70 57 49 6e 66 6f 2d 3e 77 63 74 72 6c 46 6c 61 pWInfo->wctrlFla
233c0 67 73 20 26 20 57 48 45 52 45 5f 55 53 45 5f 4c gs & WHERE_USE_L
233d0 49 4d 49 54 29 21 3d 30 20 26 26 20 70 57 49 6e IMIT)!=0 && pWIn
233e0 66 6f 2d 3e 69 4c 69 6d 69 74 3c 6e 52 6f 77 20 fo->iLimit<nRow
233f0 29 7b 0a 20 20 20 20 6e 52 6f 77 20 3d 20 70 57 ){. nRow = pW
23400 49 6e 66 6f 2d 3e 69 4c 69 6d 69 74 3b 0a 20 20 Info->iLimit;.
23410 7d 0a 20 20 72 53 6f 72 74 43 6f 73 74 20 2b 3d }. rSortCost +=
23420 20 65 73 74 4c 6f 67 28 6e 52 6f 77 29 3b 0a 20 estLog(nRow);.
23430 20 72 65 74 75 72 6e 20 72 53 6f 72 74 43 6f 73 return rSortCos
23440 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 69 76 65 t;.}../*.** Give
23450 6e 20 74 68 65 20 6c 69 73 74 20 6f 66 20 57 68 n the list of Wh
23460 65 72 65 4c 6f 6f 70 20 6f 62 6a 65 63 74 73 20 ereLoop objects
23470 61 74 20 70 57 49 6e 66 6f 2d 3e 70 4c 6f 6f 70 at pWInfo->pLoop
23480 73 2c 20 74 68 69 73 20 72 6f 75 74 69 6e 65 0a s, this routine.
23490 2a 2a 20 61 74 74 65 6d 70 74 73 20 74 6f 20 66 ** attempts to f
234a0 69 6e 64 20 74 68 65 20 6c 6f 77 65 73 74 20 63 ind the lowest c
234b0 6f 73 74 20 70 61 74 68 20 74 68 61 74 20 76 69 ost path that vi
234c0 73 69 74 73 20 65 61 63 68 20 57 68 65 72 65 4c sits each WhereL
234d0 6f 6f 70 0a 2a 2a 20 6f 6e 63 65 2e 20 20 54 68 oop.** once. Th
234e0 69 73 20 70 61 74 68 20 69 73 20 74 68 65 6e 20 is path is then
234f0 6c 6f 61 64 65 64 20 69 6e 74 6f 20 74 68 65 20 loaded into the
23500 70 57 49 6e 66 6f 2d 3e 61 5b 5d 2e 70 57 4c 6f pWInfo->a[].pWLo
23510 6f 70 20 66 69 65 6c 64 73 2e 0a 2a 2a 0a 2a 2a op fields..**.**
23520 20 41 73 73 75 6d 65 20 74 68 61 74 20 74 68 65 Assume that the
23530 20 74 6f 74 61 6c 20 6e 75 6d 62 65 72 20 6f 66 total number of
23540 20 6f 75 74 70 75 74 20 72 6f 77 73 20 74 68 61 output rows tha
23550 74 20 77 69 6c 6c 20 6e 65 65 64 20 74 6f 20 62 t will need to b
23560 65 20 73 6f 72 74 65 64 0a 2a 2a 20 77 69 6c 6c e sorted.** will
23570 20 62 65 20 6e 52 6f 77 45 73 74 20 28 69 6e 20 be nRowEst (in
23580 74 68 65 20 31 30 2a 6c 6f 67 32 20 72 65 70 72 the 10*log2 repr
23590 65 73 65 6e 74 61 74 69 6f 6e 29 2e 20 20 4f 72 esentation). Or
235a0 2c 20 69 67 6e 6f 72 65 20 73 6f 72 74 69 6e 67 , ignore sorting
235b0 0a 2a 2a 20 63 6f 73 74 73 20 69 66 20 6e 52 6f .** costs if nRo
235c0 77 45 73 74 3d 3d 30 2e 0a 2a 2a 0a 2a 2a 20 52 wEst==0..**.** R
235d0 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 eturn SQLITE_OK
235e0 6f 6e 20 73 75 63 63 65 73 73 20 6f 72 20 53 51 on success or SQ
235f0 4c 49 54 45 5f 4e 4f 4d 45 4d 20 6f 66 20 61 20 LITE_NOMEM of a
23600 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 6f memory allocatio
23610 6e 0a 2a 2a 20 65 72 72 6f 72 20 6f 63 63 75 72 n.** error occur
23620 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 s..*/.static int
23630 20 77 68 65 72 65 50 61 74 68 53 6f 6c 76 65 72 wherePathSolver
23640 28 57 68 65 72 65 49 6e 66 6f 20 2a 70 57 49 6e (WhereInfo *pWIn
23650 66 6f 2c 20 4c 6f 67 45 73 74 20 6e 52 6f 77 45 fo, LogEst nRowE
23660 73 74 29 7b 0a 20 20 69 6e 74 20 6d 78 43 68 6f st){. int mxCho
23670 69 63 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 ice;
23680 20 2f 2a 20 4d 61 78 69 6d 75 6d 20 6e 75 6d 62 /* Maximum numb
23690 65 72 20 6f 66 20 73 69 6d 75 6c 74 61 6e 65 6f er of simultaneo
236a0 75 73 20 70 61 74 68 73 20 74 72 61 63 6b 65 64 us paths tracked
236b0 20 2a 2f 0a 20 20 69 6e 74 20 6e 4c 6f 6f 70 3b */. int nLoop;
236c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
236d0 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 74 65 72 /* Number of ter
236e0 6d 73 20 69 6e 20 74 68 65 20 6a 6f 69 6e 20 2a ms in the join *
236f0 2f 0a 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 /. Parse *pPars
23700 65 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a e; /*
23710 20 50 61 72 73 69 6e 67 20 63 6f 6e 74 65 78 74 Parsing context
23720 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 */. sqlite3 *d
23730 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b;
23740 2f 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 /* The database
23750 63 6f 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 connection */.
23760 69 6e 74 20 69 4c 6f 6f 70 3b 20 20 20 20 20 20 int iLoop;
23770 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 6f 6f /* Loo
23780 70 20 63 6f 75 6e 74 65 72 20 6f 76 65 72 20 74 p counter over t
23790 68 65 20 74 65 72 6d 73 20 6f 66 20 74 68 65 20 he terms of the
237a0 6a 6f 69 6e 20 2a 2f 0a 20 20 69 6e 74 20 69 69 join */. int ii
237b0 2c 20 6a 6a 3b 20 20 20 20 20 20 20 20 20 20 20 , jj;
237c0 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e /* Loop coun
237d0 74 65 72 73 20 2a 2f 0a 20 20 69 6e 74 20 6d 78 ters */. int mx
237e0 49 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 I = 0;
237f0 20 20 20 20 2f 2a 20 49 6e 64 65 78 20 6f 66 20 /* Index of
23800 6e 65 78 74 20 65 6e 74 72 79 20 74 6f 20 72 65 next entry to re
23810 70 6c 61 63 65 20 2a 2f 0a 20 20 69 6e 74 20 6e place */. int n
23820 4f 72 64 65 72 42 79 3b 20 20 20 20 20 20 20 20 OrderBy;
23830 20 20 20 20 20 2f 2a 20 4e 75 6d 62 65 72 20 6f /* Number o
23840 66 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 f ORDER BY claus
23850 65 20 74 65 72 6d 73 20 2a 2f 0a 20 20 4c 6f 67 e terms */. Log
23860 45 73 74 20 6d 78 43 6f 73 74 20 3d 20 30 3b 20 Est mxCost = 0;
23870 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 /* Maximu
23880 6d 20 63 6f 73 74 20 6f 66 20 61 20 73 65 74 20 m cost of a set
23890 6f 66 20 70 61 74 68 73 20 2a 2f 0a 20 20 4c 6f of paths */. Lo
238a0 67 45 73 74 20 6d 78 55 6e 73 6f 72 74 65 64 20 gEst mxUnsorted
238b0 3d 20 30 3b 20 20 20 20 2f 2a 20 4d 61 78 69 6d = 0; /* Maxim
238c0 75 6d 20 75 6e 73 6f 72 74 65 64 20 63 6f 73 74 um unsorted cost
238d0 20 6f 66 20 61 20 73 65 74 20 6f 66 20 70 61 74 of a set of pat
238e0 68 20 2a 2f 0a 20 20 69 6e 74 20 6e 54 6f 2c 20 h */. int nTo,
238f0 6e 46 72 6f 6d 3b 20 20 20 20 20 20 20 20 20 20 nFrom;
23900 20 2f 2a 20 4e 75 6d 62 65 72 20 6f 66 20 76 61 /* Number of va
23910 6c 69 64 20 65 6e 74 72 69 65 73 20 69 6e 20 61 lid entries in a
23920 54 6f 5b 5d 20 61 6e 64 20 61 46 72 6f 6d 5b 5d To[] and aFrom[]
23930 20 2a 2f 0a 20 20 57 68 65 72 65 50 61 74 68 20 */. WherePath
23940 2a 61 46 72 6f 6d 3b 20 20 20 20 20 20 20 20 20 *aFrom;
23950 2f 2a 20 41 6c 6c 20 6e 46 72 6f 6d 20 70 61 74 /* All nFrom pat
23960 68 73 20 61 74 20 74 68 65 20 70 72 65 76 69 6f hs at the previo
23970 75 73 20 6c 65 76 65 6c 20 2a 2f 0a 20 20 57 68 us level */. Wh
23980 65 72 65 50 61 74 68 20 2a 61 54 6f 3b 20 20 20 erePath *aTo;
23990 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 6e /* The n
239a0 54 6f 20 62 65 73 74 20 70 61 74 68 73 20 61 74 To best paths at
239b0 20 74 68 65 20 63 75 72 72 65 6e 74 20 6c 65 76 the current lev
239c0 65 6c 20 2a 2f 0a 20 20 57 68 65 72 65 50 61 74 el */. WherePat
239d0 68 20 2a 70 46 72 6f 6d 3b 20 20 20 20 20 20 20 h *pFrom;
239e0 20 20 2f 2a 20 41 6e 20 65 6c 65 6d 65 6e 74 20 /* An element
239f0 6f 66 20 61 46 72 6f 6d 5b 5d 20 74 68 61 74 20 of aFrom[] that
23a00 77 65 20 61 72 65 20 77 6f 72 6b 69 6e 67 20 6f we are working o
23a10 6e 20 2a 2f 0a 20 20 57 68 65 72 65 50 61 74 68 n */. WherePath
23a20 20 2a 70 54 6f 3b 20 20 20 20 20 20 20 20 20 20 *pTo;
23a30 20 2f 2a 20 41 6e 20 65 6c 65 6d 65 6e 74 20 6f /* An element o
23a40 66 20 61 54 6f 5b 5d 20 74 68 61 74 20 77 65 20 f aTo[] that we
23a50 61 72 65 20 77 6f 72 6b 69 6e 67 20 6f 6e 20 2a are working on *
23a60 2f 0a 20 20 57 68 65 72 65 4c 6f 6f 70 20 2a 70 /. WhereLoop *p
23a70 57 4c 6f 6f 70 3b 20 20 20 20 20 20 20 20 2f 2a WLoop; /*
23a80 20 4f 6e 65 20 6f 66 20 74 68 65 20 57 68 65 72 One of the Wher
23a90 65 4c 6f 6f 70 20 6f 62 6a 65 63 74 73 20 2a 2f eLoop objects */
23aa0 0a 20 20 57 68 65 72 65 4c 6f 6f 70 20 2a 2a 70 . WhereLoop **p
23ab0 58 3b 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 X; /*
23ac0 55 73 65 64 20 74 6f 20 64 69 76 79 20 75 70 20 Used to divy up
23ad0 74 68 65 20 70 53 70 61 63 65 20 6d 65 6d 6f 72 the pSpace memor
23ae0 79 20 2a 2f 0a 20 20 4c 6f 67 45 73 74 20 2a 61 y */. LogEst *a
23af0 53 6f 72 74 43 6f 73 74 20 3d 20 30 3b 20 20 20 SortCost = 0;
23b00 20 2f 2a 20 53 6f 72 74 69 6e 67 20 61 6e 64 20 /* Sorting and
23b10 70 61 72 74 69 61 6c 20 73 6f 72 74 69 6e 67 20 partial sorting
23b20 63 6f 73 74 73 20 2a 2f 0a 20 20 63 68 61 72 20 costs */. char
23b30 2a 70 53 70 61 63 65 3b 20 20 20 20 20 20 20 20 *pSpace;
23b40 20 20 20 20 20 2f 2a 20 54 65 6d 70 6f 72 61 72 /* Temporar
23b50 79 20 6d 65 6d 6f 72 79 20 75 73 65 64 20 62 79 y memory used by
23b60 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 2a 2f this routine */
23b70 0a 20 20 69 6e 74 20 6e 53 70 61 63 65 3b 20 20 . int nSpace;
23b80 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
23b90 42 79 74 65 73 20 6f 66 20 73 70 61 63 65 20 61 Bytes of space a
23ba0 6c 6c 6f 63 61 74 65 64 20 61 74 20 70 53 70 61 llocated at pSpa
23bb0 63 65 20 2a 2f 0a 0a 20 20 70 50 61 72 73 65 20 ce */.. pParse
23bc0 3d 20 70 57 49 6e 66 6f 2d 3e 70 50 61 72 73 65 = pWInfo->pParse
23bd0 3b 0a 20 20 64 62 20 3d 20 70 50 61 72 73 65 2d ;. db = pParse-
23be0 3e 64 62 3b 0a 20 20 6e 4c 6f 6f 70 20 3d 20 70 >db;. nLoop = p
23bf0 57 49 6e 66 6f 2d 3e 6e 4c 65 76 65 6c 3b 0a 20 WInfo->nLevel;.
23c00 20 2f 2a 20 54 55 4e 49 4e 47 3a 20 46 6f 72 20 /* TUNING: For
23c10 73 69 6d 70 6c 65 20 71 75 65 72 69 65 73 2c 20 simple queries,
23c20 6f 6e 6c 79 20 74 68 65 20 62 65 73 74 20 70 61 only the best pa
23c30 74 68 20 69 73 20 74 72 61 63 6b 65 64 2e 0a 20 th is tracked..
23c40 20 2a 2a 20 46 6f 72 20 32 2d 77 61 79 20 6a 6f ** For 2-way jo
23c50 69 6e 73 2c 20 74 68 65 20 35 20 62 65 73 74 20 ins, the 5 best
23c60 70 61 74 68 73 20 61 72 65 20 66 6f 6c 6c 6f 77 paths are follow
23c70 65 64 2e 0a 20 20 2a 2a 20 46 6f 72 20 6a 6f 69 ed.. ** For joi
23c80 6e 73 20 6f 66 20 33 20 6f 72 20 6d 6f 72 65 20 ns of 3 or more
23c90 74 61 62 6c 65 73 2c 20 74 72 61 63 6b 20 74 68 tables, track th
23ca0 65 20 31 30 20 62 65 73 74 20 70 61 74 68 73 20 e 10 best paths
23cb0 2a 2f 0a 20 20 6d 78 43 68 6f 69 63 65 20 3d 20 */. mxChoice =
23cc0 28 6e 4c 6f 6f 70 3c 3d 31 29 20 3f 20 31 20 3a (nLoop<=1) ? 1 :
23cd0 20 28 6e 4c 6f 6f 70 3d 3d 32 20 3f 20 35 20 3a (nLoop==2 ? 5 :
23ce0 20 31 30 29 3b 0a 20 20 61 73 73 65 72 74 28 20 10);. assert(
23cf0 6e 4c 6f 6f 70 3c 3d 70 57 49 6e 66 6f 2d 3e 70 nLoop<=pWInfo->p
23d00 54 61 62 4c 69 73 74 2d 3e 6e 53 72 63 20 29 3b TabList->nSrc );
23d10 0a 20 20 57 48 45 52 45 54 52 41 43 45 28 30 78 . WHERETRACE(0x
23d20 30 30 32 2c 20 28 22 2d 2d 2d 2d 20 62 65 67 69 002, ("---- begi
23d30 6e 20 73 6f 6c 76 65 72 2e 20 20 28 6e 52 6f 77 n solver. (nRow
23d40 45 73 74 3d 25 64 29 5c 6e 22 2c 20 6e 52 6f 77 Est=%d)\n", nRow
23d50 45 73 74 29 29 3b 0a 0a 20 20 2f 2a 20 49 66 20 Est));.. /* If
23d60 6e 52 6f 77 45 73 74 20 69 73 20 7a 65 72 6f 20 nRowEst is zero
23d70 61 6e 64 20 74 68 65 72 65 20 69 73 20 61 6e 20 and there is an
23d80 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 2c ORDER BY clause,
23d90 20 69 67 6e 6f 72 65 20 69 74 2e 20 49 6e 20 74 ignore it. In t
23da0 68 69 73 0a 20 20 2a 2a 20 63 61 73 65 20 74 68 his. ** case th
23db0 65 20 70 75 72 70 6f 73 65 20 6f 66 20 74 68 69 e purpose of thi
23dc0 73 20 63 61 6c 6c 20 69 73 20 74 6f 20 65 73 74 s call is to est
23dd0 69 6d 61 74 65 20 74 68 65 20 6e 75 6d 62 65 72 imate the number
23de0 20 6f 66 20 72 6f 77 73 20 72 65 74 75 72 6e 65 of rows returne
23df0 64 0a 20 20 2a 2a 20 62 79 20 74 68 65 20 6f 76 d. ** by the ov
23e00 65 72 61 6c 6c 20 71 75 65 72 79 2e 20 4f 6e 63 erall query. Onc
23e10 65 20 74 68 69 73 20 65 73 74 69 6d 61 74 65 20 e this estimate
23e20 68 61 73 20 62 65 65 6e 20 6f 62 74 61 69 6e 65 has been obtaine
23e30 64 2c 20 74 68 65 20 63 61 6c 6c 65 72 0a 20 20 d, the caller.
23e40 2a 2a 20 77 69 6c 6c 20 69 6e 76 6f 6b 65 20 74 ** will invoke t
23e50 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 61 20 73 his function a s
23e60 65 63 6f 6e 64 20 74 69 6d 65 2c 20 70 61 73 73 econd time, pass
23e70 69 6e 67 20 74 68 65 20 65 73 74 69 6d 61 74 65 ing the estimate
23e80 20 61 73 20 74 68 65 0a 20 20 2a 2a 20 6e 52 6f as the. ** nRo
23e90 77 45 73 74 20 70 61 72 61 6d 65 74 65 72 2e 20 wEst parameter.
23ea0 20 2a 2f 0a 20 20 69 66 28 20 70 57 49 6e 66 6f */. if( pWInfo
23eb0 2d 3e 70 4f 72 64 65 72 42 79 3d 3d 30 20 7c 7c ->pOrderBy==0 ||
23ec0 20 6e 52 6f 77 45 73 74 3d 3d 30 20 29 7b 0a 20 nRowEst==0 ){.
23ed0 20 20 20 6e 4f 72 64 65 72 42 79 20 3d 20 30 3b nOrderBy = 0;
23ee0 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 6e 4f . }else{. nO
23ef0 72 64 65 72 42 79 20 3d 20 70 57 49 6e 66 6f 2d rderBy = pWInfo-
23f00 3e 70 4f 72 64 65 72 42 79 2d 3e 6e 45 78 70 72 >pOrderBy->nExpr
23f10 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 41 6c 6c 6f ;. }.. /* Allo
23f20 63 61 74 65 20 61 6e 64 20 69 6e 69 74 69 61 6c cate and initial
23f30 69 7a 65 20 73 70 61 63 65 20 66 6f 72 20 61 54 ize space for aT
23f40 6f 2c 20 61 46 72 6f 6d 20 61 6e 64 20 61 53 6f o, aFrom and aSo
23f50 72 74 43 6f 73 74 5b 5d 20 2a 2f 0a 20 20 6e 53 rtCost[] */. nS
23f60 70 61 63 65 20 3d 20 28 73 69 7a 65 6f 66 28 57 pace = (sizeof(W
23f70 68 65 72 65 50 61 74 68 29 2b 73 69 7a 65 6f 66 herePath)+sizeof
23f80 28 57 68 65 72 65 4c 6f 6f 70 2a 29 2a 6e 4c 6f (WhereLoop*)*nLo
23f90 6f 70 29 2a 6d 78 43 68 6f 69 63 65 2a 32 3b 0a op)*mxChoice*2;.
23fa0 20 20 6e 53 70 61 63 65 20 2b 3d 20 73 69 7a 65 nSpace += size
23fb0 6f 66 28 4c 6f 67 45 73 74 29 20 2a 20 6e 4f 72 of(LogEst) * nOr
23fc0 64 65 72 42 79 3b 0a 20 20 70 53 70 61 63 65 20 derBy;. pSpace
23fd0 3d 20 73 71 6c 69 74 65 33 44 62 4d 61 6c 6c 6f = sqlite3DbMallo
23fe0 63 52 61 77 4e 4e 28 64 62 2c 20 6e 53 70 61 63 cRawNN(db, nSpac
23ff0 65 29 3b 0a 20 20 69 66 28 20 70 53 70 61 63 65 e);. if( pSpace
24000 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c ==0 ) return SQL
24010 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a ITE_NOMEM_BKPT;.
24020 20 20 61 54 6f 20 3d 20 28 57 68 65 72 65 50 61 aTo = (WherePa
24030 74 68 2a 29 70 53 70 61 63 65 3b 0a 20 20 61 46 th*)pSpace;. aF
24040 72 6f 6d 20 3d 20 61 54 6f 2b 6d 78 43 68 6f 69 rom = aTo+mxChoi
24050 63 65 3b 0a 20 20 6d 65 6d 73 65 74 28 61 46 72 ce;. memset(aFr
24060 6f 6d 2c 20 30 2c 20 73 69 7a 65 6f 66 28 61 46 om, 0, sizeof(aF
24070 72 6f 6d 5b 30 5d 29 29 3b 0a 20 20 70 58 20 3d rom[0]));. pX =
24080 20 28 57 68 65 72 65 4c 6f 6f 70 2a 2a 29 28 61 (WhereLoop**)(a
24090 46 72 6f 6d 2b 6d 78 43 68 6f 69 63 65 29 3b 0a From+mxChoice);.
240a0 20 20 66 6f 72 28 69 69 3d 6d 78 43 68 6f 69 63 for(ii=mxChoic
240b0 65 2a 32 2c 20 70 46 72 6f 6d 3d 61 54 6f 3b 20 e*2, pFrom=aTo;
240c0 69 69 3e 30 3b 20 69 69 2d 2d 2c 20 70 46 72 6f ii>0; ii--, pFro
240d0 6d 2b 2b 2c 20 70 58 20 2b 3d 20 6e 4c 6f 6f 70 m++, pX += nLoop
240e0 29 7b 0a 20 20 20 20 70 46 72 6f 6d 2d 3e 61 4c ){. pFrom->aL
240f0 6f 6f 70 20 3d 20 70 58 3b 0a 20 20 7d 0a 20 20 oop = pX;. }.
24100 69 66 28 20 6e 4f 72 64 65 72 42 79 20 29 7b 0a if( nOrderBy ){.
24110 20 20 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 /* If there
24120 69 73 20 61 6e 20 4f 52 44 45 52 20 42 59 20 63 is an ORDER BY c
24130 6c 61 75 73 65 20 61 6e 64 20 69 74 20 69 73 20 lause and it is
24140 6e 6f 74 20 62 65 69 6e 67 20 69 67 6e 6f 72 65 not being ignore
24150 64 2c 20 73 65 74 20 75 70 0a 20 20 20 20 2a 2a d, set up. **
24160 20 73 70 61 63 65 20 66 6f 72 20 74 68 65 20 61 space for the a
24170 53 6f 72 74 43 6f 73 74 5b 5d 20 61 72 72 61 79 SortCost[] array
24180 2e 20 45 61 63 68 20 65 6c 65 6d 65 6e 74 20 6f . Each element o
24190 66 20 74 68 65 20 61 53 6f 72 74 43 6f 73 74 20 f the aSortCost
241a0 61 72 72 61 79 0a 20 20 20 20 2a 2a 20 69 73 20 array. ** is
241b0 65 69 74 68 65 72 20 7a 65 72 6f 20 2d 20 6d 65 either zero - me
241c0 61 6e 69 6e 67 20 69 74 20 68 61 73 20 6e 6f 74 aning it has not
241d0 20 79 65 74 20 62 65 65 6e 20 69 6e 69 74 69 61 yet been initia
241e0 6c 69 7a 65 64 20 2d 20 6f 72 20 74 68 65 0a 20 lized - or the.
241f0 20 20 20 2a 2a 20 63 6f 73 74 20 6f 66 20 73 6f ** cost of so
24200 72 74 69 6e 67 20 6e 52 6f 77 45 73 74 20 72 6f rting nRowEst ro
24210 77 73 20 6f 66 20 64 61 74 61 20 77 68 65 72 65 ws of data where
24220 20 74 68 65 20 66 69 72 73 74 20 58 20 74 65 72 the first X ter
24230 6d 73 20 6f 66 0a 20 20 20 20 2a 2a 20 74 68 65 ms of. ** the
24240 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 ORDER BY clause
24250 20 61 72 65 20 61 6c 72 65 61 64 79 20 69 6e 20 are already in
24260 6f 72 64 65 72 2c 20 77 68 65 72 65 20 58 20 69 order, where X i
24270 73 20 74 68 65 20 61 72 72 61 79 20 0a 20 20 20 s the array .
24280 20 2a 2a 20 69 6e 64 65 78 2e 20 20 2a 2f 0a 20 ** index. */.
24290 20 20 20 61 53 6f 72 74 43 6f 73 74 20 3d 20 28 aSortCost = (
242a0 4c 6f 67 45 73 74 2a 29 70 58 3b 0a 20 20 20 20 LogEst*)pX;.
242b0 6d 65 6d 73 65 74 28 61 53 6f 72 74 43 6f 73 74 memset(aSortCost
242c0 2c 20 30 2c 20 73 69 7a 65 6f 66 28 4c 6f 67 45 , 0, sizeof(LogE
242d0 73 74 29 20 2a 20 6e 4f 72 64 65 72 42 79 29 3b st) * nOrderBy);
242e0 0a 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 61 . }. assert( a
242f0 53 6f 72 74 43 6f 73 74 3d 3d 30 20 7c 7c 20 26 SortCost==0 || &
24300 70 53 70 61 63 65 5b 6e 53 70 61 63 65 5d 3d 3d pSpace[nSpace]==
24310 28 63 68 61 72 2a 29 26 61 53 6f 72 74 43 6f 73 (char*)&aSortCos
24320 74 5b 6e 4f 72 64 65 72 42 79 5d 20 29 3b 0a 20 t[nOrderBy] );.
24330 20 61 73 73 65 72 74 28 20 61 53 6f 72 74 43 6f assert( aSortCo
24340 73 74 21 3d 30 20 7c 7c 20 26 70 53 70 61 63 65 st!=0 || &pSpace
24350 5b 6e 53 70 61 63 65 5d 3d 3d 28 63 68 61 72 2a [nSpace]==(char*
24360 29 70 58 20 29 3b 0a 0a 20 20 2f 2a 20 53 65 65 )pX );.. /* See
24370 64 20 74 68 65 20 73 65 61 72 63 68 20 77 69 74 d the search wit
24380 68 20 61 20 73 69 6e 67 6c 65 20 57 68 65 72 65 h a single Where
24390 50 61 74 68 20 63 6f 6e 74 61 69 6e 69 6e 67 20 Path containing
243a0 7a 65 72 6f 20 57 68 65 72 65 4c 6f 6f 70 73 2e zero WhereLoops.
243b0 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 55 4e 49 4e . **. ** TUNIN
243c0 47 3a 20 44 6f 20 6e 6f 74 20 6c 65 74 20 74 68 G: Do not let th
243d0 65 20 6e 75 6d 62 65 72 20 6f 66 20 69 74 65 72 e number of iter
243e0 61 74 69 6f 6e 73 20 67 6f 20 61 62 6f 76 65 20 ations go above
243f0 32 38 2e 20 20 49 66 20 74 68 65 20 63 6f 73 74 28. If the cost
24400 0a 20 20 2a 2a 20 6f 66 20 63 6f 6d 70 75 74 69 . ** of computi
24410 6e 67 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 20 ng an automatic
24420 69 6e 64 65 78 20 69 73 20 6e 6f 74 20 70 61 69 index is not pai
24430 64 20 62 61 63 6b 20 77 69 74 68 69 6e 20 74 68 d back within th
24440 65 20 66 69 72 73 74 20 32 38 0a 20 20 2a 2a 20 e first 28. **
24450 72 6f 77 73 2c 20 74 68 65 6e 20 64 6f 20 6e 6f rows, then do no
24460 74 20 75 73 65 20 74 68 65 20 61 75 74 6f 6d 61 t use the automa
24470 74 69 63 20 69 6e 64 65 78 2e 20 2a 2f 0a 20 20 tic index. */.
24480 61 46 72 6f 6d 5b 30 5d 2e 6e 52 6f 77 20 3d 20 aFrom[0].nRow =
24490 4d 49 4e 28 70 50 61 72 73 65 2d 3e 6e 51 75 65 MIN(pParse->nQue
244a0 72 79 4c 6f 6f 70 2c 20 34 38 29 3b 20 20 61 73 ryLoop, 48); as
244b0 73 65 72 74 28 20 34 38 3d 3d 73 71 6c 69 74 65 sert( 48==sqlite
244c0 33 4c 6f 67 45 73 74 28 32 38 29 20 29 3b 0a 20 3LogEst(28) );.
244d0 20 6e 46 72 6f 6d 20 3d 20 31 3b 0a 20 20 61 73 nFrom = 1;. as
244e0 73 65 72 74 28 20 61 46 72 6f 6d 5b 30 5d 2e 69 sert( aFrom[0].i
244f0 73 4f 72 64 65 72 65 64 3d 3d 30 20 29 3b 0a 20 sOrdered==0 );.
24500 20 69 66 28 20 6e 4f 72 64 65 72 42 79 20 29 7b if( nOrderBy ){
24510 0a 20 20 20 20 2f 2a 20 49 66 20 6e 4c 6f 6f 70 . /* If nLoop
24520 20 69 73 20 7a 65 72 6f 2c 20 74 68 65 6e 20 74 is zero, then t
24530 68 65 72 65 20 61 72 65 20 6e 6f 20 46 52 4f 4d here are no FROM
24540 20 74 65 72 6d 73 20 69 6e 20 74 68 65 20 71 75 terms in the qu
24550 65 72 79 2e 20 53 69 6e 63 65 0a 20 20 20 20 2a ery. Since. *
24560 2a 20 69 6e 20 74 68 69 73 20 63 61 73 65 20 74 * in this case t
24570 68 65 20 71 75 65 72 79 20 6d 61 79 20 72 65 74 he query may ret
24580 75 72 6e 20 61 20 6d 61 78 69 6d 75 6d 20 6f 66 urn a maximum of
24590 20 6f 6e 65 20 72 6f 77 2c 20 74 68 65 20 72 65 one row, the re
245a0 73 75 6c 74 73 0a 20 20 20 20 2a 2a 20 61 72 65 sults. ** are
245b0 20 61 6c 72 65 61 64 79 20 69 6e 20 74 68 65 20 already in the
245c0 72 65 71 75 65 73 74 65 64 20 6f 72 64 65 72 2e requested order.
245d0 20 53 65 74 20 69 73 4f 72 64 65 72 65 64 20 74 Set isOrdered t
245e0 6f 20 6e 4f 72 64 65 72 42 79 20 74 6f 0a 20 20 o nOrderBy to.
245f0 20 20 2a 2a 20 69 6e 64 69 63 61 74 65 20 74 68 ** indicate th
24600 69 73 2e 20 4f 72 2c 20 69 66 20 6e 4c 6f 6f 70 is. Or, if nLoop
24610 20 69 73 20 67 72 65 61 74 65 72 20 74 68 61 6e is greater than
24620 20 7a 65 72 6f 2c 20 73 65 74 20 69 73 4f 72 64 zero, set isOrd
24630 65 72 65 64 20 74 6f 0a 20 20 20 20 2a 2a 20 2d ered to. ** -
24640 31 2c 20 69 6e 64 69 63 61 74 69 6e 67 20 74 68 1, indicating th
24650 61 74 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 at the result se
24660 74 20 6d 61 79 20 6f 72 20 6d 61 79 20 6e 6f 74 t may or may not
24670 20 62 65 20 6f 72 64 65 72 65 64 2c 20 0a 20 20 be ordered, .
24680 20 20 2a 2a 20 64 65 70 65 6e 64 69 6e 67 20 6f ** depending o
24690 6e 20 74 68 65 20 6c 6f 6f 70 73 20 61 64 64 65 n the loops adde
246a0 64 20 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74 d to the current
246b0 20 70 6c 61 6e 2e 20 20 2a 2f 0a 20 20 20 20 61 plan. */. a
246c0 46 72 6f 6d 5b 30 5d 2e 69 73 4f 72 64 65 72 65 From[0].isOrdere
246d0 64 20 3d 20 6e 4c 6f 6f 70 3e 30 20 3f 20 2d 31 d = nLoop>0 ? -1
246e0 20 3a 20 6e 4f 72 64 65 72 42 79 3b 0a 20 20 7d : nOrderBy;. }
246f0 0a 0a 20 20 2f 2a 20 43 6f 6d 70 75 74 65 20 73 .. /* Compute s
24700 75 63 63 65 73 73 69 76 65 6c 79 20 6c 6f 6e 67 uccessively long
24710 65 72 20 57 68 65 72 65 50 61 74 68 73 20 75 73 er WherePaths us
24720 69 6e 67 20 74 68 65 20 70 72 65 76 69 6f 75 73 ing the previous
24730 20 67 65 6e 65 72 61 74 69 6f 6e 0a 20 20 2a 2a generation. **
24740 20 6f 66 20 57 68 65 72 65 50 61 74 68 73 20 61 of WherePaths a
24750 73 20 74 68 65 20 62 61 73 69 73 20 66 6f 72 20 s the basis for
24760 74 68 65 20 6e 65 78 74 2e 20 20 4b 65 65 70 20 the next. Keep
24770 74 72 61 63 6b 20 6f 66 20 74 68 65 20 6d 78 43 track of the mxC
24780 68 6f 69 63 65 0a 20 20 2a 2a 20 62 65 73 74 20 hoice. ** best
24790 70 61 74 68 73 20 61 74 20 65 61 63 68 20 67 65 paths at each ge
247a0 6e 65 72 61 74 69 6f 6e 20 2a 2f 0a 20 20 66 6f neration */. fo
247b0 72 28 69 4c 6f 6f 70 3d 30 3b 20 69 4c 6f 6f 70 r(iLoop=0; iLoop
247c0 3c 6e 4c 6f 6f 70 3b 20 69 4c 6f 6f 70 2b 2b 29 <nLoop; iLoop++)
247d0 7b 0a 20 20 20 20 6e 54 6f 20 3d 20 30 3b 0a 20 {. nTo = 0;.
247e0 20 20 20 66 6f 72 28 69 69 3d 30 2c 20 70 46 72 for(ii=0, pFr
247f0 6f 6d 3d 61 46 72 6f 6d 3b 20 69 69 3c 6e 46 72 om=aFrom; ii<nFr
24800 6f 6d 3b 20 69 69 2b 2b 2c 20 70 46 72 6f 6d 2b om; ii++, pFrom+
24810 2b 29 7b 0a 20 20 20 20 20 20 66 6f 72 28 70 57 +){. for(pW
24820 4c 6f 6f 70 3d 70 57 49 6e 66 6f 2d 3e 70 4c 6f Loop=pWInfo->pLo
24830 6f 70 73 3b 20 70 57 4c 6f 6f 70 3b 20 70 57 4c ops; pWLoop; pWL
24840 6f 6f 70 3d 70 57 4c 6f 6f 70 2d 3e 70 4e 65 78 oop=pWLoop->pNex
24850 74 4c 6f 6f 70 29 7b 0a 20 20 20 20 20 20 20 20 tLoop){.
24860 4c 6f 67 45 73 74 20 6e 4f 75 74 3b 20 20 20 20 LogEst nOut;
24870 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24880 20 20 2f 2a 20 52 6f 77 73 20 76 69 73 69 74 65 /* Rows visite
24890 64 20 62 79 20 28 70 46 72 6f 6d 2b 70 57 4c 6f d by (pFrom+pWLo
248a0 6f 70 29 20 2a 2f 0a 20 20 20 20 20 20 20 20 4c op) */. L
248b0 6f 67 45 73 74 20 72 43 6f 73 74 3b 20 20 20 20 ogEst rCost;
248c0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
248d0 20 2f 2a 20 43 6f 73 74 20 6f 66 20 70 61 74 68 /* Cost of path
248e0 20 28 70 46 72 6f 6d 2b 70 57 4c 6f 6f 70 29 20 (pFrom+pWLoop)
248f0 2a 2f 0a 20 20 20 20 20 20 20 20 4c 6f 67 45 73 */. LogEs
24900 74 20 72 55 6e 73 6f 72 74 65 64 3b 20 20 20 20 t rUnsorted;
24910 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
24920 55 6e 73 6f 72 74 65 64 20 63 6f 73 74 20 6f 66 Unsorted cost of
24930 20 28 70 46 72 6f 6d 2b 70 57 4c 6f 6f 70 29 20 (pFrom+pWLoop)
24940 2a 2f 0a 20 20 20 20 20 20 20 20 69 38 20 69 73 */. i8 is
24950 4f 72 64 65 72 65 64 20 3d 20 70 46 72 6f 6d 2d Ordered = pFrom-
24960 3e 69 73 4f 72 64 65 72 65 64 3b 20 20 2f 2a 20 >isOrdered; /*
24970 69 73 4f 72 64 65 72 65 64 20 66 6f 72 20 28 70 isOrdered for (p
24980 46 72 6f 6d 2b 70 57 4c 6f 6f 70 29 20 2a 2f 0a From+pWLoop) */.
24990 20 20 20 20 20 20 20 20 42 69 74 6d 61 73 6b 20 Bitmask
249a0 6d 61 73 6b 4e 65 77 3b 20 20 20 20 20 20 20 20 maskNew;
249b0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 61 73 /* Mas
249c0 6b 20 6f 66 20 73 72 63 20 76 69 73 69 74 65 64 k of src visited
249d0 20 62 79 20 28 2e 2e 29 20 2a 2f 0a 20 20 20 20 by (..) */.
249e0 20 20 20 20 42 69 74 6d 61 73 6b 20 72 65 76 4d Bitmask revM
249f0 61 73 6b 20 3d 20 30 3b 20 20 20 20 20 20 20 20 ask = 0;
24a00 20 20 20 20 20 20 2f 2a 20 4d 61 73 6b 20 6f 66 /* Mask of
24a10 20 72 65 76 2d 6f 72 64 65 72 20 6c 6f 6f 70 73 rev-order loops
24a20 20 66 6f 72 20 28 2e 2e 29 20 2a 2f 0a 0a 20 20 for (..) */..
24a30 20 20 20 20 20 20 69 66 28 20 28 70 57 4c 6f 6f if( (pWLoo
24a40 70 2d 3e 70 72 65 72 65 71 20 26 20 7e 70 46 72 p->prereq & ~pFr
24a50 6f 6d 2d 3e 6d 61 73 6b 4c 6f 6f 70 29 21 3d 30 om->maskLoop)!=0
24a60 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 ) continue;.
24a70 20 20 20 20 20 69 66 28 20 28 70 57 4c 6f 6f 70 if( (pWLoop
24a80 2d 3e 6d 61 73 6b 53 65 6c 66 20 26 20 70 46 72 ->maskSelf & pFr
24a90 6f 6d 2d 3e 6d 61 73 6b 4c 6f 6f 70 29 21 3d 30 om->maskLoop)!=0
24aa0 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 ) continue;.
24ab0 20 20 20 20 20 69 66 28 20 28 70 57 4c 6f 6f 70 if( (pWLoop
24ac0 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 ->wsFlags & WHER
24ad0 45 5f 41 55 54 4f 5f 49 4e 44 45 58 29 21 3d 30 E_AUTO_INDEX)!=0
24ae0 20 26 26 20 70 46 72 6f 6d 2d 3e 6e 52 6f 77 3c && pFrom->nRow<
24af0 31 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 10 ){.
24b00 2f 2a 20 44 6f 20 6e 6f 74 20 75 73 65 20 61 6e /* Do not use an
24b10 20 61 75 74 6f 6d 61 74 69 63 20 69 6e 64 65 78 automatic index
24b20 20 69 66 20 74 68 65 20 74 68 69 73 20 6c 6f 6f if the this loo
24b30 70 20 69 73 20 65 78 70 65 63 74 65 64 0a 20 20 p is expected.
24b40 20 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 72 75 ** to ru
24b50 6e 20 6c 65 73 73 20 74 68 61 6e 20 32 20 74 69 n less than 2 ti
24b60 6d 65 73 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 mes. */.
24b70 20 20 61 73 73 65 72 74 28 20 31 30 3d 3d 73 71 assert( 10==sq
24b80 6c 69 74 65 33 4c 6f 67 45 73 74 28 32 29 20 29 lite3LogEst(2) )
24b90 3b 0a 20 20 20 20 20 20 20 20 20 20 63 6f 6e 74 ;. cont
24ba0 69 6e 75 65 3b 0a 20 20 20 20 20 20 20 20 7d 0a inue;. }.
24bb0 20 20 20 20 20 20 20 20 2f 2a 20 41 74 20 74 68 /* At th
24bc0 69 73 20 70 6f 69 6e 74 2c 20 70 57 4c 6f 6f 70 is point, pWLoop
24bd0 20 69 73 20 61 20 63 61 6e 64 69 64 61 74 65 20 is a candidate
24be0 74 6f 20 62 65 20 74 68 65 20 6e 65 78 74 20 6c to be the next l
24bf0 6f 6f 70 2e 20 0a 20 20 20 20 20 20 20 20 2a 2a oop. . **
24c00 20 43 6f 6d 70 75 74 65 20 69 74 73 20 63 6f 73 Compute its cos
24c10 74 20 2a 2f 0a 20 20 20 20 20 20 20 20 72 55 6e t */. rUn
24c20 73 6f 72 74 65 64 20 3d 20 73 71 6c 69 74 65 33 sorted = sqlite3
24c30 4c 6f 67 45 73 74 41 64 64 28 70 57 4c 6f 6f 70 LogEstAdd(pWLoop
24c40 2d 3e 72 53 65 74 75 70 2c 70 57 4c 6f 6f 70 2d ->rSetup,pWLoop-
24c50 3e 72 52 75 6e 20 2b 20 70 46 72 6f 6d 2d 3e 6e >rRun + pFrom->n
24c60 52 6f 77 29 3b 0a 20 20 20 20 20 20 20 20 72 55 Row);. rU
24c70 6e 73 6f 72 74 65 64 20 3d 20 73 71 6c 69 74 65 nsorted = sqlite
24c80 33 4c 6f 67 45 73 74 41 64 64 28 72 55 6e 73 6f 3LogEstAdd(rUnso
24c90 72 74 65 64 2c 20 70 46 72 6f 6d 2d 3e 72 55 6e rted, pFrom->rUn
24ca0 73 6f 72 74 65 64 29 3b 0a 20 20 20 20 20 20 20 sorted);.
24cb0 20 6e 4f 75 74 20 3d 20 70 46 72 6f 6d 2d 3e 6e nOut = pFrom->n
24cc0 52 6f 77 20 2b 20 70 57 4c 6f 6f 70 2d 3e 6e 4f Row + pWLoop->nO
24cd0 75 74 3b 0a 20 20 20 20 20 20 20 20 6d 61 73 6b ut;. mask
24ce0 4e 65 77 20 3d 20 70 46 72 6f 6d 2d 3e 6d 61 73 New = pFrom->mas
24cf0 6b 4c 6f 6f 70 20 7c 20 70 57 4c 6f 6f 70 2d 3e kLoop | pWLoop->
24d00 6d 61 73 6b 53 65 6c 66 3b 0a 20 20 20 20 20 20 maskSelf;.
24d10 20 20 69 66 28 20 69 73 4f 72 64 65 72 65 64 3c if( isOrdered<
24d20 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 0 ){. i
24d30 73 4f 72 64 65 72 65 64 20 3d 20 77 68 65 72 65 sOrdered = where
24d40 50 61 74 68 53 61 74 69 73 66 69 65 73 4f 72 64 PathSatisfiesOrd
24d50 65 72 42 79 28 70 57 49 6e 66 6f 2c 0a 20 20 20 erBy(pWInfo,.
24d60 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
24d70 20 20 20 20 70 57 49 6e 66 6f 2d 3e 70 4f 72 64 pWInfo->pOrd
24d80 65 72 42 79 2c 20 70 46 72 6f 6d 2c 20 70 57 49 erBy, pFrom, pWI
24d90 6e 66 6f 2d 3e 77 63 74 72 6c 46 6c 61 67 73 2c nfo->wctrlFlags,
24da0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
24db0 20 20 20 20 20 20 20 20 69 4c 6f 6f 70 2c 20 70 iLoop, p
24dc0 57 4c 6f 6f 70 2c 20 26 72 65 76 4d 61 73 6b 29 WLoop, &revMask)
24dd0 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b ;. }else{
24de0 0a 20 20 20 20 20 20 20 20 20 20 72 65 76 4d 61 . revMa
24df0 73 6b 20 3d 20 70 46 72 6f 6d 2d 3e 72 65 76 4c sk = pFrom->revL
24e00 6f 6f 70 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 oop;. }.
24e10 20 20 20 20 20 20 20 69 66 28 20 69 73 4f 72 64 if( isOrd
24e20 65 72 65 64 3e 3d 30 20 26 26 20 69 73 4f 72 64 ered>=0 && isOrd
24e30 65 72 65 64 3c 6e 4f 72 64 65 72 42 79 20 29 7b ered<nOrderBy ){
24e40 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20 61 . if( a
24e50 53 6f 72 74 43 6f 73 74 5b 69 73 4f 72 64 65 72 SortCost[isOrder
24e60 65 64 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 ed]==0 ){.
24e70 20 20 20 20 20 20 61 53 6f 72 74 43 6f 73 74 5b aSortCost[
24e80 69 73 4f 72 64 65 72 65 64 5d 20 3d 20 77 68 65 isOrdered] = whe
24e90 72 65 53 6f 72 74 69 6e 67 43 6f 73 74 28 0a 20 reSortingCost(.
24ea0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 p
24eb0 57 49 6e 66 6f 2c 20 6e 52 6f 77 45 73 74 2c 20 WInfo, nRowEst,
24ec0 6e 4f 72 64 65 72 42 79 2c 20 69 73 4f 72 64 65 nOrderBy, isOrde
24ed0 72 65 64 0a 20 20 20 20 20 20 20 20 20 20 20 20 red.
24ee0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 );. }.
24ef0 20 20 20 20 20 20 20 20 20 72 43 6f 73 74 20 3d rCost =
24f00 20 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 41 64 sqlite3LogEstAd
24f10 64 28 72 55 6e 73 6f 72 74 65 64 2c 20 61 53 6f d(rUnsorted, aSo
24f20 72 74 43 6f 73 74 5b 69 73 4f 72 64 65 72 65 64 rtCost[isOrdered
24f30 5d 29 3b 0a 0a 20 20 20 20 20 20 20 20 20 20 57 ]);.. W
24f40 48 45 52 45 54 52 41 43 45 28 30 78 30 30 32 2c HERETRACE(0x002,
24f50 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 28 . (
24f60 22 2d 2d 2d 2d 20 73 6f 72 74 20 63 6f 73 74 3d "---- sort cost=
24f70 25 2d 33 64 20 28 25 64 2f 25 64 29 20 69 6e 63 %-3d (%d/%d) inc
24f80 72 65 61 73 65 73 20 63 6f 73 74 20 25 33 64 20 reases cost %3d
24f90 74 6f 20 25 2d 33 64 5c 6e 22 2c 0a 20 20 20 20 to %-3d\n",.
24fa0 20 20 20 20 20 20 20 20 20 20 20 61 53 6f 72 74 aSort
24fb0 43 6f 73 74 5b 69 73 4f 72 64 65 72 65 64 5d 2c Cost[isOrdered],
24fc0 20 28 6e 4f 72 64 65 72 42 79 2d 69 73 4f 72 64 (nOrderBy-isOrd
24fd0 65 72 65 64 29 2c 20 6e 4f 72 64 65 72 42 79 2c ered), nOrderBy,
24fe0 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
24ff0 20 72 55 6e 73 6f 72 74 65 64 2c 20 72 43 6f 73 rUnsorted, rCos
25000 74 29 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c t));. }el
25010 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 72 43 se{. rC
25020 6f 73 74 20 3d 20 72 55 6e 73 6f 72 74 65 64 3b ost = rUnsorted;
25030 0a 20 20 20 20 20 20 20 20 20 20 72 55 6e 73 6f . rUnso
25040 72 74 65 64 20 2d 3d 20 32 3b 20 20 2f 2a 20 54 rted -= 2; /* T
25050 55 4e 49 4e 47 3a 20 20 53 6c 69 67 68 74 20 62 UNING: Slight b
25060 69 61 73 20 69 6e 20 66 61 76 6f 72 20 6f 66 20 ias in favor of
25070 6e 6f 2d 73 6f 72 74 20 70 6c 61 6e 73 20 2a 2f no-sort plans */
25080 0a 20 20 20 20 20 20 20 20 7d 0a 0a 20 20 20 20 . }..
25090 20 20 20 20 2f 2a 20 43 68 65 63 6b 20 74 6f 20 /* Check to
250a0 73 65 65 20 69 66 20 70 57 4c 6f 6f 70 20 73 68 see if pWLoop sh
250b0 6f 75 6c 64 20 62 65 20 61 64 64 65 64 20 74 6f ould be added to
250c0 20 74 68 65 20 73 65 74 20 6f 66 0a 20 20 20 20 the set of.
250d0 20 20 20 20 2a 2a 20 6d 78 43 68 6f 69 63 65 20 ** mxChoice
250e0 62 65 73 74 2d 73 6f 2d 66 61 72 20 70 61 74 68 best-so-far path
250f0 73 2e 0a 20 20 20 20 20 20 20 20 2a 2a 0a 20 20 s.. **.
25100 20 20 20 20 20 20 2a 2a 20 46 69 72 73 74 20 6c ** First l
25110 6f 6f 6b 20 66 6f 72 20 61 6e 20 65 78 69 73 74 ook for an exist
25120 69 6e 67 20 70 61 74 68 20 61 6d 6f 6e 67 20 62 ing path among b
25130 65 73 74 2d 73 6f 2d 66 61 72 20 70 61 74 68 73 est-so-far paths
25140 0a 20 20 20 20 20 20 20 20 2a 2a 20 74 68 61 74 . ** that
25150 20 63 6f 76 65 72 73 20 74 68 65 20 73 61 6d 65 covers the same
25160 20 73 65 74 20 6f 66 20 6c 6f 6f 70 73 20 61 6e set of loops an
25170 64 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 69 d has the same i
25180 73 4f 72 64 65 72 65 64 0a 20 20 20 20 20 20 20 sOrdered.
25190 20 2a 2a 20 73 65 74 74 69 6e 67 20 61 73 20 74 ** setting as t
251a0 68 65 20 63 75 72 72 65 6e 74 20 70 61 74 68 20 he current path
251b0 63 61 6e 64 69 64 61 74 65 2e 0a 20 20 20 20 20 candidate..
251c0 20 20 20 2a 2a 0a 20 20 20 20 20 20 20 20 2a 2a **. **
251d0 20 54 68 65 20 74 65 72 6d 20 22 28 28 70 54 6f The term "((pTo
251e0 2d 3e 69 73 4f 72 64 65 72 65 64 5e 69 73 4f 72 ->isOrdered^isOr
251f0 64 65 72 65 64 29 26 30 78 38 30 29 3d 3d 30 22 dered)&0x80)==0"
25200 20 69 73 20 65 71 75 69 76 61 6c 65 6e 74 0a 20 is equivalent.
25210 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 28 70 54 ** to (pT
25220 6f 2d 3e 69 73 4f 72 64 65 72 65 64 3d 3d 28 2d o->isOrdered==(-
25230 31 29 29 3d 3d 28 69 73 4f 72 64 65 72 65 64 3d 1))==(isOrdered=
25240 3d 28 2d 31 29 29 22 20 66 6f 72 20 74 68 65 20 =(-1))" for the
25250 72 61 6e 67 65 0a 20 20 20 20 20 20 20 20 2a 2a range. **
25260 20 6f 66 20 6c 65 67 61 6c 20 76 61 6c 75 65 73 of legal values
25270 20 66 6f 72 20 69 73 4f 72 64 65 72 65 64 2c 20 for isOrdered,
25280 2d 31 2e 2e 36 34 2e 0a 20 20 20 20 20 20 20 20 -1..64..
25290 2a 2f 0a 20 20 20 20 20 20 20 20 66 6f 72 28 6a */. for(j
252a0 6a 3d 30 2c 20 70 54 6f 3d 61 54 6f 3b 20 6a 6a j=0, pTo=aTo; jj
252b0 3c 6e 54 6f 3b 20 6a 6a 2b 2b 2c 20 70 54 6f 2b <nTo; jj++, pTo+
252c0 2b 29 7b 0a 20 20 20 20 20 20 20 20 20 20 69 66 +){. if
252d0 28 20 70 54 6f 2d 3e 6d 61 73 6b 4c 6f 6f 70 3d ( pTo->maskLoop=
252e0 3d 6d 61 73 6b 4e 65 77 0a 20 20 20 20 20 20 20 =maskNew.
252f0 20 20 20 20 26 26 20 28 28 70 54 6f 2d 3e 69 73 && ((pTo->is
25300 4f 72 64 65 72 65 64 5e 69 73 4f 72 64 65 72 65 Ordered^isOrdere
25310 64 29 26 30 78 38 30 29 3d 3d 30 0a 20 20 20 20 d)&0x80)==0.
25320 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 ){.
25330 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 6a testcase( j
25340 6a 3d 3d 6e 54 6f 2d 31 20 29 3b 0a 20 20 20 20 j==nTo-1 );.
25350 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 break;.
25360 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 }.
25370 20 20 20 7d 0a 20 20 20 20 20 20 20 20 69 66 28 }. if(
25380 20 6a 6a 3e 3d 6e 54 6f 20 29 7b 0a 20 20 20 20 jj>=nTo ){.
25390 20 20 20 20 20 20 2f 2a 20 4e 6f 6e 65 20 6f 66 /* None of
253a0 20 74 68 65 20 65 78 69 73 74 69 6e 67 20 62 65 the existing be
253b0 73 74 2d 73 6f 2d 66 61 72 20 70 61 74 68 73 20 st-so-far paths
253c0 6d 61 74 63 68 20 74 68 65 20 63 61 6e 64 69 64 match the candid
253d0 61 74 65 2e 20 2a 2f 0a 20 20 20 20 20 20 20 20 ate. */.
253e0 20 20 69 66 28 20 6e 54 6f 3e 3d 6d 78 43 68 6f if( nTo>=mxCho
253f0 69 63 65 0a 20 20 20 20 20 20 20 20 20 20 20 26 ice. &
25400 26 20 28 72 43 6f 73 74 3e 6d 78 43 6f 73 74 20 & (rCost>mxCost
25410 7c 7c 20 28 72 43 6f 73 74 3d 3d 6d 78 43 6f 73 || (rCost==mxCos
25420 74 20 26 26 20 72 55 6e 73 6f 72 74 65 64 3e 3d t && rUnsorted>=
25430 6d 78 55 6e 73 6f 72 74 65 64 29 29 0a 20 20 20 mxUnsorted)).
25440 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 ){.
25450 20 20 20 20 20 20 2f 2a 20 54 68 65 20 63 75 72 /* The cur
25460 72 65 6e 74 20 63 61 6e 64 69 64 61 74 65 20 69 rent candidate i
25470 73 20 6e 6f 20 62 65 74 74 65 72 20 74 68 61 6e s no better than
25480 20 61 6e 79 20 6f 66 20 74 68 65 20 6d 78 43 68 any of the mxCh
25490 6f 69 63 65 0a 20 20 20 20 20 20 20 20 20 20 20 oice.
254a0 20 2a 2a 20 70 61 74 68 73 20 63 75 72 72 65 6e ** paths curren
254b0 74 6c 79 20 69 6e 20 74 68 65 20 62 65 73 74 2d tly in the best-
254c0 73 6f 2d 66 61 72 20 62 75 66 66 65 72 2e 20 20 so-far buffer.
254d0 53 6f 20 64 69 73 63 61 72 64 0a 20 20 20 20 20 So discard.
254e0 20 20 20 20 20 20 20 2a 2a 20 74 68 69 73 20 63 ** this c
254f0 61 6e 64 69 64 61 74 65 20 61 73 20 6e 6f 74 20 andidate as not
25500 76 69 61 62 6c 65 2e 20 2a 2f 0a 23 69 66 64 65 viable. */.#ifde
25510 66 20 57 48 45 52 45 54 52 41 43 45 5f 45 4e 41 f WHERETRACE_ENA
25520 42 4c 45 44 20 2f 2a 20 30 78 34 20 2a 2f 0a 20 BLED /* 0x4 */.
25530 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 73 if( s
25540 71 6c 69 74 65 33 57 68 65 72 65 54 72 61 63 65 qlite3WhereTrace
25550 26 30 78 34 20 29 7b 0a 20 20 20 20 20 20 20 20 &0x4 ){.
25560 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 65 62 sqlite3Deb
25570 75 67 50 72 69 6e 74 66 28 22 53 6b 69 70 20 20 ugPrintf("Skip
25580 20 25 73 20 63 6f 73 74 3d 25 2d 33 64 2c 25 33 %s cost=%-3d,%3
25590 64 2c 25 33 64 20 6f 72 64 65 72 3d 25 63 5c 6e d,%3d order=%c\n
255a0 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 ",.
255b0 20 20 20 20 20 77 68 65 72 65 50 61 74 68 4e 61 wherePathNa
255c0 6d 65 28 70 46 72 6f 6d 2c 20 69 4c 6f 6f 70 2c me(pFrom, iLoop,
255d0 20 70 57 4c 6f 6f 70 29 2c 20 72 43 6f 73 74 2c pWLoop), rCost,
255e0 20 6e 4f 75 74 2c 20 72 55 6e 73 6f 72 74 65 64 nOut, rUnsorted
255f0 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,.
25600 20 20 20 20 69 73 4f 72 64 65 72 65 64 3e 3d 30 isOrdered>=0
25610 20 3f 20 69 73 4f 72 64 65 72 65 64 2b 27 30 27 ? isOrdered+'0'
25620 20 3a 20 27 3f 27 29 3b 0a 20 20 20 20 20 20 20 : '?');.
25630 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 }.#endif.
25640 20 20 20 20 20 20 20 20 20 20 63 6f 6e 74 69 6e contin
25650 75 65 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a ue;. }.
25660 20 20 20 20 20 20 20 20 20 20 2f 2a 20 49 66 20 /* If
25670 77 65 20 72 65 61 63 68 20 74 68 69 73 20 70 6f we reach this po
25680 69 6e 74 73 20 69 74 20 6d 65 61 6e 73 20 74 68 ints it means th
25690 61 74 20 74 68 65 20 6e 65 77 20 63 61 6e 64 69 at the new candi
256a0 64 61 74 65 20 70 61 74 68 0a 20 20 20 20 20 20 date path.
256b0 20 20 20 20 2a 2a 20 6e 65 65 64 73 20 74 6f 20 ** needs to
256c0 62 65 20 61 64 64 65 64 20 74 6f 20 74 68 65 20 be added to the
256d0 73 65 74 20 6f 66 20 62 65 73 74 2d 73 6f 2d 66 set of best-so-f
256e0 61 72 20 70 61 74 68 73 2e 20 2a 2f 0a 20 20 20 ar paths. */.
256f0 20 20 20 20 20 20 20 69 66 28 20 6e 54 6f 3c 6d if( nTo<m
25700 78 43 68 6f 69 63 65 20 29 7b 0a 20 20 20 20 20 xChoice ){.
25710 20 20 20 20 20 20 20 2f 2a 20 49 6e 63 72 65 61 /* Increa
25720 73 65 20 74 68 65 20 73 69 7a 65 20 6f 66 20 74 se the size of t
25730 68 65 20 61 54 6f 20 73 65 74 20 62 79 20 6f 6e he aTo set by on
25740 65 20 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 e */.
25750 20 6a 6a 20 3d 20 6e 54 6f 2b 2b 3b 0a 20 20 20 jj = nTo++;.
25760 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 }else{.
25770 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 65 77 /* New
25780 20 70 61 74 68 20 72 65 70 6c 61 63 65 73 20 74 path replaces t
25790 68 65 20 70 72 69 6f 72 20 77 6f 72 73 74 20 74 he prior worst t
257a0 6f 20 6b 65 65 70 20 63 6f 75 6e 74 20 62 65 6c o keep count bel
257b0 6f 77 20 6d 78 43 68 6f 69 63 65 20 2a 2f 0a 20 ow mxChoice */.
257c0 20 20 20 20 20 20 20 20 20 20 20 6a 6a 20 3d 20 jj =
257d0 6d 78 49 3b 0a 20 20 20 20 20 20 20 20 20 20 7d mxI;. }
257e0 0a 20 20 20 20 20 20 20 20 20 20 70 54 6f 20 3d . pTo =
257f0 20 26 61 54 6f 5b 6a 6a 5d 3b 0a 23 69 66 64 65 &aTo[jj];.#ifde
25800 66 20 57 48 45 52 45 54 52 41 43 45 5f 45 4e 41 f WHERETRACE_ENA
25810 42 4c 45 44 20 2f 2a 20 30 78 34 20 2a 2f 0a 20 BLED /* 0x4 */.
25820 20 20 20 20 20 20 20 20 20 69 66 28 20 73 71 6c if( sql
25830 69 74 65 33 57 68 65 72 65 54 72 61 63 65 26 30 ite3WhereTrace&0
25840 78 34 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 x4 ){.
25850 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 sqlite3DebugPr
25860 69 6e 74 66 28 22 4e 65 77 20 20 20 20 25 73 20 intf("New %s
25870 63 6f 73 74 3d 25 2d 33 64 2c 25 33 64 2c 25 33 cost=%-3d,%3d,%3
25880 64 20 6f 72 64 65 72 3d 25 63 5c 6e 22 2c 0a 20 d order=%c\n",.
25890 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 w
258a0 68 65 72 65 50 61 74 68 4e 61 6d 65 28 70 46 72 herePathName(pFr
258b0 6f 6d 2c 20 69 4c 6f 6f 70 2c 20 70 57 4c 6f 6f om, iLoop, pWLoo
258c0 70 29 2c 20 72 43 6f 73 74 2c 20 6e 4f 75 74 2c p), rCost, nOut,
258d0 20 72 55 6e 73 6f 72 74 65 64 2c 0a 20 20 20 20 rUnsorted,.
258e0 20 20 20 20 20 20 20 20 20 20 20 20 69 73 4f 72 isOr
258f0 64 65 72 65 64 3e 3d 30 20 3f 20 69 73 4f 72 64 dered>=0 ? isOrd
25900 65 72 65 64 2b 27 30 27 20 3a 20 27 3f 27 29 3b ered+'0' : '?');
25910 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 23 65 6e . }.#en
25920 64 69 66 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 dif. }els
25930 65 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20 e{. /*
25940 43 6f 6e 74 72 6f 6c 20 72 65 61 63 68 65 73 20 Control reaches
25950 68 65 72 65 20 69 66 20 62 65 73 74 2d 73 6f 2d here if best-so-
25960 66 61 72 20 70 61 74 68 20 70 54 6f 3d 61 54 6f far path pTo=aTo
25970 5b 6a 6a 5d 20 63 6f 76 65 72 73 20 74 68 65 0a [jj] covers the.
25980 20 20 20 20 20 20 20 20 20 20 2a 2a 20 73 61 6d ** sam
25990 65 20 73 65 74 20 6f 66 20 6c 6f 6f 70 73 20 61 e set of loops a
259a0 6e 64 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 nd has the same
259b0 69 73 4f 72 64 65 72 65 64 20 73 65 74 74 69 6e isOrdered settin
259c0 67 20 61 73 20 74 68 65 0a 20 20 20 20 20 20 20 g as the.
259d0 20 20 20 2a 2a 20 63 61 6e 64 69 64 61 74 65 20 ** candidate
259e0 70 61 74 68 2e 20 20 43 68 65 63 6b 20 74 6f 20 path. Check to
259f0 73 65 65 20 69 66 20 74 68 65 20 63 61 6e 64 69 see if the candi
25a00 64 61 74 65 20 73 68 6f 75 6c 64 20 72 65 70 6c date should repl
25a10 61 63 65 0a 20 20 20 20 20 20 20 20 20 20 2a 2a ace. **
25a20 20 70 54 6f 20 6f 72 20 69 66 20 74 68 65 20 63 pTo or if the c
25a30 61 6e 64 69 64 61 74 65 20 73 68 6f 75 6c 64 20 andidate should
25a40 62 65 20 73 6b 69 70 70 65 64 2e 0a 20 20 20 20 be skipped..
25a50 20 20 20 20 20 20 2a 2a 20 0a 20 20 20 20 20 20 ** .
25a60 20 20 20 20 2a 2a 20 54 68 65 20 63 6f 6e 64 69 ** The condi
25a70 74 69 6f 6e 61 6c 20 69 73 20 61 6e 20 65 78 70 tional is an exp
25a80 61 6e 64 65 64 20 76 65 63 74 6f 72 20 63 6f 6d anded vector com
25a90 70 61 72 69 73 6f 6e 20 65 71 75 69 76 61 6c 65 parison equivale
25aa0 6e 74 20 74 6f 3a 0a 20 20 20 20 20 20 20 20 20 nt to:.
25ab0 20 2a 2a 20 20 20 28 70 54 6f 2d 3e 72 43 6f 73 ** (pTo->rCos
25ac0 74 2c 70 54 6f 2d 3e 6e 52 6f 77 2c 70 54 6f 2d t,pTo->nRow,pTo-
25ad0 3e 72 55 6e 73 6f 72 74 65 64 29 20 3c 3d 20 28 >rUnsorted) <= (
25ae0 72 43 6f 73 74 2c 6e 4f 75 74 2c 72 55 6e 73 6f rCost,nOut,rUnso
25af0 72 74 65 64 29 0a 20 20 20 20 20 20 20 20 20 20 rted).
25b00 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 */. if(
25b10 20 70 54 6f 2d 3e 72 43 6f 73 74 3c 72 43 6f 73 pTo->rCost<rCos
25b20 74 20 0a 20 20 20 20 20 20 20 20 20 20 20 7c 7c t . ||
25b30 20 28 70 54 6f 2d 3e 72 43 6f 73 74 3d 3d 72 43 (pTo->rCost==rC
25b40 6f 73 74 0a 20 20 20 20 20 20 20 20 20 20 20 20 ost.
25b50 20 20 20 26 26 20 28 70 54 6f 2d 3e 6e 52 6f 77 && (pTo->nRow
25b60 3c 6e 4f 75 74 0a 20 20 20 20 20 20 20 20 20 20 <nOut.
25b70 20 20 20 20 20 20 20 20 20 7c 7c 20 28 70 54 6f || (pTo
25b80 2d 3e 6e 52 6f 77 3d 3d 6e 4f 75 74 20 26 26 20 ->nRow==nOut &&
25b90 70 54 6f 2d 3e 72 55 6e 73 6f 72 74 65 64 3c 3d pTo->rUnsorted<=
25ba0 72 55 6e 73 6f 72 74 65 64 29 0a 20 20 20 20 20 rUnsorted).
25bb0 20 20 20 20 20 20 20 20 20 20 20 20 20 29 0a 20 ).
25bc0 20 20 20 20 20 20 20 20 20 20 20 20 20 29 0a 20 ).
25bd0 20 20 20 20 20 20 20 20 20 29 7b 0a 23 69 66 64 ){.#ifd
25be0 65 66 20 57 48 45 52 45 54 52 41 43 45 5f 45 4e ef WHERETRACE_EN
25bf0 41 42 4c 45 44 20 2f 2a 20 30 78 34 20 2a 2f 0a ABLED /* 0x4 */.
25c00 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 if(
25c10 73 71 6c 69 74 65 33 57 68 65 72 65 54 72 61 63 sqlite3WhereTrac
25c20 65 26 30 78 34 20 29 7b 0a 20 20 20 20 20 20 20 e&0x4 ){.
25c30 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 44 65 sqlite3De
25c40 62 75 67 50 72 69 6e 74 66 28 0a 20 20 20 20 20 bugPrintf(.
25c50 20 20 20 20 20 20 20 20 20 20 20 20 20 22 53 6b "Sk
25c60 69 70 20 20 20 25 73 20 63 6f 73 74 3d 25 2d 33 ip %s cost=%-3
25c70 64 2c 25 33 64 2c 25 33 64 20 6f 72 64 65 72 3d d,%3d,%3d order=
25c80 25 63 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 %c",.
25c90 20 20 20 20 20 20 20 77 68 65 72 65 50 61 74 68 wherePath
25ca0 4e 61 6d 65 28 70 46 72 6f 6d 2c 20 69 4c 6f 6f Name(pFrom, iLoo
25cb0 70 2c 20 70 57 4c 6f 6f 70 29 2c 20 72 43 6f 73 p, pWLoop), rCos
25cc0 74 2c 20 6e 4f 75 74 2c 20 72 55 6e 73 6f 72 74 t, nOut, rUnsort
25cd0 65 64 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 ed,.
25ce0 20 20 20 20 20 20 69 73 4f 72 64 65 72 65 64 3e isOrdered>
25cf0 3d 30 20 3f 20 69 73 4f 72 64 65 72 65 64 2b 27 =0 ? isOrdered+'
25d00 30 27 20 3a 20 27 3f 27 29 3b 0a 20 20 20 20 20 0' : '?');.
25d10 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
25d20 44 65 62 75 67 50 72 69 6e 74 66 28 22 20 20 20 DebugPrintf("
25d30 76 73 20 25 73 20 63 6f 73 74 3d 25 2d 33 64 2c vs %s cost=%-3d,
25d40 25 33 64 2c 25 33 64 20 6f 72 64 65 72 3d 25 63 %3d,%3d order=%c
25d50 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 \n",.
25d60 20 20 20 20 20 20 20 77 68 65 72 65 50 61 74 68 wherePath
25d70 4e 61 6d 65 28 70 54 6f 2c 20 69 4c 6f 6f 70 2b Name(pTo, iLoop+
25d80 31 2c 20 30 29 2c 20 70 54 6f 2d 3e 72 43 6f 73 1, 0), pTo->rCos
25d90 74 2c 20 70 54 6f 2d 3e 6e 52 6f 77 2c 0a 20 20 t, pTo->nRow,.
25da0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
25db0 70 54 6f 2d 3e 72 55 6e 73 6f 72 74 65 64 2c 20 pTo->rUnsorted,
25dc0 70 54 6f 2d 3e 69 73 4f 72 64 65 72 65 64 3e 3d pTo->isOrdered>=
25dd0 30 20 3f 20 70 54 6f 2d 3e 69 73 4f 72 64 65 72 0 ? pTo->isOrder
25de0 65 64 2b 27 30 27 20 3a 20 27 3f 27 29 3b 0a 20 ed+'0' : '?');.
25df0 20 20 20 20 20 20 20 20 20 20 20 7d 0a 23 65 6e }.#en
25e00 64 69 66 0a 20 20 20 20 20 20 20 20 20 20 20 20 dif.
25e10 2f 2a 20 44 69 73 63 61 72 64 20 74 68 65 20 63 /* Discard the c
25e20 61 6e 64 69 64 61 74 65 20 70 61 74 68 20 66 72 andidate path fr
25e30 6f 6d 20 66 75 72 74 68 65 72 20 63 6f 6e 73 69 om further consi
25e40 64 65 72 61 74 69 6f 6e 20 2a 2f 0a 20 20 20 20 deration */.
25e50 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 testcase
25e60 28 20 70 54 6f 2d 3e 72 43 6f 73 74 3d 3d 72 43 ( pTo->rCost==rC
25e70 6f 73 74 20 29 3b 0a 20 20 20 20 20 20 20 20 20 ost );.
25e80 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 continue;.
25e90 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
25ea0 20 20 20 74 65 73 74 63 61 73 65 28 20 70 54 6f testcase( pTo
25eb0 2d 3e 72 43 6f 73 74 3d 3d 72 43 6f 73 74 2b 31 ->rCost==rCost+1
25ec0 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a );. /*
25ed0 20 43 6f 6e 74 72 6f 6c 20 72 65 61 63 68 65 73 Control reaches
25ee0 20 68 65 72 65 20 69 66 20 74 68 65 20 63 61 6e here if the can
25ef0 64 69 64 61 74 65 20 70 61 74 68 20 69 73 20 62 didate path is b
25f00 65 74 74 65 72 20 74 68 61 6e 20 74 68 65 0a 20 etter than the.
25f10 20 20 20 20 20 20 20 20 20 2a 2a 20 70 54 6f 20 ** pTo
25f20 70 61 74 68 2e 20 20 52 65 70 6c 61 63 65 20 70 path. Replace p
25f30 54 6f 20 77 69 74 68 20 74 68 65 20 63 61 6e 64 To with the cand
25f40 69 64 61 74 65 2e 20 2a 2f 0a 23 69 66 64 65 66 idate. */.#ifdef
25f50 20 57 48 45 52 45 54 52 41 43 45 5f 45 4e 41 42 WHERETRACE_ENAB
25f60 4c 45 44 20 2f 2a 20 30 78 34 20 2a 2f 0a 20 20 LED /* 0x4 */.
25f70 20 20 20 20 20 20 20 20 69 66 28 20 73 71 6c 69 if( sqli
25f80 74 65 33 57 68 65 72 65 54 72 61 63 65 26 30 78 te3WhereTrace&0x
25f90 34 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 4 ){.
25fa0 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 sqlite3DebugPri
25fb0 6e 74 66 28 0a 20 20 20 20 20 20 20 20 20 20 20 ntf(.
25fc0 20 20 20 20 20 22 55 70 64 61 74 65 20 25 73 20 "Update %s
25fd0 63 6f 73 74 3d 25 2d 33 64 2c 25 33 64 2c 25 33 cost=%-3d,%3d,%3
25fe0 64 20 6f 72 64 65 72 3d 25 63 22 2c 0a 20 20 20 d order=%c",.
25ff0 20 20 20 20 20 20 20 20 20 20 20 20 20 77 68 65 whe
26000 72 65 50 61 74 68 4e 61 6d 65 28 70 46 72 6f 6d rePathName(pFrom
26010 2c 20 69 4c 6f 6f 70 2c 20 70 57 4c 6f 6f 70 29 , iLoop, pWLoop)
26020 2c 20 72 43 6f 73 74 2c 20 6e 4f 75 74 2c 20 72 , rCost, nOut, r
26030 55 6e 73 6f 72 74 65 64 2c 0a 20 20 20 20 20 20 Unsorted,.
26040 20 20 20 20 20 20 20 20 20 20 69 73 4f 72 64 65 isOrde
26050 72 65 64 3e 3d 30 20 3f 20 69 73 4f 72 64 65 72 red>=0 ? isOrder
26060 65 64 2b 27 30 27 20 3a 20 27 3f 27 29 3b 0a 20 ed+'0' : '?');.
26070 20 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 sqlit
26080 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 20 e3DebugPrintf("
26090 20 77 61 73 20 25 73 20 63 6f 73 74 3d 25 2d 33 was %s cost=%-3
260a0 64 2c 25 33 64 2c 25 33 64 20 6f 72 64 65 72 3d d,%3d,%3d order=
260b0 25 63 5c 6e 22 2c 0a 20 20 20 20 20 20 20 20 20 %c\n",.
260c0 20 20 20 20 20 20 20 77 68 65 72 65 50 61 74 68 wherePath
260d0 4e 61 6d 65 28 70 54 6f 2c 20 69 4c 6f 6f 70 2b Name(pTo, iLoop+
260e0 31 2c 20 30 29 2c 20 70 54 6f 2d 3e 72 43 6f 73 1, 0), pTo->rCos
260f0 74 2c 20 70 54 6f 2d 3e 6e 52 6f 77 2c 0a 20 20 t, pTo->nRow,.
26100 20 20 20 20 20 20 20 20 20 20 20 20 20 20 70 54 pT
26110 6f 2d 3e 72 55 6e 73 6f 72 74 65 64 2c 20 70 54 o->rUnsorted, pT
26120 6f 2d 3e 69 73 4f 72 64 65 72 65 64 3e 3d 30 20 o->isOrdered>=0
26130 3f 20 70 54 6f 2d 3e 69 73 4f 72 64 65 72 65 64 ? pTo->isOrdered
26140 2b 27 30 27 20 3a 20 27 3f 27 29 3b 0a 20 20 20 +'0' : '?');.
26150 20 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a }.#endif.
26160 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
26170 20 20 2f 2a 20 70 57 4c 6f 6f 70 20 69 73 20 61 /* pWLoop is a
26180 20 77 69 6e 6e 65 72 2e 20 20 41 64 64 20 69 74 winner. Add it
26190 20 74 6f 20 74 68 65 20 73 65 74 20 6f 66 20 62 to the set of b
261a0 65 73 74 20 73 6f 20 66 61 72 20 2a 2f 0a 20 20 est so far */.
261b0 20 20 20 20 20 20 70 54 6f 2d 3e 6d 61 73 6b 4c pTo->maskL
261c0 6f 6f 70 20 3d 20 70 46 72 6f 6d 2d 3e 6d 61 73 oop = pFrom->mas
261d0 6b 4c 6f 6f 70 20 7c 20 70 57 4c 6f 6f 70 2d 3e kLoop | pWLoop->
261e0 6d 61 73 6b 53 65 6c 66 3b 0a 20 20 20 20 20 20 maskSelf;.
261f0 20 20 70 54 6f 2d 3e 72 65 76 4c 6f 6f 70 20 3d pTo->revLoop =
26200 20 72 65 76 4d 61 73 6b 3b 0a 20 20 20 20 20 20 revMask;.
26210 20 20 70 54 6f 2d 3e 6e 52 6f 77 20 3d 20 6e 4f pTo->nRow = nO
26220 75 74 3b 0a 20 20 20 20 20 20 20 20 70 54 6f 2d ut;. pTo-
26230 3e 72 43 6f 73 74 20 3d 20 72 43 6f 73 74 3b 0a >rCost = rCost;.
26240 20 20 20 20 20 20 20 20 70 54 6f 2d 3e 72 55 6e pTo->rUn
26250 73 6f 72 74 65 64 20 3d 20 72 55 6e 73 6f 72 74 sorted = rUnsort
26260 65 64 3b 0a 20 20 20 20 20 20 20 20 70 54 6f 2d ed;. pTo-
26270 3e 69 73 4f 72 64 65 72 65 64 20 3d 20 69 73 4f >isOrdered = isO
26280 72 64 65 72 65 64 3b 0a 20 20 20 20 20 20 20 20 rdered;.
26290 6d 65 6d 63 70 79 28 70 54 6f 2d 3e 61 4c 6f 6f memcpy(pTo->aLoo
262a0 70 2c 20 70 46 72 6f 6d 2d 3e 61 4c 6f 6f 70 2c p, pFrom->aLoop,
262b0 20 73 69 7a 65 6f 66 28 57 68 65 72 65 4c 6f 6f sizeof(WhereLoo
262c0 70 2a 29 2a 69 4c 6f 6f 70 29 3b 0a 20 20 20 20 p*)*iLoop);.
262d0 20 20 20 20 70 54 6f 2d 3e 61 4c 6f 6f 70 5b 69 pTo->aLoop[i
262e0 4c 6f 6f 70 5d 20 3d 20 70 57 4c 6f 6f 70 3b 0a Loop] = pWLoop;.
262f0 20 20 20 20 20 20 20 20 69 66 28 20 6e 54 6f 3e if( nTo>
26300 3d 6d 78 43 68 6f 69 63 65 20 29 7b 0a 20 20 20 =mxChoice ){.
26310 20 20 20 20 20 20 20 6d 78 49 20 3d 20 30 3b 0a mxI = 0;.
26320 20 20 20 20 20 20 20 20 20 20 6d 78 43 6f 73 74 mxCost
26330 20 3d 20 61 54 6f 5b 30 5d 2e 72 43 6f 73 74 3b = aTo[0].rCost;
26340 0a 20 20 20 20 20 20 20 20 20 20 6d 78 55 6e 73 . mxUns
26350 6f 72 74 65 64 20 3d 20 61 54 6f 5b 30 5d 2e 6e orted = aTo[0].n
26360 52 6f 77 3b 0a 20 20 20 20 20 20 20 20 20 20 66 Row;. f
26370 6f 72 28 6a 6a 3d 31 2c 20 70 54 6f 3d 26 61 54 or(jj=1, pTo=&aT
26380 6f 5b 31 5d 3b 20 6a 6a 3c 6d 78 43 68 6f 69 63 o[1]; jj<mxChoic
26390 65 3b 20 6a 6a 2b 2b 2c 20 70 54 6f 2b 2b 29 7b e; jj++, pTo++){
263a0 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 . if(
263b0 20 70 54 6f 2d 3e 72 43 6f 73 74 3e 6d 78 43 6f pTo->rCost>mxCo
263c0 73 74 20 0a 20 20 20 20 20 20 20 20 20 20 20 20 st .
263d0 20 7c 7c 20 28 70 54 6f 2d 3e 72 43 6f 73 74 3d || (pTo->rCost=
263e0 3d 6d 78 43 6f 73 74 20 26 26 20 70 54 6f 2d 3e =mxCost && pTo->
263f0 72 55 6e 73 6f 72 74 65 64 3e 6d 78 55 6e 73 6f rUnsorted>mxUnso
26400 72 74 65 64 29 20 0a 20 20 20 20 20 20 20 20 20 rted) .
26410 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 ){.
26420 20 20 20 20 6d 78 43 6f 73 74 20 3d 20 70 54 6f mxCost = pTo
26430 2d 3e 72 43 6f 73 74 3b 0a 20 20 20 20 20 20 20 ->rCost;.
26440 20 20 20 20 20 20 20 6d 78 55 6e 73 6f 72 74 65 mxUnsorte
26450 64 20 3d 20 70 54 6f 2d 3e 72 55 6e 73 6f 72 74 d = pTo->rUnsort
26460 65 64 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 ed;.
26470 20 20 6d 78 49 20 3d 20 6a 6a 3b 0a 20 20 20 20 mxI = jj;.
26480 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
26490 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a }. }.
264a0 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 0a 23 }. }..#
264b0 69 66 64 65 66 20 57 48 45 52 45 54 52 41 43 45 ifdef WHERETRACE
264c0 5f 45 4e 41 42 4c 45 44 20 20 2f 2a 20 3e 3d 32 _ENABLED /* >=2
264d0 20 2a 2f 0a 20 20 20 20 69 66 28 20 73 71 6c 69 */. if( sqli
264e0 74 65 33 57 68 65 72 65 54 72 61 63 65 20 26 20 te3WhereTrace &
264f0 30 78 30 32 20 29 7b 0a 20 20 20 20 20 20 73 71 0x02 ){. sq
26500 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 lite3DebugPrintf
26510 28 22 2d 2d 2d 2d 20 61 66 74 65 72 20 72 6f 75 ("---- after rou
26520 6e 64 20 25 64 20 2d 2d 2d 2d 5c 6e 22 2c 20 69 nd %d ----\n", i
26530 4c 6f 6f 70 29 3b 0a 20 20 20 20 20 20 66 6f 72 Loop);. for
26540 28 69 69 3d 30 2c 20 70 54 6f 3d 61 54 6f 3b 20 (ii=0, pTo=aTo;
26550 69 69 3c 6e 54 6f 3b 20 69 69 2b 2b 2c 20 70 54 ii<nTo; ii++, pT
26560 6f 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 73 71 o++){. sq
26570 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 lite3DebugPrintf
26580 28 22 20 25 73 20 63 6f 73 74 3d 25 2d 33 64 20 (" %s cost=%-3d
26590 6e 72 6f 77 3d 25 2d 33 64 20 6f 72 64 65 72 3d nrow=%-3d order=
265a0 25 63 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 %c",.
265b0 77 68 65 72 65 50 61 74 68 4e 61 6d 65 28 70 54 wherePathName(pT
265c0 6f 2c 20 69 4c 6f 6f 70 2b 31 2c 20 30 29 2c 20 o, iLoop+1, 0),
265d0 70 54 6f 2d 3e 72 43 6f 73 74 2c 20 70 54 6f 2d pTo->rCost, pTo-
265e0 3e 6e 52 6f 77 2c 0a 20 20 20 20 20 20 20 20 20 >nRow,.
265f0 20 20 70 54 6f 2d 3e 69 73 4f 72 64 65 72 65 64 pTo->isOrdered
26600 3e 3d 30 20 3f 20 28 70 54 6f 2d 3e 69 73 4f 72 >=0 ? (pTo->isOr
26610 64 65 72 65 64 2b 27 30 27 29 20 3a 20 27 3f 27 dered+'0') : '?'
26620 29 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 70 );. if( p
26630 54 6f 2d 3e 69 73 4f 72 64 65 72 65 64 3e 30 20 To->isOrdered>0
26640 29 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c ){. sql
26650 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 ite3DebugPrintf(
26660 22 20 72 65 76 3d 30 78 25 6c 6c 78 5c 6e 22 2c " rev=0x%llx\n",
26670 20 70 54 6f 2d 3e 72 65 76 4c 6f 6f 70 29 3b 0a pTo->revLoop);.
26680 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 }else{.
26690 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 sqlite3
266a0 44 65 62 75 67 50 72 69 6e 74 66 28 22 5c 6e 22 DebugPrintf("\n"
266b0 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 );. }.
266c0 20 20 20 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 69 }. }.#endi
266d0 66 0a 0a 20 20 20 20 2f 2a 20 53 77 61 70 20 74 f.. /* Swap t
266e0 68 65 20 72 6f 6c 65 73 20 6f 66 20 61 46 72 6f he roles of aFro
266f0 6d 20 61 6e 64 20 61 54 6f 20 66 6f 72 20 74 68 m and aTo for th
26700 65 20 6e 65 78 74 20 67 65 6e 65 72 61 74 69 6f e next generatio
26710 6e 20 2a 2f 0a 20 20 20 20 70 46 72 6f 6d 20 3d n */. pFrom =
26720 20 61 54 6f 3b 0a 20 20 20 20 61 54 6f 20 3d 20 aTo;. aTo =
26730 61 46 72 6f 6d 3b 0a 20 20 20 20 61 46 72 6f 6d aFrom;. aFrom
26740 20 3d 20 70 46 72 6f 6d 3b 0a 20 20 20 20 6e 46 = pFrom;. nF
26750 72 6f 6d 20 3d 20 6e 54 6f 3b 0a 20 20 7d 0a 0a rom = nTo;. }..
26760 20 20 69 66 28 20 6e 46 72 6f 6d 3d 3d 30 20 29 if( nFrom==0 )
26770 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 {. sqlite3Err
26780 6f 72 4d 73 67 28 70 50 61 72 73 65 2c 20 22 6e orMsg(pParse, "n
26790 6f 20 71 75 65 72 79 20 73 6f 6c 75 74 69 6f 6e o query solution
267a0 22 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 ");. sqlite3D
267b0 62 46 72 65 65 4e 4e 28 64 62 2c 20 70 53 70 61 bFreeNN(db, pSpa
267c0 63 65 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 ce);. return
267d0 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 SQLITE_ERROR;.
267e0 7d 0a 20 20 0a 20 20 2f 2a 20 46 69 6e 64 20 74 }. . /* Find t
267f0 68 65 20 6c 6f 77 65 73 74 20 63 6f 73 74 20 70 he lowest cost p
26800 61 74 68 2e 20 20 70 46 72 6f 6d 20 77 69 6c 6c ath. pFrom will
26810 20 62 65 20 6c 65 66 74 20 70 6f 69 6e 74 69 6e be left pointin
26820 67 20 74 6f 20 74 68 61 74 20 70 61 74 68 20 2a g to that path *
26830 2f 0a 20 20 70 46 72 6f 6d 20 3d 20 61 46 72 6f /. pFrom = aFro
26840 6d 3b 0a 20 20 66 6f 72 28 69 69 3d 31 3b 20 69 m;. for(ii=1; i
26850 69 3c 6e 46 72 6f 6d 3b 20 69 69 2b 2b 29 7b 0a i<nFrom; ii++){.
26860 20 20 20 20 69 66 28 20 70 46 72 6f 6d 2d 3e 72 if( pFrom->r
26870 43 6f 73 74 3e 61 46 72 6f 6d 5b 69 69 5d 2e 72 Cost>aFrom[ii].r
26880 43 6f 73 74 20 29 20 70 46 72 6f 6d 20 3d 20 26 Cost ) pFrom = &
26890 61 46 72 6f 6d 5b 69 69 5d 3b 0a 20 20 7d 0a 20 aFrom[ii];. }.
268a0 20 61 73 73 65 72 74 28 20 70 57 49 6e 66 6f 2d assert( pWInfo-
268b0 3e 6e 4c 65 76 65 6c 3d 3d 6e 4c 6f 6f 70 20 29 >nLevel==nLoop )
268c0 3b 0a 20 20 2f 2a 20 4c 6f 61 64 20 74 68 65 20 ;. /* Load the
268d0 6c 6f 77 65 73 74 20 63 6f 73 74 20 70 61 74 68 lowest cost path
268e0 20 69 6e 74 6f 20 70 57 49 6e 66 6f 20 2a 2f 0a into pWInfo */.
268f0 20 20 66 6f 72 28 69 4c 6f 6f 70 3d 30 3b 20 69 for(iLoop=0; i
26900 4c 6f 6f 70 3c 6e 4c 6f 6f 70 3b 20 69 4c 6f 6f Loop<nLoop; iLoo
26910 70 2b 2b 29 7b 0a 20 20 20 20 57 68 65 72 65 4c p++){. WhereL
26920 65 76 65 6c 20 2a 70 4c 65 76 65 6c 20 3d 20 70 evel *pLevel = p
26930 57 49 6e 66 6f 2d 3e 61 20 2b 20 69 4c 6f 6f 70 WInfo->a + iLoop
26940 3b 0a 20 20 20 20 70 4c 65 76 65 6c 2d 3e 70 57 ;. pLevel->pW
26950 4c 6f 6f 70 20 3d 20 70 57 4c 6f 6f 70 20 3d 20 Loop = pWLoop =
26960 70 46 72 6f 6d 2d 3e 61 4c 6f 6f 70 5b 69 4c 6f pFrom->aLoop[iLo
26970 6f 70 5d 3b 0a 20 20 20 20 70 4c 65 76 65 6c 2d op];. pLevel-
26980 3e 69 46 72 6f 6d 20 3d 20 70 57 4c 6f 6f 70 2d >iFrom = pWLoop-
26990 3e 69 54 61 62 3b 0a 20 20 20 20 70 4c 65 76 65 >iTab;. pLeve
269a0 6c 2d 3e 69 54 61 62 43 75 72 20 3d 20 70 57 49 l->iTabCur = pWI
269b0 6e 66 6f 2d 3e 70 54 61 62 4c 69 73 74 2d 3e 61 nfo->pTabList->a
269c0 5b 70 4c 65 76 65 6c 2d 3e 69 46 72 6f 6d 5d 2e [pLevel->iFrom].
269d0 69 43 75 72 73 6f 72 3b 0a 20 20 7d 0a 20 20 69 iCursor;. }. i
269e0 66 28 20 28 70 57 49 6e 66 6f 2d 3e 77 63 74 72 f( (pWInfo->wctr
269f0 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f 57 lFlags & WHERE_W
26a00 41 4e 54 5f 44 49 53 54 49 4e 43 54 29 21 3d 30 ANT_DISTINCT)!=0
26a10 0a 20 20 20 26 26 20 28 70 57 49 6e 66 6f 2d 3e . && (pWInfo->
26a20 77 63 74 72 6c 46 6c 61 67 73 20 26 20 57 48 45 wctrlFlags & WHE
26a30 52 45 5f 44 49 53 54 49 4e 43 54 42 59 29 3d 3d RE_DISTINCTBY)==
26a40 30 0a 20 20 20 26 26 20 70 57 49 6e 66 6f 2d 3e 0. && pWInfo->
26a50 65 44 69 73 74 69 6e 63 74 3d 3d 57 48 45 52 45 eDistinct==WHERE
26a60 5f 44 49 53 54 49 4e 43 54 5f 4e 4f 4f 50 0a 20 _DISTINCT_NOOP.
26a70 20 20 26 26 20 6e 52 6f 77 45 73 74 0a 20 20 29 && nRowEst. )
26a80 7b 0a 20 20 20 20 42 69 74 6d 61 73 6b 20 6e 6f {. Bitmask no
26a90 74 55 73 65 64 3b 0a 20 20 20 20 69 6e 74 20 72 tUsed;. int r
26aa0 63 20 3d 20 77 68 65 72 65 50 61 74 68 53 61 74 c = wherePathSat
26ab0 69 73 66 69 65 73 4f 72 64 65 72 42 79 28 70 57 isfiesOrderBy(pW
26ac0 49 6e 66 6f 2c 20 70 57 49 6e 66 6f 2d 3e 70 52 Info, pWInfo->pR
26ad0 65 73 75 6c 74 53 65 74 2c 20 70 46 72 6f 6d 2c esultSet, pFrom,
26ae0 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
26af0 20 20 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 WHERE_DISTINCT
26b00 42 59 2c 20 6e 4c 6f 6f 70 2d 31 2c 20 70 46 72 BY, nLoop-1, pFr
26b10 6f 6d 2d 3e 61 4c 6f 6f 70 5b 6e 4c 6f 6f 70 2d om->aLoop[nLoop-
26b20 31 5d 2c 20 26 6e 6f 74 55 73 65 64 29 3b 0a 20 1], ¬Used);.
26b30 20 20 20 69 66 28 20 72 63 3d 3d 70 57 49 6e 66 if( rc==pWInf
26b40 6f 2d 3e 70 52 65 73 75 6c 74 53 65 74 2d 3e 6e o->pResultSet->n
26b50 45 78 70 72 20 29 7b 0a 20 20 20 20 20 20 70 57 Expr ){. pW
26b60 49 6e 66 6f 2d 3e 65 44 69 73 74 69 6e 63 74 20 Info->eDistinct
26b70 3d 20 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 = WHERE_DISTINCT
26b80 5f 4f 52 44 45 52 45 44 3b 0a 20 20 20 20 7d 0a _ORDERED;. }.
26b90 20 20 7d 0a 20 20 69 66 28 20 70 57 49 6e 66 6f }. if( pWInfo
26ba0 2d 3e 70 4f 72 64 65 72 42 79 20 29 7b 0a 20 20 ->pOrderBy ){.
26bb0 20 20 69 66 28 20 70 57 49 6e 66 6f 2d 3e 77 63 if( pWInfo->wc
26bc0 74 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 trlFlags & WHERE
26bd0 5f 44 49 53 54 49 4e 43 54 42 59 20 29 7b 0a 20 _DISTINCTBY ){.
26be0 20 20 20 20 20 69 66 28 20 70 46 72 6f 6d 2d 3e if( pFrom->
26bf0 69 73 4f 72 64 65 72 65 64 3d 3d 70 57 49 6e 66 isOrdered==pWInf
26c00 6f 2d 3e 70 4f 72 64 65 72 42 79 2d 3e 6e 45 78 o->pOrderBy->nEx
26c10 70 72 20 29 7b 0a 20 20 20 20 20 20 20 20 70 57 pr ){. pW
26c20 49 6e 66 6f 2d 3e 65 44 69 73 74 69 6e 63 74 20 Info->eDistinct
26c30 3d 20 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 = WHERE_DISTINCT
26c40 5f 4f 52 44 45 52 45 44 3b 0a 20 20 20 20 20 20 _ORDERED;.
26c50 7d 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }. }else{.
26c60 20 20 20 70 57 49 6e 66 6f 2d 3e 6e 4f 42 53 61 pWInfo->nOBSa
26c70 74 20 3d 20 70 46 72 6f 6d 2d 3e 69 73 4f 72 64 t = pFrom->isOrd
26c80 65 72 65 64 3b 0a 20 20 20 20 20 20 70 57 49 6e ered;. pWIn
26c90 66 6f 2d 3e 72 65 76 4d 61 73 6b 20 3d 20 70 46 fo->revMask = pF
26ca0 72 6f 6d 2d 3e 72 65 76 4c 6f 6f 70 3b 0a 20 20 rom->revLoop;.
26cb0 20 20 20 20 69 66 28 20 70 57 49 6e 66 6f 2d 3e if( pWInfo->
26cc0 6e 4f 42 53 61 74 3c 3d 30 20 29 7b 0a 20 20 20 nOBSat<=0 ){.
26cd0 20 20 20 20 20 70 57 49 6e 66 6f 2d 3e 6e 4f 42 pWInfo->nOB
26ce0 53 61 74 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 Sat = 0;.
26cf0 20 69 66 28 20 6e 4c 6f 6f 70 3e 30 20 29 7b 0a if( nLoop>0 ){.
26d00 20 20 20 20 20 20 20 20 20 20 75 33 32 20 77 73 u32 ws
26d10 46 6c 61 67 73 20 3d 20 70 46 72 6f 6d 2d 3e 61 Flags = pFrom->a
26d20 4c 6f 6f 70 5b 6e 4c 6f 6f 70 2d 31 5d 2d 3e 77 Loop[nLoop-1]->w
26d30 73 46 6c 61 67 73 3b 0a 20 20 20 20 20 20 20 20 sFlags;.
26d40 20 20 69 66 28 20 28 77 73 46 6c 61 67 73 20 26 if( (wsFlags &
26d50 20 57 48 45 52 45 5f 4f 4e 45 52 4f 57 29 3d 3d WHERE_ONEROW)==
26d60 30 20 0a 20 20 20 20 20 20 20 20 20 20 20 26 26 0 . &&
26d70 20 28 77 73 46 6c 61 67 73 26 28 57 48 45 52 45 (wsFlags&(WHERE
26d80 5f 49 50 4b 7c 57 48 45 52 45 5f 43 4f 4c 55 4d _IPK|WHERE_COLUM
26d90 4e 5f 49 4e 29 29 21 3d 28 57 48 45 52 45 5f 49 N_IN))!=(WHERE_I
26da0 50 4b 7c 57 48 45 52 45 5f 43 4f 4c 55 4d 4e 5f PK|WHERE_COLUMN_
26db0 49 4e 29 0a 20 20 20 20 20 20 20 20 20 20 29 7b IN). ){
26dc0 0a 20 20 20 20 20 20 20 20 20 20 20 20 42 69 74 . Bit
26dd0 6d 61 73 6b 20 6d 20 3d 20 30 3b 0a 20 20 20 20 mask m = 0;.
26de0 20 20 20 20 20 20 20 20 69 6e 74 20 72 63 20 3d int rc =
26df0 20 77 68 65 72 65 50 61 74 68 53 61 74 69 73 66 wherePathSatisf
26e00 69 65 73 4f 72 64 65 72 42 79 28 70 57 49 6e 66 iesOrderBy(pWInf
26e10 6f 2c 20 70 57 49 6e 66 6f 2d 3e 70 4f 72 64 65 o, pWInfo->pOrde
26e20 72 42 79 2c 20 70 46 72 6f 6d 2c 0a 20 20 20 20 rBy, pFrom,.
26e30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
26e40 20 20 57 48 45 52 45 5f 4f 52 44 45 52 42 59 5f WHERE_ORDERBY_
26e50 4c 49 4d 49 54 2c 20 6e 4c 6f 6f 70 2d 31 2c 20 LIMIT, nLoop-1,
26e60 70 46 72 6f 6d 2d 3e 61 4c 6f 6f 70 5b 6e 4c 6f pFrom->aLoop[nLo
26e70 6f 70 2d 31 5d 2c 20 26 6d 29 3b 0a 20 20 20 20 op-1], &m);.
26e80 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 testcase
26e90 28 20 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 ( wsFlags & WHER
26ea0 45 5f 49 50 4b 20 29 3b 0a 20 20 20 20 20 20 20 E_IPK );.
26eb0 20 20 20 20 20 74 65 73 74 63 61 73 65 28 20 77 testcase( w
26ec0 73 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f 43 sFlags & WHERE_C
26ed0 4f 4c 55 4d 4e 5f 49 4e 20 29 3b 0a 20 20 20 20 OLUMN_IN );.
26ee0 20 20 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d if( rc==
26ef0 70 57 49 6e 66 6f 2d 3e 70 4f 72 64 65 72 42 79 pWInfo->pOrderBy
26f00 2d 3e 6e 45 78 70 72 20 29 7b 0a 20 20 20 20 20 ->nExpr ){.
26f10 20 20 20 20 20 20 20 20 20 70 57 49 6e 66 6f 2d pWInfo-
26f20 3e 62 4f 72 64 65 72 65 64 49 6e 6e 65 72 4c 6f >bOrderedInnerLo
26f30 6f 70 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 op = 1;.
26f40 20 20 20 20 20 20 70 57 49 6e 66 6f 2d 3e 72 65 pWInfo->re
26f50 76 4d 61 73 6b 20 3d 20 6d 3b 0a 20 20 20 20 20 vMask = m;.
26f60 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 }.
26f70 20 20 20 7d 0a 20 20 20 20 20 20 20 20 7d 0a 20 }. }.
26f80 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 }. }.
26f90 20 69 66 28 20 28 70 57 49 6e 66 6f 2d 3e 77 63 if( (pWInfo->wc
26fa0 74 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 trlFlags & WHERE
26fb0 5f 53 4f 52 54 42 59 47 52 4f 55 50 29 0a 20 20 _SORTBYGROUP).
26fc0 20 20 20 20 20 20 26 26 20 70 57 49 6e 66 6f 2d && pWInfo-
26fd0 3e 6e 4f 42 53 61 74 3d 3d 70 57 49 6e 66 6f 2d >nOBSat==pWInfo-
26fe0 3e 70 4f 72 64 65 72 42 79 2d 3e 6e 45 78 70 72 >pOrderBy->nExpr
26ff0 20 26 26 20 6e 4c 6f 6f 70 3e 30 0a 20 20 20 20 && nLoop>0.
27000 29 7b 0a 20 20 20 20 20 20 42 69 74 6d 61 73 6b ){. Bitmask
27010 20 72 65 76 4d 61 73 6b 20 3d 20 30 3b 0a 20 20 revMask = 0;.
27020 20 20 20 20 69 6e 74 20 6e 4f 72 64 65 72 20 3d int nOrder =
27030 20 77 68 65 72 65 50 61 74 68 53 61 74 69 73 66 wherePathSatisf
27040 69 65 73 4f 72 64 65 72 42 79 28 70 57 49 6e 66 iesOrderBy(pWInf
27050 6f 2c 20 70 57 49 6e 66 6f 2d 3e 70 4f 72 64 65 o, pWInfo->pOrde
27060 72 42 79 2c 20 0a 20 20 20 20 20 20 20 20 20 20 rBy, .
27070 70 46 72 6f 6d 2c 20 30 2c 20 6e 4c 6f 6f 70 2d pFrom, 0, nLoop-
27080 31 2c 20 70 46 72 6f 6d 2d 3e 61 4c 6f 6f 70 5b 1, pFrom->aLoop[
27090 6e 4c 6f 6f 70 2d 31 5d 2c 20 26 72 65 76 4d 61 nLoop-1], &revMa
270a0 73 6b 0a 20 20 20 20 20 20 29 3b 0a 20 20 20 20 sk. );.
270b0 20 20 61 73 73 65 72 74 28 20 70 57 49 6e 66 6f assert( pWInfo
270c0 2d 3e 73 6f 72 74 65 64 3d 3d 30 20 29 3b 0a 20 ->sorted==0 );.
270d0 20 20 20 20 20 69 66 28 20 6e 4f 72 64 65 72 3d if( nOrder=
270e0 3d 70 57 49 6e 66 6f 2d 3e 70 4f 72 64 65 72 42 =pWInfo->pOrderB
270f0 79 2d 3e 6e 45 78 70 72 20 29 7b 0a 20 20 20 20 y->nExpr ){.
27100 20 20 20 20 70 57 49 6e 66 6f 2d 3e 73 6f 72 74 pWInfo->sort
27110 65 64 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 ed = 1;.
27120 70 57 49 6e 66 6f 2d 3e 72 65 76 4d 61 73 6b 20 pWInfo->revMask
27130 3d 20 72 65 76 4d 61 73 6b 3b 0a 20 20 20 20 20 = revMask;.
27140 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 0a 20 }. }. }...
27150 20 70 57 49 6e 66 6f 2d 3e 6e 52 6f 77 4f 75 74 pWInfo->nRowOut
27160 20 3d 20 70 46 72 6f 6d 2d 3e 6e 52 6f 77 3b 0a = pFrom->nRow;.
27170 0a 20 20 2f 2a 20 46 72 65 65 20 74 65 6d 70 6f . /* Free tempo
27180 72 61 72 79 20 6d 65 6d 6f 72 79 20 61 6e 64 20 rary memory and
27190 72 65 74 75 72 6e 20 73 75 63 63 65 73 73 20 2a return success *
271a0 2f 0a 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 /. sqlite3DbFre
271b0 65 4e 4e 28 64 62 2c 20 70 53 70 61 63 65 29 3b eNN(db, pSpace);
271c0 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 . return SQLITE
271d0 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 4d 6f _OK;.}../*.** Mo
271e0 73 74 20 71 75 65 72 69 65 73 20 75 73 65 20 6f st queries use o
271f0 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 74 61 62 nly a single tab
27200 6c 65 20 28 74 68 65 79 20 61 72 65 20 6e 6f 74 le (they are not
27210 20 6a 6f 69 6e 73 29 20 61 6e 64 20 68 61 76 65 joins) and have
27220 0a 2a 2a 20 73 69 6d 70 6c 65 20 3d 3d 20 63 6f .** simple == co
27230 6e 73 74 72 61 69 6e 74 73 20 61 67 61 69 6e 73 nstraints agains
27240 74 20 69 6e 64 65 78 65 64 20 66 69 65 6c 64 73 t indexed fields
27250 2e 20 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 . This routine
27260 61 74 74 65 6d 70 74 73 0a 2a 2a 20 74 6f 20 70 attempts.** to p
27270 6c 61 6e 20 74 68 6f 73 65 20 73 69 6d 70 6c 65 lan those simple
27280 20 63 61 73 65 73 20 75 73 69 6e 67 20 6d 75 63 cases using muc
27290 68 20 6c 65 73 73 20 63 65 72 65 6d 6f 6e 79 20 h less ceremony
272a0 74 68 61 6e 20 74 68 65 0a 2a 2a 20 67 65 6e 65 than the.** gene
272b0 72 61 6c 2d 70 75 72 70 6f 73 65 20 71 75 65 72 ral-purpose quer
272c0 79 20 70 6c 61 6e 6e 65 72 2c 20 61 6e 64 20 74 y planner, and t
272d0 68 65 72 65 62 79 20 79 69 65 6c 64 20 66 61 73 hereby yield fas
272e0 74 65 72 20 73 71 6c 69 74 65 33 5f 70 72 65 70 ter sqlite3_prep
272f0 61 72 65 28 29 0a 2a 2a 20 74 69 6d 65 73 20 66 are().** times f
27300 6f 72 20 74 68 65 20 63 6f 6d 6d 6f 6e 20 63 61 or the common ca
27310 73 65 2e 0a 2a 2a 0a 2a 2a 20 52 65 74 75 72 6e se..**.** Return
27320 20 6e 6f 6e 2d 7a 65 72 6f 20 6f 6e 20 73 75 63 non-zero on suc
27330 63 65 73 73 2c 20 69 66 20 74 68 69 73 20 71 75 cess, if this qu
27340 65 72 79 20 63 61 6e 20 62 65 20 68 61 6e 64 6c ery can be handl
27350 65 64 20 62 79 20 74 68 69 73 0a 2a 2a 20 6e 6f ed by this.** no
27360 2d 66 72 69 6c 6c 73 20 71 75 65 72 79 20 70 6c -frills query pl
27370 61 6e 6e 65 72 2e 20 20 52 65 74 75 72 6e 20 7a anner. Return z
27380 65 72 6f 20 69 66 20 74 68 69 73 20 71 75 65 72 ero if this quer
27390 79 20 6e 65 65 64 73 20 74 68 65 20 0a 2a 2a 20 y needs the .**
273a0 67 65 6e 65 72 61 6c 2d 70 75 72 70 6f 73 65 20 general-purpose
273b0 71 75 65 72 79 20 70 6c 61 6e 6e 65 72 2e 0a 2a query planner..*
273c0 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 77 68 65 /.static int whe
273d0 72 65 53 68 6f 72 74 43 75 74 28 57 68 65 72 65 reShortCut(Where
273e0 4c 6f 6f 70 42 75 69 6c 64 65 72 20 2a 70 42 75 LoopBuilder *pBu
273f0 69 6c 64 65 72 29 7b 0a 20 20 57 68 65 72 65 49 ilder){. WhereI
27400 6e 66 6f 20 2a 70 57 49 6e 66 6f 3b 0a 20 20 73 nfo *pWInfo;. s
27410 74 72 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 truct SrcList_it
27420 65 6d 20 2a 70 49 74 65 6d 3b 0a 20 20 57 68 65 em *pItem;. Whe
27430 72 65 43 6c 61 75 73 65 20 2a 70 57 43 3b 0a 20 reClause *pWC;.
27440 20 57 68 65 72 65 54 65 72 6d 20 2a 70 54 65 72 WhereTerm *pTer
27450 6d 3b 0a 20 20 57 68 65 72 65 4c 6f 6f 70 20 2a m;. WhereLoop *
27460 70 4c 6f 6f 70 3b 0a 20 20 69 6e 74 20 69 43 75 pLoop;. int iCu
27470 72 3b 0a 20 20 69 6e 74 20 6a 3b 0a 20 20 54 61 r;. int j;. Ta
27480 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20 49 6e 64 ble *pTab;. Ind
27490 65 78 20 2a 70 49 64 78 3b 0a 0a 20 20 70 57 49 ex *pIdx;.. pWI
274a0 6e 66 6f 20 3d 20 70 42 75 69 6c 64 65 72 2d 3e nfo = pBuilder->
274b0 70 57 49 6e 66 6f 3b 0a 20 20 69 66 28 20 70 57 pWInfo;. if( pW
274c0 49 6e 66 6f 2d 3e 77 63 74 72 6c 46 6c 61 67 73 Info->wctrlFlags
274d0 20 26 20 57 48 45 52 45 5f 4f 52 5f 53 55 42 43 & WHERE_OR_SUBC
274e0 4c 41 55 53 45 20 29 20 72 65 74 75 72 6e 20 30 LAUSE ) return 0
274f0 3b 0a 20 20 61 73 73 65 72 74 28 20 70 57 49 6e ;. assert( pWIn
27500 66 6f 2d 3e 70 54 61 62 4c 69 73 74 2d 3e 6e 53 fo->pTabList->nS
27510 72 63 3e 3d 31 20 29 3b 0a 20 20 70 49 74 65 6d rc>=1 );. pItem
27520 20 3d 20 70 57 49 6e 66 6f 2d 3e 70 54 61 62 4c = pWInfo->pTabL
27530 69 73 74 2d 3e 61 3b 0a 20 20 70 54 61 62 20 3d ist->a;. pTab =
27540 20 70 49 74 65 6d 2d 3e 70 54 61 62 3b 0a 20 20 pItem->pTab;.
27550 69 66 28 20 49 73 56 69 72 74 75 61 6c 28 70 54 if( IsVirtual(pT
27560 61 62 29 20 29 20 72 65 74 75 72 6e 20 30 3b 0a ab) ) return 0;.
27570 20 20 69 66 28 20 70 49 74 65 6d 2d 3e 66 67 2e if( pItem->fg.
27580 69 73 49 6e 64 65 78 65 64 42 79 20 29 20 72 65 isIndexedBy ) re
27590 74 75 72 6e 20 30 3b 0a 20 20 69 43 75 72 20 3d turn 0;. iCur =
275a0 20 70 49 74 65 6d 2d 3e 69 43 75 72 73 6f 72 3b pItem->iCursor;
275b0 0a 20 20 70 57 43 20 3d 20 26 70 57 49 6e 66 6f . pWC = &pWInfo
275c0 2d 3e 73 57 43 3b 0a 20 20 70 4c 6f 6f 70 20 3d ->sWC;. pLoop =
275d0 20 70 42 75 69 6c 64 65 72 2d 3e 70 4e 65 77 3b pBuilder->pNew;
275e0 0a 20 20 70 4c 6f 6f 70 2d 3e 77 73 46 6c 61 67 . pLoop->wsFlag
275f0 73 20 3d 20 30 3b 0a 20 20 70 4c 6f 6f 70 2d 3e s = 0;. pLoop->
27600 6e 53 6b 69 70 20 3d 20 30 3b 0a 20 20 70 54 65 nSkip = 0;. pTe
27610 72 6d 20 3d 20 73 71 6c 69 74 65 33 57 68 65 72 rm = sqlite3Wher
27620 65 46 69 6e 64 54 65 72 6d 28 70 57 43 2c 20 69 eFindTerm(pWC, i
27630 43 75 72 2c 20 2d 31 2c 20 30 2c 20 57 4f 5f 45 Cur, -1, 0, WO_E
27640 51 7c 57 4f 5f 49 53 2c 20 30 29 3b 0a 20 20 69 Q|WO_IS, 0);. i
27650 66 28 20 70 54 65 72 6d 20 29 7b 0a 20 20 20 20 f( pTerm ){.
27660 74 65 73 74 63 61 73 65 28 20 70 54 65 72 6d 2d testcase( pTerm-
27670 3e 65 4f 70 65 72 61 74 6f 72 20 26 20 57 4f 5f >eOperator & WO_
27680 49 53 20 29 3b 0a 20 20 20 20 70 4c 6f 6f 70 2d IS );. pLoop-
27690 3e 77 73 46 6c 61 67 73 20 3d 20 57 48 45 52 45 >wsFlags = WHERE
276a0 5f 43 4f 4c 55 4d 4e 5f 45 51 7c 57 48 45 52 45 _COLUMN_EQ|WHERE
276b0 5f 49 50 4b 7c 57 48 45 52 45 5f 4f 4e 45 52 4f _IPK|WHERE_ONERO
276c0 57 3b 0a 20 20 20 20 70 4c 6f 6f 70 2d 3e 61 4c W;. pLoop->aL
276d0 54 65 72 6d 5b 30 5d 20 3d 20 70 54 65 72 6d 3b Term[0] = pTerm;
276e0 0a 20 20 20 20 70 4c 6f 6f 70 2d 3e 6e 4c 54 65 . pLoop->nLTe
276f0 72 6d 20 3d 20 31 3b 0a 20 20 20 20 70 4c 6f 6f rm = 1;. pLoo
27700 70 2d 3e 75 2e 62 74 72 65 65 2e 6e 45 71 20 3d p->u.btree.nEq =
27710 20 31 3b 0a 20 20 20 20 2f 2a 20 54 55 4e 49 4e 1;. /* TUNIN
27720 47 3a 20 43 6f 73 74 20 6f 66 20 61 20 72 6f 77 G: Cost of a row
27730 69 64 20 6c 6f 6f 6b 75 70 20 69 73 20 31 30 20 id lookup is 10
27740 2a 2f 0a 20 20 20 20 70 4c 6f 6f 70 2d 3e 72 52 */. pLoop->rR
27750 75 6e 20 3d 20 33 33 3b 20 20 2f 2a 20 33 33 3d un = 33; /* 33=
27760 3d 73 71 6c 69 74 65 33 4c 6f 67 45 73 74 28 31 =sqlite3LogEst(1
27770 30 29 20 2a 2f 0a 20 20 7d 65 6c 73 65 7b 0a 20 0) */. }else{.
27780 20 20 20 66 6f 72 28 70 49 64 78 3d 70 54 61 62 for(pIdx=pTab
27790 2d 3e 70 49 6e 64 65 78 3b 20 70 49 64 78 3b 20 ->pIndex; pIdx;
277a0 70 49 64 78 3d 70 49 64 78 2d 3e 70 4e 65 78 74 pIdx=pIdx->pNext
277b0 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 6f 70 4d ){. int opM
277c0 61 73 6b 3b 0a 20 20 20 20 20 20 61 73 73 65 72 ask;. asser
277d0 74 28 20 70 4c 6f 6f 70 2d 3e 61 4c 54 65 72 6d t( pLoop->aLTerm
277e0 53 70 61 63 65 3d 3d 70 4c 6f 6f 70 2d 3e 61 4c Space==pLoop->aL
277f0 54 65 72 6d 20 29 3b 0a 20 20 20 20 20 20 69 66 Term );. if
27800 28 20 21 49 73 55 6e 69 71 75 65 49 6e 64 65 78 ( !IsUniqueIndex
27810 28 70 49 64 78 29 0a 20 20 20 20 20 20 20 7c 7c (pIdx). ||
27820 20 70 49 64 78 2d 3e 70 50 61 72 74 49 64 78 57 pIdx->pPartIdxW
27830 68 65 72 65 21 3d 30 20 0a 20 20 20 20 20 20 20 here!=0 .
27840 7c 7c 20 70 49 64 78 2d 3e 6e 4b 65 79 43 6f 6c || pIdx->nKeyCol
27850 3e 41 72 72 61 79 53 69 7a 65 28 70 4c 6f 6f 70 >ArraySize(pLoop
27860 2d 3e 61 4c 54 65 72 6d 53 70 61 63 65 29 20 0a ->aLTermSpace) .
27870 20 20 20 20 20 20 29 20 63 6f 6e 74 69 6e 75 65 ) continue
27880 3b 0a 20 20 20 20 20 20 6f 70 4d 61 73 6b 20 3d ;. opMask =
27890 20 70 49 64 78 2d 3e 75 6e 69 71 4e 6f 74 4e 75 pIdx->uniqNotNu
278a0 6c 6c 20 3f 20 28 57 4f 5f 45 51 7c 57 4f 5f 49 ll ? (WO_EQ|WO_I
278b0 53 29 20 3a 20 57 4f 5f 45 51 3b 0a 20 20 20 20 S) : WO_EQ;.
278c0 20 20 66 6f 72 28 6a 3d 30 3b 20 6a 3c 70 49 64 for(j=0; j<pId
278d0 78 2d 3e 6e 4b 65 79 43 6f 6c 3b 20 6a 2b 2b 29 x->nKeyCol; j++)
278e0 7b 0a 20 20 20 20 20 20 20 20 70 54 65 72 6d 20 {. pTerm
278f0 3d 20 73 71 6c 69 74 65 33 57 68 65 72 65 46 69 = sqlite3WhereFi
27900 6e 64 54 65 72 6d 28 70 57 43 2c 20 69 43 75 72 ndTerm(pWC, iCur
27910 2c 20 6a 2c 20 30 2c 20 6f 70 4d 61 73 6b 2c 20 , j, 0, opMask,
27920 70 49 64 78 29 3b 0a 20 20 20 20 20 20 20 20 69 pIdx);. i
27930 66 28 20 70 54 65 72 6d 3d 3d 30 20 29 20 62 72 f( pTerm==0 ) br
27940 65 61 6b 3b 0a 20 20 20 20 20 20 20 20 74 65 73 eak;. tes
27950 74 63 61 73 65 28 20 70 54 65 72 6d 2d 3e 65 4f tcase( pTerm->eO
27960 70 65 72 61 74 6f 72 20 26 20 57 4f 5f 49 53 20 perator & WO_IS
27970 29 3b 0a 20 20 20 20 20 20 20 20 70 4c 6f 6f 70 );. pLoop
27980 2d 3e 61 4c 54 65 72 6d 5b 6a 5d 20 3d 20 70 54 ->aLTerm[j] = pT
27990 65 72 6d 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 erm;. }.
279a0 20 20 20 69 66 28 20 6a 21 3d 70 49 64 78 2d 3e if( j!=pIdx->
279b0 6e 4b 65 79 43 6f 6c 20 29 20 63 6f 6e 74 69 6e nKeyCol ) contin
279c0 75 65 3b 0a 20 20 20 20 20 20 70 4c 6f 6f 70 2d ue;. pLoop-
279d0 3e 77 73 46 6c 61 67 73 20 3d 20 57 48 45 52 45 >wsFlags = WHERE
279e0 5f 43 4f 4c 55 4d 4e 5f 45 51 7c 57 48 45 52 45 _COLUMN_EQ|WHERE
279f0 5f 4f 4e 45 52 4f 57 7c 57 48 45 52 45 5f 49 4e _ONEROW|WHERE_IN
27a00 44 45 58 45 44 3b 0a 20 20 20 20 20 20 69 66 28 DEXED;. if(
27a10 20 70 49 64 78 2d 3e 69 73 43 6f 76 65 72 69 6e pIdx->isCoverin
27a20 67 20 7c 7c 20 28 70 49 74 65 6d 2d 3e 63 6f 6c g || (pItem->col
27a30 55 73 65 64 20 26 20 7e 63 6f 6c 75 6d 6e 73 49 Used & ~columnsI
27a40 6e 49 6e 64 65 78 28 70 49 64 78 29 29 3d 3d 30 nIndex(pIdx))==0
27a50 20 29 7b 0a 20 20 20 20 20 20 20 20 70 4c 6f 6f ){. pLoo
27a60 70 2d 3e 77 73 46 6c 61 67 73 20 7c 3d 20 57 48 p->wsFlags |= WH
27a70 45 52 45 5f 49 44 58 5f 4f 4e 4c 59 3b 0a 20 20 ERE_IDX_ONLY;.
27a80 20 20 20 20 7d 0a 20 20 20 20 20 20 70 4c 6f 6f }. pLoo
27a90 70 2d 3e 6e 4c 54 65 72 6d 20 3d 20 6a 3b 0a 20 p->nLTerm = j;.
27aa0 20 20 20 20 20 70 4c 6f 6f 70 2d 3e 75 2e 62 74 pLoop->u.bt
27ab0 72 65 65 2e 6e 45 71 20 3d 20 6a 3b 0a 20 20 20 ree.nEq = j;.
27ac0 20 20 20 70 4c 6f 6f 70 2d 3e 75 2e 62 74 72 65 pLoop->u.btre
27ad0 65 2e 70 49 6e 64 65 78 20 3d 20 70 49 64 78 3b e.pIndex = pIdx;
27ae0 0a 20 20 20 20 20 20 2f 2a 20 54 55 4e 49 4e 47 . /* TUNING
27af0 3a 20 43 6f 73 74 20 6f 66 20 61 20 75 6e 69 71 : Cost of a uniq
27b00 75 65 20 69 6e 64 65 78 20 6c 6f 6f 6b 75 70 20 ue index lookup
27b10 69 73 20 31 35 20 2a 2f 0a 20 20 20 20 20 20 70 is 15 */. p
27b20 4c 6f 6f 70 2d 3e 72 52 75 6e 20 3d 20 33 39 3b Loop->rRun = 39;
27b30 20 20 2f 2a 20 33 39 3d 3d 73 71 6c 69 74 65 33 /* 39==sqlite3
27b40 4c 6f 67 45 73 74 28 31 35 29 20 2a 2f 0a 20 20 LogEst(15) */.
27b50 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d break;. }
27b60 0a 20 20 7d 0a 20 20 69 66 28 20 70 4c 6f 6f 70 . }. if( pLoop
27b70 2d 3e 77 73 46 6c 61 67 73 20 29 7b 0a 20 20 20 ->wsFlags ){.
27b80 20 70 4c 6f 6f 70 2d 3e 6e 4f 75 74 20 3d 20 28 pLoop->nOut = (
27b90 4c 6f 67 45 73 74 29 31 3b 0a 20 20 20 20 70 57 LogEst)1;. pW
27ba0 49 6e 66 6f 2d 3e 61 5b 30 5d 2e 70 57 4c 6f 6f Info->a[0].pWLoo
27bb0 70 20 3d 20 70 4c 6f 6f 70 3b 0a 20 20 20 20 61 p = pLoop;. a
27bc0 73 73 65 72 74 28 20 70 57 49 6e 66 6f 2d 3e 73 ssert( pWInfo->s
27bd0 4d 61 73 6b 53 65 74 2e 6e 3d 3d 31 20 26 26 20 MaskSet.n==1 &&
27be0 69 43 75 72 3d 3d 70 57 49 6e 66 6f 2d 3e 73 4d iCur==pWInfo->sM
27bf0 61 73 6b 53 65 74 2e 69 78 5b 30 5d 20 29 3b 0a askSet.ix[0] );.
27c00 20 20 20 20 70 4c 6f 6f 70 2d 3e 6d 61 73 6b 53 pLoop->maskS
27c10 65 6c 66 20 3d 20 31 3b 20 2f 2a 20 73 71 6c 69 elf = 1; /* sqli
27c20 74 65 33 57 68 65 72 65 47 65 74 4d 61 73 6b 28 te3WhereGetMask(
27c30 26 70 57 49 6e 66 6f 2d 3e 73 4d 61 73 6b 53 65 &pWInfo->sMaskSe
27c40 74 2c 20 69 43 75 72 29 3b 20 2a 2f 0a 20 20 20 t, iCur); */.
27c50 20 70 57 49 6e 66 6f 2d 3e 61 5b 30 5d 2e 69 54 pWInfo->a[0].iT
27c60 61 62 43 75 72 20 3d 20 69 43 75 72 3b 0a 20 20 abCur = iCur;.
27c70 20 20 70 57 49 6e 66 6f 2d 3e 6e 52 6f 77 4f 75 pWInfo->nRowOu
27c80 74 20 3d 20 31 3b 0a 20 20 20 20 69 66 28 20 70 t = 1;. if( p
27c90 57 49 6e 66 6f 2d 3e 70 4f 72 64 65 72 42 79 20 WInfo->pOrderBy
27ca0 29 20 70 57 49 6e 66 6f 2d 3e 6e 4f 42 53 61 74 ) pWInfo->nOBSat
27cb0 20 3d 20 20 70 57 49 6e 66 6f 2d 3e 70 4f 72 64 = pWInfo->pOrd
27cc0 65 72 42 79 2d 3e 6e 45 78 70 72 3b 0a 20 20 20 erBy->nExpr;.
27cd0 20 69 66 28 20 70 57 49 6e 66 6f 2d 3e 77 63 74 if( pWInfo->wct
27ce0 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f rlFlags & WHERE_
27cf0 57 41 4e 54 5f 44 49 53 54 49 4e 43 54 20 29 7b WANT_DISTINCT ){
27d00 0a 20 20 20 20 20 20 70 57 49 6e 66 6f 2d 3e 65 . pWInfo->e
27d10 44 69 73 74 69 6e 63 74 20 3d 20 57 48 45 52 45 Distinct = WHERE
27d20 5f 44 49 53 54 49 4e 43 54 5f 55 4e 49 51 55 45 _DISTINCT_UNIQUE
27d30 3b 0a 20 20 20 20 7d 0a 23 69 66 64 65 66 20 53 ;. }.#ifdef S
27d40 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 20 20 QLITE_DEBUG.
27d50 70 4c 6f 6f 70 2d 3e 63 49 64 20 3d 20 27 30 27 pLoop->cId = '0'
27d60 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 72 65 74 ;.#endif. ret
27d70 75 72 6e 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74 urn 1;. }. ret
27d80 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 urn 0;.}../*.**
27d90 48 65 6c 70 65 72 20 66 75 6e 63 74 69 6f 6e 20 Helper function
27da0 66 6f 72 20 65 78 70 72 49 73 44 65 74 65 72 6d for exprIsDeterm
27db0 69 6e 69 73 74 69 63 28 29 2e 0a 2a 2f 0a 73 74 inistic()..*/.st
27dc0 61 74 69 63 20 69 6e 74 20 65 78 70 72 4e 6f 64 atic int exprNod
27dd0 65 49 73 44 65 74 65 72 6d 69 6e 69 73 74 69 63 eIsDeterministic
27de0 28 57 61 6c 6b 65 72 20 2a 70 57 61 6c 6b 65 72 (Walker *pWalker
27df0 2c 20 45 78 70 72 20 2a 70 45 78 70 72 29 7b 0a , Expr *pExpr){.
27e00 20 20 69 66 28 20 70 45 78 70 72 2d 3e 6f 70 3d if( pExpr->op=
27e10 3d 54 4b 5f 46 55 4e 43 54 49 4f 4e 20 26 26 20 =TK_FUNCTION &&
27e20 45 78 70 72 48 61 73 50 72 6f 70 65 72 74 79 28 ExprHasProperty(
27e30 70 45 78 70 72 2c 20 45 50 5f 43 6f 6e 73 74 46 pExpr, EP_ConstF
27e40 75 6e 63 29 3d 3d 30 20 29 7b 0a 20 20 20 20 70 unc)==0 ){. p
27e50 57 61 6c 6b 65 72 2d 3e 65 43 6f 64 65 20 3d 20 Walker->eCode =
27e60 30 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 57 52 0;. return WR
27e70 43 5f 41 62 6f 72 74 3b 0a 20 20 7d 0a 20 20 72 C_Abort;. }. r
27e80 65 74 75 72 6e 20 57 52 43 5f 43 6f 6e 74 69 6e eturn WRC_Contin
27e90 75 65 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 74 ue;.}../*.** Ret
27ea0 75 72 6e 20 74 72 75 65 20 69 66 20 74 68 65 20 urn true if the
27eb0 65 78 70 72 65 73 73 69 6f 6e 20 63 6f 6e 74 61 expression conta
27ec0 69 6e 73 20 6e 6f 20 6e 6f 6e 2d 64 65 74 65 72 ins no non-deter
27ed0 6d 69 6e 69 73 74 69 63 20 53 51 4c 20 0a 2a 2a ministic SQL .**
27ee0 20 66 75 6e 63 74 69 6f 6e 73 2e 20 44 6f 20 6e functions. Do n
27ef0 6f 74 20 63 6f 6e 73 69 64 65 72 20 6e 6f 6e 2d ot consider non-
27f00 64 65 74 65 72 6d 69 6e 69 73 74 69 63 20 53 51 deterministic SQ
27f10 4c 20 66 75 6e 63 74 69 6f 6e 73 20 74 68 61 74 L functions that
27f20 20 61 72 65 20 0a 2a 2a 20 70 61 72 74 20 6f 66 are .** part of
27f30 20 73 75 62 2d 73 65 6c 65 63 74 20 73 74 61 74 sub-select stat
27f40 65 6d 65 6e 74 73 2e 0a 2a 2f 0a 73 74 61 74 69 ements..*/.stati
27f50 63 20 69 6e 74 20 65 78 70 72 49 73 44 65 74 65 c int exprIsDete
27f60 72 6d 69 6e 69 73 74 69 63 28 45 78 70 72 20 2a rministic(Expr *
27f70 70 29 7b 0a 20 20 57 61 6c 6b 65 72 20 77 3b 0a p){. Walker w;.
27f80 20 20 6d 65 6d 73 65 74 28 26 77 2c 20 30 2c 20 memset(&w, 0,
27f90 73 69 7a 65 6f 66 28 77 29 29 3b 0a 20 20 77 2e sizeof(w));. w.
27fa0 65 43 6f 64 65 20 3d 20 31 3b 0a 20 20 77 2e 78 eCode = 1;. w.x
27fb0 45 78 70 72 43 61 6c 6c 62 61 63 6b 20 3d 20 65 ExprCallback = e
27fc0 78 70 72 4e 6f 64 65 49 73 44 65 74 65 72 6d 69 xprNodeIsDetermi
27fd0 6e 69 73 74 69 63 3b 0a 20 20 77 2e 78 53 65 6c nistic;. w.xSel
27fe0 65 63 74 43 61 6c 6c 62 61 63 6b 20 3d 20 73 71 ectCallback = sq
27ff0 6c 69 74 65 33 53 65 6c 65 63 74 57 61 6c 6b 46 lite3SelectWalkF
28000 61 69 6c 3b 0a 20 20 73 71 6c 69 74 65 33 57 61 ail;. sqlite3Wa
28010 6c 6b 45 78 70 72 28 26 77 2c 20 70 29 3b 0a 20 lkExpr(&w, p);.
28020 20 72 65 74 75 72 6e 20 77 2e 65 43 6f 64 65 3b return w.eCode;
28030 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 6e 65 72 61 .}../*.** Genera
28040 74 65 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 te the beginning
28050 20 6f 66 20 74 68 65 20 6c 6f 6f 70 20 75 73 65 of the loop use
28060 64 20 66 6f 72 20 57 48 45 52 45 20 63 6c 61 75 d for WHERE clau
28070 73 65 20 70 72 6f 63 65 73 73 69 6e 67 2e 0a 2a se processing..*
28080 2a 20 54 68 65 20 72 65 74 75 72 6e 20 76 61 6c * The return val
28090 75 65 20 69 73 20 61 20 70 6f 69 6e 74 65 72 20 ue is a pointer
280a0 74 6f 20 61 6e 20 6f 70 61 71 75 65 20 73 74 72 to an opaque str
280b0 75 63 74 75 72 65 20 74 68 61 74 20 63 6f 6e 74 ucture that cont
280c0 61 69 6e 73 0a 2a 2a 20 69 6e 66 6f 72 6d 61 74 ains.** informat
280d0 69 6f 6e 20 6e 65 65 64 65 64 20 74 6f 20 74 65 ion needed to te
280e0 72 6d 69 6e 61 74 65 20 74 68 65 20 6c 6f 6f 70 rminate the loop
280f0 2e 20 20 4c 61 74 65 72 2c 20 74 68 65 20 63 61 . Later, the ca
28100 6c 6c 69 6e 67 20 72 6f 75 74 69 6e 65 0a 2a 2a lling routine.**
28110 20 73 68 6f 75 6c 64 20 69 6e 76 6f 6b 65 20 73 should invoke s
28120 71 6c 69 74 65 33 57 68 65 72 65 45 6e 64 28 29 qlite3WhereEnd()
28130 20 77 69 74 68 20 74 68 65 20 72 65 74 75 72 6e with the return
28140 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 66 value of this f
28150 75 6e 63 74 69 6f 6e 0a 2a 2a 20 69 6e 20 6f 72 unction.** in or
28160 64 65 72 20 74 6f 20 63 6f 6d 70 6c 65 74 65 20 der to complete
28170 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 65 the WHERE clause
28180 20 70 72 6f 63 65 73 73 69 6e 67 2e 0a 2a 2a 0a processing..**.
28190 2a 2a 20 49 66 20 61 6e 20 65 72 72 6f 72 20 6f ** If an error o
281a0 63 63 75 72 73 2c 20 74 68 69 73 20 72 6f 75 74 ccurs, this rout
281b0 69 6e 65 20 72 65 74 75 72 6e 73 20 4e 55 4c 4c ine returns NULL
281c0 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 62 61 73 69 ..**.** The basi
281d0 63 20 69 64 65 61 20 69 73 20 74 6f 20 64 6f 20 c idea is to do
281e0 61 20 6e 65 73 74 65 64 20 6c 6f 6f 70 2c 20 6f a nested loop, o
281f0 6e 65 20 6c 6f 6f 70 20 66 6f 72 20 65 61 63 68 ne loop for each
28200 20 74 61 62 6c 65 20 69 6e 0a 2a 2a 20 74 68 65 table in.** the
28210 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 6f 66 20 FROM clause of
28220 61 20 73 65 6c 65 63 74 2e 20 20 28 49 4e 53 45 a select. (INSE
28230 52 54 20 61 6e 64 20 55 50 44 41 54 45 20 73 74 RT and UPDATE st
28240 61 74 65 6d 65 6e 74 73 20 61 72 65 20 74 68 65 atements are the
28250 0a 2a 2a 20 73 61 6d 65 20 61 73 20 61 20 53 45 .** same as a SE
28260 4c 45 43 54 20 77 69 74 68 20 6f 6e 6c 79 20 61 LECT with only a
28270 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 20 69 6e single table in
28280 20 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 the FROM clause
28290 2e 29 20 20 46 6f 72 0a 2a 2a 20 65 78 61 6d 70 .) For.** examp
282a0 6c 65 2c 20 69 66 20 74 68 65 20 53 51 4c 20 69 le, if the SQL i
282b0 73 20 74 68 69 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 s this:.**.**
282c0 20 20 20 20 53 45 4c 45 43 54 20 2a 20 46 52 4f SELECT * FRO
282d0 4d 20 74 31 2c 20 74 32 2c 20 74 33 20 57 48 45 M t1, t2, t3 WHE
282e0 52 45 20 2e 2e 2e 3b 0a 2a 2a 0a 2a 2a 20 54 68 RE ...;.**.** Th
282f0 65 6e 20 74 68 65 20 63 6f 64 65 20 67 65 6e 65 en the code gene
28300 72 61 74 65 64 20 69 73 20 63 6f 6e 63 65 70 74 rated is concept
28310 75 61 6c 6c 79 20 6c 69 6b 65 20 74 68 65 20 66 ually like the f
28320 6f 6c 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 ollowing:.**.**
28330 20 20 20 20 20 66 6f 72 65 61 63 68 20 72 6f 77 foreach row
28340 31 20 69 6e 20 74 31 20 64 6f 20 20 20 20 20 20 1 in t1 do
28350 20 5c 20 20 20 20 43 6f 64 65 20 67 65 6e 65 72 \ Code gener
28360 61 74 65 64 0a 2a 2a 20 20 20 20 20 20 20 20 66 ated.** f
28370 6f 72 65 61 63 68 20 72 6f 77 32 20 69 6e 20 74 oreach row2 in t
28380 32 20 64 6f 20 20 20 20 20 20 7c 2d 2d 20 62 79 2 do |-- by
28390 20 73 71 6c 69 74 65 33 57 68 65 72 65 42 65 67 sqlite3WhereBeg
283a0 69 6e 28 29 0a 2a 2a 20 20 20 20 20 20 20 20 20 in().**
283b0 20 66 6f 72 65 61 63 68 20 72 6f 77 33 20 69 6e foreach row3 in
283c0 20 74 33 20 64 6f 20 20 20 2f 0a 2a 2a 20 20 20 t3 do /.**
283d0 20 20 20 20 20 20 20 20 20 2e 2e 2e 0a 2a 2a 20 ....**
283e0 20 20 20 20 20 20 20 20 20 65 6e 64 20 20 20 20 end
283f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28400 20 5c 20 20 20 20 43 6f 64 65 20 67 65 6e 65 72 \ Code gener
28410 61 74 65 64 0a 2a 2a 20 20 20 20 20 20 20 20 65 ated.** e
28420 6e 64 20 20 20 20 20 20 20 20 20 20 20 20 20 20 nd
28430 20 20 20 20 20 20 20 20 20 20 7c 2d 2d 20 62 79 |-- by
28440 20 73 71 6c 69 74 65 33 57 68 65 72 65 45 6e 64 sqlite3WhereEnd
28450 28 29 0a 2a 2a 20 20 20 20 20 20 65 6e 64 20 20 ().** end
28460 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
28470 20 20 20 20 20 20 20 2f 0a 2a 2a 0a 2a 2a 20 4e /.**.** N
28480 6f 74 65 20 74 68 61 74 20 74 68 65 20 6c 6f 6f ote that the loo
28490 70 73 20 6d 69 67 68 74 20 6e 6f 74 20 62 65 20 ps might not be
284a0 6e 65 73 74 65 64 20 69 6e 20 74 68 65 20 6f 72 nested in the or
284b0 64 65 72 20 69 6e 20 77 68 69 63 68 20 74 68 65 der in which the
284c0 79 0a 2a 2a 20 61 70 70 65 61 72 20 69 6e 20 74 y.** appear in t
284d0 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 69 he FROM clause i
284e0 66 20 61 20 64 69 66 66 65 72 65 6e 74 20 6f 72 f a different or
284f0 64 65 72 20 69 73 20 62 65 74 74 65 72 20 61 62 der is better ab
28500 6c 65 20 74 6f 20 6d 61 6b 65 0a 2a 2a 20 75 73 le to make.** us
28510 65 20 6f 66 20 69 6e 64 69 63 65 73 2e 20 20 4e e of indices. N
28520 6f 74 65 20 61 6c 73 6f 20 74 68 61 74 20 77 68 ote also that wh
28530 65 6e 20 74 68 65 20 49 4e 20 6f 70 65 72 61 74 en the IN operat
28540 6f 72 20 61 70 70 65 61 72 73 20 69 6e 0a 2a 2a or appears in.**
28550 20 74 68 65 20 57 48 45 52 45 20 63 6c 61 75 73 the WHERE claus
28560 65 2c 20 69 74 20 6d 69 67 68 74 20 72 65 73 75 e, it might resu
28570 6c 74 20 69 6e 20 61 64 64 69 74 69 6f 6e 61 6c lt in additional
28580 20 6e 65 73 74 65 64 20 6c 6f 6f 70 73 20 66 6f nested loops fo
28590 72 0a 2a 2a 20 73 63 61 6e 6e 69 6e 67 20 74 68 r.** scanning th
285a0 72 6f 75 67 68 20 61 6c 6c 20 76 61 6c 75 65 73 rough all values
285b0 20 6f 6e 20 74 68 65 20 72 69 67 68 74 2d 68 61 on the right-ha
285c0 6e 64 20 73 69 64 65 20 6f 66 20 74 68 65 20 49 nd side of the I
285d0 4e 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 72 65 20 61 N..**.** There a
285e0 72 65 20 42 74 72 65 65 20 63 75 72 73 6f 72 73 re Btree cursors
285f0 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 associated with
28600 20 65 61 63 68 20 74 61 62 6c 65 2e 20 20 74 31 each table. t1
28610 20 75 73 65 73 20 63 75 72 73 6f 72 0a 2a 2a 20 uses cursor.**
28620 6e 75 6d 62 65 72 20 70 54 61 62 4c 69 73 74 2d number pTabList-
28630 3e 61 5b 30 5d 2e 69 43 75 72 73 6f 72 2e 20 20 >a[0].iCursor.
28640 74 32 20 75 73 65 73 20 74 68 65 20 63 75 72 73 t2 uses the curs
28650 6f 72 20 70 54 61 62 4c 69 73 74 2d 3e 61 5b 31 or pTabList->a[1
28660 5d 2e 69 43 75 72 73 6f 72 2e 0a 2a 2a 20 41 6e ].iCursor..** An
28670 64 20 73 6f 20 66 6f 72 74 68 2e 20 20 54 68 69 d so forth. Thi
28680 73 20 72 6f 75 74 69 6e 65 20 67 65 6e 65 72 61 s routine genera
28690 74 65 73 20 63 6f 64 65 20 74 6f 20 6f 70 65 6e tes code to open
286a0 20 74 68 6f 73 65 20 56 44 42 45 20 63 75 72 73 those VDBE curs
286b0 6f 72 73 0a 2a 2a 20 61 6e 64 20 73 71 6c 69 74 ors.** and sqlit
286c0 65 33 57 68 65 72 65 45 6e 64 28 29 20 67 65 6e e3WhereEnd() gen
286d0 65 72 61 74 65 73 20 74 68 65 20 63 6f 64 65 20 erates the code
286e0 74 6f 20 63 6c 6f 73 65 20 74 68 65 6d 2e 0a 2a to close them..*
286f0 2a 0a 2a 2a 20 54 68 65 20 63 6f 64 65 20 74 68 *.** The code th
28700 61 74 20 73 71 6c 69 74 65 33 57 68 65 72 65 42 at sqlite3WhereB
28710 65 67 69 6e 28 29 20 67 65 6e 65 72 61 74 65 73 egin() generates
28720 20 6c 65 61 76 65 73 20 74 68 65 20 63 75 72 73 leaves the curs
28730 6f 72 73 20 6e 61 6d 65 64 0a 2a 2a 20 69 6e 20 ors named.** in
28740 70 54 61 62 4c 69 73 74 20 70 6f 69 6e 74 69 6e pTabList pointin
28750 67 20 61 74 20 74 68 65 69 72 20 61 70 70 72 6f g at their appro
28760 70 72 69 61 74 65 20 65 6e 74 72 69 65 73 2e 20 priate entries.
28770 20 54 68 65 20 5b 2e 2e 2e 5d 20 63 6f 64 65 0a The [...] code.
28780 2a 2a 20 63 61 6e 20 75 73 65 20 4f 50 5f 43 6f ** can use OP_Co
28790 6c 75 6d 6e 20 61 6e 64 20 4f 50 5f 52 6f 77 69 lumn and OP_Rowi
287a0 64 20 6f 70 63 6f 64 65 73 20 6f 6e 20 74 68 65 d opcodes on the
287b0 73 65 20 63 75 72 73 6f 72 73 20 74 6f 20 65 78 se cursors to ex
287c0 74 72 61 63 74 0a 2a 2a 20 64 61 74 61 20 66 72 tract.** data fr
287d0 6f 6d 20 74 68 65 20 76 61 72 69 6f 75 73 20 74 om the various t
287e0 61 62 6c 65 73 20 6f 66 20 74 68 65 20 6c 6f 6f ables of the loo
287f0 70 2e 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 p..**.** If the
28800 57 48 45 52 45 20 63 6c 61 75 73 65 20 69 73 20 WHERE clause is
28810 65 6d 70 74 79 2c 20 74 68 65 20 66 6f 72 65 61 empty, the forea
28820 63 68 20 6c 6f 6f 70 73 20 6d 75 73 74 20 65 61 ch loops must ea
28830 63 68 20 73 63 61 6e 20 74 68 65 69 72 0a 2a 2a ch scan their.**
28840 20 65 6e 74 69 72 65 20 74 61 62 6c 65 73 2e 20 entire tables.
28850 20 54 68 75 73 20 61 20 74 68 72 65 65 2d 77 61 Thus a three-wa
28860 79 20 6a 6f 69 6e 20 69 73 20 61 6e 20 4f 28 4e y join is an O(N
28870 5e 33 29 20 6f 70 65 72 61 74 69 6f 6e 2e 20 20 ^3) operation.
28880 42 75 74 20 69 66 0a 2a 2a 20 74 68 65 20 74 61 But if.** the ta
28890 62 6c 65 73 20 68 61 76 65 20 69 6e 64 69 63 65 bles have indice
288a0 73 20 61 6e 64 20 74 68 65 72 65 20 61 72 65 20 s and there are
288b0 74 65 72 6d 73 20 69 6e 20 74 68 65 20 57 48 45 terms in the WHE
288c0 52 45 20 63 6c 61 75 73 65 20 74 68 61 74 0a 2a RE clause that.*
288d0 2a 20 72 65 66 65 72 20 74 6f 20 74 68 6f 73 65 * refer to those
288e0 20 69 6e 64 69 63 65 73 2c 20 61 20 63 6f 6d 70 indices, a comp
288f0 6c 65 74 65 20 74 61 62 6c 65 20 73 63 61 6e 20 lete table scan
28900 63 61 6e 20 62 65 20 61 76 6f 69 64 65 64 20 61 can be avoided a
28910 6e 64 20 74 68 65 0a 2a 2a 20 63 6f 64 65 20 77 nd the.** code w
28920 69 6c 6c 20 72 75 6e 20 6d 75 63 68 20 66 61 73 ill run much fas
28930 74 65 72 2e 20 20 4d 6f 73 74 20 6f 66 20 74 68 ter. Most of th
28940 65 20 77 6f 72 6b 20 6f 66 20 74 68 69 73 20 72 e work of this r
28950 6f 75 74 69 6e 65 20 69 73 20 63 68 65 63 6b 69 outine is checki
28960 6e 67 0a 2a 2a 20 74 6f 20 73 65 65 20 69 66 20 ng.** to see if
28970 74 68 65 72 65 20 61 72 65 20 69 6e 64 69 63 65 there are indice
28980 73 20 74 68 61 74 20 63 61 6e 20 62 65 20 75 73 s that can be us
28990 65 64 20 74 6f 20 73 70 65 65 64 20 75 70 20 74 ed to speed up t
289a0 68 65 20 6c 6f 6f 70 2e 0a 2a 2a 0a 2a 2a 20 54 he loop..**.** T
289b0 65 72 6d 73 20 6f 66 20 74 68 65 20 57 48 45 52 erms of the WHER
289c0 45 20 63 6c 61 75 73 65 20 61 72 65 20 61 6c 73 E clause are als
289d0 6f 20 75 73 65 64 20 74 6f 20 6c 69 6d 69 74 20 o used to limit
289e0 77 68 69 63 68 20 72 6f 77 73 20 61 63 74 75 61 which rows actua
289f0 6c 6c 79 0a 2a 2a 20 6d 61 6b 65 20 69 74 20 74 lly.** make it t
28a00 6f 20 74 68 65 20 22 2e 2e 2e 22 20 69 6e 20 74 o the "..." in t
28a10 68 65 20 6d 69 64 64 6c 65 20 6f 66 20 74 68 65 he middle of the
28a20 20 6c 6f 6f 70 2e 20 20 41 66 74 65 72 20 65 61 loop. After ea
28a30 63 68 20 22 66 6f 72 65 61 63 68 22 2c 0a 2a 2a ch "foreach",.**
28a40 20 74 65 72 6d 73 20 6f 66 20 74 68 65 20 57 48 terms of the WH
28a50 45 52 45 20 63 6c 61 75 73 65 20 74 68 61 74 20 ERE clause that
28a60 75 73 65 20 6f 6e 6c 79 20 74 65 72 6d 73 20 69 use only terms i
28a70 6e 20 74 68 61 74 20 6c 6f 6f 70 20 61 6e 64 20 n that loop and
28a80 6f 75 74 65 72 0a 2a 2a 20 6c 6f 6f 70 73 20 61 outer.** loops a
28a90 72 65 20 65 76 61 6c 75 61 74 65 64 20 61 6e 64 re evaluated and
28aa0 20 69 66 20 66 61 6c 73 65 20 61 20 6a 75 6d 70 if false a jump
28ab0 20 69 73 20 6d 61 64 65 20 61 72 6f 75 6e 64 20 is made around
28ac0 61 6c 6c 20 73 75 62 73 65 71 75 65 6e 74 0a 2a all subsequent.*
28ad0 2a 20 69 6e 6e 65 72 20 6c 6f 6f 70 73 20 28 6f * inner loops (o
28ae0 72 20 61 72 6f 75 6e 64 20 74 68 65 20 22 2e 2e r around the "..
28af0 2e 22 20 69 66 20 74 68 65 20 74 65 73 74 20 6f ." if the test o
28b00 63 63 75 72 73 20 77 69 74 68 69 6e 20 74 68 65 ccurs within the
28b10 20 69 6e 6e 65 72 2d 0a 2a 2a 20 6d 6f 73 74 20 inner-.** most
28b20 6c 6f 6f 70 29 0a 2a 2a 0a 2a 2a 20 4f 55 54 45 loop).**.** OUTE
28b30 52 20 4a 4f 49 4e 53 0a 2a 2a 0a 2a 2a 20 41 6e R JOINS.**.** An
28b40 20 6f 75 74 65 72 20 6a 6f 69 6e 20 6f 66 20 74 outer join of t
28b50 61 62 6c 65 73 20 74 31 20 61 6e 64 20 74 32 20 ables t1 and t2
28b60 69 73 20 63 6f 6e 63 65 70 74 61 6c 6c 79 20 63 is conceptally c
28b70 6f 64 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a oded as follows:
28b80 0a 2a 2a 0a 2a 2a 20 20 20 20 66 6f 72 65 61 63 .**.** foreac
28b90 68 20 72 6f 77 31 20 69 6e 20 74 31 20 64 6f 0a h row1 in t1 do.
28ba0 2a 2a 20 20 20 20 20 20 66 6c 61 67 20 3d 20 30 ** flag = 0
28bb0 0a 2a 2a 20 20 20 20 20 20 66 6f 72 65 61 63 68 .** foreach
28bc0 20 72 6f 77 32 20 69 6e 20 74 32 20 64 6f 0a 2a row2 in t2 do.*
28bd0 2a 20 20 20 20 20 20 20 20 73 74 61 72 74 3a 0a * start:.
28be0 2a 2a 20 20 20 20 20 20 20 20 20 20 2e 2e 2e 0a ** ....
28bf0 2a 2a 20 20 20 20 20 20 20 20 20 20 66 6c 61 67 ** flag
28c00 20 3d 20 31 0a 2a 2a 20 20 20 20 20 20 65 6e 64 = 1.** end
28c10 0a 2a 2a 20 20 20 20 20 20 69 66 20 66 6c 61 67 .** if flag
28c20 3d 3d 30 20 74 68 65 6e 0a 2a 2a 20 20 20 20 20 ==0 then.**
28c30 20 20 20 6d 6f 76 65 20 74 68 65 20 72 6f 77 32 move the row2
28c40 20 63 75 72 73 6f 72 20 74 6f 20 61 20 6e 75 6c cursor to a nul
28c50 6c 20 72 6f 77 0a 2a 2a 20 20 20 20 20 20 20 20 l row.**
28c60 67 6f 74 6f 20 73 74 61 72 74 0a 2a 2a 20 20 20 goto start.**
28c70 20 20 20 66 69 0a 2a 2a 20 20 20 20 65 6e 64 0a fi.** end.
28c80 2a 2a 0a 2a 2a 20 4f 52 44 45 52 20 42 59 20 43 **.** ORDER BY C
28c90 4c 41 55 53 45 20 50 52 4f 43 45 53 53 49 4e 47 LAUSE PROCESSING
28ca0 0a 2a 2a 0a 2a 2a 20 70 4f 72 64 65 72 42 79 20 .**.** pOrderBy
28cb0 69 73 20 61 20 70 6f 69 6e 74 65 72 20 74 6f 20 is a pointer to
28cc0 74 68 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 the ORDER BY cla
28cd0 75 73 65 20 28 6f 72 20 74 68 65 20 47 52 4f 55 use (or the GROU
28ce0 50 20 42 59 20 63 6c 61 75 73 65 0a 2a 2a 20 69 P BY clause.** i
28cf0 66 20 74 68 65 20 57 48 45 52 45 5f 47 52 4f 55 f the WHERE_GROU
28d00 50 42 59 20 66 6c 61 67 20 69 73 20 73 65 74 20 PBY flag is set
28d10 69 6e 20 77 63 74 72 6c 46 6c 61 67 73 29 20 6f in wctrlFlags) o
28d20 66 20 61 20 53 45 4c 45 43 54 20 73 74 61 74 65 f a SELECT state
28d30 6d 65 6e 74 0a 2a 2a 20 69 66 20 74 68 65 72 65 ment.** if there
28d40 20 69 73 20 6f 6e 65 2e 20 20 49 66 20 74 68 65 is one. If the
28d50 72 65 20 69 73 20 6e 6f 20 4f 52 44 45 52 20 42 re is no ORDER B
28d60 59 20 63 6c 61 75 73 65 20 6f 72 20 69 66 20 74 Y clause or if t
28d70 68 69 73 20 72 6f 75 74 69 6e 65 0a 2a 2a 20 69 his routine.** i
28d80 73 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 61 6e s called from an
28d90 20 55 50 44 41 54 45 20 6f 72 20 44 45 4c 45 54 UPDATE or DELET
28da0 45 20 73 74 61 74 65 6d 65 6e 74 2c 20 74 68 65 E statement, the
28db0 6e 20 70 4f 72 64 65 72 42 79 20 69 73 20 4e 55 n pOrderBy is NU
28dc0 4c 4c 2e 0a 2a 2a 0a 2a 2a 20 54 68 65 20 69 49 LL..**.** The iI
28dd0 64 78 43 75 72 20 70 61 72 61 6d 65 74 65 72 20 dxCur parameter
28de0 69 73 20 74 68 65 20 63 75 72 73 6f 72 20 6e 75 is the cursor nu
28df0 6d 62 65 72 20 6f 66 20 61 6e 20 69 6e 64 65 78 mber of an index
28e00 2e 20 20 49 66 20 0a 2a 2a 20 57 48 45 52 45 5f . If .** WHERE_
28e10 4f 52 5f 53 55 42 43 4c 41 55 53 45 20 69 73 20 OR_SUBCLAUSE is
28e20 73 65 74 2c 20 69 49 64 78 43 75 72 20 69 73 20 set, iIdxCur is
28e30 74 68 65 20 63 75 72 73 6f 72 20 6e 75 6d 62 65 the cursor numbe
28e40 72 20 6f 66 20 61 6e 20 69 6e 64 65 78 0a 2a 2a r of an index.**
28e50 20 74 6f 20 75 73 65 20 66 6f 72 20 4f 52 20 63 to use for OR c
28e60 6c 61 75 73 65 20 70 72 6f 63 65 73 73 69 6e 67 lause processing
28e70 2e 20 20 54 68 65 20 57 48 45 52 45 20 63 6c 61 . The WHERE cla
28e80 75 73 65 20 73 68 6f 75 6c 64 20 75 73 65 20 74 use should use t
28e90 68 69 73 0a 2a 2a 20 73 70 65 63 69 66 69 63 20 his.** specific
28ea0 63 75 72 73 6f 72 2e 20 20 49 66 20 57 48 45 52 cursor. If WHER
28eb0 45 5f 4f 4e 45 50 41 53 53 5f 44 45 53 49 52 45 E_ONEPASS_DESIRE
28ec0 44 20 69 73 20 73 65 74 2c 20 74 68 65 6e 20 69 D is set, then i
28ed0 49 64 78 43 75 72 20 69 73 0a 2a 2a 20 74 68 65 IdxCur is.** the
28ee0 20 66 69 72 73 74 20 63 75 72 73 6f 72 20 69 6e first cursor in
28ef0 20 61 6e 20 61 72 72 61 79 20 6f 66 20 63 75 72 an array of cur
28f00 73 6f 72 73 20 66 6f 72 20 61 6c 6c 20 69 6e 64 sors for all ind
28f10 69 63 65 73 2e 20 20 69 49 64 78 43 75 72 20 73 ices. iIdxCur s
28f20 68 6f 75 6c 64 0a 2a 2a 20 62 65 20 75 73 65 64 hould.** be used
28f30 20 74 6f 20 63 6f 6d 70 75 74 65 20 74 68 65 20 to compute the
28f40 61 70 70 72 6f 70 72 69 61 74 65 20 63 75 72 73 appropriate curs
28f50 6f 72 20 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 or depending on
28f60 77 68 69 63 68 20 69 6e 64 65 78 20 69 73 0a 2a which index is.*
28f70 2a 20 75 73 65 64 2e 0a 2a 2f 0a 57 68 65 72 65 * used..*/.Where
28f80 49 6e 66 6f 20 2a 73 71 6c 69 74 65 33 57 68 65 Info *sqlite3Whe
28f90 72 65 42 65 67 69 6e 28 0a 20 20 50 61 72 73 65 reBegin(. Parse
28fa0 20 2a 70 50 61 72 73 65 2c 20 20 20 20 20 20 20 *pParse,
28fb0 20 20 20 2f 2a 20 54 68 65 20 70 61 72 73 65 72 /* The parser
28fc0 20 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 53 72 context */. Sr
28fd0 63 4c 69 73 74 20 2a 70 54 61 62 4c 69 73 74 2c cList *pTabList,
28fe0 20 20 20 20 20 20 2f 2a 20 46 52 4f 4d 20 63 6c /* FROM cl
28ff0 61 75 73 65 3a 20 41 20 6c 69 73 74 20 6f 66 20 ause: A list of
29000 61 6c 6c 20 74 61 62 6c 65 73 20 74 6f 20 62 65 all tables to be
29010 20 73 63 61 6e 6e 65 64 20 2a 2f 0a 20 20 45 78 scanned */. Ex
29020 70 72 20 2a 70 57 68 65 72 65 2c 20 20 20 20 20 pr *pWhere,
29030 20 20 20 20 20 20 2f 2a 20 54 68 65 20 57 48 45 /* The WHE
29040 52 45 20 63 6c 61 75 73 65 20 2a 2f 0a 20 20 45 RE clause */. E
29050 78 70 72 4c 69 73 74 20 2a 70 4f 72 64 65 72 42 xprList *pOrderB
29060 79 2c 20 20 20 20 20 2f 2a 20 41 6e 20 4f 52 44 y, /* An ORD
29070 45 52 20 42 59 20 28 6f 72 20 47 52 4f 55 50 20 ER BY (or GROUP
29080 42 59 29 20 63 6c 61 75 73 65 2c 20 6f 72 20 4e BY) clause, or N
29090 55 4c 4c 20 2a 2f 0a 20 20 45 78 70 72 4c 69 73 ULL */. ExprLis
290a0 74 20 2a 70 52 65 73 75 6c 74 53 65 74 2c 20 20 t *pResultSet,
290b0 20 2f 2a 20 51 75 65 72 79 20 72 65 73 75 6c 74 /* Query result
290c0 20 73 65 74 2e 20 20 52 65 71 27 64 20 66 6f 72 set. Req'd for
290d0 20 44 49 53 54 49 4e 43 54 20 2a 2f 0a 20 20 75 DISTINCT */. u
290e0 31 36 20 77 63 74 72 6c 46 6c 61 67 73 2c 20 20 16 wctrlFlags,
290f0 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 57 48 /* The WH
29100 45 52 45 5f 2a 20 66 6c 61 67 73 20 64 65 66 69 ERE_* flags defi
29110 6e 65 64 20 69 6e 20 73 71 6c 69 74 65 49 6e 74 ned in sqliteInt
29120 2e 68 20 2a 2f 0a 20 20 69 6e 74 20 69 41 75 78 .h */. int iAux
29130 41 72 67 20 20 20 20 20 20 20 20 20 20 20 20 20 Arg
29140 2f 2a 20 49 66 20 57 48 45 52 45 5f 4f 52 5f 53 /* If WHERE_OR_S
29150 55 42 43 4c 41 55 53 45 20 69 73 20 73 65 74 2c UBCLAUSE is set,
29160 20 69 6e 64 65 78 20 63 75 72 73 6f 72 20 6e 75 index cursor nu
29170 6d 62 65 72 0a 20 20 20 20 20 20 20 20 20 20 20 mber.
29180 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2a *
29190 2a 20 49 66 20 57 48 45 52 45 5f 55 53 45 5f 4c * If WHERE_USE_L
291a0 49 4d 49 54 2c 20 74 68 65 6e 20 74 68 65 20 6c IMIT, then the l
291b0 69 6d 69 74 20 61 6d 6f 75 6e 74 20 2a 2f 0a 29 imit amount */.)
291c0 7b 0a 20 20 69 6e 74 20 6e 42 79 74 65 57 49 6e {. int nByteWIn
291d0 66 6f 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f fo; /
291e0 2a 20 4e 75 6d 2e 20 62 79 74 65 73 20 61 6c 6c * Num. bytes all
291f0 6f 63 61 74 65 64 20 66 6f 72 20 57 68 65 72 65 ocated for Where
29200 49 6e 66 6f 20 73 74 72 75 63 74 20 2a 2f 0a 20 Info struct */.
29210 20 69 6e 74 20 6e 54 61 62 4c 69 73 74 3b 20 20 int nTabList;
29220 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4e /* N
29230 75 6d 62 65 72 20 6f 66 20 65 6c 65 6d 65 6e 74 umber of element
29240 73 20 69 6e 20 70 54 61 62 4c 69 73 74 20 2a 2f s in pTabList */
29250 0a 20 20 57 68 65 72 65 49 6e 66 6f 20 2a 70 57 . WhereInfo *pW
29260 49 6e 66 6f 3b 20 20 20 20 20 20 20 20 20 2f 2a Info; /*
29270 20 57 69 6c 6c 20 62 65 63 6f 6d 65 20 74 68 65 Will become the
29280 20 72 65 74 75 72 6e 20 76 61 6c 75 65 20 6f 66 return value of
29290 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 2a this function *
292a0 2f 0a 20 20 56 64 62 65 20 2a 76 20 3d 20 70 50 /. Vdbe *v = pP
292b0 61 72 73 65 2d 3e 70 56 64 62 65 3b 20 20 20 2f arse->pVdbe; /
292c0 2a 20 54 68 65 20 76 69 72 74 75 61 6c 20 64 61 * The virtual da
292d0 74 61 62 61 73 65 20 65 6e 67 69 6e 65 20 2a 2f tabase engine */
292e0 0a 20 20 42 69 74 6d 61 73 6b 20 6e 6f 74 52 65 . Bitmask notRe
292f0 61 64 79 3b 20 20 20 20 20 20 20 20 20 20 2f 2a ady; /*
29300 20 43 75 72 73 6f 72 73 20 74 68 61 74 20 61 72 Cursors that ar
29310 65 20 6e 6f 74 20 79 65 74 20 70 6f 73 69 74 69 e not yet positi
29320 6f 6e 65 64 20 2a 2f 0a 20 20 57 68 65 72 65 4c oned */. WhereL
29330 6f 6f 70 42 75 69 6c 64 65 72 20 73 57 4c 42 3b oopBuilder sWLB;
29340 20 20 20 20 20 2f 2a 20 54 68 65 20 57 68 65 72 /* The Wher
29350 65 4c 6f 6f 70 20 62 75 69 6c 64 65 72 20 2a 2f eLoop builder */
29360 0a 20 20 57 68 65 72 65 4d 61 73 6b 53 65 74 20 . WhereMaskSet
29370 2a 70 4d 61 73 6b 53 65 74 3b 20 20 20 20 2f 2a *pMaskSet; /*
29380 20 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 The expression
29390 6d 61 73 6b 20 73 65 74 20 2a 2f 0a 20 20 57 68 mask set */. Wh
293a0 65 72 65 4c 65 76 65 6c 20 2a 70 4c 65 76 65 6c ereLevel *pLevel
293b0 3b 20 20 20 20 20 20 20 20 2f 2a 20 41 20 73 69 ; /* A si
293c0 6e 67 6c 65 20 6c 65 76 65 6c 20 69 6e 20 70 57 ngle level in pW
293d0 49 6e 66 6f 2d 3e 61 5b 5d 20 2a 2f 0a 20 20 57 Info->a[] */. W
293e0 68 65 72 65 4c 6f 6f 70 20 2a 70 4c 6f 6f 70 3b hereLoop *pLoop;
293f0 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 /* Poi
29400 6e 74 65 72 20 74 6f 20 61 20 73 69 6e 67 6c 65 nter to a single
29410 20 57 68 65 72 65 4c 6f 6f 70 20 6f 62 6a 65 63 WhereLoop objec
29420 74 20 2a 2f 0a 20 20 69 6e 74 20 69 69 3b 20 20 t */. int ii;
29430 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
29440 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 /* Loop counte
29450 72 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a r */. sqlite3 *
29460 64 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 db;
29470 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 63 6f /* Database co
29480 6e 6e 65 63 74 69 6f 6e 20 2a 2f 0a 20 20 69 6e nnection */. in
29490 74 20 72 63 3b 20 20 20 20 20 20 20 20 20 20 20 t rc;
294a0 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
294b0 72 6e 20 63 6f 64 65 20 2a 2f 0a 20 20 75 38 20 rn code */. u8
294c0 62 46 6f 72 64 65 6c 65 74 65 20 3d 20 30 3b 20 bFordelete = 0;
294d0 20 20 20 20 20 20 20 20 2f 2a 20 4f 50 46 4c 41 /* OPFLA
294e0 47 5f 46 4f 52 44 45 4c 45 54 45 20 6f 72 20 7a G_FORDELETE or z
294f0 65 72 6f 2c 20 61 73 20 61 70 70 72 6f 70 72 69 ero, as appropri
29500 61 74 65 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 ate */.. assert
29510 28 20 28 77 63 74 72 6c 46 6c 61 67 73 20 26 20 ( (wctrlFlags &
29520 57 48 45 52 45 5f 4f 4e 45 50 41 53 53 5f 4d 55 WHERE_ONEPASS_MU
29530 4c 54 49 52 4f 57 29 3d 3d 30 20 7c 7c 20 28 0a LTIROW)==0 || (.
29540 20 20 20 20 20 20 20 20 28 77 63 74 72 6c 46 6c (wctrlFl
29550 61 67 73 20 26 20 57 48 45 52 45 5f 4f 4e 45 50 ags & WHERE_ONEP
29560 41 53 53 5f 44 45 53 49 52 45 44 29 21 3d 30 20 ASS_DESIRED)!=0
29570 0a 20 20 20 20 20 26 26 20 28 77 63 74 72 6c 46 . && (wctrlF
29580 6c 61 67 73 20 26 20 57 48 45 52 45 5f 4f 52 5f lags & WHERE_OR_
29590 53 55 42 43 4c 41 55 53 45 29 3d 3d 30 20 0a 20 SUBCLAUSE)==0 .
295a0 20 29 29 3b 0a 0a 20 20 2f 2a 20 4f 6e 6c 79 20 ));.. /* Only
295b0 6f 6e 65 20 6f 66 20 57 48 45 52 45 5f 4f 52 5f one of WHERE_OR_
295c0 53 55 42 43 4c 41 55 53 45 20 6f 72 20 57 48 45 SUBCLAUSE or WHE
295d0 52 45 5f 55 53 45 5f 4c 49 4d 49 54 20 2a 2f 0a RE_USE_LIMIT */.
295e0 20 20 61 73 73 65 72 74 28 20 28 77 63 74 72 6c assert( (wctrl
295f0 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f 4f 52 Flags & WHERE_OR
29600 5f 53 55 42 43 4c 41 55 53 45 29 3d 3d 30 0a 20 _SUBCLAUSE)==0.
29610 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 28 77 || (w
29620 63 74 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 ctrlFlags & WHER
29630 45 5f 55 53 45 5f 4c 49 4d 49 54 29 3d 3d 30 20 E_USE_LIMIT)==0
29640 29 3b 0a 0a 20 20 2f 2a 20 56 61 72 69 61 62 6c );.. /* Variabl
29650 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e e initialization
29660 20 2a 2f 0a 20 20 64 62 20 3d 20 70 50 61 72 73 */. db = pPars
29670 65 2d 3e 64 62 3b 0a 20 20 6d 65 6d 73 65 74 28 e->db;. memset(
29680 26 73 57 4c 42 2c 20 30 2c 20 73 69 7a 65 6f 66 &sWLB, 0, sizeof
29690 28 73 57 4c 42 29 29 3b 0a 0a 20 20 2f 2a 20 41 (sWLB));.. /* A
296a0 6e 20 4f 52 44 45 52 2f 47 52 4f 55 50 20 42 59 n ORDER/GROUP BY
296b0 20 63 6c 61 75 73 65 20 6f 66 20 6d 6f 72 65 20 clause of more
296c0 74 68 61 6e 20 36 33 20 74 65 72 6d 73 20 63 61 than 63 terms ca
296d0 6e 6e 6f 74 20 62 65 20 6f 70 74 69 6d 69 7a 65 nnot be optimize
296e0 64 20 2a 2f 0a 20 20 74 65 73 74 63 61 73 65 28 d */. testcase(
296f0 20 70 4f 72 64 65 72 42 79 20 26 26 20 70 4f 72 pOrderBy && pOr
29700 64 65 72 42 79 2d 3e 6e 45 78 70 72 3d 3d 42 4d derBy->nExpr==BM
29710 53 2d 31 20 29 3b 0a 20 20 69 66 28 20 70 4f 72 S-1 );. if( pOr
29720 64 65 72 42 79 20 26 26 20 70 4f 72 64 65 72 42 derBy && pOrderB
29730 79 2d 3e 6e 45 78 70 72 3e 3d 42 4d 53 20 29 20 y->nExpr>=BMS )
29740 70 4f 72 64 65 72 42 79 20 3d 20 30 3b 0a 20 20 pOrderBy = 0;.
29750 73 57 4c 42 2e 70 4f 72 64 65 72 42 79 20 3d 20 sWLB.pOrderBy =
29760 70 4f 72 64 65 72 42 79 3b 0a 0a 20 20 2f 2a 20 pOrderBy;.. /*
29770 44 69 73 61 62 6c 65 20 74 68 65 20 44 49 53 54 Disable the DIST
29780 49 4e 43 54 20 6f 70 74 69 6d 69 7a 61 74 69 6f INCT optimizatio
29790 6e 20 69 66 20 53 51 4c 49 54 45 5f 44 69 73 74 n if SQLITE_Dist
297a0 69 6e 63 74 4f 70 74 20 69 73 20 73 65 74 20 76 inctOpt is set v
297b0 69 61 0a 20 20 2a 2a 20 73 71 6c 69 74 65 33 5f ia. ** sqlite3_
297c0 74 65 73 74 5f 63 74 72 6c 28 53 51 4c 49 54 45 test_ctrl(SQLITE
297d0 5f 54 45 53 54 43 54 52 4c 5f 4f 50 54 49 4d 49 _TESTCTRL_OPTIMI
297e0 5a 41 54 49 4f 4e 53 2c 2e 2e 2e 29 20 2a 2f 0a ZATIONS,...) */.
297f0 20 20 69 66 28 20 4f 70 74 69 6d 69 7a 61 74 69 if( Optimizati
29800 6f 6e 44 69 73 61 62 6c 65 64 28 64 62 2c 20 53 onDisabled(db, S
29810 51 4c 49 54 45 5f 44 69 73 74 69 6e 63 74 4f 70 QLITE_DistinctOp
29820 74 29 20 29 7b 0a 20 20 20 20 77 63 74 72 6c 46 t) ){. wctrlF
29830 6c 61 67 73 20 26 3d 20 7e 57 48 45 52 45 5f 57 lags &= ~WHERE_W
29840 41 4e 54 5f 44 49 53 54 49 4e 43 54 3b 0a 20 20 ANT_DISTINCT;.
29850 7d 0a 0a 20 20 2f 2a 20 54 68 65 20 6e 75 6d 62 }.. /* The numb
29860 65 72 20 6f 66 20 74 61 62 6c 65 73 20 69 6e 20 er of tables in
29870 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 20 the FROM clause
29880 69 73 20 6c 69 6d 69 74 65 64 20 62 79 20 74 68 is limited by th
29890 65 20 6e 75 6d 62 65 72 20 6f 66 0a 20 20 2a 2a e number of. **
298a0 20 62 69 74 73 20 69 6e 20 61 20 42 69 74 6d 61 bits in a Bitma
298b0 73 6b 20 0a 20 20 2a 2f 0a 20 20 74 65 73 74 63 sk . */. testc
298c0 61 73 65 28 20 70 54 61 62 4c 69 73 74 2d 3e 6e ase( pTabList->n
298d0 53 72 63 3d 3d 42 4d 53 20 29 3b 0a 20 20 69 66 Src==BMS );. if
298e0 28 20 70 54 61 62 4c 69 73 74 2d 3e 6e 53 72 63 ( pTabList->nSrc
298f0 3e 42 4d 53 20 29 7b 0a 20 20 20 20 73 71 6c 69 >BMS ){. sqli
29900 74 65 33 45 72 72 6f 72 4d 73 67 28 70 50 61 72 te3ErrorMsg(pPar
29910 73 65 2c 20 22 61 74 20 6d 6f 73 74 20 25 64 20 se, "at most %d
29920 74 61 62 6c 65 73 20 69 6e 20 61 20 6a 6f 69 6e tables in a join
29930 22 2c 20 42 4d 53 29 3b 0a 20 20 20 20 72 65 74 ", BMS);. ret
29940 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 2f 2a urn 0;. }.. /*
29950 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6e This function n
29960 6f 72 6d 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 ormally generate
29970 73 20 61 20 6e 65 73 74 65 64 20 6c 6f 6f 70 20 s a nested loop
29980 66 6f 72 20 61 6c 6c 20 74 61 62 6c 65 73 20 69 for all tables i
29990 6e 20 0a 20 20 2a 2a 20 70 54 61 62 4c 69 73 74 n . ** pTabList
299a0 2e 20 20 42 75 74 20 69 66 20 74 68 65 20 57 48 . But if the WH
299b0 45 52 45 5f 4f 52 5f 53 55 42 43 4c 41 55 53 45 ERE_OR_SUBCLAUSE
299c0 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20 74 68 flag is set, th
299d0 65 6e 20 77 65 20 73 68 6f 75 6c 64 0a 20 20 2a en we should. *
299e0 2a 20 6f 6e 6c 79 20 67 65 6e 65 72 61 74 65 20 * only generate
299f0 63 6f 64 65 20 66 6f 72 20 74 68 65 20 66 69 72 code for the fir
29a00 73 74 20 74 61 62 6c 65 20 69 6e 20 70 54 61 62 st table in pTab
29a10 4c 69 73 74 20 61 6e 64 20 61 73 73 75 6d 65 20 List and assume
29a20 74 68 61 74 0a 20 20 2a 2a 20 61 6e 79 20 63 75 that. ** any cu
29a30 72 73 6f 72 73 20 61 73 73 6f 63 69 61 74 65 64 rsors associated
29a40 20 77 69 74 68 20 73 75 62 73 65 71 75 65 6e 74 with subsequent
29a50 20 74 61 62 6c 65 73 20 61 72 65 20 75 6e 69 6e tables are unin
29a60 69 74 69 61 6c 69 7a 65 64 2e 0a 20 20 2a 2f 0a itialized.. */.
29a70 20 20 6e 54 61 62 4c 69 73 74 20 3d 20 28 77 63 nTabList = (wc
29a80 74 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 trlFlags & WHERE
29a90 5f 4f 52 5f 53 55 42 43 4c 41 55 53 45 29 20 3f _OR_SUBCLAUSE) ?
29aa0 20 31 20 3a 20 70 54 61 62 4c 69 73 74 2d 3e 6e 1 : pTabList->n
29ab0 53 72 63 3b 0a 0a 20 20 2f 2a 20 41 6c 6c 6f 63 Src;.. /* Alloc
29ac0 61 74 65 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 ate and initiali
29ad0 7a 65 20 74 68 65 20 57 68 65 72 65 49 6e 66 6f ze the WhereInfo
29ae0 20 73 74 72 75 63 74 75 72 65 20 74 68 61 74 20 structure that
29af0 77 69 6c 6c 20 62 65 63 6f 6d 65 20 74 68 65 0a will become the.
29b00 20 20 2a 2a 20 72 65 74 75 72 6e 20 76 61 6c 75 ** return valu
29b10 65 2e 20 41 20 73 69 6e 67 6c 65 20 61 6c 6c 6f e. A single allo
29b20 63 61 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 cation is used t
29b30 6f 20 73 74 6f 72 65 20 74 68 65 20 57 68 65 72 o store the Wher
29b40 65 49 6e 66 6f 0a 20 20 2a 2a 20 73 74 72 75 63 eInfo. ** struc
29b50 74 2c 20 74 68 65 20 63 6f 6e 74 65 6e 74 73 20 t, the contents
29b60 6f 66 20 57 68 65 72 65 49 6e 66 6f 2e 61 5b 5d of WhereInfo.a[]
29b70 2c 20 74 68 65 20 57 68 65 72 65 43 6c 61 75 73 , the WhereClaus
29b80 65 20 73 74 72 75 63 74 75 72 65 0a 20 20 2a 2a e structure. **
29b90 20 61 6e 64 20 74 68 65 20 57 68 65 72 65 4d 61 and the WhereMa
29ba0 73 6b 53 65 74 20 73 74 72 75 63 74 75 72 65 2e skSet structure.
29bb0 20 53 69 6e 63 65 20 57 68 65 72 65 43 6c 61 75 Since WhereClau
29bc0 73 65 20 63 6f 6e 74 61 69 6e 73 20 61 6e 20 38 se contains an 8
29bd0 2d 62 79 74 65 0a 20 20 2a 2a 20 66 69 65 6c 64 -byte. ** field
29be0 20 28 74 79 70 65 20 42 69 74 6d 61 73 6b 29 20 (type Bitmask)
29bf0 69 74 20 6d 75 73 74 20 62 65 20 61 6c 69 67 6e it must be align
29c00 65 64 20 6f 6e 20 61 6e 20 38 2d 62 79 74 65 20 ed on an 8-byte
29c10 62 6f 75 6e 64 61 72 79 20 6f 6e 0a 20 20 2a 2a boundary on. **
29c20 20 73 6f 6d 65 20 61 72 63 68 69 74 65 63 74 75 some architectu
29c30 72 65 73 2e 20 48 65 6e 63 65 20 74 68 65 20 52 res. Hence the R
29c40 4f 55 4e 44 38 28 29 20 62 65 6c 6f 77 2e 0a 20 OUND8() below..
29c50 20 2a 2f 0a 20 20 6e 42 79 74 65 57 49 6e 66 6f */. nByteWInfo
29c60 20 3d 20 52 4f 55 4e 44 38 28 73 69 7a 65 6f 66 = ROUND8(sizeof
29c70 28 57 68 65 72 65 49 6e 66 6f 29 2b 28 6e 54 61 (WhereInfo)+(nTa
29c80 62 4c 69 73 74 2d 31 29 2a 73 69 7a 65 6f 66 28 bList-1)*sizeof(
29c90 57 68 65 72 65 4c 65 76 65 6c 29 29 3b 0a 20 20 WhereLevel));.
29ca0 70 57 49 6e 66 6f 20 3d 20 73 71 6c 69 74 65 33 pWInfo = sqlite3
29cb0 44 62 4d 61 6c 6c 6f 63 52 61 77 4e 4e 28 64 62 DbMallocRawNN(db
29cc0 2c 20 6e 42 79 74 65 57 49 6e 66 6f 20 2b 20 73 , nByteWInfo + s
29cd0 69 7a 65 6f 66 28 57 68 65 72 65 4c 6f 6f 70 29 izeof(WhereLoop)
29ce0 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c );. if( db->mal
29cf0 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20 locFailed ){.
29d00 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 sqlite3DbFree(d
29d10 62 2c 20 70 57 49 6e 66 6f 29 3b 0a 20 20 20 20 b, pWInfo);.
29d20 70 57 49 6e 66 6f 20 3d 20 30 3b 0a 20 20 20 20 pWInfo = 0;.
29d30 67 6f 74 6f 20 77 68 65 72 65 42 65 67 69 6e 45 goto whereBeginE
29d40 72 72 6f 72 3b 0a 20 20 7d 0a 20 20 70 57 49 6e rror;. }. pWIn
29d50 66 6f 2d 3e 70 50 61 72 73 65 20 3d 20 70 50 61 fo->pParse = pPa
29d60 72 73 65 3b 0a 20 20 70 57 49 6e 66 6f 2d 3e 70 rse;. pWInfo->p
29d70 54 61 62 4c 69 73 74 20 3d 20 70 54 61 62 4c 69 TabList = pTabLi
29d80 73 74 3b 0a 20 20 70 57 49 6e 66 6f 2d 3e 70 4f st;. pWInfo->pO
29d90 72 64 65 72 42 79 20 3d 20 70 4f 72 64 65 72 42 rderBy = pOrderB
29da0 79 3b 0a 20 20 70 57 49 6e 66 6f 2d 3e 70 57 68 y;. pWInfo->pWh
29db0 65 72 65 20 3d 20 70 57 68 65 72 65 3b 0a 20 20 ere = pWhere;.
29dc0 70 57 49 6e 66 6f 2d 3e 70 52 65 73 75 6c 74 53 pWInfo->pResultS
29dd0 65 74 20 3d 20 70 52 65 73 75 6c 74 53 65 74 3b et = pResultSet;
29de0 0a 20 20 70 57 49 6e 66 6f 2d 3e 61 69 43 75 72 . pWInfo->aiCur
29df0 4f 6e 65 50 61 73 73 5b 30 5d 20 3d 20 70 57 49 OnePass[0] = pWI
29e00 6e 66 6f 2d 3e 61 69 43 75 72 4f 6e 65 50 61 73 nfo->aiCurOnePas
29e10 73 5b 31 5d 20 3d 20 2d 31 3b 0a 20 20 70 57 49 s[1] = -1;. pWI
29e20 6e 66 6f 2d 3e 6e 4c 65 76 65 6c 20 3d 20 6e 54 nfo->nLevel = nT
29e30 61 62 4c 69 73 74 3b 0a 20 20 70 57 49 6e 66 6f abList;. pWInfo
29e40 2d 3e 69 42 72 65 61 6b 20 3d 20 70 57 49 6e 66 ->iBreak = pWInf
29e50 6f 2d 3e 69 43 6f 6e 74 69 6e 75 65 20 3d 20 73 o->iContinue = s
29e60 71 6c 69 74 65 33 56 64 62 65 4d 61 6b 65 4c 61 qlite3VdbeMakeLa
29e70 62 65 6c 28 76 29 3b 0a 20 20 70 57 49 6e 66 6f bel(v);. pWInfo
29e80 2d 3e 77 63 74 72 6c 46 6c 61 67 73 20 3d 20 77 ->wctrlFlags = w
29e90 63 74 72 6c 46 6c 61 67 73 3b 0a 20 20 70 57 49 ctrlFlags;. pWI
29ea0 6e 66 6f 2d 3e 69 4c 69 6d 69 74 20 3d 20 69 41 nfo->iLimit = iA
29eb0 75 78 41 72 67 3b 0a 20 20 70 57 49 6e 66 6f 2d uxArg;. pWInfo-
29ec0 3e 73 61 76 65 64 4e 51 75 65 72 79 4c 6f 6f 70 >savedNQueryLoop
29ed0 20 3d 20 70 50 61 72 73 65 2d 3e 6e 51 75 65 72 = pParse->nQuer
29ee0 79 4c 6f 6f 70 3b 0a 20 20 6d 65 6d 73 65 74 28 yLoop;. memset(
29ef0 26 70 57 49 6e 66 6f 2d 3e 6e 4f 42 53 61 74 2c &pWInfo->nOBSat,
29f00 20 30 2c 20 0a 20 20 20 20 20 20 20 20 20 6f 66 0, . of
29f10 66 73 65 74 6f 66 28 57 68 65 72 65 49 6e 66 6f fsetof(WhereInfo
29f20 2c 73 57 43 29 20 2d 20 6f 66 66 73 65 74 6f 66 ,sWC) - offsetof
29f30 28 57 68 65 72 65 49 6e 66 6f 2c 6e 4f 42 53 61 (WhereInfo,nOBSa
29f40 74 29 29 3b 0a 20 20 6d 65 6d 73 65 74 28 26 70 t));. memset(&p
29f50 57 49 6e 66 6f 2d 3e 61 5b 30 5d 2c 20 30 2c 20 WInfo->a[0], 0,
29f60 73 69 7a 65 6f 66 28 57 68 65 72 65 4c 6f 6f 70 sizeof(WhereLoop
29f70 29 2b 6e 54 61 62 4c 69 73 74 2a 73 69 7a 65 6f )+nTabList*sizeo
29f80 66 28 57 68 65 72 65 4c 65 76 65 6c 29 29 3b 0a f(WhereLevel));.
29f90 20 20 61 73 73 65 72 74 28 20 70 57 49 6e 66 6f assert( pWInfo
29fa0 2d 3e 65 4f 6e 65 50 61 73 73 3d 3d 4f 4e 45 50 ->eOnePass==ONEP
29fb0 41 53 53 5f 4f 46 46 20 29 3b 20 20 2f 2a 20 4f ASS_OFF ); /* O
29fc0 4e 45 50 41 53 53 20 64 65 66 61 75 6c 74 73 20 NEPASS defaults
29fd0 74 6f 20 4f 46 46 20 2a 2f 0a 20 20 70 4d 61 73 to OFF */. pMas
29fe0 6b 53 65 74 20 3d 20 26 70 57 49 6e 66 6f 2d 3e kSet = &pWInfo->
29ff0 73 4d 61 73 6b 53 65 74 3b 0a 20 20 73 57 4c 42 sMaskSet;. sWLB
2a000 2e 70 57 49 6e 66 6f 20 3d 20 70 57 49 6e 66 6f .pWInfo = pWInfo
2a010 3b 0a 20 20 73 57 4c 42 2e 70 57 43 20 3d 20 26 ;. sWLB.pWC = &
2a020 70 57 49 6e 66 6f 2d 3e 73 57 43 3b 0a 20 20 73 pWInfo->sWC;. s
2a030 57 4c 42 2e 70 4e 65 77 20 3d 20 28 57 68 65 72 WLB.pNew = (Wher
2a040 65 4c 6f 6f 70 2a 29 28 28 28 63 68 61 72 2a 29 eLoop*)(((char*)
2a050 70 57 49 6e 66 6f 29 2b 6e 42 79 74 65 57 49 6e pWInfo)+nByteWIn
2a060 66 6f 29 3b 0a 20 20 61 73 73 65 72 74 28 20 45 fo);. assert( E
2a070 49 47 48 54 5f 42 59 54 45 5f 41 4c 49 47 4e 4d IGHT_BYTE_ALIGNM
2a080 45 4e 54 28 73 57 4c 42 2e 70 4e 65 77 29 20 29 ENT(sWLB.pNew) )
2a090 3b 0a 20 20 77 68 65 72 65 4c 6f 6f 70 49 6e 69 ;. whereLoopIni
2a0a0 74 28 73 57 4c 42 2e 70 4e 65 77 29 3b 0a 23 69 t(sWLB.pNew);.#i
2a0b0 66 64 65 66 20 53 51 4c 49 54 45 5f 44 45 42 55 fdef SQLITE_DEBU
2a0c0 47 0a 20 20 73 57 4c 42 2e 70 4e 65 77 2d 3e 63 G. sWLB.pNew->c
2a0d0 49 64 20 3d 20 27 2a 27 3b 0a 23 65 6e 64 69 66 Id = '*';.#endif
2a0e0 0a 0a 20 20 2f 2a 20 53 70 6c 69 74 20 74 68 65 .. /* Split the
2a0f0 20 57 48 45 52 45 20 63 6c 61 75 73 65 20 69 6e WHERE clause in
2a100 74 6f 20 73 65 70 61 72 61 74 65 20 73 75 62 65 to separate sube
2a110 78 70 72 65 73 73 69 6f 6e 73 20 77 68 65 72 65 xpressions where
2a120 20 65 61 63 68 0a 20 20 2a 2a 20 73 75 62 65 78 each. ** subex
2a130 70 72 65 73 73 69 6f 6e 20 69 73 20 73 65 70 61 pression is sepa
2a140 72 61 74 65 64 20 62 79 20 61 6e 20 41 4e 44 20 rated by an AND
2a150 6f 70 65 72 61 74 6f 72 2e 0a 20 20 2a 2f 0a 20 operator.. */.
2a160 20 69 6e 69 74 4d 61 73 6b 53 65 74 28 70 4d 61 initMaskSet(pMa
2a170 73 6b 53 65 74 29 3b 0a 20 20 73 71 6c 69 74 65 skSet);. sqlite
2a180 33 57 68 65 72 65 43 6c 61 75 73 65 49 6e 69 74 3WhereClauseInit
2a190 28 26 70 57 49 6e 66 6f 2d 3e 73 57 43 2c 20 70 (&pWInfo->sWC, p
2a1a0 57 49 6e 66 6f 29 3b 0a 20 20 73 71 6c 69 74 65 WInfo);. sqlite
2a1b0 33 57 68 65 72 65 53 70 6c 69 74 28 26 70 57 49 3WhereSplit(&pWI
2a1c0 6e 66 6f 2d 3e 73 57 43 2c 20 70 57 68 65 72 65 nfo->sWC, pWhere
2a1d0 2c 20 54 4b 5f 41 4e 44 29 3b 0a 20 20 20 20 0a , TK_AND);. .
2a1e0 20 20 2f 2a 20 53 70 65 63 69 61 6c 20 63 61 73 /* Special cas
2a1f0 65 3a 20 4e 6f 20 46 52 4f 4d 20 63 6c 61 75 73 e: No FROM claus
2a200 65 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6e 54 61 e. */. if( nTa
2a210 62 4c 69 73 74 3d 3d 30 20 29 7b 0a 20 20 20 20 bList==0 ){.
2a220 69 66 28 20 70 4f 72 64 65 72 42 79 20 29 20 70 if( pOrderBy ) p
2a230 57 49 6e 66 6f 2d 3e 6e 4f 42 53 61 74 20 3d 20 WInfo->nOBSat =
2a240 70 4f 72 64 65 72 42 79 2d 3e 6e 45 78 70 72 3b pOrderBy->nExpr;
2a250 0a 20 20 20 20 69 66 28 20 77 63 74 72 6c 46 6c . if( wctrlFl
2a260 61 67 73 20 26 20 57 48 45 52 45 5f 57 41 4e 54 ags & WHERE_WANT
2a270 5f 44 49 53 54 49 4e 43 54 20 29 7b 0a 20 20 20 _DISTINCT ){.
2a280 20 20 20 70 57 49 6e 66 6f 2d 3e 65 44 69 73 74 pWInfo->eDist
2a290 69 6e 63 74 20 3d 20 57 48 45 52 45 5f 44 49 53 inct = WHERE_DIS
2a2a0 54 49 4e 43 54 5f 55 4e 49 51 55 45 3b 0a 20 20 TINCT_UNIQUE;.
2a2b0 20 20 7d 0a 20 20 20 20 45 78 70 6c 61 69 6e 51 }. ExplainQ
2a2c0 75 65 72 79 50 6c 61 6e 28 28 70 50 61 72 73 65 ueryPlan((pParse
2a2d0 2c 20 30 2c 20 22 53 43 41 4e 20 43 4f 4e 53 54 , 0, "SCAN CONST
2a2e0 41 4e 54 20 52 4f 57 22 29 29 3b 0a 20 20 7d 65 ANT ROW"));. }e
2a2f0 6c 73 65 7b 0a 20 20 20 20 2f 2a 20 41 73 73 69 lse{. /* Assi
2a300 67 6e 20 61 20 62 69 74 20 66 72 6f 6d 20 74 68 gn a bit from th
2a310 65 20 62 69 74 6d 61 73 6b 20 74 6f 20 65 76 65 e bitmask to eve
2a320 72 79 20 74 65 72 6d 20 69 6e 20 74 68 65 20 46 ry term in the F
2a330 52 4f 4d 20 63 6c 61 75 73 65 2e 0a 20 20 20 20 ROM clause..
2a340 2a 2a 0a 20 20 20 20 2a 2a 20 54 68 65 20 4e 2d **. ** The N-
2a350 74 68 20 74 65 72 6d 20 6f 66 20 74 68 65 20 46 th term of the F
2a360 52 4f 4d 20 63 6c 61 75 73 65 20 69 73 20 61 73 ROM clause is as
2a370 73 69 67 6e 65 64 20 61 20 62 69 74 6d 61 73 6b signed a bitmask
2a380 20 6f 66 20 31 3c 3c 4e 2e 0a 20 20 20 20 2a 2a of 1<<N.. **
2a390 0a 20 20 20 20 2a 2a 20 54 68 65 20 72 75 6c 65 . ** The rule
2a3a0 20 6f 66 20 74 68 65 20 70 72 65 76 69 6f 75 73 of the previous
2a3b0 20 73 65 6e 74 65 6e 63 65 20 65 6e 73 75 72 65 sentence ensure
2a3c0 73 20 74 68 74 61 20 69 66 20 58 20 69 73 20 74 s thta if X is t
2a3d0 68 65 20 62 69 74 6d 61 73 6b 20 66 6f 72 0a 20 he bitmask for.
2a3e0 20 20 20 2a 2a 20 61 20 74 61 62 6c 65 20 54 2c ** a table T,
2a3f0 20 74 68 65 6e 20 58 2d 31 20 69 73 20 74 68 65 then X-1 is the
2a400 20 62 69 74 6d 61 73 6b 20 66 6f 72 20 61 6c 6c bitmask for all
2a410 20 6f 74 68 65 72 20 74 61 62 6c 65 73 20 74 6f other tables to
2a420 20 74 68 65 20 6c 65 66 74 20 6f 66 20 54 2e 0a the left of T..
2a430 20 20 20 20 2a 2a 20 4b 6e 6f 77 69 6e 67 20 74 ** Knowing t
2a440 68 65 20 62 69 74 6d 61 73 6b 20 66 6f 72 20 61 he bitmask for a
2a450 6c 6c 20 74 61 62 6c 65 73 20 74 6f 20 74 68 65 ll tables to the
2a460 20 6c 65 66 74 20 6f 66 20 61 20 6c 65 66 74 20 left of a left
2a470 6a 6f 69 6e 20 69 73 0a 20 20 20 20 2a 2a 20 69 join is. ** i
2a480 6d 70 6f 72 74 61 6e 74 2e 20 20 54 69 63 6b 65 mportant. Ticke
2a490 74 20 23 33 30 31 35 2e 0a 20 20 20 20 2a 2a 0a t #3015.. **.
2a4a0 20 20 20 20 2a 2a 20 4e 6f 74 65 20 74 68 61 74 ** Note that
2a4b0 20 62 69 74 6d 61 73 6b 73 20 61 72 65 20 63 72 bitmasks are cr
2a4c0 65 61 74 65 64 20 66 6f 72 20 61 6c 6c 20 70 54 eated for all pT
2a4d0 61 62 4c 69 73 74 2d 3e 6e 53 72 63 20 74 61 62 abList->nSrc tab
2a4e0 6c 65 73 20 69 6e 0a 20 20 20 20 2a 2a 20 70 54 les in. ** pT
2a4f0 61 62 4c 69 73 74 2c 20 6e 6f 74 20 6a 75 73 74 abList, not just
2a500 20 74 68 65 20 66 69 72 73 74 20 6e 54 61 62 4c the first nTabL
2a510 69 73 74 20 74 61 62 6c 65 73 2e 20 20 6e 54 61 ist tables. nTa
2a520 62 4c 69 73 74 20 69 73 20 6e 6f 72 6d 61 6c 6c bList is normall
2a530 79 0a 20 20 20 20 2a 2a 20 65 71 75 61 6c 20 74 y. ** equal t
2a540 6f 20 70 54 61 62 4c 69 73 74 2d 3e 6e 53 72 63 o pTabList->nSrc
2a550 20 62 75 74 20 6d 69 67 68 74 20 62 65 20 73 68 but might be sh
2a560 6f 72 74 65 6e 65 64 20 74 6f 20 31 20 69 66 20 ortened to 1 if
2a570 74 68 65 0a 20 20 20 20 2a 2a 20 57 48 45 52 45 the. ** WHERE
2a580 5f 4f 52 5f 53 55 42 43 4c 41 55 53 45 20 66 6c _OR_SUBCLAUSE fl
2a590 61 67 20 69 73 20 73 65 74 2e 0a 20 20 20 20 2a ag is set.. *
2a5a0 2f 0a 20 20 20 20 69 69 20 3d 20 30 3b 0a 20 20 /. ii = 0;.
2a5b0 20 20 64 6f 7b 0a 20 20 20 20 20 20 63 72 65 61 do{. crea
2a5c0 74 65 4d 61 73 6b 28 70 4d 61 73 6b 53 65 74 2c teMask(pMaskSet,
2a5d0 20 70 54 61 62 4c 69 73 74 2d 3e 61 5b 69 69 5d pTabList->a[ii]
2a5e0 2e 69 43 75 72 73 6f 72 29 3b 0a 20 20 20 20 20 .iCursor);.
2a5f0 20 73 71 6c 69 74 65 33 57 68 65 72 65 54 61 62 sqlite3WhereTab
2a600 46 75 6e 63 41 72 67 73 28 70 50 61 72 73 65 2c FuncArgs(pParse,
2a610 20 26 70 54 61 62 4c 69 73 74 2d 3e 61 5b 69 69 &pTabList->a[ii
2a620 5d 2c 20 26 70 57 49 6e 66 6f 2d 3e 73 57 43 29 ], &pWInfo->sWC)
2a630 3b 0a 20 20 20 20 7d 77 68 69 6c 65 28 20 28 2b ;. }while( (+
2a640 2b 69 69 29 3c 70 54 61 62 4c 69 73 74 2d 3e 6e +ii)<pTabList->n
2a650 53 72 63 20 29 3b 0a 20 20 23 69 66 64 65 66 20 Src );. #ifdef
2a660 53 51 4c 49 54 45 5f 44 45 42 55 47 0a 20 20 20 SQLITE_DEBUG.
2a670 20 7b 0a 20 20 20 20 20 20 42 69 74 6d 61 73 6b {. Bitmask
2a680 20 6d 78 20 3d 20 30 3b 0a 20 20 20 20 20 20 66 mx = 0;. f
2a690 6f 72 28 69 69 3d 30 3b 20 69 69 3c 70 54 61 62 or(ii=0; ii<pTab
2a6a0 4c 69 73 74 2d 3e 6e 53 72 63 3b 20 69 69 2b 2b List->nSrc; ii++
2a6b0 29 7b 0a 20 20 20 20 20 20 20 20 42 69 74 6d 61 ){. Bitma
2a6c0 73 6b 20 6d 20 3d 20 73 71 6c 69 74 65 33 57 68 sk m = sqlite3Wh
2a6d0 65 72 65 47 65 74 4d 61 73 6b 28 70 4d 61 73 6b ereGetMask(pMask
2a6e0 53 65 74 2c 20 70 54 61 62 4c 69 73 74 2d 3e 61 Set, pTabList->a
2a6f0 5b 69 69 5d 2e 69 43 75 72 73 6f 72 29 3b 0a 20 [ii].iCursor);.
2a700 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 6d assert( m
2a710 3e 3d 6d 78 20 29 3b 0a 20 20 20 20 20 20 20 20 >=mx );.
2a720 6d 78 20 3d 20 6d 3b 0a 20 20 20 20 20 20 7d 0a mx = m;. }.
2a730 20 20 20 20 7d 0a 20 20 23 65 6e 64 69 66 0a 20 }. #endif.
2a740 20 7d 0a 20 20 0a 20 20 2f 2a 20 41 6e 61 6c 79 }. . /* Analy
2a750 7a 65 20 61 6c 6c 20 6f 66 20 74 68 65 20 73 75 ze all of the su
2a760 62 65 78 70 72 65 73 73 69 6f 6e 73 2e 20 2a 2f bexpressions. */
2a770 0a 20 20 73 71 6c 69 74 65 33 57 68 65 72 65 45 . sqlite3WhereE
2a780 78 70 72 41 6e 61 6c 79 7a 65 28 70 54 61 62 4c xprAnalyze(pTabL
2a790 69 73 74 2c 20 26 70 57 49 6e 66 6f 2d 3e 73 57 ist, &pWInfo->sW
2a7a0 43 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 C);. if( db->ma
2a7b0 6c 6c 6f 63 46 61 69 6c 65 64 20 29 20 67 6f 74 llocFailed ) got
2a7c0 6f 20 77 68 65 72 65 42 65 67 69 6e 45 72 72 6f o whereBeginErro
2a7d0 72 3b 0a 0a 20 20 2f 2a 20 53 70 65 63 69 61 6c r;.. /* Special
2a7e0 20 63 61 73 65 3a 20 57 48 45 52 45 20 74 65 72 case: WHERE ter
2a7f0 6d 73 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 72 ms that do not r
2a800 65 66 65 72 20 74 6f 20 61 6e 79 20 74 61 62 6c efer to any tabl
2a810 65 73 20 69 6e 20 74 68 65 20 6a 6f 69 6e 0a 20 es in the join.
2a820 20 2a 2a 20 28 63 6f 6e 73 74 61 6e 74 20 65 78 ** (constant ex
2a830 70 72 65 73 73 69 6f 6e 73 29 2e 20 45 76 61 6c pressions). Eval
2a840 75 61 74 65 20 65 61 63 68 20 73 75 63 68 20 74 uate each such t
2a850 65 72 6d 2c 20 61 6e 64 20 6a 75 6d 70 20 6f 76 erm, and jump ov
2a860 65 72 20 61 6c 6c 20 74 68 65 0a 20 20 2a 2a 20 er all the. **
2a870 67 65 6e 65 72 61 74 65 64 20 63 6f 64 65 20 69 generated code i
2a880 66 20 74 68 65 20 72 65 73 75 6c 74 20 69 73 20 f the result is
2a890 6e 6f 74 20 74 72 75 65 2e 20 20 0a 20 20 2a 2a not true. . **
2a8a0 0a 20 20 2a 2a 20 44 6f 20 6e 6f 74 20 64 6f 20 . ** Do not do
2a8b0 74 68 69 73 20 69 66 20 74 68 65 20 65 78 70 72 this if the expr
2a8c0 65 73 73 69 6f 6e 20 63 6f 6e 74 61 69 6e 73 20 ession contains
2a8d0 6e 6f 6e 2d 64 65 74 65 72 6d 69 6e 69 73 74 69 non-deterministi
2a8e0 63 20 66 75 6e 63 74 69 6f 6e 73 0a 20 20 2a 2a c functions. **
2a8f0 20 74 68 61 74 20 61 72 65 20 6e 6f 74 20 77 69 that are not wi
2a900 74 68 69 6e 20 61 20 73 75 62 2d 73 65 6c 65 63 thin a sub-selec
2a910 74 2e 20 54 68 69 73 20 69 73 20 6e 6f 74 20 73 t. This is not s
2a920 74 72 69 63 74 6c 79 20 72 65 71 75 69 72 65 64 trictly required
2a930 2c 20 62 75 74 0a 20 20 2a 2a 20 70 72 65 73 65 , but. ** prese
2a940 72 76 65 73 20 53 51 4c 69 74 65 27 73 20 6c 65 rves SQLite's le
2a950 67 61 63 79 20 62 65 68 61 76 69 6f 75 72 20 69 gacy behaviour i
2a960 6e 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 n the following
2a970 74 77 6f 20 63 61 73 65 73 3a 0a 20 20 2a 2a 0a two cases:. **.
2a980 20 20 2a 2a 20 20 20 46 52 4f 4d 20 2e 2e 2e 20 ** FROM ...
2a990 57 48 45 52 45 20 72 61 6e 64 6f 6d 28 29 3e 30 WHERE random()>0
2a9a0 3b 20 20 20 20 20 20 20 20 20 20 20 2d 2d 20 65 ; -- e
2a9b0 76 61 6c 20 72 61 6e 64 6f 6d 28 29 20 6f 6e 63 val random() onc
2a9c0 65 20 70 65 72 20 72 6f 77 0a 20 20 2a 2a 20 20 e per row. **
2a9d0 20 46 52 4f 4d 20 2e 2e 2e 20 57 48 45 52 45 20 FROM ... WHERE
2a9e0 28 53 45 4c 45 43 54 20 72 61 6e 64 6f 6d 28 29 (SELECT random()
2a9f0 29 3e 30 3b 20 20 2d 2d 20 65 76 61 6c 20 72 61 )>0; -- eval ra
2aa00 6e 64 6f 6d 28 29 20 6f 6e 63 65 20 6f 76 65 72 ndom() once over
2aa10 61 6c 6c 0a 20 20 2a 2f 0a 20 20 66 6f 72 28 69 all. */. for(i
2aa20 69 3d 30 3b 20 69 69 3c 73 57 4c 42 2e 70 57 43 i=0; ii<sWLB.pWC
2aa30 2d 3e 6e 54 65 72 6d 3b 20 69 69 2b 2b 29 7b 0a ->nTerm; ii++){.
2aa40 20 20 20 20 57 68 65 72 65 54 65 72 6d 20 2a 70 WhereTerm *p
2aa50 54 20 3d 20 26 73 57 4c 42 2e 70 57 43 2d 3e 61 T = &sWLB.pWC->a
2aa60 5b 69 69 5d 3b 0a 20 20 20 20 69 66 28 20 70 54 [ii];. if( pT
2aa70 2d 3e 77 74 46 6c 61 67 73 20 26 20 54 45 52 4d ->wtFlags & TERM
2aa80 5f 56 49 52 54 55 41 4c 20 29 20 63 6f 6e 74 69 _VIRTUAL ) conti
2aa90 6e 75 65 3b 0a 20 20 20 20 69 66 28 20 70 54 2d nue;. if( pT-
2aaa0 3e 70 72 65 72 65 71 41 6c 6c 3d 3d 30 20 26 26 >prereqAll==0 &&
2aab0 20 28 6e 54 61 62 4c 69 73 74 3d 3d 30 20 7c 7c (nTabList==0 ||
2aac0 20 65 78 70 72 49 73 44 65 74 65 72 6d 69 6e 69 exprIsDetermini
2aad0 73 74 69 63 28 70 54 2d 3e 70 45 78 70 72 29 29 stic(pT->pExpr))
2aae0 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
2aaf0 33 45 78 70 72 49 66 46 61 6c 73 65 28 70 50 61 3ExprIfFalse(pPa
2ab00 72 73 65 2c 20 70 54 2d 3e 70 45 78 70 72 2c 20 rse, pT->pExpr,
2ab10 70 57 49 6e 66 6f 2d 3e 69 42 72 65 61 6b 2c 20 pWInfo->iBreak,
2ab20 53 51 4c 49 54 45 5f 4a 55 4d 50 49 46 4e 55 4c SQLITE_JUMPIFNUL
2ab30 4c 29 3b 0a 20 20 20 20 20 20 70 54 2d 3e 77 74 L);. pT->wt
2ab40 46 6c 61 67 73 20 7c 3d 20 54 45 52 4d 5f 43 4f Flags |= TERM_CO
2ab50 44 45 44 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a DED;. }. }..
2ab60 20 20 69 66 28 20 77 63 74 72 6c 46 6c 61 67 73 if( wctrlFlags
2ab70 20 26 20 57 48 45 52 45 5f 57 41 4e 54 5f 44 49 & WHERE_WANT_DI
2ab80 53 54 49 4e 43 54 20 29 7b 0a 20 20 20 20 69 66 STINCT ){. if
2ab90 28 20 69 73 44 69 73 74 69 6e 63 74 52 65 64 75 ( isDistinctRedu
2aba0 6e 64 61 6e 74 28 70 50 61 72 73 65 2c 20 70 54 ndant(pParse, pT
2abb0 61 62 4c 69 73 74 2c 20 26 70 57 49 6e 66 6f 2d abList, &pWInfo-
2abc0 3e 73 57 43 2c 20 70 52 65 73 75 6c 74 53 65 74 >sWC, pResultSet
2abd0 29 20 29 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 ) ){. /* Th
2abe0 65 20 44 49 53 54 49 4e 43 54 20 6d 61 72 6b 69 e DISTINCT marki
2abf0 6e 67 20 69 73 20 70 6f 69 6e 74 6c 65 73 73 2e ng is pointless.
2ac00 20 20 49 67 6e 6f 72 65 20 69 74 2e 20 2a 2f 0a Ignore it. */.
2ac10 20 20 20 20 20 20 70 57 49 6e 66 6f 2d 3e 65 44 pWInfo->eD
2ac20 69 73 74 69 6e 63 74 20 3d 20 57 48 45 52 45 5f istinct = WHERE_
2ac30 44 49 53 54 49 4e 43 54 5f 55 4e 49 51 55 45 3b DISTINCT_UNIQUE;
2ac40 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 70 . }else if( p
2ac50 4f 72 64 65 72 42 79 3d 3d 30 20 29 7b 0a 20 20 OrderBy==0 ){.
2ac60 20 20 20 20 2f 2a 20 54 72 79 20 74 6f 20 4f 52 /* Try to OR
2ac70 44 45 52 20 42 59 20 74 68 65 20 72 65 73 75 6c DER BY the resul
2ac80 74 20 73 65 74 20 74 6f 20 6d 61 6b 65 20 64 69 t set to make di
2ac90 73 74 69 6e 63 74 20 70 72 6f 63 65 73 73 69 6e stinct processin
2aca0 67 20 65 61 73 69 65 72 20 2a 2f 0a 20 20 20 20 g easier */.
2acb0 20 20 70 57 49 6e 66 6f 2d 3e 77 63 74 72 6c 46 pWInfo->wctrlF
2acc0 6c 61 67 73 20 7c 3d 20 57 48 45 52 45 5f 44 49 lags |= WHERE_DI
2acd0 53 54 49 4e 43 54 42 59 3b 0a 20 20 20 20 20 20 STINCTBY;.
2ace0 70 57 49 6e 66 6f 2d 3e 70 4f 72 64 65 72 42 79 pWInfo->pOrderBy
2acf0 20 3d 20 70 52 65 73 75 6c 74 53 65 74 3b 0a 20 = pResultSet;.
2ad00 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 }. }.. /* C
2ad10 6f 6e 73 74 72 75 63 74 20 74 68 65 20 57 68 65 onstruct the Whe
2ad20 72 65 4c 6f 6f 70 20 6f 62 6a 65 63 74 73 20 2a reLoop objects *
2ad30 2f 0a 23 69 66 20 64 65 66 69 6e 65 64 28 57 48 /.#if defined(WH
2ad40 45 52 45 54 52 41 43 45 5f 45 4e 41 42 4c 45 44 ERETRACE_ENABLED
2ad50 29 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 57 ). if( sqlite3W
2ad60 68 65 72 65 54 72 61 63 65 20 26 20 30 78 66 66 hereTrace & 0xff
2ad70 66 66 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 ff ){. sqlite
2ad80 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 2a 2a 3DebugPrintf("**
2ad90 2a 20 4f 70 74 69 6d 69 7a 65 72 20 53 74 61 72 * Optimizer Star
2ada0 74 20 2a 2a 2a 20 28 77 63 74 72 6c 46 6c 61 67 t *** (wctrlFlag
2adb0 73 3a 20 30 78 25 78 22 2c 77 63 74 72 6c 46 6c s: 0x%x",wctrlFl
2adc0 61 67 73 29 3b 0a 20 20 20 20 69 66 28 20 77 63 ags);. if( wc
2add0 74 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 trlFlags & WHERE
2ade0 5f 55 53 45 5f 4c 49 4d 49 54 20 29 7b 0a 20 20 _USE_LIMIT ){.
2adf0 20 20 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 sqlite3Debug
2ae00 50 72 69 6e 74 66 28 22 2c 20 6c 69 6d 69 74 3a Printf(", limit:
2ae10 20 25 64 22 2c 20 69 41 75 78 41 72 67 29 3b 0a %d", iAuxArg);.
2ae20 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 }. sqlite
2ae30 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 29 5c 3DebugPrintf(")\
2ae40 6e 22 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 n");. }. if( s
2ae50 71 6c 69 74 65 33 57 68 65 72 65 54 72 61 63 65 qlite3WhereTrace
2ae60 20 26 20 30 78 31 30 30 20 29 7b 20 2f 2a 20 44 & 0x100 ){ /* D
2ae70 69 73 70 6c 61 79 20 61 6c 6c 20 74 65 72 6d 73 isplay all terms
2ae80 20 6f 66 20 74 68 65 20 57 48 45 52 45 20 63 6c of the WHERE cl
2ae90 61 75 73 65 20 2a 2f 0a 20 20 20 20 73 71 6c 69 ause */. sqli
2aea0 74 65 33 57 68 65 72 65 43 6c 61 75 73 65 50 72 te3WhereClausePr
2aeb0 69 6e 74 28 73 57 4c 42 2e 70 57 43 29 3b 0a 20 int(sWLB.pWC);.
2aec0 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66 28 }.#endif.. if(
2aed0 20 6e 54 61 62 4c 69 73 74 21 3d 31 20 7c 7c 20 nTabList!=1 ||
2aee0 77 68 65 72 65 53 68 6f 72 74 43 75 74 28 26 73 whereShortCut(&s
2aef0 57 4c 42 29 3d 3d 30 20 29 7b 0a 20 20 20 20 72 WLB)==0 ){. r
2af00 63 20 3d 20 77 68 65 72 65 4c 6f 6f 70 41 64 64 c = whereLoopAdd
2af10 41 6c 6c 28 26 73 57 4c 42 29 3b 0a 20 20 20 20 All(&sWLB);.
2af20 69 66 28 20 72 63 20 29 20 67 6f 74 6f 20 77 68 if( rc ) goto wh
2af30 65 72 65 42 65 67 69 6e 45 72 72 6f 72 3b 0a 20 ereBeginError;.
2af40 20 0a 23 69 66 64 65 66 20 57 48 45 52 45 54 52 .#ifdef WHERETR
2af50 41 43 45 5f 45 4e 41 42 4c 45 44 0a 20 20 20 20 ACE_ENABLED.
2af60 69 66 28 20 73 71 6c 69 74 65 33 57 68 65 72 65 if( sqlite3Where
2af70 54 72 61 63 65 20 29 7b 20 20 20 20 2f 2a 20 44 Trace ){ /* D
2af80 69 73 70 6c 61 79 20 61 6c 6c 20 6f 66 20 74 68 isplay all of th
2af90 65 20 57 68 65 72 65 4c 6f 6f 70 20 6f 62 6a 65 e WhereLoop obje
2afa0 63 74 73 20 2a 2f 0a 20 20 20 20 20 20 57 68 65 cts */. Whe
2afb0 72 65 4c 6f 6f 70 20 2a 70 3b 0a 20 20 20 20 20 reLoop *p;.
2afc0 20 69 6e 74 20 69 3b 0a 20 20 20 20 20 20 73 74 int i;. st
2afd0 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 atic const char
2afe0 7a 4c 61 62 65 6c 5b 5d 20 3d 20 22 30 31 32 33 zLabel[] = "0123
2aff0 34 35 36 37 38 39 61 62 63 64 65 66 67 68 69 6a 456789abcdefghij
2b000 6b 6c 6d 6e 6f 70 71 72 73 74 75 76 77 79 78 7a klmnopqrstuvwyxz
2b010 22 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ".
2b020 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2b030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 "
2b040 41 42 43 44 45 46 47 48 49 4a 4b 4c 4d 4e 4f 50 ABCDEFGHIJKLMNOP
2b050 51 52 53 54 55 56 57 59 58 5a 22 3b 0a 20 20 20 QRSTUVWYXZ";.
2b060 20 20 20 66 6f 72 28 70 3d 70 57 49 6e 66 6f 2d for(p=pWInfo-
2b070 3e 70 4c 6f 6f 70 73 2c 20 69 3d 30 3b 20 70 3b >pLoops, i=0; p;
2b080 20 70 3d 70 2d 3e 70 4e 65 78 74 4c 6f 6f 70 2c p=p->pNextLoop,
2b090 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 70 i++){. p
2b0a0 2d 3e 63 49 64 20 3d 20 7a 4c 61 62 65 6c 5b 69 ->cId = zLabel[i
2b0b0 25 28 73 69 7a 65 6f 66 28 7a 4c 61 62 65 6c 29 %(sizeof(zLabel)
2b0c0 2d 31 29 5d 3b 0a 20 20 20 20 20 20 20 20 77 68 -1)];. wh
2b0d0 65 72 65 4c 6f 6f 70 50 72 69 6e 74 28 70 2c 20 ereLoopPrint(p,
2b0e0 73 57 4c 42 2e 70 57 43 29 3b 0a 20 20 20 20 20 sWLB.pWC);.
2b0f0 20 7d 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a }. }.#endif.
2b100 20 20 0a 20 20 20 20 77 68 65 72 65 50 61 74 68 . wherePath
2b110 53 6f 6c 76 65 72 28 70 57 49 6e 66 6f 2c 20 30 Solver(pWInfo, 0
2b120 29 3b 0a 20 20 20 20 69 66 28 20 64 62 2d 3e 6d );. if( db->m
2b130 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 20 67 6f allocFailed ) go
2b140 74 6f 20 77 68 65 72 65 42 65 67 69 6e 45 72 72 to whereBeginErr
2b150 6f 72 3b 0a 20 20 20 20 69 66 28 20 70 57 49 6e or;. if( pWIn
2b160 66 6f 2d 3e 70 4f 72 64 65 72 42 79 20 29 7b 0a fo->pOrderBy ){.
2b170 20 20 20 20 20 20 20 77 68 65 72 65 50 61 74 68 wherePath
2b180 53 6f 6c 76 65 72 28 70 57 49 6e 66 6f 2c 20 70 Solver(pWInfo, p
2b190 57 49 6e 66 6f 2d 3e 6e 52 6f 77 4f 75 74 2b 31 WInfo->nRowOut+1
2b1a0 29 3b 0a 20 20 20 20 20 20 20 69 66 28 20 64 62 );. if( db
2b1b0 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 ->mallocFailed )
2b1c0 20 67 6f 74 6f 20 77 68 65 72 65 42 65 67 69 6e goto whereBegin
2b1d0 45 72 72 6f 72 3b 0a 20 20 20 20 7d 0a 20 20 7d Error;. }. }
2b1e0 0a 20 20 69 66 28 20 70 57 49 6e 66 6f 2d 3e 70 . if( pWInfo->p
2b1f0 4f 72 64 65 72 42 79 3d 3d 30 20 26 26 20 28 64 OrderBy==0 && (d
2b200 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 b->flags & SQLIT
2b210 45 5f 52 65 76 65 72 73 65 4f 72 64 65 72 29 21 E_ReverseOrder)!
2b220 3d 30 20 29 7b 0a 20 20 20 20 20 70 57 49 6e 66 =0 ){. pWInf
2b230 6f 2d 3e 72 65 76 4d 61 73 6b 20 3d 20 41 4c 4c o->revMask = ALL
2b240 42 49 54 53 3b 0a 20 20 7d 0a 20 20 69 66 28 20 BITS;. }. if(
2b250 70 50 61 72 73 65 2d 3e 6e 45 72 72 20 7c 7c 20 pParse->nErr ||
2b260 4e 45 56 45 52 28 64 62 2d 3e 6d 61 6c 6c 6f 63 NEVER(db->malloc
2b270 46 61 69 6c 65 64 29 20 29 7b 0a 20 20 20 20 67 Failed) ){. g
2b280 6f 74 6f 20 77 68 65 72 65 42 65 67 69 6e 45 72 oto whereBeginEr
2b290 72 6f 72 3b 0a 20 20 7d 0a 23 69 66 64 65 66 20 ror;. }.#ifdef
2b2a0 57 48 45 52 45 54 52 41 43 45 5f 45 4e 41 42 4c WHERETRACE_ENABL
2b2b0 45 44 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 ED. if( sqlite3
2b2c0 57 68 65 72 65 54 72 61 63 65 20 29 7b 0a 20 20 WhereTrace ){.
2b2d0 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 sqlite3DebugPr
2b2e0 69 6e 74 66 28 22 2d 2d 2d 2d 20 53 6f 6c 75 74 intf("---- Solut
2b2f0 69 6f 6e 20 6e 52 6f 77 3d 25 64 22 2c 20 70 57 ion nRow=%d", pW
2b300 49 6e 66 6f 2d 3e 6e 52 6f 77 4f 75 74 29 3b 0a Info->nRowOut);.
2b310 20 20 20 20 69 66 28 20 70 57 49 6e 66 6f 2d 3e if( pWInfo->
2b320 6e 4f 42 53 61 74 3e 30 20 29 7b 0a 20 20 20 20 nOBSat>0 ){.
2b330 20 20 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 sqlite3DebugPr
2b340 69 6e 74 66 28 22 20 4f 52 44 45 52 42 59 3d 25 intf(" ORDERBY=%
2b350 64 2c 30 78 25 6c 6c 78 22 2c 20 70 57 49 6e 66 d,0x%llx", pWInf
2b360 6f 2d 3e 6e 4f 42 53 61 74 2c 20 70 57 49 6e 66 o->nOBSat, pWInf
2b370 6f 2d 3e 72 65 76 4d 61 73 6b 29 3b 0a 20 20 20 o->revMask);.
2b380 20 7d 0a 20 20 20 20 73 77 69 74 63 68 28 20 70 }. switch( p
2b390 57 49 6e 66 6f 2d 3e 65 44 69 73 74 69 6e 63 74 WInfo->eDistinct
2b3a0 20 29 7b 0a 20 20 20 20 20 20 63 61 73 65 20 57 ){. case W
2b3b0 48 45 52 45 5f 44 49 53 54 49 4e 43 54 5f 55 4e HERE_DISTINCT_UN
2b3c0 49 51 55 45 3a 20 7b 0a 20 20 20 20 20 20 20 20 IQUE: {.
2b3d0 73 71 6c 69 74 65 33 44 65 62 75 67 50 72 69 6e sqlite3DebugPrin
2b3e0 74 66 28 22 20 20 44 49 53 54 49 4e 43 54 3d 75 tf(" DISTINCT=u
2b3f0 6e 69 71 75 65 22 29 3b 0a 20 20 20 20 20 20 20 nique");.
2b400 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a break;. }.
2b410 20 20 20 20 20 20 63 61 73 65 20 57 48 45 52 45 case WHERE
2b420 5f 44 49 53 54 49 4e 43 54 5f 4f 52 44 45 52 45 _DISTINCT_ORDERE
2b430 44 3a 20 7b 0a 20 20 20 20 20 20 20 20 73 71 6c D: {. sql
2b440 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 ite3DebugPrintf(
2b450 22 20 20 44 49 53 54 49 4e 43 54 3d 6f 72 64 65 " DISTINCT=orde
2b460 72 65 64 22 29 3b 0a 20 20 20 20 20 20 20 20 62 red");. b
2b470 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 reak;. }.
2b480 20 20 20 20 63 61 73 65 20 57 48 45 52 45 5f 44 case WHERE_D
2b490 49 53 54 49 4e 43 54 5f 55 4e 4f 52 44 45 52 45 ISTINCT_UNORDERE
2b4a0 44 3a 20 7b 0a 20 20 20 20 20 20 20 20 73 71 6c D: {. sql
2b4b0 69 74 65 33 44 65 62 75 67 50 72 69 6e 74 66 28 ite3DebugPrintf(
2b4c0 22 20 20 44 49 53 54 49 4e 43 54 3d 75 6e 6f 72 " DISTINCT=unor
2b4d0 64 65 72 65 64 22 29 3b 0a 20 20 20 20 20 20 20 dered");.
2b4e0 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a break;. }.
2b4f0 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 }. sqlite
2b500 33 44 65 62 75 67 50 72 69 6e 74 66 28 22 5c 6e 3DebugPrintf("\n
2b510 22 29 3b 0a 20 20 20 20 66 6f 72 28 69 69 3d 30 ");. for(ii=0
2b520 3b 20 69 69 3c 70 57 49 6e 66 6f 2d 3e 6e 4c 65 ; ii<pWInfo->nLe
2b530 76 65 6c 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 vel; ii++){.
2b540 20 20 77 68 65 72 65 4c 6f 6f 70 50 72 69 6e 74 whereLoopPrint
2b550 28 70 57 49 6e 66 6f 2d 3e 61 5b 69 69 5d 2e 70 (pWInfo->a[ii].p
2b560 57 4c 6f 6f 70 2c 20 73 57 4c 42 2e 70 57 43 29 WLoop, sWLB.pWC)
2b570 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 ;. }. }.#end
2b580 69 66 0a 0a 20 20 2f 2a 20 41 74 74 65 6d 70 74 if.. /* Attempt
2b590 20 74 6f 20 6f 6d 69 74 20 74 61 62 6c 65 73 20 to omit tables
2b5a0 66 72 6f 6d 20 74 68 65 20 6a 6f 69 6e 20 74 68 from the join th
2b5b0 61 74 20 64 6f 20 6e 6f 74 20 61 66 66 65 63 74 at do not affect
2b5c0 20 74 68 65 20 72 65 73 75 6c 74 2e 0a 20 20 2a the result.. *
2b5d0 2a 20 46 6f 72 20 61 20 74 61 62 6c 65 20 74 6f * For a table to
2b5e0 20 6e 6f 74 20 61 66 66 65 63 74 20 74 68 65 20 not affect the
2b5f0 72 65 73 75 6c 74 2c 20 74 68 65 20 66 6f 6c 6c result, the foll
2b600 6f 77 69 6e 67 20 6d 75 73 74 20 62 65 20 74 72 owing must be tr
2b610 75 65 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 ue:. **. **
2b620 31 29 20 54 68 65 20 71 75 65 72 79 20 6d 75 73 1) The query mus
2b630 74 20 6e 6f 74 20 62 65 20 61 6e 20 61 67 67 72 t not be an aggr
2b640 65 67 61 74 65 2e 0a 20 20 2a 2a 20 20 20 32 29 egate.. ** 2)
2b650 20 54 68 65 20 74 61 62 6c 65 20 6d 75 73 74 20 The table must
2b660 62 65 20 74 68 65 20 52 48 53 20 6f 66 20 61 20 be the RHS of a
2b670 4c 45 46 54 20 4a 4f 49 4e 2e 0a 20 20 2a 2a 20 LEFT JOIN.. **
2b680 20 20 33 29 20 45 69 74 68 65 72 20 74 68 65 20 3) Either the
2b690 71 75 65 72 79 20 6d 75 73 74 20 62 65 20 44 49 query must be DI
2b6a0 53 54 49 4e 43 54 2c 20 6f 72 20 65 6c 73 65 20 STINCT, or else
2b6b0 74 68 65 20 4f 4e 20 6f 72 20 55 53 49 4e 47 20 the ON or USING
2b6c0 63 6c 61 75 73 65 0a 20 20 2a 2a 20 20 20 20 20 clause. **
2b6d0 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 61 20 must contain a
2b6e0 63 6f 6e 73 74 72 61 69 6e 74 20 74 68 61 74 20 constraint that
2b6f0 6c 69 6d 69 74 73 20 74 68 65 20 73 63 61 6e 20 limits the scan
2b700 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 6f 20 of the table to
2b710 0a 20 20 2a 2a 20 20 20 20 20 20 61 74 20 6d 6f . ** at mo
2b720 73 74 20 61 20 73 69 6e 67 6c 65 20 72 6f 77 2e st a single row.
2b730 0a 20 20 2a 2a 20 20 20 34 29 20 54 68 65 20 74 . ** 4) The t
2b740 61 62 6c 65 20 6d 75 73 74 20 6e 6f 74 20 62 65 able must not be
2b750 20 72 65 66 65 72 65 6e 63 65 64 20 62 79 20 61 referenced by a
2b760 6e 79 20 70 61 72 74 20 6f 66 20 74 68 65 20 71 ny part of the q
2b770 75 65 72 79 20 61 70 61 72 74 0a 20 20 2a 2a 20 uery apart. **
2b780 20 20 20 20 20 66 72 6f 6d 20 69 74 73 20 6f 77 from its ow
2b790 6e 20 55 53 49 4e 47 20 6f 72 20 4f 4e 20 63 6c n USING or ON cl
2b7a0 61 75 73 65 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 ause.. **. **
2b7b0 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 67 69 76 For example, giv
2b7c0 65 6e 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 en:. **. **
2b7d0 20 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 74 CREATE TABLE t
2b7e0 31 28 69 70 6b 20 49 4e 54 45 47 45 52 20 50 52 1(ipk INTEGER PR
2b7f0 49 4d 41 52 59 20 4b 45 59 2c 20 76 31 29 3b 0a IMARY KEY, v1);.
2b800 20 20 2a 2a 20 20 20 20 20 43 52 45 41 54 45 20 ** CREATE
2b810 54 41 42 4c 45 20 74 32 28 69 70 6b 20 49 4e 54 TABLE t2(ipk INT
2b820 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59 EGER PRIMARY KEY
2b830 2c 20 76 32 29 3b 0a 20 20 2a 2a 20 20 20 20 20 , v2);. **
2b840 43 52 45 41 54 45 20 54 41 42 4c 45 20 74 33 28 CREATE TABLE t3(
2b850 69 70 6b 20 49 4e 54 45 47 45 52 20 50 52 49 4d ipk INTEGER PRIM
2b860 41 52 59 20 4b 45 59 2c 20 76 33 29 3b 0a 20 20 ARY KEY, v3);.
2b870 2a 2a 0a 20 20 2a 2a 20 74 68 65 6e 20 74 61 62 **. ** then tab
2b880 6c 65 20 74 32 20 63 61 6e 20 62 65 20 6f 6d 69 le t2 can be omi
2b890 74 74 65 64 20 66 72 6f 6d 20 74 68 65 20 66 6f tted from the fo
2b8a0 6c 6c 6f 77 69 6e 67 3a 0a 20 20 2a 2a 0a 20 20 llowing:. **.
2b8b0 2a 2a 20 20 20 20 20 53 45 4c 45 43 54 20 76 31 ** SELECT v1
2b8c0 2c 20 76 33 20 46 52 4f 4d 20 74 31 20 0a 20 20 , v3 FROM t1 .
2b8d0 2a 2a 20 20 20 20 20 20 20 4c 45 46 54 20 4a 4f ** LEFT JO
2b8e0 49 4e 20 74 32 20 55 53 49 4e 47 20 28 74 31 2e IN t2 USING (t1.
2b8f0 69 70 6b 3d 74 32 2e 69 70 6b 29 0a 20 20 2a 2a ipk=t2.ipk). **
2b900 20 20 20 20 20 20 20 4c 45 46 54 20 4a 4f 49 4e LEFT JOIN
2b910 20 74 33 20 55 53 49 4e 47 20 28 74 31 2e 69 70 t3 USING (t1.ip
2b920 6b 3d 74 33 2e 69 70 6b 29 0a 20 20 2a 2a 0a 20 k=t3.ipk). **.
2b930 20 2a 2a 20 6f 72 20 66 72 6f 6d 3a 0a 20 20 2a ** or from:. *
2b940 2a 0a 20 20 2a 2a 20 20 20 20 20 53 45 4c 45 43 *. ** SELEC
2b950 54 20 44 49 53 54 49 4e 43 54 20 76 31 2c 20 76 T DISTINCT v1, v
2b960 33 20 46 52 4f 4d 20 74 31 20 0a 20 20 2a 2a 20 3 FROM t1 . **
2b970 20 20 20 20 20 20 4c 45 46 54 20 4a 4f 49 4e 20 LEFT JOIN
2b980 74 32 0a 20 20 2a 2a 20 20 20 20 20 20 20 4c 45 t2. ** LE
2b990 46 54 20 4a 4f 49 4e 20 74 33 20 55 53 49 4e 47 FT JOIN t3 USING
2b9a0 20 28 74 31 2e 69 70 6b 3d 74 33 2e 69 70 6b 29 (t1.ipk=t3.ipk)
2b9b0 0a 20 20 2a 2f 0a 20 20 6e 6f 74 52 65 61 64 79 . */. notReady
2b9c0 20 3d 20 7e 28 42 69 74 6d 61 73 6b 29 30 3b 0a = ~(Bitmask)0;.
2b9d0 20 20 69 66 28 20 70 57 49 6e 66 6f 2d 3e 6e 4c if( pWInfo->nL
2b9e0 65 76 65 6c 3e 3d 32 0a 20 20 20 26 26 20 70 52 evel>=2. && pR
2b9f0 65 73 75 6c 74 53 65 74 21 3d 30 20 20 20 20 20 esultSet!=0
2ba00 20 20 20 20 20 20 20 20 20 20 2f 2a 20 67 75 61 /* gua
2ba10 72 61 6e 74 65 65 73 20 63 6f 6e 64 69 74 69 6f rantees conditio
2ba20 6e 20 28 31 29 20 61 62 6f 76 65 20 2a 2f 0a 20 n (1) above */.
2ba30 20 20 26 26 20 4f 70 74 69 6d 69 7a 61 74 69 6f && Optimizatio
2ba40 6e 45 6e 61 62 6c 65 64 28 64 62 2c 20 53 51 4c nEnabled(db, SQL
2ba50 49 54 45 5f 4f 6d 69 74 4e 6f 6f 70 4a 6f 69 6e ITE_OmitNoopJoin
2ba60 29 0a 20 20 29 7b 0a 20 20 20 20 69 6e 74 20 69 ). ){. int i
2ba70 3b 0a 20 20 20 20 42 69 74 6d 61 73 6b 20 74 61 ;. Bitmask ta
2ba80 62 55 73 65 64 20 3d 20 73 71 6c 69 74 65 33 57 bUsed = sqlite3W
2ba90 68 65 72 65 45 78 70 72 4c 69 73 74 55 73 61 67 hereExprListUsag
2baa0 65 28 70 4d 61 73 6b 53 65 74 2c 20 70 52 65 73 e(pMaskSet, pRes
2bab0 75 6c 74 53 65 74 29 3b 0a 20 20 20 20 69 66 28 ultSet);. if(
2bac0 20 73 57 4c 42 2e 70 4f 72 64 65 72 42 79 20 29 sWLB.pOrderBy )
2bad0 7b 0a 20 20 20 20 20 20 74 61 62 55 73 65 64 20 {. tabUsed
2bae0 7c 3d 20 73 71 6c 69 74 65 33 57 68 65 72 65 45 |= sqlite3WhereE
2baf0 78 70 72 4c 69 73 74 55 73 61 67 65 28 70 4d 61 xprListUsage(pMa
2bb00 73 6b 53 65 74 2c 20 73 57 4c 42 2e 70 4f 72 64 skSet, sWLB.pOrd
2bb10 65 72 42 79 29 3b 0a 20 20 20 20 7d 0a 20 20 20 erBy);. }.
2bb20 20 66 6f 72 28 69 3d 70 57 49 6e 66 6f 2d 3e 6e for(i=pWInfo->n
2bb30 4c 65 76 65 6c 2d 31 3b 20 69 3e 3d 31 3b 20 69 Level-1; i>=1; i
2bb40 2d 2d 29 7b 0a 20 20 20 20 20 20 57 68 65 72 65 --){. Where
2bb50 54 65 72 6d 20 2a 70 54 65 72 6d 2c 20 2a 70 45 Term *pTerm, *pE
2bb60 6e 64 3b 0a 20 20 20 20 20 20 73 74 72 75 63 74 nd;. struct
2bb70 20 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 2a 70 SrcList_item *p
2bb80 49 74 65 6d 3b 0a 20 20 20 20 20 20 70 4c 6f 6f Item;. pLoo
2bb90 70 20 3d 20 70 57 49 6e 66 6f 2d 3e 61 5b 69 5d p = pWInfo->a[i]
2bba0 2e 70 57 4c 6f 6f 70 3b 0a 20 20 20 20 20 20 70 .pWLoop;. p
2bbb0 49 74 65 6d 20 3d 20 26 70 57 49 6e 66 6f 2d 3e Item = &pWInfo->
2bbc0 70 54 61 62 4c 69 73 74 2d 3e 61 5b 70 4c 6f 6f pTabList->a[pLoo
2bbd0 70 2d 3e 69 54 61 62 5d 3b 0a 20 20 20 20 20 20 p->iTab];.
2bbe0 69 66 28 20 28 70 49 74 65 6d 2d 3e 66 67 2e 6a if( (pItem->fg.j
2bbf0 6f 69 6e 74 79 70 65 20 26 20 4a 54 5f 4c 45 46 ointype & JT_LEF
2bc00 54 29 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65 T)==0 ) continue
2bc10 3b 0a 20 20 20 20 20 20 69 66 28 20 28 77 63 74 ;. if( (wct
2bc20 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f rlFlags & WHERE_
2bc30 57 41 4e 54 5f 44 49 53 54 49 4e 43 54 29 3d 3d WANT_DISTINCT)==
2bc40 30 0a 20 20 20 20 20 20 20 26 26 20 28 70 4c 6f 0. && (pLo
2bc50 6f 70 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 48 op->wsFlags & WH
2bc60 45 52 45 5f 4f 4e 45 52 4f 57 29 3d 3d 30 0a 20 ERE_ONEROW)==0.
2bc70 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 ){.
2bc80 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 continue;.
2bc90 7d 0a 20 20 20 20 20 20 69 66 28 20 28 74 61 62 }. if( (tab
2bca0 55 73 65 64 20 26 20 70 4c 6f 6f 70 2d 3e 6d 61 Used & pLoop->ma
2bcb0 73 6b 53 65 6c 66 29 21 3d 30 20 29 20 63 6f 6e skSelf)!=0 ) con
2bcc0 74 69 6e 75 65 3b 0a 20 20 20 20 20 20 70 45 6e tinue;. pEn
2bcd0 64 20 3d 20 73 57 4c 42 2e 70 57 43 2d 3e 61 20 d = sWLB.pWC->a
2bce0 2b 20 73 57 4c 42 2e 70 57 43 2d 3e 6e 54 65 72 + sWLB.pWC->nTer
2bcf0 6d 3b 0a 20 20 20 20 20 20 66 6f 72 28 70 54 65 m;. for(pTe
2bd00 72 6d 3d 73 57 4c 42 2e 70 57 43 2d 3e 61 3b 20 rm=sWLB.pWC->a;
2bd10 70 54 65 72 6d 3c 70 45 6e 64 3b 20 70 54 65 72 pTerm<pEnd; pTer
2bd20 6d 2b 2b 29 7b 0a 20 20 20 20 20 20 20 20 69 66 m++){. if
2bd30 28 20 28 70 54 65 72 6d 2d 3e 70 72 65 72 65 71 ( (pTerm->prereq
2bd40 41 6c 6c 20 26 20 70 4c 6f 6f 70 2d 3e 6d 61 73 All & pLoop->mas
2bd50 6b 53 65 6c 66 29 21 3d 30 20 29 7b 0a 20 20 20 kSelf)!=0 ){.
2bd60 20 20 20 20 20 20 20 69 66 28 20 21 45 78 70 72 if( !Expr
2bd70 48 61 73 50 72 6f 70 65 72 74 79 28 70 54 65 72 HasProperty(pTer
2bd80 6d 2d 3e 70 45 78 70 72 2c 20 45 50 5f 46 72 6f m->pExpr, EP_Fro
2bd90 6d 4a 6f 69 6e 29 0a 20 20 20 20 20 20 20 20 20 mJoin).
2bda0 20 20 7c 7c 20 70 54 65 72 6d 2d 3e 70 45 78 70 || pTerm->pExp
2bdb0 72 2d 3e 69 52 69 67 68 74 4a 6f 69 6e 54 61 62 r->iRightJoinTab
2bdc0 6c 65 21 3d 70 49 74 65 6d 2d 3e 69 43 75 72 73 le!=pItem->iCurs
2bdd0 6f 72 0a 20 20 20 20 20 20 20 20 20 20 29 7b 0a or. ){.
2bde0 20 20 20 20 20 20 20 20 20 20 20 20 62 72 65 61 brea
2bdf0 6b 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 k;. }.
2be00 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
2be10 0a 20 20 20 20 20 20 69 66 28 20 70 54 65 72 6d . if( pTerm
2be20 3c 70 45 6e 64 20 29 20 63 6f 6e 74 69 6e 75 65 <pEnd ) continue
2be30 3b 0a 20 20 20 20 20 20 57 48 45 52 45 54 52 41 ;. WHERETRA
2be40 43 45 28 30 78 66 66 66 66 2c 20 28 22 2d 3e 20 CE(0xffff, ("->
2be50 64 72 6f 70 20 6c 6f 6f 70 20 25 63 20 6e 6f 74 drop loop %c not
2be60 20 75 73 65 64 5c 6e 22 2c 20 70 4c 6f 6f 70 2d used\n", pLoop-
2be70 3e 63 49 64 29 29 3b 0a 20 20 20 20 20 20 6e 6f >cId));. no
2be80 74 52 65 61 64 79 20 26 3d 20 7e 70 4c 6f 6f 70 tReady &= ~pLoop
2be90 2d 3e 6d 61 73 6b 53 65 6c 66 3b 0a 20 20 20 20 ->maskSelf;.
2bea0 20 20 66 6f 72 28 70 54 65 72 6d 3d 73 57 4c 42 for(pTerm=sWLB
2beb0 2e 70 57 43 2d 3e 61 3b 20 70 54 65 72 6d 3c 70 .pWC->a; pTerm<p
2bec0 45 6e 64 3b 20 70 54 65 72 6d 2b 2b 29 7b 0a 20 End; pTerm++){.
2bed0 20 20 20 20 20 20 20 69 66 28 20 28 70 54 65 72 if( (pTer
2bee0 6d 2d 3e 70 72 65 72 65 71 41 6c 6c 20 26 20 70 m->prereqAll & p
2bef0 4c 6f 6f 70 2d 3e 6d 61 73 6b 53 65 6c 66 29 21 Loop->maskSelf)!
2bf00 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 =0 ){.
2bf10 70 54 65 72 6d 2d 3e 77 74 46 6c 61 67 73 20 7c pTerm->wtFlags |
2bf20 3d 20 54 45 52 4d 5f 43 4f 44 45 44 3b 0a 20 20 = TERM_CODED;.
2bf30 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a }. }.
2bf40 20 20 20 20 20 20 69 66 28 20 69 21 3d 70 57 49 if( i!=pWI
2bf50 6e 66 6f 2d 3e 6e 4c 65 76 65 6c 2d 31 20 29 7b nfo->nLevel-1 ){
2bf60 0a 20 20 20 20 20 20 20 20 69 6e 74 20 6e 42 79 . int nBy
2bf70 74 65 20 3d 20 28 70 57 49 6e 66 6f 2d 3e 6e 4c te = (pWInfo->nL
2bf80 65 76 65 6c 2d 31 2d 69 29 20 2a 20 73 69 7a 65 evel-1-i) * size
2bf90 6f 66 28 57 68 65 72 65 4c 65 76 65 6c 29 3b 0a of(WhereLevel);.
2bfa0 20 20 20 20 20 20 20 20 6d 65 6d 6d 6f 76 65 28 memmove(
2bfb0 26 70 57 49 6e 66 6f 2d 3e 61 5b 69 5d 2c 20 26 &pWInfo->a[i], &
2bfc0 70 57 49 6e 66 6f 2d 3e 61 5b 69 2b 31 5d 2c 20 pWInfo->a[i+1],
2bfd0 6e 42 79 74 65 29 3b 0a 20 20 20 20 20 20 7d 0a nByte);. }.
2bfe0 20 20 20 20 20 20 70 57 49 6e 66 6f 2d 3e 6e 4c pWInfo->nL
2bff0 65 76 65 6c 2d 2d 3b 0a 20 20 20 20 20 20 6e 54 evel--;. nT
2c000 61 62 4c 69 73 74 2d 2d 3b 0a 20 20 20 20 7d 0a abList--;. }.
2c010 20 20 7d 0a 20 20 57 48 45 52 45 54 52 41 43 45 }. WHERETRACE
2c020 28 30 78 66 66 66 66 2c 28 22 2a 2a 2a 20 4f 70 (0xffff,("*** Op
2c030 74 69 6d 69 7a 65 72 20 46 69 6e 69 73 68 65 64 timizer Finished
2c040 20 2a 2a 2a 5c 6e 22 29 29 3b 0a 20 20 70 57 49 ***\n"));. pWI
2c050 6e 66 6f 2d 3e 70 50 61 72 73 65 2d 3e 6e 51 75 nfo->pParse->nQu
2c060 65 72 79 4c 6f 6f 70 20 2b 3d 20 70 57 49 6e 66 eryLoop += pWInf
2c070 6f 2d 3e 6e 52 6f 77 4f 75 74 3b 0a 0a 20 20 2f o->nRowOut;.. /
2c080 2a 20 49 66 20 74 68 65 20 63 61 6c 6c 65 72 20 * If the caller
2c090 69 73 20 61 6e 20 55 50 44 41 54 45 20 6f 72 20 is an UPDATE or
2c0a0 44 45 4c 45 54 45 20 73 74 61 74 65 6d 65 6e 74 DELETE statement
2c0b0 20 74 68 61 74 20 69 73 20 72 65 71 75 65 73 74 that is request
2c0c0 69 6e 67 0a 20 20 2a 2a 20 74 6f 20 75 73 65 20 ing. ** to use
2c0d0 61 20 6f 6e 65 2d 70 61 73 73 20 61 6c 67 6f 72 a one-pass algor
2c0e0 69 74 68 6d 2c 20 64 65 74 65 72 6d 69 6e 65 20 ithm, determine
2c0f0 69 66 20 74 68 69 73 20 69 73 20 61 70 70 72 6f if this is appro
2c100 70 72 69 61 74 65 2e 0a 20 20 2a 2a 0a 20 20 2a priate.. **. *
2c110 2a 20 41 20 6f 6e 65 2d 70 61 73 73 20 61 70 70 * A one-pass app
2c120 72 6f 61 63 68 20 63 61 6e 20 62 65 20 75 73 65 roach can be use
2c130 64 20 69 66 20 74 68 65 20 63 61 6c 6c 65 72 20 d if the caller
2c140 68 61 73 20 72 65 71 75 65 73 74 65 64 20 6f 6e has requested on
2c150 65 0a 20 20 2a 2a 20 61 6e 64 20 65 69 74 68 65 e. ** and eithe
2c160 72 20 28 61 29 20 74 68 65 20 73 63 61 6e 20 76 r (a) the scan v
2c170 69 73 69 74 73 20 61 74 20 6d 6f 73 74 20 6f 6e isits at most on
2c180 65 20 72 6f 77 20 6f 72 20 28 62 29 20 65 61 63 e row or (b) eac
2c190 68 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20 66 6f h. ** of the fo
2c1a0 6c 6c 6f 77 69 6e 67 20 61 72 65 20 74 72 75 65 llowing are true
2c1b0 3a 0a 20 20 2a 2a 0a 20 20 2a 2a 20 20 20 2a 20 :. **. ** *
2c1c0 74 68 65 20 63 61 6c 6c 65 72 20 68 61 73 20 69 the caller has i
2c1d0 6e 64 69 63 61 74 65 64 20 74 68 61 74 20 61 20 ndicated that a
2c1e0 6f 6e 65 2d 70 61 73 73 20 61 70 70 72 6f 61 63 one-pass approac
2c1f0 68 20 63 61 6e 20 62 65 20 75 73 65 64 0a 20 20 h can be used.
2c200 2a 2a 20 20 20 20 20 77 69 74 68 20 6d 75 6c 74 ** with mult
2c210 69 70 6c 65 20 72 6f 77 73 20 28 62 79 20 73 65 iple rows (by se
2c220 74 74 69 6e 67 20 57 48 45 52 45 5f 4f 4e 45 50 tting WHERE_ONEP
2c230 41 53 53 5f 4d 55 4c 54 49 52 4f 57 29 2c 20 61 ASS_MULTIROW), a
2c240 6e 64 0a 20 20 2a 2a 20 20 20 2a 20 74 68 65 20 nd. ** * the
2c250 74 61 62 6c 65 20 69 73 20 6e 6f 74 20 61 20 76 table is not a v
2c260 69 72 74 75 61 6c 20 74 61 62 6c 65 2c 20 61 6e irtual table, an
2c270 64 0a 20 20 2a 2a 20 20 20 2a 20 65 69 74 68 65 d. ** * eithe
2c280 72 20 74 68 65 20 73 63 61 6e 20 64 6f 65 73 20 r the scan does
2c290 6e 6f 74 20 75 73 65 20 74 68 65 20 4f 52 20 6f not use the OR o
2c2a0 70 74 69 6d 69 7a 61 74 69 6f 6e 20 6f 72 20 74 ptimization or t
2c2b0 68 65 20 63 61 6c 6c 65 72 0a 20 20 2a 2a 20 20 he caller. **
2c2c0 20 20 20 69 73 20 61 20 44 45 4c 45 54 45 20 6f is a DELETE o
2c2d0 70 65 72 61 74 69 6f 6e 20 28 57 48 45 52 45 5f peration (WHERE_
2c2e0 44 55 50 4c 49 43 41 54 45 53 5f 4f 4b 20 69 73 DUPLICATES_OK is
2c2f0 20 6f 6e 6c 79 20 73 70 65 63 69 66 69 65 64 0a only specified.
2c300 20 20 2a 2a 20 20 20 20 20 66 6f 72 20 44 45 4c ** for DEL
2c310 45 54 45 29 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 ETE).. **. **
2c320 54 68 65 20 6c 61 73 74 20 71 75 61 6c 69 66 69 The last qualifi
2c330 63 61 74 69 6f 6e 20 69 73 20 62 65 63 61 75 73 cation is becaus
2c340 65 20 61 6e 20 55 50 44 41 54 45 20 73 74 61 74 e an UPDATE stat
2c350 65 6d 65 6e 74 20 75 73 65 73 0a 20 20 2a 2a 20 ement uses. **
2c360 57 68 65 72 65 49 6e 66 6f 2e 61 69 43 75 72 4f WhereInfo.aiCurO
2c370 6e 65 50 61 73 73 5b 31 5d 20 74 6f 20 64 65 74 nePass[1] to det
2c380 65 72 6d 69 6e 65 20 77 68 65 74 68 65 72 20 6f ermine whether o
2c390 72 20 6e 6f 74 20 69 74 20 72 65 61 6c 6c 79 20 r not it really
2c3a0 63 61 6e 0a 20 20 2a 2a 20 75 73 65 20 61 20 6f can. ** use a o
2c3b0 6e 65 2d 70 61 73 73 20 61 70 70 72 6f 61 63 68 ne-pass approach
2c3c0 2c 20 61 6e 64 20 74 68 69 73 20 69 73 20 6e 6f , and this is no
2c3d0 74 20 73 65 74 20 61 63 63 75 72 61 74 65 6c 79 t set accurately
2c3e0 20 66 6f 72 20 73 63 61 6e 73 0a 20 20 2a 2a 20 for scans. **
2c3f0 74 68 61 74 20 75 73 65 20 74 68 65 20 4f 52 20 that use the OR
2c400 6f 70 74 69 6d 69 7a 61 74 69 6f 6e 2e 0a 20 20 optimization..
2c410 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 28 77 63 */. assert( (wc
2c420 74 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 trlFlags & WHERE
2c430 5f 4f 4e 45 50 41 53 53 5f 44 45 53 49 52 45 44 _ONEPASS_DESIRED
2c440 29 3d 3d 30 20 7c 7c 20 70 57 49 6e 66 6f 2d 3e )==0 || pWInfo->
2c450 6e 4c 65 76 65 6c 3d 3d 31 20 29 3b 0a 20 20 69 nLevel==1 );. i
2c460 66 28 20 28 77 63 74 72 6c 46 6c 61 67 73 20 26 f( (wctrlFlags &
2c470 20 57 48 45 52 45 5f 4f 4e 45 50 41 53 53 5f 44 WHERE_ONEPASS_D
2c480 45 53 49 52 45 44 29 21 3d 30 20 29 7b 0a 20 20 ESIRED)!=0 ){.
2c490 20 20 69 6e 74 20 77 73 46 6c 61 67 73 20 3d 20 int wsFlags =
2c4a0 70 57 49 6e 66 6f 2d 3e 61 5b 30 5d 2e 70 57 4c pWInfo->a[0].pWL
2c4b0 6f 6f 70 2d 3e 77 73 46 6c 61 67 73 3b 0a 20 20 oop->wsFlags;.
2c4c0 20 20 69 6e 74 20 62 4f 6e 65 72 6f 77 20 3d 20 int bOnerow =
2c4d0 28 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 45 (wsFlags & WHERE
2c4e0 5f 4f 4e 45 52 4f 57 29 21 3d 30 3b 0a 20 20 20 _ONEROW)!=0;.
2c4f0 20 69 66 28 20 62 4f 6e 65 72 6f 77 20 7c 7c 20 if( bOnerow ||
2c500 28 0a 20 20 20 20 20 20 20 20 30 21 3d 28 77 63 (. 0!=(wc
2c510 74 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 45 trlFlags & WHERE
2c520 5f 4f 4e 45 50 41 53 53 5f 4d 55 4c 54 49 52 4f _ONEPASS_MULTIRO
2c530 57 29 0a 20 20 20 20 20 26 26 20 30 3d 3d 28 77 W). && 0==(w
2c540 73 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f 56 sFlags & WHERE_V
2c550 49 52 54 55 41 4c 54 41 42 4c 45 29 0a 20 20 20 IRTUALTABLE).
2c560 20 20 26 26 20 28 30 3d 3d 28 77 73 46 6c 61 67 && (0==(wsFlag
2c570 73 20 26 20 57 48 45 52 45 5f 4d 55 4c 54 49 5f s & WHERE_MULTI_
2c580 4f 52 29 20 7c 7c 20 28 77 63 74 72 6c 46 6c 61 OR) || (wctrlFla
2c590 67 73 20 26 20 57 48 45 52 45 5f 44 55 50 4c 49 gs & WHERE_DUPLI
2c5a0 43 41 54 45 53 5f 4f 4b 29 29 0a 20 20 20 20 29 CATES_OK)). )
2c5b0 29 7b 0a 20 20 20 20 20 20 70 57 49 6e 66 6f 2d ){. pWInfo-
2c5c0 3e 65 4f 6e 65 50 61 73 73 20 3d 20 62 4f 6e 65 >eOnePass = bOne
2c5d0 72 6f 77 20 3f 20 4f 4e 45 50 41 53 53 5f 53 49 row ? ONEPASS_SI
2c5e0 4e 47 4c 45 20 3a 20 4f 4e 45 50 41 53 53 5f 4d NGLE : ONEPASS_M
2c5f0 55 4c 54 49 3b 0a 20 20 20 20 20 20 69 66 28 20 ULTI;. if(
2c600 48 61 73 52 6f 77 69 64 28 70 54 61 62 4c 69 73 HasRowid(pTabLis
2c610 74 2d 3e 61 5b 30 5d 2e 70 54 61 62 29 20 26 26 t->a[0].pTab) &&
2c620 20 28 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 (wsFlags & WHER
2c630 45 5f 49 44 58 5f 4f 4e 4c 59 29 20 29 7b 0a 20 E_IDX_ONLY) ){.
2c640 20 20 20 20 20 20 20 69 66 28 20 77 63 74 72 6c if( wctrl
2c650 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f 4f 4e Flags & WHERE_ON
2c660 45 50 41 53 53 5f 4d 55 4c 54 49 52 4f 57 20 29 EPASS_MULTIROW )
2c670 7b 0a 20 20 20 20 20 20 20 20 20 20 62 46 6f 72 {. bFor
2c680 64 65 6c 65 74 65 20 3d 20 4f 50 46 4c 41 47 5f delete = OPFLAG_
2c690 46 4f 52 44 45 4c 45 54 45 3b 0a 20 20 20 20 20 FORDELETE;.
2c6a0 20 20 20 7d 0a 20 20 20 20 20 20 20 20 70 57 49 }. pWI
2c6b0 6e 66 6f 2d 3e 61 5b 30 5d 2e 70 57 4c 6f 6f 70 nfo->a[0].pWLoop
2c6c0 2d 3e 77 73 46 6c 61 67 73 20 3d 20 28 77 73 46 ->wsFlags = (wsF
2c6d0 6c 61 67 73 20 26 20 7e 57 48 45 52 45 5f 49 44 lags & ~WHERE_ID
2c6e0 58 5f 4f 4e 4c 59 29 3b 0a 20 20 20 20 20 20 7d X_ONLY);. }
2c6f0 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a . }. }.. /*
2c700 20 4f 70 65 6e 20 61 6c 6c 20 74 61 62 6c 65 73 Open all tables
2c710 20 69 6e 20 74 68 65 20 70 54 61 62 4c 69 73 74 in the pTabList
2c720 20 61 6e 64 20 61 6e 79 20 69 6e 64 69 63 65 73 and any indices
2c730 20 73 65 6c 65 63 74 65 64 20 66 6f 72 0a 20 20 selected for.
2c740 2a 2a 20 73 65 61 72 63 68 69 6e 67 20 74 68 6f ** searching tho
2c750 73 65 20 74 61 62 6c 65 73 2e 0a 20 20 2a 2f 0a se tables.. */.
2c760 20 20 66 6f 72 28 69 69 3d 30 2c 20 70 4c 65 76 for(ii=0, pLev
2c770 65 6c 3d 70 57 49 6e 66 6f 2d 3e 61 3b 20 69 69 el=pWInfo->a; ii
2c780 3c 6e 54 61 62 4c 69 73 74 3b 20 69 69 2b 2b 2c <nTabList; ii++,
2c790 20 70 4c 65 76 65 6c 2b 2b 29 7b 0a 20 20 20 20 pLevel++){.
2c7a0 54 61 62 6c 65 20 2a 70 54 61 62 3b 20 20 20 20 Table *pTab;
2c7b0 20 2f 2a 20 54 61 62 6c 65 20 74 6f 20 6f 70 65 /* Table to ope
2c7c0 6e 20 2a 2f 0a 20 20 20 20 69 6e 74 20 69 44 62 n */. int iDb
2c7d0 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 ; /* Ind
2c7e0 65 78 20 6f 66 20 64 61 74 61 62 61 73 65 20 63 ex of database c
2c7f0 6f 6e 74 61 69 6e 69 6e 67 20 74 61 62 6c 65 2f ontaining table/
2c800 69 6e 64 65 78 20 2a 2f 0a 20 20 20 20 73 74 72 index */. str
2c810 75 63 74 20 53 72 63 4c 69 73 74 5f 69 74 65 6d uct SrcList_item
2c820 20 2a 70 54 61 62 49 74 65 6d 3b 0a 0a 20 20 20 *pTabItem;..
2c830 20 70 54 61 62 49 74 65 6d 20 3d 20 26 70 54 61 pTabItem = &pTa
2c840 62 4c 69 73 74 2d 3e 61 5b 70 4c 65 76 65 6c 2d bList->a[pLevel-
2c850 3e 69 46 72 6f 6d 5d 3b 0a 20 20 20 20 70 54 61 >iFrom];. pTa
2c860 62 20 3d 20 70 54 61 62 49 74 65 6d 2d 3e 70 54 b = pTabItem->pT
2c870 61 62 3b 0a 20 20 20 20 69 44 62 20 3d 20 73 71 ab;. iDb = sq
2c880 6c 69 74 65 33 53 63 68 65 6d 61 54 6f 49 6e 64 lite3SchemaToInd
2c890 65 78 28 64 62 2c 20 70 54 61 62 2d 3e 70 53 63 ex(db, pTab->pSc
2c8a0 68 65 6d 61 29 3b 0a 20 20 20 20 70 4c 6f 6f 70 hema);. pLoop
2c8b0 20 3d 20 70 4c 65 76 65 6c 2d 3e 70 57 4c 6f 6f = pLevel->pWLoo
2c8c0 70 3b 0a 20 20 20 20 69 66 28 20 28 70 54 61 62 p;. if( (pTab
2c8d0 2d 3e 74 61 62 46 6c 61 67 73 20 26 20 54 46 5f ->tabFlags & TF_
2c8e0 45 70 68 65 6d 65 72 61 6c 29 21 3d 30 20 7c 7c Ephemeral)!=0 ||
2c8f0 20 70 54 61 62 2d 3e 70 53 65 6c 65 63 74 20 29 pTab->pSelect )
2c900 7b 0a 20 20 20 20 20 20 2f 2a 20 44 6f 20 6e 6f {. /* Do no
2c910 74 68 69 6e 67 20 2a 2f 0a 20 20 20 20 7d 65 6c thing */. }el
2c920 73 65 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 se.#ifndef SQLIT
2c930 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54 41 E_OMIT_VIRTUALTA
2c940 42 4c 45 0a 20 20 20 20 69 66 28 20 28 70 4c 6f BLE. if( (pLo
2c950 6f 70 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 48 op->wsFlags & WH
2c960 45 52 45 5f 56 49 52 54 55 41 4c 54 41 42 4c 45 ERE_VIRTUALTABLE
2c970 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 63 6f )!=0 ){. co
2c980 6e 73 74 20 63 68 61 72 20 2a 70 56 54 61 62 20 nst char *pVTab
2c990 3d 20 28 63 6f 6e 73 74 20 63 68 61 72 20 2a 29 = (const char *)
2c9a0 73 71 6c 69 74 65 33 47 65 74 56 54 61 62 6c 65 sqlite3GetVTable
2c9b0 28 64 62 2c 20 70 54 61 62 29 3b 0a 20 20 20 20 (db, pTab);.
2c9c0 20 20 69 6e 74 20 69 43 75 72 20 3d 20 70 54 61 int iCur = pTa
2c9d0 62 49 74 65 6d 2d 3e 69 43 75 72 73 6f 72 3b 0a bItem->iCursor;.
2c9e0 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 sqlite3Vdb
2c9f0 65 41 64 64 4f 70 34 28 76 2c 20 4f 50 5f 56 4f eAddOp4(v, OP_VO
2ca00 70 65 6e 2c 20 69 43 75 72 2c 20 30 2c 20 30 2c pen, iCur, 0, 0,
2ca10 20 70 56 54 61 62 2c 20 50 34 5f 56 54 41 42 29 pVTab, P4_VTAB)
2ca20 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 ;. }else if(
2ca30 49 73 56 69 72 74 75 61 6c 28 70 54 61 62 29 20 IsVirtual(pTab)
2ca40 29 7b 0a 20 20 20 20 20 20 2f 2a 20 6e 6f 6f 70 ){. /* noop
2ca50 20 2a 2f 0a 20 20 20 20 7d 65 6c 73 65 0a 23 65 */. }else.#e
2ca60 6e 64 69 66 0a 20 20 20 20 69 66 28 20 28 70 4c ndif. if( (pL
2ca70 6f 6f 70 2d 3e 77 73 46 6c 61 67 73 20 26 20 57 oop->wsFlags & W
2ca80 48 45 52 45 5f 49 44 58 5f 4f 4e 4c 59 29 3d 3d HERE_IDX_ONLY)==
2ca90 30 0a 20 20 20 20 20 20 20 20 20 26 26 20 28 77 0. && (w
2caa0 63 74 72 6c 46 6c 61 67 73 20 26 20 57 48 45 52 ctrlFlags & WHER
2cab0 45 5f 4f 52 5f 53 55 42 43 4c 41 55 53 45 29 3d E_OR_SUBCLAUSE)=
2cac0 3d 30 20 29 7b 0a 20 20 20 20 20 20 69 6e 74 20 =0 ){. int
2cad0 6f 70 20 3d 20 4f 50 5f 4f 70 65 6e 52 65 61 64 op = OP_OpenRead
2cae0 3b 0a 20 20 20 20 20 20 69 66 28 20 70 57 49 6e ;. if( pWIn
2caf0 66 6f 2d 3e 65 4f 6e 65 50 61 73 73 21 3d 4f 4e fo->eOnePass!=ON
2cb00 45 50 41 53 53 5f 4f 46 46 20 29 7b 0a 20 20 20 EPASS_OFF ){.
2cb10 20 20 20 20 20 6f 70 20 3d 20 4f 50 5f 4f 70 65 op = OP_Ope
2cb20 6e 57 72 69 74 65 3b 0a 20 20 20 20 20 20 20 20 nWrite;.
2cb30 70 57 49 6e 66 6f 2d 3e 61 69 43 75 72 4f 6e 65 pWInfo->aiCurOne
2cb40 50 61 73 73 5b 30 5d 20 3d 20 70 54 61 62 49 74 Pass[0] = pTabIt
2cb50 65 6d 2d 3e 69 43 75 72 73 6f 72 3b 0a 20 20 20 em->iCursor;.
2cb60 20 20 20 7d 3b 0a 20 20 20 20 20 20 73 71 6c 69 };. sqli
2cb70 74 65 33 4f 70 65 6e 54 61 62 6c 65 28 70 50 61 te3OpenTable(pPa
2cb80 72 73 65 2c 20 70 54 61 62 49 74 65 6d 2d 3e 69 rse, pTabItem->i
2cb90 43 75 72 73 6f 72 2c 20 69 44 62 2c 20 70 54 61 Cursor, iDb, pTa
2cba0 62 2c 20 6f 70 29 3b 0a 20 20 20 20 20 20 61 73 b, op);. as
2cbb0 73 65 72 74 28 20 70 54 61 62 49 74 65 6d 2d 3e sert( pTabItem->
2cbc0 69 43 75 72 73 6f 72 3d 3d 70 4c 65 76 65 6c 2d iCursor==pLevel-
2cbd0 3e 69 54 61 62 43 75 72 20 29 3b 0a 20 20 20 20 >iTabCur );.
2cbe0 20 20 74 65 73 74 63 61 73 65 28 20 70 57 49 6e testcase( pWIn
2cbf0 66 6f 2d 3e 65 4f 6e 65 50 61 73 73 3d 3d 4f 4e fo->eOnePass==ON
2cc00 45 50 41 53 53 5f 4f 46 46 20 26 26 20 70 54 61 EPASS_OFF && pTa
2cc10 62 2d 3e 6e 43 6f 6c 3d 3d 42 4d 53 2d 31 20 29 b->nCol==BMS-1 )
2cc20 3b 0a 20 20 20 20 20 20 74 65 73 74 63 61 73 65 ;. testcase
2cc30 28 20 70 57 49 6e 66 6f 2d 3e 65 4f 6e 65 50 61 ( pWInfo->eOnePa
2cc40 73 73 3d 3d 4f 4e 45 50 41 53 53 5f 4f 46 46 20 ss==ONEPASS_OFF
2cc50 26 26 20 70 54 61 62 2d 3e 6e 43 6f 6c 3d 3d 42 && pTab->nCol==B
2cc60 4d 53 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 MS );. if(
2cc70 70 57 49 6e 66 6f 2d 3e 65 4f 6e 65 50 61 73 73 pWInfo->eOnePass
2cc80 3d 3d 4f 4e 45 50 41 53 53 5f 4f 46 46 20 26 26 ==ONEPASS_OFF &&
2cc90 20 70 54 61 62 2d 3e 6e 43 6f 6c 3c 42 4d 53 20 pTab->nCol<BMS
2cca0 26 26 20 48 61 73 52 6f 77 69 64 28 70 54 61 62 && HasRowid(pTab
2ccb0 29 20 29 7b 0a 20 20 20 20 20 20 20 20 42 69 74 ) ){. Bit
2ccc0 6d 61 73 6b 20 62 20 3d 20 70 54 61 62 49 74 65 mask b = pTabIte
2ccd0 6d 2d 3e 63 6f 6c 55 73 65 64 3b 0a 20 20 20 20 m->colUsed;.
2cce0 20 20 20 20 69 6e 74 20 6e 20 3d 20 30 3b 0a 20 int n = 0;.
2ccf0 20 20 20 20 20 20 20 66 6f 72 28 3b 20 62 3b 20 for(; b;
2cd00 62 3d 62 3e 3e 31 2c 20 6e 2b 2b 29 7b 7d 0a 20 b=b>>1, n++){}.
2cd10 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 sqlite3Vd
2cd20 62 65 43 68 61 6e 67 65 50 34 28 76 2c 20 2d 31 beChangeP4(v, -1
2cd30 2c 20 53 51 4c 49 54 45 5f 49 4e 54 5f 54 4f 5f , SQLITE_INT_TO_
2cd40 50 54 52 28 6e 29 2c 20 50 34 5f 49 4e 54 33 32 PTR(n), P4_INT32
2cd50 29 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 );. asser
2cd60 74 28 20 6e 3c 3d 70 54 61 62 2d 3e 6e 43 6f 6c t( n<=pTab->nCol
2cd70 20 29 3b 0a 20 20 20 20 20 20 7d 0a 23 69 66 64 );. }.#ifd
2cd80 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 ef SQLITE_ENABLE
2cd90 5f 43 55 52 53 4f 52 5f 48 49 4e 54 53 0a 20 20 _CURSOR_HINTS.
2cda0 20 20 20 20 69 66 28 20 70 4c 6f 6f 70 2d 3e 75 if( pLoop->u
2cdb0 2e 62 74 72 65 65 2e 70 49 6e 64 65 78 21 3d 30 .btree.pIndex!=0
2cdc0 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 ){. sqli
2cdd0 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 35 28 te3VdbeChangeP5(
2cde0 76 2c 20 4f 50 46 4c 41 47 5f 53 45 45 4b 45 51 v, OPFLAG_SEEKEQ
2cdf0 7c 62 46 6f 72 64 65 6c 65 74 65 29 3b 0a 20 20 |bFordelete);.
2ce00 20 20 20 20 7d 65 6c 73 65 0a 23 65 6e 64 69 66 }else.#endif
2ce10 0a 20 20 20 20 20 20 7b 0a 20 20 20 20 20 20 20 . {.
2ce20 20 73 71 6c 69 74 65 33 56 64 62 65 43 68 61 6e sqlite3VdbeChan
2ce30 67 65 50 35 28 76 2c 20 62 46 6f 72 64 65 6c 65 geP5(v, bFordele
2ce40 74 65 29 3b 0a 20 20 20 20 20 20 7d 0a 23 69 66 te);. }.#if
2ce50 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c def SQLITE_ENABL
2ce60 45 5f 43 4f 4c 55 4d 4e 5f 55 53 45 44 5f 4d 41 E_COLUMN_USED_MA
2ce70 53 4b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 SK. sqlite3
2ce80 56 64 62 65 41 64 64 4f 70 34 44 75 70 38 28 76 VdbeAddOp4Dup8(v
2ce90 2c 20 4f 50 5f 43 6f 6c 75 6d 6e 73 55 73 65 64 , OP_ColumnsUsed
2cea0 2c 20 70 54 61 62 49 74 65 6d 2d 3e 69 43 75 72 , pTabItem->iCur
2ceb0 73 6f 72 2c 20 30 2c 20 30 2c 0a 20 20 20 20 20 sor, 0, 0,.
2cec0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2ced0 20 20 20 20 20 20 20 28 63 6f 6e 73 74 20 75 38 (const u8
2cee0 2a 29 26 70 54 61 62 49 74 65 6d 2d 3e 63 6f 6c *)&pTabItem->col
2cef0 55 73 65 64 2c 20 50 34 5f 49 4e 54 36 34 29 3b Used, P4_INT64);
2cf00 0a 23 65 6e 64 69 66 0a 20 20 20 20 7d 65 6c 73 .#endif. }els
2cf10 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 e{. sqlite3
2cf20 54 61 62 6c 65 4c 6f 63 6b 28 70 50 61 72 73 65 TableLock(pParse
2cf30 2c 20 69 44 62 2c 20 70 54 61 62 2d 3e 74 6e 75 , iDb, pTab->tnu
2cf40 6d 2c 20 30 2c 20 70 54 61 62 2d 3e 7a 4e 61 6d m, 0, pTab->zNam
2cf50 65 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 e);. }. if
2cf60 28 20 70 4c 6f 6f 70 2d 3e 77 73 46 6c 61 67 73 ( pLoop->wsFlags
2cf70 20 26 20 57 48 45 52 45 5f 49 4e 44 45 58 45 44 & WHERE_INDEXED
2cf80 20 29 7b 0a 20 20 20 20 20 20 49 6e 64 65 78 20 ){. Index
2cf90 2a 70 49 78 20 3d 20 70 4c 6f 6f 70 2d 3e 75 2e *pIx = pLoop->u.
2cfa0 62 74 72 65 65 2e 70 49 6e 64 65 78 3b 0a 20 20 btree.pIndex;.
2cfb0 20 20 20 20 69 6e 74 20 69 49 6e 64 65 78 43 75 int iIndexCu
2cfc0 72 3b 0a 20 20 20 20 20 20 69 6e 74 20 6f 70 20 r;. int op
2cfd0 3d 20 4f 50 5f 4f 70 65 6e 52 65 61 64 3b 0a 20 = OP_OpenRead;.
2cfe0 20 20 20 20 20 2f 2a 20 69 41 75 78 41 72 67 20 /* iAuxArg
2cff0 69 73 20 61 6c 77 61 79 73 20 73 65 74 20 74 6f is always set to
2d000 20 61 20 70 6f 73 69 74 69 76 65 20 76 61 6c 75 a positive valu
2d010 65 20 69 66 20 4f 4e 45 50 41 53 53 20 69 73 20 e if ONEPASS is
2d020 70 6f 73 73 69 62 6c 65 20 2a 2f 0a 20 20 20 20 possible */.
2d030 20 20 61 73 73 65 72 74 28 20 69 41 75 78 41 72 assert( iAuxAr
2d040 67 21 3d 30 20 7c 7c 20 28 70 57 49 6e 66 6f 2d g!=0 || (pWInfo-
2d050 3e 77 63 74 72 6c 46 6c 61 67 73 20 26 20 57 48 >wctrlFlags & WH
2d060 45 52 45 5f 4f 4e 45 50 41 53 53 5f 44 45 53 49 ERE_ONEPASS_DESI
2d070 52 45 44 29 3d 3d 30 20 29 3b 0a 20 20 20 20 20 RED)==0 );.
2d080 20 69 66 28 20 21 48 61 73 52 6f 77 69 64 28 70 if( !HasRowid(p
2d090 54 61 62 29 20 26 26 20 49 73 50 72 69 6d 61 72 Tab) && IsPrimar
2d0a0 79 4b 65 79 49 6e 64 65 78 28 70 49 78 29 0a 20 yKeyIndex(pIx).
2d0b0 20 20 20 20 20 20 26 26 20 28 77 63 74 72 6c 46 && (wctrlF
2d0c0 6c 61 67 73 20 26 20 57 48 45 52 45 5f 4f 52 5f lags & WHERE_OR_
2d0d0 53 55 42 43 4c 41 55 53 45 29 21 3d 30 0a 20 20 SUBCLAUSE)!=0.
2d0e0 20 20 20 20 29 7b 0a 20 20 20 20 20 20 20 20 2f ){. /
2d0f0 2a 20 54 68 69 73 20 69 73 20 6f 6e 65 20 74 65 * This is one te
2d100 72 6d 20 6f 66 20 61 6e 20 4f 52 2d 6f 70 74 69 rm of an OR-opti
2d110 6d 69 7a 61 74 69 6f 6e 20 75 73 69 6e 67 20 74 mization using t
2d120 68 65 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f he PRIMARY KEY o
2d130 66 20 61 0a 20 20 20 20 20 20 20 20 2a 2a 20 57 f a. ** W
2d140 49 54 48 4f 55 54 20 52 4f 57 49 44 20 74 61 62 ITHOUT ROWID tab
2d150 6c 65 2e 20 20 4e 6f 20 6e 65 65 64 20 66 6f 72 le. No need for
2d160 20 61 20 73 65 70 61 72 61 74 65 20 69 6e 64 65 a separate inde
2d170 78 20 2a 2f 0a 20 20 20 20 20 20 20 20 69 49 6e x */. iIn
2d180 64 65 78 43 75 72 20 3d 20 70 4c 65 76 65 6c 2d dexCur = pLevel-
2d190 3e 69 54 61 62 43 75 72 3b 0a 20 20 20 20 20 20 >iTabCur;.
2d1a0 20 20 6f 70 20 3d 20 30 3b 0a 20 20 20 20 20 20 op = 0;.
2d1b0 7d 65 6c 73 65 20 69 66 28 20 70 57 49 6e 66 6f }else if( pWInfo
2d1c0 2d 3e 65 4f 6e 65 50 61 73 73 21 3d 4f 4e 45 50 ->eOnePass!=ONEP
2d1d0 41 53 53 5f 4f 46 46 20 29 7b 0a 20 20 20 20 20 ASS_OFF ){.
2d1e0 20 20 20 49 6e 64 65 78 20 2a 70 4a 20 3d 20 70 Index *pJ = p
2d1f0 54 61 62 49 74 65 6d 2d 3e 70 54 61 62 2d 3e 70 TabItem->pTab->p
2d200 49 6e 64 65 78 3b 0a 20 20 20 20 20 20 20 20 69 Index;. i
2d210 49 6e 64 65 78 43 75 72 20 3d 20 69 41 75 78 41 IndexCur = iAuxA
2d220 72 67 3b 0a 20 20 20 20 20 20 20 20 61 73 73 65 rg;. asse
2d230 72 74 28 20 77 63 74 72 6c 46 6c 61 67 73 20 26 rt( wctrlFlags &
2d240 20 57 48 45 52 45 5f 4f 4e 45 50 41 53 53 5f 44 WHERE_ONEPASS_D
2d250 45 53 49 52 45 44 20 29 3b 0a 20 20 20 20 20 20 ESIRED );.
2d260 20 20 77 68 69 6c 65 28 20 41 4c 57 41 59 53 28 while( ALWAYS(
2d270 70 4a 29 20 26 26 20 70 4a 21 3d 70 49 78 20 29 pJ) && pJ!=pIx )
2d280 7b 0a 20 20 20 20 20 20 20 20 20 20 69 49 6e 64 {. iInd
2d290 65 78 43 75 72 2b 2b 3b 0a 20 20 20 20 20 20 20 exCur++;.
2d2a0 20 20 20 70 4a 20 3d 20 70 4a 2d 3e 70 4e 65 78 pJ = pJ->pNex
2d2b0 74 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 t;. }.
2d2c0 20 20 20 20 20 6f 70 20 3d 20 4f 50 5f 4f 70 65 op = OP_Ope
2d2d0 6e 57 72 69 74 65 3b 0a 20 20 20 20 20 20 20 20 nWrite;.
2d2e0 70 57 49 6e 66 6f 2d 3e 61 69 43 75 72 4f 6e 65 pWInfo->aiCurOne
2d2f0 50 61 73 73 5b 31 5d 20 3d 20 69 49 6e 64 65 78 Pass[1] = iIndex
2d300 43 75 72 3b 0a 20 20 20 20 20 20 7d 65 6c 73 65 Cur;. }else
2d310 20 69 66 28 20 69 41 75 78 41 72 67 20 26 26 20 if( iAuxArg &&
2d320 28 77 63 74 72 6c 46 6c 61 67 73 20 26 20 57 48 (wctrlFlags & WH
2d330 45 52 45 5f 4f 52 5f 53 55 42 43 4c 41 55 53 45 ERE_OR_SUBCLAUSE
2d340 29 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 )!=0 ){.
2d350 69 49 6e 64 65 78 43 75 72 20 3d 20 69 41 75 78 iIndexCur = iAux
2d360 41 72 67 3b 0a 20 20 20 20 20 20 20 20 6f 70 20 Arg;. op
2d370 3d 20 4f 50 5f 52 65 6f 70 65 6e 49 64 78 3b 0a = OP_ReopenIdx;.
2d380 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 }else{.
2d390 20 20 20 20 20 69 49 6e 64 65 78 43 75 72 20 3d iIndexCur =
2d3a0 20 70 50 61 72 73 65 2d 3e 6e 54 61 62 2b 2b 3b pParse->nTab++;
2d3b0 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 70 . }. p
2d3c0 4c 65 76 65 6c 2d 3e 69 49 64 78 43 75 72 20 3d Level->iIdxCur =
2d3d0 20 69 49 6e 64 65 78 43 75 72 3b 0a 20 20 20 20 iIndexCur;.
2d3e0 20 20 61 73 73 65 72 74 28 20 70 49 78 2d 3e 70 assert( pIx->p
2d3f0 53 63 68 65 6d 61 3d 3d 70 54 61 62 2d 3e 70 53 Schema==pTab->pS
2d400 63 68 65 6d 61 20 29 3b 0a 20 20 20 20 20 20 61 chema );. a
2d410 73 73 65 72 74 28 20 69 49 6e 64 65 78 43 75 72 ssert( iIndexCur
2d420 3e 3d 30 20 29 3b 0a 20 20 20 20 20 20 69 66 28 >=0 );. if(
2d430 20 6f 70 20 29 7b 0a 20 20 20 20 20 20 20 20 73 op ){. s
2d440 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 33 qlite3VdbeAddOp3
2d450 28 76 2c 20 6f 70 2c 20 69 49 6e 64 65 78 43 75 (v, op, iIndexCu
2d460 72 2c 20 70 49 78 2d 3e 74 6e 75 6d 2c 20 69 44 r, pIx->tnum, iD
2d470 62 29 3b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 b);. sqli
2d480 74 65 33 56 64 62 65 53 65 74 50 34 4b 65 79 49 te3VdbeSetP4KeyI
2d490 6e 66 6f 28 70 50 61 72 73 65 2c 20 70 49 78 29 nfo(pParse, pIx)
2d4a0 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 28 70 ;. if( (p
2d4b0 4c 6f 6f 70 2d 3e 77 73 46 6c 61 67 73 20 26 20 Loop->wsFlags &
2d4c0 57 48 45 52 45 5f 43 4f 4e 53 54 52 41 49 4e 54 WHERE_CONSTRAINT
2d4d0 29 21 3d 30 0a 20 20 20 20 20 20 20 20 20 26 26 )!=0. &&
2d4e0 20 28 70 4c 6f 6f 70 2d 3e 77 73 46 6c 61 67 73 (pLoop->wsFlags
2d4f0 20 26 20 28 57 48 45 52 45 5f 43 4f 4c 55 4d 4e & (WHERE_COLUMN
2d500 5f 52 41 4e 47 45 7c 57 48 45 52 45 5f 53 4b 49 _RANGE|WHERE_SKI
2d510 50 53 43 41 4e 29 29 3d 3d 30 0a 20 20 20 20 20 PSCAN))==0.
2d520 20 20 20 20 26 26 20 28 70 57 49 6e 66 6f 2d 3e && (pWInfo->
2d530 77 63 74 72 6c 46 6c 61 67 73 26 57 48 45 52 45 wctrlFlags&WHERE
2d540 5f 4f 52 44 45 52 42 59 5f 4d 49 4e 29 3d 3d 30 _ORDERBY_MIN)==0
2d550 0a 20 20 20 20 20 20 20 20 20 26 26 20 70 57 49 . && pWI
2d560 6e 66 6f 2d 3e 65 44 69 73 74 69 6e 63 74 21 3d nfo->eDistinct!=
2d570 57 48 45 52 45 5f 44 49 53 54 49 4e 43 54 5f 4f WHERE_DISTINCT_O
2d580 52 44 45 52 45 44 0a 20 20 20 20 20 20 20 20 29 RDERED. )
2d590 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 {. sqli
2d5a0 74 65 33 56 64 62 65 43 68 61 6e 67 65 50 35 28 te3VdbeChangeP5(
2d5b0 76 2c 20 4f 50 46 4c 41 47 5f 53 45 45 4b 45 51 v, OPFLAG_SEEKEQ
2d5c0 29 3b 20 2f 2a 20 48 69 6e 74 20 74 6f 20 43 4f ); /* Hint to CO
2d5d0 4d 44 42 32 20 2a 2f 0a 20 20 20 20 20 20 20 20 MDB2 */.
2d5e0 7d 0a 20 20 20 20 20 20 20 20 56 64 62 65 43 6f }. VdbeCo
2d5f0 6d 6d 65 6e 74 28 28 76 2c 20 22 25 73 22 2c 20 mment((v, "%s",
2d600 70 49 78 2d 3e 7a 4e 61 6d 65 29 29 3b 0a 23 69 pIx->zName));.#i
2d610 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 fdef SQLITE_ENAB
2d620 4c 45 5f 43 4f 4c 55 4d 4e 5f 55 53 45 44 5f 4d LE_COLUMN_USED_M
2d630 41 53 4b 0a 20 20 20 20 20 20 20 20 7b 0a 20 20 ASK. {.
2d640 20 20 20 20 20 20 20 20 75 36 34 20 63 6f 6c 55 u64 colU
2d650 73 65 64 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 sed = 0;.
2d660 20 20 20 69 6e 74 20 69 69 2c 20 6a 6a 3b 0a 20 int ii, jj;.
2d670 20 20 20 20 20 20 20 20 20 66 6f 72 28 69 69 3d for(ii=
2d680 30 3b 20 69 69 3c 70 49 78 2d 3e 6e 43 6f 6c 75 0; ii<pIx->nColu
2d690 6d 6e 3b 20 69 69 2b 2b 29 7b 0a 20 20 20 20 20 mn; ii++){.
2d6a0 20 20 20 20 20 20 20 6a 6a 20 3d 20 70 49 78 2d jj = pIx-
2d6b0 3e 61 69 43 6f 6c 75 6d 6e 5b 69 69 5d 3b 0a 20 >aiColumn[ii];.
2d6c0 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 6a if( j
2d6d0 6a 3c 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a j<0 ) continue;.
2d6e0 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 20 if(
2d6f0 6a 6a 3e 36 33 20 29 20 6a 6a 20 3d 20 36 33 3b jj>63 ) jj = 63;
2d700 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66 28 . if(
2d710 20 28 70 54 61 62 49 74 65 6d 2d 3e 63 6f 6c 55 (pTabItem->colU
2d720 73 65 64 20 26 20 4d 41 53 4b 42 49 54 28 6a 6a sed & MASKBIT(jj
2d730 29 29 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65 ))==0 ) continue
2d740 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 63 6f ;. co
2d750 6c 55 73 65 64 20 7c 3d 20 28 28 75 36 34 29 31 lUsed |= ((u64)1
2d760 29 3c 3c 28 69 69 3c 36 33 20 3f 20 69 69 20 3a )<<(ii<63 ? ii :
2d770 20 36 33 29 3b 0a 20 20 20 20 20 20 20 20 20 20 63);.
2d780 7d 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 }. sqli
2d790 74 65 33 56 64 62 65 41 64 64 4f 70 34 44 75 70 te3VdbeAddOp4Dup
2d7a0 38 28 76 2c 20 4f 50 5f 43 6f 6c 75 6d 6e 73 55 8(v, OP_ColumnsU
2d7b0 73 65 64 2c 20 69 49 6e 64 65 78 43 75 72 2c 20 sed, iIndexCur,
2d7c0 30 2c 20 30 2c 0a 20 20 20 20 20 20 20 20 20 20 0, 0,.
2d7d0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2d7e0 20 20 20 20 20 20 28 75 38 2a 29 26 63 6f 6c 55 (u8*)&colU
2d7f0 73 65 64 2c 20 50 34 5f 49 4e 54 36 34 29 3b 0a sed, P4_INT64);.
2d800 20 20 20 20 20 20 20 20 7d 0a 23 65 6e 64 69 66 }.#endif
2d810 20 2f 2a 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c /* SQLITE_ENABL
2d820 45 5f 43 4f 4c 55 4d 4e 5f 55 53 45 44 5f 4d 41 E_COLUMN_USED_MA
2d830 53 4b 20 2a 2f 0a 20 20 20 20 20 20 7d 0a 20 20 SK */. }.
2d840 20 20 7d 0a 20 20 20 20 69 66 28 20 69 44 62 3e }. if( iDb>
2d850 3d 30 20 29 20 73 71 6c 69 74 65 33 43 6f 64 65 =0 ) sqlite3Code
2d860 56 65 72 69 66 79 53 63 68 65 6d 61 28 70 50 61 VerifySchema(pPa
2d870 72 73 65 2c 20 69 44 62 29 3b 0a 20 20 7d 0a 20 rse, iDb);. }.
2d880 20 70 57 49 6e 66 6f 2d 3e 69 54 6f 70 20 3d 20 pWInfo->iTop =
2d890 73 71 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 sqlite3VdbeCurre
2d8a0 6e 74 41 64 64 72 28 76 29 3b 0a 20 20 69 66 28 ntAddr(v);. if(
2d8b0 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
2d8c0 64 20 29 20 67 6f 74 6f 20 77 68 65 72 65 42 65 d ) goto whereBe
2d8d0 67 69 6e 45 72 72 6f 72 3b 0a 0a 20 20 2f 2a 20 ginError;.. /*
2d8e0 47 65 6e 65 72 61 74 65 20 74 68 65 20 63 6f 64 Generate the cod
2d8f0 65 20 74 6f 20 64 6f 20 74 68 65 20 73 65 61 72 e to do the sear
2d900 63 68 2e 20 20 45 61 63 68 20 69 74 65 72 61 74 ch. Each iterat
2d910 69 6f 6e 20 6f 66 20 74 68 65 20 66 6f 72 0a 20 ion of the for.
2d920 20 2a 2a 20 6c 6f 6f 70 20 62 65 6c 6f 77 20 67 ** loop below g
2d930 65 6e 65 72 61 74 65 73 20 63 6f 64 65 20 66 6f enerates code fo
2d940 72 20 61 20 73 69 6e 67 6c 65 20 6e 65 73 74 65 r a single neste
2d950 64 20 6c 6f 6f 70 20 6f 66 20 74 68 65 20 56 4d d loop of the VM
2d960 0a 20 20 2a 2a 20 70 72 6f 67 72 61 6d 2e 0a 20 . ** program..
2d970 20 2a 2f 0a 20 20 66 6f 72 28 69 69 3d 30 3b 20 */. for(ii=0;
2d980 69 69 3c 6e 54 61 62 4c 69 73 74 3b 20 69 69 2b ii<nTabList; ii+
2d990 2b 29 7b 0a 20 20 20 20 69 6e 74 20 61 64 64 72 +){. int addr
2d9a0 45 78 70 6c 61 69 6e 3b 0a 20 20 20 20 69 6e 74 Explain;. int
2d9b0 20 77 73 46 6c 61 67 73 3b 0a 20 20 20 20 70 4c wsFlags;. pL
2d9c0 65 76 65 6c 20 3d 20 26 70 57 49 6e 66 6f 2d 3e evel = &pWInfo->
2d9d0 61 5b 69 69 5d 3b 0a 20 20 20 20 77 73 46 6c 61 a[ii];. wsFla
2d9e0 67 73 20 3d 20 70 4c 65 76 65 6c 2d 3e 70 57 4c gs = pLevel->pWL
2d9f0 6f 6f 70 2d 3e 77 73 46 6c 61 67 73 3b 0a 23 69 oop->wsFlags;.#i
2da00 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
2da10 54 5f 41 55 54 4f 4d 41 54 49 43 5f 49 4e 44 45 T_AUTOMATIC_INDE
2da20 58 0a 20 20 20 20 69 66 28 20 28 70 4c 65 76 65 X. if( (pLeve
2da30 6c 2d 3e 70 57 4c 6f 6f 70 2d 3e 77 73 46 6c 61 l->pWLoop->wsFla
2da40 67 73 20 26 20 57 48 45 52 45 5f 41 55 54 4f 5f gs & WHERE_AUTO_
2da50 49 4e 44 45 58 29 21 3d 30 20 29 7b 0a 20 20 20 INDEX)!=0 ){.
2da60 20 20 20 63 6f 6e 73 74 72 75 63 74 41 75 74 6f constructAuto
2da70 6d 61 74 69 63 49 6e 64 65 78 28 70 50 61 72 73 maticIndex(pPars
2da80 65 2c 20 26 70 57 49 6e 66 6f 2d 3e 73 57 43 2c e, &pWInfo->sWC,
2da90 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2daa0 20 26 70 54 61 62 4c 69 73 74 2d 3e 61 5b 70 4c &pTabList->a[pL
2dab0 65 76 65 6c 2d 3e 69 46 72 6f 6d 5d 2c 20 6e 6f evel->iFrom], no
2dac0 74 52 65 61 64 79 2c 20 70 4c 65 76 65 6c 29 3b tReady, pLevel);
2dad0 0a 20 20 20 20 20 20 69 66 28 20 64 62 2d 3e 6d . if( db->m
2dae0 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 20 67 6f allocFailed ) go
2daf0 74 6f 20 77 68 65 72 65 42 65 67 69 6e 45 72 72 to whereBeginErr
2db00 6f 72 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 or;. }.#endif
2db10 0a 20 20 20 20 61 64 64 72 45 78 70 6c 61 69 6e . addrExplain
2db20 20 3d 20 73 71 6c 69 74 65 33 57 68 65 72 65 45 = sqlite3WhereE
2db30 78 70 6c 61 69 6e 4f 6e 65 53 63 61 6e 28 0a 20 xplainOneScan(.
2db40 20 20 20 20 20 20 20 70 50 61 72 73 65 2c 20 70 pParse, p
2db50 54 61 62 4c 69 73 74 2c 20 70 4c 65 76 65 6c 2c TabList, pLevel,
2db60 20 69 69 2c 20 70 4c 65 76 65 6c 2d 3e 69 46 72 ii, pLevel->iFr
2db70 6f 6d 2c 20 77 63 74 72 6c 46 6c 61 67 73 0a 20 om, wctrlFlags.
2db80 20 20 20 29 3b 0a 20 20 20 20 70 4c 65 76 65 6c );. pLevel
2db90 2d 3e 61 64 64 72 42 6f 64 79 20 3d 20 73 71 6c ->addrBody = sql
2dba0 69 74 65 33 56 64 62 65 43 75 72 72 65 6e 74 41 ite3VdbeCurrentA
2dbb0 64 64 72 28 76 29 3b 0a 20 20 20 20 6e 6f 74 52 ddr(v);. notR
2dbc0 65 61 64 79 20 3d 20 73 71 6c 69 74 65 33 57 68 eady = sqlite3Wh
2dbd0 65 72 65 43 6f 64 65 4f 6e 65 4c 6f 6f 70 53 74 ereCodeOneLoopSt
2dbe0 61 72 74 28 70 57 49 6e 66 6f 2c 20 69 69 2c 20 art(pWInfo, ii,
2dbf0 6e 6f 74 52 65 61 64 79 29 3b 0a 20 20 20 20 70 notReady);. p
2dc00 57 49 6e 66 6f 2d 3e 69 43 6f 6e 74 69 6e 75 65 WInfo->iContinue
2dc10 20 3d 20 70 4c 65 76 65 6c 2d 3e 61 64 64 72 43 = pLevel->addrC
2dc20 6f 6e 74 3b 0a 20 20 20 20 69 66 28 20 28 77 73 ont;. if( (ws
2dc30 46 6c 61 67 73 26 57 48 45 52 45 5f 4d 55 4c 54 Flags&WHERE_MULT
2dc40 49 5f 4f 52 29 3d 3d 30 20 26 26 20 28 77 63 74 I_OR)==0 && (wct
2dc50 72 6c 46 6c 61 67 73 26 57 48 45 52 45 5f 4f 52 rlFlags&WHERE_OR
2dc60 5f 53 55 42 43 4c 41 55 53 45 29 3d 3d 30 20 29 _SUBCLAUSE)==0 )
2dc70 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 57 {. sqlite3W
2dc80 68 65 72 65 41 64 64 53 63 61 6e 53 74 61 74 75 hereAddScanStatu
2dc90 73 28 76 2c 20 70 54 61 62 4c 69 73 74 2c 20 70 s(v, pTabList, p
2dca0 4c 65 76 65 6c 2c 20 61 64 64 72 45 78 70 6c 61 Level, addrExpla
2dcb0 69 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a in);. }. }..
2dcc0 20 20 2f 2a 20 44 6f 6e 65 2e 20 2a 2f 0a 20 20 /* Done. */.
2dcd0 56 64 62 65 4d 6f 64 75 6c 65 43 6f 6d 6d 65 6e VdbeModuleCommen
2dce0 74 28 28 76 2c 20 22 42 65 67 69 6e 20 57 48 45 t((v, "Begin WHE
2dcf0 52 45 2d 63 6f 72 65 22 29 29 3b 0a 20 20 72 65 RE-core"));. re
2dd00 74 75 72 6e 20 70 57 49 6e 66 6f 3b 0a 0a 20 20 turn pWInfo;..
2dd10 2f 2a 20 4a 75 6d 70 20 68 65 72 65 20 69 66 20 /* Jump here if
2dd20 6d 61 6c 6c 6f 63 20 66 61 69 6c 73 20 2a 2f 0a malloc fails */.
2dd30 77 68 65 72 65 42 65 67 69 6e 45 72 72 6f 72 3a whereBeginError:
2dd40 0a 20 20 69 66 28 20 70 57 49 6e 66 6f 20 29 7b . if( pWInfo ){
2dd50 0a 20 20 20 20 70 50 61 72 73 65 2d 3e 6e 51 75 . pParse->nQu
2dd60 65 72 79 4c 6f 6f 70 20 3d 20 70 57 49 6e 66 6f eryLoop = pWInfo
2dd70 2d 3e 73 61 76 65 64 4e 51 75 65 72 79 4c 6f 6f ->savedNQueryLoo
2dd80 70 3b 0a 20 20 20 20 77 68 65 72 65 49 6e 66 6f p;. whereInfo
2dd90 46 72 65 65 28 64 62 2c 20 70 57 49 6e 66 6f 29 Free(db, pWInfo)
2dda0 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 ;. }. return 0
2ddb0 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 47 65 6e 65 72 ;.}../*.** Gener
2ddc0 61 74 65 20 74 68 65 20 65 6e 64 20 6f 66 20 74 ate the end of t
2ddd0 68 65 20 57 48 45 52 45 20 6c 6f 6f 70 2e 20 20 he WHERE loop.
2dde0 53 65 65 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e 20 See comments on
2ddf0 0a 2a 2a 20 73 71 6c 69 74 65 33 57 68 65 72 65 .** sqlite3Where
2de00 42 65 67 69 6e 28 29 20 66 6f 72 20 61 64 64 69 Begin() for addi
2de10 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 tional informati
2de20 6f 6e 2e 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 on..*/.void sqli
2de30 74 65 33 57 68 65 72 65 45 6e 64 28 57 68 65 72 te3WhereEnd(Wher
2de40 65 49 6e 66 6f 20 2a 70 57 49 6e 66 6f 29 7b 0a eInfo *pWInfo){.
2de50 20 20 50 61 72 73 65 20 2a 70 50 61 72 73 65 20 Parse *pParse
2de60 3d 20 70 57 49 6e 66 6f 2d 3e 70 50 61 72 73 65 = pWInfo->pParse
2de70 3b 0a 20 20 56 64 62 65 20 2a 76 20 3d 20 70 50 ;. Vdbe *v = pP
2de80 61 72 73 65 2d 3e 70 56 64 62 65 3b 0a 20 20 69 arse->pVdbe;. i
2de90 6e 74 20 69 3b 0a 20 20 57 68 65 72 65 4c 65 76 nt i;. WhereLev
2dea0 65 6c 20 2a 70 4c 65 76 65 6c 3b 0a 20 20 57 68 el *pLevel;. Wh
2deb0 65 72 65 4c 6f 6f 70 20 2a 70 4c 6f 6f 70 3b 0a ereLoop *pLoop;.
2dec0 20 20 53 72 63 4c 69 73 74 20 2a 70 54 61 62 4c SrcList *pTabL
2ded0 69 73 74 20 3d 20 70 57 49 6e 66 6f 2d 3e 70 54 ist = pWInfo->pT
2dee0 61 62 4c 69 73 74 3b 0a 20 20 73 71 6c 69 74 65 abList;. sqlite
2def0 33 20 2a 64 62 20 3d 20 70 50 61 72 73 65 2d 3e 3 *db = pParse->
2df00 64 62 3b 0a 0a 20 20 2f 2a 20 47 65 6e 65 72 61 db;.. /* Genera
2df10 74 65 20 6c 6f 6f 70 20 74 65 72 6d 69 6e 61 74 te loop terminat
2df20 69 6f 6e 20 63 6f 64 65 2e 0a 20 20 2a 2f 0a 20 ion code.. */.
2df30 20 56 64 62 65 4d 6f 64 75 6c 65 43 6f 6d 6d 65 VdbeModuleComme
2df40 6e 74 28 28 76 2c 20 22 45 6e 64 20 57 48 45 52 nt((v, "End WHER
2df50 45 2d 63 6f 72 65 22 29 29 3b 0a 20 20 73 71 6c E-core"));. sql
2df60 69 74 65 33 45 78 70 72 43 61 63 68 65 43 6c 65 ite3ExprCacheCle
2df70 61 72 28 70 50 61 72 73 65 29 3b 0a 20 20 66 6f ar(pParse);. fo
2df80 72 28 69 3d 70 57 49 6e 66 6f 2d 3e 6e 4c 65 76 r(i=pWInfo->nLev
2df90 65 6c 2d 31 3b 20 69 3e 3d 30 3b 20 69 2d 2d 29 el-1; i>=0; i--)
2dfa0 7b 0a 20 20 20 20 69 6e 74 20 61 64 64 72 3b 0a {. int addr;.
2dfb0 20 20 20 20 70 4c 65 76 65 6c 20 3d 20 26 70 57 pLevel = &pW
2dfc0 49 6e 66 6f 2d 3e 61 5b 69 5d 3b 0a 20 20 20 20 Info->a[i];.
2dfd0 70 4c 6f 6f 70 20 3d 20 70 4c 65 76 65 6c 2d 3e pLoop = pLevel->
2dfe0 70 57 4c 6f 6f 70 3b 0a 20 20 20 20 69 66 28 20 pWLoop;. if(
2dff0 70 4c 65 76 65 6c 2d 3e 6f 70 21 3d 4f 50 5f 4e pLevel->op!=OP_N
2e000 6f 6f 70 20 29 7b 0a 23 69 66 6e 64 65 66 20 53 oop ){.#ifndef S
2e010 51 4c 49 54 45 5f 44 49 53 41 42 4c 45 5f 53 4b QLITE_DISABLE_SK
2e020 49 50 41 48 45 41 44 5f 44 49 53 54 49 4e 43 54 IPAHEAD_DISTINCT
2e030 0a 20 20 20 20 20 20 69 6e 74 20 61 64 64 72 53 . int addrS
2e040 65 65 6b 20 3d 20 30 3b 0a 20 20 20 20 20 20 49 eek = 0;. I
2e050 6e 64 65 78 20 2a 70 49 64 78 3b 0a 20 20 20 20 ndex *pIdx;.
2e060 20 20 69 6e 74 20 6e 3b 0a 20 20 20 20 20 20 69 int n;. i
2e070 66 28 20 70 57 49 6e 66 6f 2d 3e 65 44 69 73 74 f( pWInfo->eDist
2e080 69 6e 63 74 3d 3d 57 48 45 52 45 5f 44 49 53 54 inct==WHERE_DIST
2e090 49 4e 43 54 5f 4f 52 44 45 52 45 44 0a 20 20 20 INCT_ORDERED.
2e0a0 20 20 20 20 26 26 20 69 3d 3d 70 57 49 6e 66 6f && i==pWInfo
2e0b0 2d 3e 6e 4c 65 76 65 6c 2d 31 20 20 2f 2a 20 54 ->nLevel-1 /* T
2e0c0 69 63 6b 65 74 20 5b 65 66 39 33 31 38 37 35 37 icket [ef9318757
2e0d0 62 31 35 32 65 33 5d 20 32 30 31 37 2d 31 30 2d b152e3] 2017-10-
2e0e0 32 31 20 2a 2f 0a 20 20 20 20 20 20 20 26 26 20 21 */. &&
2e0f0 28 70 4c 6f 6f 70 2d 3e 77 73 46 6c 61 67 73 20 (pLoop->wsFlags
2e100 26 20 57 48 45 52 45 5f 49 4e 44 45 58 45 44 29 & WHERE_INDEXED)
2e110 21 3d 30 0a 20 20 20 20 20 20 20 26 26 20 28 70 !=0. && (p
2e120 49 64 78 20 3d 20 70 4c 6f 6f 70 2d 3e 75 2e 62 Idx = pLoop->u.b
2e130 74 72 65 65 2e 70 49 6e 64 65 78 29 2d 3e 68 61 tree.pIndex)->ha
2e140 73 53 74 61 74 31 0a 20 20 20 20 20 20 20 26 26 sStat1. &&
2e150 20 28 6e 20 3d 20 70 4c 6f 6f 70 2d 3e 75 2e 62 (n = pLoop->u.b
2e160 74 72 65 65 2e 6e 49 64 78 43 6f 6c 29 3e 30 0a tree.nIdxCol)>0.
2e170 20 20 20 20 20 20 20 26 26 20 70 49 64 78 2d 3e && pIdx->
2e180 61 69 52 6f 77 4c 6f 67 45 73 74 5b 6e 5d 3e 3d aiRowLogEst[n]>=
2e190 33 36 0a 20 20 20 20 20 20 29 7b 0a 20 20 20 20 36. ){.
2e1a0 20 20 20 20 69 6e 74 20 72 31 20 3d 20 70 50 61 int r1 = pPa
2e1b0 72 73 65 2d 3e 6e 4d 65 6d 2b 31 3b 0a 20 20 20 rse->nMem+1;.
2e1c0 20 20 20 20 20 69 6e 74 20 6a 2c 20 6f 70 3b 0a int j, op;.
2e1d0 20 20 20 20 20 20 20 20 66 6f 72 28 6a 3d 30 3b for(j=0;
2e1e0 20 6a 3c 6e 3b 20 6a 2b 2b 29 7b 0a 20 20 20 20 j<n; j++){.
2e1f0 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 sqlite3Vdb
2e200 65 41 64 64 4f 70 33 28 76 2c 20 4f 50 5f 43 6f eAddOp3(v, OP_Co
2e210 6c 75 6d 6e 2c 20 70 4c 65 76 65 6c 2d 3e 69 49 lumn, pLevel->iI
2e220 64 78 43 75 72 2c 20 6a 2c 20 72 31 2b 6a 29 3b dxCur, j, r1+j);
2e230 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
2e240 20 20 20 70 50 61 72 73 65 2d 3e 6e 4d 65 6d 20 pParse->nMem
2e250 2b 3d 20 6e 2b 31 3b 0a 20 20 20 20 20 20 20 20 += n+1;.
2e260 6f 70 20 3d 20 70 4c 65 76 65 6c 2d 3e 6f 70 3d op = pLevel->op=
2e270 3d 4f 50 5f 50 72 65 76 20 3f 20 4f 50 5f 53 65 =OP_Prev ? OP_Se
2e280 65 6b 4c 54 20 3a 20 4f 50 5f 53 65 65 6b 47 54 ekLT : OP_SeekGT
2e290 3b 0a 20 20 20 20 20 20 20 20 61 64 64 72 53 65 ;. addrSe
2e2a0 65 6b 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 ek = sqlite3Vdbe
2e2b0 41 64 64 4f 70 34 49 6e 74 28 76 2c 20 6f 70 2c AddOp4Int(v, op,
2e2c0 20 70 4c 65 76 65 6c 2d 3e 69 49 64 78 43 75 72 pLevel->iIdxCur
2e2d0 2c 20 30 2c 20 72 31 2c 20 6e 29 3b 0a 20 20 20 , 0, r1, n);.
2e2e0 20 20 20 20 20 56 64 62 65 43 6f 76 65 72 61 67 VdbeCoverag
2e2f0 65 49 66 28 76 2c 20 6f 70 3d 3d 4f 50 5f 53 65 eIf(v, op==OP_Se
2e300 65 6b 4c 54 29 3b 0a 20 20 20 20 20 20 20 20 56 ekLT);. V
2e310 64 62 65 43 6f 76 65 72 61 67 65 49 66 28 76 2c dbeCoverageIf(v,
2e320 20 6f 70 3d 3d 4f 50 5f 53 65 65 6b 47 54 29 3b op==OP_SeekGT);
2e330 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
2e340 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 VdbeAddOp2(v, OP
2e350 5f 47 6f 74 6f 2c 20 31 2c 20 70 4c 65 76 65 6c _Goto, 1, pLevel
2e360 2d 3e 70 32 29 3b 0a 20 20 20 20 20 20 7d 0a 23 ->p2);. }.#
2e370 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f endif /* SQLITE_
2e380 44 49 53 41 42 4c 45 5f 53 4b 49 50 41 48 45 41 DISABLE_SKIPAHEA
2e390 44 5f 44 49 53 54 49 4e 43 54 20 2a 2f 0a 20 20 D_DISTINCT */.
2e3a0 20 20 20 20 2f 2a 20 54 68 65 20 63 6f 6d 6d 6f /* The commo
2e3b0 6e 20 63 61 73 65 3a 20 41 64 76 61 6e 63 65 20 n case: Advance
2e3c0 74 6f 20 74 68 65 20 6e 65 78 74 20 72 6f 77 20 to the next row
2e3d0 2a 2f 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 */. sqlite3
2e3e0 56 64 62 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c VdbeResolveLabel
2e3f0 28 76 2c 20 70 4c 65 76 65 6c 2d 3e 61 64 64 72 (v, pLevel->addr
2e400 43 6f 6e 74 29 3b 0a 20 20 20 20 20 20 73 71 6c Cont);. sql
2e410 69 74 65 33 56 64 62 65 41 64 64 4f 70 33 28 76 ite3VdbeAddOp3(v
2e420 2c 20 70 4c 65 76 65 6c 2d 3e 6f 70 2c 20 70 4c , pLevel->op, pL
2e430 65 76 65 6c 2d 3e 70 31 2c 20 70 4c 65 76 65 6c evel->p1, pLevel
2e440 2d 3e 70 32 2c 20 70 4c 65 76 65 6c 2d 3e 70 33 ->p2, pLevel->p3
2e450 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 );. sqlite3
2e460 56 64 62 65 43 68 61 6e 67 65 50 35 28 76 2c 20 VdbeChangeP5(v,
2e470 70 4c 65 76 65 6c 2d 3e 70 35 29 3b 0a 20 20 20 pLevel->p5);.
2e480 20 20 20 56 64 62 65 43 6f 76 65 72 61 67 65 28 VdbeCoverage(
2e490 76 29 3b 0a 20 20 20 20 20 20 56 64 62 65 43 6f v);. VdbeCo
2e4a0 76 65 72 61 67 65 49 66 28 76 2c 20 70 4c 65 76 verageIf(v, pLev
2e4b0 65 6c 2d 3e 6f 70 3d 3d 4f 50 5f 4e 65 78 74 29 el->op==OP_Next)
2e4c0 3b 0a 20 20 20 20 20 20 56 64 62 65 43 6f 76 65 ;. VdbeCove
2e4d0 72 61 67 65 49 66 28 76 2c 20 70 4c 65 76 65 6c rageIf(v, pLevel
2e4e0 2d 3e 6f 70 3d 3d 4f 50 5f 50 72 65 76 29 3b 0a ->op==OP_Prev);.
2e4f0 20 20 20 20 20 20 56 64 62 65 43 6f 76 65 72 61 VdbeCovera
2e500 67 65 49 66 28 76 2c 20 70 4c 65 76 65 6c 2d 3e geIf(v, pLevel->
2e510 6f 70 3d 3d 4f 50 5f 56 4e 65 78 74 29 3b 0a 23 op==OP_VNext);.#
2e520 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 44 49 ifndef SQLITE_DI
2e530 53 41 42 4c 45 5f 53 4b 49 50 41 48 45 41 44 5f SABLE_SKIPAHEAD_
2e540 44 49 53 54 49 4e 43 54 0a 20 20 20 20 20 20 69 DISTINCT. i
2e550 66 28 20 61 64 64 72 53 65 65 6b 20 29 20 73 71 f( addrSeek ) sq
2e560 6c 69 74 65 33 56 64 62 65 4a 75 6d 70 48 65 72 lite3VdbeJumpHer
2e570 65 28 76 2c 20 61 64 64 72 53 65 65 6b 29 3b 0a e(v, addrSeek);.
2e580 23 65 6e 64 69 66 0a 20 20 20 20 7d 65 6c 73 65 #endif. }else
2e590 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 {. sqlite3V
2e5a0 64 62 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c 28 dbeResolveLabel(
2e5b0 76 2c 20 70 4c 65 76 65 6c 2d 3e 61 64 64 72 43 v, pLevel->addrC
2e5c0 6f 6e 74 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 ont);. }.
2e5d0 69 66 28 20 70 4c 6f 6f 70 2d 3e 77 73 46 6c 61 if( pLoop->wsFla
2e5e0 67 73 20 26 20 57 48 45 52 45 5f 49 4e 5f 41 42 gs & WHERE_IN_AB
2e5f0 4c 45 20 26 26 20 70 4c 65 76 65 6c 2d 3e 75 2e LE && pLevel->u.
2e600 69 6e 2e 6e 49 6e 3e 30 20 29 7b 0a 20 20 20 20 in.nIn>0 ){.
2e610 20 20 73 74 72 75 63 74 20 49 6e 4c 6f 6f 70 20 struct InLoop
2e620 2a 70 49 6e 3b 0a 20 20 20 20 20 20 69 6e 74 20 *pIn;. int
2e630 6a 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 j;. sqlite3
2e640 56 64 62 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c VdbeResolveLabel
2e650 28 76 2c 20 70 4c 65 76 65 6c 2d 3e 61 64 64 72 (v, pLevel->addr
2e660 4e 78 74 29 3b 0a 20 20 20 20 20 20 66 6f 72 28 Nxt);. for(
2e670 6a 3d 70 4c 65 76 65 6c 2d 3e 75 2e 69 6e 2e 6e j=pLevel->u.in.n
2e680 49 6e 2c 20 70 49 6e 3d 26 70 4c 65 76 65 6c 2d In, pIn=&pLevel-
2e690 3e 75 2e 69 6e 2e 61 49 6e 4c 6f 6f 70 5b 6a 2d >u.in.aInLoop[j-
2e6a0 31 5d 3b 20 6a 3e 30 3b 20 6a 2d 2d 2c 20 70 49 1]; j>0; j--, pI
2e6b0 6e 2d 2d 29 7b 0a 20 20 20 20 20 20 20 20 73 71 n--){. sq
2e6c0 6c 69 74 65 33 56 64 62 65 4a 75 6d 70 48 65 72 lite3VdbeJumpHer
2e6d0 65 28 76 2c 20 70 49 6e 2d 3e 61 64 64 72 49 6e e(v, pIn->addrIn
2e6e0 54 6f 70 2b 31 29 3b 0a 20 20 20 20 20 20 20 20 Top+1);.
2e6f0 69 66 28 20 70 49 6e 2d 3e 65 45 6e 64 4c 6f 6f if( pIn->eEndLoo
2e700 70 4f 70 21 3d 4f 50 5f 4e 6f 6f 70 20 29 7b 0a pOp!=OP_Noop ){.
2e710 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 sqlite
2e720 33 56 64 62 65 41 64 64 4f 70 32 28 76 2c 20 70 3VdbeAddOp2(v, p
2e730 49 6e 2d 3e 65 45 6e 64 4c 6f 6f 70 4f 70 2c 20 In->eEndLoopOp,
2e740 70 49 6e 2d 3e 69 43 75 72 2c 20 70 49 6e 2d 3e pIn->iCur, pIn->
2e750 61 64 64 72 49 6e 54 6f 70 29 3b 0a 20 20 20 20 addrInTop);.
2e760 20 20 20 20 20 20 56 64 62 65 43 6f 76 65 72 61 VdbeCovera
2e770 67 65 28 76 29 3b 0a 20 20 20 20 20 20 20 20 20 ge(v);.
2e780 20 56 64 62 65 43 6f 76 65 72 61 67 65 49 66 28 VdbeCoverageIf(
2e790 76 2c 20 70 49 6e 2d 3e 65 45 6e 64 4c 6f 6f 70 v, pIn->eEndLoop
2e7a0 4f 70 3d 3d 4f 50 5f 50 72 65 76 49 66 4f 70 65 Op==OP_PrevIfOpe
2e7b0 6e 29 3b 0a 20 20 20 20 20 20 20 20 20 20 56 64 n);. Vd
2e7c0 62 65 43 6f 76 65 72 61 67 65 49 66 28 76 2c 20 beCoverageIf(v,
2e7d0 70 49 6e 2d 3e 65 45 6e 64 4c 6f 6f 70 4f 70 3d pIn->eEndLoopOp=
2e7e0 3d 4f 50 5f 4e 65 78 74 49 66 4f 70 65 6e 29 3b =OP_NextIfOpen);
2e7f0 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
2e800 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 4a 75 sqlite3VdbeJu
2e810 6d 70 48 65 72 65 28 76 2c 20 70 49 6e 2d 3e 61 mpHere(v, pIn->a
2e820 64 64 72 49 6e 54 6f 70 2d 31 29 3b 0a 20 20 20 ddrInTop-1);.
2e830 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73 }. }. s
2e840 71 6c 69 74 65 33 56 64 62 65 52 65 73 6f 6c 76 qlite3VdbeResolv
2e850 65 4c 61 62 65 6c 28 76 2c 20 70 4c 65 76 65 6c eLabel(v, pLevel
2e860 2d 3e 61 64 64 72 42 72 6b 29 3b 0a 20 20 20 20 ->addrBrk);.
2e870 69 66 28 20 70 4c 65 76 65 6c 2d 3e 61 64 64 72 if( pLevel->addr
2e880 53 6b 69 70 20 29 7b 0a 20 20 20 20 20 20 73 71 Skip ){. sq
2e890 6c 69 74 65 33 56 64 62 65 47 6f 74 6f 28 76 2c lite3VdbeGoto(v,
2e8a0 20 70 4c 65 76 65 6c 2d 3e 61 64 64 72 53 6b 69 pLevel->addrSki
2e8b0 70 29 3b 0a 20 20 20 20 20 20 56 64 62 65 43 6f p);. VdbeCo
2e8c0 6d 6d 65 6e 74 28 28 76 2c 20 22 6e 65 78 74 20 mment((v, "next
2e8d0 73 6b 69 70 2d 73 63 61 6e 20 6f 6e 20 25 73 22 skip-scan on %s"
2e8e0 2c 20 70 4c 6f 6f 70 2d 3e 75 2e 62 74 72 65 65 , pLoop->u.btree
2e8f0 2e 70 49 6e 64 65 78 2d 3e 7a 4e 61 6d 65 29 29 .pIndex->zName))
2e900 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 ;. sqlite3V
2e910 64 62 65 4a 75 6d 70 48 65 72 65 28 76 2c 20 70 dbeJumpHere(v, p
2e920 4c 65 76 65 6c 2d 3e 61 64 64 72 53 6b 69 70 29 Level->addrSkip)
2e930 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 ;. sqlite3V
2e940 64 62 65 4a 75 6d 70 48 65 72 65 28 76 2c 20 70 dbeJumpHere(v, p
2e950 4c 65 76 65 6c 2d 3e 61 64 64 72 53 6b 69 70 2d Level->addrSkip-
2e960 32 29 3b 0a 20 20 20 20 7d 0a 23 69 66 6e 64 65 2);. }.#ifnde
2e970 66 20 53 51 4c 49 54 45 5f 4c 49 4b 45 5f 44 4f f SQLITE_LIKE_DO
2e980 45 53 4e 54 5f 4d 41 54 43 48 5f 42 4c 4f 42 53 ESNT_MATCH_BLOBS
2e990 0a 20 20 20 20 69 66 28 20 70 4c 65 76 65 6c 2d . if( pLevel-
2e9a0 3e 61 64 64 72 4c 69 6b 65 52 65 70 20 29 7b 0a >addrLikeRep ){.
2e9b0 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 sqlite3Vdb
2e9c0 65 41 64 64 4f 70 32 28 76 2c 20 4f 50 5f 44 65 eAddOp2(v, OP_De
2e9d0 63 72 4a 75 6d 70 5a 65 72 6f 2c 20 28 69 6e 74 crJumpZero, (int
2e9e0 29 28 70 4c 65 76 65 6c 2d 3e 69 4c 69 6b 65 52 )(pLevel->iLikeR
2e9f0 65 70 43 6e 74 72 3e 3e 31 29 2c 0a 20 20 20 20 epCntr>>1),.
2ea00 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2ea10 20 20 20 20 70 4c 65 76 65 6c 2d 3e 61 64 64 72 pLevel->addr
2ea20 4c 69 6b 65 52 65 70 29 3b 0a 20 20 20 20 20 20 LikeRep);.
2ea30 56 64 62 65 43 6f 76 65 72 61 67 65 28 76 29 3b VdbeCoverage(v);
2ea40 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20 20 . }.#endif.
2ea50 20 20 69 66 28 20 70 4c 65 76 65 6c 2d 3e 69 4c if( pLevel->iL
2ea60 65 66 74 4a 6f 69 6e 20 29 7b 0a 20 20 20 20 20 eftJoin ){.
2ea70 20 69 6e 74 20 77 73 20 3d 20 70 4c 6f 6f 70 2d int ws = pLoop-
2ea80 3e 77 73 46 6c 61 67 73 3b 0a 20 20 20 20 20 20 >wsFlags;.
2ea90 61 64 64 72 20 3d 20 73 71 6c 69 74 65 33 56 64 addr = sqlite3Vd
2eaa0 62 65 41 64 64 4f 70 31 28 76 2c 20 4f 50 5f 49 beAddOp1(v, OP_I
2eab0 66 50 6f 73 2c 20 70 4c 65 76 65 6c 2d 3e 69 4c fPos, pLevel->iL
2eac0 65 66 74 4a 6f 69 6e 29 3b 20 56 64 62 65 43 6f eftJoin); VdbeCo
2ead0 76 65 72 61 67 65 28 76 29 3b 0a 20 20 20 20 20 verage(v);.
2eae0 20 61 73 73 65 72 74 28 20 28 77 73 20 26 20 57 assert( (ws & W
2eaf0 48 45 52 45 5f 49 44 58 5f 4f 4e 4c 59 29 3d 3d HERE_IDX_ONLY)==
2eb00 30 20 7c 7c 20 28 77 73 20 26 20 57 48 45 52 45 0 || (ws & WHERE
2eb10 5f 49 4e 44 45 58 45 44 29 21 3d 30 20 29 3b 0a _INDEXED)!=0 );.
2eb20 20 20 20 20 20 20 69 66 28 20 28 77 73 20 26 20 if( (ws &
2eb30 57 48 45 52 45 5f 49 44 58 5f 4f 4e 4c 59 29 3d WHERE_IDX_ONLY)=
2eb40 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 =0 ){. as
2eb50 73 65 72 74 28 20 70 4c 65 76 65 6c 2d 3e 69 54 sert( pLevel->iT
2eb60 61 62 43 75 72 3d 3d 70 54 61 62 4c 69 73 74 2d abCur==pTabList-
2eb70 3e 61 5b 70 4c 65 76 65 6c 2d 3e 69 46 72 6f 6d >a[pLevel->iFrom
2eb80 5d 2e 69 43 75 72 73 6f 72 20 29 3b 0a 20 20 20 ].iCursor );.
2eb90 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 sqlite3Vdbe
2eba0 41 64 64 4f 70 31 28 76 2c 20 4f 50 5f 4e 75 6c AddOp1(v, OP_Nul
2ebb0 6c 52 6f 77 2c 20 70 4c 65 76 65 6c 2d 3e 69 54 lRow, pLevel->iT
2ebc0 61 62 43 75 72 29 3b 0a 20 20 20 20 20 20 7d 0a abCur);. }.
2ebd0 20 20 20 20 20 20 69 66 28 20 28 77 73 20 26 20 if( (ws &
2ebe0 57 48 45 52 45 5f 49 4e 44 45 58 45 44 29 20 0a WHERE_INDEXED) .
2ebf0 20 20 20 20 20 20 20 7c 7c 20 28 28 77 73 20 26 || ((ws &
2ec00 20 57 48 45 52 45 5f 4d 55 4c 54 49 5f 4f 52 29 WHERE_MULTI_OR)
2ec10 20 26 26 20 70 4c 65 76 65 6c 2d 3e 75 2e 70 43 && pLevel->u.pC
2ec20 6f 76 69 64 78 29 20 0a 20 20 20 20 20 20 29 7b ovidx) . ){
2ec30 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 . sqlite3
2ec40 56 64 62 65 41 64 64 4f 70 31 28 76 2c 20 4f 50 VdbeAddOp1(v, OP
2ec50 5f 4e 75 6c 6c 52 6f 77 2c 20 70 4c 65 76 65 6c _NullRow, pLevel
2ec60 2d 3e 69 49 64 78 43 75 72 29 3b 0a 20 20 20 20 ->iIdxCur);.
2ec70 20 20 7d 0a 20 20 20 20 20 20 69 66 28 20 70 4c }. if( pL
2ec80 65 76 65 6c 2d 3e 6f 70 3d 3d 4f 50 5f 52 65 74 evel->op==OP_Ret
2ec90 75 72 6e 20 29 7b 0a 20 20 20 20 20 20 20 20 73 urn ){. s
2eca0 71 6c 69 74 65 33 56 64 62 65 41 64 64 4f 70 32 qlite3VdbeAddOp2
2ecb0 28 76 2c 20 4f 50 5f 47 6f 73 75 62 2c 20 70 4c (v, OP_Gosub, pL
2ecc0 65 76 65 6c 2d 3e 70 31 2c 20 70 4c 65 76 65 6c evel->p1, pLevel
2ecd0 2d 3e 61 64 64 72 46 69 72 73 74 29 3b 0a 20 20 ->addrFirst);.
2ece0 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
2ecf0 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 47 6f sqlite3VdbeGo
2ed00 74 6f 28 76 2c 20 70 4c 65 76 65 6c 2d 3e 61 64 to(v, pLevel->ad
2ed10 64 72 46 69 72 73 74 29 3b 0a 20 20 20 20 20 20 drFirst);.
2ed20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 }. sqlite3V
2ed30 64 62 65 4a 75 6d 70 48 65 72 65 28 76 2c 20 61 dbeJumpHere(v, a
2ed40 64 64 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 ddr);. }.
2ed50 56 64 62 65 4d 6f 64 75 6c 65 43 6f 6d 6d 65 6e VdbeModuleCommen
2ed60 74 28 28 76 2c 20 22 45 6e 64 20 57 48 45 52 45 t((v, "End WHERE
2ed70 2d 6c 6f 6f 70 25 64 3a 20 25 73 22 2c 20 69 2c -loop%d: %s", i,
2ed80 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
2ed90 20 20 20 20 20 20 70 57 49 6e 66 6f 2d 3e 70 54 pWInfo->pT
2eda0 61 62 4c 69 73 74 2d 3e 61 5b 70 4c 65 76 65 6c abList->a[pLevel
2edb0 2d 3e 69 46 72 6f 6d 5d 2e 70 54 61 62 2d 3e 7a ->iFrom].pTab->z
2edc0 4e 61 6d 65 29 29 3b 0a 20 20 7d 0a 0a 20 20 2f Name));. }.. /
2edd0 2a 20 54 68 65 20 22 62 72 65 61 6b 22 20 70 6f * The "break" po
2ede0 69 6e 74 20 69 73 20 68 65 72 65 2c 20 6a 75 73 int is here, jus
2edf0 74 20 70 61 73 74 20 74 68 65 20 65 6e 64 20 6f t past the end o
2ee00 66 20 74 68 65 20 6f 75 74 65 72 20 6c 6f 6f 70 f the outer loop
2ee10 2e 0a 20 20 2a 2a 20 53 65 74 20 69 74 2e 0a 20 .. ** Set it..
2ee20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 56 64 62 */. sqlite3Vdb
2ee30 65 52 65 73 6f 6c 76 65 4c 61 62 65 6c 28 76 2c eResolveLabel(v,
2ee40 20 70 57 49 6e 66 6f 2d 3e 69 42 72 65 61 6b 29 pWInfo->iBreak)
2ee50 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 57 49 ;.. assert( pWI
2ee60 6e 66 6f 2d 3e 6e 4c 65 76 65 6c 3c 3d 70 54 61 nfo->nLevel<=pTa
2ee70 62 4c 69 73 74 2d 3e 6e 53 72 63 20 29 3b 0a 20 bList->nSrc );.
2ee80 20 66 6f 72 28 69 3d 30 2c 20 70 4c 65 76 65 6c for(i=0, pLevel
2ee90 3d 70 57 49 6e 66 6f 2d 3e 61 3b 20 69 3c 70 57 =pWInfo->a; i<pW
2eea0 49 6e 66 6f 2d 3e 6e 4c 65 76 65 6c 3b 20 69 2b Info->nLevel; i+
2eeb0 2b 2c 20 70 4c 65 76 65 6c 2b 2b 29 7b 0a 20 20 +, pLevel++){.
2eec0 20 20 69 6e 74 20 6b 2c 20 6c 61 73 74 3b 0a 20 int k, last;.
2eed0 20 20 20 56 64 62 65 4f 70 20 2a 70 4f 70 3b 0a VdbeOp *pOp;.
2eee0 20 20 20 20 49 6e 64 65 78 20 2a 70 49 64 78 20 Index *pIdx
2eef0 3d 20 30 3b 0a 20 20 20 20 73 74 72 75 63 74 20 = 0;. struct
2ef00 53 72 63 4c 69 73 74 5f 69 74 65 6d 20 2a 70 54 SrcList_item *pT
2ef10 61 62 49 74 65 6d 20 3d 20 26 70 54 61 62 4c 69 abItem = &pTabLi
2ef20 73 74 2d 3e 61 5b 70 4c 65 76 65 6c 2d 3e 69 46 st->a[pLevel->iF
2ef30 72 6f 6d 5d 3b 0a 20 20 20 20 54 61 62 6c 65 20 rom];. Table
2ef40 2a 70 54 61 62 20 3d 20 70 54 61 62 49 74 65 6d *pTab = pTabItem
2ef50 2d 3e 70 54 61 62 3b 0a 20 20 20 20 61 73 73 65 ->pTab;. asse
2ef60 72 74 28 20 70 54 61 62 21 3d 30 20 29 3b 0a 20 rt( pTab!=0 );.
2ef70 20 20 20 70 4c 6f 6f 70 20 3d 20 70 4c 65 76 65 pLoop = pLeve
2ef80 6c 2d 3e 70 57 4c 6f 6f 70 3b 0a 0a 20 20 20 20 l->pWLoop;..
2ef90 2f 2a 20 46 6f 72 20 61 20 63 6f 2d 72 6f 75 74 /* For a co-rout
2efa0 69 6e 65 2c 20 63 68 61 6e 67 65 20 61 6c 6c 20 ine, change all
2efb0 4f 50 5f 43 6f 6c 75 6d 6e 20 72 65 66 65 72 65 OP_Column refere
2efc0 6e 63 65 73 20 74 6f 20 74 68 65 20 74 61 62 6c nces to the tabl
2efd0 65 20 6f 66 0a 20 20 20 20 2a 2a 20 74 68 65 20 e of. ** the
2efe0 63 6f 2d 72 6f 75 74 69 6e 65 20 69 6e 74 6f 20 co-routine into
2eff0 4f 50 5f 43 6f 70 79 20 6f 66 20 72 65 73 75 6c OP_Copy of resul
2f000 74 20 63 6f 6e 74 61 69 6e 65 64 20 69 6e 20 61 t contained in a
2f010 20 72 65 67 69 73 74 65 72 2e 0a 20 20 20 20 2a register.. *
2f020 2a 20 4f 50 5f 52 6f 77 69 64 20 62 65 63 6f 6d * OP_Rowid becom
2f030 65 73 20 4f 50 5f 4e 75 6c 6c 2e 0a 20 20 20 20 es OP_Null..
2f040 2a 2f 0a 20 20 20 20 69 66 28 20 70 54 61 62 49 */. if( pTabI
2f050 74 65 6d 2d 3e 66 67 2e 76 69 61 43 6f 72 6f 75 tem->fg.viaCorou
2f060 74 69 6e 65 20 29 7b 0a 20 20 20 20 20 20 74 65 tine ){. te
2f070 73 74 63 61 73 65 28 20 70 50 61 72 73 65 2d 3e stcase( pParse->
2f080 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
2f090 20 29 3b 0a 20 20 20 20 20 20 74 72 61 6e 73 6c );. transl
2f0a0 61 74 65 43 6f 6c 75 6d 6e 54 6f 43 6f 70 79 28 ateColumnToCopy(
2f0b0 70 50 61 72 73 65 2c 20 70 4c 65 76 65 6c 2d 3e pParse, pLevel->
2f0c0 61 64 64 72 42 6f 64 79 2c 20 70 4c 65 76 65 6c addrBody, pLevel
2f0d0 2d 3e 69 54 61 62 43 75 72 2c 0a 20 20 20 20 20 ->iTabCur,.
2f0e0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
2f0f0 20 20 20 20 20 20 20 70 54 61 62 49 74 65 6d 2d pTabItem-
2f100 3e 72 65 67 52 65 73 75 6c 74 2c 20 30 29 3b 0a >regResult, 0);.
2f110 20 20 20 20 20 20 63 6f 6e 74 69 6e 75 65 3b 0a continue;.
2f120 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 49 66 }.. /* If
2f130 20 74 68 69 73 20 73 63 61 6e 20 75 73 65 73 20 this scan uses
2f140 61 6e 20 69 6e 64 65 78 2c 20 6d 61 6b 65 20 56 an index, make V
2f150 44 42 45 20 63 6f 64 65 20 73 75 62 73 74 69 74 DBE code substit
2f160 75 74 69 6f 6e 73 20 74 6f 20 72 65 61 64 20 64 utions to read d
2f170 61 74 61 0a 20 20 20 20 2a 2a 20 66 72 6f 6d 20 ata. ** from
2f180 74 68 65 20 69 6e 64 65 78 20 69 6e 73 74 65 61 the index instea
2f190 64 20 6f 66 20 66 72 6f 6d 20 74 68 65 20 74 61 d of from the ta
2f1a0 62 6c 65 20 77 68 65 72 65 20 70 6f 73 73 69 62 ble where possib
2f1b0 6c 65 2e 20 20 49 6e 20 73 6f 6d 65 20 63 61 73 le. In some cas
2f1c0 65 73 0a 20 20 20 20 2a 2a 20 74 68 69 73 20 6f es. ** this o
2f1d0 70 74 69 6d 69 7a 61 74 69 6f 6e 20 70 72 65 76 ptimization prev
2f1e0 65 6e 74 73 20 74 68 65 20 74 61 62 6c 65 20 66 ents the table f
2f1f0 72 6f 6d 20 65 76 65 72 20 62 65 69 6e 67 20 72 rom ever being r
2f200 65 61 64 2c 20 77 68 69 63 68 20 63 61 6e 0a 20 ead, which can.
2f210 20 20 20 2a 2a 20 79 69 65 6c 64 20 61 20 73 69 ** yield a si
2f220 67 6e 69 66 69 63 61 6e 74 20 70 65 72 66 6f 72 gnificant perfor
2f230 6d 61 6e 63 65 20 62 6f 6f 73 74 2e 0a 20 20 20 mance boost..
2f240 20 2a 2a 20 0a 20 20 20 20 2a 2a 20 43 61 6c 6c ** . ** Call
2f250 73 20 74 6f 20 74 68 65 20 63 6f 64 65 20 67 65 s to the code ge
2f260 6e 65 72 61 74 6f 72 20 69 6e 20 62 65 74 77 65 nerator in betwe
2f270 65 6e 20 73 71 6c 69 74 65 33 57 68 65 72 65 42 en sqlite3WhereB
2f280 65 67 69 6e 20 61 6e 64 0a 20 20 20 20 2a 2a 20 egin and. **
2f290 73 71 6c 69 74 65 33 57 68 65 72 65 45 6e 64 20 sqlite3WhereEnd
2f2a0 77 69 6c 6c 20 68 61 76 65 20 63 72 65 61 74 65 will have create
2f2b0 64 20 63 6f 64 65 20 74 68 61 74 20 72 65 66 65 d code that refe
2f2c0 72 65 6e 63 65 73 20 74 68 65 20 74 61 62 6c 65 rences the table
2f2d0 0a 20 20 20 20 2a 2a 20 64 69 72 65 63 74 6c 79 . ** directly
2f2e0 2e 20 20 54 68 69 73 20 6c 6f 6f 70 20 73 63 61 . This loop sca
2f2f0 6e 73 20 61 6c 6c 20 74 68 61 74 20 63 6f 64 65 ns all that code
2f300 20 6c 6f 6f 6b 69 6e 67 20 66 6f 72 20 6f 70 63 looking for opc
2f310 6f 64 65 73 0a 20 20 20 20 2a 2a 20 74 68 61 74 odes. ** that
2f320 20 72 65 66 65 72 65 6e 63 65 20 74 68 65 20 74 reference the t
2f330 61 62 6c 65 20 61 6e 64 20 63 6f 6e 76 65 72 74 able and convert
2f340 73 20 74 68 65 6d 20 69 6e 74 6f 20 6f 70 63 6f s them into opco
2f350 64 65 73 20 74 68 61 74 0a 20 20 20 20 2a 2a 20 des that. **
2f360 72 65 66 65 72 65 6e 63 65 20 74 68 65 20 69 6e reference the in
2f370 64 65 78 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 dex.. */.
2f380 69 66 28 20 70 4c 6f 6f 70 2d 3e 77 73 46 6c 61 if( pLoop->wsFla
2f390 67 73 20 26 20 28 57 48 45 52 45 5f 49 4e 44 45 gs & (WHERE_INDE
2f3a0 58 45 44 7c 57 48 45 52 45 5f 49 44 58 5f 4f 4e XED|WHERE_IDX_ON
2f3b0 4c 59 29 20 29 7b 0a 20 20 20 20 20 20 70 49 64 LY) ){. pId
2f3c0 78 20 3d 20 70 4c 6f 6f 70 2d 3e 75 2e 62 74 72 x = pLoop->u.btr
2f3d0 65 65 2e 70 49 6e 64 65 78 3b 0a 20 20 20 20 7d ee.pIndex;. }
2f3e0 65 6c 73 65 20 69 66 28 20 70 4c 6f 6f 70 2d 3e else if( pLoop->
2f3f0 77 73 46 6c 61 67 73 20 26 20 57 48 45 52 45 5f wsFlags & WHERE_
2f400 4d 55 4c 54 49 5f 4f 52 20 29 7b 0a 20 20 20 20 MULTI_OR ){.
2f410 20 20 70 49 64 78 20 3d 20 70 4c 65 76 65 6c 2d pIdx = pLevel-
2f420 3e 75 2e 70 43 6f 76 69 64 78 3b 0a 20 20 20 20 >u.pCovidx;.
2f430 7d 0a 20 20 20 20 69 66 28 20 70 49 64 78 0a 20 }. if( pIdx.
2f440 20 20 20 20 26 26 20 28 70 57 49 6e 66 6f 2d 3e && (pWInfo->
2f450 65 4f 6e 65 50 61 73 73 3d 3d 4f 4e 45 50 41 53 eOnePass==ONEPAS
2f460 53 5f 4f 46 46 20 7c 7c 20 21 48 61 73 52 6f 77 S_OFF || !HasRow
2f470 69 64 28 70 49 64 78 2d 3e 70 54 61 62 6c 65 29 id(pIdx->pTable)
2f480 29 0a 20 20 20 20 20 26 26 20 21 64 62 2d 3e 6d ). && !db->m
2f490 61 6c 6c 6f 63 46 61 69 6c 65 64 0a 20 20 20 20 allocFailed.
2f4a0 29 7b 0a 20 20 20 20 20 20 6c 61 73 74 20 3d 20 ){. last =
2f4b0 73 71 6c 69 74 65 33 56 64 62 65 43 75 72 72 65 sqlite3VdbeCurre
2f4c0 6e 74 41 64 64 72 28 76 29 3b 0a 20 20 20 20 20 ntAddr(v);.
2f4d0 20 6b 20 3d 20 70 4c 65 76 65 6c 2d 3e 61 64 64 k = pLevel->add
2f4e0 72 42 6f 64 79 3b 0a 20 20 20 20 20 20 70 4f 70 rBody;. pOp
2f4f0 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 47 65 = sqlite3VdbeGe
2f500 74 4f 70 28 76 2c 20 6b 29 3b 0a 20 20 20 20 20 tOp(v, k);.
2f510 20 66 6f 72 28 3b 20 6b 3c 6c 61 73 74 3b 20 6b for(; k<last; k
2f520 2b 2b 2c 20 70 4f 70 2b 2b 29 7b 0a 20 20 20 20 ++, pOp++){.
2f530 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 70 31 21 if( pOp->p1!
2f540 3d 70 4c 65 76 65 6c 2d 3e 69 54 61 62 43 75 72 =pLevel->iTabCur
2f550 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 ) continue;.
2f560 20 20 20 20 20 69 66 28 20 70 4f 70 2d 3e 6f 70 if( pOp->op
2f570 63 6f 64 65 3d 3d 4f 50 5f 43 6f 6c 75 6d 6e 0a code==OP_Column.
2f580 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e #ifdef SQLITE_EN
2f590 41 42 4c 45 5f 4f 46 46 53 45 54 5f 53 51 4c 5f ABLE_OFFSET_SQL_
2f5a0 46 55 4e 43 0a 20 20 20 20 20 20 20 20 20 7c 7c FUNC. ||
2f5b0 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 3d 3d 4f 50 pOp->opcode==OP
2f5c0 5f 4f 66 66 73 65 74 0a 23 65 6e 64 69 66 0a 20 _Offset.#endif.
2f5d0 20 20 20 20 20 20 20 29 7b 0a 20 20 20 20 20 20 ){.
2f5e0 20 20 20 20 69 6e 74 20 78 20 3d 20 70 4f 70 2d int x = pOp-
2f5f0 3e 70 32 3b 0a 20 20 20 20 20 20 20 20 20 20 61 >p2;. a
2f600 73 73 65 72 74 28 20 70 49 64 78 2d 3e 70 54 61 ssert( pIdx->pTa
2f610 62 6c 65 3d 3d 70 54 61 62 20 29 3b 0a 20 20 20 ble==pTab );.
2f620 20 20 20 20 20 20 20 69 66 28 20 21 48 61 73 52 if( !HasR
2f630 6f 77 69 64 28 70 54 61 62 29 20 29 7b 0a 20 20 owid(pTab) ){.
2f640 20 20 20 20 20 20 20 20 20 20 49 6e 64 65 78 20 Index
2f650 2a 70 50 6b 20 3d 20 73 71 6c 69 74 65 33 50 72 *pPk = sqlite3Pr
2f660 69 6d 61 72 79 4b 65 79 49 6e 64 65 78 28 70 54 imaryKeyIndex(pT
2f670 61 62 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 ab);.
2f680 20 78 20 3d 20 70 50 6b 2d 3e 61 69 43 6f 6c 75 x = pPk->aiColu
2f690 6d 6e 5b 78 5d 3b 0a 20 20 20 20 20 20 20 20 20 mn[x];.
2f6a0 20 20 20 61 73 73 65 72 74 28 20 78 3e 3d 30 20 assert( x>=0
2f6b0 29 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 );. }.
2f6c0 20 20 20 20 20 20 20 20 20 78 20 3d 20 73 71 6c x = sql
2f6d0 69 74 65 33 43 6f 6c 75 6d 6e 4f 66 49 6e 64 65 ite3ColumnOfInde
2f6e0 78 28 70 49 64 78 2c 20 78 29 3b 0a 20 20 20 20 x(pIdx, x);.
2f6f0 20 20 20 20 20 20 69 66 28 20 78 3e 3d 30 20 29 if( x>=0 )
2f700 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20 70 4f {. pO
2f710 70 2d 3e 70 32 20 3d 20 78 3b 0a 20 20 20 20 20 p->p2 = x;.
2f720 20 20 20 20 20 20 20 70 4f 70 2d 3e 70 31 20 3d pOp->p1 =
2f730 20 70 4c 65 76 65 6c 2d 3e 69 49 64 78 43 75 72 pLevel->iIdxCur
2f740 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 ;. }.
2f750 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
2f760 28 70 4c 6f 6f 70 2d 3e 77 73 46 6c 61 67 73 20 (pLoop->wsFlags
2f770 26 20 57 48 45 52 45 5f 49 44 58 5f 4f 4e 4c 59 & WHERE_IDX_ONLY
2f780 29 3d 3d 30 20 7c 7c 20 78 3e 3d 30 20 0a 20 20 )==0 || x>=0 .
2f790 20 20 20 20 20 20 20 20 20 20 20 20 7c 7c 20 70 || p
2f7a0 57 49 6e 66 6f 2d 3e 65 4f 6e 65 50 61 73 73 20 WInfo->eOnePass
2f7b0 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 );. }else
2f7c0 20 69 66 28 20 70 4f 70 2d 3e 6f 70 63 6f 64 65 if( pOp->opcode
2f7d0 3d 3d 4f 50 5f 52 6f 77 69 64 20 29 7b 0a 20 20 ==OP_Rowid ){.
2f7e0 20 20 20 20 20 20 20 20 70 4f 70 2d 3e 70 31 20 pOp->p1
2f7f0 3d 20 70 4c 65 76 65 6c 2d 3e 69 49 64 78 43 75 = pLevel->iIdxCu
2f800 72 3b 0a 20 20 20 20 20 20 20 20 20 20 70 4f 70 r;. pOp
2f810 2d 3e 6f 70 63 6f 64 65 20 3d 20 4f 50 5f 49 64 ->opcode = OP_Id
2f820 78 52 6f 77 69 64 3b 0a 20 20 20 20 20 20 20 20 xRowid;.
2f830 7d 65 6c 73 65 20 69 66 28 20 70 4f 70 2d 3e 6f }else if( pOp->o
2f840 70 63 6f 64 65 3d 3d 4f 50 5f 49 66 4e 75 6c 6c pcode==OP_IfNull
2f850 52 6f 77 20 29 7b 0a 20 20 20 20 20 20 20 20 20 Row ){.
2f860 20 70 4f 70 2d 3e 70 31 20 3d 20 70 4c 65 76 65 pOp->p1 = pLeve
2f870 6c 2d 3e 69 49 64 78 43 75 72 3b 0a 20 20 20 20 l->iIdxCur;.
2f880 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 }. }.
2f890 20 20 7d 0a 20 20 7d 0a 0a 20 20 2f 2a 20 46 69 }. }.. /* Fi
2f8a0 6e 61 6c 20 63 6c 65 61 6e 75 70 0a 20 20 2a 2f nal cleanup. */
2f8b0 0a 20 20 70 50 61 72 73 65 2d 3e 6e 51 75 65 72 . pParse->nQuer
2f8c0 79 4c 6f 6f 70 20 3d 20 70 57 49 6e 66 6f 2d 3e yLoop = pWInfo->
2f8d0 73 61 76 65 64 4e 51 75 65 72 79 4c 6f 6f 70 3b savedNQueryLoop;
2f8e0 0a 20 20 77 68 65 72 65 49 6e 66 6f 46 72 65 65 . whereInfoFree
2f8f0 28 64 62 2c 20 70 57 49 6e 66 6f 29 3b 0a 20 20 (db, pWInfo);.
2f900 72 65 74 75 72 6e 3b 0a 7d 0a return;.}.