/ Hex Artifact Content
Login

Artifact db64c97583b59d78a9eebd2bfc3e61d9f571ef12:


0000: 2f 2a 0a 2a 2a 20 32 30 30 35 20 4d 61 79 20 32  /*.** 2005 May 2
0010: 35 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  5.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
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: 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63 6f  .** This file co
0180: 6e 74 61 69 6e 73 20 74 68 65 20 69 6d 70 6c 65  ntains the imple
0190: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
01a0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
01b0: 28 29 0a 2a 2a 20 69 6e 74 65 72 66 61 63 65 2c  ().** interface,
01c0: 20 61 6e 64 20 72 6f 75 74 69 6e 65 73 20 74 68   and routines th
01d0: 61 74 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f  at contribute to
01e0: 20 6c 6f 61 64 69 6e 67 20 74 68 65 20 64 61 74   loading the dat
01f0: 61 62 61 73 65 20 73 63 68 65 6d 61 0a 2a 2a 20  abase schema.** 
0200: 66 72 6f 6d 20 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a  from disk..**.**
0210: 20 24 49 64 3a 20 70 72 65 70 61 72 65 2e 63 2c   $Id: prepare.c,
0220: 76 20 31 2e 31 31 32 20 32 30 30 39 2f 30 33 2f  v 1.112 2009/03/
0230: 32 33 20 31 37 3a 31 31 3a 32 37 20 64 61 6e 69  23 17:11:27 dani
0240: 65 6c 6b 31 39 37 37 20 45 78 70 20 24 0a 2a 2f  elk1977 Exp $.*/
0250: 0a 23 69 6e 63 6c 75 64 65 20 22 73 71 6c 69 74  .#include "sqlit
0260: 65 49 6e 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 46  eInt.h"../*.** F
0270: 69 6c 6c 20 74 68 65 20 49 6e 69 74 44 61 74 61  ill the InitData
0280: 20 73 74 72 75 63 74 75 72 65 20 77 69 74 68 20   structure with 
0290: 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  an error message
02a0: 20 74 68 61 74 20 69 6e 64 69 63 61 74 65 73 0a   that indicates.
02b0: 2a 2a 20 74 68 61 74 20 74 68 65 20 64 61 74 61  ** that the data
02c0: 62 61 73 65 20 69 73 20 63 6f 72 72 75 70 74 2e  base is corrupt.
02d0: 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20  .*/.static void 
02e0: 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28 0a 20  corruptSchema(. 
02f0: 20 49 6e 69 74 44 61 74 61 20 2a 70 44 61 74 61   InitData *pData
0300: 2c 20 20 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c  ,     /* Initial
0310: 69 7a 61 74 69 6f 6e 20 63 6f 6e 74 65 78 74 20  ization context 
0320: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
0330: 2a 7a 4f 62 6a 2c 20 20 20 20 2f 2a 20 4f 62 6a  *zObj,    /* Obj
0340: 65 63 74 20 62 65 69 6e 67 20 70 61 72 73 65 64  ect being parsed
0350: 20 61 74 20 74 68 65 20 70 6f 69 6e 74 20 6f 66   at the point of
0360: 20 65 72 72 6f 72 20 2a 2f 0a 20 20 63 6f 6e 73   error */.  cons
0370: 74 20 63 68 61 72 20 2a 7a 45 78 74 72 61 20 20  t char *zExtra  
0380: 20 2f 2a 20 45 72 72 6f 72 20 69 6e 66 6f 72 6d   /* Error inform
0390: 61 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 73 71  ation */.){.  sq
03a0: 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 44 61 74  lite3 *db = pDat
03b0: 61 2d 3e 64 62 3b 0a 20 20 69 66 28 20 21 64 62  a->db;.  if( !db
03c0: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26  ->mallocFailed &
03d0: 26 20 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53  & (db->flags & S
03e0: 51 4c 49 54 45 5f 52 65 63 6f 76 65 72 79 4d 6f  QLITE_RecoveryMo
03f0: 64 65 29 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66  de)==0 ){.    if
0400: 28 20 7a 4f 62 6a 3d 3d 30 20 29 20 7a 4f 62 6a  ( zObj==0 ) zObj
0410: 20 3d 20 22 3f 22 3b 0a 20 20 20 20 73 71 6c 69   = "?";.    sqli
0420: 74 65 33 53 65 74 53 74 72 69 6e 67 28 70 44 61  te3SetString(pDa
0430: 74 61 2d 3e 70 7a 45 72 72 4d 73 67 2c 20 70 44  ta->pzErrMsg, pD
0440: 61 74 61 2d 3e 64 62 2c 0a 20 20 20 20 20 20 20  ata->db,.       
0450: 22 6d 61 6c 66 6f 72 6d 65 64 20 64 61 74 61 62  "malformed datab
0460: 61 73 65 20 73 63 68 65 6d 61 20 28 25 73 29 22  ase schema (%s)"
0470: 2c 20 7a 4f 62 6a 29 3b 0a 20 20 20 20 69 66 28  , zObj);.    if(
0480: 20 7a 45 78 74 72 61 20 26 26 20 7a 45 78 74 72   zExtra && zExtr
0490: 61 5b 30 5d 20 29 7b 0a 20 20 20 20 20 20 2a 70  a[0] ){.      *p
04a0: 44 61 74 61 2d 3e 70 7a 45 72 72 4d 73 67 20 3d  Data->pzErrMsg =
04b0: 20 73 71 6c 69 74 65 33 4d 41 70 70 65 6e 64 66   sqlite3MAppendf
04c0: 28 70 44 61 74 61 2d 3e 64 62 2c 20 2a 70 44 61  (pData->db, *pDa
04d0: 74 61 2d 3e 70 7a 45 72 72 4d 73 67 2c 20 22 25  ta->pzErrMsg, "%
04e0: 73 20 2d 20 25 73 22 2c 0a 20 20 20 20 20 20 20  s - %s",.       
04f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0500: 20 20 20 20 20 20 20 20 20 20 20 2a 70 44 61 74             *pDat
0510: 61 2d 3e 70 7a 45 72 72 4d 73 67 2c 20 7a 45 78  a->pzErrMsg, zEx
0520: 74 72 61 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  tra);.    }.  }.
0530: 20 20 70 44 61 74 61 2d 3e 72 63 20 3d 20 53 51    pData->rc = SQ
0540: 4c 49 54 45 5f 43 4f 52 52 55 50 54 3b 0a 7d 0a  LITE_CORRUPT;.}.
0550: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74  ./*.** This is t
0560: 68 65 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74  he callback rout
0570: 69 6e 65 20 66 6f 72 20 74 68 65 20 63 6f 64 65  ine for the code
0580: 20 74 68 61 74 20 69 6e 69 74 69 61 6c 69 7a 65   that initialize
0590: 73 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73  s the.** databas
05a0: 65 2e 20 20 53 65 65 20 73 71 6c 69 74 65 33 49  e.  See sqlite3I
05b0: 6e 69 74 28 29 20 62 65 6c 6f 77 20 66 6f 72 20  nit() below for 
05c0: 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72  additional infor
05d0: 6d 61 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20  mation..** This 
05e0: 72 6f 75 74 69 6e 65 20 69 73 20 61 6c 73 6f 20  routine is also 
05f0: 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 20  called from the 
0600: 4f 50 5f 50 61 72 73 65 53 63 68 65 6d 61 20 6f  OP_ParseSchema o
0610: 70 63 6f 64 65 20 6f 66 20 74 68 65 20 56 44 42  pcode of the VDB
0620: 45 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 63 61  E..**.** Each ca
0630: 6c 6c 62 61 63 6b 20 63 6f 6e 74 61 69 6e 73 20  llback contains 
0640: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e  the following in
0650: 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a 0a 2a 2a  formation:.**.**
0660: 20 20 20 20 20 61 72 67 76 5b 30 5d 20 3d 20 6e       argv[0] = n
0670: 61 6d 65 20 6f 66 20 74 68 69 6e 67 20 62 65 69  ame of thing bei
0680: 6e 67 20 63 72 65 61 74 65 64 0a 2a 2a 20 20 20  ng created.**   
0690: 20 20 61 72 67 76 5b 31 5d 20 3d 20 72 6f 6f 74    argv[1] = root
06a0: 20 70 61 67 65 20 6e 75 6d 62 65 72 20 66 6f 72   page number for
06b0: 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e   table or index.
06c0: 20 30 20 66 6f 72 20 74 72 69 67 67 65 72 20 6f   0 for trigger o
06d0: 72 20 76 69 65 77 2e 0a 2a 2a 20 20 20 20 20 61  r view..**     a
06e0: 72 67 76 5b 32 5d 20 3d 20 53 51 4c 20 74 65 78  rgv[2] = SQL tex
06f0: 74 20 66 6f 72 20 74 68 65 20 43 52 45 41 54 45  t for the CREATE
0700: 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a 2a 0a 2a   statement..**.*
0710: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 69  /.int sqlite3Ini
0720: 74 43 61 6c 6c 62 61 63 6b 28 76 6f 69 64 20 2a  tCallback(void *
0730: 70 49 6e 69 74 2c 20 69 6e 74 20 61 72 67 63 2c  pInit, int argc,
0740: 20 63 68 61 72 20 2a 2a 61 72 67 76 2c 20 63 68   char **argv, ch
0750: 61 72 20 2a 2a 4e 6f 74 55 73 65 64 29 7b 0a 20  ar **NotUsed){. 
0760: 20 49 6e 69 74 44 61 74 61 20 2a 70 44 61 74 61   InitData *pData
0770: 20 3d 20 28 49 6e 69 74 44 61 74 61 2a 29 70 49   = (InitData*)pI
0780: 6e 69 74 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a  nit;.  sqlite3 *
0790: 64 62 20 3d 20 70 44 61 74 61 2d 3e 64 62 3b 0a  db = pData->db;.
07a0: 20 20 69 6e 74 20 69 44 62 20 3d 20 70 44 61 74    int iDb = pDat
07b0: 61 2d 3e 69 44 62 3b 0a 0a 20 20 61 73 73 65 72  a->iDb;..  asser
07c0: 74 28 20 61 72 67 63 3d 3d 33 20 29 3b 0a 20 20  t( argc==3 );.  
07d0: 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 54 45 52  UNUSED_PARAMETER
07e0: 32 28 4e 6f 74 55 73 65 64 2c 20 61 72 67 63 29  2(NotUsed, argc)
07f0: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
0800: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64  te3_mutex_held(d
0810: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 44  b->mutex) );.  D
0820: 62 43 6c 65 61 72 50 72 6f 70 65 72 74 79 28 64  bClearProperty(d
0830: 62 2c 20 69 44 62 2c 20 44 42 5f 45 6d 70 74 79  b, iDb, DB_Empty
0840: 29 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c  );.  if( db->mal
0850: 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20  locFailed ){.   
0860: 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70   corruptSchema(p
0870: 44 61 74 61 2c 20 61 72 67 76 5b 30 5d 2c 20 30  Data, argv[0], 0
0880: 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51  );.    return SQ
0890: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a  LITE_NOMEM;.  }.
08a0: 0a 20 20 61 73 73 65 72 74 28 20 69 44 62 3e 3d  .  assert( iDb>=
08b0: 30 20 26 26 20 69 44 62 3c 64 62 2d 3e 6e 44 62  0 && iDb<db->nDb
08c0: 20 29 3b 0a 20 20 69 66 28 20 61 72 67 76 3d 3d   );.  if( argv==
08d0: 30 20 29 20 72 65 74 75 72 6e 20 30 3b 20 20 20  0 ) return 0;   
08e0: 2f 2a 20 4d 69 67 68 74 20 68 61 70 70 65 6e 20  /* Might happen 
08f0: 69 66 20 45 4d 50 54 59 5f 52 45 53 55 4c 54 5f  if EMPTY_RESULT_
0900: 43 41 4c 4c 42 41 43 4b 53 20 61 72 65 20 6f 6e  CALLBACKS are on
0910: 20 2a 2f 0a 20 20 69 66 28 20 61 72 67 76 5b 31   */.  if( argv[1
0920: 5d 3d 3d 30 20 29 7b 0a 20 20 20 20 63 6f 72 72  ]==0 ){.    corr
0930: 75 70 74 53 63 68 65 6d 61 28 70 44 61 74 61 2c  uptSchema(pData,
0940: 20 61 72 67 76 5b 30 5d 2c 20 30 29 3b 0a 20 20   argv[0], 0);.  
0950: 7d 65 6c 73 65 20 69 66 28 20 61 72 67 76 5b 32  }else if( argv[2
0960: 5d 20 26 26 20 61 72 67 76 5b 32 5d 5b 30 5d 20  ] && argv[2][0] 
0970: 29 7b 0a 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74  ){.    /* Call t
0980: 68 65 20 70 61 72 73 65 72 20 74 6f 20 70 72 6f  he parser to pro
0990: 63 65 73 73 20 61 20 43 52 45 41 54 45 20 54 41  cess a CREATE TA
09a0: 42 4c 45 2c 20 49 4e 44 45 58 20 6f 72 20 56 49  BLE, INDEX or VI
09b0: 45 57 2e 0a 20 20 20 20 2a 2a 20 42 75 74 20 62  EW..    ** But b
09c0: 65 63 61 75 73 65 20 64 62 2d 3e 69 6e 69 74 2e  ecause db->init.
09d0: 62 75 73 79 20 69 73 20 73 65 74 20 74 6f 20 31  busy is set to 1
09e0: 2c 20 6e 6f 20 56 44 42 45 20 63 6f 64 65 20 69  , no VDBE code i
09f0: 73 20 67 65 6e 65 72 61 74 65 64 0a 20 20 20 20  s generated.    
0a00: 2a 2a 20 6f 72 20 65 78 65 63 75 74 65 64 2e 20  ** or executed. 
0a10: 20 41 6c 6c 20 74 68 65 20 70 61 72 73 65 72 20   All the parser 
0a20: 64 6f 65 73 20 69 73 20 62 75 69 6c 64 20 74 68  does is build th
0a30: 65 20 69 6e 74 65 72 6e 61 6c 20 64 61 74 61 0a  e internal data.
0a40: 20 20 20 20 2a 2a 20 73 74 72 75 63 74 75 72 65      ** structure
0a50: 73 20 74 68 61 74 20 64 65 73 63 72 69 62 65 20  s that describe 
0a60: 74 68 65 20 74 61 62 6c 65 2c 20 69 6e 64 65 78  the table, index
0a70: 2c 20 6f 72 20 76 69 65 77 2e 0a 20 20 20 20 2a  , or view..    *
0a80: 2f 0a 20 20 20 20 63 68 61 72 20 2a 7a 45 72 72  /.    char *zErr
0a90: 3b 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20  ;.    int rc;.  
0aa0: 20 20 75 38 20 6c 6f 6f 6b 61 73 69 64 65 45 6e    u8 lookasideEn
0ab0: 61 62 6c 65 64 3b 0a 20 20 20 20 61 73 73 65 72  abled;.    asser
0ac0: 74 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79  t( db->init.busy
0ad0: 20 29 3b 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74   );.    db->init
0ae0: 2e 69 44 62 20 3d 20 69 44 62 3b 0a 20 20 20 20  .iDb = iDb;.    
0af0: 64 62 2d 3e 69 6e 69 74 2e 6e 65 77 54 6e 75 6d  db->init.newTnum
0b00: 20 3d 20 61 74 6f 69 28 61 72 67 76 5b 31 5d 29   = atoi(argv[1])
0b10: 3b 0a 20 20 20 20 6c 6f 6f 6b 61 73 69 64 65 45  ;.    lookasideE
0b20: 6e 61 62 6c 65 64 20 3d 20 64 62 2d 3e 6c 6f 6f  nabled = db->loo
0b30: 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c 65 64 3b  kaside.bEnabled;
0b40: 0a 20 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69  .    db->lookasi
0b50: 64 65 2e 62 45 6e 61 62 6c 65 64 20 3d 20 30 3b  de.bEnabled = 0;
0b60: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
0b70: 33 5f 65 78 65 63 28 64 62 2c 20 61 72 67 76 5b  3_exec(db, argv[
0b80: 32 5d 2c 20 30 2c 20 30 2c 20 26 7a 45 72 72 29  2], 0, 0, &zErr)
0b90: 3b 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69  ;.    db->init.i
0ba0: 44 62 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e  Db = 0;.    db->
0bb0: 6c 6f 6f 6b 61 73 69 64 65 2e 62 45 6e 61 62 6c  lookaside.bEnabl
0bc0: 65 64 20 3d 20 6c 6f 6f 6b 61 73 69 64 65 45 6e  ed = lookasideEn
0bd0: 61 62 6c 65 64 3b 0a 20 20 20 20 61 73 73 65 72  abled;.    asser
0be0: 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b  t( rc!=SQLITE_OK
0bf0: 20 7c 7c 20 7a 45 72 72 3d 3d 30 20 29 3b 0a 20   || zErr==0 );. 
0c00: 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f 4b     if( SQLITE_OK
0c10: 21 3d 72 63 20 29 7b 0a 20 20 20 20 20 20 70 44  !=rc ){.      pD
0c20: 61 74 61 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20  ata->rc = rc;.  
0c30: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
0c40: 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20  TE_NOMEM ){.    
0c50: 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61      db->mallocFa
0c60: 69 6c 65 64 20 3d 20 31 3b 0a 20 20 20 20 20 20  iled = 1;.      
0c70: 7d 65 6c 73 65 20 69 66 28 20 72 63 21 3d 53 51  }else if( rc!=SQ
0c80: 4c 49 54 45 5f 49 4e 54 45 52 52 55 50 54 20 26  LITE_INTERRUPT &
0c90: 26 20 28 72 63 26 30 78 66 66 29 21 3d 53 51 4c  & (rc&0xff)!=SQL
0ca0: 49 54 45 5f 4c 4f 43 4b 45 44 20 29 7b 0a 20 20  ITE_LOCKED ){.  
0cb0: 20 20 20 20 20 20 63 6f 72 72 75 70 74 53 63 68        corruptSch
0cc0: 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67 76 5b  ema(pData, argv[
0cd0: 30 5d 2c 20 7a 45 72 72 29 3b 0a 20 20 20 20 20  0], zErr);.     
0ce0: 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33   }.      sqlite3
0cf0: 44 62 46 72 65 65 28 64 62 2c 20 7a 45 72 72 29  DbFree(db, zErr)
0d00: 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 20  ;.    }.  }else 
0d10: 69 66 28 20 61 72 67 76 5b 30 5d 3d 3d 30 20 29  if( argv[0]==0 )
0d20: 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53 63 68  {.    corruptSch
0d30: 65 6d 61 28 70 44 61 74 61 2c 20 30 2c 20 30 29  ema(pData, 0, 0)
0d40: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f  ;.  }else{.    /
0d50: 2a 20 49 66 20 74 68 65 20 53 51 4c 20 63 6f 6c  * If the SQL col
0d60: 75 6d 6e 20 69 73 20 62 6c 61 6e 6b 20 69 74 20  umn is blank it 
0d70: 6d 65 61 6e 73 20 74 68 69 73 20 69 73 20 61 6e  means this is an
0d80: 20 69 6e 64 65 78 20 74 68 61 74 0a 20 20 20 20   index that.    
0d90: 2a 2a 20 77 61 73 20 63 72 65 61 74 65 64 20 74  ** was created t
0da0: 6f 20 62 65 20 74 68 65 20 50 52 49 4d 41 52 59  o be the PRIMARY
0db0: 20 4b 45 59 20 6f 72 20 74 6f 20 66 75 6c 66 69   KEY or to fulfi
0dc0: 6c 6c 20 61 20 55 4e 49 51 55 45 0a 20 20 20 20  ll a UNIQUE.    
0dd0: 2a 2a 20 63 6f 6e 73 74 72 61 69 6e 74 20 66 6f  ** constraint fo
0de0: 72 20 61 20 43 52 45 41 54 45 20 54 41 42 4c 45  r a CREATE TABLE
0df0: 2e 20 20 54 68 65 20 69 6e 64 65 78 20 73 68 6f  .  The index sho
0e00: 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61 64 79  uld have already
0e10: 0a 20 20 20 20 2a 2a 20 62 65 65 6e 20 63 72 65  .    ** been cre
0e20: 61 74 65 64 20 77 68 65 6e 20 77 65 20 70 72 6f  ated when we pro
0e30: 63 65 73 73 65 64 20 74 68 65 20 43 52 45 41 54  cessed the CREAT
0e40: 45 20 54 41 42 4c 45 2e 20 20 41 6c 6c 20 77 65  E TABLE.  All we
0e50: 20 68 61 76 65 0a 20 20 20 20 2a 2a 20 74 6f 20   have.    ** to 
0e60: 64 6f 20 68 65 72 65 20 69 73 20 72 65 63 6f 72  do here is recor
0e70: 64 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20  d the root page 
0e80: 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 61 74 20  number for that 
0e90: 69 6e 64 65 78 2e 0a 20 20 20 20 2a 2f 0a 20 20  index..    */.  
0ea0: 20 20 49 6e 64 65 78 20 2a 70 49 6e 64 65 78 3b    Index *pIndex;
0eb0: 0a 20 20 20 20 70 49 6e 64 65 78 20 3d 20 73 71  .    pIndex = sq
0ec0: 6c 69 74 65 33 46 69 6e 64 49 6e 64 65 78 28 64  lite3FindIndex(d
0ed0: 62 2c 20 61 72 67 76 5b 30 5d 2c 20 64 62 2d 3e  b, argv[0], db->
0ee0: 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 29 3b  aDb[iDb].zName);
0ef0: 0a 20 20 20 20 69 66 28 20 70 49 6e 64 65 78 3d  .    if( pIndex=
0f00: 3d 30 20 7c 7c 20 70 49 6e 64 65 78 2d 3e 74 6e  =0 || pIndex->tn
0f10: 75 6d 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 2f  um!=0 ){.      /
0f20: 2a 20 54 68 69 73 20 63 61 6e 20 6f 63 63 75 72  * This can occur
0f30: 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74 73   if there exists
0f40: 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20 61 20 54   an index on a T
0f50: 45 4d 50 20 74 61 62 6c 65 20 77 68 69 63 68 0a  EMP table which.
0f60: 20 20 20 20 20 20 2a 2a 20 68 61 73 20 74 68 65        ** has the
0f70: 20 73 61 6d 65 20 6e 61 6d 65 20 61 73 20 61 6e   same name as an
0f80: 6f 74 68 65 72 20 69 6e 64 65 78 20 6f 6e 20 61  other index on a
0f90: 20 70 65 72 6d 61 6e 65 6e 74 20 69 6e 64 65 78   permanent index
0fa0: 2e 20 20 53 69 6e 63 65 0a 20 20 20 20 20 20 2a  .  Since.      *
0fb0: 2a 20 74 68 65 20 70 65 72 6d 61 6e 65 6e 74 20  * the permanent 
0fc0: 74 61 62 6c 65 20 69 73 20 68 69 64 64 65 6e 20  table is hidden 
0fd0: 62 79 20 74 68 65 20 54 45 4d 50 20 74 61 62 6c  by the TEMP tabl
0fe0: 65 2c 20 77 65 20 63 61 6e 20 61 6c 73 6f 0a 20  e, we can also. 
0ff0: 20 20 20 20 20 2a 2a 20 73 61 66 65 6c 79 20 69       ** safely i
1000: 67 6e 6f 72 65 20 74 68 65 20 69 6e 64 65 78 20  gnore the index 
1010: 6f 6e 20 74 68 65 20 70 65 72 6d 61 6e 65 6e 74  on the permanent
1020: 20 74 61 62 6c 65 2e 0a 20 20 20 20 20 20 2a 2f   table..      */
1030: 0a 20 20 20 20 20 20 2f 2a 20 44 6f 20 4e 6f 74  .      /* Do Not
1040: 68 69 6e 67 20 2a 2f 3b 0a 20 20 20 20 7d 65 6c  hing */;.    }el
1050: 73 65 7b 0a 20 20 20 20 20 20 70 49 6e 64 65 78  se{.      pIndex
1060: 2d 3e 74 6e 75 6d 20 3d 20 61 74 6f 69 28 61 72  ->tnum = atoi(ar
1070: 67 76 5b 31 5d 29 3b 0a 20 20 20 20 7d 0a 20 20  gv[1]);.    }.  
1080: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  }.  return 0;.}.
1090: 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74  ./*.** Attempt t
10a0: 6f 20 72 65 61 64 20 74 68 65 20 64 61 74 61 62  o read the datab
10b0: 61 73 65 20 73 63 68 65 6d 61 20 61 6e 64 20 69  ase schema and i
10c0: 6e 69 74 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e  nitialize intern
10d0: 61 6c 0a 2a 2a 20 64 61 74 61 20 73 74 72 75 63  al.** data struc
10e0: 74 75 72 65 73 20 66 6f 72 20 61 20 73 69 6e 67  tures for a sing
10f0: 6c 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  le database file
1100: 2e 20 20 54 68 65 20 69 6e 64 65 78 20 6f 66 20  .  The index of 
1110: 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20  the.** database 
1120: 66 69 6c 65 20 69 73 20 67 69 76 65 6e 20 62 79  file is given by
1130: 20 69 44 62 2e 20 20 69 44 62 3d 3d 30 20 69 73   iDb.  iDb==0 is
1140: 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 6d 61   used for the ma
1150: 69 6e 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20  in.** database. 
1160: 20 69 44 62 3d 3d 31 20 73 68 6f 75 6c 64 20 6e   iDb==1 should n
1170: 65 76 65 72 20 62 65 20 75 73 65 64 2e 20 20 69  ever be used.  i
1180: 44 62 3e 3d 32 20 69 73 20 75 73 65 64 20 66 6f  Db>=2 is used fo
1190: 72 0a 2a 2a 20 61 75 78 69 6c 69 61 72 79 20 64  r.** auxiliary d
11a0: 61 74 61 62 61 73 65 73 2e 20 20 52 65 74 75 72  atabases.  Retur
11b0: 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 53 51 4c  n one of the SQL
11c0: 49 54 45 5f 20 65 72 72 6f 72 20 63 6f 64 65 73  ITE_ error codes
11d0: 20 74 6f 0a 2a 2a 20 69 6e 64 69 63 61 74 65 20   to.** indicate 
11e0: 73 75 63 63 65 73 73 20 6f 72 20 66 61 69 6c 75  success or failu
11f0: 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  re..*/.static in
1200: 74 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65  t sqlite3InitOne
1210: 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69 6e  (sqlite3 *db, in
1220: 74 20 69 44 62 2c 20 63 68 61 72 20 2a 2a 70 7a  t iDb, char **pz
1230: 45 72 72 4d 73 67 29 7b 0a 20 20 69 6e 74 20 72  ErrMsg){.  int r
1240: 63 3b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 63  c;.  BtCursor *c
1250: 75 72 4d 61 69 6e 3b 0a 20 20 69 6e 74 20 73 69  urMain;.  int si
1260: 7a 65 3b 0a 20 20 54 61 62 6c 65 20 2a 70 54 61  ze;.  Table *pTa
1270: 62 3b 0a 20 20 44 62 20 2a 70 44 62 3b 0a 20 20  b;.  Db *pDb;.  
1280: 63 68 61 72 20 63 6f 6e 73 74 20 2a 61 7a 41 72  char const *azAr
1290: 67 5b 34 5d 3b 0a 20 20 69 6e 74 20 6d 65 74 61  g[4];.  int meta
12a0: 5b 31 30 5d 3b 0a 20 20 49 6e 69 74 44 61 74 61  [10];.  InitData
12b0: 20 69 6e 69 74 44 61 74 61 3b 0a 20 20 63 68 61   initData;.  cha
12c0: 72 20 63 6f 6e 73 74 20 2a 7a 4d 61 73 74 65 72  r const *zMaster
12d0: 53 63 68 65 6d 61 3b 0a 20 20 63 68 61 72 20 63  Schema;.  char c
12e0: 6f 6e 73 74 20 2a 7a 4d 61 73 74 65 72 4e 61 6d  onst *zMasterNam
12f0: 65 20 3d 20 53 43 48 45 4d 41 5f 54 41 42 4c 45  e = SCHEMA_TABLE
1300: 28 69 44 62 29 3b 0a 0a 20 20 2f 2a 0a 20 20 2a  (iDb);..  /*.  *
1310: 2a 20 54 68 65 20 6d 61 73 74 65 72 20 64 61 74  * The master dat
1320: 61 62 61 73 65 20 74 61 62 6c 65 20 68 61 73 20  abase table has 
1330: 61 20 73 74 72 75 63 74 75 72 65 20 6c 69 6b 65  a structure like
1340: 20 74 68 69 73 0a 20 20 2a 2f 0a 20 20 73 74 61   this.  */.  sta
1350: 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 6d  tic const char m
1360: 61 73 74 65 72 5f 73 63 68 65 6d 61 5b 5d 20 3d  aster_schema[] =
1370: 20 0a 20 20 20 20 20 22 43 52 45 41 54 45 20 54   .     "CREATE T
1380: 41 42 4c 45 20 73 71 6c 69 74 65 5f 6d 61 73 74  ABLE sqlite_mast
1390: 65 72 28 5c 6e 22 0a 20 20 20 20 20 22 20 20 74  er(\n".     "  t
13a0: 79 70 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20  ype text,\n".   
13b0: 20 20 22 20 20 6e 61 6d 65 20 74 65 78 74 2c 5c    "  name text,\
13c0: 6e 22 0a 20 20 20 20 20 22 20 20 74 62 6c 5f 6e  n".     "  tbl_n
13d0: 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20  ame text,\n".   
13e0: 20 20 22 20 20 72 6f 6f 74 70 61 67 65 20 69 6e    "  rootpage in
13f0: 74 65 67 65 72 2c 5c 6e 22 0a 20 20 20 20 20 22  teger,\n".     "
1400: 20 20 73 71 6c 20 74 65 78 74 5c 6e 22 0a 20 20    sql text\n".  
1410: 20 20 20 22 29 22 0a 20 20 3b 0a 23 69 66 6e 64     ")".  ;.#ifnd
1420: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54  ef SQLITE_OMIT_T
1430: 45 4d 50 44 42 0a 20 20 73 74 61 74 69 63 20 63  EMPDB.  static c
1440: 6f 6e 73 74 20 63 68 61 72 20 74 65 6d 70 5f 6d  onst char temp_m
1450: 61 73 74 65 72 5f 73 63 68 65 6d 61 5b 5d 20 3d  aster_schema[] =
1460: 20 0a 20 20 20 20 20 22 43 52 45 41 54 45 20 54   .     "CREATE T
1470: 45 4d 50 20 54 41 42 4c 45 20 73 71 6c 69 74 65  EMP TABLE sqlite
1480: 5f 74 65 6d 70 5f 6d 61 73 74 65 72 28 5c 6e 22  _temp_master(\n"
1490: 0a 20 20 20 20 20 22 20 20 74 79 70 65 20 74 65  .     "  type te
14a0: 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 6e  xt,\n".     "  n
14b0: 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20  ame text,\n".   
14c0: 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20 74 65    "  tbl_name te
14d0: 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 72  xt,\n".     "  r
14e0: 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65 72 2c  ootpage integer,
14f0: 5c 6e 22 0a 20 20 20 20 20 22 20 20 73 71 6c 20  \n".     "  sql 
1500: 74 65 78 74 5c 6e 22 0a 20 20 20 20 20 22 29 22  text\n".     ")"
1510: 0a 20 20 3b 0a 23 65 6c 73 65 0a 20 20 23 64 65  .  ;.#else.  #de
1520: 66 69 6e 65 20 74 65 6d 70 5f 6d 61 73 74 65 72  fine temp_master
1530: 5f 73 63 68 65 6d 61 20 30 0a 23 65 6e 64 69 66  _schema 0.#endif
1540: 0a 0a 20 20 61 73 73 65 72 74 28 20 69 44 62 3e  ..  assert( iDb>
1550: 3d 30 20 26 26 20 69 44 62 3c 64 62 2d 3e 6e 44  =0 && iDb<db->nD
1560: 62 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64  b );.  assert( d
1570: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 53 63 68  b->aDb[iDb].pSch
1580: 65 6d 61 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ema );.  assert(
1590: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
15a0: 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29  eld(db->mutex) )
15b0: 3b 0a 20 20 61 73 73 65 72 74 28 20 69 44 62 3d  ;.  assert( iDb=
15c0: 3d 31 20 7c 7c 20 73 71 6c 69 74 65 33 42 74 72  =1 || sqlite3Btr
15d0: 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 64 62 2d  eeHoldsMutex(db-
15e0: 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 29 20 29  >aDb[iDb].pBt) )
15f0: 3b 0a 0a 20 20 2f 2a 20 7a 4d 61 73 74 65 72 53  ;..  /* zMasterS
1600: 63 68 65 6d 61 20 61 6e 64 20 7a 49 6e 69 74 53  chema and zInitS
1610: 63 72 69 70 74 20 61 72 65 20 73 65 74 20 74 6f  cript are set to
1620: 20 70 6f 69 6e 74 20 61 74 20 74 68 65 20 6d 61   point at the ma
1630: 73 74 65 72 20 73 63 68 65 6d 61 0a 20 20 2a 2a  ster schema.  **
1640: 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 73 61 74   and initialisat
1650: 69 6f 6e 20 73 63 72 69 70 74 20 61 70 70 72 6f  ion script appro
1660: 70 72 69 61 74 65 20 66 6f 72 20 74 68 65 20 64  priate for the d
1670: 61 74 61 62 61 73 65 20 62 65 69 6e 67 0a 20 20  atabase being.  
1680: 2a 2a 20 69 6e 69 74 69 61 6c 69 73 65 64 2e 20  ** initialised. 
1690: 7a 4d 61 73 74 65 72 4e 61 6d 65 20 69 73 20 74  zMasterName is t
16a0: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 6d  he name of the m
16b0: 61 73 74 65 72 20 74 61 62 6c 65 2e 0a 20 20 2a  aster table..  *
16c0: 2f 0a 20 20 69 66 28 20 21 4f 4d 49 54 5f 54 45  /.  if( !OMIT_TE
16d0: 4d 50 44 42 20 26 26 20 69 44 62 3d 3d 31 20 29  MPDB && iDb==1 )
16e0: 7b 0a 20 20 20 20 7a 4d 61 73 74 65 72 53 63 68  {.    zMasterSch
16f0: 65 6d 61 20 3d 20 74 65 6d 70 5f 6d 61 73 74 65  ema = temp_maste
1700: 72 5f 73 63 68 65 6d 61 3b 0a 20 20 7d 65 6c 73  r_schema;.  }els
1710: 65 7b 0a 20 20 20 20 7a 4d 61 73 74 65 72 53 63  e{.    zMasterSc
1720: 68 65 6d 61 20 3d 20 6d 61 73 74 65 72 5f 73 63  hema = master_sc
1730: 68 65 6d 61 3b 0a 20 20 7d 0a 20 20 7a 4d 61 73  hema;.  }.  zMas
1740: 74 65 72 4e 61 6d 65 20 3d 20 53 43 48 45 4d 41  terName = SCHEMA
1750: 5f 54 41 42 4c 45 28 69 44 62 29 3b 0a 0a 20 20  _TABLE(iDb);..  
1760: 2f 2a 20 43 6f 6e 73 74 72 75 63 74 20 74 68 65  /* Construct the
1770: 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73 2e 20   schema tables. 
1780: 20 2a 2f 0a 20 20 61 7a 41 72 67 5b 30 5d 20 3d   */.  azArg[0] =
1790: 20 7a 4d 61 73 74 65 72 4e 61 6d 65 3b 0a 20 20   zMasterName;.  
17a0: 61 7a 41 72 67 5b 31 5d 20 3d 20 22 31 22 3b 0a  azArg[1] = "1";.
17b0: 20 20 61 7a 41 72 67 5b 32 5d 20 3d 20 7a 4d 61    azArg[2] = zMa
17c0: 73 74 65 72 53 63 68 65 6d 61 3b 0a 20 20 61 7a  sterSchema;.  az
17d0: 41 72 67 5b 33 5d 20 3d 20 30 3b 0a 20 20 69 6e  Arg[3] = 0;.  in
17e0: 69 74 44 61 74 61 2e 64 62 20 3d 20 64 62 3b 0a  itData.db = db;.
17f0: 20 20 69 6e 69 74 44 61 74 61 2e 69 44 62 20 3d    initData.iDb =
1800: 20 69 44 62 3b 0a 20 20 69 6e 69 74 44 61 74 61   iDb;.  initData
1810: 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  .rc = SQLITE_OK;
1820: 0a 20 20 69 6e 69 74 44 61 74 61 2e 70 7a 45 72  .  initData.pzEr
1830: 72 4d 73 67 20 3d 20 70 7a 45 72 72 4d 73 67 3b  rMsg = pzErrMsg;
1840: 0a 20 20 28 76 6f 69 64 29 73 71 6c 69 74 65 33  .  (void)sqlite3
1850: 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a 20  SafetyOff(db);. 
1860: 20 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c   sqlite3InitCall
1870: 62 61 63 6b 28 26 69 6e 69 74 44 61 74 61 2c 20  back(&initData, 
1880: 33 2c 20 28 63 68 61 72 20 2a 2a 29 61 7a 41 72  3, (char **)azAr
1890: 67 2c 20 30 29 3b 0a 20 20 28 76 6f 69 64 29 73  g, 0);.  (void)s
18a0: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64  qlite3SafetyOn(d
18b0: 62 29 3b 0a 20 20 69 66 28 20 69 6e 69 74 44 61  b);.  if( initDa
18c0: 74 61 2e 72 63 20 29 7b 0a 20 20 20 20 72 63 20  ta.rc ){.    rc 
18d0: 3d 20 69 6e 69 74 44 61 74 61 2e 72 63 3b 0a 20  = initData.rc;. 
18e0: 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75     goto error_ou
18f0: 74 3b 0a 20 20 7d 0a 20 20 70 54 61 62 20 3d 20  t;.  }.  pTab = 
1900: 73 71 6c 69 74 65 33 46 69 6e 64 54 61 62 6c 65  sqlite3FindTable
1910: 28 64 62 2c 20 7a 4d 61 73 74 65 72 4e 61 6d 65  (db, zMasterName
1920: 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a  , db->aDb[iDb].z
1930: 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 70 54 61  Name);.  if( pTa
1940: 62 20 29 7b 0a 20 20 20 20 70 54 61 62 2d 3e 74  b ){.    pTab->t
1950: 61 62 46 6c 61 67 73 20 7c 3d 20 54 46 5f 52 65  abFlags |= TF_Re
1960: 61 64 6f 6e 6c 79 3b 0a 20 20 7d 0a 0a 20 20 2f  adonly;.  }..  /
1970: 2a 20 43 72 65 61 74 65 20 61 20 63 75 72 73 6f  * Create a curso
1980: 72 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 64 61  r to hold the da
1990: 74 61 62 61 73 65 20 6f 70 65 6e 0a 20 20 2a 2f  tabase open.  */
19a0: 0a 20 20 70 44 62 20 3d 20 26 64 62 2d 3e 61 44  .  pDb = &db->aD
19b0: 62 5b 69 44 62 5d 3b 0a 20 20 69 66 28 20 70 44  b[iDb];.  if( pD
19c0: 62 2d 3e 70 42 74 3d 3d 30 20 29 7b 0a 20 20 20  b->pBt==0 ){.   
19d0: 20 69 66 28 20 21 4f 4d 49 54 5f 54 45 4d 50 44   if( !OMIT_TEMPD
19e0: 42 20 26 26 20 69 44 62 3d 3d 31 20 29 7b 0a 20  B && iDb==1 ){. 
19f0: 20 20 20 20 20 44 62 53 65 74 50 72 6f 70 65 72       DbSetProper
1a00: 74 79 28 64 62 2c 20 31 2c 20 44 42 5f 53 63 68  ty(db, 1, DB_Sch
1a10: 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 20 20 20  emaLoaded);.    
1a20: 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c  }.    return SQL
1a30: 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 63 75  ITE_OK;.  }.  cu
1a40: 72 4d 61 69 6e 20 3d 20 73 71 6c 69 74 65 33 4d  rMain = sqlite3M
1a50: 61 6c 6c 6f 63 5a 65 72 6f 28 73 71 6c 69 74 65  allocZero(sqlite
1a60: 33 42 74 72 65 65 43 75 72 73 6f 72 53 69 7a 65  3BtreeCursorSize
1a70: 28 29 29 3b 0a 20 20 69 66 28 20 21 63 75 72 4d  ());.  if( !curM
1a80: 61 69 6e 20 29 7b 0a 20 20 20 20 72 63 20 3d 20  ain ){.    rc = 
1a90: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20  SQLITE_NOMEM;.  
1aa0: 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74    goto error_out
1ab0: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 42  ;.  }.  sqlite3B
1ac0: 74 72 65 65 45 6e 74 65 72 28 70 44 62 2d 3e 70  treeEnter(pDb->p
1ad0: 42 74 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69  Bt);.  rc = sqli
1ae0: 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 28 70  te3BtreeCursor(p
1af0: 44 62 2d 3e 70 42 74 2c 20 4d 41 53 54 45 52 5f  Db->pBt, MASTER_
1b00: 52 4f 4f 54 2c 20 30 2c 20 30 2c 20 63 75 72 4d  ROOT, 0, 0, curM
1b10: 61 69 6e 29 3b 0a 20 20 69 66 28 20 72 63 21 3d  ain);.  if( rc!=
1b20: 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 72 63 21  SQLITE_OK && rc!
1b30: 3d 53 51 4c 49 54 45 5f 45 4d 50 54 59 20 29 7b  =SQLITE_EMPTY ){
1b40: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53  .    sqlite3SetS
1b50: 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20  tring(pzErrMsg, 
1b60: 64 62 2c 20 22 25 73 22 2c 20 73 71 6c 69 74 65  db, "%s", sqlite
1b70: 33 45 72 72 53 74 72 28 72 63 29 29 3b 0a 20 20  3ErrStr(rc));.  
1b80: 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f 65    goto initone_e
1b90: 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20  rror_out;.  }.. 
1ba0: 20 2f 2a 20 47 65 74 20 74 68 65 20 64 61 74 61   /* Get the data
1bb0: 62 61 73 65 20 6d 65 74 61 20 69 6e 66 6f 72 6d  base meta inform
1bc0: 61 74 69 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  ation..  **.  **
1bd0: 20 4d 65 74 61 20 76 61 6c 75 65 73 20 61 72 65   Meta values are
1be0: 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a   as follows:.  *
1bf0: 2a 20 20 20 20 6d 65 74 61 5b 30 5d 20 20 20 53  *    meta[0]   S
1c00: 63 68 65 6d 61 20 63 6f 6f 6b 69 65 2e 20 20 43  chema cookie.  C
1c10: 68 61 6e 67 65 73 20 77 69 74 68 20 65 61 63 68  hanges with each
1c20: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 2e 0a   schema change..
1c30: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 31 5d 20    **    meta[1] 
1c40: 20 20 46 69 6c 65 20 66 6f 72 6d 61 74 20 6f 66    File format of
1c50: 20 73 63 68 65 6d 61 20 6c 61 79 65 72 2e 0a 20   schema layer.. 
1c60: 20 2a 2a 20 20 20 20 6d 65 74 61 5b 32 5d 20 20   **    meta[2]  
1c70: 20 53 69 7a 65 20 6f 66 20 74 68 65 20 70 61 67   Size of the pag
1c80: 65 20 63 61 63 68 65 2e 0a 20 20 2a 2a 20 20 20  e cache..  **   
1c90: 20 6d 65 74 61 5b 33 5d 20 20 20 55 73 65 20 66   meta[3]   Use f
1ca0: 72 65 65 6c 69 73 74 20 69 66 20 30 2e 20 20 41  reelist if 0.  A
1cb0: 75 74 6f 76 61 63 75 75 6d 20 69 66 20 67 72 65  utovacuum if gre
1cc0: 61 74 65 72 20 74 68 61 6e 20 7a 65 72 6f 2e 0a  ater than zero..
1cd0: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 34 5d 20    **    meta[4] 
1ce0: 20 20 44 62 20 74 65 78 74 20 65 6e 63 6f 64 69    Db text encodi
1cf0: 6e 67 2e 20 31 3a 55 54 46 2d 38 20 32 3a 55 54  ng. 1:UTF-8 2:UT
1d00: 46 2d 31 36 4c 45 20 33 3a 55 54 46 2d 31 36 42  F-16LE 3:UTF-16B
1d10: 45 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 35  E.  **    meta[5
1d20: 5d 20 20 20 54 68 65 20 75 73 65 72 20 63 6f 6f  ]   The user coo
1d30: 6b 69 65 2e 20 55 73 65 64 20 62 79 20 74 68 65  kie. Used by the
1d40: 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e 0a 20 20   application..  
1d50: 2a 2a 20 20 20 20 6d 65 74 61 5b 36 5d 20 20 20  **    meta[6]   
1d60: 49 6e 63 72 65 6d 65 6e 74 61 6c 2d 76 61 63 75  Incremental-vacu
1d70: 75 6d 20 66 6c 61 67 2e 0a 20 20 2a 2a 20 20 20  um flag..  **   
1d80: 20 6d 65 74 61 5b 37 5d 0a 20 20 2a 2a 20 20 20   meta[7].  **   
1d90: 20 6d 65 74 61 5b 38 5d 0a 20 20 2a 2a 20 20 20   meta[8].  **   
1da0: 20 6d 65 74 61 5b 39 5d 0a 20 20 2a 2a 0a 20 20   meta[9].  **.  
1db0: 2a 2a 20 4e 6f 74 65 3a 20 54 68 65 20 23 64 65  ** Note: The #de
1dc0: 66 69 6e 65 64 20 53 51 4c 49 54 45 5f 55 54 46  fined SQLITE_UTF
1dd0: 2a 20 73 79 6d 62 6f 6c 73 20 69 6e 20 73 71 6c  * symbols in sql
1de0: 69 74 65 49 6e 74 2e 68 20 63 6f 72 72 65 73 70  iteInt.h corresp
1df0: 6f 6e 64 20 74 6f 0a 20 20 2a 2a 20 74 68 65 20  ond to.  ** the 
1e00: 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20  possible values 
1e10: 6f 66 20 6d 65 74 61 5b 34 5d 2e 0a 20 20 2a 2f  of meta[4]..  */
1e20: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
1e30: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 6e 74 20  E_OK ){.    int 
1e40: 69 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  i;.    for(i=0; 
1e50: 69 3c 41 72 72 61 79 53 69 7a 65 28 6d 65 74 61  i<ArraySize(meta
1e60: 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 72  ); i++){.      r
1e70: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
1e80: 47 65 74 4d 65 74 61 28 70 44 62 2d 3e 70 42 74  GetMeta(pDb->pBt
1e90: 2c 20 69 2b 31 2c 20 28 75 33 32 20 2a 29 26 6d  , i+1, (u32 *)&m
1ea0: 65 74 61 5b 69 5d 29 3b 0a 20 20 20 20 20 20 69  eta[i]);.      i
1eb0: 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 20  f( rc ){.       
1ec0: 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e   sqlite3SetStrin
1ed0: 67 28 70 7a 45 72 72 4d 73 67 2c 20 64 62 2c 20  g(pzErrMsg, db, 
1ee0: 22 25 73 22 2c 20 73 71 6c 69 74 65 33 45 72 72  "%s", sqlite3Err
1ef0: 53 74 72 28 72 63 29 29 3b 0a 20 20 20 20 20 20  Str(rc));.      
1f00: 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f 65    goto initone_e
1f10: 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 20 20 20 20  rror_out;.      
1f20: 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b  }.    }.  }else{
1f30: 0a 20 20 20 20 6d 65 6d 73 65 74 28 6d 65 74 61  .    memset(meta
1f40: 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d 65 74 61  , 0, sizeof(meta
1f50: 29 29 3b 0a 20 20 7d 0a 20 20 70 44 62 2d 3e 70  ));.  }.  pDb->p
1f60: 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 5f 63  Schema->schema_c
1f70: 6f 6f 6b 69 65 20 3d 20 6d 65 74 61 5b 30 5d 3b  ookie = meta[0];
1f80: 0a 0a 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e  ..  /* If openin
1f90: 67 20 61 20 6e 6f 6e 2d 65 6d 70 74 79 20 64 61  g a non-empty da
1fa0: 74 61 62 61 73 65 2c 20 63 68 65 63 6b 20 74 68  tabase, check th
1fb0: 65 20 74 65 78 74 20 65 6e 63 6f 64 69 6e 67 2e  e text encoding.
1fc0: 20 46 6f 72 20 74 68 65 0a 20 20 2a 2a 20 6d 61   For the.  ** ma
1fd0: 69 6e 20 64 61 74 61 62 61 73 65 2c 20 73 65 74  in database, set
1fe0: 20 73 71 6c 69 74 65 33 2e 65 6e 63 20 74 6f 20   sqlite3.enc to 
1ff0: 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6f 66 20  the encoding of 
2000: 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73  the main databas
2010: 65 2e 0a 20 20 2a 2a 20 46 6f 72 20 61 6e 20 61  e..  ** For an a
2020: 74 74 61 63 68 65 64 20 64 62 2c 20 69 74 20 69  ttached db, it i
2030: 73 20 61 6e 20 65 72 72 6f 72 20 69 66 20 74 68  s an error if th
2040: 65 20 65 6e 63 6f 64 69 6e 67 20 69 73 20 6e 6f  e encoding is no
2050: 74 20 74 68 65 20 73 61 6d 65 0a 20 20 2a 2a 20  t the same.  ** 
2060: 61 73 20 73 71 6c 69 74 65 33 2e 65 6e 63 2e 0a  as sqlite3.enc..
2070: 20 20 2a 2f 0a 20 20 69 66 28 20 6d 65 74 61 5b    */.  if( meta[
2080: 34 5d 20 29 7b 20 20 2f 2a 20 74 65 78 74 20 65  4] ){  /* text e
2090: 6e 63 6f 64 69 6e 67 20 2a 2f 0a 20 20 20 20 69  ncoding */.    i
20a0: 66 28 20 69 44 62 3d 3d 30 20 29 7b 0a 20 20 20  f( iDb==0 ){.   
20b0: 20 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67     /* If opening
20c0: 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61   the main databa
20d0: 73 65 2c 20 73 65 74 20 45 4e 43 28 64 62 29 2e  se, set ENC(db).
20e0: 20 2a 2f 0a 20 20 20 20 20 20 45 4e 43 28 64 62   */.      ENC(db
20f0: 29 20 3d 20 28 75 38 29 6d 65 74 61 5b 34 5d 3b  ) = (u8)meta[4];
2100: 0a 20 20 20 20 20 20 64 62 2d 3e 70 44 66 6c 74  .      db->pDflt
2110: 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69  Coll = sqlite3Fi
2120: 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 53 51  ndCollSeq(db, SQ
2130: 4c 49 54 45 5f 55 54 46 38 2c 20 22 42 49 4e 41  LITE_UTF8, "BINA
2140: 52 59 22 2c 20 36 2c 20 30 29 3b 0a 20 20 20 20  RY", 6, 0);.    
2150: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20  }else{.      /* 
2160: 49 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 61 74  If opening an at
2170: 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65 2c  tached database,
2180: 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6d 75   the encoding mu
2190: 63 68 20 6d 61 74 63 68 20 45 4e 43 28 64 62 29  ch match ENC(db)
21a0: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 6d 65   */.      if( me
21b0: 74 61 5b 34 5d 21 3d 45 4e 43 28 64 62 29 20 29  ta[4]!=ENC(db) )
21c0: 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65  {.        sqlite
21d0: 33 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72  3SetString(pzErr
21e0: 4d 73 67 2c 20 64 62 2c 20 22 61 74 74 61 63 68  Msg, db, "attach
21f0: 65 64 20 64 61 74 61 62 61 73 65 73 20 6d 75 73  ed databases mus
2200: 74 20 75 73 65 20 74 68 65 20 73 61 6d 65 22 0a  t use the same".
2210: 20 20 20 20 20 20 20 20 20 20 20 20 22 20 74 65              " te
2220: 78 74 20 65 6e 63 6f 64 69 6e 67 20 61 73 20 6d  xt encoding as m
2230: 61 69 6e 20 64 61 74 61 62 61 73 65 22 29 3b 0a  ain database");.
2240: 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c          rc = SQL
2250: 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20  ITE_ERROR;.     
2260: 20 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f     goto initone_
2270: 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 20 20 20  error_out;.     
2280: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65   }.    }.  }else
2290: 7b 0a 20 20 20 20 44 62 53 65 74 50 72 6f 70 65  {.    DbSetPrope
22a0: 72 74 79 28 64 62 2c 20 69 44 62 2c 20 44 42 5f  rty(db, iDb, DB_
22b0: 45 6d 70 74 79 29 3b 0a 20 20 7d 0a 20 20 70 44  Empty);.  }.  pD
22c0: 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 65 6e 63 20  b->pSchema->enc 
22d0: 3d 20 45 4e 43 28 64 62 29 3b 0a 0a 20 20 69 66  = ENC(db);..  if
22e0: 28 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e  ( pDb->pSchema->
22f0: 63 61 63 68 65 5f 73 69 7a 65 3d 3d 30 20 29 7b  cache_size==0 ){
2300: 0a 20 20 20 20 73 69 7a 65 20 3d 20 6d 65 74 61  .    size = meta
2310: 5b 32 5d 3b 0a 20 20 20 20 69 66 28 20 73 69 7a  [2];.    if( siz
2320: 65 3d 3d 30 20 29 7b 20 73 69 7a 65 20 3d 20 53  e==0 ){ size = S
2330: 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 43 41  QLITE_DEFAULT_CA
2340: 43 48 45 5f 53 49 5a 45 3b 20 7d 0a 20 20 20 20  CHE_SIZE; }.    
2350: 69 66 28 20 73 69 7a 65 3c 30 20 29 20 73 69 7a  if( size<0 ) siz
2360: 65 20 3d 20 2d 73 69 7a 65 3b 0a 20 20 20 20 70  e = -size;.    p
2370: 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 63 61 63  Db->pSchema->cac
2380: 68 65 5f 73 69 7a 65 20 3d 20 73 69 7a 65 3b 0a  he_size = size;.
2390: 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65      sqlite3Btree
23a0: 53 65 74 43 61 63 68 65 53 69 7a 65 28 70 44 62  SetCacheSize(pDb
23b0: 2d 3e 70 42 74 2c 20 70 44 62 2d 3e 70 53 63 68  ->pBt, pDb->pSch
23c0: 65 6d 61 2d 3e 63 61 63 68 65 5f 73 69 7a 65 29  ema->cache_size)
23d0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a 2a  ;.  }..  /*.  **
23e0: 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 31 20   file_format==1 
23f0: 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 30 2e 30     Version 3.0.0
2400: 2e 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 6f 72 6d  ..  ** file_form
2410: 61 74 3d 3d 32 20 20 20 20 56 65 72 73 69 6f 6e  at==2    Version
2420: 20 33 2e 31 2e 33 2e 20 20 2f 2f 20 41 4c 54 45   3.1.3.  // ALTE
2430: 52 20 54 41 42 4c 45 20 41 44 44 20 43 4f 4c 55  R TABLE ADD COLU
2440: 4d 4e 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 6f 72  MN.  ** file_for
2450: 6d 61 74 3d 3d 33 20 20 20 20 56 65 72 73 69 6f  mat==3    Versio
2460: 6e 20 33 2e 31 2e 34 2e 20 20 2f 2f 20 64 69 74  n 3.1.4.  // dit
2470: 74 6f 20 62 75 74 20 77 69 74 68 20 6e 6f 6e 2d  to but with non-
2480: 4e 55 4c 4c 20 64 65 66 61 75 6c 74 73 0a 20 20  NULL defaults.  
2490: 2a 2a 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d  ** file_format==
24a0: 34 20 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 33  4    Version 3.3
24b0: 2e 30 2e 20 20 2f 2f 20 44 45 53 43 20 69 6e 64  .0.  // DESC ind
24c0: 69 63 65 73 2e 20 20 42 6f 6f 6c 65 61 6e 20 63  ices.  Boolean c
24d0: 6f 6e 73 74 61 6e 74 73 0a 20 20 2a 2f 0a 20 20  onstants.  */.  
24e0: 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69  pDb->pSchema->fi
24f0: 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 28 75 38 29  le_format = (u8)
2500: 6d 65 74 61 5b 31 5d 3b 0a 20 20 69 66 28 20 70  meta[1];.  if( p
2510: 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69 6c  Db->pSchema->fil
2520: 65 5f 66 6f 72 6d 61 74 3d 3d 30 20 29 7b 0a 20  e_format==0 ){. 
2530: 20 20 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d     pDb->pSchema-
2540: 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 31  >file_format = 1
2550: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 44 62 2d  ;.  }.  if( pDb-
2560: 3e 70 53 63 68 65 6d 61 2d 3e 66 69 6c 65 5f 66  >pSchema->file_f
2570: 6f 72 6d 61 74 3e 53 51 4c 49 54 45 5f 4d 41 58  ormat>SQLITE_MAX
2580: 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 20 29 7b 0a  _FILE_FORMAT ){.
2590: 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74      sqlite3SetSt
25a0: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 64  ring(pzErrMsg, d
25b0: 62 2c 20 22 75 6e 73 75 70 70 6f 72 74 65 64 20  b, "unsupported 
25c0: 66 69 6c 65 20 66 6f 72 6d 61 74 22 29 3b 0a 20  file format");. 
25d0: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45     rc = SQLITE_E
25e0: 52 52 4f 52 3b 0a 20 20 20 20 67 6f 74 6f 20 69  RROR;.    goto i
25f0: 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75 74  nitone_error_out
2600: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 69 63 6b  ;.  }..  /* Tick
2610: 65 74 20 23 32 38 30 34 3a 20 20 57 68 65 6e 20  et #2804:  When 
2620: 77 65 20 6f 70 65 6e 20 61 20 64 61 74 61 62 61  we open a databa
2630: 73 65 20 69 6e 20 74 68 65 20 6e 65 77 65 72 20  se in the newer 
2640: 66 69 6c 65 20 66 6f 72 6d 61 74 2c 0a 20 20 2a  file format,.  *
2650: 2a 20 63 6c 65 61 72 20 74 68 65 20 6c 65 67 61  * clear the lega
2660: 63 79 5f 66 69 6c 65 5f 66 6f 72 6d 61 74 20 70  cy_file_format p
2670: 72 61 67 6d 61 20 66 6c 61 67 20 73 6f 20 74 68  ragma flag so th
2680: 61 74 20 61 20 56 41 43 55 55 4d 20 77 69 6c 6c  at a VACUUM will
2690: 0a 20 20 2a 2a 20 6e 6f 74 20 64 6f 77 6e 67 72  .  ** not downgr
26a0: 61 64 65 20 74 68 65 20 64 61 74 61 62 61 73 65  ade the database
26b0: 20 61 6e 64 20 74 68 75 73 20 69 6e 76 61 6c 69   and thus invali
26c0: 64 61 74 65 20 61 6e 79 20 64 65 73 63 65 6e 64  date any descend
26d0: 69 6e 67 0a 20 20 2a 2a 20 69 6e 64 69 63 65 73  ing.  ** indices
26e0: 20 74 68 61 74 20 74 68 65 20 75 73 65 72 20 6d   that the user m
26f0: 69 67 68 74 20 68 61 76 65 20 63 72 65 61 74 65  ight have create
2700: 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 69 44  d..  */.  if( iD
2710: 62 3d 3d 30 20 26 26 20 6d 65 74 61 5b 31 5d 3e  b==0 && meta[1]>
2720: 3d 34 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c  =4 ){.    db->fl
2730: 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 4c  ags &= ~SQLITE_L
2740: 65 67 61 63 79 46 69 6c 65 46 6d 74 3b 0a 20 20  egacyFileFmt;.  
2750: 7d 0a 0a 20 20 2f 2a 20 52 65 61 64 20 74 68 65  }..  /* Read the
2760: 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74   schema informat
2770: 69 6f 6e 20 6f 75 74 20 6f 66 20 74 68 65 20 73  ion out of the s
2780: 63 68 65 6d 61 20 74 61 62 6c 65 73 0a 20 20 2a  chema tables.  *
2790: 2f 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e  /.  assert( db->
27a0: 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20 20 69  init.busy );.  i
27b0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 45 4d  f( rc==SQLITE_EM
27c0: 50 54 59 20 29 7b 0a 20 20 20 20 2f 2a 20 46 6f  PTY ){.    /* Fo
27d0: 72 20 61 6e 20 65 6d 70 74 79 20 64 61 74 61 62  r an empty datab
27e0: 61 73 65 2c 20 74 68 65 72 65 20 69 73 20 6e 6f  ase, there is no
27f0: 74 68 69 6e 67 20 74 6f 20 72 65 61 64 20 2a 2f  thing to read */
2800: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
2810: 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  _OK;.  }else{.  
2820: 20 20 63 68 61 72 20 2a 7a 53 71 6c 3b 0a 20 20    char *zSql;.  
2830: 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74 65 33    zSql = sqlite3
2840: 4d 50 72 69 6e 74 66 28 64 62 2c 20 0a 20 20 20  MPrintf(db, .   
2850: 20 20 20 20 20 22 53 45 4c 45 43 54 20 6e 61 6d       "SELECT nam
2860: 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c  e, rootpage, sql
2870: 20 46 52 4f 4d 20 27 25 71 27 2e 25 73 22 2c 0a   FROM '%q'.%s",.
2880: 20 20 20 20 20 20 20 20 64 62 2d 3e 61 44 62 5b          db->aDb[
2890: 69 44 62 5d 2e 7a 4e 61 6d 65 2c 20 7a 4d 61 73  iDb].zName, zMas
28a0: 74 65 72 4e 61 6d 65 29 3b 0a 20 20 20 20 28 76  terName);.    (v
28b0: 6f 69 64 29 73 71 6c 69 74 65 33 53 61 66 65 74  oid)sqlite3Safet
28c0: 79 4f 66 66 28 64 62 29 3b 0a 23 69 66 6e 64 65  yOff(db);.#ifnde
28d0: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55  f SQLITE_OMIT_AU
28e0: 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 20 20  THORIZATION.    
28f0: 7b 0a 20 20 20 20 20 20 69 6e 74 20 28 2a 78 41  {.      int (*xA
2900: 75 74 68 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63  uth)(void*,int,c
2910: 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74  onst char*,const
2920: 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61   char*,const cha
2930: 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b  r*,const char*);
2940: 0a 20 20 20 20 20 20 78 41 75 74 68 20 3d 20 64  .      xAuth = d
2950: 62 2d 3e 78 41 75 74 68 3b 0a 20 20 20 20 20 20  b->xAuth;.      
2960: 64 62 2d 3e 78 41 75 74 68 20 3d 20 30 3b 0a 23  db->xAuth = 0;.#
2970: 65 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20 3d  endif.      rc =
2980: 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 64 62   sqlite3_exec(db
2990: 2c 20 7a 53 71 6c 2c 20 73 71 6c 69 74 65 33 49  , zSql, sqlite3I
29a0: 6e 69 74 43 61 6c 6c 62 61 63 6b 2c 20 26 69 6e  nitCallback, &in
29b0: 69 74 44 61 74 61 2c 20 30 29 3b 0a 23 69 66 6e  itData, 0);.#ifn
29c0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
29d0: 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20  AUTHORIZATION.  
29e0: 20 20 20 20 64 62 2d 3e 78 41 75 74 68 20 3d 20      db->xAuth = 
29f0: 78 41 75 74 68 3b 0a 20 20 20 20 7d 0a 23 65 6e  xAuth;.    }.#en
2a00: 64 69 66 0a 20 20 20 20 69 66 28 20 72 63 3d 3d  dif.    if( rc==
2a10: 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20 3d  SQLITE_OK ) rc =
2a20: 20 69 6e 69 74 44 61 74 61 2e 72 63 3b 0a 20 20   initData.rc;.  
2a30: 20 20 28 76 6f 69 64 29 73 71 6c 69 74 65 33 53    (void)sqlite3S
2a40: 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20 20 20  afetyOn(db);.   
2a50: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64   sqlite3DbFree(d
2a60: 62 2c 20 7a 53 71 6c 29 3b 0a 23 69 66 6e 64 65  b, zSql);.#ifnde
2a70: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4e  f SQLITE_OMIT_AN
2a80: 41 4c 59 5a 45 0a 20 20 20 20 69 66 28 20 72 63  ALYZE.    if( rc
2a90: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  ==SQLITE_OK ){. 
2aa0: 20 20 20 20 20 73 71 6c 69 74 65 33 41 6e 61 6c       sqlite3Anal
2ab0: 79 73 69 73 4c 6f 61 64 28 64 62 2c 20 69 44 62  ysisLoad(db, iDb
2ac0: 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a  );.    }.#endif.
2ad0: 20 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61    }.  if( db->ma
2ae0: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20  llocFailed ){.  
2af0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f    rc = SQLITE_NO
2b00: 4d 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65 33  MEM;.    sqlite3
2b10: 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68  ResetInternalSch
2b20: 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 7d 0a  ema(db, 0);.  }.
2b30: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
2b40: 5f 4f 4b 20 7c 7c 20 28 64 62 2d 3e 66 6c 61 67  _OK || (db->flag
2b50: 73 26 53 51 4c 49 54 45 5f 52 65 63 6f 76 65 72  s&SQLITE_Recover
2b60: 79 4d 6f 64 65 29 29 7b 0a 20 20 20 20 2f 2a 20  yMode)){.    /* 
2b70: 42 6c 61 63 6b 20 6d 61 67 69 63 3a 20 49 66 20  Black magic: If 
2b80: 74 68 65 20 53 51 4c 49 54 45 5f 52 65 63 6f 76  the SQLITE_Recov
2b90: 65 72 79 4d 6f 64 65 20 66 6c 61 67 20 69 73 20  eryMode flag is 
2ba0: 73 65 74 2c 20 74 68 65 6e 20 63 6f 6e 73 69 64  set, then consid
2bb0: 65 72 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 63  er.    ** the sc
2bc0: 68 65 6d 61 20 6c 6f 61 64 65 64 2c 20 65 76 65  hema loaded, eve
2bd0: 6e 20 69 66 20 65 72 72 6f 72 73 20 6f 63 63 75  n if errors occu
2be0: 72 72 65 64 2e 20 49 6e 20 74 68 69 73 20 73 69  rred. In this si
2bf0: 74 75 61 74 69 6f 6e 20 74 68 65 20 0a 20 20 20  tuation the .   
2c00: 20 2a 2a 20 63 75 72 72 65 6e 74 20 73 71 6c 69   ** current sqli
2c10: 74 65 33 5f 70 72 65 70 61 72 65 28 29 20 6f 70  te3_prepare() op
2c20: 65 72 61 74 69 6f 6e 20 77 69 6c 6c 20 66 61 69  eration will fai
2c30: 6c 2c 20 62 75 74 20 74 68 65 20 66 6f 6c 6c 6f  l, but the follo
2c40: 77 69 6e 67 20 6f 6e 65 0a 20 20 20 20 2a 2a 20  wing one.    ** 
2c50: 77 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f 20  will attempt to 
2c60: 63 6f 6d 70 69 6c 65 20 74 68 65 20 73 75 70 70  compile the supp
2c70: 6c 69 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61  lied statement a
2c80: 67 61 69 6e 73 74 20 77 68 61 74 65 76 65 72 20  gainst whatever 
2c90: 73 75 62 73 65 74 0a 20 20 20 20 2a 2a 20 6f 66  subset.    ** of
2ca0: 20 74 68 65 20 73 63 68 65 6d 61 20 77 61 73 20   the schema was 
2cb0: 6c 6f 61 64 65 64 20 62 65 66 6f 72 65 20 74 68  loaded before th
2cc0: 65 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64  e error occurred
2cd0: 2e 20 54 68 65 20 70 72 69 6d 61 72 79 0a 20 20  . The primary.  
2ce0: 20 20 2a 2a 20 70 75 72 70 6f 73 65 20 6f 66 20    ** purpose of 
2cf0: 74 68 69 73 20 69 73 20 74 6f 20 61 6c 6c 6f 77  this is to allow
2d00: 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 73   access to the s
2d10: 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62  qlite_master tab
2d20: 6c 65 0a 20 20 20 20 2a 2a 20 65 76 65 6e 20 77  le.    ** even w
2d30: 68 65 6e 20 69 74 73 20 63 6f 6e 74 65 6e 74 73  hen its contents
2d40: 20 68 61 76 65 20 62 65 65 6e 20 63 6f 72 72 75   have been corru
2d50: 70 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20  pted..    */.   
2d60: 20 44 62 53 65 74 50 72 6f 70 65 72 74 79 28 64   DbSetProperty(d
2d70: 62 2c 20 69 44 62 2c 20 44 42 5f 53 63 68 65 6d  b, iDb, DB_Schem
2d80: 61 4c 6f 61 64 65 64 29 3b 0a 20 20 20 20 72 63  aLoaded);.    rc
2d90: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20   = SQLITE_OK;.  
2da0: 7d 0a 0a 20 20 2f 2a 20 4a 75 6d 70 20 68 65 72  }..  /* Jump her
2db0: 65 20 66 6f 72 20 61 6e 20 65 72 72 6f 72 20 74  e for an error t
2dc0: 68 61 74 20 6f 63 63 75 72 73 20 61 66 74 65 72  hat occurs after
2dd0: 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 61 6c   successfully al
2de0: 6c 6f 63 61 74 69 6e 67 0a 20 20 2a 2a 20 63 75  locating.  ** cu
2df0: 72 4d 61 69 6e 20 61 6e 64 20 63 61 6c 6c 69 6e  rMain and callin
2e00: 67 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e  g sqlite3BtreeEn
2e10: 74 65 72 28 29 2e 20 46 6f 72 20 61 6e 20 65 72  ter(). For an er
2e20: 72 6f 72 20 74 68 61 74 20 6f 63 63 75 72 73 0a  ror that occurs.
2e30: 20 20 2a 2a 20 62 65 66 6f 72 65 20 74 68 61 74    ** before that
2e40: 20 70 6f 69 6e 74 2c 20 6a 75 6d 70 20 74 6f 20   point, jump to 
2e50: 65 72 72 6f 72 5f 6f 75 74 2e 0a 20 20 2a 2f 0a  error_out..  */.
2e60: 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75  initone_error_ou
2e70: 74 3a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65  t:.  sqlite3Btre
2e80: 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 63 75 72  eCloseCursor(cur
2e90: 4d 61 69 6e 29 3b 0a 20 20 73 71 6c 69 74 65 33  Main);.  sqlite3
2ea0: 5f 66 72 65 65 28 63 75 72 4d 61 69 6e 29 3b 0a  _free(curMain);.
2eb0: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65    sqlite3BtreeLe
2ec0: 61 76 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a 0a  ave(pDb->pBt);..
2ed0: 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 69 66 28  error_out:.  if(
2ee0: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45   rc==SQLITE_NOME
2ef0: 4d 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f  M || rc==SQLITE_
2f00: 49 4f 45 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a 20  IOERR_NOMEM ){. 
2f10: 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69     db->mallocFai
2f20: 6c 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72  led = 1;.  }.  r
2f30: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
2f40: 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 61 6c  ** Initialize al
2f50: 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73  l database files
2f60: 20 2d 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61   - the main data
2f70: 62 61 73 65 20 66 69 6c 65 2c 20 74 68 65 20 66  base file, the f
2f80: 69 6c 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 73  ile.** used to s
2f90: 74 6f 72 65 20 74 65 6d 70 6f 72 61 72 79 20 74  tore temporary t
2fa0: 61 62 6c 65 73 2c 20 61 6e 64 20 61 6e 79 20 61  ables, and any a
2fb0: 64 64 69 74 69 6f 6e 61 6c 20 64 61 74 61 62 61  dditional databa
2fc0: 73 65 20 66 69 6c 65 73 0a 2a 2a 20 63 72 65 61  se files.** crea
2fd0: 74 65 64 20 75 73 69 6e 67 20 41 54 54 41 43 48  ted using ATTACH
2fe0: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 52 65   statements.  Re
2ff0: 74 75 72 6e 20 61 20 73 75 63 63 65 73 73 20 63  turn a success c
3000: 6f 64 65 2e 20 20 49 66 20 61 6e 0a 2a 2a 20 65  ode.  If an.** e
3010: 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 77 72 69  rror occurs, wri
3020: 74 65 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73  te an error mess
3030: 61 67 65 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d  age into *pzErrM
3040: 73 67 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72 20  sg..**.** After 
3050: 61 20 64 61 74 61 62 61 73 65 20 69 73 20 69 6e  a database is in
3060: 69 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 44  itialized, the D
3070: 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 20 62  B_SchemaLoaded b
3080: 69 74 20 69 73 20 73 65 74 0a 2a 2a 20 62 69 74  it is set.** bit
3090: 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 66   is set in the f
30a0: 6c 61 67 73 20 66 69 65 6c 64 20 6f 66 20 74 68  lags field of th
30b0: 65 20 44 62 20 73 74 72 75 63 74 75 72 65 2e 20  e Db structure. 
30c0: 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  If the database.
30d0: 2a 2a 20 66 69 6c 65 20 77 61 73 20 6f 66 20 7a  ** file was of z
30e0: 65 72 6f 2d 6c 65 6e 67 74 68 2c 20 74 68 65 6e  ero-length, then
30f0: 20 74 68 65 20 44 42 5f 45 6d 70 74 79 20 66 6c   the DB_Empty fl
3100: 61 67 20 69 73 20 61 6c 73 6f 20 73 65 74 2e 0a  ag is also set..
3110: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e  */.int sqlite3In
3120: 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  it(sqlite3 *db, 
3130: 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29  char **pzErrMsg)
3140: 7b 0a 20 20 69 6e 74 20 69 2c 20 72 63 3b 0a 20  {.  int i, rc;. 
3150: 20 69 6e 74 20 63 6f 6d 6d 69 74 5f 69 6e 74 65   int commit_inte
3160: 72 6e 61 6c 20 3d 20 21 28 64 62 2d 3e 66 6c 61  rnal = !(db->fla
3170: 67 73 26 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e  gs&SQLITE_Intern
3180: 43 68 61 6e 67 65 73 29 3b 0a 20 20 0a 20 20 61  Changes);.  .  a
3190: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
31a0: 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75  utex_held(db->mu
31b0: 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 64 62  tex) );.  if( db
31c0: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 20 72 65  ->init.busy ) re
31d0: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  turn SQLITE_OK;.
31e0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b    rc = SQLITE_OK
31f0: 3b 0a 20 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73  ;.  db->init.bus
3200: 79 20 3d 20 31 3b 0a 20 20 66 6f 72 28 69 3d 30  y = 1;.  for(i=0
3210: 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ; rc==SQLITE_OK 
3220: 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b  && i<db->nDb; i+
3230: 2b 29 7b 0a 20 20 20 20 69 66 28 20 44 62 48 61  +){.    if( DbHa
3240: 73 50 72 6f 70 65 72 74 79 28 64 62 2c 20 69 2c  sProperty(db, i,
3250: 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64   DB_SchemaLoaded
3260: 29 20 7c 7c 20 69 3d 3d 31 20 29 20 63 6f 6e 74  ) || i==1 ) cont
3270: 69 6e 75 65 3b 0a 20 20 20 20 72 63 20 3d 20 73  inue;.    rc = s
3280: 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65 28 64 62  qlite3InitOne(db
3290: 2c 20 69 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a  , i, pzErrMsg);.
32a0: 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20      if( rc ){.  
32b0: 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74      sqlite3Reset
32c0: 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64  InternalSchema(d
32d0: 62 2c 20 69 29 3b 0a 20 20 20 20 7d 0a 20 20 7d  b, i);.    }.  }
32e0: 0a 0a 20 20 2f 2a 20 4f 6e 63 65 20 61 6c 6c 20  ..  /* Once all 
32f0: 74 68 65 20 6f 74 68 65 72 20 64 61 74 61 62 61  the other databa
3300: 73 65 73 20 68 61 76 65 20 62 65 65 6e 20 69 6e  ses have been in
3310: 69 74 69 61 6c 69 73 65 64 2c 20 6c 6f 61 64 20  itialised, load 
3320: 74 68 65 20 73 63 68 65 6d 61 0a 20 20 2a 2a 20  the schema.  ** 
3330: 66 6f 72 20 74 68 65 20 54 45 4d 50 20 64 61 74  for the TEMP dat
3340: 61 62 61 73 65 2e 20 54 68 69 73 20 69 73 20 6c  abase. This is l
3350: 6f 61 64 65 64 20 6c 61 73 74 2c 20 61 73 20 74  oaded last, as t
3360: 68 65 20 54 45 4d 50 20 64 61 74 61 62 61 73 65  he TEMP database
3370: 0a 20 20 2a 2a 20 73 63 68 65 6d 61 20 6d 61 79  .  ** schema may
3380: 20 63 6f 6e 74 61 69 6e 20 72 65 66 65 72 65 6e   contain referen
3390: 63 65 73 20 74 6f 20 6f 62 6a 65 63 74 73 20 69  ces to objects i
33a0: 6e 20 6f 74 68 65 72 20 64 61 74 61 62 61 73 65  n other database
33b0: 73 2e 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 66 20  s..  */.#ifndef 
33c0: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d 50  SQLITE_OMIT_TEMP
33d0: 44 42 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  DB.  if( rc==SQL
33e0: 49 54 45 5f 4f 4b 20 26 26 20 64 62 2d 3e 6e 44  ITE_OK && db->nD
33f0: 62 3e 31 20 26 26 20 21 44 62 48 61 73 50 72 6f  b>1 && !DbHasPro
3400: 70 65 72 74 79 28 64 62 2c 20 31 2c 20 44 42 5f  perty(db, 1, DB_
3410: 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 20 29 7b  SchemaLoaded) ){
3420: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
3430: 33 49 6e 69 74 4f 6e 65 28 64 62 2c 20 31 2c 20  3InitOne(db, 1, 
3440: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 69  pzErrMsg);.    i
3450: 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 73  f( rc ){.      s
3460: 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72  qlite3ResetInter
3470: 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 31 29  nalSchema(db, 1)
3480: 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64  ;.    }.  }.#end
3490: 69 66 0a 0a 20 20 64 62 2d 3e 69 6e 69 74 2e 62  if..  db->init.b
34a0: 75 73 79 20 3d 20 30 3b 0a 20 20 69 66 28 20 72  usy = 0;.  if( r
34b0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20  c==SQLITE_OK && 
34c0: 63 6f 6d 6d 69 74 5f 69 6e 74 65 72 6e 61 6c 20  commit_internal 
34d0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f  ){.    sqlite3Co
34e0: 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e  mmitInternalChan
34f0: 67 65 73 28 64 62 29 3b 0a 20 20 7d 0a 0a 20 20  ges(db);.  }..  
3500: 72 65 74 75 72 6e 20 72 63 3b 20 0a 7d 0a 0a 2f  return rc; .}../
3510: 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e  *.** This routin
3520: 65 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20  e is a no-op if 
3530: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68  the database sch
3540: 65 6d 61 20 69 73 20 61 6c 72 65 61 64 79 20 69  ema is already i
3550: 6e 69 74 69 61 6c 69 73 65 64 2e 0a 2a 2a 20 4f  nitialised..** O
3560: 74 68 65 72 77 69 73 65 2c 20 74 68 65 20 73 63  therwise, the sc
3570: 68 65 6d 61 20 69 73 20 6c 6f 61 64 65 64 2e 20  hema is loaded. 
3580: 41 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73  An error code is
3590: 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e   returned..*/.in
35a0: 74 20 73 71 6c 69 74 65 33 52 65 61 64 53 63 68  t sqlite3ReadSch
35b0: 65 6d 61 28 50 61 72 73 65 20 2a 70 50 61 72 73  ema(Parse *pPars
35c0: 65 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53  e){.  int rc = S
35d0: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 73 71 6c 69  QLITE_OK;.  sqli
35e0: 74 65 33 20 2a 64 62 20 3d 20 70 50 61 72 73 65  te3 *db = pParse
35f0: 2d 3e 64 62 3b 0a 20 20 61 73 73 65 72 74 28 20  ->db;.  assert( 
3600: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
3610: 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b  ld(db->mutex) );
3620: 0a 20 20 69 66 28 20 21 64 62 2d 3e 69 6e 69 74  .  if( !db->init
3630: 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 72 63 20  .busy ){.    rc 
3640: 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 28 64 62  = sqlite3Init(db
3650: 2c 20 26 70 50 61 72 73 65 2d 3e 7a 45 72 72 4d  , &pParse->zErrM
3660: 73 67 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72  sg);.  }.  if( r
3670: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
3680: 20 20 20 20 70 50 61 72 73 65 2d 3e 72 63 20 3d      pParse->rc =
3690: 20 72 63 3b 0a 20 20 20 20 70 50 61 72 73 65 2d   rc;.    pParse-
36a0: 3e 6e 45 72 72 2b 2b 3b 0a 20 20 7d 0a 20 20 72  >nErr++;.  }.  r
36b0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a  eturn rc;.}.../*
36c0: 0a 2a 2a 20 43 68 65 63 6b 20 73 63 68 65 6d 61  .** Check schema
36d0: 20 63 6f 6f 6b 69 65 73 20 69 6e 20 61 6c 6c 20   cookies in all 
36e0: 64 61 74 61 62 61 73 65 73 2e 20 20 49 66 20 61  databases.  If a
36f0: 6e 79 20 63 6f 6f 6b 69 65 20 69 73 20 6f 75 74  ny cookie is out
3700: 0a 2a 2a 20 6f 66 20 64 61 74 65 2c 20 72 65 74  .** of date, ret
3710: 75 72 6e 20 30 2e 20 20 49 66 20 61 6c 6c 20 73  urn 0.  If all s
3720: 63 68 65 6d 61 20 63 6f 6f 6b 69 65 73 20 61 72  chema cookies ar
3730: 65 20 63 75 72 72 65 6e 74 2c 20 72 65 74 75 72  e current, retur
3740: 6e 20 31 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  n 1..*/.static i
3750: 6e 74 20 73 63 68 65 6d 61 49 73 56 61 6c 69 64  nt schemaIsValid
3760: 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20  (sqlite3 *db){. 
3770: 20 69 6e 74 20 69 44 62 3b 0a 20 20 69 6e 74 20   int iDb;.  int 
3780: 72 63 3b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a  rc;.  BtCursor *
3790: 63 75 72 54 65 6d 70 3b 0a 20 20 69 6e 74 20 63  curTemp;.  int c
37a0: 6f 6f 6b 69 65 3b 0a 20 20 69 6e 74 20 61 6c 6c  ookie;.  int all
37b0: 4f 6b 20 3d 20 31 3b 0a 0a 20 20 63 75 72 54 65  Ok = 1;..  curTe
37c0: 6d 70 20 3d 20 28 42 74 43 75 72 73 6f 72 20 2a  mp = (BtCursor *
37d0: 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 73  )sqlite3Malloc(s
37e0: 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f  qlite3BtreeCurso
37f0: 72 53 69 7a 65 28 29 29 3b 0a 20 20 69 66 28 20  rSize());.  if( 
3800: 63 75 72 54 65 6d 70 20 29 7b 0a 20 20 20 20 61  curTemp ){.    a
3810: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d  ssert( sqlite3_m
3820: 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75  utex_held(db->mu
3830: 74 65 78 29 20 29 3b 0a 20 20 20 20 66 6f 72 28  tex) );.    for(
3840: 69 44 62 3d 30 3b 20 61 6c 6c 4f 6b 20 26 26 20  iDb=0; allOk && 
3850: 69 44 62 3c 64 62 2d 3e 6e 44 62 3b 20 69 44 62  iDb<db->nDb; iDb
3860: 2b 2b 29 7b 0a 20 20 20 20 20 20 42 74 72 65 65  ++){.      Btree
3870: 20 2a 70 42 74 3b 0a 20 20 20 20 20 20 70 42 74   *pBt;.      pBt
3880: 20 3d 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e   = db->aDb[iDb].
3890: 70 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20 70  pBt;.      if( p
38a0: 42 74 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65  Bt==0 ) continue
38b0: 3b 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 63  ;.      memset(c
38c0: 75 72 54 65 6d 70 2c 20 30 2c 20 73 71 6c 69 74  urTemp, 0, sqlit
38d0: 65 33 42 74 72 65 65 43 75 72 73 6f 72 53 69 7a  e3BtreeCursorSiz
38e0: 65 28 29 29 3b 0a 20 20 20 20 20 20 72 63 20 3d  e());.      rc =
38f0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72   sqlite3BtreeCur
3900: 73 6f 72 28 70 42 74 2c 20 4d 41 53 54 45 52 5f  sor(pBt, MASTER_
3910: 52 4f 4f 54 2c 20 30 2c 20 30 2c 20 63 75 72 54  ROOT, 0, 0, curT
3920: 65 6d 70 29 3b 0a 20 20 20 20 20 20 69 66 28 20  emp);.      if( 
3930: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
3940: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71  .        rc = sq
3950: 6c 69 74 65 33 42 74 72 65 65 47 65 74 4d 65 74  lite3BtreeGetMet
3960: 61 28 70 42 74 2c 20 31 2c 20 28 75 33 32 20 2a  a(pBt, 1, (u32 *
3970: 29 26 63 6f 6f 6b 69 65 29 3b 0a 20 20 20 20 20  )&cookie);.     
3980: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
3990: 45 5f 4f 4b 20 26 26 20 63 6f 6f 6b 69 65 21 3d  E_OK && cookie!=
39a0: 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 53 63  db->aDb[iDb].pSc
39b0: 68 65 6d 61 2d 3e 73 63 68 65 6d 61 5f 63 6f 6f  hema->schema_coo
39c0: 6b 69 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20  kie ){.         
39d0: 20 61 6c 6c 4f 6b 20 3d 20 30 3b 0a 20 20 20 20   allOk = 0;.    
39e0: 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 73 71      }.        sq
39f0: 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 43  lite3BtreeCloseC
3a00: 75 72 73 6f 72 28 63 75 72 54 65 6d 70 29 3b 0a  ursor(curTemp);.
3a10: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66        }.      if
3a20: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d  ( rc==SQLITE_NOM
3a30: 45 4d 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45  EM || rc==SQLITE
3a40: 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a  _IOERR_NOMEM ){.
3a50: 20 20 20 20 20 20 20 20 64 62 2d 3e 6d 61 6c 6c          db->mall
3a60: 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a 20 20  ocFailed = 1;.  
3a70: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20      }.    }.    
3a80: 73 71 6c 69 74 65 33 5f 66 72 65 65 28 63 75 72  sqlite3_free(cur
3a90: 54 65 6d 70 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  Temp);.  }else{.
3aa0: 20 20 20 20 61 6c 6c 4f 6b 20 3d 20 30 3b 0a 20      allOk = 0;. 
3ab0: 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69     db->mallocFai
3ac0: 6c 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20 20  led = 1;.  }..  
3ad0: 72 65 74 75 72 6e 20 61 6c 6c 4f 6b 3b 0a 7d 0a  return allOk;.}.
3ae0: 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 61  ./*.** Convert a
3af0: 20 73 63 68 65 6d 61 20 70 6f 69 6e 74 65 72 20   schema pointer 
3b00: 69 6e 74 6f 20 74 68 65 20 69 44 62 20 69 6e 64  into the iDb ind
3b10: 65 78 20 74 68 61 74 20 69 6e 64 69 63 61 74 65  ex that indicate
3b20: 73 0a 2a 2a 20 77 68 69 63 68 20 64 61 74 61 62  s.** which datab
3b30: 61 73 65 20 66 69 6c 65 20 69 6e 20 64 62 2d 3e  ase file in db->
3b40: 61 44 62 5b 5d 20 74 68 65 20 73 63 68 65 6d 61  aDb[] the schema
3b50: 20 72 65 66 65 72 73 20 74 6f 2e 0a 2a 2a 0a 2a   refers to..**.*
3b60: 2a 20 49 66 20 74 68 65 20 73 61 6d 65 20 64 61  * If the same da
3b70: 74 61 62 61 73 65 20 69 73 20 61 74 74 61 63 68  tabase is attach
3b80: 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 63  ed more than onc
3b90: 65 2c 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20  e, the first.** 
3ba0: 61 74 74 61 63 68 65 64 20 64 61 74 61 62 61 73  attached databas
3bb0: 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a  e is returned..*
3bc0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 63 68  /.int sqlite3Sch
3bd0: 65 6d 61 54 6f 49 6e 64 65 78 28 73 71 6c 69 74  emaToIndex(sqlit
3be0: 65 33 20 2a 64 62 2c 20 53 63 68 65 6d 61 20 2a  e3 *db, Schema *
3bf0: 70 53 63 68 65 6d 61 29 7b 0a 20 20 69 6e 74 20  pSchema){.  int 
3c00: 69 20 3d 20 2d 31 30 30 30 30 30 30 3b 0a 0a 20  i = -1000000;.. 
3c10: 20 2f 2a 20 49 66 20 70 53 63 68 65 6d 61 20 69   /* If pSchema i
3c20: 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 72 65 74  s NULL, then ret
3c30: 75 72 6e 20 2d 31 30 30 30 30 30 30 2e 20 54 68  urn -1000000. Th
3c40: 69 73 20 68 61 70 70 65 6e 73 20 77 68 65 6e 20  is happens when 
3c50: 63 6f 64 65 20 69 6e 20 0a 20 20 2a 2a 20 65 78  code in .  ** ex
3c60: 70 72 2e 63 20 69 73 20 74 72 79 69 6e 67 20 74  pr.c is trying t
3c70: 6f 20 72 65 73 6f 6c 76 65 20 61 20 72 65 66 65  o resolve a refe
3c80: 72 65 6e 63 65 20 74 6f 20 61 20 74 72 61 6e 73  rence to a trans
3c90: 69 65 6e 74 20 74 61 62 6c 65 20 28 69 2e 65 2e  ient table (i.e.
3ca0: 20 6f 6e 65 0a 20 20 2a 2a 20 63 72 65 61 74 65   one.  ** create
3cb0: 64 20 62 79 20 61 20 73 75 62 2d 73 65 6c 65 63  d by a sub-selec
3cc0: 74 29 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65  t). In this case
3cd0: 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75   the return valu
3ce0: 65 20 6f 66 20 74 68 69 73 20 0a 20 20 2a 2a 20  e of this .  ** 
3cf0: 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20  function should 
3d00: 6e 65 76 65 72 20 62 65 20 75 73 65 64 2e 0a 20  never be used.. 
3d10: 20 2a 2a 0a 20 20 2a 2a 20 57 65 20 72 65 74 75   **.  ** We retu
3d20: 72 6e 20 2d 31 30 30 30 30 30 30 20 69 6e 73 74  rn -1000000 inst
3d30: 65 61 64 20 6f 66 20 74 68 65 20 6d 6f 72 65 20  ead of the more 
3d40: 75 73 75 61 6c 20 2d 31 20 73 69 6d 70 6c 79 20  usual -1 simply 
3d50: 62 65 63 61 75 73 65 20 75 73 69 6e 67 0a 20 20  because using.  
3d60: 2a 2a 20 2d 31 30 30 30 30 30 30 20 61 73 20 74  ** -1000000 as t
3d70: 68 65 20 69 6e 63 6f 72 72 65 63 74 20 69 6e 64  he incorrect ind
3d80: 65 78 20 69 6e 74 6f 20 64 62 2d 3e 61 44 62 5b  ex into db->aDb[
3d90: 5d 20 69 73 20 6d 75 63 68 20 0a 20 20 2a 2a 20  ] is much .  ** 
3da0: 6d 6f 72 65 20 6c 69 6b 65 6c 79 20 74 6f 20 63  more likely to c
3db0: 61 75 73 65 20 61 20 73 65 67 66 61 75 6c 74 20  ause a segfault 
3dc0: 74 68 61 6e 20 2d 31 20 28 6f 66 20 63 6f 75 72  than -1 (of cour
3dd0: 73 65 20 74 68 65 72 65 20 61 72 65 20 61 73 73  se there are ass
3de0: 65 72 74 28 29 0a 20 20 2a 2a 20 73 74 61 74 65  ert().  ** state
3df0: 6d 65 6e 74 73 20 74 6f 6f 2c 20 62 75 74 20 69  ments too, but i
3e00: 74 20 6e 65 76 65 72 20 68 75 72 74 73 20 74 6f  t never hurts to
3e10: 20 70 6c 61 79 20 74 68 65 20 6f 64 64 73 29 2e   play the odds).
3e20: 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  .  */.  assert( 
3e30: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
3e40: 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b  ld(db->mutex) );
3e50: 0a 20 20 69 66 28 20 70 53 63 68 65 6d 61 20 29  .  if( pSchema )
3e60: 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 41  {.    for(i=0; A
3e70: 4c 57 41 59 53 28 69 3c 64 62 2d 3e 6e 44 62 29  LWAYS(i<db->nDb)
3e80: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66  ; i++){.      if
3e90: 28 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 53 63  ( db->aDb[i].pSc
3ea0: 68 65 6d 61 3d 3d 70 53 63 68 65 6d 61 20 29 7b  hema==pSchema ){
3eb0: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a  .        break;.
3ec0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20        }.    }.  
3ed0: 20 20 61 73 73 65 72 74 28 20 69 3e 3d 30 20 26    assert( i>=0 &
3ee0: 26 20 69 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20  & i<db->nDb );. 
3ef0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a 7d   }.  return i;.}
3f00: 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20  ../*.** Compile 
3f10: 74 68 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 65  the UTF-8 encode
3f20: 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20  d SQL statement 
3f30: 7a 53 71 6c 20 69 6e 74 6f 20 61 20 73 74 61 74  zSql into a stat
3f40: 65 6d 65 6e 74 20 68 61 6e 64 6c 65 2e 0a 2a 2f  ement handle..*/
3f50: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69  .static int sqli
3f60: 74 65 33 50 72 65 70 61 72 65 28 0a 20 20 73 71  te3Prepare(.  sq
3f70: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20  lite3 *db,      
3f80: 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62          /* Datab
3f90: 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20  ase handle. */. 
3fa0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71   const char *zSq
3fb0: 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54  l,         /* UT
3fc0: 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20  F-8 encoded SQL 
3fd0: 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20  statement. */.  
3fe0: 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20  int nBytes,     
3ff0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e            /* Len
4000: 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62  gth of zSql in b
4010: 79 74 65 73 2e 20 2a 2f 0a 20 20 69 6e 74 20 73  ytes. */.  int s
4020: 61 76 65 53 71 6c 46 6c 61 67 2c 20 20 20 20 20  aveSqlFlag,     
4030: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20       /* True to 
4040: 63 6f 70 79 20 53 51 4c 20 74 65 78 74 20 69 6e  copy SQL text in
4050: 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f 73  to the sqlite3_s
4060: 74 6d 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  tmt */.  sqlite3
4070: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
4080: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69     /* OUT: A poi
4090: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70  nter to the prep
40a0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a  ared statement *
40b0: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
40c0: 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a  *pzTail       /*
40d0: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72   OUT: End of par
40e0: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b  sed string */.){
40f0: 0a 20 20 50 61 72 73 65 20 73 50 61 72 73 65 3b  .  Parse sParse;
4100: 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67  .  char *zErrMsg
4110: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 20 3d   = 0;.  int rc =
4120: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e   SQLITE_OK;.  in
4130: 74 20 69 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  t i;..  assert( 
4140: 70 70 53 74 6d 74 20 29 3b 0a 20 20 2a 70 70 53  ppStmt );.  *ppS
4150: 74 6d 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 73  tmt = 0;.  if( s
4160: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64  qlite3SafetyOn(d
4170: 62 29 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e  b) ){.    return
4180: 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 3b 0a   SQLITE_MISUSE;.
4190: 20 20 7d 0a 20 20 61 73 73 65 72 74 28 20 21 64    }.  assert( !d
41a0: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20  b->mallocFailed 
41b0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c  );.  assert( sql
41c0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28  ite3_mutex_held(
41d0: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a 20  db->mutex) );.. 
41e0: 20 2f 2a 20 43 68 65 63 6b 20 74 6f 20 76 65 72   /* Check to ver
41f0: 69 66 79 20 74 68 61 74 20 69 74 20 69 73 20 70  ify that it is p
4200: 6f 73 73 69 62 6c 65 20 74 6f 20 67 65 74 20 61  ossible to get a
4210: 20 72 65 61 64 20 6c 6f 63 6b 20 6f 6e 20 61 6c   read lock on al
4220: 6c 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20  l.  ** database 
4230: 73 63 68 65 6d 61 73 2e 20 20 54 68 65 20 69 6e  schemas.  The in
4240: 61 62 69 6c 69 74 79 20 74 6f 20 67 65 74 20 61  ability to get a
4250: 20 72 65 61 64 20 6c 6f 63 6b 20 69 6e 64 69 63   read lock indic
4260: 61 74 65 73 20 74 68 61 74 0a 20 20 2a 2a 20 73  ates that.  ** s
4270: 6f 6d 65 20 6f 74 68 65 72 20 64 61 74 61 62 61  ome other databa
4280: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73  se connection is
4290: 20 68 6f 6c 64 69 6e 67 20 61 20 77 72 69 74 65   holding a write
42a0: 2d 6c 6f 63 6b 2c 20 77 68 69 63 68 20 69 6e 0a  -lock, which in.
42b0: 20 20 2a 2a 20 74 75 72 6e 20 6d 65 61 6e 73 20    ** turn means 
42c0: 74 68 61 74 20 74 68 65 20 6f 74 68 65 72 20 63  that the other c
42d0: 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 73 20 6d 61  onnection has ma
42e0: 64 65 20 75 6e 63 6f 6d 6d 69 74 74 65 64 20 63  de uncommitted c
42f0: 68 61 6e 67 65 73 0a 20 20 2a 2a 20 74 6f 20 74  hanges.  ** to t
4300: 68 65 20 73 63 68 65 6d 61 2e 0a 20 20 2a 2a 0a  he schema..  **.
4310: 20 20 2a 2a 20 57 65 72 65 20 77 65 20 74 6f 20    ** Were we to 
4320: 70 72 6f 63 65 65 64 20 61 6e 64 20 70 72 65 70  proceed and prep
4330: 61 72 65 20 74 68 65 20 73 74 61 74 65 6d 65 6e  are the statemen
4340: 74 20 61 67 61 69 6e 73 74 20 74 68 65 20 75 6e  t against the un
4350: 63 6f 6d 6d 69 74 74 65 64 0a 20 20 2a 2a 20 73  committed.  ** s
4360: 63 68 65 6d 61 20 63 68 61 6e 67 65 73 20 61 6e  chema changes an
4370: 64 20 69 66 20 74 68 6f 73 65 20 73 63 68 65 6d  d if those schem
4380: 61 20 63 68 61 6e 67 65 73 20 61 72 65 20 73 75  a changes are su
4390: 62 73 65 71 75 65 6e 74 6c 79 20 72 6f 6c 6c 65  bsequently rolle
43a0: 64 0a 20 20 2a 2a 20 62 61 63 6b 20 61 6e 64 20  d.  ** back and 
43b0: 64 69 66 66 65 72 65 6e 74 20 63 68 61 6e 67 65  different change
43c0: 73 20 61 72 65 20 6d 61 64 65 20 69 6e 20 74 68  s are made in th
43d0: 65 69 72 20 70 6c 61 63 65 2c 20 74 68 65 6e 20  eir place, then 
43e0: 77 68 65 6e 20 74 68 69 73 0a 20 20 2a 2a 20 70  when this.  ** p
43f0: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e  repared statemen
4400: 74 20 67 6f 65 73 20 74 6f 20 72 75 6e 20 74 68  t goes to run th
4410: 65 20 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65 20  e schema cookie 
4420: 77 6f 75 6c 64 20 66 61 69 6c 20 74 6f 20 64 65  would fail to de
4430: 74 65 63 74 0a 20 20 2a 2a 20 74 68 65 20 73 63  tect.  ** the sc
4440: 68 65 6d 61 20 63 68 61 6e 67 65 2e 20 20 44 69  hema change.  Di
4450: 73 61 73 74 65 72 20 77 6f 75 6c 64 20 66 6f 6c  saster would fol
4460: 6c 6f 77 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54  low..  **.  ** T
4470: 68 69 73 20 74 68 72 65 61 64 20 69 73 20 63 75  his thread is cu
4480: 72 72 65 6e 74 6c 79 20 68 6f 6c 64 69 6e 67 20  rrently holding 
4490: 6d 75 74 65 78 65 73 20 6f 6e 20 61 6c 6c 20 42  mutexes on all B
44a0: 74 72 65 65 73 20 28 62 65 63 61 75 73 65 0a 20  trees (because. 
44b0: 20 2a 2a 20 6f 66 20 74 68 65 20 73 71 6c 69 74   ** of the sqlit
44c0: 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c 6c 28  e3BtreeEnterAll(
44d0: 29 20 69 6e 20 73 71 6c 69 74 65 33 4c 6f 63 6b  ) in sqlite3Lock
44e0: 41 6e 64 50 72 65 70 61 72 65 28 29 29 20 73 6f  AndPrepare()) so
44f0: 20 69 74 0a 20 20 2a 2a 20 69 73 20 6e 6f 74 20   it.  ** is not 
4500: 70 6f 73 73 69 62 6c 65 20 66 6f 72 20 61 6e 6f  possible for ano
4510: 74 68 65 72 20 74 68 72 65 61 64 20 74 6f 20 73  ther thread to s
4520: 74 61 72 74 20 61 20 6e 65 77 20 73 63 68 65 6d  tart a new schem
4530: 61 20 63 68 61 6e 67 65 0a 20 20 2a 2a 20 77 68  a change.  ** wh
4540: 69 6c 65 20 74 68 69 73 20 72 6f 75 74 69 6e 65  ile this routine
4550: 20 69 73 20 72 75 6e 6e 69 6e 67 2e 20 20 48 65   is running.  He
4560: 6e 63 65 2c 20 77 65 20 64 6f 20 6e 6f 74 20 6e  nce, we do not n
4570: 65 65 64 20 74 6f 20 68 6f 6c 64 20 0a 20 20 2a  eed to hold .  *
4580: 2a 20 6c 6f 63 6b 73 20 6f 6e 20 74 68 65 20 73  * locks on the s
4590: 63 68 65 6d 61 2c 20 77 65 20 6a 75 73 74 20 6e  chema, we just n
45a0: 65 65 64 20 74 6f 20 6d 61 6b 65 20 73 75 72 65  eed to make sure
45b0: 20 6e 6f 62 6f 64 79 20 65 6c 73 65 20 69 73 20   nobody else is 
45c0: 0a 20 20 2a 2a 20 68 6f 6c 64 69 6e 67 20 74 68  .  ** holding th
45d0: 65 6d 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4e 6f  em..  **.  ** No
45e0: 74 65 20 74 68 61 74 20 73 65 74 74 69 6e 67 20  te that setting 
45f0: 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54 54 45 44  READ_UNCOMMITTED
4600: 20 6f 76 65 72 72 69 64 65 73 20 6d 6f 73 74 20   overrides most 
4610: 6c 6f 63 6b 20 64 65 74 65 63 74 69 6f 6e 2c 0a  lock detection,.
4620: 20 20 2a 2a 20 62 75 74 20 69 74 20 64 6f 65 73    ** but it does
4630: 20 2a 6e 6f 74 2a 20 6f 76 65 72 72 69 64 65 20   *not* override 
4640: 73 63 68 65 6d 61 20 6c 6f 63 6b 20 64 65 74 65  schema lock dete
4650: 63 74 69 6f 6e 2c 20 73 6f 20 74 68 69 73 20 61  ction, so this a
4660: 6c 6c 20 73 74 69 6c 6c 0a 20 20 2a 2a 20 77 6f  ll still.  ** wo
4670: 72 6b 73 20 65 76 65 6e 20 69 66 20 52 45 41 44  rks even if READ
4680: 5f 55 4e 43 4f 4d 4d 49 54 54 45 44 20 69 73 20  _UNCOMMITTED is 
4690: 73 65 74 2e 0a 20 20 2a 2f 0a 20 20 66 6f 72 28  set..  */.  for(
46a0: 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20  i=0; i<db->nDb; 
46b0: 69 2b 2b 29 20 7b 0a 20 20 20 20 42 74 72 65 65  i++) {.    Btree
46c0: 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b   *pBt = db->aDb[
46d0: 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69 66 28 20  i].pBt;.    if( 
46e0: 70 42 74 20 29 7b 0a 20 20 20 20 20 20 61 73 73  pBt ){.      ass
46f0: 65 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 65  ert( sqlite3Btre
4700: 65 48 6f 6c 64 73 4d 75 74 65 78 28 70 42 74 29  eHoldsMutex(pBt)
4710: 20 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73   );.      rc = s
4720: 71 6c 69 74 65 33 42 74 72 65 65 53 63 68 65 6d  qlite3BtreeSchem
4730: 61 4c 6f 63 6b 65 64 28 70 42 74 29 3b 0a 20 20  aLocked(pBt);.  
4740: 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20      if( rc ){.  
4750: 20 20 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72        const char
4760: 20 2a 7a 44 62 20 3d 20 64 62 2d 3e 61 44 62 5b   *zDb = db->aDb[
4770: 69 5d 2e 7a 4e 61 6d 65 3b 0a 20 20 20 20 20 20  i].zName;.      
4780: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64    sqlite3Error(d
4790: 62 2c 20 72 63 2c 20 22 64 61 74 61 62 61 73 65  b, rc, "database
47a0: 20 73 63 68 65 6d 61 20 69 73 20 6c 6f 63 6b 65   schema is locke
47b0: 64 3a 20 25 73 22 2c 20 7a 44 62 29 3b 0a 20 20  d: %s", zDb);.  
47c0: 20 20 20 20 20 20 28 76 6f 69 64 29 73 71 6c 69        (void)sqli
47d0: 74 65 33 53 61 66 65 74 79 4f 66 66 28 64 62 29  te3SafetyOff(db)
47e0: 3b 0a 20 20 20 20 20 20 20 20 74 65 73 74 63 61  ;.        testca
47f0: 73 65 28 20 64 62 2d 3e 66 6c 61 67 73 20 26 20  se( db->flags & 
4800: 53 51 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d  SQLITE_ReadUncom
4810: 6d 69 74 74 65 64 20 29 3b 0a 20 20 20 20 20 20  mitted );.      
4820: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
4830: 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b  ApiExit(db, rc);
4840: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
4850: 20 7d 0a 20 20 0a 20 20 6d 65 6d 73 65 74 28 26   }.  .  memset(&
4860: 73 50 61 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f  sParse, 0, sizeo
4870: 66 28 73 50 61 72 73 65 29 29 3b 0a 20 20 73 50  f(sParse));.  sP
4880: 61 72 73 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20  arse.db = db;.  
4890: 69 66 28 20 6e 42 79 74 65 73 3e 3d 30 20 26 26  if( nBytes>=0 &&
48a0: 20 28 6e 42 79 74 65 73 3d 3d 30 20 7c 7c 20 7a   (nBytes==0 || z
48b0: 53 71 6c 5b 6e 42 79 74 65 73 2d 31 5d 21 3d 30  Sql[nBytes-1]!=0
48c0: 29 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a  ) ){.    char *z
48d0: 53 71 6c 43 6f 70 79 3b 0a 20 20 20 20 69 6e 74  SqlCopy;.    int
48e0: 20 6d 78 4c 65 6e 20 3d 20 64 62 2d 3e 61 4c 69   mxLen = db->aLi
48f0: 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54  mit[SQLITE_LIMIT
4900: 5f 53 51 4c 5f 4c 45 4e 47 54 48 5d 3b 0a 20 20  _SQL_LENGTH];.  
4910: 20 20 69 66 28 20 6e 42 79 74 65 73 3e 6d 78 4c    if( nBytes>mxL
4920: 65 6e 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69  en ){.      sqli
4930: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 53 51 4c  te3Error(db, SQL
4940: 49 54 45 5f 54 4f 4f 42 49 47 2c 20 22 73 74 61  ITE_TOOBIG, "sta
4950: 74 65 6d 65 6e 74 20 74 6f 6f 20 6c 6f 6e 67 22  tement too long"
4960: 29 3b 0a 20 20 20 20 20 20 28 76 6f 69 64 29 73  );.      (void)s
4970: 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66 66 28  qlite3SafetyOff(
4980: 64 62 29 3b 0a 20 20 20 20 20 20 72 65 74 75 72  db);.      retur
4990: 6e 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74  n sqlite3ApiExit
49a0: 28 64 62 2c 20 53 51 4c 49 54 45 5f 54 4f 4f 42  (db, SQLITE_TOOB
49b0: 49 47 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 7a  IG);.    }.    z
49c0: 53 71 6c 43 6f 70 79 20 3d 20 73 71 6c 69 74 65  SqlCopy = sqlite
49d0: 33 44 62 53 74 72 4e 44 75 70 28 64 62 2c 20 7a  3DbStrNDup(db, z
49e0: 53 71 6c 2c 20 6e 42 79 74 65 73 29 3b 0a 20 20  Sql, nBytes);.  
49f0: 20 20 69 66 28 20 7a 53 71 6c 43 6f 70 79 20 29    if( zSqlCopy )
4a00: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 52  {.      sqlite3R
4a10: 75 6e 50 61 72 73 65 72 28 26 73 50 61 72 73 65  unParser(&sParse
4a20: 2c 20 7a 53 71 6c 43 6f 70 79 2c 20 26 7a 45 72  , zSqlCopy, &zEr
4a30: 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 73 71 6c  rMsg);.      sql
4a40: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a  ite3DbFree(db, z
4a50: 53 71 6c 43 6f 70 79 29 3b 0a 20 20 20 20 20 20  SqlCopy);.      
4a60: 73 50 61 72 73 65 2e 7a 54 61 69 6c 20 3d 20 26  sParse.zTail = &
4a70: 7a 53 71 6c 5b 73 50 61 72 73 65 2e 7a 54 61 69  zSql[sParse.zTai
4a80: 6c 2d 7a 53 71 6c 43 6f 70 79 5d 3b 0a 20 20 20  l-zSqlCopy];.   
4a90: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 50   }else{.      sP
4aa0: 61 72 73 65 2e 7a 54 61 69 6c 20 3d 20 26 7a 53  arse.zTail = &zS
4ab0: 71 6c 5b 6e 42 79 74 65 73 5d 3b 0a 20 20 20 20  ql[nBytes];.    
4ac0: 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73  }.  }else{.    s
4ad0: 71 6c 69 74 65 33 52 75 6e 50 61 72 73 65 72 28  qlite3RunParser(
4ae0: 26 73 50 61 72 73 65 2c 20 7a 53 71 6c 2c 20 26  &sParse, zSql, &
4af0: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 7d 0a 0a 20  zErrMsg);.  }.. 
4b00: 20 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46   if( db->mallocF
4b10: 61 69 6c 65 64 20 29 7b 0a 20 20 20 20 73 50 61  ailed ){.    sPa
4b20: 72 73 65 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f  rse.rc = SQLITE_
4b30: 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20 20 69 66 28  NOMEM;.  }.  if(
4b40: 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49   sParse.rc==SQLI
4b50: 54 45 5f 44 4f 4e 45 20 29 20 73 50 61 72 73 65  TE_DONE ) sParse
4b60: 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  .rc = SQLITE_OK;
4b70: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 63 68  .  if( sParse.ch
4b80: 65 63 6b 53 63 68 65 6d 61 20 26 26 20 21 73 63  eckSchema && !sc
4b90: 68 65 6d 61 49 73 56 61 6c 69 64 28 64 62 29 20  hemaIsValid(db) 
4ba0: 29 7b 0a 20 20 20 20 73 50 61 72 73 65 2e 72 63  ){.    sParse.rc
4bb0: 20 3d 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41   = SQLITE_SCHEMA
4bc0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 50 61 72  ;.  }.  if( sPar
4bd0: 73 65 2e 72 63 3d 3d 53 51 4c 49 54 45 5f 53 43  se.rc==SQLITE_SC
4be0: 48 45 4d 41 20 29 7b 0a 20 20 20 20 73 71 6c 69  HEMA ){.    sqli
4bf0: 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c  te3ResetInternal
4c00: 53 63 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20  Schema(db, 0);. 
4c10: 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c   }.  if( db->mal
4c20: 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20  locFailed ){.   
4c30: 20 73 50 61 72 73 65 2e 72 63 20 3d 20 53 51 4c   sParse.rc = SQL
4c40: 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a 20  ITE_NOMEM;.  }. 
4c50: 20 69 66 28 20 70 7a 54 61 69 6c 20 29 7b 0a 20   if( pzTail ){. 
4c60: 20 20 20 2a 70 7a 54 61 69 6c 20 3d 20 73 50 61     *pzTail = sPa
4c70: 72 73 65 2e 7a 54 61 69 6c 3b 0a 20 20 7d 0a 20  rse.zTail;.  }. 
4c80: 20 72 63 20 3d 20 73 50 61 72 73 65 2e 72 63 3b   rc = sParse.rc;
4c90: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  ..#ifndef SQLITE
4ca0: 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20  _OMIT_EXPLAIN.  
4cb0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  if( rc==SQLITE_O
4cc0: 4b 20 26 26 20 73 50 61 72 73 65 2e 70 56 64 62  K && sParse.pVdb
4cd0: 65 20 26 26 20 73 50 61 72 73 65 2e 65 78 70 6c  e && sParse.expl
4ce0: 61 69 6e 20 29 7b 0a 20 20 20 20 69 66 28 20 73  ain ){.    if( s
4cf0: 50 61 72 73 65 2e 65 78 70 6c 61 69 6e 3d 3d 32  Parse.explain==2
4d00: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65   ){.      sqlite
4d10: 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28  3VdbeSetNumCols(
4d20: 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 33 29  sParse.pVdbe, 3)
4d30: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  ;.      sqlite3V
4d40: 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50  dbeSetColName(sP
4d50: 61 72 73 65 2e 70 56 64 62 65 2c 20 30 2c 20 43  arse.pVdbe, 0, C
4d60: 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 2c 20 22 6f 72  OLNAME_NAME, "or
4d70: 64 65 72 22 2c 20 53 51 4c 49 54 45 5f 53 54 41  der", SQLITE_STA
4d80: 54 49 43 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  TIC);.      sqli
4d90: 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d  te3VdbeSetColNam
4da0: 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20  e(sParse.pVdbe, 
4db0: 31 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 2c  1, COLNAME_NAME,
4dc0: 20 22 66 72 6f 6d 22 2c 20 53 51 4c 49 54 45 5f   "from", SQLITE_
4dd0: 53 54 41 54 49 43 29 3b 0a 20 20 20 20 20 20 73  STATIC);.      s
4de0: 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c  qlite3VdbeSetCol
4df0: 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62  Name(sParse.pVdb
4e00: 65 2c 20 32 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41  e, 2, COLNAME_NA
4e10: 4d 45 2c 20 22 64 65 74 61 69 6c 22 2c 20 53 51  ME, "detail", SQ
4e20: 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20  LITE_STATIC);.  
4e30: 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 73    }else{.      s
4e40: 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e 75 6d  qlite3VdbeSetNum
4e50: 43 6f 6c 73 28 73 50 61 72 73 65 2e 70 56 64 62  Cols(sParse.pVdb
4e60: 65 2c 20 38 29 3b 0a 20 20 20 20 20 20 73 71 6c  e, 8);.      sql
4e70: 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61  ite3VdbeSetColNa
4e80: 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c  me(sParse.pVdbe,
4e90: 20 30 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45   0, COLNAME_NAME
4ea0: 2c 20 22 61 64 64 72 22 2c 20 53 51 4c 49 54 45  , "addr", SQLITE
4eb0: 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20 20 20  _STATIC);.      
4ec0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f  sqlite3VdbeSetCo
4ed0: 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64  lName(sParse.pVd
4ee0: 62 65 2c 20 31 2c 20 43 4f 4c 4e 41 4d 45 5f 4e  be, 1, COLNAME_N
4ef0: 41 4d 45 2c 20 22 6f 70 63 6f 64 65 22 2c 20 53  AME, "opcode", S
4f00: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
4f10: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
4f20: 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73  SetColName(sPars
4f30: 65 2e 70 56 64 62 65 2c 20 32 2c 20 43 4f 4c 4e  e.pVdbe, 2, COLN
4f40: 41 4d 45 5f 4e 41 4d 45 2c 20 22 70 31 22 2c 20  AME_NAME, "p1", 
4f50: 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a  SQLITE_STATIC);.
4f60: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
4f70: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72  eSetColName(sPar
4f80: 73 65 2e 70 56 64 62 65 2c 20 33 2c 20 43 4f 4c  se.pVdbe, 3, COL
4f90: 4e 41 4d 45 5f 4e 41 4d 45 2c 20 22 70 32 22 2c  NAME_NAME, "p2",
4fa0: 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b   SQLITE_STATIC);
4fb0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
4fc0: 62 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61  beSetColName(sPa
4fd0: 72 73 65 2e 70 56 64 62 65 2c 20 34 2c 20 43 4f  rse.pVdbe, 4, CO
4fe0: 4c 4e 41 4d 45 5f 4e 41 4d 45 2c 20 22 70 33 22  LNAME_NAME, "p3"
4ff0: 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29  , SQLITE_STATIC)
5000: 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56  ;.      sqlite3V
5010: 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50  dbeSetColName(sP
5020: 61 72 73 65 2e 70 56 64 62 65 2c 20 35 2c 20 43  arse.pVdbe, 5, C
5030: 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 2c 20 22 70 34  OLNAME_NAME, "p4
5040: 22 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43  ", SQLITE_STATIC
5050: 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  );.      sqlite3
5060: 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73  VdbeSetColName(s
5070: 50 61 72 73 65 2e 70 56 64 62 65 2c 20 36 2c 20  Parse.pVdbe, 6, 
5080: 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 2c 20 22 70  COLNAME_NAME, "p
5090: 35 22 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49  5", SQLITE_STATI
50a0: 43 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  C);.      sqlite
50b0: 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65 28  3VdbeSetColName(
50c0: 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 37 2c  sParse.pVdbe, 7,
50d0: 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 2c 20 22   COLNAME_NAME, "
50e0: 63 6f 6d 6d 65 6e 74 22 2c 20 53 51 4c 49 54 45  comment", SQLITE
50f0: 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20 7d 0a  _STATIC);.    }.
5100: 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 20 69 66    }.#endif..  if
5110: 28 20 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f  ( sqlite3SafetyO
5120: 66 66 28 64 62 29 20 29 7b 0a 20 20 20 20 72 63  ff(db) ){.    rc
5130: 20 3d 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45   = SQLITE_MISUSE
5140: 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28  ;.  }..  assert(
5150: 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 3d 3d   db->init.busy==
5160: 30 20 7c 7c 20 73 61 76 65 53 71 6c 46 6c 61 67  0 || saveSqlFlag
5170: 3d 3d 30 20 29 3b 0a 20 20 69 66 28 20 64 62 2d  ==0 );.  if( db-
5180: 3e 69 6e 69 74 2e 62 75 73 79 3d 3d 30 20 29 7b  >init.busy==0 ){
5190: 0a 20 20 20 20 56 64 62 65 20 2a 70 56 64 62 65  .    Vdbe *pVdbe
51a0: 20 3d 20 73 50 61 72 73 65 2e 70 56 64 62 65 3b   = sParse.pVdbe;
51b0: 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65  .    sqlite3Vdbe
51c0: 53 65 74 53 71 6c 28 70 56 64 62 65 2c 20 7a 53  SetSql(pVdbe, zS
51d0: 71 6c 2c 20 28 69 6e 74 29 28 73 50 61 72 73 65  ql, (int)(sParse
51e0: 2e 7a 54 61 69 6c 2d 7a 53 71 6c 29 2c 20 73 61  .zTail-zSql), sa
51f0: 76 65 53 71 6c 46 6c 61 67 29 3b 0a 20 20 7d 0a  veSqlFlag);.  }.
5200: 20 20 69 66 28 20 73 50 61 72 73 65 2e 70 56 64    if( sParse.pVd
5210: 62 65 20 26 26 20 28 72 63 21 3d 53 51 4c 49 54  be && (rc!=SQLIT
5220: 45 5f 4f 4b 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c  E_OK || db->mall
5230: 6f 63 46 61 69 6c 65 64 29 20 29 7b 0a 20 20 20  ocFailed) ){.   
5240: 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 6e 61   sqlite3VdbeFina
5250: 6c 69 7a 65 28 73 50 61 72 73 65 2e 70 56 64 62  lize(sParse.pVdb
5260: 65 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 21  e);.    assert(!
5270: 28 2a 70 70 53 74 6d 74 29 29 3b 0a 20 20 7d 65  (*ppStmt));.  }e
5280: 6c 73 65 7b 0a 20 20 20 20 2a 70 70 53 74 6d 74  lse{.    *ppStmt
5290: 20 3d 20 28 73 71 6c 69 74 65 33 5f 73 74 6d 74   = (sqlite3_stmt
52a0: 2a 29 73 50 61 72 73 65 2e 70 56 64 62 65 3b 0a  *)sParse.pVdbe;.
52b0: 20 20 7d 0a 0a 20 20 69 66 28 20 7a 45 72 72 4d    }..  if( zErrM
52c0: 73 67 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65  sg ){.    sqlite
52d0: 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 22  3Error(db, rc, "
52e0: 25 73 22 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20  %s", zErrMsg);. 
52f0: 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65     sqlite3DbFree
5300: 28 64 62 2c 20 7a 45 72 72 4d 73 67 29 3b 0a 20  (db, zErrMsg);. 
5310: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69   }else{.    sqli
5320: 74 65 33 45 72 72 6f 72 28 64 62 2c 20 72 63 2c  te3Error(db, rc,
5330: 20 30 29 3b 0a 20 20 7d 0a 0a 20 20 72 63 20 3d   0);.  }..  rc =
5340: 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28   sqlite3ApiExit(
5350: 64 62 2c 20 72 63 29 3b 0a 20 20 61 73 73 65 72  db, rc);.  asser
5360: 74 28 20 28 72 63 26 64 62 2d 3e 65 72 72 4d 61  t( (rc&db->errMa
5370: 73 6b 29 3d 3d 72 63 20 29 3b 0a 20 20 72 65 74  sk)==rc );.  ret
5380: 75 72 6e 20 72 63 3b 0a 7d 0a 73 74 61 74 69 63  urn rc;.}.static
5390: 20 69 6e 74 20 73 71 6c 69 74 65 33 4c 6f 63 6b   int sqlite3Lock
53a0: 41 6e 64 50 72 65 70 61 72 65 28 0a 20 20 73 71  AndPrepare(.  sq
53b0: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20  lite3 *db,      
53c0: 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62          /* Datab
53d0: 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20  ase handle. */. 
53e0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71   const char *zSq
53f0: 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54  l,         /* UT
5400: 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20  F-8 encoded SQL 
5410: 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20  statement. */.  
5420: 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20  int nBytes,     
5430: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e            /* Len
5440: 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62  gth of zSql in b
5450: 79 74 65 73 2e 20 2a 2f 0a 20 20 69 6e 74 20 73  ytes. */.  int s
5460: 61 76 65 53 71 6c 46 6c 61 67 2c 20 20 20 20 20  aveSqlFlag,     
5470: 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20       /* True to 
5480: 63 6f 70 79 20 53 51 4c 20 74 65 78 74 20 69 6e  copy SQL text in
5490: 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f 73  to the sqlite3_s
54a0: 74 6d 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  tmt */.  sqlite3
54b0: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
54c0: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69     /* OUT: A poi
54d0: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70  nter to the prep
54e0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a  ared statement *
54f0: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
5500: 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a  *pzTail       /*
5510: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72   OUT: End of par
5520: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b  sed string */.){
5530: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 66 28  .  int rc;.  if(
5540: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43   !sqlite3SafetyC
5550: 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20  heckOk(db) ){.  
5560: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
5570: 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 73 71  MISUSE;.  }.  sq
5580: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
5590: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  r(db->mutex);.  
55a0: 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65  sqlite3BtreeEnte
55b0: 72 41 6c 6c 28 64 62 29 3b 0a 20 20 72 63 20 3d  rAll(db);.  rc =
55c0: 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 28   sqlite3Prepare(
55d0: 64 62 2c 20 7a 53 71 6c 2c 20 6e 42 79 74 65 73  db, zSql, nBytes
55e0: 2c 20 73 61 76 65 53 71 6c 46 6c 61 67 2c 20 70  , saveSqlFlag, p
55f0: 70 53 74 6d 74 2c 20 70 7a 54 61 69 6c 29 3b 0a  pStmt, pzTail);.
5600: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65    sqlite3BtreeLe
5610: 61 76 65 41 6c 6c 28 64 62 29 3b 0a 20 20 73 71  aveAll(db);.  sq
5620: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
5630: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  e(db->mutex);.  
5640: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
5650: 0a 2a 2a 20 52 65 72 75 6e 20 74 68 65 20 63 6f  .** Rerun the co
5660: 6d 70 69 6c 61 74 69 6f 6e 20 6f 66 20 61 20 73  mpilation of a s
5670: 74 61 74 65 6d 65 6e 74 20 61 66 74 65 72 20 61  tatement after a
5680: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 2e 0a   schema change..
5690: 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 73 74 61  **.** If the sta
56a0: 74 65 6d 65 6e 74 20 69 73 20 73 75 63 63 65 73  tement is succes
56b0: 73 66 75 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65  sfully recompile
56c0: 64 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45  d, return SQLITE
56d0: 5f 4f 4b 2e 20 4f 74 68 65 72 77 69 73 65 2c 0a  _OK. Otherwise,.
56e0: 2a 2a 20 69 66 20 74 68 65 20 73 74 61 74 65 6d  ** if the statem
56f0: 65 6e 74 20 63 61 6e 6e 6f 74 20 62 65 20 72 65  ent cannot be re
5700: 63 6f 6d 70 69 6c 65 64 20 62 65 63 61 75 73 65  compiled because
5710: 20 61 6e 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74   another connect
5720: 69 6f 6e 20 68 61 73 0a 2a 2a 20 6c 6f 63 6b 65  ion has.** locke
5730: 64 20 74 68 65 20 73 71 6c 69 74 65 33 5f 6d 61  d the sqlite3_ma
5740: 73 74 65 72 20 74 61 62 6c 65 2c 20 72 65 74 75  ster table, retu
5750: 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44  rn SQLITE_LOCKED
5760: 2e 20 49 66 20 61 6e 79 20 6f 74 68 65 72 20 65  . If any other e
5770: 72 72 6f 72 0a 2a 2a 20 6f 63 63 75 72 73 2c 20  rror.** occurs, 
5780: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 53 43  return SQLITE_SC
5790: 48 45 4d 41 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c  HEMA..*/.int sql
57a0: 69 74 65 33 52 65 70 72 65 70 61 72 65 28 56 64  ite3Reprepare(Vd
57b0: 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63  be *p){.  int rc
57c0: 3b 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74  ;.  sqlite3_stmt
57d0: 20 2a 70 4e 65 77 3b 0a 20 20 63 6f 6e 73 74 20   *pNew;.  const 
57e0: 63 68 61 72 20 2a 7a 53 71 6c 3b 0a 20 20 73 71  char *zSql;.  sq
57f0: 6c 69 74 65 33 20 2a 64 62 3b 0a 0a 20 20 61 73  lite3 *db;..  as
5800: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
5810: 74 65 78 5f 68 65 6c 64 28 73 71 6c 69 74 65 33  tex_held(sqlite3
5820: 56 64 62 65 44 62 28 70 29 2d 3e 6d 75 74 65 78  VdbeDb(p)->mutex
5830: 29 20 29 3b 0a 20 20 7a 53 71 6c 20 3d 20 73 71  ) );.  zSql = sq
5840: 6c 69 74 65 33 5f 73 71 6c 28 28 73 71 6c 69 74  lite3_sql((sqlit
5850: 65 33 5f 73 74 6d 74 20 2a 29 70 29 3b 0a 20 20  e3_stmt *)p);.  
5860: 61 73 73 65 72 74 28 20 7a 53 71 6c 21 3d 30 20  assert( zSql!=0 
5870: 29 3b 20 20 2f 2a 20 52 65 70 72 65 70 61 72 65  );  /* Reprepare
5880: 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 66 6f 72   only called for
5890: 20 70 72 65 70 61 72 65 5f 76 32 28 29 20 73 74   prepare_v2() st
58a0: 61 74 65 6d 65 6e 74 73 20 2a 2f 0a 20 20 64 62  atements */.  db
58b0: 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 44 62   = sqlite3VdbeDb
58c0: 28 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73  (p);.  assert( s
58d0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
58e0: 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  d(db->mutex) );.
58f0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f    rc = sqlite3Lo
5900: 63 6b 41 6e 64 50 72 65 70 61 72 65 28 64 62 2c  ckAndPrepare(db,
5910: 20 7a 53 71 6c 2c 20 2d 31 2c 20 30 2c 20 26 70   zSql, -1, 0, &p
5920: 4e 65 77 2c 20 30 29 3b 0a 20 20 69 66 28 20 72  New, 0);.  if( r
5930: 63 20 29 7b 0a 20 20 20 20 69 66 28 20 72 63 3d  c ){.    if( rc=
5940: 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 7b  =SQLITE_NOMEM ){
5950: 0a 20 20 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f  .      db->mallo
5960: 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a 20 20 20  cFailed = 1;.   
5970: 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 70   }.    assert( p
5980: 4e 65 77 3d 3d 30 20 29 3b 0a 20 20 20 20 72 65  New==0 );.    re
5990: 74 75 72 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45  turn (rc==SQLITE
59a0: 5f 4c 4f 43 4b 45 44 29 20 3f 20 53 51 4c 49 54  _LOCKED) ? SQLIT
59b0: 45 5f 4c 4f 43 4b 45 44 20 3a 20 53 51 4c 49 54  E_LOCKED : SQLIT
59c0: 45 5f 53 43 48 45 4d 41 3b 0a 20 20 7d 65 6c 73  E_SCHEMA;.  }els
59d0: 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 70  e{.    assert( p
59e0: 4e 65 77 21 3d 30 20 29 3b 0a 20 20 7d 0a 20 20  New!=0 );.  }.  
59f0: 73 71 6c 69 74 65 33 56 64 62 65 53 77 61 70 28  sqlite3VdbeSwap(
5a00: 28 56 64 62 65 2a 29 70 4e 65 77 2c 20 70 29 3b  (Vdbe*)pNew, p);
5a10: 0a 20 20 73 71 6c 69 74 65 33 54 72 61 6e 73 66  .  sqlite3Transf
5a20: 65 72 42 69 6e 64 69 6e 67 73 28 70 4e 65 77 2c  erBindings(pNew,
5a30: 20 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 29   (sqlite3_stmt*)
5a40: 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62  p);.  sqlite3Vdb
5a50: 65 52 65 73 65 74 53 74 65 70 52 65 73 75 6c 74  eResetStepResult
5a60: 28 28 56 64 62 65 2a 29 70 4e 65 77 29 3b 0a 20  ((Vdbe*)pNew);. 
5a70: 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 6e 61   sqlite3VdbeFina
5a80: 6c 69 7a 65 28 28 56 64 62 65 2a 29 70 4e 65 77  lize((Vdbe*)pNew
5a90: 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49  );.  return SQLI
5aa0: 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a  TE_OK;.}.../*.**
5ab0: 20 54 77 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66   Two versions of
5ac0: 20 74 68 65 20 6f 66 66 69 63 69 61 6c 20 41 50   the official AP
5ad0: 49 2e 20 20 4c 65 67 61 63 79 20 61 6e 64 20 6e  I.  Legacy and n
5ae0: 65 77 20 75 73 65 2e 20 20 49 6e 20 74 68 65 20  ew use.  In the 
5af0: 6c 65 67 61 63 79 0a 2a 2a 20 76 65 72 73 69 6f  legacy.** versio
5b00: 6e 2c 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20  n, the original 
5b10: 53 51 4c 20 74 65 78 74 20 69 73 20 6e 6f 74 20  SQL text is not 
5b20: 73 61 76 65 64 20 69 6e 20 74 68 65 20 70 72 65  saved in the pre
5b30: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 0a  pared statement.
5b40: 2a 2a 20 61 6e 64 20 73 6f 20 69 66 20 61 20 73  ** and so if a s
5b50: 63 68 65 6d 61 20 63 68 61 6e 67 65 20 6f 63 63  chema change occ
5b60: 75 72 73 2c 20 53 51 4c 49 54 45 5f 53 43 48 45  urs, SQLITE_SCHE
5b70: 4d 41 20 69 73 20 72 65 74 75 72 6e 65 64 20 62  MA is returned b
5b80: 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73 74 65  y.** sqlite3_ste
5b90: 70 28 29 2e 20 20 49 6e 20 74 68 65 20 6e 65 77  p().  In the new
5ba0: 20 76 65 72 73 69 6f 6e 2c 20 74 68 65 20 6f 72   version, the or
5bb0: 69 67 69 6e 61 6c 20 53 51 4c 20 74 65 78 74 20  iginal SQL text 
5bc0: 69 73 20 72 65 74 61 69 6e 65 64 0a 2a 2a 20 61  is retained.** a
5bd0: 6e 64 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  nd the statement
5be0: 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c   is automaticall
5bf0: 79 20 72 65 63 6f 6d 70 69 6c 65 64 20 69 66 20  y recompiled if 
5c00: 61 6e 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65  an schema change
5c10: 0a 2a 2a 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 69  .** occurs..*/.i
5c20: 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61  nt sqlite3_prepa
5c30: 72 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  re(.  sqlite3 *d
5c40: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  b,              
5c50: 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64  /* Database hand
5c60: 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  le. */.  const c
5c70: 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20  har *zSql,      
5c80: 20 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f     /* UTF-8 enco
5c90: 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  ded SQL statemen
5ca0: 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74  t. */.  int nByt
5cb0: 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  es,             
5cc0: 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a    /* Length of z
5cd0: 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f  Sql in bytes. */
5ce0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
5cf0: 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20  **ppStmt,    /* 
5d00: 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74  OUT: A pointer t
5d10: 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73  o the prepared s
5d20: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f  tatement */.  co
5d30: 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 69  nst char **pzTai
5d40: 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20  l       /* OUT: 
5d50: 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74  End of parsed st
5d60: 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74  ring */.){.  int
5d70: 20 72 63 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69   rc;.  rc = sqli
5d80: 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72  te3LockAndPrepar
5d90: 65 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73  e(db,zSql,nBytes
5da0: 2c 30 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c  ,0,ppStmt,pzTail
5db0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d  );.  assert( rc=
5dc0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70  =SQLITE_OK || pp
5dd0: 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74  Stmt==0 || *ppSt
5de0: 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52  mt==0 );  /* VER
5df0: 49 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20  IFY: F13021 */. 
5e00: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e   return rc;.}.in
5e10: 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72  t sqlite3_prepar
5e20: 65 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 33 20  e_v2(.  sqlite3 
5e30: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20  *db,            
5e40: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61    /* Database ha
5e50: 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74  ndle. */.  const
5e60: 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20   char *zSql,    
5e70: 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e       /* UTF-8 en
5e80: 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d  coded SQL statem
5e90: 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42  ent. */.  int nB
5ea0: 79 74 65 73 2c 20 20 20 20 20 20 20 20 20 20 20  ytes,           
5eb0: 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66      /* Length of
5ec0: 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20   zSql in bytes. 
5ed0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d  */.  sqlite3_stm
5ee0: 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f  t **ppStmt,    /
5ef0: 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72  * OUT: A pointer
5f00: 20 74 6f 20 74 68 65 20 70 72 65 70 61 72 65 64   to the prepared
5f10: 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20   statement */.  
5f20: 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54  const char **pzT
5f30: 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54  ail       /* OUT
5f40: 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20  : End of parsed 
5f50: 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69  string */.){.  i
5f60: 6e 74 20 72 63 3b 0a 20 20 72 63 20 3d 20 73 71  nt rc;.  rc = sq
5f70: 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70  lite3LockAndPrep
5f80: 61 72 65 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74  are(db,zSql,nByt
5f90: 65 73 2c 31 2c 70 70 53 74 6d 74 2c 70 7a 54 61  es,1,ppStmt,pzTa
5fa0: 69 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72  il);.  assert( r
5fb0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20  c==SQLITE_OK || 
5fc0: 70 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70  ppStmt==0 || *pp
5fd0: 53 74 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56  Stmt==0 );  /* V
5fe0: 45 52 49 46 59 3a 20 46 31 33 30 32 31 20 2a 2f  ERIFY: F13021 */
5ff0: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a  .  return rc;.}.
6000: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45  ..#ifndef SQLITE
6010: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a  _OMIT_UTF16./*.*
6020: 2a 20 43 6f 6d 70 69 6c 65 20 74 68 65 20 55 54  * Compile the UT
6030: 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 53 51 4c  F-16 encoded SQL
6040: 20 73 74 61 74 65 6d 65 6e 74 20 7a 53 71 6c 20   statement zSql 
6050: 69 6e 74 6f 20 61 20 73 74 61 74 65 6d 65 6e 74  into a statement
6060: 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 73 74 61 74   handle..*/.stat
6070: 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 50 72  ic int sqlite3Pr
6080: 65 70 61 72 65 31 36 28 0a 20 20 73 71 6c 69 74  epare16(.  sqlit
6090: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  e3 *db,         
60a0: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
60b0: 20 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63   handle. */ .  c
60c0: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c  onst void *zSql,
60d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d           /* UTF-
60e0: 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  8 encoded SQL st
60f0: 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e  atement. */.  in
6100: 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20  t nBytes,       
6110: 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74          /* Lengt
6120: 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74  h of zSql in byt
6130: 65 73 2e 20 2a 2f 0a 20 20 69 6e 74 20 73 61 76  es. */.  int sav
6140: 65 53 71 6c 46 6c 61 67 2c 20 20 20 20 20 20 20  eSqlFlag,       
6150: 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 73 61     /* True to sa
6160: 76 65 20 53 51 4c 20 74 65 78 74 20 69 6e 74 6f  ve SQL text into
6170: 20 74 68 65 20 73 71 6c 69 74 65 33 5f 73 74 6d   the sqlite3_stm
6180: 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73  t */.  sqlite3_s
6190: 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20  tmt **ppStmt,   
61a0: 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74   /* OUT: A point
61b0: 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61 72  er to the prepar
61c0: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a  ed statement */.
61d0: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70    const void **p
61e0: 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f  zTail       /* O
61f0: 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65  UT: End of parse
6200: 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20  d string */.){. 
6210: 20 2f 2a 20 54 68 69 73 20 66 75 6e 63 74 69 6f   /* This functio
6220: 6e 20 63 75 72 72 65 6e 74 6c 79 20 77 6f 72 6b  n currently work
6230: 73 20 62 79 20 66 69 72 73 74 20 74 72 61 6e 73  s by first trans
6240: 66 6f 72 6d 69 6e 67 20 74 68 65 20 55 54 46 2d  forming the UTF-
6250: 31 36 0a 20 20 2a 2a 20 65 6e 63 6f 64 65 64 20  16.  ** encoded 
6260: 73 74 72 69 6e 67 20 74 6f 20 55 54 46 2d 38 2c  string to UTF-8,
6270: 20 74 68 65 6e 20 69 6e 76 6f 6b 69 6e 67 20 73   then invoking s
6280: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29  qlite3_prepare()
6290: 2e 20 54 68 65 0a 20 20 2a 2a 20 74 72 69 63 6b  . The.  ** trick
62a0: 79 20 62 69 74 20 69 73 20 66 69 67 75 72 69 6e  y bit is figurin
62b0: 67 20 6f 75 74 20 74 68 65 20 70 6f 69 6e 74 65  g out the pointe
62c0: 72 20 74 6f 20 72 65 74 75 72 6e 20 69 6e 20 2a  r to return in *
62d0: 70 7a 54 61 69 6c 2e 0a 20 20 2a 2f 0a 20 20 63  pzTail..  */.  c
62e0: 68 61 72 20 2a 7a 53 71 6c 38 3b 0a 20 20 63 6f  har *zSql8;.  co
62f0: 6e 73 74 20 63 68 61 72 20 2a 7a 54 61 69 6c 38  nst char *zTail8
6300: 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 20 3d   = 0;.  int rc =
6310: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 69   SQLITE_OK;..  i
6320: 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74  f( !sqlite3Safet
6330: 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a  yCheckOk(db) ){.
6340: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
6350: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20  E_MISUSE;.  }.  
6360: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
6370: 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  ter(db->mutex);.
6380: 20 20 7a 53 71 6c 38 20 3d 20 73 71 6c 69 74 65    zSql8 = sqlite
6390: 33 55 74 66 31 36 74 6f 38 28 64 62 2c 20 7a 53  3Utf16to8(db, zS
63a0: 71 6c 2c 20 6e 42 79 74 65 73 29 3b 0a 20 20 69  ql, nBytes);.  i
63b0: 66 28 20 7a 53 71 6c 38 20 29 7b 0a 20 20 20 20  f( zSql8 ){.    
63c0: 72 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b  rc = sqlite3Lock
63d0: 41 6e 64 50 72 65 70 61 72 65 28 64 62 2c 20 7a  AndPrepare(db, z
63e0: 53 71 6c 38 2c 20 2d 31 2c 20 73 61 76 65 53 71  Sql8, -1, saveSq
63f0: 6c 46 6c 61 67 2c 20 70 70 53 74 6d 74 2c 20 26  lFlag, ppStmt, &
6400: 7a 54 61 69 6c 38 29 3b 0a 20 20 7d 0a 0a 20 20  zTail8);.  }..  
6410: 69 66 28 20 7a 54 61 69 6c 38 20 26 26 20 70 7a  if( zTail8 && pz
6420: 54 61 69 6c 20 29 7b 0a 20 20 20 20 2f 2a 20 49  Tail ){.    /* I
6430: 66 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72  f sqlite3_prepar
6440: 65 20 72 65 74 75 72 6e 73 20 61 20 74 61 69 6c  e returns a tail
6450: 20 70 6f 69 6e 74 65 72 2c 20 77 65 20 63 61 6c   pointer, we cal
6460: 63 75 6c 61 74 65 20 74 68 65 0a 20 20 20 20 2a  culate the.    *
6470: 2a 20 65 71 75 69 76 61 6c 65 6e 74 20 70 6f 69  * equivalent poi
6480: 6e 74 65 72 20 69 6e 74 6f 20 74 68 65 20 55 54  nter into the UT
6490: 46 2d 31 36 20 73 74 72 69 6e 67 20 62 79 20 63  F-16 string by c
64a0: 6f 75 6e 74 69 6e 67 20 74 68 65 20 75 6e 69 63  ounting the unic
64b0: 6f 64 65 0a 20 20 20 20 2a 2a 20 63 68 61 72 61  ode.    ** chara
64c0: 63 74 65 72 73 20 62 65 74 77 65 65 6e 20 7a 53  cters between zS
64d0: 71 6c 38 20 61 6e 64 20 7a 54 61 69 6c 38 2c 20  ql8 and zTail8, 
64e0: 61 6e 64 20 74 68 65 6e 20 72 65 74 75 72 6e 69  and then returni
64f0: 6e 67 20 61 20 70 6f 69 6e 74 65 72 0a 20 20 20  ng a pointer.   
6500: 20 2a 2a 20 74 68 65 20 73 61 6d 65 20 6e 75 6d   ** the same num
6510: 62 65 72 20 6f 66 20 63 68 61 72 61 63 74 65 72  ber of character
6520: 73 20 69 6e 74 6f 20 74 68 65 20 55 54 46 2d 31  s into the UTF-1
6530: 36 20 73 74 72 69 6e 67 2e 0a 20 20 20 20 2a 2f  6 string..    */
6540: 0a 20 20 20 20 69 6e 74 20 63 68 61 72 73 5f 70  .    int chars_p
6550: 61 72 73 65 64 20 3d 20 73 71 6c 69 74 65 33 55  arsed = sqlite3U
6560: 74 66 38 43 68 61 72 4c 65 6e 28 7a 53 71 6c 38  tf8CharLen(zSql8
6570: 2c 20 28 69 6e 74 29 28 7a 54 61 69 6c 38 2d 7a  , (int)(zTail8-z
6580: 53 71 6c 38 29 29 3b 0a 20 20 20 20 2a 70 7a 54  Sql8));.    *pzT
6590: 61 69 6c 20 3d 20 28 75 38 20 2a 29 7a 53 71 6c  ail = (u8 *)zSql
65a0: 20 2b 20 73 71 6c 69 74 65 33 55 74 66 31 36 42   + sqlite3Utf16B
65b0: 79 74 65 4c 65 6e 28 7a 53 71 6c 2c 20 63 68 61  yteLen(zSql, cha
65c0: 72 73 5f 70 61 72 73 65 64 29 3b 0a 20 20 7d 0a  rs_parsed);.  }.
65d0: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28    sqlite3DbFree(
65e0: 64 62 2c 20 7a 53 71 6c 38 29 3b 20 0a 20 20 72  db, zSql8); .  r
65f0: 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78  c = sqlite3ApiEx
6600: 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71  it(db, rc);.  sq
6610: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
6620: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  e(db->mutex);.  
6630: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
6640: 0a 2a 2a 20 54 77 6f 20 76 65 72 73 69 6f 6e 73  .** Two versions
6650: 20 6f 66 20 74 68 65 20 6f 66 66 69 63 69 61 6c   of the official
6660: 20 41 50 49 2e 20 20 4c 65 67 61 63 79 20 61 6e   API.  Legacy an
6670: 64 20 6e 65 77 20 75 73 65 2e 20 20 49 6e 20 74  d new use.  In t
6680: 68 65 20 6c 65 67 61 63 79 0a 2a 2a 20 76 65 72  he legacy.** ver
6690: 73 69 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69 6e  sion, the origin
66a0: 61 6c 20 53 51 4c 20 74 65 78 74 20 69 73 20 6e  al SQL text is n
66b0: 6f 74 20 73 61 76 65 64 20 69 6e 20 74 68 65 20  ot saved in the 
66c0: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  prepared stateme
66d0: 6e 74 0a 2a 2a 20 61 6e 64 20 73 6f 20 69 66 20  nt.** and so if 
66e0: 61 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 20  a schema change 
66f0: 6f 63 63 75 72 73 2c 20 53 51 4c 49 54 45 5f 53  occurs, SQLITE_S
6700: 43 48 45 4d 41 20 69 73 20 72 65 74 75 72 6e 65  CHEMA is returne
6710: 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f  d by.** sqlite3_
6720: 73 74 65 70 28 29 2e 20 20 49 6e 20 74 68 65 20  step().  In the 
6730: 6e 65 77 20 76 65 72 73 69 6f 6e 2c 20 74 68 65  new version, the
6740: 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 20 74 65   original SQL te
6750: 78 74 20 69 73 20 72 65 74 61 69 6e 65 64 0a 2a  xt is retained.*
6760: 2a 20 61 6e 64 20 74 68 65 20 73 74 61 74 65 6d  * and the statem
6770: 65 6e 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63  ent is automatic
6780: 61 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65 64 20  ally recompiled 
6790: 69 66 20 61 6e 20 73 63 68 65 6d 61 20 63 68 61  if an schema cha
67a0: 6e 67 65 0a 2a 2a 20 6f 63 63 75 72 73 2e 0a 2a  nge.** occurs..*
67b0: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72  /.int sqlite3_pr
67c0: 65 70 61 72 65 31 36 28 0a 20 20 73 71 6c 69 74  epare16(.  sqlit
67d0: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  e3 *db,         
67e0: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
67f0: 20 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63   handle. */ .  c
6800: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c  onst void *zSql,
6810: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d           /* UTF-
6820: 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  8 encoded SQL st
6830: 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e  atement. */.  in
6840: 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20  t nBytes,       
6850: 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74          /* Lengt
6860: 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74  h of zSql in byt
6870: 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  es. */.  sqlite3
6880: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
6890: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69     /* OUT: A poi
68a0: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70  nter to the prep
68b0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a  ared statement *
68c0: 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  /.  const void *
68d0: 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a  *pzTail       /*
68e0: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72   OUT: End of par
68f0: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b  sed string */.){
6900: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20  .  int rc;.  rc 
6910: 3d 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65  = sqlite3Prepare
6920: 31 36 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65  16(db,zSql,nByte
6930: 73 2c 30 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69  s,0,ppStmt,pzTai
6940: 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63  l);.  assert( rc
6950: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70  ==SQLITE_OK || p
6960: 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53  pStmt==0 || *ppS
6970: 74 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45  tmt==0 );  /* VE
6980: 52 49 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a  RIFY: F13021 */.
6990: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69    return rc;.}.i
69a0: 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61  nt sqlite3_prepa
69b0: 72 65 31 36 5f 76 32 28 0a 20 20 73 71 6c 69 74  re16_v2(.  sqlit
69c0: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  e3 *db,         
69d0: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
69e0: 20 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63   handle. */ .  c
69f0: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c  onst void *zSql,
6a00: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d           /* UTF-
6a10: 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  8 encoded SQL st
6a20: 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e  atement. */.  in
6a30: 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20  t nBytes,       
6a40: 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74          /* Lengt
6a50: 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74  h of zSql in byt
6a60: 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  es. */.  sqlite3
6a70: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
6a80: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69     /* OUT: A poi
6a90: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70  nter to the prep
6aa0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a  ared statement *
6ab0: 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  /.  const void *
6ac0: 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a  *pzTail       /*
6ad0: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72   OUT: End of par
6ae0: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b  sed string */.){
6af0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20  .  int rc;.  rc 
6b00: 3d 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65  = sqlite3Prepare
6b10: 31 36 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65  16(db,zSql,nByte
6b20: 73 2c 31 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69  s,1,ppStmt,pzTai
6b30: 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63  l);.  assert( rc
6b40: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70  ==SQLITE_OK || p
6b50: 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53  pStmt==0 || *ppS
6b60: 74 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45  tmt==0 );  /* VE
6b70: 52 49 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a  RIFY: F13021 */.
6b80: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
6b90: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
6ba0: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a     _OMIT_UTF16 */.