/ Hex Artifact Content
Login

Artifact 498b3bf76a508dc201f90c3e619f597630b1870bdce77eef2dbd380542a4a232:


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 2f 0a 23 69  from disk..*/.#i
0210: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e  nclude "sqliteIn
0220: 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 46 69 6c 6c  t.h"../*.** Fill
0230: 20 74 68 65 20 49 6e 69 74 44 61 74 61 20 73 74   the InitData st
0240: 72 75 63 74 75 72 65 20 77 69 74 68 20 61 6e 20  ructure with an 
0250: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 74 68  error message th
0260: 61 74 20 69 6e 64 69 63 61 74 65 73 0a 2a 2a 20  at indicates.** 
0270: 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 73  that the databas
0280: 65 20 69 73 20 63 6f 72 72 75 70 74 2e 0a 2a 2f  e is corrupt..*/
0290: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 6f 72  .static void cor
02a0: 72 75 70 74 53 63 68 65 6d 61 28 0a 20 20 49 6e  ruptSchema(.  In
02b0: 69 74 44 61 74 61 20 2a 70 44 61 74 61 2c 20 20  itData *pData,  
02c0: 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c 69 7a 61     /* Initializa
02d0: 74 69 6f 6e 20 63 6f 6e 74 65 78 74 20 2a 2f 0a  tion context */.
02e0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4f    const char *zO
02f0: 62 6a 2c 20 20 20 20 2f 2a 20 4f 62 6a 65 63 74  bj,    /* Object
0300: 20 62 65 69 6e 67 20 70 61 72 73 65 64 20 61 74   being parsed at
0310: 20 74 68 65 20 70 6f 69 6e 74 20 6f 66 20 65 72   the point of er
0320: 72 6f 72 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  ror */.  const c
0330: 68 61 72 20 2a 7a 45 78 74 72 61 20 20 20 2f 2a  har *zExtra   /*
0340: 20 45 72 72 6f 72 20 69 6e 66 6f 72 6d 61 74 69   Error informati
0350: 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74  on */.){.  sqlit
0360: 65 33 20 2a 64 62 20 3d 20 70 44 61 74 61 2d 3e  e3 *db = pData->
0370: 64 62 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61  db;.  if( db->ma
0380: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20  llocFailed ){.  
0390: 20 20 70 44 61 74 61 2d 3e 72 63 20 3d 20 53 51    pData->rc = SQ
03a0: 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b  LITE_NOMEM_BKPT;
03b0: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 44 61  .  }else if( pDa
03c0: 74 61 2d 3e 70 7a 45 72 72 4d 73 67 5b 30 5d 21  ta->pzErrMsg[0]!
03d0: 3d 30 20 29 7b 0a 20 20 20 20 2f 2a 20 41 20 65  =0 ){.    /* A e
03e0: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 68 61 73  rror message has
03f0: 20 61 6c 72 65 61 64 79 20 62 65 65 6e 20 67 65   already been ge
0400: 6e 65 72 61 74 65 64 2e 20 20 44 6f 20 6e 6f 74  nerated.  Do not
0410: 20 6f 76 65 72 77 72 69 74 65 20 69 74 20 2a 2f   overwrite it */
0420: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 44 61  .  }else if( pDa
0430: 74 61 2d 3e 6d 49 6e 69 74 46 6c 61 67 73 20 26  ta->mInitFlags &
0440: 20 49 4e 49 54 46 4c 41 47 5f 41 6c 74 65 72 54   INITFLAG_AlterT
0450: 61 62 6c 65 20 29 7b 0a 20 20 20 20 2a 70 44 61  able ){.    *pDa
0460: 74 61 2d 3e 70 7a 45 72 72 4d 73 67 20 3d 20 73  ta->pzErrMsg = s
0470: 71 6c 69 74 65 33 44 62 53 74 72 44 75 70 28 64  qlite3DbStrDup(d
0480: 62 2c 20 7a 45 78 74 72 61 29 3b 0a 20 20 20 20  b, zExtra);.    
0490: 70 44 61 74 61 2d 3e 72 63 20 3d 20 53 51 4c 49  pData->rc = SQLI
04a0: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 65 6c 73  TE_ERROR;.  }els
04b0: 65 20 69 66 28 20 64 62 2d 3e 66 6c 61 67 73 20  e if( db->flags 
04c0: 26 20 53 51 4c 49 54 45 5f 57 72 69 74 65 53 63  & SQLITE_WriteSc
04d0: 68 65 6d 61 20 29 7b 0a 20 20 20 20 70 44 61 74  hema ){.    pDat
04e0: 61 2d 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 43  a->rc = SQLITE_C
04f0: 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a 20 20 7d  ORRUPT_BKPT;.  }
0500: 65 6c 73 65 7b 0a 20 20 20 20 63 68 61 72 20 2a  else{.    char *
0510: 7a 3b 0a 20 20 20 20 69 66 28 20 7a 4f 62 6a 3d  z;.    if( zObj=
0520: 3d 30 20 29 20 7a 4f 62 6a 20 3d 20 22 3f 22 3b  =0 ) zObj = "?";
0530: 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33  .    z = sqlite3
0540: 4d 50 72 69 6e 74 66 28 64 62 2c 20 22 6d 61 6c  MPrintf(db, "mal
0550: 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 20  formed database 
0560: 73 63 68 65 6d 61 20 28 25 73 29 22 2c 20 7a 4f  schema (%s)", zO
0570: 62 6a 29 3b 0a 20 20 20 20 69 66 28 20 7a 45 78  bj);.    if( zEx
0580: 74 72 61 20 26 26 20 7a 45 78 74 72 61 5b 30 5d  tra && zExtra[0]
0590: 20 29 20 7a 20 3d 20 73 71 6c 69 74 65 33 4d 50   ) z = sqlite3MP
05a0: 72 69 6e 74 66 28 64 62 2c 20 22 25 7a 20 2d 20  rintf(db, "%z - 
05b0: 25 73 22 2c 20 7a 2c 20 7a 45 78 74 72 61 29 3b  %s", z, zExtra);
05c0: 0a 20 20 20 20 2a 70 44 61 74 61 2d 3e 70 7a 45  .    *pData->pzE
05d0: 72 72 4d 73 67 20 3d 20 7a 3b 0a 20 20 20 20 70  rrMsg = z;.    p
05e0: 44 61 74 61 2d 3e 72 63 20 3d 20 53 51 4c 49 54  Data->rc = SQLIT
05f0: 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50 54 3b 0a  E_CORRUPT_BKPT;.
0600: 20 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69    }.}../*.** Thi
0610: 73 20 69 73 20 74 68 65 20 63 61 6c 6c 62 61 63  s is the callbac
0620: 6b 20 72 6f 75 74 69 6e 65 20 66 6f 72 20 74 68  k routine for th
0630: 65 20 63 6f 64 65 20 74 68 61 74 20 69 6e 69 74  e code that init
0640: 69 61 6c 69 7a 65 73 20 74 68 65 0a 2a 2a 20 64  ializes the.** d
0650: 61 74 61 62 61 73 65 2e 20 20 53 65 65 20 73 71  atabase.  See sq
0660: 6c 69 74 65 33 49 6e 69 74 28 29 20 62 65 6c 6f  lite3Init() belo
0670: 77 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  w for additional
0680: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a 2a   information..**
0690: 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73   This routine is
06a0: 20 61 6c 73 6f 20 63 61 6c 6c 65 64 20 66 72 6f   also called fro
06b0: 6d 20 74 68 65 20 4f 50 5f 50 61 72 73 65 53 63  m the OP_ParseSc
06c0: 68 65 6d 61 20 6f 70 63 6f 64 65 20 6f 66 20 74  hema opcode of t
06d0: 68 65 20 56 44 42 45 2e 0a 2a 2a 0a 2a 2a 20 45  he VDBE..**.** E
06e0: 61 63 68 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6e  ach callback con
06f0: 74 61 69 6e 73 20 74 68 65 20 66 6f 6c 6c 6f 77  tains the follow
0700: 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a  ing information:
0710: 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b  .**.**     argv[
0720: 30 5d 20 3d 20 6e 61 6d 65 20 6f 66 20 74 68 69  0] = name of thi
0730: 6e 67 20 62 65 69 6e 67 20 63 72 65 61 74 65 64  ng being created
0740: 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 31 5d 20  .**     argv[1] 
0750: 3d 20 72 6f 6f 74 20 70 61 67 65 20 6e 75 6d 62  = root page numb
0760: 65 72 20 66 6f 72 20 74 61 62 6c 65 20 6f 72 20  er for table or 
0770: 69 6e 64 65 78 2e 20 30 20 66 6f 72 20 74 72 69  index. 0 for tri
0780: 67 67 65 72 20 6f 72 20 76 69 65 77 2e 0a 2a 2a  gger or view..**
0790: 20 20 20 20 20 61 72 67 76 5b 32 5d 20 3d 20 53       argv[2] = S
07a0: 51 4c 20 74 65 78 74 20 66 6f 72 20 74 68 65 20  QL text for the 
07b0: 43 52 45 41 54 45 20 73 74 61 74 65 6d 65 6e 74  CREATE statement
07c0: 2e 0a 2a 2a 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69  ..**.*/.int sqli
07d0: 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28  te3InitCallback(
07e0: 76 6f 69 64 20 2a 70 49 6e 69 74 2c 20 69 6e 74  void *pInit, int
07f0: 20 61 72 67 63 2c 20 63 68 61 72 20 2a 2a 61 72   argc, char **ar
0800: 67 76 2c 20 63 68 61 72 20 2a 2a 4e 6f 74 55 73  gv, char **NotUs
0810: 65 64 29 7b 0a 20 20 49 6e 69 74 44 61 74 61 20  ed){.  InitData 
0820: 2a 70 44 61 74 61 20 3d 20 28 49 6e 69 74 44 61  *pData = (InitDa
0830: 74 61 2a 29 70 49 6e 69 74 3b 0a 20 20 73 71 6c  ta*)pInit;.  sql
0840: 69 74 65 33 20 2a 64 62 20 3d 20 70 44 61 74 61  ite3 *db = pData
0850: 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 69 44 62 20  ->db;.  int iDb 
0860: 3d 20 70 44 61 74 61 2d 3e 69 44 62 3b 0a 0a 20  = pData->iDb;.. 
0870: 20 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d 33   assert( argc==3
0880: 20 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 52   );.  UNUSED_PAR
0890: 41 4d 45 54 45 52 32 28 4e 6f 74 55 73 65 64 2c  AMETER2(NotUsed,
08a0: 20 61 72 67 63 29 3b 0a 20 20 61 73 73 65 72 74   argc);.  assert
08b0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
08c0: 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20  held(db->mutex) 
08d0: 29 3b 0a 20 20 44 62 43 6c 65 61 72 50 72 6f 70  );.  DbClearProp
08e0: 65 72 74 79 28 64 62 2c 20 69 44 62 2c 20 44 42  erty(db, iDb, DB
08f0: 5f 45 6d 70 74 79 29 3b 0a 20 20 69 66 28 20 64  _Empty);.  if( d
0900: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20  b->mallocFailed 
0910: 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53 63  ){.    corruptSc
0920: 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67 76  hema(pData, argv
0930: 5b 30 5d 2c 20 30 29 3b 0a 20 20 20 20 72 65 74  [0], 0);.    ret
0940: 75 72 6e 20 31 3b 0a 20 20 7d 0a 0a 20 20 61 73  urn 1;.  }..  as
0950: 73 65 72 74 28 20 69 44 62 3e 3d 30 20 26 26 20  sert( iDb>=0 && 
0960: 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20  iDb<db->nDb );. 
0970: 20 69 66 28 20 61 72 67 76 3d 3d 30 20 29 20 72   if( argv==0 ) r
0980: 65 74 75 72 6e 20 30 3b 20 20 20 2f 2a 20 4d 69  eturn 0;   /* Mi
0990: 67 68 74 20 68 61 70 70 65 6e 20 69 66 20 45 4d  ght happen if EM
09a0: 50 54 59 5f 52 45 53 55 4c 54 5f 43 41 4c 4c 42  PTY_RESULT_CALLB
09b0: 41 43 4b 53 20 61 72 65 20 6f 6e 20 2a 2f 0a 20  ACKS are on */. 
09c0: 20 69 66 28 20 61 72 67 76 5b 31 5d 3d 3d 30 20   if( argv[1]==0 
09d0: 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53 63  ){.    corruptSc
09e0: 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67 76  hema(pData, argv
09f0: 5b 30 5d 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65  [0], 0);.  }else
0a00: 20 69 66 28 20 73 71 6c 69 74 65 33 5f 73 74 72   if( sqlite3_str
0a10: 6e 69 63 6d 70 28 61 72 67 76 5b 32 5d 2c 22 63  nicmp(argv[2],"c
0a20: 72 65 61 74 65 20 22 2c 37 29 3d 3d 30 20 29 7b  reate ",7)==0 ){
0a30: 0a 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74 68 65  .    /* Call the
0a40: 20 70 61 72 73 65 72 20 74 6f 20 70 72 6f 63 65   parser to proce
0a50: 73 73 20 61 20 43 52 45 41 54 45 20 54 41 42 4c  ss a CREATE TABL
0a60: 45 2c 20 49 4e 44 45 58 20 6f 72 20 56 49 45 57  E, INDEX or VIEW
0a70: 2e 0a 20 20 20 20 2a 2a 20 42 75 74 20 62 65 63  ..    ** But bec
0a80: 61 75 73 65 20 64 62 2d 3e 69 6e 69 74 2e 62 75  ause db->init.bu
0a90: 73 79 20 69 73 20 73 65 74 20 74 6f 20 31 2c 20  sy is set to 1, 
0aa0: 6e 6f 20 56 44 42 45 20 63 6f 64 65 20 69 73 20  no VDBE code is 
0ab0: 67 65 6e 65 72 61 74 65 64 0a 20 20 20 20 2a 2a  generated.    **
0ac0: 20 6f 72 20 65 78 65 63 75 74 65 64 2e 20 20 41   or executed.  A
0ad0: 6c 6c 20 74 68 65 20 70 61 72 73 65 72 20 64 6f  ll the parser do
0ae0: 65 73 20 69 73 20 62 75 69 6c 64 20 74 68 65 20  es is build the 
0af0: 69 6e 74 65 72 6e 61 6c 20 64 61 74 61 0a 20 20  internal data.  
0b00: 20 20 2a 2a 20 73 74 72 75 63 74 75 72 65 73 20    ** structures 
0b10: 74 68 61 74 20 64 65 73 63 72 69 62 65 20 74 68  that describe th
0b20: 65 20 74 61 62 6c 65 2c 20 69 6e 64 65 78 2c 20  e table, index, 
0b30: 6f 72 20 76 69 65 77 2e 0a 20 20 20 20 2a 2f 0a  or view..    */.
0b40: 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 20      int rc;.    
0b50: 75 38 20 73 61 76 65 64 5f 69 44 62 20 3d 20 64  u8 saved_iDb = d
0b60: 62 2d 3e 69 6e 69 74 2e 69 44 62 3b 0a 20 20 20  b->init.iDb;.   
0b70: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70   sqlite3_stmt *p
0b80: 53 74 6d 74 3b 0a 20 20 20 20 54 45 53 54 4f 4e  Stmt;.    TESTON
0b90: 4c 59 28 69 6e 74 20 72 63 70 29 3b 20 20 20 20  LY(int rcp);    
0ba0: 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 72          /* Retur
0bb0: 6e 20 63 6f 64 65 20 66 72 6f 6d 20 73 71 6c 69  n code from sqli
0bc0: 74 65 33 5f 70 72 65 70 61 72 65 28 29 20 2a 2f  te3_prepare() */
0bd0: 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 64 62  ..    assert( db
0be0: 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20  ->init.busy );. 
0bf0: 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69 44 62 20     db->init.iDb 
0c00: 3d 20 69 44 62 3b 0a 20 20 20 20 64 62 2d 3e 69  = iDb;.    db->i
0c10: 6e 69 74 2e 6e 65 77 54 6e 75 6d 20 3d 20 73 71  nit.newTnum = sq
0c20: 6c 69 74 65 33 41 74 6f 69 28 61 72 67 76 5b 31  lite3Atoi(argv[1
0c30: 5d 29 3b 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74  ]);.    db->init
0c40: 2e 6f 72 70 68 61 6e 54 72 69 67 67 65 72 20 3d  .orphanTrigger =
0c50: 20 30 3b 0a 20 20 20 20 54 45 53 54 4f 4e 4c 59   0;.    TESTONLY
0c60: 28 72 63 70 20 3d 20 29 20 73 71 6c 69 74 65 33  (rcp = ) sqlite3
0c70: 5f 70 72 65 70 61 72 65 28 64 62 2c 20 61 72 67  _prepare(db, arg
0c80: 76 5b 32 5d 2c 20 2d 31 2c 20 26 70 53 74 6d 74  v[2], -1, &pStmt
0c90: 2c 20 30 29 3b 0a 20 20 20 20 72 63 20 3d 20 64  , 0);.    rc = d
0ca0: 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 20 20  b->errCode;.    
0cb0: 61 73 73 65 72 74 28 20 28 72 63 26 30 78 46 46  assert( (rc&0xFF
0cc0: 29 3d 3d 28 72 63 70 26 30 78 46 46 29 20 29 3b  )==(rcp&0xFF) );
0cd0: 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69 44  .    db->init.iD
0ce0: 62 20 3d 20 73 61 76 65 64 5f 69 44 62 3b 0a 20  b = saved_iDb;. 
0cf0: 20 20 20 2f 2a 20 61 73 73 65 72 74 28 20 73 61     /* assert( sa
0d00: 76 65 64 5f 69 44 62 3d 3d 30 20 7c 7c 20 28 64  ved_iDb==0 || (d
0d10: 62 2d 3e 6d 44 62 46 6c 61 67 73 20 26 20 44 42  b->mDbFlags & DB
0d20: 46 4c 41 47 5f 56 61 63 75 75 6d 29 21 3d 30 20  FLAG_Vacuum)!=0 
0d30: 29 3b 20 2a 2f 0a 20 20 20 20 69 66 28 20 53 51  ); */.    if( SQ
0d40: 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 7b 0a 20  LITE_OK!=rc ){. 
0d50: 20 20 20 20 20 69 66 28 20 64 62 2d 3e 69 6e 69       if( db->ini
0d60: 74 2e 6f 72 70 68 61 6e 54 72 69 67 67 65 72 20  t.orphanTrigger 
0d70: 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72  ){.        asser
0d80: 74 28 20 69 44 62 3d 3d 31 20 29 3b 0a 20 20 20  t( iDb==1 );.   
0d90: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20     }else{.      
0da0: 20 20 70 44 61 74 61 2d 3e 72 63 20 3d 20 72 63    pData->rc = rc
0db0: 3b 0a 20 20 20 20 20 20 20 20 69 66 28 20 72 63  ;.        if( rc
0dc0: 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29  ==SQLITE_NOMEM )
0dd0: 7b 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69  {.          sqli
0de0: 74 65 33 4f 6f 6d 46 61 75 6c 74 28 64 62 29 3b  te3OomFault(db);
0df0: 0a 20 20 20 20 20 20 20 20 7d 65 6c 73 65 20 69  .        }else i
0e00: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 49 4e  f( rc!=SQLITE_IN
0e10: 54 45 52 52 55 50 54 20 26 26 20 28 72 63 26 30  TERRUPT && (rc&0
0e20: 78 46 46 29 21 3d 53 51 4c 49 54 45 5f 4c 4f 43  xFF)!=SQLITE_LOC
0e30: 4b 45 44 20 29 7b 0a 20 20 20 20 20 20 20 20 20  KED ){.         
0e40: 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70   corruptSchema(p
0e50: 44 61 74 61 2c 20 61 72 67 76 5b 30 5d 2c 20 73  Data, argv[0], s
0e60: 71 6c 69 74 65 33 5f 65 72 72 6d 73 67 28 64 62  qlite3_errmsg(db
0e70: 29 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20  ));.        }.  
0e80: 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20      }.    }.    
0e90: 73 71 6c 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65  sqlite3_finalize
0ea0: 28 70 53 74 6d 74 29 3b 0a 20 20 7d 65 6c 73 65  (pStmt);.  }else
0eb0: 20 69 66 28 20 61 72 67 76 5b 30 5d 3d 3d 30 20   if( argv[0]==0 
0ec0: 7c 7c 20 28 61 72 67 76 5b 32 5d 21 3d 30 20 26  || (argv[2]!=0 &
0ed0: 26 20 61 72 67 76 5b 32 5d 5b 30 5d 21 3d 30 29  & argv[2][0]!=0)
0ee0: 20 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53   ){.    corruptS
0ef0: 63 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67  chema(pData, arg
0f00: 76 5b 30 5d 2c 20 30 29 3b 0a 20 20 7d 65 6c 73  v[0], 0);.  }els
0f10: 65 7b 0a 20 20 20 20 2f 2a 20 49 66 20 74 68 65  e{.    /* If the
0f20: 20 53 51 4c 20 63 6f 6c 75 6d 6e 20 69 73 20 62   SQL column is b
0f30: 6c 61 6e 6b 20 69 74 20 6d 65 61 6e 73 20 74 68  lank it means th
0f40: 69 73 20 69 73 20 61 6e 20 69 6e 64 65 78 20 74  is is an index t
0f50: 68 61 74 0a 20 20 20 20 2a 2a 20 77 61 73 20 63  hat.    ** was c
0f60: 72 65 61 74 65 64 20 74 6f 20 62 65 20 74 68 65  reated to be the
0f70: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 72 20   PRIMARY KEY or 
0f80: 74 6f 20 66 75 6c 66 69 6c 6c 20 61 20 55 4e 49  to fulfill a UNI
0f90: 51 55 45 0a 20 20 20 20 2a 2a 20 63 6f 6e 73 74  QUE.    ** const
0fa0: 72 61 69 6e 74 20 66 6f 72 20 61 20 43 52 45 41  raint for a CREA
0fb0: 54 45 20 54 41 42 4c 45 2e 20 20 54 68 65 20 69  TE TABLE.  The i
0fc0: 6e 64 65 78 20 73 68 6f 75 6c 64 20 68 61 76 65  ndex should have
0fd0: 20 61 6c 72 65 61 64 79 0a 20 20 20 20 2a 2a 20   already.    ** 
0fe0: 62 65 65 6e 20 63 72 65 61 74 65 64 20 77 68 65  been created whe
0ff0: 6e 20 77 65 20 70 72 6f 63 65 73 73 65 64 20 74  n we processed t
1000: 68 65 20 43 52 45 41 54 45 20 54 41 42 4c 45 2e  he CREATE TABLE.
1010: 20 20 41 6c 6c 20 77 65 20 68 61 76 65 0a 20 20    All we have.  
1020: 20 20 2a 2a 20 74 6f 20 64 6f 20 68 65 72 65 20    ** to do here 
1030: 69 73 20 72 65 63 6f 72 64 20 74 68 65 20 72 6f  is record the ro
1040: 6f 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 66  ot page number f
1050: 6f 72 20 74 68 61 74 20 69 6e 64 65 78 2e 0a 20  or that index.. 
1060: 20 20 20 2a 2f 0a 20 20 20 20 49 6e 64 65 78 20     */.    Index 
1070: 2a 70 49 6e 64 65 78 3b 0a 20 20 20 20 70 49 6e  *pIndex;.    pIn
1080: 64 65 78 20 3d 20 73 71 6c 69 74 65 33 46 69 6e  dex = sqlite3Fin
1090: 64 49 6e 64 65 78 28 64 62 2c 20 61 72 67 76 5b  dIndex(db, argv[
10a0: 30 5d 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d  0], db->aDb[iDb]
10b0: 2e 7a 44 62 53 4e 61 6d 65 29 3b 0a 20 20 20 20  .zDbSName);.    
10c0: 69 66 28 20 70 49 6e 64 65 78 3d 3d 30 20 29 7b  if( pIndex==0 ){
10d0: 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 73 20 63  .      /* This c
10e0: 61 6e 20 6f 63 63 75 72 20 69 66 20 74 68 65 72  an occur if ther
10f0: 65 20 65 78 69 73 74 73 20 61 6e 20 69 6e 64 65  e exists an inde
1100: 78 20 6f 6e 20 61 20 54 45 4d 50 20 74 61 62 6c  x on a TEMP tabl
1110: 65 20 77 68 69 63 68 0a 20 20 20 20 20 20 2a 2a  e which.      **
1120: 20 68 61 73 20 74 68 65 20 73 61 6d 65 20 6e 61   has the same na
1130: 6d 65 20 61 73 20 61 6e 6f 74 68 65 72 20 69 6e  me as another in
1140: 64 65 78 20 6f 6e 20 61 20 70 65 72 6d 61 6e 65  dex on a permane
1150: 6e 74 20 69 6e 64 65 78 2e 20 20 53 69 6e 63 65  nt index.  Since
1160: 0a 20 20 20 20 20 20 2a 2a 20 74 68 65 20 70 65  .      ** the pe
1170: 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65 20 69 73  rmanent table is
1180: 20 68 69 64 64 65 6e 20 62 79 20 74 68 65 20 54   hidden by the T
1190: 45 4d 50 20 74 61 62 6c 65 2c 20 77 65 20 63 61  EMP table, we ca
11a0: 6e 20 61 6c 73 6f 0a 20 20 20 20 20 20 2a 2a 20  n also.      ** 
11b0: 73 61 66 65 6c 79 20 69 67 6e 6f 72 65 20 74 68  safely ignore th
11c0: 65 20 69 6e 64 65 78 20 6f 6e 20 74 68 65 20 70  e index on the p
11d0: 65 72 6d 61 6e 65 6e 74 20 74 61 62 6c 65 2e 0a  ermanent table..
11e0: 20 20 20 20 20 20 2a 2f 0a 20 20 20 20 20 20 2f        */.      /
11f0: 2a 20 44 6f 20 4e 6f 74 68 69 6e 67 20 2a 2f 3b  * Do Nothing */;
1200: 0a 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 73  .    }else if( s
1210: 71 6c 69 74 65 33 47 65 74 49 6e 74 33 32 28 61  qlite3GetInt32(a
1220: 72 67 76 5b 31 5d 2c 20 26 70 49 6e 64 65 78 2d  rgv[1], &pIndex-
1230: 3e 74 6e 75 6d 29 3d 3d 30 20 29 7b 0a 20 20 20  >tnum)==0 ){.   
1240: 20 20 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61     corruptSchema
1250: 28 70 44 61 74 61 2c 20 61 72 67 76 5b 30 5d 2c  (pData, argv[0],
1260: 20 22 69 6e 76 61 6c 69 64 20 72 6f 6f 74 70 61   "invalid rootpa
1270: 67 65 22 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  ge");.    }.  }.
1280: 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f    return 0;.}../
1290: 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20  *.** Attempt to 
12a0: 72 65 61 64 20 74 68 65 20 64 61 74 61 62 61 73  read the databas
12b0: 65 20 73 63 68 65 6d 61 20 61 6e 64 20 69 6e 69  e schema and ini
12c0: 74 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e 61 6c  tialize internal
12d0: 0a 2a 2a 20 64 61 74 61 20 73 74 72 75 63 74 75  .** data structu
12e0: 72 65 73 20 66 6f 72 20 61 20 73 69 6e 67 6c 65  res for a single
12f0: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20   database file. 
1300: 20 54 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68   The index of th
1310: 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69  e.** database fi
1320: 6c 65 20 69 73 20 67 69 76 65 6e 20 62 79 20 69  le is given by i
1330: 44 62 2e 20 20 69 44 62 3d 3d 30 20 69 73 20 75  Db.  iDb==0 is u
1340: 73 65 64 20 66 6f 72 20 74 68 65 20 6d 61 69 6e  sed for the main
1350: 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 20 69  .** database.  i
1360: 44 62 3d 3d 31 20 73 68 6f 75 6c 64 20 6e 65 76  Db==1 should nev
1370: 65 72 20 62 65 20 75 73 65 64 2e 20 20 69 44 62  er be used.  iDb
1380: 3e 3d 32 20 69 73 20 75 73 65 64 20 66 6f 72 0a  >=2 is used for.
1390: 2a 2a 20 61 75 78 69 6c 69 61 72 79 20 64 61 74  ** auxiliary dat
13a0: 61 62 61 73 65 73 2e 20 20 52 65 74 75 72 6e 20  abases.  Return 
13b0: 6f 6e 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54  one of the SQLIT
13c0: 45 5f 20 65 72 72 6f 72 20 63 6f 64 65 73 20 74  E_ error codes t
13d0: 6f 0a 2a 2a 20 69 6e 64 69 63 61 74 65 20 73 75  o.** indicate su
13e0: 63 63 65 73 73 20 6f 72 20 66 61 69 6c 75 72 65  ccess or failure
13f0: 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33  ..*/.int sqlite3
1400: 49 6e 69 74 4f 6e 65 28 73 71 6c 69 74 65 33 20  InitOne(sqlite3 
1410: 2a 64 62 2c 20 69 6e 74 20 69 44 62 2c 20 63 68  *db, int iDb, ch
1420: 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 2c 20 75  ar **pzErrMsg, u
1430: 33 32 20 6d 46 6c 61 67 73 29 7b 0a 20 20 69 6e  32 mFlags){.  in
1440: 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 3b 0a 23  t rc;.  int i;.#
1450: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
1460: 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 20 20  IT_DEPRECATED.  
1470: 69 6e 74 20 73 69 7a 65 3b 0a 23 65 6e 64 69 66  int size;.#endif
1480: 0a 20 20 44 62 20 2a 70 44 62 3b 0a 20 20 63 68  .  Db *pDb;.  ch
1490: 61 72 20 63 6f 6e 73 74 20 2a 61 7a 41 72 67 5b  ar const *azArg[
14a0: 34 5d 3b 0a 20 20 69 6e 74 20 6d 65 74 61 5b 35  4];.  int meta[5
14b0: 5d 3b 0a 20 20 49 6e 69 74 44 61 74 61 20 69 6e  ];.  InitData in
14c0: 69 74 44 61 74 61 3b 0a 20 20 63 6f 6e 73 74 20  itData;.  const 
14d0: 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 4e 61 6d  char *zMasterNam
14e0: 65 3b 0a 20 20 69 6e 74 20 6f 70 65 6e 65 64 54  e;.  int openedT
14f0: 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 30 3b 0a  ransaction = 0;.
1500: 0a 20 20 61 73 73 65 72 74 28 20 28 64 62 2d 3e  .  assert( (db->
1510: 6d 44 62 46 6c 61 67 73 20 26 20 44 42 46 4c 41  mDbFlags & DBFLA
1520: 47 5f 53 63 68 65 6d 61 4b 6e 6f 77 6e 4f 6b 29  G_SchemaKnownOk)
1530: 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ==0 );.  assert(
1540: 20 69 44 62 3e 3d 30 20 26 26 20 69 44 62 3c 64   iDb>=0 && iDb<d
1550: 62 2d 3e 6e 44 62 20 29 3b 0a 20 20 61 73 73 65  b->nDb );.  asse
1560: 72 74 28 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d  rt( db->aDb[iDb]
1570: 2e 70 53 63 68 65 6d 61 20 29 3b 0a 20 20 61 73  .pSchema );.  as
1580: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
1590: 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74  tex_held(db->mut
15a0: 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28  ex) );.  assert(
15b0: 20 69 44 62 3d 3d 31 20 7c 7c 20 73 71 6c 69 74   iDb==1 || sqlit
15c0: 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65  e3BtreeHoldsMute
15d0: 78 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70  x(db->aDb[iDb].p
15e0: 42 74 29 20 29 3b 0a 0a 20 20 64 62 2d 3e 69 6e  Bt) );..  db->in
15f0: 69 74 2e 62 75 73 79 20 3d 20 31 3b 0a 0a 20 20  it.busy = 1;..  
1600: 2f 2a 20 43 6f 6e 73 74 72 75 63 74 20 74 68 65  /* Construct the
1610: 20 69 6e 2d 6d 65 6d 6f 72 79 20 72 65 70 72 65   in-memory repre
1620: 73 65 6e 74 61 74 69 6f 6e 20 73 63 68 65 6d 61  sentation schema
1630: 20 74 61 62 6c 65 73 20 28 73 71 6c 69 74 65 5f   tables (sqlite_
1640: 6d 61 73 74 65 72 20 6f 72 0a 20 20 2a 2a 20 73  master or.  ** s
1650: 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65  qlite_temp_maste
1660: 72 29 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 74  r) by invoking t
1670: 68 65 20 70 61 72 73 65 72 20 64 69 72 65 63 74  he parser direct
1680: 6c 79 2e 20 20 54 68 65 20 61 70 70 72 6f 70 72  ly.  The appropr
1690: 69 61 74 65 0a 20 20 2a 2a 20 74 61 62 6c 65 20  iate.  ** table 
16a0: 6e 61 6d 65 20 77 69 6c 6c 20 62 65 20 69 6e 73  name will be ins
16b0: 65 72 74 65 64 20 61 75 74 6f 6d 61 74 69 63 61  erted automatica
16c0: 6c 6c 79 20 62 79 20 74 68 65 20 70 61 72 73 65  lly by the parse
16d0: 72 20 73 6f 20 77 65 20 63 61 6e 20 6a 75 73 74  r so we can just
16e0: 0a 20 20 2a 2a 20 75 73 65 20 74 68 65 20 61 62  .  ** use the ab
16f0: 62 72 65 76 69 61 74 69 6f 6e 20 22 78 22 20 68  breviation "x" h
1700: 65 72 65 2e 20 20 54 68 65 20 70 61 72 73 65 72  ere.  The parser
1710: 20 77 69 6c 6c 20 61 6c 73 6f 20 61 75 74 6f 6d   will also autom
1720: 61 74 69 63 61 6c 6c 79 20 74 61 67 0a 20 20 2a  atically tag.  *
1730: 2a 20 74 68 65 20 73 63 68 65 6d 61 20 74 61 62  * the schema tab
1740: 6c 65 20 61 73 20 72 65 61 64 2d 6f 6e 6c 79 2e  le as read-only.
1750: 20 2a 2f 0a 20 20 61 7a 41 72 67 5b 30 5d 20 3d   */.  azArg[0] =
1760: 20 7a 4d 61 73 74 65 72 4e 61 6d 65 20 3d 20 53   zMasterName = S
1770: 43 48 45 4d 41 5f 54 41 42 4c 45 28 69 44 62 29  CHEMA_TABLE(iDb)
1780: 3b 0a 20 20 61 7a 41 72 67 5b 31 5d 20 3d 20 22  ;.  azArg[1] = "
1790: 31 22 3b 0a 20 20 61 7a 41 72 67 5b 32 5d 20 3d  1";.  azArg[2] =
17a0: 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 20 78   "CREATE TABLE x
17b0: 28 74 79 70 65 20 74 65 78 74 2c 6e 61 6d 65 20  (type text,name 
17c0: 74 65 78 74 2c 74 62 6c 5f 6e 61 6d 65 20 74 65  text,tbl_name te
17d0: 78 74 2c 22 0a 20 20 20 20 20 20 20 20 20 20 20  xt,".           
17e0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
17f0: 20 22 72 6f 6f 74 70 61 67 65 20 69 6e 74 2c 73   "rootpage int,s
1800: 71 6c 20 74 65 78 74 29 22 3b 0a 20 20 61 7a 41  ql text)";.  azA
1810: 72 67 5b 33 5d 20 3d 20 30 3b 0a 20 20 69 6e 69  rg[3] = 0;.  ini
1820: 74 44 61 74 61 2e 64 62 20 3d 20 64 62 3b 0a 20  tData.db = db;. 
1830: 20 69 6e 69 74 44 61 74 61 2e 69 44 62 20 3d 20   initData.iDb = 
1840: 69 44 62 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e  iDb;.  initData.
1850: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a  rc = SQLITE_OK;.
1860: 20 20 69 6e 69 74 44 61 74 61 2e 70 7a 45 72 72    initData.pzErr
1870: 4d 73 67 20 3d 20 70 7a 45 72 72 4d 73 67 3b 0a  Msg = pzErrMsg;.
1880: 20 20 69 6e 69 74 44 61 74 61 2e 6d 49 6e 69 74    initData.mInit
1890: 46 6c 61 67 73 20 3d 20 6d 46 6c 61 67 73 3b 0a  Flags = mFlags;.
18a0: 20 20 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c    sqlite3InitCal
18b0: 6c 62 61 63 6b 28 26 69 6e 69 74 44 61 74 61 2c  lback(&initData,
18c0: 20 33 2c 20 28 63 68 61 72 20 2a 2a 29 61 7a 41   3, (char **)azA
18d0: 72 67 2c 20 30 29 3b 0a 20 20 69 66 28 20 69 6e  rg, 0);.  if( in
18e0: 69 74 44 61 74 61 2e 72 63 20 29 7b 0a 20 20 20  itData.rc ){.   
18f0: 20 72 63 20 3d 20 69 6e 69 74 44 61 74 61 2e 72   rc = initData.r
1900: 63 3b 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f  c;.    goto erro
1910: 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  r_out;.  }..  /*
1920: 20 43 72 65 61 74 65 20 61 20 63 75 72 73 6f 72   Create a cursor
1930: 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 64 61 74   to hold the dat
1940: 61 62 61 73 65 20 6f 70 65 6e 0a 20 20 2a 2f 0a  abase open.  */.
1950: 20 20 70 44 62 20 3d 20 26 64 62 2d 3e 61 44 62    pDb = &db->aDb
1960: 5b 69 44 62 5d 3b 0a 20 20 69 66 28 20 70 44 62  [iDb];.  if( pDb
1970: 2d 3e 70 42 74 3d 3d 30 20 29 7b 0a 20 20 20 20  ->pBt==0 ){.    
1980: 61 73 73 65 72 74 28 20 69 44 62 3d 3d 31 20 29  assert( iDb==1 )
1990: 3b 0a 20 20 20 20 44 62 53 65 74 50 72 6f 70 65  ;.    DbSetPrope
19a0: 72 74 79 28 64 62 2c 20 31 2c 20 44 42 5f 53 63  rty(db, 1, DB_Sc
19b0: 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 20 20  hemaLoaded);.   
19c0: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
19d0: 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f  .    goto error_
19e0: 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 49  out;.  }..  /* I
19f0: 66 20 74 68 65 72 65 20 69 73 20 6e 6f 74 20 61  f there is not a
1a00: 6c 72 65 61 64 79 20 61 20 72 65 61 64 2d 6f 6e  lready a read-on
1a10: 6c 79 20 28 6f 72 20 72 65 61 64 2d 77 72 69 74  ly (or read-writ
1a20: 65 29 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f  e) transaction o
1a30: 70 65 6e 65 64 0a 20 20 2a 2a 20 6f 6e 20 74 68  pened.  ** on th
1a40: 65 20 62 2d 74 72 65 65 20 64 61 74 61 62 61 73  e b-tree databas
1a50: 65 2c 20 6f 70 65 6e 20 6f 6e 65 20 6e 6f 77 2e  e, open one now.
1a60: 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f   If a transactio
1a70: 6e 20 69 73 20 6f 70 65 6e 65 64 2c 20 69 74 20  n is opened, it 
1a80: 0a 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20 63 6c  .  ** will be cl
1a90: 6f 73 65 64 20 62 65 66 6f 72 65 20 74 68 69 73  osed before this
1aa0: 20 66 75 6e 63 74 69 6f 6e 20 72 65 74 75 72 6e   function return
1ab0: 73 2e 20 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  s.  */.  sqlite3
1ac0: 42 74 72 65 65 45 6e 74 65 72 28 70 44 62 2d 3e  BtreeEnter(pDb->
1ad0: 70 42 74 29 3b 0a 20 20 69 66 28 20 21 73 71 6c  pBt);.  if( !sql
1ae0: 69 74 65 33 42 74 72 65 65 49 73 49 6e 52 65 61  ite3BtreeIsInRea
1af0: 64 54 72 61 6e 73 28 70 44 62 2d 3e 70 42 74 29  dTrans(pDb->pBt)
1b00: 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c   ){.    rc = sql
1b10: 69 74 65 33 42 74 72 65 65 42 65 67 69 6e 54 72  ite3BtreeBeginTr
1b20: 61 6e 73 28 70 44 62 2d 3e 70 42 74 2c 20 30 2c  ans(pDb->pBt, 0,
1b30: 20 30 29 3b 0a 20 20 20 20 69 66 28 20 72 63 21   0);.    if( rc!
1b40: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
1b50: 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74      sqlite3SetSt
1b60: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 64  ring(pzErrMsg, d
1b70: 62 2c 20 73 71 6c 69 74 65 33 45 72 72 53 74 72  b, sqlite3ErrStr
1b80: 28 72 63 29 29 3b 0a 20 20 20 20 20 20 67 6f 74  (rc));.      got
1b90: 6f 20 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f  o initone_error_
1ba0: 6f 75 74 3b 0a 20 20 20 20 7d 0a 20 20 20 20 6f  out;.    }.    o
1bb0: 70 65 6e 65 64 54 72 61 6e 73 61 63 74 69 6f 6e  penedTransaction
1bc0: 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20   = 1;.  }..  /* 
1bd0: 47 65 74 20 74 68 65 20 64 61 74 61 62 61 73 65  Get the database
1be0: 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61 74 69 6f   meta informatio
1bf0: 6e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4d 65 74  n..  **.  ** Met
1c00: 61 20 76 61 6c 75 65 73 20 61 72 65 20 61 73 20  a values are as 
1c10: 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a 2a 20 20 20  follows:.  **   
1c20: 20 6d 65 74 61 5b 30 5d 20 20 20 53 63 68 65 6d   meta[0]   Schem
1c30: 61 20 63 6f 6f 6b 69 65 2e 20 20 43 68 61 6e 67  a cookie.  Chang
1c40: 65 73 20 77 69 74 68 20 65 61 63 68 20 73 63 68  es with each sch
1c50: 65 6d 61 20 63 68 61 6e 67 65 2e 0a 20 20 2a 2a  ema change..  **
1c60: 20 20 20 20 6d 65 74 61 5b 31 5d 20 20 20 46 69      meta[1]   Fi
1c70: 6c 65 20 66 6f 72 6d 61 74 20 6f 66 20 73 63 68  le format of sch
1c80: 65 6d 61 20 6c 61 79 65 72 2e 0a 20 20 2a 2a 20  ema layer..  ** 
1c90: 20 20 20 6d 65 74 61 5b 32 5d 20 20 20 53 69 7a     meta[2]   Siz
1ca0: 65 20 6f 66 20 74 68 65 20 70 61 67 65 20 63 61  e of the page ca
1cb0: 63 68 65 2e 0a 20 20 2a 2a 20 20 20 20 6d 65 74  che..  **    met
1cc0: 61 5b 33 5d 20 20 20 4c 61 72 67 65 73 74 20 72  a[3]   Largest r
1cd0: 6f 6f 74 70 61 67 65 20 28 61 75 74 6f 2f 69 6e  ootpage (auto/in
1ce0: 63 72 5f 76 61 63 75 75 6d 20 6d 6f 64 65 29 0a  cr_vacuum mode).
1cf0: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 34 5d 20    **    meta[4] 
1d00: 20 20 44 62 20 74 65 78 74 20 65 6e 63 6f 64 69    Db text encodi
1d10: 6e 67 2e 20 31 3a 55 54 46 2d 38 20 32 3a 55 54  ng. 1:UTF-8 2:UT
1d20: 46 2d 31 36 4c 45 20 33 3a 55 54 46 2d 31 36 42  F-16LE 3:UTF-16B
1d30: 45 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 35  E.  **    meta[5
1d40: 5d 20 20 20 55 73 65 72 20 76 65 72 73 69 6f 6e  ]   User version
1d50: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 36 5d  .  **    meta[6]
1d60: 20 20 20 49 6e 63 72 65 6d 65 6e 74 61 6c 20 76     Incremental v
1d70: 61 63 75 75 6d 20 6d 6f 64 65 0a 20 20 2a 2a 20  acuum mode.  ** 
1d80: 20 20 20 6d 65 74 61 5b 37 5d 20 20 20 75 6e 75     meta[7]   unu
1d90: 73 65 64 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61  sed.  **    meta
1da0: 5b 38 5d 20 20 20 75 6e 75 73 65 64 0a 20 20 2a  [8]   unused.  *
1db0: 2a 20 20 20 20 6d 65 74 61 5b 39 5d 20 20 20 75  *    meta[9]   u
1dc0: 6e 75 73 65 64 0a 20 20 2a 2a 0a 20 20 2a 2a 20  nused.  **.  ** 
1dd0: 4e 6f 74 65 3a 20 54 68 65 20 23 64 65 66 69 6e  Note: The #defin
1de0: 65 64 20 53 51 4c 49 54 45 5f 55 54 46 2a 20 73  ed SQLITE_UTF* s
1df0: 79 6d 62 6f 6c 73 20 69 6e 20 73 71 6c 69 74 65  ymbols in sqlite
1e00: 49 6e 74 2e 68 20 63 6f 72 72 65 73 70 6f 6e 64  Int.h correspond
1e10: 20 74 6f 0a 20 20 2a 2a 20 74 68 65 20 70 6f 73   to.  ** the pos
1e20: 73 69 62 6c 65 20 76 61 6c 75 65 73 20 6f 66 20  sible values of 
1e30: 6d 65 74 61 5b 34 5d 2e 0a 20 20 2a 2f 0a 20 20  meta[4]..  */.  
1e40: 66 6f 72 28 69 3d 30 3b 20 69 3c 41 72 72 61 79  for(i=0; i<Array
1e50: 53 69 7a 65 28 6d 65 74 61 29 3b 20 69 2b 2b 29  Size(meta); i++)
1e60: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72  {.    sqlite3Btr
1e70: 65 65 47 65 74 4d 65 74 61 28 70 44 62 2d 3e 70  eeGetMeta(pDb->p
1e80: 42 74 2c 20 69 2b 31 2c 20 28 75 33 32 20 2a 29  Bt, i+1, (u32 *)
1e90: 26 6d 65 74 61 5b 69 5d 29 3b 0a 20 20 7d 0a 20  &meta[i]);.  }. 
1ea0: 20 69 66 28 20 28 64 62 2d 3e 66 6c 61 67 73 20   if( (db->flags 
1eb0: 26 20 53 51 4c 49 54 45 5f 52 65 73 65 74 44 61  & SQLITE_ResetDa
1ec0: 74 61 62 61 73 65 29 21 3d 30 20 29 7b 0a 20 20  tabase)!=0 ){.  
1ed0: 20 20 6d 65 6d 73 65 74 28 6d 65 74 61 2c 20 30    memset(meta, 0
1ee0: 2c 20 73 69 7a 65 6f 66 28 6d 65 74 61 29 29 3b  , sizeof(meta));
1ef0: 0a 20 20 7d 0a 20 20 70 44 62 2d 3e 70 53 63 68  .  }.  pDb->pSch
1f00: 65 6d 61 2d 3e 73 63 68 65 6d 61 5f 63 6f 6f 6b  ema->schema_cook
1f10: 69 65 20 3d 20 6d 65 74 61 5b 42 54 52 45 45 5f  ie = meta[BTREE_
1f20: 53 43 48 45 4d 41 5f 56 45 52 53 49 4f 4e 2d 31  SCHEMA_VERSION-1
1f30: 5d 3b 0a 0a 20 20 2f 2a 20 49 66 20 6f 70 65 6e  ];..  /* If open
1f40: 69 6e 67 20 61 20 6e 6f 6e 2d 65 6d 70 74 79 20  ing a non-empty 
1f50: 64 61 74 61 62 61 73 65 2c 20 63 68 65 63 6b 20  database, check 
1f60: 74 68 65 20 74 65 78 74 20 65 6e 63 6f 64 69 6e  the text encodin
1f70: 67 2e 20 46 6f 72 20 74 68 65 0a 20 20 2a 2a 20  g. For the.  ** 
1f80: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2c 20 73  main database, s
1f90: 65 74 20 73 71 6c 69 74 65 33 2e 65 6e 63 20 74  et sqlite3.enc t
1fa0: 6f 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6f  o the encoding o
1fb0: 66 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62  f the main datab
1fc0: 61 73 65 2e 0a 20 20 2a 2a 20 46 6f 72 20 61 6e  ase..  ** For an
1fd0: 20 61 74 74 61 63 68 65 64 20 64 62 2c 20 69 74   attached db, it
1fe0: 20 69 73 20 61 6e 20 65 72 72 6f 72 20 69 66 20   is an error if 
1ff0: 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 69 73 20  the encoding is 
2000: 6e 6f 74 20 74 68 65 20 73 61 6d 65 0a 20 20 2a  not the same.  *
2010: 2a 20 61 73 20 73 71 6c 69 74 65 33 2e 65 6e 63  * as sqlite3.enc
2020: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6d 65 74  ..  */.  if( met
2030: 61 5b 42 54 52 45 45 5f 54 45 58 54 5f 45 4e 43  a[BTREE_TEXT_ENC
2040: 4f 44 49 4e 47 2d 31 5d 20 29 7b 20 20 2f 2a 20  ODING-1] ){  /* 
2050: 74 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 2a 2f  text encoding */
2060: 0a 20 20 20 20 69 66 28 20 69 44 62 3d 3d 30 20  .    if( iDb==0 
2070: 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54  ){.#ifndef SQLIT
2080: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 20 20 20  E_OMIT_UTF16.   
2090: 20 20 20 75 38 20 65 6e 63 6f 64 69 6e 67 3b 0a     u8 encoding;.
20a0: 20 20 20 20 20 20 2f 2a 20 49 66 20 6f 70 65 6e        /* If open
20b0: 69 6e 67 20 74 68 65 20 6d 61 69 6e 20 64 61 74  ing the main dat
20c0: 61 62 61 73 65 2c 20 73 65 74 20 45 4e 43 28 64  abase, set ENC(d
20d0: 62 29 2e 20 2a 2f 0a 20 20 20 20 20 20 65 6e 63  b). */.      enc
20e0: 6f 64 69 6e 67 20 3d 20 28 75 38 29 6d 65 74 61  oding = (u8)meta
20f0: 5b 42 54 52 45 45 5f 54 45 58 54 5f 45 4e 43 4f  [BTREE_TEXT_ENCO
2100: 44 49 4e 47 2d 31 5d 20 26 20 33 3b 0a 20 20 20  DING-1] & 3;.   
2110: 20 20 20 69 66 28 20 65 6e 63 6f 64 69 6e 67 3d     if( encoding=
2120: 3d 30 20 29 20 65 6e 63 6f 64 69 6e 67 20 3d 20  =0 ) encoding = 
2130: 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 20 20 20  SQLITE_UTF8;.   
2140: 20 20 20 45 4e 43 28 64 62 29 20 3d 20 65 6e 63     ENC(db) = enc
2150: 6f 64 69 6e 67 3b 0a 23 65 6c 73 65 0a 20 20 20  oding;.#else.   
2160: 20 20 20 45 4e 43 28 64 62 29 20 3d 20 53 51 4c     ENC(db) = SQL
2170: 49 54 45 5f 55 54 46 38 3b 0a 23 65 6e 64 69 66  ITE_UTF8;.#endif
2180: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  .    }else{.    
2190: 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67 20    /* If opening 
21a0: 61 6e 20 61 74 74 61 63 68 65 64 20 64 61 74 61  an attached data
21b0: 62 61 73 65 2c 20 74 68 65 20 65 6e 63 6f 64 69  base, the encodi
21c0: 6e 67 20 6d 75 63 68 20 6d 61 74 63 68 20 45 4e  ng much match EN
21d0: 43 28 64 62 29 20 2a 2f 0a 20 20 20 20 20 20 69  C(db) */.      i
21e0: 66 28 20 6d 65 74 61 5b 42 54 52 45 45 5f 54 45  f( meta[BTREE_TE
21f0: 58 54 5f 45 4e 43 4f 44 49 4e 47 2d 31 5d 21 3d  XT_ENCODING-1]!=
2200: 45 4e 43 28 64 62 29 20 29 7b 0a 20 20 20 20 20  ENC(db) ){.     
2210: 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72     sqlite3SetStr
2220: 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 64 62  ing(pzErrMsg, db
2230: 2c 20 22 61 74 74 61 63 68 65 64 20 64 61 74 61  , "attached data
2240: 62 61 73 65 73 20 6d 75 73 74 20 75 73 65 20 74  bases must use t
2250: 68 65 20 73 61 6d 65 22 0a 20 20 20 20 20 20 20  he same".       
2260: 20 20 20 20 20 22 20 74 65 78 74 20 65 6e 63 6f       " text enco
2270: 64 69 6e 67 20 61 73 20 6d 61 69 6e 20 64 61 74  ding as main dat
2280: 61 62 61 73 65 22 29 3b 0a 20 20 20 20 20 20 20  abase");.       
2290: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52   rc = SQLITE_ERR
22a0: 4f 52 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f  OR;.        goto
22b0: 20 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f   initone_error_o
22c0: 75 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20  ut;.      }.    
22d0: 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 44  }.  }else{.    D
22e0: 62 53 65 74 50 72 6f 70 65 72 74 79 28 64 62 2c  bSetProperty(db,
22f0: 20 69 44 62 2c 20 44 42 5f 45 6d 70 74 79 29 3b   iDb, DB_Empty);
2300: 0a 20 20 7d 0a 20 20 70 44 62 2d 3e 70 53 63 68  .  }.  pDb->pSch
2310: 65 6d 61 2d 3e 65 6e 63 20 3d 20 45 4e 43 28 64  ema->enc = ENC(d
2320: 62 29 3b 0a 0a 20 20 69 66 28 20 70 44 62 2d 3e  b);..  if( pDb->
2330: 70 53 63 68 65 6d 61 2d 3e 63 61 63 68 65 5f 73  pSchema->cache_s
2340: 69 7a 65 3d 3d 30 20 29 7b 0a 23 69 66 6e 64 65  ize==0 ){.#ifnde
2350: 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45  f SQLITE_OMIT_DE
2360: 50 52 45 43 41 54 45 44 0a 20 20 20 20 73 69 7a  PRECATED.    siz
2370: 65 20 3d 20 73 71 6c 69 74 65 33 41 62 73 49 6e  e = sqlite3AbsIn
2380: 74 33 32 28 6d 65 74 61 5b 42 54 52 45 45 5f 44  t32(meta[BTREE_D
2390: 45 46 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a  EFAULT_CACHE_SIZ
23a0: 45 2d 31 5d 29 3b 0a 20 20 20 20 69 66 28 20 73  E-1]);.    if( s
23b0: 69 7a 65 3d 3d 30 20 29 7b 20 73 69 7a 65 20 3d  ize==0 ){ size =
23c0: 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f   SQLITE_DEFAULT_
23d0: 43 41 43 48 45 5f 53 49 5a 45 3b 20 7d 0a 20 20  CACHE_SIZE; }.  
23e0: 20 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e    pDb->pSchema->
23f0: 63 61 63 68 65 5f 73 69 7a 65 20 3d 20 73 69 7a  cache_size = siz
2400: 65 3b 0a 23 65 6c 73 65 0a 20 20 20 20 70 44 62  e;.#else.    pDb
2410: 2d 3e 70 53 63 68 65 6d 61 2d 3e 63 61 63 68 65  ->pSchema->cache
2420: 5f 73 69 7a 65 20 3d 20 53 51 4c 49 54 45 5f 44  _size = SQLITE_D
2430: 45 46 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a  EFAULT_CACHE_SIZ
2440: 45 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71  E;.#endif.    sq
2450: 6c 69 74 65 33 42 74 72 65 65 53 65 74 43 61 63  lite3BtreeSetCac
2460: 68 65 53 69 7a 65 28 70 44 62 2d 3e 70 42 74 2c  heSize(pDb->pBt,
2470: 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 63   pDb->pSchema->c
2480: 61 63 68 65 5f 73 69 7a 65 29 3b 0a 20 20 7d 0a  ache_size);.  }.
2490: 0a 20 20 2f 2a 0a 20 20 2a 2a 20 66 69 6c 65 5f  .  /*.  ** file_
24a0: 66 6f 72 6d 61 74 3d 3d 31 20 20 20 20 56 65 72  format==1    Ver
24b0: 73 69 6f 6e 20 33 2e 30 2e 30 2e 0a 20 20 2a 2a  sion 3.0.0..  **
24c0: 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 32 20   file_format==2 
24d0: 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 31 2e 33     Version 3.1.3
24e0: 2e 20 20 2f 2f 20 41 4c 54 45 52 20 54 41 42 4c  .  // ALTER TABL
24f0: 45 20 41 44 44 20 43 4f 4c 55 4d 4e 0a 20 20 2a  E ADD COLUMN.  *
2500: 2a 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 33  * file_format==3
2510: 20 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 31 2e      Version 3.1.
2520: 34 2e 20 20 2f 2f 20 64 69 74 74 6f 20 62 75 74  4.  // ditto but
2530: 20 77 69 74 68 20 6e 6f 6e 2d 4e 55 4c 4c 20 64   with non-NULL d
2540: 65 66 61 75 6c 74 73 0a 20 20 2a 2a 20 66 69 6c  efaults.  ** fil
2550: 65 5f 66 6f 72 6d 61 74 3d 3d 34 20 20 20 20 56  e_format==4    V
2560: 65 72 73 69 6f 6e 20 33 2e 33 2e 30 2e 20 20 2f  ersion 3.3.0.  /
2570: 2f 20 44 45 53 43 20 69 6e 64 69 63 65 73 2e 20  / DESC indices. 
2580: 20 42 6f 6f 6c 65 61 6e 20 63 6f 6e 73 74 61 6e   Boolean constan
2590: 74 73 0a 20 20 2a 2f 0a 20 20 70 44 62 2d 3e 70  ts.  */.  pDb->p
25a0: 53 63 68 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f 72  Schema->file_for
25b0: 6d 61 74 20 3d 20 28 75 38 29 6d 65 74 61 5b 42  mat = (u8)meta[B
25c0: 54 52 45 45 5f 46 49 4c 45 5f 46 4f 52 4d 41 54  TREE_FILE_FORMAT
25d0: 2d 31 5d 3b 0a 20 20 69 66 28 20 70 44 62 2d 3e  -1];.  if( pDb->
25e0: 70 53 63 68 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f  pSchema->file_fo
25f0: 72 6d 61 74 3d 3d 30 20 29 7b 0a 20 20 20 20 70  rmat==0 ){.    p
2600: 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69 6c  Db->pSchema->fil
2610: 65 5f 66 6f 72 6d 61 74 20 3d 20 31 3b 0a 20 20  e_format = 1;.  
2620: 7d 0a 20 20 69 66 28 20 70 44 62 2d 3e 70 53 63  }.  if( pDb->pSc
2630: 68 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61  hema->file_forma
2640: 74 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 46 49 4c  t>SQLITE_MAX_FIL
2650: 45 5f 46 4f 52 4d 41 54 20 29 7b 0a 20 20 20 20  E_FORMAT ){.    
2660: 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67  sqlite3SetString
2670: 28 70 7a 45 72 72 4d 73 67 2c 20 64 62 2c 20 22  (pzErrMsg, db, "
2680: 75 6e 73 75 70 70 6f 72 74 65 64 20 66 69 6c 65  unsupported file
2690: 20 66 6f 72 6d 61 74 22 29 3b 0a 20 20 20 20 72   format");.    r
26a0: 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52  c = SQLITE_ERROR
26b0: 3b 0a 20 20 20 20 67 6f 74 6f 20 69 6e 69 74 6f  ;.    goto inito
26c0: 6e 65 5f 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20  ne_error_out;.  
26d0: 7d 0a 0a 20 20 2f 2a 20 54 69 63 6b 65 74 20 23  }..  /* Ticket #
26e0: 32 38 30 34 3a 20 20 57 68 65 6e 20 77 65 20 6f  2804:  When we o
26f0: 70 65 6e 20 61 20 64 61 74 61 62 61 73 65 20 69  pen a database i
2700: 6e 20 74 68 65 20 6e 65 77 65 72 20 66 69 6c 65  n the newer file
2710: 20 66 6f 72 6d 61 74 2c 0a 20 20 2a 2a 20 63 6c   format,.  ** cl
2720: 65 61 72 20 74 68 65 20 6c 65 67 61 63 79 5f 66  ear the legacy_f
2730: 69 6c 65 5f 66 6f 72 6d 61 74 20 70 72 61 67 6d  ile_format pragm
2740: 61 20 66 6c 61 67 20 73 6f 20 74 68 61 74 20 61  a flag so that a
2750: 20 56 41 43 55 55 4d 20 77 69 6c 6c 0a 20 20 2a   VACUUM will.  *
2760: 2a 20 6e 6f 74 20 64 6f 77 6e 67 72 61 64 65 20  * not downgrade 
2770: 74 68 65 20 64 61 74 61 62 61 73 65 20 61 6e 64  the database and
2780: 20 74 68 75 73 20 69 6e 76 61 6c 69 64 61 74 65   thus invalidate
2790: 20 61 6e 79 20 64 65 73 63 65 6e 64 69 6e 67 0a   any descending.
27a0: 20 20 2a 2a 20 69 6e 64 69 63 65 73 20 74 68 61    ** indices tha
27b0: 74 20 74 68 65 20 75 73 65 72 20 6d 69 67 68 74  t the user might
27c0: 20 68 61 76 65 20 63 72 65 61 74 65 64 2e 0a 20   have created.. 
27d0: 20 2a 2f 0a 20 20 69 66 28 20 69 44 62 3d 3d 30   */.  if( iDb==0
27e0: 20 26 26 20 6d 65 74 61 5b 42 54 52 45 45 5f 46   && meta[BTREE_F
27f0: 49 4c 45 5f 46 4f 52 4d 41 54 2d 31 5d 3e 3d 34  ILE_FORMAT-1]>=4
2800: 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c 61 67   ){.    db->flag
2810: 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 4c 65 67  s &= ~SQLITE_Leg
2820: 61 63 79 46 69 6c 65 46 6d 74 3b 0a 20 20 7d 0a  acyFileFmt;.  }.
2830: 0a 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 73  .  /* Read the s
2840: 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f  chema informatio
2850: 6e 20 6f 75 74 20 6f 66 20 74 68 65 20 73 63 68  n out of the sch
2860: 65 6d 61 20 74 61 62 6c 65 73 0a 20 20 2a 2f 0a  ema tables.  */.
2870: 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e    assert( db->in
2880: 69 74 2e 62 75 73 79 20 29 3b 0a 20 20 7b 0a 20  it.busy );.  {. 
2890: 20 20 20 63 68 61 72 20 2a 7a 53 71 6c 3b 0a 20     char *zSql;. 
28a0: 20 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74 65     zSql = sqlite
28b0: 33 4d 50 72 69 6e 74 66 28 64 62 2c 20 0a 20 20  3MPrintf(db, .  
28c0: 20 20 20 20 20 20 22 53 45 4c 45 43 54 20 6e 61        "SELECT na
28d0: 6d 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71  me, rootpage, sq
28e0: 6c 20 46 52 4f 4d 20 5c 22 25 77 5c 22 2e 25 73  l FROM \"%w\".%s
28f0: 20 4f 52 44 45 52 20 42 59 20 72 6f 77 69 64 22   ORDER BY rowid"
2900: 2c 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 61 44  ,.        db->aD
2910: 62 5b 69 44 62 5d 2e 7a 44 62 53 4e 61 6d 65 2c  b[iDb].zDbSName,
2920: 20 7a 4d 61 73 74 65 72 4e 61 6d 65 29 3b 0a 23   zMasterName);.#
2930: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
2940: 49 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e  IT_AUTHORIZATION
2950: 0a 20 20 20 20 7b 0a 20 20 20 20 20 20 73 71 6c  .    {.      sql
2960: 69 74 65 33 5f 78 61 75 74 68 20 78 41 75 74 68  ite3_xauth xAuth
2970: 3b 0a 20 20 20 20 20 20 78 41 75 74 68 20 3d 20  ;.      xAuth = 
2980: 64 62 2d 3e 78 41 75 74 68 3b 0a 20 20 20 20 20  db->xAuth;.     
2990: 20 64 62 2d 3e 78 41 75 74 68 20 3d 20 30 3b 0a   db->xAuth = 0;.
29a0: 23 65 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20  #endif.      rc 
29b0: 3d 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 64  = sqlite3_exec(d
29c0: 62 2c 20 7a 53 71 6c 2c 20 73 71 6c 69 74 65 33  b, zSql, sqlite3
29d0: 49 6e 69 74 43 61 6c 6c 62 61 63 6b 2c 20 26 69  InitCallback, &i
29e0: 6e 69 74 44 61 74 61 2c 20 30 29 3b 0a 23 69 66  nitData, 0);.#if
29f0: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
2a00: 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20  _AUTHORIZATION. 
2a10: 20 20 20 20 20 64 62 2d 3e 78 41 75 74 68 20 3d       db->xAuth =
2a20: 20 78 41 75 74 68 3b 0a 20 20 20 20 7d 0a 23 65   xAuth;.    }.#e
2a30: 6e 64 69 66 0a 20 20 20 20 69 66 28 20 72 63 3d  ndif.    if( rc=
2a40: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20  =SQLITE_OK ) rc 
2a50: 3d 20 69 6e 69 74 44 61 74 61 2e 72 63 3b 0a 20  = initData.rc;. 
2a60: 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65     sqlite3DbFree
2a70: 28 64 62 2c 20 7a 53 71 6c 29 3b 0a 23 69 66 6e  (db, zSql);.#ifn
2a80: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
2a90: 41 4e 41 4c 59 5a 45 0a 20 20 20 20 69 66 28 20  ANALYZE.    if( 
2aa0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
2ab0: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 41 6e  .      sqlite3An
2ac0: 61 6c 79 73 69 73 4c 6f 61 64 28 64 62 2c 20 69  alysisLoad(db, i
2ad0: 44 62 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69  Db);.    }.#endi
2ae0: 66 0a 20 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e  f.  }.  if( db->
2af0: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a  mallocFailed ){.
2b00: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
2b10: 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20  NOMEM_BKPT;.    
2b20: 73 71 6c 69 74 65 33 52 65 73 65 74 41 6c 6c 53  sqlite3ResetAllS
2b30: 63 68 65 6d 61 73 4f 66 43 6f 6e 6e 65 63 74 69  chemasOfConnecti
2b40: 6f 6e 28 64 62 29 3b 0a 20 20 7d 0a 20 20 69 66  on(db);.  }.  if
2b50: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
2b60: 7c 7c 20 28 64 62 2d 3e 66 6c 61 67 73 26 53 51  || (db->flags&SQ
2b70: 4c 49 54 45 5f 4e 6f 53 63 68 65 6d 61 45 72 72  LITE_NoSchemaErr
2b80: 6f 72 29 29 7b 0a 20 20 20 20 2f 2a 20 42 6c 61  or)){.    /* Bla
2b90: 63 6b 20 6d 61 67 69 63 3a 20 49 66 20 74 68 65  ck magic: If the
2ba0: 20 53 51 4c 49 54 45 5f 4e 6f 53 63 68 65 6d 61   SQLITE_NoSchema
2bb0: 45 72 72 6f 72 20 66 6c 61 67 20 69 73 20 73 65  Error flag is se
2bc0: 74 2c 20 74 68 65 6e 20 63 6f 6e 73 69 64 65 72  t, then consider
2bd0: 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 63 68 65  .    ** the sche
2be0: 6d 61 20 6c 6f 61 64 65 64 2c 20 65 76 65 6e 20  ma loaded, even 
2bf0: 69 66 20 65 72 72 6f 72 73 20 6f 63 63 75 72 72  if errors occurr
2c00: 65 64 2e 20 49 6e 20 74 68 69 73 20 73 69 74 75  ed. In this situ
2c10: 61 74 69 6f 6e 20 74 68 65 20 0a 20 20 20 20 2a  ation the .    *
2c20: 2a 20 63 75 72 72 65 6e 74 20 73 71 6c 69 74 65  * current sqlite
2c30: 33 5f 70 72 65 70 61 72 65 28 29 20 6f 70 65 72  3_prepare() oper
2c40: 61 74 69 6f 6e 20 77 69 6c 6c 20 66 61 69 6c 2c  ation will fail,
2c50: 20 62 75 74 20 74 68 65 20 66 6f 6c 6c 6f 77 69   but the followi
2c60: 6e 67 20 6f 6e 65 0a 20 20 20 20 2a 2a 20 77 69  ng one.    ** wi
2c70: 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 63 6f  ll attempt to co
2c80: 6d 70 69 6c 65 20 74 68 65 20 73 75 70 70 6c 69  mpile the suppli
2c90: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61 67 61  ed statement aga
2ca0: 69 6e 73 74 20 77 68 61 74 65 76 65 72 20 73 75  inst whatever su
2cb0: 62 73 65 74 0a 20 20 20 20 2a 2a 20 6f 66 20 74  bset.    ** of t
2cc0: 68 65 20 73 63 68 65 6d 61 20 77 61 73 20 6c 6f  he schema was lo
2cd0: 61 64 65 64 20 62 65 66 6f 72 65 20 74 68 65 20  aded before the 
2ce0: 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2e 20  error occurred. 
2cf0: 54 68 65 20 70 72 69 6d 61 72 79 0a 20 20 20 20  The primary.    
2d00: 2a 2a 20 70 75 72 70 6f 73 65 20 6f 66 20 74 68  ** purpose of th
2d10: 69 73 20 69 73 20 74 6f 20 61 6c 6c 6f 77 20 61  is is to allow a
2d20: 63 63 65 73 73 20 74 6f 20 74 68 65 20 73 71 6c  ccess to the sql
2d30: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65  ite_master table
2d40: 0a 20 20 20 20 2a 2a 20 65 76 65 6e 20 77 68 65  .    ** even whe
2d50: 6e 20 69 74 73 20 63 6f 6e 74 65 6e 74 73 20 68  n its contents h
2d60: 61 76 65 20 62 65 65 6e 20 63 6f 72 72 75 70 74  ave been corrupt
2d70: 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 44  ed..    */.    D
2d80: 62 53 65 74 50 72 6f 70 65 72 74 79 28 64 62 2c  bSetProperty(db,
2d90: 20 69 44 62 2c 20 44 42 5f 53 63 68 65 6d 61 4c   iDb, DB_SchemaL
2da0: 6f 61 64 65 64 29 3b 0a 20 20 20 20 72 63 20 3d  oaded);.    rc =
2db0: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a   SQLITE_OK;.  }.
2dc0: 0a 20 20 2f 2a 20 4a 75 6d 70 20 68 65 72 65 20  .  /* Jump here 
2dd0: 66 6f 72 20 61 6e 20 65 72 72 6f 72 20 74 68 61  for an error tha
2de0: 74 20 6f 63 63 75 72 73 20 61 66 74 65 72 20 73  t occurs after s
2df0: 75 63 63 65 73 73 66 75 6c 6c 79 20 61 6c 6c 6f  uccessfully allo
2e00: 63 61 74 69 6e 67 0a 20 20 2a 2a 20 63 75 72 4d  cating.  ** curM
2e10: 61 69 6e 20 61 6e 64 20 63 61 6c 6c 69 6e 67 20  ain and calling 
2e20: 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65  sqlite3BtreeEnte
2e30: 72 28 29 2e 20 46 6f 72 20 61 6e 20 65 72 72 6f  r(). For an erro
2e40: 72 20 74 68 61 74 20 6f 63 63 75 72 73 0a 20 20  r that occurs.  
2e50: 2a 2a 20 62 65 66 6f 72 65 20 74 68 61 74 20 70  ** before that p
2e60: 6f 69 6e 74 2c 20 6a 75 6d 70 20 74 6f 20 65 72  oint, jump to er
2e70: 72 6f 72 5f 6f 75 74 2e 0a 20 20 2a 2f 0a 69 6e  ror_out..  */.in
2e80: 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75 74 3a  itone_error_out:
2e90: 0a 20 20 69 66 28 20 6f 70 65 6e 65 64 54 72 61  .  if( openedTra
2ea0: 6e 73 61 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20  nsaction ){.    
2eb0: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d  sqlite3BtreeComm
2ec0: 69 74 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 20  it(pDb->pBt);.  
2ed0: 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65  }.  sqlite3Btree
2ee0: 4c 65 61 76 65 28 70 44 62 2d 3e 70 42 74 29 3b  Leave(pDb->pBt);
2ef0: 0a 0a 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 69  ..error_out:.  i
2f00: 66 28 20 72 63 20 29 7b 0a 20 20 20 20 69 66 28  f( rc ){.    if(
2f10: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45   rc==SQLITE_NOME
2f20: 4d 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f  M || rc==SQLITE_
2f30: 49 4f 45 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a 20  IOERR_NOMEM ){. 
2f40: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 6f 6d 46       sqlite3OomF
2f50: 61 75 6c 74 28 64 62 29 3b 0a 20 20 20 20 7d 0a  ault(db);.    }.
2f60: 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74      sqlite3Reset
2f70: 4f 6e 65 53 63 68 65 6d 61 28 64 62 2c 20 69 44  OneSchema(db, iD
2f80: 62 29 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 69 6e  b);.  }.  db->in
2f90: 69 74 2e 62 75 73 79 20 3d 20 30 3b 0a 20 20 72  it.busy = 0;.  r
2fa0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
2fb0: 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 61 6c  ** Initialize al
2fc0: 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73  l database files
2fd0: 20 2d 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61   - the main data
2fe0: 62 61 73 65 20 66 69 6c 65 2c 20 74 68 65 20 66  base file, the f
2ff0: 69 6c 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 73  ile.** used to s
3000: 74 6f 72 65 20 74 65 6d 70 6f 72 61 72 79 20 74  tore temporary t
3010: 61 62 6c 65 73 2c 20 61 6e 64 20 61 6e 79 20 61  ables, and any a
3020: 64 64 69 74 69 6f 6e 61 6c 20 64 61 74 61 62 61  dditional databa
3030: 73 65 20 66 69 6c 65 73 0a 2a 2a 20 63 72 65 61  se files.** crea
3040: 74 65 64 20 75 73 69 6e 67 20 41 54 54 41 43 48  ted using ATTACH
3050: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 52 65   statements.  Re
3060: 74 75 72 6e 20 61 20 73 75 63 63 65 73 73 20 63  turn a success c
3070: 6f 64 65 2e 20 20 49 66 20 61 6e 0a 2a 2a 20 65  ode.  If an.** e
3080: 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 77 72 69  rror occurs, wri
3090: 74 65 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73  te an error mess
30a0: 61 67 65 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d  age into *pzErrM
30b0: 73 67 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72 20  sg..**.** After 
30c0: 61 20 64 61 74 61 62 61 73 65 20 69 73 20 69 6e  a database is in
30d0: 69 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 44  itialized, the D
30e0: 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 20 62  B_SchemaLoaded b
30f0: 69 74 20 69 73 20 73 65 74 0a 2a 2a 20 62 69 74  it is set.** bit
3100: 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 66   is set in the f
3110: 6c 61 67 73 20 66 69 65 6c 64 20 6f 66 20 74 68  lags field of th
3120: 65 20 44 62 20 73 74 72 75 63 74 75 72 65 2e 20  e Db structure. 
3130: 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  If the database.
3140: 2a 2a 20 66 69 6c 65 20 77 61 73 20 6f 66 20 7a  ** file was of z
3150: 65 72 6f 2d 6c 65 6e 67 74 68 2c 20 74 68 65 6e  ero-length, then
3160: 20 74 68 65 20 44 42 5f 45 6d 70 74 79 20 66 6c   the DB_Empty fl
3170: 61 67 20 69 73 20 61 6c 73 6f 20 73 65 74 2e 0a  ag is also set..
3180: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e  */.int sqlite3In
3190: 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  it(sqlite3 *db, 
31a0: 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29  char **pzErrMsg)
31b0: 7b 0a 20 20 69 6e 74 20 69 2c 20 72 63 3b 0a 20  {.  int i, rc;. 
31c0: 20 69 6e 74 20 63 6f 6d 6d 69 74 5f 69 6e 74 65   int commit_inte
31d0: 72 6e 61 6c 20 3d 20 21 28 64 62 2d 3e 6d 44 62  rnal = !(db->mDb
31e0: 46 6c 61 67 73 26 44 42 46 4c 41 47 5f 53 63 68  Flags&DBFLAG_Sch
31f0: 65 6d 61 43 68 61 6e 67 65 29 3b 0a 20 20 0a 20  emaChange);.  . 
3200: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3210: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e  _mutex_held(db->
3220: 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65  mutex) );.  asse
3230: 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 65  rt( sqlite3Btree
3240: 48 6f 6c 64 73 4d 75 74 65 78 28 64 62 2d 3e 61  HoldsMutex(db->a
3250: 44 62 5b 30 5d 2e 70 42 74 29 20 29 3b 0a 20 20  Db[0].pBt) );.  
3260: 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e 69 74  assert( db->init
3270: 2e 62 75 73 79 3d 3d 30 20 29 3b 0a 20 20 45 4e  .busy==0 );.  EN
3280: 43 28 64 62 29 20 3d 20 53 43 48 45 4d 41 5f 45  C(db) = SCHEMA_E
3290: 4e 43 28 64 62 29 3b 0a 20 20 61 73 73 65 72 74  NC(db);.  assert
32a0: 28 20 64 62 2d 3e 6e 44 62 3e 30 20 29 3b 0a 20  ( db->nDb>0 );. 
32b0: 20 2f 2a 20 44 6f 20 74 68 65 20 6d 61 69 6e 20   /* Do the main 
32c0: 73 63 68 65 6d 61 20 66 69 72 73 74 20 2a 2f 0a  schema first */.
32d0: 20 20 69 66 28 20 21 44 62 48 61 73 50 72 6f 70    if( !DbHasProp
32e0: 65 72 74 79 28 64 62 2c 20 30 2c 20 44 42 5f 53  erty(db, 0, DB_S
32f0: 63 68 65 6d 61 4c 6f 61 64 65 64 29 20 29 7b 0a  chemaLoaded) ){.
3300: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
3310: 49 6e 69 74 4f 6e 65 28 64 62 2c 20 30 2c 20 70  InitOne(db, 0, p
3320: 7a 45 72 72 4d 73 67 2c 20 30 29 3b 0a 20 20 20  zErrMsg, 0);.   
3330: 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e   if( rc ) return
3340: 20 72 63 3b 0a 20 20 7d 0a 20 20 2f 2a 20 41 6c   rc;.  }.  /* Al
3350: 6c 20 6f 74 68 65 72 20 73 63 68 65 6d 61 73 20  l other schemas 
3360: 61 66 74 65 72 20 74 68 65 20 6d 61 69 6e 20 73  after the main s
3370: 63 68 65 6d 61 2e 20 54 68 65 20 22 74 65 6d 70  chema. The "temp
3380: 22 20 73 63 68 65 6d 61 20 6d 75 73 74 20 62 65  " schema must be
3390: 20 6c 61 73 74 20 2a 2f 0a 20 20 66 6f 72 28 69   last */.  for(i
33a0: 3d 64 62 2d 3e 6e 44 62 2d 31 3b 20 69 3e 30 3b  =db->nDb-1; i>0;
33b0: 20 69 2d 2d 29 7b 0a 20 20 20 20 61 73 73 65 72   i--){.    asser
33c0: 74 28 20 69 3d 3d 31 20 7c 7c 20 73 71 6c 69 74  t( i==1 || sqlit
33d0: 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65  e3BtreeHoldsMute
33e0: 78 28 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74  x(db->aDb[i].pBt
33f0: 29 20 29 3b 0a 20 20 20 20 69 66 28 20 21 44 62  ) );.    if( !Db
3400: 48 61 73 50 72 6f 70 65 72 74 79 28 64 62 2c 20  HasProperty(db, 
3410: 69 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64  i, DB_SchemaLoad
3420: 65 64 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20  ed) ){.      rc 
3430: 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65  = sqlite3InitOne
3440: 28 64 62 2c 20 69 2c 20 70 7a 45 72 72 4d 73 67  (db, i, pzErrMsg
3450: 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20  , 0);.      if( 
3460: 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a  rc ) return rc;.
3470: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20      }.  }.  if( 
3480: 63 6f 6d 6d 69 74 5f 69 6e 74 65 72 6e 61 6c 20  commit_internal 
3490: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f  ){.    sqlite3Co
34a0: 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e  mmitInternalChan
34b0: 67 65 73 28 64 62 29 3b 0a 20 20 7d 0a 20 20 72  ges(db);.  }.  r
34c0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
34d0: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
34e0: 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f  outine is a no-o
34f0: 70 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73  p if the databas
3500: 65 20 73 63 68 65 6d 61 20 69 73 20 61 6c 72 65  e schema is alre
3510: 61 64 79 20 69 6e 69 74 69 61 6c 69 7a 65 64 2e  ady initialized.
3520: 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 74  .** Otherwise, t
3530: 68 65 20 73 63 68 65 6d 61 20 69 73 20 6c 6f 61  he schema is loa
3540: 64 65 64 2e 20 41 6e 20 65 72 72 6f 72 20 63 6f  ded. An error co
3550: 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a  de is returned..
3560: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65  */.int sqlite3Re
3570: 61 64 53 63 68 65 6d 61 28 50 61 72 73 65 20 2a  adSchema(Parse *
3580: 70 50 61 72 73 65 29 7b 0a 20 20 69 6e 74 20 72  pParse){.  int r
3590: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
35a0: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70   sqlite3 *db = p
35b0: 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 61 73 73  Parse->db;.  ass
35c0: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
35d0: 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65  ex_held(db->mute
35e0: 78 29 20 29 3b 0a 20 20 69 66 28 20 21 64 62 2d  x) );.  if( !db-
35f0: 3e 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20 20  >init.busy ){.  
3600: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49 6e    rc = sqlite3In
3610: 69 74 28 64 62 2c 20 26 70 50 61 72 73 65 2d 3e  it(db, &pParse->
3620: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 69 66  zErrMsg);.    if
3630: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
3640: 29 7b 0a 20 20 20 20 20 20 70 50 61 72 73 65 2d  ){.      pParse-
3650: 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20 20 20 20  >rc = rc;.      
3660: 70 50 61 72 73 65 2d 3e 6e 45 72 72 2b 2b 3b 0a  pParse->nErr++;.
3670: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62      }else if( db
3680: 2d 3e 6e 6f 53 68 61 72 65 64 43 61 63 68 65 20  ->noSharedCache 
3690: 29 7b 0a 20 20 20 20 20 20 64 62 2d 3e 6d 44 62  ){.      db->mDb
36a0: 46 6c 61 67 73 20 7c 3d 20 44 42 46 4c 41 47 5f  Flags |= DBFLAG_
36b0: 53 63 68 65 6d 61 4b 6e 6f 77 6e 4f 6b 3b 0a 20  SchemaKnownOk;. 
36c0: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72     }.  }.  retur
36d0: 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  n rc;.}.../*.** 
36e0: 43 68 65 63 6b 20 73 63 68 65 6d 61 20 63 6f 6f  Check schema coo
36f0: 6b 69 65 73 20 69 6e 20 61 6c 6c 20 64 61 74 61  kies in all data
3700: 62 61 73 65 73 2e 20 20 49 66 20 61 6e 79 20 63  bases.  If any c
3710: 6f 6f 6b 69 65 20 69 73 20 6f 75 74 0a 2a 2a 20  ookie is out.** 
3720: 6f 66 20 64 61 74 65 20 73 65 74 20 70 50 61 72  of date set pPar
3730: 73 65 2d 3e 72 63 20 74 6f 20 53 51 4c 49 54 45  se->rc to SQLITE
3740: 5f 53 43 48 45 4d 41 2e 20 20 49 66 20 61 6c 6c  _SCHEMA.  If all
3750: 20 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65 73 0a   schema cookies.
3760: 2a 2a 20 6d 61 6b 65 20 6e 6f 20 63 68 61 6e 67  ** make no chang
3770: 65 73 20 74 6f 20 70 50 61 72 73 65 2d 3e 72 63  es to pParse->rc
3780: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
3790: 20 73 63 68 65 6d 61 49 73 56 61 6c 69 64 28 50   schemaIsValid(P
37a0: 61 72 73 65 20 2a 70 50 61 72 73 65 29 7b 0a 20  arse *pParse){. 
37b0: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70   sqlite3 *db = p
37c0: 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 69 6e 74  Parse->db;.  int
37d0: 20 69 44 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a   iDb;.  int rc;.
37e0: 20 20 69 6e 74 20 63 6f 6f 6b 69 65 3b 0a 0a 20    int cookie;.. 
37f0: 20 61 73 73 65 72 74 28 20 70 50 61 72 73 65 2d   assert( pParse-
3800: 3e 63 68 65 63 6b 53 63 68 65 6d 61 20 29 3b 0a  >checkSchema );.
3810: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
3820: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d  3_mutex_held(db-
3830: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 6f 72  >mutex) );.  for
3840: 28 69 44 62 3d 30 3b 20 69 44 62 3c 64 62 2d 3e  (iDb=0; iDb<db->
3850: 6e 44 62 3b 20 69 44 62 2b 2b 29 7b 0a 20 20 20  nDb; iDb++){.   
3860: 20 69 6e 74 20 6f 70 65 6e 65 64 54 72 61 6e 73   int openedTrans
3870: 61 63 74 69 6f 6e 20 3d 20 30 3b 20 20 20 20 20  action = 0;     
3880: 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61      /* True if a
3890: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20   transaction is 
38a0: 6f 70 65 6e 65 64 20 2a 2f 0a 20 20 20 20 42 74  opened */.    Bt
38b0: 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61  ree *pBt = db->a
38c0: 44 62 5b 69 44 62 5d 2e 70 42 74 3b 20 20 20 20  Db[iDb].pBt;    
38d0: 20 2f 2a 20 42 74 72 65 65 20 64 61 74 61 62 61   /* Btree databa
38e0: 73 65 20 74 6f 20 72 65 61 64 20 63 6f 6f 6b 69  se to read cooki
38f0: 65 20 66 72 6f 6d 20 2a 2f 0a 20 20 20 20 69 66  e from */.    if
3900: 28 20 70 42 74 3d 3d 30 20 29 20 63 6f 6e 74 69  ( pBt==0 ) conti
3910: 6e 75 65 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20  nue;..    /* If 
3920: 74 68 65 72 65 20 69 73 20 6e 6f 74 20 61 6c 72  there is not alr
3930: 65 61 64 79 20 61 20 72 65 61 64 2d 6f 6e 6c 79  eady a read-only
3940: 20 28 6f 72 20 72 65 61 64 2d 77 72 69 74 65 29   (or read-write)
3950: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65   transaction ope
3960: 6e 65 64 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 68  ned.    ** on th
3970: 65 20 62 2d 74 72 65 65 20 64 61 74 61 62 61 73  e b-tree databas
3980: 65 2c 20 6f 70 65 6e 20 6f 6e 65 20 6e 6f 77 2e  e, open one now.
3990: 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f   If a transactio
39a0: 6e 20 69 73 20 6f 70 65 6e 65 64 2c 20 69 74 20  n is opened, it 
39b0: 0a 20 20 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20  .    ** will be 
39c0: 63 6c 6f 73 65 64 20 69 6d 6d 65 64 69 61 74 65  closed immediate
39d0: 6c 79 20 61 66 74 65 72 20 72 65 61 64 69 6e 67  ly after reading
39e0: 20 74 68 65 20 6d 65 74 61 2d 76 61 6c 75 65 2e   the meta-value.
39f0: 20 2a 2f 0a 20 20 20 20 69 66 28 20 21 73 71 6c   */.    if( !sql
3a00: 69 74 65 33 42 74 72 65 65 49 73 49 6e 52 65 61  ite3BtreeIsInRea
3a10: 64 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a 20  dTrans(pBt) ){. 
3a20: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
3a30: 33 42 74 72 65 65 42 65 67 69 6e 54 72 61 6e 73  3BtreeBeginTrans
3a40: 28 70 42 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20  (pBt, 0, 0);.   
3a50: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
3a60: 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 72 63 3d 3d 53  E_NOMEM || rc==S
3a70: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45  QLITE_IOERR_NOME
3a80: 4d 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  M ){.        sql
3a90: 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28 64 62 29  ite3OomFault(db)
3aa0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
3ab0: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
3ac0: 4b 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 20 20  K ) return;.    
3ad0: 20 20 6f 70 65 6e 65 64 54 72 61 6e 73 61 63 74    openedTransact
3ae0: 69 6f 6e 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 0a  ion = 1;.    }..
3af0: 20 20 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20      /* Read the 
3b00: 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65 20 66 72  schema cookie fr
3b10: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2e  om the database.
3b20: 20 49 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 20   If it does not 
3b30: 6d 61 74 63 68 20 74 68 65 20 0a 20 20 20 20 2a  match the .    *
3b40: 2a 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 61  * value stored a
3b50: 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 69 6e  s part of the in
3b60: 2d 6d 65 6d 6f 72 79 20 73 63 68 65 6d 61 20 72  -memory schema r
3b70: 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 2c 0a 20  epresentation,. 
3b80: 20 20 20 2a 2a 20 73 65 74 20 50 61 72 73 65 2e     ** set Parse.
3b90: 72 63 20 74 6f 20 53 51 4c 49 54 45 5f 53 43 48  rc to SQLITE_SCH
3ba0: 45 4d 41 2e 20 2a 2f 0a 20 20 20 20 73 71 6c 69  EMA. */.    sqli
3bb0: 74 65 33 42 74 72 65 65 47 65 74 4d 65 74 61 28  te3BtreeGetMeta(
3bc0: 70 42 74 2c 20 42 54 52 45 45 5f 53 43 48 45 4d  pBt, BTREE_SCHEM
3bd0: 41 5f 56 45 52 53 49 4f 4e 2c 20 28 75 33 32 20  A_VERSION, (u32 
3be0: 2a 29 26 63 6f 6f 6b 69 65 29 3b 0a 20 20 20 20  *)&cookie);.    
3bf0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 53  assert( sqlite3S
3c00: 63 68 65 6d 61 4d 75 74 65 78 48 65 6c 64 28 64  chemaMutexHeld(d
3c10: 62 2c 20 69 44 62 2c 20 30 29 20 29 3b 0a 20 20  b, iDb, 0) );.  
3c20: 20 20 69 66 28 20 63 6f 6f 6b 69 65 21 3d 64 62    if( cookie!=db
3c30: 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 53 63 68 65  ->aDb[iDb].pSche
3c40: 6d 61 2d 3e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69  ma->schema_cooki
3c50: 65 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  e ){.      sqlit
3c60: 65 33 52 65 73 65 74 4f 6e 65 53 63 68 65 6d 61  e3ResetOneSchema
3c70: 28 64 62 2c 20 69 44 62 29 3b 0a 20 20 20 20 20  (db, iDb);.     
3c80: 20 70 50 61 72 73 65 2d 3e 72 63 20 3d 20 53 51   pParse->rc = SQ
3c90: 4c 49 54 45 5f 53 43 48 45 4d 41 3b 0a 20 20 20  LITE_SCHEMA;.   
3ca0: 20 7d 0a 0a 20 20 20 20 2f 2a 20 43 6c 6f 73 65   }..    /* Close
3cb0: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
3cc0: 2c 20 69 66 20 6f 6e 65 20 77 61 73 20 6f 70 65  , if one was ope
3cd0: 6e 65 64 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20  ned. */.    if( 
3ce0: 6f 70 65 6e 65 64 54 72 61 6e 73 61 63 74 69 6f  openedTransactio
3cf0: 6e 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  n ){.      sqlit
3d00: 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 70 42  e3BtreeCommit(pB
3d10: 74 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a  t);.    }.  }.}.
3d20: 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 61  ./*.** Convert a
3d30: 20 73 63 68 65 6d 61 20 70 6f 69 6e 74 65 72 20   schema pointer 
3d40: 69 6e 74 6f 20 74 68 65 20 69 44 62 20 69 6e 64  into the iDb ind
3d50: 65 78 20 74 68 61 74 20 69 6e 64 69 63 61 74 65  ex that indicate
3d60: 73 0a 2a 2a 20 77 68 69 63 68 20 64 61 74 61 62  s.** which datab
3d70: 61 73 65 20 66 69 6c 65 20 69 6e 20 64 62 2d 3e  ase file in db->
3d80: 61 44 62 5b 5d 20 74 68 65 20 73 63 68 65 6d 61  aDb[] the schema
3d90: 20 72 65 66 65 72 73 20 74 6f 2e 0a 2a 2a 0a 2a   refers to..**.*
3da0: 2a 20 49 66 20 74 68 65 20 73 61 6d 65 20 64 61  * If the same da
3db0: 74 61 62 61 73 65 20 69 73 20 61 74 74 61 63 68  tabase is attach
3dc0: 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 63  ed more than onc
3dd0: 65 2c 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20  e, the first.** 
3de0: 61 74 74 61 63 68 65 64 20 64 61 74 61 62 61 73  attached databas
3df0: 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a  e is returned..*
3e00: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 63 68  /.int sqlite3Sch
3e10: 65 6d 61 54 6f 49 6e 64 65 78 28 73 71 6c 69 74  emaToIndex(sqlit
3e20: 65 33 20 2a 64 62 2c 20 53 63 68 65 6d 61 20 2a  e3 *db, Schema *
3e30: 70 53 63 68 65 6d 61 29 7b 0a 20 20 69 6e 74 20  pSchema){.  int 
3e40: 69 20 3d 20 2d 31 30 30 30 30 30 30 3b 0a 0a 20  i = -1000000;.. 
3e50: 20 2f 2a 20 49 66 20 70 53 63 68 65 6d 61 20 69   /* If pSchema i
3e60: 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 72 65 74  s NULL, then ret
3e70: 75 72 6e 20 2d 31 30 30 30 30 30 30 2e 20 54 68  urn -1000000. Th
3e80: 69 73 20 68 61 70 70 65 6e 73 20 77 68 65 6e 20  is happens when 
3e90: 63 6f 64 65 20 69 6e 20 0a 20 20 2a 2a 20 65 78  code in .  ** ex
3ea0: 70 72 2e 63 20 69 73 20 74 72 79 69 6e 67 20 74  pr.c is trying t
3eb0: 6f 20 72 65 73 6f 6c 76 65 20 61 20 72 65 66 65  o resolve a refe
3ec0: 72 65 6e 63 65 20 74 6f 20 61 20 74 72 61 6e 73  rence to a trans
3ed0: 69 65 6e 74 20 74 61 62 6c 65 20 28 69 2e 65 2e  ient table (i.e.
3ee0: 20 6f 6e 65 0a 20 20 2a 2a 20 63 72 65 61 74 65   one.  ** create
3ef0: 64 20 62 79 20 61 20 73 75 62 2d 73 65 6c 65 63  d by a sub-selec
3f00: 74 29 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65  t). In this case
3f10: 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75   the return valu
3f20: 65 20 6f 66 20 74 68 69 73 20 0a 20 20 2a 2a 20  e of this .  ** 
3f30: 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20  function should 
3f40: 6e 65 76 65 72 20 62 65 20 75 73 65 64 2e 0a 20  never be used.. 
3f50: 20 2a 2a 0a 20 20 2a 2a 20 57 65 20 72 65 74 75   **.  ** We retu
3f60: 72 6e 20 2d 31 30 30 30 30 30 30 20 69 6e 73 74  rn -1000000 inst
3f70: 65 61 64 20 6f 66 20 74 68 65 20 6d 6f 72 65 20  ead of the more 
3f80: 75 73 75 61 6c 20 2d 31 20 73 69 6d 70 6c 79 20  usual -1 simply 
3f90: 62 65 63 61 75 73 65 20 75 73 69 6e 67 0a 20 20  because using.  
3fa0: 2a 2a 20 2d 31 30 30 30 30 30 30 20 61 73 20 74  ** -1000000 as t
3fb0: 68 65 20 69 6e 63 6f 72 72 65 63 74 20 69 6e 64  he incorrect ind
3fc0: 65 78 20 69 6e 74 6f 20 64 62 2d 3e 61 44 62 5b  ex into db->aDb[
3fd0: 5d 20 69 73 20 6d 75 63 68 20 0a 20 20 2a 2a 20  ] is much .  ** 
3fe0: 6d 6f 72 65 20 6c 69 6b 65 6c 79 20 74 6f 20 63  more likely to c
3ff0: 61 75 73 65 20 61 20 73 65 67 66 61 75 6c 74 20  ause a segfault 
4000: 74 68 61 6e 20 2d 31 20 28 6f 66 20 63 6f 75 72  than -1 (of cour
4010: 73 65 20 74 68 65 72 65 20 61 72 65 20 61 73 73  se there are ass
4020: 65 72 74 28 29 0a 20 20 2a 2a 20 73 74 61 74 65  ert().  ** state
4030: 6d 65 6e 74 73 20 74 6f 6f 2c 20 62 75 74 20 69  ments too, but i
4040: 74 20 6e 65 76 65 72 20 68 75 72 74 73 20 74 6f  t never hurts to
4050: 20 70 6c 61 79 20 74 68 65 20 6f 64 64 73 29 2e   play the odds).
4060: 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  .  */.  assert( 
4070: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
4080: 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b  ld(db->mutex) );
4090: 0a 20 20 69 66 28 20 70 53 63 68 65 6d 61 20 29  .  if( pSchema )
40a0: 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 31  {.    for(i=0; 1
40b0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 61 73  ; i++){.      as
40c0: 73 65 72 74 28 20 69 3c 64 62 2d 3e 6e 44 62 20  sert( i<db->nDb 
40d0: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 64 62 2d  );.      if( db-
40e0: 3e 61 44 62 5b 69 5d 2e 70 53 63 68 65 6d 61 3d  >aDb[i].pSchema=
40f0: 3d 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20  =pSchema ){.    
4100: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
4110: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73   }.    }.    ass
4120: 65 72 74 28 20 69 3e 3d 30 20 26 26 20 69 3c 64  ert( i>=0 && i<d
4130: 62 2d 3e 6e 44 62 20 29 3b 0a 20 20 7d 0a 20 20  b->nDb );.  }.  
4140: 72 65 74 75 72 6e 20 69 3b 0a 7d 0a 0a 2f 2a 0a  return i;.}../*.
4150: 2a 2a 20 46 72 65 65 20 61 6c 6c 20 6d 65 6d 6f  ** Free all memo
4160: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 69  ry allocations i
4170: 6e 20 74 68 65 20 70 50 61 72 73 65 20 6f 62 6a  n the pParse obj
4180: 65 63 74 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ect.*/.void sqli
4190: 74 65 33 50 61 72 73 65 72 52 65 73 65 74 28 50  te3ParserReset(P
41a0: 61 72 73 65 20 2a 70 50 61 72 73 65 29 7b 0a 20  arse *pParse){. 
41b0: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70   sqlite3 *db = p
41c0: 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 73 71 6c  Parse->db;.  sql
41d0: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70  ite3DbFree(db, p
41e0: 50 61 72 73 65 2d 3e 61 4c 61 62 65 6c 29 3b 0a  Parse->aLabel);.
41f0: 20 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73    sqlite3ExprLis
4200: 74 44 65 6c 65 74 65 28 64 62 2c 20 70 50 61 72  tDelete(db, pPar
4210: 73 65 2d 3e 70 43 6f 6e 73 74 45 78 70 72 29 3b  se->pConstExpr);
4220: 0a 20 20 69 66 28 20 64 62 20 29 7b 0a 20 20 20  .  if( db ){.   
4230: 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6c 6f 6f   assert( db->loo
4240: 6b 61 73 69 64 65 2e 62 44 69 73 61 62 6c 65 20  kaside.bDisable 
4250: 3e 3d 20 70 50 61 72 73 65 2d 3e 64 69 73 61 62  >= pParse->disab
4260: 6c 65 4c 6f 6f 6b 61 73 69 64 65 20 29 3b 0a 20  leLookaside );. 
4270: 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65     db->lookaside
4280: 2e 62 44 69 73 61 62 6c 65 20 2d 3d 20 70 50 61  .bDisable -= pPa
4290: 72 73 65 2d 3e 64 69 73 61 62 6c 65 4c 6f 6f 6b  rse->disableLook
42a0: 61 73 69 64 65 3b 0a 20 20 7d 0a 20 20 70 50 61  aside;.  }.  pPa
42b0: 72 73 65 2d 3e 64 69 73 61 62 6c 65 4c 6f 6f 6b  rse->disableLook
42c0: 61 73 69 64 65 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a  aside = 0;.}../*
42d0: 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20 74 68 65 20  .** Compile the 
42e0: 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51  UTF-8 encoded SQ
42f0: 4c 20 73 74 61 74 65 6d 65 6e 74 20 7a 53 71 6c  L statement zSql
4300: 20 69 6e 74 6f 20 61 20 73 74 61 74 65 6d 65 6e   into a statemen
4310: 74 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 73 74 61  t handle..*/.sta
4320: 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 50  tic int sqlite3P
4330: 72 65 70 61 72 65 28 0a 20 20 73 71 6c 69 74 65  repare(.  sqlite
4340: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  3 *db,          
4350: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20      /* Database 
4360: 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e  handle. */.  con
4370: 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20  st char *zSql,  
4380: 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 20         /* UTF-8 
4390: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74  encoded SQL stat
43a0: 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20  ement. */.  int 
43b0: 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 20  nBytes,         
43c0: 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20        /* Length 
43d0: 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73  of zSql in bytes
43e0: 2e 20 2a 2f 0a 20 20 75 33 32 20 70 72 65 70 46  . */.  u32 prepF
43f0: 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 20  lags,           
4400: 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65   /* Zero or more
4410: 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f   SQLITE_PREPARE_
4420: 2a 20 66 6c 61 67 73 20 2a 2f 0a 20 20 56 64 62  * flags */.  Vdb
4430: 65 20 2a 70 52 65 70 72 65 70 61 72 65 2c 20 20  e *pReprepare,  
4440: 20 20 20 20 20 20 20 2f 2a 20 56 4d 20 62 65 69         /* VM bei
4450: 6e 67 20 72 65 70 72 65 70 61 72 65 64 20 2a 2f  ng reprepared */
4460: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
4470: 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20  **ppStmt,    /* 
4480: 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74  OUT: A pointer t
4490: 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73  o the prepared s
44a0: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f  tatement */.  co
44b0: 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 69  nst char **pzTai
44c0: 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20  l       /* OUT: 
44d0: 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74  End of parsed st
44e0: 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 63 68 61  ring */.){.  cha
44f0: 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b 20  r *zErrMsg = 0; 
4500: 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 20         /* Error 
4510: 6d 65 73 73 61 67 65 20 2a 2f 0a 20 20 69 6e 74  message */.  int
4520: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
4530: 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74         /* Result
4540: 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 69   code */.  int i
4550: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
4560: 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75       /* Loop cou
4570: 6e 74 65 72 20 2a 2f 0a 20 20 50 61 72 73 65 20  nter */.  Parse 
4580: 73 50 61 72 73 65 3b 20 20 20 20 20 20 20 20 20  sParse;         
4590: 20 20 20 20 2f 2a 20 50 61 72 73 69 6e 67 20 63      /* Parsing c
45a0: 6f 6e 74 65 78 74 20 2a 2f 0a 0a 20 20 6d 65 6d  ontext */..  mem
45b0: 73 65 74 28 26 73 50 61 72 73 65 2c 20 30 2c 20  set(&sParse, 0, 
45c0: 50 41 52 53 45 5f 48 44 52 5f 53 5a 29 3b 0a 20  PARSE_HDR_SZ);. 
45d0: 20 6d 65 6d 73 65 74 28 50 41 52 53 45 5f 54 41   memset(PARSE_TA
45e0: 49 4c 28 26 73 50 61 72 73 65 29 2c 20 30 2c 20  IL(&sParse), 0, 
45f0: 50 41 52 53 45 5f 54 41 49 4c 5f 53 5a 29 3b 0a  PARSE_TAIL_SZ);.
4600: 20 20 73 50 61 72 73 65 2e 70 52 65 70 72 65 70    sParse.pReprep
4610: 61 72 65 20 3d 20 70 52 65 70 72 65 70 61 72 65  are = pReprepare
4620: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 70 53 74  ;.  assert( ppSt
4630: 6d 74 20 26 26 20 2a 70 70 53 74 6d 74 3d 3d 30  mt && *ppStmt==0
4640: 20 29 3b 0a 20 20 2f 2a 20 61 73 73 65 72 74 28   );.  /* assert(
4650: 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c   !db->mallocFail
4660: 65 64 20 29 3b 20 2f 2f 20 6e 6f 74 20 74 72 75  ed ); // not tru
4670: 65 20 77 69 74 68 20 53 51 4c 49 54 45 5f 55 53  e with SQLITE_US
4680: 45 5f 41 4c 4c 4f 43 41 20 2a 2f 0a 20 20 61 73  E_ALLOCA */.  as
4690: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
46a0: 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74  tex_held(db->mut
46b0: 65 78 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 6f 72  ex) );..  /* For
46c0: 20 61 20 6c 6f 6e 67 2d 74 65 72 6d 20 75 73 65   a long-term use
46d0: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
46e0: 65 6e 74 20 61 76 6f 69 64 20 74 68 65 20 75 73  ent avoid the us
46f0: 65 20 6f 66 0a 20 20 2a 2a 20 6c 6f 6f 6b 61 73  e of.  ** lookas
4700: 69 64 65 20 6d 65 6d 6f 72 79 2e 0a 20 20 2a 2f  ide memory..  */
4710: 0a 20 20 69 66 28 20 70 72 65 70 46 6c 61 67 73  .  if( prepFlags
4720: 20 26 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52   & SQLITE_PREPAR
4730: 45 5f 50 45 52 53 49 53 54 45 4e 54 20 29 7b 0a  E_PERSISTENT ){.
4740: 20 20 20 20 73 50 61 72 73 65 2e 64 69 73 61 62      sParse.disab
4750: 6c 65 4c 6f 6f 6b 61 73 69 64 65 2b 2b 3b 0a 20  leLookaside++;. 
4760: 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65     db->lookaside
4770: 2e 62 44 69 73 61 62 6c 65 2b 2b 3b 0a 20 20 7d  .bDisable++;.  }
4780: 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74 6f 20  ..  /* Check to 
4790: 76 65 72 69 66 79 20 74 68 61 74 20 69 74 20 69  verify that it i
47a0: 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 67 65  s possible to ge
47b0: 74 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 6f 6e  t a read lock on
47c0: 20 61 6c 6c 0a 20 20 2a 2a 20 64 61 74 61 62 61   all.  ** databa
47d0: 73 65 20 73 63 68 65 6d 61 73 2e 20 20 54 68 65  se schemas.  The
47e0: 20 69 6e 61 62 69 6c 69 74 79 20 74 6f 20 67 65   inability to ge
47f0: 74 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 69 6e  t a read lock in
4800: 64 69 63 61 74 65 73 20 74 68 61 74 0a 20 20 2a  dicates that.  *
4810: 2a 20 73 6f 6d 65 20 6f 74 68 65 72 20 64 61 74  * some other dat
4820: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
4830: 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 20 77 72   is holding a wr
4840: 69 74 65 2d 6c 6f 63 6b 2c 20 77 68 69 63 68 20  ite-lock, which 
4850: 69 6e 0a 20 20 2a 2a 20 74 75 72 6e 20 6d 65 61  in.  ** turn mea
4860: 6e 73 20 74 68 61 74 20 74 68 65 20 6f 74 68 65  ns that the othe
4870: 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 73  r connection has
4880: 20 6d 61 64 65 20 75 6e 63 6f 6d 6d 69 74 74 65   made uncommitte
4890: 64 20 63 68 61 6e 67 65 73 0a 20 20 2a 2a 20 74  d changes.  ** t
48a0: 6f 20 74 68 65 20 73 63 68 65 6d 61 2e 0a 20 20  o the schema..  
48b0: 2a 2a 0a 20 20 2a 2a 20 57 65 72 65 20 77 65 20  **.  ** Were we 
48c0: 74 6f 20 70 72 6f 63 65 65 64 20 61 6e 64 20 70  to proceed and p
48d0: 72 65 70 61 72 65 20 74 68 65 20 73 74 61 74 65  repare the state
48e0: 6d 65 6e 74 20 61 67 61 69 6e 73 74 20 74 68 65  ment against the
48f0: 20 75 6e 63 6f 6d 6d 69 74 74 65 64 0a 20 20 2a   uncommitted.  *
4900: 2a 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73  * schema changes
4910: 20 61 6e 64 20 69 66 20 74 68 6f 73 65 20 73 63   and if those sc
4920: 68 65 6d 61 20 63 68 61 6e 67 65 73 20 61 72 65  hema changes are
4930: 20 73 75 62 73 65 71 75 65 6e 74 6c 79 20 72 6f   subsequently ro
4940: 6c 6c 65 64 0a 20 20 2a 2a 20 62 61 63 6b 20 61  lled.  ** back a
4950: 6e 64 20 64 69 66 66 65 72 65 6e 74 20 63 68 61  nd different cha
4960: 6e 67 65 73 20 61 72 65 20 6d 61 64 65 20 69 6e  nges are made in
4970: 20 74 68 65 69 72 20 70 6c 61 63 65 2c 20 74 68   their place, th
4980: 65 6e 20 77 68 65 6e 20 74 68 69 73 0a 20 20 2a  en when this.  *
4990: 2a 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  * prepared state
49a0: 6d 65 6e 74 20 67 6f 65 73 20 74 6f 20 72 75 6e  ment goes to run
49b0: 20 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6f 6b   the schema cook
49c0: 69 65 20 77 6f 75 6c 64 20 66 61 69 6c 20 74 6f  ie would fail to
49d0: 20 64 65 74 65 63 74 0a 20 20 2a 2a 20 74 68 65   detect.  ** the
49e0: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 2e 20   schema change. 
49f0: 20 44 69 73 61 73 74 65 72 20 77 6f 75 6c 64 20   Disaster would 
4a00: 66 6f 6c 6c 6f 77 2e 0a 20 20 2a 2a 0a 20 20 2a  follow..  **.  *
4a10: 2a 20 54 68 69 73 20 74 68 72 65 61 64 20 69 73  * This thread is
4a20: 20 63 75 72 72 65 6e 74 6c 79 20 68 6f 6c 64 69   currently holdi
4a30: 6e 67 20 6d 75 74 65 78 65 73 20 6f 6e 20 61 6c  ng mutexes on al
4a40: 6c 20 42 74 72 65 65 73 20 28 62 65 63 61 75 73  l Btrees (becaus
4a50: 65 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20 73 71  e.  ** of the sq
4a60: 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 41  lite3BtreeEnterA
4a70: 6c 6c 28 29 20 69 6e 20 73 71 6c 69 74 65 33 4c  ll() in sqlite3L
4a80: 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28 29 29  ockAndPrepare())
4a90: 20 73 6f 20 69 74 0a 20 20 2a 2a 20 69 73 20 6e   so it.  ** is n
4aa0: 6f 74 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20  ot possible for 
4ab0: 61 6e 6f 74 68 65 72 20 74 68 72 65 61 64 20 74  another thread t
4ac0: 6f 20 73 74 61 72 74 20 61 20 6e 65 77 20 73 63  o start a new sc
4ad0: 68 65 6d 61 20 63 68 61 6e 67 65 0a 20 20 2a 2a  hema change.  **
4ae0: 20 77 68 69 6c 65 20 74 68 69 73 20 72 6f 75 74   while this rout
4af0: 69 6e 65 20 69 73 20 72 75 6e 6e 69 6e 67 2e 20  ine is running. 
4b00: 20 48 65 6e 63 65 2c 20 77 65 20 64 6f 20 6e 6f   Hence, we do no
4b10: 74 20 6e 65 65 64 20 74 6f 20 68 6f 6c 64 20 0a  t need to hold .
4b20: 20 20 2a 2a 20 6c 6f 63 6b 73 20 6f 6e 20 74 68    ** locks on th
4b30: 65 20 73 63 68 65 6d 61 2c 20 77 65 20 6a 75 73  e schema, we jus
4b40: 74 20 6e 65 65 64 20 74 6f 20 6d 61 6b 65 20 73  t need to make s
4b50: 75 72 65 20 6e 6f 62 6f 64 79 20 65 6c 73 65 20  ure nobody else 
4b60: 69 73 20 0a 20 20 2a 2a 20 68 6f 6c 64 69 6e 67  is .  ** holding
4b70: 20 74 68 65 6d 2e 0a 20 20 2a 2a 0a 20 20 2a 2a   them..  **.  **
4b80: 20 4e 6f 74 65 20 74 68 61 74 20 73 65 74 74 69   Note that setti
4b90: 6e 67 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54  ng READ_UNCOMMIT
4ba0: 54 45 44 20 6f 76 65 72 72 69 64 65 73 20 6d 6f  TED overrides mo
4bb0: 73 74 20 6c 6f 63 6b 20 64 65 74 65 63 74 69 6f  st lock detectio
4bc0: 6e 2c 0a 20 20 2a 2a 20 62 75 74 20 69 74 20 64  n,.  ** but it d
4bd0: 6f 65 73 20 2a 6e 6f 74 2a 20 6f 76 65 72 72 69  oes *not* overri
4be0: 64 65 20 73 63 68 65 6d 61 20 6c 6f 63 6b 20 64  de schema lock d
4bf0: 65 74 65 63 74 69 6f 6e 2c 20 73 6f 20 74 68 69  etection, so thi
4c00: 73 20 61 6c 6c 20 73 74 69 6c 6c 0a 20 20 2a 2a  s all still.  **
4c10: 20 77 6f 72 6b 73 20 65 76 65 6e 20 69 66 20 52   works even if R
4c20: 45 41 44 5f 55 4e 43 4f 4d 4d 49 54 54 45 44 20  EAD_UNCOMMITTED 
4c30: 69 73 20 73 65 74 2e 0a 20 20 2a 2f 0a 20 20 66  is set..  */.  f
4c40: 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44  or(i=0; i<db->nD
4c50: 62 3b 20 69 2b 2b 29 20 7b 0a 20 20 20 20 42 74  b; i++) {.    Bt
4c60: 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61  ree *pBt = db->a
4c70: 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69  Db[i].pBt;.    i
4c80: 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20  f( pBt ){.      
4c90: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 42  assert( sqlite3B
4ca0: 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70  treeHoldsMutex(p
4cb0: 42 74 29 20 29 3b 0a 20 20 20 20 20 20 72 63 20  Bt) );.      rc 
4cc0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 63  = sqlite3BtreeSc
4cd0: 68 65 6d 61 4c 6f 63 6b 65 64 28 70 42 74 29 3b  hemaLocked(pBt);
4ce0: 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b  .      if( rc ){
4cf0: 0a 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63  .        const c
4d00: 68 61 72 20 2a 7a 44 62 20 3d 20 64 62 2d 3e 61  har *zDb = db->a
4d10: 44 62 5b 69 5d 2e 7a 44 62 53 4e 61 6d 65 3b 0a  Db[i].zDbSName;.
4d20: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 45          sqlite3E
4d30: 72 72 6f 72 57 69 74 68 4d 73 67 28 64 62 2c 20  rrorWithMsg(db, 
4d40: 72 63 2c 20 22 64 61 74 61 62 61 73 65 20 73 63  rc, "database sc
4d50: 68 65 6d 61 20 69 73 20 6c 6f 63 6b 65 64 3a 20  hema is locked: 
4d60: 25 73 22 2c 20 7a 44 62 29 3b 0a 20 20 20 20 20  %s", zDb);.     
4d70: 20 20 20 74 65 73 74 63 61 73 65 28 20 64 62 2d     testcase( db-
4d80: 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f  >flags & SQLITE_
4d90: 52 65 61 64 55 6e 63 6f 6d 6d 69 74 20 29 3b 0a  ReadUncommit );.
4da0: 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64          goto end
4db0: 5f 70 72 65 70 61 72 65 3b 0a 20 20 20 20 20 20  _prepare;.      
4dc0: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 73  }.    }.  }..  s
4dd0: 71 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b  qlite3VtabUnlock
4de0: 4c 69 73 74 28 64 62 29 3b 0a 0a 20 20 73 50 61  List(db);..  sPa
4df0: 72 73 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20 69  rse.db = db;.  i
4e00: 66 28 20 6e 42 79 74 65 73 3e 3d 30 20 26 26 20  f( nBytes>=0 && 
4e10: 28 6e 42 79 74 65 73 3d 3d 30 20 7c 7c 20 7a 53  (nBytes==0 || zS
4e20: 71 6c 5b 6e 42 79 74 65 73 2d 31 5d 21 3d 30 29  ql[nBytes-1]!=0)
4e30: 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 53   ){.    char *zS
4e40: 71 6c 43 6f 70 79 3b 0a 20 20 20 20 69 6e 74 20  qlCopy;.    int 
4e50: 6d 78 4c 65 6e 20 3d 20 64 62 2d 3e 61 4c 69 6d  mxLen = db->aLim
4e60: 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f  it[SQLITE_LIMIT_
4e70: 53 51 4c 5f 4c 45 4e 47 54 48 5d 3b 0a 20 20 20  SQL_LENGTH];.   
4e80: 20 74 65 73 74 63 61 73 65 28 20 6e 42 79 74 65   testcase( nByte
4e90: 73 3d 3d 6d 78 4c 65 6e 20 29 3b 0a 20 20 20 20  s==mxLen );.    
4ea0: 74 65 73 74 63 61 73 65 28 20 6e 42 79 74 65 73  testcase( nBytes
4eb0: 3d 3d 6d 78 4c 65 6e 2b 31 20 29 3b 0a 20 20 20  ==mxLen+1 );.   
4ec0: 20 69 66 28 20 6e 42 79 74 65 73 3e 6d 78 4c 65   if( nBytes>mxLe
4ed0: 6e 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  n ){.      sqlit
4ee0: 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64  e3ErrorWithMsg(d
4ef0: 62 2c 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47  b, SQLITE_TOOBIG
4f00: 2c 20 22 73 74 61 74 65 6d 65 6e 74 20 74 6f 6f  , "statement too
4f10: 20 6c 6f 6e 67 22 29 3b 0a 20 20 20 20 20 20 72   long");.      r
4f20: 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78  c = sqlite3ApiEx
4f30: 69 74 28 64 62 2c 20 53 51 4c 49 54 45 5f 54 4f  it(db, SQLITE_TO
4f40: 4f 42 49 47 29 3b 0a 20 20 20 20 20 20 67 6f 74  OBIG);.      got
4f50: 6f 20 65 6e 64 5f 70 72 65 70 61 72 65 3b 0a 20  o end_prepare;. 
4f60: 20 20 20 7d 0a 20 20 20 20 7a 53 71 6c 43 6f 70     }.    zSqlCop
4f70: 79 20 3d 20 73 71 6c 69 74 65 33 44 62 53 74 72  y = sqlite3DbStr
4f80: 4e 44 75 70 28 64 62 2c 20 7a 53 71 6c 2c 20 6e  NDup(db, zSql, n
4f90: 42 79 74 65 73 29 3b 0a 20 20 20 20 69 66 28 20  Bytes);.    if( 
4fa0: 7a 53 71 6c 43 6f 70 79 20 29 7b 0a 20 20 20 20  zSqlCopy ){.    
4fb0: 20 20 73 71 6c 69 74 65 33 52 75 6e 50 61 72 73    sqlite3RunPars
4fc0: 65 72 28 26 73 50 61 72 73 65 2c 20 7a 53 71 6c  er(&sParse, zSql
4fd0: 43 6f 70 79 2c 20 26 7a 45 72 72 4d 73 67 29 3b  Copy, &zErrMsg);
4fe0: 0a 20 20 20 20 20 20 73 50 61 72 73 65 2e 7a 54  .      sParse.zT
4ff0: 61 69 6c 20 3d 20 26 7a 53 71 6c 5b 73 50 61 72  ail = &zSql[sPar
5000: 73 65 2e 7a 54 61 69 6c 2d 7a 53 71 6c 43 6f 70  se.zTail-zSqlCop
5010: 79 5d 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  y];.      sqlite
5020: 33 44 62 46 72 65 65 28 64 62 2c 20 7a 53 71 6c  3DbFree(db, zSql
5030: 43 6f 70 79 29 3b 0a 20 20 20 20 7d 65 6c 73 65  Copy);.    }else
5040: 7b 0a 20 20 20 20 20 20 73 50 61 72 73 65 2e 7a  {.      sParse.z
5050: 54 61 69 6c 20 3d 20 26 7a 53 71 6c 5b 6e 42 79  Tail = &zSql[nBy
5060: 74 65 73 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d 65  tes];.    }.  }e
5070: 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  lse{.    sqlite3
5080: 52 75 6e 50 61 72 73 65 72 28 26 73 50 61 72 73  RunParser(&sPars
5090: 65 2c 20 7a 53 71 6c 2c 20 26 7a 45 72 72 4d 73  e, zSql, &zErrMs
50a0: 67 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74  g);.  }.  assert
50b0: 28 20 30 3d 3d 73 50 61 72 73 65 2e 6e 51 75 65  ( 0==sParse.nQue
50c0: 72 79 4c 6f 6f 70 20 29 3b 0a 0a 20 20 69 66 28  ryLoop );..  if(
50d0: 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49   sParse.rc==SQLI
50e0: 54 45 5f 44 4f 4e 45 20 29 20 73 50 61 72 73 65  TE_DONE ) sParse
50f0: 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  .rc = SQLITE_OK;
5100: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 63 68  .  if( sParse.ch
5110: 65 63 6b 53 63 68 65 6d 61 20 29 7b 0a 20 20 20  eckSchema ){.   
5120: 20 73 63 68 65 6d 61 49 73 56 61 6c 69 64 28 26   schemaIsValid(&
5130: 73 50 61 72 73 65 29 3b 0a 20 20 7d 0a 20 20 69  sParse);.  }.  i
5140: 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69  f( db->mallocFai
5150: 6c 65 64 20 29 7b 0a 20 20 20 20 73 50 61 72 73  led ){.    sPars
5160: 65 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f  e.rc = SQLITE_NO
5170: 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20  MEM_BKPT;.  }.  
5180: 69 66 28 20 70 7a 54 61 69 6c 20 29 7b 0a 20 20  if( pzTail ){.  
5190: 20 20 2a 70 7a 54 61 69 6c 20 3d 20 73 50 61 72    *pzTail = sPar
51a0: 73 65 2e 7a 54 61 69 6c 3b 0a 20 20 7d 0a 20 20  se.zTail;.  }.  
51b0: 72 63 20 3d 20 73 50 61 72 73 65 2e 72 63 3b 0a  rc = sParse.rc;.
51c0: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
51d0: 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20 69  OMIT_EXPLAIN.  i
51e0: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
51f0: 20 26 26 20 73 50 61 72 73 65 2e 70 56 64 62 65   && sParse.pVdbe
5200: 20 26 26 20 73 50 61 72 73 65 2e 65 78 70 6c 61   && sParse.expla
5210: 69 6e 20 29 7b 0a 20 20 20 20 73 74 61 74 69 63  in ){.    static
5220: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 20 63 6f   const char * co
5230: 6e 73 74 20 61 7a 43 6f 6c 4e 61 6d 65 5b 5d 20  nst azColName[] 
5240: 3d 20 7b 0a 20 20 20 20 20 20 20 22 61 64 64 72  = {.       "addr
5250: 22 2c 20 22 6f 70 63 6f 64 65 22 2c 20 22 70 31  ", "opcode", "p1
5260: 22 2c 20 22 70 32 22 2c 20 22 70 33 22 2c 20 22  ", "p2", "p3", "
5270: 70 34 22 2c 20 22 70 35 22 2c 20 22 63 6f 6d 6d  p4", "p5", "comm
5280: 65 6e 74 22 2c 0a 20 20 20 20 20 20 20 22 69 64  ent",.       "id
5290: 22 2c 20 22 70 61 72 65 6e 74 22 2c 20 22 6e 6f  ", "parent", "no
52a0: 74 75 73 65 64 22 2c 20 22 64 65 74 61 69 6c 22  tused", "detail"
52b0: 0a 20 20 20 20 7d 3b 0a 20 20 20 20 69 6e 74 20  .    };.    int 
52c0: 69 46 69 72 73 74 2c 20 6d 78 3b 0a 20 20 20 20  iFirst, mx;.    
52d0: 69 66 28 20 73 50 61 72 73 65 2e 65 78 70 6c 61  if( sParse.expla
52e0: 69 6e 3d 3d 32 20 29 7b 0a 20 20 20 20 20 20 73  in==2 ){.      s
52f0: 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e 75 6d  qlite3VdbeSetNum
5300: 43 6f 6c 73 28 73 50 61 72 73 65 2e 70 56 64 62  Cols(sParse.pVdb
5310: 65 2c 20 34 29 3b 0a 20 20 20 20 20 20 69 46 69  e, 4);.      iFi
5320: 72 73 74 20 3d 20 38 3b 0a 20 20 20 20 20 20 6d  rst = 8;.      m
5330: 78 20 3d 20 31 32 3b 0a 20 20 20 20 7d 65 6c 73  x = 12;.    }els
5340: 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  e{.      sqlite3
5350: 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28 73  VdbeSetNumCols(s
5360: 50 61 72 73 65 2e 70 56 64 62 65 2c 20 38 29 3b  Parse.pVdbe, 8);
5370: 0a 20 20 20 20 20 20 69 46 69 72 73 74 20 3d 20  .      iFirst = 
5380: 30 3b 0a 20 20 20 20 20 20 6d 78 20 3d 20 38 3b  0;.      mx = 8;
5390: 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 69  .    }.    for(i
53a0: 3d 69 46 69 72 73 74 3b 20 69 3c 6d 78 3b 20 69  =iFirst; i<mx; i
53b0: 2b 2b 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  ++){.      sqlit
53c0: 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65  e3VdbeSetColName
53d0: 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 69  (sParse.pVdbe, i
53e0: 2d 69 46 69 72 73 74 2c 20 43 4f 4c 4e 41 4d 45  -iFirst, COLNAME
53f0: 5f 4e 41 4d 45 2c 0a 20 20 20 20 20 20 20 20 20  _NAME,.         
5400: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
5410: 20 20 20 61 7a 43 6f 6c 4e 61 6d 65 5b 69 5d 2c     azColName[i],
5420: 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b   SQLITE_STATIC);
5430: 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69  .    }.  }.#endi
5440: 66 0a 0a 20 20 69 66 28 20 64 62 2d 3e 69 6e 69  f..  if( db->ini
5450: 74 2e 62 75 73 79 3d 3d 30 20 29 7b 0a 20 20 20  t.busy==0 ){.   
5460: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 53   sqlite3VdbeSetS
5470: 71 6c 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c  ql(sParse.pVdbe,
5480: 20 7a 53 71 6c 2c 20 28 69 6e 74 29 28 73 50 61   zSql, (int)(sPa
5490: 72 73 65 2e 7a 54 61 69 6c 2d 7a 53 71 6c 29 2c  rse.zTail-zSql),
54a0: 20 70 72 65 70 46 6c 61 67 73 29 3b 0a 20 20 7d   prepFlags);.  }
54b0: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 70 56  .  if( sParse.pV
54c0: 64 62 65 20 26 26 20 28 72 63 21 3d 53 51 4c 49  dbe && (rc!=SQLI
54d0: 54 45 5f 4f 4b 20 7c 7c 20 64 62 2d 3e 6d 61 6c  TE_OK || db->mal
54e0: 6c 6f 63 46 61 69 6c 65 64 29 20 29 7b 0a 20 20  locFailed) ){.  
54f0: 20 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 6e    sqlite3VdbeFin
5500: 61 6c 69 7a 65 28 73 50 61 72 73 65 2e 70 56 64  alize(sParse.pVd
5510: 62 65 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  be);.    assert(
5520: 21 28 2a 70 70 53 74 6d 74 29 29 3b 0a 20 20 7d  !(*ppStmt));.  }
5530: 65 6c 73 65 7b 0a 20 20 20 20 2a 70 70 53 74 6d  else{.    *ppStm
5540: 74 20 3d 20 28 73 71 6c 69 74 65 33 5f 73 74 6d  t = (sqlite3_stm
5550: 74 2a 29 73 50 61 72 73 65 2e 70 56 64 62 65 3b  t*)sParse.pVdbe;
5560: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 7a 45 72 72  .  }..  if( zErr
5570: 4d 73 67 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  Msg ){.    sqlit
5580: 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64  e3ErrorWithMsg(d
5590: 62 2c 20 72 63 2c 20 22 25 73 22 2c 20 7a 45 72  b, rc, "%s", zEr
55a0: 72 4d 73 67 29 3b 0a 20 20 20 20 73 71 6c 69 74  rMsg);.    sqlit
55b0: 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a 45 72  e3DbFree(db, zEr
55c0: 72 4d 73 67 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  rMsg);.  }else{.
55d0: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
55e0: 28 64 62 2c 20 72 63 29 3b 0a 20 20 7d 0a 0a 20  (db, rc);.  }.. 
55f0: 20 2f 2a 20 44 65 6c 65 74 65 20 61 6e 79 20 54   /* Delete any T
5600: 72 69 67 67 65 72 50 72 67 20 73 74 72 75 63 74  riggerPrg struct
5610: 75 72 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 77  ures allocated w
5620: 68 69 6c 65 20 70 61 72 73 69 6e 67 20 74 68 69  hile parsing thi
5630: 73 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a  s statement. */.
5640: 20 20 77 68 69 6c 65 28 20 73 50 61 72 73 65 2e    while( sParse.
5650: 70 54 72 69 67 67 65 72 50 72 67 20 29 7b 0a 20  pTriggerPrg ){. 
5660: 20 20 20 54 72 69 67 67 65 72 50 72 67 20 2a 70     TriggerPrg *p
5670: 54 20 3d 20 73 50 61 72 73 65 2e 70 54 72 69 67  T = sParse.pTrig
5680: 67 65 72 50 72 67 3b 0a 20 20 20 20 73 50 61 72  gerPrg;.    sPar
5690: 73 65 2e 70 54 72 69 67 67 65 72 50 72 67 20 3d  se.pTriggerPrg =
56a0: 20 70 54 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20   pT->pNext;.    
56b0: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62  sqlite3DbFree(db
56c0: 2c 20 70 54 29 3b 0a 20 20 7d 0a 0a 65 6e 64 5f  , pT);.  }..end_
56d0: 70 72 65 70 61 72 65 3a 0a 0a 20 20 73 71 6c 69  prepare:..  sqli
56e0: 74 65 33 50 61 72 73 65 72 52 65 73 65 74 28 26  te3ParserReset(&
56f0: 73 50 61 72 73 65 29 3b 0a 20 20 72 65 74 75 72  sParse);.  retur
5700: 6e 20 72 63 3b 0a 7d 0a 73 74 61 74 69 63 20 69  n rc;.}.static i
5710: 6e 74 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e  nt sqlite3LockAn
5720: 64 50 72 65 70 61 72 65 28 0a 20 20 73 71 6c 69  dPrepare(.  sqli
5730: 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20  te3 *db,        
5740: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73        /* Databas
5750: 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63  e handle. */.  c
5760: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c  onst char *zSql,
5770: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d           /* UTF-
5780: 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  8 encoded SQL st
5790: 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e  atement. */.  in
57a0: 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20  t nBytes,       
57b0: 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74          /* Lengt
57c0: 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74  h of zSql in byt
57d0: 65 73 2e 20 2a 2f 0a 20 20 75 33 32 20 70 72 65  es. */.  u32 pre
57e0: 70 46 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20  pFlags,         
57f0: 20 20 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f     /* Zero or mo
5800: 72 65 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52  re SQLITE_PREPAR
5810: 45 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a 20 20 56  E_* flags */.  V
5820: 64 62 65 20 2a 70 4f 6c 64 2c 20 20 20 20 20 20  dbe *pOld,      
5830: 20 20 20 20 20 20 20 20 20 2f 2a 20 56 4d 20 62           /* VM b
5840: 65 69 6e 67 20 72 65 70 72 65 70 61 72 65 64 20  eing reprepared 
5850: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d  */.  sqlite3_stm
5860: 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f  t **ppStmt,    /
5870: 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72  * OUT: A pointer
5880: 20 74 6f 20 74 68 65 20 70 72 65 70 61 72 65 64   to the prepared
5890: 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20   statement */.  
58a0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54  const char **pzT
58b0: 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54  ail       /* OUT
58c0: 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20  : End of parsed 
58d0: 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69  string */.){.  i
58e0: 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 63 6e 74  nt rc;.  int cnt
58f0: 20 3d 20 30 3b 0a 0a 23 69 66 64 65 66 20 53 51   = 0;..#ifdef SQ
5900: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f  LITE_ENABLE_API_
5910: 41 52 4d 4f 52 0a 20 20 69 66 28 20 70 70 53 74  ARMOR.  if( ppSt
5920: 6d 74 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53  mt==0 ) return S
5930: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50  QLITE_MISUSE_BKP
5940: 54 3b 0a 23 65 6e 64 69 66 0a 20 20 2a 70 70 53  T;.#endif.  *ppS
5950: 74 6d 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 21  tmt = 0;.  if( !
5960: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65  sqlite3SafetyChe
5970: 63 6b 4f 6b 28 64 62 29 7c 7c 7a 53 71 6c 3d 3d  ckOk(db)||zSql==
5980: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 ){.    return 
5990: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b  SQLITE_MISUSE_BK
59a0: 50 54 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  PT;.  }.  sqlite
59b0: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62  3_mutex_enter(db
59c0: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c 69  ->mutex);.  sqli
59d0: 74 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c 6c  te3BtreeEnterAll
59e0: 28 64 62 29 3b 0a 20 20 64 6f 7b 0a 20 20 20 20  (db);.  do{.    
59f0: 2f 2a 20 4d 61 6b 65 20 6d 75 6c 74 69 70 6c 65  /* Make multiple
5a00: 20 61 74 74 65 6d 70 74 73 20 74 6f 20 63 6f 6d   attempts to com
5a10: 70 69 6c 65 20 74 68 65 20 53 51 4c 2c 20 75 6e  pile the SQL, un
5a20: 74 69 6c 20 69 74 20 65 69 74 68 65 72 20 73 75  til it either su
5a30: 63 63 65 65 64 73 0a 20 20 20 20 2a 2a 20 6f 72  cceeds.    ** or
5a40: 20 65 6e 63 6f 75 6e 74 65 72 73 20 61 20 70 65   encounters a pe
5a50: 72 6d 61 6e 65 6e 74 20 65 72 72 6f 72 2e 20 20  rmanent error.  
5a60: 41 20 73 63 68 65 6d 61 20 70 72 6f 62 6c 65 6d  A schema problem
5a70: 20 61 66 74 65 72 20 6f 6e 65 20 73 63 68 65 6d   after one schem
5a80: 61 0a 20 20 20 20 2a 2a 20 72 65 73 65 74 20 69  a.    ** reset i
5a90: 73 20 63 6f 6e 73 69 64 65 72 65 64 20 61 20 70  s considered a p
5aa0: 65 72 6d 61 6e 65 6e 74 20 65 72 72 6f 72 2e 20  ermanent error. 
5ab0: 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  */.    rc = sqli
5ac0: 74 65 33 50 72 65 70 61 72 65 28 64 62 2c 20 7a  te3Prepare(db, z
5ad0: 53 71 6c 2c 20 6e 42 79 74 65 73 2c 20 70 72 65  Sql, nBytes, pre
5ae0: 70 46 6c 61 67 73 2c 20 70 4f 6c 64 2c 20 70 70  pFlags, pOld, pp
5af0: 53 74 6d 74 2c 20 70 7a 54 61 69 6c 29 3b 0a 20  Stmt, pzTail);. 
5b00: 20 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53     assert( rc==S
5b10: 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 2a 70 70 53  QLITE_OK || *ppS
5b20: 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 7d 77 68 69  tmt==0 );.  }whi
5b30: 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 45  le( rc==SQLITE_E
5b40: 52 52 4f 52 5f 52 45 54 52 59 0a 20 20 20 20 20  RROR_RETRY.     
5b50: 20 20 7c 7c 20 28 72 63 3d 3d 53 51 4c 49 54 45    || (rc==SQLITE
5b60: 5f 53 43 48 45 4d 41 20 26 26 20 28 73 71 6c 69  _SCHEMA && (sqli
5b70: 74 65 33 52 65 73 65 74 4f 6e 65 53 63 68 65 6d  te3ResetOneSchem
5b80: 61 28 64 62 2c 2d 31 29 2c 20 63 6e 74 2b 2b 29  a(db,-1), cnt++)
5b90: 3d 3d 30 29 20 29 3b 0a 20 20 73 71 6c 69 74 65  ==0) );.  sqlite
5ba0: 33 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64  3BtreeLeaveAll(d
5bb0: 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  b);.  rc = sqlit
5bc0: 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63  e3ApiExit(db, rc
5bd0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 72 63  );.  assert( (rc
5be0: 26 64 62 2d 3e 65 72 72 4d 61 73 6b 29 3d 3d 72  &db->errMask)==r
5bf0: 63 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d  c );.  sqlite3_m
5c00: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d  utex_leave(db->m
5c10: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20  utex);.  return 
5c20: 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52 65 72  rc;.}../*.** Rer
5c30: 75 6e 20 74 68 65 20 63 6f 6d 70 69 6c 61 74 69  un the compilati
5c40: 6f 6e 20 6f 66 20 61 20 73 74 61 74 65 6d 65 6e  on of a statemen
5c50: 74 20 61 66 74 65 72 20 61 20 73 63 68 65 6d 61  t after a schema
5c60: 20 63 68 61 6e 67 65 2e 0a 2a 2a 0a 2a 2a 20 49   change..**.** I
5c70: 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20  f the statement 
5c80: 69 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20  is successfully 
5c90: 72 65 63 6f 6d 70 69 6c 65 64 2c 20 72 65 74 75  recompiled, retu
5ca0: 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 4f 74  rn SQLITE_OK. Ot
5cb0: 68 65 72 77 69 73 65 2c 0a 2a 2a 20 69 66 20 74  herwise,.** if t
5cc0: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 63 61 6e  he statement can
5cd0: 6e 6f 74 20 62 65 20 72 65 63 6f 6d 70 69 6c 65  not be recompile
5ce0: 64 20 62 65 63 61 75 73 65 20 61 6e 6f 74 68 65  d because anothe
5cf0: 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 73  r connection has
5d00: 0a 2a 2a 20 6c 6f 63 6b 65 64 20 74 68 65 20 73  .** locked the s
5d10: 71 6c 69 74 65 33 5f 6d 61 73 74 65 72 20 74 61  qlite3_master ta
5d20: 62 6c 65 2c 20 72 65 74 75 72 6e 20 53 51 4c 49  ble, return SQLI
5d30: 54 45 5f 4c 4f 43 4b 45 44 2e 20 49 66 20 61 6e  TE_LOCKED. If an
5d40: 79 20 6f 74 68 65 72 20 65 72 72 6f 72 0a 2a 2a  y other error.**
5d50: 20 6f 63 63 75 72 73 2c 20 72 65 74 75 72 6e 20   occurs, return 
5d60: 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 2e 0a 2a  SQLITE_SCHEMA..*
5d70: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65 70  /.int sqlite3Rep
5d80: 72 65 70 61 72 65 28 56 64 62 65 20 2a 70 29 7b  repare(Vdbe *p){
5d90: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 71 6c  .  int rc;.  sql
5da0: 69 74 65 33 5f 73 74 6d 74 20 2a 70 4e 65 77 3b  ite3_stmt *pNew;
5db0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
5dc0: 53 71 6c 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a  Sql;.  sqlite3 *
5dd0: 64 62 3b 0a 20 20 75 38 20 70 72 65 70 46 6c 61  db;.  u8 prepFla
5de0: 67 73 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 73  gs;..  assert( s
5df0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
5e00: 64 28 73 71 6c 69 74 65 33 56 64 62 65 44 62 28  d(sqlite3VdbeDb(
5e10: 70 29 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20  p)->mutex) );.  
5e20: 7a 53 71 6c 20 3d 20 73 71 6c 69 74 65 33 5f 73  zSql = sqlite3_s
5e30: 71 6c 28 28 73 71 6c 69 74 65 33 5f 73 74 6d 74  ql((sqlite3_stmt
5e40: 20 2a 29 70 29 3b 0a 20 20 61 73 73 65 72 74 28   *)p);.  assert(
5e50: 20 7a 53 71 6c 21 3d 30 20 29 3b 20 20 2f 2a 20   zSql!=0 );  /* 
5e60: 52 65 70 72 65 70 61 72 65 20 6f 6e 6c 79 20 63  Reprepare only c
5e70: 61 6c 6c 65 64 20 66 6f 72 20 70 72 65 70 61 72  alled for prepar
5e80: 65 5f 76 32 28 29 20 73 74 61 74 65 6d 65 6e 74  e_v2() statement
5e90: 73 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 6c 69  s */.  db = sqli
5ea0: 74 65 33 56 64 62 65 44 62 28 70 29 3b 0a 20 20  te3VdbeDb(p);.  
5eb0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
5ec0: 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d  mutex_held(db->m
5ed0: 75 74 65 78 29 20 29 3b 0a 20 20 70 72 65 70 46  utex) );.  prepF
5ee0: 6c 61 67 73 20 3d 20 73 71 6c 69 74 65 33 56 64  lags = sqlite3Vd
5ef0: 62 65 50 72 65 70 61 72 65 46 6c 61 67 73 28 70  bePrepareFlags(p
5f00: 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65  );.  rc = sqlite
5f10: 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28  3LockAndPrepare(
5f20: 64 62 2c 20 7a 53 71 6c 2c 20 2d 31 2c 20 70 72  db, zSql, -1, pr
5f30: 65 70 46 6c 61 67 73 2c 20 70 2c 20 26 70 4e 65  epFlags, p, &pNe
5f40: 77 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 20  w, 0);.  if( rc 
5f50: 29 7b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53  ){.    if( rc==S
5f60: 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20  QLITE_NOMEM ){. 
5f70: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 6f 6d 46       sqlite3OomF
5f80: 61 75 6c 74 28 64 62 29 3b 0a 20 20 20 20 7d 0a  ault(db);.    }.
5f90: 20 20 20 20 61 73 73 65 72 74 28 20 70 4e 65 77      assert( pNew
5fa0: 3d 3d 30 20 29 3b 0a 20 20 20 20 72 65 74 75 72  ==0 );.    retur
5fb0: 6e 20 72 63 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  n rc;.  }else{. 
5fc0: 20 20 20 61 73 73 65 72 74 28 20 70 4e 65 77 21     assert( pNew!
5fd0: 3d 30 20 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69  =0 );.  }.  sqli
5fe0: 74 65 33 56 64 62 65 53 77 61 70 28 28 56 64 62  te3VdbeSwap((Vdb
5ff0: 65 2a 29 70 4e 65 77 2c 20 70 29 3b 0a 20 20 73  e*)pNew, p);.  s
6000: 71 6c 69 74 65 33 54 72 61 6e 73 66 65 72 42 69  qlite3TransferBi
6010: 6e 64 69 6e 67 73 28 70 4e 65 77 2c 20 28 73 71  ndings(pNew, (sq
6020: 6c 69 74 65 33 5f 73 74 6d 74 2a 29 70 29 3b 0a  lite3_stmt*)p);.
6030: 20 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73    sqlite3VdbeRes
6040: 65 74 53 74 65 70 52 65 73 75 6c 74 28 28 56 64  etStepResult((Vd
6050: 62 65 2a 29 70 4e 65 77 29 3b 0a 20 20 73 71 6c  be*)pNew);.  sql
6060: 69 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a 65  ite3VdbeFinalize
6070: 28 28 56 64 62 65 2a 29 70 4e 65 77 29 3b 0a 20  ((Vdbe*)pNew);. 
6080: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f   return SQLITE_O
6090: 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 77 6f  K;.}.../*.** Two
60a0: 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65   versions of the
60b0: 20 6f 66 66 69 63 69 61 6c 20 41 50 49 2e 20 20   official API.  
60c0: 4c 65 67 61 63 79 20 61 6e 64 20 6e 65 77 20 75  Legacy and new u
60d0: 73 65 2e 20 20 49 6e 20 74 68 65 20 6c 65 67 61  se.  In the lega
60e0: 63 79 0a 2a 2a 20 76 65 72 73 69 6f 6e 2c 20 74  cy.** version, t
60f0: 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 20  he original SQL 
6100: 74 65 78 74 20 69 73 20 6e 6f 74 20 73 61 76 65  text is not save
6110: 64 20 69 6e 20 74 68 65 20 70 72 65 70 61 72 65  d in the prepare
6120: 64 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 61  d statement.** a
6130: 6e 64 20 73 6f 20 69 66 20 61 20 73 63 68 65 6d  nd so if a schem
6140: 61 20 63 68 61 6e 67 65 20 6f 63 63 75 72 73 2c  a change occurs,
6150: 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 69   SQLITE_SCHEMA i
6160: 73 20 72 65 74 75 72 6e 65 64 20 62 79 0a 2a 2a  s returned by.**
6170: 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 2e   sqlite3_step().
6180: 20 20 49 6e 20 74 68 65 20 6e 65 77 20 76 65 72    In the new ver
6190: 73 69 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69 6e  sion, the origin
61a0: 61 6c 20 53 51 4c 20 74 65 78 74 20 69 73 20 72  al SQL text is r
61b0: 65 74 61 69 6e 65 64 0a 2a 2a 20 61 6e 64 20 74  etained.** and t
61c0: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20  he statement is 
61d0: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 65  automatically re
61e0: 63 6f 6d 70 69 6c 65 64 20 69 66 20 61 6e 20 73  compiled if an s
61f0: 63 68 65 6d 61 20 63 68 61 6e 67 65 0a 2a 2a 20  chema change.** 
6200: 6f 63 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74 20 73  occurs..*/.int s
6210: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 0a  qlite3_prepare(.
6220: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20    sqlite3 *db,  
6230: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44              /* D
6240: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20  atabase handle. 
6250: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
6260: 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f  *zSql,         /
6270: 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20  * UTF-8 encoded 
6280: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a  SQL statement. *
6290: 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20  /.  int nBytes, 
62a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
62b0: 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20   Length of zSql 
62c0: 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 73  in bytes. */.  s
62d0: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70  qlite3_stmt **pp
62e0: 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a  Stmt,    /* OUT:
62f0: 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68   A pointer to th
6300: 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  e prepared state
6310: 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20  ment */.  const 
6320: 63 68 61 72 20 2a 2a 70 7a 54 61 69 6c 20 20 20  char **pzTail   
6330: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20      /* OUT: End 
6340: 6f 66 20 70 61 72 73 65 64 20 73 74 72 69 6e 67  of parsed string
6350: 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b   */.){.  int rc;
6360: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4c  .  rc = sqlite3L
6370: 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28 64 62  ockAndPrepare(db
6380: 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 30 2c 30  ,zSql,nBytes,0,0
6390: 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29 3b  ,ppStmt,pzTail);
63a0: 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53  .  assert( rc==S
63b0: 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53 74  QLITE_OK || ppSt
63c0: 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d 74  mt==0 || *ppStmt
63d0: 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52 49 46  ==0 );  /* VERIF
63e0: 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20 20 72  Y: F13021 */.  r
63f0: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20  eturn rc;.}.int 
6400: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f  sqlite3_prepare_
6410: 76 32 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  v2(.  sqlite3 *d
6420: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  b,              
6430: 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64  /* Database hand
6440: 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  le. */.  const c
6450: 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20  har *zSql,      
6460: 20 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f     /* UTF-8 enco
6470: 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  ded SQL statemen
6480: 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74  t. */.  int nByt
6490: 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  es,             
64a0: 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a    /* Length of z
64b0: 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f  Sql in bytes. */
64c0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
64d0: 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20  **ppStmt,    /* 
64e0: 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74  OUT: A pointer t
64f0: 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73  o the prepared s
6500: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f  tatement */.  co
6510: 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 69  nst char **pzTai
6520: 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20  l       /* OUT: 
6530: 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74  End of parsed st
6540: 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74  ring */.){.  int
6550: 20 72 63 3b 0a 20 20 2f 2a 20 45 56 49 44 45 4e   rc;.  /* EVIDEN
6560: 43 45 2d 4f 46 3a 20 52 2d 33 37 39 32 33 2d 31  CE-OF: R-37923-1
6570: 32 31 37 33 20 54 68 65 20 73 71 6c 69 74 65 33  2173 The sqlite3
6580: 5f 70 72 65 70 61 72 65 5f 76 32 28 29 20 69 6e  _prepare_v2() in
6590: 74 65 72 66 61 63 65 20 77 6f 72 6b 73 0a 20 20  terface works.  
65a0: 2a 2a 20 65 78 61 63 74 6c 79 20 74 68 65 20 73  ** exactly the s
65b0: 61 6d 65 20 61 73 20 73 71 6c 69 74 65 33 5f 70  ame as sqlite3_p
65c0: 72 65 70 61 72 65 5f 76 33 28 29 20 77 69 74 68  repare_v3() with
65d0: 20 61 20 7a 65 72 6f 20 70 72 65 70 46 6c 61 67   a zero prepFlag
65e0: 73 0a 20 20 2a 2a 20 70 61 72 61 6d 65 74 65 72  s.  ** parameter
65f0: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 50 72 6f 6f  ..  **.  ** Proo
6600: 66 20 69 6e 20 74 68 61 74 20 74 68 65 20 35 74  f in that the 5t
6610: 68 20 70 61 72 61 6d 65 74 65 72 20 74 6f 20 73  h parameter to s
6620: 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65  qlite3LockAndPre
6630: 70 61 72 65 20 69 73 20 30 20 2a 2f 0a 20 20 72  pare is 0 */.  r
6640: 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41  c = sqlite3LockA
6650: 6e 64 50 72 65 70 61 72 65 28 64 62 2c 7a 53 71  ndPrepare(db,zSq
6660: 6c 2c 6e 42 79 74 65 73 2c 53 51 4c 49 54 45 5f  l,nBytes,SQLITE_
6670: 50 52 45 50 41 52 45 5f 53 41 56 45 53 51 4c 2c  PREPARE_SAVESQL,
6680: 30 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20  0,.             
6690: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
66a0: 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a  ppStmt,pzTail);.
66b0: 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51    assert( rc==SQ
66c0: 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d  LITE_OK || ppStm
66d0: 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d 74 3d  t==0 || *ppStmt=
66e0: 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72  =0 );.  return r
66f0: 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  c;.}.int sqlite3
6700: 5f 70 72 65 70 61 72 65 5f 76 33 28 0a 20 20 73  _prepare_v3(.  s
6710: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20  qlite3 *db,     
6720: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61           /* Data
6730: 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a  base handle. */.
6740: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53    const char *zS
6750: 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55  ql,         /* U
6760: 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 4c  TF-8 encoded SQL
6770: 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20   statement. */. 
6780: 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20   int nBytes,    
6790: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65             /* Le
67a0: 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20  ngth of zSql in 
67b0: 62 79 74 65 73 2e 20 2a 2f 0a 20 20 75 6e 73 69  bytes. */.  unsi
67c0: 67 6e 65 64 20 69 6e 74 20 70 72 65 70 46 6c 61  gned int prepFla
67d0: 67 73 2c 20 20 20 2f 2a 20 5a 65 72 6f 20 6f 72  gs,   /* Zero or
67e0: 20 6d 6f 72 65 20 53 51 4c 49 54 45 5f 50 52 45   more SQLITE_PRE
67f0: 50 41 52 45 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a  PARE_* flags */.
6800: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a    sqlite3_stmt *
6810: 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f  *ppStmt,    /* O
6820: 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f  UT: A pointer to
6830: 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74   the prepared st
6840: 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e  atement */.  con
6850: 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 69 6c  st char **pzTail
6860: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45         /* OUT: E
6870: 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74 72  nd of parsed str
6880: 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20  ing */.){.  int 
6890: 72 63 3b 0a 20 20 2f 2a 20 45 56 49 44 45 4e 43  rc;.  /* EVIDENC
68a0: 45 2d 4f 46 3a 20 52 2d 35 36 38 36 31 2d 34 32  E-OF: R-56861-42
68b0: 36 37 33 20 73 71 6c 69 74 65 33 5f 70 72 65 70  673 sqlite3_prep
68c0: 61 72 65 5f 76 33 28 29 20 64 69 66 66 65 72 73  are_v3() differs
68d0: 20 66 72 6f 6d 0a 20 20 2a 2a 20 73 71 6c 69 74   from.  ** sqlit
68e0: 65 33 5f 70 72 65 70 61 72 65 5f 76 32 28 29 20  e3_prepare_v2() 
68f0: 6f 6e 6c 79 20 69 6e 20 68 61 76 69 6e 67 20 74  only in having t
6900: 68 65 20 65 78 74 72 61 20 70 72 65 70 46 6c 61  he extra prepFla
6910: 67 73 20 70 61 72 61 6d 65 74 65 72 2c 0a 20 20  gs parameter,.  
6920: 2a 2a 20 77 68 69 63 68 20 69 73 20 61 20 62 69  ** which is a bi
6930: 74 20 61 72 72 61 79 20 63 6f 6e 73 69 73 74 69  t array consisti
6940: 6e 67 20 6f 66 20 7a 65 72 6f 20 6f 72 20 6d 6f  ng of zero or mo
6950: 72 65 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20 53  re of the.  ** S
6960: 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 2a 20  QLITE_PREPARE_* 
6970: 66 6c 61 67 73 2e 0a 20 20 2a 2a 0a 20 20 2a 2a  flags..  **.  **
6980: 20 50 72 6f 6f 66 20 62 79 20 63 6f 6d 70 61 72   Proof by compar
6990: 69 73 6f 6e 20 74 6f 20 74 68 65 20 69 6d 70 6c  ison to the impl
69a0: 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 73 71  ementation of sq
69b0: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76 32  lite3_prepare_v2
69c0: 28 29 0a 20 20 2a 2a 20 64 69 72 65 63 74 6c 79  ().  ** directly
69d0: 20 61 62 6f 76 65 2e 20 2a 2f 0a 20 20 72 63 20   above. */.  rc 
69e0: 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64  = sqlite3LockAnd
69f0: 50 72 65 70 61 72 65 28 64 62 2c 7a 53 71 6c 2c  Prepare(db,zSql,
6a00: 6e 42 79 74 65 73 2c 0a 20 20 20 20 20 20 20 20  nBytes,.        
6a10: 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f           SQLITE_
6a20: 50 52 45 50 41 52 45 5f 53 41 56 45 53 51 4c 7c  PREPARE_SAVESQL|
6a30: 28 70 72 65 70 46 6c 61 67 73 26 53 51 4c 49 54  (prepFlags&SQLIT
6a40: 45 5f 50 52 45 50 41 52 45 5f 4d 41 53 4b 29 2c  E_PREPARE_MASK),
6a50: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
6a60: 20 20 30 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69    0,ppStmt,pzTai
6a70: 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63  l);.  assert( rc
6a80: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70  ==SQLITE_OK || p
6a90: 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53  pStmt==0 || *ppS
6aa0: 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 72 65 74 75  tmt==0 );.  retu
6ab0: 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 23 69 66 6e 64  rn rc;.}...#ifnd
6ac0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  ef SQLITE_OMIT_U
6ad0: 54 46 31 36 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 69  TF16./*.** Compi
6ae0: 6c 65 20 74 68 65 20 55 54 46 2d 31 36 20 65 6e  le the UTF-16 en
6af0: 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d  coded SQL statem
6b00: 65 6e 74 20 7a 53 71 6c 20 69 6e 74 6f 20 61 20  ent zSql into a 
6b10: 73 74 61 74 65 6d 65 6e 74 20 68 61 6e 64 6c 65  statement handle
6b20: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20  ..*/.static int 
6b30: 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 31 36  sqlite3Prepare16
6b40: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c  (.  sqlite3 *db,
6b50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
6b60: 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   Database handle
6b70: 2e 20 2a 2f 20 0a 20 20 63 6f 6e 73 74 20 76 6f  . */ .  const vo
6b80: 69 64 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20  id *zSql,       
6b90: 20 20 2f 2a 20 55 54 46 2d 31 36 20 65 6e 63 6f    /* UTF-16 enco
6ba0: 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  ded SQL statemen
6bb0: 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74  t. */.  int nByt
6bc0: 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  es,             
6bd0: 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a    /* Length of z
6be0: 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f  Sql in bytes. */
6bf0: 0a 20 20 75 33 32 20 70 72 65 70 46 6c 61 67 73  .  u32 prepFlags
6c00: 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20  ,            /* 
6c10: 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 53 51 4c  Zero or more SQL
6c20: 49 54 45 5f 50 52 45 50 41 52 45 5f 2a 20 66 6c  ITE_PREPARE_* fl
6c30: 61 67 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ags */.  sqlite3
6c40: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
6c50: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69     /* OUT: A poi
6c60: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70  nter to the prep
6c70: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a  ared statement *
6c80: 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  /.  const void *
6c90: 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a  *pzTail       /*
6ca0: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72   OUT: End of par
6cb0: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b  sed string */.){
6cc0: 0a 20 20 2f 2a 20 54 68 69 73 20 66 75 6e 63 74  .  /* This funct
6cd0: 69 6f 6e 20 63 75 72 72 65 6e 74 6c 79 20 77 6f  ion currently wo
6ce0: 72 6b 73 20 62 79 20 66 69 72 73 74 20 74 72 61  rks by first tra
6cf0: 6e 73 66 6f 72 6d 69 6e 67 20 74 68 65 20 55 54  nsforming the UT
6d00: 46 2d 31 36 0a 20 20 2a 2a 20 65 6e 63 6f 64 65  F-16.  ** encode
6d10: 64 20 73 74 72 69 6e 67 20 74 6f 20 55 54 46 2d  d string to UTF-
6d20: 38 2c 20 74 68 65 6e 20 69 6e 76 6f 6b 69 6e 67  8, then invoking
6d30: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
6d40: 28 29 2e 20 54 68 65 0a 20 20 2a 2a 20 74 72 69  (). The.  ** tri
6d50: 63 6b 79 20 62 69 74 20 69 73 20 66 69 67 75 72  cky bit is figur
6d60: 69 6e 67 20 6f 75 74 20 74 68 65 20 70 6f 69 6e  ing out the poin
6d70: 74 65 72 20 74 6f 20 72 65 74 75 72 6e 20 69 6e  ter to return in
6d80: 20 2a 70 7a 54 61 69 6c 2e 0a 20 20 2a 2f 0a 20   *pzTail..  */. 
6d90: 20 63 68 61 72 20 2a 7a 53 71 6c 38 3b 0a 20 20   char *zSql8;.  
6da0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 61 69  const char *zTai
6db0: 6c 38 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63  l8 = 0;.  int rc
6dc0: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a 23   = SQLITE_OK;..#
6dd0: 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e 41  ifdef SQLITE_ENA
6de0: 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20 20  BLE_API_ARMOR.  
6df0: 69 66 28 20 70 70 53 74 6d 74 3d 3d 30 20 29 20  if( ppStmt==0 ) 
6e00: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49  return SQLITE_MI
6e10: 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64 69  SUSE_BKPT;.#endi
6e20: 66 0a 20 20 2a 70 70 53 74 6d 74 20 3d 20 30 3b  f.  *ppStmt = 0;
6e30: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 53  .  if( !sqlite3S
6e40: 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62 29  afetyCheckOk(db)
6e50: 7c 7c 7a 53 71 6c 3d 3d 30 20 29 7b 0a 20 20 20  ||zSql==0 ){.   
6e60: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d   return SQLITE_M
6e70: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a  ISUSE_BKPT;.  }.
6e80: 20 20 69 66 28 20 6e 42 79 74 65 73 3e 3d 30 20    if( nBytes>=0 
6e90: 29 7b 0a 20 20 20 20 69 6e 74 20 73 7a 3b 0a 20  ){.    int sz;. 
6ea0: 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a     const char *z
6eb0: 20 3d 20 28 63 6f 6e 73 74 20 63 68 61 72 2a 29   = (const char*)
6ec0: 7a 53 71 6c 3b 0a 20 20 20 20 66 6f 72 28 73 7a  zSql;.    for(sz
6ed0: 3d 30 3b 20 73 7a 3c 6e 42 79 74 65 73 20 26 26  =0; sz<nBytes &&
6ee0: 20 28 7a 5b 73 7a 5d 21 3d 30 20 7c 7c 20 7a 5b   (z[sz]!=0 || z[
6ef0: 73 7a 2b 31 5d 21 3d 30 29 3b 20 73 7a 20 2b 3d  sz+1]!=0); sz +=
6f00: 20 32 29 7b 7d 0a 20 20 20 20 6e 42 79 74 65 73   2){}.    nBytes
6f10: 20 3d 20 73 7a 3b 0a 20 20 7d 0a 20 20 73 71 6c   = sz;.  }.  sql
6f20: 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72  ite3_mutex_enter
6f30: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 7a  (db->mutex);.  z
6f40: 53 71 6c 38 20 3d 20 73 71 6c 69 74 65 33 55 74  Sql8 = sqlite3Ut
6f50: 66 31 36 74 6f 38 28 64 62 2c 20 7a 53 71 6c 2c  f16to8(db, zSql,
6f60: 20 6e 42 79 74 65 73 2c 20 53 51 4c 49 54 45 5f   nBytes, SQLITE_
6f70: 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 20 20  UTF16NATIVE);.  
6f80: 69 66 28 20 7a 53 71 6c 38 20 29 7b 0a 20 20 20  if( zSql8 ){.   
6f90: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f 63   rc = sqlite3Loc
6fa0: 6b 41 6e 64 50 72 65 70 61 72 65 28 64 62 2c 20  kAndPrepare(db, 
6fb0: 7a 53 71 6c 38 2c 20 2d 31 2c 20 70 72 65 70 46  zSql8, -1, prepF
6fc0: 6c 61 67 73 2c 20 30 2c 20 70 70 53 74 6d 74 2c  lags, 0, ppStmt,
6fd0: 20 26 7a 54 61 69 6c 38 29 3b 0a 20 20 7d 0a 0a   &zTail8);.  }..
6fe0: 20 20 69 66 28 20 7a 54 61 69 6c 38 20 26 26 20    if( zTail8 && 
6ff0: 70 7a 54 61 69 6c 20 29 7b 0a 20 20 20 20 2f 2a  pzTail ){.    /*
7000: 20 49 66 20 73 71 6c 69 74 65 33 5f 70 72 65 70   If sqlite3_prep
7010: 61 72 65 20 72 65 74 75 72 6e 73 20 61 20 74 61  are returns a ta
7020: 69 6c 20 70 6f 69 6e 74 65 72 2c 20 77 65 20 63  il pointer, we c
7030: 61 6c 63 75 6c 61 74 65 20 74 68 65 0a 20 20 20  alculate the.   
7040: 20 2a 2a 20 65 71 75 69 76 61 6c 65 6e 74 20 70   ** equivalent p
7050: 6f 69 6e 74 65 72 20 69 6e 74 6f 20 74 68 65 20  ointer into the 
7060: 55 54 46 2d 31 36 20 73 74 72 69 6e 67 20 62 79  UTF-16 string by
7070: 20 63 6f 75 6e 74 69 6e 67 20 74 68 65 20 75 6e   counting the un
7080: 69 63 6f 64 65 0a 20 20 20 20 2a 2a 20 63 68 61  icode.    ** cha
7090: 72 61 63 74 65 72 73 20 62 65 74 77 65 65 6e 20  racters between 
70a0: 7a 53 71 6c 38 20 61 6e 64 20 7a 54 61 69 6c 38  zSql8 and zTail8
70b0: 2c 20 61 6e 64 20 74 68 65 6e 20 72 65 74 75 72  , and then retur
70c0: 6e 69 6e 67 20 61 20 70 6f 69 6e 74 65 72 0a 20  ning a pointer. 
70d0: 20 20 20 2a 2a 20 74 68 65 20 73 61 6d 65 20 6e     ** the same n
70e0: 75 6d 62 65 72 20 6f 66 20 63 68 61 72 61 63 74  umber of charact
70f0: 65 72 73 20 69 6e 74 6f 20 74 68 65 20 55 54 46  ers into the UTF
7100: 2d 31 36 20 73 74 72 69 6e 67 2e 0a 20 20 20 20  -16 string..    
7110: 2a 2f 0a 20 20 20 20 69 6e 74 20 63 68 61 72 73  */.    int chars
7120: 5f 70 61 72 73 65 64 20 3d 20 73 71 6c 69 74 65  _parsed = sqlite
7130: 33 55 74 66 38 43 68 61 72 4c 65 6e 28 7a 53 71  3Utf8CharLen(zSq
7140: 6c 38 2c 20 28 69 6e 74 29 28 7a 54 61 69 6c 38  l8, (int)(zTail8
7150: 2d 7a 53 71 6c 38 29 29 3b 0a 20 20 20 20 2a 70  -zSql8));.    *p
7160: 7a 54 61 69 6c 20 3d 20 28 75 38 20 2a 29 7a 53  zTail = (u8 *)zS
7170: 71 6c 20 2b 20 73 71 6c 69 74 65 33 55 74 66 31  ql + sqlite3Utf1
7180: 36 42 79 74 65 4c 65 6e 28 7a 53 71 6c 2c 20 63  6ByteLen(zSql, c
7190: 68 61 72 73 5f 70 61 72 73 65 64 29 3b 0a 20 20  hars_parsed);.  
71a0: 7d 0a 20 20 73 71 6c 69 74 65 33 44 62 46 72 65  }.  sqlite3DbFre
71b0: 65 28 64 62 2c 20 7a 53 71 6c 38 29 3b 20 0a 20  e(db, zSql8); . 
71c0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69   rc = sqlite3Api
71d0: 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20  Exit(db, rc);.  
71e0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65  sqlite3_mutex_le
71f0: 61 76 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  ave(db->mutex);.
7200: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
7210: 2f 2a 0a 2a 2a 20 54 77 6f 20 76 65 72 73 69 6f  /*.** Two versio
7220: 6e 73 20 6f 66 20 74 68 65 20 6f 66 66 69 63 69  ns of the offici
7230: 61 6c 20 41 50 49 2e 20 20 4c 65 67 61 63 79 20  al API.  Legacy 
7240: 61 6e 64 20 6e 65 77 20 75 73 65 2e 20 20 49 6e  and new use.  In
7250: 20 74 68 65 20 6c 65 67 61 63 79 0a 2a 2a 20 76   the legacy.** v
7260: 65 72 73 69 6f 6e 2c 20 74 68 65 20 6f 72 69 67  ersion, the orig
7270: 69 6e 61 6c 20 53 51 4c 20 74 65 78 74 20 69 73  inal SQL text is
7280: 20 6e 6f 74 20 73 61 76 65 64 20 69 6e 20 74 68   not saved in th
7290: 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  e prepared state
72a0: 6d 65 6e 74 0a 2a 2a 20 61 6e 64 20 73 6f 20 69  ment.** and so i
72b0: 66 20 61 20 73 63 68 65 6d 61 20 63 68 61 6e 67  f a schema chang
72c0: 65 20 6f 63 63 75 72 73 2c 20 53 51 4c 49 54 45  e occurs, SQLITE
72d0: 5f 53 43 48 45 4d 41 20 69 73 20 72 65 74 75 72  _SCHEMA is retur
72e0: 6e 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65  ned by.** sqlite
72f0: 33 5f 73 74 65 70 28 29 2e 20 20 49 6e 20 74 68  3_step().  In th
7300: 65 20 6e 65 77 20 76 65 72 73 69 6f 6e 2c 20 74  e new version, t
7310: 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 20  he original SQL 
7320: 74 65 78 74 20 69 73 20 72 65 74 61 69 6e 65 64  text is retained
7330: 0a 2a 2a 20 61 6e 64 20 74 68 65 20 73 74 61 74  .** and the stat
7340: 65 6d 65 6e 74 20 69 73 20 61 75 74 6f 6d 61 74  ement is automat
7350: 69 63 61 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65  ically recompile
7360: 64 20 69 66 20 61 6e 20 73 63 68 65 6d 61 20 63  d if an schema c
7370: 68 61 6e 67 65 0a 2a 2a 20 6f 63 63 75 72 73 2e  hange.** occurs.
7380: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f  .*/.int sqlite3_
7390: 70 72 65 70 61 72 65 31 36 28 0a 20 20 73 71 6c  prepare16(.  sql
73a0: 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20  ite3 *db,       
73b0: 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61         /* Databa
73c0: 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20  se handle. */ . 
73d0: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53 71   const void *zSq
73e0: 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54  l,         /* UT
73f0: 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 53 51 4c  F-16 encoded SQL
7400: 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20   statement. */. 
7410: 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20   int nBytes,    
7420: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65             /* Le
7430: 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20  ngth of zSql in 
7440: 62 79 74 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69  bytes. */.  sqli
7450: 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d  te3_stmt **ppStm
7460: 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20  t,    /* OUT: A 
7470: 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70  pointer to the p
7480: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e  repared statemen
7490: 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69  t */.  const voi
74a0: 64 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20 20  d **pzTail      
74b0: 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20   /* OUT: End of 
74c0: 70 61 72 73 65 64 20 73 74 72 69 6e 67 20 2a 2f  parsed string */
74d0: 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20  .){.  int rc;.  
74e0: 72 63 20 3d 20 73 71 6c 69 74 65 33 50 72 65 70  rc = sqlite3Prep
74f0: 61 72 65 31 36 28 64 62 2c 7a 53 71 6c 2c 6e 42  are16(db,zSql,nB
7500: 79 74 65 73 2c 30 2c 70 70 53 74 6d 74 2c 70 7a  ytes,0,ppStmt,pz
7510: 54 61 69 6c 29 3b 0a 20 20 61 73 73 65 72 74 28  Tail);.  assert(
7520: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c   rc==SQLITE_OK |
7530: 7c 20 70 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a  | ppStmt==0 || *
7540: 70 70 53 74 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a  ppStmt==0 );  /*
7550: 20 56 45 52 49 46 59 3a 20 46 31 33 30 32 31 20   VERIFY: F13021 
7560: 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a  */.  return rc;.
7570: 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72  }.int sqlite3_pr
7580: 65 70 61 72 65 31 36 5f 76 32 28 0a 20 20 73 71  epare16_v2(.  sq
7590: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20  lite3 *db,      
75a0: 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62          /* Datab
75b0: 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a  ase handle. */ .
75c0: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53    const void *zS
75d0: 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55  ql,         /* U
75e0: 54 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 53 51  TF-16 encoded SQ
75f0: 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a  L statement. */.
7600: 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20    int nBytes,   
7610: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c              /* L
7620: 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e  ength of zSql in
7630: 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 73 71 6c   bytes. */.  sql
7640: 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74  ite3_stmt **ppSt
7650: 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41  mt,    /* OUT: A
7660: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20   pointer to the 
7670: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  prepared stateme
7680: 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f  nt */.  const vo
7690: 69 64 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20  id **pzTail     
76a0: 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66    /* OUT: End of
76b0: 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20 2a   parsed string *
76c0: 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  /.){.  int rc;. 
76d0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 72 65   rc = sqlite3Pre
76e0: 70 61 72 65 31 36 28 64 62 2c 7a 53 71 6c 2c 6e  pare16(db,zSql,n
76f0: 42 79 74 65 73 2c 53 51 4c 49 54 45 5f 50 52 45  Bytes,SQLITE_PRE
7700: 50 41 52 45 5f 53 41 56 45 53 51 4c 2c 70 70 53  PARE_SAVESQL,ppS
7710: 74 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a 20 20 61  tmt,pzTail);.  a
7720: 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54  ssert( rc==SQLIT
7730: 45 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d 74 3d 3d  E_OK || ppStmt==
7740: 30 20 7c 7c 20 2a 70 70 53 74 6d 74 3d 3d 30 20  0 || *ppStmt==0 
7750: 29 3b 20 20 2f 2a 20 56 45 52 49 46 59 3a 20 46  );  /* VERIFY: F
7760: 31 33 30 32 31 20 2a 2f 0a 20 20 72 65 74 75 72  13021 */.  retur
7770: 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69  n rc;.}.int sqli
7780: 74 65 33 5f 70 72 65 70 61 72 65 31 36 5f 76 33  te3_prepare16_v3
7790: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c  (.  sqlite3 *db,
77a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a                /*
77b0: 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65   Database handle
77c0: 2e 20 2a 2f 20 0a 20 20 63 6f 6e 73 74 20 76 6f  . */ .  const vo
77d0: 69 64 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20  id *zSql,       
77e0: 20 20 2f 2a 20 55 54 46 2d 31 36 20 65 6e 63 6f    /* UTF-16 enco
77f0: 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  ded SQL statemen
7800: 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74  t. */.  int nByt
7810: 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  es,             
7820: 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a    /* Length of z
7830: 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f  Sql in bytes. */
7840: 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20  .  unsigned int 
7850: 70 72 65 70 46 6c 61 67 73 2c 20 20 20 2f 2a 20  prepFlags,   /* 
7860: 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 53 51 4c  Zero or more SQL
7870: 49 54 45 5f 50 52 45 50 41 52 45 5f 2a 20 66 6c  ITE_PREPARE_* fl
7880: 61 67 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  ags */.  sqlite3
7890: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
78a0: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69     /* OUT: A poi
78b0: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70  nter to the prep
78c0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a  ared statement *
78d0: 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  /.  const void *
78e0: 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a  *pzTail       /*
78f0: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72   OUT: End of par
7900: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b  sed string */.){
7910: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20  .  int rc;.  rc 
7920: 3d 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65  = sqlite3Prepare
7930: 31 36 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65  16(db,zSql,nByte
7940: 73 2c 0a 20 20 20 20 20 20 20 20 20 53 51 4c 49  s,.         SQLI
7950: 54 45 5f 50 52 45 50 41 52 45 5f 53 41 56 45 53  TE_PREPARE_SAVES
7960: 51 4c 7c 28 70 72 65 70 46 6c 61 67 73 26 53 51  QL|(prepFlags&SQ
7970: 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 4d 41 53  LITE_PREPARE_MAS
7980: 4b 29 2c 0a 20 20 20 20 20 20 20 20 20 70 70 53  K),.         ppS
7990: 74 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a 20 20 61  tmt,pzTail);.  a
79a0: 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54  ssert( rc==SQLIT
79b0: 45 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d 74 3d 3d  E_OK || ppStmt==
79c0: 30 20 7c 7c 20 2a 70 70 53 74 6d 74 3d 3d 30 20  0 || *ppStmt==0 
79d0: 29 3b 20 20 2f 2a 20 56 45 52 49 46 59 3a 20 46  );  /* VERIFY: F
79e0: 31 33 30 32 31 20 2a 2f 0a 20 20 72 65 74 75 72  13021 */.  retur
79f0: 6e 20 72 63 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20  n rc;.}..#endif 
7a00: 2f 2a 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55  /* SQLITE_OMIT_U
7a10: 54 46 31 36 20 2a 2f 0a                          TF16 */.