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 */.