/ Hex Artifact Content
Login

Artifact 72d74e6d3b9c8eb0663b33ec6438aa718096ac79:


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 37 20 32 30 30 39 2f 30 34 2f  v 1.117 2009/04/
0230: 32 30 20 31 37 3a 34 33 3a 30 33 20 64 72 68 20  20 17:43:03 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 69 6e 74 20 69 3b 0a 20 20 42  rc;.  int i;.  B
11b0: 74 43 75 72 73 6f 72 20 2a 63 75 72 4d 61 69 6e  tCursor *curMain
11c0: 3b 0a 20 20 69 6e 74 20 73 69 7a 65 3b 0a 20 20  ;.  int size;.  
11d0: 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 20 44  Table *pTab;.  D
11e0: 62 20 2a 70 44 62 3b 0a 20 20 63 68 61 72 20 63  b *pDb;.  char c
11f0: 6f 6e 73 74 20 2a 61 7a 41 72 67 5b 34 5d 3b 0a  onst *azArg[4];.
1200: 20 20 69 6e 74 20 6d 65 74 61 5b 31 30 5d 3b 0a    int meta[10];.
1210: 20 20 49 6e 69 74 44 61 74 61 20 69 6e 69 74 44    InitData initD
1220: 61 74 61 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73  ata;.  char cons
1230: 74 20 2a 7a 4d 61 73 74 65 72 53 63 68 65 6d 61  t *zMasterSchema
1240: 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a  ;.  char const *
1250: 7a 4d 61 73 74 65 72 4e 61 6d 65 20 3d 20 53 43  zMasterName = SC
1260: 48 45 4d 41 5f 54 41 42 4c 45 28 69 44 62 29 3b  HEMA_TABLE(iDb);
1270: 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20  ..  /*.  ** The 
1280: 6d 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20  master database 
1290: 74 61 62 6c 65 20 68 61 73 20 61 20 73 74 72 75  table has a stru
12a0: 63 74 75 72 65 20 6c 69 6b 65 20 74 68 69 73 0a  cture like this.
12b0: 20 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 6f    */.  static co
12c0: 6e 73 74 20 63 68 61 72 20 6d 61 73 74 65 72 5f  nst char master_
12d0: 73 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20 20  schema[] = .    
12e0: 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 20 73   "CREATE TABLE s
12f0: 71 6c 69 74 65 5f 6d 61 73 74 65 72 28 5c 6e 22  qlite_master(\n"
1300: 0a 20 20 20 20 20 22 20 20 74 79 70 65 20 74 65  .     "  type te
1310: 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 6e  xt,\n".     "  n
1320: 61 6d 65 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20  ame text,\n".   
1330: 20 20 22 20 20 74 62 6c 5f 6e 61 6d 65 20 74 65    "  tbl_name te
1340: 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 72  xt,\n".     "  r
1350: 6f 6f 74 70 61 67 65 20 69 6e 74 65 67 65 72 2c  ootpage integer,
1360: 5c 6e 22 0a 20 20 20 20 20 22 20 20 73 71 6c 20  \n".     "  sql 
1370: 74 65 78 74 5c 6e 22 0a 20 20 20 20 20 22 29 22  text\n".     ")"
1380: 0a 20 20 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c  .  ;.#ifndef SQL
1390: 49 54 45 5f 4f 4d 49 54 5f 54 45 4d 50 44 42 0a  ITE_OMIT_TEMPDB.
13a0: 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 20 63    static const c
13b0: 68 61 72 20 74 65 6d 70 5f 6d 61 73 74 65 72 5f  har temp_master_
13c0: 73 63 68 65 6d 61 5b 5d 20 3d 20 0a 20 20 20 20  schema[] = .    
13d0: 20 22 43 52 45 41 54 45 20 54 45 4d 50 20 54 41   "CREATE TEMP TA
13e0: 42 4c 45 20 73 71 6c 69 74 65 5f 74 65 6d 70 5f  BLE sqlite_temp_
13f0: 6d 61 73 74 65 72 28 5c 6e 22 0a 20 20 20 20 20  master(\n".     
1400: 22 20 20 74 79 70 65 20 74 65 78 74 2c 5c 6e 22  "  type text,\n"
1410: 0a 20 20 20 20 20 22 20 20 6e 61 6d 65 20 74 65  .     "  name te
1420: 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 20 20 74  xt,\n".     "  t
1430: 62 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 5c 6e 22  bl_name text,\n"
1440: 0a 20 20 20 20 20 22 20 20 72 6f 6f 74 70 61 67  .     "  rootpag
1450: 65 20 69 6e 74 65 67 65 72 2c 5c 6e 22 0a 20 20  e integer,\n".  
1460: 20 20 20 22 20 20 73 71 6c 20 74 65 78 74 5c 6e     "  sql text\n
1470: 22 0a 20 20 20 20 20 22 29 22 0a 20 20 3b 0a 23  ".     ")".  ;.#
1480: 65 6c 73 65 0a 20 20 23 64 65 66 69 6e 65 20 74  else.  #define t
1490: 65 6d 70 5f 6d 61 73 74 65 72 5f 73 63 68 65 6d  emp_master_schem
14a0: 61 20 30 0a 23 65 6e 64 69 66 0a 0a 20 20 61 73  a 0.#endif..  as
14b0: 73 65 72 74 28 20 69 44 62 3e 3d 30 20 26 26 20  sert( iDb>=0 && 
14c0: 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20  iDb<db->nDb );. 
14d0: 20 61 73 73 65 72 74 28 20 64 62 2d 3e 61 44 62   assert( db->aDb
14e0: 5b 69 44 62 5d 2e 70 53 63 68 65 6d 61 20 29 3b  [iDb].pSchema );
14f0: 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74  .  assert( sqlit
1500: 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62  e3_mutex_held(db
1510: 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73  ->mutex) );.  as
1520: 73 65 72 74 28 20 69 44 62 3d 3d 31 20 7c 7c 20  sert( iDb==1 || 
1530: 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64  sqlite3BtreeHold
1540: 73 4d 75 74 65 78 28 64 62 2d 3e 61 44 62 5b 69  sMutex(db->aDb[i
1550: 44 62 5d 2e 70 42 74 29 20 29 3b 0a 0a 20 20 2f  Db].pBt) );..  /
1560: 2a 20 7a 4d 61 73 74 65 72 53 63 68 65 6d 61 20  * zMasterSchema 
1570: 61 6e 64 20 7a 49 6e 69 74 53 63 72 69 70 74 20  and zInitScript 
1580: 61 72 65 20 73 65 74 20 74 6f 20 70 6f 69 6e 74  are set to point
1590: 20 61 74 20 74 68 65 20 6d 61 73 74 65 72 20 73   at the master s
15a0: 63 68 65 6d 61 0a 20 20 2a 2a 20 61 6e 64 20 69  chema.  ** and i
15b0: 6e 69 74 69 61 6c 69 73 61 74 69 6f 6e 20 73 63  nitialisation sc
15c0: 72 69 70 74 20 61 70 70 72 6f 70 72 69 61 74 65  ript appropriate
15d0: 20 66 6f 72 20 74 68 65 20 64 61 74 61 62 61 73   for the databas
15e0: 65 20 62 65 69 6e 67 0a 20 20 2a 2a 20 69 6e 69  e being.  ** ini
15f0: 74 69 61 6c 69 73 65 64 2e 20 7a 4d 61 73 74 65  tialised. zMaste
1600: 72 4e 61 6d 65 20 69 73 20 74 68 65 20 6e 61 6d  rName is the nam
1610: 65 20 6f 66 20 74 68 65 20 6d 61 73 74 65 72 20  e of the master 
1620: 74 61 62 6c 65 2e 0a 20 20 2a 2f 0a 20 20 69 66  table..  */.  if
1630: 28 20 21 4f 4d 49 54 5f 54 45 4d 50 44 42 20 26  ( !OMIT_TEMPDB &
1640: 26 20 69 44 62 3d 3d 31 20 29 7b 0a 20 20 20 20  & iDb==1 ){.    
1650: 7a 4d 61 73 74 65 72 53 63 68 65 6d 61 20 3d 20  zMasterSchema = 
1660: 74 65 6d 70 5f 6d 61 73 74 65 72 5f 73 63 68 65  temp_master_sche
1670: 6d 61 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ma;.  }else{.   
1680: 20 7a 4d 61 73 74 65 72 53 63 68 65 6d 61 20 3d   zMasterSchema =
1690: 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 3b 0a   master_schema;.
16a0: 20 20 7d 0a 20 20 7a 4d 61 73 74 65 72 4e 61 6d    }.  zMasterNam
16b0: 65 20 3d 20 53 43 48 45 4d 41 5f 54 41 42 4c 45  e = SCHEMA_TABLE
16c0: 28 69 44 62 29 3b 0a 0a 20 20 2f 2a 20 43 6f 6e  (iDb);..  /* Con
16d0: 73 74 72 75 63 74 20 74 68 65 20 73 63 68 65 6d  struct the schem
16e0: 61 20 74 61 62 6c 65 73 2e 20 20 2a 2f 0a 20 20  a tables.  */.  
16f0: 61 7a 41 72 67 5b 30 5d 20 3d 20 7a 4d 61 73 74  azArg[0] = zMast
1700: 65 72 4e 61 6d 65 3b 0a 20 20 61 7a 41 72 67 5b  erName;.  azArg[
1710: 31 5d 20 3d 20 22 31 22 3b 0a 20 20 61 7a 41 72  1] = "1";.  azAr
1720: 67 5b 32 5d 20 3d 20 7a 4d 61 73 74 65 72 53 63  g[2] = zMasterSc
1730: 68 65 6d 61 3b 0a 20 20 61 7a 41 72 67 5b 33 5d  hema;.  azArg[3]
1740: 20 3d 20 30 3b 0a 20 20 69 6e 69 74 44 61 74 61   = 0;.  initData
1750: 2e 64 62 20 3d 20 64 62 3b 0a 20 20 69 6e 69 74  .db = db;.  init
1760: 44 61 74 61 2e 69 44 62 20 3d 20 69 44 62 3b 0a  Data.iDb = iDb;.
1770: 20 20 69 6e 69 74 44 61 74 61 2e 72 63 20 3d 20    initData.rc = 
1780: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 69  SQLITE_OK;.  ini
1790: 74 44 61 74 61 2e 70 7a 45 72 72 4d 73 67 20 3d  tData.pzErrMsg =
17a0: 20 70 7a 45 72 72 4d 73 67 3b 0a 20 20 28 76 6f   pzErrMsg;.  (vo
17b0: 69 64 29 73 71 6c 69 74 65 33 53 61 66 65 74 79  id)sqlite3Safety
17c0: 4f 66 66 28 64 62 29 3b 0a 20 20 73 71 6c 69 74  Off(db);.  sqlit
17d0: 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 26  e3InitCallback(&
17e0: 69 6e 69 74 44 61 74 61 2c 20 33 2c 20 28 63 68  initData, 3, (ch
17f0: 61 72 20 2a 2a 29 61 7a 41 72 67 2c 20 30 29 3b  ar **)azArg, 0);
1800: 0a 20 20 28 76 6f 69 64 29 73 71 6c 69 74 65 33  .  (void)sqlite3
1810: 53 61 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20 20  SafetyOn(db);.  
1820: 69 66 28 20 69 6e 69 74 44 61 74 61 2e 72 63 20  if( initData.rc 
1830: 29 7b 0a 20 20 20 20 72 63 20 3d 20 69 6e 69 74  ){.    rc = init
1840: 44 61 74 61 2e 72 63 3b 0a 20 20 20 20 67 6f 74  Data.rc;.    got
1850: 6f 20 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d  o error_out;.  }
1860: 0a 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74 65  .  pTab = sqlite
1870: 33 46 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 7a  3FindTable(db, z
1880: 4d 61 73 74 65 72 4e 61 6d 65 2c 20 64 62 2d 3e  MasterName, db->
1890: 61 44 62 5b 69 44 62 5d 2e 7a 4e 61 6d 65 29 3b  aDb[iDb].zName);
18a0: 0a 20 20 69 66 28 20 70 54 61 62 20 29 7b 0a 20  .  if( pTab ){. 
18b0: 20 20 20 70 54 61 62 2d 3e 74 61 62 46 6c 61 67     pTab->tabFlag
18c0: 73 20 7c 3d 20 54 46 5f 52 65 61 64 6f 6e 6c 79  s |= TF_Readonly
18d0: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 72 65 61  ;.  }..  /* Crea
18e0: 74 65 20 61 20 63 75 72 73 6f 72 20 74 6f 20 68  te a cursor to h
18f0: 6f 6c 64 20 74 68 65 20 64 61 74 61 62 61 73 65  old the database
1900: 20 6f 70 65 6e 0a 20 20 2a 2f 0a 20 20 70 44 62   open.  */.  pDb
1910: 20 3d 20 26 64 62 2d 3e 61 44 62 5b 69 44 62 5d   = &db->aDb[iDb]
1920: 3b 0a 20 20 69 66 28 20 70 44 62 2d 3e 70 42 74  ;.  if( pDb->pBt
1930: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 28 20 21  ==0 ){.    if( !
1940: 4f 4d 49 54 5f 54 45 4d 50 44 42 20 26 26 20 69  OMIT_TEMPDB && i
1950: 44 62 3d 3d 31 20 29 7b 0a 20 20 20 20 20 20 44  Db==1 ){.      D
1960: 62 53 65 74 50 72 6f 70 65 72 74 79 28 64 62 2c  bSetProperty(db,
1970: 20 31 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61   1, DB_SchemaLoa
1980: 64 65 64 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20  ded);.    }.    
1990: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
19a0: 3b 0a 20 20 7d 0a 20 20 63 75 72 4d 61 69 6e 20  ;.  }.  curMain 
19b0: 3d 20 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 5a  = sqlite3MallocZ
19c0: 65 72 6f 28 73 71 6c 69 74 65 33 42 74 72 65 65  ero(sqlite3Btree
19d0: 43 75 72 73 6f 72 53 69 7a 65 28 29 29 3b 0a 20  CursorSize());. 
19e0: 20 69 66 28 20 21 63 75 72 4d 61 69 6e 20 29 7b   if( !curMain ){
19f0: 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45  .    rc = SQLITE
1a00: 5f 4e 4f 4d 45 4d 3b 0a 20 20 20 20 67 6f 74 6f  _NOMEM;.    goto
1a10: 20 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a   error_out;.  }.
1a20: 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e    sqlite3BtreeEn
1a30: 74 65 72 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20  ter(pDb->pBt);. 
1a40: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72   rc = sqlite3Btr
1a50: 65 65 43 75 72 73 6f 72 28 70 44 62 2d 3e 70 42  eeCursor(pDb->pB
1a60: 74 2c 20 4d 41 53 54 45 52 5f 52 4f 4f 54 2c 20  t, MASTER_ROOT, 
1a70: 30 2c 20 30 2c 20 63 75 72 4d 61 69 6e 29 3b 0a  0, 0, curMain);.
1a80: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
1a90: 5f 45 4d 50 54 59 20 29 20 72 63 20 3d 20 53 51  _EMPTY ) rc = SQ
1aa0: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 72  LITE_OK;.  if( r
1ab0: 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c!=SQLITE_OK ){.
1ac0: 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74      sqlite3SetSt
1ad0: 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 64  ring(pzErrMsg, d
1ae0: 62 2c 20 22 25 73 22 2c 20 73 71 6c 69 74 65 33  b, "%s", sqlite3
1af0: 45 72 72 53 74 72 28 72 63 29 29 3b 0a 20 20 20  ErrStr(rc));.   
1b00: 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f 65 72   goto initone_er
1b10: 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20  ror_out;.  }..  
1b20: 2f 2a 20 47 65 74 20 74 68 65 20 64 61 74 61 62  /* Get the datab
1b30: 61 73 65 20 6d 65 74 61 20 69 6e 66 6f 72 6d 61  ase meta informa
1b40: 74 69 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20  tion..  **.  ** 
1b50: 4d 65 74 61 20 76 61 6c 75 65 73 20 61 72 65 20  Meta values are 
1b60: 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 2a 2a  as follows:.  **
1b70: 20 20 20 20 6d 65 74 61 5b 30 5d 20 20 20 53 63      meta[0]   Sc
1b80: 68 65 6d 61 20 63 6f 6f 6b 69 65 2e 20 20 43 68  hema cookie.  Ch
1b90: 61 6e 67 65 73 20 77 69 74 68 20 65 61 63 68 20  anges with each 
1ba0: 73 63 68 65 6d 61 20 63 68 61 6e 67 65 2e 0a 20  schema change.. 
1bb0: 20 2a 2a 20 20 20 20 6d 65 74 61 5b 31 5d 20 20   **    meta[1]  
1bc0: 20 46 69 6c 65 20 66 6f 72 6d 61 74 20 6f 66 20   File format of 
1bd0: 73 63 68 65 6d 61 20 6c 61 79 65 72 2e 0a 20 20  schema layer..  
1be0: 2a 2a 20 20 20 20 6d 65 74 61 5b 32 5d 20 20 20  **    meta[2]   
1bf0: 53 69 7a 65 20 6f 66 20 74 68 65 20 70 61 67 65  Size of the page
1c00: 20 63 61 63 68 65 2e 0a 20 20 2a 2a 20 20 20 20   cache..  **    
1c10: 6d 65 74 61 5b 33 5d 20 20 20 55 73 65 20 66 72  meta[3]   Use fr
1c20: 65 65 6c 69 73 74 20 69 66 20 30 2e 20 20 41 75  eelist if 0.  Au
1c30: 74 6f 76 61 63 75 75 6d 20 69 66 20 67 72 65 61  tovacuum if grea
1c40: 74 65 72 20 74 68 61 6e 20 7a 65 72 6f 2e 0a 20  ter than zero.. 
1c50: 20 2a 2a 20 20 20 20 6d 65 74 61 5b 34 5d 20 20   **    meta[4]  
1c60: 20 44 62 20 74 65 78 74 20 65 6e 63 6f 64 69 6e   Db text encodin
1c70: 67 2e 20 31 3a 55 54 46 2d 38 20 32 3a 55 54 46  g. 1:UTF-8 2:UTF
1c80: 2d 31 36 4c 45 20 33 3a 55 54 46 2d 31 36 42 45  -16LE 3:UTF-16BE
1c90: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 35 5d  .  **    meta[5]
1ca0: 20 20 20 54 68 65 20 75 73 65 72 20 63 6f 6f 6b     The user cook
1cb0: 69 65 2e 20 55 73 65 64 20 62 79 20 74 68 65 20  ie. Used by the 
1cc0: 61 70 70 6c 69 63 61 74 69 6f 6e 2e 0a 20 20 2a  application..  *
1cd0: 2a 20 20 20 20 6d 65 74 61 5b 36 5d 20 20 20 49  *    meta[6]   I
1ce0: 6e 63 72 65 6d 65 6e 74 61 6c 2d 76 61 63 75 75  ncremental-vacuu
1cf0: 6d 20 66 6c 61 67 2e 0a 20 20 2a 2a 20 20 20 20  m flag..  **    
1d00: 6d 65 74 61 5b 37 5d 0a 20 20 2a 2a 20 20 20 20  meta[7].  **    
1d10: 6d 65 74 61 5b 38 5d 0a 20 20 2a 2a 20 20 20 20  meta[8].  **    
1d20: 6d 65 74 61 5b 39 5d 0a 20 20 2a 2a 0a 20 20 2a  meta[9].  **.  *
1d30: 2a 20 4e 6f 74 65 3a 20 54 68 65 20 23 64 65 66  * Note: The #def
1d40: 69 6e 65 64 20 53 51 4c 49 54 45 5f 55 54 46 2a  ined SQLITE_UTF*
1d50: 20 73 79 6d 62 6f 6c 73 20 69 6e 20 73 71 6c 69   symbols in sqli
1d60: 74 65 49 6e 74 2e 68 20 63 6f 72 72 65 73 70 6f  teInt.h correspo
1d70: 6e 64 20 74 6f 0a 20 20 2a 2a 20 74 68 65 20 70  nd to.  ** the p
1d80: 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 73 20 6f  ossible values o
1d90: 66 20 6d 65 74 61 5b 34 5d 2e 0a 20 20 2a 2f 0a  f meta[4]..  */.
1da0: 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 41 72 72    for(i=0; i<Arr
1db0: 61 79 53 69 7a 65 28 6d 65 74 61 29 3b 20 69 2b  aySize(meta); i+
1dc0: 2b 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c  +){.    rc = sql
1dd0: 69 74 65 33 42 74 72 65 65 47 65 74 4d 65 74 61  ite3BtreeGetMeta
1de0: 28 70 44 62 2d 3e 70 42 74 2c 20 69 2b 31 2c 20  (pDb->pBt, i+1, 
1df0: 28 75 33 32 20 2a 29 26 6d 65 74 61 5b 69 5d 29  (u32 *)&meta[i])
1e00: 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a  ;.    if( rc ){.
1e10: 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 65 74        sqlite3Set
1e20: 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c  String(pzErrMsg,
1e30: 20 64 62 2c 20 22 25 73 22 2c 20 73 71 6c 69 74   db, "%s", sqlit
1e40: 65 33 45 72 72 53 74 72 28 72 63 29 29 3b 0a 20  e3ErrStr(rc));. 
1e50: 20 20 20 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e       goto initon
1e60: 65 5f 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 20  e_error_out;.   
1e70: 20 7d 0a 20 20 7d 0a 20 20 70 44 62 2d 3e 70 53   }.  }.  pDb->pS
1e80: 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 5f 63 6f  chema->schema_co
1e90: 6f 6b 69 65 20 3d 20 6d 65 74 61 5b 30 5d 3b 0a  okie = meta[0];.
1ea0: 0a 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67  .  /* If opening
1eb0: 20 61 20 6e 6f 6e 2d 65 6d 70 74 79 20 64 61 74   a non-empty dat
1ec0: 61 62 61 73 65 2c 20 63 68 65 63 6b 20 74 68 65  abase, check the
1ed0: 20 74 65 78 74 20 65 6e 63 6f 64 69 6e 67 2e 20   text encoding. 
1ee0: 46 6f 72 20 74 68 65 0a 20 20 2a 2a 20 6d 61 69  For the.  ** mai
1ef0: 6e 20 64 61 74 61 62 61 73 65 2c 20 73 65 74 20  n database, set 
1f00: 73 71 6c 69 74 65 33 2e 65 6e 63 20 74 6f 20 74  sqlite3.enc to t
1f10: 68 65 20 65 6e 63 6f 64 69 6e 67 20 6f 66 20 74  he encoding of t
1f20: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  he main database
1f30: 2e 0a 20 20 2a 2a 20 46 6f 72 20 61 6e 20 61 74  ..  ** For an at
1f40: 74 61 63 68 65 64 20 64 62 2c 20 69 74 20 69 73  tached db, it is
1f50: 20 61 6e 20 65 72 72 6f 72 20 69 66 20 74 68 65   an error if the
1f60: 20 65 6e 63 6f 64 69 6e 67 20 69 73 20 6e 6f 74   encoding is not
1f70: 20 74 68 65 20 73 61 6d 65 0a 20 20 2a 2a 20 61   the same.  ** a
1f80: 73 20 73 71 6c 69 74 65 33 2e 65 6e 63 2e 0a 20  s sqlite3.enc.. 
1f90: 20 2a 2f 0a 20 20 69 66 28 20 6d 65 74 61 5b 34   */.  if( meta[4
1fa0: 5d 20 29 7b 20 20 2f 2a 20 74 65 78 74 20 65 6e  ] ){  /* text en
1fb0: 63 6f 64 69 6e 67 20 2a 2f 0a 20 20 20 20 69 66  coding */.    if
1fc0: 28 20 69 44 62 3d 3d 30 20 29 7b 0a 20 20 20 20  ( iDb==0 ){.    
1fd0: 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67 20    /* If opening 
1fe0: 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73  the main databas
1ff0: 65 2c 20 73 65 74 20 45 4e 43 28 64 62 29 2e 20  e, set ENC(db). 
2000: 2a 2f 0a 20 20 20 20 20 20 45 4e 43 28 64 62 29  */.      ENC(db)
2010: 20 3d 20 28 75 38 29 6d 65 74 61 5b 34 5d 3b 0a   = (u8)meta[4];.
2020: 20 20 20 20 20 20 64 62 2d 3e 70 44 66 6c 74 43        db->pDfltC
2030: 6f 6c 6c 20 3d 20 73 71 6c 69 74 65 33 46 69 6e  oll = sqlite3Fin
2040: 64 43 6f 6c 6c 53 65 71 28 64 62 2c 20 53 51 4c  dCollSeq(db, SQL
2050: 49 54 45 5f 55 54 46 38 2c 20 22 42 49 4e 41 52  ITE_UTF8, "BINAR
2060: 59 22 2c 20 36 2c 20 30 29 3b 0a 20 20 20 20 7d  Y", 6, 0);.    }
2070: 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20 49  else{.      /* I
2080: 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 61 74 74  f opening an att
2090: 61 63 68 65 64 20 64 61 74 61 62 61 73 65 2c 20  ached database, 
20a0: 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6d 75 63  the encoding muc
20b0: 68 20 6d 61 74 63 68 20 45 4e 43 28 64 62 29 20  h match ENC(db) 
20c0: 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 6d 65 74  */.      if( met
20d0: 61 5b 34 5d 21 3d 45 4e 43 28 64 62 29 20 29 7b  a[4]!=ENC(db) ){
20e0: 0a 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33  .        sqlite3
20f0: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d  SetString(pzErrM
2100: 73 67 2c 20 64 62 2c 20 22 61 74 74 61 63 68 65  sg, db, "attache
2110: 64 20 64 61 74 61 62 61 73 65 73 20 6d 75 73 74  d databases must
2120: 20 75 73 65 20 74 68 65 20 73 61 6d 65 22 0a 20   use the same". 
2130: 20 20 20 20 20 20 20 20 20 20 20 22 20 74 65 78             " tex
2140: 74 20 65 6e 63 6f 64 69 6e 67 20 61 73 20 6d 61  t encoding as ma
2150: 69 6e 20 64 61 74 61 62 61 73 65 22 29 3b 0a 20  in database");. 
2160: 20 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49         rc = SQLI
2170: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20  TE_ERROR;.      
2180: 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f 65    goto initone_e
2190: 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 20 20 20 20  rror_out;.      
21a0: 7d 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b  }.    }.  }else{
21b0: 0a 20 20 20 20 44 62 53 65 74 50 72 6f 70 65 72  .    DbSetProper
21c0: 74 79 28 64 62 2c 20 69 44 62 2c 20 44 42 5f 45  ty(db, iDb, DB_E
21d0: 6d 70 74 79 29 3b 0a 20 20 7d 0a 20 20 70 44 62  mpty);.  }.  pDb
21e0: 2d 3e 70 53 63 68 65 6d 61 2d 3e 65 6e 63 20 3d  ->pSchema->enc =
21f0: 20 45 4e 43 28 64 62 29 3b 0a 0a 20 20 69 66 28   ENC(db);..  if(
2200: 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 63   pDb->pSchema->c
2210: 61 63 68 65 5f 73 69 7a 65 3d 3d 30 20 29 7b 0a  ache_size==0 ){.
2220: 20 20 20 20 73 69 7a 65 20 3d 20 6d 65 74 61 5b      size = meta[
2230: 32 5d 3b 0a 20 20 20 20 69 66 28 20 73 69 7a 65  2];.    if( size
2240: 3d 3d 30 20 29 7b 20 73 69 7a 65 20 3d 20 53 51  ==0 ){ size = SQ
2250: 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 43  LITE_DEFAULT_CAC
2260: 48 45 5f 53 49 5a 45 3b 20 7d 0a 20 20 20 20 69  HE_SIZE; }.    i
2270: 66 28 20 73 69 7a 65 3c 30 20 29 20 73 69 7a 65  f( size<0 ) size
2280: 20 3d 20 2d 73 69 7a 65 3b 0a 20 20 20 20 70 44   = -size;.    pD
2290: 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 63 61 63 68  b->pSchema->cach
22a0: 65 5f 73 69 7a 65 20 3d 20 73 69 7a 65 3b 0a 20  e_size = size;. 
22b0: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 53     sqlite3BtreeS
22c0: 65 74 43 61 63 68 65 53 69 7a 65 28 70 44 62 2d  etCacheSize(pDb-
22d0: 3e 70 42 74 2c 20 70 44 62 2d 3e 70 53 63 68 65  >pBt, pDb->pSche
22e0: 6d 61 2d 3e 63 61 63 68 65 5f 73 69 7a 65 29 3b  ma->cache_size);
22f0: 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20  .  }..  /*.  ** 
2300: 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 31 20 20  file_format==1  
2310: 20 20 56 65 72 73 69 6f 6e 20 33 2e 30 2e 30 2e    Version 3.0.0.
2320: 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 6f 72 6d 61  .  ** file_forma
2330: 74 3d 3d 32 20 20 20 20 56 65 72 73 69 6f 6e 20  t==2    Version 
2340: 33 2e 31 2e 33 2e 20 20 2f 2f 20 41 4c 54 45 52  3.1.3.  // ALTER
2350: 20 54 41 42 4c 45 20 41 44 44 20 43 4f 4c 55 4d   TABLE ADD COLUM
2360: 4e 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 6f 72 6d  N.  ** file_form
2370: 61 74 3d 3d 33 20 20 20 20 56 65 72 73 69 6f 6e  at==3    Version
2380: 20 33 2e 31 2e 34 2e 20 20 2f 2f 20 64 69 74 74   3.1.4.  // ditt
2390: 6f 20 62 75 74 20 77 69 74 68 20 6e 6f 6e 2d 4e  o but with non-N
23a0: 55 4c 4c 20 64 65 66 61 75 6c 74 73 0a 20 20 2a  ULL defaults.  *
23b0: 2a 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 34  * file_format==4
23c0: 20 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 33 2e      Version 3.3.
23d0: 30 2e 20 20 2f 2f 20 44 45 53 43 20 69 6e 64 69  0.  // DESC indi
23e0: 63 65 73 2e 20 20 42 6f 6f 6c 65 61 6e 20 63 6f  ces.  Boolean co
23f0: 6e 73 74 61 6e 74 73 0a 20 20 2a 2f 0a 20 20 70  nstants.  */.  p
2400: 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69 6c  Db->pSchema->fil
2410: 65 5f 66 6f 72 6d 61 74 20 3d 20 28 75 38 29 6d  e_format = (u8)m
2420: 65 74 61 5b 31 5d 3b 0a 20 20 69 66 28 20 70 44  eta[1];.  if( pD
2430: 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69 6c 65  b->pSchema->file
2440: 5f 66 6f 72 6d 61 74 3d 3d 30 20 29 7b 0a 20 20  _format==0 ){.  
2450: 20 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e    pDb->pSchema->
2460: 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 31 3b  file_format = 1;
2470: 0a 20 20 7d 0a 20 20 69 66 28 20 70 44 62 2d 3e  .  }.  if( pDb->
2480: 70 53 63 68 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f  pSchema->file_fo
2490: 72 6d 61 74 3e 53 51 4c 49 54 45 5f 4d 41 58 5f  rmat>SQLITE_MAX_
24a0: 46 49 4c 45 5f 46 4f 52 4d 41 54 20 29 7b 0a 20  FILE_FORMAT ){. 
24b0: 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72     sqlite3SetStr
24c0: 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 64 62  ing(pzErrMsg, db
24d0: 2c 20 22 75 6e 73 75 70 70 6f 72 74 65 64 20 66  , "unsupported f
24e0: 69 6c 65 20 66 6f 72 6d 61 74 22 29 3b 0a 20 20  ile format");.  
24f0: 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52    rc = SQLITE_ER
2500: 52 4f 52 3b 0a 20 20 20 20 67 6f 74 6f 20 69 6e  ROR;.    goto in
2510: 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75 74 3b  itone_error_out;
2520: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 69 63 6b 65  .  }..  /* Ticke
2530: 74 20 23 32 38 30 34 3a 20 20 57 68 65 6e 20 77  t #2804:  When w
2540: 65 20 6f 70 65 6e 20 61 20 64 61 74 61 62 61 73  e open a databas
2550: 65 20 69 6e 20 74 68 65 20 6e 65 77 65 72 20 66  e in the newer f
2560: 69 6c 65 20 66 6f 72 6d 61 74 2c 0a 20 20 2a 2a  ile format,.  **
2570: 20 63 6c 65 61 72 20 74 68 65 20 6c 65 67 61 63   clear the legac
2580: 79 5f 66 69 6c 65 5f 66 6f 72 6d 61 74 20 70 72  y_file_format pr
2590: 61 67 6d 61 20 66 6c 61 67 20 73 6f 20 74 68 61  agma flag so tha
25a0: 74 20 61 20 56 41 43 55 55 4d 20 77 69 6c 6c 0a  t a VACUUM will.
25b0: 20 20 2a 2a 20 6e 6f 74 20 64 6f 77 6e 67 72 61    ** not downgra
25c0: 64 65 20 74 68 65 20 64 61 74 61 62 61 73 65 20  de the database 
25d0: 61 6e 64 20 74 68 75 73 20 69 6e 76 61 6c 69 64  and thus invalid
25e0: 61 74 65 20 61 6e 79 20 64 65 73 63 65 6e 64 69  ate any descendi
25f0: 6e 67 0a 20 20 2a 2a 20 69 6e 64 69 63 65 73 20  ng.  ** indices 
2600: 74 68 61 74 20 74 68 65 20 75 73 65 72 20 6d 69  that the user mi
2610: 67 68 74 20 68 61 76 65 20 63 72 65 61 74 65 64  ght have created
2620: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 69 44 62  ..  */.  if( iDb
2630: 3d 3d 30 20 26 26 20 6d 65 74 61 5b 31 5d 3e 3d  ==0 && meta[1]>=
2640: 34 20 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c 61  4 ){.    db->fla
2650: 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f 4c 65  gs &= ~SQLITE_Le
2660: 67 61 63 79 46 69 6c 65 46 6d 74 3b 0a 20 20 7d  gacyFileFmt;.  }
2670: 0a 0a 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20  ..  /* Read the 
2680: 73 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69  schema informati
2690: 6f 6e 20 6f 75 74 20 6f 66 20 74 68 65 20 73 63  on out of the sc
26a0: 68 65 6d 61 20 74 61 62 6c 65 73 0a 20 20 2a 2f  hema tables.  */
26b0: 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 69  .  assert( db->i
26c0: 6e 69 74 2e 62 75 73 79 20 29 3b 0a 20 20 69 66  nit.busy );.  if
26d0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 45 4d 50  ( rc==SQLITE_EMP
26e0: 54 59 20 29 7b 0a 20 20 20 20 2f 2a 20 46 6f 72  TY ){.    /* For
26f0: 20 61 6e 20 65 6d 70 74 79 20 64 61 74 61 62 61   an empty databa
2700: 73 65 2c 20 74 68 65 72 65 20 69 73 20 6e 6f 74  se, there is not
2710: 68 69 6e 67 20 74 6f 20 72 65 61 64 20 2a 2f 0a  hing to read */.
2720: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
2730: 4f 4b 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  OK;.  }else{.   
2740: 20 63 68 61 72 20 2a 7a 53 71 6c 3b 0a 20 20 20   char *zSql;.   
2750: 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74 65 33 4d   zSql = sqlite3M
2760: 50 72 69 6e 74 66 28 64 62 2c 20 0a 20 20 20 20  Printf(db, .    
2770: 20 20 20 20 22 53 45 4c 45 43 54 20 6e 61 6d 65      "SELECT name
2780: 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c 20  , rootpage, sql 
2790: 46 52 4f 4d 20 27 25 71 27 2e 25 73 22 2c 0a 20  FROM '%q'.%s",. 
27a0: 20 20 20 20 20 20 20 64 62 2d 3e 61 44 62 5b 69         db->aDb[i
27b0: 44 62 5d 2e 7a 4e 61 6d 65 2c 20 7a 4d 61 73 74  Db].zName, zMast
27c0: 65 72 4e 61 6d 65 29 3b 0a 20 20 20 20 28 76 6f  erName);.    (vo
27d0: 69 64 29 73 71 6c 69 74 65 33 53 61 66 65 74 79  id)sqlite3Safety
27e0: 4f 66 66 28 64 62 29 3b 0a 23 69 66 6e 64 65 66  Off(db);.#ifndef
27f0: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 55 54   SQLITE_OMIT_AUT
2800: 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 20 20 7b  HORIZATION.    {
2810: 0a 20 20 20 20 20 20 69 6e 74 20 28 2a 78 41 75  .      int (*xAu
2820: 74 68 29 28 76 6f 69 64 2a 2c 69 6e 74 2c 63 6f  th)(void*,int,co
2830: 6e 73 74 20 63 68 61 72 2a 2c 63 6f 6e 73 74 20  nst char*,const 
2840: 63 68 61 72 2a 2c 63 6f 6e 73 74 20 63 68 61 72  char*,const char
2850: 2a 2c 63 6f 6e 73 74 20 63 68 61 72 2a 29 3b 0a  *,const char*);.
2860: 20 20 20 20 20 20 78 41 75 74 68 20 3d 20 64 62        xAuth = db
2870: 2d 3e 78 41 75 74 68 3b 0a 20 20 20 20 20 20 64  ->xAuth;.      d
2880: 62 2d 3e 78 41 75 74 68 20 3d 20 30 3b 0a 23 65  b->xAuth = 0;.#e
2890: 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20 3d 20  ndif.      rc = 
28a0: 73 71 6c 69 74 65 33 5f 65 78 65 63 28 64 62 2c  sqlite3_exec(db,
28b0: 20 7a 53 71 6c 2c 20 73 71 6c 69 74 65 33 49 6e   zSql, sqlite3In
28c0: 69 74 43 61 6c 6c 62 61 63 6b 2c 20 26 69 6e 69  itCallback, &ini
28d0: 74 44 61 74 61 2c 20 30 29 3b 0a 23 69 66 6e 64  tData, 0);.#ifnd
28e0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41  ef SQLITE_OMIT_A
28f0: 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 20  UTHORIZATION.   
2900: 20 20 20 64 62 2d 3e 78 41 75 74 68 20 3d 20 78     db->xAuth = x
2910: 41 75 74 68 3b 0a 20 20 20 20 7d 0a 23 65 6e 64  Auth;.    }.#end
2920: 69 66 0a 20 20 20 20 69 66 28 20 72 63 3d 3d 53  if.    if( rc==S
2930: 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20 3d 20  QLITE_OK ) rc = 
2940: 69 6e 69 74 44 61 74 61 2e 72 63 3b 0a 20 20 20  initData.rc;.   
2950: 20 28 76 6f 69 64 29 73 71 6c 69 74 65 33 53 61   (void)sqlite3Sa
2960: 66 65 74 79 4f 6e 28 64 62 29 3b 0a 20 20 20 20  fetyOn(db);.    
2970: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62  sqlite3DbFree(db
2980: 2c 20 7a 53 71 6c 29 3b 0a 23 69 66 6e 64 65 66  , zSql);.#ifndef
2990: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 4e 41   SQLITE_OMIT_ANA
29a0: 4c 59 5a 45 0a 20 20 20 20 69 66 28 20 72 63 3d  LYZE.    if( rc=
29b0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20  =SQLITE_OK ){.  
29c0: 20 20 20 20 73 71 6c 69 74 65 33 41 6e 61 6c 79      sqlite3Analy
29d0: 73 69 73 4c 6f 61 64 28 64 62 2c 20 69 44 62 29  sisLoad(db, iDb)
29e0: 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 0a 20  ;.    }.#endif. 
29f0: 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61 6c   }.  if( db->mal
2a00: 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20 20  locFailed ){.   
2a10: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d   rc = SQLITE_NOM
2a20: 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 52  EM;.    sqlite3R
2a30: 65 73 65 74 49 6e 74 65 72 6e 61 6c 53 63 68 65  esetInternalSche
2a40: 6d 61 28 64 62 2c 20 30 29 3b 0a 20 20 7d 0a 20  ma(db, 0);.  }. 
2a50: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f   if( rc==SQLITE_
2a60: 4f 4b 20 7c 7c 20 28 64 62 2d 3e 66 6c 61 67 73  OK || (db->flags
2a70: 26 53 51 4c 49 54 45 5f 52 65 63 6f 76 65 72 79  &SQLITE_Recovery
2a80: 4d 6f 64 65 29 29 7b 0a 20 20 20 20 2f 2a 20 42  Mode)){.    /* B
2a90: 6c 61 63 6b 20 6d 61 67 69 63 3a 20 49 66 20 74  lack magic: If t
2aa0: 68 65 20 53 51 4c 49 54 45 5f 52 65 63 6f 76 65  he SQLITE_Recove
2ab0: 72 79 4d 6f 64 65 20 66 6c 61 67 20 69 73 20 73  ryMode flag is s
2ac0: 65 74 2c 20 74 68 65 6e 20 63 6f 6e 73 69 64 65  et, then conside
2ad0: 72 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 63 68  r.    ** the sch
2ae0: 65 6d 61 20 6c 6f 61 64 65 64 2c 20 65 76 65 6e  ema loaded, even
2af0: 20 69 66 20 65 72 72 6f 72 73 20 6f 63 63 75 72   if errors occur
2b00: 72 65 64 2e 20 49 6e 20 74 68 69 73 20 73 69 74  red. In this sit
2b10: 75 61 74 69 6f 6e 20 74 68 65 20 0a 20 20 20 20  uation the .    
2b20: 2a 2a 20 63 75 72 72 65 6e 74 20 73 71 6c 69 74  ** current sqlit
2b30: 65 33 5f 70 72 65 70 61 72 65 28 29 20 6f 70 65  e3_prepare() ope
2b40: 72 61 74 69 6f 6e 20 77 69 6c 6c 20 66 61 69 6c  ration will fail
2b50: 2c 20 62 75 74 20 74 68 65 20 66 6f 6c 6c 6f 77  , but the follow
2b60: 69 6e 67 20 6f 6e 65 0a 20 20 20 20 2a 2a 20 77  ing one.    ** w
2b70: 69 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 63  ill attempt to c
2b80: 6f 6d 70 69 6c 65 20 74 68 65 20 73 75 70 70 6c  ompile the suppl
2b90: 69 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61 67  ied statement ag
2ba0: 61 69 6e 73 74 20 77 68 61 74 65 76 65 72 20 73  ainst whatever s
2bb0: 75 62 73 65 74 0a 20 20 20 20 2a 2a 20 6f 66 20  ubset.    ** of 
2bc0: 74 68 65 20 73 63 68 65 6d 61 20 77 61 73 20 6c  the schema was l
2bd0: 6f 61 64 65 64 20 62 65 66 6f 72 65 20 74 68 65  oaded before the
2be0: 20 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2e   error occurred.
2bf0: 20 54 68 65 20 70 72 69 6d 61 72 79 0a 20 20 20   The primary.   
2c00: 20 2a 2a 20 70 75 72 70 6f 73 65 20 6f 66 20 74   ** purpose of t
2c10: 68 69 73 20 69 73 20 74 6f 20 61 6c 6c 6f 77 20  his is to allow 
2c20: 61 63 63 65 73 73 20 74 6f 20 74 68 65 20 73 71  access to the sq
2c30: 6c 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c  lite_master tabl
2c40: 65 0a 20 20 20 20 2a 2a 20 65 76 65 6e 20 77 68  e.    ** even wh
2c50: 65 6e 20 69 74 73 20 63 6f 6e 74 65 6e 74 73 20  en its contents 
2c60: 68 61 76 65 20 62 65 65 6e 20 63 6f 72 72 75 70  have been corrup
2c70: 74 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20  ted..    */.    
2c80: 44 62 53 65 74 50 72 6f 70 65 72 74 79 28 64 62  DbSetProperty(db
2c90: 2c 20 69 44 62 2c 20 44 42 5f 53 63 68 65 6d 61  , iDb, DB_Schema
2ca0: 4c 6f 61 64 65 64 29 3b 0a 20 20 20 20 72 63 20  Loaded);.    rc 
2cb0: 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d  = SQLITE_OK;.  }
2cc0: 0a 0a 20 20 2f 2a 20 4a 75 6d 70 20 68 65 72 65  ..  /* Jump here
2cd0: 20 66 6f 72 20 61 6e 20 65 72 72 6f 72 20 74 68   for an error th
2ce0: 61 74 20 6f 63 63 75 72 73 20 61 66 74 65 72 20  at occurs after 
2cf0: 73 75 63 63 65 73 73 66 75 6c 6c 79 20 61 6c 6c  successfully all
2d00: 6f 63 61 74 69 6e 67 0a 20 20 2a 2a 20 63 75 72  ocating.  ** cur
2d10: 4d 61 69 6e 20 61 6e 64 20 63 61 6c 6c 69 6e 67  Main and calling
2d20: 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74   sqlite3BtreeEnt
2d30: 65 72 28 29 2e 20 46 6f 72 20 61 6e 20 65 72 72  er(). For an err
2d40: 6f 72 20 74 68 61 74 20 6f 63 63 75 72 73 0a 20  or that occurs. 
2d50: 20 2a 2a 20 62 65 66 6f 72 65 20 74 68 61 74 20   ** before that 
2d60: 70 6f 69 6e 74 2c 20 6a 75 6d 70 20 74 6f 20 65  point, jump to e
2d70: 72 72 6f 72 5f 6f 75 74 2e 0a 20 20 2a 2f 0a 69  rror_out..  */.i
2d80: 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75 74  nitone_error_out
2d90: 3a 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65  :.  sqlite3Btree
2da0: 43 6c 6f 73 65 43 75 72 73 6f 72 28 63 75 72 4d  CloseCursor(curM
2db0: 61 69 6e 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f  ain);.  sqlite3_
2dc0: 66 72 65 65 28 63 75 72 4d 61 69 6e 29 3b 0a 20  free(curMain);. 
2dd0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61   sqlite3BtreeLea
2de0: 76 65 28 70 44 62 2d 3e 70 42 74 29 3b 0a 0a 65  ve(pDb->pBt);..e
2df0: 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 69 66 28 20  rror_out:.  if( 
2e00: 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  rc==SQLITE_NOMEM
2e10: 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49   || rc==SQLITE_I
2e20: 4f 45 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20  OERR_NOMEM ){.  
2e30: 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c    db->mallocFail
2e40: 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 72 65  ed = 1;.  }.  re
2e50: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
2e60: 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 61 6c 6c  * Initialize all
2e70: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73 20   database files 
2e80: 2d 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62  - the main datab
2e90: 61 73 65 20 66 69 6c 65 2c 20 74 68 65 20 66 69  ase file, the fi
2ea0: 6c 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 73 74  le.** used to st
2eb0: 6f 72 65 20 74 65 6d 70 6f 72 61 72 79 20 74 61  ore temporary ta
2ec0: 62 6c 65 73 2c 20 61 6e 64 20 61 6e 79 20 61 64  bles, and any ad
2ed0: 64 69 74 69 6f 6e 61 6c 20 64 61 74 61 62 61 73  ditional databas
2ee0: 65 20 66 69 6c 65 73 0a 2a 2a 20 63 72 65 61 74  e files.** creat
2ef0: 65 64 20 75 73 69 6e 67 20 41 54 54 41 43 48 20  ed using ATTACH 
2f00: 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 52 65 74  statements.  Ret
2f10: 75 72 6e 20 61 20 73 75 63 63 65 73 73 20 63 6f  urn a success co
2f20: 64 65 2e 20 20 49 66 20 61 6e 0a 2a 2a 20 65 72  de.  If an.** er
2f30: 72 6f 72 20 6f 63 63 75 72 73 2c 20 77 72 69 74  ror occurs, writ
2f40: 65 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73 61  e an error messa
2f50: 67 65 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d 73  ge into *pzErrMs
2f60: 67 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72 20 61  g..**.** After a
2f70: 20 64 61 74 61 62 61 73 65 20 69 73 20 69 6e 69   database is ini
2f80: 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 44 42  tialized, the DB
2f90: 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 20 62 69  _SchemaLoaded bi
2fa0: 74 20 69 73 20 73 65 74 0a 2a 2a 20 62 69 74 20  t is set.** bit 
2fb0: 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 66 6c  is set in the fl
2fc0: 61 67 73 20 66 69 65 6c 64 20 6f 66 20 74 68 65  ags field of the
2fd0: 20 44 62 20 73 74 72 75 63 74 75 72 65 2e 20 49   Db structure. I
2fe0: 66 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 2a  f the database.*
2ff0: 2a 20 66 69 6c 65 20 77 61 73 20 6f 66 20 7a 65  * file was of ze
3000: 72 6f 2d 6c 65 6e 67 74 68 2c 20 74 68 65 6e 20  ro-length, then 
3010: 74 68 65 20 44 42 5f 45 6d 70 74 79 20 66 6c 61  the DB_Empty fla
3020: 67 20 69 73 20 61 6c 73 6f 20 73 65 74 2e 0a 2a  g is also set..*
3030: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e 69  /.int sqlite3Ini
3040: 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 63  t(sqlite3 *db, c
3050: 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b  har **pzErrMsg){
3060: 0a 20 20 69 6e 74 20 69 2c 20 72 63 3b 0a 20 20  .  int i, rc;.  
3070: 69 6e 74 20 63 6f 6d 6d 69 74 5f 69 6e 74 65 72  int commit_inter
3080: 6e 61 6c 20 3d 20 21 28 64 62 2d 3e 66 6c 61 67  nal = !(db->flag
3090: 73 26 53 51 4c 49 54 45 5f 49 6e 74 65 72 6e 43  s&SQLITE_InternC
30a0: 68 61 6e 67 65 73 29 3b 0a 20 20 0a 20 20 61 73  hanges);.  .  as
30b0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
30c0: 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74  tex_held(db->mut
30d0: 65 78 29 20 29 3b 0a 20 20 69 66 28 20 64 62 2d  ex) );.  if( db-
30e0: 3e 69 6e 69 74 2e 62 75 73 79 20 29 20 72 65 74  >init.busy ) ret
30f0: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  urn SQLITE_OK;. 
3100: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
3110: 0a 20 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79  .  db->init.busy
3120: 20 3d 20 31 3b 0a 20 20 66 6f 72 28 69 3d 30 3b   = 1;.  for(i=0;
3130: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26   rc==SQLITE_OK &
3140: 26 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b  & i<db->nDb; i++
3150: 29 7b 0a 20 20 20 20 69 66 28 20 44 62 48 61 73  ){.    if( DbHas
3160: 50 72 6f 70 65 72 74 79 28 64 62 2c 20 69 2c 20  Property(db, i, 
3170: 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29  DB_SchemaLoaded)
3180: 20 7c 7c 20 69 3d 3d 31 20 29 20 63 6f 6e 74 69   || i==1 ) conti
3190: 6e 75 65 3b 0a 20 20 20 20 72 63 20 3d 20 73 71  nue;.    rc = sq
31a0: 6c 69 74 65 33 49 6e 69 74 4f 6e 65 28 64 62 2c  lite3InitOne(db,
31b0: 20 69 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20   i, pzErrMsg);. 
31c0: 20 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20     if( rc ){.   
31d0: 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74 49     sqlite3ResetI
31e0: 6e 74 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62  nternalSchema(db
31f0: 2c 20 69 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a  , i);.    }.  }.
3200: 0a 20 20 2f 2a 20 4f 6e 63 65 20 61 6c 6c 20 74  .  /* Once all t
3210: 68 65 20 6f 74 68 65 72 20 64 61 74 61 62 61 73  he other databas
3220: 65 73 20 68 61 76 65 20 62 65 65 6e 20 69 6e 69  es have been ini
3230: 74 69 61 6c 69 73 65 64 2c 20 6c 6f 61 64 20 74  tialised, load t
3240: 68 65 20 73 63 68 65 6d 61 0a 20 20 2a 2a 20 66  he schema.  ** f
3250: 6f 72 20 74 68 65 20 54 45 4d 50 20 64 61 74 61  or the TEMP data
3260: 62 61 73 65 2e 20 54 68 69 73 20 69 73 20 6c 6f  base. This is lo
3270: 61 64 65 64 20 6c 61 73 74 2c 20 61 73 20 74 68  aded last, as th
3280: 65 20 54 45 4d 50 20 64 61 74 61 62 61 73 65 0a  e TEMP database.
3290: 20 20 2a 2a 20 73 63 68 65 6d 61 20 6d 61 79 20    ** schema may 
32a0: 63 6f 6e 74 61 69 6e 20 72 65 66 65 72 65 6e 63  contain referenc
32b0: 65 73 20 74 6f 20 6f 62 6a 65 63 74 73 20 69 6e  es to objects in
32c0: 20 6f 74 68 65 72 20 64 61 74 61 62 61 73 65 73   other databases
32d0: 2e 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53  ..  */.#ifndef S
32e0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d 50 44  QLITE_OMIT_TEMPD
32f0: 42 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49  B.  if( rc==SQLI
3300: 54 45 5f 4f 4b 20 26 26 20 64 62 2d 3e 6e 44 62  TE_OK && db->nDb
3310: 3e 31 20 26 26 20 21 44 62 48 61 73 50 72 6f 70  >1 && !DbHasProp
3320: 65 72 74 79 28 64 62 2c 20 31 2c 20 44 42 5f 53  erty(db, 1, DB_S
3330: 63 68 65 6d 61 4c 6f 61 64 65 64 29 20 29 7b 0a  chemaLoaded) ){.
3340: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
3350: 49 6e 69 74 4f 6e 65 28 64 62 2c 20 31 2c 20 70  InitOne(db, 1, p
3360: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 69 66  zErrMsg);.    if
3370: 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 73 71  ( rc ){.      sq
3380: 6c 69 74 65 33 52 65 73 65 74 49 6e 74 65 72 6e  lite3ResetIntern
3390: 61 6c 53 63 68 65 6d 61 28 64 62 2c 20 31 29 3b  alSchema(db, 1);
33a0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69  .    }.  }.#endi
33b0: 66 0a 0a 20 20 64 62 2d 3e 69 6e 69 74 2e 62 75  f..  db->init.bu
33c0: 73 79 20 3d 20 30 3b 0a 20 20 69 66 28 20 72 63  sy = 0;.  if( rc
33d0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 63  ==SQLITE_OK && c
33e0: 6f 6d 6d 69 74 5f 69 6e 74 65 72 6e 61 6c 20 29  ommit_internal )
33f0: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f 6d  {.    sqlite3Com
3400: 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67  mitInternalChang
3410: 65 73 28 64 62 29 3b 0a 20 20 7d 0a 0a 20 20 72  es(db);.  }..  r
3420: 65 74 75 72 6e 20 72 63 3b 20 0a 7d 0a 0a 2f 2a  eturn rc; .}../*
3430: 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65  .** This routine
3440: 20 69 73 20 61 20 6e 6f 2d 6f 70 20 69 66 20 74   is a no-op if t
3450: 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 65  he database sche
3460: 6d 61 20 69 73 20 61 6c 72 65 61 64 79 20 69 6e  ma is already in
3470: 69 74 69 61 6c 69 73 65 64 2e 0a 2a 2a 20 4f 74  itialised..** Ot
3480: 68 65 72 77 69 73 65 2c 20 74 68 65 20 73 63 68  herwise, the sch
3490: 65 6d 61 20 69 73 20 6c 6f 61 64 65 64 2e 20 41  ema is loaded. A
34a0: 6e 20 65 72 72 6f 72 20 63 6f 64 65 20 69 73 20  n error code is 
34b0: 72 65 74 75 72 6e 65 64 2e 0a 2a 2f 0a 69 6e 74  returned..*/.int
34c0: 20 73 71 6c 69 74 65 33 52 65 61 64 53 63 68 65   sqlite3ReadSche
34d0: 6d 61 28 50 61 72 73 65 20 2a 70 50 61 72 73 65  ma(Parse *pParse
34e0: 29 7b 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51  ){.  int rc = SQ
34f0: 4c 49 54 45 5f 4f 4b 3b 0a 20 20 73 71 6c 69 74  LITE_OK;.  sqlit
3500: 65 33 20 2a 64 62 20 3d 20 70 50 61 72 73 65 2d  e3 *db = pParse-
3510: 3e 64 62 3b 0a 20 20 61 73 73 65 72 74 28 20 73  >db;.  assert( s
3520: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
3530: 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  d(db->mutex) );.
3540: 20 20 69 66 28 20 21 64 62 2d 3e 69 6e 69 74 2e    if( !db->init.
3550: 62 75 73 79 20 29 7b 0a 20 20 20 20 72 63 20 3d  busy ){.    rc =
3560: 20 73 71 6c 69 74 65 33 49 6e 69 74 28 64 62 2c   sqlite3Init(db,
3570: 20 26 70 50 61 72 73 65 2d 3e 7a 45 72 72 4d 73   &pParse->zErrMs
3580: 67 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 72 63  g);.  }.  if( rc
3590: 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20  !=SQLITE_OK ){. 
35a0: 20 20 20 70 50 61 72 73 65 2d 3e 72 63 20 3d 20     pParse->rc = 
35b0: 72 63 3b 0a 20 20 20 20 70 50 61 72 73 65 2d 3e  rc;.    pParse->
35c0: 6e 45 72 72 2b 2b 3b 0a 20 20 7d 0a 20 20 72 65  nErr++;.  }.  re
35d0: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a  turn rc;.}.../*.
35e0: 2a 2a 20 43 68 65 63 6b 20 73 63 68 65 6d 61 20  ** Check schema 
35f0: 63 6f 6f 6b 69 65 73 20 69 6e 20 61 6c 6c 20 64  cookies in all d
3600: 61 74 61 62 61 73 65 73 2e 20 20 49 66 20 61 6e  atabases.  If an
3610: 79 20 63 6f 6f 6b 69 65 20 69 73 20 6f 75 74 0a  y cookie is out.
3620: 2a 2a 20 6f 66 20 64 61 74 65 2c 20 72 65 74 75  ** of date, retu
3630: 72 6e 20 30 2e 20 20 49 66 20 61 6c 6c 20 73 63  rn 0.  If all sc
3640: 68 65 6d 61 20 63 6f 6f 6b 69 65 73 20 61 72 65  hema cookies are
3650: 20 63 75 72 72 65 6e 74 2c 20 72 65 74 75 72 6e   current, return
3660: 20 31 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e   1..*/.static in
3670: 74 20 73 63 68 65 6d 61 49 73 56 61 6c 69 64 28  t schemaIsValid(
3680: 73 71 6c 69 74 65 33 20 2a 64 62 29 7b 0a 20 20  sqlite3 *db){.  
3690: 69 6e 74 20 69 44 62 3b 0a 20 20 69 6e 74 20 72  int iDb;.  int r
36a0: 63 3b 0a 20 20 42 74 43 75 72 73 6f 72 20 2a 63  c;.  BtCursor *c
36b0: 75 72 54 65 6d 70 3b 0a 20 20 69 6e 74 20 63 6f  urTemp;.  int co
36c0: 6f 6b 69 65 3b 0a 20 20 69 6e 74 20 61 6c 6c 4f  okie;.  int allO
36d0: 6b 20 3d 20 31 3b 0a 0a 20 20 63 75 72 54 65 6d  k = 1;..  curTem
36e0: 70 20 3d 20 28 42 74 43 75 72 73 6f 72 20 2a 29  p = (BtCursor *)
36f0: 73 71 6c 69 74 65 33 4d 61 6c 6c 6f 63 28 73 71  sqlite3Malloc(sq
3700: 6c 69 74 65 33 42 74 72 65 65 43 75 72 73 6f 72  lite3BtreeCursor
3710: 53 69 7a 65 28 29 29 3b 0a 20 20 69 66 28 20 63  Size());.  if( c
3720: 75 72 54 65 6d 70 20 29 7b 0a 20 20 20 20 61 73  urTemp ){.    as
3730: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
3740: 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74  tex_held(db->mut
3750: 65 78 29 20 29 3b 0a 20 20 20 20 66 6f 72 28 69  ex) );.    for(i
3760: 44 62 3d 30 3b 20 61 6c 6c 4f 6b 20 26 26 20 69  Db=0; allOk && i
3770: 44 62 3c 64 62 2d 3e 6e 44 62 3b 20 69 44 62 2b  Db<db->nDb; iDb+
3780: 2b 29 7b 0a 20 20 20 20 20 20 42 74 72 65 65 20  +){.      Btree 
3790: 2a 70 42 74 3b 0a 20 20 20 20 20 20 70 42 74 20  *pBt;.      pBt 
37a0: 3d 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70  = db->aDb[iDb].p
37b0: 42 74 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42  Bt;.      if( pB
37c0: 74 3d 3d 30 20 29 20 63 6f 6e 74 69 6e 75 65 3b  t==0 ) continue;
37d0: 0a 20 20 20 20 20 20 6d 65 6d 73 65 74 28 63 75  .      memset(cu
37e0: 72 54 65 6d 70 2c 20 30 2c 20 73 71 6c 69 74 65  rTemp, 0, sqlite
37f0: 33 42 74 72 65 65 43 75 72 73 6f 72 53 69 7a 65  3BtreeCursorSize
3800: 28 29 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20  ());.      rc = 
3810: 73 71 6c 69 74 65 33 42 74 72 65 65 43 75 72 73  sqlite3BtreeCurs
3820: 6f 72 28 70 42 74 2c 20 4d 41 53 54 45 52 5f 52  or(pBt, MASTER_R
3830: 4f 4f 54 2c 20 30 2c 20 30 2c 20 63 75 72 54 65  OOT, 0, 0, curTe
3840: 6d 70 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72  mp);.      if( r
3850: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a  c==SQLITE_OK ){.
3860: 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c          rc = sql
3870: 69 74 65 33 42 74 72 65 65 47 65 74 4d 65 74 61  ite3BtreeGetMeta
3880: 28 70 42 74 2c 20 31 2c 20 28 75 33 32 20 2a 29  (pBt, 1, (u32 *)
3890: 26 63 6f 6f 6b 69 65 29 3b 0a 20 20 20 20 20 20  &cookie);.      
38a0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45    if( rc==SQLITE
38b0: 5f 4f 4b 20 26 26 20 63 6f 6f 6b 69 65 21 3d 64  _OK && cookie!=d
38c0: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 53 63 68  b->aDb[iDb].pSch
38d0: 65 6d 61 2d 3e 73 63 68 65 6d 61 5f 63 6f 6f 6b  ema->schema_cook
38e0: 69 65 20 29 7b 0a 20 20 20 20 20 20 20 20 20 20  ie ){.          
38f0: 61 6c 6c 4f 6b 20 3d 20 30 3b 0a 20 20 20 20 20  allOk = 0;.     
3900: 20 20 20 7d 0a 20 20 20 20 20 20 20 20 73 71 6c     }.        sql
3910: 69 74 65 33 42 74 72 65 65 43 6c 6f 73 65 43 75  ite3BtreeCloseCu
3920: 72 73 6f 72 28 63 75 72 54 65 6d 70 29 3b 0a 20  rsor(curTemp);. 
3930: 20 20 20 20 20 7d 0a 20 20 20 20 20 20 69 66 28       }.      if(
3940: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45   rc==SQLITE_NOME
3950: 4d 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f  M || rc==SQLITE_
3960: 49 4f 45 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a 20  IOERR_NOMEM ){. 
3970: 20 20 20 20 20 20 20 64 62 2d 3e 6d 61 6c 6c 6f         db->mallo
3980: 63 46 61 69 6c 65 64 20 3d 20 31 3b 0a 20 20 20  cFailed = 1;.   
3990: 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 73     }.    }.    s
39a0: 71 6c 69 74 65 33 5f 66 72 65 65 28 63 75 72 54  qlite3_free(curT
39b0: 65 6d 70 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20  emp);.  }else{. 
39c0: 20 20 20 61 6c 6c 4f 6b 20 3d 20 30 3b 0a 20 20     allOk = 0;.  
39d0: 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c    db->mallocFail
39e0: 65 64 20 3d 20 31 3b 0a 20 20 7d 0a 0a 20 20 72  ed = 1;.  }..  r
39f0: 65 74 75 72 6e 20 61 6c 6c 4f 6b 3b 0a 7d 0a 0a  eturn allOk;.}..
3a00: 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 61 20  /*.** Convert a 
3a10: 73 63 68 65 6d 61 20 70 6f 69 6e 74 65 72 20 69  schema pointer i
3a20: 6e 74 6f 20 74 68 65 20 69 44 62 20 69 6e 64 65  nto the iDb inde
3a30: 78 20 74 68 61 74 20 69 6e 64 69 63 61 74 65 73  x that indicates
3a40: 0a 2a 2a 20 77 68 69 63 68 20 64 61 74 61 62 61  .** which databa
3a50: 73 65 20 66 69 6c 65 20 69 6e 20 64 62 2d 3e 61  se file in db->a
3a60: 44 62 5b 5d 20 74 68 65 20 73 63 68 65 6d 61 20  Db[] the schema 
3a70: 72 65 66 65 72 73 20 74 6f 2e 0a 2a 2a 0a 2a 2a  refers to..**.**
3a80: 20 49 66 20 74 68 65 20 73 61 6d 65 20 64 61 74   If the same dat
3a90: 61 62 61 73 65 20 69 73 20 61 74 74 61 63 68 65  abase is attache
3aa0: 64 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 63 65  d more than once
3ab0: 2c 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61  , the first.** a
3ac0: 74 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65  ttached database
3ad0: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a 2f   is returned..*/
3ae0: 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 63 68 65  .int sqlite3Sche
3af0: 6d 61 54 6f 49 6e 64 65 78 28 73 71 6c 69 74 65  maToIndex(sqlite
3b00: 33 20 2a 64 62 2c 20 53 63 68 65 6d 61 20 2a 70  3 *db, Schema *p
3b10: 53 63 68 65 6d 61 29 7b 0a 20 20 69 6e 74 20 69  Schema){.  int i
3b20: 20 3d 20 2d 31 30 30 30 30 30 30 3b 0a 0a 20 20   = -1000000;..  
3b30: 2f 2a 20 49 66 20 70 53 63 68 65 6d 61 20 69 73  /* If pSchema is
3b40: 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 72 65 74 75   NULL, then retu
3b50: 72 6e 20 2d 31 30 30 30 30 30 30 2e 20 54 68 69  rn -1000000. Thi
3b60: 73 20 68 61 70 70 65 6e 73 20 77 68 65 6e 20 63  s happens when c
3b70: 6f 64 65 20 69 6e 20 0a 20 20 2a 2a 20 65 78 70  ode in .  ** exp
3b80: 72 2e 63 20 69 73 20 74 72 79 69 6e 67 20 74 6f  r.c is trying to
3b90: 20 72 65 73 6f 6c 76 65 20 61 20 72 65 66 65 72   resolve a refer
3ba0: 65 6e 63 65 20 74 6f 20 61 20 74 72 61 6e 73 69  ence to a transi
3bb0: 65 6e 74 20 74 61 62 6c 65 20 28 69 2e 65 2e 20  ent table (i.e. 
3bc0: 6f 6e 65 0a 20 20 2a 2a 20 63 72 65 61 74 65 64  one.  ** created
3bd0: 20 62 79 20 61 20 73 75 62 2d 73 65 6c 65 63 74   by a sub-select
3be0: 29 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65 20  ). In this case 
3bf0: 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75 65  the return value
3c00: 20 6f 66 20 74 68 69 73 20 0a 20 20 2a 2a 20 66   of this .  ** f
3c10: 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20 6e  unction should n
3c20: 65 76 65 72 20 62 65 20 75 73 65 64 2e 0a 20 20  ever be used..  
3c30: 2a 2a 0a 20 20 2a 2a 20 57 65 20 72 65 74 75 72  **.  ** We retur
3c40: 6e 20 2d 31 30 30 30 30 30 30 20 69 6e 73 74 65  n -1000000 inste
3c50: 61 64 20 6f 66 20 74 68 65 20 6d 6f 72 65 20 75  ad of the more u
3c60: 73 75 61 6c 20 2d 31 20 73 69 6d 70 6c 79 20 62  sual -1 simply b
3c70: 65 63 61 75 73 65 20 75 73 69 6e 67 0a 20 20 2a  ecause using.  *
3c80: 2a 20 2d 31 30 30 30 30 30 30 20 61 73 20 74 68  * -1000000 as th
3c90: 65 20 69 6e 63 6f 72 72 65 63 74 20 69 6e 64 65  e incorrect inde
3ca0: 78 20 69 6e 74 6f 20 64 62 2d 3e 61 44 62 5b 5d  x into db->aDb[]
3cb0: 20 69 73 20 6d 75 63 68 20 0a 20 20 2a 2a 20 6d   is much .  ** m
3cc0: 6f 72 65 20 6c 69 6b 65 6c 79 20 74 6f 20 63 61  ore likely to ca
3cd0: 75 73 65 20 61 20 73 65 67 66 61 75 6c 74 20 74  use a segfault t
3ce0: 68 61 6e 20 2d 31 20 28 6f 66 20 63 6f 75 72 73  han -1 (of cours
3cf0: 65 20 74 68 65 72 65 20 61 72 65 20 61 73 73 65  e there are asse
3d00: 72 74 28 29 0a 20 20 2a 2a 20 73 74 61 74 65 6d  rt().  ** statem
3d10: 65 6e 74 73 20 74 6f 6f 2c 20 62 75 74 20 69 74  ents too, but it
3d20: 20 6e 65 76 65 72 20 68 75 72 74 73 20 74 6f 20   never hurts to 
3d30: 70 6c 61 79 20 74 68 65 20 6f 64 64 73 29 2e 0a  play the odds)..
3d40: 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 73    */.  assert( s
3d50: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c  qlite3_mutex_hel
3d60: 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  d(db->mutex) );.
3d70: 20 20 69 66 28 20 70 53 63 68 65 6d 61 20 29 7b    if( pSchema ){
3d80: 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 41 4c  .    for(i=0; AL
3d90: 57 41 59 53 28 69 3c 64 62 2d 3e 6e 44 62 29 3b  WAYS(i<db->nDb);
3da0: 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 69 66 28   i++){.      if(
3db0: 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 53 63 68   db->aDb[i].pSch
3dc0: 65 6d 61 3d 3d 70 53 63 68 65 6d 61 20 29 7b 0a  ema==pSchema ){.
3dd0: 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20          break;. 
3de0: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 20       }.    }.   
3df0: 20 61 73 73 65 72 74 28 20 69 3e 3d 30 20 26 26   assert( i>=0 &&
3e00: 20 69 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20 20   i<db->nDb );.  
3e10: 7d 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a 7d 0a  }.  return i;.}.
3e20: 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20 74  ./*.** Compile t
3e30: 68 65 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64  he UTF-8 encoded
3e40: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 20 7a   SQL statement z
3e50: 53 71 6c 20 69 6e 74 6f 20 61 20 73 74 61 74 65  Sql into a state
3e60: 6d 65 6e 74 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a  ment handle..*/.
3e70: 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74  static int sqlit
3e80: 65 33 50 72 65 70 61 72 65 28 0a 20 20 73 71 6c  e3Prepare(.  sql
3e90: 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20  ite3 *db,       
3ea0: 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61         /* Databa
3eb0: 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20  se handle. */.  
3ec0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c  const char *zSql
3ed0: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46  ,         /* UTF
3ee0: 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73  -8 encoded SQL s
3ef0: 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69  tatement. */.  i
3f00: 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20  nt nBytes,      
3f10: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67           /* Leng
3f20: 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79  th of zSql in by
3f30: 74 65 73 2e 20 2a 2f 0a 20 20 69 6e 74 20 73 61  tes. */.  int sa
3f40: 76 65 53 71 6c 46 6c 61 67 2c 20 20 20 20 20 20  veSqlFlag,      
3f50: 20 20 20 20 2f 2a 20 54 72 75 65 20 74 6f 20 63      /* True to c
3f60: 6f 70 79 20 53 51 4c 20 74 65 78 74 20 69 6e 74  opy SQL text int
3f70: 6f 20 74 68 65 20 73 71 6c 69 74 65 33 5f 73 74  o the sqlite3_st
3f80: 6d 74 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f  mt */.  sqlite3_
3f90: 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20  stmt **ppStmt,  
3fa0: 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e    /* OUT: A poin
3fb0: 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61  ter to the prepa
3fc0: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f  red statement */
3fd0: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a  .  const char **
3fe0: 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20  pzTail       /* 
3ff0: 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73  OUT: End of pars
4000: 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a  ed string */.){.
4010: 20 20 50 61 72 73 65 20 73 50 61 72 73 65 3b 0a    Parse sParse;.
4020: 20 20 63 68 61 72 20 2a 7a 45 72 72 4d 73 67 20    char *zErrMsg 
4030: 3d 20 30 3b 0a 20 20 69 6e 74 20 72 63 20 3d 20  = 0;.  int rc = 
4040: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e 74  SQLITE_OK;.  int
4050: 20 69 3b 0a 0a 20 20 69 66 28 20 73 71 6c 69 74   i;..  if( sqlit
4060: 65 33 53 61 66 65 74 79 4f 6e 28 64 62 29 20 29  e3SafetyOn(db) )
4070: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d   return SQLITE_M
4080: 49 53 55 53 45 3b 0a 20 20 61 73 73 65 72 74 28  ISUSE;.  assert(
4090: 20 70 70 53 74 6d 74 20 26 26 20 2a 70 70 53 74   ppStmt && *ppSt
40a0: 6d 74 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72  mt==0 );.  asser
40b0: 74 28 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61  t( !db->mallocFa
40c0: 69 6c 65 64 20 29 3b 0a 20 20 61 73 73 65 72 74  iled );.  assert
40d0: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f  ( sqlite3_mutex_
40e0: 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20  held(db->mutex) 
40f0: 29 3b 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74  );..  /* Check t
4100: 6f 20 76 65 72 69 66 79 20 74 68 61 74 20 69 74  o verify that it
4110: 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20   is possible to 
4120: 67 65 74 20 61 20 72 65 61 64 20 6c 6f 63 6b 20  get a read lock 
4130: 6f 6e 20 61 6c 6c 0a 20 20 2a 2a 20 64 61 74 61  on all.  ** data
4140: 62 61 73 65 20 73 63 68 65 6d 61 73 2e 20 20 54  base schemas.  T
4150: 68 65 20 69 6e 61 62 69 6c 69 74 79 20 74 6f 20  he inability to 
4160: 67 65 74 20 61 20 72 65 61 64 20 6c 6f 63 6b 20  get a read lock 
4170: 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 0a 20  indicates that. 
4180: 20 2a 2a 20 73 6f 6d 65 20 6f 74 68 65 72 20 64   ** some other d
4190: 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69  atabase connecti
41a0: 6f 6e 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 20  on is holding a 
41b0: 77 72 69 74 65 2d 6c 6f 63 6b 2c 20 77 68 69 63  write-lock, whic
41c0: 68 20 69 6e 0a 20 20 2a 2a 20 74 75 72 6e 20 6d  h in.  ** turn m
41d0: 65 61 6e 73 20 74 68 61 74 20 74 68 65 20 6f 74  eans that the ot
41e0: 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68  her connection h
41f0: 61 73 20 6d 61 64 65 20 75 6e 63 6f 6d 6d 69 74  as made uncommit
4200: 74 65 64 20 63 68 61 6e 67 65 73 0a 20 20 2a 2a  ted changes.  **
4210: 20 74 6f 20 74 68 65 20 73 63 68 65 6d 61 2e 0a   to the schema..
4220: 20 20 2a 2a 0a 20 20 2a 2a 20 57 65 72 65 20 77    **.  ** Were w
4230: 65 20 74 6f 20 70 72 6f 63 65 65 64 20 61 6e 64  e to proceed and
4240: 20 70 72 65 70 61 72 65 20 74 68 65 20 73 74 61   prepare the sta
4250: 74 65 6d 65 6e 74 20 61 67 61 69 6e 73 74 20 74  tement against t
4260: 68 65 20 75 6e 63 6f 6d 6d 69 74 74 65 64 0a 20  he uncommitted. 
4270: 20 2a 2a 20 73 63 68 65 6d 61 20 63 68 61 6e 67   ** schema chang
4280: 65 73 20 61 6e 64 20 69 66 20 74 68 6f 73 65 20  es and if those 
4290: 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73 20 61  schema changes a
42a0: 72 65 20 73 75 62 73 65 71 75 65 6e 74 6c 79 20  re subsequently 
42b0: 72 6f 6c 6c 65 64 0a 20 20 2a 2a 20 62 61 63 6b  rolled.  ** back
42c0: 20 61 6e 64 20 64 69 66 66 65 72 65 6e 74 20 63   and different c
42d0: 68 61 6e 67 65 73 20 61 72 65 20 6d 61 64 65 20  hanges are made 
42e0: 69 6e 20 74 68 65 69 72 20 70 6c 61 63 65 2c 20  in their place, 
42f0: 74 68 65 6e 20 77 68 65 6e 20 74 68 69 73 0a 20  then when this. 
4300: 20 2a 2a 20 70 72 65 70 61 72 65 64 20 73 74 61   ** prepared sta
4310: 74 65 6d 65 6e 74 20 67 6f 65 73 20 74 6f 20 72  tement goes to r
4320: 75 6e 20 74 68 65 20 73 63 68 65 6d 61 20 63 6f  un the schema co
4330: 6f 6b 69 65 20 77 6f 75 6c 64 20 66 61 69 6c 20  okie would fail 
4340: 74 6f 20 64 65 74 65 63 74 0a 20 20 2a 2a 20 74  to detect.  ** t
4350: 68 65 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65  he schema change
4360: 2e 20 20 44 69 73 61 73 74 65 72 20 77 6f 75 6c  .  Disaster woul
4370: 64 20 66 6f 6c 6c 6f 77 2e 0a 20 20 2a 2a 0a 20  d follow..  **. 
4380: 20 2a 2a 20 54 68 69 73 20 74 68 72 65 61 64 20   ** This thread 
4390: 69 73 20 63 75 72 72 65 6e 74 6c 79 20 68 6f 6c  is currently hol
43a0: 64 69 6e 67 20 6d 75 74 65 78 65 73 20 6f 6e 20  ding mutexes on 
43b0: 61 6c 6c 20 42 74 72 65 65 73 20 28 62 65 63 61  all Btrees (beca
43c0: 75 73 65 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20  use.  ** of the 
43d0: 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65  sqlite3BtreeEnte
43e0: 72 41 6c 6c 28 29 20 69 6e 20 73 71 6c 69 74 65  rAll() in sqlite
43f0: 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28  3LockAndPrepare(
4400: 29 29 20 73 6f 20 69 74 0a 20 20 2a 2a 20 69 73  )) so it.  ** is
4410: 20 6e 6f 74 20 70 6f 73 73 69 62 6c 65 20 66 6f   not possible fo
4420: 72 20 61 6e 6f 74 68 65 72 20 74 68 72 65 61 64  r another thread
4430: 20 74 6f 20 73 74 61 72 74 20 61 20 6e 65 77 20   to start a new 
4440: 73 63 68 65 6d 61 20 63 68 61 6e 67 65 0a 20 20  schema change.  
4450: 2a 2a 20 77 68 69 6c 65 20 74 68 69 73 20 72 6f  ** while this ro
4460: 75 74 69 6e 65 20 69 73 20 72 75 6e 6e 69 6e 67  utine is running
4470: 2e 20 20 48 65 6e 63 65 2c 20 77 65 20 64 6f 20  .  Hence, we do 
4480: 6e 6f 74 20 6e 65 65 64 20 74 6f 20 68 6f 6c 64  not need to hold
4490: 20 0a 20 20 2a 2a 20 6c 6f 63 6b 73 20 6f 6e 20   .  ** locks on 
44a0: 74 68 65 20 73 63 68 65 6d 61 2c 20 77 65 20 6a  the schema, we j
44b0: 75 73 74 20 6e 65 65 64 20 74 6f 20 6d 61 6b 65  ust need to make
44c0: 20 73 75 72 65 20 6e 6f 62 6f 64 79 20 65 6c 73   sure nobody els
44d0: 65 20 69 73 20 0a 20 20 2a 2a 20 68 6f 6c 64 69  e is .  ** holdi
44e0: 6e 67 20 74 68 65 6d 2e 0a 20 20 2a 2a 0a 20 20  ng them..  **.  
44f0: 2a 2a 20 4e 6f 74 65 20 74 68 61 74 20 73 65 74  ** Note that set
4500: 74 69 6e 67 20 52 45 41 44 5f 55 4e 43 4f 4d 4d  ting READ_UNCOMM
4510: 49 54 54 45 44 20 6f 76 65 72 72 69 64 65 73 20  ITTED overrides 
4520: 6d 6f 73 74 20 6c 6f 63 6b 20 64 65 74 65 63 74  most lock detect
4530: 69 6f 6e 2c 0a 20 20 2a 2a 20 62 75 74 20 69 74  ion,.  ** but it
4540: 20 64 6f 65 73 20 2a 6e 6f 74 2a 20 6f 76 65 72   does *not* over
4550: 72 69 64 65 20 73 63 68 65 6d 61 20 6c 6f 63 6b  ride schema lock
4560: 20 64 65 74 65 63 74 69 6f 6e 2c 20 73 6f 20 74   detection, so t
4570: 68 69 73 20 61 6c 6c 20 73 74 69 6c 6c 0a 20 20  his all still.  
4580: 2a 2a 20 77 6f 72 6b 73 20 65 76 65 6e 20 69 66  ** works even if
4590: 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54 54 45   READ_UNCOMMITTE
45a0: 44 20 69 73 20 73 65 74 2e 0a 20 20 2a 2f 0a 20  D is set..  */. 
45b0: 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e   for(i=0; i<db->
45c0: 6e 44 62 3b 20 69 2b 2b 29 20 7b 0a 20 20 20 20  nDb; i++) {.    
45d0: 42 74 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d  Btree *pBt = db-
45e0: 3e 61 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20  >aDb[i].pBt;.   
45f0: 20 69 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20   if( pBt ){.    
4600: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
4610: 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78  3BtreeHoldsMutex
4620: 28 70 42 74 29 20 29 3b 0a 20 20 20 20 20 20 72  (pBt) );.      r
4630: 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65  c = sqlite3Btree
4640: 53 63 68 65 6d 61 4c 6f 63 6b 65 64 28 70 42 74  SchemaLocked(pBt
4650: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 20  );.      if( rc 
4660: 29 7b 0a 20 20 20 20 20 20 20 20 63 6f 6e 73 74  ){.        const
4670: 20 63 68 61 72 20 2a 7a 44 62 20 3d 20 64 62 2d   char *zDb = db-
4680: 3e 61 44 62 5b 69 5d 2e 7a 4e 61 6d 65 3b 0a 20  >aDb[i].zName;. 
4690: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 45 72         sqlite3Er
46a0: 72 6f 72 28 64 62 2c 20 72 63 2c 20 22 64 61 74  ror(db, rc, "dat
46b0: 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 73 20  abase schema is 
46c0: 6c 6f 63 6b 65 64 3a 20 25 73 22 2c 20 7a 44 62  locked: %s", zDb
46d0: 29 3b 0a 20 20 20 20 20 20 20 20 28 76 6f 69 64  );.        (void
46e0: 29 73 71 6c 69 74 65 33 53 61 66 65 74 79 4f 66  )sqlite3SafetyOf
46f0: 66 28 64 62 29 3b 0a 20 20 20 20 20 20 20 20 74  f(db);.        t
4700: 65 73 74 63 61 73 65 28 20 64 62 2d 3e 66 6c 61  estcase( db->fla
4710: 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65 61 64  gs & SQLITE_Read
4720: 55 6e 63 6f 6d 6d 69 74 74 65 64 20 29 3b 0a 20  Uncommitted );. 
4730: 20 20 20 20 20 20 20 72 65 74 75 72 6e 20 73 71         return sq
4740: 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c  lite3ApiExit(db,
4750: 20 72 63 29 3b 0a 20 20 20 20 20 20 7d 0a 20 20   rc);.      }.  
4760: 20 20 7d 0a 20 20 7d 0a 20 20 0a 20 20 6d 65 6d    }.  }.  .  mem
4770: 73 65 74 28 26 73 50 61 72 73 65 2c 20 30 2c 20  set(&sParse, 0, 
4780: 73 69 7a 65 6f 66 28 73 50 61 72 73 65 29 29 3b  sizeof(sParse));
4790: 0a 20 20 73 50 61 72 73 65 2e 64 62 20 3d 20 64  .  sParse.db = d
47a0: 62 3b 0a 20 20 69 66 28 20 6e 42 79 74 65 73 3e  b;.  if( nBytes>
47b0: 3d 30 20 26 26 20 28 6e 42 79 74 65 73 3d 3d 30  =0 && (nBytes==0
47c0: 20 7c 7c 20 7a 53 71 6c 5b 6e 42 79 74 65 73 2d   || zSql[nBytes-
47d0: 31 5d 21 3d 30 29 20 29 7b 0a 20 20 20 20 63 68  1]!=0) ){.    ch
47e0: 61 72 20 2a 7a 53 71 6c 43 6f 70 79 3b 0a 20 20  ar *zSqlCopy;.  
47f0: 20 20 69 6e 74 20 6d 78 4c 65 6e 20 3d 20 64 62    int mxLen = db
4800: 2d 3e 61 4c 69 6d 69 74 5b 53 51 4c 49 54 45 5f  ->aLimit[SQLITE_
4810: 4c 49 4d 49 54 5f 53 51 4c 5f 4c 45 4e 47 54 48  LIMIT_SQL_LENGTH
4820: 5d 3b 0a 20 20 20 20 69 66 28 20 6e 42 79 74 65  ];.    if( nByte
4830: 73 3e 6d 78 4c 65 6e 20 29 7b 0a 20 20 20 20 20  s>mxLen ){.     
4840: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
4850: 2c 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 2c  , SQLITE_TOOBIG,
4860: 20 22 73 74 61 74 65 6d 65 6e 74 20 74 6f 6f 20   "statement too 
4870: 6c 6f 6e 67 22 29 3b 0a 20 20 20 20 20 20 28 76  long");.      (v
4880: 6f 69 64 29 73 71 6c 69 74 65 33 53 61 66 65 74  oid)sqlite3Safet
4890: 79 4f 66 66 28 64 62 29 3b 0a 20 20 20 20 20 20  yOff(db);.      
48a0: 72 65 74 75 72 6e 20 73 71 6c 69 74 65 33 41 70  return sqlite3Ap
48b0: 69 45 78 69 74 28 64 62 2c 20 53 51 4c 49 54 45  iExit(db, SQLITE
48c0: 5f 54 4f 4f 42 49 47 29 3b 0a 20 20 20 20 7d 0a  _TOOBIG);.    }.
48d0: 20 20 20 20 7a 53 71 6c 43 6f 70 79 20 3d 20 73      zSqlCopy = s
48e0: 71 6c 69 74 65 33 44 62 53 74 72 4e 44 75 70 28  qlite3DbStrNDup(
48f0: 64 62 2c 20 7a 53 71 6c 2c 20 6e 42 79 74 65 73  db, zSql, nBytes
4900: 29 3b 0a 20 20 20 20 69 66 28 20 7a 53 71 6c 43  );.    if( zSqlC
4910: 6f 70 79 20 29 7b 0a 20 20 20 20 20 20 73 71 6c  opy ){.      sql
4920: 69 74 65 33 52 75 6e 50 61 72 73 65 72 28 26 73  ite3RunParser(&s
4930: 50 61 72 73 65 2c 20 7a 53 71 6c 43 6f 70 79 2c  Parse, zSqlCopy,
4940: 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20   &zErrMsg);.    
4950: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28    sqlite3DbFree(
4960: 64 62 2c 20 7a 53 71 6c 43 6f 70 79 29 3b 0a 20  db, zSqlCopy);. 
4970: 20 20 20 20 20 73 50 61 72 73 65 2e 7a 54 61 69       sParse.zTai
4980: 6c 20 3d 20 26 7a 53 71 6c 5b 73 50 61 72 73 65  l = &zSql[sParse
4990: 2e 7a 54 61 69 6c 2d 7a 53 71 6c 43 6f 70 79 5d  .zTail-zSqlCopy]
49a0: 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20  ;.    }else{.   
49b0: 20 20 20 73 50 61 72 73 65 2e 7a 54 61 69 6c 20     sParse.zTail 
49c0: 3d 20 26 7a 53 71 6c 5b 6e 42 79 74 65 73 5d 3b  = &zSql[nBytes];
49d0: 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a  .    }.  }else{.
49e0: 20 20 20 20 73 71 6c 69 74 65 33 52 75 6e 50 61      sqlite3RunPa
49f0: 72 73 65 72 28 26 73 50 61 72 73 65 2c 20 7a 53  rser(&sParse, zS
4a00: 71 6c 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20  ql, &zErrMsg);. 
4a10: 20 7d 0a 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61   }..  if( db->ma
4a20: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20  llocFailed ){.  
4a30: 20 20 73 50 61 72 73 65 2e 72 63 20 3d 20 53 51    sParse.rc = SQ
4a40: 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a 20 20 7d 0a  LITE_NOMEM;.  }.
4a50: 20 20 69 66 28 20 73 50 61 72 73 65 2e 72 63 3d    if( sParse.rc=
4a60: 3d 53 51 4c 49 54 45 5f 44 4f 4e 45 20 29 20 73  =SQLITE_DONE ) s
4a70: 50 61 72 73 65 2e 72 63 20 3d 20 53 51 4c 49 54  Parse.rc = SQLIT
4a80: 45 5f 4f 4b 3b 0a 20 20 69 66 28 20 73 50 61 72  E_OK;.  if( sPar
4a90: 73 65 2e 63 68 65 63 6b 53 63 68 65 6d 61 20 26  se.checkSchema &
4aa0: 26 20 21 73 63 68 65 6d 61 49 73 56 61 6c 69 64  & !schemaIsValid
4ab0: 28 64 62 29 20 29 7b 0a 20 20 20 20 73 50 61 72  (db) ){.    sPar
4ac0: 73 65 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 53  se.rc = SQLITE_S
4ad0: 43 48 45 4d 41 3b 0a 20 20 7d 0a 20 20 69 66 28  CHEMA;.  }.  if(
4ae0: 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49   sParse.rc==SQLI
4af0: 54 45 5f 53 43 48 45 4d 41 20 29 7b 0a 20 20 20  TE_SCHEMA ){.   
4b00: 20 73 71 6c 69 74 65 33 52 65 73 65 74 49 6e 74   sqlite3ResetInt
4b10: 65 72 6e 61 6c 53 63 68 65 6d 61 28 64 62 2c 20  ernalSchema(db, 
4b20: 30 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 64 62  0);.  }.  if( db
4b30: 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29  ->mallocFailed )
4b40: 7b 0a 20 20 20 20 73 50 61 72 73 65 2e 72 63 20  {.    sParse.rc 
4b50: 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 3b 0a  = SQLITE_NOMEM;.
4b60: 20 20 7d 0a 20 20 69 66 28 20 70 7a 54 61 69 6c    }.  if( pzTail
4b70: 20 29 7b 0a 20 20 20 20 2a 70 7a 54 61 69 6c 20   ){.    *pzTail 
4b80: 3d 20 73 50 61 72 73 65 2e 7a 54 61 69 6c 3b 0a  = sParse.zTail;.
4b90: 20 20 7d 0a 20 20 72 63 20 3d 20 73 50 61 72 73    }.  rc = sPars
4ba0: 65 2e 72 63 3b 0a 0a 23 69 66 6e 64 65 66 20 53  e.rc;..#ifndef S
4bb0: 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 58 50 4c 41  QLITE_OMIT_EXPLA
4bc0: 49 4e 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c  IN.  if( rc==SQL
4bd0: 49 54 45 5f 4f 4b 20 26 26 20 73 50 61 72 73 65  ITE_OK && sParse
4be0: 2e 70 56 64 62 65 20 26 26 20 73 50 61 72 73 65  .pVdbe && sParse
4bf0: 2e 65 78 70 6c 61 69 6e 20 29 7b 0a 20 20 20 20  .explain ){.    
4c00: 69 66 28 20 73 50 61 72 73 65 2e 65 78 70 6c 61  if( sParse.expla
4c10: 69 6e 3d 3d 32 20 29 7b 0a 20 20 20 20 20 20 73  in==2 ){.      s
4c20: 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e 75 6d  qlite3VdbeSetNum
4c30: 43 6f 6c 73 28 73 50 61 72 73 65 2e 70 56 64 62  Cols(sParse.pVdb
4c40: 65 2c 20 33 29 3b 0a 20 20 20 20 20 20 73 71 6c  e, 3);.      sql
4c50: 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61  ite3VdbeSetColNa
4c60: 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c  me(sParse.pVdbe,
4c70: 20 30 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45   0, COLNAME_NAME
4c80: 2c 20 22 6f 72 64 65 72 22 2c 20 53 51 4c 49 54  , "order", SQLIT
4c90: 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 20 20  E_STATIC);.     
4ca0: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 43   sqlite3VdbeSetC
4cb0: 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56  olName(sParse.pV
4cc0: 64 62 65 2c 20 31 2c 20 43 4f 4c 4e 41 4d 45 5f  dbe, 1, COLNAME_
4cd0: 4e 41 4d 45 2c 20 22 66 72 6f 6d 22 2c 20 53 51  NAME, "from", SQ
4ce0: 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20  LITE_STATIC);.  
4cf0: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53      sqlite3VdbeS
4d00: 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65  etColName(sParse
4d10: 2e 70 56 64 62 65 2c 20 32 2c 20 43 4f 4c 4e 41  .pVdbe, 2, COLNA
4d20: 4d 45 5f 4e 41 4d 45 2c 20 22 64 65 74 61 69 6c  ME_NAME, "detail
4d30: 22 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43  ", SQLITE_STATIC
4d40: 29 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20  );.    }else{.  
4d50: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53      sqlite3VdbeS
4d60: 65 74 4e 75 6d 43 6f 6c 73 28 73 50 61 72 73 65  etNumCols(sParse
4d70: 2e 70 56 64 62 65 2c 20 38 29 3b 0a 20 20 20 20  .pVdbe, 8);.    
4d80: 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74    sqlite3VdbeSet
4d90: 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73 65 2e 70  ColName(sParse.p
4da0: 56 64 62 65 2c 20 30 2c 20 43 4f 4c 4e 41 4d 45  Vdbe, 0, COLNAME
4db0: 5f 4e 41 4d 45 2c 20 22 61 64 64 72 22 2c 20 53  _NAME, "addr", S
4dc0: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
4dd0: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65       sqlite3Vdbe
4de0: 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 72 73  SetColName(sPars
4df0: 65 2e 70 56 64 62 65 2c 20 31 2c 20 43 4f 4c 4e  e.pVdbe, 1, COLN
4e00: 41 4d 45 5f 4e 41 4d 45 2c 20 22 6f 70 63 6f 64  AME_NAME, "opcod
4e10: 65 22 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49  e", SQLITE_STATI
4e20: 43 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  C);.      sqlite
4e30: 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65 28  3VdbeSetColName(
4e40: 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 32 2c  sParse.pVdbe, 2,
4e50: 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 2c 20 22   COLNAME_NAME, "
4e60: 70 31 22 2c 20 53 51 4c 49 54 45 5f 53 54 41 54  p1", SQLITE_STAT
4e70: 49 43 29 3b 0a 20 20 20 20 20 20 73 71 6c 69 74  IC);.      sqlit
4e80: 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65  e3VdbeSetColName
4e90: 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 33  (sParse.pVdbe, 3
4ea0: 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 2c 20  , COLNAME_NAME, 
4eb0: 22 70 32 22 2c 20 53 51 4c 49 54 45 5f 53 54 41  "p2", SQLITE_STA
4ec0: 54 49 43 29 3b 0a 20 20 20 20 20 20 73 71 6c 69  TIC);.      sqli
4ed0: 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d  te3VdbeSetColNam
4ee0: 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20  e(sParse.pVdbe, 
4ef0: 34 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45 2c  4, COLNAME_NAME,
4f00: 20 22 70 33 22 2c 20 53 51 4c 49 54 45 5f 53 54   "p3", SQLITE_ST
4f10: 41 54 49 43 29 3b 0a 20 20 20 20 20 20 73 71 6c  ATIC);.      sql
4f20: 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61  ite3VdbeSetColNa
4f30: 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c  me(sParse.pVdbe,
4f40: 20 35 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d 45   5, COLNAME_NAME
4f50: 2c 20 22 70 34 22 2c 20 53 51 4c 49 54 45 5f 53  , "p4", SQLITE_S
4f60: 54 41 54 49 43 29 3b 0a 20 20 20 20 20 20 73 71  TATIC);.      sq
4f70: 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e  lite3VdbeSetColN
4f80: 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62 65  ame(sParse.pVdbe
4f90: 2c 20 36 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d  , 6, COLNAME_NAM
4fa0: 45 2c 20 22 70 35 22 2c 20 53 51 4c 49 54 45 5f  E, "p5", SQLITE_
4fb0: 53 54 41 54 49 43 29 3b 0a 20 20 20 20 20 20 73  STATIC);.      s
4fc0: 71 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c  qlite3VdbeSetCol
4fd0: 4e 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62  Name(sParse.pVdb
4fe0: 65 2c 20 37 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41  e, 7, COLNAME_NA
4ff0: 4d 45 2c 20 22 63 6f 6d 6d 65 6e 74 22 2c 20 53  ME, "comment", S
5000: 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20  QLITE_STATIC);. 
5010: 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a     }.  }.#endif.
5020: 0a 20 20 69 66 28 20 73 71 6c 69 74 65 33 53 61  .  if( sqlite3Sa
5030: 66 65 74 79 4f 66 66 28 64 62 29 20 29 7b 0a 20  fetyOff(db) ){. 
5040: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4d     rc = SQLITE_M
5050: 49 53 55 53 45 3b 0a 20 20 7d 0a 0a 20 20 61 73  ISUSE;.  }..  as
5060: 73 65 72 74 28 20 64 62 2d 3e 69 6e 69 74 2e 62  sert( db->init.b
5070: 75 73 79 3d 3d 30 20 7c 7c 20 73 61 76 65 53 71  usy==0 || saveSq
5080: 6c 46 6c 61 67 3d 3d 30 20 29 3b 0a 20 20 69 66  lFlag==0 );.  if
5090: 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 3d  ( db->init.busy=
50a0: 3d 30 20 29 7b 0a 20 20 20 20 56 64 62 65 20 2a  =0 ){.    Vdbe *
50b0: 70 56 64 62 65 20 3d 20 73 50 61 72 73 65 2e 70  pVdbe = sParse.p
50c0: 56 64 62 65 3b 0a 20 20 20 20 73 71 6c 69 74 65  Vdbe;.    sqlite
50d0: 33 56 64 62 65 53 65 74 53 71 6c 28 70 56 64 62  3VdbeSetSql(pVdb
50e0: 65 2c 20 7a 53 71 6c 2c 20 28 69 6e 74 29 28 73  e, zSql, (int)(s
50f0: 50 61 72 73 65 2e 7a 54 61 69 6c 2d 7a 53 71 6c  Parse.zTail-zSql
5100: 29 2c 20 73 61 76 65 53 71 6c 46 6c 61 67 29 3b  ), saveSqlFlag);
5110: 0a 20 20 7d 0a 20 20 69 66 28 20 73 50 61 72 73  .  }.  if( sPars
5120: 65 2e 70 56 64 62 65 20 26 26 20 28 72 63 21 3d  e.pVdbe && (rc!=
5130: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 64 62 2d  SQLITE_OK || db-
5140: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 29 20 29  >mallocFailed) )
5150: 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 56 64 62  {.    sqlite3Vdb
5160: 65 46 69 6e 61 6c 69 7a 65 28 73 50 61 72 73 65  eFinalize(sParse
5170: 2e 70 56 64 62 65 29 3b 0a 20 20 20 20 61 73 73  .pVdbe);.    ass
5180: 65 72 74 28 21 28 2a 70 70 53 74 6d 74 29 29 3b  ert(!(*ppStmt));
5190: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70  .  }else{.    *p
51a0: 70 53 74 6d 74 20 3d 20 28 73 71 6c 69 74 65 33  pStmt = (sqlite3
51b0: 5f 73 74 6d 74 2a 29 73 50 61 72 73 65 2e 70 56  _stmt*)sParse.pV
51c0: 64 62 65 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20  dbe;.  }..  if( 
51d0: 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 73  zErrMsg ){.    s
51e0: 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c 20  qlite3Error(db, 
51f0: 72 63 2c 20 22 25 73 22 2c 20 7a 45 72 72 4d 73  rc, "%s", zErrMs
5200: 67 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44  g);.    sqlite3D
5210: 62 46 72 65 65 28 64 62 2c 20 7a 45 72 72 4d 73  bFree(db, zErrMs
5220: 67 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20  g);.  }else{.   
5230: 20 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62   sqlite3Error(db
5240: 2c 20 72 63 2c 20 30 29 3b 0a 20 20 7d 0a 0a 20  , rc, 0);.  }.. 
5250: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69   rc = sqlite3Api
5260: 45 78 69 74 28 64 62 2c 20 72 63 29 3b 0a 20 20  Exit(db, rc);.  
5270: 61 73 73 65 72 74 28 20 28 72 63 26 64 62 2d 3e  assert( (rc&db->
5280: 65 72 72 4d 61 73 6b 29 3d 3d 72 63 20 29 3b 0a  errMask)==rc );.
5290: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 73    return rc;.}.s
52a0: 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65  tatic int sqlite
52b0: 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28  3LockAndPrepare(
52c0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  .  sqlite3 *db, 
52d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
52e0: 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e  Database handle.
52f0: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72   */.  const char
5300: 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20   *zSql,         
5310: 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64  /* UTF-8 encoded
5320: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20   SQL statement. 
5330: 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c  */.  int nBytes,
5340: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5350: 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c  * Length of zSql
5360: 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20   in bytes. */.  
5370: 69 6e 74 20 73 61 76 65 53 71 6c 46 6c 61 67 2c  int saveSqlFlag,
5380: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75            /* Tru
5390: 65 20 74 6f 20 63 6f 70 79 20 53 51 4c 20 74 65  e to copy SQL te
53a0: 78 74 20 69 6e 74 6f 20 74 68 65 20 73 71 6c 69  xt into the sqli
53b0: 74 65 33 5f 73 74 6d 74 20 2a 2f 0a 20 20 73 71  te3_stmt */.  sq
53c0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53  lite3_stmt **ppS
53d0: 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20  tmt,    /* OUT: 
53e0: 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  A pointer to the
53f0: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
5400: 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  ent */.  const c
5410: 68 61 72 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20  har **pzTail    
5420: 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f     /* OUT: End o
5430: 66 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20  f parsed string 
5440: 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  */.){.  int rc;.
5450: 20 20 61 73 73 65 72 74 28 20 70 70 53 74 6d 74    assert( ppStmt
5460: 21 3d 30 20 29 3b 0a 20 20 2a 70 70 53 74 6d 74  !=0 );.  *ppStmt
5470: 20 3d 20 30 3b 0a 20 20 69 66 28 20 21 73 71 6c   = 0;.  if( !sql
5480: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f  ite3SafetyCheckO
5490: 6b 28 64 62 29 20 29 7b 0a 20 20 20 20 72 65 74  k(db) ){.    ret
54a0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53  urn SQLITE_MISUS
54b0: 45 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33  E;.  }.  sqlite3
54c0: 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d  _mutex_enter(db-
54d0: 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c 69 74  >mutex);.  sqlit
54e0: 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c 6c 28  e3BtreeEnterAll(
54f0: 64 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69  db);.  rc = sqli
5500: 74 65 33 50 72 65 70 61 72 65 28 64 62 2c 20 7a  te3Prepare(db, z
5510: 53 71 6c 2c 20 6e 42 79 74 65 73 2c 20 73 61 76  Sql, nBytes, sav
5520: 65 53 71 6c 46 6c 61 67 2c 20 70 70 53 74 6d 74  eSqlFlag, ppStmt
5530: 2c 20 70 7a 54 61 69 6c 29 3b 0a 20 20 73 71 6c  , pzTail);.  sql
5540: 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 41 6c  ite3BtreeLeaveAl
5550: 6c 28 64 62 29 3b 0a 20 20 73 71 6c 69 74 65 33  l(db);.  sqlite3
5560: 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d  _mutex_leave(db-
5570: 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72  >mutex);.  retur
5580: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 52  n rc;.}../*.** R
5590: 65 72 75 6e 20 74 68 65 20 63 6f 6d 70 69 6c 61  erun the compila
55a0: 74 69 6f 6e 20 6f 66 20 61 20 73 74 61 74 65 6d  tion of a statem
55b0: 65 6e 74 20 61 66 74 65 72 20 61 20 73 63 68 65  ent after a sche
55c0: 6d 61 20 63 68 61 6e 67 65 2e 0a 2a 2a 0a 2a 2a  ma change..**.**
55d0: 20 49 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e   If the statemen
55e0: 74 20 69 73 20 73 75 63 63 65 73 73 66 75 6c 6c  t is successfull
55f0: 79 20 72 65 63 6f 6d 70 69 6c 65 64 2c 20 72 65  y recompiled, re
5600: 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20  turn SQLITE_OK. 
5610: 4f 74 68 65 72 77 69 73 65 2c 0a 2a 2a 20 69 66  Otherwise,.** if
5620: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 63   the statement c
5630: 61 6e 6e 6f 74 20 62 65 20 72 65 63 6f 6d 70 69  annot be recompi
5640: 6c 65 64 20 62 65 63 61 75 73 65 20 61 6e 6f 74  led because anot
5650: 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68  her connection h
5660: 61 73 0a 2a 2a 20 6c 6f 63 6b 65 64 20 74 68 65  as.** locked the
5670: 20 73 71 6c 69 74 65 33 5f 6d 61 73 74 65 72 20   sqlite3_master 
5680: 74 61 62 6c 65 2c 20 72 65 74 75 72 6e 20 53 51  table, return SQ
5690: 4c 49 54 45 5f 4c 4f 43 4b 45 44 2e 20 49 66 20  LITE_LOCKED. If 
56a0: 61 6e 79 20 6f 74 68 65 72 20 65 72 72 6f 72 0a  any other error.
56b0: 2a 2a 20 6f 63 63 75 72 73 2c 20 72 65 74 75 72  ** occurs, retur
56c0: 6e 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 2e  n SQLITE_SCHEMA.
56d0: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 52  .*/.int sqlite3R
56e0: 65 70 72 65 70 61 72 65 28 56 64 62 65 20 2a 70  eprepare(Vdbe *p
56f0: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73  ){.  int rc;.  s
5700: 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 4e 65  qlite3_stmt *pNe
5710: 77 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20  w;.  const char 
5720: 2a 7a 53 71 6c 3b 0a 20 20 73 71 6c 69 74 65 33  *zSql;.  sqlite3
5730: 20 2a 64 62 3b 0a 0a 20 20 61 73 73 65 72 74 28   *db;..  assert(
5740: 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68   sqlite3_mutex_h
5750: 65 6c 64 28 73 71 6c 69 74 65 33 56 64 62 65 44  eld(sqlite3VdbeD
5760: 62 28 70 29 2d 3e 6d 75 74 65 78 29 20 29 3b 0a  b(p)->mutex) );.
5770: 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74 65 33    zSql = sqlite3
5780: 5f 73 71 6c 28 28 73 71 6c 69 74 65 33 5f 73 74  _sql((sqlite3_st
5790: 6d 74 20 2a 29 70 29 3b 0a 20 20 61 73 73 65 72  mt *)p);.  asser
57a0: 74 28 20 7a 53 71 6c 21 3d 30 20 29 3b 20 20 2f  t( zSql!=0 );  /
57b0: 2a 20 52 65 70 72 65 70 61 72 65 20 6f 6e 6c 79  * Reprepare only
57c0: 20 63 61 6c 6c 65 64 20 66 6f 72 20 70 72 65 70   called for prep
57d0: 61 72 65 5f 76 32 28 29 20 73 74 61 74 65 6d 65  are_v2() stateme
57e0: 6e 74 73 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71  nts */.  db = sq
57f0: 6c 69 74 65 33 56 64 62 65 44 62 28 70 29 3b 0a  lite3VdbeDb(p);.
5800: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
5810: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d  3_mutex_held(db-
5820: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 72 63 20  >mutex) );.  rc 
5830: 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64  = sqlite3LockAnd
5840: 50 72 65 70 61 72 65 28 64 62 2c 20 7a 53 71 6c  Prepare(db, zSql
5850: 2c 20 2d 31 2c 20 30 2c 20 26 70 4e 65 77 2c 20  , -1, 0, &pNew, 
5860: 30 29 3b 0a 20 20 69 66 28 20 72 63 20 29 7b 0a  0);.  if( rc ){.
5870: 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49      if( rc==SQLI
5880: 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20  TE_NOMEM ){.    
5890: 20 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c    db->mallocFail
58a0: 65 64 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20  ed = 1;.    }.  
58b0: 20 20 61 73 73 65 72 74 28 20 70 4e 65 77 3d 3d    assert( pNew==
58c0: 30 20 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 );.    return 
58d0: 28 72 63 3d 3d 53 51 4c 49 54 45 5f 4c 4f 43 4b  (rc==SQLITE_LOCK
58e0: 45 44 29 20 3f 20 53 51 4c 49 54 45 5f 4c 4f 43  ED) ? SQLITE_LOC
58f0: 4b 45 44 20 3a 20 53 51 4c 49 54 45 5f 53 43 48  KED : SQLITE_SCH
5900: 45 4d 41 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20  EMA;.  }else{.  
5910: 20 20 61 73 73 65 72 74 28 20 70 4e 65 77 21 3d    assert( pNew!=
5920: 30 20 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74  0 );.  }.  sqlit
5930: 65 33 56 64 62 65 53 77 61 70 28 28 56 64 62 65  e3VdbeSwap((Vdbe
5940: 2a 29 70 4e 65 77 2c 20 70 29 3b 0a 20 20 73 71  *)pNew, p);.  sq
5950: 6c 69 74 65 33 54 72 61 6e 73 66 65 72 42 69 6e  lite3TransferBin
5960: 64 69 6e 67 73 28 70 4e 65 77 2c 20 28 73 71 6c  dings(pNew, (sql
5970: 69 74 65 33 5f 73 74 6d 74 2a 29 70 29 3b 0a 20  ite3_stmt*)p);. 
5980: 20 73 71 6c 69 74 65 33 56 64 62 65 52 65 73 65   sqlite3VdbeRese
5990: 74 53 74 65 70 52 65 73 75 6c 74 28 28 56 64 62  tStepResult((Vdb
59a0: 65 2a 29 70 4e 65 77 29 3b 0a 20 20 73 71 6c 69  e*)pNew);.  sqli
59b0: 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a 65 28  te3VdbeFinalize(
59c0: 28 56 64 62 65 2a 29 70 4e 65 77 29 3b 0a 20 20  (Vdbe*)pNew);.  
59d0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b  return SQLITE_OK
59e0: 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 77 6f 20  ;.}.../*.** Two 
59f0: 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20  versions of the 
5a00: 6f 66 66 69 63 69 61 6c 20 41 50 49 2e 20 20 4c  official API.  L
5a10: 65 67 61 63 79 20 61 6e 64 20 6e 65 77 20 75 73  egacy and new us
5a20: 65 2e 20 20 49 6e 20 74 68 65 20 6c 65 67 61 63  e.  In the legac
5a30: 79 0a 2a 2a 20 76 65 72 73 69 6f 6e 2c 20 74 68  y.** version, th
5a40: 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 20 74  e original SQL t
5a50: 65 78 74 20 69 73 20 6e 6f 74 20 73 61 76 65 64  ext is not saved
5a60: 20 69 6e 20 74 68 65 20 70 72 65 70 61 72 65 64   in the prepared
5a70: 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 61 6e   statement.** an
5a80: 64 20 73 6f 20 69 66 20 61 20 73 63 68 65 6d 61  d so if a schema
5a90: 20 63 68 61 6e 67 65 20 6f 63 63 75 72 73 2c 20   change occurs, 
5aa0: 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 69 73  SQLITE_SCHEMA is
5ab0: 20 72 65 74 75 72 6e 65 64 20 62 79 0a 2a 2a 20   returned by.** 
5ac0: 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 2e 20  sqlite3_step(). 
5ad0: 20 49 6e 20 74 68 65 20 6e 65 77 20 76 65 72 73   In the new vers
5ae0: 69 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69 6e 61  ion, the origina
5af0: 6c 20 53 51 4c 20 74 65 78 74 20 69 73 20 72 65  l SQL text is re
5b00: 74 61 69 6e 65 64 0a 2a 2a 20 61 6e 64 20 74 68  tained.** and th
5b10: 65 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 61  e statement is a
5b20: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 65 63  utomatically rec
5b30: 6f 6d 70 69 6c 65 64 20 69 66 20 61 6e 20 73 63  ompiled if an sc
5b40: 68 65 6d 61 20 63 68 61 6e 67 65 0a 2a 2a 20 6f  hema change.** o
5b50: 63 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71  ccurs..*/.int sq
5b60: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 0a 20  lite3_prepare(. 
5b70: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20   sqlite3 *db,   
5b80: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61             /* Da
5b90: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a  tabase handle. *
5ba0: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  /.  const char *
5bb0: 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a  zSql,         /*
5bc0: 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53   UTF-8 encoded S
5bd0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f  QL statement. */
5be0: 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20  .  int nBytes,  
5bf0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5c00: 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69  Length of zSql i
5c10: 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 73 71  n bytes. */.  sq
5c20: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53  lite3_stmt **ppS
5c30: 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20  tmt,    /* OUT: 
5c40: 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65  A pointer to the
5c50: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
5c60: 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63  ent */.  const c
5c70: 68 61 72 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20  har **pzTail    
5c80: 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f     /* OUT: End o
5c90: 66 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20  f parsed string 
5ca0: 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a  */.){.  int rc;.
5cb0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f    rc = sqlite3Lo
5cc0: 63 6b 41 6e 64 50 72 65 70 61 72 65 28 64 62 2c  ckAndPrepare(db,
5cd0: 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 30 2c 70 70  zSql,nBytes,0,pp
5ce0: 53 74 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a 20 20  Stmt,pzTail);.  
5cf0: 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49  assert( rc==SQLI
5d00: 54 45 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d 74 3d  TE_OK || ppStmt=
5d10: 3d 30 20 7c 7c 20 2a 70 70 53 74 6d 74 3d 3d 30  =0 || *ppStmt==0
5d20: 20 29 3b 20 20 2f 2a 20 56 45 52 49 46 59 3a 20   );  /* VERIFY: 
5d30: 46 31 33 30 32 31 20 2a 2f 0a 20 20 72 65 74 75  F13021 */.  retu
5d40: 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c  rn rc;.}.int sql
5d50: 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76 32 28  ite3_prepare_v2(
5d60: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  .  sqlite3 *db, 
5d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
5d80: 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e  Database handle.
5d90: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72   */.  const char
5da0: 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20   *zSql,         
5db0: 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64  /* UTF-8 encoded
5dc0: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20   SQL statement. 
5dd0: 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c  */.  int nBytes,
5de0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
5df0: 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c  * Length of zSql
5e00: 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20   in bytes. */.  
5e10: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70  sqlite3_stmt **p
5e20: 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54  pStmt,    /* OUT
5e30: 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74  : A pointer to t
5e40: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74  he prepared stat
5e50: 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74  ement */.  const
5e60: 20 63 68 61 72 20 2a 2a 70 7a 54 61 69 6c 20 20   char **pzTail  
5e70: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64       /* OUT: End
5e80: 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 69 6e   of parsed strin
5e90: 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63  g */.){.  int rc
5ea0: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  ;.  rc = sqlite3
5eb0: 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28 64  LockAndPrepare(d
5ec0: 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 31 2c  b,zSql,nBytes,1,
5ed0: 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a  ppStmt,pzTail);.
5ee0: 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51    assert( rc==SQ
5ef0: 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d  LITE_OK || ppStm
5f00: 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d 74 3d  t==0 || *ppStmt=
5f10: 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52 49 46 59  =0 );  /* VERIFY
5f20: 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20 20 72 65  : F13021 */.  re
5f30: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 23 69 66  turn rc;.}...#if
5f40: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
5f50: 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 43 6f 6d  _UTF16./*.** Com
5f60: 70 69 6c 65 20 74 68 65 20 55 54 46 2d 31 36 20  pile the UTF-16 
5f70: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74  encoded SQL stat
5f80: 65 6d 65 6e 74 20 7a 53 71 6c 20 69 6e 74 6f 20  ement zSql into 
5f90: 61 20 73 74 61 74 65 6d 65 6e 74 20 68 61 6e 64  a statement hand
5fa0: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e  le..*/.static in
5fb0: 74 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65  t sqlite3Prepare
5fc0: 31 36 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64  16(.  sqlite3 *d
5fd0: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20  b,              
5fe0: 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64  /* Database hand
5ff0: 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e 73 74 20  le. */ .  const 
6000: 76 6f 69 64 20 2a 7a 53 71 6c 2c 20 20 20 20 20  void *zSql,     
6010: 20 20 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63      /* UTF-8 enc
6020: 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65  oded SQL stateme
6030: 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79  nt. */.  int nBy
6040: 74 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20  tes,            
6050: 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20     /* Length of 
6060: 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a  zSql in bytes. *
6070: 2f 0a 20 20 69 6e 74 20 73 61 76 65 53 71 6c 46  /.  int saveSqlF
6080: 6c 61 67 2c 20 20 20 20 20 20 20 20 20 20 2f 2a  lag,          /*
6090: 20 54 72 75 65 20 74 6f 20 73 61 76 65 20 53 51   True to save SQ
60a0: 4c 20 74 65 78 74 20 69 6e 74 6f 20 74 68 65 20  L text into the 
60b0: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2f 0a  sqlite3_stmt */.
60c0: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a    sqlite3_stmt *
60d0: 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f  *ppStmt,    /* O
60e0: 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f  UT: A pointer to
60f0: 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74   the prepared st
6100: 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e  atement */.  con
6110: 73 74 20 76 6f 69 64 20 2a 2a 70 7a 54 61 69 6c  st void **pzTail
6120: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45         /* OUT: E
6130: 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74 72  nd of parsed str
6140: 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 2f 2a 20 54  ing */.){.  /* T
6150: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 75 72  his function cur
6160: 72 65 6e 74 6c 79 20 77 6f 72 6b 73 20 62 79 20  rently works by 
6170: 66 69 72 73 74 20 74 72 61 6e 73 66 6f 72 6d 69  first transformi
6180: 6e 67 20 74 68 65 20 55 54 46 2d 31 36 0a 20 20  ng the UTF-16.  
6190: 2a 2a 20 65 6e 63 6f 64 65 64 20 73 74 72 69 6e  ** encoded strin
61a0: 67 20 74 6f 20 55 54 46 2d 38 2c 20 74 68 65 6e  g to UTF-8, then
61b0: 20 69 6e 76 6f 6b 69 6e 67 20 73 71 6c 69 74 65   invoking sqlite
61c0: 33 5f 70 72 65 70 61 72 65 28 29 2e 20 54 68 65  3_prepare(). The
61d0: 0a 20 20 2a 2a 20 74 72 69 63 6b 79 20 62 69 74  .  ** tricky bit
61e0: 20 69 73 20 66 69 67 75 72 69 6e 67 20 6f 75 74   is figuring out
61f0: 20 74 68 65 20 70 6f 69 6e 74 65 72 20 74 6f 20   the pointer to 
6200: 72 65 74 75 72 6e 20 69 6e 20 2a 70 7a 54 61 69  return in *pzTai
6210: 6c 2e 0a 20 20 2a 2f 0a 20 20 63 68 61 72 20 2a  l..  */.  char *
6220: 7a 53 71 6c 38 3b 0a 20 20 63 6f 6e 73 74 20 63  zSql8;.  const c
6230: 68 61 72 20 2a 7a 54 61 69 6c 38 20 3d 20 30 3b  har *zTail8 = 0;
6240: 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49  .  int rc = SQLI
6250: 54 45 5f 4f 4b 3b 0a 0a 20 20 61 73 73 65 72 74  TE_OK;..  assert
6260: 28 20 70 70 53 74 6d 74 20 29 3b 0a 20 20 2a 70  ( ppStmt );.  *p
6270: 70 53 74 6d 74 20 3d 20 30 3b 0a 20 20 69 66 28  pStmt = 0;.  if(
6280: 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 79 43   !sqlite3SafetyC
6290: 68 65 63 6b 4f 6b 28 64 62 29 20 29 7b 0a 20 20  heckOk(db) ){.  
62a0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
62b0: 4d 49 53 55 53 45 3b 0a 20 20 7d 0a 20 20 73 71  MISUSE;.  }.  sq
62c0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
62d0: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  r(db->mutex);.  
62e0: 7a 53 71 6c 38 20 3d 20 73 71 6c 69 74 65 33 55  zSql8 = sqlite3U
62f0: 74 66 31 36 74 6f 38 28 64 62 2c 20 7a 53 71 6c  tf16to8(db, zSql
6300: 2c 20 6e 42 79 74 65 73 29 3b 0a 20 20 69 66 28  , nBytes);.  if(
6310: 20 7a 53 71 6c 38 20 29 7b 0a 20 20 20 20 72 63   zSql8 ){.    rc
6320: 20 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e   = sqlite3LockAn
6330: 64 50 72 65 70 61 72 65 28 64 62 2c 20 7a 53 71  dPrepare(db, zSq
6340: 6c 38 2c 20 2d 31 2c 20 73 61 76 65 53 71 6c 46  l8, -1, saveSqlF
6350: 6c 61 67 2c 20 70 70 53 74 6d 74 2c 20 26 7a 54  lag, ppStmt, &zT
6360: 61 69 6c 38 29 3b 0a 20 20 7d 0a 0a 20 20 69 66  ail8);.  }..  if
6370: 28 20 7a 54 61 69 6c 38 20 26 26 20 70 7a 54 61  ( zTail8 && pzTa
6380: 69 6c 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66 20  il ){.    /* If 
6390: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 20  sqlite3_prepare 
63a0: 72 65 74 75 72 6e 73 20 61 20 74 61 69 6c 20 70  returns a tail p
63b0: 6f 69 6e 74 65 72 2c 20 77 65 20 63 61 6c 63 75  ointer, we calcu
63c0: 6c 61 74 65 20 74 68 65 0a 20 20 20 20 2a 2a 20  late the.    ** 
63d0: 65 71 75 69 76 61 6c 65 6e 74 20 70 6f 69 6e 74  equivalent point
63e0: 65 72 20 69 6e 74 6f 20 74 68 65 20 55 54 46 2d  er into the UTF-
63f0: 31 36 20 73 74 72 69 6e 67 20 62 79 20 63 6f 75  16 string by cou
6400: 6e 74 69 6e 67 20 74 68 65 20 75 6e 69 63 6f 64  nting the unicod
6410: 65 0a 20 20 20 20 2a 2a 20 63 68 61 72 61 63 74  e.    ** charact
6420: 65 72 73 20 62 65 74 77 65 65 6e 20 7a 53 71 6c  ers between zSql
6430: 38 20 61 6e 64 20 7a 54 61 69 6c 38 2c 20 61 6e  8 and zTail8, an
6440: 64 20 74 68 65 6e 20 72 65 74 75 72 6e 69 6e 67  d then returning
6450: 20 61 20 70 6f 69 6e 74 65 72 0a 20 20 20 20 2a   a pointer.    *
6460: 2a 20 74 68 65 20 73 61 6d 65 20 6e 75 6d 62 65  * the same numbe
6470: 72 20 6f 66 20 63 68 61 72 61 63 74 65 72 73 20  r of characters 
6480: 69 6e 74 6f 20 74 68 65 20 55 54 46 2d 31 36 20  into the UTF-16 
6490: 73 74 72 69 6e 67 2e 0a 20 20 20 20 2a 2f 0a 20  string..    */. 
64a0: 20 20 20 69 6e 74 20 63 68 61 72 73 5f 70 61 72     int chars_par
64b0: 73 65 64 20 3d 20 73 71 6c 69 74 65 33 55 74 66  sed = sqlite3Utf
64c0: 38 43 68 61 72 4c 65 6e 28 7a 53 71 6c 38 2c 20  8CharLen(zSql8, 
64d0: 28 69 6e 74 29 28 7a 54 61 69 6c 38 2d 7a 53 71  (int)(zTail8-zSq
64e0: 6c 38 29 29 3b 0a 20 20 20 20 2a 70 7a 54 61 69  l8));.    *pzTai
64f0: 6c 20 3d 20 28 75 38 20 2a 29 7a 53 71 6c 20 2b  l = (u8 *)zSql +
6500: 20 73 71 6c 69 74 65 33 55 74 66 31 36 42 79 74   sqlite3Utf16Byt
6510: 65 4c 65 6e 28 7a 53 71 6c 2c 20 63 68 61 72 73  eLen(zSql, chars
6520: 5f 70 61 72 73 65 64 29 3b 0a 20 20 7d 0a 20 20  _parsed);.  }.  
6530: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62  sqlite3DbFree(db
6540: 2c 20 7a 53 71 6c 38 29 3b 20 0a 20 20 72 63 20  , zSql8); .  rc 
6550: 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69 74  = sqlite3ApiExit
6560: 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c 69  (db, rc);.  sqli
6570: 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28  te3_mutex_leave(
6580: 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65  db->mutex);.  re
6590: 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a  turn rc;.}../*.*
65a0: 2a 20 54 77 6f 20 76 65 72 73 69 6f 6e 73 20 6f  * Two versions o
65b0: 66 20 74 68 65 20 6f 66 66 69 63 69 61 6c 20 41  f the official A
65c0: 50 49 2e 20 20 4c 65 67 61 63 79 20 61 6e 64 20  PI.  Legacy and 
65d0: 6e 65 77 20 75 73 65 2e 20 20 49 6e 20 74 68 65  new use.  In the
65e0: 20 6c 65 67 61 63 79 0a 2a 2a 20 76 65 72 73 69   legacy.** versi
65f0: 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69 6e 61 6c  on, the original
6600: 20 53 51 4c 20 74 65 78 74 20 69 73 20 6e 6f 74   SQL text is not
6610: 20 73 61 76 65 64 20 69 6e 20 74 68 65 20 70 72   saved in the pr
6620: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74  epared statement
6630: 0a 2a 2a 20 61 6e 64 20 73 6f 20 69 66 20 61 20  .** and so if a 
6640: 73 63 68 65 6d 61 20 63 68 61 6e 67 65 20 6f 63  schema change oc
6650: 63 75 72 73 2c 20 53 51 4c 49 54 45 5f 53 43 48  curs, SQLITE_SCH
6660: 45 4d 41 20 69 73 20 72 65 74 75 72 6e 65 64 20  EMA is returned 
6670: 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73 74  by.** sqlite3_st
6680: 65 70 28 29 2e 20 20 49 6e 20 74 68 65 20 6e 65  ep().  In the ne
6690: 77 20 76 65 72 73 69 6f 6e 2c 20 74 68 65 20 6f  w version, the o
66a0: 72 69 67 69 6e 61 6c 20 53 51 4c 20 74 65 78 74  riginal SQL text
66b0: 20 69 73 20 72 65 74 61 69 6e 65 64 0a 2a 2a 20   is retained.** 
66c0: 61 6e 64 20 74 68 65 20 73 74 61 74 65 6d 65 6e  and the statemen
66d0: 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c  t is automatical
66e0: 6c 79 20 72 65 63 6f 6d 70 69 6c 65 64 20 69 66  ly recompiled if
66f0: 20 61 6e 20 73 63 68 65 6d 61 20 63 68 61 6e 67   an schema chang
6700: 65 0a 2a 2a 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a  e.** occurs..*/.
6710: 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70  int sqlite3_prep
6720: 61 72 65 31 36 28 0a 20 20 73 71 6c 69 74 65 33  are16(.  sqlite3
6730: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20   *db,           
6740: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68     /* Database h
6750: 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e  andle. */ .  con
6760: 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c 20 20  st void *zSql,  
6770: 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 20         /* UTF-8 
6780: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74  encoded SQL stat
6790: 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20  ement. */.  int 
67a0: 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 20  nBytes,         
67b0: 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20        /* Length 
67c0: 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73  of zSql in bytes
67d0: 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73  . */.  sqlite3_s
67e0: 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20  tmt **ppStmt,   
67f0: 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74   /* OUT: A point
6800: 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61 72  er to the prepar
6810: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a  ed statement */.
6820: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70    const void **p
6830: 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f  zTail       /* O
6840: 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65  UT: End of parse
6850: 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20  d string */.){. 
6860: 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20 3d 20   int rc;.  rc = 
6870: 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 31 36  sqlite3Prepare16
6880: 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c  (db,zSql,nBytes,
6890: 30 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29  0,ppStmt,pzTail)
68a0: 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d  ;.  assert( rc==
68b0: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53  SQLITE_OK || ppS
68c0: 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d  tmt==0 || *ppStm
68d0: 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52 49  t==0 );  /* VERI
68e0: 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20 20  FY: F13021 */.  
68f0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74  return rc;.}.int
6900: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
6910: 31 36 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 33  16_v2(.  sqlite3
6920: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20   *db,           
6930: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68     /* Database h
6940: 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e  andle. */ .  con
6950: 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c 20 20  st void *zSql,  
6960: 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 20         /* UTF-8 
6970: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74  encoded SQL stat
6980: 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20  ement. */.  int 
6990: 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 20  nBytes,         
69a0: 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20        /* Length 
69b0: 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73  of zSql in bytes
69c0: 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73  . */.  sqlite3_s
69d0: 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20  tmt **ppStmt,   
69e0: 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74   /* OUT: A point
69f0: 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61 72  er to the prepar
6a00: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a  ed statement */.
6a10: 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70    const void **p
6a20: 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f  zTail       /* O
6a30: 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65  UT: End of parse
6a40: 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20  d string */.){. 
6a50: 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20 3d 20   int rc;.  rc = 
6a60: 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 31 36  sqlite3Prepare16
6a70: 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c  (db,zSql,nBytes,
6a80: 31 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29  1,ppStmt,pzTail)
6a90: 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d  ;.  assert( rc==
6aa0: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53  SQLITE_OK || ppS
6ab0: 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d  tmt==0 || *ppStm
6ac0: 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52 49  t==0 );  /* VERI
6ad0: 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20 20  FY: F13021 */.  
6ae0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 65  return rc;.}..#e
6af0: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f  ndif /* SQLITE_O
6b00: 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a           MIT_UTF16 */.