/ Hex Artifact Content
Login

Artifact 36237f0607ca954ac13a4a0e2d2ac40c33bc6e032a5f55f431713061ef1625f9:


0000: 2f 2a 0a 2a 2a 20 32 30 31 37 20 4a 75 6c 79 20  /*.** 2017 July 
0010: 31 35 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74  15.**.** The aut
0020: 68 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f  hor disclaims co
0030: 70 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20  pyright to this 
0040: 73 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e  source code.  In
0050: 20 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c   place of.** a l
0060: 65 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72  egal notice, her
0070: 65 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a  e is a blessing:
0080: 0a 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f  .**.**    May yo
0090: 75 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f  u do good and no
00a0: 74 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61  t evil..**    Ma
00b0: 79 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69  y you find forgi
00c0: 76 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73  veness for yours
00d0: 65 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20  elf and forgive 
00e0: 6f 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61  others..**    Ma
00f0: 79 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65  y you share free
0100: 6c 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67  ly, never taking
0110: 20 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67   more than you g
0120: 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a  ive..**.********
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 0a 2a 2a 0a 2a 2a 20 54 68 69 73 20 66 69 6c  *.**.** This fil
0180: 65 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 69  e contains the i
0190: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66  mplementation of
01a0: 20 74 68 65 20 22 75 6e 69 6f 6e 76 74 61 62 22   the "unionvtab"
01b0: 20 61 6e 64 20 22 73 77 61 72 6d 76 74 61 62 22   and "swarmvtab"
01c0: 0a 2a 2a 20 76 69 72 74 75 61 6c 20 74 61 62 6c  .** virtual tabl
01d0: 65 73 2e 20 54 68 65 73 65 20 6d 6f 64 75 6c 65  es. These module
01e0: 73 20 70 72 6f 76 69 64 65 20 72 65 61 64 2d 6f  s provide read-o
01f0: 6e 6c 79 20 61 63 63 65 73 73 20 74 6f 20 6d 75  nly access to mu
0200: 6c 74 69 70 6c 65 20 74 61 62 6c 65 73 2c 0a 2a  ltiple tables,.*
0210: 2a 20 70 6f 73 73 69 62 6c 79 20 69 6e 20 6d 75  * possibly in mu
0220: 6c 74 69 70 6c 65 20 64 61 74 61 62 61 73 65 20  ltiple database 
0230: 66 69 6c 65 73 2c 20 76 69 61 20 61 20 73 69 6e  files, via a sin
0240: 67 6c 65 20 64 61 74 61 62 61 73 65 20 6f 62 6a  gle database obj
0250: 65 63 74 2e 0a 2a 2a 20 54 68 65 20 73 6f 75 72  ect..** The sour
0260: 63 65 20 74 61 62 6c 65 73 20 6d 75 73 74 20 68  ce tables must h
0270: 61 76 65 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e  ave the followin
0280: 67 20 63 68 61 72 61 63 74 65 72 69 73 74 69 63  g characteristic
0290: 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 54 68 65  s:.**.**   * The
02a0: 79 20 6d 75 73 74 20 61 6c 6c 20 62 65 20 72 6f  y must all be ro
02b0: 77 69 64 20 74 61 62 6c 65 73 20 28 6e 6f 74 20  wid tables (not 
02c0: 56 49 52 54 55 41 4c 20 6f 72 20 57 49 54 48 4f  VIRTUAL or WITHO
02d0: 55 54 20 52 4f 57 49 44 0a 2a 2a 20 20 20 20 20  UT ROWID.**     
02e0: 74 61 62 6c 65 73 20 6f 72 20 76 69 65 77 73 29  tables or views)
02f0: 2e 0a 2a 2a 0a 2a 2a 20 20 20 2a 20 45 61 63 68  ..**.**   * Each
0300: 20 74 61 62 6c 65 20 6d 75 73 74 20 68 61 76 65   table must have
0310: 20 74 68 65 20 73 61 6d 65 20 73 65 74 20 6f 66   the same set of
0320: 20 63 6f 6c 75 6d 6e 73 2c 20 64 65 63 6c 61 72   columns, declar
0330: 65 64 20 69 6e 0a 2a 2a 20 20 20 20 20 74 68 65  ed in.**     the
0340: 20 73 61 6d 65 20 6f 72 64 65 72 20 61 6e 64 20   same order and 
0350: 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 64 65  with the same de
0360: 63 6c 61 72 65 64 20 74 79 70 65 73 2e 0a 2a 2a  clared types..**
0370: 0a 2a 2a 20 20 20 2a 20 54 68 65 20 74 61 62 6c  .**   * The tabl
0380: 65 73 20 6d 75 73 74 20 6e 6f 74 20 66 65 61 74  es must not feat
0390: 75 72 65 20 61 20 75 73 65 72 2d 64 65 66 69 6e  ure a user-defin
03a0: 65 64 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 64 20  ed column named 
03b0: 22 5f 72 6f 77 69 64 5f 22 2e 0a 2a 2a 0a 2a 2a  "_rowid_"..**.**
03c0: 20 20 20 2a 20 45 61 63 68 20 74 61 62 6c 65 20     * Each table 
03d0: 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 61 20 64  must contain a d
03e0: 69 73 74 69 6e 63 74 20 72 61 6e 67 65 20 6f 66  istinct range of
03f0: 20 72 6f 77 69 64 20 76 61 6c 75 65 73 2e 0a 2a   rowid values..*
0400: 2a 0a 2a 2a 20 54 68 65 20 64 69 66 66 65 72 65  *.** The differe
0410: 6e 63 65 20 62 65 74 77 65 65 6e 20 74 68 65 20  nce between the 
0420: 74 77 6f 20 76 69 72 74 75 61 6c 20 74 61 62 6c  two virtual tabl
0430: 65 20 6d 6f 64 75 6c 65 73 20 69 73 20 74 68 61  e modules is tha
0440: 74 20 66 6f 72 20 0a 2a 2a 20 22 75 6e 69 6f 6e  t for .** "union
0450: 76 74 61 62 22 2c 20 61 6c 6c 20 73 6f 75 72 63  vtab", all sourc
0460: 65 20 74 61 62 6c 65 73 20 6d 75 73 74 20 62 65  e tables must be
0470: 20 6c 6f 63 61 74 65 64 20 69 6e 20 74 68 65 20   located in the 
0480: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 6f 72  main database or
0490: 0a 2a 2a 20 69 6e 20 64 61 74 61 62 61 73 65 73  .** in databases
04a0: 20 41 54 54 41 43 48 65 64 20 74 6f 20 74 68 65   ATTACHed to the
04b0: 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 20 62   main database b
04c0: 79 20 74 68 65 20 75 73 65 72 2e 20 46 6f 72 20  y the user. For 
04d0: 22 73 77 61 72 6d 76 74 61 62 22 2c 0a 2a 2a 20  "swarmvtab",.** 
04e0: 74 68 65 20 74 61 62 6c 65 73 20 6d 61 79 20 62  the tables may b
04f0: 65 20 6c 6f 63 61 74 65 64 20 69 6e 20 61 6e 79  e located in any
0500: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 6f   database file o
0510: 6e 20 64 69 73 6b 2e 20 54 68 65 20 22 73 77 61  n disk. The "swa
0520: 72 6d 76 74 61 62 22 0a 2a 2a 20 69 6d 70 6c 65  rmvtab".** imple
0530: 6d 65 6e 74 61 74 69 6f 6e 20 74 61 6b 65 73 20  mentation takes 
0540: 63 61 72 65 20 6f 66 20 6f 70 65 6e 69 6e 67 20  care of opening 
0550: 61 6e 64 20 63 6c 6f 73 69 6e 67 20 64 61 74 61  and closing data
0560: 62 61 73 65 20 66 69 6c 65 73 0a 2a 2a 20 61 75  base files.** au
0570: 74 6f 6d 61 74 69 63 61 6c 6c 79 2e 0a 2a 2a 0a  tomatically..**.
0580: 2a 2a 20 55 4e 49 4f 4e 56 54 41 42 0a 2a 2a 0a  ** UNIONVTAB.**.
0590: 2a 2a 20 20 20 41 20 22 75 6e 69 6f 6e 76 74 61  **   A "unionvta
05a0: 62 22 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65  b" virtual table
05b0: 20 69 73 20 63 72 65 61 74 65 64 20 61 73 20 66   is created as f
05c0: 6f 6c 6c 6f 77 73 3a 0a 2a 2a 0a 2a 2a 20 20 20  ollows:.**.**   
05d0: 20 20 43 52 45 41 54 45 20 56 49 52 54 55 41 4c    CREATE VIRTUAL
05e0: 20 54 41 42 4c 45 20 3c 6e 61 6d 65 3e 20 55 53   TABLE <name> US
05f0: 49 4e 47 20 75 6e 69 6f 6e 76 74 61 62 28 3c 73  ING unionvtab(<s
0600: 71 6c 2d 73 74 61 74 65 6d 65 6e 74 3e 29 3b 0a  ql-statement>);.
0610: 2a 2a 0a 2a 2a 20 20 20 54 68 65 20 69 6d 70 6c  **.**   The impl
0620: 65 6d 65 6e 74 61 74 69 6f 6e 20 65 76 61 6c 75  ementation evalu
0630: 74 65 73 20 3c 73 71 6c 20 73 74 61 74 65 6d 65  tes <sql stateme
0640: 6e 74 3e 20 77 68 65 6e 65 76 65 72 20 61 20 75  nt> whenever a u
0650: 6e 69 6f 6e 76 74 61 62 20 76 69 72 74 75 61 6c  nionvtab virtual
0660: 0a 2a 2a 20 20 20 74 61 62 6c 65 20 69 73 20 63  .**   table is c
0670: 72 65 61 74 65 64 20 6f 72 20 6f 70 65 6e 65 64  reated or opened
0680: 2e 20 49 74 20 73 68 6f 75 6c 64 20 72 65 74 75  . It should retu
0690: 72 6e 20 6f 6e 65 20 72 6f 77 20 66 6f 72 20 65  rn one row for e
06a0: 61 63 68 20 73 6f 75 72 63 65 0a 2a 2a 20 20 20  ach source.**   
06b0: 64 61 74 61 62 61 73 65 20 74 61 62 6c 65 2e 20  database table. 
06c0: 54 68 65 20 66 6f 75 72 20 63 6f 6c 75 6d 6e 73  The four columns
06d0: 20 72 65 71 75 69 72 65 64 20 6f 66 20 65 61 63   required of eac
06e0: 68 20 72 6f 77 20 61 72 65 3a 0a 2a 2a 0a 2a 2a  h row are:.**.**
06f0: 20 20 20 20 20 31 2e 20 54 68 65 20 6e 61 6d 65       1. The name
0700: 20 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65   of the database
0710: 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68 65 20   containing the 
0720: 74 61 62 6c 65 20 28 22 6d 61 69 6e 22 20 6f 72  table ("main" or
0730: 20 22 74 65 6d 70 22 20 6f 72 0a 2a 2a 20 20 20   "temp" or.**   
0740: 20 20 20 20 20 74 68 65 20 6e 61 6d 65 20 6f 66       the name of
0750: 20 61 6e 20 61 74 74 61 63 68 65 64 20 64 61 74   an attached dat
0760: 61 62 61 73 65 29 2e 20 4f 72 20 4e 55 4c 4c 20  abase). Or NULL 
0770: 74 6f 20 69 6e 64 69 63 61 74 65 20 74 68 61 74  to indicate that
0780: 20 61 6c 6c 0a 2a 2a 20 20 20 20 20 20 20 20 64   all.**        d
0790: 61 74 61 62 61 73 65 73 20 73 68 6f 75 6c 64 20  atabases should 
07a0: 62 65 20 73 65 61 72 63 68 65 64 20 66 6f 72 20  be searched for 
07b0: 74 68 65 20 74 61 62 6c 65 20 69 6e 20 74 68 65  the table in the
07c0: 20 75 73 75 61 6c 20 66 61 73 68 69 6f 6e 2e 0a   usual fashion..
07d0: 2a 2a 0a 2a 2a 20 20 20 20 20 32 2e 20 54 68 65  **.**     2. The
07e0: 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74   name of the dat
07f0: 61 62 61 73 65 20 74 61 62 6c 65 2e 0a 2a 2a 0a  abase table..**.
0800: 2a 2a 20 20 20 20 20 33 2e 20 54 68 65 20 73 6d  **     3. The sm
0810: 61 6c 6c 65 73 74 20 72 6f 77 69 64 20 69 6e 20  allest rowid in 
0820: 74 68 65 20 72 61 6e 67 65 20 6f 66 20 72 6f 77  the range of row
0830: 69 64 73 20 74 68 61 74 20 6d 61 79 20 62 65 20  ids that may be 
0840: 73 74 6f 72 65 64 20 69 6e 20 74 68 65 0a 2a 2a  stored in the.**
0850: 20 20 20 20 20 20 20 20 64 61 74 61 62 61 73 65          database
0860: 20 74 61 62 6c 65 20 28 61 6e 20 69 6e 74 65 67   table (an integ
0870: 65 72 29 2e 0a 2a 2a 0a 2a 2a 20 20 20 20 20 34  er)..**.**     4
0880: 2e 20 54 68 65 20 6c 61 72 67 65 73 74 20 72 6f  . The largest ro
0890: 77 69 64 20 69 6e 20 74 68 65 20 72 61 6e 67 65  wid in the range
08a0: 20 6f 66 20 72 6f 77 69 64 73 20 74 68 61 74 20   of rowids that 
08b0: 6d 61 79 20 62 65 20 73 74 6f 72 65 64 20 69 6e  may be stored in
08c0: 20 74 68 65 0a 2a 2a 20 20 20 20 20 20 20 20 64   the.**        d
08d0: 61 74 61 62 61 73 65 20 74 61 62 6c 65 20 28 61  atabase table (a
08e0: 6e 20 69 6e 74 65 67 65 72 29 2e 0a 2a 2a 0a 2a  n integer)..**.*
08f0: 2a 20 53 57 41 52 4d 56 54 41 42 0a 2a 2a 0a 2a  * SWARMVTAB.**.*
0900: 2a 20 20 4c 45 47 41 43 59 20 53 59 4e 54 41 58  *  LEGACY SYNTAX
0910: 3a 0a 2a 2a 0a 2a 2a 20 20 20 41 20 22 73 77 61  :.**.**   A "swa
0920: 72 6d 76 74 61 62 22 20 76 69 72 74 75 61 6c 20  rmvtab" virtual 
0930: 74 61 62 6c 65 20 69 73 20 63 72 65 61 74 65 64  table is created
0940: 20 73 69 6d 69 6c 61 72 6c 79 20 74 6f 20 61 20   similarly to a 
0950: 75 6e 69 6f 6e 76 74 61 62 20 74 61 62 6c 65 3a  unionvtab table:
0960: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 43 52 45 41 54  .**.**     CREAT
0970: 45 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20  E VIRTUAL TABLE 
0980: 3c 6e 61 6d 65 3e 0a 2a 2a 20 20 20 20 20 20 55  <name>.**      U
0990: 53 49 4e 47 20 73 77 61 72 6d 76 74 61 62 28 3c  SING swarmvtab(<
09a0: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 3e 2c 20  sql-statement>, 
09b0: 3c 63 61 6c 6c 62 61 63 6b 3e 29 3b 0a 2a 2a 0a  <callback>);.**.
09c0: 2a 2a 20 20 20 54 68 65 20 64 69 66 66 65 72 65  **   The differe
09d0: 6e 63 65 20 69 73 20 74 68 61 74 20 66 6f 72 20  nce is that for 
09e0: 61 20 73 77 61 72 6d 76 74 61 62 20 74 61 62 6c  a swarmvtab tabl
09f0: 65 2c 20 74 68 65 20 66 69 72 73 74 20 63 6f 6c  e, the first col
0a00: 75 6d 6e 20 72 65 74 75 72 6e 65 64 0a 2a 2a 20  umn returned.** 
0a10: 20 20 62 79 20 74 68 65 20 3c 73 71 6c 20 73 74    by the <sql st
0a20: 61 74 65 6d 65 6e 74 3e 20 6d 75 73 74 20 72 65  atement> must re
0a30: 74 75 72 6e 20 61 20 70 61 74 68 20 6f 72 20 55  turn a path or U
0a40: 52 49 20 74 68 61 74 20 63 61 6e 20 62 65 20 75  RI that can be u
0a50: 73 65 64 20 74 6f 20 6f 70 65 6e 0a 2a 2a 20 20  sed to open.**  
0a60: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
0a70: 6c 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 74 68  le containing th
0a80: 65 20 73 6f 75 72 63 65 20 74 61 62 6c 65 2e 20  e source table. 
0a90: 20 54 68 65 20 3c 63 61 6c 6c 62 61 63 6b 3e 20   The <callback> 
0aa0: 6f 70 74 69 6f 6e 0a 2a 2a 20 20 20 69 73 20 6f  option.**   is o
0ab0: 70 74 69 6f 6e 61 6c 2e 20 20 49 66 20 69 6e 63  ptional.  If inc
0ac0: 6c 75 64 65 64 2c 20 69 74 20 69 73 20 74 68 65  luded, it is the
0ad0: 20 6e 61 6d 65 20 6f 66 20 61 6e 20 61 70 70 6c   name of an appl
0ae0: 69 63 61 74 69 6f 6e 2d 64 65 66 69 6e 65 64 0a  ication-defined.
0af0: 2a 2a 20 20 20 53 51 4c 20 66 75 6e 63 74 69 6f  **   SQL functio
0b00: 6e 20 74 68 61 74 20 69 73 20 69 6e 76 6f 6b 65  n that is invoke
0b10: 64 20 77 69 74 68 20 74 68 65 20 55 52 49 20 6f  d with the URI o
0b20: 66 20 74 68 65 20 66 69 6c 65 2c 20 69 66 20 74  f the file, if t
0b30: 68 65 20 66 69 6c 65 0a 2a 2a 20 20 20 64 6f 65  he file.**   doe
0b40: 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 65 78  s not already ex
0b50: 69 73 74 20 6f 6e 20 64 69 73 6b 20 77 68 65 6e  ist on disk when
0b60: 20 72 65 71 75 69 72 65 64 20 62 79 20 73 77 61   required by swa
0b70: 72 6d 76 74 61 62 2e 0a 2a 2a 0a 2a 2a 20 20 4e  rmvtab..**.**  N
0b80: 45 57 20 53 59 4e 54 41 58 3a 0a 2a 2a 0a 2a 2a  EW SYNTAX:.**.**
0b90: 20 20 20 55 73 69 6e 67 20 74 68 65 20 6e 65 77     Using the new
0ba0: 20 73 79 6e 74 61 78 2c 20 61 20 73 77 61 72 6d   syntax, a swarm
0bb0: 76 74 61 62 20 74 61 62 6c 65 20 69 73 20 63 72  vtab table is cr
0bc0: 65 61 74 65 64 20 77 69 74 68 3a 0a 2a 2a 0a 2a  eated with:.**.*
0bd0: 2a 20 20 20 20 20 20 43 52 45 41 54 45 20 56 49  *      CREATE VI
0be0: 52 54 55 41 4c 20 54 41 42 4c 45 20 3c 6e 61 6d  RTUAL TABLE <nam
0bf0: 65 3e 20 55 53 49 4e 47 20 73 77 61 72 6d 76 74  e> USING swarmvt
0c00: 61 62 28 0a 2a 2a 20 20 20 20 20 20 20 20 3c 73  ab(.**        <s
0c10: 71 6c 2d 73 74 61 74 65 6d 65 6e 74 3e 20 5b 2c  ql-statement> [,
0c20: 20 3c 6f 70 74 69 6f 6e 73 3e 5d 0a 2a 2a 20 20   <options>].**  
0c30: 20 20 20 20 29 3b 0a 2a 2a 0a 2a 2a 20 20 20 77      );.**.**   w
0c40: 68 65 72 65 20 76 61 6c 69 64 20 3c 6f 70 74 69  here valid <opti
0c50: 6f 6e 73 3e 20 61 72 65 3a 0a 2a 2a 0a 2a 2a 20  ons> are:.**.** 
0c60: 20 20 20 20 20 6d 69 73 73 69 6e 67 3d 3c 75 64       missing=<ud
0c70: 66 2d 66 75 6e 63 74 69 6f 6e 2d 6e 61 6d 65 3e  f-function-name>
0c80: 0a 2a 2a 20 20 20 20 20 20 6f 70 65 6e 63 6c 6f  .**      openclo
0c90: 73 65 3d 3c 75 64 66 2d 66 75 6e 63 74 69 6f 6e  se=<udf-function
0ca0: 2d 6e 61 6d 65 3e 0a 2a 2a 20 20 20 20 20 20 6d  -name>.**      m
0cb0: 61 78 6f 70 65 6e 3d 3c 69 6e 74 65 67 65 72 3e  axopen=<integer>
0cc0: 0a 2a 2a 20 20 20 20 20 20 3c 73 71 6c 2d 70 61  .**      <sql-pa
0cd0: 72 61 6d 65 74 65 72 3e 3d 3c 74 65 78 74 2d 76  rameter>=<text-v
0ce0: 61 6c 75 65 3e 0a 2a 2a 0a 2a 2a 20 20 20 54 68  alue>.**.**   Th
0cf0: 65 20 3c 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74  e <sql-statement
0d00: 3e 20 6d 75 73 74 20 72 65 74 75 72 6e 20 74 68  > must return th
0d10: 65 20 73 61 6d 65 20 34 20 63 6f 6c 75 6d 6e 73  e same 4 columns
0d20: 20 61 73 20 66 6f 72 20 61 20 73 77 61 72 6d 76   as for a swarmv
0d30: 74 61 62 0a 2a 2a 20 20 20 74 61 62 6c 65 20 69  tab.**   table i
0d40: 6e 20 6c 65 67 61 63 79 20 6d 6f 64 65 2e 20 48  n legacy mode. H
0d50: 6f 77 65 76 65 72 2c 20 69 74 20 6d 61 79 20 61  owever, it may a
0d60: 6c 73 6f 20 72 65 74 75 72 6e 20 61 20 35 74 68  lso return a 5th
0d70: 20 63 6f 6c 75 6d 6e 20 2d 20 74 68 65 0a 2a 2a   column - the.**
0d80: 20 20 20 22 63 6f 6e 74 65 78 74 22 20 63 6f 6c     "context" col
0d90: 75 6d 6e 2e 20 54 68 65 20 74 65 78 74 20 76 61  umn. The text va
0da0: 6c 75 65 20 72 65 74 75 72 6e 65 64 20 69 6e 20  lue returned in 
0db0: 74 68 69 73 20 63 6f 6c 75 6d 6e 20 69 73 20 6e  this column is n
0dc0: 6f 74 20 75 73 65 64 0a 2a 2a 20 20 20 61 74 20  ot used.**   at 
0dd0: 61 6c 6c 20 62 79 20 74 68 65 20 73 77 61 72 6d  all by the swarm
0de0: 76 74 61 62 20 69 6d 70 6c 65 6d 65 6e 74 61 74  vtab implementat
0df0: 69 6f 6e 2c 20 65 78 63 65 70 74 20 74 68 61 74  ion, except that
0e00: 20 69 74 20 69 73 20 70 61 73 73 65 64 20 61 73   it is passed as
0e10: 0a 2a 2a 20 20 20 61 6e 20 61 64 64 69 74 69 6f  .**   an additio
0e20: 6e 61 6c 20 61 72 67 75 6d 65 6e 74 20 74 6f 20  nal argument to 
0e30: 74 68 65 20 74 77 6f 20 55 44 46 20 66 75 6e 63  the two UDF func
0e40: 74 69 6f 6e 73 20 74 68 61 74 20 6d 61 79 20 62  tions that may b
0e50: 65 20 69 6e 76 6f 6b 65 64 0a 2a 2a 20 20 20 28  e invoked.**   (
0e60: 73 65 65 20 62 65 6c 6f 77 29 2e 0a 2a 2a 0a 2a  see below)..**.*
0e70: 2a 20 20 20 54 68 65 20 22 6d 69 73 73 69 6e 67  *   The "missing
0e80: 22 20 6f 70 74 69 6f 6e 2c 20 69 66 20 70 72 65  " option, if pre
0e90: 73 65 6e 74 2c 20 73 70 65 63 69 66 69 65 73 20  sent, specifies 
0ea0: 74 68 65 20 6e 61 6d 65 20 6f 66 20 61 6e 20 53  the name of an S
0eb0: 51 4c 20 55 44 46 0a 2a 2a 20 20 20 66 75 6e 63  QL UDF.**   func
0ec0: 74 69 6f 6e 20 74 6f 20 62 65 20 69 6e 76 6f 6b  tion to be invok
0ed0: 65 64 20 69 66 20 61 20 64 61 74 61 62 61 73 65  ed if a database
0ee0: 20 66 69 6c 65 20 69 73 20 6e 6f 74 20 61 6c 72   file is not alr
0ef0: 65 61 64 79 20 70 72 65 73 65 6e 74 20 6f 6e 0a  eady present on.
0f00: 2a 2a 20 20 20 64 69 73 6b 20 77 68 65 6e 20 72  **   disk when r
0f10: 65 71 75 69 72 65 64 20 62 79 20 73 77 61 72 6d  equired by swarm
0f20: 76 74 61 62 2e 20 49 66 20 74 68 65 20 3c 73 71  vtab. If the <sq
0f30: 6c 2d 73 74 61 74 65 6d 65 6e 74 3e 20 64 69 64  l-statement> did
0f40: 20 6e 6f 74 20 70 72 6f 76 69 64 65 0a 2a 2a 20   not provide.** 
0f50: 20 20 61 20 63 6f 6e 74 65 78 74 20 63 6f 6c 75    a context colu
0f60: 6d 6e 2c 20 69 74 20 69 73 20 69 6e 76 6f 6b 65  mn, it is invoke
0f70: 64 20 61 73 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20  d as:.**.**     
0f80: 53 45 4c 45 43 54 20 3c 6d 69 73 73 69 6e 67 2d  SELECT <missing-
0f90: 75 64 66 3e 28 3c 64 61 74 61 62 61 73 65 20 66  udf>(<database f
0fa0: 69 6c 65 6e 61 6d 65 2f 75 72 69 3e 29 3b 0a 2a  ilename/uri>);.*
0fb0: 2a 0a 2a 2a 20 20 20 4f 72 2c 20 69 66 20 74 68  *.**   Or, if th
0fc0: 65 72 65 20 77 61 73 20 61 20 63 6f 6e 74 65 78  ere was a contex
0fd0: 74 20 63 6f 6c 75 6d 6e 3a 0a 2a 2a 0a 2a 2a 20  t column:.**.** 
0fe0: 20 20 20 20 53 45 4c 45 43 54 20 3c 6d 69 73 73      SELECT <miss
0ff0: 69 6e 67 2d 75 64 66 3e 28 3c 64 61 74 61 62 61  ing-udf>(<databa
1000: 73 65 20 66 69 6c 65 6e 61 6d 65 2f 75 72 69 3e  se filename/uri>
1010: 2c 20 3c 63 6f 6e 74 65 78 74 3e 29 3b 0a 2a 2a  , <context>);.**
1020: 0a 2a 2a 20 20 20 54 68 65 20 22 6f 70 65 6e 63  .**   The "openc
1030: 6c 6f 73 65 22 20 6f 70 74 69 6f 6e 20 6d 61 79  lose" option may
1040: 20 61 6c 73 6f 20 73 70 65 63 69 66 79 20 61 20   also specify a 
1050: 55 44 46 20 66 75 6e 63 74 69 6f 6e 2e 20 54 68  UDF function. Th
1060: 69 73 20 66 75 6e 63 74 69 6f 6e 0a 2a 2a 20 20  is function.**  
1070: 20 69 73 20 69 6e 76 6f 6b 65 64 20 72 69 67 68   is invoked righ
1080: 74 20 62 65 66 6f 72 65 20 73 77 61 72 6d 76 74  t before swarmvt
1090: 61 62 20 6f 70 65 6e 73 20 61 20 64 61 74 61 62  ab opens a datab
10a0: 61 73 65 2c 20 61 6e 64 20 72 69 67 68 74 20 61  ase, and right a
10b0: 66 74 65 72 0a 2a 2a 20 20 20 69 74 20 63 6c 6f  fter.**   it clo
10c0: 73 65 73 20 6f 6e 65 2e 20 54 68 65 20 66 69 72  ses one. The fir
10d0: 73 74 20 61 72 67 75 6d 65 6e 74 20 2d 20 6f 72  st argument - or
10e0: 20 66 69 72 73 74 20 74 77 6f 20 61 72 67 75 6d   first two argum
10f0: 65 6e 74 73 2c 20 69 66 0a 2a 2a 20 20 20 3c 73  ents, if.**   <s
1100: 71 6c 2d 73 74 61 74 65 6d 65 6e 74 3e 20 73 75  ql-statement> su
1110: 70 70 6c 69 65 64 20 74 68 65 20 63 6f 6e 74 65  pplied the conte
1120: 78 74 20 63 6f 6c 75 6d 6e 20 2d 20 69 73 20 74  xt column - is t
1130: 68 65 20 73 61 6d 65 20 61 73 20 66 6f 72 0a 2a  he same as for.*
1140: 2a 20 20 20 74 68 65 20 22 6d 69 73 73 69 6e 67  *   the "missing
1150: 22 20 55 44 46 2e 20 46 6f 6c 6c 6f 77 69 6e 67  " UDF. Following
1160: 20 74 68 69 73 2c 20 74 68 65 20 55 44 46 20 69   this, the UDF i
1170: 73 20 70 61 73 73 65 64 20 69 6e 74 65 67 65 72  s passed integer
1180: 20 76 61 6c 75 65 0a 2a 2a 20 20 20 30 20 62 65   value.**   0 be
1190: 66 6f 72 65 20 61 20 64 62 20 69 73 20 6f 70 65  fore a db is ope
11a0: 6e 65 64 2c 20 61 6e 64 20 31 20 72 69 67 68 74  ned, and 1 right
11b0: 20 61 66 74 65 72 20 69 74 20 69 73 20 63 6c 6f   after it is clo
11c0: 73 65 64 2e 20 49 66 20 62 6f 74 68 0a 2a 2a 20  sed. If both.** 
11d0: 20 20 61 20 6d 69 73 73 69 6e 67 20 61 6e 64 20    a missing and 
11e0: 6f 70 65 6e 63 6c 6f 73 65 20 55 44 46 20 69 73  openclose UDF is
11f0: 20 73 75 70 70 6c 69 65 64 2c 20 74 68 65 20 61   supplied, the a
1200: 70 70 6c 69 63 61 74 69 6f 6e 20 73 68 6f 75 6c  pplication shoul
1210: 64 20 65 78 70 65 63 74 0a 2a 2a 20 20 20 74 68  d expect.**   th
1220: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 65 71 75  e following sequ
1230: 65 6e 63 65 20 6f 66 20 63 61 6c 6c 73 20 28 66  ence of calls (f
1240: 6f 72 20 61 20 73 69 6e 67 6c 65 20 64 61 74 61  or a single data
1250: 62 61 73 65 29 3a 0a 2a 2a 0a 2a 2a 20 20 20 20  base):.**.**    
1260: 20 20 53 45 4c 45 43 54 20 3c 6f 70 65 6e 63 6c    SELECT <opencl
1270: 6f 73 65 2d 75 64 66 3e 28 3c 64 62 20 66 69 6c  ose-udf>(<db fil
1280: 65 6e 61 6d 65 3e 2c 20 3c 63 6f 6e 74 65 78 74  ename>, <context
1290: 3e 2c 20 30 29 3b 0a 2a 2a 20 20 20 20 20 20 69  >, 0);.**      i
12a0: 66 28 20 64 62 20 6e 6f 74 20 61 6c 72 65 61 64  f( db not alread
12b0: 79 20 6f 6e 20 64 69 73 6b 20 29 7b 0a 2a 2a 20  y on disk ){.** 
12c0: 20 20 20 20 20 20 20 20 20 53 45 4c 45 43 54 20           SELECT 
12d0: 3c 6d 69 73 73 69 6e 67 2d 75 64 66 3e 28 3c 64  <missing-udf>(<d
12e0: 62 20 66 69 6c 65 6e 61 6d 65 3e 2c 20 3c 63 6f  b filename>, <co
12f0: 6e 74 65 78 74 3e 29 3b 0a 2a 2a 20 20 20 20 20  ntext>);.**     
1300: 20 7d 0a 2a 2a 20 20 20 20 20 20 2e 2e 2e 20 73   }.**      ... s
1310: 77 61 72 6d 76 74 61 62 20 75 73 65 73 20 64 61  warmvtab uses da
1320: 74 61 62 61 73 65 20 2e 2e 2e 0a 2a 2a 20 20 20  tabase ....**   
1330: 20 20 20 53 45 4c 45 43 54 20 3c 6f 70 65 6e 63     SELECT <openc
1340: 6c 6f 73 65 2d 75 64 66 3e 28 3c 64 62 20 66 69  lose-udf>(<db fi
1350: 6c 65 6e 61 6d 65 3e 2c 20 3c 63 6f 6e 74 65 78  lename>, <contex
1360: 74 3e 2c 20 31 29 3b 0a 2a 2a 0a 2a 2a 20 20 20  t>, 1);.**.**   
1370: 54 68 65 20 22 6d 61 78 6f 70 65 6e 22 20 6f 70  The "maxopen" op
1380: 74 69 6f 6e 20 69 73 20 75 73 65 64 20 74 6f 20  tion is used to 
1390: 63 6f 6e 66 69 67 75 72 65 20 74 68 65 20 6d 61  configure the ma
13a0: 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66 0a  ximum number of.
13b0: 2a 2a 20 20 20 64 61 74 61 62 61 73 65 20 66 69  **   database fi
13c0: 6c 65 73 20 73 77 61 72 6d 76 74 61 62 20 77 69  les swarmvtab wi
13d0: 6c 6c 20 68 6f 6c 64 20 6f 70 65 6e 20 73 69 6d  ll hold open sim
13e0: 75 6c 74 61 6e 65 6f 75 73 6c 79 20 28 64 65 66  ultaneously (def
13f0: 61 75 6c 74 20 39 29 2e 0a 2a 2a 0a 2a 2a 20 20  ault 9)..**.**  
1400: 20 49 66 20 61 6e 20 6f 70 74 69 6f 6e 20 6e 61   If an option na
1410: 6d 65 20 62 65 67 69 6e 73 20 77 69 74 68 20 61  me begins with a
1420: 20 22 3a 22 20 63 68 61 72 61 63 74 65 72 2c 20   ":" character, 
1430: 74 68 65 6e 20 69 74 20 69 73 20 61 73 73 75 6d  then it is assum
1440: 65 64 0a 2a 2a 20 20 20 74 6f 20 62 65 20 61 6e  ed.**   to be an
1450: 20 53 51 4c 20 70 61 72 61 6d 65 74 65 72 2e 20   SQL parameter. 
1460: 49 6e 20 74 68 69 73 20 63 61 73 65 2c 20 74 68  In this case, th
1470: 65 20 73 70 65 63 69 66 69 65 64 20 74 65 78 74  e specified text
1480: 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 20 20 62   value is.**   b
1490: 6f 75 6e 64 20 74 6f 20 74 68 65 20 73 61 6d 65  ound to the same
14a0: 20 76 61 72 69 61 62 6c 65 20 6f 66 20 74 68 65   variable of the
14b0: 20 3c 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 3e   <sql-statement>
14c0: 20 62 65 66 6f 72 65 20 69 74 20 69 73 20 0a 2a   before it is .*
14d0: 2a 20 20 20 65 78 65 63 75 74 65 64 2e 20 49 74  *   executed. It
14e0: 20 69 73 20 61 6e 20 65 72 72 6f 72 20 6f 66 20   is an error of 
14f0: 74 68 65 20 6e 61 6d 65 64 20 53 51 4c 20 70 61  the named SQL pa
1500: 72 61 6d 65 74 65 72 20 64 6f 65 73 20 6e 6f 74  rameter does not
1510: 20 65 78 69 73 74 2e 0a 2a 2a 20 20 20 46 6f 72   exist..**   For
1520: 20 65 78 61 6d 70 6c 65 3a 0a 2a 2a 0a 2a 2a 20   example:.**.** 
1530: 20 20 20 20 43 52 45 41 54 45 20 56 49 52 54 55      CREATE VIRTU
1540: 41 4c 20 54 41 42 4c 45 20 73 77 61 72 6d 20 55  AL TABLE swarm U
1550: 53 49 4e 47 20 73 77 61 72 6d 76 74 61 62 28 0a  SING swarmvtab(.
1560: 2a 2a 20 20 20 20 20 20 20 27 53 45 4c 45 43 54  **       'SELECT
1570: 20 3a 70 61 74 68 20 7c 7c 20 6c 6f 63 61 6c 66   :path || localf
1580: 69 6c 65 2c 20 74 62 6c 2c 20 6d 69 6e 2c 20 6d  ile, tbl, min, m
1590: 61 78 20 46 52 4f 4d 20 73 77 61 72 6d 64 69 72  ax FROM swarmdir
15a0: 27 2c 0a 2a 2a 20 20 20 20 20 20 20 3a 70 61 74  ',.**       :pat
15b0: 68 3d 27 2f 68 6f 6d 65 2f 75 73 65 72 2f 64 61  h='/home/user/da
15c0: 74 61 62 61 73 65 73 2f 27 0a 2a 2a 20 20 20 20  tabases/'.**    
15d0: 20 20 20 6d 69 73 73 69 6e 67 3d 27 6d 69 73 73     missing='miss
15e0: 69 6e 67 5f 66 75 6e 63 27 0a 2a 2a 20 20 20 20  ing_func'.**    
15f0: 20 29 3b 0a 2a 2f 0a 0a 23 69 6e 63 6c 75 64 65   );.*/..#include
1600: 20 22 73 71 6c 69 74 65 33 65 78 74 2e 68 22 0a   "sqlite3ext.h".
1610: 53 51 4c 49 54 45 5f 45 58 54 45 4e 53 49 4f 4e  SQLITE_EXTENSION
1620: 5f 49 4e 49 54 31 0a 23 69 6e 63 6c 75 64 65 20  _INIT1.#include 
1630: 3c 61 73 73 65 72 74 2e 68 3e 0a 23 69 6e 63 6c  <assert.h>.#incl
1640: 75 64 65 20 3c 73 74 72 69 6e 67 2e 68 3e 0a 23  ude <string.h>.#
1650: 69 6e 63 6c 75 64 65 20 3c 73 74 64 6c 69 62 2e  include <stdlib.
1660: 68 3e 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49  h>..#ifndef SQLI
1670: 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41 4c 54  TE_OMIT_VIRTUALT
1680: 41 42 4c 45 0a 0a 2f 2a 0a 2a 2a 20 4c 61 72 67  ABLE../*.** Larg
1690: 65 73 74 20 61 6e 64 20 73 6d 61 6c 6c 65 73 74  est and smallest
16a0: 20 70 6f 73 73 69 62 6c 65 20 36 34 2d 62 69 74   possible 64-bit
16b0: 20 73 69 67 6e 65 64 20 69 6e 74 65 67 65 72 73   signed integers
16c0: 2e 20 54 68 65 73 65 20 6d 61 63 72 6f 73 0a 2a  . These macros.*
16d0: 2a 20 63 6f 70 69 65 64 20 66 72 6f 6d 20 73 71  * copied from sq
16e0: 6c 69 74 65 49 6e 74 2e 68 2e 0a 2a 2f 0a 23 69  liteInt.h..*/.#i
16f0: 66 6e 64 65 66 20 4c 41 52 47 45 53 54 5f 49 4e  fndef LARGEST_IN
1700: 54 36 34 0a 23 20 64 65 66 69 6e 65 20 4c 41 52  T64.# define LAR
1710: 47 45 53 54 5f 49 4e 54 36 34 20 20 28 30 78 66  GEST_INT64  (0xf
1720: 66 66 66 66 66 66 66 7c 28 28 28 73 71 6c 69 74  fffffff|(((sqlit
1730: 65 33 5f 69 6e 74 36 34 29 30 78 37 66 66 66 66  e3_int64)0x7ffff
1740: 66 66 66 29 3c 3c 33 32 29 29 0a 23 65 6e 64 69  fff)<<32)).#endi
1750: 66 0a 23 69 66 6e 64 65 66 20 53 4d 41 4c 4c 45  f.#ifndef SMALLE
1760: 53 54 5f 49 4e 54 36 34 0a 23 20 64 65 66 69 6e  ST_INT64.# defin
1770: 65 20 53 4d 41 4c 4c 45 53 54 5f 49 4e 54 36 34  e SMALLEST_INT64
1780: 20 28 28 28 73 71 6c 69 74 65 33 5f 69 6e 74 36   (((sqlite3_int6
1790: 34 29 2d 31 29 20 2d 20 4c 41 52 47 45 53 54 5f  4)-1) - LARGEST_
17a0: 49 4e 54 36 34 29 0a 23 65 6e 64 69 66 0a 0a 2f  INT64).#endif../
17b0: 2a 0a 2a 2a 20 54 68 65 20 66 6f 6c 6c 6f 77 69  *.** The followi
17c0: 6e 67 20 69 73 20 61 6c 73 6f 20 63 6f 70 69 65  ng is also copie
17d0: 64 20 66 72 6f 6d 20 73 71 6c 69 74 65 49 6e 74  d from sqliteInt
17e0: 2e 68 2e 20 54 6f 20 66 61 63 69 6c 69 74 61 74  .h. To facilitat
17f0: 65 20 63 6f 76 65 72 61 67 65 0a 2a 2a 20 74 65  e coverage.** te
1800: 73 74 69 6e 67 2e 0a 2a 2f 0a 23 69 66 6e 64 65  sting..*/.#ifnde
1810: 66 20 41 4c 57 41 59 53 0a 23 20 69 66 20 64 65  f ALWAYS.# if de
1820: 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 43 4f 56  fined(SQLITE_COV
1830: 45 52 41 47 45 5f 54 45 53 54 29 20 7c 7c 20 64  ERAGE_TEST) || d
1840: 65 66 69 6e 65 64 28 53 51 4c 49 54 45 5f 4d 55  efined(SQLITE_MU
1850: 54 41 54 49 4f 4e 5f 54 45 53 54 29 0a 23 20 20  TATION_TEST).#  
1860: 64 65 66 69 6e 65 20 41 4c 57 41 59 53 28 58 29  define ALWAYS(X)
1870: 20 20 20 20 20 20 28 31 29 0a 23 20 20 64 65 66        (1).#  def
1880: 69 6e 65 20 4e 45 56 45 52 28 58 29 20 20 20 20  ine NEVER(X)    
1890: 20 20 20 28 30 29 0a 23 20 65 6c 69 66 20 21 64     (0).# elif !d
18a0: 65 66 69 6e 65 64 28 4e 44 45 42 55 47 29 0a 23  efined(NDEBUG).#
18b0: 20 20 64 65 66 69 6e 65 20 41 4c 57 41 59 53 28    define ALWAYS(
18c0: 58 29 20 20 20 20 20 20 28 28 58 29 3f 31 3a 28  X)      ((X)?1:(
18d0: 61 73 73 65 72 74 28 30 29 2c 30 29 29 0a 23 20  assert(0),0)).# 
18e0: 20 64 65 66 69 6e 65 20 4e 45 56 45 52 28 58 29   define NEVER(X)
18f0: 20 20 20 20 20 20 20 28 28 58 29 3f 28 61 73 73         ((X)?(ass
1900: 65 72 74 28 30 29 2c 31 29 3a 30 29 0a 23 20 65  ert(0),1):0).# e
1910: 6c 73 65 0a 23 20 20 64 65 66 69 6e 65 20 41 4c  lse.#  define AL
1920: 57 41 59 53 28 58 29 20 20 20 20 20 20 28 58 29  WAYS(X)      (X)
1930: 0a 23 20 20 64 65 66 69 6e 65 20 4e 45 56 45 52  .#  define NEVER
1940: 28 58 29 20 20 20 20 20 20 20 28 58 29 0a 23 20  (X)       (X).# 
1950: 65 6e 64 69 66 0a 23 65 6e 64 69 66 0a 0a 2f 2a  endif.#endif../*
1960: 0a 2a 2a 20 54 68 65 20 73 77 61 72 6d 76 74 61  .** The swarmvta
1970: 62 20 6d 6f 64 75 6c 65 20 61 74 74 65 6d 70 74  b module attempt
1980: 73 20 74 6f 20 6b 65 65 70 20 74 68 65 20 6e 75  s to keep the nu
1990: 6d 62 65 72 20 6f 66 20 6f 70 65 6e 20 64 61 74  mber of open dat
19a0: 61 62 61 73 65 20 66 69 6c 65 73 0a 2a 2a 20 61  abase files.** a
19b0: 74 20 6f 72 20 62 65 6c 6f 77 20 74 68 69 73 20  t or below this 
19c0: 6c 69 6d 69 74 2e 20 54 68 69 73 20 6d 61 79 20  limit. This may 
19d0: 6e 6f 74 20 62 65 20 70 6f 73 73 69 62 6c 65 20  not be possible 
19e0: 69 66 20 74 68 65 72 65 20 61 72 65 20 74 6f 6f  if there are too
19f0: 20 6d 61 6e 79 0a 2a 2a 20 73 69 6d 75 6c 74 61   many.** simulta
1a00: 6e 65 6f 75 73 20 71 75 65 72 69 65 73 2e 0a 2a  neous queries..*
1a10: 2f 0a 23 64 65 66 69 6e 65 20 53 57 41 52 4d 56  /.#define SWARMV
1a20: 54 41 42 5f 4d 41 58 5f 4f 50 45 4e 20 39 0a 0a  TAB_MAX_OPEN 9..
1a30: 74 79 70 65 64 65 66 20 73 74 72 75 63 74 20 55  typedef struct U
1a40: 6e 69 6f 6e 43 73 72 20 55 6e 69 6f 6e 43 73 72  nionCsr UnionCsr
1a50: 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75 63 74  ;.typedef struct
1a60: 20 55 6e 69 6f 6e 54 61 62 20 55 6e 69 6f 6e 54   UnionTab UnionT
1a70: 61 62 3b 0a 74 79 70 65 64 65 66 20 73 74 72 75  ab;.typedef stru
1a80: 63 74 20 55 6e 69 6f 6e 53 72 63 20 55 6e 69 6f  ct UnionSrc Unio
1a90: 6e 53 72 63 3b 0a 0a 2f 2a 0a 2a 2a 20 45 61 63  nSrc;../*.** Eac
1aa0: 68 20 73 6f 75 72 63 65 20 74 61 62 6c 65 20 28  h source table (
1ab0: 72 6f 77 20 72 65 74 75 72 6e 65 64 20 62 79 20  row returned by 
1ac0: 74 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69  the initializati
1ad0: 6f 6e 20 71 75 65 72 79 29 20 69 73 20 0a 2a 2a  on query) is .**
1ae0: 20 72 65 70 72 65 73 65 6e 74 65 64 20 62 79 20   represented by 
1af0: 61 6e 20 69 6e 73 74 61 6e 63 65 20 6f 66 20 74  an instance of t
1b00: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 73 74 72  he following str
1b10: 75 63 74 75 72 65 20 73 74 6f 72 65 64 20 69 6e  ucture stored in
1b20: 20 74 68 65 0a 2a 2a 20 55 6e 69 6f 6e 54 61 62   the.** UnionTab
1b30: 2e 61 53 72 63 5b 5d 20 61 72 72 61 79 2e 0a 2a  .aSrc[] array..*
1b40: 2f 0a 73 74 72 75 63 74 20 55 6e 69 6f 6e 53 72  /.struct UnionSr
1b50: 63 20 7b 0a 20 20 63 68 61 72 20 2a 7a 44 62 3b  c {.  char *zDb;
1b60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1b70: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73        /* Databas
1b80: 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 73 6f 75  e containing sou
1b90: 72 63 65 20 74 61 62 6c 65 20 2a 2f 0a 20 20 63  rce table */.  c
1ba0: 68 61 72 20 2a 7a 54 61 62 3b 20 20 20 20 20 20  har *zTab;      
1bb0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
1bc0: 2a 20 53 6f 75 72 63 65 20 74 61 62 6c 65 20 6e  * Source table n
1bd0: 61 6d 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ame */.  sqlite3
1be0: 5f 69 6e 74 36 34 20 69 4d 69 6e 3b 20 20 20 20  _int64 iMin;    
1bf0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4d 69 6e 69           /* Mini
1c00: 6d 75 6d 20 72 6f 77 69 64 20 2a 2f 0a 20 20 73  mum rowid */.  s
1c10: 71 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 4d 61  qlite3_int64 iMa
1c20: 78 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  x;             /
1c30: 2a 20 4d 61 78 69 6d 75 6d 20 72 6f 77 69 64 20  * Maximum rowid 
1c40: 2a 2f 0a 0a 20 20 2f 2a 20 46 69 65 6c 64 73 20  */..  /* Fields 
1c50: 75 73 65 64 20 62 79 20 73 77 61 72 6d 76 74 61  used by swarmvta
1c60: 62 20 6f 6e 6c 79 20 2a 2f 0a 20 20 63 68 61 72  b only */.  char
1c70: 20 2a 7a 46 69 6c 65 3b 20 20 20 20 20 20 20 20   *zFile;        
1c80: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44              /* D
1c90: 61 74 61 62 61 73 65 20 66 69 6c 65 20 63 6f 6e  atabase file con
1ca0: 74 61 69 6e 69 6e 67 20 74 61 62 6c 65 20 7a 54  taining table zT
1cb0: 61 62 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 43  ab */.  char *zC
1cc0: 6f 6e 74 65 78 74 3b 20 20 20 20 20 20 20 20 20  ontext;         
1cd0: 20 20 20 20 20 20 20 20 2f 2a 20 43 6f 6e 74 65          /* Conte
1ce0: 78 74 20 73 74 72 69 6e 67 2c 20 69 66 20 61 6e  xt string, if an
1cf0: 79 20 2a 2f 0a 20 20 69 6e 74 20 6e 55 73 65 72  y */.  int nUser
1d00: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1d10: 20 20 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e         /* Curren
1d20: 74 20 6e 75 6d 62 65 72 20 6f 66 20 75 73 65 72  t number of user
1d30: 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a  s */.  sqlite3 *
1d40: 64 62 3b 20 20 20 20 20 20 20 20 20 20 20 20 20  db;             
1d50: 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61         /* Databa
1d60: 73 65 20 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 55  se handle */.  U
1d70: 6e 69 6f 6e 53 72 63 20 2a 70 4e 65 78 74 43 6c  nionSrc *pNextCl
1d80: 6f 73 61 62 6c 65 3b 20 20 20 20 20 20 20 20 2f  osable;        /
1d90: 2a 20 4e 65 78 74 20 69 6e 20 6c 69 73 74 20 6f  * Next in list o
1da0: 66 20 63 6c 6f 73 61 62 6c 65 20 73 6f 75 72 63  f closable sourc
1db0: 65 73 20 2a 2f 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20  es */.};../*.** 
1dc0: 56 69 72 74 75 61 6c 20 74 61 62 6c 65 20 20 74  Virtual table  t
1dd0: 79 70 65 20 66 6f 72 20 75 6e 69 6f 6e 20 76 74  ype for union vt
1de0: 61 62 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 55 6e  ab..*/.struct Un
1df0: 69 6f 6e 54 61 62 20 7b 0a 20 20 73 71 6c 69 74  ionTab {.  sqlit
1e00: 65 33 5f 76 74 61 62 20 62 61 73 65 3b 20 20 20  e3_vtab base;   
1e10: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 42 61             /* Ba
1e20: 73 65 20 63 6c 61 73 73 20 2d 20 6d 75 73 74 20  se class - must 
1e30: 62 65 20 66 69 72 73 74 20 2a 2f 0a 20 20 73 71  be first */.  sq
1e40: 6c 69 74 65 33 20 2a 64 62 3b 20 20 20 20 20 20  lite3 *db;      
1e50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
1e60: 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   Database handle
1e70: 20 2a 2f 0a 20 20 69 6e 74 20 62 53 77 61 72 6d   */.  int bSwarm
1e80: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
1e90: 20 20 20 20 20 20 2f 2a 20 31 20 66 6f 72 20 22        /* 1 for "
1ea0: 73 77 61 72 6d 76 74 61 62 22 2c 20 30 20 66 6f  swarmvtab", 0 fo
1eb0: 72 20 22 75 6e 69 6f 6e 76 74 61 62 22 20 2a 2f  r "unionvtab" */
1ec0: 0a 20 20 69 6e 74 20 69 50 4b 3b 20 20 20 20 20  .  int iPK;     
1ed0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1ee0: 20 20 20 2f 2a 20 49 4e 54 45 47 45 52 20 50 52     /* INTEGER PR
1ef0: 49 4d 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e  IMARY KEY column
1f00: 2c 20 6f 72 20 2d 31 20 2a 2f 0a 20 20 69 6e 74  , or -1 */.  int
1f10: 20 6e 53 72 63 3b 20 20 20 20 20 20 20 20 20 20   nSrc;          
1f20: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
1f30: 4e 75 6d 62 65 72 20 6f 66 20 65 6c 65 6d 65 6e  Number of elemen
1f40: 74 73 20 69 6e 20 74 68 65 20 61 53 72 63 5b 5d  ts in the aSrc[]
1f50: 20 61 72 72 61 79 20 2a 2f 0a 20 20 55 6e 69 6f   array */.  Unio
1f60: 6e 53 72 63 20 2a 61 53 72 63 3b 20 20 20 20 20  nSrc *aSrc;     
1f70: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 41              /* A
1f80: 72 72 61 79 20 6f 66 20 73 6f 75 72 63 65 20 74  rray of source t
1f90: 61 62 6c 65 73 2c 20 73 6f 72 74 65 64 20 62 79  ables, sorted by
1fa0: 20 72 6f 77 69 64 20 2a 2f 0a 0a 20 20 2f 2a 20   rowid */..  /* 
1fb0: 55 73 65 64 20 62 79 20 73 77 61 72 6d 76 74 61  Used by swarmvta
1fc0: 62 20 6f 6e 6c 79 20 2a 2f 0a 20 20 69 6e 74 20  b only */.  int 
1fd0: 62 48 61 73 43 6f 6e 74 65 78 74 3b 20 20 20 20  bHasContext;    
1fe0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 48              /* H
1ff0: 61 73 20 63 6f 6e 74 65 78 74 20 73 74 72 69 6e  as context strin
2000: 67 73 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 53  gs */.  char *zS
2010: 6f 75 72 63 65 53 74 72 3b 20 20 20 20 20 20 20  ourceStr;       
2020: 20 20 20 20 20 20 20 20 2f 2a 20 45 78 70 65 63          /* Expec
2030: 74 65 64 20 75 6e 69 6f 6e 53 6f 75 72 63 65 54  ted unionSourceT
2040: 6f 53 74 72 28 29 20 76 61 6c 75 65 20 2a 2f 0a  oStr() value */.
2050: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a    sqlite3_stmt *
2060: 70 4e 6f 74 46 6f 75 6e 64 3b 20 20 20 20 20 20  pNotFound;      
2070: 20 20 2f 2a 20 55 44 46 20 74 6f 20 69 6e 76 6f    /* UDF to invo
2080: 6b 65 20 69 66 20 66 69 6c 65 20 6e 6f 74 20 66  ke if file not f
2090: 6f 75 6e 64 20 6f 6e 20 6f 70 65 6e 20 2a 2f 0a  ound on open */.
20a0: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a    sqlite3_stmt *
20b0: 70 4f 70 65 6e 43 6c 6f 73 65 3b 20 20 20 20 20  pOpenClose;     
20c0: 20 20 2f 2a 20 55 44 46 20 74 6f 20 69 6e 76 6f    /* UDF to invo
20d0: 6b 65 20 6f 6e 20 6f 70 65 6e 20 61 6e 64 20 63  ke on open and c
20e0: 6c 6f 73 65 20 2a 2f 0a 0a 20 20 55 6e 69 6f 6e  lose */..  Union
20f0: 53 72 63 20 2a 70 43 6c 6f 73 61 62 6c 65 3b 20  Src *pClosable; 
2100: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 46 69             /* Fi
2110: 72 73 74 20 69 6e 20 6c 69 73 74 20 6f 66 20 63  rst in list of c
2120: 6c 6f 73 61 62 6c 65 20 73 6f 75 72 63 65 73 20  losable sources 
2130: 2a 2f 0a 20 20 69 6e 74 20 6e 4f 70 65 6e 3b 20  */.  int nOpen; 
2140: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
2150: 20 20 20 20 20 2f 2a 20 43 75 72 72 65 6e 74 20       /* Current 
2160: 6e 75 6d 62 65 72 20 6f 66 20 6f 70 65 6e 20 73  number of open s
2170: 6f 75 72 63 65 73 20 2a 2f 0a 20 20 69 6e 74 20  ources */.  int 
2180: 6e 4d 61 78 4f 70 65 6e 3b 20 20 20 20 20 20 20  nMaxOpen;       
2190: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4d              /* M
21a0: 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66  aximum number of
21b0: 20 6f 70 65 6e 20 73 6f 75 72 63 65 73 20 2a 2f   open sources */
21c0: 0a 7d 3b 0a 0a 2f 2a 0a 2a 2a 20 56 69 72 74 75  .};../*.** Virtu
21d0: 61 6c 20 74 61 62 6c 65 20 63 75 72 73 6f 72 20  al table cursor 
21e0: 74 79 70 65 20 66 6f 72 20 75 6e 69 6f 6e 20 76  type for union v
21f0: 74 61 62 2e 0a 2a 2f 0a 73 74 72 75 63 74 20 55  tab..*/.struct U
2200: 6e 69 6f 6e 43 73 72 20 7b 0a 20 20 73 71 6c 69  nionCsr {.  sqli
2210: 74 65 33 5f 76 74 61 62 5f 63 75 72 73 6f 72 20  te3_vtab_cursor 
2220: 62 61 73 65 3b 20 20 20 20 20 20 20 2f 2a 20 42  base;       /* B
2230: 61 73 65 20 63 6c 61 73 73 20 2d 20 6d 75 73 74  ase class - must
2240: 20 62 65 20 66 69 72 73 74 20 2a 2f 0a 20 20 73   be first */.  s
2250: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
2260: 6d 74 3b 20 20 20 20 20 20 20 20 20 20 20 20 2f  mt;            /
2270: 2a 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20  * SQL statement 
2280: 74 6f 20 72 75 6e 20 2a 2f 0a 0a 20 20 2f 2a 20  to run */..  /* 
2290: 55 73 65 64 20 62 79 20 73 77 61 72 6d 76 74 61  Used by swarmvta
22a0: 62 20 6f 6e 6c 79 20 2a 2f 0a 20 20 73 71 6c 69  b only */.  sqli
22b0: 74 65 33 5f 69 6e 74 36 34 20 69 4d 61 78 52 6f  te3_int64 iMaxRo
22c0: 77 69 64 3b 20 20 20 20 20 20 20 20 2f 2a 20 4c  wid;        /* L
22d0: 61 73 74 20 72 6f 77 69 64 20 74 6f 20 76 69 73  ast rowid to vis
22e0: 69 74 20 2a 2f 0a 20 20 69 6e 74 20 69 54 61 62  it */.  int iTab
22f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
2300: 20 20 20 20 20 20 20 20 2f 2a 20 49 6e 64 65 78          /* Index
2310: 20 6f 66 20 74 61 62 6c 65 20 72 65 61 64 20 62   of table read b
2320: 79 20 70 53 74 6d 74 20 2a 2f 0a 7d 3b 0a 0a 2f  y pStmt */.};../
2330: 2a 0a 2a 2a 20 47 69 76 65 6e 20 55 6e 69 6f 6e  *.** Given Union
2340: 54 61 62 20 74 61 62 6c 65 20 70 54 61 62 20 61  Tab table pTab a
2350: 6e 64 20 55 6e 69 6f 6e 53 72 63 20 6f 62 6a 65  nd UnionSrc obje
2360: 63 74 20 70 53 72 63 2c 20 72 65 74 75 72 6e 20  ct pSrc, return 
2370: 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20  the database.** 
2380: 68 61 6e 64 6c 65 20 74 68 61 74 20 73 68 6f 75  handle that shou
2390: 6c 64 20 62 65 20 75 73 65 64 20 74 6f 20 61 63  ld be used to ac
23a0: 63 65 73 73 20 74 68 65 20 74 61 62 6c 65 20 69  cess the table i
23b0: 64 65 6e 74 69 66 69 65 64 20 62 79 20 70 53 72  dentified by pSr
23c0: 63 2e 20 54 68 69 73 0a 2a 2a 20 69 73 20 74 68  c. This.** is th
23d0: 65 20 6d 61 69 6e 20 64 62 20 68 61 6e 64 6c 65  e main db handle
23e0: 20 66 6f 72 20 22 75 6e 69 6f 6e 76 74 61 62 22   for "unionvtab"
23f0: 20 74 61 62 6c 65 73 2c 20 6f 72 20 74 68 65 20   tables, or the 
2400: 73 6f 75 72 63 65 2d 73 70 65 63 69 66 69 63 20  source-specific 
2410: 0a 2a 2a 20 68 61 6e 64 6c 65 20 66 6f 72 20 22  .** handle for "
2420: 73 77 61 72 6d 76 74 61 62 22 2e 0a 2a 2f 0a 23  swarmvtab"..*/.#
2430: 64 65 66 69 6e 65 20 75 6e 69 6f 6e 47 65 74 44  define unionGetD
2440: 62 28 70 54 61 62 2c 20 70 53 72 63 29 20 28 28  b(pTab, pSrc) ((
2450: 70 54 61 62 29 2d 3e 62 53 77 61 72 6d 20 3f 20  pTab)->bSwarm ? 
2460: 28 70 53 72 63 29 2d 3e 64 62 20 3a 20 28 70 54  (pSrc)->db : (pT
2470: 61 62 29 2d 3e 64 62 29 0a 0a 2f 2a 0a 2a 2a 20  ab)->db)../*.** 
2480: 49 66 20 2a 70 52 63 20 69 73 20 6f 74 68 65 72  If *pRc is other
2490: 20 74 68 61 6e 20 53 51 4c 49 54 45 5f 4f 4b 20   than SQLITE_OK 
24a0: 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69  when this functi
24b0: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c 20 69 74  on is called, it
24c0: 0a 2a 2a 20 61 6c 77 61 79 73 20 72 65 74 75 72  .** always retur
24d0: 6e 73 20 4e 55 4c 4c 2e 20 4f 74 68 65 72 77 69  ns NULL. Otherwi
24e0: 73 65 2c 20 69 74 20 61 74 74 65 6d 70 74 73 20  se, it attempts 
24f0: 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 6e 64 20  to allocate and 
2500: 72 65 74 75 72 6e 0a 2a 2a 20 61 20 70 6f 69 6e  return.** a poin
2510: 74 65 72 20 74 6f 20 6e 42 79 74 65 20 62 79 74  ter to nByte byt
2520: 65 73 20 6f 66 20 7a 65 72 6f 65 64 20 6d 65 6d  es of zeroed mem
2530: 6f 72 79 2e 20 49 66 20 74 68 65 20 6d 65 6d 6f  ory. If the memo
2540: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 0a 2a 2a  ry allocation.**
2550: 20 69 73 20 61 74 74 65 6d 70 74 65 64 20 62 75   is attempted bu
2560: 74 20 66 61 69 6c 73 2c 20 4e 55 4c 4c 20 69 73  t fails, NULL is
2570: 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 2a 70   returned and *p
2580: 52 63 20 69 73 20 73 65 74 20 74 6f 20 0a 2a 2a  Rc is set to .**
2590: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 0a 2a   SQLITE_NOMEM..*
25a0: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 2a 75  /.static void *u
25b0: 6e 69 6f 6e 4d 61 6c 6c 6f 63 28 69 6e 74 20 2a  nionMalloc(int *
25c0: 70 52 63 2c 20 73 71 6c 69 74 65 33 5f 69 6e 74  pRc, sqlite3_int
25d0: 36 34 20 6e 42 79 74 65 29 7b 0a 20 20 76 6f 69  64 nByte){.  voi
25e0: 64 20 2a 70 52 65 74 3b 0a 20 20 61 73 73 65 72  d *pRet;.  asser
25f0: 74 28 20 6e 42 79 74 65 3e 30 20 29 3b 0a 20 20  t( nByte>0 );.  
2600: 69 66 28 20 2a 70 52 63 3d 3d 53 51 4c 49 54 45  if( *pRc==SQLITE
2610: 5f 4f 4b 20 29 7b 0a 20 20 20 20 70 52 65 74 20  _OK ){.    pRet 
2620: 3d 20 73 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63  = sqlite3_malloc
2630: 36 34 28 6e 42 79 74 65 29 3b 0a 20 20 20 20 69  64(nByte);.    i
2640: 66 28 20 70 52 65 74 20 29 7b 0a 20 20 20 20 20  f( pRet ){.     
2650: 20 6d 65 6d 73 65 74 28 70 52 65 74 2c 20 30 2c   memset(pRet, 0,
2660: 20 28 73 69 7a 65 5f 74 29 6e 42 79 74 65 29 3b   (size_t)nByte);
2670: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
2680: 20 20 2a 70 52 63 20 3d 20 53 51 4c 49 54 45 5f    *pRc = SQLITE_
2690: 4e 4f 4d 45 4d 3b 0a 20 20 20 20 7d 0a 20 20 7d  NOMEM;.    }.  }
26a0: 65 6c 73 65 7b 0a 20 20 20 20 70 52 65 74 20 3d  else{.    pRet =
26b0: 20 30 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e   0;.  }.  return
26c0: 20 70 52 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   pRet;.}../*.** 
26d0: 49 66 20 2a 70 52 63 20 69 73 20 6f 74 68 65 72  If *pRc is other
26e0: 20 74 68 61 6e 20 53 51 4c 49 54 45 5f 4f 4b 20   than SQLITE_OK 
26f0: 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69  when this functi
2700: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c 20 69 74  on is called, it
2710: 0a 2a 2a 20 61 6c 77 61 79 73 20 72 65 74 75 72  .** always retur
2720: 6e 73 20 4e 55 4c 4c 2e 20 4f 74 68 65 72 77 69  ns NULL. Otherwi
2730: 73 65 2c 20 69 74 20 61 74 74 65 6d 70 74 73 20  se, it attempts 
2740: 74 6f 20 61 6c 6c 6f 63 61 74 65 20 61 6e 64 20  to allocate and 
2750: 72 65 74 75 72 6e 0a 2a 2a 20 61 20 63 6f 70 79  return.** a copy
2760: 20 6f 66 20 74 68 65 20 6e 75 6c 2d 74 65 72 6d   of the nul-term
2770: 69 6e 61 74 65 64 20 73 74 72 69 6e 67 20 70 61  inated string pa
2780: 73 73 65 64 20 61 73 20 74 68 65 20 73 65 63 6f  ssed as the seco
2790: 6e 64 20 61 72 67 75 6d 65 6e 74 2e 0a 2a 2a 20  nd argument..** 
27a0: 49 66 20 74 68 65 20 61 6c 6c 6f 63 61 74 69 6f  If the allocatio
27b0: 6e 20 69 73 20 61 74 74 65 6d 70 74 65 64 20 62  n is attempted b
27c0: 75 74 20 66 61 69 6c 73 2c 20 4e 55 4c 4c 20 69  ut fails, NULL i
27d0: 73 20 72 65 74 75 72 6e 65 64 20 61 6e 64 20 2a  s returned and *
27e0: 70 52 63 20 69 73 20 0a 2a 2a 20 73 65 74 20 74  pRc is .** set t
27f0: 6f 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 2e 0a  o SQLITE_NOMEM..
2800: 2a 2f 0a 73 74 61 74 69 63 20 63 68 61 72 20 2a  */.static char *
2810: 75 6e 69 6f 6e 53 74 72 64 75 70 28 69 6e 74 20  unionStrdup(int 
2820: 2a 70 52 63 2c 20 63 6f 6e 73 74 20 63 68 61 72  *pRc, const char
2830: 20 2a 7a 49 6e 29 7b 0a 20 20 63 68 61 72 20 2a   *zIn){.  char *
2840: 7a 52 65 74 20 3d 20 30 3b 0a 20 20 69 66 28 20  zRet = 0;.  if( 
2850: 7a 49 6e 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  zIn ){.    sqlit
2860: 65 33 5f 69 6e 74 36 34 20 6e 42 79 74 65 20 3d  e3_int64 nByte =
2870: 20 73 74 72 6c 65 6e 28 7a 49 6e 29 20 2b 20 31   strlen(zIn) + 1
2880: 3b 0a 20 20 20 20 7a 52 65 74 20 3d 20 75 6e 69  ;.    zRet = uni
2890: 6f 6e 4d 61 6c 6c 6f 63 28 70 52 63 2c 20 6e 42  onMalloc(pRc, nB
28a0: 79 74 65 29 3b 0a 20 20 20 20 69 66 28 20 7a 52  yte);.    if( zR
28b0: 65 74 20 29 7b 0a 20 20 20 20 20 20 6d 65 6d 63  et ){.      memc
28c0: 70 79 28 7a 52 65 74 2c 20 7a 49 6e 2c 20 28 73  py(zRet, zIn, (s
28d0: 69 7a 65 5f 74 29 6e 42 79 74 65 29 3b 0a 20 20  ize_t)nByte);.  
28e0: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e    }.  }.  return
28f0: 20 7a 52 65 74 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20   zRet;.}../*.** 
2900: 49 66 20 74 68 65 20 66 69 72 73 74 20 63 68 61  If the first cha
2910: 72 61 63 74 65 72 20 6f 66 20 74 68 65 20 73 74  racter of the st
2920: 72 69 6e 67 20 70 61 73 73 65 64 20 61 73 20 74  ring passed as t
2930: 68 65 20 6f 6e 6c 79 20 61 72 67 75 6d 65 6e 74  he only argument
2940: 20 74 6f 20 74 68 69 73 0a 2a 2a 20 66 75 6e 63   to this.** func
2950: 74 69 6f 6e 20 69 73 20 6f 6e 65 20 6f 66 20 74  tion is one of t
2960: 68 65 20 34 20 74 68 61 74 20 6d 61 79 20 62 65  he 4 that may be
2970: 20 75 73 65 64 20 61 73 20 61 6e 20 6f 70 65 6e   used as an open
2980: 20 71 75 6f 74 65 20 63 68 61 72 61 63 74 65 72   quote character
2990: 0a 2a 2a 20 69 6e 20 53 51 4c 2c 20 74 68 69 73  .** in SQL, this
29a0: 20 66 75 6e 63 74 69 6f 6e 20 61 73 73 75 6d 65   function assume
29b0: 73 20 74 68 61 74 20 74 68 65 20 69 6e 70 75 74  s that the input
29c0: 20 69 73 20 61 20 77 65 6c 6c 2d 66 6f 72 6d 65   is a well-forme
29d0: 64 20 71 75 6f 74 65 64 20 53 51 4c 20 0a 2a 2a  d quoted SQL .**
29e0: 20 73 74 72 69 6e 67 2e 20 49 6e 20 74 68 69 73   string. In this
29f0: 20 63 61 73 65 20 74 68 65 20 73 74 72 69 6e 67   case the string
2a00: 20 69 73 20 64 65 71 75 6f 74 65 64 20 69 6e 20   is dequoted in 
2a10: 70 6c 61 63 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  place..**.** If 
2a20: 74 68 65 20 66 69 72 73 74 20 63 68 61 72 61 63  the first charac
2a30: 74 65 72 20 6f 66 20 74 68 65 20 69 6e 70 75 74  ter of the input
2a40: 20 69 73 20 6e 6f 74 20 61 6e 20 6f 70 65 6e 20   is not an open 
2a50: 71 75 6f 74 65 2c 20 74 68 65 6e 20 74 68 69 73  quote, then this
2a60: 0a 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  .** function is 
2a70: 61 20 6e 6f 2d 6f 70 2e 0a 2a 2f 0a 73 74 61 74  a no-op..*/.stat
2a80: 69 63 20 76 6f 69 64 20 75 6e 69 6f 6e 44 65 71  ic void unionDeq
2a90: 75 6f 74 65 28 63 68 61 72 20 2a 7a 29 7b 0a 20  uote(char *z){. 
2aa0: 20 69 66 28 20 7a 20 29 7b 0a 20 20 20 20 63 68   if( z ){.    ch
2ab0: 61 72 20 71 20 3d 20 7a 5b 30 5d 3b 0a 0a 20 20  ar q = z[0];..  
2ac0: 20 20 2f 2a 20 53 65 74 20 73 74 61 63 6b 20 76    /* Set stack v
2ad0: 61 72 69 61 62 6c 65 20 71 20 74 6f 20 74 68 65  ariable q to the
2ae0: 20 63 6c 6f 73 65 2d 71 75 6f 74 65 20 63 68 61   close-quote cha
2af0: 72 61 63 74 65 72 20 2a 2f 0a 20 20 20 20 69 66  racter */.    if
2b00: 28 20 71 3d 3d 27 5b 27 20 7c 7c 20 71 3d 3d 27  ( q=='[' || q=='
2b10: 5c 27 27 20 7c 7c 20 71 3d 3d 27 22 27 20 7c 7c  \'' || q=='"' ||
2b20: 20 71 3d 3d 27 60 27 20 29 7b 0a 20 20 20 20 20   q=='`' ){.     
2b30: 20 69 6e 74 20 69 49 6e 20 3d 20 31 3b 0a 20 20   int iIn = 1;.  
2b40: 20 20 20 20 69 6e 74 20 69 4f 75 74 20 3d 20 30      int iOut = 0
2b50: 3b 0a 20 20 20 20 20 20 69 66 28 20 71 3d 3d 27  ;.      if( q=='
2b60: 5b 27 20 29 20 71 20 3d 20 27 5d 27 3b 20 20 0a  [' ) q = ']';  .
2b70: 20 20 20 20 20 20 77 68 69 6c 65 28 20 41 4c 57        while( ALW
2b80: 41 59 53 28 7a 5b 69 49 6e 5d 29 20 29 7b 0a 20  AYS(z[iIn]) ){. 
2b90: 20 20 20 20 20 20 20 69 66 28 20 7a 5b 69 49 6e         if( z[iIn
2ba0: 5d 3d 3d 71 20 29 7b 0a 20 20 20 20 20 20 20 20  ]==q ){.        
2bb0: 20 20 69 66 28 20 7a 5b 69 49 6e 2b 31 5d 21 3d    if( z[iIn+1]!=
2bc0: 71 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20  q ){.           
2bd0: 20 2f 2a 20 43 68 61 72 61 63 74 65 72 20 69 49   /* Character iI
2be0: 6e 20 77 61 73 20 74 68 65 20 63 6c 6f 73 65 20  n was the close 
2bf0: 71 75 6f 74 65 2e 20 2a 2f 0a 20 20 20 20 20 20  quote. */.      
2c00: 20 20 20 20 20 20 69 49 6e 2b 2b 3b 0a 20 20 20        iIn++;.   
2c10: 20 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a           break;.
2c20: 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b            }else{
2c30: 0a 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  .            /* 
2c40: 43 68 61 72 61 63 74 65 72 20 69 49 6e 20 61 6e  Character iIn an
2c50: 64 20 69 49 6e 2b 31 20 66 6f 72 6d 20 61 6e 20  d iIn+1 form an 
2c60: 65 73 63 61 70 65 64 20 71 75 6f 74 65 20 63 68  escaped quote ch
2c70: 61 72 61 63 74 65 72 2e 20 53 6b 69 70 0a 20 20  aracter. Skip.  
2c80: 20 20 20 20 20 20 20 20 20 20 2a 2a 20 74 68 65            ** the
2c90: 20 69 6e 70 75 74 20 63 75 72 73 6f 72 20 70 61   input cursor pa
2ca0: 73 74 20 62 6f 74 68 20 61 6e 64 20 63 6f 70 79  st both and copy
2cb0: 20 61 20 73 69 6e 67 6c 65 20 71 75 6f 74 65 20   a single quote 
2cc0: 63 68 61 72 61 63 74 65 72 20 0a 20 20 20 20 20  character .     
2cd0: 20 20 20 20 20 20 20 2a 2a 20 74 6f 20 74 68 65         ** to the
2ce0: 20 6f 75 74 70 75 74 20 62 75 66 66 65 72 2e 20   output buffer. 
2cf0: 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 69  */.            i
2d00: 49 6e 20 2b 3d 20 32 3b 0a 20 20 20 20 20 20 20  In += 2;.       
2d10: 20 20 20 20 20 7a 5b 69 4f 75 74 2b 2b 5d 20 3d       z[iOut++] =
2d20: 20 71 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a   q;.          }.
2d30: 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20          }else{. 
2d40: 20 20 20 20 20 20 20 20 20 7a 5b 69 4f 75 74 2b           z[iOut+
2d50: 2b 5d 20 3d 20 7a 5b 69 49 6e 2b 2b 5d 3b 0a 20  +] = z[iIn++];. 
2d60: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d         }.      }
2d70: 0a 20 20 20 20 20 20 7a 5b 69 4f 75 74 5d 20 3d  .      z[iOut] =
2d80: 20 27 5c 30 27 3b 0a 20 20 20 20 7d 0a 20 20 7d   '\0';.    }.  }
2d90: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
2da0: 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d  unction is a no-
2db0: 6f 70 20 69 66 20 2a 70 52 63 20 69 73 20 73 65  op if *pRc is se
2dc0: 74 20 74 6f 20 6f 74 68 65 72 20 74 68 61 6e 20  t to other than 
2dd0: 53 51 4c 49 54 45 5f 4f 4b 20 77 68 65 6e 20 69  SQLITE_OK when i
2de0: 74 0a 2a 2a 20 69 73 20 63 61 6c 6c 65 64 2e 20  t.** is called. 
2df0: 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65 64  NULL is returned
2e00: 20 69 6e 20 74 68 69 73 20 63 61 73 65 2e 0a 2a   in this case..*
2e10: 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20  *.** Otherwise, 
2e20: 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  the SQL statemen
2e30: 74 20 70 61 73 73 65 64 20 61 73 20 74 68 65 20  t passed as the 
2e40: 74 68 69 72 64 20 61 72 67 75 6d 65 6e 74 20 69  third argument i
2e50: 73 20 70 72 65 70 61 72 65 64 0a 2a 2a 20 61 67  s prepared.** ag
2e60: 61 69 6e 73 74 20 74 68 65 20 64 61 74 61 62 61  ainst the databa
2e70: 73 65 20 68 61 6e 64 6c 65 20 70 61 73 73 65 64  se handle passed
2e80: 20 61 73 20 74 68 65 20 73 65 63 6f 6e 64 2e 20   as the second. 
2e90: 49 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  If the statement
2ea0: 20 69 73 0a 2a 2a 20 73 75 63 63 65 73 73 66 75   is.** successfu
2eb0: 6c 6c 79 20 70 72 65 70 61 72 65 64 2c 20 61 20  lly prepared, a 
2ec0: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 6e  pointer to the n
2ed0: 65 77 20 73 74 61 74 65 6d 65 6e 74 20 68 61 6e  ew statement han
2ee0: 64 6c 65 20 69 73 20 0a 2a 2a 20 72 65 74 75 72  dle is .** retur
2ef0: 6e 65 64 2e 20 49 74 20 69 73 20 74 68 65 20 72  ned. It is the r
2f00: 65 73 70 6f 6e 73 69 62 69 6c 69 74 79 20 6f 66  esponsibility of
2f10: 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 65   the caller to e
2f20: 76 65 6e 74 75 61 6c 6c 79 20 66 72 65 65 20 74  ventually free t
2f30: 68 65 0a 2a 2a 20 73 74 61 74 65 6d 65 6e 74 20  he.** statement 
2f40: 62 79 20 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74  by calling sqlit
2f50: 65 33 5f 66 69 6e 61 6c 69 7a 65 28 29 2e 20 41  e3_finalize(). A
2f60: 6c 74 65 72 6e 61 74 69 76 65 6c 79 2c 20 69 66  lternatively, if
2f70: 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 63 6f   statement.** co
2f80: 6d 70 69 6c 61 74 69 6f 6e 20 66 61 69 6c 73 2c  mpilation fails,
2f90: 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65   NULL is returne
2fa0: 64 2c 20 2a 70 52 63 20 69 73 20 73 65 74 20 74  d, *pRc is set t
2fb0: 6f 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f  o an SQLite erro
2fc0: 72 0a 2a 2a 20 63 6f 64 65 20 61 6e 64 20 2a 70  r.** code and *p
2fd0: 7a 45 72 72 20 6d 61 79 20 62 65 20 73 65 74 20  zErr may be set 
2fe0: 74 6f 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73  to an error mess
2ff0: 61 67 65 20 62 75 66 66 65 72 20 61 6c 6c 6f 63  age buffer alloc
3000: 61 74 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74  ated by.** sqlit
3010: 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e 0a 2a 2f 0a  e3_malloc()..*/.
3020: 73 74 61 74 69 63 20 73 71 6c 69 74 65 33 5f 73  static sqlite3_s
3030: 74 6d 74 20 2a 75 6e 69 6f 6e 50 72 65 70 61 72  tmt *unionPrepar
3040: 65 28 0a 20 20 69 6e 74 20 2a 70 52 63 2c 20 20  e(.  int *pRc,  
3050: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3060: 20 20 20 20 20 2f 2a 20 49 4e 2f 4f 55 54 3a 20       /* IN/OUT: 
3070: 45 72 72 6f 72 20 63 6f 64 65 20 2a 2f 0a 20 20  Error code */.  
3080: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
3090: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
30a0: 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64  /* Database hand
30b0: 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  le */.  const ch
30c0: 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20  ar *zSql,       
30d0: 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 20 73          /* SQL s
30e0: 74 61 74 65 6d 65 6e 74 20 74 6f 20 70 72 65 70  tatement to prep
30f0: 61 72 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a  are */.  char **
3100: 70 7a 45 72 72 20 20 20 20 20 20 20 20 20 20 20  pzErr           
3110: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
3120: 20 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20 2a   Error message *
3130: 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 5f 73  /.){.  sqlite3_s
3140: 74 6d 74 20 2a 70 52 65 74 20 3d 20 30 3b 0a 20  tmt *pRet = 0;. 
3150: 20 61 73 73 65 72 74 28 20 70 7a 45 72 72 20 29   assert( pzErr )
3160: 3b 0a 20 20 69 66 28 20 2a 70 52 63 3d 3d 53 51  ;.  if( *pRc==SQ
3170: 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69  LITE_OK ){.    i
3180: 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f  nt rc = sqlite3_
3190: 70 72 65 70 61 72 65 5f 76 32 28 64 62 2c 20 7a  prepare_v2(db, z
31a0: 53 71 6c 2c 20 2d 31 2c 20 26 70 52 65 74 2c 20  Sql, -1, &pRet, 
31b0: 30 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21 3d  0);.    if( rc!=
31c0: 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20  SQLITE_OK ){.   
31d0: 20 20 20 2a 70 7a 45 72 72 20 3d 20 73 71 6c 69     *pzErr = sqli
31e0: 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 73 71 6c  te3_mprintf("sql
31f0: 20 65 72 72 6f 72 3a 20 25 73 22 2c 20 73 71 6c   error: %s", sql
3200: 69 74 65 33 5f 65 72 72 6d 73 67 28 64 62 29 29  ite3_errmsg(db))
3210: 3b 0a 20 20 20 20 20 20 2a 70 52 63 20 3d 20 72  ;.      *pRc = r
3220: 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72  c;.    }.  }.  r
3230: 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 2f  eturn pRet;.}../
3240: 2a 0a 2a 2a 20 4c 69 6b 65 20 75 6e 69 6f 6e 50  *.** Like unionP
3250: 72 65 70 61 72 65 28 29 2c 20 65 78 63 65 70 74  repare(), except
3260: 20 70 72 65 70 61 72 65 20 74 68 65 20 72 65 73   prepare the res
3270: 75 6c 74 73 20 6f 66 20 76 70 72 69 6e 74 66 28  ults of vprintf(
3280: 7a 46 6d 74 2c 20 2e 2e 2e 29 0a 2a 2a 20 69 6e  zFmt, ...).** in
3290: 73 74 65 61 64 20 6f 66 20 61 20 63 6f 6e 73 74  stead of a const
32a0: 61 6e 74 20 53 51 4c 20 73 74 72 69 6e 67 2e 0a  ant SQL string..
32b0: 2a 2f 0a 73 74 61 74 69 63 20 73 71 6c 69 74 65  */.static sqlite
32c0: 33 5f 73 74 6d 74 20 2a 75 6e 69 6f 6e 50 72 65  3_stmt *unionPre
32d0: 70 61 72 65 50 72 69 6e 74 66 28 0a 20 20 69 6e  parePrintf(.  in
32e0: 74 20 2a 70 52 63 2c 20 20 20 20 20 20 20 20 20  t *pRc,         
32f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
3300: 20 49 4e 2f 4f 55 54 3a 20 45 72 72 6f 72 20 63   IN/OUT: Error c
3310: 6f 64 65 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a  ode */.  char **
3320: 70 7a 45 72 72 2c 20 20 20 20 20 20 20 20 20 20  pzErr,          
3330: 20 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a           /* OUT:
3340: 20 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20 2a   Error message *
3350: 2f 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c  /.  sqlite3 *db,
3360: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3370: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20      /* Database 
3380: 68 61 6e 64 6c 65 20 2a 2f 0a 20 20 63 6f 6e 73  handle */.  cons
3390: 74 20 63 68 61 72 20 2a 7a 46 6d 74 2c 20 20 20  t char *zFmt,   
33a0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 70              /* p
33b0: 72 69 6e 74 66 28 29 20 66 6f 72 6d 61 74 20 73  rintf() format s
33c0: 74 72 69 6e 67 20 2a 2f 0a 20 20 2e 2e 2e 20 20  tring */.  ...  
33d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
33e0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72             /* Tr
33f0: 61 69 6c 69 6e 67 20 70 72 69 6e 74 66 20 61 72  ailing printf ar
3400: 67 73 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74  gs */.){.  sqlit
3410: 65 33 5f 73 74 6d 74 20 2a 70 52 65 74 20 3d 20  e3_stmt *pRet = 
3420: 30 3b 0a 20 20 63 68 61 72 20 2a 7a 53 71 6c 3b  0;.  char *zSql;
3430: 0a 20 20 76 61 5f 6c 69 73 74 20 61 70 3b 0a 20  .  va_list ap;. 
3440: 20 76 61 5f 73 74 61 72 74 28 61 70 2c 20 7a 46   va_start(ap, zF
3450: 6d 74 29 3b 0a 0a 20 20 7a 53 71 6c 20 3d 20 73  mt);..  zSql = s
3460: 71 6c 69 74 65 33 5f 76 6d 70 72 69 6e 74 66 28  qlite3_vmprintf(
3470: 7a 46 6d 74 2c 20 61 70 29 3b 0a 20 20 69 66 28  zFmt, ap);.  if(
3480: 20 2a 70 52 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b   *pRc==SQLITE_OK
3490: 20 29 7b 0a 20 20 20 20 69 66 28 20 7a 53 71 6c   ){.    if( zSql
34a0: 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2a 70 52  ==0 ){.      *pR
34b0: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
34c0: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
34d0: 20 20 20 70 52 65 74 20 3d 20 75 6e 69 6f 6e 50     pRet = unionP
34e0: 72 65 70 61 72 65 28 70 52 63 2c 20 64 62 2c 20  repare(pRc, db, 
34f0: 7a 53 71 6c 2c 20 70 7a 45 72 72 29 3b 0a 20 20  zSql, pzErr);.  
3500: 20 20 7d 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65    }.  }.  sqlite
3510: 33 5f 66 72 65 65 28 7a 53 71 6c 29 3b 0a 0a 20  3_free(zSql);.. 
3520: 20 76 61 5f 65 6e 64 28 61 70 29 3b 0a 20 20 72   va_end(ap);.  r
3530: 65 74 75 72 6e 20 70 52 65 74 3b 0a 7d 0a 0a 0a  eturn pRet;.}...
3540: 2f 2a 0a 2a 2a 20 43 61 6c 6c 20 73 71 6c 69 74  /*.** Call sqlit
3550: 65 33 5f 72 65 73 65 74 28 29 20 6f 6e 20 53 51  e3_reset() on SQ
3560: 4c 20 73 74 61 74 65 6d 65 6e 74 20 70 53 74 6d  L statement pStm
3570: 74 2e 20 49 66 20 2a 70 52 63 20 69 73 20 73 65  t. If *pRc is se
3580: 74 20 74 6f 20 0a 2a 2a 20 53 51 4c 49 54 45 5f  t to .** SQLITE_
3590: 4f 4b 20 77 68 65 6e 20 74 68 69 73 20 66 75 6e  OK when this fun
35a0: 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c  ction is called,
35b0: 20 74 68 65 6e 20 69 74 20 69 73 20 73 65 74 20   then it is set 
35c0: 74 6f 20 74 68 65 0a 2a 2a 20 76 61 6c 75 65 20  to the.** value 
35d0: 72 65 74 75 72 6e 65 64 20 62 79 20 73 71 6c 69  returned by sqli
35e0: 74 65 33 5f 72 65 73 65 74 28 29 20 62 65 66 6f  te3_reset() befo
35f0: 72 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  re this function
3600: 20 65 78 69 74 73 2e 0a 2a 2a 20 49 6e 20 74 68   exits..** In th
3610: 69 73 20 63 61 73 65 2c 20 2a 70 7a 45 72 72 20  is case, *pzErr 
3620: 6d 61 79 20 62 65 20 73 65 74 20 74 6f 20 70 6f  may be set to po
3630: 69 6e 74 20 74 6f 20 61 6e 20 65 72 72 6f 72 20  int to an error 
3640: 6d 65 73 73 61 67 65 0a 2a 2a 20 62 75 66 66 65  message.** buffe
3650: 72 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20 73  r allocated by s
3660: 71 6c 69 74 65 33 5f 6d 61 6c 6c 6f 63 28 29 2e  qlite3_malloc().
3670: 0a 2a 2f 0a 23 69 66 20 30 0a 73 74 61 74 69 63  .*/.#if 0.static
3680: 20 76 6f 69 64 20 75 6e 69 6f 6e 52 65 73 65 74   void unionReset
3690: 28 69 6e 74 20 2a 70 52 63 2c 20 73 71 6c 69 74  (int *pRc, sqlit
36a0: 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20  e3_stmt *pStmt, 
36b0: 63 68 61 72 20 2a 2a 70 7a 45 72 72 29 7b 0a 20  char **pzErr){. 
36c0: 20 69 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65   int rc = sqlite
36d0: 33 5f 72 65 73 65 74 28 70 53 74 6d 74 29 3b 0a  3_reset(pStmt);.
36e0: 20 20 69 66 28 20 2a 70 52 63 3d 3d 53 51 4c 49    if( *pRc==SQLI
36f0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70 52  TE_OK ){.    *pR
3700: 63 20 3d 20 72 63 3b 0a 20 20 20 20 69 66 28 20  c = rc;.    if( 
3710: 72 63 20 29 7b 0a 20 20 20 20 20 20 2a 70 7a 45  rc ){.      *pzE
3720: 72 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72  rr = sqlite3_mpr
3730: 69 6e 74 66 28 22 25 73 22 2c 20 73 71 6c 69 74  intf("%s", sqlit
3740: 65 33 5f 65 72 72 6d 73 67 28 73 71 6c 69 74 65  e3_errmsg(sqlite
3750: 33 5f 64 62 5f 68 61 6e 64 6c 65 28 70 53 74 6d  3_db_handle(pStm
3760: 74 29 29 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  t)));.    }.  }.
3770: 7d 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a 2a 20  }.#endif../*.** 
3780: 43 61 6c 6c 20 73 71 6c 69 74 65 33 5f 66 69 6e  Call sqlite3_fin
3790: 61 6c 69 7a 65 28 29 20 6f 6e 20 53 51 4c 20 73  alize() on SQL s
37a0: 74 61 74 65 6d 65 6e 74 20 70 53 74 6d 74 2e 20  tatement pStmt. 
37b0: 49 66 20 2a 70 52 63 20 69 73 20 73 65 74 20 74  If *pRc is set t
37c0: 6f 20 0a 2a 2a 20 53 51 4c 49 54 45 5f 4f 4b 20  o .** SQLITE_OK 
37d0: 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69  when this functi
37e0: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68  on is called, th
37f0: 65 6e 20 69 74 20 69 73 20 73 65 74 20 74 6f 20  en it is set to 
3800: 74 68 65 0a 2a 2a 20 76 61 6c 75 65 20 72 65 74  the.** value ret
3810: 75 72 6e 65 64 20 62 79 20 73 71 6c 69 74 65 33  urned by sqlite3
3820: 5f 66 69 6e 61 6c 69 7a 65 28 29 20 62 65 66 6f  _finalize() befo
3830: 72 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e  re this function
3840: 20 65 78 69 74 73 2e 0a 2a 2f 0a 73 74 61 74 69   exits..*/.stati
3850: 63 20 76 6f 69 64 20 75 6e 69 6f 6e 46 69 6e 61  c void unionFina
3860: 6c 69 7a 65 28 69 6e 74 20 2a 70 52 63 2c 20 73  lize(int *pRc, s
3870: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
3880: 6d 74 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 72  mt, char **pzErr
3890: 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  ){.  sqlite3 *db
38a0: 20 3d 20 73 71 6c 69 74 65 33 5f 64 62 5f 68 61   = sqlite3_db_ha
38b0: 6e 64 6c 65 28 70 53 74 6d 74 29 3b 0a 20 20 69  ndle(pStmt);.  i
38c0: 6e 74 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f  nt rc = sqlite3_
38d0: 66 69 6e 61 6c 69 7a 65 28 70 53 74 6d 74 29 3b  finalize(pStmt);
38e0: 0a 20 20 69 66 28 20 2a 70 52 63 3d 3d 53 51 4c  .  if( *pRc==SQL
38f0: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 2a 70  ITE_OK ){.    *p
3900: 52 63 20 3d 20 72 63 3b 0a 20 20 20 20 69 66 28  Rc = rc;.    if(
3910: 20 72 63 20 29 7b 0a 20 20 20 20 20 20 2a 70 7a   rc ){.      *pz
3920: 45 72 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70  Err = sqlite3_mp
3930: 72 69 6e 74 66 28 22 25 73 22 2c 20 73 71 6c 69  rintf("%s", sqli
3940: 74 65 33 5f 65 72 72 6d 73 67 28 64 62 29 29 3b  te3_errmsg(db));
3950: 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a 0a 2f 2a  .    }.  }.}../*
3960: 0a 2a 2a 20 49 66 20 61 6e 20 22 6f 70 65 6e 63  .** If an "openc
3970: 6c 6f 73 65 22 20 55 44 46 20 77 61 73 20 73 75  lose" UDF was su
3980: 70 70 6c 69 65 64 20 77 68 65 6e 20 74 68 69 73  pplied when this
3990: 20 76 69 72 74 75 61 6c 20 74 61 62 6c 65 20 77   virtual table w
39a0: 61 73 20 63 72 65 61 74 65 64 2c 0a 2a 2a 20 69  as created,.** i
39b0: 6e 76 6f 6b 65 20 69 74 20 6e 6f 77 2e 20 54 68  nvoke it now. Th
39c0: 65 20 66 69 72 73 74 20 61 72 67 75 6d 65 6e 74  e first argument
39d0: 20 70 61 73 73 65 64 20 69 73 20 74 68 65 20 6e   passed is the n
39e0: 61 6d 65 20 6f 66 20 74 68 65 20 64 61 74 61 62  ame of the datab
39f0: 61 73 65 0a 2a 2a 20 66 69 6c 65 20 66 6f 72 20  ase.** file for 
3a00: 73 6f 75 72 63 65 20 70 53 72 63 2e 20 54 68 65  source pSrc. The
3a10: 20 73 65 63 6f 6e 64 20 69 73 20 69 6e 74 65 67   second is integ
3a20: 65 72 20 76 61 6c 75 65 20 62 43 6c 6f 73 65 2e  er value bClose.
3a30: 0a 2a 2a 0a 2a 2a 20 49 66 20 73 75 63 63 65 73  .**.** If succes
3a40: 73 66 75 6c 2c 20 72 65 74 75 72 6e 20 53 51 4c  sful, return SQL
3a50: 49 54 45 5f 4f 4b 2e 20 4f 74 68 65 72 77 69 73  ITE_OK. Otherwis
3a60: 65 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f  e an SQLite erro
3a70: 72 20 63 6f 64 65 2e 20 49 6e 20 74 68 69 73 0a  r code. In this.
3a80: 2a 2a 20 63 61 73 65 20 69 66 20 61 72 67 75 6d  ** case if argum
3a90: 65 6e 74 20 70 7a 45 72 72 20 69 73 20 6e 6f 74  ent pzErr is not
3aa0: 20 4e 55 4c 4c 2c 20 61 6c 73 6f 20 73 65 74 20   NULL, also set 
3ab0: 28 2a 70 7a 45 72 72 29 20 74 6f 20 61 6e 20 45  (*pzErr) to an E
3ac0: 6e 67 6c 69 73 68 0a 2a 2a 20 6c 61 6e 67 75 61  nglish.** langua
3ad0: 67 65 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  ge error message
3ae0: 2e 20 54 68 65 20 63 61 6c 6c 65 72 20 69 73 20  . The caller is 
3af0: 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20  responsible for 
3b00: 65 76 65 6e 74 75 61 6c 6c 79 20 66 72 65 65 69  eventually freei
3b10: 6e 67 20 0a 2a 2a 20 61 6e 79 20 65 72 72 6f 72  ng .** any error
3b20: 20 6d 65 73 73 61 67 65 20 75 73 69 6e 67 20 73   message using s
3b30: 71 6c 69 74 65 33 5f 66 72 65 65 28 29 2e 0a 2a  qlite3_free()..*
3b40: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69  /.static int uni
3b50: 6f 6e 49 6e 76 6f 6b 65 4f 70 65 6e 43 6c 6f 73  onInvokeOpenClos
3b60: 65 28 0a 20 20 55 6e 69 6f 6e 54 61 62 20 2a 70  e(.  UnionTab *p
3b70: 54 61 62 2c 20 0a 20 20 55 6e 69 6f 6e 53 72 63  Tab, .  UnionSrc
3b80: 20 2a 70 53 72 63 2c 20 0a 20 20 69 6e 74 20 62   *pSrc, .  int b
3b90: 43 6c 6f 73 65 2c 0a 20 20 63 68 61 72 20 2a 2a  Close,.  char **
3ba0: 70 7a 45 72 72 0a 29 7b 0a 20 20 69 6e 74 20 72  pzErr.){.  int r
3bb0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
3bc0: 20 69 66 28 20 70 54 61 62 2d 3e 70 4f 70 65 6e   if( pTab->pOpen
3bd0: 43 6c 6f 73 65 20 29 7b 0a 20 20 20 20 73 71 6c  Close ){.    sql
3be0: 69 74 65 33 5f 62 69 6e 64 5f 74 65 78 74 28 70  ite3_bind_text(p
3bf0: 54 61 62 2d 3e 70 4f 70 65 6e 43 6c 6f 73 65 2c  Tab->pOpenClose,
3c00: 20 31 2c 20 70 53 72 63 2d 3e 7a 46 69 6c 65 2c   1, pSrc->zFile,
3c10: 20 2d 31 2c 20 53 51 4c 49 54 45 5f 53 54 41 54   -1, SQLITE_STAT
3c20: 49 43 29 3b 0a 20 20 20 20 69 66 28 20 70 54 61  IC);.    if( pTa
3c30: 62 2d 3e 62 48 61 73 43 6f 6e 74 65 78 74 20 29  b->bHasContext )
3c40: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  {.      sqlite3_
3c50: 62 69 6e 64 5f 74 65 78 74 28 70 54 61 62 2d 3e  bind_text(pTab->
3c60: 70 4f 70 65 6e 43 6c 6f 73 65 2c 20 32 2c 20 70  pOpenClose, 2, p
3c70: 53 72 63 2d 3e 7a 43 6f 6e 74 65 78 74 2c 20 2d  Src->zContext, -
3c80: 31 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43  1, SQLITE_STATIC
3c90: 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c  );.    }.    sql
3ca0: 69 74 65 33 5f 62 69 6e 64 5f 69 6e 74 28 70 54  ite3_bind_int(pT
3cb0: 61 62 2d 3e 70 4f 70 65 6e 43 6c 6f 73 65 2c 20  ab->pOpenClose, 
3cc0: 32 2b 70 54 61 62 2d 3e 62 48 61 73 43 6f 6e 74  2+pTab->bHasCont
3cd0: 65 78 74 2c 20 62 43 6c 6f 73 65 29 3b 0a 20 20  ext, bClose);.  
3ce0: 20 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 70    sqlite3_step(p
3cf0: 54 61 62 2d 3e 70 4f 70 65 6e 43 6c 6f 73 65 29  Tab->pOpenClose)
3d00: 3b 0a 20 20 20 20 69 66 28 20 53 51 4c 49 54 45  ;.    if( SQLITE
3d10: 5f 4f 4b 21 3d 28 72 63 20 3d 20 73 71 6c 69 74  _OK!=(rc = sqlit
3d20: 65 33 5f 72 65 73 65 74 28 70 54 61 62 2d 3e 70  e3_reset(pTab->p
3d30: 4f 70 65 6e 43 6c 6f 73 65 29 29 20 29 7b 0a 20  OpenClose)) ){. 
3d40: 20 20 20 20 20 69 66 28 20 70 7a 45 72 72 20 29       if( pzErr )
3d50: 7b 0a 20 20 20 20 20 20 20 20 2a 70 7a 45 72 72  {.        *pzErr
3d60: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e   = sqlite3_mprin
3d70: 74 66 28 22 25 73 22 2c 20 73 71 6c 69 74 65 33  tf("%s", sqlite3
3d80: 5f 65 72 72 6d 73 67 28 70 54 61 62 2d 3e 64 62  _errmsg(pTab->db
3d90: 29 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ));.      }.    
3da0: 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72  }.  }.  return r
3db0: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73  c;.}../*.** This
3dc0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e   function is a n
3dd0: 6f 2d 6f 70 20 66 6f 72 20 75 6e 69 6f 6e 76 74  o-op for unionvt
3de0: 61 62 2e 20 46 6f 72 20 73 77 61 72 6d 76 74 61  ab. For swarmvta
3df0: 62 2c 20 69 74 20 61 74 74 65 6d 70 74 73 20 74  b, it attempts t
3e00: 6f 0a 2a 2a 20 63 6c 6f 73 65 20 6f 70 65 6e 20  o.** close open 
3e10: 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20 75  database files u
3e20: 6e 74 69 6c 20 61 74 20 6d 6f 73 74 20 6e 4d 61  ntil at most nMa
3e30: 78 20 61 72 65 20 6f 70 65 6e 2e 20 41 6e 20 53  x are open. An S
3e40: 51 4c 69 74 65 20 65 72 72 6f 72 0a 2a 2a 20 63  QLite error.** c
3e50: 6f 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 20  ode is returned 
3e60: 69 66 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75  if an error occu
3e70: 72 73 2c 20 6f 72 20 53 51 4c 49 54 45 5f 4f 4b  rs, or SQLITE_OK
3e80: 20 6f 74 68 65 72 77 69 73 65 2e 0a 2a 2f 0a 73   otherwise..*/.s
3e90: 74 61 74 69 63 20 76 6f 69 64 20 75 6e 69 6f 6e  tatic void union
3ea0: 43 6c 6f 73 65 53 6f 75 72 63 65 73 28 55 6e 69  CloseSources(Uni
3eb0: 6f 6e 54 61 62 20 2a 70 54 61 62 2c 20 69 6e 74  onTab *pTab, int
3ec0: 20 6e 4d 61 78 29 7b 0a 20 20 77 68 69 6c 65 28   nMax){.  while(
3ed0: 20 70 54 61 62 2d 3e 70 43 6c 6f 73 61 62 6c 65   pTab->pClosable
3ee0: 20 26 26 20 70 54 61 62 2d 3e 6e 4f 70 65 6e 3e   && pTab->nOpen>
3ef0: 6e 4d 61 78 20 29 7b 0a 20 20 20 20 55 6e 69 6f  nMax ){.    Unio
3f00: 6e 53 72 63 20 2a 70 3b 0a 20 20 20 20 55 6e 69  nSrc *p;.    Uni
3f10: 6f 6e 53 72 63 20 2a 2a 70 70 3b 0a 20 20 20 20  onSrc **pp;.    
3f20: 66 6f 72 28 70 70 3d 26 70 54 61 62 2d 3e 70 43  for(pp=&pTab->pC
3f30: 6c 6f 73 61 62 6c 65 3b 20 28 2a 70 70 29 2d 3e  losable; (*pp)->
3f40: 70 4e 65 78 74 43 6c 6f 73 61 62 6c 65 3b 20 70  pNextClosable; p
3f50: 70 3d 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74 43  p=&(*pp)->pNextC
3f60: 6c 6f 73 61 62 6c 65 29 3b 0a 20 20 20 20 70 20  losable);.    p 
3f70: 3d 20 2a 70 70 3b 0a 20 20 20 20 61 73 73 65 72  = *pp;.    asser
3f80: 74 28 20 70 2d 3e 64 62 20 29 3b 0a 20 20 20 20  t( p->db );.    
3f90: 73 71 6c 69 74 65 33 5f 63 6c 6f 73 65 28 70 2d  sqlite3_close(p-
3fa0: 3e 64 62 29 3b 0a 20 20 20 20 70 2d 3e 64 62 20  >db);.    p->db 
3fb0: 3d 20 30 3b 0a 20 20 20 20 2a 70 70 20 3d 20 30  = 0;.    *pp = 0
3fc0: 3b 0a 20 20 20 20 70 54 61 62 2d 3e 6e 4f 70 65  ;.    pTab->nOpe
3fd0: 6e 2d 2d 3b 0a 20 20 20 20 75 6e 69 6f 6e 49 6e  n--;.    unionIn
3fe0: 76 6f 6b 65 4f 70 65 6e 43 6c 6f 73 65 28 70 54  vokeOpenClose(pT
3ff0: 61 62 2c 20 70 2c 20 31 2c 20 30 29 3b 0a 20 20  ab, p, 1, 0);.  
4000: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 78 44 69 73 63  }.}../*.** xDisc
4010: 6f 6e 6e 65 63 74 20 6d 65 74 68 6f 64 2e 0a 2a  onnect method..*
4020: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69  /.static int uni
4030: 6f 6e 44 69 73 63 6f 6e 6e 65 63 74 28 73 71 6c  onDisconnect(sql
4040: 69 74 65 33 5f 76 74 61 62 20 2a 70 56 74 61 62  ite3_vtab *pVtab
4050: 29 7b 0a 20 20 69 66 28 20 70 56 74 61 62 20 29  ){.  if( pVtab )
4060: 7b 0a 20 20 20 20 55 6e 69 6f 6e 54 61 62 20 2a  {.    UnionTab *
4070: 70 54 61 62 20 3d 20 28 55 6e 69 6f 6e 54 61 62  pTab = (UnionTab
4080: 2a 29 70 56 74 61 62 3b 0a 20 20 20 20 69 6e 74  *)pVtab;.    int
4090: 20 69 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b   i;.    for(i=0;
40a0: 20 69 3c 70 54 61 62 2d 3e 6e 53 72 63 3b 20 69   i<pTab->nSrc; i
40b0: 2b 2b 29 7b 0a 20 20 20 20 20 20 55 6e 69 6f 6e  ++){.      Union
40c0: 53 72 63 20 2a 70 53 72 63 20 3d 20 26 70 54 61  Src *pSrc = &pTa
40d0: 62 2d 3e 61 53 72 63 5b 69 5d 3b 0a 20 20 20 20  b->aSrc[i];.    
40e0: 20 20 69 6e 74 20 62 48 61 76 65 53 72 63 44 62    int bHaveSrcDb
40f0: 20 3d 20 28 70 53 72 63 2d 3e 64 62 21 3d 30 29   = (pSrc->db!=0)
4100: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f  ;.      sqlite3_
4110: 63 6c 6f 73 65 28 70 53 72 63 2d 3e 64 62 29 3b  close(pSrc->db);
4120: 0a 20 20 20 20 20 20 69 66 28 20 62 48 61 76 65  .      if( bHave
4130: 53 72 63 44 62 20 29 7b 0a 20 20 20 20 20 20 20  SrcDb ){.       
4140: 20 75 6e 69 6f 6e 49 6e 76 6f 6b 65 4f 70 65 6e   unionInvokeOpen
4150: 43 6c 6f 73 65 28 70 54 61 62 2c 20 70 53 72 63  Close(pTab, pSrc
4160: 2c 20 31 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d  , 1, 0);.      }
4170: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66  .      sqlite3_f
4180: 72 65 65 28 70 53 72 63 2d 3e 7a 44 62 29 3b 0a  ree(pSrc->zDb);.
4190: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72        sqlite3_fr
41a0: 65 65 28 70 53 72 63 2d 3e 7a 54 61 62 29 3b 0a  ee(pSrc->zTab);.
41b0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66 72        sqlite3_fr
41c0: 65 65 28 70 53 72 63 2d 3e 7a 46 69 6c 65 29 3b  ee(pSrc->zFile);
41d0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66  .      sqlite3_f
41e0: 72 65 65 28 70 53 72 63 2d 3e 7a 43 6f 6e 74 65  ree(pSrc->zConte
41f0: 78 74 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73  xt);.    }.    s
4200: 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28  qlite3_finalize(
4210: 70 54 61 62 2d 3e 70 4e 6f 74 46 6f 75 6e 64 29  pTab->pNotFound)
4220: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 69  ;.    sqlite3_fi
4230: 6e 61 6c 69 7a 65 28 70 54 61 62 2d 3e 70 4f 70  nalize(pTab->pOp
4240: 65 6e 43 6c 6f 73 65 29 3b 0a 20 20 20 20 73 71  enClose);.    sq
4250: 6c 69 74 65 33 5f 66 72 65 65 28 70 54 61 62 2d  lite3_free(pTab-
4260: 3e 7a 53 6f 75 72 63 65 53 74 72 29 3b 0a 20 20  >zSourceStr);.  
4270: 20 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70    sqlite3_free(p
4280: 54 61 62 2d 3e 61 53 72 63 29 3b 0a 20 20 20 20  Tab->aSrc);.    
4290: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 70 54 61  sqlite3_free(pTa
42a0: 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e  b);.  }.  return
42b0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 2f   SQLITE_OK;.}../
42c0: 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 68 61 74 20  *.** Check that 
42d0: 74 68 65 20 74 61 62 6c 65 20 69 64 65 6e 74 69  the table identi
42e0: 66 69 65 64 20 62 79 20 70 53 72 63 20 69 73 20  fied by pSrc is 
42f0: 61 20 72 6f 77 69 64 20 74 61 62 6c 65 2e 20 49  a rowid table. I
4300: 66 20 6e 6f 74 2c 0a 2a 2a 20 72 65 74 75 72 6e  f not,.** return
4310: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 20 61 6e   SQLITE_ERROR an
4320: 64 20 73 65 74 20 28 2a 70 7a 45 72 72 29 20 74  d set (*pzErr) t
4330: 6f 20 70 6f 69 6e 74 20 74 6f 20 61 6e 20 45 6e  o point to an En
4340: 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 0a 2a  glish language.*
4350: 2a 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e  * error message.
4360: 20 49 66 20 74 68 65 20 74 61 62 6c 65 20 69 73   If the table is
4370: 20 61 20 72 6f 77 69 64 20 74 61 62 6c 65 20 61   a rowid table a
4380: 6e 64 20 6e 6f 20 65 72 72 6f 72 20 6f 63 63 75  nd no error occu
4390: 72 73 2c 0a 2a 2a 20 72 65 74 75 72 6e 20 53 51  rs,.** return SQ
43a0: 4c 49 54 45 5f 4f 4b 20 61 6e 64 20 6c 65 61 76  LITE_OK and leav
43b0: 65 20 28 2a 70 7a 45 72 72 29 20 75 6e 6d 6f 64  e (*pzErr) unmod
43c0: 69 66 69 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  ified..*/.static
43d0: 20 69 6e 74 20 75 6e 69 6f 6e 49 73 49 6e 74 6b   int unionIsIntk
43e0: 65 79 54 61 62 6c 65 28 0a 20 20 73 71 6c 69 74  eyTable(.  sqlit
43f0: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  e3 *db,         
4400: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61             /* Da
4410: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 2a 2f  tabase handle */
4420: 0a 20 20 55 6e 69 6f 6e 53 72 63 20 2a 70 53 72  .  UnionSrc *pSr
4430: 63 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  c,              
4440: 20 20 20 2f 2a 20 53 6f 75 72 63 65 20 74 61 62     /* Source tab
4450: 6c 65 20 74 6f 20 74 65 73 74 20 2a 2f 0a 20 20  le to test */.  
4460: 63 68 61 72 20 2a 2a 70 7a 45 72 72 20 20 20 20  char **pzErr    
4470: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
4480: 2f 2a 20 4f 55 54 3a 20 45 72 72 6f 72 20 6d 65  /* OUT: Error me
4490: 73 73 61 67 65 20 2a 2f 0a 29 7b 0a 20 20 69 6e  ssage */.){.  in
44a0: 74 20 62 50 6b 20 3d 20 30 3b 0a 20 20 63 6f 6e  t bPk = 0;.  con
44b0: 73 74 20 63 68 61 72 20 2a 7a 54 79 70 65 20 3d  st char *zType =
44c0: 20 30 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a 20   0;.  int rc;.. 
44d0: 20 73 71 6c 69 74 65 33 5f 74 61 62 6c 65 5f 63   sqlite3_table_c
44e0: 6f 6c 75 6d 6e 5f 6d 65 74 61 64 61 74 61 28 0a  olumn_metadata(.
44f0: 20 20 20 20 20 20 64 62 2c 20 70 53 72 63 2d 3e        db, pSrc->
4500: 7a 44 62 2c 20 70 53 72 63 2d 3e 7a 54 61 62 2c  zDb, pSrc->zTab,
4510: 20 22 5f 72 6f 77 69 64 5f 22 2c 20 26 7a 54 79   "_rowid_", &zTy
4520: 70 65 2c 20 30 2c 20 30 2c 20 26 62 50 6b 2c 20  pe, 0, 0, &bPk, 
4530: 30 0a 20 20 29 3b 0a 20 20 72 63 20 3d 20 73 71  0.  );.  rc = sq
4540: 6c 69 74 65 33 5f 65 72 72 63 6f 64 65 28 64 62  lite3_errcode(db
4550: 29 3b 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  );.  if( rc==SQL
4560: 49 54 45 5f 45 52 52 4f 52 20 0a 20 20 20 7c 7c  ITE_ERROR .   ||
4570: 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20   (rc==SQLITE_OK 
4580: 26 26 20 28 21 62 50 6b 20 7c 7c 20 73 71 6c 69  && (!bPk || sqli
4590: 74 65 33 5f 73 74 72 69 63 6d 70 28 22 69 6e 74  te3_stricmp("int
45a0: 65 67 65 72 22 2c 20 7a 54 79 70 65 29 29 29 0a  eger", zType))).
45b0: 20 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51    ){.    rc = SQ
45c0: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20  LITE_ERROR;.    
45d0: 2a 70 7a 45 72 72 20 3d 20 73 71 6c 69 74 65 33  *pzErr = sqlite3
45e0: 5f 6d 70 72 69 6e 74 66 28 22 6e 6f 20 73 75 63  _mprintf("no suc
45f0: 68 20 72 6f 77 69 64 20 74 61 62 6c 65 3a 20 25  h rowid table: %
4600: 73 25 73 25 73 22 2c 0a 20 20 20 20 20 20 20 20  s%s%s",.        
4610: 28 70 53 72 63 2d 3e 7a 44 62 20 3f 20 70 53 72  (pSrc->zDb ? pSr
4620: 63 2d 3e 7a 44 62 20 3a 20 22 22 29 2c 0a 20 20  c->zDb : ""),.  
4630: 20 20 20 20 20 20 28 70 53 72 63 2d 3e 7a 44 62        (pSrc->zDb
4640: 20 3f 20 22 2e 22 20 3a 20 22 22 29 2c 0a 20 20   ? "." : ""),.  
4650: 20 20 20 20 20 20 70 53 72 63 2d 3e 7a 54 61 62        pSrc->zTab
4660: 0a 20 20 20 20 29 3b 0a 20 20 7d 0a 20 20 72 65  .    );.  }.  re
4670: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
4680: 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  * This function 
4690: 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 2a 70  is a no-op if *p
46a0: 52 63 20 69 73 20 6f 74 68 65 72 20 74 68 61 6e  Rc is other than
46b0: 20 53 51 4c 49 54 45 5f 4f 4b 20 77 68 65 6e 20   SQLITE_OK when 
46c0: 69 74 20 69 73 0a 2a 2a 20 63 61 6c 6c 65 64 2e  it is.** called.
46d0: 20 49 6e 20 74 68 69 73 20 63 61 73 65 20 69 74   In this case it
46e0: 20 72 65 74 75 72 6e 73 20 4e 55 4c 4c 2e 0a 2a   returns NULL..*
46f0: 2a 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20  *.** Otherwise, 
4700: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 68  this function ch
4710: 65 63 6b 73 20 74 68 61 74 20 74 68 65 20 73 6f  ecks that the so
4720: 75 72 63 65 20 74 61 62 6c 65 20 70 61 73 73 65  urce table passe
4730: 64 20 61 73 20 74 68 65 0a 2a 2a 20 73 65 63 6f  d as the.** seco
4740: 6e 64 20 61 72 67 75 6d 65 6e 74 20 28 61 29 20  nd argument (a) 
4750: 65 78 69 73 74 73 2c 20 28 62 29 20 69 73 20 6e  exists, (b) is n
4760: 6f 74 20 61 20 76 69 65 77 20 61 6e 64 20 28 63  ot a view and (c
4770: 29 20 68 61 73 20 61 20 63 6f 6c 75 6d 6e 20 0a  ) has a column .
4780: 2a 2a 20 6e 61 6d 65 64 20 22 5f 72 6f 77 69 64  ** named "_rowid
4790: 5f 22 20 6f 66 20 74 79 70 65 20 22 69 6e 74 65  _" of type "inte
47a0: 67 65 72 22 20 74 68 61 74 20 69 73 20 74 68 65  ger" that is the
47b0: 20 70 72 69 6d 61 72 79 20 6b 65 79 2e 0a 2a 2a   primary key..**
47c0: 20 49 66 20 74 68 69 73 20 69 73 20 6e 6f 74 20   If this is not 
47d0: 74 68 65 20 63 61 73 65 2c 20 2a 70 52 63 20 69  the case, *pRc i
47e0: 73 20 73 65 74 20 74 6f 20 53 51 4c 49 54 45 5f  s set to SQLITE_
47f0: 45 52 52 4f 52 20 61 6e 64 20 4e 55 4c 4c 20 69  ERROR and NULL i
4800: 73 0a 2a 2a 20 72 65 74 75 72 6e 65 64 2e 0a 2a  s.** returned..*
4810: 2a 0a 2a 2a 20 46 69 6e 61 6c 6c 79 2c 20 69 66  *.** Finally, if
4820: 20 74 68 65 20 73 6f 75 72 63 65 20 74 61 62 6c   the source tabl
4830: 65 20 70 61 73 73 65 73 20 74 68 65 20 63 68 65  e passes the che
4840: 63 6b 73 20 61 62 6f 76 65 2c 20 61 20 6e 75 6c  cks above, a nul
4850: 2d 74 65 72 6d 69 6e 61 74 65 64 0a 2a 2a 20 73  -terminated.** s
4860: 74 72 69 6e 67 20 64 65 73 63 72 69 62 69 6e 67  tring describing
4870: 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65   the column name
4880: 73 20 61 6e 64 20 74 79 70 65 73 20 62 65 6c 6f  s and types belo
4890: 6e 67 69 6e 67 20 74 6f 20 74 68 65 20 73 6f 75  nging to the sou
48a0: 72 63 65 0a 2a 2a 20 74 61 62 6c 65 20 69 73 20  rce.** table is 
48b0: 72 65 74 75 72 6e 65 64 2e 20 54 61 62 6c 65 73  returned. Tables
48c0: 20 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 73   with the same s
48d0: 65 74 20 6f 66 20 63 6f 6c 75 6d 6e 20 6e 61 6d  et of column nam
48e0: 65 73 20 61 6e 64 20 74 79 70 65 73 20 0a 2a 2a  es and types .**
48f0: 20 63 61 75 73 65 20 74 68 69 73 20 66 75 6e 63   cause this func
4900: 74 69 6f 6e 20 74 6f 20 72 65 74 75 72 6e 20 69  tion to return i
4910: 64 65 6e 74 69 63 61 6c 20 73 74 72 69 6e 67 73  dentical strings
4920: 2e 20 49 73 20 69 73 20 74 68 65 20 72 65 73 70  . Is is the resp
4930: 6f 6e 73 69 62 69 6c 69 74 79 0a 2a 2a 20 6f 66  onsibility.** of
4940: 20 74 68 65 20 63 61 6c 6c 65 72 20 74 6f 20 66   the caller to f
4950: 72 65 65 20 74 68 65 20 72 65 74 75 72 6e 65 64  ree the returned
4960: 20 73 74 72 69 6e 67 20 75 73 69 6e 67 20 73 71   string using sq
4970: 6c 69 74 65 33 5f 66 72 65 65 28 29 20 77 68 65  lite3_free() whe
4980: 6e 0a 2a 2a 20 69 74 20 69 73 20 6e 6f 20 6c 6f  n.** it is no lo
4990: 6e 67 65 72 20 72 65 71 75 69 72 65 64 2e 0a 2a  nger required..*
49a0: 2f 0a 73 74 61 74 69 63 20 63 68 61 72 20 2a 75  /.static char *u
49b0: 6e 69 6f 6e 53 6f 75 72 63 65 54 6f 53 74 72 28  nionSourceToStr(
49c0: 0a 20 20 69 6e 74 20 2a 70 52 63 2c 20 20 20 20  .  int *pRc,    
49d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
49e0: 20 20 20 2f 2a 20 49 4e 2f 4f 55 54 3a 20 45 72     /* IN/OUT: Er
49f0: 72 6f 72 20 63 6f 64 65 20 2a 2f 0a 20 20 55 6e  ror code */.  Un
4a00: 69 6f 6e 54 61 62 20 2a 70 54 61 62 2c 20 20 20  ionTab *pTab,   
4a10: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
4a20: 20 56 69 72 74 75 61 6c 20 74 61 62 6c 65 20 6f   Virtual table o
4a30: 62 6a 65 63 74 20 2a 2f 0a 20 20 55 6e 69 6f 6e  bject */.  Union
4a40: 53 72 63 20 2a 70 53 72 63 2c 20 20 20 20 20 20  Src *pSrc,      
4a50: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 53 6f             /* So
4a60: 75 72 63 65 20 74 61 62 6c 65 20 74 6f 20 74 65  urce table to te
4a70: 73 74 20 2a 2f 0a 20 20 63 68 61 72 20 2a 2a 70  st */.  char **p
4a80: 7a 45 72 72 20 20 20 20 20 20 20 20 20 20 20 20  zErr            
4a90: 20 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20          /* OUT: 
4aa0: 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20 2a 2f  Error message */
4ab0: 0a 29 7b 0a 20 20 63 68 61 72 20 2a 7a 52 65 74  .){.  char *zRet
4ac0: 20 3d 20 30 3b 0a 20 20 69 66 28 20 2a 70 52 63   = 0;.  if( *pRc
4ad0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
4ae0: 20 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d     sqlite3 *db =
4af0: 20 75 6e 69 6f 6e 47 65 74 44 62 28 70 54 61 62   unionGetDb(pTab
4b00: 2c 20 70 53 72 63 29 3b 0a 20 20 20 20 69 6e 74  , pSrc);.    int
4b10: 20 72 63 20 3d 20 75 6e 69 6f 6e 49 73 49 6e 74   rc = unionIsInt
4b20: 6b 65 79 54 61 62 6c 65 28 64 62 2c 20 70 53 72  keyTable(db, pSr
4b30: 63 2c 20 70 7a 45 72 72 29 3b 0a 20 20 20 20 73  c, pzErr);.    s
4b40: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 53 74  qlite3_stmt *pSt
4b50: 6d 74 20 3d 20 75 6e 69 6f 6e 50 72 65 70 61 72  mt = unionPrepar
4b60: 65 28 26 72 63 2c 20 64 62 2c 20 0a 20 20 20 20  e(&rc, db, .    
4b70: 20 20 20 20 22 53 45 4c 45 43 54 20 67 72 6f 75      "SELECT grou
4b80: 70 5f 63 6f 6e 63 61 74 28 71 75 6f 74 65 28 6e  p_concat(quote(n
4b90: 61 6d 65 29 20 7c 7c 20 27 2e 27 20 7c 7c 20 71  ame) || '.' || q
4ba0: 75 6f 74 65 28 74 79 70 65 29 29 20 22 0a 20 20  uote(type)) ".  
4bb0: 20 20 20 20 20 20 22 46 52 4f 4d 20 70 72 61 67        "FROM prag
4bc0: 6d 61 5f 74 61 62 6c 65 5f 69 6e 66 6f 28 3f 2c  ma_table_info(?,
4bd0: 20 3f 29 22 2c 20 70 7a 45 72 72 0a 20 20 20 20   ?)", pzErr.    
4be0: 29 3b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53  );.    if( rc==S
4bf0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
4c00: 20 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74    sqlite3_bind_t
4c10: 65 78 74 28 70 53 74 6d 74 2c 20 31 2c 20 70 53  ext(pStmt, 1, pS
4c20: 72 63 2d 3e 7a 54 61 62 2c 20 2d 31 2c 20 53 51  rc->zTab, -1, SQ
4c30: 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20  LITE_STATIC);.  
4c40: 20 20 20 20 73 71 6c 69 74 65 33 5f 62 69 6e 64      sqlite3_bind
4c50: 5f 74 65 78 74 28 70 53 74 6d 74 2c 20 32 2c 20  _text(pStmt, 2, 
4c60: 70 53 72 63 2d 3e 7a 44 62 2c 20 2d 31 2c 20 53  pSrc->zDb, -1, S
4c70: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
4c80: 20 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f       if( SQLITE_
4c90: 52 4f 57 3d 3d 73 71 6c 69 74 65 33 5f 73 74 65  ROW==sqlite3_ste
4ca0: 70 28 70 53 74 6d 74 29 20 29 7b 0a 20 20 20 20  p(pStmt) ){.    
4cb0: 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a      const char *
4cc0: 7a 20 3d 20 28 63 6f 6e 73 74 20 63 68 61 72 2a  z = (const char*
4cd0: 29 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f  )sqlite3_column_
4ce0: 74 65 78 74 28 70 53 74 6d 74 2c 20 30 29 3b 0a  text(pStmt, 0);.
4cf0: 20 20 20 20 20 20 20 20 7a 52 65 74 20 3d 20 75          zRet = u
4d00: 6e 69 6f 6e 53 74 72 64 75 70 28 26 72 63 2c 20  nionStrdup(&rc, 
4d10: 7a 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  z);.      }.    
4d20: 20 20 75 6e 69 6f 6e 46 69 6e 61 6c 69 7a 65 28    unionFinalize(
4d30: 26 72 63 2c 20 70 53 74 6d 74 2c 20 70 7a 45 72  &rc, pStmt, pzEr
4d40: 72 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 2a 70  r);.    }.    *p
4d50: 52 63 20 3d 20 72 63 3b 0a 20 20 7d 0a 0a 20 20  Rc = rc;.  }..  
4d60: 72 65 74 75 72 6e 20 7a 52 65 74 3b 0a 7d 0a 0a  return zRet;.}..
4d70: 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 74 68 61 74  /*.** Check that
4d80: 20 61 6c 6c 20 63 6f 6e 66 69 67 75 72 65 64 20   all configured 
4d90: 73 6f 75 72 63 65 20 74 61 62 6c 65 73 20 65 78  source tables ex
4da0: 69 73 74 20 61 6e 64 20 68 61 76 65 20 74 68 65  ist and have the
4db0: 20 73 61 6d 65 20 63 6f 6c 75 6d 6e 0a 2a 2a 20   same column.** 
4dc0: 6e 61 6d 65 73 20 61 6e 64 20 64 61 74 61 74 79  names and dataty
4dd0: 70 65 73 2e 20 49 66 20 74 68 69 73 20 69 73 20  pes. If this is 
4de0: 6e 6f 74 20 74 68 65 20 63 61 73 65 2c 20 6f 72  not the case, or
4df0: 20 69 66 20 73 6f 6d 65 20 6f 74 68 65 72 20 65   if some other e
4e00: 72 72 6f 72 0a 2a 2a 20 6f 63 63 75 72 73 2c 20  rror.** occurs, 
4e10: 72 65 74 75 72 6e 20 61 6e 20 53 51 4c 69 74 65  return an SQLite
4e20: 20 65 72 72 6f 72 20 63 6f 64 65 2e 20 49 6e 20   error code. In 
4e30: 74 68 69 73 20 63 61 73 65 20 2a 70 7a 45 72 72  this case *pzErr
4e40: 20 6d 61 79 20 62 65 20 73 65 74 0a 2a 2a 20 74   may be set.** t
4e50: 6f 20 70 6f 69 6e 74 20 74 6f 20 61 6e 20 65 72  o point to an er
4e60: 72 6f 72 20 6d 65 73 73 61 67 65 20 62 75 66 66  ror message buff
4e70: 65 72 20 61 6c 6c 6f 63 61 74 65 64 20 62 79 20  er allocated by 
4e80: 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28  sqlite3_mprintf(
4e90: 29 2e 0a 2a 2a 20 4f 72 2c 20 69 66 20 6e 6f 20  )..** Or, if no 
4ea0: 70 72 6f 62 6c 65 6d 73 20 72 65 67 61 72 64 69  problems regardi
4eb0: 6e 67 20 74 68 65 20 73 6f 75 72 63 65 20 74 61  ng the source ta
4ec0: 62 6c 65 73 20 61 72 65 20 64 65 74 65 63 74 65  bles are detecte
4ed0: 64 20 61 6e 64 20 6e 6f 0a 2a 2a 20 6f 74 68 65  d and no.** othe
4ee0: 72 20 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20  r error occurs, 
4ef0: 53 51 4c 49 54 45 5f 4f 4b 20 69 73 20 72 65 74  SQLITE_OK is ret
4f00: 75 72 6e 65 64 2e 0a 2a 2f 0a 73 74 61 74 69 63  urned..*/.static
4f10: 20 69 6e 74 20 75 6e 69 6f 6e 53 6f 75 72 63 65   int unionSource
4f20: 43 68 65 63 6b 28 55 6e 69 6f 6e 54 61 62 20 2a  Check(UnionTab *
4f30: 70 54 61 62 2c 20 63 68 61 72 20 2a 2a 70 7a 45  pTab, char **pzE
4f40: 72 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20  rr){.  int rc = 
4f50: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 63 68 61  SQLITE_OK;.  cha
4f60: 72 20 2a 7a 30 20 3d 20 30 3b 0a 20 20 69 6e 74  r *z0 = 0;.  int
4f70: 20 69 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 2a   i;..  assert( *
4f80: 70 7a 45 72 72 3d 3d 30 20 29 3b 0a 20 20 7a 30  pzErr==0 );.  z0
4f90: 20 3d 20 75 6e 69 6f 6e 53 6f 75 72 63 65 54 6f   = unionSourceTo
4fa0: 53 74 72 28 26 72 63 2c 20 70 54 61 62 2c 20 26  Str(&rc, pTab, &
4fb0: 70 54 61 62 2d 3e 61 53 72 63 5b 30 5d 2c 20 70  pTab->aSrc[0], p
4fc0: 7a 45 72 72 29 3b 0a 20 20 66 6f 72 28 69 3d 31  zErr);.  for(i=1
4fd0: 3b 20 69 3c 70 54 61 62 2d 3e 6e 53 72 63 3b 20  ; i<pTab->nSrc; 
4fe0: 69 2b 2b 29 7b 0a 20 20 20 20 63 68 61 72 20 2a  i++){.    char *
4ff0: 7a 20 3d 20 75 6e 69 6f 6e 53 6f 75 72 63 65 54  z = unionSourceT
5000: 6f 53 74 72 28 26 72 63 2c 20 70 54 61 62 2c 20  oStr(&rc, pTab, 
5010: 26 70 54 61 62 2d 3e 61 53 72 63 5b 69 5d 2c 20  &pTab->aSrc[i], 
5020: 70 7a 45 72 72 29 3b 0a 20 20 20 20 69 66 28 20  pzErr);.    if( 
5030: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc==SQLITE_OK &&
5040: 20 73 71 6c 69 74 65 33 5f 73 74 72 69 63 6d 70   sqlite3_stricmp
5050: 28 7a 2c 20 7a 30 29 20 29 7b 0a 20 20 20 20 20  (z, z0) ){.     
5060: 20 2a 70 7a 45 72 72 20 3d 20 73 71 6c 69 74 65   *pzErr = sqlite
5070: 33 5f 6d 70 72 69 6e 74 66 28 22 73 6f 75 72 63  3_mprintf("sourc
5080: 65 20 74 61 62 6c 65 20 73 63 68 65 6d 61 20 6d  e table schema m
5090: 69 73 6d 61 74 63 68 22 29 3b 0a 20 20 20 20 20  ismatch");.     
50a0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52   rc = SQLITE_ERR
50b0: 4f 52 3b 0a 20 20 20 20 7d 0a 20 20 20 20 73 71  OR;.    }.    sq
50c0: 6c 69 74 65 33 5f 66 72 65 65 28 7a 29 3b 0a 20  lite3_free(z);. 
50d0: 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 66 72 65   }.  sqlite3_fre
50e0: 65 28 7a 30 29 3b 0a 0a 20 20 72 65 74 75 72 6e  e(z0);..  return
50f0: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 72   rc;.}../*.** Tr
5100: 79 20 74 6f 20 6f 70 65 6e 20 74 68 65 20 73 77  y to open the sw
5110: 61 72 6d 76 74 61 62 20 64 61 74 61 62 61 73 65  armvtab database
5120: 2e 20 20 49 66 20 69 6e 69 74 69 61 6c 6c 79 20  .  If initially 
5130: 75 6e 61 62 6c 65 2c 20 69 6e 76 6f 6b 65 20 74  unable, invoke t
5140: 68 65 0a 2a 2a 20 6e 6f 74 2d 66 6f 75 6e 64 20  he.** not-found 
5150: 63 61 6c 6c 62 61 63 6b 20 55 44 46 20 61 6e 64  callback UDF and
5160: 20 74 68 65 6e 20 74 72 79 20 61 67 61 69 6e 2e   then try again.
5170: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75  .*/.static int u
5180: 6e 69 6f 6e 4f 70 65 6e 44 61 74 61 62 61 73 65  nionOpenDatabase
5190: 49 6e 6e 65 72 28 55 6e 69 6f 6e 54 61 62 20 2a  Inner(UnionTab *
51a0: 70 54 61 62 2c 20 55 6e 69 6f 6e 53 72 63 20 2a  pTab, UnionSrc *
51b0: 70 53 72 63 2c 20 63 68 61 72 20 2a 2a 70 7a 45  pSrc, char **pzE
51c0: 72 72 29 7b 0a 20 20 73 74 61 74 69 63 20 63 6f  rr){.  static co
51d0: 6e 73 74 20 69 6e 74 20 6f 70 65 6e 46 6c 61 67  nst int openFlag
51e0: 73 20 3d 20 53 51 4c 49 54 45 5f 4f 50 45 4e 5f  s = SQLITE_OPEN_
51f0: 52 45 41 44 4f 4e 4c 59 20 7c 20 53 51 4c 49 54  READONLY | SQLIT
5200: 45 5f 4f 50 45 4e 5f 55 52 49 3b 0a 20 20 69 6e  E_OPEN_URI;.  in
5210: 74 20 72 63 3b 0a 0a 20 20 72 63 20 3d 20 75 6e  t rc;..  rc = un
5220: 69 6f 6e 49 6e 76 6f 6b 65 4f 70 65 6e 43 6c 6f  ionInvokeOpenClo
5230: 73 65 28 70 54 61 62 2c 20 70 53 72 63 2c 20 30  se(pTab, pSrc, 0
5240: 2c 20 70 7a 45 72 72 29 3b 0a 20 20 69 66 28 20  , pzErr);.  if( 
5250: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc!=SQLITE_OK ) 
5260: 72 65 74 75 72 6e 20 72 63 3b 0a 0a 20 20 72 63  return rc;..  rc
5270: 20 3d 20 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f   = sqlite3_open_
5280: 76 32 28 70 53 72 63 2d 3e 7a 46 69 6c 65 2c 20  v2(pSrc->zFile, 
5290: 26 70 53 72 63 2d 3e 64 62 2c 20 6f 70 65 6e 46  &pSrc->db, openF
52a0: 6c 61 67 73 2c 20 30 29 3b 0a 20 20 69 66 28 20  lags, 0);.  if( 
52b0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20  rc==SQLITE_OK ) 
52c0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 69 66 28  return rc;.  if(
52d0: 20 70 54 61 62 2d 3e 70 4e 6f 74 46 6f 75 6e 64   pTab->pNotFound
52e0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f   ){.    sqlite3_
52f0: 63 6c 6f 73 65 28 70 53 72 63 2d 3e 64 62 29 3b  close(pSrc->db);
5300: 0a 20 20 20 20 70 53 72 63 2d 3e 64 62 20 3d 20  .    pSrc->db = 
5310: 30 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 62  0;.    sqlite3_b
5320: 69 6e 64 5f 74 65 78 74 28 70 54 61 62 2d 3e 70  ind_text(pTab->p
5330: 4e 6f 74 46 6f 75 6e 64 2c 20 31 2c 20 70 53 72  NotFound, 1, pSr
5340: 63 2d 3e 7a 46 69 6c 65 2c 20 2d 31 2c 20 53 51  c->zFile, -1, SQ
5350: 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20  LITE_STATIC);.  
5360: 20 20 69 66 28 20 70 54 61 62 2d 3e 62 48 61 73    if( pTab->bHas
5370: 43 6f 6e 74 65 78 74 20 29 7b 0a 20 20 20 20 20  Context ){.     
5380: 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f 74 65   sqlite3_bind_te
5390: 78 74 28 70 54 61 62 2d 3e 70 4e 6f 74 46 6f 75  xt(pTab->pNotFou
53a0: 6e 64 2c 20 32 2c 20 70 53 72 63 2d 3e 7a 43 6f  nd, 2, pSrc->zCo
53b0: 6e 74 65 78 74 2c 20 2d 31 2c 20 53 51 4c 49 54  ntext, -1, SQLIT
53c0: 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20 7d  E_STATIC);.    }
53d0: 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 73 74 65  .    sqlite3_ste
53e0: 70 28 70 54 61 62 2d 3e 70 4e 6f 74 46 6f 75 6e  p(pTab->pNotFoun
53f0: 64 29 3b 0a 20 20 20 20 69 66 28 20 53 51 4c 49  d);.    if( SQLI
5400: 54 45 5f 4f 4b 21 3d 28 72 63 20 3d 20 73 71 6c  TE_OK!=(rc = sql
5410: 69 74 65 33 5f 72 65 73 65 74 28 70 54 61 62 2d  ite3_reset(pTab-
5420: 3e 70 4e 6f 74 46 6f 75 6e 64 29 29 20 29 7b 0a  >pNotFound)) ){.
5430: 20 20 20 20 20 20 2a 70 7a 45 72 72 20 3d 20 73        *pzErr = s
5440: 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22  qlite3_mprintf("
5450: 25 73 22 2c 20 73 71 6c 69 74 65 33 5f 65 72 72  %s", sqlite3_err
5460: 6d 73 67 28 70 54 61 62 2d 3e 64 62 29 29 3b 0a  msg(pTab->db));.
5470: 20 20 20 20 20 20 72 65 74 75 72 6e 20 72 63 3b        return rc;
5480: 0a 20 20 20 20 7d 0a 20 20 20 20 72 63 20 3d 20  .    }.    rc = 
5490: 73 71 6c 69 74 65 33 5f 6f 70 65 6e 5f 76 32 28  sqlite3_open_v2(
54a0: 70 53 72 63 2d 3e 7a 46 69 6c 65 2c 20 26 70 53  pSrc->zFile, &pS
54b0: 72 63 2d 3e 64 62 2c 20 6f 70 65 6e 46 6c 61 67  rc->db, openFlag
54c0: 73 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 69 66 28  s, 0);.  }.  if(
54d0: 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc!=SQLITE_OK )
54e0: 7b 0a 20 20 20 20 2a 70 7a 45 72 72 20 3d 20 73  {.    *pzErr = s
54f0: 71 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22  qlite3_mprintf("
5500: 25 73 22 2c 20 73 71 6c 69 74 65 33 5f 65 72 72  %s", sqlite3_err
5510: 6d 73 67 28 70 53 72 63 2d 3e 64 62 29 29 3b 0a  msg(pSrc->db));.
5520: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63 3b    }.  return rc;
5530: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
5540: 75 6e 63 74 69 6f 6e 20 6d 61 79 20 6f 6e 6c 79  unction may only
5550: 20 62 65 20 63 61 6c 6c 65 64 20 66 6f 72 20 73   be called for s
5560: 77 61 72 6d 76 74 61 62 20 74 61 62 6c 65 73 2e  warmvtab tables.
5570: 20 54 68 65 20 72 65 73 75 6c 74 73 20 6f 66 0a   The results of.
5580: 2a 2a 20 63 61 6c 6c 69 6e 67 20 69 74 20 6f 6e  ** calling it on
5590: 20 61 20 75 6e 69 6f 6e 76 74 61 62 20 74 61 62   a unionvtab tab
55a0: 6c 65 20 61 72 65 20 75 6e 64 65 66 69 6e 65 64  le are undefined
55b0: 2e 0a 2a 2a 0a 2a 2a 20 46 6f 72 20 61 20 73 77  ..**.** For a sw
55c0: 61 72 6d 76 74 61 62 20 74 61 62 6c 65 2c 20 74  armvtab table, t
55d0: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 65 6e 73  his function ens
55e0: 75 72 65 73 20 74 68 61 74 20 73 6f 75 72 63 65  ures that source
55f0: 20 64 61 74 61 62 61 73 65 20 69 53 72 63 0a 2a   database iSrc.*
5600: 2a 20 69 73 20 6f 70 65 6e 2e 20 49 66 20 74 68  * is open. If th
5610: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6f 70  e database is op
5620: 65 6e 65 64 20 73 75 63 63 65 73 73 66 75 6c 6c  ened successfull
5630: 79 20 61 6e 64 20 74 68 65 20 73 63 68 65 6d 61  y and the schema
5640: 20 69 73 20 61 73 0a 2a 2a 20 65 78 70 65 63 74   is as.** expect
5650: 65 64 2c 20 6f 72 20 69 66 20 69 74 20 69 73 20  ed, or if it is 
5660: 61 6c 72 65 61 64 79 20 6f 70 65 6e 20 77 68 65  already open whe
5670: 6e 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  n this function 
5680: 69 73 20 63 61 6c 6c 65 64 2c 20 53 51 4c 49 54  is called, SQLIT
5690: 45 5f 4f 4b 0a 2a 2a 20 69 73 20 72 65 74 75 72  E_OK.** is retur
56a0: 6e 65 64 2e 0a 2a 2a 0a 2a 2a 20 41 6c 74 65 72  ned..**.** Alter
56b0: 6e 61 74 69 76 65 6c 79 20 49 66 20 61 6e 20 65  natively If an e
56c0: 72 72 6f 72 20 6f 63 63 75 72 73 20 77 68 69 6c  rror occurs whil
56d0: 65 20 6f 70 65 6e 69 6e 67 20 74 68 65 20 64 61  e opening the da
56e0: 74 61 62 61 73 65 73 2c 20 6f 72 20 69 66 20 74  tabases, or if t
56f0: 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 73  he.** database s
5700: 63 68 65 6d 61 20 69 73 20 75 6e 73 75 69 74 61  chema is unsuita
5710: 62 6c 65 2c 20 61 6e 20 53 51 4c 69 74 65 20 65  ble, an SQLite e
5720: 72 72 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74  rror code is ret
5730: 75 72 6e 65 64 20 61 6e 64 20 28 2a 70 7a 45 72  urned and (*pzEr
5740: 72 29 0a 2a 2a 20 6d 61 79 20 62 65 20 73 65 74  r).** may be set
5750: 20 74 6f 20 70 6f 69 6e 74 20 74 6f 20 61 6e 20   to point to an 
5760: 45 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65  English language
5770: 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 20   error message. 
5780: 49 6e 20 74 68 69 73 20 63 61 73 65 20 69 74 20  In this case it 
5790: 69 73 0a 2a 2a 20 74 68 65 20 72 65 73 70 6f 6e  is.** the respon
57a0: 73 69 62 69 6c 69 74 79 20 6f 66 20 74 68 65 20  sibility of the 
57b0: 63 61 6c 6c 65 72 20 74 6f 20 65 76 65 6e 74 75  caller to eventu
57c0: 61 6c 6c 79 20 66 72 65 65 20 74 68 65 20 65 72  ally free the er
57d0: 72 6f 72 20 6d 65 73 73 61 67 65 20 62 75 66 66  ror message buff
57e0: 65 72 0a 2a 2a 20 75 73 69 6e 67 20 73 71 6c 69  er.** using sqli
57f0: 74 65 33 5f 66 72 65 65 28 29 2e 20 0a 2a 2f 0a  te3_free(). .*/.
5800: 73 74 61 74 69 63 20 69 6e 74 20 75 6e 69 6f 6e  static int union
5810: 4f 70 65 6e 44 61 74 61 62 61 73 65 28 55 6e 69  OpenDatabase(Uni
5820: 6f 6e 54 61 62 20 2a 70 54 61 62 2c 20 69 6e 74  onTab *pTab, int
5830: 20 69 53 72 63 2c 20 63 68 61 72 20 2a 2a 70 7a   iSrc, char **pz
5840: 45 72 72 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d  Err){.  int rc =
5850: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 55 6e   SQLITE_OK;.  Un
5860: 69 6f 6e 53 72 63 20 2a 70 53 72 63 20 3d 20 26  ionSrc *pSrc = &
5870: 70 54 61 62 2d 3e 61 53 72 63 5b 69 53 72 63 5d  pTab->aSrc[iSrc]
5880: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 54 61  ;..  assert( pTa
5890: 62 2d 3e 62 53 77 61 72 6d 20 26 26 20 69 53 72  b->bSwarm && iSr
58a0: 63 3c 70 54 61 62 2d 3e 6e 53 72 63 20 29 3b 0a  c<pTab->nSrc );.
58b0: 20 20 69 66 28 20 70 53 72 63 2d 3e 64 62 3d 3d    if( pSrc->db==
58c0: 30 20 29 7b 0a 20 20 20 20 75 6e 69 6f 6e 43 6c  0 ){.    unionCl
58d0: 6f 73 65 53 6f 75 72 63 65 73 28 70 54 61 62 2c  oseSources(pTab,
58e0: 20 70 54 61 62 2d 3e 6e 4d 61 78 4f 70 65 6e 2d   pTab->nMaxOpen-
58f0: 31 29 3b 0a 20 20 20 20 72 63 20 3d 20 75 6e 69  1);.    rc = uni
5900: 6f 6e 4f 70 65 6e 44 61 74 61 62 61 73 65 49 6e  onOpenDatabaseIn
5910: 6e 65 72 28 70 54 61 62 2c 20 70 53 72 63 2c 20  ner(pTab, pSrc, 
5920: 70 7a 45 72 72 29 3b 0a 20 20 20 20 69 66 28 20  pzErr);.    if( 
5930: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
5940: 0a 20 20 20 20 20 20 63 68 61 72 20 2a 7a 20 3d  .      char *z =
5950: 20 75 6e 69 6f 6e 53 6f 75 72 63 65 54 6f 53 74   unionSourceToSt
5960: 72 28 26 72 63 2c 20 70 54 61 62 2c 20 70 53 72  r(&rc, pTab, pSr
5970: 63 2c 20 70 7a 45 72 72 29 3b 0a 20 20 20 20 20  c, pzErr);.     
5980: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
5990: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 20 20 69 66  OK ){.        if
59a0: 28 20 70 54 61 62 2d 3e 7a 53 6f 75 72 63 65 53  ( pTab->zSourceS
59b0: 74 72 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 20  tr==0 ){.       
59c0: 20 20 20 70 54 61 62 2d 3e 7a 53 6f 75 72 63 65     pTab->zSource
59d0: 53 74 72 20 3d 20 7a 3b 0a 20 20 20 20 20 20 20  Str = z;.       
59e0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20   }else{.        
59f0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 73 74    if( sqlite3_st
5a00: 72 69 63 6d 70 28 7a 2c 20 70 54 61 62 2d 3e 7a  ricmp(z, pTab->z
5a10: 53 6f 75 72 63 65 53 74 72 29 20 29 7b 0a 20 20  SourceStr) ){.  
5a20: 20 20 20 20 20 20 20 20 20 20 2a 70 7a 45 72 72            *pzErr
5a30: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e   = sqlite3_mprin
5a40: 74 66 28 22 73 6f 75 72 63 65 20 74 61 62 6c 65  tf("source table
5a50: 20 73 63 68 65 6d 61 20 6d 69 73 6d 61 74 63 68   schema mismatch
5a60: 22 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  ");.            
5a70: 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f  rc = SQLITE_ERRO
5a80: 52 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20  R;.          }. 
5a90: 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33           sqlite3
5aa0: 5f 66 72 65 65 28 7a 29 3b 0a 20 20 20 20 20 20  _free(z);.      
5ab0: 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20    }.      }.    
5ac0: 7d 0a 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53  }..    if( rc==S
5ad0: 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20  QLITE_OK ){.    
5ae0: 20 20 70 53 72 63 2d 3e 70 4e 65 78 74 43 6c 6f    pSrc->pNextClo
5af0: 73 61 62 6c 65 20 3d 20 70 54 61 62 2d 3e 70 43  sable = pTab->pC
5b00: 6c 6f 73 61 62 6c 65 3b 0a 20 20 20 20 20 20 70  losable;.      p
5b10: 54 61 62 2d 3e 70 43 6c 6f 73 61 62 6c 65 20 3d  Tab->pClosable =
5b20: 20 70 53 72 63 3b 0a 20 20 20 20 20 20 70 54 61   pSrc;.      pTa
5b30: 62 2d 3e 6e 4f 70 65 6e 2b 2b 3b 0a 20 20 20 20  b->nOpen++;.    
5b40: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c  }else{.      sql
5b50: 69 74 65 33 5f 63 6c 6f 73 65 28 70 53 72 63 2d  ite3_close(pSrc-
5b60: 3e 64 62 29 3b 0a 20 20 20 20 20 20 70 53 72 63  >db);.      pSrc
5b70: 2d 3e 64 62 20 3d 20 30 3b 0a 20 20 20 20 20 20  ->db = 0;.      
5b80: 75 6e 69 6f 6e 49 6e 76 6f 6b 65 4f 70 65 6e 43  unionInvokeOpenC
5b90: 6c 6f 73 65 28 70 54 61 62 2c 20 70 53 72 63 2c  lose(pTab, pSrc,
5ba0: 20 31 2c 20 30 29 3b 0a 20 20 20 20 7d 0a 20 20   1, 0);.    }.  
5bb0: 7d 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  }..  return rc;.
5bc0: 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  }.../*.** This f
5bd0: 75 6e 63 74 69 6f 6e 20 69 73 20 61 20 6e 6f 2d  unction is a no-
5be0: 6f 70 20 66 6f 72 20 75 6e 69 6f 6e 76 74 61 62  op for unionvtab
5bf0: 20 74 61 62 6c 65 73 2e 20 46 6f 72 20 73 77 61   tables. For swa
5c00: 72 6d 76 74 61 62 2c 20 69 6e 63 72 65 6d 65 6e  rmvtab, incremen
5c10: 74 20 0a 2a 2a 20 74 68 65 20 72 65 66 65 72 65  t .** the refere
5c20: 6e 63 65 20 63 6f 75 6e 74 20 66 6f 72 20 73 6f  nce count for so
5c30: 75 72 63 65 20 74 61 62 6c 65 20 69 54 61 62 2e  urce table iTab.
5c40: 20 49 66 20 74 68 65 20 72 65 66 65 72 65 6e 63   If the referenc
5c50: 65 20 63 6f 75 6e 74 20 77 61 73 0a 2a 2a 20 7a  e count was.** z
5c60: 65 72 6f 20 62 65 66 6f 72 65 20 69 74 20 77 61  ero before it wa
5c70: 73 20 69 6e 63 72 65 6d 65 6e 74 65 64 2c 20 61  s incremented, a
5c80: 6c 73 6f 20 72 65 6d 6f 76 65 20 74 68 65 20 73  lso remove the s
5c90: 6f 75 72 63 65 20 66 72 6f 6d 20 74 68 65 20 63  ource from the c
5ca0: 6c 6f 73 61 62 6c 65 0a 2a 2a 20 6c 69 73 74 2e  losable.** list.
5cb0: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
5cc0: 75 6e 69 6f 6e 49 6e 63 72 52 65 66 63 6f 75 6e  unionIncrRefcoun
5cd0: 74 28 55 6e 69 6f 6e 54 61 62 20 2a 70 54 61 62  t(UnionTab *pTab
5ce0: 2c 20 69 6e 74 20 69 54 61 62 29 7b 0a 20 20 69  , int iTab){.  i
5cf0: 66 28 20 70 54 61 62 2d 3e 62 53 77 61 72 6d 20  f( pTab->bSwarm 
5d00: 29 7b 0a 20 20 20 20 55 6e 69 6f 6e 53 72 63 20  ){.    UnionSrc 
5d10: 2a 70 53 72 63 20 3d 20 26 70 54 61 62 2d 3e 61  *pSrc = &pTab->a
5d20: 53 72 63 5b 69 54 61 62 5d 3b 0a 20 20 20 20 61  Src[iTab];.    a
5d30: 73 73 65 72 74 28 20 70 53 72 63 2d 3e 6e 55 73  ssert( pSrc->nUs
5d40: 65 72 3e 3d 30 20 26 26 20 70 53 72 63 2d 3e 64  er>=0 && pSrc->d
5d50: 62 20 29 3b 0a 20 20 20 20 69 66 28 20 70 53 72  b );.    if( pSr
5d60: 63 2d 3e 6e 55 73 65 72 3d 3d 30 20 29 7b 0a 20  c->nUser==0 ){. 
5d70: 20 20 20 20 20 55 6e 69 6f 6e 53 72 63 20 2a 2a       UnionSrc **
5d80: 70 70 3b 0a 20 20 20 20 20 20 66 6f 72 28 70 70  pp;.      for(pp
5d90: 3d 26 70 54 61 62 2d 3e 70 43 6c 6f 73 61 62 6c  =&pTab->pClosabl
5da0: 65 3b 20 2a 70 70 21 3d 70 53 72 63 3b 20 70 70  e; *pp!=pSrc; pp
5db0: 3d 26 28 2a 70 70 29 2d 3e 70 4e 65 78 74 43 6c  =&(*pp)->pNextCl
5dc0: 6f 73 61 62 6c 65 29 3b 0a 20 20 20 20 20 20 2a  osable);.      *
5dd0: 70 70 20 3d 20 70 53 72 63 2d 3e 70 4e 65 78 74  pp = pSrc->pNext
5de0: 43 6c 6f 73 61 62 6c 65 3b 0a 20 20 20 20 20 20  Closable;.      
5df0: 70 53 72 63 2d 3e 70 4e 65 78 74 43 6c 6f 73 61  pSrc->pNextClosa
5e00: 62 6c 65 20 3d 20 30 3b 0a 20 20 20 20 7d 0a 20  ble = 0;.    }. 
5e10: 20 20 20 70 53 72 63 2d 3e 6e 55 73 65 72 2b 2b     pSrc->nUser++
5e20: 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46  ;.  }.}../*.** F
5e30: 69 6e 61 6c 69 7a 65 20 74 68 65 20 53 51 4c 20  inalize the SQL 
5e40: 73 74 61 74 65 6d 65 6e 74 20 70 43 73 72 2d 3e  statement pCsr->
5e50: 70 53 74 6d 74 20 61 6e 64 20 72 65 74 75 72 6e  pStmt and return
5e60: 20 74 68 65 20 72 65 73 75 6c 74 2e 0a 2a 2a 0a   the result..**.
5e70: 2a 2a 20 49 66 20 74 68 69 73 20 69 73 20 61 20  ** If this is a 
5e80: 73 77 61 72 6d 76 74 61 62 20 74 61 62 6c 65 20  swarmvtab table 
5e90: 28 6e 6f 74 20 75 6e 69 6f 6e 76 74 61 62 29 20  (not unionvtab) 
5ea0: 61 6e 64 20 70 43 73 72 2d 3e 70 53 74 6d 74 20  and pCsr->pStmt 
5eb0: 77 61 73 20 6e 6f 74 0a 2a 2a 20 4e 55 4c 4c 20  was not.** NULL 
5ec0: 77 68 65 6e 20 74 68 69 73 20 66 75 6e 63 74 69  when this functi
5ed0: 6f 6e 20 77 61 73 20 63 61 6c 6c 65 64 2c 20 61  on was called, a
5ee0: 6c 73 6f 20 64 65 63 72 65 6d 65 6e 74 20 74 68  lso decrement th
5ef0: 65 20 72 65 66 65 72 65 6e 63 65 0a 2a 2a 20 63  e reference.** c
5f00: 6f 75 6e 74 20 6f 6e 20 74 68 65 20 61 73 73 6f  ount on the asso
5f10: 63 69 61 74 65 64 20 73 6f 75 72 63 65 20 74 61  ciated source ta
5f20: 62 6c 65 2e 20 49 66 20 74 68 69 73 20 6d 65 61  ble. If this mea
5f30: 6e 73 20 74 68 65 20 73 6f 75 72 63 65 20 74 61  ns the source ta
5f40: 62 6c 65 73 0a 2a 2a 20 72 65 66 63 6f 75 6e 74  bles.** refcount
5f50: 20 69 73 20 6e 6f 77 20 7a 65 72 6f 2c 20 61 64   is now zero, ad
5f60: 64 20 69 74 20 74 6f 20 74 68 65 20 63 6c 6f 73  d it to the clos
5f70: 61 62 6c 65 20 6c 69 73 74 2e 0a 2a 2f 0a 73 74  able list..*/.st
5f80: 61 74 69 63 20 69 6e 74 20 75 6e 69 6f 6e 46 69  atic int unionFi
5f90: 6e 61 6c 69 7a 65 43 73 72 53 74 6d 74 28 55 6e  nalizeCsrStmt(Un
5fa0: 69 6f 6e 43 73 72 20 2a 70 43 73 72 29 7b 0a 20  ionCsr *pCsr){. 
5fb0: 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45   int rc = SQLITE
5fc0: 5f 4f 4b 3b 0a 20 20 69 66 28 20 70 43 73 72 2d  _OK;.  if( pCsr-
5fd0: 3e 70 53 74 6d 74 20 29 7b 0a 20 20 20 20 55 6e  >pStmt ){.    Un
5fe0: 69 6f 6e 54 61 62 20 2a 70 54 61 62 20 3d 20 28  ionTab *pTab = (
5ff0: 55 6e 69 6f 6e 54 61 62 2a 29 70 43 73 72 2d 3e  UnionTab*)pCsr->
6000: 62 61 73 65 2e 70 56 74 61 62 3b 0a 20 20 20 20  base.pVtab;.    
6010: 55 6e 69 6f 6e 53 72 63 20 2a 70 53 72 63 20 3d  UnionSrc *pSrc =
6020: 20 26 70 54 61 62 2d 3e 61 53 72 63 5b 70 43 73   &pTab->aSrc[pCs
6030: 72 2d 3e 69 54 61 62 5d 3b 0a 20 20 20 20 72 63  r->iTab];.    rc
6040: 20 3d 20 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c   = sqlite3_final
6050: 69 7a 65 28 70 43 73 72 2d 3e 70 53 74 6d 74 29  ize(pCsr->pStmt)
6060: 3b 0a 20 20 20 20 70 43 73 72 2d 3e 70 53 74 6d  ;.    pCsr->pStm
6070: 74 20 3d 20 30 3b 0a 20 20 20 20 69 66 28 20 70  t = 0;.    if( p
6080: 54 61 62 2d 3e 62 53 77 61 72 6d 20 29 7b 0a 20  Tab->bSwarm ){. 
6090: 20 20 20 20 20 70 53 72 63 2d 3e 6e 55 73 65 72       pSrc->nUser
60a0: 2d 2d 3b 0a 20 20 20 20 20 20 61 73 73 65 72 74  --;.      assert
60b0: 28 20 70 53 72 63 2d 3e 6e 55 73 65 72 3e 3d 30  ( pSrc->nUser>=0
60c0: 20 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 53   );.      if( pS
60d0: 72 63 2d 3e 6e 55 73 65 72 3d 3d 30 20 29 7b 0a  rc->nUser==0 ){.
60e0: 20 20 20 20 20 20 20 20 70 53 72 63 2d 3e 70 4e          pSrc->pN
60f0: 65 78 74 43 6c 6f 73 61 62 6c 65 20 3d 20 70 54  extClosable = pT
6100: 61 62 2d 3e 70 43 6c 6f 73 61 62 6c 65 3b 0a 20  ab->pClosable;. 
6110: 20 20 20 20 20 20 20 70 54 61 62 2d 3e 70 43 6c         pTab->pCl
6120: 6f 73 61 62 6c 65 20 3d 20 70 53 72 63 3b 0a 20  osable = pSrc;. 
6130: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 75 6e 69       }.      uni
6140: 6f 6e 43 6c 6f 73 65 53 6f 75 72 63 65 73 28 70  onCloseSources(p
6150: 54 61 62 2c 20 70 54 61 62 2d 3e 6e 4d 61 78 4f  Tab, pTab->nMaxO
6160: 70 65 6e 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  pen);.    }.  }.
6170: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
6180: 2f 2a 20 0a 2a 2a 20 52 65 74 75 72 6e 20 74 72  /* .** Return tr
6190: 75 65 20 69 66 20 74 68 65 20 61 72 67 75 6d 65  ue if the argume
61a0: 6e 74 20 69 73 20 61 20 73 70 61 63 65 2c 20 74  nt is a space, t
61b0: 61 62 2c 20 43 52 20 6f 72 20 4c 46 20 63 68 61  ab, CR or LF cha
61c0: 72 61 63 74 65 72 2e 0a 2a 2f 0a 73 74 61 74 69  racter..*/.stati
61d0: 63 20 69 6e 74 20 75 6e 69 6f 6e 5f 69 73 73 70  c int union_issp
61e0: 61 63 65 28 63 68 61 72 20 63 29 7b 0a 20 20 72  ace(char c){.  r
61f0: 65 74 75 72 6e 20 28 63 3d 3d 27 20 27 20 7c 7c  eturn (c==' ' ||
6200: 20 63 3d 3d 27 5c 6e 27 20 7c 7c 20 63 3d 3d 27   c=='\n' || c=='
6210: 5c 72 27 20 7c 7c 20 63 3d 3d 27 5c 74 27 29 3b  \r' || c=='\t');
6220: 0a 7d 0a 0a 2f 2a 20 0a 2a 2a 20 52 65 74 75 72  .}../* .** Retur
6230: 6e 20 74 72 75 65 20 69 66 20 74 68 65 20 61 72  n true if the ar
6240: 67 75 6d 65 6e 74 20 69 73 20 61 6e 20 61 6c 70  gument is an alp
6250: 68 61 6e 75 6d 65 72 69 63 20 63 68 61 72 61 63  hanumeric charac
6260: 74 65 72 20 69 6e 20 74 68 65 20 0a 2a 2a 20 41  ter in the .** A
6270: 53 43 49 49 20 72 61 6e 67 65 2e 0a 2a 2f 0a 73  SCII range..*/.s
6280: 74 61 74 69 63 20 69 6e 74 20 75 6e 69 6f 6e 5f  tatic int union_
6290: 69 73 69 64 63 68 61 72 28 63 68 61 72 20 63 29  isidchar(char c)
62a0: 7b 0a 20 20 72 65 74 75 72 6e 20 28 28 63 3e 3d  {.  return ((c>=
62b0: 27 61 27 20 26 26 20 63 3c 3d 27 7a 27 29 20 7c  'a' && c<='z') |
62c0: 7c 20 28 63 3e 3d 27 41 27 20 26 26 20 63 3c 27  | (c>='A' && c<'
62d0: 5a 27 29 20 7c 7c 20 28 63 3e 3d 27 30 27 20 26  Z') || (c>='0' &
62e0: 26 20 63 3c 3d 27 39 27 29 29 3b 0a 7d 0a 0a 2f  & c<='9'));.}../
62f0: 2a 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69  *.** This functi
6300: 6f 6e 20 69 73 20 63 61 6c 6c 65 64 20 74 6f 20  on is called to 
6310: 68 61 6e 64 6c 65 20 61 6c 6c 20 61 72 67 75 6d  handle all argum
6320: 65 6e 74 73 20 66 6f 6c 6c 6f 77 69 6e 67 20 74  ents following t
6330: 68 65 20 66 69 72 73 74 20 0a 2a 2a 20 28 74 68  he first .** (th
6340: 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 29  e SQL statement)
6350: 20 70 61 73 73 65 64 20 74 6f 20 61 20 73 77 61   passed to a swa
6360: 72 6d 76 74 61 62 20 28 6e 6f 74 20 75 6e 69 6f  rmvtab (not unio
6370: 6e 76 74 61 62 29 20 43 52 45 41 54 45 20 0a 2a  nvtab) CREATE .*
6380: 2a 20 56 49 52 54 55 41 4c 20 54 41 42 4c 45 20  * VIRTUAL TABLE 
6390: 73 74 61 74 65 6d 65 6e 74 2e 20 49 74 20 6d 61  statement. It ma
63a0: 79 20 62 69 6e 64 20 70 61 72 61 6d 65 74 65 72  y bind parameter
63b0: 73 20 74 6f 20 74 68 65 20 53 51 4c 20 73 74 61  s to the SQL sta
63c0: 74 65 6d 65 6e 74 20 0a 2a 2a 20 6f 72 20 63 6f  tement .** or co
63d0: 6e 66 69 67 75 72 65 20 6d 65 6d 62 65 72 73 20  nfigure members 
63e0: 6f 66 20 74 68 65 20 55 6e 69 6f 6e 54 61 62 20  of the UnionTab 
63f0: 6f 62 6a 65 63 74 20 70 61 73 73 65 64 20 61 73  object passed as
6400: 20 74 68 65 20 73 65 63 6f 6e 64 0a 2a 2a 20 61   the second.** a
6410: 72 67 75 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2a 20 52  rgument..**.** R
6420: 65 66 65 72 20 74 6f 20 68 65 61 64 65 72 20 63  efer to header c
6430: 6f 6d 6d 65 6e 74 73 20 61 74 20 74 68 65 20 74  omments at the t
6440: 6f 70 20 6f 66 20 74 68 69 73 20 66 69 6c 65 20  op of this file 
6450: 66 6f 72 20 61 20 64 65 73 63 72 69 70 74 69 6f  for a descriptio
6460: 6e 0a 2a 2a 20 6f 66 20 74 68 65 20 61 72 67 75  n.** of the argu
6470: 6d 65 6e 74 73 20 70 61 72 73 65 64 2e 0a 2a 2a  ments parsed..**
6480: 0a 2a 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f  .** This functio
6490: 6e 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20  n is a no-op if 
64a0: 2a 70 52 63 20 69 73 20 6f 74 68 65 72 20 74 68  *pRc is other th
64b0: 61 6e 20 53 51 4c 49 54 45 5f 4f 4b 20 77 68 65  an SQLITE_OK whe
64c0: 6e 20 69 74 20 69 73 0a 2a 2a 20 63 61 6c 6c 65  n it is.** calle
64d0: 64 2e 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66  d. Otherwise, if
64e0: 20 61 6e 20 65 72 72 6f 72 20 6f 63 63 75 72 73   an error occurs
64f0: 2c 20 2a 70 52 63 20 69 73 20 73 65 74 20 74 6f  , *pRc is set to
6500: 20 61 6e 20 53 51 4c 69 74 65 20 65 72 72 6f 72   an SQLite error
6510: 0a 2a 2a 20 63 6f 64 65 2e 20 49 6e 20 74 68 69  .** code. In thi
6520: 73 20 63 61 73 65 20 2a 70 7a 45 72 72 20 6d 61  s case *pzErr ma
6530: 79 20 62 65 20 73 65 74 20 74 6f 20 70 6f 69 6e  y be set to poin
6540: 74 20 74 6f 20 61 20 62 75 66 66 65 72 20 63 6f  t to a buffer co
6550: 6e 74 61 69 6e 69 6e 67 0a 2a 2a 20 61 6e 20 45  ntaining.** an E
6560: 6e 67 6c 69 73 68 20 6c 61 6e 67 75 61 67 65 20  nglish language 
6570: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 2e 20 49  error message. I
6580: 74 20 69 73 20 74 68 65 20 72 65 73 70 6f 6e 73  t is the respons
6590: 69 62 69 6c 69 74 79 20 6f 66 20 74 68 65 20 0a  ibility of the .
65a0: 2a 2a 20 63 61 6c 6c 65 72 20 74 6f 20 65 76 65  ** caller to eve
65b0: 6e 74 75 61 6c 6c 79 20 66 72 65 65 20 74 68 65  ntually free the
65c0: 20 62 75 66 66 65 72 20 75 73 69 6e 67 20 73 71   buffer using sq
65d0: 6c 69 74 65 33 5f 66 72 65 65 28 29 2e 0a 2a 2f  lite3_free()..*/
65e0: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 75 6e 69  .static void uni
65f0: 6f 6e 43 6f 6e 66 69 67 75 72 65 56 74 61 62 28  onConfigureVtab(
6600: 0a 20 20 69 6e 74 20 2a 70 52 63 2c 20 20 20 20  .  int *pRc,    
6610: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6620: 20 20 20 2f 2a 20 49 4e 2f 4f 55 54 3a 20 45 72     /* IN/OUT: Er
6630: 72 6f 72 20 63 6f 64 65 20 2a 2f 0a 20 20 55 6e  ror code */.  Un
6640: 69 6f 6e 54 61 62 20 2a 70 54 61 62 2c 20 20 20  ionTab *pTab,   
6650: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
6660: 20 54 61 62 6c 65 20 74 6f 20 63 6f 6e 66 69 67   Table to config
6670: 75 72 65 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ure */.  sqlite3
6680: 5f 73 74 6d 74 20 2a 70 53 74 6d 74 2c 20 20 20  _stmt *pStmt,   
6690: 20 20 20 20 20 20 20 20 20 2f 2a 20 53 51 4c 20           /* SQL 
66a0: 73 74 61 74 65 6d 65 6e 74 20 74 6f 20 66 69 6e  statement to fin
66b0: 64 20 73 6f 75 72 63 65 73 20 2a 2f 0a 20 20 69  d sources */.  i
66c0: 6e 74 20 6e 41 72 67 2c 20 20 20 20 20 20 20 20  nt nArg,        
66d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
66e0: 2a 20 4e 75 6d 62 65 72 20 6f 66 20 65 6e 74 72  * Number of entr
66f0: 69 65 73 20 69 6e 20 61 7a 41 72 67 5b 5d 20 61  ies in azArg[] a
6700: 72 72 61 79 20 2a 2f 0a 20 20 63 6f 6e 73 74 20  rray */.  const 
6710: 63 68 61 72 20 2a 20 63 6f 6e 73 74 20 2a 61 7a  char * const *az
6720: 41 72 67 2c 20 20 20 20 20 20 2f 2a 20 41 72 72  Arg,      /* Arr
6730: 61 79 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20  ay of arguments 
6740: 74 6f 20 63 6f 6e 73 69 64 65 72 20 2a 2f 0a 20  to consider */. 
6750: 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 20 20 20   char **pzErr   
6760: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6770: 20 2f 2a 20 4f 55 54 3a 20 45 72 72 6f 72 20 6d   /* OUT: Error m
6780: 65 73 73 61 67 65 20 2a 2f 0a 29 7b 0a 20 20 69  essage */.){.  i
6790: 6e 74 20 72 63 20 3d 20 2a 70 52 63 3b 0a 20 20  nt rc = *pRc;.  
67a0: 69 6e 74 20 69 3b 0a 20 20 69 66 28 20 72 63 3d  int i;.  if( rc=
67b0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
67c0: 20 20 70 54 61 62 2d 3e 62 48 61 73 43 6f 6e 74    pTab->bHasCont
67d0: 65 78 74 20 3d 20 28 73 71 6c 69 74 65 33 5f 63  ext = (sqlite3_c
67e0: 6f 6c 75 6d 6e 5f 63 6f 75 6e 74 28 70 53 74 6d  olumn_count(pStm
67f0: 74 29 3e 34 29 3b 0a 20 20 7d 0a 20 20 66 6f 72  t)>4);.  }.  for
6800: 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45  (i=0; rc==SQLITE
6810: 5f 4f 4b 20 26 26 20 69 3c 6e 41 72 67 3b 20 69  _OK && i<nArg; i
6820: 2b 2b 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a  ++){.    char *z
6830: 41 72 67 20 3d 20 75 6e 69 6f 6e 53 74 72 64 75  Arg = unionStrdu
6840: 70 28 26 72 63 2c 20 61 7a 41 72 67 5b 69 5d 29  p(&rc, azArg[i])
6850: 3b 0a 20 20 20 20 69 66 28 20 7a 41 72 67 20 29  ;.    if( zArg )
6860: 7b 0a 20 20 20 20 20 20 69 6e 74 20 6e 4f 70 74  {.      int nOpt
6870: 20 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20   = 0;           
6880: 20 20 20 20 2f 2a 20 53 69 7a 65 20 6f 66 20 6f      /* Size of o
6890: 70 74 69 6f 6e 20 6e 61 6d 65 20 69 6e 20 62 79  ption name in by
68a0: 74 65 73 20 2a 2f 0a 20 20 20 20 20 20 63 68 61  tes */.      cha
68b0: 72 20 2a 7a 4f 70 74 3b 20 20 20 20 20 20 20 20  r *zOpt;        
68c0: 20 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e           /* Poin
68d0: 74 65 72 20 74 6f 20 6f 70 74 69 6f 6e 20 6e 61  ter to option na
68e0: 6d 65 20 2a 2f 0a 20 20 20 20 20 20 63 68 61 72  me */.      char
68f0: 20 2a 7a 56 61 6c 3b 20 20 20 20 20 20 20 20 20   *zVal;         
6900: 20 20 20 20 20 20 20 20 2f 2a 20 50 6f 69 6e 74          /* Point
6910: 65 72 20 74 6f 20 76 61 6c 75 65 20 2a 2f 0a 0a  er to value */..
6920: 20 20 20 20 20 20 75 6e 69 6f 6e 44 65 71 75 6f        unionDequo
6930: 74 65 28 7a 41 72 67 29 3b 0a 20 20 20 20 20 20  te(zArg);.      
6940: 7a 4f 70 74 20 3d 20 7a 41 72 67 3b 0a 20 20 20  zOpt = zArg;.   
6950: 20 20 20 77 68 69 6c 65 28 20 75 6e 69 6f 6e 5f     while( union_
6960: 69 73 73 70 61 63 65 28 2a 7a 4f 70 74 29 20 29  isspace(*zOpt) )
6970: 20 7a 4f 70 74 2b 2b 3b 0a 20 20 20 20 20 20 7a   zOpt++;.      z
6980: 56 61 6c 20 3d 20 7a 4f 70 74 3b 0a 20 20 20 20  Val = zOpt;.    
6990: 20 20 69 66 28 20 2a 7a 56 61 6c 3d 3d 27 3a 27    if( *zVal==':'
69a0: 20 29 20 7a 56 61 6c 2b 2b 3b 0a 20 20 20 20 20   ) zVal++;.     
69b0: 20 77 68 69 6c 65 28 20 75 6e 69 6f 6e 5f 69 73   while( union_is
69c0: 69 64 63 68 61 72 28 2a 7a 56 61 6c 29 20 29 20  idchar(*zVal) ) 
69d0: 7a 56 61 6c 2b 2b 3b 0a 20 20 20 20 20 20 6e 4f  zVal++;.      nO
69e0: 70 74 20 3d 20 28 69 6e 74 29 28 7a 56 61 6c 2d  pt = (int)(zVal-
69f0: 7a 4f 70 74 29 3b 0a 0a 20 20 20 20 20 20 77 68  zOpt);..      wh
6a00: 69 6c 65 28 20 75 6e 69 6f 6e 5f 69 73 73 70 61  ile( union_isspa
6a10: 63 65 28 2a 7a 56 61 6c 29 20 29 20 7a 56 61 6c  ce(*zVal) ) zVal
6a20: 2b 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 2a 7a  ++;.      if( *z
6a30: 56 61 6c 3d 3d 27 3d 27 20 29 7b 0a 20 20 20 20  Val=='=' ){.    
6a40: 20 20 20 20 7a 4f 70 74 5b 6e 4f 70 74 5d 20 3d      zOpt[nOpt] =
6a50: 20 27 5c 30 27 3b 0a 20 20 20 20 20 20 20 20 7a   '\0';.        z
6a60: 56 61 6c 2b 2b 3b 0a 20 20 20 20 20 20 20 20 77  Val++;.        w
6a70: 68 69 6c 65 28 20 75 6e 69 6f 6e 5f 69 73 73 70  hile( union_issp
6a80: 61 63 65 28 2a 7a 56 61 6c 29 20 29 20 7a 56 61  ace(*zVal) ) zVa
6a90: 6c 2b 2b 3b 0a 20 20 20 20 20 20 20 20 7a 56 61  l++;.        zVa
6aa0: 6c 20 3d 20 75 6e 69 6f 6e 53 74 72 64 75 70 28  l = unionStrdup(
6ab0: 26 72 63 2c 20 7a 56 61 6c 29 3b 0a 20 20 20 20  &rc, zVal);.    
6ac0: 20 20 20 20 69 66 28 20 7a 56 61 6c 20 29 7b 0a      if( zVal ){.
6ad0: 20 20 20 20 20 20 20 20 20 20 75 6e 69 6f 6e 44            unionD
6ae0: 65 71 75 6f 74 65 28 7a 56 61 6c 29 3b 0a 20 20  equote(zVal);.  
6af0: 20 20 20 20 20 20 20 20 69 66 28 20 7a 4f 70 74          if( zOpt
6b00: 5b 30 5d 3d 3d 27 3a 27 20 29 7b 0a 20 20 20 20  [0]==':' ){.    
6b10: 20 20 20 20 20 20 20 20 2f 2a 20 41 20 76 61 6c          /* A val
6b20: 75 65 20 74 6f 20 62 69 6e 64 20 74 6f 20 74 68  ue to bind to th
6b30: 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20  e SQL statement 
6b40: 2a 2f 0a 20 20 20 20 20 20 20 20 20 20 20 20 69  */.            i
6b50: 6e 74 20 69 50 61 72 61 6d 20 3d 20 73 71 6c 69  nt iParam = sqli
6b60: 74 65 33 5f 62 69 6e 64 5f 70 61 72 61 6d 65 74  te3_bind_paramet
6b70: 65 72 5f 69 6e 64 65 78 28 70 53 74 6d 74 2c 20  er_index(pStmt, 
6b80: 7a 4f 70 74 29 3b 0a 20 20 20 20 20 20 20 20 20  zOpt);.         
6b90: 20 20 20 69 66 28 20 69 50 61 72 61 6d 3d 3d 30     if( iParam==0
6ba0: 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20 20 20   ){.            
6bb0: 20 20 2a 70 7a 45 72 72 20 3d 20 73 71 6c 69 74    *pzErr = sqlit
6bc0: 65 33 5f 6d 70 72 69 6e 74 66 28 0a 20 20 20 20  e3_mprintf(.    
6bd0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 22 73                "s
6be0: 77 61 72 6d 76 74 61 62 3a 20 6e 6f 20 73 75 63  warmvtab: no suc
6bf0: 68 20 53 51 4c 20 70 61 72 61 6d 65 74 65 72 3a  h SQL parameter:
6c00: 20 25 73 22 2c 20 7a 4f 70 74 0a 20 20 20 20 20   %s", zOpt.     
6c10: 20 20 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20           );.    
6c20: 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53            rc = S
6c30: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20  QLITE_ERROR;.   
6c40: 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a           }else{.
6c50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 72 63                rc
6c60: 20 3d 20 73 71 6c 69 74 65 33 5f 62 69 6e 64 5f   = sqlite3_bind_
6c70: 74 65 78 74 28 70 53 74 6d 74 2c 20 69 50 61 72  text(pStmt, iPar
6c80: 61 6d 2c 20 7a 56 61 6c 2c 20 2d 31 2c 20 53 51  am, zVal, -1, SQ
6c90: 4c 49 54 45 5f 54 52 41 4e 53 49 45 4e 54 29 3b  LITE_TRANSIENT);
6ca0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20  .            }. 
6cb0: 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69           }else i
6cc0: 66 28 20 6e 4f 70 74 3d 3d 37 20 26 26 20 30 3d  f( nOpt==7 && 0=
6cd0: 3d 73 71 6c 69 74 65 33 5f 73 74 72 6e 69 63 6d  =sqlite3_strnicm
6ce0: 70 28 7a 4f 70 74 2c 20 22 6d 61 78 6f 70 65 6e  p(zOpt, "maxopen
6cf0: 22 2c 20 37 29 20 29 7b 0a 20 20 20 20 20 20 20  ", 7) ){.       
6d00: 20 20 20 20 20 70 54 61 62 2d 3e 6e 4d 61 78 4f       pTab->nMaxO
6d10: 70 65 6e 20 3d 20 61 74 6f 69 28 7a 56 61 6c 29  pen = atoi(zVal)
6d20: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 69 66  ;.            if
6d30: 28 20 70 54 61 62 2d 3e 6e 4d 61 78 4f 70 65 6e  ( pTab->nMaxOpen
6d40: 3c 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20  <=0 ){.         
6d50: 20 20 20 20 20 2a 70 7a 45 72 72 20 3d 20 73 71       *pzErr = sq
6d60: 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 73  lite3_mprintf("s
6d70: 77 61 72 6d 76 74 61 62 3a 20 69 6c 6c 65 67 61  warmvtab: illega
6d80: 6c 20 6d 61 78 6f 70 65 6e 20 76 61 6c 75 65 22  l maxopen value"
6d90: 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  );.             
6da0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52   rc = SQLITE_ERR
6db0: 4f 52 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20  OR;.            
6dc0: 7d 0a 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73  }.          }els
6dd0: 65 20 69 66 28 20 6e 4f 70 74 3d 3d 37 20 26 26  e if( nOpt==7 &&
6de0: 20 30 3d 3d 73 71 6c 69 74 65 33 5f 73 74 72 6e   0==sqlite3_strn
6df0: 69 63 6d 70 28 7a 4f 70 74 2c 20 22 6d 69 73 73  icmp(zOpt, "miss
6e00: 69 6e 67 22 2c 20 37 29 20 29 7b 0a 20 20 20 20  ing", 7) ){.    
6e10: 20 20 20 20 20 20 20 20 69 66 28 20 70 54 61 62          if( pTab
6e20: 2d 3e 70 4e 6f 74 46 6f 75 6e 64 20 29 7b 0a 20  ->pNotFound ){. 
6e30: 20 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 7a               *pz
6e40: 45 72 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70  Err = sqlite3_mp
6e50: 72 69 6e 74 66 28 0a 20 20 20 20 20 20 20 20 20  rintf(.         
6e60: 20 20 20 20 20 20 20 20 20 22 73 77 61 72 6d 76           "swarmv
6e70: 74 61 62 3a 20 64 75 70 6c 69 63 61 74 65 20 5c  tab: duplicate \
6e80: 22 6d 69 73 73 69 6e 67 5c 22 20 6f 70 74 69 6f  "missing\" optio
6e90: 6e 22 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20  n");.           
6ea0: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45     rc = SQLITE_E
6eb0: 52 52 4f 52 3b 0a 20 20 20 20 20 20 20 20 20 20  RROR;.          
6ec0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
6ed0: 20 20 20 20 20 20 20 70 54 61 62 2d 3e 70 4e 6f         pTab->pNo
6ee0: 74 46 6f 75 6e 64 20 3d 20 75 6e 69 6f 6e 50 72  tFound = unionPr
6ef0: 65 70 61 72 65 50 72 69 6e 74 66 28 26 72 63 2c  eparePrintf(&rc,
6f00: 20 70 7a 45 72 72 2c 20 70 54 61 62 2d 3e 64 62   pzErr, pTab->db
6f10: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,.              
6f20: 20 20 20 20 22 53 45 4c 45 43 54 20 5c 22 25 77      "SELECT \"%w
6f30: 5c 22 28 3f 25 73 29 22 2c 20 7a 56 61 6c 2c 20  \"(?%s)", zVal, 
6f40: 70 54 61 62 2d 3e 62 48 61 73 43 6f 6e 74 65 78  pTab->bHasContex
6f50: 74 20 3f 20 22 2c 3f 22 20 3a 20 22 22 0a 20 20  t ? ",?" : "".  
6f60: 20 20 20 20 20 20 20 20 20 20 20 20 29 3b 0a 20              );. 
6f70: 20 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20             }.   
6f80: 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69 66 28         }else if(
6f90: 20 6e 4f 70 74 3d 3d 39 20 26 26 20 30 3d 3d 73   nOpt==9 && 0==s
6fa0: 71 6c 69 74 65 33 5f 73 74 72 6e 69 63 6d 70 28  qlite3_strnicmp(
6fb0: 7a 4f 70 74 2c 20 22 6f 70 65 6e 63 6c 6f 73 65  zOpt, "openclose
6fc0: 22 2c 20 39 29 20 29 7b 0a 20 20 20 20 20 20 20  ", 9) ){.       
6fd0: 20 20 20 20 20 69 66 28 20 70 54 61 62 2d 3e 70       if( pTab->p
6fe0: 4f 70 65 6e 43 6c 6f 73 65 20 29 7b 0a 20 20 20  OpenClose ){.   
6ff0: 20 20 20 20 20 20 20 20 20 20 20 2a 70 7a 45 72             *pzEr
7000: 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69  r = sqlite3_mpri
7010: 6e 74 66 28 0a 20 20 20 20 20 20 20 20 20 20 20  ntf(.           
7020: 20 20 20 20 20 20 20 22 73 77 61 72 6d 76 74 61         "swarmvta
7030: 62 3a 20 64 75 70 6c 69 63 61 74 65 20 5c 22 6f  b: duplicate \"o
7040: 70 65 6e 63 6c 6f 73 65 5c 22 20 6f 70 74 69 6f  penclose\" optio
7050: 6e 22 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20  n");.           
7060: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45     rc = SQLITE_E
7070: 52 52 4f 52 3b 0a 20 20 20 20 20 20 20 20 20 20  RROR;.          
7080: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
7090: 20 20 20 20 20 20 20 70 54 61 62 2d 3e 70 4f 70         pTab->pOp
70a0: 65 6e 43 6c 6f 73 65 20 3d 20 75 6e 69 6f 6e 50  enClose = unionP
70b0: 72 65 70 61 72 65 50 72 69 6e 74 66 28 26 72 63  reparePrintf(&rc
70c0: 2c 20 70 7a 45 72 72 2c 20 70 54 61 62 2d 3e 64  , pzErr, pTab->d
70d0: 62 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  b,.             
70e0: 20 20 20 20 20 22 53 45 4c 45 43 54 20 5c 22 25       "SELECT \"%
70f0: 77 5c 22 28 3f 2c 3f 25 73 29 22 2c 20 7a 56 61  w\"(?,?%s)", zVa
7100: 6c 2c 20 70 54 61 62 2d 3e 62 48 61 73 43 6f 6e  l, pTab->bHasCon
7110: 74 65 78 74 20 3f 20 22 2c 3f 22 20 3a 20 22 22  text ? ",?" : ""
7120: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 29  .              )
7130: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 7d 0a  ;.            }.
7140: 20 20 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b            }else{
7150: 0a 20 20 20 20 20 20 20 20 20 20 20 20 2a 70 7a  .            *pz
7160: 45 72 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70  Err = sqlite3_mp
7170: 72 69 6e 74 66 28 22 73 77 61 72 6d 76 74 61 62  rintf("swarmvtab
7180: 3a 20 75 6e 72 65 63 6f 67 6e 69 7a 65 64 20 6f  : unrecognized o
7190: 70 74 69 6f 6e 3a 20 25 73 22 2c 7a 4f 70 74 29  ption: %s",zOpt)
71a0: 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20 72 63  ;.            rc
71b0: 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b   = SQLITE_ERROR;
71c0: 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20 20  .          }.   
71d0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 5f 66         sqlite3_f
71e0: 72 65 65 28 7a 56 61 6c 29 3b 0a 20 20 20 20 20  ree(zVal);.     
71f0: 20 20 20 7d 0a 20 20 20 20 20 20 7d 65 6c 73 65     }.      }else
7200: 7b 0a 20 20 20 20 20 20 20 20 69 66 28 20 69 3d  {.        if( i=
7210: 3d 30 20 26 26 20 6e 41 72 67 3d 3d 31 20 29 7b  =0 && nArg==1 ){
7220: 0a 20 20 20 20 20 20 20 20 20 20 70 54 61 62 2d  .          pTab-
7230: 3e 70 4e 6f 74 46 6f 75 6e 64 20 3d 20 75 6e 69  >pNotFound = uni
7240: 6f 6e 50 72 65 70 61 72 65 50 72 69 6e 74 66 28  onPreparePrintf(
7250: 26 72 63 2c 20 70 7a 45 72 72 2c 20 70 54 61 62  &rc, pzErr, pTab
7260: 2d 3e 64 62 2c 0a 20 20 20 20 20 20 20 20 20 20  ->db,.          
7270: 20 20 20 20 22 53 45 4c 45 43 54 20 5c 22 25 77      "SELECT \"%w
7280: 5c 22 28 3f 29 22 2c 20 7a 41 72 67 0a 20 20 20  \"(?)", zArg.   
7290: 20 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20         );.      
72a0: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20    }else{.       
72b0: 20 20 20 2a 70 7a 45 72 72 20 3d 20 73 71 6c 69     *pzErr = sqli
72c0: 74 65 33 5f 6d 70 72 69 6e 74 66 28 20 22 73 77  te3_mprintf( "sw
72d0: 61 72 6d 76 74 61 62 3a 20 70 61 72 73 65 20 65  armvtab: parse e
72e0: 72 72 6f 72 3a 20 25 73 22 2c 20 61 7a 41 72 67  rror: %s", azArg
72f0: 5b 69 5d 29 3b 0a 20 20 20 20 20 20 20 20 20 20  [i]);.          
7300: 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f  rc = SQLITE_ERRO
7310: 52 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20  R;.        }.   
7320: 20 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74     }.      sqlit
7330: 65 33 5f 66 72 65 65 28 7a 41 72 67 29 3b 0a 20  e3_free(zArg);. 
7340: 20 20 20 7d 0a 20 20 7d 0a 20 20 2a 70 52 63 20     }.  }.  *pRc 
7350: 3d 20 72 63 3b 0a 7d 0a 0a 2f 2a 20 0a 2a 2a 20  = rc;.}../* .** 
7360: 78 43 6f 6e 6e 65 63 74 2f 78 43 72 65 61 74 65  xConnect/xCreate
7370: 20 6d 65 74 68 6f 64 2e 0a 2a 2a 0a 2a 2a 20 54   method..**.** T
7380: 68 65 20 61 72 67 76 5b 5d 20 61 72 72 61 79 20  he argv[] array 
7390: 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 66 6f 6c  contains the fol
73a0: 6c 6f 77 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20  lowing:.**.**   
73b0: 61 72 67 76 5b 30 5d 20 20 20 2d 3e 20 6d 6f 64  argv[0]   -> mod
73c0: 75 6c 65 20 6e 61 6d 65 20 20 28 22 75 6e 69 6f  ule name  ("unio
73d0: 6e 76 74 61 62 22 20 6f 72 20 22 73 77 61 72 6d  nvtab" or "swarm
73e0: 76 74 61 62 22 29 0a 2a 2a 20 20 20 61 72 67 76  vtab").**   argv
73f0: 5b 31 5d 20 20 20 2d 3e 20 64 61 74 61 62 61 73  [1]   -> databas
7400: 65 20 6e 61 6d 65 0a 2a 2a 20 20 20 61 72 67 76  e name.**   argv
7410: 5b 32 5d 20 20 20 2d 3e 20 74 61 62 6c 65 20 6e  [2]   -> table n
7420: 61 6d 65 0a 2a 2a 20 20 20 61 72 67 76 5b 33 5d  ame.**   argv[3]
7430: 20 20 20 2d 3e 20 53 51 4c 20 73 74 61 74 65 6d     -> SQL statem
7440: 65 6e 74 0a 2a 2a 20 20 20 61 72 67 76 5b 34 5d  ent.**   argv[4]
7450: 20 20 20 2d 3e 20 6e 6f 74 2d 66 6f 75 6e 64 20     -> not-found 
7460: 63 61 6c 6c 62 61 63 6b 20 55 44 46 20 6e 61 6d  callback UDF nam
7470: 65 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  e.*/.static int 
7480: 75 6e 69 6f 6e 43 6f 6e 6e 65 63 74 28 0a 20 20  unionConnect(.  
7490: 73 71 6c 69 74 65 33 20 2a 64 62 2c 0a 20 20 76  sqlite3 *db,.  v
74a0: 6f 69 64 20 2a 70 41 75 78 2c 0a 20 20 69 6e 74  oid *pAux,.  int
74b0: 20 61 72 67 63 2c 20 63 6f 6e 73 74 20 63 68 61   argc, const cha
74c0: 72 20 2a 63 6f 6e 73 74 2a 61 72 67 76 2c 0a 20  r *const*argv,. 
74d0: 20 73 71 6c 69 74 65 33 5f 76 74 61 62 20 2a 2a   sqlite3_vtab **
74e0: 70 70 56 74 61 62 2c 0a 20 20 63 68 61 72 20 2a  ppVtab,.  char *
74f0: 2a 70 7a 45 72 72 0a 29 7b 0a 20 20 55 6e 69 6f  *pzErr.){.  Unio
7500: 6e 54 61 62 20 2a 70 54 61 62 20 3d 20 30 3b 0a  nTab *pTab = 0;.
7510: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
7520: 45 5f 4f 4b 3b 0a 20 20 69 6e 74 20 62 53 77 61  E_OK;.  int bSwa
7530: 72 6d 20 3d 20 28 70 41 75 78 3d 3d 30 20 3f 20  rm = (pAux==0 ? 
7540: 30 20 3a 20 31 29 3b 0a 20 20 63 6f 6e 73 74 20  0 : 1);.  const 
7550: 63 68 61 72 20 2a 7a 56 74 61 62 20 3d 20 28 62  char *zVtab = (b
7560: 53 77 61 72 6d 20 3f 20 22 73 77 61 72 6d 76 74  Swarm ? "swarmvt
7570: 61 62 22 20 3a 20 22 75 6e 69 6f 6e 76 74 61 62  ab" : "unionvtab
7580: 22 29 3b 0a 0a 20 20 69 66 28 20 73 71 6c 69 74  ");..  if( sqlit
7590: 65 33 5f 73 74 72 69 63 6d 70 28 22 74 65 6d 70  e3_stricmp("temp
75a0: 22 2c 20 61 72 67 76 5b 31 5d 29 20 29 7b 0a 20  ", argv[1]) ){. 
75b0: 20 20 20 2f 2a 20 75 6e 69 6f 6e 76 74 61 62 20     /* unionvtab 
75c0: 74 61 62 6c 65 73 20 6d 61 79 20 6f 6e 6c 79 20  tables may only 
75d0: 62 65 20 63 72 65 61 74 65 64 20 69 6e 20 74 68  be created in th
75e0: 65 20 74 65 6d 70 20 73 63 68 65 6d 61 20 2a 2f  e temp schema */
75f0: 0a 20 20 20 20 2a 70 7a 45 72 72 20 3d 20 73 71  .    *pzErr = sq
7600: 6c 69 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 25  lite3_mprintf("%
7610: 73 20 74 61 62 6c 65 73 20 6d 75 73 74 20 62 65  s tables must be
7620: 20 63 72 65 61 74 65 64 20 69 6e 20 54 45 4d 50   created in TEMP
7630: 20 73 63 68 65 6d 61 22 2c 20 7a 56 74 61 62 29   schema", zVtab)
7640: 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  ;.    rc = SQLIT
7650: 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 65 6c 73 65  E_ERROR;.  }else
7660: 20 69 66 28 20 61 72 67 63 3c 34 20 7c 7c 20 28   if( argc<4 || (
7670: 61 72 67 63 3e 34 20 26 26 20 62 53 77 61 72 6d  argc>4 && bSwarm
7680: 3d 3d 30 29 20 29 7b 0a 20 20 20 20 2a 70 7a 45  ==0) ){.    *pzE
7690: 72 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72  rr = sqlite3_mpr
76a0: 69 6e 74 66 28 22 77 72 6f 6e 67 20 6e 75 6d 62  intf("wrong numb
76b0: 65 72 20 6f 66 20 61 72 67 75 6d 65 6e 74 73 20  er of arguments 
76c0: 66 6f 72 20 25 73 22 2c 20 7a 56 74 61 62 29 3b  for %s", zVtab);
76d0: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
76e0: 5f 45 52 52 4f 52 3b 0a 20 20 7d 65 6c 73 65 7b  _ERROR;.  }else{
76f0: 0a 20 20 20 20 69 6e 74 20 6e 41 6c 6c 6f 63 20  .    int nAlloc 
7700: 3d 20 30 3b 20 20 20 20 20 20 20 20 20 20 20 20  = 0;            
7710: 20 20 20 2f 2a 20 41 6c 6c 6f 63 61 74 65 64 20     /* Allocated 
7720: 73 69 7a 65 20 6f 66 20 70 54 61 62 2d 3e 61 53  size of pTab->aS
7730: 72 63 5b 5d 20 2a 2f 0a 20 20 20 20 73 71 6c 69  rc[] */.    sqli
7740: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 20  te3_stmt *pStmt 
7750: 3d 20 30 3b 20 20 20 20 20 20 2f 2a 20 41 72 67  = 0;      /* Arg
7760: 75 6d 65 6e 74 20 73 74 61 74 65 6d 65 6e 74 20  ument statement 
7770: 2a 2f 0a 20 20 20 20 63 68 61 72 20 2a 7a 41 72  */.    char *zAr
7780: 67 20 3d 20 75 6e 69 6f 6e 53 74 72 64 75 70 28  g = unionStrdup(
7790: 26 72 63 2c 20 61 72 67 76 5b 33 5d 29 3b 20 20  &rc, argv[3]);  
77a0: 20 20 20 20 2f 2a 20 43 6f 70 79 20 6f 66 20 61      /* Copy of a
77b0: 72 67 75 6d 65 6e 74 20 74 6f 20 43 56 54 20 2a  rgument to CVT *
77c0: 2f 0a 0a 20 20 20 20 2f 2a 20 50 72 65 70 61 72  /..    /* Prepar
77d0: 65 20 74 68 65 20 53 51 4c 20 73 74 61 74 65 6d  e the SQL statem
77e0: 65 6e 74 2e 20 49 6e 73 74 65 61 64 20 6f 66 20  ent. Instead of 
77f0: 65 78 65 63 75 74 69 6e 67 20 69 74 20 64 69 72  executing it dir
7800: 65 63 74 6c 79 2c 20 73 6f 72 74 0a 20 20 20 20  ectly, sort.    
7810: 2a 2a 20 74 68 65 20 72 65 73 75 6c 74 73 20 62  ** the results b
7820: 79 20 74 68 65 20 22 6d 69 6e 69 6d 75 6d 20 72  y the "minimum r
7830: 6f 77 69 64 22 20 66 69 65 6c 64 2e 20 54 68 69  owid" field. Thi
7840: 73 20 6d 61 6b 65 73 20 69 74 20 65 61 73 69 65  s makes it easie
7850: 72 20 74 6f 0a 20 20 20 20 2a 2a 20 63 68 65 63  r to.    ** chec
7860: 6b 20 74 68 61 74 20 74 68 65 72 65 20 61 72 65  k that there are
7870: 20 6e 6f 20 72 6f 77 69 64 20 72 61 6e 67 65 20   no rowid range 
7880: 6f 76 65 72 6c 61 70 73 20 62 65 74 77 65 65 6e  overlaps between
7890: 20 73 6f 75 72 63 65 20 74 61 62 6c 65 73 20 0a   source tables .
78a0: 20 20 20 20 2a 2a 20 61 6e 64 20 74 68 61 74 20      ** and that 
78b0: 74 68 65 20 55 6e 69 6f 6e 54 61 62 2e 61 53 72  the UnionTab.aSr
78c0: 63 5b 5d 20 61 72 72 61 79 20 69 73 20 61 6c 77  c[] array is alw
78d0: 61 79 73 20 73 6f 72 74 65 64 20 62 79 20 72 6f  ays sorted by ro
78e0: 77 69 64 2e 20 20 2a 2f 0a 20 20 20 20 75 6e 69  wid.  */.    uni
78f0: 6f 6e 44 65 71 75 6f 74 65 28 7a 41 72 67 29 3b  onDequote(zArg);
7900: 0a 20 20 20 20 70 53 74 6d 74 20 3d 20 75 6e 69  .    pStmt = uni
7910: 6f 6e 50 72 65 70 61 72 65 50 72 69 6e 74 66 28  onPreparePrintf(
7920: 26 72 63 2c 20 70 7a 45 72 72 2c 20 64 62 2c 20  &rc, pzErr, db, 
7930: 0a 20 20 20 20 20 20 20 20 22 53 45 4c 45 43 54  .        "SELECT
7940: 20 2a 20 46 52 4f 4d 20 28 25 7a 29 20 4f 52 44   * FROM (%z) ORD
7950: 45 52 20 42 59 20 33 22 2c 20 7a 41 72 67 0a 20  ER BY 3", zArg. 
7960: 20 20 20 29 3b 0a 0a 20 20 20 20 2f 2a 20 41 6c     );..    /* Al
7970: 6c 6f 63 61 74 65 20 74 68 65 20 55 6e 69 6f 6e  locate the Union
7980: 54 61 62 20 73 74 72 75 63 74 75 72 65 20 2a 2f  Tab structure */
7990: 0a 20 20 20 20 70 54 61 62 20 3d 20 75 6e 69 6f  .    pTab = unio
79a0: 6e 4d 61 6c 6c 6f 63 28 26 72 63 2c 20 73 69 7a  nMalloc(&rc, siz
79b0: 65 6f 66 28 55 6e 69 6f 6e 54 61 62 29 29 3b 0a  eof(UnionTab));.
79c0: 20 20 20 20 69 66 28 20 70 54 61 62 20 29 7b 0a      if( pTab ){.
79d0: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 72 63        assert( rc
79e0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 3b 0a 20  ==SQLITE_OK );. 
79f0: 20 20 20 20 20 70 54 61 62 2d 3e 64 62 20 3d 20       pTab->db = 
7a00: 64 62 3b 0a 20 20 20 20 20 20 70 54 61 62 2d 3e  db;.      pTab->
7a10: 62 53 77 61 72 6d 20 3d 20 62 53 77 61 72 6d 3b  bSwarm = bSwarm;
7a20: 0a 20 20 20 20 20 20 70 54 61 62 2d 3e 6e 4d 61  .      pTab->nMa
7a30: 78 4f 70 65 6e 20 3d 20 53 57 41 52 4d 56 54 41  xOpen = SWARMVTA
7a40: 42 5f 4d 41 58 5f 4f 50 45 4e 3b 0a 20 20 20 20  B_MAX_OPEN;.    
7a50: 7d 0a 0a 20 20 20 20 2f 2a 20 50 61 72 73 65 20  }..    /* Parse 
7a60: 6f 74 68 65 72 20 43 56 54 20 61 72 67 75 6d 65  other CVT argume
7a70: 6e 74 73 2c 20 69 66 20 61 6e 79 20 2a 2f 0a 20  nts, if any */. 
7a80: 20 20 20 69 66 28 20 62 53 77 61 72 6d 20 29 7b     if( bSwarm ){
7a90: 0a 20 20 20 20 20 20 75 6e 69 6f 6e 43 6f 6e 66  .      unionConf
7aa0: 69 67 75 72 65 56 74 61 62 28 26 72 63 2c 20 70  igureVtab(&rc, p
7ab0: 54 61 62 2c 20 70 53 74 6d 74 2c 20 61 72 67 63  Tab, pStmt, argc
7ac0: 2d 34 2c 20 26 61 72 67 76 5b 34 5d 2c 20 70 7a  -4, &argv[4], pz
7ad0: 45 72 72 29 3b 0a 20 20 20 20 7d 0a 0a 20 20 20  Err);.    }..   
7ae0: 20 2f 2a 20 49 74 65 72 61 74 65 20 74 68 72 6f   /* Iterate thro
7af0: 75 67 68 20 74 68 65 20 72 6f 77 73 20 72 65 74  ugh the rows ret
7b00: 75 72 6e 65 64 20 62 79 20 74 68 65 20 53 51 4c  urned by the SQL
7b10: 20 73 74 61 74 65 6d 65 6e 74 20 73 70 65 63 69   statement speci
7b20: 66 69 65 64 0a 20 20 20 20 2a 2a 20 61 73 20 61  fied.    ** as a
7b30: 6e 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 74 68  n argument to th
7b40: 65 20 43 52 45 41 54 45 20 56 49 52 54 55 41 4c  e CREATE VIRTUAL
7b50: 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e 74   TABLE statement
7b60: 2e 20 2a 2f 0a 20 20 20 20 77 68 69 6c 65 28 20  . */.    while( 
7b70: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc==SQLITE_OK &&
7b80: 20 53 51 4c 49 54 45 5f 52 4f 57 3d 3d 73 71 6c   SQLITE_ROW==sql
7b90: 69 74 65 33 5f 73 74 65 70 28 70 53 74 6d 74 29  ite3_step(pStmt)
7ba0: 20 29 7b 0a 20 20 20 20 20 20 63 6f 6e 73 74 20   ){.      const 
7bb0: 63 68 61 72 20 2a 7a 44 62 20 3d 20 28 63 6f 6e  char *zDb = (con
7bc0: 73 74 20 63 68 61 72 2a 29 73 71 6c 69 74 65 33  st char*)sqlite3
7bd0: 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 70 53 74  _column_text(pSt
7be0: 6d 74 2c 20 30 29 3b 0a 20 20 20 20 20 20 63 6f  mt, 0);.      co
7bf0: 6e 73 74 20 63 68 61 72 20 2a 7a 54 61 62 20 3d  nst char *zTab =
7c00: 20 28 63 6f 6e 73 74 20 63 68 61 72 2a 29 73 71   (const char*)sq
7c10: 6c 69 74 65 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78  lite3_column_tex
7c20: 74 28 70 53 74 6d 74 2c 20 31 29 3b 0a 20 20 20  t(pStmt, 1);.   
7c30: 20 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34     sqlite3_int64
7c40: 20 69 4d 69 6e 20 3d 20 73 71 6c 69 74 65 33 5f   iMin = sqlite3_
7c50: 63 6f 6c 75 6d 6e 5f 69 6e 74 36 34 28 70 53 74  column_int64(pSt
7c60: 6d 74 2c 20 32 29 3b 0a 20 20 20 20 20 20 73 71  mt, 2);.      sq
7c70: 6c 69 74 65 33 5f 69 6e 74 36 34 20 69 4d 61 78  lite3_int64 iMax
7c80: 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d   = sqlite3_colum
7c90: 6e 5f 69 6e 74 36 34 28 70 53 74 6d 74 2c 20 33  n_int64(pStmt, 3
7ca0: 29 3b 0a 20 20 20 20 20 20 55 6e 69 6f 6e 53 72  );.      UnionSr
7cb0: 63 20 2a 70 53 72 63 3b 0a 0a 20 20 20 20 20 20  c *pSrc;..      
7cc0: 2f 2a 20 47 72 6f 77 20 74 68 65 20 70 54 61 62  /* Grow the pTab
7cd0: 2d 3e 61 53 72 63 5b 5d 20 61 72 72 61 79 20 69  ->aSrc[] array i
7ce0: 66 20 72 65 71 75 69 72 65 64 2e 20 2a 2f 0a 20  f required. */. 
7cf0: 20 20 20 20 20 69 66 28 20 6e 41 6c 6c 6f 63 3c       if( nAlloc<
7d00: 3d 70 54 61 62 2d 3e 6e 53 72 63 20 29 7b 0a 20  =pTab->nSrc ){. 
7d10: 20 20 20 20 20 20 20 69 6e 74 20 6e 4e 65 77 20         int nNew 
7d20: 3d 20 6e 41 6c 6c 6f 63 20 3f 20 6e 41 6c 6c 6f  = nAlloc ? nAllo
7d30: 63 2a 32 20 3a 20 38 3b 0a 20 20 20 20 20 20 20  c*2 : 8;.       
7d40: 20 55 6e 69 6f 6e 53 72 63 20 2a 61 4e 65 77 20   UnionSrc *aNew 
7d50: 3d 20 28 55 6e 69 6f 6e 53 72 63 2a 29 73 71 6c  = (UnionSrc*)sql
7d60: 69 74 65 33 5f 72 65 61 6c 6c 6f 63 36 34 28 0a  ite3_realloc64(.
7d70: 20 20 20 20 20 20 20 20 20 20 20 20 70 54 61 62              pTab
7d80: 2d 3e 61 53 72 63 2c 20 6e 4e 65 77 2a 73 69 7a  ->aSrc, nNew*siz
7d90: 65 6f 66 28 55 6e 69 6f 6e 53 72 63 29 0a 20 20  eof(UnionSrc).  
7da0: 20 20 20 20 20 20 29 3b 0a 20 20 20 20 20 20 20        );.       
7db0: 20 69 66 28 20 61 4e 65 77 3d 3d 30 20 29 7b 0a   if( aNew==0 ){.
7dc0: 20 20 20 20 20 20 20 20 20 20 72 63 20 3d 20 53            rc = S
7dd0: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 20  QLITE_NOMEM;.   
7de0: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
7df0: 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20        }else{.   
7e00: 20 20 20 20 20 20 20 6d 65 6d 73 65 74 28 26 61         memset(&a
7e10: 4e 65 77 5b 70 54 61 62 2d 3e 6e 53 72 63 5d 2c  New[pTab->nSrc],
7e20: 20 30 2c 20 28 6e 4e 65 77 2d 70 54 61 62 2d 3e   0, (nNew-pTab->
7e30: 6e 53 72 63 29 2a 73 69 7a 65 6f 66 28 55 6e 69  nSrc)*sizeof(Uni
7e40: 6f 6e 53 72 63 29 29 3b 0a 20 20 20 20 20 20 20  onSrc));.       
7e50: 20 20 20 70 54 61 62 2d 3e 61 53 72 63 20 3d 20     pTab->aSrc = 
7e60: 61 4e 65 77 3b 0a 20 20 20 20 20 20 20 20 20 20  aNew;.          
7e70: 6e 41 6c 6c 6f 63 20 3d 20 6e 4e 65 77 3b 0a 20  nAlloc = nNew;. 
7e80: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d         }.      }
7e90: 0a 0a 20 20 20 20 20 20 2f 2a 20 43 68 65 63 6b  ..      /* Check
7ea0: 20 66 6f 72 20 70 72 6f 62 6c 65 6d 73 20 77 69   for problems wi
7eb0: 74 68 20 74 68 65 20 73 70 65 63 69 66 69 65 64  th the specified
7ec0: 20 72 61 6e 67 65 20 6f 66 20 72 6f 77 69 64 73   range of rowids
7ed0: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 69 4d   */.      if( iM
7ee0: 61 78 3c 69 4d 69 6e 20 7c 7c 20 28 70 54 61 62  ax<iMin || (pTab
7ef0: 2d 3e 6e 53 72 63 3e 30 20 26 26 20 69 4d 69 6e  ->nSrc>0 && iMin
7f00: 3c 3d 70 54 61 62 2d 3e 61 53 72 63 5b 70 54 61  <=pTab->aSrc[pTa
7f10: 62 2d 3e 6e 53 72 63 2d 31 5d 2e 69 4d 61 78 29  b->nSrc-1].iMax)
7f20: 20 29 7b 0a 20 20 20 20 20 20 20 20 2a 70 7a 45   ){.        *pzE
7f30: 72 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72  rr = sqlite3_mpr
7f40: 69 6e 74 66 28 22 72 6f 77 69 64 20 72 61 6e 67  intf("rowid rang
7f50: 65 20 6d 69 73 6d 61 74 63 68 20 65 72 72 6f 72  e mismatch error
7f60: 22 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d  ");.        rc =
7f70: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20   SQLITE_ERROR;. 
7f80: 20 20 20 20 20 7d 0a 0a 20 20 20 20 20 20 69 66       }..      if
7f90: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
7fa0: 29 7b 0a 20 20 20 20 20 20 20 20 70 53 72 63 20  ){.        pSrc 
7fb0: 3d 20 26 70 54 61 62 2d 3e 61 53 72 63 5b 70 54  = &pTab->aSrc[pT
7fc0: 61 62 2d 3e 6e 53 72 63 2b 2b 5d 3b 0a 20 20 20  ab->nSrc++];.   
7fd0: 20 20 20 20 20 70 53 72 63 2d 3e 7a 54 61 62 20       pSrc->zTab 
7fe0: 3d 20 75 6e 69 6f 6e 53 74 72 64 75 70 28 26 72  = unionStrdup(&r
7ff0: 63 2c 20 7a 54 61 62 29 3b 0a 20 20 20 20 20 20  c, zTab);.      
8000: 20 20 70 53 72 63 2d 3e 69 4d 69 6e 20 3d 20 69    pSrc->iMin = i
8010: 4d 69 6e 3b 0a 20 20 20 20 20 20 20 20 70 53 72  Min;.        pSr
8020: 63 2d 3e 69 4d 61 78 20 3d 20 69 4d 61 78 3b 0a  c->iMax = iMax;.
8030: 20 20 20 20 20 20 20 20 69 66 28 20 62 53 77 61          if( bSwa
8040: 72 6d 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  rm ){.          
8050: 70 53 72 63 2d 3e 7a 46 69 6c 65 20 3d 20 75 6e  pSrc->zFile = un
8060: 69 6f 6e 53 74 72 64 75 70 28 26 72 63 2c 20 7a  ionStrdup(&rc, z
8070: 44 62 29 3b 0a 20 20 20 20 20 20 20 20 7d 65 6c  Db);.        }el
8080: 73 65 7b 0a 20 20 20 20 20 20 20 20 20 20 70 53  se{.          pS
8090: 72 63 2d 3e 7a 44 62 20 3d 20 75 6e 69 6f 6e 53  rc->zDb = unionS
80a0: 74 72 64 75 70 28 26 72 63 2c 20 7a 44 62 29 3b  trdup(&rc, zDb);
80b0: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
80c0: 20 20 20 69 66 28 20 70 54 61 62 2d 3e 62 48 61     if( pTab->bHa
80d0: 73 43 6f 6e 74 65 78 74 20 29 7b 0a 20 20 20 20  sContext ){.    
80e0: 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72        const char
80f0: 20 2a 7a 43 6f 6e 74 65 78 74 20 3d 20 28 63 6f   *zContext = (co
8100: 6e 73 74 20 63 68 61 72 2a 29 73 71 6c 69 74 65  nst char*)sqlite
8110: 33 5f 63 6f 6c 75 6d 6e 5f 74 65 78 74 28 70 53  3_column_text(pS
8120: 74 6d 74 2c 20 34 29 3b 0a 20 20 20 20 20 20 20  tmt, 4);.       
8130: 20 20 20 70 53 72 63 2d 3e 7a 43 6f 6e 74 65 78     pSrc->zContex
8140: 74 20 3d 20 75 6e 69 6f 6e 53 74 72 64 75 70 28  t = unionStrdup(
8150: 26 72 63 2c 20 7a 43 6f 6e 74 65 78 74 29 3b 0a  &rc, zContext);.
8160: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20          }.      
8170: 7d 0a 20 20 20 20 7d 0a 20 20 20 20 75 6e 69 6f  }.    }.    unio
8180: 6e 46 69 6e 61 6c 69 7a 65 28 26 72 63 2c 20 70  nFinalize(&rc, p
8190: 53 74 6d 74 2c 20 70 7a 45 72 72 29 3b 0a 20 20  Stmt, pzErr);.  
81a0: 20 20 70 53 74 6d 74 20 3d 20 30 3b 0a 0a 20 20    pStmt = 0;..  
81b0: 20 20 2f 2a 20 49 74 20 69 73 20 61 6e 20 65 72    /* It is an er
81c0: 72 6f 72 20 69 66 20 74 68 65 20 53 45 4c 45 43  ror if the SELEC
81d0: 54 20 73 74 61 74 65 6d 65 6e 74 20 72 65 74 75  T statement retu
81e0: 72 6e 65 64 20 7a 65 72 6f 20 72 6f 77 73 2e 20  rned zero rows. 
81f0: 49 66 20 6f 6e 6c 79 0a 20 20 20 20 2a 2a 20 62  If only.    ** b
8200: 65 63 61 75 73 65 20 74 68 65 72 65 20 69 73 20  ecause there is 
8210: 6e 6f 20 77 61 79 20 74 6f 20 64 65 74 65 72 6d  no way to determ
8220: 69 6e 65 20 74 68 65 20 73 63 68 65 6d 61 20 6f  ine the schema o
8230: 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 0a 20  f the virtual . 
8240: 20 20 20 2a 2a 20 74 61 62 6c 65 20 69 6e 20 74     ** table in t
8250: 68 69 73 20 63 61 73 65 2e 20 20 2a 2f 0a 20 20  his case.  */.  
8260: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
8270: 5f 4f 4b 20 26 26 20 70 54 61 62 2d 3e 6e 53 72  _OK && pTab->nSr
8280: 63 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 2a 70  c==0 ){.      *p
8290: 7a 45 72 72 20 3d 20 73 71 6c 69 74 65 33 5f 6d  zErr = sqlite3_m
82a0: 70 72 69 6e 74 66 28 22 6e 6f 20 73 6f 75 72 63  printf("no sourc
82b0: 65 20 74 61 62 6c 65 73 20 63 6f 6e 66 69 67 75  e tables configu
82c0: 72 65 64 22 29 3b 0a 20 20 20 20 20 20 72 63 20  red");.      rc 
82d0: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  = SQLITE_ERROR;.
82e0: 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 46 6f      }..    /* Fo
82f0: 72 20 75 6e 69 6f 6e 76 74 61 62 2c 20 76 65 72  r unionvtab, ver
8300: 69 66 79 20 74 68 61 74 20 61 6c 6c 20 73 6f 75  ify that all sou
8310: 72 63 65 20 74 61 62 6c 65 73 20 65 78 69 73 74  rce tables exist
8320: 20 61 6e 64 20 68 61 76 65 20 0a 20 20 20 20 2a   and have .    *
8330: 2a 20 63 6f 6d 70 61 74 69 62 6c 65 20 73 63 68  * compatible sch
8340: 65 6d 61 73 2e 20 46 6f 72 20 73 77 61 72 6d 76  emas. For swarmv
8350: 74 61 62 2c 20 61 74 74 61 63 68 20 74 68 65 20  tab, attach the 
8360: 66 69 72 73 74 20 64 61 74 61 62 61 73 65 20 61  first database a
8370: 6e 64 0a 20 20 20 20 2a 2a 20 63 68 65 63 6b 20  nd.    ** check 
8380: 74 68 61 74 20 74 68 65 20 66 69 72 73 74 20 74  that the first t
8390: 61 62 6c 65 20 69 73 20 61 20 72 6f 77 69 64 20  able is a rowid 
83a0: 74 61 62 6c 65 20 6f 6e 6c 79 2e 20 20 2a 2f 0a  table only.  */.
83b0: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
83c0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 69  TE_OK ){.      i
83d0: 66 28 20 62 53 77 61 72 6d 20 29 7b 0a 20 20 20  f( bSwarm ){.   
83e0: 20 20 20 20 20 72 63 20 3d 20 75 6e 69 6f 6e 4f       rc = unionO
83f0: 70 65 6e 44 61 74 61 62 61 73 65 28 70 54 61 62  penDatabase(pTab
8400: 2c 20 30 2c 20 70 7a 45 72 72 29 3b 0a 20 20 20  , 0, pzErr);.   
8410: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
8420: 20 20 72 63 20 3d 20 75 6e 69 6f 6e 53 6f 75 72    rc = unionSour
8430: 63 65 43 68 65 63 6b 28 70 54 61 62 2c 20 70 7a  ceCheck(pTab, pz
8440: 45 72 72 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20  Err);.      }.  
8450: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 43 6f 6d 70    }..    /* Comp
8460: 6f 73 65 20 61 20 43 52 45 41 54 45 20 54 41 42  ose a CREATE TAB
8470: 4c 45 20 73 74 61 74 65 6d 65 6e 74 20 61 6e 64  LE statement and
8480: 20 70 61 73 73 20 69 74 20 74 6f 20 64 65 63 6c   pass it to decl
8490: 61 72 65 5f 76 74 61 62 28 29 20 2a 2f 0a 20 20  are_vtab() */.  
84a0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
84b0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 55 6e 69  _OK ){.      Uni
84c0: 6f 6e 53 72 63 20 2a 70 53 72 63 20 3d 20 26 70  onSrc *pSrc = &p
84d0: 54 61 62 2d 3e 61 53 72 63 5b 30 5d 3b 0a 20 20  Tab->aSrc[0];.  
84e0: 20 20 20 20 73 71 6c 69 74 65 33 20 2a 74 64 62      sqlite3 *tdb
84f0: 20 3d 20 75 6e 69 6f 6e 47 65 74 44 62 28 70 54   = unionGetDb(pT
8500: 61 62 2c 20 70 53 72 63 29 3b 0a 20 20 20 20 20  ab, pSrc);.     
8510: 20 70 53 74 6d 74 20 3d 20 75 6e 69 6f 6e 50 72   pStmt = unionPr
8520: 65 70 61 72 65 50 72 69 6e 74 66 28 26 72 63 2c  eparePrintf(&rc,
8530: 20 70 7a 45 72 72 2c 20 74 64 62 2c 20 22 53 45   pzErr, tdb, "SE
8540: 4c 45 43 54 20 22 0a 20 20 20 20 20 20 20 20 20  LECT ".         
8550: 20 22 27 43 52 45 41 54 45 20 54 41 42 4c 45 20   "'CREATE TABLE 
8560: 78 79 7a 28 27 22 0a 20 20 20 20 20 20 20 20 20  xyz('".         
8570: 20 22 20 20 20 20 7c 7c 20 67 72 6f 75 70 5f 63   "    || group_c
8580: 6f 6e 63 61 74 28 71 75 6f 74 65 28 6e 61 6d 65  oncat(quote(name
8590: 29 20 7c 7c 20 27 20 27 20 7c 7c 20 74 79 70 65  ) || ' ' || type
85a0: 2c 20 27 2c 20 27 29 22 0a 20 20 20 20 20 20 20  , ', ')".       
85b0: 20 20 20 22 20 20 20 20 7c 7c 20 27 29 27 2c 22     "    || ')',"
85c0: 0a 20 20 20 20 20 20 20 20 20 20 22 6d 61 78 28  .          "max(
85d0: 28 63 69 64 2b 31 29 20 2a 20 28 74 79 70 65 3d  (cid+1) * (type=
85e0: 27 49 4e 54 45 47 45 52 27 20 43 4f 4c 4c 41 54  'INTEGER' COLLAT
85f0: 45 20 6e 6f 63 61 73 65 20 41 4e 44 20 70 6b 3d  E nocase AND pk=
8600: 31 29 29 2d 31 20 22 0a 20 20 20 20 20 20 20 20  1))-1 ".        
8610: 20 20 22 46 52 4f 4d 20 70 72 61 67 6d 61 5f 74    "FROM pragma_t
8620: 61 62 6c 65 5f 69 6e 66 6f 28 25 51 2c 20 3f 29  able_info(%Q, ?)
8630: 22 2c 20 0a 20 20 20 20 20 20 20 20 20 20 70 53  ", .          pS
8640: 72 63 2d 3e 7a 54 61 62 2c 20 70 53 72 63 2d 3e  rc->zTab, pSrc->
8650: 7a 44 62 0a 20 20 20 20 20 20 29 3b 0a 20 20 20  zDb.      );.   
8660: 20 7d 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53   }.    if( rc==S
8670: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 53 51 4c 49  QLITE_OK && SQLI
8680: 54 45 5f 52 4f 57 3d 3d 73 71 6c 69 74 65 33 5f  TE_ROW==sqlite3_
8690: 73 74 65 70 28 70 53 74 6d 74 29 20 29 7b 0a 20  step(pStmt) ){. 
86a0: 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20       const char 
86b0: 2a 7a 44 65 63 6c 20 3d 20 28 63 6f 6e 73 74 20  *zDecl = (const 
86c0: 63 68 61 72 2a 29 73 71 6c 69 74 65 33 5f 63 6f  char*)sqlite3_co
86d0: 6c 75 6d 6e 5f 74 65 78 74 28 70 53 74 6d 74 2c  lumn_text(pStmt,
86e0: 20 30 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20   0);.      rc = 
86f0: 73 71 6c 69 74 65 33 5f 64 65 63 6c 61 72 65 5f  sqlite3_declare_
8700: 76 74 61 62 28 64 62 2c 20 7a 44 65 63 6c 29 3b  vtab(db, zDecl);
8710: 0a 20 20 20 20 20 20 70 54 61 62 2d 3e 69 50 4b  .      pTab->iPK
8720: 20 3d 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75 6d   = sqlite3_colum
8730: 6e 5f 69 6e 74 28 70 53 74 6d 74 2c 20 31 29 3b  n_int(pStmt, 1);
8740: 0a 20 20 20 20 7d 0a 0a 20 20 20 20 75 6e 69 6f  .    }..    unio
8750: 6e 46 69 6e 61 6c 69 7a 65 28 26 72 63 2c 20 70  nFinalize(&rc, p
8760: 53 74 6d 74 2c 20 70 7a 45 72 72 29 3b 0a 20 20  Stmt, pzErr);.  
8770: 7d 0a 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c  }..  if( rc!=SQL
8780: 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 75 6e  ITE_OK ){.    un
8790: 69 6f 6e 44 69 73 63 6f 6e 6e 65 63 74 28 28 73  ionDisconnect((s
87a0: 71 6c 69 74 65 33 5f 76 74 61 62 2a 29 70 54 61  qlite3_vtab*)pTa
87b0: 62 29 3b 0a 20 20 20 20 70 54 61 62 20 3d 20 30  b);.    pTab = 0
87c0: 3b 0a 20 20 7d 0a 0a 20 20 2a 70 70 56 74 61 62  ;.  }..  *ppVtab
87d0: 20 3d 20 28 73 71 6c 69 74 65 33 5f 76 74 61 62   = (sqlite3_vtab
87e0: 2a 29 70 54 61 62 3b 0a 20 20 72 65 74 75 72 6e  *)pTab;.  return
87f0: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 78 4f   rc;.}../*.** xO
8800: 70 65 6e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  pen.*/.static in
8810: 74 20 75 6e 69 6f 6e 4f 70 65 6e 28 73 71 6c 69  t unionOpen(sqli
8820: 74 65 33 5f 76 74 61 62 20 2a 70 2c 20 73 71 6c  te3_vtab *p, sql
8830: 69 74 65 33 5f 76 74 61 62 5f 63 75 72 73 6f 72  ite3_vtab_cursor
8840: 20 2a 2a 70 70 43 75 72 73 6f 72 29 7b 0a 20 20   **ppCursor){.  
8850: 55 6e 69 6f 6e 43 73 72 20 2a 70 43 73 72 3b 0a  UnionCsr *pCsr;.
8860: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54    int rc = SQLIT
8870: 45 5f 4f 4b 3b 0a 20 20 28 76 6f 69 64 29 70 3b  E_OK;.  (void)p;
8880: 20 20 2f 2a 20 53 75 70 70 72 65 73 73 20 68 61    /* Suppress ha
8890: 72 6d 6c 65 73 73 20 77 61 72 6e 69 6e 67 20 2a  rmless warning *
88a0: 2f 0a 20 20 70 43 73 72 20 3d 20 28 55 6e 69 6f  /.  pCsr = (Unio
88b0: 6e 43 73 72 2a 29 75 6e 69 6f 6e 4d 61 6c 6c 6f  nCsr*)unionMallo
88c0: 63 28 26 72 63 2c 20 73 69 7a 65 6f 66 28 55 6e  c(&rc, sizeof(Un
88d0: 69 6f 6e 43 73 72 29 29 3b 0a 20 20 2a 70 70 43  ionCsr));.  *ppC
88e0: 75 72 73 6f 72 20 3d 20 26 70 43 73 72 2d 3e 62  ursor = &pCsr->b
88f0: 61 73 65 3b 0a 20 20 72 65 74 75 72 6e 20 72 63  ase;.  return rc
8900: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 78 43 6c 6f 73  ;.}../*.** xClos
8910: 65 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  e.*/.static int 
8920: 75 6e 69 6f 6e 43 6c 6f 73 65 28 73 71 6c 69 74  unionClose(sqlit
8930: 65 33 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 2a  e3_vtab_cursor *
8940: 63 75 72 29 7b 0a 20 20 55 6e 69 6f 6e 43 73 72  cur){.  UnionCsr
8950: 20 2a 70 43 73 72 20 3d 20 28 55 6e 69 6f 6e 43   *pCsr = (UnionC
8960: 73 72 2a 29 63 75 72 3b 0a 20 20 75 6e 69 6f 6e  sr*)cur;.  union
8970: 46 69 6e 61 6c 69 7a 65 43 73 72 53 74 6d 74 28  FinalizeCsrStmt(
8980: 70 43 73 72 29 3b 0a 20 20 73 71 6c 69 74 65 33  pCsr);.  sqlite3
8990: 5f 66 72 65 65 28 70 43 73 72 29 3b 0a 20 20 72  _free(pCsr);.  r
89a0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
89b0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 66  .}../*.** This f
89c0: 75 6e 63 74 69 6f 6e 20 64 6f 65 73 20 74 68 65  unction does the
89d0: 20 77 6f 72 6b 20 6f 66 20 74 68 65 20 78 4e 65   work of the xNe
89e0: 78 74 28 29 20 6d 65 74 68 6f 64 2e 20 45 78 63  xt() method. Exc
89f0: 65 70 74 20 74 68 61 74 2c 20 69 66 20 69 74 0a  ept that, if it.
8a00: 2a 2a 20 72 65 74 75 72 6e 73 20 53 51 4c 49 54  ** returns SQLIT
8a10: 45 5f 52 4f 57 2c 20 69 74 20 73 68 6f 75 6c 64  E_ROW, it should
8a20: 20 62 65 20 63 61 6c 6c 65 64 20 61 67 61 69 6e   be called again
8a30: 20 77 69 74 68 69 6e 20 74 68 65 20 73 61 6d 65   within the same
8a40: 20 78 4e 65 78 74 28 29 0a 2a 2a 20 6d 65 74 68   xNext().** meth
8a50: 6f 64 20 63 61 6c 6c 2e 20 53 65 65 20 75 6e 69  od call. See uni
8a60: 6f 6e 4e 65 78 74 28 29 20 66 6f 72 20 64 65 74  onNext() for det
8a70: 61 69 6c 73 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ails..*/.static 
8a80: 69 6e 74 20 64 6f 55 6e 69 6f 6e 4e 65 78 74 28  int doUnionNext(
8a90: 55 6e 69 6f 6e 43 73 72 20 2a 70 43 73 72 29 7b  UnionCsr *pCsr){
8aa0: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49  .  int rc = SQLI
8ab0: 54 45 5f 4f 4b 3b 0a 20 20 61 73 73 65 72 74 28  TE_OK;.  assert(
8ac0: 20 70 43 73 72 2d 3e 70 53 74 6d 74 20 29 3b 0a   pCsr->pStmt );.
8ad0: 20 20 69 66 28 20 73 71 6c 69 74 65 33 5f 73 74    if( sqlite3_st
8ae0: 65 70 28 70 43 73 72 2d 3e 70 53 74 6d 74 29 21  ep(pCsr->pStmt)!
8af0: 3d 53 51 4c 49 54 45 5f 52 4f 57 20 29 7b 0a 20  =SQLITE_ROW ){. 
8b00: 20 20 20 55 6e 69 6f 6e 54 61 62 20 2a 70 54 61     UnionTab *pTa
8b10: 62 20 3d 20 28 55 6e 69 6f 6e 54 61 62 2a 29 70  b = (UnionTab*)p
8b20: 43 73 72 2d 3e 62 61 73 65 2e 70 56 74 61 62 3b  Csr->base.pVtab;
8b30: 0a 20 20 20 20 72 63 20 3d 20 75 6e 69 6f 6e 46  .    rc = unionF
8b40: 69 6e 61 6c 69 7a 65 43 73 72 53 74 6d 74 28 70  inalizeCsrStmt(p
8b50: 43 73 72 29 3b 0a 20 20 20 20 69 66 28 20 72 63  Csr);.    if( rc
8b60: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 70  ==SQLITE_OK && p
8b70: 54 61 62 2d 3e 62 53 77 61 72 6d 20 29 7b 0a 20  Tab->bSwarm ){. 
8b80: 20 20 20 20 20 70 43 73 72 2d 3e 69 54 61 62 2b       pCsr->iTab+
8b90: 2b 3b 0a 20 20 20 20 20 20 69 66 28 20 70 43 73  +;.      if( pCs
8ba0: 72 2d 3e 69 54 61 62 3c 70 54 61 62 2d 3e 6e 53  r->iTab<pTab->nS
8bb0: 72 63 20 29 7b 0a 20 20 20 20 20 20 20 20 55 6e  rc ){.        Un
8bc0: 69 6f 6e 53 72 63 20 2a 70 53 72 63 20 3d 20 26  ionSrc *pSrc = &
8bd0: 70 54 61 62 2d 3e 61 53 72 63 5b 70 43 73 72 2d  pTab->aSrc[pCsr-
8be0: 3e 69 54 61 62 5d 3b 0a 20 20 20 20 20 20 20 20  >iTab];.        
8bf0: 69 66 28 20 70 43 73 72 2d 3e 69 4d 61 78 52 6f  if( pCsr->iMaxRo
8c00: 77 69 64 3e 3d 70 53 72 63 2d 3e 69 4d 69 6e 20  wid>=pSrc->iMin 
8c10: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ){.          /* 
8c20: 49 74 20 69 73 20 6e 65 63 65 73 73 61 72 79 20  It is necessary 
8c30: 74 6f 20 73 63 61 6e 20 74 68 65 20 6e 65 78 74  to scan the next
8c40: 20 74 61 62 6c 65 2e 20 2a 2f 0a 20 20 20 20 20   table. */.     
8c50: 20 20 20 20 20 72 63 20 3d 20 75 6e 69 6f 6e 4f       rc = unionO
8c60: 70 65 6e 44 61 74 61 62 61 73 65 28 70 54 61 62  penDatabase(pTab
8c70: 2c 20 70 43 73 72 2d 3e 69 54 61 62 2c 20 26 70  , pCsr->iTab, &p
8c80: 54 61 62 2d 3e 62 61 73 65 2e 7a 45 72 72 4d 73  Tab->base.zErrMs
8c90: 67 29 3b 0a 20 20 20 20 20 20 20 20 20 20 70 43  g);.          pC
8ca0: 73 72 2d 3e 70 53 74 6d 74 20 3d 20 75 6e 69 6f  sr->pStmt = unio
8cb0: 6e 50 72 65 70 61 72 65 50 72 69 6e 74 66 28 26  nPreparePrintf(&
8cc0: 72 63 2c 20 26 70 54 61 62 2d 3e 62 61 73 65 2e  rc, &pTab->base.
8cd0: 7a 45 72 72 4d 73 67 2c 20 70 53 72 63 2d 3e 64  zErrMsg, pSrc->d
8ce0: 62 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  b,.             
8cf0: 20 22 53 45 4c 45 43 54 20 72 6f 77 69 64 2c 20   "SELECT rowid, 
8d00: 2a 20 46 52 4f 4d 20 25 51 20 25 73 20 25 6c 6c  * FROM %Q %s %ll
8d10: 64 22 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  d",.            
8d20: 20 20 70 53 72 63 2d 3e 7a 54 61 62 2c 0a 20 20    pSrc->zTab,.  
8d30: 20 20 20 20 20 20 20 20 20 20 20 20 28 70 53 72              (pSr
8d40: 63 2d 3e 69 4d 61 78 3e 70 43 73 72 2d 3e 69 4d  c->iMax>pCsr->iM
8d50: 61 78 52 6f 77 69 64 20 3f 20 22 57 48 45 52 45  axRowid ? "WHERE
8d60: 20 5f 72 6f 77 69 64 5f 20 3c 3d 22 20 3a 20 22   _rowid_ <=" : "
8d70: 2d 2d 20 22 29 2c 0a 20 20 20 20 20 20 20 20 20  -- "),.         
8d80: 20 20 20 20 20 70 43 73 72 2d 3e 69 4d 61 78 52       pCsr->iMaxR
8d90: 6f 77 69 64 0a 20 20 20 20 20 20 20 20 20 20 29  owid.          )
8da0: 3b 0a 20 20 20 20 20 20 20 20 20 20 69 66 28 20  ;.          if( 
8db0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
8dc0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 61 73 73  .            ass
8dd0: 65 72 74 28 20 70 43 73 72 2d 3e 70 53 74 6d 74  ert( pCsr->pStmt
8de0: 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20 20   );.            
8df0: 75 6e 69 6f 6e 49 6e 63 72 52 65 66 63 6f 75 6e  unionIncrRefcoun
8e00: 74 28 70 54 61 62 2c 20 70 43 73 72 2d 3e 69 54  t(pTab, pCsr->iT
8e10: 61 62 29 3b 0a 20 20 20 20 20 20 20 20 20 20 20  ab);.           
8e20: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 52 4f 57   rc = SQLITE_ROW
8e30: 3b 0a 20 20 20 20 20 20 20 20 20 20 7d 0a 20 20  ;.          }.  
8e40: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a        }.      }.
8e50: 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 72 65 74      }.  }..  ret
8e60: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
8e70: 20 78 4e 65 78 74 0a 2a 2f 0a 73 74 61 74 69 63   xNext.*/.static
8e80: 20 69 6e 74 20 75 6e 69 6f 6e 4e 65 78 74 28 73   int unionNext(s
8e90: 71 6c 69 74 65 33 5f 76 74 61 62 5f 63 75 72 73  qlite3_vtab_curs
8ea0: 6f 72 20 2a 63 75 72 29 7b 0a 20 20 69 6e 74 20  or *cur){.  int 
8eb0: 72 63 3b 0a 20 20 64 6f 20 7b 0a 20 20 20 20 72  rc;.  do {.    r
8ec0: 63 20 3d 20 64 6f 55 6e 69 6f 6e 4e 65 78 74 28  c = doUnionNext(
8ed0: 28 55 6e 69 6f 6e 43 73 72 2a 29 63 75 72 29 3b  (UnionCsr*)cur);
8ee0: 0a 20 20 7d 77 68 69 6c 65 28 20 72 63 3d 3d 53  .  }while( rc==S
8ef0: 51 4c 49 54 45 5f 52 4f 57 20 29 3b 0a 20 20 72  QLITE_ROW );.  r
8f00: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
8f10: 2a 2a 20 78 43 6f 6c 75 6d 6e 0a 2a 2f 0a 73 74  ** xColumn.*/.st
8f20: 61 74 69 63 20 69 6e 74 20 75 6e 69 6f 6e 43 6f  atic int unionCo
8f30: 6c 75 6d 6e 28 0a 20 20 73 71 6c 69 74 65 33 5f  lumn(.  sqlite3_
8f40: 76 74 61 62 5f 63 75 72 73 6f 72 20 2a 63 75 72  vtab_cursor *cur
8f50: 2c 0a 20 20 73 71 6c 69 74 65 33 5f 63 6f 6e 74  ,.  sqlite3_cont
8f60: 65 78 74 20 2a 63 74 78 2c 0a 20 20 69 6e 74 20  ext *ctx,.  int 
8f70: 69 0a 29 7b 0a 20 20 55 6e 69 6f 6e 43 73 72 20  i.){.  UnionCsr 
8f80: 2a 70 43 73 72 20 3d 20 28 55 6e 69 6f 6e 43 73  *pCsr = (UnionCs
8f90: 72 2a 29 63 75 72 3b 0a 20 20 73 71 6c 69 74 65  r*)cur;.  sqlite
8fa0: 33 5f 72 65 73 75 6c 74 5f 76 61 6c 75 65 28 63  3_result_value(c
8fb0: 74 78 2c 20 73 71 6c 69 74 65 33 5f 63 6f 6c 75  tx, sqlite3_colu
8fc0: 6d 6e 5f 76 61 6c 75 65 28 70 43 73 72 2d 3e 70  mn_value(pCsr->p
8fd0: 53 74 6d 74 2c 20 69 2b 31 29 29 3b 0a 20 20 72  Stmt, i+1));.  r
8fe0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
8ff0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 78 52 6f 77 69 64  .}../*.** xRowid
9000: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75  .*/.static int u
9010: 6e 69 6f 6e 52 6f 77 69 64 28 73 71 6c 69 74 65  nionRowid(sqlite
9020: 33 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 2a 63  3_vtab_cursor *c
9030: 75 72 2c 20 73 71 6c 69 74 65 5f 69 6e 74 36 34  ur, sqlite_int64
9040: 20 2a 70 52 6f 77 69 64 29 7b 0a 20 20 55 6e 69   *pRowid){.  Uni
9050: 6f 6e 43 73 72 20 2a 70 43 73 72 20 3d 20 28 55  onCsr *pCsr = (U
9060: 6e 69 6f 6e 43 73 72 2a 29 63 75 72 3b 0a 20 20  nionCsr*)cur;.  
9070: 2a 70 52 6f 77 69 64 20 3d 20 73 71 6c 69 74 65  *pRowid = sqlite
9080: 33 5f 63 6f 6c 75 6d 6e 5f 69 6e 74 36 34 28 70  3_column_int64(p
9090: 43 73 72 2d 3e 70 53 74 6d 74 2c 20 30 29 3b 0a  Csr->pStmt, 0);.
90a0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
90b0: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 78 45 6f  OK;.}../*.** xEo
90c0: 66 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  f.*/.static int 
90d0: 75 6e 69 6f 6e 45 6f 66 28 73 71 6c 69 74 65 33  unionEof(sqlite3
90e0: 5f 76 74 61 62 5f 63 75 72 73 6f 72 20 2a 63 75  _vtab_cursor *cu
90f0: 72 29 7b 0a 20 20 55 6e 69 6f 6e 43 73 72 20 2a  r){.  UnionCsr *
9100: 70 43 73 72 20 3d 20 28 55 6e 69 6f 6e 43 73 72  pCsr = (UnionCsr
9110: 2a 29 63 75 72 3b 0a 20 20 72 65 74 75 72 6e 20  *)cur;.  return 
9120: 70 43 73 72 2d 3e 70 53 74 6d 74 3d 3d 30 3b 0a  pCsr->pStmt==0;.
9130: 7d 0a 0a 2f 2a 0a 2a 2a 20 78 46 69 6c 74 65 72  }../*.** xFilter
9140: 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 75  .*/.static int u
9150: 6e 69 6f 6e 46 69 6c 74 65 72 28 0a 20 20 73 71  nionFilter(.  sq
9160: 6c 69 74 65 33 5f 76 74 61 62 5f 63 75 72 73 6f  lite3_vtab_curso
9170: 72 20 2a 70 56 74 61 62 43 75 72 73 6f 72 2c 20  r *pVtabCursor, 
9180: 0a 20 20 69 6e 74 20 69 64 78 4e 75 6d 2c 20 63  .  int idxNum, c
9190: 6f 6e 73 74 20 63 68 61 72 20 2a 69 64 78 53 74  onst char *idxSt
91a0: 72 2c 0a 20 20 69 6e 74 20 61 72 67 63 2c 20 73  r,.  int argc, s
91b0: 71 6c 69 74 65 33 5f 76 61 6c 75 65 20 2a 2a 61  qlite3_value **a
91c0: 72 67 76 0a 29 7b 0a 20 20 55 6e 69 6f 6e 54 61  rgv.){.  UnionTa
91d0: 62 20 2a 70 54 61 62 20 3d 20 28 55 6e 69 6f 6e  b *pTab = (Union
91e0: 54 61 62 2a 29 28 70 56 74 61 62 43 75 72 73 6f  Tab*)(pVtabCurso
91f0: 72 2d 3e 70 56 74 61 62 29 3b 0a 20 20 55 6e 69  r->pVtab);.  Uni
9200: 6f 6e 43 73 72 20 2a 70 43 73 72 20 3d 20 28 55  onCsr *pCsr = (U
9210: 6e 69 6f 6e 43 73 72 2a 29 70 56 74 61 62 43 75  nionCsr*)pVtabCu
9220: 72 73 6f 72 3b 0a 20 20 69 6e 74 20 72 63 20 3d  rsor;.  int rc =
9230: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e   SQLITE_OK;.  in
9240: 74 20 69 3b 0a 20 20 63 68 61 72 20 2a 7a 53 71  t i;.  char *zSq
9250: 6c 20 3d 20 30 3b 0a 20 20 69 6e 74 20 62 5a 65  l = 0;.  int bZe
9260: 72 6f 20 3d 20 30 3b 0a 0a 20 20 73 71 6c 69 74  ro = 0;..  sqlit
9270: 65 33 5f 69 6e 74 36 34 20 69 4d 69 6e 20 3d 20  e3_int64 iMin = 
9280: 53 4d 41 4c 4c 45 53 54 5f 49 4e 54 36 34 3b 0a  SMALLEST_INT64;.
9290: 20 20 73 71 6c 69 74 65 33 5f 69 6e 74 36 34 20    sqlite3_int64 
92a0: 69 4d 61 78 20 3d 20 4c 41 52 47 45 53 54 5f 49  iMax = LARGEST_I
92b0: 4e 54 36 34 3b 0a 0a 20 20 61 73 73 65 72 74 28  NT64;..  assert(
92c0: 20 69 64 78 4e 75 6d 3d 3d 30 20 0a 20 20 20 20   idxNum==0 .    
92d0: 20 20 20 7c 7c 20 69 64 78 4e 75 6d 3d 3d 53 51     || idxNum==SQ
92e0: 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 54  LITE_INDEX_CONST
92f0: 52 41 49 4e 54 5f 45 51 0a 20 20 20 20 20 20 20  RAINT_EQ.       
9300: 7c 7c 20 69 64 78 4e 75 6d 3d 3d 53 51 4c 49 54  || idxNum==SQLIT
9310: 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49  E_INDEX_CONSTRAI
9320: 4e 54 5f 4c 45 0a 20 20 20 20 20 20 20 7c 7c 20  NT_LE.       || 
9330: 69 64 78 4e 75 6d 3d 3d 53 51 4c 49 54 45 5f 49  idxNum==SQLITE_I
9340: 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f  NDEX_CONSTRAINT_
9350: 47 45 0a 20 20 20 20 20 20 20 7c 7c 20 69 64 78  GE.       || idx
9360: 4e 75 6d 3d 3d 53 51 4c 49 54 45 5f 49 4e 44 45  Num==SQLITE_INDE
9370: 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 4c 54 0a  X_CONSTRAINT_LT.
9380: 20 20 20 20 20 20 20 7c 7c 20 69 64 78 4e 75 6d         || idxNum
9390: 3d 3d 53 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43  ==SQLITE_INDEX_C
93a0: 4f 4e 53 54 52 41 49 4e 54 5f 47 54 0a 20 20 20  ONSTRAINT_GT.   
93b0: 20 20 20 20 7c 7c 20 69 64 78 4e 75 6d 3d 3d 28      || idxNum==(
93c0: 53 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f 4e  SQLITE_INDEX_CON
93d0: 53 54 52 41 49 4e 54 5f 47 45 7c 53 51 4c 49 54  STRAINT_GE|SQLIT
93e0: 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49  E_INDEX_CONSTRAI
93f0: 4e 54 5f 4c 45 29 0a 20 20 29 3b 0a 0a 20 20 28  NT_LE).  );..  (
9400: 76 6f 69 64 29 69 64 78 53 74 72 3b 20 20 2f 2a  void)idxStr;  /*
9410: 20 53 75 70 70 72 65 73 73 20 68 61 72 6d 6c 65   Suppress harmle
9420: 73 73 20 77 61 72 6e 69 6e 67 20 2a 2f 0a 20 20  ss warning */.  
9430: 0a 20 20 69 66 28 20 69 64 78 4e 75 6d 3d 3d 53  .  if( idxNum==S
9440: 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f 4e 53  QLITE_INDEX_CONS
9450: 54 52 41 49 4e 54 5f 45 51 20 29 7b 0a 20 20 20  TRAINT_EQ ){.   
9460: 20 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d 31   assert( argc==1
9470: 20 29 3b 0a 20 20 20 20 69 4d 69 6e 20 3d 20 69   );.    iMin = i
9480: 4d 61 78 20 3d 20 73 71 6c 69 74 65 33 5f 76 61  Max = sqlite3_va
9490: 6c 75 65 5f 69 6e 74 36 34 28 61 72 67 76 5b 30  lue_int64(argv[0
94a0: 5d 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 0a 20 20  ]);.  }else{..  
94b0: 20 20 69 66 28 20 69 64 78 4e 75 6d 20 26 20 28    if( idxNum & (
94c0: 53 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f 4e  SQLITE_INDEX_CON
94d0: 53 54 52 41 49 4e 54 5f 4c 45 7c 53 51 4c 49 54  STRAINT_LE|SQLIT
94e0: 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49  E_INDEX_CONSTRAI
94f0: 4e 54 5f 4c 54 29 20 29 7b 0a 20 20 20 20 20 20  NT_LT) ){.      
9500: 61 73 73 65 72 74 28 20 61 72 67 63 3e 3d 31 20  assert( argc>=1 
9510: 29 3b 0a 20 20 20 20 20 20 69 4d 61 78 20 3d 20  );.      iMax = 
9520: 73 71 6c 69 74 65 33 5f 76 61 6c 75 65 5f 69 6e  sqlite3_value_in
9530: 74 36 34 28 61 72 67 76 5b 30 5d 29 3b 0a 20 20  t64(argv[0]);.  
9540: 20 20 20 20 69 66 28 20 69 64 78 4e 75 6d 20 26      if( idxNum &
9550: 20 53 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f   SQLITE_INDEX_CO
9560: 4e 53 54 52 41 49 4e 54 5f 4c 54 20 29 7b 0a 20  NSTRAINT_LT ){. 
9570: 20 20 20 20 20 20 20 69 66 28 20 69 4d 61 78 3d         if( iMax=
9580: 3d 53 4d 41 4c 4c 45 53 54 5f 49 4e 54 36 34 20  =SMALLEST_INT64 
9590: 29 7b 0a 20 20 20 20 20 20 20 20 20 20 62 5a 65  ){.          bZe
95a0: 72 6f 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20  ro = 1;.        
95b0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 20  }else{.         
95c0: 20 69 4d 61 78 2d 2d 3b 0a 20 20 20 20 20 20 20   iMax--;.       
95d0: 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d   }.      }.    }
95e0: 0a 0a 20 20 20 20 69 66 28 20 69 64 78 4e 75 6d  ..    if( idxNum
95f0: 20 26 20 28 53 51 4c 49 54 45 5f 49 4e 44 45 58   & (SQLITE_INDEX
9600: 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 47 45 7c 53  _CONSTRAINT_GE|S
9610: 51 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f 4e 53  QLITE_INDEX_CONS
9620: 54 52 41 49 4e 54 5f 47 54 29 20 29 7b 0a 20 20  TRAINT_GT) ){.  
9630: 20 20 20 20 61 73 73 65 72 74 28 20 61 72 67 63      assert( argc
9640: 3e 3d 31 20 29 3b 0a 20 20 20 20 20 20 69 4d 69  >=1 );.      iMi
9650: 6e 20 3d 20 73 71 6c 69 74 65 33 5f 76 61 6c 75  n = sqlite3_valu
9660: 65 5f 69 6e 74 36 34 28 61 72 67 76 5b 61 72 67  e_int64(argv[arg
9670: 63 2d 31 5d 29 3b 0a 20 20 20 20 20 20 69 66 28  c-1]);.      if(
9680: 20 69 64 78 4e 75 6d 20 26 20 53 51 4c 49 54 45   idxNum & SQLITE
9690: 5f 49 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49 4e  _INDEX_CONSTRAIN
96a0: 54 5f 47 54 20 29 7b 0a 20 20 20 20 20 20 20 20  T_GT ){.        
96b0: 69 66 28 20 69 4d 69 6e 3d 3d 4c 41 52 47 45 53  if( iMin==LARGES
96c0: 54 5f 49 4e 54 36 34 20 29 7b 0a 20 20 20 20 20  T_INT64 ){.     
96d0: 20 20 20 20 20 62 5a 65 72 6f 20 3d 20 31 3b 0a       bZero = 1;.
96e0: 20 20 20 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20          }else{. 
96f0: 20 20 20 20 20 20 20 20 20 69 4d 69 6e 2b 2b 3b           iMin++;
9700: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20  .        }.     
9710: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20   }.    }.  }..  
9720: 75 6e 69 6f 6e 46 69 6e 61 6c 69 7a 65 43 73 72  unionFinalizeCsr
9730: 53 74 6d 74 28 70 43 73 72 29 3b 0a 20 20 69 66  Stmt(pCsr);.  if
9740: 28 20 62 5a 65 72 6f 20 29 7b 0a 20 20 20 20 72  ( bZero ){.    r
9750: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
9760: 0a 20 20 7d 0a 0a 20 20 66 6f 72 28 69 3d 30 3b  .  }..  for(i=0;
9770: 20 69 3c 70 54 61 62 2d 3e 6e 53 72 63 3b 20 69   i<pTab->nSrc; i
9780: 2b 2b 29 7b 0a 20 20 20 20 55 6e 69 6f 6e 53 72  ++){.    UnionSr
9790: 63 20 2a 70 53 72 63 20 3d 20 26 70 54 61 62 2d  c *pSrc = &pTab-
97a0: 3e 61 53 72 63 5b 69 5d 3b 0a 20 20 20 20 69 66  >aSrc[i];.    if
97b0: 28 20 69 4d 69 6e 3e 70 53 72 63 2d 3e 69 4d 61  ( iMin>pSrc->iMa
97c0: 78 20 7c 7c 20 69 4d 61 78 3c 70 53 72 63 2d 3e  x || iMax<pSrc->
97d0: 69 4d 69 6e 20 29 7b 0a 20 20 20 20 20 20 63 6f  iMin ){.      co
97e0: 6e 74 69 6e 75 65 3b 0a 20 20 20 20 7d 0a 0a 20  ntinue;.    }.. 
97f0: 20 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74 65     zSql = sqlite
9800: 33 5f 6d 70 72 69 6e 74 66 28 22 25 7a 25 73 53  3_mprintf("%z%sS
9810: 45 4c 45 43 54 20 72 6f 77 69 64 2c 20 2a 20 46  ELECT rowid, * F
9820: 52 4f 4d 20 25 73 25 71 25 73 25 51 22 0a 20 20  ROM %s%q%s%Q".  
9830: 20 20 20 20 20 20 2c 20 7a 53 71 6c 0a 20 20 20        , zSql.   
9840: 20 20 20 20 20 2c 20 28 7a 53 71 6c 20 3f 20 22       , (zSql ? "
9850: 20 55 4e 49 4f 4e 20 41 4c 4c 20 22 20 3a 20 22   UNION ALL " : "
9860: 22 29 0a 20 20 20 20 20 20 20 20 2c 20 28 70 53  ").        , (pS
9870: 72 63 2d 3e 7a 44 62 20 3f 20 22 27 22 20 3a 20  rc->zDb ? "'" : 
9880: 22 22 29 0a 20 20 20 20 20 20 20 20 2c 20 28 70  "").        , (p
9890: 53 72 63 2d 3e 7a 44 62 20 3f 20 70 53 72 63 2d  Src->zDb ? pSrc-
98a0: 3e 7a 44 62 20 3a 20 22 22 29 0a 20 20 20 20 20  >zDb : "").     
98b0: 20 20 20 2c 20 28 70 53 72 63 2d 3e 7a 44 62 20     , (pSrc->zDb 
98c0: 3f 20 22 27 2e 22 20 3a 20 22 22 29 0a 20 20 20  ? "'." : "").   
98d0: 20 20 20 20 20 2c 20 70 53 72 63 2d 3e 7a 54 61       , pSrc->zTa
98e0: 62 0a 20 20 20 20 29 3b 0a 20 20 20 20 69 66 28  b.    );.    if(
98f0: 20 7a 53 71 6c 3d 3d 30 20 29 7b 0a 20 20 20 20   zSql==0 ){.    
9900: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f    rc = SQLITE_NO
9910: 4d 45 4d 3b 0a 20 20 20 20 20 20 62 72 65 61 6b  MEM;.      break
9920: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 69 66 28  ;.    }..    if(
9930: 20 69 4d 69 6e 3d 3d 69 4d 61 78 20 29 7b 0a 20   iMin==iMax ){. 
9940: 20 20 20 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69       zSql = sqli
9950: 74 65 33 5f 6d 70 72 69 6e 74 66 28 22 25 7a 20  te3_mprintf("%z 
9960: 57 48 45 52 45 20 72 6f 77 69 64 3d 25 6c 6c 64  WHERE rowid=%lld
9970: 22 2c 20 7a 53 71 6c 2c 20 69 4d 69 6e 29 3b 0a  ", zSql, iMin);.
9980: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20      }else{.     
9990: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 57 68   const char *zWh
99a0: 65 72 65 20 3d 20 22 57 48 45 52 45 22 3b 0a 20  ere = "WHERE";. 
99b0: 20 20 20 20 20 69 66 28 20 69 4d 69 6e 21 3d 53       if( iMin!=S
99c0: 4d 41 4c 4c 45 53 54 5f 49 4e 54 36 34 20 26 26  MALLEST_INT64 &&
99d0: 20 69 4d 69 6e 3e 70 53 72 63 2d 3e 69 4d 69 6e   iMin>pSrc->iMin
99e0: 20 29 7b 0a 20 20 20 20 20 20 20 20 7a 53 71 6c   ){.        zSql
99f0: 20 3d 20 73 71 6c 69 74 65 33 5f 6d 70 72 69 6e   = sqlite3_mprin
9a00: 74 66 28 22 25 7a 20 57 48 45 52 45 20 72 6f 77  tf("%z WHERE row
9a10: 69 64 3e 3d 25 6c 6c 64 22 2c 20 7a 53 71 6c 2c  id>=%lld", zSql,
9a20: 20 69 4d 69 6e 29 3b 0a 20 20 20 20 20 20 20 20   iMin);.        
9a30: 7a 57 68 65 72 65 20 3d 20 22 41 4e 44 22 3b 0a  zWhere = "AND";.
9a40: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66        }.      if
9a50: 28 20 69 4d 61 78 21 3d 4c 41 52 47 45 53 54 5f  ( iMax!=LARGEST_
9a60: 49 4e 54 36 34 20 26 26 20 69 4d 61 78 3c 70 53  INT64 && iMax<pS
9a70: 72 63 2d 3e 69 4d 61 78 20 29 7b 0a 20 20 20 20  rc->iMax ){.    
9a80: 20 20 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74      zSql = sqlit
9a90: 65 33 5f 6d 70 72 69 6e 74 66 28 22 25 7a 20 25  e3_mprintf("%z %
9aa0: 73 20 72 6f 77 69 64 3c 3d 25 6c 6c 64 22 2c 20  s rowid<=%lld", 
9ab0: 7a 53 71 6c 2c 20 7a 57 68 65 72 65 2c 20 69 4d  zSql, zWhere, iM
9ac0: 61 78 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20  ax);.      }.   
9ad0: 20 7d 0a 0a 20 20 20 20 69 66 28 20 70 54 61 62   }..    if( pTab
9ae0: 2d 3e 62 53 77 61 72 6d 20 29 7b 0a 20 20 20 20  ->bSwarm ){.    
9af0: 20 20 70 43 73 72 2d 3e 69 54 61 62 20 3d 20 69    pCsr->iTab = i
9b00: 3b 0a 20 20 20 20 20 20 70 43 73 72 2d 3e 69 4d  ;.      pCsr->iM
9b10: 61 78 52 6f 77 69 64 20 3d 20 69 4d 61 78 3b 0a  axRowid = iMax;.
9b20: 20 20 20 20 20 20 72 63 20 3d 20 75 6e 69 6f 6e        rc = union
9b30: 4f 70 65 6e 44 61 74 61 62 61 73 65 28 70 54 61  OpenDatabase(pTa
9b40: 62 2c 20 69 2c 20 26 70 54 61 62 2d 3e 62 61 73  b, i, &pTab->bas
9b50: 65 2e 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20  e.zErrMsg);.    
9b60: 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a 20    break;.    }. 
9b70: 20 7d 0a 0a 20 20 69 66 28 20 7a 53 71 6c 3d 3d   }..  if( zSql==
9b80: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 ){.    return 
9b90: 72 63 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  rc;.  }else{.   
9ba0: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 75   sqlite3 *db = u
9bb0: 6e 69 6f 6e 47 65 74 44 62 28 70 54 61 62 2c 20  nionGetDb(pTab, 
9bc0: 26 70 54 61 62 2d 3e 61 53 72 63 5b 70 43 73 72  &pTab->aSrc[pCsr
9bd0: 2d 3e 69 54 61 62 5d 29 3b 0a 20 20 20 20 70 43  ->iTab]);.    pC
9be0: 73 72 2d 3e 70 53 74 6d 74 20 3d 20 75 6e 69 6f  sr->pStmt = unio
9bf0: 6e 50 72 65 70 61 72 65 28 26 72 63 2c 20 64 62  nPrepare(&rc, db
9c00: 2c 20 7a 53 71 6c 2c 20 26 70 54 61 62 2d 3e 62  , zSql, &pTab->b
9c10: 61 73 65 2e 7a 45 72 72 4d 73 67 29 3b 0a 20 20  ase.zErrMsg);.  
9c20: 20 20 69 66 28 20 70 43 73 72 2d 3e 70 53 74 6d    if( pCsr->pStm
9c30: 74 20 29 7b 0a 20 20 20 20 20 20 75 6e 69 6f 6e  t ){.      union
9c40: 49 6e 63 72 52 65 66 63 6f 75 6e 74 28 70 54 61  IncrRefcount(pTa
9c50: 62 2c 20 70 43 73 72 2d 3e 69 54 61 62 29 3b 0a  b, pCsr->iTab);.
9c60: 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65      }.    sqlite
9c70: 33 5f 66 72 65 65 28 7a 53 71 6c 29 3b 0a 20 20  3_free(zSql);.  
9c80: 7d 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49  }.  if( rc!=SQLI
9c90: 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 20 72  TE_OK ) return r
9ca0: 63 3b 0a 20 20 72 65 74 75 72 6e 20 75 6e 69 6f  c;.  return unio
9cb0: 6e 4e 65 78 74 28 70 56 74 61 62 43 75 72 73 6f  nNext(pVtabCurso
9cc0: 72 29 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 78 42 65  r);.}../*.** xBe
9cd0: 73 74 49 6e 64 65 78 2e 0a 2a 2a 0a 2a 2a 20 54  stIndex..**.** T
9ce0: 68 69 73 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  his implementati
9cf0: 6f 6e 20 73 65 61 72 63 68 65 73 20 66 6f 72 20  on searches for 
9d00: 63 6f 6e 73 74 72 61 69 6e 74 73 20 6f 6e 20 74  constraints on t
9d10: 68 65 20 72 6f 77 69 64 20 66 69 65 6c 64 2e 20  he rowid field. 
9d20: 45 51 2c 20 0a 2a 2a 20 4c 45 2c 20 4c 54 2c 20  EQ, .** LE, LT, 
9d30: 47 45 20 61 6e 64 20 47 54 20 61 72 65 20 68 61  GE and GT are ha
9d40: 6e 64 6c 65 64 2e 0a 2a 2a 0a 2a 2a 20 49 66 20  ndled..**.** If 
9d50: 74 68 65 72 65 20 69 73 20 61 6e 20 45 51 20 63  there is an EQ c
9d60: 6f 6d 70 61 72 69 73 6f 6e 2c 20 74 68 65 6e 20  omparison, then 
9d70: 69 64 78 4e 75 6d 20 69 73 20 73 65 74 20 74 6f  idxNum is set to
9d80: 20 49 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49 4e   INDEX_CONSTRAIN
9d90: 54 5f 45 51 2e 0a 2a 2a 20 49 6e 20 74 68 69 73  T_EQ..** In this
9da0: 20 63 61 73 65 20 74 68 65 20 6f 6e 6c 79 20 61   case the only a
9db0: 72 67 75 6d 65 6e 74 20 70 61 73 73 65 64 20 74  rgument passed t
9dc0: 6f 20 78 46 69 6c 74 65 72 20 69 73 20 74 68 65  o xFilter is the
9dd0: 20 72 68 73 20 6f 66 20 74 68 65 20 3d 3d 0a 2a   rhs of the ==.*
9de0: 2a 20 6f 70 65 72 61 74 6f 72 2e 0a 2a 2a 0a 2a  * operator..**.*
9df0: 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 69 66 20  * Otherwise, if 
9e00: 61 6e 20 4c 45 20 6f 72 20 4c 54 20 63 6f 6e 73  an LE or LT cons
9e10: 74 72 61 69 6e 74 20 69 73 20 66 6f 75 6e 64 2c  traint is found,
9e20: 20 74 68 65 6e 20 74 68 65 20 49 4e 44 45 58 5f   then the INDEX_
9e30: 43 4f 4e 53 54 52 41 49 4e 54 5f 4c 45 0a 2a 2a  CONSTRAINT_LE.**
9e40: 20 6f 72 20 49 4e 44 45 58 5f 43 4f 4e 53 54 52   or INDEX_CONSTR
9e50: 41 49 4e 54 5f 4c 54 20 28 62 75 74 20 6e 6f 74  AINT_LT (but not
9e60: 20 62 6f 74 68 29 20 62 69 74 20 69 73 20 73 65   both) bit is se
9e70: 74 20 69 6e 20 69 64 78 4e 75 6d 2e 20 54 68 65  t in idxNum. The
9e80: 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65   first.** argume
9e90: 6e 74 20 74 6f 20 78 46 69 6c 74 65 72 20 69 73  nt to xFilter is
9ea0: 20 74 68 65 20 72 68 73 20 6f 66 20 74 68 65 20   the rhs of the 
9eb0: 3c 3d 20 6f 72 20 3c 20 6f 70 65 72 61 74 6f 72  <= or < operator
9ec0: 2e 20 20 53 69 6d 69 6c 61 72 6c 79 2c 20 69 66  .  Similarly, if
9ed0: 20 0a 2a 2a 20 61 6e 20 47 45 20 6f 72 20 47 54   .** an GE or GT
9ee0: 20 63 6f 6e 73 74 72 61 69 6e 74 20 69 73 20 66   constraint is f
9ef0: 6f 75 6e 64 2c 20 74 68 65 6e 20 74 68 65 20 49  ound, then the I
9f00: 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f  NDEX_CONSTRAINT_
9f10: 47 45 20 6f 72 0a 2a 2a 20 49 4e 44 45 58 5f 43  GE or.** INDEX_C
9f20: 4f 4e 53 54 52 41 49 4e 54 5f 47 54 20 62 69 74  ONSTRAINT_GT bit
9f30: 20 69 73 20 73 65 74 20 69 6e 20 69 64 78 4e 75   is set in idxNu
9f40: 6d 2e 20 54 68 65 20 72 68 73 20 6f 66 20 74 68  m. The rhs of th
9f50: 65 20 3e 3d 20 6f 72 20 3e 20 6f 70 65 72 61 74  e >= or > operat
9f60: 6f 72 0a 2a 2a 20 69 73 20 70 61 73 73 65 64 20  or.** is passed 
9f70: 61 73 20 65 69 74 68 65 72 20 74 68 65 20 66 69  as either the fi
9f80: 72 73 74 20 6f 72 20 73 65 63 6f 6e 64 20 61 72  rst or second ar
9f90: 67 75 6d 65 6e 74 20 74 6f 20 78 46 69 6c 74 65  gument to xFilte
9fa0: 72 2c 20 64 65 70 65 6e 64 69 6e 67 0a 2a 2a 20  r, depending.** 
9fb0: 6f 6e 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f  on whether or no
9fc0: 74 20 74 68 65 72 65 20 69 73 20 61 6c 73 6f 20  t there is also 
9fd0: 61 20 4c 54 7c 4c 45 20 63 6f 6e 73 74 72 61 69  a LT|LE constrai
9fe0: 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  nt..*/.static in
9ff0: 74 20 75 6e 69 6f 6e 42 65 73 74 49 6e 64 65 78  t unionBestIndex
a000: 28 0a 20 20 73 71 6c 69 74 65 33 5f 76 74 61 62  (.  sqlite3_vtab
a010: 20 2a 74 61 62 2c 0a 20 20 73 71 6c 69 74 65 33   *tab,.  sqlite3
a020: 5f 69 6e 64 65 78 5f 69 6e 66 6f 20 2a 70 49 64  _index_info *pId
a030: 78 49 6e 66 6f 0a 29 7b 0a 20 20 55 6e 69 6f 6e  xInfo.){.  Union
a040: 54 61 62 20 2a 70 54 61 62 20 3d 20 28 55 6e 69  Tab *pTab = (Uni
a050: 6f 6e 54 61 62 2a 29 74 61 62 3b 0a 20 20 69 6e  onTab*)tab;.  in
a060: 74 20 69 45 71 20 3d 20 2d 31 3b 0a 20 20 69 6e  t iEq = -1;.  in
a070: 74 20 69 4c 74 20 3d 20 2d 31 3b 0a 20 20 69 6e  t iLt = -1;.  in
a080: 74 20 69 47 74 20 3d 20 2d 31 3b 0a 20 20 69 6e  t iGt = -1;.  in
a090: 74 20 69 3b 0a 0a 20 20 66 6f 72 28 69 3d 30 3b  t i;..  for(i=0;
a0a0: 20 69 3c 70 49 64 78 49 6e 66 6f 2d 3e 6e 43 6f   i<pIdxInfo->nCo
a0b0: 6e 73 74 72 61 69 6e 74 3b 20 69 2b 2b 29 7b 0a  nstraint; i++){.
a0c0: 20 20 20 20 73 74 72 75 63 74 20 73 71 6c 69 74      struct sqlit
a0d0: 65 33 5f 69 6e 64 65 78 5f 63 6f 6e 73 74 72 61  e3_index_constra
a0e0: 69 6e 74 20 2a 70 20 3d 20 26 70 49 64 78 49 6e  int *p = &pIdxIn
a0f0: 66 6f 2d 3e 61 43 6f 6e 73 74 72 61 69 6e 74 5b  fo->aConstraint[
a100: 69 5d 3b 0a 20 20 20 20 69 66 28 20 70 2d 3e 75  i];.    if( p->u
a110: 73 61 62 6c 65 20 26 26 20 28 70 2d 3e 69 43 6f  sable && (p->iCo
a120: 6c 75 6d 6e 3c 30 20 7c 7c 20 70 2d 3e 69 43 6f  lumn<0 || p->iCo
a130: 6c 75 6d 6e 3d 3d 70 54 61 62 2d 3e 69 50 4b 29  lumn==pTab->iPK)
a140: 20 29 7b 0a 20 20 20 20 20 20 73 77 69 74 63 68   ){.      switch
a150: 28 20 70 2d 3e 6f 70 20 29 7b 0a 20 20 20 20 20  ( p->op ){.     
a160: 20 20 20 63 61 73 65 20 53 51 4c 49 54 45 5f 49     case SQLITE_I
a170: 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f  NDEX_CONSTRAINT_
a180: 45 51 3a 0a 20 20 20 20 20 20 20 20 20 20 69 45  EQ:.          iE
a190: 71 20 3d 20 69 3b 0a 20 20 20 20 20 20 20 20 20  q = i;.         
a1a0: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 20 20   break;.        
a1b0: 63 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 44 45  case SQLITE_INDE
a1c0: 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 4c 45 3a  X_CONSTRAINT_LE:
a1d0: 0a 20 20 20 20 20 20 20 20 63 61 73 65 20 53 51  .        case SQ
a1e0: 4c 49 54 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 54  LITE_INDEX_CONST
a1f0: 52 41 49 4e 54 5f 4c 54 3a 0a 20 20 20 20 20 20  RAINT_LT:.      
a200: 20 20 20 20 69 4c 74 20 3d 20 69 3b 0a 20 20 20      iLt = i;.   
a210: 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20         break;.  
a220: 20 20 20 20 20 20 63 61 73 65 20 53 51 4c 49 54        case SQLIT
a230: 45 5f 49 4e 44 45 58 5f 43 4f 4e 53 54 52 41 49  E_INDEX_CONSTRAI
a240: 4e 54 5f 47 45 3a 0a 20 20 20 20 20 20 20 20 63  NT_GE:.        c
a250: 61 73 65 20 53 51 4c 49 54 45 5f 49 4e 44 45 58  ase SQLITE_INDEX
a260: 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 47 54 3a 0a  _CONSTRAINT_GT:.
a270: 20 20 20 20 20 20 20 20 20 20 69 47 74 20 3d 20            iGt = 
a280: 69 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65  i;.          bre
a290: 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ak;.      }.    
a2a0: 7d 0a 20 20 7d 0a 0a 20 20 69 66 28 20 69 45 71  }.  }..  if( iEq
a2b0: 3e 3d 30 20 29 7b 0a 20 20 20 20 70 49 64 78 49  >=0 ){.    pIdxI
a2c0: 6e 66 6f 2d 3e 65 73 74 69 6d 61 74 65 64 52 6f  nfo->estimatedRo
a2d0: 77 73 20 3d 20 31 3b 0a 20 20 20 20 70 49 64 78  ws = 1;.    pIdx
a2e0: 49 6e 66 6f 2d 3e 69 64 78 46 6c 61 67 73 20 3d  Info->idxFlags =
a2f0: 20 53 51 4c 49 54 45 5f 49 4e 44 45 58 5f 53 43   SQLITE_INDEX_SC
a300: 41 4e 5f 55 4e 49 51 55 45 3b 0a 20 20 20 20 70  AN_UNIQUE;.    p
a310: 49 64 78 49 6e 66 6f 2d 3e 65 73 74 69 6d 61 74  IdxInfo->estimat
a320: 65 64 43 6f 73 74 20 3d 20 33 2e 30 3b 0a 20 20  edCost = 3.0;.  
a330: 20 20 70 49 64 78 49 6e 66 6f 2d 3e 69 64 78 4e    pIdxInfo->idxN
a340: 75 6d 20 3d 20 53 51 4c 49 54 45 5f 49 4e 44 45  um = SQLITE_INDE
a350: 58 5f 43 4f 4e 53 54 52 41 49 4e 54 5f 45 51 3b  X_CONSTRAINT_EQ;
a360: 0a 20 20 20 20 70 49 64 78 49 6e 66 6f 2d 3e 61  .    pIdxInfo->a
a370: 43 6f 6e 73 74 72 61 69 6e 74 55 73 61 67 65 5b  ConstraintUsage[
a380: 69 45 71 5d 2e 61 72 67 76 49 6e 64 65 78 20 3d  iEq].argvIndex =
a390: 20 31 3b 0a 20 20 20 20 70 49 64 78 49 6e 66 6f   1;.    pIdxInfo
a3a0: 2d 3e 61 43 6f 6e 73 74 72 61 69 6e 74 55 73 61  ->aConstraintUsa
a3b0: 67 65 5b 69 45 71 5d 2e 6f 6d 69 74 20 3d 20 31  ge[iEq].omit = 1
a3c0: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 69  ;.  }else{.    i
a3d0: 6e 74 20 69 43 6f 6e 73 20 3d 20 31 3b 0a 20 20  nt iCons = 1;.  
a3e0: 20 20 69 6e 74 20 69 64 78 4e 75 6d 20 3d 20 30    int idxNum = 0
a3f0: 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 69 6e  ;.    sqlite3_in
a400: 74 36 34 20 6e 52 6f 77 20 3d 20 31 30 30 30 30  t64 nRow = 10000
a410: 30 30 3b 0a 20 20 20 20 69 66 28 20 69 4c 74 3e  00;.    if( iLt>
a420: 3d 30 20 29 7b 0a 20 20 20 20 20 20 6e 52 6f 77  =0 ){.      nRow
a430: 20 3d 20 6e 52 6f 77 20 2f 20 32 3b 0a 20 20 20   = nRow / 2;.   
a440: 20 20 20 70 49 64 78 49 6e 66 6f 2d 3e 61 43 6f     pIdxInfo->aCo
a450: 6e 73 74 72 61 69 6e 74 55 73 61 67 65 5b 69 4c  nstraintUsage[iL
a460: 74 5d 2e 61 72 67 76 49 6e 64 65 78 20 3d 20 69  t].argvIndex = i
a470: 43 6f 6e 73 2b 2b 3b 0a 20 20 20 20 20 20 70 49  Cons++;.      pI
a480: 64 78 49 6e 66 6f 2d 3e 61 43 6f 6e 73 74 72 61  dxInfo->aConstra
a490: 69 6e 74 55 73 61 67 65 5b 69 4c 74 5d 2e 6f 6d  intUsage[iLt].om
a4a0: 69 74 20 3d 20 31 3b 0a 20 20 20 20 20 20 69 64  it = 1;.      id
a4b0: 78 4e 75 6d 20 7c 3d 20 70 49 64 78 49 6e 66 6f  xNum |= pIdxInfo
a4c0: 2d 3e 61 43 6f 6e 73 74 72 61 69 6e 74 5b 69 4c  ->aConstraint[iL
a4d0: 74 5d 2e 6f 70 3b 0a 20 20 20 20 7d 0a 20 20 20  t].op;.    }.   
a4e0: 20 69 66 28 20 69 47 74 3e 3d 30 20 29 7b 0a 20   if( iGt>=0 ){. 
a4f0: 20 20 20 20 20 6e 52 6f 77 20 3d 20 6e 52 6f 77       nRow = nRow
a500: 20 2f 20 32 3b 0a 20 20 20 20 20 20 70 49 64 78   / 2;.      pIdx
a510: 49 6e 66 6f 2d 3e 61 43 6f 6e 73 74 72 61 69 6e  Info->aConstrain
a520: 74 55 73 61 67 65 5b 69 47 74 5d 2e 61 72 67 76  tUsage[iGt].argv
a530: 49 6e 64 65 78 20 3d 20 69 43 6f 6e 73 2b 2b 3b  Index = iCons++;
a540: 0a 20 20 20 20 20 20 70 49 64 78 49 6e 66 6f 2d  .      pIdxInfo-
a550: 3e 61 43 6f 6e 73 74 72 61 69 6e 74 55 73 61 67  >aConstraintUsag
a560: 65 5b 69 47 74 5d 2e 6f 6d 69 74 20 3d 20 31 3b  e[iGt].omit = 1;
a570: 0a 20 20 20 20 20 20 69 64 78 4e 75 6d 20 7c 3d  .      idxNum |=
a580: 20 70 49 64 78 49 6e 66 6f 2d 3e 61 43 6f 6e 73   pIdxInfo->aCons
a590: 74 72 61 69 6e 74 5b 69 47 74 5d 2e 6f 70 3b 0a  traint[iGt].op;.
a5a0: 20 20 20 20 7d 0a 20 20 20 20 70 49 64 78 49 6e      }.    pIdxIn
a5b0: 66 6f 2d 3e 65 73 74 69 6d 61 74 65 64 52 6f 77  fo->estimatedRow
a5c0: 73 20 3d 20 6e 52 6f 77 3b 0a 20 20 20 20 70 49  s = nRow;.    pI
a5d0: 64 78 49 6e 66 6f 2d 3e 65 73 74 69 6d 61 74 65  dxInfo->estimate
a5e0: 64 43 6f 73 74 20 3d 20 33 2e 30 20 2a 20 28 64  dCost = 3.0 * (d
a5f0: 6f 75 62 6c 65 29 6e 52 6f 77 3b 0a 20 20 20 20  ouble)nRow;.    
a600: 70 49 64 78 49 6e 66 6f 2d 3e 69 64 78 4e 75 6d  pIdxInfo->idxNum
a610: 20 3d 20 69 64 78 4e 75 6d 3b 0a 20 20 7d 0a 0a   = idxNum;.  }..
a620: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
a630: 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 67  OK;.}../*.** Reg
a640: 69 73 74 65 72 20 74 68 65 20 75 6e 69 6f 6e 76  ister the unionv
a650: 74 61 62 20 76 69 72 74 75 61 6c 20 74 61 62 6c  tab virtual tabl
a660: 65 20 6d 6f 64 75 6c 65 20 77 69 74 68 20 64 61  e module with da
a670: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 20 64 62  tabase handle db
a680: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
a690: 63 72 65 61 74 65 55 6e 69 6f 6e 56 74 61 62 28  createUnionVtab(
a6a0: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20  sqlite3 *db){.  
a6b0: 73 74 61 74 69 63 20 73 71 6c 69 74 65 33 5f 6d  static sqlite3_m
a6c0: 6f 64 75 6c 65 20 75 6e 69 6f 6e 4d 6f 64 75 6c  odule unionModul
a6d0: 65 20 3d 20 7b 0a 20 20 20 20 30 2c 20 20 20 20  e = {.    0,    
a6e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a6f0: 20 20 20 20 20 20 20 20 2f 2a 20 69 56 65 72 73          /* iVers
a700: 69 6f 6e 20 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e  ion */.    union
a710: 43 6f 6e 6e 65 63 74 2c 0a 20 20 20 20 75 6e 69  Connect,.    uni
a720: 6f 6e 43 6f 6e 6e 65 63 74 2c 0a 20 20 20 20 75  onConnect,.    u
a730: 6e 69 6f 6e 42 65 73 74 49 6e 64 65 78 2c 20 20  nionBestIndex,  
a740: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
a750: 78 42 65 73 74 49 6e 64 65 78 20 2d 20 71 75 65  xBestIndex - que
a760: 72 79 20 70 6c 61 6e 6e 65 72 20 2a 2f 0a 20 20  ry planner */.  
a770: 20 20 75 6e 69 6f 6e 44 69 73 63 6f 6e 6e 65 63    unionDisconnec
a780: 74 2c 20 0a 20 20 20 20 75 6e 69 6f 6e 44 69 73  t, .    unionDis
a790: 63 6f 6e 6e 65 63 74 2c 0a 20 20 20 20 75 6e 69  connect,.    uni
a7a0: 6f 6e 4f 70 65 6e 2c 20 20 20 20 20 20 20 20 20  onOpen,         
a7b0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 4f             /* xO
a7c0: 70 65 6e 20 2d 20 6f 70 65 6e 20 61 20 63 75 72  pen - open a cur
a7d0: 73 6f 72 20 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e  sor */.    union
a7e0: 43 6c 6f 73 65 2c 20 20 20 20 20 20 20 20 20 20  Close,          
a7f0: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 43 6c 6f           /* xClo
a800: 73 65 20 2d 20 63 6c 6f 73 65 20 61 20 63 75 72  se - close a cur
a810: 73 6f 72 20 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e  sor */.    union
a820: 46 69 6c 74 65 72 2c 20 20 20 20 20 20 20 20 20  Filter,         
a830: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 46 69 6c           /* xFil
a840: 74 65 72 20 2d 20 63 6f 6e 66 69 67 75 72 65 20  ter - configure 
a850: 73 63 61 6e 20 63 6f 6e 73 74 72 61 69 6e 74 73  scan constraints
a860: 20 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e 4e 65 78   */.    unionNex
a870: 74 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  t,              
a880: 20 20 20 20 20 20 2f 2a 20 78 4e 65 78 74 20 2d        /* xNext -
a890: 20 61 64 76 61 6e 63 65 20 61 20 63 75 72 73 6f   advance a curso
a8a0: 72 20 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e 45 6f  r */.    unionEo
a8b0: 66 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  f,              
a8c0: 20 20 20 20 20 20 20 2f 2a 20 78 45 6f 66 20 2d         /* xEof -
a8d0: 20 63 68 65 63 6b 20 66 6f 72 20 65 6e 64 20 6f   check for end o
a8e0: 66 20 73 63 61 6e 20 2a 2f 0a 20 20 20 20 75 6e  f scan */.    un
a8f0: 69 6f 6e 43 6f 6c 75 6d 6e 2c 20 20 20 20 20 20  ionColumn,      
a900: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78              /* x
a910: 43 6f 6c 75 6d 6e 20 2d 20 72 65 61 64 20 64 61  Column - read da
a920: 74 61 20 2a 2f 0a 20 20 20 20 75 6e 69 6f 6e 52  ta */.    unionR
a930: 6f 77 69 64 2c 20 20 20 20 20 20 20 20 20 20 20  owid,           
a940: 20 20 20 20 20 20 20 20 2f 2a 20 78 52 6f 77 69          /* xRowi
a950: 64 20 2d 20 72 65 61 64 20 64 61 74 61 20 2a 2f  d - read data */
a960: 0a 20 20 20 20 30 2c 20 20 20 20 20 20 20 20 20  .    0,         
a970: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a980: 20 20 20 2f 2a 20 78 55 70 64 61 74 65 20 2a 2f     /* xUpdate */
a990: 0a 20 20 20 20 30 2c 20 20 20 20 20 20 20 20 20  .    0,         
a9a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a9b0: 20 20 20 2f 2a 20 78 42 65 67 69 6e 20 2a 2f 0a     /* xBegin */.
a9c0: 20 20 20 20 30 2c 20 20 20 20 20 20 20 20 20 20      0,          
a9d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
a9e0: 20 20 2f 2a 20 78 53 79 6e 63 20 2a 2f 0a 20 20    /* xSync */.  
a9f0: 20 20 30 2c 20 20 20 20 20 20 20 20 20 20 20 20    0,            
aa00: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
aa10: 2f 2a 20 78 43 6f 6d 6d 69 74 20 2a 2f 0a 20 20  /* xCommit */.  
aa20: 20 20 30 2c 20 20 20 20 20 20 20 20 20 20 20 20    0,            
aa30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
aa40: 2f 2a 20 78 52 6f 6c 6c 62 61 63 6b 20 2a 2f 0a  /* xRollback */.
aa50: 20 20 20 20 30 2c 20 20 20 20 20 20 20 20 20 20      0,          
aa60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
aa70: 20 20 2f 2a 20 78 46 69 6e 64 4d 65 74 68 6f 64    /* xFindMethod
aa80: 20 2a 2f 0a 20 20 20 20 30 2c 20 20 20 20 20 20   */.    0,      
aa90: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
aaa0: 20 20 20 20 20 20 2f 2a 20 78 52 65 6e 61 6d 65        /* xRename
aab0: 20 2a 2f 0a 20 20 20 20 30 2c 20 20 20 20 20 20   */.    0,      
aac0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
aad0: 20 20 20 20 20 20 2f 2a 20 78 53 61 76 65 70 6f        /* xSavepo
aae0: 69 6e 74 20 2a 2f 0a 20 20 20 20 30 2c 20 20 20  int */.    0,   
aaf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ab00: 20 20 20 20 20 20 20 20 20 2f 2a 20 78 52 65 6c           /* xRel
ab10: 65 61 73 65 20 2a 2f 0a 20 20 20 20 30 2c 20 20  ease */.    0,  
ab20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
ab30: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 78 52 6f            /* xRo
ab40: 6c 6c 62 61 63 6b 54 6f 20 2a 2f 0a 20 20 20 20  llbackTo */.    
ab50: 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0               
ab60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
ab70: 20 78 53 68 61 64 6f 77 4e 61 6d 65 20 2a 2f 0a   xShadowName */.
ab80: 20 20 7d 3b 0a 20 20 69 6e 74 20 72 63 3b 0a 0a    };.  int rc;..
ab90: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 63    rc = sqlite3_c
aba0: 72 65 61 74 65 5f 6d 6f 64 75 6c 65 28 64 62 2c  reate_module(db,
abb0: 20 22 75 6e 69 6f 6e 76 74 61 62 22 2c 20 26 75   "unionvtab", &u
abc0: 6e 69 6f 6e 4d 6f 64 75 6c 65 2c 20 30 29 3b 0a  nionModule, 0);.
abd0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
abe0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  _OK ){.    rc = 
abf0: 73 71 6c 69 74 65 33 5f 63 72 65 61 74 65 5f 6d  sqlite3_create_m
ac00: 6f 64 75 6c 65 28 64 62 2c 20 22 73 77 61 72 6d  odule(db, "swarm
ac10: 76 74 61 62 22 2c 20 26 75 6e 69 6f 6e 4d 6f 64  vtab", &unionMod
ac20: 75 6c 65 2c 20 28 76 6f 69 64 2a 29 64 62 29 3b  ule, (void*)db);
ac30: 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 72 63  .  }.  return rc
ac40: 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20 53  ;.}..#endif /* S
ac50: 51 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55  QLITE_OMIT_VIRTU
ac60: 41 4c 54 41 42 4c 45 20 2a 2f 0a 0a 23 69 66 64  ALTABLE */..#ifd
ac70: 65 66 20 5f 57 49 4e 33 32 0a 5f 5f 64 65 63 6c  ef _WIN32.__decl
ac80: 73 70 65 63 28 64 6c 6c 65 78 70 6f 72 74 29 0a  spec(dllexport).
ac90: 23 65 6e 64 69 66 0a 69 6e 74 20 73 71 6c 69 74  #endif.int sqlit
aca0: 65 33 5f 75 6e 69 6f 6e 76 74 61 62 5f 69 6e 69  e3_unionvtab_ini
acb0: 74 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  t(.  sqlite3 *db
acc0: 2c 20 0a 20 20 63 68 61 72 20 2a 2a 70 7a 45 72  , .  char **pzEr
acd0: 72 4d 73 67 2c 20 0a 20 20 63 6f 6e 73 74 20 73  rMsg, .  const s
ace0: 71 6c 69 74 65 33 5f 61 70 69 5f 72 6f 75 74 69  qlite3_api_routi
acf0: 6e 65 73 20 2a 70 41 70 69 0a 29 7b 0a 20 20 69  nes *pApi.){.  i
ad00: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  nt rc = SQLITE_O
ad10: 4b 3b 0a 20 20 53 51 4c 49 54 45 5f 45 58 54 45  K;.  SQLITE_EXTE
ad20: 4e 53 49 4f 4e 5f 49 4e 49 54 32 28 70 41 70 69  NSION_INIT2(pApi
ad30: 29 3b 0a 20 20 28 76 6f 69 64 29 70 7a 45 72 72  );.  (void)pzErr
ad40: 4d 73 67 3b 20 20 2f 2a 20 53 75 70 70 72 65 73  Msg;  /* Suppres
ad50: 73 20 68 61 72 6d 6c 65 73 73 20 77 61 72 6e 69  s harmless warni
ad60: 6e 67 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 51  ng */.#ifndef SQ
ad70: 4c 49 54 45 5f 4f 4d 49 54 5f 56 49 52 54 55 41  LITE_OMIT_VIRTUA
ad80: 4c 54 41 42 4c 45 0a 20 20 72 63 20 3d 20 63 72  LTABLE.  rc = cr
ad90: 65 61 74 65 55 6e 69 6f 6e 56 74 61 62 28 64 62  eateUnionVtab(db
ada0: 29 3b 0a 23 65 6e 64 69 66 0a 20 20 72 65 74 75  );.#endif.  retu
adb0: 72 6e 20 72 63 3b 0a 7d 0a                       rn rc;.}.