/ Hex Artifact Content
Login

Artifact 0ad1ba3290e0626aa4e7589ed6ab6af2572875b0:


0000: 2f 2a 0a 2a 2a 20 32 30 30 35 20 4d 61 79 20 32  /*.** 2005 May 2
0010: 35 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  5.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63 6f  .** This file co
0180: 6e 74 61 69 6e 73 20 74 68 65 20 69 6d 70 6c 65  ntains the imple
0190: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
01a0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
01b0: 28 29 0a 2a 2a 20 69 6e 74 65 72 66 61 63 65 2c  ().** interface,
01c0: 20 61 6e 64 20 72 6f 75 74 69 6e 65 73 20 74 68   and routines th
01d0: 61 74 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f  at contribute to
01e0: 20 6c 6f 61 64 69 6e 67 20 74 68 65 20 64 61 74   loading the dat
01f0: 61 62 61 73 65 20 73 63 68 65 6d 61 0a 2a 2a 20  abase schema.** 
0200: 66 72 6f 6d 20 64 69 73 6b 2e 0a 2a 2a 0a 2a 2a  from disk..**.**
0210: 20 24 49 64 3a 20 70 72 65 70 61 72 65 2e 63 2c   $Id: prepare.c,
0220: 76 20 31 2e 31 31 36 20 32 30 30 39 2f 30 34 2f  v 1.116 2009/04/
0230: 30 32 20 31 38 3a 33 32 3a 32 37 20 64 72 68 20  02 18:32:27 drh 
0240: 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75 64  Exp $.*/.#includ
0250: 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a  e "sqliteInt.h".
0260: 0a 2f 2a 0a 2a 2a 20 46 69 6c 6c 20 74 68 65 20  ./*.** Fill the 
0270: 49 6e 69 74 44 61 74 61 20 73 74 72 75 63 74 75  InitData structu
0280: 72 65 20 77 69 74 68 20 61 6e 20 65 72 72 6f 72  re with an error
0290: 20 6d 65 73 73 61 67 65 20 74 68 61 74 20 69 6e   message that in
02a0: 64 69 63 61 74 65 73 0a 2a 2a 20 74 68 61 74 20  dicates.** that 
02b0: 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20  the database is 
02c0: 63 6f 72 72 75 70 74 2e 0a 2a 2f 0a 73 74 61 74  corrupt..*/.stat
02d0: 69 63 20 76 6f 69 64 20 63 6f 72 72 75 70 74 53  ic void corruptS
02e0: 63 68 65 6d 61 28 0a 20 20 49 6e 69 74 44 61 74  chema(.  InitDat
02f0: 61 20 2a 70 44 61 74 61 2c 20 20 20 20 20 2f 2a  a *pData,     /*
0300: 20 49 6e 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20   Initialization 
0310: 63 6f 6e 74 65 78 74 20 2a 2f 0a 20 20 63 6f 6e  context */.  con
0320: 73 74 20 63 68 61 72 20 2a 7a 4f 62 6a 2c 20 20  st char *zObj,  
0330: 20 20 2f 2a 20 4f 62 6a 65 63 74 20 62 65 69 6e    /* Object bein
0340: 67 20 70 61 72 73 65 64 20 61 74 20 74 68 65 20  g parsed at the 
0350: 70 6f 69 6e 74 20 6f 66 20 65 72 72 6f 72 20 2a  point of error *
0360: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
0370: 7a 45 78 74 72 61 20 20 20 2f 2a 20 45 72 72 6f  zExtra   /* Erro
0380: 72 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 2a 2f  r information */
0390: 0a 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  .){.  sqlite3 *d
03a0: 62 20 3d 20 70 44 61 74 61 2d 3e 64 62 3b 0a 20  b = pData->db;. 
03b0: 20 69 66 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63   if( !db->malloc
03c0: 46 61 69 6c 65 64 20 26 26 20 28 64 62 2d 3e 66  Failed && (db->f
03d0: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65  lags & SQLITE_Re
03e0: 63 6f 76 65 72 79 4d 6f 64 65 29 3d 3d 30 20 29  coveryMode)==0 )
03f0: 7b 0a 20 20 20 20 69 66 28 20 7a 4f 62 6a 3d 3d  {.    if( zObj==
0400: 30 20 29 20 7a 4f 62 6a 20 3d 20 22 3f 22 3b 0a  0 ) zObj = "?";.
0410: 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74      sqlite3SetSt
0420: 72 69 6e 67 28 70 44 61 74 61 2d 3e 70 7a 45 72  ring(pData->pzEr
0430: 72 4d 73 67 2c 20 70 44 61 74 61 2d 3e 64 62 2c  rMsg, pData->db,
0440: 0a 20 20 20 20 20 20 20 22 6d 61 6c 66 6f 72 6d  .       "malform
0450: 65 64 20 64 61 74 61 62 61 73 65 20 73 63 68 65  ed database sche
0460: 6d 61 20 28 25 73 29 22 2c 20 7a 4f 62 6a 29 3b  ma (%s)", zObj);
0470: 0a 20 20 20 20 69 66 28 20 7a 45 78 74 72 61 20  .    if( zExtra 
0480: 26 26 20 7a 45 78 74 72 61 5b 30 5d 20 29 7b 0a  && zExtra[0] ){.
0490: 20 20 20 20 20 20 2a 70 44 61 74 61 2d 3e 70 7a        *pData->pz
04a0: 45 72 72 4d 73 67 20 3d 20 73 71 6c 69 74 65 33  ErrMsg = sqlite3
04b0: 4d 41 70 70 65 6e 64 66 28 70 44 61 74 61 2d 3e  MAppendf(pData->
04c0: 64 62 2c 20 2a 70 44 61 74 61 2d 3e 70 7a 45 72  db, *pData->pzEr
04d0: 72 4d 73 67 2c 20 22 25 73 20 2d 20 25 73 22 2c  rMsg, "%s - %s",
04e0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
04f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0500: 20 20 20 2a 70 44 61 74 61 2d 3e 70 7a 45 72 72     *pData->pzErr
0510: 4d 73 67 2c 20 7a 45 78 74 72 61 29 3b 0a 20 20  Msg, zExtra);.  
0520: 20 20 7d 0a 20 20 7d 0a 20 20 70 44 61 74 61 2d    }.  }.  pData-
0530: 3e 72 63 20 3d 20 53 51 4c 49 54 45 5f 43 4f 52  >rc = SQLITE_COR
0540: 52 55 50 54 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54  RUPT;.}../*.** T
0550: 68 69 73 20 69 73 20 74 68 65 20 63 61 6c 6c 62  his is the callb
0560: 61 63 6b 20 72 6f 75 74 69 6e 65 20 66 6f 72 20  ack routine for 
0570: 74 68 65 20 63 6f 64 65 20 74 68 61 74 20 69 6e  the code that in
0580: 69 74 69 61 6c 69 7a 65 73 20 74 68 65 0a 2a 2a  itializes the.**
0590: 20 64 61 74 61 62 61 73 65 2e 20 20 53 65 65 20   database.  See 
05a0: 73 71 6c 69 74 65 33 49 6e 69 74 28 29 20 62 65  sqlite3Init() be
05b0: 6c 6f 77 20 66 6f 72 20 61 64 64 69 74 69 6f 6e  low for addition
05c0: 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a  al information..
05d0: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20  ** This routine 
05e0: 69 73 20 61 6c 73 6f 20 63 61 6c 6c 65 64 20 66  is also called f
05f0: 72 6f 6d 20 74 68 65 20 4f 50 5f 50 61 72 73 65  rom the OP_Parse
0600: 53 63 68 65 6d 61 20 6f 70 63 6f 64 65 20 6f 66  Schema opcode of
0610: 20 74 68 65 20 56 44 42 45 2e 0a 2a 2a 0a 2a 2a   the VDBE..**.**
0620: 20 45 61 63 68 20 63 61 6c 6c 62 61 63 6b 20 63   Each callback c
0630: 6f 6e 74 61 69 6e 73 20 74 68 65 20 66 6f 6c 6c  ontains the foll
0640: 6f 77 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f  owing informatio
0650: 6e 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 72 67  n:.**.**     arg
0660: 76 5b 30 5d 20 3d 20 6e 61 6d 65 20 6f 66 20 74  v[0] = name of t
0670: 68 69 6e 67 20 62 65 69 6e 67 20 63 72 65 61 74  hing being creat
0680: 65 64 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 31  ed.**     argv[1
0690: 5d 20 3d 20 72 6f 6f 74 20 70 61 67 65 20 6e 75  ] = root page nu
06a0: 6d 62 65 72 20 66 6f 72 20 74 61 62 6c 65 20 6f  mber for table o
06b0: 72 20 69 6e 64 65 78 2e 20 30 20 66 6f 72 20 74  r index. 0 for t
06c0: 72 69 67 67 65 72 20 6f 72 20 76 69 65 77 2e 0a  rigger or view..
06d0: 2a 2a 20 20 20 20 20 61 72 67 76 5b 32 5d 20 3d  **     argv[2] =
06e0: 20 53 51 4c 20 74 65 78 74 20 66 6f 72 20 74 68   SQL text for th
06f0: 65 20 43 52 45 41 54 45 20 73 74 61 74 65 6d 65  e CREATE stateme
0700: 6e 74 2e 0a 2a 2a 0a 2a 2f 0a 69 6e 74 20 73 71  nt..**.*/.int sq
0710: 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63  lite3InitCallbac
0720: 6b 28 76 6f 69 64 20 2a 70 49 6e 69 74 2c 20 69  k(void *pInit, i
0730: 6e 74 20 61 72 67 63 2c 20 63 68 61 72 20 2a 2a  nt argc, char **
0740: 61 72 67 76 2c 20 63 68 61 72 20 2a 2a 4e 6f 74  argv, char **Not
0750: 55 73 65 64 29 7b 0a 20 20 49 6e 69 74 44 61 74  Used){.  InitDat
0760: 61 20 2a 70 44 61 74 61 20 3d 20 28 49 6e 69 74  a *pData = (Init
0770: 44 61 74 61 2a 29 70 49 6e 69 74 3b 0a 20 20 73  Data*)pInit;.  s
0780: 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 44 61  qlite3 *db = pDa
0790: 74 61 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 69 44  ta->db;.  int iD
07a0: 62 20 3d 20 70 44 61 74 61 2d 3e 69 44 62 3b 0a  b = pData->iDb;.
07b0: 0a 20 20 61 73 73 65 72 74 28 20 61 72 67 63 3d  .  assert( argc=
07c0: 3d 33 20 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50  =3 );.  UNUSED_P
07d0: 41 52 41 4d 45 54 45 52 32 28 4e 6f 74 55 73 65  ARAMETER2(NotUse
07e0: 64 2c 20 61 72 67 63 29 3b 0a 20 20 61 73 73 65  d, argc);.  asse
07f0: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
0800: 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78  x_held(db->mutex
0810: 29 20 29 3b 0a 20 20 44 62 43 6c 65 61 72 50 72  ) );.  DbClearPr
0820: 6f 70 65 72 74 79 28 64 62 2c 20 69 44 62 2c 20  operty(db, iDb, 
0830: 44 42 5f 45 6d 70 74 79 29 3b 0a 20 20 69 66 28  DB_Empty);.  if(
0840: 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65   db->mallocFaile
0850: 64 20 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74  d ){.    corrupt
0860: 53 63 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72  Schema(pData, ar
0870: 67 76 5b 30 5d 2c 20 30 29 3b 0a 20 20 20 20 72  gv[0], 0);.    r
0880: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f 4d  eturn SQLITE_NOM
0890: 45 4d 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72  EM;.  }..  asser
08a0: 74 28 20 69 44 62 3e 3d 30 20 26 26 20 69 44 62  t( iDb>=0 && iDb
08b0: 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20 20 69 66  <db->nDb );.  if
08c0: 28 20 61 72 67 76 3d 3d 30 20 29 20 72 65 74 75  ( argv==0 ) retu
08d0: 72 6e 20 30 3b 20 20 20 2f 2a 20 4d 69 67 68 74  rn 0;   /* Might
08e0: 20 68 61 70 70 65 6e 20 69 66 20 45 4d 50 54 59   happen if EMPTY
08f0: 5f 52 45 53 55 4c 54 5f 43 41 4c 4c 42 41 43 4b  _RESULT_CALLBACK
0900: 53 20 61 72 65 20 6f 6e 20 2a 2f 0a 20 20 69 66  S are on */.  if
0910: 28 20 61 72 67 76 5b 31 5d 3d 3d 30 20 29 7b 0a  ( argv[1]==0 ){.
0920: 20 20 20 20 63 6f 72 72 75 70 74 53 63 68 65 6d      corruptSchem
0930: 61 28 70 44 61 74 61 2c 20 61 72 67 76 5b 30 5d  a(pData, argv[0]
0940: 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66  , 0);.  }else if
0950: 28 20 61 72 67 76 5b 32 5d 20 26 26 20 61 72 67  ( argv[2] && arg
0960: 76 5b 32 5d 5b 30 5d 20 29 7b 0a 20 20 20 20 2f  v[2][0] ){.    /
0970: 2a 20 43 61 6c 6c 20 74 68 65 20 70 61 72 73 65  * Call the parse
0980: 72 20 74 6f 20 70 72 6f 63 65 73 73 20 61 20 43  r to process a C
0990: 52 45 41 54 45 20 54 41 42 4c 45 2c 20 49 4e 44  REATE TABLE, IND
09a0: 45 58 20 6f 72 20 56 49 45 57 2e 0a 20 20 20 20  EX or VIEW..    
09b0: 2a 2a 20 42 75 74 20 62 65 63 61 75 73 65 20 64  ** But because d
09c0: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 69 73 20  b->init.busy is 
09d0: 73 65 74 20 74 6f 20 31 2c 20 6e 6f 20 56 44 42  set to 1, no VDB
09e0: 45 20 63 6f 64 65 20 69 73 20 67 65 6e 65 72 61  E code is genera
09f0: 74 65 64 0a 20 20 20 20 2a 2a 20 6f 72 20 65 78  ted.    ** or ex
0a00: 65 63 75 74 65 64 2e 20 20 41 6c 6c 20 74 68 65  ecuted.  All the
0a10: 20 70 61 72 73 65 72 20 64 6f 65 73 20 69 73 20   parser does is 
0a20: 62 75 69 6c 64 20 74 68 65 20 69 6e 74 65 72 6e  build the intern
0a30: 61 6c 20 64 61 74 61 0a 20 20 20 20 2a 2a 20 73  al data.    ** s
0a40: 74 72 75 63 74 75 72 65 73 20 74 68 61 74 20 64  tructures that d
0a50: 65 73 63 72 69 62 65 20 74 68 65 20 74 61 62 6c  escribe the tabl
0a60: 65 2c 20 69 6e 64 65 78 2c 20 6f 72 20 76 69 65  e, index, or vie
0a70: 77 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 63 68  w..    */.    ch
0a80: 61 72 20 2a 7a 45 72 72 3b 0a 20 20 20 20 69 6e  ar *zErr;.    in
0a90: 74 20 72 63 3b 0a 20 20 20 20 61 73 73 65 72 74  t rc;.    assert
0aa0: 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20  ( db->init.busy 
0ab0: 29 3b 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e  );.    db->init.
0ac0: 69 44 62 20 3d 20 69 44 62 3b 0a 20 20 20 20 64  iDb = iDb;.    d
0ad0: 62 2d 3e 69 6e 69 74 2e 6e 65 77 54 6e 75 6d 20  b->init.newTnum 
0ae0: 3d 20 61 74 6f 69 28 61 72 67 76 5b 31 5d 29 3b  = atoi(argv[1]);
0af0: 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65  .    rc = sqlite
0b00: 33 5f 65 78 65 63 28 64 62 2c 20 61 72 67 76 5b  3_exec(db, argv[
0b10: 32 5d 2c 20 30 2c 20 30 2c 20 26 7a 45 72 72 29  2], 0, 0, &zErr)
0b20: 3b 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69  ;.    db->init.i
0b30: 44 62 20 3d 20 30 3b 0a 20 20 20 20 61 73 73 65  Db = 0;.    asse
0b40: 72 74 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  rt( rc!=SQLITE_O
0b50: 4b 20 7c 7c 20 7a 45 72 72 3d 3d 30 20 29 3b 0a  K || zErr==0 );.
0b60: 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f 4f      if( SQLITE_O
0b70: 4b 21 3d 72 63 20 29 7b 0a 20 20 20 20 20 20 70  K!=rc ){.      p
0b80: 44 61 74 61 2d 3e 72 63 20 3d 20 72 63 3b 0a 20  Data->rc = rc;. 
0b90: 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c       if( rc==SQL
0ba0: 49 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20  ITE_NOMEM ){.   
0bb0: 20 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46       db->mallocF
0bc0: 61 69 6c 65 64 20 3d 20 31 3b 0a 20 20 20 20 20  ailed = 1;.     
0bd0: 20 7d 65 6c 73 65 20 69 66 28 20 72 63 21 3d 53   }else if( rc!=S
0be0: 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 50 54 20  QLITE_INTERRUPT 
0bf0: 26 26 20 28 72 63 26 30 78 66 66 29 21 3d 53 51  && (rc&0xff)!=SQ
0c00: 4c 49 54 45 5f 4c 4f 43 4b 45 44 20 29 7b 0a 20  LITE_LOCKED ){. 
0c10: 20 20 20 20 20 20 20 63 6f 72 72 75 70 74 53 63         corruptSc
0c20: 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67 76  hema(pData, argv
0c30: 5b 30 5d 2c 20 7a 45 72 72 29 3b 0a 20 20 20 20  [0], zErr);.    
0c40: 20 20 7d 0a 20 20 20 20 20 20 73 71 6c 69 74 65    }.      sqlite
0c50: 33 44 62 46 72 65 65 28 64 62 2c 20 7a 45 72 72  3DbFree(db, zErr
0c60: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65  );.    }.  }else
0c70: 20 69 66 28 20 61 72 67 76 5b 30 5d 3d 3d 30 20   if( argv[0]==0 
0c80: 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53 63  ){.    corruptSc
0c90: 68 65 6d 61 28 70 44 61 74 61 2c 20 30 2c 20 30  hema(pData, 0, 0
0ca0: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
0cb0: 2f 2a 20 49 66 20 74 68 65 20 53 51 4c 20 63 6f  /* If the SQL co
0cc0: 6c 75 6d 6e 20 69 73 20 62 6c 61 6e 6b 20 69 74  lumn is blank it
0cd0: 20 6d 65 61 6e 73 20 74 68 69 73 20 69 73 20 61   means this is a
0ce0: 6e 20 69 6e 64 65 78 20 74 68 61 74 0a 20 20 20  n index that.   
0cf0: 20 2a 2a 20 77 61 73 20 63 72 65 61 74 65 64 20   ** was created 
0d00: 74 6f 20 62 65 20 74 68 65 20 50 52 49 4d 41 52  to be the PRIMAR
0d10: 59 20 4b 45 59 20 6f 72 20 74 6f 20 66 75 6c 66  Y KEY or to fulf
0d20: 69 6c 6c 20 61 20 55 4e 49 51 55 45 0a 20 20 20  ill a UNIQUE.   
0d30: 20 2a 2a 20 63 6f 6e 73 74 72 61 69 6e 74 20 66   ** constraint f
0d40: 6f 72 20 61 20 43 52 45 41 54 45 20 54 41 42 4c  or a CREATE TABL
0d50: 45 2e 20 20 54 68 65 20 69 6e 64 65 78 20 73 68  E.  The index sh
0d60: 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65 61 64  ould have alread
0d70: 79 0a 20 20 20 20 2a 2a 20 62 65 65 6e 20 63 72  y.    ** been cr
0d80: 65 61 74 65 64 20 77 68 65 6e 20 77 65 20 70 72  eated when we pr
0d90: 6f 63 65 73 73 65 64 20 74 68 65 20 43 52 45 41  ocessed the CREA
0da0: 54 45 20 54 41 42 4c 45 2e 20 20 41 6c 6c 20 77  TE TABLE.  All w
0db0: 65 20 68 61 76 65 0a 20 20 20 20 2a 2a 20 74 6f  e have.    ** to
0dc0: 20 64 6f 20 68 65 72 65 20 69 73 20 72 65 63 6f   do here is reco
0dd0: 72 64 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65  rd the root page
0de0: 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 61 74   number for that
0df0: 20 69 6e 64 65 78 2e 0a 20 20 20 20 2a 2f 0a 20   index..    */. 
0e00: 20 20 20 49 6e 64 65 78 20 2a 70 49 6e 64 65 78     Index *pIndex
0e10: 3b 0a 20 20 20 20 70 49 6e 64 65 78 20 3d 20 73  ;.    pIndex = s
0e20: 71 6c 69 74 65 33 46 69 6e 64 49 6e 64 65 78 28  qlite3FindIndex(
0e30: 64 62 2c 20 61 72 67 76 5b 30 5d 2c 20 64 62 2d  db, argv[0], db-
0e40: 3e 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 29  >aDb[iDb].zName)
0e50: 3b 0a 20 20 20 20 69 66 28 20 70 49 6e 64 65 78  ;.    if( pIndex
0e60: 3d 3d 30 20 7c 7c 20 70 49 6e 64 65 78 2d 3e 74  ==0 || pIndex->t
0e70: 6e 75 6d 21 3d 30 20 29 7b 0a 20 20 20 20 20 20  num!=0 ){.      
0e80: 2f 2a 20 54 68 69 73 20 63 61 6e 20 6f 63 63 75  /* This can occu
0e90: 72 20 69 66 20 74 68 65 72 65 20 65 78 69 73 74  r if there exist
0ea0: 73 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20 61 20  s an index on a 
0eb0: 54 45 4d 50 20 74 61 62 6c 65 20 77 68 69 63 68  TEMP table which
0ec0: 0a 20 20 20 20 20 20 2a 2a 20 68 61 73 20 74 68  .      ** has th
0ed0: 65 20 73 61 6d 65 20 6e 61 6d 65 20 61 73 20 61  e same name as a
0ee0: 6e 6f 74 68 65 72 20 69 6e 64 65 78 20 6f 6e 20  nother index on 
0ef0: 61 20 70 65 72 6d 61 6e 65 6e 74 20 69 6e 64 65  a permanent inde
0f00: 78 2e 20 20 53 69 6e 63 65 0a 20 20 20 20 20 20  x.  Since.      
0f10: 2a 2a 20 74 68 65 20 70 65 72 6d 61 6e 65 6e 74  ** the permanent
0f20: 20 74 61 62 6c 65 20 69 73 20 68 69 64 64 65 6e   table is hidden
0f30: 20 62 79 20 74 68 65 20 54 45 4d 50 20 74 61 62   by the TEMP tab
0f40: 6c 65 2c 20 77 65 20 63 61 6e 20 61 6c 73 6f 0a  le, we can also.
0f50: 20 20 20 20 20 20 2a 2a 20 73 61 66 65 6c 79 20        ** safely 
0f60: 69 67 6e 6f 72 65 20 74 68 65 20 69 6e 64 65 78  ignore the index
0f70: 20 6f 6e 20 74 68 65 20 70 65 72 6d 61 6e 65 6e   on the permanen
0f80: 74 20 74 61 62 6c 65 2e 0a 20 20 20 20 20 20 2a  t table..      *
0f90: 2f 0a 20 20 20 20 20 20 2f 2a 20 44 6f 20 4e 6f  /.      /* Do No
0fa0: 74 68 69 6e 67 20 2a 2f 3b 0a 20 20 20 20 7d 65  thing */;.    }e
0fb0: 6c 73 65 7b 0a 20 20 20 20 20 20 70 49 6e 64 65  lse{.      pInde
0fc0: 78 2d 3e 74 6e 75 6d 20 3d 20 61 74 6f 69 28 61  x->tnum = atoi(a
0fd0: 72 67 76 5b 31 5d 29 3b 0a 20 20 20 20 7d 0a 20  rgv[1]);.    }. 
0fe0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d   }.  return 0;.}
0ff0: 0a 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20  ../*.** Attempt 
1000: 74 6f 20 72 65 61 64 20 74 68 65 20 64 61 74 61  to read the data
1010: 62 61 73 65 20 73 63 68 65 6d 61 20 61 6e 64 20  base schema and 
1020: 69 6e 69 74 69 61 6c 69 7a 65 20 69 6e 74 65 72  initialize inter
1030: 6e 61 6c 0a 2a 2a 20 64 61 74 61 20 73 74 72 75  nal.** data stru
1040: 63 74 75 72 65 73 20 66 6f 72 20 61 20 73 69 6e  ctures for a sin
1050: 67 6c 65 20 64 61 74 61 62 61 73 65 20 66 69 6c  gle database fil
1060: 65 2e 20 20 54 68 65 20 69 6e 64 65 78 20 6f 66  e.  The index of
1070: 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65   the.** database
1080: 20 66 69 6c 65 20 69 73 20 67 69 76 65 6e 20 62   file is given b
1090: 79 20 69 44 62 2e 20 20 69 44 62 3d 3d 30 20 69  y iDb.  iDb==0 i
10a0: 73 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 6d  s used for the m
10b0: 61 69 6e 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e  ain.** database.
10c0: 20 20 69 44 62 3d 3d 31 20 73 68 6f 75 6c 64 20    iDb==1 should 
10d0: 6e 65 76 65 72 20 62 65 20 75 73 65 64 2e 20 20  never be used.  
10e0: 69 44 62 3e 3d 32 20 69 73 20 75 73 65 64 20 66  iDb>=2 is used f
10f0: 6f 72 0a 2a 2a 20 61 75 78 69 6c 69 61 72 79 20  or.** auxiliary 
1100: 64 61 74 61 62 61 73 65 73 2e 20 20 52 65 74 75  databases.  Retu
1110: 72 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 53 51  rn one of the SQ
1120: 4c 49 54 45 5f 20 65 72 72 6f 72 20 63 6f 64 65  LITE_ error code
1130: 73 20 74 6f 0a 2a 2a 20 69 6e 64 69 63 61 74 65  s to.** indicate
1140: 20 73 75 63 63 65 73 73 20 6f 72 20 66 61 69 6c   success or fail
1150: 75 72 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69  ure..*/.static i
1160: 6e 74 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e  nt sqlite3InitOn
1170: 65 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 69  e(sqlite3 *db, i
1180: 6e 74 20 69 44 62 2c 20 63 68 61 72 20 2a 2a 70  nt iDb, char **p
1190: 7a 45 72 72 4d 73 67 29 7b 0a 20 20 69 6e 74 20  zErrMsg){.  int 
11a0: 72 63 3b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a  rc;.  BtCursor *
11b0: 63 75 72 4d 61 69 6e 3b 0a 20 20 69 6e 74 20 73  curMain;.  int s
11c0: 69 7a 65 3b 0a 20 20 54 61 62 6c 65 20 2a 70 54  ize;.  Table *pT
11d0: 61 62 3b 0a 20 20 44 62 20 2a 70 44 62 3b 0a 20  ab;.  Db *pDb;. 
11e0: 20 63 68 61 72 20 63 6f 6e 73 74 20 2a 61 7a 41   char const *azA
11f0: 72 67 5b 34 5d 3b 0a 20 20 69 6e 74 20 6d 65 74  rg[4];.  int met
1200: 61 5b 31 30 5d 3b 0a 20 20 49 6e 69 74 44 61 74  a[10];.  InitDat
1210: 61 20 69 6e 69 74 44 61 74 61 3b 0a 20 20 63 68  a initData;.  ch
1220: 61 72 20 63 6f 6e 73 74 20 2a 7a 4d 61 73 74 65  ar const *zMaste
1230: 72 53 63 68 65 6d 61 3b 0a 20 20 63 68 61 72 20  rSchema;.  char 
1240: 63 6f 6e 73 74 20 2a 7a 4d 61 73 74 65 72 4e 61  const *zMasterNa
1250: 6d 65 20 3d 20 53 43 48 45 4d 41 5f 54 41 42 4c  me = SCHEMA_TABL
1260: 45 28 69 44 62 29 3b 0a 0a 20 20 2f 2a 0a 20 20  E(iDb);..  /*.  
1270: 2a 2a 20 54 68 65 20 6d 61 73 74 65 72 20 64 61  ** The master da
1280: 74 61 62 61 73 65 20 74 61 62 6c 65 20 68 61 73  tabase table has
1290: 20 61 20 73 74 72 75 63 74 75 72 65 20 6c 69 6b   a structure lik
12a0: 65 20 74 68 69 73 0a 20 20 2a 2f 0a 20 20 73 74  e this.  */.  st
12b0: 61 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20  atic const char 
12c0: 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b 5d 20  master_schema[] 
12d0: 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54 45 20  = .     "CREATE 
12e0: 54 41 42 4c 45 20 73 71 6c 69 74 65 5f 6d 61 73  TABLE sqlite_mas
12f0: 74 65 72 28 5c 6e 22 0a 20 20 20 20 20 22 20 20  ter(\n".     "  
1300: 74 79 70 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20  type text,\n".  
1310: 20 20 20 22 20 20 6e 61 6d 65 20 74 65 78 74 2c     "  name text,
1320: 5c 6e 22 0a 20 20 20 20 20 22 20 20 74 62 6c 5f  \n".     "  tbl_
1330: 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20  name text,\n".  
1340: 20 20 20 22 20 20 72 6f 6f 74 70 61 67 65 20 69     "  rootpage i
1350: 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20 20 20 20  nteger,\n".     
1360: 22 20 20 73 71 6c 20 74 65 78 74 5c 6e 22 0a 20  "  sql text\n". 
1370: 20 20 20 20 22 29 22 0a 20 20 3b 0a 23 69 66 6e      ")".  ;.#ifn
1380: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
1390: 54 45 4d 50 44 42 0a 20 20 73 74 61 74 69 63 20  TEMPDB.  static 
13a0: 63 6f 6e 73 74 20 63 68 61 72 20 74 65 6d 70 5f  const char temp_
13b0: 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 5b 5d 20  master_schema[] 
13c0: 3d 20 0a 20 20 20 20 20 22 43 52 45 41 54 45 20  = .     "CREATE 
13d0: 54 45 4d 50 20 54 41 42 4c 45 20 73 71 6c 69 74  TEMP TABLE sqlit
13e0: 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 28 5c 6e  e_temp_master(\n
13f0: 22 0a 20 20 20 20 20 22 20 20 74 79 70 65 20 74  ".     "  type t
1400: 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20  ext,\n".     "  
1410: 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20  name text,\n".  
1420: 20 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20 74     "  tbl_name t
1430: 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20  ext,\n".     "  
1440: 72 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65 72  rootpage integer
1450: 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 73 71 6c  ,\n".     "  sql
1460: 20 74 65 78 74 5c 6e 22 0a 20 20 20 20 20 22 29   text\n".     ")
1470: 22 0a 20 20 3b 0a 23 65 6c 73 65 0a 20 20 23 64  ".  ;.#else.  #d
1480: 65 66 69 6e 65 20 74 65 6d 70 5f 6d 61 73 74 65  efine temp_maste
1490: 72 5f 73 63 68 65 6d 61 20 30 0a 23 65 6e 64 69  r_schema 0.#endi
14a0: 66 0a 0a 20 20 61 73 73 65 72 74 28 20 69 44 62  f..  assert( iDb
14b0: 3e 3d 30 20 26 26 20 69 44 62 3c 64 62 2d 3e 6e  >=0 && iDb<db->n
14c0: 44 62 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20  Db );.  assert( 
14d0: 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 53 63  db->aDb[iDb].pSc
14e0: 68 65 6d 61 20 29 3b 0a 20 20 61 73 73 65 72 74  hema );.  assert
14f0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
1500: 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20  held(db->mutex) 
1510: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 69 44 62  );.  assert( iDb
1520: 3d 3d 31 20 7c 7c 20 73 71 6c 69 74 65 33 42 74  ==1 || sqlite3Bt
1530: 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 64 62  reeHoldsMutex(db
1540: 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 29 20  ->aDb[iDb].pBt) 
1550: 29 3b 0a 0a 20 20 2f 2a 20 7a 4d 61 73 74 65 72  );..  /* zMaster
1560: 53 63 68 65 6d 61 20 61 6e 64 20 7a 49 6e 69 74  Schema and zInit
1570: 53 63 72 69 70 74 20 61 72 65 20 73 65 74 20 74  Script are set t
1580: 6f 20 70 6f 69 6e 74 20 61 74 20 74 68 65 20 6d  o point at the m
1590: 61 73 74 65 72 20 73 63 68 65 6d 61 0a 20 20 2a  aster schema.  *
15a0: 2a 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 73 61  * and initialisa
15b0: 74 69 6f 6e 20 73 63 72 69 70 74 20 61 70 70 72  tion script appr
15c0: 6f 70 72 69 61 74 65 20 66 6f 72 20 74 68 65 20  opriate for the 
15d0: 64 61 74 61 62 61 73 65 20 62 65 69 6e 67 0a 20  database being. 
15e0: 20 2a 2a 20 69 6e 69 74 69 61 6c 69 73 65 64 2e   ** initialised.
15f0: 20 7a 4d 61 73 74 65 72 4e 61 6d 65 20 69 73 20   zMasterName is 
1600: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
1610: 6d 61 73 74 65 72 20 74 61 62 6c 65 2e 0a 20 20  master table..  
1620: 2a 2f 0a 20 20 69 66 28 20 21 4f 4d 49 54 5f 54  */.  if( !OMIT_T
1630: 45 4d 50 44 42 20 26 26 20 69 44 62 3d 3d 31 20  EMPDB && iDb==1 
1640: 29 7b 0a 20 20 20 20 7a 4d 61 73 74 65 72 53 63  ){.    zMasterSc
1650: 68 65 6d 61 20 3d 20 74 65 6d 70 5f 6d 61 73 74  hema = temp_mast
1660: 65 72 5f 73 63 68 65 6d 61 3b 0a 20 20 7d 65 6c  er_schema;.  }el
1670: 73 65 7b 0a 20 20 20 20 7a 4d 61 73 74 65 72 53  se{.    zMasterS
1680: 63 68 65 6d 61 20 3d 20 6d 61 73 74 65 72 5f 73  chema = master_s
1690: 63 68 65 6d 61 3b 0a 20 20 7d 0a 20 20 7a 4d 61  chema;.  }.  zMa
16a0: 73 74 65 72 4e 61 6d 65 20 3d 20 53 43 48 45 4d  sterName = SCHEM
16b0: 41 5f 54 41 42 4c 45 28 69 44 62 29 3b 0a 0a 20  A_TABLE(iDb);.. 
16c0: 20 2f 2a 20 43 6f 6e 73 74 72 75 63 74 20 74 68   /* Construct th
16d0: 65 20 73 63 68 65 6d 61 20 74 61 62 6c 65 73 2e  e schema tables.
16e0: 20 20 2a 2f 0a 20 20 61 7a 41 72 67 5b 30 5d 20    */.  azArg[0] 
16f0: 3d 20 7a 4d 61 73 74 65 72 4e 61 6d 65 3b 0a 20  = zMasterName;. 
1700: 20 61 7a 41 72 67 5b 31 5d 20 3d 20 22 31 22 3b   azArg[1] = "1";
1710: 0a 20 20 61 7a 41 72 67 5b 32 5d 20 3d 20 7a 4d  .  azArg[2] = zM
1720: 61 73 74 65 72 53 63 68 65 6d 61 3b 0a 20 20 61  asterSchema;.  a
1730: 7a 41 72 67 5b 33 5d 20 3d 20 30 3b 0a 20 20 69  zArg[3] = 0;.  i
1740: 6e 69 74 44 61 74 61 2e 64 62 20 3d 20 64 62 3b  nitData.db = db;
1750: 0a 20 20 69 6e 69 74 44 61 74 61 2e 69 44 62 20  .  initData.iDb 
1760: 3d 20 69 44 62 3b 0a 20 20 69 6e 69 74 44 61 74  = iDb;.  initDat
1770: 61 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  a.rc = SQLITE_OK
1780: 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e 70 7a 45  ;.  initData.pzE
1790: 72 72 4d 73 67 20 3d 20 70 7a 45 72 72 4d 73 67  rrMsg = pzErrMsg
17a0: 3b 0a 20 20 28 76 6f 69 64 29 73 71 6c 69 74 65  ;.  (void)sqlite
17b0: 33 53 61 66 65 74 79 4f 66 66 28 64 62 29 3b 0a  3SafetyOff(db);.
17c0: 20 20 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c    sqlite3InitCal
17d0: 6c 62 61 63 6b 28 26 69 6e 69 74 44 61 74 61 2c  lback(&initData,
17e0: 20 33 2c 20 28 63 68 61 72 20 2a 2a 29 61 7a 41   3, (char **)azA
17f0: 72 67 2c 20 30 29 3b 0a 20 20 28 76 6f 69 64 29  rg, 0);.  (void)
1800: 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 6e 28  sqlite3SafetyOn(
1810: 64 62 29 3b 0a 20 20 69 66 28 20 69 6e 69 74 44  db);.  if( initD
1820: 61 74 61 2e 72 63 20 29 7b 0a 20 20 20 20 72 63  ata.rc ){.    rc
1830: 20 3d 20 69 6e 69 74 44 61 74 61 2e 72 63 3b 0a   = initData.rc;.
1840: 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f      goto error_o
1850: 75 74 3b 0a 20 20 7d 0a 20 20 70 54 61 62 20 3d  ut;.  }.  pTab =
1860: 20 73 71 6c 69 74 65 33 46 69 6e 64 54 61 62 6c   sqlite3FindTabl
1870: 65 28 64 62 2c 20 7a 4d 61 73 74 65 72 4e 61 6d  e(db, zMasterNam
1880: 65 2c 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e  e, db->aDb[iDb].
1890: 7a 4e 61 6d 65 29 3b 0a 20 20 69 66 28 20 70 54  zName);.  if( pT
18a0: 61 62 20 29 7b 0a 20 20 20 20 70 54 61 62 2d 3e  ab ){.    pTab->
18b0: 74 61 62 46 6c 61 67 73 20 7c 3d 20 54 46 5f 52  tabFlags |= TF_R
18c0: 65 61 64 6f 6e 6c 79 3b 0a 20 20 7d 0a 0a 20 20  eadonly;.  }..  
18d0: 2f 2a 20 43 72 65 61 74 65 20 61 20 63 75 72 73  /* Create a curs
18e0: 6f 72 20 74 6f 20 68 6f 6c 64 20 74 68 65 20 64  or to hold the d
18f0: 61 74 61 62 61 73 65 20 6f 70 65 6e 0a 20 20 2a  atabase open.  *
1900: 2f 0a 20 20 70 44 62 20 3d 20 26 64 62 2d 3e 61  /.  pDb = &db->a
1910: 44 62 5b 69 44 62 5d 3b 0a 20 20 69 66 28 20 70  Db[iDb];.  if( p
1920: 44 62 2d 3e 70 42 74 3d 3d 30 20 29 7b 0a 20 20  Db->pBt==0 ){.  
1930: 20 20 69 66 28 20 21 4f 4d 49 54 5f 54 45 4d 50    if( !OMIT_TEMP
1940: 44 42 20 26 26 20 69 44 62 3d 3d 31 20 29 7b 0a  DB && iDb==1 ){.
1950: 20 20 20 20 20 20 44 62 53 65 74 50 72 6f 70 65        DbSetPrope
1960: 72 74 79 28 64 62 2c 20 31 2c 20 44 42 5f 53 63  rty(db, 1, DB_Sc
1970: 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 20 20  hemaLoaded);.   
1980: 20 7d 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51   }.    return SQ
1990: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 20 20 63  LITE_OK;.  }.  c
19a0: 75 72 4d 61 69 6e 20 3d 20 73 71 6c 69 74 65 33  urMain = sqlite3
19b0: 4d 61 6c 6c 6f 63 5a 65 72 6f 28 73 71 6c 69 74  MallocZero(sqlit
19c0: 65 33 42 74 72 65 65 43 75 72 73 6f 72 53 69 7a  e3BtreeCursorSiz
19d0: 65 28 29 29 3b 0a 20 20 69 66 28 20 21 63 75 72  e());.  if( !cur
19e0: 4d 61 69 6e 20 29 7b 0a 20 20 20 20 72 63 20 3d  Main ){.    rc =
19f0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20   SQLITE_NOMEM;. 
1a00: 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75     goto error_ou
1a10: 74 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  t;.  }.  sqlite3
1a20: 42 74 72 65 65 45 6e 74 65 72 28 70 44 62 2d 3e  BtreeEnter(pDb->
1a30: 70 42 74 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c  pBt);.  rc = sql
1a40: 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 28  ite3BtreeCursor(
1a50: 70 44 62 2d 3e 70 42 74 2c 20 4d 41 53 54 45 52  pDb->pBt, MASTER
1a60: 5f 52 4f 4f 54 2c 20 30 2c 20 30 2c 20 63 75 72  _ROOT, 0, 0, cur
1a70: 4d 61 69 6e 29 3b 0a 20 20 69 66 28 20 72 63 21  Main);.  if( rc!
1a80: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 72 63  =SQLITE_OK && rc
1a90: 21 3d 53 51 4c 49 54 45 5f 45 4d 50 54 59 20 29  !=SQLITE_EMPTY )
1aa0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 53 65 74  {.    sqlite3Set
1ab0: 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c  String(pzErrMsg,
1ac0: 20 64 62 2c 20 22 25 73 22 2c 20 73 71 6c 69 74   db, "%s", sqlit
1ad0: 65 33 45 72 72 53 74 72 28 72 63 29 29 3b 0a 20  e3ErrStr(rc));. 
1ae0: 20 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f     goto initone_
1af0: 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a  error_out;.  }..
1b00: 20 20 2f 2a 20 47 65 74 20 74 68 65 20 64 61 74    /* Get the dat
1b10: 61 62 61 73 65 20 6d 65 74 61 20 69 6e 66 6f 72  abase meta infor
1b20: 6d 61 74 69 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a  mation..  **.  *
1b30: 2a 20 4d 65 74 61 20 76 61 6c 75 65 73 20 61 72  * Meta values ar
1b40: 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20  e as follows:.  
1b50: 2a 2a 20 20 20 20 6d 65 74 61 5b 30 5d 20 20 20  **    meta[0]   
1b60: 53 63 68 65 6d 61 20 63 6f 6f 6b 69 65 2e 20 20  Schema cookie.  
1b70: 43 68 61 6e 67 65 73 20 77 69 74 68 20 65 61 63  Changes with eac
1b80: 68 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 2e  h schema change.
1b90: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 31 5d  .  **    meta[1]
1ba0: 20 20 20 46 69 6c 65 20 66 6f 72 6d 61 74 20 6f     File format o
1bb0: 66 20 73 63 68 65 6d 61 20 6c 61 79 65 72 2e 0a  f schema layer..
1bc0: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 32 5d 20    **    meta[2] 
1bd0: 20 20 53 69 7a 65 20 6f 66 20 74 68 65 20 70 61    Size of the pa
1be0: 67 65 20 63 61 63 68 65 2e 0a 20 20 2a 2a 20 20  ge cache..  **  
1bf0: 20 20 6d 65 74 61 5b 33 5d 20 20 20 55 73 65 20    meta[3]   Use 
1c00: 66 72 65 65 6c 69 73 74 20 69 66 20 30 2e 20 20  freelist if 0.  
1c10: 41 75 74 6f 76 61 63 75 75 6d 20 69 66 20 67 72  Autovacuum if gr
1c20: 65 61 74 65 72 20 74 68 61 6e 20 7a 65 72 6f 2e  eater than zero.
1c30: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 34 5d  .  **    meta[4]
1c40: 20 20 20 44 62 20 74 65 78 74 20 65 6e 63 6f 64     Db text encod
1c50: 69 6e 67 2e 20 31 3a 55 54 46 2d 38 20 32 3a 55  ing. 1:UTF-8 2:U
1c60: 54 46 2d 31 36 4c 45 20 33 3a 55 54 46 2d 31 36  TF-16LE 3:UTF-16
1c70: 42 45 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b  BE.  **    meta[
1c80: 35 5d 20 20 20 54 68 65 20 75 73 65 72 20 63 6f  5]   The user co
1c90: 6f 6b 69 65 2e 20 55 73 65 64 20 62 79 20 74 68  okie. Used by th
1ca0: 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e 0a 20  e application.. 
1cb0: 20 2a 2a 20 20 20 20 6d 65 74 61 5b 36 5d 20 20   **    meta[6]  
1cc0: 20 49 6e 63 72 65 6d 65 6e 74 61 6c 2d 76 61 63   Incremental-vac
1cd0: 75 75 6d 20 66 6c 61 67 2e 0a 20 20 2a 2a 20 20  uum flag..  **  
1ce0: 20 20 6d 65 74 61 5b 37 5d 0a 20 20 2a 2a 20 20    meta[7].  **  
1cf0: 20 20 6d 65 74 61 5b 38 5d 0a 20 20 2a 2a 20 20    meta[8].  **  
1d00: 20 20 6d 65 74 61 5b 39 5d 0a 20 20 2a 2a 0a 20    meta[9].  **. 
1d10: 20 2a 2a 20 4e 6f 74 65 3a 20 54 68 65 20 23 64   ** Note: The #d
1d20: 65 66 69 6e 65 64 20 53 51 4c 49 54 45 5f 55 54  efined SQLITE_UT
1d30: 46 2a 20 73 79 6d 62 6f 6c 73 20 69 6e 20 73 71  F* symbols in sq
1d40: 6c 69 74 65 49 6e 74 2e 68 20 63 6f 72 72 65 73  liteInt.h corres
1d50: 70 6f 6e 64 20 74 6f 0a 20 20 2a 2a 20 74 68 65  pond to.  ** the
1d60: 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73   possible values
1d70: 20 6f 66 20 6d 65 74 61 5b 34 5d 2e 0a 20 20 2a   of meta[4]..  *
1d80: 2f 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  /.  if( rc==SQLI
1d90: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 69 6e 74  TE_OK ){.    int
1da0: 20 69 3b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b   i;.    for(i=0;
1db0: 20 69 3c 41 72 72 61 79 53 69 7a 65 28 6d 65 74   i<ArraySize(met
1dc0: 61 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20  a); i++){.      
1dd0: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65  rc = sqlite3Btre
1de0: 65 47 65 74 4d 65 74 61 28 70 44 62 2d 3e 70 42  eGetMeta(pDb->pB
1df0: 74 2c 20 69 2b 31 2c 20 28 75 33 32 20 2a 29 26  t, i+1, (u32 *)&
1e00: 6d 65 74 61 5b 69 5d 29 3b 0a 20 20 20 20 20 20  meta[i]);.      
1e10: 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20  if( rc ){.      
1e20: 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69    sqlite3SetStri
1e30: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 64 62 2c  ng(pzErrMsg, db,
1e40: 20 22 25 73 22 2c 20 73 71 6c 69 74 65 33 45 72   "%s", sqlite3Er
1e50: 72 53 74 72 28 72 63 29 29 3b 0a 20 20 20 20 20  rStr(rc));.     
1e60: 20 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f     goto initone_
1e70: 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 20 20 20  error_out;.     
1e80: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65   }.    }.  }else
1e90: 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 6d 65 74  {.    memset(met
1ea0: 61 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d 65 74  a, 0, sizeof(met
1eb0: 61 29 29 3b 0a 20 20 7d 0a 20 20 70 44 62 2d 3e  a));.  }.  pDb->
1ec0: 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 5f  pSchema->schema_
1ed0: 63 6f 6f 6b 69 65 20 3d 20 6d 65 74 61 5b 30 5d  cookie = meta[0]
1ee0: 3b 0a 0a 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69  ;..  /* If openi
1ef0: 6e 67 20 61 20 6e 6f 6e 2d 65 6d 70 74 79 20 64  ng a non-empty d
1f00: 61 74 61 62 61 73 65 2c 20 63 68 65 63 6b 20 74  atabase, check t
1f10: 68 65 20 74 65 78 74 20 65 6e 63 6f 64 69 6e 67  he text encoding
1f20: 2e 20 46 6f 72 20 74 68 65 0a 20 20 2a 2a 20 6d  . For the.  ** m
1f30: 61 69 6e 20 64 61 74 61 62 61 73 65 2c 20 73 65  ain database, se
1f40: 74 20 73 71 6c 69 74 65 33 2e 65 6e 63 20 74 6f  t sqlite3.enc to
1f50: 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6f 66   the encoding of
1f60: 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61   the main databa
1f70: 73 65 2e 0a 20 20 2a 2a 20 46 6f 72 20 61 6e 20  se..  ** For an 
1f80: 61 74 74 61 63 68 65 64 20 64 62 2c 20 69 74 20  attached db, it 
1f90: 69 73 20 61 6e 20 65 72 72 6f 72 20 69 66 20 74  is an error if t
1fa0: 68 65 20 65 6e 63 6f 64 69 6e 67 20 69 73 20 6e  he encoding is n
1fb0: 6f 74 20 74 68 65 20 73 61 6d 65 0a 20 20 2a 2a  ot the same.  **
1fc0: 20 61 73 20 73 71 6c 69 74 65 33 2e 65 6e 63 2e   as sqlite3.enc.
1fd0: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6d 65 74 61  .  */.  if( meta
1fe0: 5b 34 5d 20 29 7b 20 20 2f 2a 20 74 65 78 74 20  [4] ){  /* text 
1ff0: 65 6e 63 6f 64 69 6e 67 20 2a 2f 0a 20 20 20 20  encoding */.    
2000: 69 66 28 20 69 44 62 3d 3d 30 20 29 7b 0a 20 20  if( iDb==0 ){.  
2010: 20 20 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e      /* If openin
2020: 67 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62  g the main datab
2030: 61 73 65 2c 20 73 65 74 20 45 4e 43 28 64 62 29  ase, set ENC(db)
2040: 2e 20 2a 2f 0a 20 20 20 20 20 20 45 4e 43 28 64  . */.      ENC(d
2050: 62 29 20 3d 20 28 75 38 29 6d 65 74 61 5b 34 5d  b) = (u8)meta[4]
2060: 3b 0a 20 20 20 20 20 20 64 62 2d 3e 70 44 66 6c  ;.      db->pDfl
2070: 74 43 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46  tColl = sqlite3F
2080: 69 6e 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 53  indCollSeq(db, S
2090: 51 4c 49 54 45 5f 55 54 46 38 2c 20 22 42 49 4e  QLITE_UTF8, "BIN
20a0: 41 52 59 22 2c 20 36 2c 20 30 29 3b 0a 20 20 20  ARY", 6, 0);.   
20b0: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f 2a   }else{.      /*
20c0: 20 49 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 61   If opening an a
20d0: 74 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65  ttached database
20e0: 2c 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6d  , the encoding m
20f0: 75 63 68 20 6d 61 74 63 68 20 45 4e 43 28 64 62  uch match ENC(db
2100: 29 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 6d  ) */.      if( m
2110: 65 74 61 5b 34 5d 21 3d 45 4e 43 28 64 62 29 20  eta[4]!=ENC(db) 
2120: 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74  ){.        sqlit
2130: 65 33 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72  e3SetString(pzEr
2140: 72 4d 73 67 2c 20 64 62 2c 20 22 61 74 74 61 63  rMsg, db, "attac
2150: 68 65 64 20 64 61 74 61 62 61 73 65 73 20 6d 75  hed databases mu
2160: 73 74 20 75 73 65 20 74 68 65 20 73 61 6d 65 22  st use the same"
2170: 0a 20 20 20 20 20 20 20 20 20 20 20 20 22 20 74  .            " t
2180: 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 61 73 20  ext encoding as 
2190: 6d 61 69 6e 20 64 61 74 61 62 61 73 65 22 29 3b  main database");
21a0: 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 53 51  .        rc = SQ
21b0: 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20  LITE_ERROR;.    
21c0: 20 20 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65      goto initone
21d0: 5f 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 20 20  _error_out;.    
21e0: 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73    }.    }.  }els
21f0: 65 7b 0a 20 20 20 20 44 62 53 65 74 50 72 6f 70  e{.    DbSetProp
2200: 65 72 74 79 28 64 62 2c 20 69 44 62 2c 20 44 42  erty(db, iDb, DB
2210: 5f 45 6d 70 74 79 29 3b 0a 20 20 7d 0a 20 20 70  _Empty);.  }.  p
2220: 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 65 6e 63  Db->pSchema->enc
2230: 20 3d 20 45 4e 43 28 64 62 29 3b 0a 0a 20 20 69   = ENC(db);..  i
2240: 66 28 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d  f( pDb->pSchema-
2250: 3e 63 61 63 68 65 5f 73 69 7a 65 3d 3d 30 20 29  >cache_size==0 )
2260: 7b 0a 20 20 20 20 73 69 7a 65 20 3d 20 6d 65 74  {.    size = met
2270: 61 5b 32 5d 3b 0a 20 20 20 20 69 66 28 20 73 69  a[2];.    if( si
2280: 7a 65 3d 3d 30 20 29 7b 20 73 69 7a 65 20 3d 20  ze==0 ){ size = 
2290: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 43  SQLITE_DEFAULT_C
22a0: 41 43 48 45 5f 53 49 5a 45 3b 20 7d 0a 20 20 20  ACHE_SIZE; }.   
22b0: 20 69 66 28 20 73 69 7a 65 3c 30 20 29 20 73 69   if( size<0 ) si
22c0: 7a 65 20 3d 20 2d 73 69 7a 65 3b 0a 20 20 20 20  ze = -size;.    
22d0: 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 63 61  pDb->pSchema->ca
22e0: 63 68 65 5f 73 69 7a 65 20 3d 20 73 69 7a 65 3b  che_size = size;
22f0: 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65  .    sqlite3Btre
2300: 65 53 65 74 43 61 63 68 65 53 69 7a 65 28 70 44  eSetCacheSize(pD
2310: 62 2d 3e 70 42 74 2c 20 70 44 62 2d 3e 70 53 63  b->pBt, pDb->pSc
2320: 68 65 6d 61 2d 3e 63 61 63 68 65 5f 73 69 7a 65  hema->cache_size
2330: 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a  );.  }..  /*.  *
2340: 2a 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 31  * file_format==1
2350: 20 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 30 2e      Version 3.0.
2360: 30 2e 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 6f 72  0..  ** file_for
2370: 6d 61 74 3d 3d 32 20 20 20 20 56 65 72 73 69 6f  mat==2    Versio
2380: 6e 20 33 2e 31 2e 33 2e 20 20 2f 2f 20 41 4c 54  n 3.1.3.  // ALT
2390: 45 52 20 54 41 42 4c 45 20 41 44 44 20 43 4f 4c  ER TABLE ADD COL
23a0: 55 4d 4e 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 6f  UMN.  ** file_fo
23b0: 72 6d 61 74 3d 3d 33 20 20 20 20 56 65 72 73 69  rmat==3    Versi
23c0: 6f 6e 20 33 2e 31 2e 34 2e 20 20 2f 2f 20 64 69  on 3.1.4.  // di
23d0: 74 74 6f 20 62 75 74 20 77 69 74 68 20 6e 6f 6e  tto but with non
23e0: 2d 4e 55 4c 4c 20 64 65 66 61 75 6c 74 73 0a 20  -NULL defaults. 
23f0: 20 2a 2a 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d   ** file_format=
2400: 3d 34 20 20 20 20 56 65 72 73 69 6f 6e 20 33 2e  =4    Version 3.
2410: 33 2e 30 2e 20 20 2f 2f 20 44 45 53 43 20 69 6e  3.0.  // DESC in
2420: 64 69 63 65 73 2e 20 20 42 6f 6f 6c 65 61 6e 20  dices.  Boolean 
2430: 63 6f 6e 73 74 61 6e 74 73 0a 20 20 2a 2f 0a 20  constants.  */. 
2440: 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66   pDb->pSchema->f
2450: 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 28 75 38  ile_format = (u8
2460: 29 6d 65 74 61 5b 31 5d 3b 0a 20 20 69 66 28 20  )meta[1];.  if( 
2470: 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69  pDb->pSchema->fi
2480: 6c 65 5f 66 6f 72 6d 61 74 3d 3d 30 20 29 7b 0a  le_format==0 ){.
2490: 20 20 20 20 70 44 62 2d 3e 70 53 63 68 65 6d 61      pDb->pSchema
24a0: 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20  ->file_format = 
24b0: 31 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 44 62  1;.  }.  if( pDb
24c0: 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69 6c 65 5f  ->pSchema->file_
24d0: 66 6f 72 6d 61 74 3e 53 51 4c 49 54 45 5f 4d 41  format>SQLITE_MA
24e0: 58 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 20 29 7b  X_FILE_FORMAT ){
24f0: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53  .    sqlite3SetS
2500: 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20  tring(pzErrMsg, 
2510: 64 62 2c 20 22 75 6e 73 75 70 70 6f 72 74 65 64  db, "unsupported
2520: 20 66 69 6c 65 20 66 6f 72 6d 61 74 22 29 3b 0a   file format");.
2530: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
2540: 45 52 52 4f 52 3b 0a 20 20 20 20 67 6f 74 6f 20  ERROR;.    goto 
2550: 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75  initone_error_ou
2560: 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 69 63  t;.  }..  /* Tic
2570: 6b 65 74 20 23 32 38 30 34 3a 20 20 57 68 65 6e  ket #2804:  When
2580: 20 77 65 20 6f 70 65 6e 20 61 20 64 61 74 61 62   we open a datab
2590: 61 73 65 20 69 6e 20 74 68 65 20 6e 65 77 65 72  ase in the newer
25a0: 20 66 69 6c 65 20 66 6f 72 6d 61 74 2c 0a 20 20   file format,.  
25b0: 2a 2a 20 63 6c 65 61 72 20 74 68 65 20 6c 65 67  ** clear the leg
25c0: 61 63 79 5f 66 69 6c 65 5f 66 6f 72 6d 61 74 20  acy_file_format 
25d0: 70 72 61 67 6d 61 20 66 6c 61 67 20 73 6f 20 74  pragma flag so t
25e0: 68 61 74 20 61 20 56 41 43 55 55 4d 20 77 69 6c  hat a VACUUM wil
25f0: 6c 0a 20 20 2a 2a 20 6e 6f 74 20 64 6f 77 6e 67  l.  ** not downg
2600: 72 61 64 65 20 74 68 65 20 64 61 74 61 62 61 73  rade the databas
2610: 65 20 61 6e 64 20 74 68 75 73 20 69 6e 76 61 6c  e and thus inval
2620: 69 64 61 74 65 20 61 6e 79 20 64 65 73 63 65 6e  idate any descen
2630: 64 69 6e 67 0a 20 20 2a 2a 20 69 6e 64 69 63 65  ding.  ** indice
2640: 73 20 74 68 61 74 20 74 68 65 20 75 73 65 72 20  s that the user 
2650: 6d 69 67 68 74 20 68 61 76 65 20 63 72 65 61 74  might have creat
2660: 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 69  ed..  */.  if( i
2670: 44 62 3d 3d 30 20 26 26 20 6d 65 74 61 5b 31 5d  Db==0 && meta[1]
2680: 3e 3d 34 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66  >=4 ){.    db->f
2690: 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f  lags &= ~SQLITE_
26a0: 4c 65 67 61 63 79 46 69 6c 65 46 6d 74 3b 0a 20  LegacyFileFmt;. 
26b0: 20 7d 0a 0a 20 20 2f 2a 20 52 65 61 64 20 74 68   }..  /* Read th
26c0: 65 20 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61  e schema informa
26d0: 74 69 6f 6e 20 6f 75 74 20 6f 66 20 74 68 65 20  tion out of the 
26e0: 73 63 68 65 6d 61 20 74 61 62 6c 65 73 0a 20 20  schema tables.  
26f0: 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d  */.  assert( db-
2700: 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20 20  >init.busy );.  
2710: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 45  if( rc==SQLITE_E
2720: 4d 50 54 59 20 29 7b 0a 20 20 20 20 2f 2a 20 46  MPTY ){.    /* F
2730: 6f 72 20 61 6e 20 65 6d 70 74 79 20 64 61 74 61  or an empty data
2740: 62 61 73 65 2c 20 74 68 65 72 65 20 69 73 20 6e  base, there is n
2750: 6f 74 68 69 6e 67 20 74 6f 20 72 65 61 64 20 2a  othing to read *
2760: 2f 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54  /.    rc = SQLIT
2770: 45 5f 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  E_OK;.  }else{. 
2780: 20 20 20 63 68 61 72 20 2a 7a 53 71 6c 3b 0a 20     char *zSql;. 
2790: 20 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74 65     zSql = sqlite
27a0: 33 4d 50 72 69 6e 74 66 28 64 62 2c 20 0a 20 20  3MPrintf(db, .  
27b0: 20 20 20 20 20 20 22 53 45 4c 45 43 54 20 6e 61        "SELECT na
27c0: 6d 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71  me, rootpage, sq
27d0: 6c 20 46 52 4f 4d 20 27 25 71 27 2e 25 73 22 2c  l FROM '%q'.%s",
27e0: 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 61 44 62  .        db->aDb
27f0: 5b 69 44 62 5d 2e 7a 4e 61 6d 65 2c 20 7a 4d 61  [iDb].zName, zMa
2800: 73 74 65 72 4e 61 6d 65 29 3b 0a 20 20 20 20 28  sterName);.    (
2810: 76 6f 69 64 29 73 71 6c 69 74 65 33 53 61 66 65  void)sqlite3Safe
2820: 74 79 4f 66 66 28 64 62 29 3b 0a 23 69 66 6e 64  tyOff(db);.#ifnd
2830: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  ef SQLITE_OMIT_A
2840: 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 20  UTHORIZATION.   
2850: 20 7b 0a 20 20 20 20 20 20 69 6e 74 20 28 2a 78   {.      int (*x
2860: 41 75 74 68 29 28 76 6f 69 64 2a 2c 69 6e 74 2c  Auth)(void*,int,
2870: 63 6f 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73  const char*,cons
2880: 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68  t char*,const ch
2890: 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29  ar*,const char*)
28a0: 3b 0a 20 20 20 20 20 20 78 41 75 74 68 20 3d 20  ;.      xAuth = 
28b0: 64 62 2d 3e 78 41 75 74 68 3b 0a 20 20 20 20 20  db->xAuth;.     
28c0: 20 64 62 2d 3e 78 41 75 74 68 20 3d 20 30 3b 0a   db->xAuth = 0;.
28d0: 23 65 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20  #endif.      rc 
28e0: 3d 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 64  = sqlite3_exec(d
28f0: 62 2c 20 7a 53 71 6c 2c 20 73 71 6c 69 74 65 33  b, zSql, sqlite3
2900: 49 6e 69 74 43 61 6c 6c 62 61 63 6b 2c 20 26 69  InitCallback, &i
2910: 6e 69 74 44 61 74 61 2c 20 30 29 3b 0a 23 69 66  nitData, 0);.#if
2920: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
2930: 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20  _AUTHORIZATION. 
2940: 20 20 20 20 20 64 62 2d 3e 78 41 75 74 68 20 3d       db->xAuth =
2950: 20 78 41 75 74 68 3b 0a 20 20 20 20 7d 0a 23 65   xAuth;.    }.#e
2960: 6e 64 69 66 0a 20 20 20 20 69 66 28 20 72 63 3d  ndif.    if( rc=
2970: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20  =SQLITE_OK ) rc 
2980: 3d 20 69 6e 69 74 44 61 74 61 2e 72 63 3b 0a 20  = initData.rc;. 
2990: 20 20 20 28 76 6f 69 64 29 73 71 6c 69 74 65 33     (void)sqlite3
29a0: 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20 20  SafetyOn(db);.  
29b0: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28    sqlite3DbFree(
29c0: 64 62 2c 20 7a 53 71 6c 29 3b 0a 23 69 66 6e 64  db, zSql);.#ifnd
29d0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  ef SQLITE_OMIT_A
29e0: 4e 41 4c 59 5a 45 0a 20 20 20 20 69 66 28 20 72  NALYZE.    if( r
29f0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
2a00: 20 20 20 20 20 20 73 71 6c 69 74 65 33 41 6e 61        sqlite3Ana
2a10: 6c 79 73 69 73 4c 6f 61 64 28 64 62 2c 20 69 44  lysisLoad(db, iD
2a20: 62 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66  b);.    }.#endif
2a30: 0a 20 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 6d  .  }.  if( db->m
2a40: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20  allocFailed ){. 
2a50: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e     rc = SQLITE_N
2a60: 4f 4d 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65  OMEM;.    sqlite
2a70: 33 52 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63  3ResetInternalSc
2a80: 68 65 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 7d  hema(db, 0);.  }
2a90: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54  .  if( rc==SQLIT
2aa0: 45 5f 4f 4b 20 7c 7c 20 28 64 62 2d 3e 66 6c 61  E_OK || (db->fla
2ab0: 67 73 26 53 51 4c 49 54 45 5f 52 65 63 6f 76 65  gs&SQLITE_Recove
2ac0: 72 79 4d 6f 64 65 29 29 7b 0a 20 20 20 20 2f 2a  ryMode)){.    /*
2ad0: 20 42 6c 61 63 6b 20 6d 61 67 69 63 3a 20 49 66   Black magic: If
2ae0: 20 74 68 65 20 53 51 4c 49 54 45 5f 52 65 63 6f   the SQLITE_Reco
2af0: 76 65 72 79 4d 6f 64 65 20 66 6c 61 67 20 69 73  veryMode flag is
2b00: 20 73 65 74 2c 20 74 68 65 6e 20 63 6f 6e 73 69   set, then consi
2b10: 64 65 72 0a 20 20 20 20 2a 2a 20 74 68 65 20 73  der.    ** the s
2b20: 63 68 65 6d 61 20 6c 6f 61 64 65 64 2c 20 65 76  chema loaded, ev
2b30: 65 6e 20 69 66 20 65 72 72 6f 72 73 20 6f 63 63  en if errors occ
2b40: 75 72 72 65 64 2e 20 49 6e 20 74 68 69 73 20 73  urred. In this s
2b50: 69 74 75 61 74 69 6f 6e 20 74 68 65 20 0a 20 20  ituation the .  
2b60: 20 20 2a 2a 20 63 75 72 72 65 6e 74 20 73 71 6c    ** current sql
2b70: 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 20 6f  ite3_prepare() o
2b80: 70 65 72 61 74 69 6f 6e 20 77 69 6c 6c 20 66 61  peration will fa
2b90: 69 6c 2c 20 62 75 74 20 74 68 65 20 66 6f 6c 6c  il, but the foll
2ba0: 6f 77 69 6e 67 20 6f 6e 65 0a 20 20 20 20 2a 2a  owing one.    **
2bb0: 20 77 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f   will attempt to
2bc0: 20 63 6f 6d 70 69 6c 65 20 74 68 65 20 73 75 70   compile the sup
2bd0: 70 6c 69 65 64 20 73 74 61 74 65 6d 65 6e 74 20  plied statement 
2be0: 61 67 61 69 6e 73 74 20 77 68 61 74 65 76 65 72  against whatever
2bf0: 20 73 75 62 73 65 74 0a 20 20 20 20 2a 2a 20 6f   subset.    ** o
2c00: 66 20 74 68 65 20 73 63 68 65 6d 61 20 77 61 73  f the schema was
2c10: 20 6c 6f 61 64 65 64 20 62 65 66 6f 72 65 20 74   loaded before t
2c20: 68 65 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65  he error occurre
2c30: 64 2e 20 54 68 65 20 70 72 69 6d 61 72 79 0a 20  d. The primary. 
2c40: 20 20 20 2a 2a 20 70 75 72 70 6f 73 65 20 6f 66     ** purpose of
2c50: 20 74 68 69 73 20 69 73 20 74 6f 20 61 6c 6c 6f   this is to allo
2c60: 77 20 61 63 63 65 73 73 20 74 6f 20 74 68 65 20  w access to the 
2c70: 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 74 61  sqlite_master ta
2c80: 62 6c 65 0a 20 20 20 20 2a 2a 20 65 76 65 6e 20  ble.    ** even 
2c90: 77 68 65 6e 20 69 74 73 20 63 6f 6e 74 65 6e 74  when its content
2ca0: 73 20 68 61 76 65 20 62 65 65 6e 20 63 6f 72 72  s have been corr
2cb0: 75 70 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20  upted..    */.  
2cc0: 20 20 44 62 53 65 74 50 72 6f 70 65 72 74 79 28    DbSetProperty(
2cd0: 64 62 2c 20 69 44 62 2c 20 44 42 5f 53 63 68 65  db, iDb, DB_Sche
2ce0: 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 20 20 20 72  maLoaded);.    r
2cf0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
2d00: 20 7d 0a 0a 20 20 2f 2a 20 4a 75 6d 70 20 68 65   }..  /* Jump he
2d10: 72 65 20 66 6f 72 20 61 6e 20 65 72 72 6f 72 20  re for an error 
2d20: 74 68 61 74 20 6f 63 63 75 72 73 20 61 66 74 65  that occurs afte
2d30: 72 20 73 75 63 63 65 73 73 66 75 6c 6c 79 20 61  r successfully a
2d40: 6c 6c 6f 63 61 74 69 6e 67 0a 20 20 2a 2a 20 63  llocating.  ** c
2d50: 75 72 4d 61 69 6e 20 61 6e 64 20 63 61 6c 6c 69  urMain and calli
2d60: 6e 67 20 73 71 6c 69 74 65 33 42 74 72 65 65 45  ng sqlite3BtreeE
2d70: 6e 74 65 72 28 29 2e 20 46 6f 72 20 61 6e 20 65  nter(). For an e
2d80: 72 72 6f 72 20 74 68 61 74 20 6f 63 63 75 72 73  rror that occurs
2d90: 0a 20 20 2a 2a 20 62 65 66 6f 72 65 20 74 68 61  .  ** before tha
2da0: 74 20 70 6f 69 6e 74 2c 20 6a 75 6d 70 20 74 6f  t point, jump to
2db0: 20 65 72 72 6f 72 5f 6f 75 74 2e 0a 20 20 2a 2f   error_out..  */
2dc0: 0a 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f  .initone_error_o
2dd0: 75 74 3a 0a 20 20 73 71 6c 69 74 65 33 42 74 72  ut:.  sqlite3Btr
2de0: 65 65 43 6c 6f 73 65 43 75 72 73 6f 72 28 63 75  eeCloseCursor(cu
2df0: 72 4d 61 69 6e 29 3b 0a 20 20 73 71 6c 69 74 65  rMain);.  sqlite
2e00: 33 5f 66 72 65 65 28 63 75 72 4d 61 69 6e 29 3b  3_free(curMain);
2e10: 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c  .  sqlite3BtreeL
2e20: 65 61 76 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a  eave(pDb->pBt);.
2e30: 0a 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 69 66  .error_out:.  if
2e40: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d  ( rc==SQLITE_NOM
2e50: 45 4d 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45  EM || rc==SQLITE
2e60: 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a  _IOERR_NOMEM ){.
2e70: 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61      db->mallocFa
2e80: 69 6c 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20  iled = 1;.  }.  
2e90: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
2ea0: 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 61  .** Initialize a
2eb0: 6c 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  ll database file
2ec0: 73 20 2d 20 74 68 65 20 6d 61 69 6e 20 64 61 74  s - the main dat
2ed0: 61 62 61 73 65 20 66 69 6c 65 2c 20 74 68 65 20  abase file, the 
2ee0: 66 69 6c 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20  file.** used to 
2ef0: 73 74 6f 72 65 20 74 65 6d 70 6f 72 61 72 79 20  store temporary 
2f00: 74 61 62 6c 65 73 2c 20 61 6e 64 20 61 6e 79 20  tables, and any 
2f10: 61 64 64 69 74 69 6f 6e 61 6c 20 64 61 74 61 62  additional datab
2f20: 61 73 65 20 66 69 6c 65 73 0a 2a 2a 20 63 72 65  ase files.** cre
2f30: 61 74 65 64 20 75 73 69 6e 67 20 41 54 54 41 43  ated using ATTAC
2f40: 48 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 52  H statements.  R
2f50: 65 74 75 72 6e 20 61 20 73 75 63 63 65 73 73 20  eturn a success 
2f60: 63 6f 64 65 2e 20 20 49 66 20 61 6e 0a 2a 2a 20  code.  If an.** 
2f70: 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 77 72  error occurs, wr
2f80: 69 74 65 20 61 6e 20 65 72 72 6f 72 20 6d 65 73  ite an error mes
2f90: 73 61 67 65 20 69 6e 74 6f 20 2a 70 7a 45 72 72  sage into *pzErr
2fa0: 4d 73 67 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72  Msg..**.** After
2fb0: 20 61 20 64 61 74 61 62 61 73 65 20 69 73 20 69   a database is i
2fc0: 6e 69 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 20  nitialized, the 
2fd0: 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 20  DB_SchemaLoaded 
2fe0: 62 69 74 20 69 73 20 73 65 74 0a 2a 2a 20 62 69  bit is set.** bi
2ff0: 74 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 20  t is set in the 
3000: 66 6c 61 67 73 20 66 69 65 6c 64 20 6f 66 20 74  flags field of t
3010: 68 65 20 44 62 20 73 74 72 75 63 74 75 72 65 2e  he Db structure.
3020: 20 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65   If the database
3030: 0a 2a 2a 20 66 69 6c 65 20 77 61 73 20 6f 66 20  .** file was of 
3040: 7a 65 72 6f 2d 6c 65 6e 67 74 68 2c 20 74 68 65  zero-length, the
3050: 6e 20 74 68 65 20 44 42 5f 45 6d 70 74 79 20 66  n the DB_Empty f
3060: 6c 61 67 20 69 73 20 61 6c 73 6f 20 73 65 74 2e  lag is also set.
3070: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49  .*/.int sqlite3I
3080: 6e 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c  nit(sqlite3 *db,
3090: 20 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67   char **pzErrMsg
30a0: 29 7b 0a 20 20 69 6e 74 20 69 2c 20 72 63 3b 0a  ){.  int i, rc;.
30b0: 20 20 69 6e 74 20 63 6f 6d 6d 69 74 5f 69 6e 74    int commit_int
30c0: 65 72 6e 61 6c 20 3d 20 21 28 64 62 2d 3e 66 6c  ernal = !(db->fl
30d0: 61 67 73 26 53 51 4c 49 54 45 5f 49 6e 74 65 72  ags&SQLITE_Inter
30e0: 6e 43 68 61 6e 67 65 73 29 3b 0a 20 20 0a 20 20  nChanges);.  .  
30f0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
3100: 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d  mutex_held(db->m
3110: 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 20 64  utex) );.  if( d
3120: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 20 72  b->init.busy ) r
3130: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
3140: 0a 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f  .  rc = SQLITE_O
3150: 4b 3b 0a 20 20 64 62 2d 3e 69 6e 69 74 2e 62 75  K;.  db->init.bu
3160: 73 79 20 3d 20 31 3b 0a 20 20 66 6f 72 28 69 3d  sy = 1;.  for(i=
3170: 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  0; rc==SQLITE_OK
3180: 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69   && i<db->nDb; i
3190: 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 44 62 48  ++){.    if( DbH
31a0: 61 73 50 72 6f 70 65 72 74 79 28 64 62 2c 20 69  asProperty(db, i
31b0: 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65  , DB_SchemaLoade
31c0: 64 29 20 7c 7c 20 69 3d 3d 31 20 29 20 63 6f 6e  d) || i==1 ) con
31d0: 74 69 6e 75 65 3b 0a 20 20 20 20 72 63 20 3d 20  tinue;.    rc = 
31e0: 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65 28 64  sqlite3InitOne(d
31f0: 62 2c 20 69 2c 20 70 7a 45 72 72 4d 73 67 29 3b  b, i, pzErrMsg);
3200: 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20  .    if( rc ){. 
3210: 20 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65       sqlite3Rese
3220: 74 49 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28  tInternalSchema(
3230: 64 62 2c 20 69 29 3b 0a 20 20 20 20 7d 0a 20 20  db, i);.    }.  
3240: 7d 0a 0a 20 20 2f 2a 20 4f 6e 63 65 20 61 6c 6c  }..  /* Once all
3250: 20 74 68 65 20 6f 74 68 65 72 20 64 61 74 61 62   the other datab
3260: 61 73 65 73 20 68 61 76 65 20 62 65 65 6e 20 69  ases have been i
3270: 6e 69 74 69 61 6c 69 73 65 64 2c 20 6c 6f 61 64  nitialised, load
3280: 20 74 68 65 20 73 63 68 65 6d 61 0a 20 20 2a 2a   the schema.  **
3290: 20 66 6f 72 20 74 68 65 20 54 45 4d 50 20 64 61   for the TEMP da
32a0: 74 61 62 61 73 65 2e 20 54 68 69 73 20 69 73 20  tabase. This is 
32b0: 6c 6f 61 64 65 64 20 6c 61 73 74 2c 20 61 73 20  loaded last, as 
32c0: 74 68 65 20 54 45 4d 50 20 64 61 74 61 62 61 73  the TEMP databas
32d0: 65 0a 20 20 2a 2a 20 73 63 68 65 6d 61 20 6d 61  e.  ** schema ma
32e0: 79 20 63 6f 6e 74 61 69 6e 20 72 65 66 65 72 65  y contain refere
32f0: 6e 63 65 73 20 74 6f 20 6f 62 6a 65 63 74 73 20  nces to objects 
3300: 69 6e 20 6f 74 68 65 72 20 64 61 74 61 62 61 73  in other databas
3310: 65 73 2e 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 66  es..  */.#ifndef
3320: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d   SQLITE_OMIT_TEM
3330: 50 44 42 0a 20 20 69 66 28 20 72 63 3d 3d 53 51  PDB.  if( rc==SQ
3340: 4c 49 54 45 5f 4f 4b 20 26 26 20 64 62 2d 3e 6e  LITE_OK && db->n
3350: 44 62 3e 31 20 26 26 20 21 44 62 48 61 73 50 72  Db>1 && !DbHasPr
3360: 6f 70 65 72 74 79 28 64 62 2c 20 31 2c 20 44 42  operty(db, 1, DB
3370: 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 20 29  _SchemaLoaded) )
3380: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74  {.    rc = sqlit
3390: 65 33 49 6e 69 74 4f 6e 65 28 64 62 2c 20 31 2c  e3InitOne(db, 1,
33a0: 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20   pzErrMsg);.    
33b0: 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20  if( rc ){.      
33c0: 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65  sqlite3ResetInte
33d0: 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 31  rnalSchema(db, 1
33e0: 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e  );.    }.  }.#en
33f0: 64 69 66 0a 0a 20 20 64 62 2d 3e 69 6e 69 74 2e  dif..  db->init.
3400: 62 75 73 79 20 3d 20 30 3b 0a 20 20 69 66 28 20  busy = 0;.  if( 
3410: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26  rc==SQLITE_OK &&
3420: 20 63 6f 6d 6d 69 74 5f 69 6e 74 65 72 6e 61 6c   commit_internal
3430: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43   ){.    sqlite3C
3440: 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61  ommitInternalCha
3450: 6e 67 65 73 28 64 62 29 3b 0a 20 20 7d 0a 0a 20  nges(db);.  }.. 
3460: 20 72 65 74 75 72 6e 20 72 63 3b 20 0a 7d 0a 0a   return rc; .}..
3470: 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69  /*.** This routi
3480: 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66  ne is a no-op if
3490: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63   the database sc
34a0: 68 65 6d 61 20 69 73 20 61 6c 72 65 61 64 79 20  hema is already 
34b0: 69 6e 69 74 69 61 6c 69 73 65 64 2e 0a 2a 2a 20  initialised..** 
34c0: 4f 74 68 65 72 77 69 73 65 2c 20 74 68 65 20 73  Otherwise, the s
34d0: 63 68 65 6d 61 20 69 73 20 6c 6f 61 64 65 64 2e  chema is loaded.
34e0: 20 41 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69   An error code i
34f0: 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69  s returned..*/.i
3500: 6e 74 20 73 71 6c 69 74 65 33 52 65 61 64 53 63  nt sqlite3ReadSc
3510: 68 65 6d 61 28 50 61 72 73 65 20 2a 70 50 61 72  hema(Parse *pPar
3520: 73 65 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20  se){.  int rc = 
3530: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 73 71 6c  SQLITE_OK;.  sql
3540: 69 74 65 33 20 2a 64 62 20 3d 20 70 50 61 72 73  ite3 *db = pPars
3550: 65 2d 3e 64 62 3b 0a 20 20 61 73 73 65 72 74 28  e->db;.  assert(
3560: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
3570: 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29  eld(db->mutex) )
3580: 3b 0a 20 20 69 66 28 20 21 64 62 2d 3e 69 6e 69  ;.  if( !db->ini
3590: 74 2e 62 75 73 79 20 29 7b 0a 20 20 20 20 72 63  t.busy ){.    rc
35a0: 20 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 28 64   = sqlite3Init(d
35b0: 62 2c 20 26 70 50 61 72 73 65 2d 3e 7a 45 72 72  b, &pParse->zErr
35c0: 4d 73 67 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  Msg);.  }.  if( 
35d0: 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc!=SQLITE_OK ){
35e0: 0a 20 20 20 20 70 50 61 72 73 65 2d 3e 72 63 20  .    pParse->rc 
35f0: 3d 20 72 63 3b 0a 20 20 20 20 70 50 61 72 73 65  = rc;.    pParse
3600: 2d 3e 6e 45 72 72 2b 2b 3b 0a 20 20 7d 0a 20 20  ->nErr++;.  }.  
3610: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f  return rc;.}.../
3620: 2a 0a 2a 2a 20 43 68 65 63 6b 20 73 63 68 65 6d  *.** Check schem
3630: 61 20 63 6f 6f 6b 69 65 73 20 69 6e 20 61 6c 6c  a cookies in all
3640: 20 64 61 74 61 62 61 73 65 73 2e 20 20 49 66 20   databases.  If 
3650: 61 6e 79 20 63 6f 6f 6b 69 65 20 69 73 20 6f 75  any cookie is ou
3660: 74 0a 2a 2a 20 6f 66 20 64 61 74 65 2c 20 72 65  t.** of date, re
3670: 74 75 72 6e 20 30 2e 20 20 49 66 20 61 6c 6c 20  turn 0.  If all 
3680: 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65 73 20 61  schema cookies a
3690: 72 65 20 63 75 72 72 65 6e 74 2c 20 72 65 74 75  re current, retu
36a0: 72 6e 20 31 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  rn 1..*/.static 
36b0: 69 6e 74 20 73 63 68 65 6d 61 49 73 56 61 6c 69  int schemaIsVali
36c0: 64 28 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a  d(sqlite3 *db){.
36d0: 20 20 69 6e 74 20 69 44 62 3b 0a 20 20 69 6e 74    int iDb;.  int
36e0: 20 72 63 3b 0a 20 20 42 74 43 75 72 73 6f 72 20   rc;.  BtCursor 
36f0: 2a 63 75 72 54 65 6d 70 3b 0a 20 20 69 6e 74 20  *curTemp;.  int 
3700: 63 6f 6f 6b 69 65 3b 0a 20 20 69 6e 74 20 61 6c  cookie;.  int al
3710: 6c 4f 6b 20 3d 20 31 3b 0a 0a 20 20 63 75 72 54  lOk = 1;..  curT
3720: 65 6d 70 20 3d 20 28 42 74 43 75 72 73 6f 72 20  emp = (BtCursor 
3730: 2a 29 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28  *)sqlite3Malloc(
3740: 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73  sqlite3BtreeCurs
3750: 6f 72 53 69 7a 65 28 29 29 3b 0a 20 20 69 66 28  orSize());.  if(
3760: 20 63 75 72 54 65 6d 70 20 29 7b 0a 20 20 20 20   curTemp ){.    
3770: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
3780: 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d  mutex_held(db->m
3790: 75 74 65 78 29 20 29 3b 0a 20 20 20 20 66 6f 72  utex) );.    for
37a0: 28 69 44 62 3d 30 3b 20 61 6c 6c 4f 6b 20 26 26  (iDb=0; allOk &&
37b0: 20 69 44 62 3c 64 62 2d 3e 6e 44 62 3b 20 69 44   iDb<db->nDb; iD
37c0: 62 2b 2b 29 7b 0a 20 20 20 20 20 20 42 74 72 65  b++){.      Btre
37d0: 65 20 2a 70 42 74 3b 0a 20 20 20 20 20 20 70 42  e *pBt;.      pB
37e0: 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d  t = db->aDb[iDb]
37f0: 2e 70 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20  .pBt;.      if( 
3800: 70 42 74 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75  pBt==0 ) continu
3810: 65 3b 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28  e;.      memset(
3820: 63 75 72 54 65 6d 70 2c 20 30 2c 20 73 71 6c 69  curTemp, 0, sqli
3830: 74 65 33 42 74 72 65 65 43 75 72 73 6f 72 53 69  te3BtreeCursorSi
3840: 7a 65 28 29 29 3b 0a 20 20 20 20 20 20 72 63 20  ze());.      rc 
3850: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 43 75  = sqlite3BtreeCu
3860: 72 73 6f 72 28 70 42 74 2c 20 4d 41 53 54 45 52  rsor(pBt, MASTER
3870: 5f 52 4f 4f 54 2c 20 30 2c 20 30 2c 20 63 75 72  _ROOT, 0, 0, cur
3880: 54 65 6d 70 29 3b 0a 20 20 20 20 20 20 69 66 28  Temp);.      if(
3890: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29   rc==SQLITE_OK )
38a0: 7b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73  {.        rc = s
38b0: 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 4d 65  qlite3BtreeGetMe
38c0: 74 61 28 70 42 74 2c 20 31 2c 20 28 75 33 32 20  ta(pBt, 1, (u32 
38d0: 2a 29 26 63 6f 6f 6b 69 65 29 3b 0a 20 20 20 20  *)&cookie);.    
38e0: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
38f0: 54 45 5f 4f 4b 20 26 26 20 63 6f 6f 6b 69 65 21  TE_OK && cookie!
3900: 3d 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 53  =db->aDb[iDb].pS
3910: 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 5f 63 6f  chema->schema_co
3920: 6f 6b 69 65 20 29 7b 0a 20 20 20 20 20 20 20 20  okie ){.        
3930: 20 20 61 6c 6c 4f 6b 20 3d 20 30 3b 0a 20 20 20    allOk = 0;.   
3940: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 20 20 73       }.        s
3950: 71 6c 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65  qlite3BtreeClose
3960: 43 75 72 73 6f 72 28 63 75 72 54 65 6d 70 29 3b  Cursor(curTemp);
3970: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69  .      }.      i
3980: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f  f( rc==SQLITE_NO
3990: 4d 45 4d 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54  MEM || rc==SQLIT
39a0: 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d 20 29 7b  E_IOERR_NOMEM ){
39b0: 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 6d 61 6c  .        db->mal
39c0: 6c 6f 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a 20  locFailed = 1;. 
39d0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20       }.    }.   
39e0: 20 73 71 6c 69 74 65 33 5f 66 72 65 65 28 63 75   sqlite3_free(cu
39f0: 72 54 65 6d 70 29 3b 0a 20 20 7d 65 6c 73 65 7b  rTemp);.  }else{
3a00: 0a 20 20 20 20 61 6c 6c 4f 6b 20 3d 20 30 3b 0a  .    allOk = 0;.
3a10: 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61      db->mallocFa
3a20: 69 6c 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20  iled = 1;.  }.. 
3a30: 20 72 65 74 75 72 6e 20 61 6c 6c 4f 6b 3b 0a 7d   return allOk;.}
3a40: 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20  ../*.** Convert 
3a50: 61 20 73 63 68 65 6d 61 20 70 6f 69 6e 74 65 72  a schema pointer
3a60: 20 69 6e 74 6f 20 74 68 65 20 69 44 62 20 69 6e   into the iDb in
3a70: 64 65 78 20 74 68 61 74 20 69 6e 64 69 63 61 74  dex that indicat
3a80: 65 73 0a 2a 2a 20 77 68 69 63 68 20 64 61 74 61  es.** which data
3a90: 62 61 73 65 20 66 69 6c 65 20 69 6e 20 64 62 2d  base file in db-
3aa0: 3e 61 44 62 5b 5d 20 74 68 65 20 73 63 68 65 6d  >aDb[] the schem
3ab0: 61 20 72 65 66 65 72 73 20 74 6f 2e 0a 2a 2a 0a  a refers to..**.
3ac0: 2a 2a 20 49 66 20 74 68 65 20 73 61 6d 65 20 64  ** If the same d
3ad0: 61 74 61 62 61 73 65 20 69 73 20 61 74 74 61 63  atabase is attac
3ae0: 68 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e  hed more than on
3af0: 63 65 2c 20 74 68 65 20 66 69 72 73 74 0a 2a 2a  ce, the first.**
3b00: 20 61 74 74 61 63 68 65 64 20 64 61 74 61 62 61   attached databa
3b10: 73 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a  se is returned..
3b20: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 63  */.int sqlite3Sc
3b30: 68 65 6d 61 54 6f 49 6e 64 65 78 28 73 71 6c 69  hemaToIndex(sqli
3b40: 74 65 33 20 2a 64 62 2c 20 53 63 68 65 6d 61 20  te3 *db, Schema 
3b50: 2a 70 53 63 68 65 6d 61 29 7b 0a 20 20 69 6e 74  *pSchema){.  int
3b60: 20 69 20 3d 20 2d 31 30 30 30 30 30 30 3b 0a 0a   i = -1000000;..
3b70: 20 20 2f 2a 20 49 66 20 70 53 63 68 65 6d 61 20    /* If pSchema 
3b80: 69 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 72 65  is NULL, then re
3b90: 74 75 72 6e 20 2d 31 30 30 30 30 30 30 2e 20 54  turn -1000000. T
3ba0: 68 69 73 20 68 61 70 70 65 6e 73 20 77 68 65 6e  his happens when
3bb0: 20 63 6f 64 65 20 69 6e 20 0a 20 20 2a 2a 20 65   code in .  ** e
3bc0: 78 70 72 2e 63 20 69 73 20 74 72 79 69 6e 67 20  xpr.c is trying 
3bd0: 74 6f 20 72 65 73 6f 6c 76 65 20 61 20 72 65 66  to resolve a ref
3be0: 65 72 65 6e 63 65 20 74 6f 20 61 20 74 72 61 6e  erence to a tran
3bf0: 73 69 65 6e 74 20 74 61 62 6c 65 20 28 69 2e 65  sient table (i.e
3c00: 2e 20 6f 6e 65 0a 20 20 2a 2a 20 63 72 65 61 74  . one.  ** creat
3c10: 65 64 20 62 79 20 61 20 73 75 62 2d 73 65 6c 65  ed by a sub-sele
3c20: 63 74 29 2e 20 49 6e 20 74 68 69 73 20 63 61 73  ct). In this cas
3c30: 65 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c  e the return val
3c40: 75 65 20 6f 66 20 74 68 69 73 20 0a 20 20 2a 2a  ue of this .  **
3c50: 20 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64   function should
3c60: 20 6e 65 76 65 72 20 62 65 20 75 73 65 64 2e 0a   never be used..
3c70: 20 20 2a 2a 0a 20 20 2a 2a 20 57 65 20 72 65 74    **.  ** We ret
3c80: 75 72 6e 20 2d 31 30 30 30 30 30 30 20 69 6e 73  urn -1000000 ins
3c90: 74 65 61 64 20 6f 66 20 74 68 65 20 6d 6f 72 65  tead of the more
3ca0: 20 75 73 75 61 6c 20 2d 31 20 73 69 6d 70 6c 79   usual -1 simply
3cb0: 20 62 65 63 61 75 73 65 20 75 73 69 6e 67 0a 20   because using. 
3cc0: 20 2a 2a 20 2d 31 30 30 30 30 30 30 20 61 73 20   ** -1000000 as 
3cd0: 74 68 65 20 69 6e 63 6f 72 72 65 63 74 20 69 6e  the incorrect in
3ce0: 64 65 78 20 69 6e 74 6f 20 64 62 2d 3e 61 44 62  dex into db->aDb
3cf0: 5b 5d 20 69 73 20 6d 75 63 68 20 0a 20 20 2a 2a  [] is much .  **
3d00: 20 6d 6f 72 65 20 6c 69 6b 65 6c 79 20 74 6f 20   more likely to 
3d10: 63 61 75 73 65 20 61 20 73 65 67 66 61 75 6c 74  cause a segfault
3d20: 20 74 68 61 6e 20 2d 31 20 28 6f 66 20 63 6f 75   than -1 (of cou
3d30: 72 73 65 20 74 68 65 72 65 20 61 72 65 20 61 73  rse there are as
3d40: 73 65 72 74 28 29 0a 20 20 2a 2a 20 73 74 61 74  sert().  ** stat
3d50: 65 6d 65 6e 74 73 20 74 6f 6f 2c 20 62 75 74 20  ements too, but 
3d60: 69 74 20 6e 65 76 65 72 20 68 75 72 74 73 20 74  it never hurts t
3d70: 6f 20 70 6c 61 79 20 74 68 65 20 6f 64 64 73 29  o play the odds)
3d80: 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28  ..  */.  assert(
3d90: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
3da0: 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29  eld(db->mutex) )
3db0: 3b 0a 20 20 69 66 28 20 70 53 63 68 65 6d 61 20  ;.  if( pSchema 
3dc0: 29 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20  ){.    for(i=0; 
3dd0: 41 4c 57 41 59 53 28 69 3c 64 62 2d 3e 6e 44 62  ALWAYS(i<db->nDb
3de0: 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69  ); i++){.      i
3df0: 66 28 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 53  f( db->aDb[i].pS
3e00: 63 68 65 6d 61 3d 3d 70 53 63 68 65 6d 61 20 29  chema==pSchema )
3e10: 7b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b  {.        break;
3e20: 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20  .      }.    }. 
3e30: 20 20 20 61 73 73 65 72 74 28 20 69 3e 3d 30 20     assert( i>=0 
3e40: 26 26 20 69 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a  && i<db->nDb );.
3e50: 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a    }.  return i;.
3e60: 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 69 6c 65  }../*.** Compile
3e70: 20 74 68 65 20 55 54 46 2d 38 20 65 6e 63 6f 64   the UTF-8 encod
3e80: 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  ed SQL statement
3e90: 20 7a 53 71 6c 20 69 6e 74 6f 20 61 20 73 74 61   zSql into a sta
3ea0: 74 65 6d 65 6e 74 20 68 61 6e 64 6c 65 2e 0a 2a  tement handle..*
3eb0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c  /.static int sql
3ec0: 69 74 65 33 50 72 65 70 61 72 65 28 0a 20 20 73  ite3Prepare(.  s
3ed0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20  qlite3 *db,     
3ee0: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61           /* Data
3ef0: 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a  base handle. */.
3f00: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53    const char *zS
3f10: 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55  ql,         /* U
3f20: 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 4c  TF-8 encoded SQL
3f30: 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20   statement. */. 
3f40: 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20   int nBytes,    
3f50: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65             /* Le
3f60: 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20  ngth of zSql in 
3f70: 62 79 74 65 73 2e 20 2a 2f 0a 20 20 69 6e 74 20  bytes. */.  int 
3f80: 73 61 76 65 53 71 6c 46 6c 61 67 2c 20 20 20 20  saveSqlFlag,    
3f90: 20 20 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f        /* True to
3fa0: 20 63 6f 70 79 20 53 51 4c 20 74 65 78 74 20 69   copy SQL text i
3fb0: 6e 74 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f  nto the sqlite3_
3fc0: 73 74 6d 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65  stmt */.  sqlite
3fd0: 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c  3_stmt **ppStmt,
3fe0: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f      /* OUT: A po
3ff0: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65  inter to the pre
4000: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20  pared statement 
4010: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  */.  const char 
4020: 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f  **pzTail       /
4030: 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61  * OUT: End of pa
4040: 72 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29  rsed string */.)
4050: 7b 0a 20 20 50 61 72 73 65 20 73 50 61 72 73 65  {.  Parse sParse
4060: 3b 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73  ;.  char *zErrMs
4070: 67 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 20  g = 0;.  int rc 
4080: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69  = SQLITE_OK;.  i
4090: 6e 74 20 69 3b 0a 0a 20 20 69 66 28 20 73 71 6c  nt i;..  if( sql
40a0: 69 74 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29  ite3SafetyOn(db)
40b0: 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45   ) return SQLITE
40c0: 5f 4d 49 53 55 53 45 3b 0a 20 20 61 73 73 65 72  _MISUSE;.  asser
40d0: 74 28 20 70 70 53 74 6d 74 20 26 26 20 2a 70 70  t( ppStmt && *pp
40e0: 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 61 73 73  Stmt==0 );.  ass
40f0: 65 72 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63  ert( !db->malloc
4100: 46 61 69 6c 65 64 20 29 3b 0a 20 20 61 73 73 65  Failed );.  asse
4110: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65  rt( sqlite3_mute
4120: 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78  x_held(db->mutex
4130: 29 20 29 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b  ) );..  /* Check
4140: 20 74 6f 20 76 65 72 69 66 79 20 74 68 61 74 20   to verify that 
4150: 69 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74  it is possible t
4160: 6f 20 67 65 74 20 61 20 72 65 61 64 20 6c 6f 63  o get a read loc
4170: 6b 20 6f 6e 20 61 6c 6c 0a 20 20 2a 2a 20 64 61  k on all.  ** da
4180: 74 61 62 61 73 65 20 73 63 68 65 6d 61 73 2e 20  tabase schemas. 
4190: 20 54 68 65 20 69 6e 61 62 69 6c 69 74 79 20 74   The inability t
41a0: 6f 20 67 65 74 20 61 20 72 65 61 64 20 6c 6f 63  o get a read loc
41b0: 6b 20 69 6e 64 69 63 61 74 65 73 20 74 68 61 74  k indicates that
41c0: 0a 20 20 2a 2a 20 73 6f 6d 65 20 6f 74 68 65 72  .  ** some other
41d0: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63   database connec
41e0: 74 69 6f 6e 20 69 73 20 68 6f 6c 64 69 6e 67 20  tion is holding 
41f0: 61 20 77 72 69 74 65 2d 6c 6f 63 6b 2c 20 77 68  a write-lock, wh
4200: 69 63 68 20 69 6e 0a 20 20 2a 2a 20 74 75 72 6e  ich in.  ** turn
4210: 20 6d 65 61 6e 73 20 74 68 61 74 20 74 68 65 20   means that the 
4220: 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e  other connection
4230: 20 68 61 73 20 6d 61 64 65 20 75 6e 63 6f 6d 6d   has made uncomm
4240: 69 74 74 65 64 20 63 68 61 6e 67 65 73 0a 20 20  itted changes.  
4250: 2a 2a 20 74 6f 20 74 68 65 20 73 63 68 65 6d 61  ** to the schema
4260: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 65 72 65  ..  **.  ** Were
4270: 20 77 65 20 74 6f 20 70 72 6f 63 65 65 64 20 61   we to proceed a
4280: 6e 64 20 70 72 65 70 61 72 65 20 74 68 65 20 73  nd prepare the s
4290: 74 61 74 65 6d 65 6e 74 20 61 67 61 69 6e 73 74  tatement against
42a0: 20 74 68 65 20 75 6e 63 6f 6d 6d 69 74 74 65 64   the uncommitted
42b0: 0a 20 20 2a 2a 20 73 63 68 65 6d 61 20 63 68 61  .  ** schema cha
42c0: 6e 67 65 73 20 61 6e 64 20 69 66 20 74 68 6f 73  nges and if thos
42d0: 65 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73  e schema changes
42e0: 20 61 72 65 20 73 75 62 73 65 71 75 65 6e 74 6c   are subsequentl
42f0: 79 20 72 6f 6c 6c 65 64 0a 20 20 2a 2a 20 62 61  y rolled.  ** ba
4300: 63 6b 20 61 6e 64 20 64 69 66 66 65 72 65 6e 74  ck and different
4310: 20 63 68 61 6e 67 65 73 20 61 72 65 20 6d 61 64   changes are mad
4320: 65 20 69 6e 20 74 68 65 69 72 20 70 6c 61 63 65  e in their place
4330: 2c 20 74 68 65 6e 20 77 68 65 6e 20 74 68 69 73  , then when this
4340: 0a 20 20 2a 2a 20 70 72 65 70 61 72 65 64 20 73  .  ** prepared s
4350: 74 61 74 65 6d 65 6e 74 20 67 6f 65 73 20 74 6f  tatement goes to
4360: 20 72 75 6e 20 74 68 65 20 73 63 68 65 6d 61 20   run the schema 
4370: 63 6f 6f 6b 69 65 20 77 6f 75 6c 64 20 66 61 69  cookie would fai
4380: 6c 20 74 6f 20 64 65 74 65 63 74 0a 20 20 2a 2a  l to detect.  **
4390: 20 74 68 65 20 73 63 68 65 6d 61 20 63 68 61 6e   the schema chan
43a0: 67 65 2e 20 20 44 69 73 61 73 74 65 72 20 77 6f  ge.  Disaster wo
43b0: 75 6c 64 20 66 6f 6c 6c 6f 77 2e 0a 20 20 2a 2a  uld follow..  **
43c0: 0a 20 20 2a 2a 20 54 68 69 73 20 74 68 72 65 61  .  ** This threa
43d0: 64 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 68  d is currently h
43e0: 6f 6c 64 69 6e 67 20 6d 75 74 65 78 65 73 20 6f  olding mutexes o
43f0: 6e 20 61 6c 6c 20 42 74 72 65 65 73 20 28 62 65  n all Btrees (be
4400: 63 61 75 73 65 0a 20 20 2a 2a 20 6f 66 20 74 68  cause.  ** of th
4410: 65 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e  e sqlite3BtreeEn
4420: 74 65 72 41 6c 6c 28 29 20 69 6e 20 73 71 6c 69  terAll() in sqli
4430: 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72  te3LockAndPrepar
4440: 65 28 29 29 20 73 6f 20 69 74 0a 20 20 2a 2a 20  e()) so it.  ** 
4450: 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20  is not possible 
4460: 66 6f 72 20 61 6e 6f 74 68 65 72 20 74 68 72 65  for another thre
4470: 61 64 20 74 6f 20 73 74 61 72 74 20 61 20 6e 65  ad to start a ne
4480: 77 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 0a  w schema change.
4490: 20 20 2a 2a 20 77 68 69 6c 65 20 74 68 69 73 20    ** while this 
44a0: 72 6f 75 74 69 6e 65 20 69 73 20 72 75 6e 6e 69  routine is runni
44b0: 6e 67 2e 20 20 48 65 6e 63 65 2c 20 77 65 20 64  ng.  Hence, we d
44c0: 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f 20 68 6f  o not need to ho
44d0: 6c 64 20 0a 20 20 2a 2a 20 6c 6f 63 6b 73 20 6f  ld .  ** locks o
44e0: 6e 20 74 68 65 20 73 63 68 65 6d 61 2c 20 77 65  n the schema, we
44f0: 20 6a 75 73 74 20 6e 65 65 64 20 74 6f 20 6d 61   just need to ma
4500: 6b 65 20 73 75 72 65 20 6e 6f 62 6f 64 79 20 65  ke sure nobody e
4510: 6c 73 65 20 69 73 20 0a 20 20 2a 2a 20 68 6f 6c  lse is .  ** hol
4520: 64 69 6e 67 20 74 68 65 6d 2e 0a 20 20 2a 2a 0a  ding them..  **.
4530: 20 20 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 73    ** Note that s
4540: 65 74 74 69 6e 67 20 52 45 41 44 5f 55 4e 43 4f  etting READ_UNCO
4550: 4d 4d 49 54 54 45 44 20 6f 76 65 72 72 69 64 65  MMITTED override
4560: 73 20 6d 6f 73 74 20 6c 6f 63 6b 20 64 65 74 65  s most lock dete
4570: 63 74 69 6f 6e 2c 0a 20 20 2a 2a 20 62 75 74 20  ction,.  ** but 
4580: 69 74 20 64 6f 65 73 20 2a 6e 6f 74 2a 20 6f 76  it does *not* ov
4590: 65 72 72 69 64 65 20 73 63 68 65 6d 61 20 6c 6f  erride schema lo
45a0: 63 6b 20 64 65 74 65 63 74 69 6f 6e 2c 20 73 6f  ck detection, so
45b0: 20 74 68 69 73 20 61 6c 6c 20 73 74 69 6c 6c 0a   this all still.
45c0: 20 20 2a 2a 20 77 6f 72 6b 73 20 65 76 65 6e 20    ** works even 
45d0: 69 66 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54  if READ_UNCOMMIT
45e0: 54 45 44 20 69 73 20 73 65 74 2e 0a 20 20 2a 2f  TED is set..  */
45f0: 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62  .  for(i=0; i<db
4600: 2d 3e 6e 44 62 3b 20 69 2b 2b 29 20 7b 0a 20 20  ->nDb; i++) {.  
4610: 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64    Btree *pBt = d
4620: 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20  b->aDb[i].pBt;. 
4630: 20 20 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20     if( pBt ){.  
4640: 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c 69      assert( sqli
4650: 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74  te3BtreeHoldsMut
4660: 65 78 28 70 42 74 29 20 29 3b 0a 20 20 20 20 20  ex(pBt) );.     
4670: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72   rc = sqlite3Btr
4680: 65 65 53 63 68 65 6d 61 4c 6f 63 6b 65 64 28 70  eeSchemaLocked(p
4690: 42 74 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72  Bt);.      if( r
46a0: 63 20 29 7b 0a 20 20 20 20 20 20 20 20 63 6f 6e  c ){.        con
46b0: 73 74 20 63 68 61 72 20 2a 7a 44 62 20 3d 20 64  st char *zDb = d
46c0: 62 2d 3e 61 44 62 5b 69 5d 2e 7a 4e 61 6d 65 3b  b->aDb[i].zName;
46d0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
46e0: 45 72 72 6f 72 28 64 62 2c 20 72 63 2c 20 22 64  Error(db, rc, "d
46f0: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 69  atabase schema i
4700: 73 20 6c 6f 63 6b 65 64 3a 20 25 73 22 2c 20 7a  s locked: %s", z
4710: 44 62 29 3b 0a 20 20 20 20 20 20 20 20 28 76 6f  Db);.        (vo
4720: 69 64 29 73 71 6c 69 74 65 33 53 61 66 65 74 79  id)sqlite3Safety
4730: 4f 66 66 28 64 62 29 3b 0a 20 20 20 20 20 20 20  Off(db);.       
4740: 20 74 65 73 74 63 61 73 65 28 20 64 62 2d 3e 66   testcase( db->f
4750: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65  lags & SQLITE_Re
4760: 61 64 55 6e 63 6f 6d 6d 69 74 74 65 64 20 29 3b  adUncommitted );
4770: 0a 20 20 20 20 20 20 20 20 72 65 74 75 72 6e 20  .        return 
4780: 73 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64  sqlite3ApiExit(d
4790: 62 2c 20 72 63 29 3b 0a 20 20 20 20 20 20 7d 0a  b, rc);.      }.
47a0: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 6d      }.  }.  .  m
47b0: 65 6d 73 65 74 28 26 73 50 61 72 73 65 2c 20 30  emset(&sParse, 0
47c0: 2c 20 73 69 7a 65 6f 66 28 73 50 61 72 73 65 29  , sizeof(sParse)
47d0: 29 3b 0a 20 20 73 50 61 72 73 65 2e 64 62 20 3d  );.  sParse.db =
47e0: 20 64 62 3b 0a 20 20 69 66 28 20 6e 42 79 74 65   db;.  if( nByte
47f0: 73 3e 3d 30 20 26 26 20 28 6e 42 79 74 65 73 3d  s>=0 && (nBytes=
4800: 3d 30 20 7c 7c 20 7a 53 71 6c 5b 6e 42 79 74 65  =0 || zSql[nByte
4810: 73 2d 31 5d 21 3d 30 29 20 29 7b 0a 20 20 20 20  s-1]!=0) ){.    
4820: 63 68 61 72 20 2a 7a 53 71 6c 43 6f 70 79 3b 0a  char *zSqlCopy;.
4830: 20 20 20 20 69 6e 74 20 6d 78 4c 65 6e 20 3d 20      int mxLen = 
4840: 64 62 2d 3e 61 4c 69 6d 69 74 5b 53 51 4c 49 54  db->aLimit[SQLIT
4850: 45 5f 4c 49 4d 49 54 5f 53 51 4c 5f 4c 45 4e 47  E_LIMIT_SQL_LENG
4860: 54 48 5d 3b 0a 20 20 20 20 69 66 28 20 6e 42 79  TH];.    if( nBy
4870: 74 65 73 3e 6d 78 4c 65 6e 20 29 7b 0a 20 20 20  tes>mxLen ){.   
4880: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
4890: 64 62 2c 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49  db, SQLITE_TOOBI
48a0: 47 2c 20 22 73 74 61 74 65 6d 65 6e 74 20 74 6f  G, "statement to
48b0: 6f 20 6c 6f 6e 67 22 29 3b 0a 20 20 20 20 20 20  o long");.      
48c0: 28 76 6f 69 64 29 73 71 6c 69 74 65 33 53 61 66  (void)sqlite3Saf
48d0: 65 74 79 4f 66 66 28 64 62 29 3b 0a 20 20 20 20  etyOff(db);.    
48e0: 20 20 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33    return sqlite3
48f0: 41 70 69 45 78 69 74 28 64 62 2c 20 53 51 4c 49  ApiExit(db, SQLI
4900: 54 45 5f 54 4f 4f 42 49 47 29 3b 0a 20 20 20 20  TE_TOOBIG);.    
4910: 7d 0a 20 20 20 20 7a 53 71 6c 43 6f 70 79 20 3d  }.    zSqlCopy =
4920: 20 73 71 6c 69 74 65 33 44 62 53 74 72 4e 44 75   sqlite3DbStrNDu
4930: 70 28 64 62 2c 20 7a 53 71 6c 2c 20 6e 42 79 74  p(db, zSql, nByt
4940: 65 73 29 3b 0a 20 20 20 20 69 66 28 20 7a 53 71  es);.    if( zSq
4950: 6c 43 6f 70 79 20 29 7b 0a 20 20 20 20 20 20 73  lCopy ){.      s
4960: 71 6c 69 74 65 33 52 75 6e 50 61 72 73 65 72 28  qlite3RunParser(
4970: 26 73 50 61 72 73 65 2c 20 7a 53 71 6c 43 6f 70  &sParse, zSqlCop
4980: 79 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20  y, &zErrMsg);.  
4990: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65      sqlite3DbFre
49a0: 65 28 64 62 2c 20 7a 53 71 6c 43 6f 70 79 29 3b  e(db, zSqlCopy);
49b0: 0a 20 20 20 20 20 20 73 50 61 72 73 65 2e 7a 54  .      sParse.zT
49c0: 61 69 6c 20 3d 20 26 7a 53 71 6c 5b 73 50 61 72  ail = &zSql[sPar
49d0: 73 65 2e 7a 54 61 69 6c 2d 7a 53 71 6c 43 6f 70  se.zTail-zSqlCop
49e0: 79 5d 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20  y];.    }else{. 
49f0: 20 20 20 20 20 73 50 61 72 73 65 2e 7a 54 61 69       sParse.zTai
4a00: 6c 20 3d 20 26 7a 53 71 6c 5b 6e 42 79 74 65 73  l = &zSql[nBytes
4a10: 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65  ];.    }.  }else
4a20: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 52 75 6e  {.    sqlite3Run
4a30: 50 61 72 73 65 72 28 26 73 50 61 72 73 65 2c 20  Parser(&sParse, 
4a40: 7a 53 71 6c 2c 20 26 7a 45 72 72 4d 73 67 29 3b  zSql, &zErrMsg);
4a50: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 64 62 2d 3e  .  }..  if( db->
4a60: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a  mallocFailed ){.
4a70: 20 20 20 20 73 50 61 72 73 65 2e 72 63 20 3d 20      sParse.rc = 
4a80: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20  SQLITE_NOMEM;.  
4a90: 7d 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 72  }.  if( sParse.r
4aa0: 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29  c==SQLITE_DONE )
4ab0: 20 73 50 61 72 73 65 2e 72 63 20 3d 20 53 51 4c   sParse.rc = SQL
4ac0: 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 73 50  ITE_OK;.  if( sP
4ad0: 61 72 73 65 2e 63 68 65 63 6b 53 63 68 65 6d 61  arse.checkSchema
4ae0: 20 26 26 20 21 73 63 68 65 6d 61 49 73 56 61 6c   && !schemaIsVal
4af0: 69 64 28 64 62 29 20 29 7b 0a 20 20 20 20 73 50  id(db) ){.    sP
4b00: 61 72 73 65 2e 72 63 20 3d 20 53 51 4c 49 54 45  arse.rc = SQLITE
4b10: 5f 53 43 48 45 4d 41 3b 0a 20 20 7d 0a 20 20 69  _SCHEMA;.  }.  i
4b20: 66 28 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51  f( sParse.rc==SQ
4b30: 4c 49 54 45 5f 53 43 48 45 4d 41 20 29 7b 0a 20  LITE_SCHEMA ){. 
4b40: 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 49     sqlite3ResetI
4b50: 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62  nternalSchema(db
4b60: 2c 20 30 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  , 0);.  }.  if( 
4b70: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  db->mallocFailed
4b80: 20 29 7b 0a 20 20 20 20 73 50 61 72 73 65 2e 72   ){.    sParse.r
4b90: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
4ba0: 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 7a 54 61  ;.  }.  if( pzTa
4bb0: 69 6c 20 29 7b 0a 20 20 20 20 2a 70 7a 54 61 69  il ){.    *pzTai
4bc0: 6c 20 3d 20 73 50 61 72 73 65 2e 7a 54 61 69 6c  l = sParse.zTail
4bd0: 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 50 61  ;.  }.  rc = sPa
4be0: 72 73 65 2e 72 63 3b 0a 0a 23 69 66 6e 64 65 66  rse.rc;..#ifndef
4bf0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50   SQLITE_OMIT_EXP
4c00: 4c 41 49 4e 0a 20 20 69 66 28 20 72 63 3d 3d 53  LAIN.  if( rc==S
4c10: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 73 50 61 72  QLITE_OK && sPar
4c20: 73 65 2e 70 56 64 62 65 20 26 26 20 73 50 61 72  se.pVdbe && sPar
4c30: 73 65 2e 65 78 70 6c 61 69 6e 20 29 7b 0a 20 20  se.explain ){.  
4c40: 20 20 69 66 28 20 73 50 61 72 73 65 2e 65 78 70    if( sParse.exp
4c50: 6c 61 69 6e 3d 3d 32 20 29 7b 0a 20 20 20 20 20  lain==2 ){.     
4c60: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e   sqlite3VdbeSetN
4c70: 75 6d 43 6f 6c 73 28 73 50 61 72 73 65 2e 70 56  umCols(sParse.pV
4c80: 64 62 65 2c 20 33 29 3b 0a 20 20 20 20 20 20 73  dbe, 3);.      s
4c90: 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c  qlite3VdbeSetCol
4ca0: 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62  Name(sParse.pVdb
4cb0: 65 2c 20 30 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41  e, 0, COLNAME_NA
4cc0: 4d 45 2c 20 22 6f 72 64 65 72 22 2c 20 53 51 4c  ME, "order", SQL
4cd0: 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 20  ITE_STATIC);.   
4ce0: 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65     sqlite3VdbeSe
4cf0: 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e  tColName(sParse.
4d00: 70 56 64 62 65 2c 20 31 2c 20 43 4f 4c 4e 41 4d  pVdbe, 1, COLNAM
4d10: 45 5f 4e 41 4d 45 2c 20 22 66 72 6f 6d 22 2c 20  E_NAME, "from", 
4d20: 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a  SQLITE_STATIC);.
4d30: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
4d40: 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72  eSetColName(sPar
4d50: 73 65 2e 70 56 64 62 65 2c 20 32 2c 20 43 4f 4c  se.pVdbe, 2, COL
4d60: 4e 41 4d 45 5f 4e 41 4d 45 2c 20 22 64 65 74 61  NAME_NAME, "deta
4d70: 69 6c 22 2c 20 53 51 4c 49 54 45 5f 53 54 41 54  il", SQLITE_STAT
4d80: 49 43 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a  IC);.    }else{.
4d90: 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62        sqlite3Vdb
4da0: 65 53 65 74 4e 75 6d 43 6f 6c 73 28 73 50 61 72  eSetNumCols(sPar
4db0: 73 65 2e 70 56 64 62 65 2c 20 38 29 3b 0a 20 20  se.pVdbe, 8);.  
4dc0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53      sqlite3VdbeS
4dd0: 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65  etColName(sParse
4de0: 2e 70 56 64 62 65 2c 20 30 2c 20 43 4f 4c 4e 41  .pVdbe, 0, COLNA
4df0: 4d 45 5f 4e 41 4d 45 2c 20 22 61 64 64 72 22 2c  ME_NAME, "addr",
4e00: 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b   SQLITE_STATIC);
4e10: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64  .      sqlite3Vd
4e20: 62 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61  beSetColName(sPa
4e30: 72 73 65 2e 70 56 64 62 65 2c 20 31 2c 20 43 4f  rse.pVdbe, 1, CO
4e40: 4c 4e 41 4d 45 5f 4e 41 4d 45 2c 20 22 6f 70 63  LNAME_NAME, "opc
4e50: 6f 64 65 22 2c 20 53 51 4c 49 54 45 5f 53 54 41  ode", SQLITE_STA
4e60: 54 49 43 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  TIC);.      sqli
4e70: 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d  te3VdbeSetColNam
4e80: 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20  e(sParse.pVdbe, 
4e90: 32 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 2c  2, COLNAME_NAME,
4ea0: 20 22 70 31 22 2c 20 53 51 4c 49 54 45 5f 53 54   "p1", SQLITE_ST
4eb0: 41 54 49 43 29 3b 0a 20 20 20 20 20 20 73 71 6c  ATIC);.      sql
4ec0: 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61  ite3VdbeSetColNa
4ed0: 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c  me(sParse.pVdbe,
4ee0: 20 33 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45   3, COLNAME_NAME
4ef0: 2c 20 22 70 32 22 2c 20 53 51 4c 49 54 45 5f 53  , "p2", SQLITE_S
4f00: 54 41 54 49 43 29 3b 0a 20 20 20 20 20 20 73 71  TATIC);.      sq
4f10: 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e  lite3VdbeSetColN
4f20: 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62 65  ame(sParse.pVdbe
4f30: 2c 20 34 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d  , 4, COLNAME_NAM
4f40: 45 2c 20 22 70 33 22 2c 20 53 51 4c 49 54 45 5f  E, "p3", SQLITE_
4f50: 53 54 41 54 49 43 29 3b 0a 20 20 20 20 20 20 73  STATIC);.      s
4f60: 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c  qlite3VdbeSetCol
4f70: 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62  Name(sParse.pVdb
4f80: 65 2c 20 35 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41  e, 5, COLNAME_NA
4f90: 4d 45 2c 20 22 70 34 22 2c 20 53 51 4c 49 54 45  ME, "p4", SQLITE
4fa0: 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20 20 20  _STATIC);.      
4fb0: 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f  sqlite3VdbeSetCo
4fc0: 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64  lName(sParse.pVd
4fd0: 62 65 2c 20 36 2c 20 43 4f 4c 4e 41 4d 45 5f 4e  be, 6, COLNAME_N
4fe0: 41 4d 45 2c 20 22 70 35 22 2c 20 53 51 4c 49 54  AME, "p5", SQLIT
4ff0: 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20 20  E_STATIC);.     
5000: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43   sqlite3VdbeSetC
5010: 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56  olName(sParse.pV
5020: 64 62 65 2c 20 37 2c 20 43 4f 4c 4e 41 4d 45 5f  dbe, 7, COLNAME_
5030: 4e 41 4d 45 2c 20 22 63 6f 6d 6d 65 6e 74 22 2c  NAME, "comment",
5040: 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b   SQLITE_STATIC);
5050: 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69  .    }.  }.#endi
5060: 66 0a 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33  f..  if( sqlite3
5070: 53 61 66 65 74 79 4f 66 66 28 64 62 29 20 29 7b  SafetyOff(db) ){
5080: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
5090: 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20  _MISUSE;.  }..  
50a0: 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e 69 74  assert( db->init
50b0: 2e 62 75 73 79 3d 3d 30 20 7c 7c 20 73 61 76 65  .busy==0 || save
50c0: 53 71 6c 46 6c 61 67 3d 3d 30 20 29 3b 0a 20 20  SqlFlag==0 );.  
50d0: 69 66 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73  if( db->init.bus
50e0: 79 3d 3d 30 20 29 7b 0a 20 20 20 20 56 64 62 65  y==0 ){.    Vdbe
50f0: 20 2a 70 56 64 62 65 20 3d 20 73 50 61 72 73 65   *pVdbe = sParse
5100: 2e 70 56 64 62 65 3b 0a 20 20 20 20 73 71 6c 69  .pVdbe;.    sqli
5110: 74 65 33 56 64 62 65 53 65 74 53 71 6c 28 70 56  te3VdbeSetSql(pV
5120: 64 62 65 2c 20 7a 53 71 6c 2c 20 28 69 6e 74 29  dbe, zSql, (int)
5130: 28 73 50 61 72 73 65 2e 7a 54 61 69 6c 2d 7a 53  (sParse.zTail-zS
5140: 71 6c 29 2c 20 73 61 76 65 53 71 6c 46 6c 61 67  ql), saveSqlFlag
5150: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 73 50 61  );.  }.  if( sPa
5160: 72 73 65 2e 70 56 64 62 65 20 26 26 20 28 72 63  rse.pVdbe && (rc
5170: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 64  !=SQLITE_OK || d
5180: 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 29  b->mallocFailed)
5190: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56   ){.    sqlite3V
51a0: 64 62 65 46 69 6e 61 6c 69 7a 65 28 73 50 61 72  dbeFinalize(sPar
51b0: 73 65 2e 70 56 64 62 65 29 3b 0a 20 20 20 20 61  se.pVdbe);.    a
51c0: 73 73 65 72 74 28 21 28 2a 70 70 53 74 6d 74 29  ssert(!(*ppStmt)
51d0: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  );.  }else{.    
51e0: 2a 70 70 53 74 6d 74 20 3d 20 28 73 71 6c 69 74  *ppStmt = (sqlit
51f0: 65 33 5f 73 74 6d 74 2a 29 73 50 61 72 73 65 2e  e3_stmt*)sParse.
5200: 70 56 64 62 65 3b 0a 20 20 7d 0a 0a 20 20 69 66  pVdbe;.  }..  if
5210: 28 20 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20  ( zErrMsg ){.   
5220: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
5230: 2c 20 72 63 2c 20 22 25 73 22 2c 20 7a 45 72 72  , rc, "%s", zErr
5240: 4d 73 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65  Msg);.    sqlite
5250: 33 44 62 46 72 65 65 28 64 62 2c 20 7a 45 72 72  3DbFree(db, zErr
5260: 4d 73 67 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  Msg);.  }else{. 
5270: 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28     sqlite3Error(
5280: 64 62 2c 20 72 63 2c 20 30 29 3b 0a 20 20 7d 0a  db, rc, 0);.  }.
5290: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41  .  rc = sqlite3A
52a0: 70 69 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a  piExit(db, rc);.
52b0: 20 20 61 73 73 65 72 74 28 20 28 72 63 26 64 62    assert( (rc&db
52c0: 2d 3e 65 72 72 4d 61 73 6b 29 3d 3d 72 63 20 29  ->errMask)==rc )
52d0: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d  ;.  return rc;.}
52e0: 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69  .static int sqli
52f0: 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72  te3LockAndPrepar
5300: 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  e(.  sqlite3 *db
5310: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ,              /
5320: 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c  * Database handl
5330: 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  e. */.  const ch
5340: 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20  ar *zSql,       
5350: 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64    /* UTF-8 encod
5360: 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  ed SQL statement
5370: 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65  . */.  int nByte
5380: 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  s,              
5390: 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53   /* Length of zS
53a0: 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a  ql in bytes. */.
53b0: 20 20 69 6e 74 20 73 61 76 65 53 71 6c 46 6c 61    int saveSqlFla
53c0: 67 2c 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54  g,          /* T
53d0: 72 75 65 20 74 6f 20 63 6f 70 79 20 53 51 4c 20  rue to copy SQL 
53e0: 74 65 78 74 20 69 6e 74 6f 20 74 68 65 20 73 71  text into the sq
53f0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2f 0a 20 20  lite3_stmt */.  
5400: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70  sqlite3_stmt **p
5410: 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54  pStmt,    /* OUT
5420: 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74  : A pointer to t
5430: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74  he prepared stat
5440: 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74  ement */.  const
5450: 20 63 68 61 72 20 2a 2a 70 7a 54 61 69 6c 20 20   char **pzTail  
5460: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64       /* OUT: End
5470: 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 69 6e   of parsed strin
5480: 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63  g */.){.  int rc
5490: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 70 53 74  ;.  assert( ppSt
54a0: 6d 74 21 3d 30 20 29 3b 0a 20 20 2a 70 70 53 74  mt!=0 );.  *ppSt
54b0: 6d 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 21 73  mt = 0;.  if( !s
54c0: 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63  qlite3SafetyChec
54d0: 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72  kOk(db) ){.    r
54e0: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53  eturn SQLITE_MIS
54f0: 55 53 45 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  USE;.  }.  sqlit
5500: 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64  e3_mutex_enter(d
5510: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c  b->mutex);.  sql
5520: 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c  ite3BtreeEnterAl
5530: 6c 28 64 62 29 3b 0a 20 20 72 63 20 3d 20 73 71  l(db);.  rc = sq
5540: 6c 69 74 65 33 50 72 65 70 61 72 65 28 64 62 2c  lite3Prepare(db,
5550: 20 7a 53 71 6c 2c 20 6e 42 79 74 65 73 2c 20 73   zSql, nBytes, s
5560: 61 76 65 53 71 6c 46 6c 61 67 2c 20 70 70 53 74  aveSqlFlag, ppSt
5570: 6d 74 2c 20 70 7a 54 61 69 6c 29 3b 0a 20 20 73  mt, pzTail);.  s
5580: 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65  qlite3BtreeLeave
5590: 41 6c 6c 28 64 62 29 3b 0a 20 20 73 71 6c 69 74  All(db);.  sqlit
55a0: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64  e3_mutex_leave(d
55b0: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74  b->mutex);.  ret
55c0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a  urn rc;.}../*.**
55d0: 20 52 65 72 75 6e 20 74 68 65 20 63 6f 6d 70 69   Rerun the compi
55e0: 6c 61 74 69 6f 6e 20 6f 66 20 61 20 73 74 61 74  lation of a stat
55f0: 65 6d 65 6e 74 20 61 66 74 65 72 20 61 20 73 63  ement after a sc
5600: 68 65 6d 61 20 63 68 61 6e 67 65 2e 0a 2a 2a 0a  hema change..**.
5610: 2a 2a 20 49 66 20 74 68 65 20 73 74 61 74 65 6d  ** If the statem
5620: 65 6e 74 20 69 73 20 73 75 63 63 65 73 73 66 75  ent is successfu
5630: 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65 64 2c 20  lly recompiled, 
5640: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
5650: 2e 20 4f 74 68 65 72 77 69 73 65 2c 0a 2a 2a 20  . Otherwise,.** 
5660: 69 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  if the statement
5670: 20 63 61 6e 6e 6f 74 20 62 65 20 72 65 63 6f 6d   cannot be recom
5680: 70 69 6c 65 64 20 62 65 63 61 75 73 65 20 61 6e  piled because an
5690: 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e  other connection
56a0: 20 68 61 73 0a 2a 2a 20 6c 6f 63 6b 65 64 20 74   has.** locked t
56b0: 68 65 20 73 71 6c 69 74 65 33 5f 6d 61 73 74 65  he sqlite3_maste
56c0: 72 20 74 61 62 6c 65 2c 20 72 65 74 75 72 6e 20  r table, return 
56d0: 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 2e 20 49  SQLITE_LOCKED. I
56e0: 66 20 61 6e 79 20 6f 74 68 65 72 20 65 72 72 6f  f any other erro
56f0: 72 0a 2a 2a 20 6f 63 63 75 72 73 2c 20 72 65 74  r.** occurs, ret
5700: 75 72 6e 20 53 51 4c 49 54 45 5f 53 43 48 45 4d  urn SQLITE_SCHEM
5710: 41 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65  A..*/.int sqlite
5720: 33 52 65 70 72 65 70 61 72 65 28 56 64 62 65 20  3Reprepare(Vdbe 
5730: 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20  *p){.  int rc;. 
5740: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70   sqlite3_stmt *p
5750: 4e 65 77 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61  New;.  const cha
5760: 72 20 2a 7a 53 71 6c 3b 0a 20 20 73 71 6c 69 74  r *zSql;.  sqlit
5770: 65 33 20 2a 64 62 3b 0a 0a 20 20 61 73 73 65 72  e3 *db;..  asser
5780: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78  t( sqlite3_mutex
5790: 5f 68 65 6c 64 28 73 71 6c 69 74 65 33 56 64 62  _held(sqlite3Vdb
57a0: 65 44 62 28 70 29 2d 3e 6d 75 74 65 78 29 20 29  eDb(p)->mutex) )
57b0: 3b 0a 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74  ;.  zSql = sqlit
57c0: 65 33 5f 73 71 6c 28 28 73 71 6c 69 74 65 33 5f  e3_sql((sqlite3_
57d0: 73 74 6d 74 20 2a 29 70 29 3b 0a 20 20 61 73 73  stmt *)p);.  ass
57e0: 65 72 74 28 20 7a 53 71 6c 21 3d 30 20 29 3b 20  ert( zSql!=0 ); 
57f0: 20 2f 2a 20 52 65 70 72 65 70 61 72 65 20 6f 6e   /* Reprepare on
5800: 6c 79 20 63 61 6c 6c 65 64 20 66 6f 72 20 70 72  ly called for pr
5810: 65 70 61 72 65 5f 76 32 28 29 20 73 74 61 74 65  epare_v2() state
5820: 6d 65 6e 74 73 20 2a 2f 0a 20 20 64 62 20 3d 20  ments */.  db = 
5830: 73 71 6c 69 74 65 33 56 64 62 65 44 62 28 70 29  sqlite3VdbeDb(p)
5840: 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69  ;.  assert( sqli
5850: 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64  te3_mutex_held(d
5860: 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 72  b->mutex) );.  r
5870: 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41  c = sqlite3LockA
5880: 6e 64 50 72 65 70 61 72 65 28 64 62 2c 20 7a 53  ndPrepare(db, zS
5890: 71 6c 2c 20 2d 31 2c 20 30 2c 20 26 70 4e 65 77  ql, -1, 0, &pNew
58a0: 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63 20 29  , 0);.  if( rc )
58b0: 7b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51  {.    if( rc==SQ
58c0: 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20  LITE_NOMEM ){.  
58d0: 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61      db->mallocFa
58e0: 69 6c 65 64 20 3d 20 31 3b 0a 20 20 20 20 7d 0a  iled = 1;.    }.
58f0: 20 20 20 20 61 73 73 65 72 74 28 20 70 4e 65 77      assert( pNew
5900: 3d 3d 30 20 29 3b 0a 20 20 20 20 72 65 74 75 72  ==0 );.    retur
5910: 6e 20 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4c 4f  n (rc==SQLITE_LO
5920: 43 4b 45 44 29 20 3f 20 53 51 4c 49 54 45 5f 4c  CKED) ? SQLITE_L
5930: 4f 43 4b 45 44 20 3a 20 53 51 4c 49 54 45 5f 53  OCKED : SQLITE_S
5940: 43 48 45 4d 41 3b 0a 20 20 7d 65 6c 73 65 7b 0a  CHEMA;.  }else{.
5950: 20 20 20 20 61 73 73 65 72 74 28 20 70 4e 65 77      assert( pNew
5960: 21 3d 30 20 29 3b 0a 20 20 7d 0a 20 20 73 71 6c  !=0 );.  }.  sql
5970: 69 74 65 33 56 64 62 65 53 77 61 70 28 28 56 64  ite3VdbeSwap((Vd
5980: 62 65 2a 29 70 4e 65 77 2c 20 70 29 3b 0a 20 20  be*)pNew, p);.  
5990: 73 71 6c 69 74 65 33 54 72 61 6e 73 66 65 72 42  sqlite3TransferB
59a0: 69 6e 64 69 6e 67 73 28 70 4e 65 77 2c 20 28 73  indings(pNew, (s
59b0: 71 6c 69 74 65 33 5f 73 74 6d 74 2a 29 70 29 3b  qlite3_stmt*)p);
59c0: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 52 65  .  sqlite3VdbeRe
59d0: 73 65 74 53 74 65 70 52 65 73 75 6c 74 28 28 56  setStepResult((V
59e0: 64 62 65 2a 29 70 4e 65 77 29 3b 0a 20 20 73 71  dbe*)pNew);.  sq
59f0: 6c 69 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a  lite3VdbeFinaliz
5a00: 65 28 28 56 64 62 65 2a 29 70 4e 65 77 29 3b 0a  e((Vdbe*)pNew);.
5a10: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
5a20: 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 77  OK;.}.../*.** Tw
5a30: 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68  o versions of th
5a40: 65 20 6f 66 66 69 63 69 61 6c 20 41 50 49 2e 20  e official API. 
5a50: 20 4c 65 67 61 63 79 20 61 6e 64 20 6e 65 77 20   Legacy and new 
5a60: 75 73 65 2e 20 20 49 6e 20 74 68 65 20 6c 65 67  use.  In the leg
5a70: 61 63 79 0a 2a 2a 20 76 65 72 73 69 6f 6e 2c 20  acy.** version, 
5a80: 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c  the original SQL
5a90: 20 74 65 78 74 20 69 73 20 6e 6f 74 20 73 61 76   text is not sav
5aa0: 65 64 20 69 6e 20 74 68 65 20 70 72 65 70 61 72  ed in the prepar
5ab0: 65 64 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20  ed statement.** 
5ac0: 61 6e 64 20 73 6f 20 69 66 20 61 20 73 63 68 65  and so if a sche
5ad0: 6d 61 20 63 68 61 6e 67 65 20 6f 63 63 75 72 73  ma change occurs
5ae0: 2c 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20  , SQLITE_SCHEMA 
5af0: 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 0a 2a  is returned by.*
5b00: 2a 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29  * sqlite3_step()
5b10: 2e 20 20 49 6e 20 74 68 65 20 6e 65 77 20 76 65  .  In the new ve
5b20: 72 73 69 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69  rsion, the origi
5b30: 6e 61 6c 20 53 51 4c 20 74 65 78 74 20 69 73 20  nal SQL text is 
5b40: 72 65 74 61 69 6e 65 64 0a 2a 2a 20 61 6e 64 20  retained.** and 
5b50: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 69 73  the statement is
5b60: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72   automatically r
5b70: 65 63 6f 6d 70 69 6c 65 64 20 69 66 20 61 6e 20  ecompiled if an 
5b80: 73 63 68 65 6d 61 20 63 68 61 6e 67 65 0a 2a 2a  schema change.**
5b90: 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74 20   occurs..*/.int 
5ba0: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28  sqlite3_prepare(
5bb0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  .  sqlite3 *db, 
5bc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5bd0: 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e  Database handle.
5be0: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72   */.  const char
5bf0: 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20   *zSql,         
5c00: 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64  /* UTF-8 encoded
5c10: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20   SQL statement. 
5c20: 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c  */.  int nBytes,
5c30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5c40: 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c  * Length of zSql
5c50: 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20   in bytes. */.  
5c60: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70  sqlite3_stmt **p
5c70: 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54  pStmt,    /* OUT
5c80: 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74  : A pointer to t
5c90: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74  he prepared stat
5ca0: 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74  ement */.  const
5cb0: 20 63 68 61 72 20 2a 2a 70 7a 54 61 69 6c 20 20   char **pzTail  
5cc0: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64       /* OUT: End
5cd0: 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 69 6e   of parsed strin
5ce0: 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63  g */.){.  int rc
5cf0: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  ;.  rc = sqlite3
5d00: 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28 64  LockAndPrepare(d
5d10: 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 30 2c  b,zSql,nBytes,0,
5d20: 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a  ppStmt,pzTail);.
5d30: 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51    assert( rc==SQ
5d40: 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d  LITE_OK || ppStm
5d50: 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d 74 3d  t==0 || *ppStmt=
5d60: 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52 49 46 59  =0 );  /* VERIFY
5d70: 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20 20 72 65  : F13021 */.  re
5d80: 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73  turn rc;.}.int s
5d90: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76  qlite3_prepare_v
5da0: 32 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  2(.  sqlite3 *db
5db0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ,              /
5dc0: 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c  * Database handl
5dd0: 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  e. */.  const ch
5de0: 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20  ar *zSql,       
5df0: 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64    /* UTF-8 encod
5e00: 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  ed SQL statement
5e10: 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65  . */.  int nByte
5e20: 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  s,              
5e30: 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53   /* Length of zS
5e40: 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a  ql in bytes. */.
5e50: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a    sqlite3_stmt *
5e60: 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f  *ppStmt,    /* O
5e70: 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f  UT: A pointer to
5e80: 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74   the prepared st
5e90: 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e  atement */.  con
5ea0: 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 69 6c  st char **pzTail
5eb0: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45         /* OUT: E
5ec0: 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74 72  nd of parsed str
5ed0: 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20  ing */.){.  int 
5ee0: 72 63 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  rc;.  rc = sqlit
5ef0: 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65  e3LockAndPrepare
5f00: 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c  (db,zSql,nBytes,
5f10: 31 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29  1,ppStmt,pzTail)
5f20: 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d  ;.  assert( rc==
5f30: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53  SQLITE_OK || ppS
5f40: 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d  tmt==0 || *ppStm
5f50: 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52 49  t==0 );  /* VERI
5f60: 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20 20  FY: F13021 */.  
5f70: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 23  return rc;.}...#
5f80: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
5f90: 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 43  IT_UTF16./*.** C
5fa0: 6f 6d 70 69 6c 65 20 74 68 65 20 55 54 46 2d 31  ompile the UTF-1
5fb0: 36 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  6 encoded SQL st
5fc0: 61 74 65 6d 65 6e 74 20 7a 53 71 6c 20 69 6e 74  atement zSql int
5fd0: 6f 20 61 20 73 74 61 74 65 6d 65 6e 74 20 68 61  o a statement ha
5fe0: 6e 64 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20  ndle..*/.static 
5ff0: 69 6e 74 20 73 71 6c 69 74 65 33 50 72 65 70 61  int sqlite3Prepa
6000: 72 65 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20  re16(.  sqlite3 
6010: 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20  *db,            
6020: 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61    /* Database ha
6030: 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e 73  ndle. */ .  cons
6040: 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c 20 20 20  t void *zSql,   
6050: 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 20 65        /* UTF-8 e
6060: 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65  ncoded SQL state
6070: 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e  ment. */.  int n
6080: 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 20 20  Bytes,          
6090: 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f       /* Length o
60a0: 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e  f zSql in bytes.
60b0: 20 2a 2f 0a 20 20 69 6e 74 20 73 61 76 65 53 71   */.  int saveSq
60c0: 6c 46 6c 61 67 2c 20 20 20 20 20 20 20 20 20 20  lFlag,          
60d0: 2f 2a 20 54 72 75 65 20 74 6f 20 73 61 76 65 20  /* True to save 
60e0: 53 51 4c 20 74 65 78 74 20 69 6e 74 6f 20 74 68  SQL text into th
60f0: 65 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a  e sqlite3_stmt *
6100: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74  /.  sqlite3_stmt
6110: 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a   **ppStmt,    /*
6120: 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20   OUT: A pointer 
6130: 74 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20  to the prepared 
6140: 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63  statement */.  c
6150: 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70 7a 54 61  onst void **pzTa
6160: 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a  il       /* OUT:
6170: 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73   End of parsed s
6180: 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 2f 2a  tring */.){.  /*
6190: 20 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63   This function c
61a0: 75 72 72 65 6e 74 6c 79 20 77 6f 72 6b 73 20 62  urrently works b
61b0: 79 20 66 69 72 73 74 20 74 72 61 6e 73 66 6f 72  y first transfor
61c0: 6d 69 6e 67 20 74 68 65 20 55 54 46 2d 31 36 0a  ming the UTF-16.
61d0: 20 20 2a 2a 20 65 6e 63 6f 64 65 64 20 73 74 72    ** encoded str
61e0: 69 6e 67 20 74 6f 20 55 54 46 2d 38 2c 20 74 68  ing to UTF-8, th
61f0: 65 6e 20 69 6e 76 6f 6b 69 6e 67 20 73 71 6c 69  en invoking sqli
6200: 74 65 33 5f 70 72 65 70 61 72 65 28 29 2e 20 54  te3_prepare(). T
6210: 68 65 0a 20 20 2a 2a 20 74 72 69 63 6b 79 20 62  he.  ** tricky b
6220: 69 74 20 69 73 20 66 69 67 75 72 69 6e 67 20 6f  it is figuring o
6230: 75 74 20 74 68 65 20 70 6f 69 6e 74 65 72 20 74  ut the pointer t
6240: 6f 20 72 65 74 75 72 6e 20 69 6e 20 2a 70 7a 54  o return in *pzT
6250: 61 69 6c 2e 0a 20 20 2a 2f 0a 20 20 63 68 61 72  ail..  */.  char
6260: 20 2a 7a 53 71 6c 38 3b 0a 20 20 63 6f 6e 73 74   *zSql8;.  const
6270: 20 63 68 61 72 20 2a 7a 54 61 69 6c 38 20 3d 20   char *zTail8 = 
6280: 30 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  0;.  int rc = SQ
6290: 4c 49 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65  LITE_OK;..  asse
62a0: 72 74 28 20 70 70 53 74 6d 74 20 29 3b 0a 20 20  rt( ppStmt );.  
62b0: 2a 70 70 53 74 6d 74 20 3d 20 30 3b 0a 20 20 69  *ppStmt = 0;.  i
62c0: 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74  f( !sqlite3Safet
62d0: 79 43 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a  yCheckOk(db) ){.
62e0: 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54      return SQLIT
62f0: 45 5f 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20  E_MISUSE;.  }.  
6300: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e  sqlite3_mutex_en
6310: 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a  ter(db->mutex);.
6320: 20 20 7a 53 71 6c 38 20 3d 20 73 71 6c 69 74 65    zSql8 = sqlite
6330: 33 55 74 66 31 36 74 6f 38 28 64 62 2c 20 7a 53  3Utf16to8(db, zS
6340: 71 6c 2c 20 6e 42 79 74 65 73 29 3b 0a 20 20 69  ql, nBytes);.  i
6350: 66 28 20 7a 53 71 6c 38 20 29 7b 0a 20 20 20 20  f( zSql8 ){.    
6360: 72 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b  rc = sqlite3Lock
6370: 41 6e 64 50 72 65 70 61 72 65 28 64 62 2c 20 7a  AndPrepare(db, z
6380: 53 71 6c 38 2c 20 2d 31 2c 20 73 61 76 65 53 71  Sql8, -1, saveSq
6390: 6c 46 6c 61 67 2c 20 70 70 53 74 6d 74 2c 20 26  lFlag, ppStmt, &
63a0: 7a 54 61 69 6c 38 29 3b 0a 20 20 7d 0a 0a 20 20  zTail8);.  }..  
63b0: 69 66 28 20 7a 54 61 69 6c 38 20 26 26 20 70 7a  if( zTail8 && pz
63c0: 54 61 69 6c 20 29 7b 0a 20 20 20 20 2f 2a 20 49  Tail ){.    /* I
63d0: 66 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72  f sqlite3_prepar
63e0: 65 20 72 65 74 75 72 6e 73 20 61 20 74 61 69 6c  e returns a tail
63f0: 20 70 6f 69 6e 74 65 72 2c 20 77 65 20 63 61 6c   pointer, we cal
6400: 63 75 6c 61 74 65 20 74 68 65 0a 20 20 20 20 2a  culate the.    *
6410: 2a 20 65 71 75 69 76 61 6c 65 6e 74 20 70 6f 69  * equivalent poi
6420: 6e 74 65 72 20 69 6e 74 6f 20 74 68 65 20 55 54  nter into the UT
6430: 46 2d 31 36 20 73 74 72 69 6e 67 20 62 79 20 63  F-16 string by c
6440: 6f 75 6e 74 69 6e 67 20 74 68 65 20 75 6e 69 63  ounting the unic
6450: 6f 64 65 0a 20 20 20 20 2a 2a 20 63 68 61 72 61  ode.    ** chara
6460: 63 74 65 72 73 20 62 65 74 77 65 65 6e 20 7a 53  cters between zS
6470: 71 6c 38 20 61 6e 64 20 7a 54 61 69 6c 38 2c 20  ql8 and zTail8, 
6480: 61 6e 64 20 74 68 65 6e 20 72 65 74 75 72 6e 69  and then returni
6490: 6e 67 20 61 20 70 6f 69 6e 74 65 72 0a 20 20 20  ng a pointer.   
64a0: 20 2a 2a 20 74 68 65 20 73 61 6d 65 20 6e 75 6d   ** the same num
64b0: 62 65 72 20 6f 66 20 63 68 61 72 61 63 74 65 72  ber of character
64c0: 73 20 69 6e 74 6f 20 74 68 65 20 55 54 46 2d 31  s into the UTF-1
64d0: 36 20 73 74 72 69 6e 67 2e 0a 20 20 20 20 2a 2f  6 string..    */
64e0: 0a 20 20 20 20 69 6e 74 20 63 68 61 72 73 5f 70  .    int chars_p
64f0: 61 72 73 65 64 20 3d 20 73 71 6c 69 74 65 33 55  arsed = sqlite3U
6500: 74 66 38 43 68 61 72 4c 65 6e 28 7a 53 71 6c 38  tf8CharLen(zSql8
6510: 2c 20 28 69 6e 74 29 28 7a 54 61 69 6c 38 2d 7a  , (int)(zTail8-z
6520: 53 71 6c 38 29 29 3b 0a 20 20 20 20 2a 70 7a 54  Sql8));.    *pzT
6530: 61 69 6c 20 3d 20 28 75 38 20 2a 29 7a 53 71 6c  ail = (u8 *)zSql
6540: 20 2b 20 73 71 6c 69 74 65 33 55 74 66 31 36 42   + sqlite3Utf16B
6550: 79 74 65 4c 65 6e 28 7a 53 71 6c 2c 20 63 68 61  yteLen(zSql, cha
6560: 72 73 5f 70 61 72 73 65 64 29 3b 0a 20 20 7d 0a  rs_parsed);.  }.
6570: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28    sqlite3DbFree(
6580: 64 62 2c 20 7a 53 71 6c 38 29 3b 20 0a 20 20 72  db, zSql8); .  r
6590: 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78  c = sqlite3ApiEx
65a0: 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71  it(db, rc);.  sq
65b0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76  lite3_mutex_leav
65c0: 65 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  e(db->mutex);.  
65d0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a  return rc;.}../*
65e0: 0a 2a 2a 20 54 77 6f 20 76 65 72 73 69 6f 6e 73  .** Two versions
65f0: 20 6f 66 20 74 68 65 20 6f 66 66 69 63 69 61 6c   of the official
6600: 20 41 50 49 2e 20 20 4c 65 67 61 63 79 20 61 6e   API.  Legacy an
6610: 64 20 6e 65 77 20 75 73 65 2e 20 20 49 6e 20 74  d new use.  In t
6620: 68 65 20 6c 65 67 61 63 79 0a 2a 2a 20 76 65 72  he legacy.** ver
6630: 73 69 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69 6e  sion, the origin
6640: 61 6c 20 53 51 4c 20 74 65 78 74 20 69 73 20 6e  al SQL text is n
6650: 6f 74 20 73 61 76 65 64 20 69 6e 20 74 68 65 20  ot saved in the 
6660: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65  prepared stateme
6670: 6e 74 0a 2a 2a 20 61 6e 64 20 73 6f 20 69 66 20  nt.** and so if 
6680: 61 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 20  a schema change 
6690: 6f 63 63 75 72 73 2c 20 53 51 4c 49 54 45 5f 53  occurs, SQLITE_S
66a0: 43 48 45 4d 41 20 69 73 20 72 65 74 75 72 6e 65  CHEMA is returne
66b0: 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f  d by.** sqlite3_
66c0: 73 74 65 70 28 29 2e 20 20 49 6e 20 74 68 65 20  step().  In the 
66d0: 6e 65 77 20 76 65 72 73 69 6f 6e 2c 20 74 68 65  new version, the
66e0: 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 20 74 65   original SQL te
66f0: 78 74 20 69 73 20 72 65 74 61 69 6e 65 64 0a 2a  xt is retained.*
6700: 2a 20 61 6e 64 20 74 68 65 20 73 74 61 74 65 6d  * and the statem
6710: 65 6e 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63  ent is automatic
6720: 61 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65 64 20  ally recompiled 
6730: 69 66 20 61 6e 20 73 63 68 65 6d 61 20 63 68 61  if an schema cha
6740: 6e 67 65 0a 2a 2a 20 6f 63 63 75 72 73 2e 0a 2a  nge.** occurs..*
6750: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72  /.int sqlite3_pr
6760: 65 70 61 72 65 31 36 28 0a 20 20 73 71 6c 69 74  epare16(.  sqlit
6770: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  e3 *db,         
6780: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
6790: 20 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63   handle. */ .  c
67a0: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c  onst void *zSql,
67b0: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d           /* UTF-
67c0: 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  8 encoded SQL st
67d0: 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e  atement. */.  in
67e0: 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20  t nBytes,       
67f0: 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74          /* Lengt
6800: 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74  h of zSql in byt
6810: 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  es. */.  sqlite3
6820: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
6830: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69     /* OUT: A poi
6840: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70  nter to the prep
6850: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a  ared statement *
6860: 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  /.  const void *
6870: 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a  *pzTail       /*
6880: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72   OUT: End of par
6890: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b  sed string */.){
68a0: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20  .  int rc;.  rc 
68b0: 3d 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65  = sqlite3Prepare
68c0: 31 36 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65  16(db,zSql,nByte
68d0: 73 2c 30 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69  s,0,ppStmt,pzTai
68e0: 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63  l);.  assert( rc
68f0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70  ==SQLITE_OK || p
6900: 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53  pStmt==0 || *ppS
6910: 74 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45  tmt==0 );  /* VE
6920: 52 49 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a  RIFY: F13021 */.
6930: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69    return rc;.}.i
6940: 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61  nt sqlite3_prepa
6950: 72 65 31 36 5f 76 32 28 0a 20 20 73 71 6c 69 74  re16_v2(.  sqlit
6960: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  e3 *db,         
6970: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
6980: 20 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63   handle. */ .  c
6990: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c  onst void *zSql,
69a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d           /* UTF-
69b0: 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  8 encoded SQL st
69c0: 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e  atement. */.  in
69d0: 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20  t nBytes,       
69e0: 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74          /* Lengt
69f0: 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74  h of zSql in byt
6a00: 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  es. */.  sqlite3
6a10: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
6a20: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69     /* OUT: A poi
6a30: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70  nter to the prep
6a40: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a  ared statement *
6a50: 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  /.  const void *
6a60: 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a  *pzTail       /*
6a70: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72   OUT: End of par
6a80: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b  sed string */.){
6a90: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20  .  int rc;.  rc 
6aa0: 3d 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65  = sqlite3Prepare
6ab0: 31 36 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65  16(db,zSql,nByte
6ac0: 73 2c 31 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69  s,1,ppStmt,pzTai
6ad0: 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63  l);.  assert( rc
6ae0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70  ==SQLITE_OK || p
6af0: 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53  pStmt==0 || *ppS
6b00: 74 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45  tmt==0 );  /* VE
6b10: 52 49 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a  RIFY: F13021 */.
6b20: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a    return rc;.}..
6b30: 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45  #endif /* SQLITE
6b40: 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a     _OMIT_UTF16 */.