/ Hex Artifact Content
Login

Artifact 3948e3567324a2167dec1fbc98f2f726ebd1e43105d2ef2777875c4191dd0ff4:


0000: 2f 2a 0a 2a 2a 20 32 30 30 35 20 4d 61 79 20 32  /*.** 2005 May 2
0010: 35 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68  5.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70  or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73  yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20  ource code.  In 
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65  place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65  gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a   is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75  **.**    May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74   do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79   evil..**    May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76   you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65  eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f  lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79  thers..**    May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c   you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20  y, never taking 
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69  more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ve..**.*********
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a  ****************
0170: 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63 6f  .** This file co
0180: 6e 74 61 69 6e 73 20 74 68 65 20 69 6d 70 6c 65  ntains the imple
0190: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65  mentation of the
01a0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
01b0: 28 29 0a 2a 2a 20 69 6e 74 65 72 66 61 63 65 2c  ().** interface,
01c0: 20 61 6e 64 20 72 6f 75 74 69 6e 65 73 20 74 68   and routines th
01d0: 61 74 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f  at contribute to
01e0: 20 6c 6f 61 64 69 6e 67 20 74 68 65 20 64 61 74   loading the dat
01f0: 61 62 61 73 65 20 73 63 68 65 6d 61 0a 2a 2a 20  abase schema.** 
0200: 66 72 6f 6d 20 64 69 73 6b 2e 0a 2a 2f 0a 23 69  from disk..*/.#i
0210: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e  nclude "sqliteIn
0220: 74 2e 68 22 0a 23 69 66 64 65 66 20 53 51 4c 49  t.h".#ifdef SQLI
0230: 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 52 52 0a  TE_ENABLE_SQLRR.
0240: 23 20 69 6e 63 6c 75 64 65 20 22 73 71 6c 72 72  # include "sqlrr
0250: 2e 68 22 0a 23 65 6e 64 69 66 0a 0a 2f 2a 0a 2a  .h".#endif../*.*
0260: 2a 20 46 69 6c 6c 20 74 68 65 20 49 6e 69 74 44  * Fill the InitD
0270: 61 74 61 20 73 74 72 75 63 74 75 72 65 20 77 69  ata structure wi
0280: 74 68 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73  th an error mess
0290: 61 67 65 20 74 68 61 74 20 69 6e 64 69 63 61 74  age that indicat
02a0: 65 73 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 64  es.** that the d
02b0: 61 74 61 62 61 73 65 20 69 73 20 63 6f 72 72 75  atabase is corru
02c0: 70 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f  pt..*/.static vo
02d0: 69 64 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61  id corruptSchema
02e0: 28 0a 20 20 49 6e 69 74 44 61 74 61 20 2a 70 44  (.  InitData *pD
02f0: 61 74 61 2c 20 20 20 20 20 2f 2a 20 49 6e 69 74  ata,     /* Init
0300: 69 61 6c 69 7a 61 74 69 6f 6e 20 63 6f 6e 74 65  ialization conte
0310: 78 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68  xt */.  const ch
0320: 61 72 20 2a 7a 4f 62 6a 2c 20 20 20 20 2f 2a 20  ar *zObj,    /* 
0330: 4f 62 6a 65 63 74 20 62 65 69 6e 67 20 70 61 72  Object being par
0340: 73 65 64 20 61 74 20 74 68 65 20 70 6f 69 6e 74  sed at the point
0350: 20 6f 66 20 65 72 72 6f 72 20 2a 2f 0a 20 20 63   of error */.  c
0360: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 78 74 72  onst char *zExtr
0370: 61 20 20 20 2f 2a 20 45 72 72 6f 72 20 69 6e 66  a   /* Error inf
0380: 6f 72 6d 61 74 69 6f 6e 20 2a 2f 0a 29 7b 0a 20  ormation */.){. 
0390: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70   sqlite3 *db = p
03a0: 44 61 74 61 2d 3e 64 62 3b 0a 20 20 69 66 28 20  Data->db;.  if( 
03b0: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64  db->mallocFailed
03c0: 20 29 7b 0a 20 20 20 20 70 44 61 74 61 2d 3e 72   ){.    pData->r
03d0: 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d  c = SQLITE_NOMEM
03e0: 5f 42 4b 50 54 3b 0a 20 20 7d 65 6c 73 65 20 69  _BKPT;.  }else i
03f0: 66 28 20 70 44 61 74 61 2d 3e 70 7a 45 72 72 4d  f( pData->pzErrM
0400: 73 67 5b 30 5d 21 3d 30 20 29 7b 0a 20 20 20 20  sg[0]!=0 ){.    
0410: 2f 2a 20 41 20 65 72 72 6f 72 20 6d 65 73 73 61  /* A error messa
0420: 67 65 20 68 61 73 20 61 6c 72 65 61 64 79 20 62  ge has already b
0430: 65 65 6e 20 67 65 6e 65 72 61 74 65 64 2e 20 20  een generated.  
0440: 44 6f 20 6e 6f 74 20 6f 76 65 72 77 72 69 74 65  Do not overwrite
0450: 20 69 74 20 2a 2f 0a 20 20 7d 65 6c 73 65 20 69   it */.  }else i
0460: 66 28 20 70 44 61 74 61 2d 3e 6d 49 6e 69 74 46  f( pData->mInitF
0470: 6c 61 67 73 20 26 20 49 4e 49 54 46 4c 41 47 5f  lags & INITFLAG_
0480: 41 6c 74 65 72 54 61 62 6c 65 20 29 7b 0a 20 20  AlterTable ){.  
0490: 20 20 2a 70 44 61 74 61 2d 3e 70 7a 45 72 72 4d    *pData->pzErrM
04a0: 73 67 20 3d 20 73 71 6c 69 74 65 33 44 62 53 74  sg = sqlite3DbSt
04b0: 72 44 75 70 28 64 62 2c 20 7a 45 78 74 72 61 29  rDup(db, zExtra)
04c0: 3b 0a 20 20 20 20 70 44 61 74 61 2d 3e 72 63 20  ;.    pData->rc 
04d0: 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a  = SQLITE_ERROR;.
04e0: 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d 3e    }else if( db->
04f0: 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 57  flags & SQLITE_W
0500: 72 69 74 65 53 63 68 65 6d 61 20 29 7b 0a 20 20  riteSchema ){.  
0510: 20 20 70 44 61 74 61 2d 3e 72 63 20 3d 20 53 51    pData->rc = SQ
0520: 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b 50  LITE_CORRUPT_BKP
0530: 54 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20  T;.  }else{.    
0540: 63 68 61 72 20 2a 7a 3b 0a 20 20 20 20 69 66 28  char *z;.    if(
0550: 20 7a 4f 62 6a 3d 3d 30 20 29 20 7a 4f 62 6a 20   zObj==0 ) zObj 
0560: 3d 20 22 3f 22 3b 0a 20 20 20 20 7a 20 3d 20 73  = "?";.    z = s
0570: 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62  qlite3MPrintf(db
0580: 2c 20 22 6d 61 6c 66 6f 72 6d 65 64 20 64 61 74  , "malformed dat
0590: 61 62 61 73 65 20 73 63 68 65 6d 61 20 28 25 73  abase schema (%s
05a0: 29 22 2c 20 7a 4f 62 6a 29 3b 0a 20 20 20 20 69  )", zObj);.    i
05b0: 66 28 20 7a 45 78 74 72 61 20 26 26 20 7a 45 78  f( zExtra && zEx
05c0: 74 72 61 5b 30 5d 20 29 20 7a 20 3d 20 73 71 6c  tra[0] ) z = sql
05d0: 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62 2c 20  ite3MPrintf(db, 
05e0: 22 25 7a 20 2d 20 25 73 22 2c 20 7a 2c 20 7a 45  "%z - %s", z, zE
05f0: 78 74 72 61 29 3b 0a 20 20 20 20 2a 70 44 61 74  xtra);.    *pDat
0600: 61 2d 3e 70 7a 45 72 72 4d 73 67 20 3d 20 7a 3b  a->pzErrMsg = z;
0610: 0a 20 20 20 20 70 44 61 74 61 2d 3e 72 63 20 3d  .    pData->rc =
0620: 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f   SQLITE_CORRUPT_
0630: 42 4b 50 54 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a 0a  BKPT;.  }.}../*.
0640: 2a 2a 20 54 68 69 73 20 69 73 20 74 68 65 20 63  ** This is the c
0650: 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 6e 65 20  allback routine 
0660: 66 6f 72 20 74 68 65 20 63 6f 64 65 20 74 68 61  for the code tha
0670: 74 20 69 6e 69 74 69 61 6c 69 7a 65 73 20 74 68  t initializes th
0680: 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 20  e.** database.  
0690: 53 65 65 20 73 71 6c 69 74 65 33 49 6e 69 74 28  See sqlite3Init(
06a0: 29 20 62 65 6c 6f 77 20 66 6f 72 20 61 64 64 69  ) below for addi
06b0: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
06c0: 6f 6e 2e 0a 2a 2a 20 54 68 69 73 20 72 6f 75 74  on..** This rout
06d0: 69 6e 65 20 69 73 20 61 6c 73 6f 20 63 61 6c 6c  ine is also call
06e0: 65 64 20 66 72 6f 6d 20 74 68 65 20 4f 50 5f 50  ed from the OP_P
06f0: 61 72 73 65 53 63 68 65 6d 61 20 6f 70 63 6f 64  arseSchema opcod
0700: 65 20 6f 66 20 74 68 65 20 56 44 42 45 2e 0a 2a  e of the VDBE..*
0710: 2a 0a 2a 2a 20 45 61 63 68 20 63 61 6c 6c 62 61  *.** Each callba
0720: 63 6b 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20  ck contains the 
0730: 66 6f 6c 6c 6f 77 69 6e 67 20 69 6e 66 6f 72 6d  following inform
0740: 61 74 69 6f 6e 3a 0a 2a 2a 0a 2a 2a 20 20 20 20  ation:.**.**    
0750: 20 61 72 67 76 5b 30 5d 20 3d 20 6e 61 6d 65 20   argv[0] = name 
0760: 6f 66 20 74 68 69 6e 67 20 62 65 69 6e 67 20 63  of thing being c
0770: 72 65 61 74 65 64 0a 2a 2a 20 20 20 20 20 61 72  reated.**     ar
0780: 67 76 5b 31 5d 20 3d 20 72 6f 6f 74 20 70 61 67  gv[1] = root pag
0790: 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 61 62  e number for tab
07a0: 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 30 20 66  le or index. 0 f
07b0: 6f 72 20 74 72 69 67 67 65 72 20 6f 72 20 76 69  or trigger or vi
07c0: 65 77 2e 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b  ew..**     argv[
07d0: 32 5d 20 3d 20 53 51 4c 20 74 65 78 74 20 66 6f  2] = SQL text fo
07e0: 72 20 74 68 65 20 43 52 45 41 54 45 20 73 74 61  r the CREATE sta
07f0: 74 65 6d 65 6e 74 2e 0a 2a 2a 0a 2a 2f 0a 69 6e  tement..**.*/.in
0800: 74 20 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c  t sqlite3InitCal
0810: 6c 62 61 63 6b 28 76 6f 69 64 20 2a 70 49 6e 69  lback(void *pIni
0820: 74 2c 20 69 6e 74 20 61 72 67 63 2c 20 63 68 61  t, int argc, cha
0830: 72 20 2a 2a 61 72 67 76 2c 20 63 68 61 72 20 2a  r **argv, char *
0840: 2a 4e 6f 74 55 73 65 64 29 7b 0a 20 20 49 6e 69  *NotUsed){.  Ini
0850: 74 44 61 74 61 20 2a 70 44 61 74 61 20 3d 20 28  tData *pData = (
0860: 49 6e 69 74 44 61 74 61 2a 29 70 49 6e 69 74 3b  InitData*)pInit;
0870: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d  .  sqlite3 *db =
0880: 20 70 44 61 74 61 2d 3e 64 62 3b 0a 20 20 69 6e   pData->db;.  in
0890: 74 20 69 44 62 20 3d 20 70 44 61 74 61 2d 3e 69  t iDb = pData->i
08a0: 44 62 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 61  Db;..  assert( a
08b0: 72 67 63 3d 3d 33 20 29 3b 0a 20 20 55 4e 55 53  rgc==3 );.  UNUS
08c0: 45 44 5f 50 41 52 41 4d 45 54 45 52 32 28 4e 6f  ED_PARAMETER2(No
08d0: 74 55 73 65 64 2c 20 61 72 67 63 29 3b 0a 20 20  tUsed, argc);.  
08e0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
08f0: 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d  mutex_held(db->m
0900: 75 74 65 78 29 20 29 3b 0a 20 20 44 62 43 6c 65  utex) );.  DbCle
0910: 61 72 50 72 6f 70 65 72 74 79 28 64 62 2c 20 69  arProperty(db, i
0920: 44 62 2c 20 44 42 5f 45 6d 70 74 79 29 3b 0a 20  Db, DB_Empty);. 
0930: 20 70 44 61 74 61 2d 3e 6e 49 6e 69 74 52 6f 77   pData->nInitRow
0940: 2b 2b 3b 0a 20 20 69 66 28 20 64 62 2d 3e 6d 61  ++;.  if( db->ma
0950: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 20  llocFailed ){.  
0960: 20 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28    corruptSchema(
0970: 70 44 61 74 61 2c 20 61 72 67 76 5b 30 5d 2c 20  pData, argv[0], 
0980: 30 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 31  0);.    return 1
0990: 3b 0a 20 20 7d 0a 0a 20 20 61 73 73 65 72 74 28  ;.  }..  assert(
09a0: 20 69 44 62 3e 3d 30 20 26 26 20 69 44 62 3c 64   iDb>=0 && iDb<d
09b0: 62 2d 3e 6e 44 62 20 29 3b 0a 20 20 69 66 28 20  b->nDb );.  if( 
09c0: 61 72 67 76 3d 3d 30 20 29 20 72 65 74 75 72 6e  argv==0 ) return
09d0: 20 30 3b 20 20 20 2f 2a 20 4d 69 67 68 74 20 68   0;   /* Might h
09e0: 61 70 70 65 6e 20 69 66 20 45 4d 50 54 59 5f 52  appen if EMPTY_R
09f0: 45 53 55 4c 54 5f 43 41 4c 4c 42 41 43 4b 53 20  ESULT_CALLBACKS 
0a00: 61 72 65 20 6f 6e 20 2a 2f 0a 20 20 69 66 28 20  are on */.  if( 
0a10: 61 72 67 76 5b 31 5d 3d 3d 30 20 29 7b 0a 20 20  argv[1]==0 ){.  
0a20: 20 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 28    corruptSchema(
0a30: 70 44 61 74 61 2c 20 61 72 67 76 5b 30 5d 2c 20  pData, argv[0], 
0a40: 30 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  0);.  }else if( 
0a50: 73 71 6c 69 74 65 33 5f 73 74 72 6e 69 63 6d 70  sqlite3_strnicmp
0a60: 28 61 72 67 76 5b 32 5d 2c 22 63 72 65 61 74 65  (argv[2],"create
0a70: 20 22 2c 37 29 3d 3d 30 20 29 7b 0a 20 20 20 20   ",7)==0 ){.    
0a80: 2f 2a 20 43 61 6c 6c 20 74 68 65 20 70 61 72 73  /* Call the pars
0a90: 65 72 20 74 6f 20 70 72 6f 63 65 73 73 20 61 20  er to process a 
0aa0: 43 52 45 41 54 45 20 54 41 42 4c 45 2c 20 49 4e  CREATE TABLE, IN
0ab0: 44 45 58 20 6f 72 20 56 49 45 57 2e 0a 20 20 20  DEX or VIEW..   
0ac0: 20 2a 2a 20 42 75 74 20 62 65 63 61 75 73 65 20   ** But because 
0ad0: 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 69 73  db->init.busy is
0ae0: 20 73 65 74 20 74 6f 20 31 2c 20 6e 6f 20 56 44   set to 1, no VD
0af0: 42 45 20 63 6f 64 65 20 69 73 20 67 65 6e 65 72  BE code is gener
0b00: 61 74 65 64 0a 20 20 20 20 2a 2a 20 6f 72 20 65  ated.    ** or e
0b10: 78 65 63 75 74 65 64 2e 20 20 41 6c 6c 20 74 68  xecuted.  All th
0b20: 65 20 70 61 72 73 65 72 20 64 6f 65 73 20 69 73  e parser does is
0b30: 20 62 75 69 6c 64 20 74 68 65 20 69 6e 74 65 72   build the inter
0b40: 6e 61 6c 20 64 61 74 61 0a 20 20 20 20 2a 2a 20  nal data.    ** 
0b50: 73 74 72 75 63 74 75 72 65 73 20 74 68 61 74 20  structures that 
0b60: 64 65 73 63 72 69 62 65 20 74 68 65 20 74 61 62  describe the tab
0b70: 6c 65 2c 20 69 6e 64 65 78 2c 20 6f 72 20 76 69  le, index, or vi
0b80: 65 77 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69  ew..    */.    i
0b90: 6e 74 20 72 63 3b 0a 20 20 20 20 75 38 20 73 61  nt rc;.    u8 sa
0ba0: 76 65 64 5f 69 44 62 20 3d 20 64 62 2d 3e 69 6e  ved_iDb = db->in
0bb0: 69 74 2e 69 44 62 3b 0a 20 20 20 20 73 71 6c 69  it.iDb;.    sqli
0bc0: 74 65 33 5f 73 74 6d 74 20 2a 70 53 74 6d 74 3b  te3_stmt *pStmt;
0bd0: 0a 20 20 20 20 54 45 53 54 4f 4e 4c 59 28 69 6e  .    TESTONLY(in
0be0: 74 20 72 63 70 29 3b 20 20 20 20 20 20 20 20 20  t rcp);         
0bf0: 20 20 20 2f 2a 20 52 65 74 75 72 6e 20 63 6f 64     /* Return cod
0c00: 65 20 66 72 6f 6d 20 73 71 6c 69 74 65 33 5f 70  e from sqlite3_p
0c10: 72 65 70 61 72 65 28 29 20 2a 2f 0a 0a 20 20 20  repare() */..   
0c20: 20 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e 69   assert( db->ini
0c30: 74 2e 62 75 73 79 20 29 3b 0a 20 20 20 20 64 62  t.busy );.    db
0c40: 2d 3e 69 6e 69 74 2e 69 44 62 20 3d 20 69 44 62  ->init.iDb = iDb
0c50: 3b 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 6e  ;.    db->init.n
0c60: 65 77 54 6e 75 6d 20 3d 20 73 71 6c 69 74 65 33  ewTnum = sqlite3
0c70: 41 74 6f 69 28 61 72 67 76 5b 31 5d 29 3b 0a 20  Atoi(argv[1]);. 
0c80: 20 20 20 64 62 2d 3e 69 6e 69 74 2e 6f 72 70 68     db->init.orph
0c90: 61 6e 54 72 69 67 67 65 72 20 3d 20 30 3b 0a 20  anTrigger = 0;. 
0ca0: 20 20 20 54 45 53 54 4f 4e 4c 59 28 72 63 70 20     TESTONLY(rcp 
0cb0: 3d 20 29 20 73 71 6c 69 74 65 33 5f 70 72 65 70  = ) sqlite3_prep
0cc0: 61 72 65 28 64 62 2c 20 61 72 67 76 5b 32 5d 2c  are(db, argv[2],
0cd0: 20 2d 31 2c 20 26 70 53 74 6d 74 2c 20 30 29 3b   -1, &pStmt, 0);
0ce0: 0a 20 20 20 20 72 63 20 3d 20 64 62 2d 3e 65 72  .    rc = db->er
0cf0: 72 43 6f 64 65 3b 0a 20 20 20 20 61 73 73 65 72  rCode;.    asser
0d00: 74 28 20 28 72 63 26 30 78 46 46 29 3d 3d 28 72  t( (rc&0xFF)==(r
0d10: 63 70 26 30 78 46 46 29 20 29 3b 0a 20 20 20 20  cp&0xFF) );.    
0d20: 64 62 2d 3e 69 6e 69 74 2e 69 44 62 20 3d 20 73  db->init.iDb = s
0d30: 61 76 65 64 5f 69 44 62 3b 0a 20 20 20 20 2f 2a  aved_iDb;.    /*
0d40: 20 61 73 73 65 72 74 28 20 73 61 76 65 64 5f 69   assert( saved_i
0d50: 44 62 3d 3d 30 20 7c 7c 20 28 64 62 2d 3e 6d 44  Db==0 || (db->mD
0d60: 62 46 6c 61 67 73 20 26 20 44 42 46 4c 41 47 5f  bFlags & DBFLAG_
0d70: 56 61 63 75 75 6d 29 21 3d 30 20 29 3b 20 2a 2f  Vacuum)!=0 ); */
0d80: 0a 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f  .    if( SQLITE_
0d90: 4f 4b 21 3d 72 63 20 29 7b 0a 20 20 20 20 20 20  OK!=rc ){.      
0da0: 69 66 28 20 64 62 2d 3e 69 6e 69 74 2e 6f 72 70  if( db->init.orp
0db0: 68 61 6e 54 72 69 67 67 65 72 20 29 7b 0a 20 20  hanTrigger ){.  
0dc0: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 69 44        assert( iD
0dd0: 62 3d 3d 31 20 29 3b 0a 20 20 20 20 20 20 7d 65  b==1 );.      }e
0de0: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 44 61  lse{.        pDa
0df0: 74 61 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20  ta->rc = rc;.   
0e00: 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c       if( rc==SQL
0e10: 49 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20  ITE_NOMEM ){.   
0e20: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 6f         sqlite3Oo
0e30: 6d 46 61 75 6c 74 28 64 62 29 3b 0a 20 20 20 20  mFault(db);.    
0e40: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 72 63      }else if( rc
0e50: 21 3d 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55  !=SQLITE_INTERRU
0e60: 50 54 20 26 26 20 28 72 63 26 30 78 46 46 29 21  PT && (rc&0xFF)!
0e70: 3d 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 20 29  =SQLITE_LOCKED )
0e80: 7b 0a 20 20 20 20 20 20 20 20 20 20 63 6f 72 72  {.          corr
0e90: 75 70 74 53 63 68 65 6d 61 28 70 44 61 74 61 2c  uptSchema(pData,
0ea0: 20 61 72 67 76 5b 30 5d 2c 20 73 71 6c 69 74 65   argv[0], sqlite
0eb0: 33 5f 65 72 72 6d 73 67 28 64 62 29 29 3b 0a 20  3_errmsg(db));. 
0ec0: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d         }.      }
0ed0: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74  .    }.    sqlit
0ee0: 65 33 5f 66 69 6e 61 6c 69 7a 65 28 70 53 74 6d  e3_finalize(pStm
0ef0: 74 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20  t);.  }else if( 
0f00: 61 72 67 76 5b 30 5d 3d 3d 30 20 7c 7c 20 28 61  argv[0]==0 || (a
0f10: 72 67 76 5b 32 5d 21 3d 30 20 26 26 20 61 72 67  rgv[2]!=0 && arg
0f20: 76 5b 32 5d 5b 30 5d 21 3d 30 29 20 29 7b 0a 20  v[2][0]!=0) ){. 
0f30: 20 20 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61     corruptSchema
0f40: 28 70 44 61 74 61 2c 20 61 72 67 76 5b 30 5d 2c  (pData, argv[0],
0f50: 20 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20   0);.  }else{.  
0f60: 20 20 2f 2a 20 49 66 20 74 68 65 20 53 51 4c 20    /* If the SQL 
0f70: 63 6f 6c 75 6d 6e 20 69 73 20 62 6c 61 6e 6b 20  column is blank 
0f80: 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20 69 73  it means this is
0f90: 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74 0a 20   an index that. 
0fa0: 20 20 20 2a 2a 20 77 61 73 20 63 72 65 61 74 65     ** was create
0fb0: 64 20 74 6f 20 62 65 20 74 68 65 20 50 52 49 4d  d to be the PRIM
0fc0: 41 52 59 20 4b 45 59 20 6f 72 20 74 6f 20 66 75  ARY KEY or to fu
0fd0: 6c 66 69 6c 6c 20 61 20 55 4e 49 51 55 45 0a 20  lfill a UNIQUE. 
0fe0: 20 20 20 2a 2a 20 63 6f 6e 73 74 72 61 69 6e 74     ** constraint
0ff0: 20 66 6f 72 20 61 20 43 52 45 41 54 45 20 54 41   for a CREATE TA
1000: 42 4c 45 2e 20 20 54 68 65 20 69 6e 64 65 78 20  BLE.  The index 
1010: 73 68 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65  should have alre
1020: 61 64 79 0a 20 20 20 20 2a 2a 20 62 65 65 6e 20  ady.    ** been 
1030: 63 72 65 61 74 65 64 20 77 68 65 6e 20 77 65 20  created when we 
1040: 70 72 6f 63 65 73 73 65 64 20 74 68 65 20 43 52  processed the CR
1050: 45 41 54 45 20 54 41 42 4c 45 2e 20 20 41 6c 6c  EATE TABLE.  All
1060: 20 77 65 20 68 61 76 65 0a 20 20 20 20 2a 2a 20   we have.    ** 
1070: 74 6f 20 64 6f 20 68 65 72 65 20 69 73 20 72 65  to do here is re
1080: 63 6f 72 64 20 74 68 65 20 72 6f 6f 74 20 70 61  cord the root pa
1090: 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68  ge number for th
10a0: 61 74 20 69 6e 64 65 78 2e 0a 20 20 20 20 2a 2f  at index..    */
10b0: 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 49 6e 64  .    Index *pInd
10c0: 65 78 3b 0a 20 20 20 20 70 49 6e 64 65 78 20 3d  ex;.    pIndex =
10d0: 20 73 71 6c 69 74 65 33 46 69 6e 64 49 6e 64 65   sqlite3FindInde
10e0: 78 28 64 62 2c 20 61 72 67 76 5b 30 5d 2c 20 64  x(db, argv[0], d
10f0: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 44 62 53  b->aDb[iDb].zDbS
1100: 4e 61 6d 65 29 3b 0a 20 20 20 20 69 66 28 20 70  Name);.    if( p
1110: 49 6e 64 65 78 3d 3d 30 0a 20 20 20 20 20 7c 7c  Index==0.     ||
1120: 20 73 71 6c 69 74 65 33 47 65 74 49 6e 74 33 32   sqlite3GetInt32
1130: 28 61 72 67 76 5b 31 5d 2c 26 70 49 6e 64 65 78  (argv[1],&pIndex
1140: 2d 3e 74 6e 75 6d 29 3d 3d 30 0a 20 20 20 20 20  ->tnum)==0.     
1150: 7c 7c 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d 3c  || pIndex->tnum<
1160: 32 0a 20 20 20 20 29 7b 0a 20 20 20 20 20 20 63  2.    ){.      c
1170: 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70 44 61  orruptSchema(pDa
1180: 74 61 2c 20 61 72 67 76 5b 30 5d 2c 20 70 49 6e  ta, argv[0], pIn
1190: 64 65 78 3f 22 69 6e 76 61 6c 69 64 20 72 6f 6f  dex?"invalid roo
11a0: 74 70 61 67 65 22 3a 22 6f 72 70 68 61 6e 20 69  tpage":"orphan i
11b0: 6e 64 65 78 22 29 3b 0a 20 20 20 20 7d 0a 20 20  ndex");.    }.  
11c0: 7d 0a 20 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a  }.  return 0;.}.
11d0: 0a 2f 2a 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74  ./*.** Attempt t
11e0: 6f 20 72 65 61 64 20 74 68 65 20 64 61 74 61 62  o read the datab
11f0: 61 73 65 20 73 63 68 65 6d 61 20 61 6e 64 20 69  ase schema and i
1200: 6e 69 74 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e  nitialize intern
1210: 61 6c 0a 2a 2a 20 64 61 74 61 20 73 74 72 75 63  al.** data struc
1220: 74 75 72 65 73 20 66 6f 72 20 61 20 73 69 6e 67  tures for a sing
1230: 6c 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  le database file
1240: 2e 20 20 54 68 65 20 69 6e 64 65 78 20 6f 66 20  .  The index of 
1250: 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 65 20  the.** database 
1260: 66 69 6c 65 20 69 73 20 67 69 76 65 6e 20 62 79  file is given by
1270: 20 69 44 62 2e 20 20 69 44 62 3d 3d 30 20 69 73   iDb.  iDb==0 is
1280: 20 75 73 65 64 20 66 6f 72 20 74 68 65 20 6d 61   used for the ma
1290: 69 6e 0a 2a 2a 20 64 61 74 61 62 61 73 65 2e 20  in.** database. 
12a0: 20 69 44 62 3d 3d 31 20 73 68 6f 75 6c 64 20 6e   iDb==1 should n
12b0: 65 76 65 72 20 62 65 20 75 73 65 64 2e 20 20 69  ever be used.  i
12c0: 44 62 3e 3d 32 20 69 73 20 75 73 65 64 20 66 6f  Db>=2 is used fo
12d0: 72 0a 2a 2a 20 61 75 78 69 6c 69 61 72 79 20 64  r.** auxiliary d
12e0: 61 74 61 62 61 73 65 73 2e 20 20 52 65 74 75 72  atabases.  Retur
12f0: 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 53 51 4c  n one of the SQL
1300: 49 54 45 5f 20 65 72 72 6f 72 20 63 6f 64 65 73  ITE_ error codes
1310: 20 74 6f 0a 2a 2a 20 69 6e 64 69 63 61 74 65 20   to.** indicate 
1320: 73 75 63 63 65 73 73 20 6f 72 20 66 61 69 6c 75  success or failu
1330: 72 65 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74  re..*/.int sqlit
1340: 65 33 49 6e 69 74 4f 6e 65 28 73 71 6c 69 74 65  e3InitOne(sqlite
1350: 33 20 2a 64 62 2c 20 69 6e 74 20 69 44 62 2c 20  3 *db, int iDb, 
1360: 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 2c  char **pzErrMsg,
1370: 20 75 33 32 20 6d 46 6c 61 67 73 29 7b 0a 20 20   u32 mFlags){.  
1380: 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 69 3b  int rc;.  int i;
1390: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
13a0: 4f 4d 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a  OMIT_DEPRECATED.
13b0: 20 20 69 6e 74 20 73 69 7a 65 3b 0a 23 65 6e 64    int size;.#end
13c0: 69 66 0a 20 20 44 62 20 2a 70 44 62 3b 0a 20 20  if.  Db *pDb;.  
13d0: 63 68 61 72 20 63 6f 6e 73 74 20 2a 61 7a 41 72  char const *azAr
13e0: 67 5b 34 5d 3b 0a 20 20 69 6e 74 20 6d 65 74 61  g[4];.  int meta
13f0: 5b 35 5d 3b 0a 20 20 49 6e 69 74 44 61 74 61 20  [5];.  InitData 
1400: 69 6e 69 74 44 61 74 61 3b 0a 20 20 63 6f 6e 73  initData;.  cons
1410: 74 20 63 68 61 72 20 2a 7a 4d 61 73 74 65 72 4e  t char *zMasterN
1420: 61 6d 65 3b 0a 20 20 69 6e 74 20 6f 70 65 6e 65  ame;.  int opene
1430: 64 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 30  dTransaction = 0
1440: 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 28 64 62  ;..  assert( (db
1450: 2d 3e 6d 44 62 46 6c 61 67 73 20 26 20 44 42 46  ->mDbFlags & DBF
1460: 4c 41 47 5f 53 63 68 65 6d 61 4b 6e 6f 77 6e 4f  LAG_SchemaKnownO
1470: 6b 29 3d 3d 30 20 29 3b 0a 20 20 61 73 73 65 72  k)==0 );.  asser
1480: 74 28 20 69 44 62 3e 3d 30 20 26 26 20 69 44 62  t( iDb>=0 && iDb
1490: 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20 20 61 73  <db->nDb );.  as
14a0: 73 65 72 74 28 20 64 62 2d 3e 61 44 62 5b 69 44  sert( db->aDb[iD
14b0: 62 5d 2e 70 53 63 68 65 6d 61 20 29 3b 0a 20 20  b].pSchema );.  
14c0: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f  assert( sqlite3_
14d0: 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d  mutex_held(db->m
14e0: 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72  utex) );.  asser
14f0: 74 28 20 69 44 62 3d 3d 31 20 7c 7c 20 73 71 6c  t( iDb==1 || sql
1500: 69 74 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75  ite3BtreeHoldsMu
1510: 74 65 78 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d  tex(db->aDb[iDb]
1520: 2e 70 42 74 29 20 29 3b 0a 0a 20 20 64 62 2d 3e  .pBt) );..  db->
1530: 69 6e 69 74 2e 62 75 73 79 20 3d 20 31 3b 0a 0a  init.busy = 1;..
1540: 20 20 2f 2a 20 43 6f 6e 73 74 72 75 63 74 20 74    /* Construct t
1550: 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 72 65 70  he in-memory rep
1560: 72 65 73 65 6e 74 61 74 69 6f 6e 20 73 63 68 65  resentation sche
1570: 6d 61 20 74 61 62 6c 65 73 20 28 73 71 6c 69 74  ma tables (sqlit
1580: 65 5f 6d 61 73 74 65 72 20 6f 72 0a 20 20 2a 2a  e_master or.  **
1590: 20 73 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73   sqlite_temp_mas
15a0: 74 65 72 29 20 62 79 20 69 6e 76 6f 6b 69 6e 67  ter) by invoking
15b0: 20 74 68 65 20 70 61 72 73 65 72 20 64 69 72 65   the parser dire
15c0: 63 74 6c 79 2e 20 20 54 68 65 20 61 70 70 72 6f  ctly.  The appro
15d0: 70 72 69 61 74 65 0a 20 20 2a 2a 20 74 61 62 6c  priate.  ** tabl
15e0: 65 20 6e 61 6d 65 20 77 69 6c 6c 20 62 65 20 69  e name will be i
15f0: 6e 73 65 72 74 65 64 20 61 75 74 6f 6d 61 74 69  nserted automati
1600: 63 61 6c 6c 79 20 62 79 20 74 68 65 20 70 61 72  cally by the par
1610: 73 65 72 20 73 6f 20 77 65 20 63 61 6e 20 6a 75  ser so we can ju
1620: 73 74 0a 20 20 2a 2a 20 75 73 65 20 74 68 65 20  st.  ** use the 
1630: 61 62 62 72 65 76 69 61 74 69 6f 6e 20 22 78 22  abbreviation "x"
1640: 20 68 65 72 65 2e 20 20 54 68 65 20 70 61 72 73   here.  The pars
1650: 65 72 20 77 69 6c 6c 20 61 6c 73 6f 20 61 75 74  er will also aut
1660: 6f 6d 61 74 69 63 61 6c 6c 79 20 74 61 67 0a 20  omatically tag. 
1670: 20 2a 2a 20 74 68 65 20 73 63 68 65 6d 61 20 74   ** the schema t
1680: 61 62 6c 65 20 61 73 20 72 65 61 64 2d 6f 6e 6c  able as read-onl
1690: 79 2e 20 2a 2f 0a 20 20 61 7a 41 72 67 5b 30 5d  y. */.  azArg[0]
16a0: 20 3d 20 7a 4d 61 73 74 65 72 4e 61 6d 65 20 3d   = zMasterName =
16b0: 20 53 43 48 45 4d 41 5f 54 41 42 4c 45 28 69 44   SCHEMA_TABLE(iD
16c0: 62 29 3b 0a 20 20 61 7a 41 72 67 5b 31 5d 20 3d  b);.  azArg[1] =
16d0: 20 22 31 22 3b 0a 20 20 61 7a 41 72 67 5b 32 5d   "1";.  azArg[2]
16e0: 20 3d 20 22 43 52 45 41 54 45 20 54 41 42 4c 45   = "CREATE TABLE
16f0: 20 78 28 74 79 70 65 20 74 65 78 74 2c 6e 61 6d   x(type text,nam
1700: 65 20 74 65 78 74 2c 74 62 6c 5f 6e 61 6d 65 20  e text,tbl_name 
1710: 74 65 78 74 2c 22 0a 20 20 20 20 20 20 20 20 20  text,".         
1720: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1730: 20 20 20 22 72 6f 6f 74 70 61 67 65 20 69 6e 74     "rootpage int
1740: 2c 73 71 6c 20 74 65 78 74 29 22 3b 0a 20 20 61  ,sql text)";.  a
1750: 7a 41 72 67 5b 33 5d 20 3d 20 30 3b 0a 20 20 69  zArg[3] = 0;.  i
1760: 6e 69 74 44 61 74 61 2e 64 62 20 3d 20 64 62 3b  nitData.db = db;
1770: 0a 20 20 69 6e 69 74 44 61 74 61 2e 69 44 62 20  .  initData.iDb 
1780: 3d 20 69 44 62 3b 0a 20 20 69 6e 69 74 44 61 74  = iDb;.  initDat
1790: 61 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b  a.rc = SQLITE_OK
17a0: 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e 70 7a 45  ;.  initData.pzE
17b0: 72 72 4d 73 67 20 3d 20 70 7a 45 72 72 4d 73 67  rrMsg = pzErrMsg
17c0: 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e 6d 49 6e  ;.  initData.mIn
17d0: 69 74 46 6c 61 67 73 20 3d 20 6d 46 6c 61 67 73  itFlags = mFlags
17e0: 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e 6e 49 6e  ;.  initData.nIn
17f0: 69 74 52 6f 77 20 3d 20 30 3b 0a 20 20 73 71 6c  itRow = 0;.  sql
1800: 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b  ite3InitCallback
1810: 28 26 69 6e 69 74 44 61 74 61 2c 20 33 2c 20 28  (&initData, 3, (
1820: 63 68 61 72 20 2a 2a 29 61 7a 41 72 67 2c 20 30  char **)azArg, 0
1830: 29 3b 0a 20 20 69 66 28 20 69 6e 69 74 44 61 74  );.  if( initDat
1840: 61 2e 72 63 20 29 7b 0a 20 20 20 20 72 63 20 3d  a.rc ){.    rc =
1850: 20 69 6e 69 74 44 61 74 61 2e 72 63 3b 0a 20 20   initData.rc;.  
1860: 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74    goto error_out
1870: 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 72 65 61  ;.  }..  /* Crea
1880: 74 65 20 61 20 63 75 72 73 6f 72 20 74 6f 20 68  te a cursor to h
1890: 6f 6c 64 20 74 68 65 20 64 61 74 61 62 61 73 65  old the database
18a0: 20 6f 70 65 6e 0a 20 20 2a 2f 0a 20 20 70 44 62   open.  */.  pDb
18b0: 20 3d 20 26 64 62 2d 3e 61 44 62 5b 69 44 62 5d   = &db->aDb[iDb]
18c0: 3b 0a 20 20 69 66 28 20 70 44 62 2d 3e 70 42 74  ;.  if( pDb->pBt
18d0: 3d 3d 30 20 29 7b 0a 20 20 20 20 61 73 73 65 72  ==0 ){.    asser
18e0: 74 28 20 69 44 62 3d 3d 31 20 29 3b 0a 20 20 20  t( iDb==1 );.   
18f0: 20 44 62 53 65 74 50 72 6f 70 65 72 74 79 28 64   DbSetProperty(d
1900: 62 2c 20 31 2c 20 44 42 5f 53 63 68 65 6d 61 4c  b, 1, DB_SchemaL
1910: 6f 61 64 65 64 29 3b 0a 20 20 20 20 72 63 20 3d  oaded);.    rc =
1920: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 20 20   SQLITE_OK;.    
1930: 67 6f 74 6f 20 65 72 72 6f 72 5f 6f 75 74 3b 0a  goto error_out;.
1940: 20 20 7d 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65    }..  /* If the
1950: 72 65 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64  re is not alread
1960: 79 20 61 20 72 65 61 64 2d 6f 6e 6c 79 20 28 6f  y a read-only (o
1970: 72 20 72 65 61 64 2d 77 72 69 74 65 29 20 74 72  r read-write) tr
1980: 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65 6e 65 64  ansaction opened
1990: 0a 20 20 2a 2a 20 6f 6e 20 74 68 65 20 62 2d 74  .  ** on the b-t
19a0: 72 65 65 20 64 61 74 61 62 61 73 65 2c 20 6f 70  ree database, op
19b0: 65 6e 20 6f 6e 65 20 6e 6f 77 2e 20 49 66 20 61  en one now. If a
19c0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20   transaction is 
19d0: 6f 70 65 6e 65 64 2c 20 69 74 20 0a 20 20 2a 2a  opened, it .  **
19e0: 20 77 69 6c 6c 20 62 65 20 63 6c 6f 73 65 64 20   will be closed 
19f0: 62 65 66 6f 72 65 20 74 68 69 73 20 66 75 6e 63  before this func
1a00: 74 69 6f 6e 20 72 65 74 75 72 6e 73 2e 20 20 2a  tion returns.  *
1a10: 2f 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65  /.  sqlite3Btree
1a20: 45 6e 74 65 72 28 70 44 62 2d 3e 70 42 74 29 3b  Enter(pDb->pBt);
1a30: 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33 42  .  if( !sqlite3B
1a40: 74 72 65 65 49 73 49 6e 52 65 61 64 54 72 61 6e  treeIsInReadTran
1a50: 73 28 70 44 62 2d 3e 70 42 74 29 20 29 7b 0a 20  s(pDb->pBt) ){. 
1a60: 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 42     rc = sqlite3B
1a70: 74 72 65 65 42 65 67 69 6e 54 72 61 6e 73 28 70  treeBeginTrans(p
1a80: 44 62 2d 3e 70 42 74 2c 20 30 2c 20 30 29 3b 0a  Db->pBt, 0, 0);.
1a90: 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49      if( rc!=SQLI
1aa0: 54 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73  TE_OK ){.      s
1ab0: 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28  qlite3SetString(
1ac0: 70 7a 45 72 72 4d 73 67 2c 20 64 62 2c 20 73 71  pzErrMsg, db, sq
1ad0: 6c 69 74 65 33 45 72 72 53 74 72 28 72 63 29 29  lite3ErrStr(rc))
1ae0: 3b 0a 20 20 20 20 20 20 67 6f 74 6f 20 69 6e 69  ;.      goto ini
1af0: 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75 74 3b 0a  tone_error_out;.
1b00: 20 20 20 20 7d 0a 20 20 20 20 6f 70 65 6e 65 64      }.    opened
1b10: 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 31 3b  Transaction = 1;
1b20: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 47 65 74 20 74  .  }..  /* Get t
1b30: 68 65 20 64 61 74 61 62 61 73 65 20 6d 65 74 61  he database meta
1b40: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 20 20   information..  
1b50: 2a 2a 0a 20 20 2a 2a 20 4d 65 74 61 20 76 61 6c  **.  ** Meta val
1b60: 75 65 73 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f  ues are as follo
1b70: 77 73 3a 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61  ws:.  **    meta
1b80: 5b 30 5d 20 20 20 53 63 68 65 6d 61 20 63 6f 6f  [0]   Schema coo
1b90: 6b 69 65 2e 20 20 43 68 61 6e 67 65 73 20 77 69  kie.  Changes wi
1ba0: 74 68 20 65 61 63 68 20 73 63 68 65 6d 61 20 63  th each schema c
1bb0: 68 61 6e 67 65 2e 0a 20 20 2a 2a 20 20 20 20 6d  hange..  **    m
1bc0: 65 74 61 5b 31 5d 20 20 20 46 69 6c 65 20 66 6f  eta[1]   File fo
1bd0: 72 6d 61 74 20 6f 66 20 73 63 68 65 6d 61 20 6c  rmat of schema l
1be0: 61 79 65 72 2e 0a 20 20 2a 2a 20 20 20 20 6d 65  ayer..  **    me
1bf0: 74 61 5b 32 5d 20 20 20 53 69 7a 65 20 6f 66 20  ta[2]   Size of 
1c00: 74 68 65 20 70 61 67 65 20 63 61 63 68 65 2e 0a  the page cache..
1c10: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 33 5d 20    **    meta[3] 
1c20: 20 20 4c 61 72 67 65 73 74 20 72 6f 6f 74 70 61    Largest rootpa
1c30: 67 65 20 28 61 75 74 6f 2f 69 6e 63 72 5f 76 61  ge (auto/incr_va
1c40: 63 75 75 6d 20 6d 6f 64 65 29 0a 20 20 2a 2a 20  cuum mode).  ** 
1c50: 20 20 20 6d 65 74 61 5b 34 5d 20 20 20 44 62 20     meta[4]   Db 
1c60: 74 65 78 74 20 65 6e 63 6f 64 69 6e 67 2e 20 31  text encoding. 1
1c70: 3a 55 54 46 2d 38 20 32 3a 55 54 46 2d 31 36 4c  :UTF-8 2:UTF-16L
1c80: 45 20 33 3a 55 54 46 2d 31 36 42 45 0a 20 20 2a  E 3:UTF-16BE.  *
1c90: 2a 20 20 20 20 6d 65 74 61 5b 35 5d 20 20 20 55  *    meta[5]   U
1ca0: 73 65 72 20 76 65 72 73 69 6f 6e 0a 20 20 2a 2a  ser version.  **
1cb0: 20 20 20 20 6d 65 74 61 5b 36 5d 20 20 20 49 6e      meta[6]   In
1cc0: 63 72 65 6d 65 6e 74 61 6c 20 76 61 63 75 75 6d  cremental vacuum
1cd0: 20 6d 6f 64 65 0a 20 20 2a 2a 20 20 20 20 6d 65   mode.  **    me
1ce0: 74 61 5b 37 5d 20 20 20 75 6e 75 73 65 64 0a 20  ta[7]   unused. 
1cf0: 20 2a 2a 20 20 20 20 6d 65 74 61 5b 38 5d 20 20   **    meta[8]  
1d00: 20 75 6e 75 73 65 64 0a 20 20 2a 2a 20 20 20 20   unused.  **    
1d10: 6d 65 74 61 5b 39 5d 20 20 20 75 6e 75 73 65 64  meta[9]   unused
1d20: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4e 6f 74 65 3a  .  **.  ** Note:
1d30: 20 54 68 65 20 23 64 65 66 69 6e 65 64 20 53 51   The #defined SQ
1d40: 4c 49 54 45 5f 55 54 46 2a 20 73 79 6d 62 6f 6c  LITE_UTF* symbol
1d50: 73 20 69 6e 20 73 71 6c 69 74 65 49 6e 74 2e 68  s in sqliteInt.h
1d60: 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 0a 20   correspond to. 
1d70: 20 2a 2a 20 74 68 65 20 70 6f 73 73 69 62 6c 65   ** the possible
1d80: 20 76 61 6c 75 65 73 20 6f 66 20 6d 65 74 61 5b   values of meta[
1d90: 34 5d 2e 0a 20 20 2a 2f 0a 20 20 66 6f 72 28 69  4]..  */.  for(i
1da0: 3d 30 3b 20 69 3c 41 72 72 61 79 53 69 7a 65 28  =0; i<ArraySize(
1db0: 6d 65 74 61 29 3b 20 69 2b 2b 29 7b 0a 20 20 20  meta); i++){.   
1dc0: 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74   sqlite3BtreeGet
1dd0: 4d 65 74 61 28 70 44 62 2d 3e 70 42 74 2c 20 69  Meta(pDb->pBt, i
1de0: 2b 31 2c 20 28 75 33 32 20 2a 29 26 6d 65 74 61  +1, (u32 *)&meta
1df0: 5b 69 5d 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20  [i]);.  }.  if( 
1e00: 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c  (db->flags & SQL
1e10: 49 54 45 5f 52 65 73 65 74 44 61 74 61 62 61 73  ITE_ResetDatabas
1e20: 65 29 21 3d 30 20 29 7b 0a 20 20 20 20 6d 65 6d  e)!=0 ){.    mem
1e30: 73 65 74 28 6d 65 74 61 2c 20 30 2c 20 73 69 7a  set(meta, 0, siz
1e40: 65 6f 66 28 6d 65 74 61 29 29 3b 0a 20 20 7d 0a  eof(meta));.  }.
1e50: 20 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e    pDb->pSchema->
1e60: 73 63 68 65 6d 61 5f 63 6f 6f 6b 69 65 20 3d 20  schema_cookie = 
1e70: 6d 65 74 61 5b 42 54 52 45 45 5f 53 43 48 45 4d  meta[BTREE_SCHEM
1e80: 41 5f 56 45 52 53 49 4f 4e 2d 31 5d 3b 0a 0a 20  A_VERSION-1];.. 
1e90: 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67 20 61   /* If opening a
1ea0: 20 6e 6f 6e 2d 65 6d 70 74 79 20 64 61 74 61 62   non-empty datab
1eb0: 61 73 65 2c 20 63 68 65 63 6b 20 74 68 65 20 74  ase, check the t
1ec0: 65 78 74 20 65 6e 63 6f 64 69 6e 67 2e 20 46 6f  ext encoding. Fo
1ed0: 72 20 74 68 65 0a 20 20 2a 2a 20 6d 61 69 6e 20  r the.  ** main 
1ee0: 64 61 74 61 62 61 73 65 2c 20 73 65 74 20 73 71  database, set sq
1ef0: 6c 69 74 65 33 2e 65 6e 63 20 74 6f 20 74 68 65  lite3.enc to the
1f00: 20 65 6e 63 6f 64 69 6e 67 20 6f 66 20 74 68 65   encoding of the
1f10: 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 2e 0a   main database..
1f20: 20 20 2a 2a 20 46 6f 72 20 61 6e 20 61 74 74 61    ** For an atta
1f30: 63 68 65 64 20 64 62 2c 20 69 74 20 69 73 20 61  ched db, it is a
1f40: 6e 20 65 72 72 6f 72 20 69 66 20 74 68 65 20 65  n error if the e
1f50: 6e 63 6f 64 69 6e 67 20 69 73 20 6e 6f 74 20 74  ncoding is not t
1f60: 68 65 20 73 61 6d 65 0a 20 20 2a 2a 20 61 73 20  he same.  ** as 
1f70: 73 71 6c 69 74 65 33 2e 65 6e 63 2e 0a 20 20 2a  sqlite3.enc..  *
1f80: 2f 0a 20 20 69 66 28 20 6d 65 74 61 5b 42 54 52  /.  if( meta[BTR
1f90: 45 45 5f 54 45 58 54 5f 45 4e 43 4f 44 49 4e 47  EE_TEXT_ENCODING
1fa0: 2d 31 5d 20 29 7b 20 20 2f 2a 20 74 65 78 74 20  -1] ){  /* text 
1fb0: 65 6e 63 6f 64 69 6e 67 20 2a 2f 0a 20 20 20 20  encoding */.    
1fc0: 69 66 28 20 69 44 62 3d 3d 30 20 29 7b 0a 23 69  if( iDb==0 ){.#i
1fd0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49  fndef SQLITE_OMI
1fe0: 54 5f 55 54 46 31 36 0a 20 20 20 20 20 20 75 38  T_UTF16.      u8
1ff0: 20 65 6e 63 6f 64 69 6e 67 3b 0a 20 20 20 20 20   encoding;.     
2000: 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67 20 74   /* If opening t
2010: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  he main database
2020: 2c 20 73 65 74 20 45 4e 43 28 64 62 29 2e 20 2a  , set ENC(db). *
2030: 2f 0a 20 20 20 20 20 20 65 6e 63 6f 64 69 6e 67  /.      encoding
2040: 20 3d 20 28 75 38 29 6d 65 74 61 5b 42 54 52 45   = (u8)meta[BTRE
2050: 45 5f 54 45 58 54 5f 45 4e 43 4f 44 49 4e 47 2d  E_TEXT_ENCODING-
2060: 31 5d 20 26 20 33 3b 0a 20 20 20 20 20 20 69 66  1] & 3;.      if
2070: 28 20 65 6e 63 6f 64 69 6e 67 3d 3d 30 20 29 20  ( encoding==0 ) 
2080: 65 6e 63 6f 64 69 6e 67 20 3d 20 53 51 4c 49 54  encoding = SQLIT
2090: 45 5f 55 54 46 38 3b 0a 20 20 20 20 20 20 45 4e  E_UTF8;.      EN
20a0: 43 28 64 62 29 20 3d 20 65 6e 63 6f 64 69 6e 67  C(db) = encoding
20b0: 3b 0a 23 65 6c 73 65 0a 20 20 20 20 20 20 45 4e  ;.#else.      EN
20c0: 43 28 64 62 29 20 3d 20 53 51 4c 49 54 45 5f 55  C(db) = SQLITE_U
20d0: 54 46 38 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20  TF8;.#endif.    
20e0: 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 2f 2a 20  }else{.      /* 
20f0: 49 66 20 6f 70 65 6e 69 6e 67 20 61 6e 20 61 74  If opening an at
2100: 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65 2c  tached database,
2110: 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6d 75   the encoding mu
2120: 63 68 20 6d 61 74 63 68 20 45 4e 43 28 64 62 29  ch match ENC(db)
2130: 20 2a 2f 0a 20 20 20 20 20 20 69 66 28 20 6d 65   */.      if( me
2140: 74 61 5b 42 54 52 45 45 5f 54 45 58 54 5f 45 4e  ta[BTREE_TEXT_EN
2150: 43 4f 44 49 4e 47 2d 31 5d 21 3d 45 4e 43 28 64  CODING-1]!=ENC(d
2160: 62 29 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71  b) ){.        sq
2170: 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 70  lite3SetString(p
2180: 7a 45 72 72 4d 73 67 2c 20 64 62 2c 20 22 61 74  zErrMsg, db, "at
2190: 74 61 63 68 65 64 20 64 61 74 61 62 61 73 65 73  tached databases
21a0: 20 6d 75 73 74 20 75 73 65 20 74 68 65 20 73 61   must use the sa
21b0: 6d 65 22 0a 20 20 20 20 20 20 20 20 20 20 20 20  me".            
21c0: 22 20 74 65 78 74 20 65 6e 63 6f 64 69 6e 67 20  " text encoding 
21d0: 61 73 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  as main database
21e0: 22 29 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d  ");.        rc =
21f0: 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20   SQLITE_ERROR;. 
2200: 20 20 20 20 20 20 20 67 6f 74 6f 20 69 6e 69 74         goto init
2210: 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75 74 3b 0a 20  one_error_out;. 
2220: 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 7d       }.    }.  }
2230: 65 6c 73 65 7b 0a 20 20 20 20 44 62 53 65 74 50  else{.    DbSetP
2240: 72 6f 70 65 72 74 79 28 64 62 2c 20 69 44 62 2c  roperty(db, iDb,
2250: 20 44 42 5f 45 6d 70 74 79 29 3b 0a 20 20 7d 0a   DB_Empty);.  }.
2260: 20 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e    pDb->pSchema->
2270: 65 6e 63 20 3d 20 45 4e 43 28 64 62 29 3b 0a 0a  enc = ENC(db);..
2280: 20 20 69 66 28 20 70 44 62 2d 3e 70 53 63 68 65    if( pDb->pSche
2290: 6d 61 2d 3e 63 61 63 68 65 5f 73 69 7a 65 3d 3d  ma->cache_size==
22a0: 30 20 29 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c  0 ){.#ifndef SQL
22b0: 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41  ITE_OMIT_DEPRECA
22c0: 54 45 44 0a 20 20 20 20 73 69 7a 65 20 3d 20 73  TED.    size = s
22d0: 71 6c 69 74 65 33 41 62 73 49 6e 74 33 32 28 6d  qlite3AbsInt32(m
22e0: 65 74 61 5b 42 54 52 45 45 5f 44 45 46 41 55 4c  eta[BTREE_DEFAUL
22f0: 54 5f 43 41 43 48 45 5f 53 49 5a 45 2d 31 5d 29  T_CACHE_SIZE-1])
2300: 3b 0a 20 20 20 20 69 66 28 20 73 69 7a 65 3d 3d  ;.    if( size==
2310: 30 20 29 7b 20 73 69 7a 65 20 3d 20 53 51 4c 49  0 ){ size = SQLI
2320: 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 43 48 45  TE_DEFAULT_CACHE
2330: 5f 53 49 5a 45 3b 20 7d 0a 20 20 20 20 70 44 62  _SIZE; }.    pDb
2340: 2d 3e 70 53 63 68 65 6d 61 2d 3e 63 61 63 68 65  ->pSchema->cache
2350: 5f 73 69 7a 65 20 3d 20 73 69 7a 65 3b 0a 23 65  _size = size;.#e
2360: 6c 73 65 0a 20 20 20 20 70 44 62 2d 3e 70 53 63  lse.    pDb->pSc
2370: 68 65 6d 61 2d 3e 63 61 63 68 65 5f 73 69 7a 65  hema->cache_size
2380: 20 3d 20 53 51 4c 49 54 45 5f 44 45 46 41 55 4c   = SQLITE_DEFAUL
2390: 54 5f 43 41 43 48 45 5f 53 49 5a 45 3b 0a 23 65  T_CACHE_SIZE;.#e
23a0: 6e 64 69 66 0a 20 20 20 20 73 71 6c 69 74 65 33  ndif.    sqlite3
23b0: 42 74 72 65 65 53 65 74 43 61 63 68 65 53 69 7a  BtreeSetCacheSiz
23c0: 65 28 70 44 62 2d 3e 70 42 74 2c 20 70 44 62 2d  e(pDb->pBt, pDb-
23d0: 3e 70 53 63 68 65 6d 61 2d 3e 63 61 63 68 65 5f  >pSchema->cache_
23e0: 73 69 7a 65 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a  size);.  }..  /*
23f0: 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 6f 72 6d 61  .  ** file_forma
2400: 74 3d 3d 31 20 20 20 20 56 65 72 73 69 6f 6e 20  t==1    Version 
2410: 33 2e 30 2e 30 2e 0a 20 20 2a 2a 20 66 69 6c 65  3.0.0..  ** file
2420: 5f 66 6f 72 6d 61 74 3d 3d 32 20 20 20 20 56 65  _format==2    Ve
2430: 72 73 69 6f 6e 20 33 2e 31 2e 33 2e 20 20 2f 2f  rsion 3.1.3.  //
2440: 20 41 4c 54 45 52 20 54 41 42 4c 45 20 41 44 44   ALTER TABLE ADD
2450: 20 43 4f 4c 55 4d 4e 0a 20 20 2a 2a 20 66 69 6c   COLUMN.  ** fil
2460: 65 5f 66 6f 72 6d 61 74 3d 3d 33 20 20 20 20 56  e_format==3    V
2470: 65 72 73 69 6f 6e 20 33 2e 31 2e 34 2e 20 20 2f  ersion 3.1.4.  /
2480: 2f 20 64 69 74 74 6f 20 62 75 74 20 77 69 74 68  / ditto but with
2490: 20 6e 6f 6e 2d 4e 55 4c 4c 20 64 65 66 61 75 6c   non-NULL defaul
24a0: 74 73 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 6f 72  ts.  ** file_for
24b0: 6d 61 74 3d 3d 34 20 20 20 20 56 65 72 73 69 6f  mat==4    Versio
24c0: 6e 20 33 2e 33 2e 30 2e 20 20 2f 2f 20 44 45 53  n 3.3.0.  // DES
24d0: 43 20 69 6e 64 69 63 65 73 2e 20 20 42 6f 6f 6c  C indices.  Bool
24e0: 65 61 6e 20 63 6f 6e 73 74 61 6e 74 73 0a 20 20  ean constants.  
24f0: 2a 2f 0a 20 20 70 44 62 2d 3e 70 53 63 68 65 6d  */.  pDb->pSchem
2500: 61 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d  a->file_format =
2510: 20 28 75 38 29 6d 65 74 61 5b 42 54 52 45 45 5f   (u8)meta[BTREE_
2520: 46 49 4c 45 5f 46 4f 52 4d 41 54 2d 31 5d 3b 0a  FILE_FORMAT-1];.
2530: 20 20 69 66 28 20 70 44 62 2d 3e 70 53 63 68 65    if( pDb->pSche
2540: 6d 61 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 3d  ma->file_format=
2550: 3d 30 20 29 7b 0a 20 20 20 20 70 44 62 2d 3e 70  =0 ){.    pDb->p
2560: 53 63 68 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f 72  Schema->file_for
2570: 6d 61 74 20 3d 20 31 3b 0a 20 20 7d 0a 20 20 69  mat = 1;.  }.  i
2580: 66 28 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d  f( pDb->pSchema-
2590: 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 3e 53 51 4c  >file_format>SQL
25a0: 49 54 45 5f 4d 41 58 5f 46 49 4c 45 5f 46 4f 52  ITE_MAX_FILE_FOR
25b0: 4d 41 54 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  MAT ){.    sqlit
25c0: 65 33 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72  e3SetString(pzEr
25d0: 72 4d 73 67 2c 20 64 62 2c 20 22 75 6e 73 75 70  rMsg, db, "unsup
25e0: 70 6f 72 74 65 64 20 66 69 6c 65 20 66 6f 72 6d  ported file form
25f0: 61 74 22 29 3b 0a 20 20 20 20 72 63 20 3d 20 53  at");.    rc = S
2600: 51 4c 49 54 45 5f 45 52 52 4f 52 3b 0a 20 20 20  QLITE_ERROR;.   
2610: 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f 65 72   goto initone_er
2620: 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20  ror_out;.  }..  
2630: 2f 2a 20 54 69 63 6b 65 74 20 23 32 38 30 34 3a  /* Ticket #2804:
2640: 20 20 57 68 65 6e 20 77 65 20 6f 70 65 6e 20 61    When we open a
2650: 20 64 61 74 61 62 61 73 65 20 69 6e 20 74 68 65   database in the
2660: 20 6e 65 77 65 72 20 66 69 6c 65 20 66 6f 72 6d   newer file form
2670: 61 74 2c 0a 20 20 2a 2a 20 63 6c 65 61 72 20 74  at,.  ** clear t
2680: 68 65 20 6c 65 67 61 63 79 5f 66 69 6c 65 5f 66  he legacy_file_f
2690: 6f 72 6d 61 74 20 70 72 61 67 6d 61 20 66 6c 61  ormat pragma fla
26a0: 67 20 73 6f 20 74 68 61 74 20 61 20 56 41 43 55  g so that a VACU
26b0: 55 4d 20 77 69 6c 6c 0a 20 20 2a 2a 20 6e 6f 74  UM will.  ** not
26c0: 20 64 6f 77 6e 67 72 61 64 65 20 74 68 65 20 64   downgrade the d
26d0: 61 74 61 62 61 73 65 20 61 6e 64 20 74 68 75 73  atabase and thus
26e0: 20 69 6e 76 61 6c 69 64 61 74 65 20 61 6e 79 20   invalidate any 
26f0: 64 65 73 63 65 6e 64 69 6e 67 0a 20 20 2a 2a 20  descending.  ** 
2700: 69 6e 64 69 63 65 73 20 74 68 61 74 20 74 68 65  indices that the
2710: 20 75 73 65 72 20 6d 69 67 68 74 20 68 61 76 65   user might have
2720: 20 63 72 65 61 74 65 64 2e 0a 20 20 2a 2f 0a 20   created..  */. 
2730: 20 69 66 28 20 69 44 62 3d 3d 30 20 26 26 20 6d   if( iDb==0 && m
2740: 65 74 61 5b 42 54 52 45 45 5f 46 49 4c 45 5f 46  eta[BTREE_FILE_F
2750: 4f 52 4d 41 54 2d 31 5d 3e 3d 34 20 29 7b 0a 20  ORMAT-1]>=4 ){. 
2760: 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20     db->flags &= 
2770: 7e 28 75 36 34 29 53 51 4c 49 54 45 5f 4c 65 67  ~(u64)SQLITE_Leg
2780: 61 63 79 46 69 6c 65 46 6d 74 3b 0a 20 20 7d 0a  acyFileFmt;.  }.
2790: 0a 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 73  .  /* Read the s
27a0: 63 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f  chema informatio
27b0: 6e 20 6f 75 74 20 6f 66 20 74 68 65 20 73 63 68  n out of the sch
27c0: 65 6d 61 20 74 61 62 6c 65 73 0a 20 20 2a 2f 0a  ema tables.  */.
27d0: 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e    assert( db->in
27e0: 69 74 2e 62 75 73 79 20 29 3b 0a 20 20 7b 0a 20  it.busy );.  {. 
27f0: 20 20 20 63 68 61 72 20 2a 7a 53 71 6c 3b 0a 20     char *zSql;. 
2800: 20 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74 65     zSql = sqlite
2810: 33 4d 50 72 69 6e 74 66 28 64 62 2c 20 0a 20 20  3MPrintf(db, .  
2820: 20 20 20 20 20 20 22 53 45 4c 45 43 54 20 6e 61        "SELECT na
2830: 6d 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71  me, rootpage, sq
2840: 6c 20 46 52 4f 4d 20 5c 22 25 77 5c 22 2e 25 73  l FROM \"%w\".%s
2850: 20 4f 52 44 45 52 20 42 59 20 72 6f 77 69 64 22   ORDER BY rowid"
2860: 2c 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 61 44  ,.        db->aD
2870: 62 5b 69 44 62 5d 2e 7a 44 62 53 4e 61 6d 65 2c  b[iDb].zDbSName,
2880: 20 7a 4d 61 73 74 65 72 4e 61 6d 65 29 3b 0a 23   zMasterName);.#
2890: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d  ifndef SQLITE_OM
28a0: 49 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e  IT_AUTHORIZATION
28b0: 0a 20 20 20 20 7b 0a 20 20 20 20 20 20 73 71 6c  .    {.      sql
28c0: 69 74 65 33 5f 78 61 75 74 68 20 78 41 75 74 68  ite3_xauth xAuth
28d0: 3b 0a 20 20 20 20 20 20 78 41 75 74 68 20 3d 20  ;.      xAuth = 
28e0: 64 62 2d 3e 78 41 75 74 68 3b 0a 20 20 20 20 20  db->xAuth;.     
28f0: 20 64 62 2d 3e 78 41 75 74 68 20 3d 20 30 3b 0a   db->xAuth = 0;.
2900: 23 65 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20  #endif.      rc 
2910: 3d 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 64  = sqlite3_exec(d
2920: 62 2c 20 7a 53 71 6c 2c 20 73 71 6c 69 74 65 33  b, zSql, sqlite3
2930: 49 6e 69 74 43 61 6c 6c 62 61 63 6b 2c 20 26 69  InitCallback, &i
2940: 6e 69 74 44 61 74 61 2c 20 30 29 3b 0a 23 69 66  nitData, 0);.#if
2950: 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54  ndef SQLITE_OMIT
2960: 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20  _AUTHORIZATION. 
2970: 20 20 20 20 20 64 62 2d 3e 78 41 75 74 68 20 3d       db->xAuth =
2980: 20 78 41 75 74 68 3b 0a 20 20 20 20 7d 0a 23 65   xAuth;.    }.#e
2990: 6e 64 69 66 0a 20 20 20 20 69 66 28 20 72 63 3d  ndif.    if( rc=
29a0: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20  =SQLITE_OK ) rc 
29b0: 3d 20 69 6e 69 74 44 61 74 61 2e 72 63 3b 0a 20  = initData.rc;. 
29c0: 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65     sqlite3DbFree
29d0: 28 64 62 2c 20 7a 53 71 6c 29 3b 0a 23 69 66 6e  (db, zSql);.#ifn
29e0: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
29f0: 41 4e 41 4c 59 5a 45 0a 20 20 20 20 69 66 28 20  ANALYZE.    if( 
2a00: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b  rc==SQLITE_OK ){
2a10: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 41 6e  .      sqlite3An
2a20: 61 6c 79 73 69 73 4c 6f 61 64 28 64 62 2c 20 69  alysisLoad(db, i
2a30: 44 62 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69  Db);.    }.#endi
2a40: 66 0a 20 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e  f.  }.  if( db->
2a50: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a  mallocFailed ){.
2a60: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f      rc = SQLITE_
2a70: 4e 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20  NOMEM_BKPT;.    
2a80: 73 71 6c 69 74 65 33 52 65 73 65 74 41 6c 6c 53  sqlite3ResetAllS
2a90: 63 68 65 6d 61 73 4f 66 43 6f 6e 6e 65 63 74 69  chemasOfConnecti
2aa0: 6f 6e 28 64 62 29 3b 0a 20 20 7d 0a 20 20 69 66  on(db);.  }.  if
2ab0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc==SQLITE_OK 
2ac0: 7c 7c 20 28 64 62 2d 3e 66 6c 61 67 73 26 53 51  || (db->flags&SQ
2ad0: 4c 49 54 45 5f 4e 6f 53 63 68 65 6d 61 45 72 72  LITE_NoSchemaErr
2ae0: 6f 72 29 29 7b 0a 20 20 20 20 2f 2a 20 42 6c 61  or)){.    /* Bla
2af0: 63 6b 20 6d 61 67 69 63 3a 20 49 66 20 74 68 65  ck magic: If the
2b00: 20 53 51 4c 49 54 45 5f 4e 6f 53 63 68 65 6d 61   SQLITE_NoSchema
2b10: 45 72 72 6f 72 20 66 6c 61 67 20 69 73 20 73 65  Error flag is se
2b20: 74 2c 20 74 68 65 6e 20 63 6f 6e 73 69 64 65 72  t, then consider
2b30: 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 63 68 65  .    ** the sche
2b40: 6d 61 20 6c 6f 61 64 65 64 2c 20 65 76 65 6e 20  ma loaded, even 
2b50: 69 66 20 65 72 72 6f 72 73 20 6f 63 63 75 72 72  if errors occurr
2b60: 65 64 2e 20 49 6e 20 74 68 69 73 20 73 69 74 75  ed. In this situ
2b70: 61 74 69 6f 6e 20 74 68 65 20 0a 20 20 20 20 2a  ation the .    *
2b80: 2a 20 63 75 72 72 65 6e 74 20 73 71 6c 69 74 65  * current sqlite
2b90: 33 5f 70 72 65 70 61 72 65 28 29 20 6f 70 65 72  3_prepare() oper
2ba0: 61 74 69 6f 6e 20 77 69 6c 6c 20 66 61 69 6c 2c  ation will fail,
2bb0: 20 62 75 74 20 74 68 65 20 66 6f 6c 6c 6f 77 69   but the followi
2bc0: 6e 67 20 6f 6e 65 0a 20 20 20 20 2a 2a 20 77 69  ng one.    ** wi
2bd0: 6c 6c 20 61 74 74 65 6d 70 74 20 74 6f 20 63 6f  ll attempt to co
2be0: 6d 70 69 6c 65 20 74 68 65 20 73 75 70 70 6c 69  mpile the suppli
2bf0: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61 67 61  ed statement aga
2c00: 69 6e 73 74 20 77 68 61 74 65 76 65 72 20 73 75  inst whatever su
2c10: 62 73 65 74 0a 20 20 20 20 2a 2a 20 6f 66 20 74  bset.    ** of t
2c20: 68 65 20 73 63 68 65 6d 61 20 77 61 73 20 6c 6f  he schema was lo
2c30: 61 64 65 64 20 62 65 66 6f 72 65 20 74 68 65 20  aded before the 
2c40: 65 72 72 6f 72 20 6f 63 63 75 72 72 65 64 2e 20  error occurred. 
2c50: 54 68 65 20 70 72 69 6d 61 72 79 0a 20 20 20 20  The primary.    
2c60: 2a 2a 20 70 75 72 70 6f 73 65 20 6f 66 20 74 68  ** purpose of th
2c70: 69 73 20 69 73 20 74 6f 20 61 6c 6c 6f 77 20 61  is is to allow a
2c80: 63 63 65 73 73 20 74 6f 20 74 68 65 20 73 71 6c  ccess to the sql
2c90: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65  ite_master table
2ca0: 0a 20 20 20 20 2a 2a 20 65 76 65 6e 20 77 68 65  .    ** even whe
2cb0: 6e 20 69 74 73 20 63 6f 6e 74 65 6e 74 73 20 68  n its contents h
2cc0: 61 76 65 20 62 65 65 6e 20 63 6f 72 72 75 70 74  ave been corrupt
2cd0: 65 64 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 44  ed..    */.    D
2ce0: 62 53 65 74 50 72 6f 70 65 72 74 79 28 64 62 2c  bSetProperty(db,
2cf0: 20 69 44 62 2c 20 44 42 5f 53 63 68 65 6d 61 4c   iDb, DB_SchemaL
2d00: 6f 61 64 65 64 29 3b 0a 20 20 20 20 72 63 20 3d  oaded);.    rc =
2d10: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d 0a   SQLITE_OK;.  }.
2d20: 0a 20 20 2f 2a 20 4a 75 6d 70 20 68 65 72 65 20  .  /* Jump here 
2d30: 66 6f 72 20 61 6e 20 65 72 72 6f 72 20 74 68 61  for an error tha
2d40: 74 20 6f 63 63 75 72 73 20 61 66 74 65 72 20 73  t occurs after s
2d50: 75 63 63 65 73 73 66 75 6c 6c 79 20 61 6c 6c 6f  uccessfully allo
2d60: 63 61 74 69 6e 67 0a 20 20 2a 2a 20 63 75 72 4d  cating.  ** curM
2d70: 61 69 6e 20 61 6e 64 20 63 61 6c 6c 69 6e 67 20  ain and calling 
2d80: 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65  sqlite3BtreeEnte
2d90: 72 28 29 2e 20 46 6f 72 20 61 6e 20 65 72 72 6f  r(). For an erro
2da0: 72 20 74 68 61 74 20 6f 63 63 75 72 73 0a 20 20  r that occurs.  
2db0: 2a 2a 20 62 65 66 6f 72 65 20 74 68 61 74 20 70  ** before that p
2dc0: 6f 69 6e 74 2c 20 6a 75 6d 70 20 74 6f 20 65 72  oint, jump to er
2dd0: 72 6f 72 5f 6f 75 74 2e 0a 20 20 2a 2f 0a 69 6e  ror_out..  */.in
2de0: 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75 74 3a  itone_error_out:
2df0: 0a 20 20 69 66 28 20 6f 70 65 6e 65 64 54 72 61  .  if( openedTra
2e00: 6e 73 61 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20  nsaction ){.    
2e10: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d  sqlite3BtreeComm
2e20: 69 74 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 20  it(pDb->pBt);.  
2e30: 7d 0a 20 20 73 71 6c 69 74 65 33 42 74 72 65 65  }.  sqlite3Btree
2e40: 4c 65 61 76 65 28 70 44 62 2d 3e 70 42 74 29 3b  Leave(pDb->pBt);
2e50: 0a 0a 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 69  ..error_out:.  i
2e60: 66 28 20 72 63 20 29 7b 0a 20 20 20 20 69 66 28  f( rc ){.    if(
2e70: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45   rc==SQLITE_NOME
2e80: 4d 20 7c 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f  M || rc==SQLITE_
2e90: 49 4f 45 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a 20  IOERR_NOMEM ){. 
2ea0: 20 20 20 20 20 73 71 6c 69 74 65 33 4f 6f 6d 46       sqlite3OomF
2eb0: 61 75 6c 74 28 64 62 29 3b 0a 20 20 20 20 7d 0a  ault(db);.    }.
2ec0: 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 74      sqlite3Reset
2ed0: 4f 6e 65 53 63 68 65 6d 61 28 64 62 2c 20 69 44  OneSchema(db, iD
2ee0: 62 29 3b 0a 20 20 7d 0a 20 20 64 62 2d 3e 69 6e  b);.  }.  db->in
2ef0: 69 74 2e 62 75 73 79 20 3d 20 30 3b 0a 20 20 72  it.busy = 0;.  r
2f00: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
2f10: 2a 2a 20 49 6e 69 74 69 61 6c 69 7a 65 20 61 6c  ** Initialize al
2f20: 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 73  l database files
2f30: 20 2d 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61   - the main data
2f40: 62 61 73 65 20 66 69 6c 65 2c 20 74 68 65 20 66  base file, the f
2f50: 69 6c 65 0a 2a 2a 20 75 73 65 64 20 74 6f 20 73  ile.** used to s
2f60: 74 6f 72 65 20 74 65 6d 70 6f 72 61 72 79 20 74  tore temporary t
2f70: 61 62 6c 65 73 2c 20 61 6e 64 20 61 6e 79 20 61  ables, and any a
2f80: 64 64 69 74 69 6f 6e 61 6c 20 64 61 74 61 62 61  dditional databa
2f90: 73 65 20 66 69 6c 65 73 0a 2a 2a 20 63 72 65 61  se files.** crea
2fa0: 74 65 64 20 75 73 69 6e 67 20 41 54 54 41 43 48  ted using ATTACH
2fb0: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 52 65   statements.  Re
2fc0: 74 75 72 6e 20 61 20 73 75 63 63 65 73 73 20 63  turn a success c
2fd0: 6f 64 65 2e 20 20 49 66 20 61 6e 0a 2a 2a 20 65  ode.  If an.** e
2fe0: 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 77 72 69  rror occurs, wri
2ff0: 74 65 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 73  te an error mess
3000: 61 67 65 20 69 6e 74 6f 20 2a 70 7a 45 72 72 4d  age into *pzErrM
3010: 73 67 2e 0a 2a 2a 0a 2a 2a 20 41 66 74 65 72 20  sg..**.** After 
3020: 61 20 64 61 74 61 62 61 73 65 20 69 73 20 69 6e  a database is in
3030: 69 74 69 61 6c 69 7a 65 64 2c 20 74 68 65 20 44  itialized, the D
3040: 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 20 62  B_SchemaLoaded b
3050: 69 74 20 69 73 20 73 65 74 0a 2a 2a 20 62 69 74  it is set.** bit
3060: 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 66   is set in the f
3070: 6c 61 67 73 20 66 69 65 6c 64 20 6f 66 20 74 68  lags field of th
3080: 65 20 44 62 20 73 74 72 75 63 74 75 72 65 2e 20  e Db structure. 
3090: 49 66 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  If the database.
30a0: 2a 2a 20 66 69 6c 65 20 77 61 73 20 6f 66 20 7a  ** file was of z
30b0: 65 72 6f 2d 6c 65 6e 67 74 68 2c 20 74 68 65 6e  ero-length, then
30c0: 20 74 68 65 20 44 42 5f 45 6d 70 74 79 20 66 6c   the DB_Empty fl
30d0: 61 67 20 69 73 20 61 6c 73 6f 20 73 65 74 2e 0a  ag is also set..
30e0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 6e  */.int sqlite3In
30f0: 69 74 28 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  it(sqlite3 *db, 
3100: 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29  char **pzErrMsg)
3110: 7b 0a 20 20 69 6e 74 20 69 2c 20 72 63 3b 0a 20  {.  int i, rc;. 
3120: 20 69 6e 74 20 63 6f 6d 6d 69 74 5f 69 6e 74 65   int commit_inte
3130: 72 6e 61 6c 20 3d 20 21 28 64 62 2d 3e 6d 44 62  rnal = !(db->mDb
3140: 46 6c 61 67 73 26 44 42 46 4c 41 47 5f 53 63 68  Flags&DBFLAG_Sch
3150: 65 6d 61 43 68 61 6e 67 65 29 3b 0a 20 20 0a 20  emaChange);.  . 
3160: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
3170: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e  _mutex_held(db->
3180: 6d 75 74 65 78 29 20 29 3b 0a 20 20 61 73 73 65  mutex) );.  asse
3190: 72 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 65  rt( sqlite3Btree
31a0: 48 6f 6c 64 73 4d 75 74 65 78 28 64 62 2d 3e 61  HoldsMutex(db->a
31b0: 44 62 5b 30 5d 2e 70 42 74 29 20 29 3b 0a 20 20  Db[0].pBt) );.  
31c0: 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e 69 74  assert( db->init
31d0: 2e 62 75 73 79 3d 3d 30 20 29 3b 0a 20 20 45 4e  .busy==0 );.  EN
31e0: 43 28 64 62 29 20 3d 20 53 43 48 45 4d 41 5f 45  C(db) = SCHEMA_E
31f0: 4e 43 28 64 62 29 3b 0a 20 20 61 73 73 65 72 74  NC(db);.  assert
3200: 28 20 64 62 2d 3e 6e 44 62 3e 30 20 29 3b 0a 20  ( db->nDb>0 );. 
3210: 20 2f 2a 20 44 6f 20 74 68 65 20 6d 61 69 6e 20   /* Do the main 
3220: 73 63 68 65 6d 61 20 66 69 72 73 74 20 2a 2f 0a  schema first */.
3230: 20 20 69 66 28 20 21 44 62 48 61 73 50 72 6f 70    if( !DbHasProp
3240: 65 72 74 79 28 64 62 2c 20 30 2c 20 44 42 5f 53  erty(db, 0, DB_S
3250: 63 68 65 6d 61 4c 6f 61 64 65 64 29 20 29 7b 0a  chemaLoaded) ){.
3260: 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33      rc = sqlite3
3270: 49 6e 69 74 4f 6e 65 28 64 62 2c 20 30 2c 20 70  InitOne(db, 0, p
3280: 7a 45 72 72 4d 73 67 2c 20 30 29 3b 0a 20 20 20  zErrMsg, 0);.   
3290: 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e   if( rc ) return
32a0: 20 72 63 3b 0a 20 20 7d 0a 20 20 2f 2a 20 41 6c   rc;.  }.  /* Al
32b0: 6c 20 6f 74 68 65 72 20 73 63 68 65 6d 61 73 20  l other schemas 
32c0: 61 66 74 65 72 20 74 68 65 20 6d 61 69 6e 20 73  after the main s
32d0: 63 68 65 6d 61 2e 20 54 68 65 20 22 74 65 6d 70  chema. The "temp
32e0: 22 20 73 63 68 65 6d 61 20 6d 75 73 74 20 62 65  " schema must be
32f0: 20 6c 61 73 74 20 2a 2f 0a 20 20 66 6f 72 28 69   last */.  for(i
3300: 3d 64 62 2d 3e 6e 44 62 2d 31 3b 20 69 3e 30 3b  =db->nDb-1; i>0;
3310: 20 69 2d 2d 29 7b 0a 20 20 20 20 61 73 73 65 72   i--){.    asser
3320: 74 28 20 69 3d 3d 31 20 7c 7c 20 73 71 6c 69 74  t( i==1 || sqlit
3330: 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65  e3BtreeHoldsMute
3340: 78 28 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74  x(db->aDb[i].pBt
3350: 29 20 29 3b 0a 20 20 20 20 69 66 28 20 21 44 62  ) );.    if( !Db
3360: 48 61 73 50 72 6f 70 65 72 74 79 28 64 62 2c 20  HasProperty(db, 
3370: 69 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64  i, DB_SchemaLoad
3380: 65 64 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20  ed) ){.      rc 
3390: 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e 65  = sqlite3InitOne
33a0: 28 64 62 2c 20 69 2c 20 70 7a 45 72 72 4d 73 67  (db, i, pzErrMsg
33b0: 2c 20 30 29 3b 0a 20 20 20 20 20 20 69 66 28 20  , 0);.      if( 
33c0: 72 63 20 29 20 72 65 74 75 72 6e 20 72 63 3b 0a  rc ) return rc;.
33d0: 20 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20      }.  }.  if( 
33e0: 63 6f 6d 6d 69 74 5f 69 6e 74 65 72 6e 61 6c 20  commit_internal 
33f0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 43 6f  ){.    sqlite3Co
3400: 6d 6d 69 74 49 6e 74 65 72 6e 61 6c 43 68 61 6e  mmitInternalChan
3410: 67 65 73 28 64 62 29 3b 0a 20 20 7d 0a 20 20 72  ges(db);.  }.  r
3420: 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b  eturn SQLITE_OK;
3430: 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72  .}../*.** This r
3440: 6f 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f  outine is a no-o
3450: 70 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73  p if the databas
3460: 65 20 73 63 68 65 6d 61 20 69 73 20 61 6c 72 65  e schema is alre
3470: 61 64 79 20 69 6e 69 74 69 61 6c 69 7a 65 64 2e  ady initialized.
3480: 0a 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 74  .** Otherwise, t
3490: 68 65 20 73 63 68 65 6d 61 20 69 73 20 6c 6f 61  he schema is loa
34a0: 64 65 64 2e 20 41 6e 20 65 72 72 6f 72 20 63 6f  ded. An error co
34b0: 64 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a  de is returned..
34c0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65  */.int sqlite3Re
34d0: 61 64 53 63 68 65 6d 61 28 50 61 72 73 65 20 2a  adSchema(Parse *
34e0: 70 50 61 72 73 65 29 7b 0a 20 20 69 6e 74 20 72  pParse){.  int r
34f0: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20  c = SQLITE_OK;. 
3500: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70   sqlite3 *db = p
3510: 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 61 73 73  Parse->db;.  ass
3520: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74  ert( sqlite3_mut
3530: 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65  ex_held(db->mute
3540: 78 29 20 29 3b 0a 20 20 69 66 28 20 21 64 62 2d  x) );.  if( !db-
3550: 3e 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20 20  >init.busy ){.  
3560: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49 6e    rc = sqlite3In
3570: 69 74 28 64 62 2c 20 26 70 50 61 72 73 65 2d 3e  it(db, &pParse->
3580: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 69 66  zErrMsg);.    if
3590: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20  ( rc!=SQLITE_OK 
35a0: 29 7b 0a 20 20 20 20 20 20 70 50 61 72 73 65 2d  ){.      pParse-
35b0: 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20 20 20 20  >rc = rc;.      
35c0: 70 50 61 72 73 65 2d 3e 6e 45 72 72 2b 2b 3b 0a  pParse->nErr++;.
35d0: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62      }else if( db
35e0: 2d 3e 6e 6f 53 68 61 72 65 64 43 61 63 68 65 20  ->noSharedCache 
35f0: 29 7b 0a 20 20 20 20 20 20 64 62 2d 3e 6d 44 62  ){.      db->mDb
3600: 46 6c 61 67 73 20 7c 3d 20 44 42 46 4c 41 47 5f  Flags |= DBFLAG_
3610: 53 63 68 65 6d 61 4b 6e 6f 77 6e 4f 6b 3b 0a 20  SchemaKnownOk;. 
3620: 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72     }.  }.  retur
3630: 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20  n rc;.}.../*.** 
3640: 43 68 65 63 6b 20 73 63 68 65 6d 61 20 63 6f 6f  Check schema coo
3650: 6b 69 65 73 20 69 6e 20 61 6c 6c 20 64 61 74 61  kies in all data
3660: 62 61 73 65 73 2e 20 20 49 66 20 61 6e 79 20 63  bases.  If any c
3670: 6f 6f 6b 69 65 20 69 73 20 6f 75 74 0a 2a 2a 20  ookie is out.** 
3680: 6f 66 20 64 61 74 65 20 73 65 74 20 70 50 61 72  of date set pPar
3690: 73 65 2d 3e 72 63 20 74 6f 20 53 51 4c 49 54 45  se->rc to SQLITE
36a0: 5f 53 43 48 45 4d 41 2e 20 20 49 66 20 61 6c 6c  _SCHEMA.  If all
36b0: 20 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65 73 0a   schema cookies.
36c0: 2a 2a 20 6d 61 6b 65 20 6e 6f 20 63 68 61 6e 67  ** make no chang
36d0: 65 73 20 74 6f 20 70 50 61 72 73 65 2d 3e 72 63  es to pParse->rc
36e0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 6f 69 64  ..*/.static void
36f0: 20 73 63 68 65 6d 61 49 73 56 61 6c 69 64 28 50   schemaIsValid(P
3700: 61 72 73 65 20 2a 70 50 61 72 73 65 29 7b 0a 20  arse *pParse){. 
3710: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70   sqlite3 *db = p
3720: 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 69 6e 74  Parse->db;.  int
3730: 20 69 44 62 3b 0a 20 20 69 6e 74 20 72 63 3b 0a   iDb;.  int rc;.
3740: 20 20 69 6e 74 20 63 6f 6f 6b 69 65 3b 0a 0a 20    int cookie;.. 
3750: 20 61 73 73 65 72 74 28 20 70 50 61 72 73 65 2d   assert( pParse-
3760: 3e 63 68 65 63 6b 53 63 68 65 6d 61 20 29 3b 0a  >checkSchema );.
3770: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65    assert( sqlite
3780: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d  3_mutex_held(db-
3790: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 66 6f 72  >mutex) );.  for
37a0: 28 69 44 62 3d 30 3b 20 69 44 62 3c 64 62 2d 3e  (iDb=0; iDb<db->
37b0: 6e 44 62 3b 20 69 44 62 2b 2b 29 7b 0a 20 20 20  nDb; iDb++){.   
37c0: 20 69 6e 74 20 6f 70 65 6e 65 64 54 72 61 6e 73   int openedTrans
37d0: 61 63 74 69 6f 6e 20 3d 20 30 3b 20 20 20 20 20  action = 0;     
37e0: 20 20 20 20 2f 2a 20 54 72 75 65 20 69 66 20 61      /* True if a
37f0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73 20   transaction is 
3800: 6f 70 65 6e 65 64 20 2a 2f 0a 20 20 20 20 42 74  opened */.    Bt
3810: 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61  ree *pBt = db->a
3820: 44 62 5b 69 44 62 5d 2e 70 42 74 3b 20 20 20 20  Db[iDb].pBt;    
3830: 20 2f 2a 20 42 74 72 65 65 20 64 61 74 61 62 61   /* Btree databa
3840: 73 65 20 74 6f 20 72 65 61 64 20 63 6f 6f 6b 69  se to read cooki
3850: 65 20 66 72 6f 6d 20 2a 2f 0a 20 20 20 20 69 66  e from */.    if
3860: 28 20 70 42 74 3d 3d 30 20 29 20 63 6f 6e 74 69  ( pBt==0 ) conti
3870: 6e 75 65 3b 0a 0a 20 20 20 20 2f 2a 20 49 66 20  nue;..    /* If 
3880: 74 68 65 72 65 20 69 73 20 6e 6f 74 20 61 6c 72  there is not alr
3890: 65 61 64 79 20 61 20 72 65 61 64 2d 6f 6e 6c 79  eady a read-only
38a0: 20 28 6f 72 20 72 65 61 64 2d 77 72 69 74 65 29   (or read-write)
38b0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 6f 70 65   transaction ope
38c0: 6e 65 64 0a 20 20 20 20 2a 2a 20 6f 6e 20 74 68  ned.    ** on th
38d0: 65 20 62 2d 74 72 65 65 20 64 61 74 61 62 61 73  e b-tree databas
38e0: 65 2c 20 6f 70 65 6e 20 6f 6e 65 20 6e 6f 77 2e  e, open one now.
38f0: 20 49 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f   If a transactio
3900: 6e 20 69 73 20 6f 70 65 6e 65 64 2c 20 69 74 20  n is opened, it 
3910: 0a 20 20 20 20 2a 2a 20 77 69 6c 6c 20 62 65 20  .    ** will be 
3920: 63 6c 6f 73 65 64 20 69 6d 6d 65 64 69 61 74 65  closed immediate
3930: 6c 79 20 61 66 74 65 72 20 72 65 61 64 69 6e 67  ly after reading
3940: 20 74 68 65 20 6d 65 74 61 2d 76 61 6c 75 65 2e   the meta-value.
3950: 20 2a 2f 0a 20 20 20 20 69 66 28 20 21 73 71 6c   */.    if( !sql
3960: 69 74 65 33 42 74 72 65 65 49 73 49 6e 52 65 61  ite3BtreeIsInRea
3970: 64 54 72 61 6e 73 28 70 42 74 29 20 29 7b 0a 20  dTrans(pBt) ){. 
3980: 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 65       rc = sqlite
3990: 33 42 74 72 65 65 42 65 67 69 6e 54 72 61 6e 73  3BtreeBeginTrans
39a0: 28 70 42 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20  (pBt, 0, 0);.   
39b0: 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54     if( rc==SQLIT
39c0: 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 72 63 3d 3d 53  E_NOMEM || rc==S
39d0: 51 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45  QLITE_IOERR_NOME
39e0: 4d 20 29 7b 0a 20 20 20 20 20 20 20 20 73 71 6c  M ){.        sql
39f0: 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28 64 62 29  ite3OomFault(db)
3a00: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20  ;.      }.      
3a10: 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f  if( rc!=SQLITE_O
3a20: 4b 20 29 20 72 65 74 75 72 6e 3b 0a 20 20 20 20  K ) return;.    
3a30: 20 20 6f 70 65 6e 65 64 54 72 61 6e 73 61 63 74    openedTransact
3a40: 69 6f 6e 20 3d 20 31 3b 0a 20 20 20 20 7d 0a 0a  ion = 1;.    }..
3a50: 20 20 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20      /* Read the 
3a60: 73 63 68 65 6d 61 20 63 6f 6f 6b 69 65 20 66 72  schema cookie fr
3a70: 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2e  om the database.
3a80: 20 49 66 20 69 74 20 64 6f 65 73 20 6e 6f 74 20   If it does not 
3a90: 6d 61 74 63 68 20 74 68 65 20 0a 20 20 20 20 2a  match the .    *
3aa0: 2a 20 76 61 6c 75 65 20 73 74 6f 72 65 64 20 61  * value stored a
3ab0: 73 20 70 61 72 74 20 6f 66 20 74 68 65 20 69 6e  s part of the in
3ac0: 2d 6d 65 6d 6f 72 79 20 73 63 68 65 6d 61 20 72  -memory schema r
3ad0: 65 70 72 65 73 65 6e 74 61 74 69 6f 6e 2c 0a 20  epresentation,. 
3ae0: 20 20 20 2a 2a 20 73 65 74 20 50 61 72 73 65 2e     ** set Parse.
3af0: 72 63 20 74 6f 20 53 51 4c 49 54 45 5f 53 43 48  rc to SQLITE_SCH
3b00: 45 4d 41 2e 20 2a 2f 0a 20 20 20 20 73 71 6c 69  EMA. */.    sqli
3b10: 74 65 33 42 74 72 65 65 47 65 74 4d 65 74 61 28  te3BtreeGetMeta(
3b20: 70 42 74 2c 20 42 54 52 45 45 5f 53 43 48 45 4d  pBt, BTREE_SCHEM
3b30: 41 5f 56 45 52 53 49 4f 4e 2c 20 28 75 33 32 20  A_VERSION, (u32 
3b40: 2a 29 26 63 6f 6f 6b 69 65 29 3b 0a 20 20 20 20  *)&cookie);.    
3b50: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 53  assert( sqlite3S
3b60: 63 68 65 6d 61 4d 75 74 65 78 48 65 6c 64 28 64  chemaMutexHeld(d
3b70: 62 2c 20 69 44 62 2c 20 30 29 20 29 3b 0a 20 20  b, iDb, 0) );.  
3b80: 20 20 69 66 28 20 63 6f 6f 6b 69 65 21 3d 64 62    if( cookie!=db
3b90: 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 53 63 68 65  ->aDb[iDb].pSche
3ba0: 6d 61 2d 3e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69  ma->schema_cooki
3bb0: 65 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  e ){.      sqlit
3bc0: 65 33 52 65 73 65 74 4f 6e 65 53 63 68 65 6d 61  e3ResetOneSchema
3bd0: 28 64 62 2c 20 69 44 62 29 3b 0a 20 20 20 20 20  (db, iDb);.     
3be0: 20 70 50 61 72 73 65 2d 3e 72 63 20 3d 20 53 51   pParse->rc = SQ
3bf0: 4c 49 54 45 5f 53 43 48 45 4d 41 3b 0a 20 20 20  LITE_SCHEMA;.   
3c00: 20 7d 0a 0a 20 20 20 20 2f 2a 20 43 6c 6f 73 65   }..    /* Close
3c10: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
3c20: 2c 20 69 66 20 6f 6e 65 20 77 61 73 20 6f 70 65  , if one was ope
3c30: 6e 65 64 2e 20 2a 2f 0a 20 20 20 20 69 66 28 20  ned. */.    if( 
3c40: 6f 70 65 6e 65 64 54 72 61 6e 73 61 63 74 69 6f  openedTransactio
3c50: 6e 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  n ){.      sqlit
3c60: 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 70 42  e3BtreeCommit(pB
3c70: 74 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 7d 0a  t);.    }.  }.}.
3c80: 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 65 72 74 20 61  ./*.** Convert a
3c90: 20 73 63 68 65 6d 61 20 70 6f 69 6e 74 65 72 20   schema pointer 
3ca0: 69 6e 74 6f 20 74 68 65 20 69 44 62 20 69 6e 64  into the iDb ind
3cb0: 65 78 20 74 68 61 74 20 69 6e 64 69 63 61 74 65  ex that indicate
3cc0: 73 0a 2a 2a 20 77 68 69 63 68 20 64 61 74 61 62  s.** which datab
3cd0: 61 73 65 20 66 69 6c 65 20 69 6e 20 64 62 2d 3e  ase file in db->
3ce0: 61 44 62 5b 5d 20 74 68 65 20 73 63 68 65 6d 61  aDb[] the schema
3cf0: 20 72 65 66 65 72 73 20 74 6f 2e 0a 2a 2a 0a 2a   refers to..**.*
3d00: 2a 20 49 66 20 74 68 65 20 73 61 6d 65 20 64 61  * If the same da
3d10: 74 61 62 61 73 65 20 69 73 20 61 74 74 61 63 68  tabase is attach
3d20: 65 64 20 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 63  ed more than onc
3d30: 65 2c 20 74 68 65 20 66 69 72 73 74 0a 2a 2a 20  e, the first.** 
3d40: 61 74 74 61 63 68 65 64 20 64 61 74 61 62 61 73  attached databas
3d50: 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a  e is returned..*
3d60: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 53 63 68  /.int sqlite3Sch
3d70: 65 6d 61 54 6f 49 6e 64 65 78 28 73 71 6c 69 74  emaToIndex(sqlit
3d80: 65 33 20 2a 64 62 2c 20 53 63 68 65 6d 61 20 2a  e3 *db, Schema *
3d90: 70 53 63 68 65 6d 61 29 7b 0a 20 20 69 6e 74 20  pSchema){.  int 
3da0: 69 20 3d 20 2d 31 30 30 30 30 30 30 3b 0a 0a 20  i = -1000000;.. 
3db0: 20 2f 2a 20 49 66 20 70 53 63 68 65 6d 61 20 69   /* If pSchema i
3dc0: 73 20 4e 55 4c 4c 2c 20 74 68 65 6e 20 72 65 74  s NULL, then ret
3dd0: 75 72 6e 20 2d 31 30 30 30 30 30 30 2e 20 54 68  urn -1000000. Th
3de0: 69 73 20 68 61 70 70 65 6e 73 20 77 68 65 6e 20  is happens when 
3df0: 63 6f 64 65 20 69 6e 20 0a 20 20 2a 2a 20 65 78  code in .  ** ex
3e00: 70 72 2e 63 20 69 73 20 74 72 79 69 6e 67 20 74  pr.c is trying t
3e10: 6f 20 72 65 73 6f 6c 76 65 20 61 20 72 65 66 65  o resolve a refe
3e20: 72 65 6e 63 65 20 74 6f 20 61 20 74 72 61 6e 73  rence to a trans
3e30: 69 65 6e 74 20 74 61 62 6c 65 20 28 69 2e 65 2e  ient table (i.e.
3e40: 20 6f 6e 65 0a 20 20 2a 2a 20 63 72 65 61 74 65   one.  ** create
3e50: 64 20 62 79 20 61 20 73 75 62 2d 73 65 6c 65 63  d by a sub-selec
3e60: 74 29 2e 20 49 6e 20 74 68 69 73 20 63 61 73 65  t). In this case
3e70: 20 74 68 65 20 72 65 74 75 72 6e 20 76 61 6c 75   the return valu
3e80: 65 20 6f 66 20 74 68 69 73 20 0a 20 20 2a 2a 20  e of this .  ** 
3e90: 66 75 6e 63 74 69 6f 6e 20 73 68 6f 75 6c 64 20  function should 
3ea0: 6e 65 76 65 72 20 62 65 20 75 73 65 64 2e 0a 20  never be used.. 
3eb0: 20 2a 2a 0a 20 20 2a 2a 20 57 65 20 72 65 74 75   **.  ** We retu
3ec0: 72 6e 20 2d 31 30 30 30 30 30 30 20 69 6e 73 74  rn -1000000 inst
3ed0: 65 61 64 20 6f 66 20 74 68 65 20 6d 6f 72 65 20  ead of the more 
3ee0: 75 73 75 61 6c 20 2d 31 20 73 69 6d 70 6c 79 20  usual -1 simply 
3ef0: 62 65 63 61 75 73 65 20 75 73 69 6e 67 0a 20 20  because using.  
3f00: 2a 2a 20 2d 31 30 30 30 30 30 30 20 61 73 20 74  ** -1000000 as t
3f10: 68 65 20 69 6e 63 6f 72 72 65 63 74 20 69 6e 64  he incorrect ind
3f20: 65 78 20 69 6e 74 6f 20 64 62 2d 3e 61 44 62 5b  ex into db->aDb[
3f30: 5d 20 69 73 20 6d 75 63 68 20 0a 20 20 2a 2a 20  ] is much .  ** 
3f40: 6d 6f 72 65 20 6c 69 6b 65 6c 79 20 74 6f 20 63  more likely to c
3f50: 61 75 73 65 20 61 20 73 65 67 66 61 75 6c 74 20  ause a segfault 
3f60: 74 68 61 6e 20 2d 31 20 28 6f 66 20 63 6f 75 72  than -1 (of cour
3f70: 73 65 20 74 68 65 72 65 20 61 72 65 20 61 73 73  se there are ass
3f80: 65 72 74 28 29 0a 20 20 2a 2a 20 73 74 61 74 65  ert().  ** state
3f90: 6d 65 6e 74 73 20 74 6f 6f 2c 20 62 75 74 20 69  ments too, but i
3fa0: 74 20 6e 65 76 65 72 20 68 75 72 74 73 20 74 6f  t never hurts to
3fb0: 20 70 6c 61 79 20 74 68 65 20 6f 64 64 73 29 2e   play the odds).
3fc0: 0a 20 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20  .  */.  assert( 
3fd0: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
3fe0: 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b  ld(db->mutex) );
3ff0: 0a 20 20 69 66 28 20 70 53 63 68 65 6d 61 20 29  .  if( pSchema )
4000: 7b 0a 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 31  {.    for(i=0; 1
4010: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 61 73  ; i++){.      as
4020: 73 65 72 74 28 20 69 3c 64 62 2d 3e 6e 44 62 20  sert( i<db->nDb 
4030: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 64 62 2d  );.      if( db-
4040: 3e 61 44 62 5b 69 5d 2e 70 53 63 68 65 6d 61 3d  >aDb[i].pSchema=
4050: 3d 70 53 63 68 65 6d 61 20 29 7b 0a 20 20 20 20  =pSchema ){.    
4060: 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 20      break;.     
4070: 20 7d 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73   }.    }.    ass
4080: 65 72 74 28 20 69 3e 3d 30 20 26 26 20 69 3c 64  ert( i>=0 && i<d
4090: 62 2d 3e 6e 44 62 20 29 3b 0a 20 20 7d 0a 20 20  b->nDb );.  }.  
40a0: 72 65 74 75 72 6e 20 69 3b 0a 7d 0a 0a 2f 2a 0a  return i;.}../*.
40b0: 2a 2a 20 46 72 65 65 20 61 6c 6c 20 6d 65 6d 6f  ** Free all memo
40c0: 72 79 20 61 6c 6c 6f 63 61 74 69 6f 6e 73 20 69  ry allocations i
40d0: 6e 20 74 68 65 20 70 50 61 72 73 65 20 6f 62 6a  n the pParse obj
40e0: 65 63 74 0a 2a 2f 0a 76 6f 69 64 20 73 71 6c 69  ect.*/.void sqli
40f0: 74 65 33 50 61 72 73 65 72 52 65 73 65 74 28 50  te3ParserReset(P
4100: 61 72 73 65 20 2a 70 50 61 72 73 65 29 7b 0a 20  arse *pParse){. 
4110: 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70   sqlite3 *db = p
4120: 50 61 72 73 65 2d 3e 64 62 3b 0a 20 20 73 71 6c  Parse->db;.  sql
4130: 69 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70  ite3DbFree(db, p
4140: 50 61 72 73 65 2d 3e 61 4c 61 62 65 6c 29 3b 0a  Parse->aLabel);.
4150: 20 20 73 71 6c 69 74 65 33 45 78 70 72 4c 69 73    sqlite3ExprLis
4160: 74 44 65 6c 65 74 65 28 64 62 2c 20 70 50 61 72  tDelete(db, pPar
4170: 73 65 2d 3e 70 43 6f 6e 73 74 45 78 70 72 29 3b  se->pConstExpr);
4180: 0a 20 20 69 66 28 20 64 62 20 29 7b 0a 20 20 20  .  if( db ){.   
4190: 20 61 73 73 65 72 74 28 20 64 62 2d 3e 6c 6f 6f   assert( db->loo
41a0: 6b 61 73 69 64 65 2e 62 44 69 73 61 62 6c 65 20  kaside.bDisable 
41b0: 3e 3d 20 70 50 61 72 73 65 2d 3e 64 69 73 61 62  >= pParse->disab
41c0: 6c 65 4c 6f 6f 6b 61 73 69 64 65 20 29 3b 0a 20  leLookaside );. 
41d0: 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65     db->lookaside
41e0: 2e 62 44 69 73 61 62 6c 65 20 2d 3d 20 70 50 61  .bDisable -= pPa
41f0: 72 73 65 2d 3e 64 69 73 61 62 6c 65 4c 6f 6f 6b  rse->disableLook
4200: 61 73 69 64 65 3b 0a 20 20 7d 0a 20 20 70 50 61  aside;.  }.  pPa
4210: 72 73 65 2d 3e 64 69 73 61 62 6c 65 4c 6f 6f 6b  rse->disableLook
4220: 61 73 69 64 65 20 3d 20 30 3b 0a 7d 0a 0a 2f 2a  aside = 0;.}../*
4230: 0a 2a 2a 20 43 6f 6d 70 69 6c 65 20 74 68 65 20  .** Compile the 
4240: 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51  UTF-8 encoded SQ
4250: 4c 20 73 74 61 74 65 6d 65 6e 74 20 7a 53 71 6c  L statement zSql
4260: 20 69 6e 74 6f 20 61 20 73 74 61 74 65 6d 65 6e   into a statemen
4270: 74 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 73 74 61  t handle..*/.sta
4280: 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 50  tic int sqlite3P
4290: 72 65 70 61 72 65 28 0a 20 20 73 71 6c 69 74 65  repare(.  sqlite
42a0: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  3 *db,          
42b0: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20      /* Database 
42c0: 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e  handle. */.  con
42d0: 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20  st char *zSql,  
42e0: 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 20         /* UTF-8 
42f0: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74  encoded SQL stat
4300: 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20  ement. */.  int 
4310: 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 20  nBytes,         
4320: 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20        /* Length 
4330: 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73  of zSql in bytes
4340: 2e 20 2a 2f 0a 20 20 75 33 32 20 70 72 65 70 46  . */.  u32 prepF
4350: 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 20  lags,           
4360: 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65   /* Zero or more
4370: 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f   SQLITE_PREPARE_
4380: 2a 20 66 6c 61 67 73 20 2a 2f 0a 20 20 56 64 62  * flags */.  Vdb
4390: 65 20 2a 70 52 65 70 72 65 70 61 72 65 2c 20 20  e *pReprepare,  
43a0: 20 20 20 20 20 20 20 2f 2a 20 56 4d 20 62 65 69         /* VM bei
43b0: 6e 67 20 72 65 70 72 65 70 61 72 65 64 20 2a 2f  ng reprepared */
43c0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
43d0: 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20  **ppStmt,    /* 
43e0: 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74  OUT: A pointer t
43f0: 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73  o the prepared s
4400: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f  tatement */.  co
4410: 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 69  nst char **pzTai
4420: 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20  l       /* OUT: 
4430: 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74  End of parsed st
4440: 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 63 68 61  ring */.){.  cha
4450: 72 20 2a 7a 45 72 72 4d 73 67 20 3d 20 30 3b 20  r *zErrMsg = 0; 
4460: 20 20 20 20 20 20 20 2f 2a 20 45 72 72 6f 72 20         /* Error 
4470: 6d 65 73 73 61 67 65 20 2a 2f 0a 20 20 69 6e 74  message */.  int
4480: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b   rc = SQLITE_OK;
4490: 20 20 20 20 20 20 20 2f 2a 20 52 65 73 75 6c 74         /* Result
44a0: 20 63 6f 64 65 20 2a 2f 0a 20 20 69 6e 74 20 69   code */.  int i
44b0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ;               
44c0: 20 20 20 20 20 2f 2a 20 4c 6f 6f 70 20 63 6f 75       /* Loop cou
44d0: 6e 74 65 72 20 2a 2f 0a 20 20 50 61 72 73 65 20  nter */.  Parse 
44e0: 73 50 61 72 73 65 3b 20 20 20 20 20 20 20 20 20  sParse;         
44f0: 20 20 20 20 2f 2a 20 50 61 72 73 69 6e 67 20 63      /* Parsing c
4500: 6f 6e 74 65 78 74 20 2a 2f 0a 0a 20 20 6d 65 6d  ontext */..  mem
4510: 73 65 74 28 26 73 50 61 72 73 65 2c 20 30 2c 20  set(&sParse, 0, 
4520: 50 41 52 53 45 5f 48 44 52 5f 53 5a 29 3b 0a 20  PARSE_HDR_SZ);. 
4530: 20 6d 65 6d 73 65 74 28 50 41 52 53 45 5f 54 41   memset(PARSE_TA
4540: 49 4c 28 26 73 50 61 72 73 65 29 2c 20 30 2c 20  IL(&sParse), 0, 
4550: 50 41 52 53 45 5f 54 41 49 4c 5f 53 5a 29 3b 0a  PARSE_TAIL_SZ);.
4560: 20 20 73 50 61 72 73 65 2e 70 52 65 70 72 65 70    sParse.pReprep
4570: 61 72 65 20 3d 20 70 52 65 70 72 65 70 61 72 65  are = pReprepare
4580: 3b 0a 20 20 61 73 73 65 72 74 28 20 70 70 53 74  ;.  assert( ppSt
4590: 6d 74 20 26 26 20 2a 70 70 53 74 6d 74 3d 3d 30  mt && *ppStmt==0
45a0: 20 29 3b 0a 20 20 2f 2a 20 61 73 73 65 72 74 28   );.  /* assert(
45b0: 20 21 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c   !db->mallocFail
45c0: 65 64 20 29 3b 20 2f 2f 20 6e 6f 74 20 74 72 75  ed ); // not tru
45d0: 65 20 77 69 74 68 20 53 51 4c 49 54 45 5f 55 53  e with SQLITE_US
45e0: 45 5f 41 4c 4c 4f 43 41 20 2a 2f 0a 20 20 61 73  E_ALLOCA */.  as
45f0: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75  sert( sqlite3_mu
4600: 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74  tex_held(db->mut
4610: 65 78 29 20 29 3b 0a 0a 20 20 2f 2a 20 46 6f 72  ex) );..  /* For
4620: 20 61 20 6c 6f 6e 67 2d 74 65 72 6d 20 75 73 65   a long-term use
4630: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d   prepared statem
4640: 65 6e 74 20 61 76 6f 69 64 20 74 68 65 20 75 73  ent avoid the us
4650: 65 20 6f 66 0a 20 20 2a 2a 20 6c 6f 6f 6b 61 73  e of.  ** lookas
4660: 69 64 65 20 6d 65 6d 6f 72 79 2e 0a 20 20 2a 2f  ide memory..  */
4670: 0a 20 20 69 66 28 20 70 72 65 70 46 6c 61 67 73  .  if( prepFlags
4680: 20 26 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52   & SQLITE_PREPAR
4690: 45 5f 50 45 52 53 49 53 54 45 4e 54 20 29 7b 0a  E_PERSISTENT ){.
46a0: 20 20 20 20 73 50 61 72 73 65 2e 64 69 73 61 62      sParse.disab
46b0: 6c 65 4c 6f 6f 6b 61 73 69 64 65 2b 2b 3b 0a 20  leLookaside++;. 
46c0: 20 20 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65     db->lookaside
46d0: 2e 62 44 69 73 61 62 6c 65 2b 2b 3b 0a 20 20 7d  .bDisable++;.  }
46e0: 0a 20 20 73 50 61 72 73 65 2e 64 69 73 61 62 6c  .  sParse.disabl
46f0: 65 56 74 61 62 20 3d 20 28 70 72 65 70 46 6c 61  eVtab = (prepFla
4700: 67 73 20 26 20 53 51 4c 49 54 45 5f 50 52 45 50  gs & SQLITE_PREP
4710: 41 52 45 5f 4e 4f 5f 56 54 41 42 29 21 3d 30 3b  ARE_NO_VTAB)!=0;
4720: 0a 0a 20 20 2f 2a 20 43 68 65 63 6b 20 74 6f 20  ..  /* Check to 
4730: 76 65 72 69 66 79 20 74 68 61 74 20 69 74 20 69  verify that it i
4740: 73 20 70 6f 73 73 69 62 6c 65 20 74 6f 20 67 65  s possible to ge
4750: 74 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 6f 6e  t a read lock on
4760: 20 61 6c 6c 0a 20 20 2a 2a 20 64 61 74 61 62 61   all.  ** databa
4770: 73 65 20 73 63 68 65 6d 61 73 2e 20 20 54 68 65  se schemas.  The
4780: 20 69 6e 61 62 69 6c 69 74 79 20 74 6f 20 67 65   inability to ge
4790: 74 20 61 20 72 65 61 64 20 6c 6f 63 6b 20 69 6e  t a read lock in
47a0: 64 69 63 61 74 65 73 20 74 68 61 74 0a 20 20 2a  dicates that.  *
47b0: 2a 20 73 6f 6d 65 20 6f 74 68 65 72 20 64 61 74  * some other dat
47c0: 61 62 61 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e  abase connection
47d0: 20 69 73 20 68 6f 6c 64 69 6e 67 20 61 20 77 72   is holding a wr
47e0: 69 74 65 2d 6c 6f 63 6b 2c 20 77 68 69 63 68 20  ite-lock, which 
47f0: 69 6e 0a 20 20 2a 2a 20 74 75 72 6e 20 6d 65 61  in.  ** turn mea
4800: 6e 73 20 74 68 61 74 20 74 68 65 20 6f 74 68 65  ns that the othe
4810: 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61 73  r connection has
4820: 20 6d 61 64 65 20 75 6e 63 6f 6d 6d 69 74 74 65   made uncommitte
4830: 64 20 63 68 61 6e 67 65 73 0a 20 20 2a 2a 20 74  d changes.  ** t
4840: 6f 20 74 68 65 20 73 63 68 65 6d 61 2e 0a 20 20  o the schema..  
4850: 2a 2a 0a 20 20 2a 2a 20 57 65 72 65 20 77 65 20  **.  ** Were we 
4860: 74 6f 20 70 72 6f 63 65 65 64 20 61 6e 64 20 70  to proceed and p
4870: 72 65 70 61 72 65 20 74 68 65 20 73 74 61 74 65  repare the state
4880: 6d 65 6e 74 20 61 67 61 69 6e 73 74 20 74 68 65  ment against the
4890: 20 75 6e 63 6f 6d 6d 69 74 74 65 64 0a 20 20 2a   uncommitted.  *
48a0: 2a 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 73  * schema changes
48b0: 20 61 6e 64 20 69 66 20 74 68 6f 73 65 20 73 63   and if those sc
48c0: 68 65 6d 61 20 63 68 61 6e 67 65 73 20 61 72 65  hema changes are
48d0: 20 73 75 62 73 65 71 75 65 6e 74 6c 79 20 72 6f   subsequently ro
48e0: 6c 6c 65 64 0a 20 20 2a 2a 20 62 61 63 6b 20 61  lled.  ** back a
48f0: 6e 64 20 64 69 66 66 65 72 65 6e 74 20 63 68 61  nd different cha
4900: 6e 67 65 73 20 61 72 65 20 6d 61 64 65 20 69 6e  nges are made in
4910: 20 74 68 65 69 72 20 70 6c 61 63 65 2c 20 74 68   their place, th
4920: 65 6e 20 77 68 65 6e 20 74 68 69 73 0a 20 20 2a  en when this.  *
4930: 2a 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65  * prepared state
4940: 6d 65 6e 74 20 67 6f 65 73 20 74 6f 20 72 75 6e  ment goes to run
4950: 20 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6f 6b   the schema cook
4960: 69 65 20 77 6f 75 6c 64 20 66 61 69 6c 20 74 6f  ie would fail to
4970: 20 64 65 74 65 63 74 0a 20 20 2a 2a 20 74 68 65   detect.  ** the
4980: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 2e 20   schema change. 
4990: 20 44 69 73 61 73 74 65 72 20 77 6f 75 6c 64 20   Disaster would 
49a0: 66 6f 6c 6c 6f 77 2e 0a 20 20 2a 2a 0a 20 20 2a  follow..  **.  *
49b0: 2a 20 54 68 69 73 20 74 68 72 65 61 64 20 69 73  * This thread is
49c0: 20 63 75 72 72 65 6e 74 6c 79 20 68 6f 6c 64 69   currently holdi
49d0: 6e 67 20 6d 75 74 65 78 65 73 20 6f 6e 20 61 6c  ng mutexes on al
49e0: 6c 20 42 74 72 65 65 73 20 28 62 65 63 61 75 73  l Btrees (becaus
49f0: 65 0a 20 20 2a 2a 20 6f 66 20 74 68 65 20 73 71  e.  ** of the sq
4a00: 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 41  lite3BtreeEnterA
4a10: 6c 6c 28 29 20 69 6e 20 73 71 6c 69 74 65 33 4c  ll() in sqlite3L
4a20: 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28 29 29  ockAndPrepare())
4a30: 20 73 6f 20 69 74 0a 20 20 2a 2a 20 69 73 20 6e   so it.  ** is n
4a40: 6f 74 20 70 6f 73 73 69 62 6c 65 20 66 6f 72 20  ot possible for 
4a50: 61 6e 6f 74 68 65 72 20 74 68 72 65 61 64 20 74  another thread t
4a60: 6f 20 73 74 61 72 74 20 61 20 6e 65 77 20 73 63  o start a new sc
4a70: 68 65 6d 61 20 63 68 61 6e 67 65 0a 20 20 2a 2a  hema change.  **
4a80: 20 77 68 69 6c 65 20 74 68 69 73 20 72 6f 75 74   while this rout
4a90: 69 6e 65 20 69 73 20 72 75 6e 6e 69 6e 67 2e 20  ine is running. 
4aa0: 20 48 65 6e 63 65 2c 20 77 65 20 64 6f 20 6e 6f   Hence, we do no
4ab0: 74 20 6e 65 65 64 20 74 6f 20 68 6f 6c 64 20 0a  t need to hold .
4ac0: 20 20 2a 2a 20 6c 6f 63 6b 73 20 6f 6e 20 74 68    ** locks on th
4ad0: 65 20 73 63 68 65 6d 61 2c 20 77 65 20 6a 75 73  e schema, we jus
4ae0: 74 20 6e 65 65 64 20 74 6f 20 6d 61 6b 65 20 73  t need to make s
4af0: 75 72 65 20 6e 6f 62 6f 64 79 20 65 6c 73 65 20  ure nobody else 
4b00: 69 73 20 0a 20 20 2a 2a 20 68 6f 6c 64 69 6e 67  is .  ** holding
4b10: 20 74 68 65 6d 2e 0a 20 20 2a 2a 0a 20 20 2a 2a   them..  **.  **
4b20: 20 4e 6f 74 65 20 74 68 61 74 20 73 65 74 74 69   Note that setti
4b30: 6e 67 20 52 45 41 44 5f 55 4e 43 4f 4d 4d 49 54  ng READ_UNCOMMIT
4b40: 54 45 44 20 6f 76 65 72 72 69 64 65 73 20 6d 6f  TED overrides mo
4b50: 73 74 20 6c 6f 63 6b 20 64 65 74 65 63 74 69 6f  st lock detectio
4b60: 6e 2c 0a 20 20 2a 2a 20 62 75 74 20 69 74 20 64  n,.  ** but it d
4b70: 6f 65 73 20 2a 6e 6f 74 2a 20 6f 76 65 72 72 69  oes *not* overri
4b80: 64 65 20 73 63 68 65 6d 61 20 6c 6f 63 6b 20 64  de schema lock d
4b90: 65 74 65 63 74 69 6f 6e 2c 20 73 6f 20 74 68 69  etection, so thi
4ba0: 73 20 61 6c 6c 20 73 74 69 6c 6c 0a 20 20 2a 2a  s all still.  **
4bb0: 20 77 6f 72 6b 73 20 65 76 65 6e 20 69 66 20 52   works even if R
4bc0: 45 41 44 5f 55 4e 43 4f 4d 4d 49 54 54 45 44 20  EAD_UNCOMMITTED 
4bd0: 69 73 20 73 65 74 2e 0a 20 20 2a 2f 0a 20 20 66  is set..  */.  f
4be0: 6f 72 28 69 3d 30 3b 20 69 3c 64 62 2d 3e 6e 44  or(i=0; i<db->nD
4bf0: 62 3b 20 69 2b 2b 29 20 7b 0a 20 20 20 20 42 74  b; i++) {.    Bt
4c00: 72 65 65 20 2a 70 42 74 20 3d 20 64 62 2d 3e 61  ree *pBt = db->a
4c10: 44 62 5b 69 5d 2e 70 42 74 3b 0a 20 20 20 20 69  Db[i].pBt;.    i
4c20: 66 28 20 70 42 74 20 29 7b 0a 20 20 20 20 20 20  f( pBt ){.      
4c30: 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 42  assert( sqlite3B
4c40: 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 70  treeHoldsMutex(p
4c50: 42 74 29 20 29 3b 0a 20 20 20 20 20 20 72 63 20  Bt) );.      rc 
4c60: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 63  = sqlite3BtreeSc
4c70: 68 65 6d 61 4c 6f 63 6b 65 64 28 70 42 74 29 3b  hemaLocked(pBt);
4c80: 0a 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b  .      if( rc ){
4c90: 0a 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20 63  .        const c
4ca0: 68 61 72 20 2a 7a 44 62 20 3d 20 64 62 2d 3e 61  har *zDb = db->a
4cb0: 44 62 5b 69 5d 2e 7a 44 62 53 4e 61 6d 65 3b 0a  Db[i].zDbSName;.
4cc0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 45          sqlite3E
4cd0: 72 72 6f 72 57 69 74 68 4d 73 67 28 64 62 2c 20  rrorWithMsg(db, 
4ce0: 72 63 2c 20 22 64 61 74 61 62 61 73 65 20 73 63  rc, "database sc
4cf0: 68 65 6d 61 20 69 73 20 6c 6f 63 6b 65 64 3a 20  hema is locked: 
4d00: 25 73 22 2c 20 7a 44 62 29 3b 0a 20 20 20 20 20  %s", zDb);.     
4d10: 20 20 20 74 65 73 74 63 61 73 65 28 20 64 62 2d     testcase( db-
4d20: 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f  >flags & SQLITE_
4d30: 52 65 61 64 55 6e 63 6f 6d 6d 69 74 20 29 3b 0a  ReadUncommit );.
4d40: 20 20 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64          goto end
4d50: 5f 70 72 65 70 61 72 65 3b 0a 20 20 20 20 20 20  _prepare;.      
4d60: 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 73  }.    }.  }..  s
4d70: 71 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 6b  qlite3VtabUnlock
4d80: 4c 69 73 74 28 64 62 29 3b 0a 0a 20 20 73 50 61  List(db);..  sPa
4d90: 72 73 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20 69  rse.db = db;.  i
4da0: 66 28 20 6e 42 79 74 65 73 3e 3d 30 20 26 26 20  f( nBytes>=0 && 
4db0: 28 6e 42 79 74 65 73 3d 3d 30 20 7c 7c 20 7a 53  (nBytes==0 || zS
4dc0: 71 6c 5b 6e 42 79 74 65 73 2d 31 5d 21 3d 30 29  ql[nBytes-1]!=0)
4dd0: 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a 53   ){.    char *zS
4de0: 71 6c 43 6f 70 79 3b 0a 20 20 20 20 69 6e 74 20  qlCopy;.    int 
4df0: 6d 78 4c 65 6e 20 3d 20 64 62 2d 3e 61 4c 69 6d  mxLen = db->aLim
4e00: 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 5f  it[SQLITE_LIMIT_
4e10: 53 51 4c 5f 4c 45 4e 47 54 48 5d 3b 0a 20 20 20  SQL_LENGTH];.   
4e20: 20 74 65 73 74 63 61 73 65 28 20 6e 42 79 74 65   testcase( nByte
4e30: 73 3d 3d 6d 78 4c 65 6e 20 29 3b 0a 20 20 20 20  s==mxLen );.    
4e40: 74 65 73 74 63 61 73 65 28 20 6e 42 79 74 65 73  testcase( nBytes
4e50: 3d 3d 6d 78 4c 65 6e 2b 31 20 29 3b 0a 20 20 20  ==mxLen+1 );.   
4e60: 20 69 66 28 20 6e 42 79 74 65 73 3e 6d 78 4c 65   if( nBytes>mxLe
4e70: 6e 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  n ){.      sqlit
4e80: 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64  e3ErrorWithMsg(d
4e90: 62 2c 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47  b, SQLITE_TOOBIG
4ea0: 2c 20 22 73 74 61 74 65 6d 65 6e 74 20 74 6f 6f  , "statement too
4eb0: 20 6c 6f 6e 67 22 29 3b 0a 20 20 20 20 20 20 72   long");.      r
4ec0: 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78  c = sqlite3ApiEx
4ed0: 69 74 28 64 62 2c 20 53 51 4c 49 54 45 5f 54 4f  it(db, SQLITE_TO
4ee0: 4f 42 49 47 29 3b 0a 20 20 20 20 20 20 67 6f 74  OBIG);.      got
4ef0: 6f 20 65 6e 64 5f 70 72 65 70 61 72 65 3b 0a 20  o end_prepare;. 
4f00: 20 20 20 7d 0a 20 20 20 20 7a 53 71 6c 43 6f 70     }.    zSqlCop
4f10: 79 20 3d 20 73 71 6c 69 74 65 33 44 62 53 74 72  y = sqlite3DbStr
4f20: 4e 44 75 70 28 64 62 2c 20 7a 53 71 6c 2c 20 6e  NDup(db, zSql, n
4f30: 42 79 74 65 73 29 3b 0a 20 20 20 20 69 66 28 20  Bytes);.    if( 
4f40: 7a 53 71 6c 43 6f 70 79 20 29 7b 0a 20 20 20 20  zSqlCopy ){.    
4f50: 20 20 73 71 6c 69 74 65 33 52 75 6e 50 61 72 73    sqlite3RunPars
4f60: 65 72 28 26 73 50 61 72 73 65 2c 20 7a 53 71 6c  er(&sParse, zSql
4f70: 43 6f 70 79 2c 20 26 7a 45 72 72 4d 73 67 29 3b  Copy, &zErrMsg);
4f80: 0a 20 20 20 20 20 20 73 50 61 72 73 65 2e 7a 54  .      sParse.zT
4f90: 61 69 6c 20 3d 20 26 7a 53 71 6c 5b 73 50 61 72  ail = &zSql[sPar
4fa0: 73 65 2e 7a 54 61 69 6c 2d 7a 53 71 6c 43 6f 70  se.zTail-zSqlCop
4fb0: 79 5d 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 65  y];.      sqlite
4fc0: 33 44 62 46 72 65 65 28 64 62 2c 20 7a 53 71 6c  3DbFree(db, zSql
4fd0: 43 6f 70 79 29 3b 0a 20 20 20 20 7d 65 6c 73 65  Copy);.    }else
4fe0: 7b 0a 20 20 20 20 20 20 73 50 61 72 73 65 2e 7a  {.      sParse.z
4ff0: 54 61 69 6c 20 3d 20 26 7a 53 71 6c 5b 6e 42 79  Tail = &zSql[nBy
5000: 74 65 73 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d 65  tes];.    }.  }e
5010: 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33  lse{.    sqlite3
5020: 52 75 6e 50 61 72 73 65 72 28 26 73 50 61 72 73  RunParser(&sPars
5030: 65 2c 20 7a 53 71 6c 2c 20 26 7a 45 72 72 4d 73  e, zSql, &zErrMs
5040: 67 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 74  g);.  }.  assert
5050: 28 20 30 3d 3d 73 50 61 72 73 65 2e 6e 51 75 65  ( 0==sParse.nQue
5060: 72 79 4c 6f 6f 70 20 29 3b 0a 0a 20 20 69 66 28  ryLoop );..  if(
5070: 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c 49   sParse.rc==SQLI
5080: 54 45 5f 44 4f 4e 45 20 29 20 73 50 61 72 73 65  TE_DONE ) sParse
5090: 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b  .rc = SQLITE_OK;
50a0: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 63 68  .  if( sParse.ch
50b0: 65 63 6b 53 63 68 65 6d 61 20 29 7b 0a 20 20 20  eckSchema ){.   
50c0: 20 73 63 68 65 6d 61 49 73 56 61 6c 69 64 28 26   schemaIsValid(&
50d0: 73 50 61 72 73 65 29 3b 0a 20 20 7d 0a 20 20 69  sParse);.  }.  i
50e0: 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69  f( db->mallocFai
50f0: 6c 65 64 20 29 7b 0a 20 20 20 20 73 50 61 72 73  led ){.    sPars
5100: 65 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f  e.rc = SQLITE_NO
5110: 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20  MEM_BKPT;.  }.  
5120: 69 66 28 20 70 7a 54 61 69 6c 20 29 7b 0a 20 20  if( pzTail ){.  
5130: 20 20 2a 70 7a 54 61 69 6c 20 3d 20 73 50 61 72    *pzTail = sPar
5140: 73 65 2e 7a 54 61 69 6c 3b 0a 20 20 7d 0a 20 20  se.zTail;.  }.  
5150: 72 63 20 3d 20 73 50 61 72 73 65 2e 72 63 3b 0a  rc = sParse.rc;.
5160: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f  .#ifndef SQLITE_
5170: 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20 69  OMIT_EXPLAIN.  i
5180: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b  f( rc==SQLITE_OK
5190: 20 26 26 20 73 50 61 72 73 65 2e 70 56 64 62 65   && sParse.pVdbe
51a0: 20 26 26 20 73 50 61 72 73 65 2e 65 78 70 6c 61   && sParse.expla
51b0: 69 6e 20 29 7b 0a 20 20 20 20 73 74 61 74 69 63  in ){.    static
51c0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 20 63 6f   const char * co
51d0: 6e 73 74 20 61 7a 43 6f 6c 4e 61 6d 65 5b 5d 20  nst azColName[] 
51e0: 3d 20 7b 0a 20 20 20 20 20 20 20 22 61 64 64 72  = {.       "addr
51f0: 22 2c 20 22 6f 70 63 6f 64 65 22 2c 20 22 70 31  ", "opcode", "p1
5200: 22 2c 20 22 70 32 22 2c 20 22 70 33 22 2c 20 22  ", "p2", "p3", "
5210: 70 34 22 2c 20 22 70 35 22 2c 20 22 63 6f 6d 6d  p4", "p5", "comm
5220: 65 6e 74 22 2c 0a 20 20 20 20 20 20 20 22 69 64  ent",.       "id
5230: 22 2c 20 22 70 61 72 65 6e 74 22 2c 20 22 6e 6f  ", "parent", "no
5240: 74 75 73 65 64 22 2c 20 22 64 65 74 61 69 6c 22  tused", "detail"
5250: 0a 20 20 20 20 7d 3b 0a 20 20 20 20 69 6e 74 20  .    };.    int 
5260: 69 46 69 72 73 74 2c 20 6d 78 3b 0a 20 20 20 20  iFirst, mx;.    
5270: 69 66 28 20 73 50 61 72 73 65 2e 65 78 70 6c 61  if( sParse.expla
5280: 69 6e 3d 3d 32 20 29 7b 0a 20 20 20 20 20 20 73  in==2 ){.      s
5290: 71 6c 69 74 65 33 56 64 62 65 53 65 74 4e 75 6d  qlite3VdbeSetNum
52a0: 43 6f 6c 73 28 73 50 61 72 73 65 2e 70 56 64 62  Cols(sParse.pVdb
52b0: 65 2c 20 34 29 3b 0a 20 20 20 20 20 20 69 46 69  e, 4);.      iFi
52c0: 72 73 74 20 3d 20 38 3b 0a 20 20 20 20 20 20 6d  rst = 8;.      m
52d0: 78 20 3d 20 31 32 3b 0a 20 20 20 20 7d 65 6c 73  x = 12;.    }els
52e0: 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33  e{.      sqlite3
52f0: 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 28 73  VdbeSetNumCols(s
5300: 50 61 72 73 65 2e 70 56 64 62 65 2c 20 38 29 3b  Parse.pVdbe, 8);
5310: 0a 20 20 20 20 20 20 69 46 69 72 73 74 20 3d 20  .      iFirst = 
5320: 30 3b 0a 20 20 20 20 20 20 6d 78 20 3d 20 38 3b  0;.      mx = 8;
5330: 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 72 28 69  .    }.    for(i
5340: 3d 69 46 69 72 73 74 3b 20 69 3c 6d 78 3b 20 69  =iFirst; i<mx; i
5350: 2b 2b 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74  ++){.      sqlit
5360: 65 33 56 64 62 65 53 65 74 43 6f 6c 4e 61 6d 65  e3VdbeSetColName
5370: 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 69  (sParse.pVdbe, i
5380: 2d 69 46 69 72 73 74 2c 20 43 4f 4c 4e 41 4d 45  -iFirst, COLNAME
5390: 5f 4e 41 4d 45 2c 0a 20 20 20 20 20 20 20 20 20  _NAME,.         
53a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
53b0: 20 20 20 61 7a 43 6f 6c 4e 61 6d 65 5b 69 5d 2c     azColName[i],
53c0: 20 53 51 4c 49 54 45 5f 53 54 41 54 49 43 29 3b   SQLITE_STATIC);
53d0: 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 6e 64 69  .    }.  }.#endi
53e0: 66 0a 0a 20 20 69 66 28 20 64 62 2d 3e 69 6e 69  f..  if( db->ini
53f0: 74 2e 62 75 73 79 3d 3d 30 20 29 7b 0a 20 20 20  t.busy==0 ){.   
5400: 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 53   sqlite3VdbeSetS
5410: 71 6c 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c  ql(sParse.pVdbe,
5420: 20 7a 53 71 6c 2c 20 28 69 6e 74 29 28 73 50 61   zSql, (int)(sPa
5430: 72 73 65 2e 7a 54 61 69 6c 2d 7a 53 71 6c 29 2c  rse.zTail-zSql),
5440: 20 70 72 65 70 46 6c 61 67 73 29 3b 0a 20 20 7d   prepFlags);.  }
5450: 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 70 56  .  if( sParse.pV
5460: 64 62 65 20 26 26 20 28 72 63 21 3d 53 51 4c 49  dbe && (rc!=SQLI
5470: 54 45 5f 4f 4b 20 7c 7c 20 64 62 2d 3e 6d 61 6c  TE_OK || db->mal
5480: 6c 6f 63 46 61 69 6c 65 64 29 20 29 7b 0a 20 20  locFailed) ){.  
5490: 20 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 6e    sqlite3VdbeFin
54a0: 61 6c 69 7a 65 28 73 50 61 72 73 65 2e 70 56 64  alize(sParse.pVd
54b0: 62 65 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28  be);.    assert(
54c0: 21 28 2a 70 70 53 74 6d 74 29 29 3b 0a 20 20 7d  !(*ppStmt));.  }
54d0: 65 6c 73 65 7b 0a 20 20 20 20 2a 70 70 53 74 6d  else{.    *ppStm
54e0: 74 20 3d 20 28 73 71 6c 69 74 65 33 5f 73 74 6d  t = (sqlite3_stm
54f0: 74 2a 29 73 50 61 72 73 65 2e 70 56 64 62 65 3b  t*)sParse.pVdbe;
5500: 0a 20 20 7d 0a 0a 20 20 69 66 28 20 7a 45 72 72  .  }..  if( zErr
5510: 4d 73 67 20 29 7b 0a 20 20 20 20 73 71 6c 69 74  Msg ){.    sqlit
5520: 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64  e3ErrorWithMsg(d
5530: 62 2c 20 72 63 2c 20 22 25 73 22 2c 20 7a 45 72  b, rc, "%s", zEr
5540: 72 4d 73 67 29 3b 0a 20 20 20 20 73 71 6c 69 74  rMsg);.    sqlit
5550: 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a 45 72  e3DbFree(db, zEr
5560: 72 4d 73 67 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a  rMsg);.  }else{.
5570: 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72      sqlite3Error
5580: 28 64 62 2c 20 72 63 29 3b 0a 20 20 7d 0a 0a 20  (db, rc);.  }.. 
5590: 20 2f 2a 20 44 65 6c 65 74 65 20 61 6e 79 20 54   /* Delete any T
55a0: 72 69 67 67 65 72 50 72 67 20 73 74 72 75 63 74  riggerPrg struct
55b0: 75 72 65 73 20 61 6c 6c 6f 63 61 74 65 64 20 77  ures allocated w
55c0: 68 69 6c 65 20 70 61 72 73 69 6e 67 20 74 68 69  hile parsing thi
55d0: 73 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a  s statement. */.
55e0: 20 20 77 68 69 6c 65 28 20 73 50 61 72 73 65 2e    while( sParse.
55f0: 70 54 72 69 67 67 65 72 50 72 67 20 29 7b 0a 20  pTriggerPrg ){. 
5600: 20 20 20 54 72 69 67 67 65 72 50 72 67 20 2a 70     TriggerPrg *p
5610: 54 20 3d 20 73 50 61 72 73 65 2e 70 54 72 69 67  T = sParse.pTrig
5620: 67 65 72 50 72 67 3b 0a 20 20 20 20 73 50 61 72  gerPrg;.    sPar
5630: 73 65 2e 70 54 72 69 67 67 65 72 50 72 67 20 3d  se.pTriggerPrg =
5640: 20 70 54 2d 3e 70 4e 65 78 74 3b 0a 20 20 20 20   pT->pNext;.    
5650: 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62  sqlite3DbFree(db
5660: 2c 20 70 54 29 3b 0a 20 20 7d 0a 0a 65 6e 64 5f  , pT);.  }..end_
5670: 70 72 65 70 61 72 65 3a 0a 0a 20 20 73 71 6c 69  prepare:..  sqli
5680: 74 65 33 50 61 72 73 65 72 52 65 73 65 74 28 26  te3ParserReset(&
5690: 73 50 61 72 73 65 29 3b 0a 20 20 72 65 74 75 72  sParse);.  retur
56a0: 6e 20 72 63 3b 0a 7d 0a 73 74 61 74 69 63 20 69  n rc;.}.static i
56b0: 6e 74 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e  nt sqlite3LockAn
56c0: 64 50 72 65 70 61 72 65 28 0a 20 20 73 71 6c 69  dPrepare(.  sqli
56d0: 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20  te3 *db,        
56e0: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73        /* Databas
56f0: 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63  e handle. */.  c
5700: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c  onst char *zSql,
5710: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d           /* UTF-
5720: 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  8 encoded SQL st
5730: 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e  atement. */.  in
5740: 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20  t nBytes,       
5750: 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74          /* Lengt
5760: 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74  h of zSql in byt
5770: 65 73 2e 20 2a 2f 0a 20 20 75 33 32 20 70 72 65  es. */.  u32 pre
5780: 70 46 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20  pFlags,         
5790: 20 20 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f     /* Zero or mo
57a0: 72 65 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52  re SQLITE_PREPAR
57b0: 45 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a 20 20 56  E_* flags */.  V
57c0: 64 62 65 20 2a 70 4f 6c 64 2c 20 20 20 20 20 20  dbe *pOld,      
57d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 56 4d 20 62           /* VM b
57e0: 65 69 6e 67 20 72 65 70 72 65 70 61 72 65 64 20  eing reprepared 
57f0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d  */.  sqlite3_stm
5800: 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f  t **ppStmt,    /
5810: 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72  * OUT: A pointer
5820: 20 74 6f 20 74 68 65 20 70 72 65 70 61 72 65 64   to the prepared
5830: 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20   statement */.  
5840: 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54  const char **pzT
5850: 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54  ail       /* OUT
5860: 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20  : End of parsed 
5870: 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69  string */.){.  i
5880: 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 63 6e 74  nt rc;.  int cnt
5890: 20 3d 20 30 3b 0a 0a 23 69 66 64 65 66 20 53 51   = 0;..#ifdef SQ
58a0: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f  LITE_ENABLE_API_
58b0: 41 52 4d 4f 52 0a 20 20 69 66 28 20 70 70 53 74  ARMOR.  if( ppSt
58c0: 6d 74 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53  mt==0 ) return S
58d0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50  QLITE_MISUSE_BKP
58e0: 54 3b 0a 23 65 6e 64 69 66 0a 20 20 2a 70 70 53  T;.#endif.  *ppS
58f0: 74 6d 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 21  tmt = 0;.  if( !
5900: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65  sqlite3SafetyChe
5910: 63 6b 4f 6b 28 64 62 29 7c 7c 7a 53 71 6c 3d 3d  ckOk(db)||zSql==
5920: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20  0 ){.    return 
5930: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b  SQLITE_MISUSE_BK
5940: 50 54 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65  PT;.  }.  sqlite
5950: 33 5f 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62  3_mutex_enter(db
5960: 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c 69  ->mutex);.  sqli
5970: 74 65 33 42 74 72 65 65 45 6e 74 65 72 41 6c 6c  te3BtreeEnterAll
5980: 28 64 62 29 3b 0a 20 20 64 6f 7b 0a 20 20 20 20  (db);.  do{.    
5990: 2f 2a 20 4d 61 6b 65 20 6d 75 6c 74 69 70 6c 65  /* Make multiple
59a0: 20 61 74 74 65 6d 70 74 73 20 74 6f 20 63 6f 6d   attempts to com
59b0: 70 69 6c 65 20 74 68 65 20 53 51 4c 2c 20 75 6e  pile the SQL, un
59c0: 74 69 6c 20 69 74 20 65 69 74 68 65 72 20 73 75  til it either su
59d0: 63 63 65 65 64 73 0a 20 20 20 20 2a 2a 20 6f 72  cceeds.    ** or
59e0: 20 65 6e 63 6f 75 6e 74 65 72 73 20 61 20 70 65   encounters a pe
59f0: 72 6d 61 6e 65 6e 74 20 65 72 72 6f 72 2e 20 20  rmanent error.  
5a00: 41 20 73 63 68 65 6d 61 20 70 72 6f 62 6c 65 6d  A schema problem
5a10: 20 61 66 74 65 72 20 6f 6e 65 20 73 63 68 65 6d   after one schem
5a20: 61 0a 20 20 20 20 2a 2a 20 72 65 73 65 74 20 69  a.    ** reset i
5a30: 73 20 63 6f 6e 73 69 64 65 72 65 64 20 61 20 70  s considered a p
5a40: 65 72 6d 61 6e 65 6e 74 20 65 72 72 6f 72 2e 20  ermanent error. 
5a50: 2a 2f 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69  */.    rc = sqli
5a60: 74 65 33 50 72 65 70 61 72 65 28 64 62 2c 20 7a  te3Prepare(db, z
5a70: 53 71 6c 2c 20 6e 42 79 74 65 73 2c 20 70 72 65  Sql, nBytes, pre
5a80: 70 46 6c 61 67 73 2c 20 70 4f 6c 64 2c 20 70 70  pFlags, pOld, pp
5a90: 53 74 6d 74 2c 20 70 7a 54 61 69 6c 29 3b 0a 20  Stmt, pzTail);. 
5aa0: 20 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53     assert( rc==S
5ab0: 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 2a 70 70 53  QLITE_OK || *ppS
5ac0: 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 7d 77 68 69  tmt==0 );.  }whi
5ad0: 6c 65 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 45  le( rc==SQLITE_E
5ae0: 52 52 4f 52 5f 52 45 54 52 59 0a 20 20 20 20 20  RROR_RETRY.     
5af0: 20 20 7c 7c 20 28 72 63 3d 3d 53 51 4c 49 54 45    || (rc==SQLITE
5b00: 5f 53 43 48 45 4d 41 20 26 26 20 28 73 71 6c 69  _SCHEMA && (sqli
5b10: 74 65 33 52 65 73 65 74 4f 6e 65 53 63 68 65 6d  te3ResetOneSchem
5b20: 61 28 64 62 2c 2d 31 29 2c 20 63 6e 74 2b 2b 29  a(db,-1), cnt++)
5b30: 3d 3d 30 29 20 29 3b 0a 20 20 73 71 6c 69 74 65  ==0) );.  sqlite
5b40: 33 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64  3BtreeLeaveAll(d
5b50: 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  b);.  rc = sqlit
5b60: 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63  e3ApiExit(db, rc
5b70: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 72 63  );.  assert( (rc
5b80: 26 64 62 2d 3e 65 72 72 4d 61 73 6b 29 3d 3d 72  &db->errMask)==r
5b90: 63 20 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d  c );.  sqlite3_m
5ba0: 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d  utex_leave(db->m
5bb0: 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20  utex);.  return 
5bc0: 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 52 65  rc;.}.../*.** Re
5bd0: 72 75 6e 20 74 68 65 20 63 6f 6d 70 69 6c 61 74  run the compilat
5be0: 69 6f 6e 20 6f 66 20 61 20 73 74 61 74 65 6d 65  ion of a stateme
5bf0: 6e 74 20 61 66 74 65 72 20 61 20 73 63 68 65 6d  nt after a schem
5c00: 61 20 63 68 61 6e 67 65 2e 0a 2a 2a 0a 2a 2a 20  a change..**.** 
5c10: 49 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  If the statement
5c20: 20 69 73 20 73 75 63 63 65 73 73 66 75 6c 6c 79   is successfully
5c30: 20 72 65 63 6f 6d 70 69 6c 65 64 2c 20 72 65 74   recompiled, ret
5c40: 75 72 6e 20 53 51 4c 49 54 45 5f 4f 4b 2e 20 4f  urn SQLITE_OK. O
5c50: 74 68 65 72 77 69 73 65 2c 0a 2a 2a 20 69 66 20  therwise,.** if 
5c60: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 63 61  the statement ca
5c70: 6e 6e 6f 74 20 62 65 20 72 65 63 6f 6d 70 69 6c  nnot be recompil
5c80: 65 64 20 62 65 63 61 75 73 65 20 61 6e 6f 74 68  ed because anoth
5c90: 65 72 20 63 6f 6e 6e 65 63 74 69 6f 6e 20 68 61  er connection ha
5ca0: 73 0a 2a 2a 20 6c 6f 63 6b 65 64 20 74 68 65 20  s.** locked the 
5cb0: 73 71 6c 69 74 65 33 5f 6d 61 73 74 65 72 20 74  sqlite3_master t
5cc0: 61 62 6c 65 2c 20 72 65 74 75 72 6e 20 53 51 4c  able, return SQL
5cd0: 49 54 45 5f 4c 4f 43 4b 45 44 2e 20 49 66 20 61  ITE_LOCKED. If a
5ce0: 6e 79 20 6f 74 68 65 72 20 65 72 72 6f 72 0a 2a  ny other error.*
5cf0: 2a 20 6f 63 63 75 72 73 2c 20 72 65 74 75 72 6e  * occurs, return
5d00: 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 2e 0a   SQLITE_SCHEMA..
5d10: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65  */.int sqlite3Re
5d20: 70 72 65 70 61 72 65 28 56 64 62 65 20 2a 70 29  prepare(Vdbe *p)
5d30: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 73 71  {.  int rc;.  sq
5d40: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 70 4e 65 77  lite3_stmt *pNew
5d50: 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a  ;.  const char *
5d60: 7a 53 71 6c 3b 0a 20 20 73 71 6c 69 74 65 33 20  zSql;.  sqlite3 
5d70: 2a 64 62 3b 0a 20 20 75 38 20 70 72 65 70 46 6c  *db;.  u8 prepFl
5d80: 61 67 73 3b 0a 0a 20 20 61 73 73 65 72 74 28 20  ags;..  assert( 
5d90: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65  sqlite3_mutex_he
5da0: 6c 64 28 73 71 6c 69 74 65 33 56 64 62 65 44 62  ld(sqlite3VdbeDb
5db0: 28 70 29 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20  (p)->mutex) );. 
5dc0: 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74 65 33 5f   zSql = sqlite3_
5dd0: 73 71 6c 28 28 73 71 6c 69 74 65 33 5f 73 74 6d  sql((sqlite3_stm
5de0: 74 20 2a 29 70 29 3b 0a 20 20 61 73 73 65 72 74  t *)p);.  assert
5df0: 28 20 7a 53 71 6c 21 3d 30 20 29 3b 20 20 2f 2a  ( zSql!=0 );  /*
5e00: 20 52 65 70 72 65 70 61 72 65 20 6f 6e 6c 79 20   Reprepare only 
5e10: 63 61 6c 6c 65 64 20 66 6f 72 20 70 72 65 70 61  called for prepa
5e20: 72 65 5f 76 32 28 29 20 73 74 61 74 65 6d 65 6e  re_v2() statemen
5e30: 74 73 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 6c  ts */.  db = sql
5e40: 69 74 65 33 56 64 62 65 44 62 28 70 29 3b 0a 20  ite3VdbeDb(p);. 
5e50: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33   assert( sqlite3
5e60: 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e  _mutex_held(db->
5e70: 6d 75 74 65 78 29 20 29 3b 0a 20 20 70 72 65 70  mutex) );.  prep
5e80: 46 6c 61 67 73 20 3d 20 73 71 6c 69 74 65 33 56  Flags = sqlite3V
5e90: 64 62 65 50 72 65 70 61 72 65 46 6c 61 67 73 28  dbePrepareFlags(
5ea0: 70 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74  p);.  rc = sqlit
5eb0: 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65  e3LockAndPrepare
5ec0: 28 64 62 2c 20 7a 53 71 6c 2c 20 2d 31 2c 20 70  (db, zSql, -1, p
5ed0: 72 65 70 46 6c 61 67 73 2c 20 70 2c 20 26 70 4e  repFlags, p, &pN
5ee0: 65 77 2c 20 30 29 3b 0a 20 20 69 66 28 20 72 63  ew, 0);.  if( rc
5ef0: 20 29 7b 0a 20 20 20 20 69 66 28 20 72 63 3d 3d   ){.    if( rc==
5f00: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a  SQLITE_NOMEM ){.
5f10: 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 6f 6d        sqlite3Oom
5f20: 46 61 75 6c 74 28 64 62 29 3b 0a 20 20 20 20 7d  Fault(db);.    }
5f30: 0a 20 20 20 20 61 73 73 65 72 74 28 20 70 4e 65  .    assert( pNe
5f40: 77 3d 3d 30 20 29 3b 0a 20 20 20 20 72 65 74 75  w==0 );.    retu
5f50: 72 6e 20 72 63 3b 0a 20 20 7d 65 6c 73 65 7b 0a  rn rc;.  }else{.
5f60: 20 20 20 20 61 73 73 65 72 74 28 20 70 4e 65 77      assert( pNew
5f70: 21 3d 30 20 29 3b 0a 20 20 7d 0a 20 20 73 71 6c  !=0 );.  }.  sql
5f80: 69 74 65 33 56 64 62 65 53 77 61 70 28 28 56 64  ite3VdbeSwap((Vd
5f90: 62 65 2a 29 70 4e 65 77 2c 20 70 29 3b 0a 20 20  be*)pNew, p);.  
5fa0: 73 71 6c 69 74 65 33 54 72 61 6e 73 66 65 72 42  sqlite3TransferB
5fb0: 69 6e 64 69 6e 67 73 28 70 4e 65 77 2c 20 28 73  indings(pNew, (s
5fc0: 71 6c 69 74 65 33 5f 73 74 6d 74 2a 29 70 29 3b  qlite3_stmt*)p);
5fd0: 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 52 65  .  sqlite3VdbeRe
5fe0: 73 65 74 53 74 65 70 52 65 73 75 6c 74 28 28 56  setStepResult((V
5ff0: 64 62 65 2a 29 70 4e 65 77 29 3b 0a 20 20 73 71  dbe*)pNew);.  sq
6000: 6c 69 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a  lite3VdbeFinaliz
6010: 65 28 28 56 64 62 65 2a 29 70 4e 65 77 29 3b 0a  e((Vdbe*)pNew);.
6020: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
6030: 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a 2a 20 54 77  OK;.}.../*.** Tw
6040: 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68  o versions of th
6050: 65 20 6f 66 66 69 63 69 61 6c 20 41 50 49 2e 20  e official API. 
6060: 20 4c 65 67 61 63 79 20 61 6e 64 20 6e 65 77 20   Legacy and new 
6070: 75 73 65 2e 20 20 49 6e 20 74 68 65 20 6c 65 67  use.  In the leg
6080: 61 63 79 0a 2a 2a 20 76 65 72 73 69 6f 6e 2c 20  acy.** version, 
6090: 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c  the original SQL
60a0: 20 74 65 78 74 20 69 73 20 6e 6f 74 20 73 61 76   text is not sav
60b0: 65 64 20 69 6e 20 74 68 65 20 70 72 65 70 61 72  ed in the prepar
60c0: 65 64 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20  ed statement.** 
60d0: 61 6e 64 20 73 6f 20 69 66 20 61 20 73 63 68 65  and so if a sche
60e0: 6d 61 20 63 68 61 6e 67 65 20 6f 63 63 75 72 73  ma change occurs
60f0: 2c 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20  , SQLITE_SCHEMA 
6100: 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 0a 2a  is returned by.*
6110: 2a 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29  * sqlite3_step()
6120: 2e 20 20 49 6e 20 74 68 65 20 6e 65 77 20 76 65  .  In the new ve
6130: 72 73 69 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69  rsion, the origi
6140: 6e 61 6c 20 53 51 4c 20 74 65 78 74 20 69 73 20  nal SQL text is 
6150: 72 65 74 61 69 6e 65 64 0a 2a 2a 20 61 6e 64 20  retained.** and 
6160: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 69 73  the statement is
6170: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72   automatically r
6180: 65 63 6f 6d 70 69 6c 65 64 20 69 66 20 61 6e 20  ecompiled if an 
6190: 73 63 68 65 6d 61 20 63 68 61 6e 67 65 0a 2a 2a  schema change.**
61a0: 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74 20   occurs..*/.int 
61b0: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28  sqlite3_prepare(
61c0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20  .  sqlite3 *db, 
61d0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20               /* 
61e0: 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e  Database handle.
61f0: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72   */.  const char
6200: 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20   *zSql,         
6210: 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64  /* UTF-8 encoded
6220: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20   SQL statement. 
6230: 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c  */.  int nBytes,
6240: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
6250: 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c  * Length of zSql
6260: 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20   in bytes. */.  
6270: 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70  sqlite3_stmt **p
6280: 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54  pStmt,    /* OUT
6290: 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74  : A pointer to t
62a0: 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 74  he prepared stat
62b0: 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74  ement */.  const
62c0: 20 63 68 61 72 20 2a 2a 70 7a 54 61 69 6c 20 20   char **pzTail  
62d0: 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64       /* OUT: End
62e0: 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 69 6e   of parsed strin
62f0: 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63  g */.){.  int rc
6300: 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33  ;.  rc = sqlite3
6310: 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28 64  LockAndPrepare(d
6320: 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 30 2c  b,zSql,nBytes,0,
6330: 30 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29  0,ppStmt,pzTail)
6340: 3b 0a 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f  ;.#ifdef SQLITE_
6350: 45 4e 41 42 4c 45 5f 53 51 4c 52 52 0a 20 20 53  ENABLE_SQLRR.  S
6360: 52 52 65 63 50 72 65 70 61 72 65 28 64 62 2c 20  RRecPrepare(db, 
6370: 7a 53 71 6c 2c 20 6e 42 79 74 65 73 2c 20 30 2c  zSql, nBytes, 0,
6380: 20 2a 70 70 53 74 6d 74 29 3b 0a 23 65 6e 64 69   *ppStmt);.#endi
6390: 66 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d  f.  assert( rc==
63a0: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53  SQLITE_OK || ppS
63b0: 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d  tmt==0 || *ppStm
63c0: 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52 49  t==0 );  /* VERI
63d0: 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20 20  FY: F13021 */.  
63e0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74  return rc;.}.int
63f0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
6400: 5f 76 32 28 0a 20 20 73 71 6c 69 74 65 33 20 2a  _v2(.  sqlite3 *
6410: 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20  db,             
6420: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e   /* Database han
6430: 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20  dle. */.  const 
6440: 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20  char *zSql,     
6450: 20 20 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63      /* UTF-8 enc
6460: 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65  oded SQL stateme
6470: 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79  nt. */.  int nBy
6480: 74 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20  tes,            
6490: 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20     /* Length of 
64a0: 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a  zSql in bytes. *
64b0: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74  /.  sqlite3_stmt
64c0: 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a   **ppStmt,    /*
64d0: 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20   OUT: A pointer 
64e0: 74 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20  to the prepared 
64f0: 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63  statement */.  c
6500: 6f 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61  onst char **pzTa
6510: 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a  il       /* OUT:
6520: 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73   End of parsed s
6530: 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e  tring */.){.  in
6540: 74 20 72 63 3b 0a 20 20 2f 2a 20 45 56 49 44 45  t rc;.  /* EVIDE
6550: 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 39 32 33 2d  NCE-OF: R-37923-
6560: 31 32 31 37 33 20 54 68 65 20 73 71 6c 69 74 65  12173 The sqlite
6570: 33 5f 70 72 65 70 61 72 65 5f 76 32 28 29 20 69  3_prepare_v2() i
6580: 6e 74 65 72 66 61 63 65 20 77 6f 72 6b 73 0a 20  nterface works. 
6590: 20 2a 2a 20 65 78 61 63 74 6c 79 20 74 68 65 20   ** exactly the 
65a0: 73 61 6d 65 20 61 73 20 73 71 6c 69 74 65 33 5f  same as sqlite3_
65b0: 70 72 65 70 61 72 65 5f 76 33 28 29 20 77 69 74  prepare_v3() wit
65c0: 68 20 61 20 7a 65 72 6f 20 70 72 65 70 46 6c 61  h a zero prepFla
65d0: 67 73 0a 20 20 2a 2a 20 70 61 72 61 6d 65 74 65  gs.  ** paramete
65e0: 72 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 50 72 6f  r..  **.  ** Pro
65f0: 6f 66 20 69 6e 20 74 68 61 74 20 74 68 65 20 35  of in that the 5
6600: 74 68 20 70 61 72 61 6d 65 74 65 72 20 74 6f 20  th parameter to 
6610: 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72  sqlite3LockAndPr
6620: 65 70 61 72 65 20 69 73 20 30 20 2a 2f 0a 20 20  epare is 0 */.  
6630: 72 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b  rc = sqlite3Lock
6640: 41 6e 64 50 72 65 70 61 72 65 28 64 62 2c 7a 53  AndPrepare(db,zS
6650: 71 6c 2c 6e 42 79 74 65 73 2c 53 51 4c 49 54 45  ql,nBytes,SQLITE
6660: 5f 50 52 45 50 41 52 45 5f 53 41 56 45 53 51 4c  _PREPARE_SAVESQL
6670: 2c 30 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20  ,0,.            
6680: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
6690: 20 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29 3b   ppStmt,pzTail);
66a0: 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53  .  assert( rc==S
66b0: 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53 74  QLITE_OK || ppSt
66c0: 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d 74  mt==0 || *ppStmt
66d0: 3d 3d 30 20 29 3b 0a 20 20 72 65 74 75 72 6e 20  ==0 );.  return 
66e0: 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65  rc;.}.int sqlite
66f0: 33 5f 70 72 65 70 61 72 65 5f 76 33 28 0a 20 20  3_prepare_v3(.  
6700: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20  sqlite3 *db,    
6710: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74            /* Dat
6720: 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f  abase handle. */
6730: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a  .  const char *z
6740: 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20  Sql,         /* 
6750: 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51  UTF-8 encoded SQ
6760: 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a  L statement. */.
6770: 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20    int nBytes,   
6780: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c              /* L
6790: 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e  ength of zSql in
67a0: 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 75 6e 73   bytes. */.  uns
67b0: 69 67 6e 65 64 20 69 6e 74 20 70 72 65 70 46 6c  igned int prepFl
67c0: 61 67 73 2c 20 20 20 2f 2a 20 5a 65 72 6f 20 6f  ags,   /* Zero o
67d0: 72 20 6d 6f 72 65 20 53 51 4c 49 54 45 5f 50 52  r more SQLITE_PR
67e0: 45 50 41 52 45 5f 2a 20 66 6c 61 67 73 20 2a 2f  EPARE_* flags */
67f0: 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20  .  sqlite3_stmt 
6800: 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20  **ppStmt,    /* 
6810: 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74  OUT: A pointer t
6820: 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73  o the prepared s
6830: 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f  tatement */.  co
6840: 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 69  nst char **pzTai
6850: 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20  l       /* OUT: 
6860: 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74  End of parsed st
6870: 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74  ring */.){.  int
6880: 20 72 63 3b 0a 20 20 2f 2a 20 45 56 49 44 45 4e   rc;.  /* EVIDEN
6890: 43 45 2d 4f 46 3a 20 52 2d 35 36 38 36 31 2d 34  CE-OF: R-56861-4
68a0: 32 36 37 33 20 73 71 6c 69 74 65 33 5f 70 72 65  2673 sqlite3_pre
68b0: 70 61 72 65 5f 76 33 28 29 20 64 69 66 66 65 72  pare_v3() differ
68c0: 73 20 66 72 6f 6d 0a 20 20 2a 2a 20 73 71 6c 69  s from.  ** sqli
68d0: 74 65 33 5f 70 72 65 70 61 72 65 5f 76 32 28 29  te3_prepare_v2()
68e0: 20 6f 6e 6c 79 20 69 6e 20 68 61 76 69 6e 67 20   only in having 
68f0: 74 68 65 20 65 78 74 72 61 20 70 72 65 70 46 6c  the extra prepFl
6900: 61 67 73 20 70 61 72 61 6d 65 74 65 72 2c 0a 20  ags parameter,. 
6910: 20 2a 2a 20 77 68 69 63 68 20 69 73 20 61 20 62   ** which is a b
6920: 69 74 20 61 72 72 61 79 20 63 6f 6e 73 69 73 74  it array consist
6930: 69 6e 67 20 6f 66 20 7a 65 72 6f 20 6f 72 20 6d  ing of zero or m
6940: 6f 72 65 20 6f 66 20 74 68 65 0a 20 20 2a 2a 20  ore of the.  ** 
6950: 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 2a  SQLITE_PREPARE_*
6960: 20 66 6c 61 67 73 2e 0a 20 20 2a 2a 0a 20 20 2a   flags..  **.  *
6970: 2a 20 50 72 6f 6f 66 20 62 79 20 63 6f 6d 70 61  * Proof by compa
6980: 72 69 73 6f 6e 20 74 6f 20 74 68 65 20 69 6d 70  rison to the imp
6990: 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 73  lementation of s
69a0: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76  qlite3_prepare_v
69b0: 32 28 29 0a 20 20 2a 2a 20 64 69 72 65 63 74 6c  2().  ** directl
69c0: 79 20 61 62 6f 76 65 2e 20 2a 2f 0a 20 20 72 63  y above. */.  rc
69d0: 20 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e   = sqlite3LockAn
69e0: 64 50 72 65 70 61 72 65 28 64 62 2c 7a 53 71 6c  dPrepare(db,zSql
69f0: 2c 6e 42 79 74 65 73 2c 0a 20 20 20 20 20 20 20  ,nBytes,.       
6a00: 20 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45            SQLITE
6a10: 5f 50 52 45 50 41 52 45 5f 53 41 56 45 53 51 4c  _PREPARE_SAVESQL
6a20: 7c 28 70 72 65 70 46 6c 61 67 73 26 53 51 4c 49  |(prepFlags&SQLI
6a30: 54 45 5f 50 52 45 50 41 52 45 5f 4d 41 53 4b 29  TE_PREPARE_MASK)
6a40: 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20  ,.              
6a50: 20 20 20 30 2c 70 70 53 74 6d 74 2c 70 7a 54 61     0,ppStmt,pzTa
6a60: 69 6c 29 3b 0a 23 69 66 64 65 66 20 53 51 4c 49  il);.#ifdef SQLI
6a70: 54 45 5f 45 4e 41 42 4c 45 5f 53 51 4c 52 52 0a  TE_ENABLE_SQLRR.
6a80: 20 20 53 52 52 65 63 50 72 65 70 61 72 65 28 64    SRRecPrepare(d
6a90: 62 2c 20 7a 53 71 6c 2c 20 6e 42 79 74 65 73 2c  b, zSql, nBytes,
6aa0: 20 31 2c 20 2a 70 70 53 74 6d 74 29 3b 0a 23 65   1, *ppStmt);.#e
6ab0: 6e 64 69 66 0a 20 20 61 73 73 65 72 74 28 20 72  ndif.  assert( r
6ac0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20  c==SQLITE_OK || 
6ad0: 70 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70  ppStmt==0 || *pp
6ae0: 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 72 65 74  Stmt==0 );.  ret
6af0: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 23 69 66 6e  urn rc;.}...#ifn
6b00: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f  def SQLITE_OMIT_
6b10: 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70  UTF16./*.** Comp
6b20: 69 6c 65 20 74 68 65 20 55 54 46 2d 31 36 20 65  ile the UTF-16 e
6b30: 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65  ncoded SQL state
6b40: 6d 65 6e 74 20 7a 53 71 6c 20 69 6e 74 6f 20 61  ment zSql into a
6b50: 20 73 74 61 74 65 6d 65 6e 74 20 68 61 6e 64 6c   statement handl
6b60: 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74  e..*/.static int
6b70: 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 31   sqlite3Prepare1
6b80: 36 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62  6(.  sqlite3 *db
6b90: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f  ,              /
6ba0: 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c  * Database handl
6bb0: 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e 73 74 20 76  e. */ .  const v
6bc0: 6f 69 64 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20  oid *zSql,      
6bd0: 20 20 20 2f 2a 20 55 54 46 2d 31 36 20 65 6e 63     /* UTF-16 enc
6be0: 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65  oded SQL stateme
6bf0: 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79  nt. */.  int nBy
6c00: 74 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20  tes,            
6c10: 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20     /* Length of 
6c20: 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a  zSql in bytes. *
6c30: 2f 0a 20 20 75 33 32 20 70 72 65 70 46 6c 61 67  /.  u32 prepFlag
6c40: 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a  s,            /*
6c50: 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 53 51   Zero or more SQ
6c60: 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 2a 20 66  LITE_PREPARE_* f
6c70: 6c 61 67 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65  lags */.  sqlite
6c80: 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c  3_stmt **ppStmt,
6c90: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f      /* OUT: A po
6ca0: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65  inter to the pre
6cb0: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20  pared statement 
6cc0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  */.  const void 
6cd0: 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f  **pzTail       /
6ce0: 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61  * OUT: End of pa
6cf0: 72 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29  rsed string */.)
6d00: 7b 0a 20 20 2f 2a 20 54 68 69 73 20 66 75 6e 63  {.  /* This func
6d10: 74 69 6f 6e 20 63 75 72 72 65 6e 74 6c 79 20 77  tion currently w
6d20: 6f 72 6b 73 20 62 79 20 66 69 72 73 74 20 74 72  orks by first tr
6d30: 61 6e 73 66 6f 72 6d 69 6e 67 20 74 68 65 20 55  ansforming the U
6d40: 54 46 2d 31 36 0a 20 20 2a 2a 20 65 6e 63 6f 64  TF-16.  ** encod
6d50: 65 64 20 73 74 72 69 6e 67 20 74 6f 20 55 54 46  ed string to UTF
6d60: 2d 38 2c 20 74 68 65 6e 20 69 6e 76 6f 6b 69 6e  -8, then invokin
6d70: 67 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72  g sqlite3_prepar
6d80: 65 28 29 2e 20 54 68 65 0a 20 20 2a 2a 20 74 72  e(). The.  ** tr
6d90: 69 63 6b 79 20 62 69 74 20 69 73 20 66 69 67 75  icky bit is figu
6da0: 72 69 6e 67 20 6f 75 74 20 74 68 65 20 70 6f 69  ring out the poi
6db0: 6e 74 65 72 20 74 6f 20 72 65 74 75 72 6e 20 69  nter to return i
6dc0: 6e 20 2a 70 7a 54 61 69 6c 2e 0a 20 20 2a 2f 0a  n *pzTail..  */.
6dd0: 20 20 63 68 61 72 20 2a 7a 53 71 6c 38 3b 0a 20    char *zSql8;. 
6de0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 54 61   const char *zTa
6df0: 69 6c 38 20 3d 20 30 3b 0a 20 20 69 6e 74 20 72  il8 = 0;.  int r
6e00: 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 0a  c = SQLITE_OK;..
6e10: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e  #ifdef SQLITE_EN
6e20: 41 42 4c 45 5f 41 50 49 5f 41 52 4d 4f 52 0a 20  ABLE_API_ARMOR. 
6e30: 20 69 66 28 20 70 70 53 74 6d 74 3d 3d 30 20 29   if( ppStmt==0 )
6e40: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4d   return SQLITE_M
6e50: 49 53 55 53 45 5f 42 4b 50 54 3b 0a 23 65 6e 64  ISUSE_BKPT;.#end
6e60: 69 66 0a 20 20 2a 70 70 53 74 6d 74 20 3d 20 30  if.  *ppStmt = 0
6e70: 3b 0a 20 20 69 66 28 20 21 73 71 6c 69 74 65 33  ;.  if( !sqlite3
6e80: 53 61 66 65 74 79 43 68 65 63 6b 4f 6b 28 64 62  SafetyCheckOk(db
6e90: 29 7c 7c 7a 53 71 6c 3d 3d 30 20 29 7b 0a 20 20  )||zSql==0 ){.  
6ea0: 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f    return SQLITE_
6eb0: 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a 20 20 7d  MISUSE_BKPT;.  }
6ec0: 0a 20 20 69 66 28 20 6e 42 79 74 65 73 3e 3d 30  .  if( nBytes>=0
6ed0: 20 29 7b 0a 20 20 20 20 69 6e 74 20 73 7a 3b 0a   ){.    int sz;.
6ee0: 20 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a      const char *
6ef0: 7a 20 3d 20 28 63 6f 6e 73 74 20 63 68 61 72 2a  z = (const char*
6f00: 29 7a 53 71 6c 3b 0a 20 20 20 20 66 6f 72 28 73  )zSql;.    for(s
6f10: 7a 3d 30 3b 20 73 7a 3c 6e 42 79 74 65 73 20 26  z=0; sz<nBytes &
6f20: 26 20 28 7a 5b 73 7a 5d 21 3d 30 20 7c 7c 20 7a  & (z[sz]!=0 || z
6f30: 5b 73 7a 2b 31 5d 21 3d 30 29 3b 20 73 7a 20 2b  [sz+1]!=0); sz +
6f40: 3d 20 32 29 7b 7d 0a 20 20 20 20 6e 42 79 74 65  = 2){}.    nByte
6f50: 73 20 3d 20 73 7a 3b 0a 20 20 7d 0a 20 20 73 71  s = sz;.  }.  sq
6f60: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65  lite3_mutex_ente
6f70: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20  r(db->mutex);.  
6f80: 7a 53 71 6c 38 20 3d 20 73 71 6c 69 74 65 33 55  zSql8 = sqlite3U
6f90: 74 66 31 36 74 6f 38 28 64 62 2c 20 7a 53 71 6c  tf16to8(db, zSql
6fa0: 2c 20 6e 42 79 74 65 73 2c 20 53 51 4c 49 54 45  , nBytes, SQLITE
6fb0: 5f 55 54 46 31 36 4e 41 54 49 56 45 29 3b 0a 20  _UTF16NATIVE);. 
6fc0: 20 69 66 28 20 7a 53 71 6c 38 20 29 7b 0a 20 20   if( zSql8 ){.  
6fd0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f    rc = sqlite3Lo
6fe0: 63 6b 41 6e 64 50 72 65 70 61 72 65 28 64 62 2c  ckAndPrepare(db,
6ff0: 20 7a 53 71 6c 38 2c 20 2d 31 2c 20 70 72 65 70   zSql8, -1, prep
7000: 46 6c 61 67 73 2c 20 30 2c 20 70 70 53 74 6d 74  Flags, 0, ppStmt
7010: 2c 20 26 7a 54 61 69 6c 38 29 3b 0a 20 20 7d 0a  , &zTail8);.  }.
7020: 23 69 66 64 65 66 20 53 51 4c 49 54 45 5f 45 4e  #ifdef SQLITE_EN
7030: 41 42 4c 45 5f 53 51 4c 52 52 0a 20 20 53 52 52  ABLE_SQLRR.  SRR
7040: 65 63 50 72 65 70 61 72 65 28 64 62 2c 20 7a 53  ecPrepare(db, zS
7050: 71 6c 38 2c 20 2d 31 2c 20 31 2c 20 2a 70 70 53  ql8, -1, 1, *ppS
7060: 74 6d 74 29 3b 0a 23 65 6e 64 69 66 0a 20 20 69  tmt);.#endif.  i
7070: 66 28 20 7a 54 61 69 6c 38 20 26 26 20 70 7a 54  f( zTail8 && pzT
7080: 61 69 6c 20 29 7b 0a 20 20 20 20 2f 2a 20 49 66  ail ){.    /* If
7090: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65   sqlite3_prepare
70a0: 20 72 65 74 75 72 6e 73 20 61 20 74 61 69 6c 20   returns a tail 
70b0: 70 6f 69 6e 74 65 72 2c 20 77 65 20 63 61 6c 63  pointer, we calc
70c0: 75 6c 61 74 65 20 74 68 65 0a 20 20 20 20 2a 2a  ulate the.    **
70d0: 20 65 71 75 69 76 61 6c 65 6e 74 20 70 6f 69 6e   equivalent poin
70e0: 74 65 72 20 69 6e 74 6f 20 74 68 65 20 55 54 46  ter into the UTF
70f0: 2d 31 36 20 73 74 72 69 6e 67 20 62 79 20 63 6f  -16 string by co
7100: 75 6e 74 69 6e 67 20 74 68 65 20 75 6e 69 63 6f  unting the unico
7110: 64 65 0a 20 20 20 20 2a 2a 20 63 68 61 72 61 63  de.    ** charac
7120: 74 65 72 73 20 62 65 74 77 65 65 6e 20 7a 53 71  ters between zSq
7130: 6c 38 20 61 6e 64 20 7a 54 61 69 6c 38 2c 20 61  l8 and zTail8, a
7140: 6e 64 20 74 68 65 6e 20 72 65 74 75 72 6e 69 6e  nd then returnin
7150: 67 20 61 20 70 6f 69 6e 74 65 72 0a 20 20 20 20  g a pointer.    
7160: 2a 2a 20 74 68 65 20 73 61 6d 65 20 6e 75 6d 62  ** the same numb
7170: 65 72 20 6f 66 20 63 68 61 72 61 63 74 65 72 73  er of characters
7180: 20 69 6e 74 6f 20 74 68 65 20 55 54 46 2d 31 36   into the UTF-16
7190: 20 73 74 72 69 6e 67 2e 0a 20 20 20 20 2a 2f 0a   string..    */.
71a0: 20 20 20 20 69 6e 74 20 63 68 61 72 73 5f 70 61      int chars_pa
71b0: 72 73 65 64 20 3d 20 73 71 6c 69 74 65 33 55 74  rsed = sqlite3Ut
71c0: 66 38 43 68 61 72 4c 65 6e 28 7a 53 71 6c 38 2c  f8CharLen(zSql8,
71d0: 20 28 69 6e 74 29 28 7a 54 61 69 6c 38 2d 7a 53   (int)(zTail8-zS
71e0: 71 6c 38 29 29 3b 0a 20 20 20 20 2a 70 7a 54 61  ql8));.    *pzTa
71f0: 69 6c 20 3d 20 28 75 38 20 2a 29 7a 53 71 6c 20  il = (u8 *)zSql 
7200: 2b 20 73 71 6c 69 74 65 33 55 74 66 31 36 42 79  + sqlite3Utf16By
7210: 74 65 4c 65 6e 28 7a 53 71 6c 2c 20 63 68 61 72  teLen(zSql, char
7220: 73 5f 70 61 72 73 65 64 29 3b 0a 20 20 7d 0a 20  s_parsed);.  }. 
7230: 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 64   sqlite3DbFree(d
7240: 62 2c 20 7a 53 71 6c 38 29 3b 20 0a 20 20 72 63  b, zSql8); .  rc
7250: 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 78 69   = sqlite3ApiExi
7260: 74 28 64 62 2c 20 72 63 29 3b 0a 20 20 73 71 6c  t(db, rc);.  sql
7270: 69 74 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65  ite3_mutex_leave
7280: 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72  (db->mutex);.  r
7290: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a  eturn rc;.}../*.
72a0: 2a 2a 20 54 77 6f 20 76 65 72 73 69 6f 6e 73 20  ** Two versions 
72b0: 6f 66 20 74 68 65 20 6f 66 66 69 63 69 61 6c 20  of the official 
72c0: 41 50 49 2e 20 20 4c 65 67 61 63 79 20 61 6e 64  API.  Legacy and
72d0: 20 6e 65 77 20 75 73 65 2e 20 20 49 6e 20 74 68   new use.  In th
72e0: 65 20 6c 65 67 61 63 79 0a 2a 2a 20 76 65 72 73  e legacy.** vers
72f0: 69 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69 6e 61  ion, the origina
7300: 6c 20 53 51 4c 20 74 65 78 74 20 69 73 20 6e 6f  l SQL text is no
7310: 74 20 73 61 76 65 64 20 69 6e 20 74 68 65 20 70  t saved in the p
7320: 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e  repared statemen
7330: 74 0a 2a 2a 20 61 6e 64 20 73 6f 20 69 66 20 61  t.** and so if a
7340: 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 20 6f   schema change o
7350: 63 63 75 72 73 2c 20 53 51 4c 49 54 45 5f 53 43  ccurs, SQLITE_SC
7360: 48 45 4d 41 20 69 73 20 72 65 74 75 72 6e 65 64  HEMA is returned
7370: 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73   by.** sqlite3_s
7380: 74 65 70 28 29 2e 20 20 49 6e 20 74 68 65 20 6e  tep().  In the n
7390: 65 77 20 76 65 72 73 69 6f 6e 2c 20 74 68 65 20  ew version, the 
73a0: 6f 72 69 67 69 6e 61 6c 20 53 51 4c 20 74 65 78  original SQL tex
73b0: 74 20 69 73 20 72 65 74 61 69 6e 65 64 0a 2a 2a  t is retained.**
73c0: 20 61 6e 64 20 74 68 65 20 73 74 61 74 65 6d 65   and the stateme
73d0: 6e 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61  nt is automatica
73e0: 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65 64 20 69  lly recompiled i
73f0: 66 20 61 6e 20 73 63 68 65 6d 61 20 63 68 61 6e  f an schema chan
7400: 67 65 0a 2a 2a 20 6f 63 63 75 72 73 2e 0a 2a 2f  ge.** occurs..*/
7410: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65  .int sqlite3_pre
7420: 70 61 72 65 31 36 28 0a 20 20 73 71 6c 69 74 65  pare16(.  sqlite
7430: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20  3 *db,          
7440: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20      /* Database 
7450: 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f  handle. */ .  co
7460: 6e 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c 20  nst void *zSql, 
7470: 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 31          /* UTF-1
7480: 36 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74  6 encoded SQL st
7490: 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e  atement. */.  in
74a0: 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20  t nBytes,       
74b0: 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74          /* Lengt
74c0: 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74  h of zSql in byt
74d0: 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33  es. */.  sqlite3
74e0: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20  _stmt **ppStmt, 
74f0: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69     /* OUT: A poi
7500: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70  nter to the prep
7510: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a  ared statement *
7520: 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a  /.  const void *
7530: 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a  *pzTail       /*
7540: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72   OUT: End of par
7550: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b  sed string */.){
7560: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20  .  int rc;.  rc 
7570: 3d 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65  = sqlite3Prepare
7580: 31 36 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65  16(db,zSql,nByte
7590: 73 2c 30 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69  s,0,ppStmt,pzTai
75a0: 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63  l);.  assert( rc
75b0: 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70  ==SQLITE_OK || p
75c0: 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53  pStmt==0 || *ppS
75d0: 74 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45  tmt==0 );  /* VE
75e0: 52 49 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a  RIFY: F13021 */.
75f0: 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69    return rc;.}.i
7600: 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61  nt sqlite3_prepa
7610: 72 65 31 36 5f 76 32 28 0a 20 20 73 71 6c 69 74  re16_v2(.  sqlit
7620: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20  e3 *db,         
7630: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65       /* Database
7640: 20 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63   handle. */ .  c
7650: 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c  onst void *zSql,
7660: 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d           /* UTF-
7670: 31 36 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73  16 encoded SQL s
7680: 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69  tatement. */.  i
7690: 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20  nt nBytes,      
76a0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67           /* Leng
76b0: 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79  th of zSql in by
76c0: 74 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65  tes. */.  sqlite
76d0: 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c  3_stmt **ppStmt,
76e0: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f      /* OUT: A po
76f0: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65  inter to the pre
7700: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20  pared statement 
7710: 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  */.  const void 
7720: 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f  **pzTail       /
7730: 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61  * OUT: End of pa
7740: 72 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29  rsed string */.)
7750: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 72 63  {.  int rc;.  rc
7760: 20 3d 20 73 71 6c 69 74 65 33 50 72 65 70 61 72   = sqlite3Prepar
7770: 65 31 36 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74  e16(db,zSql,nByt
7780: 65 73 2c 53 51 4c 49 54 45 5f 50 52 45 50 41 52  es,SQLITE_PREPAR
7790: 45 5f 53 41 56 45 53 51 4c 2c 70 70 53 74 6d 74  E_SAVESQL,ppStmt
77a0: 2c 70 7a 54 61 69 6c 29 3b 0a 20 20 61 73 73 65  ,pzTail);.  asse
77b0: 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  rt( rc==SQLITE_O
77c0: 4b 20 7c 7c 20 70 70 53 74 6d 74 3d 3d 30 20 7c  K || ppStmt==0 |
77d0: 7c 20 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 20  | *ppStmt==0 ); 
77e0: 20 2f 2a 20 56 45 52 49 46 59 3a 20 46 31 33 30   /* VERIFY: F130
77f0: 32 31 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72  21 */.  return r
7800: 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33  c;.}.int sqlite3
7810: 5f 70 72 65 70 61 72 65 31 36 5f 76 33 28 0a 20  _prepare16_v3(. 
7820: 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20   sqlite3 *db,   
7830: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61             /* Da
7840: 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a  tabase handle. *
7850: 2f 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 20  / .  const void 
7860: 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f  *zSql,         /
7870: 2a 20 55 54 46 2d 31 36 20 65 6e 63 6f 64 65 64  * UTF-16 encoded
7880: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20   SQL statement. 
7890: 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c  */.  int nBytes,
78a0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f                 /
78b0: 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c  * Length of zSql
78c0: 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20   in bytes. */.  
78d0: 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 70 72 65  unsigned int pre
78e0: 70 46 6c 61 67 73 2c 20 20 20 2f 2a 20 5a 65 72  pFlags,   /* Zer
78f0: 6f 20 6f 72 20 6d 6f 72 65 20 53 51 4c 49 54 45  o or more SQLITE
7900: 5f 50 52 45 50 41 52 45 5f 2a 20 66 6c 61 67 73  _PREPARE_* flags
7910: 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74   */.  sqlite3_st
7920: 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20  mt **ppStmt,    
7930: 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65  /* OUT: A pointe
7940: 72 20 74 6f 20 74 68 65 20 70 72 65 70 61 72 65  r to the prepare
7950: 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20  d statement */. 
7960: 20 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70 7a   const void **pz
7970: 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55  Tail       /* OU
7980: 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64  T: End of parsed
7990: 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20   string */.){.  
79a0: 69 6e 74 20 72 63 3b 0a 20 20 72 63 20 3d 20 73  int rc;.  rc = s
79b0: 71 6c 69 74 65 33 50 72 65 70 61 72 65 31 36 28  qlite3Prepare16(
79c0: 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 0a  db,zSql,nBytes,.
79d0: 20 20 20 20 20 20 20 20 20 53 51 4c 49 54 45 5f           SQLITE_
79e0: 50 52 45 50 41 52 45 5f 53 41 56 45 53 51 4c 7c  PREPARE_SAVESQL|
79f0: 28 70 72 65 70 46 6c 61 67 73 26 53 51 4c 49 54  (prepFlags&SQLIT
7a00: 45 5f 50 52 45 50 41 52 45 5f 4d 41 53 4b 29 2c  E_PREPARE_MASK),
7a10: 0a 20 20 20 20 20 20 20 20 20 70 70 53 74 6d 74  .         ppStmt
7a20: 2c 70 7a 54 61 69 6c 29 3b 0a 20 20 61 73 73 65  ,pzTail);.  asse
7a30: 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f  rt( rc==SQLITE_O
7a40: 4b 20 7c 7c 20 70 70 53 74 6d 74 3d 3d 30 20 7c  K || ppStmt==0 |
7a50: 7c 20 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 20  | *ppStmt==0 ); 
7a60: 20 2f 2a 20 56 45 52 49 46 59 3a 20 46 31 33 30   /* VERIFY: F130
7a70: 32 31 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72  21 */.  return r
7a80: 63 3b 0a 7d 0a 0a 23 65 6e 64 69 66 20 2f 2a 20  c;.}..#endif /* 
7a90: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31  SQLITE_OMIT_UTF1
7aa0: 36 20 2a 2f 0a                                   6 */.