0000: 2f 2a 0a 2a 2a 20 32 30 30 35 20 4d 61 79 20 32 /*.** 2005 May 2
0010: 35 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68 5.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70 or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73 yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20 ource code. In
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65 place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65 gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75 **.** May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74 do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79 evil..** May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76 you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65 eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79 thers..** May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20 y, never taking
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69 more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a ve..**.*********
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63 6f .** This file co
0180: 6e 74 61 69 6e 73 20 74 68 65 20 69 6d 70 6c 65 ntains the imple
0190: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 mentation of the
01a0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 sqlite3_prepare
01b0: 28 29 0a 2a 2a 20 69 6e 74 65 72 66 61 63 65 2c ().** interface,
01c0: 20 61 6e 64 20 72 6f 75 74 69 6e 65 73 20 74 68 and routines th
01d0: 61 74 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f at contribute to
01e0: 20 6c 6f 61 64 69 6e 67 20 74 68 65 20 64 61 74 loading the dat
01f0: 61 62 61 73 65 20 73 63 68 65 6d 61 0a 2a 2a 20 abase schema.**
0200: 66 72 6f 6d 20 64 69 73 6b 2e 0a 2a 2f 0a 23 69 from disk..*/.#i
0210: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e nclude "sqliteIn
0220: 74 2e 68 22 0a 0a 2f 2a 0a 2a 2a 20 46 69 6c 6c t.h"../*.** Fill
0230: 20 74 68 65 20 49 6e 69 74 44 61 74 61 20 73 74 the InitData st
0240: 72 75 63 74 75 72 65 20 77 69 74 68 20 61 6e 20 ructure with an
0250: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 74 68 error message th
0260: 61 74 20 69 6e 64 69 63 61 74 65 73 0a 2a 2a 20 at indicates.**
0270: 74 68 61 74 20 74 68 65 20 64 61 74 61 62 61 73 that the databas
0280: 65 20 69 73 20 63 6f 72 72 75 70 74 2e 0a 2a 2f e is corrupt..*/
0290: 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 6f 72 .static void cor
02a0: 72 75 70 74 53 63 68 65 6d 61 28 0a 20 20 49 6e ruptSchema(. In
02b0: 69 74 44 61 74 61 20 2a 70 44 61 74 61 2c 20 20 itData *pData,
02c0: 20 20 20 2f 2a 20 49 6e 69 74 69 61 6c 69 7a 61 /* Initializa
02d0: 74 69 6f 6e 20 63 6f 6e 74 65 78 74 20 2a 2f 0a tion context */.
02e0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4f const char *zO
02f0: 62 6a 2c 20 20 20 20 2f 2a 20 4f 62 6a 65 63 74 bj, /* Object
0300: 20 62 65 69 6e 67 20 70 61 72 73 65 64 20 61 74 being parsed at
0310: 20 74 68 65 20 70 6f 69 6e 74 20 6f 66 20 65 72 the point of er
0320: 72 6f 72 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 ror */. const c
0330: 68 61 72 20 2a 7a 45 78 74 72 61 20 20 20 2f 2a har *zExtra /*
0340: 20 45 72 72 6f 72 20 69 6e 66 6f 72 6d 61 74 69 Error informati
0350: 6f 6e 20 2a 2f 0a 29 7b 0a 20 20 73 71 6c 69 74 on */.){. sqlit
0360: 65 33 20 2a 64 62 20 3d 20 70 44 61 74 61 2d 3e e3 *db = pData->
0370: 64 62 3b 0a 20 20 69 66 28 20 21 64 62 2d 3e 6d db;. if( !db->m
0380: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 26 26 20 28 allocFailed && (
0390: 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 db->flags & SQLI
03a0: 54 45 5f 57 72 69 74 65 53 63 68 65 6d 61 29 3d TE_WriteSchema)=
03b0: 3d 30 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a =0 ){. char *
03c0: 7a 3b 0a 20 20 20 20 69 66 28 20 7a 4f 62 6a 3d z;. if( zObj=
03d0: 3d 30 20 29 20 7a 4f 62 6a 20 3d 20 22 3f 22 3b =0 ) zObj = "?";
03e0: 0a 20 20 20 20 7a 20 3d 20 73 71 6c 69 74 65 33 . z = sqlite3
03f0: 4d 50 72 69 6e 74 66 28 64 62 2c 20 22 6d 61 6c MPrintf(db, "mal
0400: 66 6f 72 6d 65 64 20 64 61 74 61 62 61 73 65 20 formed database
0410: 73 63 68 65 6d 61 20 28 25 73 29 22 2c 20 7a 4f schema (%s)", zO
0420: 62 6a 29 3b 0a 20 20 20 20 69 66 28 20 7a 45 78 bj);. if( zEx
0430: 74 72 61 20 29 20 7a 20 3d 20 73 71 6c 69 74 65 tra ) z = sqlite
0440: 33 4d 50 72 69 6e 74 66 28 64 62 2c 20 22 25 7a 3MPrintf(db, "%z
0450: 20 2d 20 25 73 22 2c 20 7a 2c 20 7a 45 78 74 72 - %s", z, zExtr
0460: 61 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 a);. sqlite3D
0470: 62 46 72 65 65 28 64 62 2c 20 2a 70 44 61 74 61 bFree(db, *pData
0480: 2d 3e 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 ->pzErrMsg);.
0490: 20 2a 70 44 61 74 61 2d 3e 70 7a 45 72 72 4d 73 *pData->pzErrMs
04a0: 67 20 3d 20 7a 3b 0a 20 20 7d 0a 20 20 70 44 61 g = z;. }. pDa
04b0: 74 61 2d 3e 72 63 20 3d 20 64 62 2d 3e 6d 61 6c ta->rc = db->mal
04c0: 6c 6f 63 46 61 69 6c 65 64 20 3f 20 53 51 4c 49 locFailed ? SQLI
04d0: 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 20 3a 20 TE_NOMEM_BKPT :
04e0: 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 SQLITE_CORRUPT_B
04f0: 4b 50 54 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 KPT;.}../*.** Th
0500: 69 73 20 69 73 20 74 68 65 20 63 61 6c 6c 62 61 is is the callba
0510: 63 6b 20 72 6f 75 74 69 6e 65 20 66 6f 72 20 74 ck routine for t
0520: 68 65 20 63 6f 64 65 20 74 68 61 74 20 69 6e 69 he code that ini
0530: 74 69 61 6c 69 7a 65 73 20 74 68 65 0a 2a 2a 20 tializes the.**
0540: 64 61 74 61 62 61 73 65 2e 20 20 53 65 65 20 73 database. See s
0550: 71 6c 69 74 65 33 49 6e 69 74 28 29 20 62 65 6c qlite3Init() bel
0560: 6f 77 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61 ow for additiona
0570: 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 2a l information..*
0580: 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 * This routine i
0590: 73 20 61 6c 73 6f 20 63 61 6c 6c 65 64 20 66 72 s also called fr
05a0: 6f 6d 20 74 68 65 20 4f 50 5f 50 61 72 73 65 53 om the OP_ParseS
05b0: 63 68 65 6d 61 20 6f 70 63 6f 64 65 20 6f 66 20 chema opcode of
05c0: 74 68 65 20 56 44 42 45 2e 0a 2a 2a 0a 2a 2a 20 the VDBE..**.**
05d0: 45 61 63 68 20 63 61 6c 6c 62 61 63 6b 20 63 6f Each callback co
05e0: 6e 74 61 69 6e 73 20 74 68 65 20 66 6f 6c 6c 6f ntains the follo
05f0: 77 69 6e 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e wing information
0600: 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 20 61 72 67 76 :.**.** argv
0610: 5b 30 5d 20 3d 20 6e 61 6d 65 20 6f 66 20 74 68 [0] = name of th
0620: 69 6e 67 20 62 65 69 6e 67 20 63 72 65 61 74 65 ing being create
0630: 64 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 31 5d d.** argv[1]
0640: 20 3d 20 72 6f 6f 74 20 70 61 67 65 20 6e 75 6d = root page num
0650: 62 65 72 20 66 6f 72 20 74 61 62 6c 65 20 6f 72 ber for table or
0660: 20 69 6e 64 65 78 2e 20 30 20 66 6f 72 20 74 72 index. 0 for tr
0670: 69 67 67 65 72 20 6f 72 20 76 69 65 77 2e 0a 2a igger or view..*
0680: 2a 20 20 20 20 20 61 72 67 76 5b 32 5d 20 3d 20 * argv[2] =
0690: 53 51 4c 20 74 65 78 74 20 66 6f 72 20 74 68 65 SQL text for the
06a0: 20 43 52 45 41 54 45 20 73 74 61 74 65 6d 65 6e CREATE statemen
06b0: 74 2e 0a 2a 2a 0a 2a 2f 0a 69 6e 74 20 73 71 6c t..**.*/.int sql
06c0: 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 6b ite3InitCallback
06d0: 28 76 6f 69 64 20 2a 70 49 6e 69 74 2c 20 69 6e (void *pInit, in
06e0: 74 20 61 72 67 63 2c 20 63 68 61 72 20 2a 2a 61 t argc, char **a
06f0: 72 67 76 2c 20 63 68 61 72 20 2a 2a 4e 6f 74 55 rgv, char **NotU
0700: 73 65 64 29 7b 0a 20 20 49 6e 69 74 44 61 74 61 sed){. InitData
0710: 20 2a 70 44 61 74 61 20 3d 20 28 49 6e 69 74 44 *pData = (InitD
0720: 61 74 61 2a 29 70 49 6e 69 74 3b 0a 20 20 73 71 ata*)pInit;. sq
0730: 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 44 61 74 lite3 *db = pDat
0740: 61 2d 3e 64 62 3b 0a 20 20 69 6e 74 20 69 44 62 a->db;. int iDb
0750: 20 3d 20 70 44 61 74 61 2d 3e 69 44 62 3b 0a 0a = pData->iDb;..
0760: 20 20 61 73 73 65 72 74 28 20 61 72 67 63 3d 3d assert( argc==
0770: 33 20 29 3b 0a 20 20 55 4e 55 53 45 44 5f 50 41 3 );. UNUSED_PA
0780: 52 41 4d 45 54 45 52 32 28 4e 6f 74 55 73 65 64 RAMETER2(NotUsed
0790: 2c 20 61 72 67 63 29 3b 0a 20 20 61 73 73 65 72 , argc);. asser
07a0: 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 t( sqlite3_mutex
07b0: 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 _held(db->mutex)
07c0: 20 29 3b 0a 20 20 44 62 43 6c 65 61 72 50 72 6f );. DbClearPro
07d0: 70 65 72 74 79 28 64 62 2c 20 69 44 62 2c 20 44 perty(db, iDb, D
07e0: 42 5f 45 6d 70 74 79 29 3b 0a 20 20 69 66 28 20 B_Empty);. if(
07f0: 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 db->mallocFailed
0800: 20 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53 ){. corruptS
0810: 63 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67 chema(pData, arg
0820: 76 5b 30 5d 2c 20 30 29 3b 0a 20 20 20 20 72 65 v[0], 0);. re
0830: 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 0a 20 20 61 turn 1;. }.. a
0840: 73 73 65 72 74 28 20 69 44 62 3e 3d 30 20 26 26 ssert( iDb>=0 &&
0850: 20 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a iDb<db->nDb );.
0860: 20 20 69 66 28 20 61 72 67 76 3d 3d 30 20 29 20 if( argv==0 )
0870: 72 65 74 75 72 6e 20 30 3b 20 20 20 2f 2a 20 4d return 0; /* M
0880: 69 67 68 74 20 68 61 70 70 65 6e 20 69 66 20 45 ight happen if E
0890: 4d 50 54 59 5f 52 45 53 55 4c 54 5f 43 41 4c 4c MPTY_RESULT_CALL
08a0: 42 41 43 4b 53 20 61 72 65 20 6f 6e 20 2a 2f 0a BACKS are on */.
08b0: 20 20 69 66 28 20 61 72 67 76 5b 31 5d 3d 3d 30 if( argv[1]==0
08c0: 20 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 53 ){. corruptS
08d0: 63 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67 chema(pData, arg
08e0: 76 5b 30 5d 2c 20 30 29 3b 0a 20 20 7d 65 6c 73 v[0], 0);. }els
08f0: 65 20 69 66 28 20 73 71 6c 69 74 65 33 5f 73 74 e if( sqlite3_st
0900: 72 6e 69 63 6d 70 28 61 72 67 76 5b 32 5d 2c 22 rnicmp(argv[2],"
0910: 63 72 65 61 74 65 20 22 2c 37 29 3d 3d 30 20 29 create ",7)==0 )
0920: 7b 0a 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74 68 {. /* Call th
0930: 65 20 70 61 72 73 65 72 20 74 6f 20 70 72 6f 63 e parser to proc
0940: 65 73 73 20 61 20 43 52 45 41 54 45 20 54 41 42 ess a CREATE TAB
0950: 4c 45 2c 20 49 4e 44 45 58 20 6f 72 20 56 49 45 LE, INDEX or VIE
0960: 57 2e 0a 20 20 20 20 2a 2a 20 42 75 74 20 62 65 W.. ** But be
0970: 63 61 75 73 65 20 64 62 2d 3e 69 6e 69 74 2e 62 cause db->init.b
0980: 75 73 79 20 69 73 20 73 65 74 20 74 6f 20 31 2c usy is set to 1,
0990: 20 6e 6f 20 56 44 42 45 20 63 6f 64 65 20 69 73 no VDBE code is
09a0: 20 67 65 6e 65 72 61 74 65 64 0a 20 20 20 20 2a generated. *
09b0: 2a 20 6f 72 20 65 78 65 63 75 74 65 64 2e 20 20 * or executed.
09c0: 41 6c 6c 20 74 68 65 20 70 61 72 73 65 72 20 64 All the parser d
09d0: 6f 65 73 20 69 73 20 62 75 69 6c 64 20 74 68 65 oes is build the
09e0: 20 69 6e 74 65 72 6e 61 6c 20 64 61 74 61 0a 20 internal data.
09f0: 20 20 20 2a 2a 20 73 74 72 75 63 74 75 72 65 73 ** structures
0a00: 20 74 68 61 74 20 64 65 73 63 72 69 62 65 20 74 that describe t
0a10: 68 65 20 74 61 62 6c 65 2c 20 69 6e 64 65 78 2c he table, index,
0a20: 20 6f 72 20 76 69 65 77 2e 0a 20 20 20 20 2a 2f or view.. */
0a30: 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 20 . int rc;.
0a40: 20 75 38 20 73 61 76 65 64 5f 69 44 62 20 3d 20 u8 saved_iDb =
0a50: 64 62 2d 3e 69 6e 69 74 2e 69 44 62 3b 0a 20 20 db->init.iDb;.
0a60: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a sqlite3_stmt *
0a70: 70 53 74 6d 74 3b 0a 20 20 20 20 54 45 53 54 4f pStmt;. TESTO
0a80: 4e 4c 59 28 69 6e 74 20 72 63 70 29 3b 20 20 20 NLY(int rcp);
0a90: 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 75 /* Retu
0aa0: 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 73 71 6c rn code from sql
0ab0: 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 20 2a ite3_prepare() *
0ac0: 2f 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 64 /.. assert( d
0ad0: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b 0a b->init.busy );.
0ae0: 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69 44 62 db->init.iDb
0af0: 20 3d 20 69 44 62 3b 0a 20 20 20 20 64 62 2d 3e = iDb;. db->
0b00: 69 6e 69 74 2e 6e 65 77 54 6e 75 6d 20 3d 20 73 init.newTnum = s
0b10: 71 6c 69 74 65 33 41 74 6f 69 28 61 72 67 76 5b qlite3Atoi(argv[
0b20: 31 5d 29 3b 0a 20 20 20 20 64 62 2d 3e 69 6e 69 1]);. db->ini
0b30: 74 2e 6f 72 70 68 61 6e 54 72 69 67 67 65 72 20 t.orphanTrigger
0b40: 3d 20 30 3b 0a 20 20 20 20 54 45 53 54 4f 4e 4c = 0;. TESTONL
0b50: 59 28 72 63 70 20 3d 20 29 20 73 71 6c 69 74 65 Y(rcp = ) sqlite
0b60: 33 5f 70 72 65 70 61 72 65 28 64 62 2c 20 61 72 3_prepare(db, ar
0b70: 67 76 5b 32 5d 2c 20 2d 31 2c 20 26 70 53 74 6d gv[2], -1, &pStm
0b80: 74 2c 20 30 29 3b 0a 20 20 20 20 72 63 20 3d 20 t, 0);. rc =
0b90: 64 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 20 db->errCode;.
0ba0: 20 61 73 73 65 72 74 28 20 28 72 63 26 30 78 46 assert( (rc&0xF
0bb0: 46 29 3d 3d 28 72 63 70 26 30 78 46 46 29 20 29 F)==(rcp&0xFF) )
0bc0: 3b 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69 ;. db->init.i
0bd0: 44 62 20 3d 20 73 61 76 65 64 5f 69 44 62 3b 0a Db = saved_iDb;.
0be0: 20 20 20 20 61 73 73 65 72 74 28 20 73 61 76 65 assert( save
0bf0: 64 5f 69 44 62 3d 3d 30 20 7c 7c 20 28 64 62 2d d_iDb==0 || (db-
0c00: 3e 6d 44 62 46 6c 61 67 73 20 26 20 44 42 46 4c >mDbFlags & DBFL
0c10: 41 47 5f 56 61 63 75 75 6d 29 21 3d 30 20 29 3b AG_Vacuum)!=0 );
0c20: 0a 20 20 20 20 69 66 28 20 53 51 4c 49 54 45 5f . if( SQLITE_
0c30: 4f 4b 21 3d 72 63 20 29 7b 0a 20 20 20 20 20 20 OK!=rc ){.
0c40: 69 66 28 20 64 62 2d 3e 69 6e 69 74 2e 6f 72 70 if( db->init.orp
0c50: 68 61 6e 54 72 69 67 67 65 72 20 29 7b 0a 20 20 hanTrigger ){.
0c60: 20 20 20 20 20 20 61 73 73 65 72 74 28 20 69 44 assert( iD
0c70: 62 3d 3d 31 20 29 3b 0a 20 20 20 20 20 20 7d 65 b==1 );. }e
0c80: 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 70 44 61 lse{. pDa
0c90: 74 61 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 20 20 ta->rc = rc;.
0ca0: 20 20 20 20 20 69 66 28 20 72 63 3d 3d 53 51 4c if( rc==SQL
0cb0: 49 54 45 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 ITE_NOMEM ){.
0cc0: 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 4f 6f sqlite3Oo
0cd0: 6d 46 61 75 6c 74 28 64 62 29 3b 0a 20 20 20 20 mFault(db);.
0ce0: 20 20 20 20 7d 65 6c 73 65 20 69 66 28 20 72 63 }else if( rc
0cf0: 21 3d 53 51 4c 49 54 45 5f 49 4e 54 45 52 52 55 !=SQLITE_INTERRU
0d00: 50 54 20 26 26 20 28 72 63 26 30 78 46 46 29 21 PT && (rc&0xFF)!
0d10: 3d 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 20 29 =SQLITE_LOCKED )
0d20: 7b 0a 20 20 20 20 20 20 20 20 20 20 63 6f 72 72 {. corr
0d30: 75 70 74 53 63 68 65 6d 61 28 70 44 61 74 61 2c uptSchema(pData,
0d40: 20 61 72 67 76 5b 30 5d 2c 20 73 71 6c 69 74 65 argv[0], sqlite
0d50: 33 5f 65 72 72 6d 73 67 28 64 62 29 29 3b 0a 20 3_errmsg(db));.
0d60: 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 7d }. }
0d70: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 . }. sqlit
0d80: 65 33 5f 66 69 6e 61 6c 69 7a 65 28 70 53 74 6d e3_finalize(pStm
0d90: 74 29 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 t);. }else if(
0da0: 61 72 67 76 5b 30 5d 3d 3d 30 20 7c 7c 20 28 61 argv[0]==0 || (a
0db0: 72 67 76 5b 32 5d 21 3d 30 20 26 26 20 61 72 67 rgv[2]!=0 && arg
0dc0: 76 5b 32 5d 5b 30 5d 21 3d 30 29 20 29 7b 0a 20 v[2][0]!=0) ){.
0dd0: 20 20 20 63 6f 72 72 75 70 74 53 63 68 65 6d 61 corruptSchema
0de0: 28 70 44 61 74 61 2c 20 61 72 67 76 5b 30 5d 2c (pData, argv[0],
0df0: 20 30 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 0);. }else{.
0e00: 20 20 2f 2a 20 49 66 20 74 68 65 20 53 51 4c 20 /* If the SQL
0e10: 63 6f 6c 75 6d 6e 20 69 73 20 62 6c 61 6e 6b 20 column is blank
0e20: 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20 69 73 it means this is
0e30: 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74 0a 20 an index that.
0e40: 20 20 20 2a 2a 20 77 61 73 20 63 72 65 61 74 65 ** was create
0e50: 64 20 74 6f 20 62 65 20 74 68 65 20 50 52 49 4d d to be the PRIM
0e60: 41 52 59 20 4b 45 59 20 6f 72 20 74 6f 20 66 75 ARY KEY or to fu
0e70: 6c 66 69 6c 6c 20 61 20 55 4e 49 51 55 45 0a 20 lfill a UNIQUE.
0e80: 20 20 20 2a 2a 20 63 6f 6e 73 74 72 61 69 6e 74 ** constraint
0e90: 20 66 6f 72 20 61 20 43 52 45 41 54 45 20 54 41 for a CREATE TA
0ea0: 42 4c 45 2e 20 20 54 68 65 20 69 6e 64 65 78 20 BLE. The index
0eb0: 73 68 6f 75 6c 64 20 68 61 76 65 20 61 6c 72 65 should have alre
0ec0: 61 64 79 0a 20 20 20 20 2a 2a 20 62 65 65 6e 20 ady. ** been
0ed0: 63 72 65 61 74 65 64 20 77 68 65 6e 20 77 65 20 created when we
0ee0: 70 72 6f 63 65 73 73 65 64 20 74 68 65 20 43 52 processed the CR
0ef0: 45 41 54 45 20 54 41 42 4c 45 2e 20 20 41 6c 6c EATE TABLE. All
0f00: 20 77 65 20 68 61 76 65 0a 20 20 20 20 2a 2a 20 we have. **
0f10: 74 6f 20 64 6f 20 68 65 72 65 20 69 73 20 72 65 to do here is re
0f20: 63 6f 72 64 20 74 68 65 20 72 6f 6f 74 20 70 61 cord the root pa
0f30: 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 ge number for th
0f40: 61 74 20 69 6e 64 65 78 2e 0a 20 20 20 20 2a 2f at index.. */
0f50: 0a 20 20 20 20 49 6e 64 65 78 20 2a 70 49 6e 64 . Index *pInd
0f60: 65 78 3b 0a 20 20 20 20 70 49 6e 64 65 78 20 3d ex;. pIndex =
0f70: 20 73 71 6c 69 74 65 33 46 69 6e 64 49 6e 64 65 sqlite3FindInde
0f80: 78 28 64 62 2c 20 61 72 67 76 5b 30 5d 2c 20 64 x(db, argv[0], d
0f90: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 44 62 53 b->aDb[iDb].zDbS
0fa0: 4e 61 6d 65 29 3b 0a 20 20 20 20 69 66 28 20 70 Name);. if( p
0fb0: 49 6e 64 65 78 3d 3d 30 20 29 7b 0a 20 20 20 20 Index==0 ){.
0fc0: 20 20 2f 2a 20 54 68 69 73 20 63 61 6e 20 6f 63 /* This can oc
0fd0: 63 75 72 20 69 66 20 74 68 65 72 65 20 65 78 69 cur if there exi
0fe0: 73 74 73 20 61 6e 20 69 6e 64 65 78 20 6f 6e 20 sts an index on
0ff0: 61 20 54 45 4d 50 20 74 61 62 6c 65 20 77 68 69 a TEMP table whi
1000: 63 68 0a 20 20 20 20 20 20 2a 2a 20 68 61 73 20 ch. ** has
1010: 74 68 65 20 73 61 6d 65 20 6e 61 6d 65 20 61 73 the same name as
1020: 20 61 6e 6f 74 68 65 72 20 69 6e 64 65 78 20 6f another index o
1030: 6e 20 61 20 70 65 72 6d 61 6e 65 6e 74 20 69 6e n a permanent in
1040: 64 65 78 2e 20 20 53 69 6e 63 65 0a 20 20 20 20 dex. Since.
1050: 20 20 2a 2a 20 74 68 65 20 70 65 72 6d 61 6e 65 ** the permane
1060: 6e 74 20 74 61 62 6c 65 20 69 73 20 68 69 64 64 nt table is hidd
1070: 65 6e 20 62 79 20 74 68 65 20 54 45 4d 50 20 74 en by the TEMP t
1080: 61 62 6c 65 2c 20 77 65 20 63 61 6e 20 61 6c 73 able, we can als
1090: 6f 0a 20 20 20 20 20 20 2a 2a 20 73 61 66 65 6c o. ** safel
10a0: 79 20 69 67 6e 6f 72 65 20 74 68 65 20 69 6e 64 y ignore the ind
10b0: 65 78 20 6f 6e 20 74 68 65 20 70 65 72 6d 61 6e ex on the perman
10c0: 65 6e 74 20 74 61 62 6c 65 2e 0a 20 20 20 20 20 ent table..
10d0: 20 2a 2f 0a 20 20 20 20 20 20 2f 2a 20 44 6f 20 */. /* Do
10e0: 4e 6f 74 68 69 6e 67 20 2a 2f 3b 0a 20 20 20 20 Nothing */;.
10f0: 7d 65 6c 73 65 20 69 66 28 20 73 71 6c 69 74 65 }else if( sqlite
1100: 33 47 65 74 49 6e 74 33 32 28 61 72 67 76 5b 31 3GetInt32(argv[1
1110: 5d 2c 20 26 70 49 6e 64 65 78 2d 3e 74 6e 75 6d ], &pIndex->tnum
1120: 29 3d 3d 30 20 29 7b 0a 20 20 20 20 20 20 63 6f )==0 ){. co
1130: 72 72 75 70 74 53 63 68 65 6d 61 28 70 44 61 74 rruptSchema(pDat
1140: 61 2c 20 61 72 67 76 5b 30 5d 2c 20 22 69 6e 76 a, argv[0], "inv
1150: 61 6c 69 64 20 72 6f 6f 74 70 61 67 65 22 29 3b alid rootpage");
1160: 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 . }. }. ret
1170: 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 urn 0;.}../*.**
1180: 41 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20 Attempt to read
1190: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 the database sch
11a0: 65 6d 61 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 ema and initiali
11b0: 7a 65 20 69 6e 74 65 72 6e 61 6c 0a 2a 2a 20 64 ze internal.** d
11c0: 61 74 61 20 73 74 72 75 63 74 75 72 65 73 20 66 ata structures f
11d0: 6f 72 20 61 20 73 69 6e 67 6c 65 20 64 61 74 61 or a single data
11e0: 62 61 73 65 20 66 69 6c 65 2e 20 20 54 68 65 20 base file. The
11f0: 69 6e 64 65 78 20 6f 66 20 74 68 65 0a 2a 2a 20 index of the.**
1200: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 73 database file is
1210: 20 67 69 76 65 6e 20 62 79 20 69 44 62 2e 20 20 given by iDb.
1220: 69 44 62 3d 3d 30 20 69 73 20 75 73 65 64 20 66 iDb==0 is used f
1230: 6f 72 20 74 68 65 20 6d 61 69 6e 0a 2a 2a 20 64 or the main.** d
1240: 61 74 61 62 61 73 65 2e 20 20 69 44 62 3d 3d 31 atabase. iDb==1
1250: 20 73 68 6f 75 6c 64 20 6e 65 76 65 72 20 62 65 should never be
1260: 20 75 73 65 64 2e 20 20 69 44 62 3e 3d 32 20 69 used. iDb>=2 i
1270: 73 20 75 73 65 64 20 66 6f 72 0a 2a 2a 20 61 75 s used for.** au
1280: 78 69 6c 69 61 72 79 20 64 61 74 61 62 61 73 65 xiliary database
1290: 73 2e 20 20 52 65 74 75 72 6e 20 6f 6e 65 20 6f s. Return one o
12a0: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 20 65 72 f the SQLITE_ er
12b0: 72 6f 72 20 63 6f 64 65 73 20 74 6f 0a 2a 2a 20 ror codes to.**
12c0: 69 6e 64 69 63 61 74 65 20 73 75 63 63 65 73 73 indicate success
12d0: 20 6f 72 20 66 61 69 6c 75 72 65 2e 0a 2a 2f 0a or failure..*/.
12e0: 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 static int sqlit
12f0: 65 33 49 6e 69 74 4f 6e 65 28 73 71 6c 69 74 65 e3InitOne(sqlite
1300: 33 20 2a 64 62 2c 20 69 6e 74 20 69 44 62 2c 20 3 *db, int iDb,
1310: 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29 char **pzErrMsg)
1320: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e {. int rc;. in
1330: 74 20 69 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c t i;.#ifndef SQL
1340: 49 54 45 5f 4f 4d 49 54 5f 44 45 50 52 45 43 41 ITE_OMIT_DEPRECA
1350: 54 45 44 0a 20 20 69 6e 74 20 73 69 7a 65 3b 0a TED. int size;.
1360: 23 65 6e 64 69 66 0a 20 20 44 62 20 2a 70 44 62 #endif. Db *pDb
1370: 3b 0a 20 20 63 68 61 72 20 63 6f 6e 73 74 20 2a ;. char const *
1380: 61 7a 41 72 67 5b 34 5d 3b 0a 20 20 69 6e 74 20 azArg[4];. int
1390: 6d 65 74 61 5b 35 5d 3b 0a 20 20 49 6e 69 74 44 meta[5];. InitD
13a0: 61 74 61 20 69 6e 69 74 44 61 74 61 3b 0a 20 20 ata initData;.
13b0: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 4d 61 73 const char *zMas
13c0: 74 65 72 4e 61 6d 65 3b 0a 20 20 69 6e 74 20 6f terName;. int o
13d0: 70 65 6e 65 64 54 72 61 6e 73 61 63 74 69 6f 6e penedTransaction
13e0: 20 3d 20 30 3b 0a 0a 20 20 61 73 73 65 72 74 28 = 0;.. assert(
13f0: 20 69 44 62 3e 3d 30 20 26 26 20 69 44 62 3c 64 iDb>=0 && iDb<d
1400: 62 2d 3e 6e 44 62 20 29 3b 0a 20 20 61 73 73 65 b->nDb );. asse
1410: 72 74 28 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d rt( db->aDb[iDb]
1420: 2e 70 53 63 68 65 6d 61 20 29 3b 0a 20 20 61 73 .pSchema );. as
1430: 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 sert( sqlite3_mu
1440: 74 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 tex_held(db->mut
1450: 65 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 ex) );. assert(
1460: 20 69 44 62 3d 3d 31 20 7c 7c 20 73 71 6c 69 74 iDb==1 || sqlit
1470: 65 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 e3BtreeHoldsMute
1480: 78 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 x(db->aDb[iDb].p
1490: 42 74 29 20 29 3b 0a 0a 20 20 2f 2a 20 43 6f 6e Bt) );.. /* Con
14a0: 73 74 72 75 63 74 20 74 68 65 20 69 6e 2d 6d 65 struct the in-me
14b0: 6d 6f 72 79 20 72 65 70 72 65 73 65 6e 74 61 74 mory representat
14c0: 69 6f 6e 20 73 63 68 65 6d 61 20 74 61 62 6c 65 ion schema table
14d0: 73 20 28 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 s (sqlite_master
14e0: 20 6f 72 0a 20 20 2a 2a 20 73 71 6c 69 74 65 5f or. ** sqlite_
14f0: 74 65 6d 70 5f 6d 61 73 74 65 72 29 20 62 79 20 temp_master) by
1500: 69 6e 76 6f 6b 69 6e 67 20 74 68 65 20 70 61 72 invoking the par
1510: 73 65 72 20 64 69 72 65 63 74 6c 79 2e 20 20 54 ser directly. T
1520: 68 65 20 61 70 70 72 6f 70 72 69 61 74 65 0a 20 he appropriate.
1530: 20 2a 2a 20 74 61 62 6c 65 20 6e 61 6d 65 20 77 ** table name w
1540: 69 6c 6c 20 62 65 20 69 6e 73 65 72 74 65 64 20 ill be inserted
1550: 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 62 79 automatically by
1560: 20 74 68 65 20 70 61 72 73 65 72 20 73 6f 20 77 the parser so w
1570: 65 20 63 61 6e 20 6a 75 73 74 0a 20 20 2a 2a 20 e can just. **
1580: 75 73 65 20 74 68 65 20 61 62 62 72 65 76 69 61 use the abbrevia
1590: 74 69 6f 6e 20 22 78 22 20 68 65 72 65 2e 20 20 tion "x" here.
15a0: 54 68 65 20 70 61 72 73 65 72 20 77 69 6c 6c 20 The parser will
15b0: 61 6c 73 6f 20 61 75 74 6f 6d 61 74 69 63 61 6c also automatical
15c0: 6c 79 20 74 61 67 0a 20 20 2a 2a 20 74 68 65 20 ly tag. ** the
15d0: 73 63 68 65 6d 61 20 74 61 62 6c 65 20 61 73 20 schema table as
15e0: 72 65 61 64 2d 6f 6e 6c 79 2e 20 2a 2f 0a 20 20 read-only. */.
15f0: 61 7a 41 72 67 5b 30 5d 20 3d 20 7a 4d 61 73 74 azArg[0] = zMast
1600: 65 72 4e 61 6d 65 20 3d 20 53 43 48 45 4d 41 5f erName = SCHEMA_
1610: 54 41 42 4c 45 28 69 44 62 29 3b 0a 20 20 61 7a TABLE(iDb);. az
1620: 41 72 67 5b 31 5d 20 3d 20 22 31 22 3b 0a 20 20 Arg[1] = "1";.
1630: 61 7a 41 72 67 5b 32 5d 20 3d 20 22 43 52 45 41 azArg[2] = "CREA
1640: 54 45 20 54 41 42 4c 45 20 78 28 74 79 70 65 20 TE TABLE x(type
1650: 74 65 78 74 2c 6e 61 6d 65 20 74 65 78 74 2c 74 text,name text,t
1660: 62 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 22 0a 20 bl_name text,".
1670: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1680: 20 20 20 20 20 20 20 20 20 20 20 22 72 6f 6f 74 "root
1690: 70 61 67 65 20 69 6e 74 65 67 65 72 2c 73 71 6c page integer,sql
16a0: 20 74 65 78 74 29 22 3b 0a 20 20 61 7a 41 72 67 text)";. azArg
16b0: 5b 33 5d 20 3d 20 30 3b 0a 20 20 69 6e 69 74 44 [3] = 0;. initD
16c0: 61 74 61 2e 64 62 20 3d 20 64 62 3b 0a 20 20 69 ata.db = db;. i
16d0: 6e 69 74 44 61 74 61 2e 69 44 62 20 3d 20 69 44 nitData.iDb = iD
16e0: 62 3b 0a 20 20 69 6e 69 74 44 61 74 61 2e 72 63 b;. initData.rc
16f0: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
1700: 69 6e 69 74 44 61 74 61 2e 70 7a 45 72 72 4d 73 initData.pzErrMs
1710: 67 20 3d 20 70 7a 45 72 72 4d 73 67 3b 0a 20 20 g = pzErrMsg;.
1720: 73 71 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 sqlite3InitCallb
1730: 61 63 6b 28 26 69 6e 69 74 44 61 74 61 2c 20 33 ack(&initData, 3
1740: 2c 20 28 63 68 61 72 20 2a 2a 29 61 7a 41 72 67 , (char **)azArg
1750: 2c 20 30 29 3b 0a 20 20 69 66 28 20 69 6e 69 74 , 0);. if( init
1760: 44 61 74 61 2e 72 63 20 29 7b 0a 20 20 20 20 72 Data.rc ){. r
1770: 63 20 3d 20 69 6e 69 74 44 61 74 61 2e 72 63 3b c = initData.rc;
1780: 0a 20 20 20 20 67 6f 74 6f 20 65 72 72 6f 72 5f . goto error_
1790: 6f 75 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 43 out;. }.. /* C
17a0: 72 65 61 74 65 20 61 20 63 75 72 73 6f 72 20 74 reate a cursor t
17b0: 6f 20 68 6f 6c 64 20 74 68 65 20 64 61 74 61 62 o hold the datab
17c0: 61 73 65 20 6f 70 65 6e 0a 20 20 2a 2f 0a 20 20 ase open. */.
17d0: 70 44 62 20 3d 20 26 64 62 2d 3e 61 44 62 5b 69 pDb = &db->aDb[i
17e0: 44 62 5d 3b 0a 20 20 69 66 28 20 70 44 62 2d 3e Db];. if( pDb->
17f0: 70 42 74 3d 3d 30 20 29 7b 0a 20 20 20 20 69 66 pBt==0 ){. if
1800: 28 20 21 4f 4d 49 54 5f 54 45 4d 50 44 42 20 26 ( !OMIT_TEMPDB &
1810: 26 20 41 4c 57 41 59 53 28 69 44 62 3d 3d 31 29 & ALWAYS(iDb==1)
1820: 20 29 7b 0a 20 20 20 20 20 20 44 62 53 65 74 50 ){. DbSetP
1830: 72 6f 70 65 72 74 79 28 64 62 2c 20 31 2c 20 44 roperty(db, 1, D
1840: 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 3b B_SchemaLoaded);
1850: 0a 20 20 20 20 7d 0a 20 20 20 20 72 65 74 75 72 . }. retur
1860: 6e 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 7d n SQLITE_OK;. }
1870: 0a 0a 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 .. /* If there
1880: 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 61 is not already a
1890: 20 72 65 61 64 2d 6f 6e 6c 79 20 28 6f 72 20 72 read-only (or r
18a0: 65 61 64 2d 77 72 69 74 65 29 20 74 72 61 6e 73 ead-write) trans
18b0: 61 63 74 69 6f 6e 20 6f 70 65 6e 65 64 0a 20 20 action opened.
18c0: 2a 2a 20 6f 6e 20 74 68 65 20 62 2d 74 72 65 65 ** on the b-tree
18d0: 20 64 61 74 61 62 61 73 65 2c 20 6f 70 65 6e 20 database, open
18e0: 6f 6e 65 20 6e 6f 77 2e 20 49 66 20 61 20 74 72 one now. If a tr
18f0: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 ansaction is ope
1900: 6e 65 64 2c 20 69 74 20 0a 20 20 2a 2a 20 77 69 ned, it . ** wi
1910: 6c 6c 20 62 65 20 63 6c 6f 73 65 64 20 62 65 66 ll be closed bef
1920: 6f 72 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f ore this functio
1930: 6e 20 72 65 74 75 72 6e 73 2e 20 20 2a 2f 0a 20 n returns. */.
1940: 20 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 sqlite3BtreeEnt
1950: 65 72 28 70 44 62 2d 3e 70 42 74 29 3b 0a 20 20 er(pDb->pBt);.
1960: 69 66 28 20 21 73 71 6c 69 74 65 33 42 74 72 65 if( !sqlite3Btre
1970: 65 49 73 49 6e 52 65 61 64 54 72 61 6e 73 28 70 eIsInReadTrans(p
1980: 44 62 2d 3e 70 42 74 29 20 29 7b 0a 20 20 20 20 Db->pBt) ){.
1990: 72 63 20 3d 20 73 71 6c 69 74 65 33 42 74 72 65 rc = sqlite3Btre
19a0: 65 42 65 67 69 6e 54 72 61 6e 73 28 70 44 62 2d eBeginTrans(pDb-
19b0: 3e 70 42 74 2c 20 30 29 3b 0a 20 20 20 20 69 66 >pBt, 0);. if
19c0: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
19d0: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
19e0: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d SetString(pzErrM
19f0: 73 67 2c 20 64 62 2c 20 73 71 6c 69 74 65 33 45 sg, db, sqlite3E
1a00: 72 72 53 74 72 28 72 63 29 29 3b 0a 20 20 20 20 rrStr(rc));.
1a10: 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f 65 goto initone_e
1a20: 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a rror_out;. }.
1a30: 20 20 20 20 6f 70 65 6e 65 64 54 72 61 6e 73 61 openedTransa
1a40: 63 74 69 6f 6e 20 3d 20 31 3b 0a 20 20 7d 0a 0a ction = 1;. }..
1a50: 20 20 2f 2a 20 47 65 74 20 74 68 65 20 64 61 74 /* Get the dat
1a60: 61 62 61 73 65 20 6d 65 74 61 20 69 6e 66 6f 72 abase meta infor
1a70: 6d 61 74 69 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a mation.. **. *
1a80: 2a 20 4d 65 74 61 20 76 61 6c 75 65 73 20 61 72 * Meta values ar
1a90: 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 e as follows:.
1aa0: 2a 2a 20 20 20 20 6d 65 74 61 5b 30 5d 20 20 20 ** meta[0]
1ab0: 53 63 68 65 6d 61 20 63 6f 6f 6b 69 65 2e 20 20 Schema cookie.
1ac0: 43 68 61 6e 67 65 73 20 77 69 74 68 20 65 61 63 Changes with eac
1ad0: 68 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 2e h schema change.
1ae0: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 31 5d . ** meta[1]
1af0: 20 20 20 46 69 6c 65 20 66 6f 72 6d 61 74 20 6f File format o
1b00: 66 20 73 63 68 65 6d 61 20 6c 61 79 65 72 2e 0a f schema layer..
1b10: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 32 5d 20 ** meta[2]
1b20: 20 20 53 69 7a 65 20 6f 66 20 74 68 65 20 70 61 Size of the pa
1b30: 67 65 20 63 61 63 68 65 2e 0a 20 20 2a 2a 20 20 ge cache.. **
1b40: 20 20 6d 65 74 61 5b 33 5d 20 20 20 4c 61 72 67 meta[3] Larg
1b50: 65 73 74 20 72 6f 6f 74 70 61 67 65 20 28 61 75 est rootpage (au
1b60: 74 6f 2f 69 6e 63 72 5f 76 61 63 75 75 6d 20 6d to/incr_vacuum m
1b70: 6f 64 65 29 0a 20 20 2a 2a 20 20 20 20 6d 65 74 ode). ** met
1b80: 61 5b 34 5d 20 20 20 44 62 20 74 65 78 74 20 65 a[4] Db text e
1b90: 6e 63 6f 64 69 6e 67 2e 20 31 3a 55 54 46 2d 38 ncoding. 1:UTF-8
1ba0: 20 32 3a 55 54 46 2d 31 36 4c 45 20 33 3a 55 54 2:UTF-16LE 3:UT
1bb0: 46 2d 31 36 42 45 0a 20 20 2a 2a 20 20 20 20 6d F-16BE. ** m
1bc0: 65 74 61 5b 35 5d 20 20 20 55 73 65 72 20 76 65 eta[5] User ve
1bd0: 72 73 69 6f 6e 0a 20 20 2a 2a 20 20 20 20 6d 65 rsion. ** me
1be0: 74 61 5b 36 5d 20 20 20 49 6e 63 72 65 6d 65 6e ta[6] Incremen
1bf0: 74 61 6c 20 76 61 63 75 75 6d 20 6d 6f 64 65 0a tal vacuum mode.
1c00: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 37 5d 20 ** meta[7]
1c10: 20 20 75 6e 75 73 65 64 0a 20 20 2a 2a 20 20 20 unused. **
1c20: 20 6d 65 74 61 5b 38 5d 20 20 20 75 6e 75 73 65 meta[8] unuse
1c30: 64 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 39 d. ** meta[9
1c40: 5d 20 20 20 75 6e 75 73 65 64 0a 20 20 2a 2a 0a ] unused. **.
1c50: 20 20 2a 2a 20 4e 6f 74 65 3a 20 54 68 65 20 23 ** Note: The #
1c60: 64 65 66 69 6e 65 64 20 53 51 4c 49 54 45 5f 55 defined SQLITE_U
1c70: 54 46 2a 20 73 79 6d 62 6f 6c 73 20 69 6e 20 73 TF* symbols in s
1c80: 71 6c 69 74 65 49 6e 74 2e 68 20 63 6f 72 72 65 qliteInt.h corre
1c90: 73 70 6f 6e 64 20 74 6f 0a 20 20 2a 2a 20 74 68 spond to. ** th
1ca0: 65 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 e possible value
1cb0: 73 20 6f 66 20 6d 65 74 61 5b 34 5d 2e 0a 20 20 s of meta[4]..
1cc0: 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c */. for(i=0; i<
1cd0: 41 72 72 61 79 53 69 7a 65 28 6d 65 74 61 29 3b ArraySize(meta);
1ce0: 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 i++){. sqlit
1cf0: 65 33 42 74 72 65 65 47 65 74 4d 65 74 61 28 70 e3BtreeGetMeta(p
1d00: 44 62 2d 3e 70 42 74 2c 20 69 2b 31 2c 20 28 75 Db->pBt, i+1, (u
1d10: 33 32 20 2a 29 26 6d 65 74 61 5b 69 5d 29 3b 0a 32 *)&meta[i]);.
1d20: 20 20 7d 0a 20 20 70 44 62 2d 3e 70 53 63 68 65 }. pDb->pSche
1d30: 6d 61 2d 3e 73 63 68 65 6d 61 5f 63 6f 6f 6b 69 ma->schema_cooki
1d40: 65 20 3d 20 6d 65 74 61 5b 42 54 52 45 45 5f 53 e = meta[BTREE_S
1d50: 43 48 45 4d 41 5f 56 45 52 53 49 4f 4e 2d 31 5d CHEMA_VERSION-1]
1d60: 3b 0a 0a 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69 ;.. /* If openi
1d70: 6e 67 20 61 20 6e 6f 6e 2d 65 6d 70 74 79 20 64 ng a non-empty d
1d80: 61 74 61 62 61 73 65 2c 20 63 68 65 63 6b 20 74 atabase, check t
1d90: 68 65 20 74 65 78 74 20 65 6e 63 6f 64 69 6e 67 he text encoding
1da0: 2e 20 46 6f 72 20 74 68 65 0a 20 20 2a 2a 20 6d . For the. ** m
1db0: 61 69 6e 20 64 61 74 61 62 61 73 65 2c 20 73 65 ain database, se
1dc0: 74 20 73 71 6c 69 74 65 33 2e 65 6e 63 20 74 6f t sqlite3.enc to
1dd0: 20 74 68 65 20 65 6e 63 6f 64 69 6e 67 20 6f 66 the encoding of
1de0: 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 the main databa
1df0: 73 65 2e 0a 20 20 2a 2a 20 46 6f 72 20 61 6e 20 se.. ** For an
1e00: 61 74 74 61 63 68 65 64 20 64 62 2c 20 69 74 20 attached db, it
1e10: 69 73 20 61 6e 20 65 72 72 6f 72 20 69 66 20 74 is an error if t
1e20: 68 65 20 65 6e 63 6f 64 69 6e 67 20 69 73 20 6e he encoding is n
1e30: 6f 74 20 74 68 65 20 73 61 6d 65 0a 20 20 2a 2a ot the same. **
1e40: 20 61 73 20 73 71 6c 69 74 65 33 2e 65 6e 63 2e as sqlite3.enc.
1e50: 0a 20 20 2a 2f 0a 20 20 69 66 28 20 6d 65 74 61 . */. if( meta
1e60: 5b 42 54 52 45 45 5f 54 45 58 54 5f 45 4e 43 4f [BTREE_TEXT_ENCO
1e70: 44 49 4e 47 2d 31 5d 20 29 7b 20 20 2f 2a 20 74 DING-1] ){ /* t
1e80: 65 78 74 20 65 6e 63 6f 64 69 6e 67 20 2a 2f 0a ext encoding */.
1e90: 20 20 20 20 69 66 28 20 69 44 62 3d 3d 30 20 29 if( iDb==0 )
1ea0: 7b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 {.#ifndef SQLITE
1eb0: 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 20 20 20 20 _OMIT_UTF16.
1ec0: 20 20 75 38 20 65 6e 63 6f 64 69 6e 67 3b 0a 20 u8 encoding;.
1ed0: 20 20 20 20 20 2f 2a 20 49 66 20 6f 70 65 6e 69 /* If openi
1ee0: 6e 67 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61 ng the main data
1ef0: 62 61 73 65 2c 20 73 65 74 20 45 4e 43 28 64 62 base, set ENC(db
1f00: 29 2e 20 2a 2f 0a 20 20 20 20 20 20 65 6e 63 6f ). */. enco
1f10: 64 69 6e 67 20 3d 20 28 75 38 29 6d 65 74 61 5b ding = (u8)meta[
1f20: 42 54 52 45 45 5f 54 45 58 54 5f 45 4e 43 4f 44 BTREE_TEXT_ENCOD
1f30: 49 4e 47 2d 31 5d 20 26 20 33 3b 0a 20 20 20 20 ING-1] & 3;.
1f40: 20 20 69 66 28 20 65 6e 63 6f 64 69 6e 67 3d 3d if( encoding==
1f50: 30 20 29 20 65 6e 63 6f 64 69 6e 67 20 3d 20 53 0 ) encoding = S
1f60: 51 4c 49 54 45 5f 55 54 46 38 3b 0a 20 20 20 20 QLITE_UTF8;.
1f70: 20 20 45 4e 43 28 64 62 29 20 3d 20 65 6e 63 6f ENC(db) = enco
1f80: 64 69 6e 67 3b 0a 23 65 6c 73 65 0a 20 20 20 20 ding;.#else.
1f90: 20 20 45 4e 43 28 64 62 29 20 3d 20 53 51 4c 49 ENC(db) = SQLI
1fa0: 54 45 5f 55 54 46 38 3b 0a 23 65 6e 64 69 66 0a TE_UTF8;.#endif.
1fb0: 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 }else{.
1fc0: 20 2f 2a 20 49 66 20 6f 70 65 6e 69 6e 67 20 61 /* If opening a
1fd0: 6e 20 61 74 74 61 63 68 65 64 20 64 61 74 61 62 n attached datab
1fe0: 61 73 65 2c 20 74 68 65 20 65 6e 63 6f 64 69 6e ase, the encodin
1ff0: 67 20 6d 75 63 68 20 6d 61 74 63 68 20 45 4e 43 g much match ENC
2000: 28 64 62 29 20 2a 2f 0a 20 20 20 20 20 20 69 66 (db) */. if
2010: 28 20 6d 65 74 61 5b 42 54 52 45 45 5f 54 45 58 ( meta[BTREE_TEX
2020: 54 5f 45 4e 43 4f 44 49 4e 47 2d 31 5d 21 3d 45 T_ENCODING-1]!=E
2030: 4e 43 28 64 62 29 20 29 7b 0a 20 20 20 20 20 20 NC(db) ){.
2040: 20 20 73 71 6c 69 74 65 33 53 65 74 53 74 72 69 sqlite3SetStri
2050: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 64 62 2c ng(pzErrMsg, db,
2060: 20 22 61 74 74 61 63 68 65 64 20 64 61 74 61 62 "attached datab
2070: 61 73 65 73 20 6d 75 73 74 20 75 73 65 20 74 68 ases must use th
2080: 65 20 73 61 6d 65 22 0a 20 20 20 20 20 20 20 20 e same".
2090: 20 20 20 20 22 20 74 65 78 74 20 65 6e 63 6f 64 " text encod
20a0: 69 6e 67 20 61 73 20 6d 61 69 6e 20 64 61 74 61 ing as main data
20b0: 62 61 73 65 22 29 3b 0a 20 20 20 20 20 20 20 20 base");.
20c0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f rc = SQLITE_ERRO
20d0: 52 3b 0a 20 20 20 20 20 20 20 20 67 6f 74 6f 20 R;. goto
20e0: 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75 initone_error_ou
20f0: 74 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 7d t;. }. }
2100: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 44 62 . }else{. Db
2110: 53 65 74 50 72 6f 70 65 72 74 79 28 64 62 2c 20 SetProperty(db,
2120: 69 44 62 2c 20 44 42 5f 45 6d 70 74 79 29 3b 0a iDb, DB_Empty);.
2130: 20 20 7d 0a 20 20 70 44 62 2d 3e 70 53 63 68 65 }. pDb->pSche
2140: 6d 61 2d 3e 65 6e 63 20 3d 20 45 4e 43 28 64 62 ma->enc = ENC(db
2150: 29 3b 0a 0a 20 20 69 66 28 20 70 44 62 2d 3e 70 );.. if( pDb->p
2160: 53 63 68 65 6d 61 2d 3e 63 61 63 68 65 5f 73 69 Schema->cache_si
2170: 7a 65 3d 3d 30 20 29 7b 0a 23 69 66 6e 64 65 66 ze==0 ){.#ifndef
2180: 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 44 45 50 SQLITE_OMIT_DEP
2190: 52 45 43 41 54 45 44 0a 20 20 20 20 73 69 7a 65 RECATED. size
21a0: 20 3d 20 73 71 6c 69 74 65 33 41 62 73 49 6e 74 = sqlite3AbsInt
21b0: 33 32 28 6d 65 74 61 5b 42 54 52 45 45 5f 44 45 32(meta[BTREE_DE
21c0: 46 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a 45 FAULT_CACHE_SIZE
21d0: 2d 31 5d 29 3b 0a 20 20 20 20 69 66 28 20 73 69 -1]);. if( si
21e0: 7a 65 3d 3d 30 20 29 7b 20 73 69 7a 65 20 3d 20 ze==0 ){ size =
21f0: 53 51 4c 49 54 45 5f 44 45 46 41 55 4c 54 5f 43 SQLITE_DEFAULT_C
2200: 41 43 48 45 5f 53 49 5a 45 3b 20 7d 0a 20 20 20 ACHE_SIZE; }.
2210: 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 63 pDb->pSchema->c
2220: 61 63 68 65 5f 73 69 7a 65 20 3d 20 73 69 7a 65 ache_size = size
2230: 3b 0a 23 65 6c 73 65 0a 20 20 20 20 70 44 62 2d ;.#else. pDb-
2240: 3e 70 53 63 68 65 6d 61 2d 3e 63 61 63 68 65 5f >pSchema->cache_
2250: 73 69 7a 65 20 3d 20 53 51 4c 49 54 45 5f 44 45 size = SQLITE_DE
2260: 46 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a 45 FAULT_CACHE_SIZE
2270: 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 73 71 6c ;.#endif. sql
2280: 69 74 65 33 42 74 72 65 65 53 65 74 43 61 63 68 ite3BtreeSetCach
2290: 65 53 69 7a 65 28 70 44 62 2d 3e 70 42 74 2c 20 eSize(pDb->pBt,
22a0: 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 63 61 pDb->pSchema->ca
22b0: 63 68 65 5f 73 69 7a 65 29 3b 0a 20 20 7d 0a 0a che_size);. }..
22c0: 20 20 2f 2a 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 /*. ** file_f
22d0: 6f 72 6d 61 74 3d 3d 31 20 20 20 20 56 65 72 73 ormat==1 Vers
22e0: 69 6f 6e 20 33 2e 30 2e 30 2e 0a 20 20 2a 2a 20 ion 3.0.0.. **
22f0: 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 32 20 20 file_format==2
2300: 20 20 56 65 72 73 69 6f 6e 20 33 2e 31 2e 33 2e Version 3.1.3.
2310: 20 20 2f 2f 20 41 4c 54 45 52 20 54 41 42 4c 45 // ALTER TABLE
2320: 20 41 44 44 20 43 4f 4c 55 4d 4e 0a 20 20 2a 2a ADD COLUMN. **
2330: 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 33 20 file_format==3
2340: 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 31 2e 34 Version 3.1.4
2350: 2e 20 20 2f 2f 20 64 69 74 74 6f 20 62 75 74 20 . // ditto but
2360: 77 69 74 68 20 6e 6f 6e 2d 4e 55 4c 4c 20 64 65 with non-NULL de
2370: 66 61 75 6c 74 73 0a 20 20 2a 2a 20 66 69 6c 65 faults. ** file
2380: 5f 66 6f 72 6d 61 74 3d 3d 34 20 20 20 20 56 65 _format==4 Ve
2390: 72 73 69 6f 6e 20 33 2e 33 2e 30 2e 20 20 2f 2f rsion 3.3.0. //
23a0: 20 44 45 53 43 20 69 6e 64 69 63 65 73 2e 20 20 DESC indices.
23b0: 42 6f 6f 6c 65 61 6e 20 63 6f 6e 73 74 61 6e 74 Boolean constant
23c0: 73 0a 20 20 2a 2f 0a 20 20 70 44 62 2d 3e 70 53 s. */. pDb->pS
23d0: 63 68 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f 72 6d chema->file_form
23e0: 61 74 20 3d 20 28 75 38 29 6d 65 74 61 5b 42 54 at = (u8)meta[BT
23f0: 52 45 45 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 2d REE_FILE_FORMAT-
2400: 31 5d 3b 0a 20 20 69 66 28 20 70 44 62 2d 3e 70 1];. if( pDb->p
2410: 53 63 68 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f 72 Schema->file_for
2420: 6d 61 74 3d 3d 30 20 29 7b 0a 20 20 20 20 70 44 mat==0 ){. pD
2430: 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69 6c 65 b->pSchema->file
2440: 5f 66 6f 72 6d 61 74 20 3d 20 31 3b 0a 20 20 7d _format = 1;. }
2450: 0a 20 20 69 66 28 20 70 44 62 2d 3e 70 53 63 68 . if( pDb->pSch
2460: 65 6d 61 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 ema->file_format
2470: 3e 53 51 4c 49 54 45 5f 4d 41 58 5f 46 49 4c 45 >SQLITE_MAX_FILE
2480: 5f 46 4f 52 4d 41 54 20 29 7b 0a 20 20 20 20 73 _FORMAT ){. s
2490: 71 6c 69 74 65 33 53 65 74 53 74 72 69 6e 67 28 qlite3SetString(
24a0: 70 7a 45 72 72 4d 73 67 2c 20 64 62 2c 20 22 75 pzErrMsg, db, "u
24b0: 6e 73 75 70 70 6f 72 74 65 64 20 66 69 6c 65 20 nsupported file
24c0: 66 6f 72 6d 61 74 22 29 3b 0a 20 20 20 20 72 63 format");. rc
24d0: 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b = SQLITE_ERROR;
24e0: 0a 20 20 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e . goto initon
24f0: 65 5f 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d e_error_out;. }
2500: 0a 0a 20 20 2f 2a 20 54 69 63 6b 65 74 20 23 32 .. /* Ticket #2
2510: 38 30 34 3a 20 20 57 68 65 6e 20 77 65 20 6f 70 804: When we op
2520: 65 6e 20 61 20 64 61 74 61 62 61 73 65 20 69 6e en a database in
2530: 20 74 68 65 20 6e 65 77 65 72 20 66 69 6c 65 20 the newer file
2540: 66 6f 72 6d 61 74 2c 0a 20 20 2a 2a 20 63 6c 65 format,. ** cle
2550: 61 72 20 74 68 65 20 6c 65 67 61 63 79 5f 66 69 ar the legacy_fi
2560: 6c 65 5f 66 6f 72 6d 61 74 20 70 72 61 67 6d 61 le_format pragma
2570: 20 66 6c 61 67 20 73 6f 20 74 68 61 74 20 61 20 flag so that a
2580: 56 41 43 55 55 4d 20 77 69 6c 6c 0a 20 20 2a 2a VACUUM will. **
2590: 20 6e 6f 74 20 64 6f 77 6e 67 72 61 64 65 20 74 not downgrade t
25a0: 68 65 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 he database and
25b0: 74 68 75 73 20 69 6e 76 61 6c 69 64 61 74 65 20 thus invalidate
25c0: 61 6e 79 20 64 65 73 63 65 6e 64 69 6e 67 0a 20 any descending.
25d0: 20 2a 2a 20 69 6e 64 69 63 65 73 20 74 68 61 74 ** indices that
25e0: 20 74 68 65 20 75 73 65 72 20 6d 69 67 68 74 20 the user might
25f0: 68 61 76 65 20 63 72 65 61 74 65 64 2e 0a 20 20 have created..
2600: 2a 2f 0a 20 20 69 66 28 20 69 44 62 3d 3d 30 20 */. if( iDb==0
2610: 26 26 20 6d 65 74 61 5b 42 54 52 45 45 5f 46 49 && meta[BTREE_FI
2620: 4c 45 5f 46 4f 52 4d 41 54 2d 31 5d 3e 3d 34 20 LE_FORMAT-1]>=4
2630: 29 7b 0a 20 20 20 20 64 62 2d 3e 66 6c 61 67 73 ){. db->flags
2640: 20 26 3d 20 7e 53 51 4c 49 54 45 5f 4c 65 67 61 &= ~SQLITE_Lega
2650: 63 79 46 69 6c 65 46 6d 74 3b 0a 20 20 7d 0a 0a cyFileFmt;. }..
2660: 20 20 2f 2a 20 52 65 61 64 20 74 68 65 20 73 63 /* Read the sc
2670: 68 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e hema information
2680: 20 6f 75 74 20 6f 66 20 74 68 65 20 73 63 68 65 out of the sche
2690: 6d 61 20 74 61 62 6c 65 73 0a 20 20 2a 2f 0a 20 ma tables. */.
26a0: 20 61 73 73 65 72 74 28 20 64 62 2d 3e 69 6e 69 assert( db->ini
26b0: 74 2e 62 75 73 79 20 29 3b 0a 20 20 7b 0a 20 20 t.busy );. {.
26c0: 20 20 63 68 61 72 20 2a 7a 53 71 6c 3b 0a 20 20 char *zSql;.
26d0: 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69 74 65 33 zSql = sqlite3
26e0: 4d 50 72 69 6e 74 66 28 64 62 2c 20 0a 20 20 20 MPrintf(db, .
26f0: 20 20 20 20 20 22 53 45 4c 45 43 54 20 6e 61 6d "SELECT nam
2700: 65 2c 20 72 6f 6f 74 70 61 67 65 2c 20 73 71 6c e, rootpage, sql
2710: 20 46 52 4f 4d 20 5c 22 25 77 5c 22 2e 25 73 20 FROM \"%w\".%s
2720: 4f 52 44 45 52 20 42 59 20 72 6f 77 69 64 22 2c ORDER BY rowid",
2730: 0a 20 20 20 20 20 20 20 20 64 62 2d 3e 61 44 62 . db->aDb
2740: 5b 69 44 62 5d 2e 7a 44 62 53 4e 61 6d 65 2c 20 [iDb].zDbSName,
2750: 7a 4d 61 73 74 65 72 4e 61 6d 65 29 3b 0a 23 69 zMasterName);.#i
2760: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
2770: 54 5f 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a T_AUTHORIZATION.
2780: 20 20 20 20 7b 0a 20 20 20 20 20 20 73 71 6c 69 {. sqli
2790: 74 65 33 5f 78 61 75 74 68 20 78 41 75 74 68 3b te3_xauth xAuth;
27a0: 0a 20 20 20 20 20 20 78 41 75 74 68 20 3d 20 64 . xAuth = d
27b0: 62 2d 3e 78 41 75 74 68 3b 0a 20 20 20 20 20 20 b->xAuth;.
27c0: 64 62 2d 3e 78 41 75 74 68 20 3d 20 30 3b 0a 23 db->xAuth = 0;.#
27d0: 65 6e 64 69 66 0a 20 20 20 20 20 20 72 63 20 3d endif. rc =
27e0: 20 73 71 6c 69 74 65 33 5f 65 78 65 63 28 64 62 sqlite3_exec(db
27f0: 2c 20 7a 53 71 6c 2c 20 73 71 6c 69 74 65 33 49 , zSql, sqlite3I
2800: 6e 69 74 43 61 6c 6c 62 61 63 6b 2c 20 26 69 6e nitCallback, &in
2810: 69 74 44 61 74 61 2c 20 30 29 3b 0a 23 69 66 6e itData, 0);.#ifn
2820: 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f def SQLITE_OMIT_
2830: 41 55 54 48 4f 52 49 5a 41 54 49 4f 4e 0a 20 20 AUTHORIZATION.
2840: 20 20 20 20 64 62 2d 3e 78 41 75 74 68 20 3d 20 db->xAuth =
2850: 78 41 75 74 68 3b 0a 20 20 20 20 7d 0a 23 65 6e xAuth;. }.#en
2860: 64 69 66 0a 20 20 20 20 69 66 28 20 72 63 3d 3d dif. if( rc==
2870: 53 51 4c 49 54 45 5f 4f 4b 20 29 20 72 63 20 3d SQLITE_OK ) rc =
2880: 20 69 6e 69 74 44 61 74 61 2e 72 63 3b 0a 20 20 initData.rc;.
2890: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
28a0: 64 62 2c 20 7a 53 71 6c 29 3b 0a 23 69 66 6e 64 db, zSql);.#ifnd
28b0: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 41 ef SQLITE_OMIT_A
28c0: 4e 41 4c 59 5a 45 0a 20 20 20 20 69 66 28 20 72 NALYZE. if( r
28d0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a c==SQLITE_OK ){.
28e0: 20 20 20 20 20 20 73 71 6c 69 74 65 33 41 6e 61 sqlite3Ana
28f0: 6c 79 73 69 73 4c 6f 61 64 28 64 62 2c 20 69 44 lysisLoad(db, iD
2900: 62 29 3b 0a 20 20 20 20 7d 0a 23 65 6e 64 69 66 b);. }.#endif
2910: 0a 20 20 7d 0a 20 20 69 66 28 20 64 62 2d 3e 6d . }. if( db->m
2920: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 allocFailed ){.
2930: 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e rc = SQLITE_N
2940: 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 20 20 73 OMEM_BKPT;. s
2950: 71 6c 69 74 65 33 52 65 73 65 74 41 6c 6c 53 63 qlite3ResetAllSc
2960: 68 65 6d 61 73 4f 66 43 6f 6e 6e 65 63 74 69 6f hemasOfConnectio
2970: 6e 28 64 62 29 3b 0a 20 20 7d 0a 20 20 69 66 28 n(db);. }. if(
2980: 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c rc==SQLITE_OK |
2990: 7c 20 28 64 62 2d 3e 66 6c 61 67 73 26 53 51 4c | (db->flags&SQL
29a0: 49 54 45 5f 57 72 69 74 65 53 63 68 65 6d 61 29 ITE_WriteSchema)
29b0: 29 7b 0a 20 20 20 20 2f 2a 20 42 6c 61 63 6b 20 ){. /* Black
29c0: 6d 61 67 69 63 3a 20 49 66 20 74 68 65 20 53 51 magic: If the SQ
29d0: 4c 49 54 45 5f 57 72 69 74 65 53 63 68 65 6d 61 LITE_WriteSchema
29e0: 20 66 6c 61 67 20 69 73 20 73 65 74 2c 20 74 68 flag is set, th
29f0: 65 6e 20 63 6f 6e 73 69 64 65 72 0a 20 20 20 20 en consider.
2a00: 2a 2a 20 74 68 65 20 73 63 68 65 6d 61 20 6c 6f ** the schema lo
2a10: 61 64 65 64 2c 20 65 76 65 6e 20 69 66 20 65 72 aded, even if er
2a20: 72 6f 72 73 20 6f 63 63 75 72 72 65 64 2e 20 49 rors occurred. I
2a30: 6e 20 74 68 69 73 20 73 69 74 75 61 74 69 6f 6e n this situation
2a40: 20 74 68 65 20 0a 20 20 20 20 2a 2a 20 63 75 72 the . ** cur
2a50: 72 65 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 rent sqlite3_pre
2a60: 70 61 72 65 28 29 20 6f 70 65 72 61 74 69 6f 6e pare() operation
2a70: 20 77 69 6c 6c 20 66 61 69 6c 2c 20 62 75 74 20 will fail, but
2a80: 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 6e the following on
2a90: 65 0a 20 20 20 20 2a 2a 20 77 69 6c 6c 20 61 74 e. ** will at
2aa0: 74 65 6d 70 74 20 74 6f 20 63 6f 6d 70 69 6c 65 tempt to compile
2ab0: 20 74 68 65 20 73 75 70 70 6c 69 65 64 20 73 74 the supplied st
2ac0: 61 74 65 6d 65 6e 74 20 61 67 61 69 6e 73 74 20 atement against
2ad0: 77 68 61 74 65 76 65 72 20 73 75 62 73 65 74 0a whatever subset.
2ae0: 20 20 20 20 2a 2a 20 6f 66 20 74 68 65 20 73 63 ** of the sc
2af0: 68 65 6d 61 20 77 61 73 20 6c 6f 61 64 65 64 20 hema was loaded
2b00: 62 65 66 6f 72 65 20 74 68 65 20 65 72 72 6f 72 before the error
2b10: 20 6f 63 63 75 72 72 65 64 2e 20 54 68 65 20 70 occurred. The p
2b20: 72 69 6d 61 72 79 0a 20 20 20 20 2a 2a 20 70 75 rimary. ** pu
2b30: 72 70 6f 73 65 20 6f 66 20 74 68 69 73 20 69 73 rpose of this is
2b40: 20 74 6f 20 61 6c 6c 6f 77 20 61 63 63 65 73 73 to allow access
2b50: 20 74 6f 20 74 68 65 20 73 71 6c 69 74 65 5f 6d to the sqlite_m
2b60: 61 73 74 65 72 20 74 61 62 6c 65 0a 20 20 20 20 aster table.
2b70: 2a 2a 20 65 76 65 6e 20 77 68 65 6e 20 69 74 73 ** even when its
2b80: 20 63 6f 6e 74 65 6e 74 73 20 68 61 76 65 20 62 contents have b
2b90: 65 65 6e 20 63 6f 72 72 75 70 74 65 64 2e 0a 20 een corrupted..
2ba0: 20 20 20 2a 2f 0a 20 20 20 20 44 62 53 65 74 50 */. DbSetP
2bb0: 72 6f 70 65 72 74 79 28 64 62 2c 20 69 44 62 2c roperty(db, iDb,
2bc0: 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 DB_SchemaLoaded
2bd0: 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 );. rc = SQLI
2be0: 54 45 5f 4f 4b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a TE_OK;. }.. /*
2bf0: 20 4a 75 6d 70 20 68 65 72 65 20 66 6f 72 20 61 Jump here for a
2c00: 6e 20 65 72 72 6f 72 20 74 68 61 74 20 6f 63 63 n error that occ
2c10: 75 72 73 20 61 66 74 65 72 20 73 75 63 63 65 73 urs after succes
2c20: 73 66 75 6c 6c 79 20 61 6c 6c 6f 63 61 74 69 6e sfully allocatin
2c30: 67 0a 20 20 2a 2a 20 63 75 72 4d 61 69 6e 20 61 g. ** curMain a
2c40: 6e 64 20 63 61 6c 6c 69 6e 67 20 73 71 6c 69 74 nd calling sqlit
2c50: 65 33 42 74 72 65 65 45 6e 74 65 72 28 29 2e 20 e3BtreeEnter().
2c60: 46 6f 72 20 61 6e 20 65 72 72 6f 72 20 74 68 61 For an error tha
2c70: 74 20 6f 63 63 75 72 73 0a 20 20 2a 2a 20 62 65 t occurs. ** be
2c80: 66 6f 72 65 20 74 68 61 74 20 70 6f 69 6e 74 2c fore that point,
2c90: 20 6a 75 6d 70 20 74 6f 20 65 72 72 6f 72 5f 6f jump to error_o
2ca0: 75 74 2e 0a 20 20 2a 2f 0a 69 6e 69 74 6f 6e 65 ut.. */.initone
2cb0: 5f 65 72 72 6f 72 5f 6f 75 74 3a 0a 20 20 69 66 _error_out:. if
2cc0: 28 20 6f 70 65 6e 65 64 54 72 61 6e 73 61 63 74 ( openedTransact
2cd0: 69 6f 6e 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 ion ){. sqlit
2ce0: 65 33 42 74 72 65 65 43 6f 6d 6d 69 74 28 70 44 e3BtreeCommit(pD
2cf0: 62 2d 3e 70 42 74 29 3b 0a 20 20 7d 0a 20 20 73 b->pBt);. }. s
2d00: 71 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 qlite3BtreeLeave
2d10: 28 70 44 62 2d 3e 70 42 74 29 3b 0a 0a 65 72 72 (pDb->pBt);..err
2d20: 6f 72 5f 6f 75 74 3a 0a 20 20 69 66 28 20 72 63 or_out:. if( rc
2d30: 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 7c ==SQLITE_NOMEM |
2d40: 7c 20 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 | rc==SQLITE_IOE
2d50: 52 52 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 RR_NOMEM ){.
2d60: 73 71 6c 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28 sqlite3OomFault(
2d70: 64 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 db);. }. retur
2d80: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 49 n rc;.}../*.** I
2d90: 6e 69 74 69 61 6c 69 7a 65 20 61 6c 6c 20 64 61 nitialize all da
2da0: 74 61 62 61 73 65 20 66 69 6c 65 73 20 2d 20 74 tabase files - t
2db0: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65 he main database
2dc0: 20 66 69 6c 65 2c 20 74 68 65 20 66 69 6c 65 0a file, the file.
2dd0: 2a 2a 20 75 73 65 64 20 74 6f 20 73 74 6f 72 65 ** used to store
2de0: 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65 temporary table
2df0: 73 2c 20 61 6e 64 20 61 6e 79 20 61 64 64 69 74 s, and any addit
2e00: 69 6f 6e 61 6c 20 64 61 74 61 62 61 73 65 20 66 ional database f
2e10: 69 6c 65 73 0a 2a 2a 20 63 72 65 61 74 65 64 20 iles.** created
2e20: 75 73 69 6e 67 20 41 54 54 41 43 48 20 73 74 61 using ATTACH sta
2e30: 74 65 6d 65 6e 74 73 2e 20 20 52 65 74 75 72 6e tements. Return
2e40: 20 61 20 73 75 63 63 65 73 73 20 63 6f 64 65 2e a success code.
2e50: 20 20 49 66 20 61 6e 0a 2a 2a 20 65 72 72 6f 72 If an.** error
2e60: 20 6f 63 63 75 72 73 2c 20 77 72 69 74 65 20 61 occurs, write a
2e70: 6e 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 n error message
2e80: 69 6e 74 6f 20 2a 70 7a 45 72 72 4d 73 67 2e 0a into *pzErrMsg..
2e90: 2a 2a 0a 2a 2a 20 41 66 74 65 72 20 61 20 64 61 **.** After a da
2ea0: 74 61 62 61 73 65 20 69 73 20 69 6e 69 74 69 61 tabase is initia
2eb0: 6c 69 7a 65 64 2c 20 74 68 65 20 44 42 5f 53 63 lized, the DB_Sc
2ec0: 68 65 6d 61 4c 6f 61 64 65 64 20 62 69 74 20 69 hemaLoaded bit i
2ed0: 73 20 73 65 74 0a 2a 2a 20 62 69 74 20 69 73 20 s set.** bit is
2ee0: 73 65 74 20 69 6e 20 74 68 65 20 66 6c 61 67 73 set in the flags
2ef0: 20 66 69 65 6c 64 20 6f 66 20 74 68 65 20 44 62 field of the Db
2f00: 20 73 74 72 75 63 74 75 72 65 2e 20 49 66 20 74 structure. If t
2f10: 68 65 20 64 61 74 61 62 61 73 65 0a 2a 2a 20 66 he database.** f
2f20: 69 6c 65 20 77 61 73 20 6f 66 20 7a 65 72 6f 2d ile was of zero-
2f30: 6c 65 6e 67 74 68 2c 20 74 68 65 6e 20 74 68 65 length, then the
2f40: 20 44 42 5f 45 6d 70 74 79 20 66 6c 61 67 20 69 DB_Empty flag i
2f50: 73 20 61 6c 73 6f 20 73 65 74 2e 0a 2a 2f 0a 69 s also set..*/.i
2f60: 6e 74 20 73 71 6c 69 74 65 33 49 6e 69 74 28 73 nt sqlite3Init(s
2f70: 71 6c 69 74 65 33 20 2a 64 62 2c 20 63 68 61 72 qlite3 *db, char
2f80: 20 2a 2a 70 7a 45 72 72 4d 73 67 29 7b 0a 20 20 **pzErrMsg){.
2f90: 69 6e 74 20 69 2c 20 72 63 3b 0a 20 20 69 6e 74 int i, rc;. int
2fa0: 20 63 6f 6d 6d 69 74 5f 69 6e 74 65 72 6e 61 6c commit_internal
2fb0: 20 3d 20 21 28 64 62 2d 3e 6d 44 62 46 6c 61 67 = !(db->mDbFlag
2fc0: 73 26 44 42 46 4c 41 47 5f 53 63 68 65 6d 61 43 s&DBFLAG_SchemaC
2fd0: 68 61 6e 67 65 29 3b 0a 20 20 0a 20 20 61 73 73 hange);. . ass
2fe0: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
2ff0: 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 ex_held(db->mute
3000: 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
3010: 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64 sqlite3BtreeHold
3020: 73 4d 75 74 65 78 28 64 62 2d 3e 61 44 62 5b 30 sMutex(db->aDb[0
3030: 5d 2e 70 42 74 29 20 29 3b 0a 20 20 61 73 73 65 ].pBt) );. asse
3040: 72 74 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 rt( db->init.bus
3050: 79 3d 3d 30 20 29 3b 0a 20 20 72 63 20 3d 20 53 y==0 );. rc = S
3060: 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 64 62 2d 3e QLITE_OK;. db->
3070: 69 6e 69 74 2e 62 75 73 79 20 3d 20 31 3b 0a 20 init.busy = 1;.
3080: 20 45 4e 43 28 64 62 29 20 3d 20 53 43 48 45 4d ENC(db) = SCHEM
3090: 41 5f 45 4e 43 28 64 62 29 3b 0a 20 20 66 6f 72 A_ENC(db);. for
30a0: 28 69 3d 30 3b 20 72 63 3d 3d 53 51 4c 49 54 45 (i=0; rc==SQLITE
30b0: 5f 4f 4b 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 _OK && i<db->nDb
30c0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 69 66 28 20 ; i++){. if(
30d0: 44 62 48 61 73 50 72 6f 70 65 72 74 79 28 64 62 DbHasProperty(db
30e0: 2c 20 69 2c 20 44 42 5f 53 63 68 65 6d 61 4c 6f , i, DB_SchemaLo
30f0: 61 64 65 64 29 20 7c 7c 20 69 3d 3d 31 20 29 20 aded) || i==1 )
3100: 63 6f 6e 74 69 6e 75 65 3b 0a 20 20 20 20 72 63 continue;. rc
3110: 20 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e = sqlite3InitOn
3120: 65 28 64 62 2c 20 69 2c 20 70 7a 45 72 72 4d 73 e(db, i, pzErrMs
3130: 67 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 g);. if( rc )
3140: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 {. sqlite3R
3150: 65 73 65 74 4f 6e 65 53 63 68 65 6d 61 28 64 62 esetOneSchema(db
3160: 2c 20 69 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a , i);. }. }.
3170: 0a 20 20 2f 2a 20 4f 6e 63 65 20 61 6c 6c 20 74 . /* Once all t
3180: 68 65 20 6f 74 68 65 72 20 64 61 74 61 62 61 73 he other databas
3190: 65 73 20 68 61 76 65 20 62 65 65 6e 20 69 6e 69 es have been ini
31a0: 74 69 61 6c 69 7a 65 64 2c 20 6c 6f 61 64 20 74 tialized, load t
31b0: 68 65 20 73 63 68 65 6d 61 0a 20 20 2a 2a 20 66 he schema. ** f
31c0: 6f 72 20 74 68 65 20 54 45 4d 50 20 64 61 74 61 or the TEMP data
31d0: 62 61 73 65 2e 20 54 68 69 73 20 69 73 20 6c 6f base. This is lo
31e0: 61 64 65 64 20 6c 61 73 74 2c 20 61 73 20 74 68 aded last, as th
31f0: 65 20 54 45 4d 50 20 64 61 74 61 62 61 73 65 0a e TEMP database.
3200: 20 20 2a 2a 20 73 63 68 65 6d 61 20 6d 61 79 20 ** schema may
3210: 63 6f 6e 74 61 69 6e 20 72 65 66 65 72 65 6e 63 contain referenc
3220: 65 73 20 74 6f 20 6f 62 6a 65 63 74 73 20 69 6e es to objects in
3230: 20 6f 74 68 65 72 20 64 61 74 61 62 61 73 65 73 other databases
3240: 2e 0a 20 20 2a 2f 0a 23 69 66 6e 64 65 66 20 53 .. */.#ifndef S
3250: 51 4c 49 54 45 5f 4f 4d 49 54 5f 54 45 4d 50 44 QLITE_OMIT_TEMPD
3260: 42 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d 3e B. assert( db->
3270: 6e 44 62 3e 31 20 29 3b 0a 20 20 69 66 28 20 72 nDb>1 );. if( r
3280: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 c==SQLITE_OK &&
3290: 21 44 62 48 61 73 50 72 6f 70 65 72 74 79 28 64 !DbHasProperty(d
32a0: 62 2c 20 31 2c 20 44 42 5f 53 63 68 65 6d 61 4c b, 1, DB_SchemaL
32b0: 6f 61 64 65 64 29 20 29 7b 0a 20 20 20 20 72 63 oaded) ){. rc
32c0: 20 3d 20 73 71 6c 69 74 65 33 49 6e 69 74 4f 6e = sqlite3InitOn
32d0: 65 28 64 62 2c 20 31 2c 20 70 7a 45 72 72 4d 73 e(db, 1, pzErrMs
32e0: 67 29 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 g);. if( rc )
32f0: 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 52 {. sqlite3R
3300: 65 73 65 74 4f 6e 65 53 63 68 65 6d 61 28 64 62 esetOneSchema(db
3310: 2c 20 31 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a , 1);. }. }.
3320: 23 65 6e 64 69 66 0a 0a 20 20 64 62 2d 3e 69 6e #endif.. db->in
3330: 69 74 2e 62 75 73 79 20 3d 20 30 3b 0a 20 20 69 it.busy = 0;. i
3340: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b f( rc==SQLITE_OK
3350: 20 26 26 20 63 6f 6d 6d 69 74 5f 69 6e 74 65 72 && commit_inter
3360: 6e 61 6c 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 nal ){. sqlit
3370: 65 33 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 6c e3CommitInternal
3380: 43 68 61 6e 67 65 73 28 64 62 29 3b 0a 20 20 7d Changes(db);. }
3390: 0a 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 20 0a .. return rc; .
33a0: 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f }../*.** This ro
33b0: 75 74 69 6e 65 20 69 73 20 61 20 6e 6f 2d 6f 70 utine is a no-op
33c0: 20 69 66 20 74 68 65 20 64 61 74 61 62 61 73 65 if the database
33d0: 20 73 63 68 65 6d 61 20 69 73 20 61 6c 72 65 61 schema is alrea
33e0: 64 79 20 69 6e 69 74 69 61 6c 69 7a 65 64 2e 0a dy initialized..
33f0: 2a 2a 20 4f 74 68 65 72 77 69 73 65 2c 20 74 68 ** Otherwise, th
3400: 65 20 73 63 68 65 6d 61 20 69 73 20 6c 6f 61 64 e schema is load
3410: 65 64 2e 20 41 6e 20 65 72 72 6f 72 20 63 6f 64 ed. An error cod
3420: 65 20 69 73 20 72 65 74 75 72 6e 65 64 2e 0a 2a e is returned..*
3430: 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 52 65 61 /.int sqlite3Rea
3440: 64 53 63 68 65 6d 61 28 50 61 72 73 65 20 2a 70 dSchema(Parse *p
3450: 50 61 72 73 65 29 7b 0a 20 20 69 6e 74 20 72 63 Parse){. int rc
3460: 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 = SQLITE_OK;.
3470: 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 70 50 sqlite3 *db = pP
3480: 61 72 73 65 2d 3e 64 62 3b 0a 20 20 61 73 73 65 arse->db;. asse
3490: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
34a0: 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 x_held(db->mutex
34b0: 29 20 29 3b 0a 20 20 69 66 28 20 21 64 62 2d 3e ) );. if( !db->
34c0: 69 6e 69 74 2e 62 75 73 79 20 29 7b 0a 20 20 20 init.busy ){.
34d0: 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49 6e 69 rc = sqlite3Ini
34e0: 74 28 64 62 2c 20 26 70 50 61 72 73 65 2d 3e 7a t(db, &pParse->z
34f0: 45 72 72 4d 73 67 29 3b 0a 20 20 7d 0a 20 20 69 ErrMsg);. }. i
3500: 66 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b f( rc!=SQLITE_OK
3510: 20 29 7b 0a 20 20 20 20 70 50 61 72 73 65 2d 3e ){. pParse->
3520: 72 63 20 3d 20 72 63 3b 0a 20 20 20 20 70 50 61 rc = rc;. pPa
3530: 72 73 65 2d 3e 6e 45 72 72 2b 2b 3b 0a 20 20 7d rse->nErr++;. }
3540: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
3550: 0a 0a 2f 2a 0a 2a 2a 20 43 68 65 63 6b 20 73 63 ../*.** Check sc
3560: 68 65 6d 61 20 63 6f 6f 6b 69 65 73 20 69 6e 20 hema cookies in
3570: 61 6c 6c 20 64 61 74 61 62 61 73 65 73 2e 20 20 all databases.
3580: 49 66 20 61 6e 79 20 63 6f 6f 6b 69 65 20 69 73 If any cookie is
3590: 20 6f 75 74 0a 2a 2a 20 6f 66 20 64 61 74 65 20 out.** of date
35a0: 73 65 74 20 70 50 61 72 73 65 2d 3e 72 63 20 74 set pParse->rc t
35b0: 6f 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 2e o SQLITE_SCHEMA.
35c0: 20 20 49 66 20 61 6c 6c 20 73 63 68 65 6d 61 20 If all schema
35d0: 63 6f 6f 6b 69 65 73 0a 2a 2a 20 6d 61 6b 65 20 cookies.** make
35e0: 6e 6f 20 63 68 61 6e 67 65 73 20 74 6f 20 70 50 no changes to pP
35f0: 61 72 73 65 2d 3e 72 63 2e 0a 2a 2f 0a 73 74 61 arse->rc..*/.sta
3600: 74 69 63 20 76 6f 69 64 20 73 63 68 65 6d 61 49 tic void schemaI
3610: 73 56 61 6c 69 64 28 50 61 72 73 65 20 2a 70 50 sValid(Parse *pP
3620: 61 72 73 65 29 7b 0a 20 20 73 71 6c 69 74 65 33 arse){. sqlite3
3630: 20 2a 64 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 *db = pParse->d
3640: 62 3b 0a 20 20 69 6e 74 20 69 44 62 3b 0a 20 20 b;. int iDb;.
3650: 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 20 63 6f int rc;. int co
3660: 6f 6b 69 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 okie;.. assert(
3670: 20 70 50 61 72 73 65 2d 3e 63 68 65 63 6b 53 63 pParse->checkSc
3680: 68 65 6d 61 20 29 3b 0a 20 20 61 73 73 65 72 74 hema );. assert
3690: 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f ( sqlite3_mutex_
36a0: 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 held(db->mutex)
36b0: 29 3b 0a 20 20 66 6f 72 28 69 44 62 3d 30 3b 20 );. for(iDb=0;
36c0: 69 44 62 3c 64 62 2d 3e 6e 44 62 3b 20 69 44 62 iDb<db->nDb; iDb
36d0: 2b 2b 29 7b 0a 20 20 20 20 69 6e 74 20 6f 70 65 ++){. int ope
36e0: 6e 65 64 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d nedTransaction =
36f0: 20 30 3b 20 20 20 20 20 20 20 20 20 2f 2a 20 54 0; /* T
3700: 72 75 65 20 69 66 20 61 20 74 72 61 6e 73 61 63 rue if a transac
3710: 74 69 6f 6e 20 69 73 20 6f 70 65 6e 65 64 20 2a tion is opened *
3720: 2f 0a 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 /. Btree *pBt
3730: 20 3d 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e = db->aDb[iDb].
3740: 70 42 74 3b 20 20 20 20 20 2f 2a 20 42 74 72 65 pBt; /* Btre
3750: 65 20 64 61 74 61 62 61 73 65 20 74 6f 20 72 65 e database to re
3760: 61 64 20 63 6f 6f 6b 69 65 20 66 72 6f 6d 20 2a ad cookie from *
3770: 2f 0a 20 20 20 20 69 66 28 20 70 42 74 3d 3d 30 /. if( pBt==0
3780: 20 29 20 63 6f 6e 74 69 6e 75 65 3b 0a 0a 20 20 ) continue;..
3790: 20 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73 /* If there is
37a0: 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 61 20 72 not already a r
37b0: 65 61 64 2d 6f 6e 6c 79 20 28 6f 72 20 72 65 61 ead-only (or rea
37c0: 64 2d 77 72 69 74 65 29 20 74 72 61 6e 73 61 63 d-write) transac
37d0: 74 69 6f 6e 20 6f 70 65 6e 65 64 0a 20 20 20 20 tion opened.
37e0: 2a 2a 20 6f 6e 20 74 68 65 20 62 2d 74 72 65 65 ** on the b-tree
37f0: 20 64 61 74 61 62 61 73 65 2c 20 6f 70 65 6e 20 database, open
3800: 6f 6e 65 20 6e 6f 77 2e 20 49 66 20 61 20 74 72 one now. If a tr
3810: 61 6e 73 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 ansaction is ope
3820: 6e 65 64 2c 20 69 74 20 0a 20 20 20 20 2a 2a 20 ned, it . **
3830: 77 69 6c 6c 20 62 65 20 63 6c 6f 73 65 64 20 69 will be closed i
3840: 6d 6d 65 64 69 61 74 65 6c 79 20 61 66 74 65 72 mmediately after
3850: 20 72 65 61 64 69 6e 67 20 74 68 65 20 6d 65 74 reading the met
3860: 61 2d 76 61 6c 75 65 2e 20 2a 2f 0a 20 20 20 20 a-value. */.
3870: 69 66 28 20 21 73 71 6c 69 74 65 33 42 74 72 65 if( !sqlite3Btre
3880: 65 49 73 49 6e 52 65 61 64 54 72 61 6e 73 28 70 eIsInReadTrans(p
3890: 42 74 29 20 29 7b 0a 20 20 20 20 20 20 72 63 20 Bt) ){. rc
38a0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 = sqlite3BtreeBe
38b0: 67 69 6e 54 72 61 6e 73 28 70 42 74 2c 20 30 29 ginTrans(pBt, 0)
38c0: 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d ;. if( rc==
38d0: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 SQLITE_NOMEM ||
38e0: 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 rc==SQLITE_IOERR
38f0: 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 _NOMEM ){.
3900: 20 20 73 71 6c 69 74 65 33 4f 6f 6d 46 61 75 6c sqlite3OomFaul
3910: 74 28 64 62 29 3b 0a 20 20 20 20 20 20 7d 0a 20 t(db);. }.
3920: 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
3930: 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 3b ITE_OK ) return;
3940: 0a 20 20 20 20 20 20 6f 70 65 6e 65 64 54 72 61 . openedTra
3950: 6e 73 61 63 74 69 6f 6e 20 3d 20 31 3b 0a 20 20 nsaction = 1;.
3960: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 52 65 61 64 }.. /* Read
3970: 20 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6f 6b the schema cook
3980: 69 65 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 ie from the data
3990: 62 61 73 65 2e 20 49 66 20 69 74 20 64 6f 65 73 base. If it does
39a0: 20 6e 6f 74 20 6d 61 74 63 68 20 74 68 65 20 0a not match the .
39b0: 20 20 20 20 2a 2a 20 76 61 6c 75 65 20 73 74 6f ** value sto
39c0: 72 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 74 red as part of t
39d0: 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 73 63 68 he in-memory sch
39e0: 65 6d 61 20 72 65 70 72 65 73 65 6e 74 61 74 69 ema representati
39f0: 6f 6e 2c 0a 20 20 20 20 2a 2a 20 73 65 74 20 50 on,. ** set P
3a00: 61 72 73 65 2e 72 63 20 74 6f 20 53 51 4c 49 54 arse.rc to SQLIT
3a10: 45 5f 53 43 48 45 4d 41 2e 20 2a 2f 0a 20 20 20 E_SCHEMA. */.
3a20: 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 sqlite3BtreeGet
3a30: 4d 65 74 61 28 70 42 74 2c 20 42 54 52 45 45 5f Meta(pBt, BTREE_
3a40: 53 43 48 45 4d 41 5f 56 45 52 53 49 4f 4e 2c 20 SCHEMA_VERSION,
3a50: 28 75 33 32 20 2a 29 26 63 6f 6f 6b 69 65 29 3b (u32 *)&cookie);
3a60: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c . assert( sql
3a70: 69 74 65 33 53 63 68 65 6d 61 4d 75 74 65 78 48 ite3SchemaMutexH
3a80: 65 6c 64 28 64 62 2c 20 69 44 62 2c 20 30 29 20 eld(db, iDb, 0)
3a90: 29 3b 0a 20 20 20 20 69 66 28 20 63 6f 6f 6b 69 );. if( cooki
3aa0: 65 21 3d 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e e!=db->aDb[iDb].
3ab0: 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 5f pSchema->schema_
3ac0: 63 6f 6f 6b 69 65 20 29 7b 0a 20 20 20 20 20 20 cookie ){.
3ad0: 73 71 6c 69 74 65 33 52 65 73 65 74 4f 6e 65 53 sqlite3ResetOneS
3ae0: 63 68 65 6d 61 28 64 62 2c 20 69 44 62 29 3b 0a chema(db, iDb);.
3af0: 20 20 20 20 20 20 70 50 61 72 73 65 2d 3e 72 63 pParse->rc
3b00: 20 3d 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 = SQLITE_SCHEMA
3b10: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
3b20: 43 6c 6f 73 65 20 74 68 65 20 74 72 61 6e 73 61 Close the transa
3b30: 63 74 69 6f 6e 2c 20 69 66 20 6f 6e 65 20 77 61 ction, if one wa
3b40: 73 20 6f 70 65 6e 65 64 2e 20 2a 2f 0a 20 20 20 s opened. */.
3b50: 20 69 66 28 20 6f 70 65 6e 65 64 54 72 61 6e 73 if( openedTrans
3b60: 61 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20 action ){.
3b70: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d sqlite3BtreeComm
3b80: 69 74 28 70 42 74 29 3b 0a 20 20 20 20 7d 0a 20 it(pBt);. }.
3b90: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 }.}../*.** Conv
3ba0: 65 72 74 20 61 20 73 63 68 65 6d 61 20 70 6f 69 ert a schema poi
3bb0: 6e 74 65 72 20 69 6e 74 6f 20 74 68 65 20 69 44 nter into the iD
3bc0: 62 20 69 6e 64 65 78 20 74 68 61 74 20 69 6e 64 b index that ind
3bd0: 69 63 61 74 65 73 0a 2a 2a 20 77 68 69 63 68 20 icates.** which
3be0: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 6e database file in
3bf0: 20 64 62 2d 3e 61 44 62 5b 5d 20 74 68 65 20 73 db->aDb[] the s
3c00: 63 68 65 6d 61 20 72 65 66 65 72 73 20 74 6f 2e chema refers to.
3c10: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 73 61 .**.** If the sa
3c20: 6d 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61 me database is a
3c30: 74 74 61 63 68 65 64 20 6d 6f 72 65 20 74 68 61 ttached more tha
3c40: 6e 20 6f 6e 63 65 2c 20 74 68 65 20 66 69 72 73 n once, the firs
3c50: 74 0a 2a 2a 20 61 74 74 61 63 68 65 64 20 64 61 t.** attached da
3c60: 74 61 62 61 73 65 20 69 73 20 72 65 74 75 72 6e tabase is return
3c70: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ed..*/.int sqlit
3c80: 65 33 53 63 68 65 6d 61 54 6f 49 6e 64 65 78 28 e3SchemaToIndex(
3c90: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 53 63 68 sqlite3 *db, Sch
3ca0: 65 6d 61 20 2a 70 53 63 68 65 6d 61 29 7b 0a 20 ema *pSchema){.
3cb0: 20 69 6e 74 20 69 20 3d 20 2d 31 30 30 30 30 30 int i = -100000
3cc0: 30 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 53 63 68 0;.. /* If pSch
3cd0: 65 6d 61 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 ema is NULL, the
3ce0: 6e 20 72 65 74 75 72 6e 20 2d 31 30 30 30 30 30 n return -100000
3cf0: 30 2e 20 54 68 69 73 20 68 61 70 70 65 6e 73 20 0. This happens
3d00: 77 68 65 6e 20 63 6f 64 65 20 69 6e 20 0a 20 20 when code in .
3d10: 2a 2a 20 65 78 70 72 2e 63 20 69 73 20 74 72 79 ** expr.c is try
3d20: 69 6e 67 20 74 6f 20 72 65 73 6f 6c 76 65 20 61 ing to resolve a
3d30: 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 reference to a
3d40: 74 72 61 6e 73 69 65 6e 74 20 74 61 62 6c 65 20 transient table
3d50: 28 69 2e 65 2e 20 6f 6e 65 0a 20 20 2a 2a 20 63 (i.e. one. ** c
3d60: 72 65 61 74 65 64 20 62 79 20 61 20 73 75 62 2d reated by a sub-
3d70: 73 65 6c 65 63 74 29 2e 20 49 6e 20 74 68 69 73 select). In this
3d80: 20 63 61 73 65 20 74 68 65 20 72 65 74 75 72 6e case the return
3d90: 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 0a value of this .
3da0: 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 73 68 ** function sh
3db0: 6f 75 6c 64 20 6e 65 76 65 72 20 62 65 20 75 73 ould never be us
3dc0: 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 65 ed.. **. ** We
3dd0: 20 72 65 74 75 72 6e 20 2d 31 30 30 30 30 30 30 return -1000000
3de0: 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 instead of the
3df0: 6d 6f 72 65 20 75 73 75 61 6c 20 2d 31 20 73 69 more usual -1 si
3e00: 6d 70 6c 79 20 62 65 63 61 75 73 65 20 75 73 69 mply because usi
3e10: 6e 67 0a 20 20 2a 2a 20 2d 31 30 30 30 30 30 30 ng. ** -1000000
3e20: 20 61 73 20 74 68 65 20 69 6e 63 6f 72 72 65 63 as the incorrec
3e30: 74 20 69 6e 64 65 78 20 69 6e 74 6f 20 64 62 2d t index into db-
3e40: 3e 61 44 62 5b 5d 20 69 73 20 6d 75 63 68 20 0a >aDb[] is much .
3e50: 20 20 2a 2a 20 6d 6f 72 65 20 6c 69 6b 65 6c 79 ** more likely
3e60: 20 74 6f 20 63 61 75 73 65 20 61 20 73 65 67 66 to cause a segf
3e70: 61 75 6c 74 20 74 68 61 6e 20 2d 31 20 28 6f 66 ault than -1 (of
3e80: 20 63 6f 75 72 73 65 20 74 68 65 72 65 20 61 72 course there ar
3e90: 65 20 61 73 73 65 72 74 28 29 0a 20 20 2a 2a 20 e assert(). **
3ea0: 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 6f 2c 20 statements too,
3eb0: 62 75 74 20 69 74 20 6e 65 76 65 72 20 68 75 72 but it never hur
3ec0: 74 73 20 74 6f 20 70 6c 61 79 20 74 68 65 20 6f ts to play the o
3ed0: 64 64 73 29 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 dds).. */. ass
3ee0: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
3ef0: 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 ex_held(db->mute
3f00: 78 29 20 29 3b 0a 20 20 69 66 28 20 70 53 63 68 x) );. if( pSch
3f10: 65 6d 61 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 ema ){. for(i
3f20: 3d 30 3b 20 41 4c 57 41 59 53 28 69 3c 64 62 2d =0; ALWAYS(i<db-
3f30: 3e 6e 44 62 29 3b 20 69 2b 2b 29 7b 0a 20 20 20 >nDb); i++){.
3f40: 20 20 20 69 66 28 20 64 62 2d 3e 61 44 62 5b 69 if( db->aDb[i
3f50: 5d 2e 70 53 63 68 65 6d 61 3d 3d 70 53 63 68 65 ].pSchema==pSche
3f60: 6d 61 20 29 7b 0a 20 20 20 20 20 20 20 20 62 72 ma ){. br
3f70: 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 eak;. }.
3f80: 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 }. assert( i
3f90: 3e 3d 30 20 26 26 20 69 3c 64 62 2d 3e 6e 44 62 >=0 && i<db->nDb
3fa0: 20 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e );. }. return
3fb0: 20 69 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 i;.}../*.** Fre
3fc0: 65 20 61 6c 6c 20 6d 65 6d 6f 72 79 20 61 6c 6c e all memory all
3fd0: 6f 63 61 74 69 6f 6e 73 20 69 6e 20 74 68 65 20 ocations in the
3fe0: 70 50 61 72 73 65 20 6f 62 6a 65 63 74 0a 2a 2f pParse object.*/
3ff0: 0a 76 6f 69 64 20 73 71 6c 69 74 65 33 50 61 72 .void sqlite3Par
4000: 73 65 72 52 65 73 65 74 28 50 61 72 73 65 20 2a serReset(Parse *
4010: 70 50 61 72 73 65 29 7b 0a 20 20 73 71 6c 69 74 pParse){. sqlit
4020: 65 33 20 2a 64 62 20 3d 20 70 50 61 72 73 65 2d e3 *db = pParse-
4030: 3e 64 62 3b 0a 20 20 73 71 6c 69 74 65 33 44 62 >db;. sqlite3Db
4040: 46 72 65 65 28 64 62 2c 20 70 50 61 72 73 65 2d Free(db, pParse-
4050: 3e 61 4c 61 62 65 6c 29 3b 0a 20 20 73 71 6c 69 >aLabel);. sqli
4060: 74 65 33 45 78 70 72 4c 69 73 74 44 65 6c 65 74 te3ExprListDelet
4070: 65 28 64 62 2c 20 70 50 61 72 73 65 2d 3e 70 43 e(db, pParse->pC
4080: 6f 6e 73 74 45 78 70 72 29 3b 0a 20 20 69 66 28 onstExpr);. if(
4090: 20 64 62 20 29 7b 0a 20 20 20 20 61 73 73 65 72 db ){. asser
40a0: 74 28 20 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 65 t( db->lookaside
40b0: 2e 62 44 69 73 61 62 6c 65 20 3e 3d 20 70 50 61 .bDisable >= pPa
40c0: 72 73 65 2d 3e 64 69 73 61 62 6c 65 4c 6f 6f 6b rse->disableLook
40d0: 61 73 69 64 65 20 29 3b 0a 20 20 20 20 64 62 2d aside );. db-
40e0: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 44 69 73 61 >lookaside.bDisa
40f0: 62 6c 65 20 2d 3d 20 70 50 61 72 73 65 2d 3e 64 ble -= pParse->d
4100: 69 73 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 3b isableLookaside;
4110: 0a 20 20 7d 0a 20 20 70 50 61 72 73 65 2d 3e 64 . }. pParse->d
4120: 69 73 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 20 isableLookaside
4130: 3d 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f = 0;.}../*.** Co
4140: 6d 70 69 6c 65 20 74 68 65 20 55 54 46 2d 38 20 mpile the UTF-8
4150: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 encoded SQL stat
4160: 65 6d 65 6e 74 20 7a 53 71 6c 20 69 6e 74 6f 20 ement zSql into
4170: 61 20 73 74 61 74 65 6d 65 6e 74 20 68 61 6e 64 a statement hand
4180: 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e le..*/.static in
4190: 74 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 t sqlite3Prepare
41a0: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c (. sqlite3 *db,
41b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
41c0: 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 Database handle
41d0: 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 . */. const cha
41e0: 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 r *zSql,
41f0: 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 /* UTF-8 encode
4200: 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e d SQL statement.
4210: 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 */. int nBytes
4220: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
4230: 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 /* Length of zSq
4240: 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 l in bytes. */.
4250: 20 75 33 32 20 70 72 65 70 46 6c 61 67 73 2c 20 u32 prepFlags,
4260: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 5a 65 /* Ze
4270: 72 6f 20 6f 72 20 6d 6f 72 65 20 53 51 4c 49 54 ro or more SQLIT
4280: 45 5f 50 52 45 50 41 52 45 5f 2a 20 66 6c 61 67 E_PREPARE_* flag
4290: 73 20 2a 2f 0a 20 20 56 64 62 65 20 2a 70 52 65 s */. Vdbe *pRe
42a0: 70 72 65 70 61 72 65 2c 20 20 20 20 20 20 20 20 prepare,
42b0: 20 2f 2a 20 56 4d 20 62 65 69 6e 67 20 72 65 70 /* VM being rep
42c0: 72 65 70 61 72 65 64 20 2a 2f 0a 20 20 73 71 6c repared */. sql
42d0: 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 ite3_stmt **ppSt
42e0: 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 mt, /* OUT: A
42f0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 pointer to the
4300: 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 prepared stateme
4310: 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 nt */. const ch
4320: 61 72 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20 ar **pzTail
4330: 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 /* OUT: End of
4340: 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20 2a parsed string *
4350: 2f 0a 29 7b 0a 20 20 63 68 61 72 20 2a 7a 45 72 /.){. char *zEr
4360: 72 4d 73 67 20 3d 20 30 3b 20 20 20 20 20 20 20 rMsg = 0;
4370: 20 2f 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 67 /* Error messag
4380: 65 20 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 e */. int rc =
4390: 53 51 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 SQLITE_OK;
43a0: 20 2f 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 /* Result code
43b0: 2a 2f 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20 */. int i;
43c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f /
43d0: 2a 20 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a * Loop counter *
43e0: 2f 0a 20 20 50 61 72 73 65 20 73 50 61 72 73 65 /. Parse sParse
43f0: 3b 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a ; /*
4400: 20 50 61 72 73 69 6e 67 20 63 6f 6e 74 65 78 74 Parsing context
4410: 20 2a 2f 0a 0a 20 20 6d 65 6d 73 65 74 28 26 73 */.. memset(&s
4420: 50 61 72 73 65 2c 20 30 2c 20 50 41 52 53 45 5f Parse, 0, PARSE_
4430: 48 44 52 5f 53 5a 29 3b 0a 20 20 6d 65 6d 73 65 HDR_SZ);. memse
4440: 74 28 50 41 52 53 45 5f 54 41 49 4c 28 26 73 50 t(PARSE_TAIL(&sP
4450: 61 72 73 65 29 2c 20 30 2c 20 50 41 52 53 45 5f arse), 0, PARSE_
4460: 54 41 49 4c 5f 53 5a 29 3b 0a 20 20 73 50 61 72 TAIL_SZ);. sPar
4470: 73 65 2e 70 52 65 70 72 65 70 61 72 65 20 3d 20 se.pReprepare =
4480: 70 52 65 70 72 65 70 61 72 65 3b 0a 20 20 61 73 pReprepare;. as
4490: 73 65 72 74 28 20 70 70 53 74 6d 74 20 26 26 20 sert( ppStmt &&
44a0: 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 *ppStmt==0 );.
44b0: 2f 2a 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e /* assert( !db->
44c0: 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b 20 mallocFailed );
44d0: 2f 2f 20 6e 6f 74 20 74 72 75 65 20 77 69 74 68 // not true with
44e0: 20 53 51 4c 49 54 45 5f 55 53 45 5f 41 4c 4c 4f SQLITE_USE_ALLO
44f0: 43 41 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 CA */. assert(
4500: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
4510: 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b ld(db->mutex) );
4520: 0a 0a 20 20 2f 2a 20 46 6f 72 20 61 20 6c 6f 6e .. /* For a lon
4530: 67 2d 74 65 72 6d 20 75 73 65 20 70 72 65 70 61 g-term use prepa
4540: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 61 76 red statement av
4550: 6f 69 64 20 74 68 65 20 75 73 65 20 6f 66 0a 20 oid the use of.
4560: 20 2a 2a 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 ** lookaside me
4570: 6d 6f 72 79 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 mory.. */. if(
4580: 20 70 72 65 70 46 6c 61 67 73 20 26 20 53 51 4c prepFlags & SQL
4590: 49 54 45 5f 50 52 45 50 41 52 45 5f 50 45 52 53 ITE_PREPARE_PERS
45a0: 49 53 54 45 4e 54 20 29 7b 0a 20 20 20 20 73 50 ISTENT ){. sP
45b0: 61 72 73 65 2e 64 69 73 61 62 6c 65 4c 6f 6f 6b arse.disableLook
45c0: 61 73 69 64 65 2b 2b 3b 0a 20 20 20 20 64 62 2d aside++;. db-
45d0: 3e 6c 6f 6f 6b 61 73 69 64 65 2e 62 44 69 73 61 >lookaside.bDisa
45e0: 62 6c 65 2b 2b 3b 0a 20 20 7d 0a 0a 20 20 2f 2a ble++;. }.. /*
45f0: 20 43 68 65 63 6b 20 74 6f 20 76 65 72 69 66 79 Check to verify
4600: 20 74 68 61 74 20 69 74 20 69 73 20 70 6f 73 73 that it is poss
4610: 69 62 6c 65 20 74 6f 20 67 65 74 20 61 20 72 65 ible to get a re
4620: 61 64 20 6c 6f 63 6b 20 6f 6e 20 61 6c 6c 0a 20 ad lock on all.
4630: 20 2a 2a 20 64 61 74 61 62 61 73 65 20 73 63 68 ** database sch
4640: 65 6d 61 73 2e 20 20 54 68 65 20 69 6e 61 62 69 emas. The inabi
4650: 6c 69 74 79 20 74 6f 20 67 65 74 20 61 20 72 65 lity to get a re
4660: 61 64 20 6c 6f 63 6b 20 69 6e 64 69 63 61 74 65 ad lock indicate
4670: 73 20 74 68 61 74 0a 20 20 2a 2a 20 73 6f 6d 65 s that. ** some
4680: 20 6f 74 68 65 72 20 64 61 74 61 62 61 73 65 20 other database
4690: 63 6f 6e 6e 65 63 74 69 6f 6e 20 69 73 20 68 6f connection is ho
46a0: 6c 64 69 6e 67 20 61 20 77 72 69 74 65 2d 6c 6f lding a write-lo
46b0: 63 6b 2c 20 77 68 69 63 68 20 69 6e 0a 20 20 2a ck, which in. *
46c0: 2a 20 74 75 72 6e 20 6d 65 61 6e 73 20 74 68 61 * turn means tha
46d0: 74 20 74 68 65 20 6f 74 68 65 72 20 63 6f 6e 6e t the other conn
46e0: 65 63 74 69 6f 6e 20 68 61 73 20 6d 61 64 65 20 ection has made
46f0: 75 6e 63 6f 6d 6d 69 74 74 65 64 20 63 68 61 6e uncommitted chan
4700: 67 65 73 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 ges. ** to the
4710: 73 63 68 65 6d 61 2e 0a 20 20 2a 2a 0a 20 20 2a schema.. **. *
4720: 2a 20 57 65 72 65 20 77 65 20 74 6f 20 70 72 6f * Were we to pro
4730: 63 65 65 64 20 61 6e 64 20 70 72 65 70 61 72 65 ceed and prepare
4740: 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 61 the statement a
4750: 67 61 69 6e 73 74 20 74 68 65 20 75 6e 63 6f 6d gainst the uncom
4760: 6d 69 74 74 65 64 0a 20 20 2a 2a 20 73 63 68 65 mitted. ** sche
4770: 6d 61 20 63 68 61 6e 67 65 73 20 61 6e 64 20 69 ma changes and i
4780: 66 20 74 68 6f 73 65 20 73 63 68 65 6d 61 20 63 f those schema c
4790: 68 61 6e 67 65 73 20 61 72 65 20 73 75 62 73 65 hanges are subse
47a0: 71 75 65 6e 74 6c 79 20 72 6f 6c 6c 65 64 0a 20 quently rolled.
47b0: 20 2a 2a 20 62 61 63 6b 20 61 6e 64 20 64 69 66 ** back and dif
47c0: 66 65 72 65 6e 74 20 63 68 61 6e 67 65 73 20 61 ferent changes a
47d0: 72 65 20 6d 61 64 65 20 69 6e 20 74 68 65 69 72 re made in their
47e0: 20 70 6c 61 63 65 2c 20 74 68 65 6e 20 77 68 65 place, then whe
47f0: 6e 20 74 68 69 73 0a 20 20 2a 2a 20 70 72 65 70 n this. ** prep
4800: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 67 ared statement g
4810: 6f 65 73 20 74 6f 20 72 75 6e 20 74 68 65 20 73 oes to run the s
4820: 63 68 65 6d 61 20 63 6f 6f 6b 69 65 20 77 6f 75 chema cookie wou
4830: 6c 64 20 66 61 69 6c 20 74 6f 20 64 65 74 65 63 ld fail to detec
4840: 74 0a 20 20 2a 2a 20 74 68 65 20 73 63 68 65 6d t. ** the schem
4850: 61 20 63 68 61 6e 67 65 2e 20 20 44 69 73 61 73 a change. Disas
4860: 74 65 72 20 77 6f 75 6c 64 20 66 6f 6c 6c 6f 77 ter would follow
4870: 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 69 73 .. **. ** This
4880: 20 74 68 72 65 61 64 20 69 73 20 63 75 72 72 65 thread is curre
4890: 6e 74 6c 79 20 68 6f 6c 64 69 6e 67 20 6d 75 74 ntly holding mut
48a0: 65 78 65 73 20 6f 6e 20 61 6c 6c 20 42 74 72 65 exes on all Btre
48b0: 65 73 20 28 62 65 63 61 75 73 65 0a 20 20 2a 2a es (because. **
48c0: 20 6f 66 20 74 68 65 20 73 71 6c 69 74 65 33 42 of the sqlite3B
48d0: 74 72 65 65 45 6e 74 65 72 41 6c 6c 28 29 20 69 treeEnterAll() i
48e0: 6e 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 n sqlite3LockAnd
48f0: 50 72 65 70 61 72 65 28 29 29 20 73 6f 20 69 74 Prepare()) so it
4900: 0a 20 20 2a 2a 20 69 73 20 6e 6f 74 20 70 6f 73 . ** is not pos
4910: 73 69 62 6c 65 20 66 6f 72 20 61 6e 6f 74 68 65 sible for anothe
4920: 72 20 74 68 72 65 61 64 20 74 6f 20 73 74 61 72 r thread to star
4930: 74 20 61 20 6e 65 77 20 73 63 68 65 6d 61 20 63 t a new schema c
4940: 68 61 6e 67 65 0a 20 20 2a 2a 20 77 68 69 6c 65 hange. ** while
4950: 20 74 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 this routine is
4960: 20 72 75 6e 6e 69 6e 67 2e 20 20 48 65 6e 63 65 running. Hence
4970: 2c 20 77 65 20 64 6f 20 6e 6f 74 20 6e 65 65 64 , we do not need
4980: 20 74 6f 20 68 6f 6c 64 20 0a 20 20 2a 2a 20 6c to hold . ** l
4990: 6f 63 6b 73 20 6f 6e 20 74 68 65 20 73 63 68 65 ocks on the sche
49a0: 6d 61 2c 20 77 65 20 6a 75 73 74 20 6e 65 65 64 ma, we just need
49b0: 20 74 6f 20 6d 61 6b 65 20 73 75 72 65 20 6e 6f to make sure no
49c0: 62 6f 64 79 20 65 6c 73 65 20 69 73 20 0a 20 20 body else is .
49d0: 2a 2a 20 68 6f 6c 64 69 6e 67 20 74 68 65 6d 2e ** holding them.
49e0: 0a 20 20 2a 2a 0a 20 20 2a 2a 20 4e 6f 74 65 20 . **. ** Note
49f0: 74 68 61 74 20 73 65 74 74 69 6e 67 20 52 45 41 that setting REA
4a00: 44 5f 55 4e 43 4f 4d 4d 49 54 54 45 44 20 6f 76 D_UNCOMMITTED ov
4a10: 65 72 72 69 64 65 73 20 6d 6f 73 74 20 6c 6f 63 errides most loc
4a20: 6b 20 64 65 74 65 63 74 69 6f 6e 2c 0a 20 20 2a k detection,. *
4a30: 2a 20 62 75 74 20 69 74 20 64 6f 65 73 20 2a 6e * but it does *n
4a40: 6f 74 2a 20 6f 76 65 72 72 69 64 65 20 73 63 68 ot* override sch
4a50: 65 6d 61 20 6c 6f 63 6b 20 64 65 74 65 63 74 69 ema lock detecti
4a60: 6f 6e 2c 20 73 6f 20 74 68 69 73 20 61 6c 6c 20 on, so this all
4a70: 73 74 69 6c 6c 0a 20 20 2a 2a 20 77 6f 72 6b 73 still. ** works
4a80: 20 65 76 65 6e 20 69 66 20 52 45 41 44 5f 55 4e even if READ_UN
4a90: 43 4f 4d 4d 49 54 54 45 44 20 69 73 20 73 65 74 COMMITTED is set
4aa0: 2e 0a 20 20 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 .. */. for(i=0
4ab0: 3b 20 69 3c 64 62 2d 3e 6e 44 62 3b 20 69 2b 2b ; i<db->nDb; i++
4ac0: 29 20 7b 0a 20 20 20 20 42 74 72 65 65 20 2a 70 ) {. Btree *p
4ad0: 42 74 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e Bt = db->aDb[i].
4ae0: 70 42 74 3b 0a 20 20 20 20 69 66 28 20 70 42 74 pBt;. if( pBt
4af0: 20 29 7b 0a 20 20 20 20 20 20 61 73 73 65 72 74 ){. assert
4b00: 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f ( sqlite3BtreeHo
4b10: 6c 64 73 4d 75 74 65 78 28 70 42 74 29 20 29 3b ldsMutex(pBt) );
4b20: 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 6c 69 . rc = sqli
4b30: 74 65 33 42 74 72 65 65 53 63 68 65 6d 61 4c 6f te3BtreeSchemaLo
4b40: 63 6b 65 64 28 70 42 74 29 3b 0a 20 20 20 20 20 cked(pBt);.
4b50: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 20 if( rc ){.
4b60: 20 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a const char *z
4b70: 44 62 20 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e Db = db->aDb[i].
4b80: 7a 44 62 53 4e 61 6d 65 3b 0a 20 20 20 20 20 20 zDbSName;.
4b90: 20 20 73 71 6c 69 74 65 33 45 72 72 6f 72 57 69 sqlite3ErrorWi
4ba0: 74 68 4d 73 67 28 64 62 2c 20 72 63 2c 20 22 64 thMsg(db, rc, "d
4bb0: 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 atabase schema i
4bc0: 73 20 6c 6f 63 6b 65 64 3a 20 25 73 22 2c 20 7a s locked: %s", z
4bd0: 44 62 29 3b 0a 20 20 20 20 20 20 20 20 74 65 73 Db);. tes
4be0: 74 63 61 73 65 28 20 64 62 2d 3e 66 6c 61 67 73 tcase( db->flags
4bf0: 20 26 20 53 51 4c 49 54 45 5f 52 65 61 64 55 6e & SQLITE_ReadUn
4c00: 63 6f 6d 6d 69 74 20 29 3b 0a 20 20 20 20 20 20 commit );.
4c10: 20 20 67 6f 74 6f 20 65 6e 64 5f 70 72 65 70 61 goto end_prepa
4c20: 72 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 re;. }.
4c30: 7d 0a 20 20 7d 0a 0a 20 20 73 71 6c 69 74 65 33 }. }.. sqlite3
4c40: 56 74 61 62 55 6e 6c 6f 63 6b 4c 69 73 74 28 64 VtabUnlockList(d
4c50: 62 29 3b 0a 0a 20 20 73 50 61 72 73 65 2e 64 62 b);.. sParse.db
4c60: 20 3d 20 64 62 3b 0a 20 20 69 66 28 20 6e 42 79 = db;. if( nBy
4c70: 74 65 73 3e 3d 30 20 26 26 20 28 6e 42 79 74 65 tes>=0 && (nByte
4c80: 73 3d 3d 30 20 7c 7c 20 7a 53 71 6c 5b 6e 42 79 s==0 || zSql[nBy
4c90: 74 65 73 2d 31 5d 21 3d 30 29 20 29 7b 0a 20 20 tes-1]!=0) ){.
4ca0: 20 20 63 68 61 72 20 2a 7a 53 71 6c 43 6f 70 79 char *zSqlCopy
4cb0: 3b 0a 20 20 20 20 69 6e 74 20 6d 78 4c 65 6e 20 ;. int mxLen
4cc0: 3d 20 64 62 2d 3e 61 4c 69 6d 69 74 5b 53 51 4c = db->aLimit[SQL
4cd0: 49 54 45 5f 4c 49 4d 49 54 5f 53 51 4c 5f 4c 45 ITE_LIMIT_SQL_LE
4ce0: 4e 47 54 48 5d 3b 0a 20 20 20 20 74 65 73 74 63 NGTH];. testc
4cf0: 61 73 65 28 20 6e 42 79 74 65 73 3d 3d 6d 78 4c ase( nBytes==mxL
4d00: 65 6e 20 29 3b 0a 20 20 20 20 74 65 73 74 63 61 en );. testca
4d10: 73 65 28 20 6e 42 79 74 65 73 3d 3d 6d 78 4c 65 se( nBytes==mxLe
4d20: 6e 2b 31 20 29 3b 0a 20 20 20 20 69 66 28 20 6e n+1 );. if( n
4d30: 42 79 74 65 73 3e 6d 78 4c 65 6e 20 29 7b 0a 20 Bytes>mxLen ){.
4d40: 20 20 20 20 20 73 71 6c 69 74 65 33 45 72 72 6f sqlite3Erro
4d50: 72 57 69 74 68 4d 73 67 28 64 62 2c 20 53 51 4c rWithMsg(db, SQL
4d60: 49 54 45 5f 54 4f 4f 42 49 47 2c 20 22 73 74 61 ITE_TOOBIG, "sta
4d70: 74 65 6d 65 6e 74 20 74 6f 6f 20 6c 6f 6e 67 22 tement too long"
4d80: 29 3b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 71 );. rc = sq
4d90: 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c lite3ApiExit(db,
4da0: 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 47 29 3b SQLITE_TOOBIG);
4db0: 0a 20 20 20 20 20 20 67 6f 74 6f 20 65 6e 64 5f . goto end_
4dc0: 70 72 65 70 61 72 65 3b 0a 20 20 20 20 7d 0a 20 prepare;. }.
4dd0: 20 20 20 7a 53 71 6c 43 6f 70 79 20 3d 20 73 71 zSqlCopy = sq
4de0: 6c 69 74 65 33 44 62 53 74 72 4e 44 75 70 28 64 lite3DbStrNDup(d
4df0: 62 2c 20 7a 53 71 6c 2c 20 6e 42 79 74 65 73 29 b, zSql, nBytes)
4e00: 3b 0a 20 20 20 20 69 66 28 20 7a 53 71 6c 43 6f ;. if( zSqlCo
4e10: 70 79 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 py ){. sqli
4e20: 74 65 33 52 75 6e 50 61 72 73 65 72 28 26 73 50 te3RunParser(&sP
4e30: 61 72 73 65 2c 20 7a 53 71 6c 43 6f 70 79 2c 20 arse, zSqlCopy,
4e40: 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 &zErrMsg);.
4e50: 20 73 50 61 72 73 65 2e 7a 54 61 69 6c 20 3d 20 sParse.zTail =
4e60: 26 7a 53 71 6c 5b 73 50 61 72 73 65 2e 7a 54 61 &zSql[sParse.zTa
4e70: 69 6c 2d 7a 53 71 6c 43 6f 70 79 5d 3b 0a 20 20 il-zSqlCopy];.
4e80: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 sqlite3DbFre
4e90: 65 28 64 62 2c 20 7a 53 71 6c 43 6f 70 79 29 3b e(db, zSqlCopy);
4ea0: 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 . }else{.
4eb0: 20 20 73 50 61 72 73 65 2e 7a 54 61 69 6c 20 3d sParse.zTail =
4ec0: 20 26 7a 53 71 6c 5b 6e 42 79 74 65 73 5d 3b 0a &zSql[nBytes];.
4ed0: 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a 20 }. }else{.
4ee0: 20 20 20 73 71 6c 69 74 65 33 52 75 6e 50 61 72 sqlite3RunPar
4ef0: 73 65 72 28 26 73 50 61 72 73 65 2c 20 7a 53 71 ser(&sParse, zSq
4f00: 6c 2c 20 26 7a 45 72 72 4d 73 67 29 3b 0a 20 20 l, &zErrMsg);.
4f10: 7d 0a 20 20 61 73 73 65 72 74 28 20 30 3d 3d 73 }. assert( 0==s
4f20: 50 61 72 73 65 2e 6e 51 75 65 72 79 4c 6f 6f 70 Parse.nQueryLoop
4f30: 20 29 3b 0a 0a 20 20 69 66 28 20 73 50 61 72 73 );.. if( sPars
4f40: 65 2e 72 63 3d 3d 53 51 4c 49 54 45 5f 44 4f 4e e.rc==SQLITE_DON
4f50: 45 20 29 20 73 50 61 72 73 65 2e 72 63 20 3d 20 E ) sParse.rc =
4f60: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 66 28 SQLITE_OK;. if(
4f70: 20 73 50 61 72 73 65 2e 63 68 65 63 6b 53 63 68 sParse.checkSch
4f80: 65 6d 61 20 29 7b 0a 20 20 20 20 73 63 68 65 6d ema ){. schem
4f90: 61 49 73 56 61 6c 69 64 28 26 73 50 61 72 73 65 aIsValid(&sParse
4fa0: 29 3b 0a 20 20 7d 0a 20 20 69 66 28 20 64 62 2d );. }. if( db-
4fb0: 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b >mallocFailed ){
4fc0: 0a 20 20 20 20 73 50 61 72 73 65 2e 72 63 20 3d . sParse.rc =
4fd0: 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b SQLITE_NOMEM_BK
4fe0: 50 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 7a PT;. }. if( pz
4ff0: 54 61 69 6c 20 29 7b 0a 20 20 20 20 2a 70 7a 54 Tail ){. *pzT
5000: 61 69 6c 20 3d 20 73 50 61 72 73 65 2e 7a 54 61 ail = sParse.zTa
5010: 69 6c 3b 0a 20 20 7d 0a 20 20 72 63 20 3d 20 73 il;. }. rc = s
5020: 50 61 72 73 65 2e 72 63 3b 0a 0a 23 69 66 6e 64 Parse.rc;..#ifnd
5030: 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 45 ef SQLITE_OMIT_E
5040: 58 50 4c 41 49 4e 0a 20 20 69 66 28 20 72 63 3d XPLAIN. if( rc=
5050: 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 20 73 50 =SQLITE_OK && sP
5060: 61 72 73 65 2e 70 56 64 62 65 20 26 26 20 73 50 arse.pVdbe && sP
5070: 61 72 73 65 2e 65 78 70 6c 61 69 6e 20 29 7b 0a arse.explain ){.
5080: 20 20 20 20 73 74 61 74 69 63 20 63 6f 6e 73 74 static const
5090: 20 63 68 61 72 20 2a 20 63 6f 6e 73 74 20 61 7a char * const az
50a0: 43 6f 6c 4e 61 6d 65 5b 5d 20 3d 20 7b 0a 20 20 ColName[] = {.
50b0: 20 20 20 20 20 22 61 64 64 72 22 2c 20 22 6f 70 "addr", "op
50c0: 63 6f 64 65 22 2c 20 22 70 31 22 2c 20 22 70 32 code", "p1", "p2
50d0: 22 2c 20 22 70 33 22 2c 20 22 70 34 22 2c 20 22 ", "p3", "p4", "
50e0: 70 35 22 2c 20 22 63 6f 6d 6d 65 6e 74 22 2c 0a p5", "comment",.
50f0: 20 20 20 20 20 20 20 22 73 65 6c 65 63 74 69 64 "selectid
5100: 22 2c 20 22 6f 72 64 65 72 22 2c 20 22 66 72 6f ", "order", "fro
5110: 6d 22 2c 20 22 64 65 74 61 69 6c 22 0a 20 20 20 m", "detail".
5120: 20 7d 3b 0a 20 20 20 20 69 6e 74 20 69 46 69 72 };. int iFir
5130: 73 74 2c 20 6d 78 3b 0a 20 20 20 20 69 66 28 20 st, mx;. if(
5140: 73 50 61 72 73 65 2e 65 78 70 6c 61 69 6e 3d 3d sParse.explain==
5150: 32 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 2 ){. sqlit
5160: 65 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c 73 e3VdbeSetNumCols
5170: 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 34 (sParse.pVdbe, 4
5180: 29 3b 0a 20 20 20 20 20 20 69 46 69 72 73 74 20 );. iFirst
5190: 3d 20 38 3b 0a 20 20 20 20 20 20 6d 78 20 3d 20 = 8;. mx =
51a0: 31 32 3b 0a 20 20 20 20 7d 65 6c 73 65 7b 0a 20 12;. }else{.
51b0: 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 sqlite3Vdbe
51c0: 53 65 74 4e 75 6d 43 6f 6c 73 28 73 50 61 72 73 SetNumCols(sPars
51d0: 65 2e 70 56 64 62 65 2c 20 38 29 3b 0a 20 20 20 e.pVdbe, 8);.
51e0: 20 20 20 69 46 69 72 73 74 20 3d 20 30 3b 0a 20 iFirst = 0;.
51f0: 20 20 20 20 20 6d 78 20 3d 20 38 3b 0a 20 20 20 mx = 8;.
5200: 20 7d 0a 20 20 20 20 66 6f 72 28 69 3d 69 46 69 }. for(i=iFi
5210: 72 73 74 3b 20 69 3c 6d 78 3b 20 69 2b 2b 29 7b rst; i<mx; i++){
5220: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 56 64 . sqlite3Vd
5230: 62 65 53 65 74 43 6f 6c 4e 61 6d 65 28 73 50 61 beSetColName(sPa
5240: 72 73 65 2e 70 56 64 62 65 2c 20 69 2d 69 46 69 rse.pVdbe, i-iFi
5250: 72 73 74 2c 20 43 4f 4c 4e 41 4d 45 5f 4e 41 4d rst, COLNAME_NAM
5260: 45 2c 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 E,.
5270: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 61 a
5280: 7a 43 6f 6c 4e 61 6d 65 5b 69 5d 2c 20 53 51 4c zColName[i], SQL
5290: 49 54 45 5f 53 54 41 54 49 43 29 3b 0a 20 20 20 ITE_STATIC);.
52a0: 20 7d 0a 20 20 7d 0a 23 65 6e 64 69 66 0a 0a 20 }. }.#endif..
52b0: 20 69 66 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75 if( db->init.bu
52c0: 73 79 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c sy==0 ){. sql
52d0: 69 74 65 33 56 64 62 65 53 65 74 53 71 6c 28 73 ite3VdbeSetSql(s
52e0: 50 61 72 73 65 2e 70 56 64 62 65 2c 20 7a 53 71 Parse.pVdbe, zSq
52f0: 6c 2c 20 28 69 6e 74 29 28 73 50 61 72 73 65 2e l, (int)(sParse.
5300: 7a 54 61 69 6c 2d 7a 53 71 6c 29 2c 20 70 72 65 zTail-zSql), pre
5310: 70 46 6c 61 67 73 29 3b 0a 20 20 7d 0a 20 20 69 pFlags);. }. i
5320: 66 28 20 73 50 61 72 73 65 2e 70 56 64 62 65 20 f( sParse.pVdbe
5330: 26 26 20 28 72 63 21 3d 53 51 4c 49 54 45 5f 4f && (rc!=SQLITE_O
5340: 4b 20 7c 7c 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 K || db->mallocF
5350: 61 69 6c 65 64 29 20 29 7b 0a 20 20 20 20 73 71 ailed) ){. sq
5360: 6c 69 74 65 33 56 64 62 65 46 69 6e 61 6c 69 7a lite3VdbeFinaliz
5370: 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 29 3b e(sParse.pVdbe);
5380: 0a 20 20 20 20 61 73 73 65 72 74 28 21 28 2a 70 . assert(!(*p
5390: 70 53 74 6d 74 29 29 3b 0a 20 20 7d 65 6c 73 65 pStmt));. }else
53a0: 7b 0a 20 20 20 20 2a 70 70 53 74 6d 74 20 3d 20 {. *ppStmt =
53b0: 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a 29 73 (sqlite3_stmt*)s
53c0: 50 61 72 73 65 2e 70 56 64 62 65 3b 0a 20 20 7d Parse.pVdbe;. }
53d0: 0a 0a 20 20 69 66 28 20 7a 45 72 72 4d 73 67 20 .. if( zErrMsg
53e0: 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 72 ){. sqlite3Er
53f0: 72 6f 72 57 69 74 68 4d 73 67 28 64 62 2c 20 72 rorWithMsg(db, r
5400: 63 2c 20 22 25 73 22 2c 20 7a 45 72 72 4d 73 67 c, "%s", zErrMsg
5410: 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 62 );. sqlite3Db
5420: 46 72 65 65 28 64 62 2c 20 7a 45 72 72 4d 73 67 Free(db, zErrMsg
5430: 29 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 );. }else{.
5440: 73 71 6c 69 74 65 33 45 72 72 6f 72 28 64 62 2c sqlite3Error(db,
5450: 20 72 63 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 rc);. }.. /*
5460: 44 65 6c 65 74 65 20 61 6e 79 20 54 72 69 67 67 Delete any Trigg
5470: 65 72 50 72 67 20 73 74 72 75 63 74 75 72 65 73 erPrg structures
5480: 20 61 6c 6c 6f 63 61 74 65 64 20 77 68 69 6c 65 allocated while
5490: 20 70 61 72 73 69 6e 67 20 74 68 69 73 20 73 74 parsing this st
54a0: 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 77 68 atement. */. wh
54b0: 69 6c 65 28 20 73 50 61 72 73 65 2e 70 54 72 69 ile( sParse.pTri
54c0: 67 67 65 72 50 72 67 20 29 7b 0a 20 20 20 20 54 ggerPrg ){. T
54d0: 72 69 67 67 65 72 50 72 67 20 2a 70 54 20 3d 20 riggerPrg *pT =
54e0: 73 50 61 72 73 65 2e 70 54 72 69 67 67 65 72 50 sParse.pTriggerP
54f0: 72 67 3b 0a 20 20 20 20 73 50 61 72 73 65 2e 70 rg;. sParse.p
5500: 54 72 69 67 67 65 72 50 72 67 20 3d 20 70 54 2d TriggerPrg = pT-
5510: 3e 70 4e 65 78 74 3b 0a 20 20 20 20 73 71 6c 69 >pNext;. sqli
5520: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 70 54 te3DbFree(db, pT
5530: 29 3b 0a 20 20 7d 0a 0a 65 6e 64 5f 70 72 65 70 );. }..end_prep
5540: 61 72 65 3a 0a 0a 20 20 73 71 6c 69 74 65 33 50 are:.. sqlite3P
5550: 61 72 73 65 72 52 65 73 65 74 28 26 73 50 61 72 arserReset(&sPar
5560: 73 65 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 se);. rc = sqli
5570: 74 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 te3ApiExit(db, r
5580: 63 29 3b 0a 20 20 61 73 73 65 72 74 28 20 28 72 c);. assert( (r
5590: 63 26 64 62 2d 3e 65 72 72 4d 61 73 6b 29 3d 3d c&db->errMask)==
55a0: 72 63 20 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 rc );. return r
55b0: 63 3b 0a 7d 0a 73 74 61 74 69 63 20 69 6e 74 20 c;.}.static int
55c0: 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 sqlite3LockAndPr
55d0: 65 70 61 72 65 28 0a 20 20 73 71 6c 69 74 65 33 epare(. sqlite3
55e0: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 *db,
55f0: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 /* Database h
5600: 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 andle. */. cons
5610: 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 t char *zSql,
5620: 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 20 65 /* UTF-8 e
5630: 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 ncoded SQL state
5640: 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e ment. */. int n
5650: 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 20 20 Bytes,
5660: 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f /* Length o
5670: 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e f zSql in bytes.
5680: 20 2a 2f 0a 20 20 75 33 32 20 70 72 65 70 46 6c */. u32 prepFl
5690: 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 ags,
56a0: 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 /* Zero or more
56b0: 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 2a SQLITE_PREPARE_*
56c0: 20 66 6c 61 67 73 20 2a 2f 0a 20 20 56 64 62 65 flags */. Vdbe
56d0: 20 2a 70 4f 6c 64 2c 20 20 20 20 20 20 20 20 20 *pOld,
56e0: 20 20 20 20 20 20 2f 2a 20 56 4d 20 62 65 69 6e /* VM bein
56f0: 67 20 72 65 70 72 65 70 61 72 65 64 20 2a 2f 0a g reprepared */.
5700: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a sqlite3_stmt *
5710: 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f *ppStmt, /* O
5720: 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f UT: A pointer to
5730: 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74 the prepared st
5740: 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e atement */. con
5750: 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 69 6c st char **pzTail
5760: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 /* OUT: E
5770: 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 nd of parsed str
5780: 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 ing */.){. int
5790: 72 63 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 rc;..#ifdef SQLI
57a0: 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 TE_ENABLE_API_AR
57b0: 4d 4f 52 0a 20 20 69 66 28 20 70 70 53 74 6d 74 MOR. if( ppStmt
57c0: 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c ==0 ) return SQL
57d0: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
57e0: 0a 23 65 6e 64 69 66 0a 20 20 2a 70 70 53 74 6d .#endif. *ppStm
57f0: 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 21 73 71 t = 0;. if( !sq
5800: 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b lite3SafetyCheck
5810: 4f 6b 28 64 62 29 7c 7c 7a 53 71 6c 3d 3d 30 20 Ok(db)||zSql==0
5820: 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 ){. return SQ
5830: 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 LITE_MISUSE_BKPT
5840: 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f ;. }. sqlite3_
5850: 6d 75 74 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e mutex_enter(db->
5860: 6d 75 74 65 78 29 3b 0a 20 20 73 71 6c 69 74 65 mutex);. sqlite
5870: 33 42 74 72 65 65 45 6e 74 65 72 41 6c 6c 28 64 3BtreeEnterAll(d
5880: 62 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 b);. rc = sqlit
5890: 65 33 50 72 65 70 61 72 65 28 64 62 2c 20 7a 53 e3Prepare(db, zS
58a0: 71 6c 2c 20 6e 42 79 74 65 73 2c 20 70 72 65 70 ql, nBytes, prep
58b0: 46 6c 61 67 73 2c 20 70 4f 6c 64 2c 20 70 70 53 Flags, pOld, ppS
58c0: 74 6d 74 2c 20 70 7a 54 61 69 6c 29 3b 0a 20 20 tmt, pzTail);.
58d0: 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 53 if( rc==SQLITE_S
58e0: 43 48 45 4d 41 20 29 7b 0a 20 20 20 20 73 71 6c CHEMA ){. sql
58f0: 69 74 65 33 5f 66 69 6e 61 6c 69 7a 65 28 2a 70 ite3_finalize(*p
5900: 70 53 74 6d 74 29 3b 0a 20 20 20 20 72 63 20 3d pStmt);. rc =
5910: 20 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 28 sqlite3Prepare(
5920: 64 62 2c 20 7a 53 71 6c 2c 20 6e 42 79 74 65 73 db, zSql, nBytes
5930: 2c 20 70 72 65 70 46 6c 61 67 73 2c 20 70 4f 6c , prepFlags, pOl
5940: 64 2c 20 70 70 53 74 6d 74 2c 20 70 7a 54 61 69 d, ppStmt, pzTai
5950: 6c 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 l);. }. sqlite
5960: 33 42 74 72 65 65 4c 65 61 76 65 41 6c 6c 28 64 3BtreeLeaveAll(d
5970: 62 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 b);. sqlite3_mu
5980: 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 tex_leave(db->mu
5990: 74 65 78 29 3b 0a 20 20 61 73 73 65 72 74 28 20 tex);. assert(
59a0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c rc==SQLITE_OK ||
59b0: 20 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 *ppStmt==0 );.
59c0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 2f return rc;.}../
59d0: 2a 0a 2a 2a 20 52 65 72 75 6e 20 74 68 65 20 63 *.** Rerun the c
59e0: 6f 6d 70 69 6c 61 74 69 6f 6e 20 6f 66 20 61 20 ompilation of a
59f0: 73 74 61 74 65 6d 65 6e 74 20 61 66 74 65 72 20 statement after
5a00: 61 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 2e a schema change.
5a10: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 73 74 .**.** If the st
5a20: 61 74 65 6d 65 6e 74 20 69 73 20 73 75 63 63 65 atement is succe
5a30: 73 73 66 75 6c 6c 79 20 72 65 63 6f 6d 70 69 6c ssfully recompil
5a40: 65 64 2c 20 72 65 74 75 72 6e 20 53 51 4c 49 54 ed, return SQLIT
5a50: 45 5f 4f 4b 2e 20 4f 74 68 65 72 77 69 73 65 2c E_OK. Otherwise,
5a60: 0a 2a 2a 20 69 66 20 74 68 65 20 73 74 61 74 65 .** if the state
5a70: 6d 65 6e 74 20 63 61 6e 6e 6f 74 20 62 65 20 72 ment cannot be r
5a80: 65 63 6f 6d 70 69 6c 65 64 20 62 65 63 61 75 73 ecompiled becaus
5a90: 65 20 61 6e 6f 74 68 65 72 20 63 6f 6e 6e 65 63 e another connec
5aa0: 74 69 6f 6e 20 68 61 73 0a 2a 2a 20 6c 6f 63 6b tion has.** lock
5ab0: 65 64 20 74 68 65 20 73 71 6c 69 74 65 33 5f 6d ed the sqlite3_m
5ac0: 61 73 74 65 72 20 74 61 62 6c 65 2c 20 72 65 74 aster table, ret
5ad0: 75 72 6e 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 urn SQLITE_LOCKE
5ae0: 44 2e 20 49 66 20 61 6e 79 20 6f 74 68 65 72 20 D. If any other
5af0: 65 72 72 6f 72 0a 2a 2a 20 6f 63 63 75 72 73 2c error.** occurs,
5b00: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 53 return SQLITE_S
5b10: 43 48 45 4d 41 2e 0a 2a 2f 0a 69 6e 74 20 73 71 CHEMA..*/.int sq
5b20: 6c 69 74 65 33 52 65 70 72 65 70 61 72 65 28 56 lite3Reprepare(V
5b30: 64 62 65 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 dbe *p){. int r
5b40: 63 3b 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d c;. sqlite3_stm
5b50: 74 20 2a 70 4e 65 77 3b 0a 20 20 63 6f 6e 73 74 t *pNew;. const
5b60: 20 63 68 61 72 20 2a 7a 53 71 6c 3b 0a 20 20 73 char *zSql;. s
5b70: 71 6c 69 74 65 33 20 2a 64 62 3b 0a 20 20 75 38 qlite3 *db;. u8
5b80: 20 70 72 65 70 46 6c 61 67 73 3b 0a 0a 20 20 61 prepFlags;.. a
5b90: 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d ssert( sqlite3_m
5ba0: 75 74 65 78 5f 68 65 6c 64 28 73 71 6c 69 74 65 utex_held(sqlite
5bb0: 33 56 64 62 65 44 62 28 70 29 2d 3e 6d 75 74 65 3VdbeDb(p)->mute
5bc0: 78 29 20 29 3b 0a 20 20 7a 53 71 6c 20 3d 20 73 x) );. zSql = s
5bd0: 71 6c 69 74 65 33 5f 73 71 6c 28 28 73 71 6c 69 qlite3_sql((sqli
5be0: 74 65 33 5f 73 74 6d 74 20 2a 29 70 29 3b 0a 20 te3_stmt *)p);.
5bf0: 20 61 73 73 65 72 74 28 20 7a 53 71 6c 21 3d 30 assert( zSql!=0
5c00: 20 29 3b 20 20 2f 2a 20 52 65 70 72 65 70 61 72 ); /* Reprepar
5c10: 65 20 6f 6e 6c 79 20 63 61 6c 6c 65 64 20 66 6f e only called fo
5c20: 72 20 70 72 65 70 61 72 65 5f 76 32 28 29 20 73 r prepare_v2() s
5c30: 74 61 74 65 6d 65 6e 74 73 20 2a 2f 0a 20 20 64 tatements */. d
5c40: 62 20 3d 20 73 71 6c 69 74 65 33 56 64 62 65 44 b = sqlite3VdbeD
5c50: 62 28 70 29 3b 0a 20 20 61 73 73 65 72 74 28 20 b(p);. assert(
5c60: 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 sqlite3_mutex_he
5c70: 6c 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b ld(db->mutex) );
5c80: 0a 20 20 70 72 65 70 46 6c 61 67 73 20 3d 20 73 . prepFlags = s
5c90: 71 6c 69 74 65 33 56 64 62 65 50 72 65 70 61 72 qlite3VdbePrepar
5ca0: 65 46 6c 61 67 73 28 70 29 3b 0a 20 20 72 63 20 eFlags(p);. rc
5cb0: 3d 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 = sqlite3LockAnd
5cc0: 50 72 65 70 61 72 65 28 64 62 2c 20 7a 53 71 6c Prepare(db, zSql
5cd0: 2c 20 2d 31 2c 20 70 72 65 70 46 6c 61 67 73 2c , -1, prepFlags,
5ce0: 20 70 2c 20 26 70 4e 65 77 2c 20 30 29 3b 0a 20 p, &pNew, 0);.
5cf0: 20 69 66 28 20 72 63 20 29 7b 0a 20 20 20 20 69 if( rc ){. i
5d00: 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f f( rc==SQLITE_NO
5d10: 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 73 71 6c MEM ){. sql
5d20: 69 74 65 33 4f 6f 6d 46 61 75 6c 74 28 64 62 29 ite3OomFault(db)
5d30: 3b 0a 20 20 20 20 7d 0a 20 20 20 20 61 73 73 65 ;. }. asse
5d40: 72 74 28 20 70 4e 65 77 3d 3d 30 20 29 3b 0a 20 rt( pNew==0 );.
5d50: 20 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 return rc;.
5d60: 7d 65 6c 73 65 7b 0a 20 20 20 20 61 73 73 65 72 }else{. asser
5d70: 74 28 20 70 4e 65 77 21 3d 30 20 29 3b 0a 20 20 t( pNew!=0 );.
5d80: 7d 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 }. sqlite3VdbeS
5d90: 77 61 70 28 28 56 64 62 65 2a 29 70 4e 65 77 2c wap((Vdbe*)pNew,
5da0: 20 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 54 72 p);. sqlite3Tr
5db0: 61 6e 73 66 65 72 42 69 6e 64 69 6e 67 73 28 70 ansferBindings(p
5dc0: 4e 65 77 2c 20 28 73 71 6c 69 74 65 33 5f 73 74 New, (sqlite3_st
5dd0: 6d 74 2a 29 70 29 3b 0a 20 20 73 71 6c 69 74 65 mt*)p);. sqlite
5de0: 33 56 64 62 65 52 65 73 65 74 53 74 65 70 52 65 3VdbeResetStepRe
5df0: 73 75 6c 74 28 28 56 64 62 65 2a 29 70 4e 65 77 sult((Vdbe*)pNew
5e00: 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 62 65 );. sqlite3Vdbe
5e10: 46 69 6e 61 6c 69 7a 65 28 28 56 64 62 65 2a 29 Finalize((Vdbe*)
5e20: 70 4e 65 77 29 3b 0a 20 20 72 65 74 75 72 6e 20 pNew);. return
5e30: 53 51 4c 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f SQLITE_OK;.}.../
5e40: 2a 0a 2a 2a 20 54 77 6f 20 76 65 72 73 69 6f 6e *.** Two version
5e50: 73 20 6f 66 20 74 68 65 20 6f 66 66 69 63 69 61 s of the officia
5e60: 6c 20 41 50 49 2e 20 20 4c 65 67 61 63 79 20 61 l API. Legacy a
5e70: 6e 64 20 6e 65 77 20 75 73 65 2e 20 20 49 6e 20 nd new use. In
5e80: 74 68 65 20 6c 65 67 61 63 79 0a 2a 2a 20 76 65 the legacy.** ve
5e90: 72 73 69 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69 rsion, the origi
5ea0: 6e 61 6c 20 53 51 4c 20 74 65 78 74 20 69 73 20 nal SQL text is
5eb0: 6e 6f 74 20 73 61 76 65 64 20 69 6e 20 74 68 65 not saved in the
5ec0: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d prepared statem
5ed0: 65 6e 74 0a 2a 2a 20 61 6e 64 20 73 6f 20 69 66 ent.** and so if
5ee0: 20 61 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 a schema change
5ef0: 20 6f 63 63 75 72 73 2c 20 53 51 4c 49 54 45 5f occurs, SQLITE_
5f00: 53 43 48 45 4d 41 20 69 73 20 72 65 74 75 72 6e SCHEMA is return
5f10: 65 64 20 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 ed by.** sqlite3
5f20: 5f 73 74 65 70 28 29 2e 20 20 49 6e 20 74 68 65 _step(). In the
5f30: 20 6e 65 77 20 76 65 72 73 69 6f 6e 2c 20 74 68 new version, th
5f40: 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 20 74 e original SQL t
5f50: 65 78 74 20 69 73 20 72 65 74 61 69 6e 65 64 0a ext is retained.
5f60: 2a 2a 20 61 6e 64 20 74 68 65 20 73 74 61 74 65 ** and the state
5f70: 6d 65 6e 74 20 69 73 20 61 75 74 6f 6d 61 74 69 ment is automati
5f80: 63 61 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65 64 cally recompiled
5f90: 20 69 66 20 61 6e 20 73 63 68 65 6d 61 20 63 68 if an schema ch
5fa0: 61 6e 67 65 0a 2a 2a 20 6f 63 63 75 72 73 2e 0a ange.** occurs..
5fb0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 */.int sqlite3_p
5fc0: 72 65 70 61 72 65 28 0a 20 20 73 71 6c 69 74 65 repare(. sqlite
5fd0: 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 3 *db,
5fe0: 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 /* Database
5ff0: 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e handle. */. con
6000: 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 st char *zSql,
6010: 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 20 /* UTF-8
6020: 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 encoded SQL stat
6030: 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 ement. */. int
6040: 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 20 nBytes,
6050: 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 /* Length
6060: 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 of zSql in bytes
6070: 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 . */. sqlite3_s
6080: 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 tmt **ppStmt,
6090: 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 /* OUT: A point
60a0: 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61 72 er to the prepar
60b0: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a ed statement */.
60c0: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a 70 const char **p
60d0: 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f zTail /* O
60e0: 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65 UT: End of parse
60f0: 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 d string */.){.
6100: 20 69 6e 74 20 72 63 3b 0a 20 20 72 63 20 3d 20 int rc;. rc =
6110: 73 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 sqlite3LockAndPr
6120: 65 70 61 72 65 28 64 62 2c 7a 53 71 6c 2c 6e 42 epare(db,zSql,nB
6130: 79 74 65 73 2c 30 2c 30 2c 70 70 53 74 6d 74 2c ytes,0,0,ppStmt,
6140: 70 7a 54 61 69 6c 29 3b 0a 20 20 61 73 73 65 72 pzTail);. asser
6150: 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b t( rc==SQLITE_OK
6160: 20 7c 7c 20 70 70 53 74 6d 74 3d 3d 30 20 7c 7c || ppStmt==0 ||
6170: 20 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 20 20 *ppStmt==0 );
6180: 2f 2a 20 56 45 52 49 46 59 3a 20 46 31 33 30 32 /* VERIFY: F1302
6190: 31 20 2a 2f 0a 20 20 72 65 74 75 72 6e 20 72 63 1 */. return rc
61a0: 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f ;.}.int sqlite3_
61b0: 70 72 65 70 61 72 65 5f 76 32 28 0a 20 20 73 71 prepare_v2(. sq
61c0: 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 lite3 *db,
61d0: 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 /* Datab
61e0: 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 ase handle. */.
61f0: 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 const char *zSq
6200: 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 l, /* UT
6210: 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 F-8 encoded SQL
6220: 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 statement. */.
6230: 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 int nBytes,
6240: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e /* Len
6250: 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 gth of zSql in b
6260: 79 74 65 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 ytes. */. sqlit
6270: 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 e3_stmt **ppStmt
6280: 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 , /* OUT: A p
6290: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 ointer to the pr
62a0: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 epared statement
62b0: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
62c0: 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 **pzTail
62d0: 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 /* OUT: End of p
62e0: 61 72 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a arsed string */.
62f0: 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 2f ){. int rc;. /
6300: 2a 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 * EVIDENCE-OF: R
6310: 2d 33 37 39 32 33 2d 31 32 31 37 33 20 54 68 65 -37923-12173 The
6320: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 sqlite3_prepare
6330: 5f 76 32 28 29 20 69 6e 74 65 72 66 61 63 65 20 _v2() interface
6340: 77 6f 72 6b 73 0a 20 20 2a 2a 20 65 78 61 63 74 works. ** exact
6350: 6c 79 20 74 68 65 20 73 61 6d 65 20 61 73 20 73 ly the same as s
6360: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76 qlite3_prepare_v
6370: 33 28 29 20 77 69 74 68 20 61 20 7a 65 72 6f 20 3() with a zero
6380: 70 72 65 70 46 6c 61 67 73 0a 20 20 2a 2a 20 70 prepFlags. ** p
6390: 61 72 61 6d 65 74 65 72 2e 0a 20 20 2a 2a 0a 20 arameter.. **.
63a0: 20 2a 2a 20 50 72 6f 6f 66 20 69 6e 20 74 68 61 ** Proof in tha
63b0: 74 20 74 68 65 20 35 74 68 20 70 61 72 61 6d 65 t the 5th parame
63c0: 74 65 72 20 74 6f 20 73 71 6c 69 74 65 33 4c 6f ter to sqlite3Lo
63d0: 63 6b 41 6e 64 50 72 65 70 61 72 65 20 69 73 20 ckAndPrepare is
63e0: 30 20 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 0 */. rc = sqli
63f0: 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 te3LockAndPrepar
6400: 65 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 e(db,zSql,nBytes
6410: 2c 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f ,SQLITE_PREPARE_
6420: 53 41 56 45 53 51 4c 2c 30 2c 0a 20 20 20 20 20 SAVESQL,0,.
6430: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6440: 20 20 20 20 20 20 20 20 70 70 53 74 6d 74 2c 70 ppStmt,p
6450: 7a 54 61 69 6c 29 3b 0a 20 20 61 73 73 65 72 74 zTail);. assert
6460: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
6470: 7c 7c 20 70 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 || ppStmt==0 ||
6480: 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 *ppStmt==0 );.
6490: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 return rc;.}.int
64a0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 sqlite3_prepare
64b0: 5f 76 33 28 0a 20 20 73 71 6c 69 74 65 33 20 2a _v3(. sqlite3 *
64c0: 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 db,
64d0: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e /* Database han
64e0: 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 dle. */. const
64f0: 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 char *zSql,
6500: 20 20 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63 /* UTF-8 enc
6510: 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 oded SQL stateme
6520: 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 nt. */. int nBy
6530: 74 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 tes,
6540: 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 /* Length of
6550: 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a zSql in bytes. *
6560: 2f 0a 20 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 /. unsigned int
6570: 20 70 72 65 70 46 6c 61 67 73 2c 20 20 20 2f 2a prepFlags, /*
6580: 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 65 20 53 51 Zero or more SQ
6590: 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 2a 20 66 LITE_PREPARE_* f
65a0: 6c 61 67 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 lags */. sqlite
65b0: 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 3_stmt **ppStmt,
65c0: 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f /* OUT: A po
65d0: 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 inter to the pre
65e0: 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 pared statement
65f0: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
6600: 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f **pzTail /
6610: 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 * OUT: End of pa
6620: 72 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 rsed string */.)
6630: 7b 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 2f 2a {. int rc;. /*
6640: 20 45 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d EVIDENCE-OF: R-
6650: 35 36 38 36 31 2d 34 32 36 37 33 20 73 71 6c 69 56861-42673 sqli
6660: 74 65 33 5f 70 72 65 70 61 72 65 5f 76 33 28 29 te3_prepare_v3()
6670: 20 64 69 66 66 65 72 73 20 66 72 6f 6d 0a 20 20 differs from.
6680: 2a 2a 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 ** sqlite3_prepa
6690: 72 65 5f 76 32 28 29 20 6f 6e 6c 79 20 69 6e 20 re_v2() only in
66a0: 68 61 76 69 6e 67 20 74 68 65 20 65 78 74 72 61 having the extra
66b0: 20 70 72 65 70 46 6c 61 67 73 20 70 61 72 61 6d prepFlags param
66c0: 65 74 65 72 2c 0a 20 20 2a 2a 20 77 68 69 63 68 eter,. ** which
66d0: 20 69 73 20 61 20 62 69 74 20 61 72 72 61 79 20 is a bit array
66e0: 63 6f 6e 73 69 73 74 69 6e 67 20 6f 66 20 7a 65 consisting of ze
66f0: 72 6f 20 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68 ro or more of th
6700: 65 0a 20 20 2a 2a 20 53 51 4c 49 54 45 5f 50 52 e. ** SQLITE_PR
6710: 45 50 41 52 45 5f 2a 20 66 6c 61 67 73 2e 0a 20 EPARE_* flags..
6720: 20 2a 2a 0a 20 20 2a 2a 20 50 72 6f 6f 66 20 62 **. ** Proof b
6730: 79 20 63 6f 6d 70 61 72 69 73 6f 6e 20 74 6f 20 y comparison to
6740: 74 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 the implementati
6750: 6f 6e 20 6f 66 20 73 71 6c 69 74 65 33 5f 70 72 on of sqlite3_pr
6760: 65 70 61 72 65 5f 76 32 28 29 0a 20 20 2a 2a 20 epare_v2(). **
6770: 64 69 72 65 63 74 6c 79 20 61 62 6f 76 65 2e 20 directly above.
6780: 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 */. rc = sqlite
6790: 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28 3LockAndPrepare(
67a0: 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 0a db,zSql,nBytes,.
67b0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
67c0: 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f SQLITE_PREPARE_
67d0: 53 41 56 45 53 51 4c 7c 28 70 72 65 70 46 6c 61 SAVESQL|(prepFla
67e0: 67 73 26 53 51 4c 49 54 45 5f 50 52 45 50 41 52 gs&SQLITE_PREPAR
67f0: 45 5f 4d 41 53 4b 29 2c 0a 20 20 20 20 20 20 20 E_MASK),.
6800: 20 20 20 20 20 20 20 20 20 20 30 2c 70 70 53 74 0,ppSt
6810: 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a 20 20 61 73 mt,pzTail);. as
6820: 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 sert( rc==SQLITE
6830: 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d 74 3d 3d 30 _OK || ppStmt==0
6840: 20 7c 7c 20 2a 70 70 53 74 6d 74 3d 3d 30 20 29 || *ppStmt==0 )
6850: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
6860: 0a 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 ...#ifndef SQLIT
6870: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a E_OMIT_UTF16./*.
6880: 2a 2a 20 43 6f 6d 70 69 6c 65 20 74 68 65 20 55 ** Compile the U
6890: 54 46 2d 31 36 20 65 6e 63 6f 64 65 64 20 53 51 TF-16 encoded SQ
68a0: 4c 20 73 74 61 74 65 6d 65 6e 74 20 7a 53 71 6c L statement zSql
68b0: 20 69 6e 74 6f 20 61 20 73 74 61 74 65 6d 65 6e into a statemen
68c0: 74 20 68 61 6e 64 6c 65 2e 0a 2a 2f 0a 73 74 61 t handle..*/.sta
68d0: 74 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 50 tic int sqlite3P
68e0: 72 65 70 61 72 65 31 36 28 0a 20 20 73 71 6c 69 repare16(. sqli
68f0: 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 te3 *db,
6900: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 /* Databas
6910: 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 e handle. */ .
6920: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c const void *zSql
6930: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 , /* UTF
6940: 2d 31 36 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 -16 encoded SQL
6950: 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 statement. */.
6960: 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 int nBytes,
6970: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e /* Len
6980: 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 gth of zSql in b
6990: 79 74 65 73 2e 20 2a 2f 0a 20 20 75 33 32 20 70 ytes. */. u32 p
69a0: 72 65 70 46 6c 61 67 73 2c 20 20 20 20 20 20 20 repFlags,
69b0: 20 20 20 20 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 /* Zero or
69c0: 6d 6f 72 65 20 53 51 4c 49 54 45 5f 50 52 45 50 more SQLITE_PREP
69d0: 41 52 45 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a 20 ARE_* flags */.
69e0: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a sqlite3_stmt **
69f0: 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 ppStmt, /* OU
6a00: 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 T: A pointer to
6a10: 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 the prepared sta
6a20: 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 tement */. cons
6a30: 74 20 76 6f 69 64 20 2a 2a 70 7a 54 61 69 6c 20 t void **pzTail
6a40: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e /* OUT: En
6a50: 64 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 69 d of parsed stri
6a60: 6e 67 20 2a 2f 0a 29 7b 0a 20 20 2f 2a 20 54 68 ng */.){. /* Th
6a70: 69 73 20 66 75 6e 63 74 69 6f 6e 20 63 75 72 72 is function curr
6a80: 65 6e 74 6c 79 20 77 6f 72 6b 73 20 62 79 20 66 ently works by f
6a90: 69 72 73 74 20 74 72 61 6e 73 66 6f 72 6d 69 6e irst transformin
6aa0: 67 20 74 68 65 20 55 54 46 2d 31 36 0a 20 20 2a g the UTF-16. *
6ab0: 2a 20 65 6e 63 6f 64 65 64 20 73 74 72 69 6e 67 * encoded string
6ac0: 20 74 6f 20 55 54 46 2d 38 2c 20 74 68 65 6e 20 to UTF-8, then
6ad0: 69 6e 76 6f 6b 69 6e 67 20 73 71 6c 69 74 65 33 invoking sqlite3
6ae0: 5f 70 72 65 70 61 72 65 28 29 2e 20 54 68 65 0a _prepare(). The.
6af0: 20 20 2a 2a 20 74 72 69 63 6b 79 20 62 69 74 20 ** tricky bit
6b00: 69 73 20 66 69 67 75 72 69 6e 67 20 6f 75 74 20 is figuring out
6b10: 74 68 65 20 70 6f 69 6e 74 65 72 20 74 6f 20 72 the pointer to r
6b20: 65 74 75 72 6e 20 69 6e 20 2a 70 7a 54 61 69 6c eturn in *pzTail
6b30: 2e 0a 20 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a .. */. char *z
6b40: 53 71 6c 38 3b 0a 20 20 63 6f 6e 73 74 20 63 68 Sql8;. const ch
6b50: 61 72 20 2a 7a 54 61 69 6c 38 20 3d 20 30 3b 0a ar *zTail8 = 0;.
6b60: 20 20 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 int rc = SQLIT
6b70: 45 5f 4f 4b 3b 0a 0a 23 69 66 64 65 66 20 53 51 E_OK;..#ifdef SQ
6b80: 4c 49 54 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f LITE_ENABLE_API_
6b90: 41 52 4d 4f 52 0a 20 20 69 66 28 20 70 70 53 74 ARMOR. if( ppSt
6ba0: 6d 74 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 53 mt==0 ) return S
6bb0: 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 QLITE_MISUSE_BKP
6bc0: 54 3b 0a 23 65 6e 64 69 66 0a 20 20 2a 70 70 53 T;.#endif. *ppS
6bd0: 74 6d 74 20 3d 20 30 3b 0a 20 20 69 66 28 20 21 tmt = 0;. if( !
6be0: 73 71 6c 69 74 65 33 53 61 66 65 74 79 43 68 65 sqlite3SafetyChe
6bf0: 63 6b 4f 6b 28 64 62 29 7c 7c 7a 53 71 6c 3d 3d ckOk(db)||zSql==
6c00: 30 20 29 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 0 ){. return
6c10: 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b SQLITE_MISUSE_BK
6c20: 50 54 3b 0a 20 20 7d 0a 20 20 69 66 28 20 6e 42 PT;. }. if( nB
6c30: 79 74 65 73 3e 3d 30 20 29 7b 0a 20 20 20 20 69 ytes>=0 ){. i
6c40: 6e 74 20 73 7a 3b 0a 20 20 20 20 63 6f 6e 73 74 nt sz;. const
6c50: 20 63 68 61 72 20 2a 7a 20 3d 20 28 63 6f 6e 73 char *z = (cons
6c60: 74 20 63 68 61 72 2a 29 7a 53 71 6c 3b 0a 20 20 t char*)zSql;.
6c70: 20 20 66 6f 72 28 73 7a 3d 30 3b 20 73 7a 3c 6e for(sz=0; sz<n
6c80: 42 79 74 65 73 20 26 26 20 28 7a 5b 73 7a 5d 21 Bytes && (z[sz]!
6c90: 3d 30 20 7c 7c 20 7a 5b 73 7a 2b 31 5d 21 3d 30 =0 || z[sz+1]!=0
6ca0: 29 3b 20 73 7a 20 2b 3d 20 32 29 7b 7d 0a 20 20 ); sz += 2){}.
6cb0: 20 20 6e 42 79 74 65 73 20 3d 20 73 7a 3b 0a 20 nBytes = sz;.
6cc0: 20 7d 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 }. sqlite3_mut
6cd0: 65 78 5f 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 ex_enter(db->mut
6ce0: 65 78 29 3b 0a 20 20 7a 53 71 6c 38 20 3d 20 73 ex);. zSql8 = s
6cf0: 71 6c 69 74 65 33 55 74 66 31 36 74 6f 38 28 64 qlite3Utf16to8(d
6d00: 62 2c 20 7a 53 71 6c 2c 20 6e 42 79 74 65 73 2c b, zSql, nBytes,
6d10: 20 53 51 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 SQLITE_UTF16NAT
6d20: 49 56 45 29 3b 0a 20 20 69 66 28 20 7a 53 71 6c IVE);. if( zSql
6d30: 38 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 8 ){. rc = sq
6d40: 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 lite3LockAndPrep
6d50: 61 72 65 28 64 62 2c 20 7a 53 71 6c 38 2c 20 2d are(db, zSql8, -
6d60: 31 2c 20 70 72 65 70 46 6c 61 67 73 2c 20 30 2c 1, prepFlags, 0,
6d70: 20 70 70 53 74 6d 74 2c 20 26 7a 54 61 69 6c 38 ppStmt, &zTail8
6d80: 29 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 7a 54 );. }.. if( zT
6d90: 61 69 6c 38 20 26 26 20 70 7a 54 61 69 6c 20 29 ail8 && pzTail )
6da0: 7b 0a 20 20 20 20 2f 2a 20 49 66 20 73 71 6c 69 {. /* If sqli
6db0: 74 65 33 5f 70 72 65 70 61 72 65 20 72 65 74 75 te3_prepare retu
6dc0: 72 6e 73 20 61 20 74 61 69 6c 20 70 6f 69 6e 74 rns a tail point
6dd0: 65 72 2c 20 77 65 20 63 61 6c 63 75 6c 61 74 65 er, we calculate
6de0: 20 74 68 65 0a 20 20 20 20 2a 2a 20 65 71 75 69 the. ** equi
6df0: 76 61 6c 65 6e 74 20 70 6f 69 6e 74 65 72 20 69 valent pointer i
6e00: 6e 74 6f 20 74 68 65 20 55 54 46 2d 31 36 20 73 nto the UTF-16 s
6e10: 74 72 69 6e 67 20 62 79 20 63 6f 75 6e 74 69 6e tring by countin
6e20: 67 20 74 68 65 20 75 6e 69 63 6f 64 65 0a 20 20 g the unicode.
6e30: 20 20 2a 2a 20 63 68 61 72 61 63 74 65 72 73 20 ** characters
6e40: 62 65 74 77 65 65 6e 20 7a 53 71 6c 38 20 61 6e between zSql8 an
6e50: 64 20 7a 54 61 69 6c 38 2c 20 61 6e 64 20 74 68 d zTail8, and th
6e60: 65 6e 20 72 65 74 75 72 6e 69 6e 67 20 61 20 70 en returning a p
6e70: 6f 69 6e 74 65 72 0a 20 20 20 20 2a 2a 20 74 68 ointer. ** th
6e80: 65 20 73 61 6d 65 20 6e 75 6d 62 65 72 20 6f 66 e same number of
6e90: 20 63 68 61 72 61 63 74 65 72 73 20 69 6e 74 6f characters into
6ea0: 20 74 68 65 20 55 54 46 2d 31 36 20 73 74 72 69 the UTF-16 stri
6eb0: 6e 67 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 ng.. */. i
6ec0: 6e 74 20 63 68 61 72 73 5f 70 61 72 73 65 64 20 nt chars_parsed
6ed0: 3d 20 73 71 6c 69 74 65 33 55 74 66 38 43 68 61 = sqlite3Utf8Cha
6ee0: 72 4c 65 6e 28 7a 53 71 6c 38 2c 20 28 69 6e 74 rLen(zSql8, (int
6ef0: 29 28 7a 54 61 69 6c 38 2d 7a 53 71 6c 38 29 29 )(zTail8-zSql8))
6f00: 3b 0a 20 20 20 20 2a 70 7a 54 61 69 6c 20 3d 20 ;. *pzTail =
6f10: 28 75 38 20 2a 29 7a 53 71 6c 20 2b 20 73 71 6c (u8 *)zSql + sql
6f20: 69 74 65 33 55 74 66 31 36 42 79 74 65 4c 65 6e ite3Utf16ByteLen
6f30: 28 7a 53 71 6c 2c 20 63 68 61 72 73 5f 70 61 72 (zSql, chars_par
6f40: 73 65 64 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 sed);. }. sqli
6f50: 74 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a 53 te3DbFree(db, zS
6f60: 71 6c 38 29 3b 20 0a 20 20 72 63 20 3d 20 73 71 ql8); . rc = sq
6f70: 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 2c lite3ApiExit(db,
6f80: 20 72 63 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f rc);. sqlite3_
6f90: 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e mutex_leave(db->
6fa0: 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 75 72 6e mutex);. return
6fb0: 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 77 rc;.}../*.** Tw
6fc0: 6f 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 o versions of th
6fd0: 65 20 6f 66 66 69 63 69 61 6c 20 41 50 49 2e 20 e official API.
6fe0: 20 4c 65 67 61 63 79 20 61 6e 64 20 6e 65 77 20 Legacy and new
6ff0: 75 73 65 2e 20 20 49 6e 20 74 68 65 20 6c 65 67 use. In the leg
7000: 61 63 79 0a 2a 2a 20 76 65 72 73 69 6f 6e 2c 20 acy.** version,
7010: 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c the original SQL
7020: 20 74 65 78 74 20 69 73 20 6e 6f 74 20 73 61 76 text is not sav
7030: 65 64 20 69 6e 20 74 68 65 20 70 72 65 70 61 72 ed in the prepar
7040: 65 64 20 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 ed statement.**
7050: 61 6e 64 20 73 6f 20 69 66 20 61 20 73 63 68 65 and so if a sche
7060: 6d 61 20 63 68 61 6e 67 65 20 6f 63 63 75 72 73 ma change occurs
7070: 2c 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 , SQLITE_SCHEMA
7080: 69 73 20 72 65 74 75 72 6e 65 64 20 62 79 0a 2a is returned by.*
7090: 2a 20 73 71 6c 69 74 65 33 5f 73 74 65 70 28 29 * sqlite3_step()
70a0: 2e 20 20 49 6e 20 74 68 65 20 6e 65 77 20 76 65 . In the new ve
70b0: 72 73 69 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69 rsion, the origi
70c0: 6e 61 6c 20 53 51 4c 20 74 65 78 74 20 69 73 20 nal SQL text is
70d0: 72 65 74 61 69 6e 65 64 0a 2a 2a 20 61 6e 64 20 retained.** and
70e0: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 69 73 the statement is
70f0: 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 automatically r
7100: 65 63 6f 6d 70 69 6c 65 64 20 69 66 20 61 6e 20 ecompiled if an
7110: 73 63 68 65 6d 61 20 63 68 61 6e 67 65 0a 2a 2a schema change.**
7120: 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74 20 occurs..*/.int
7130: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 31 sqlite3_prepare1
7140: 36 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 6(. sqlite3 *db
7150: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f , /
7160: 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c * Database handl
7170: 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e 73 74 20 76 e. */ . const v
7180: 6f 69 64 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 oid *zSql,
7190: 20 20 20 2f 2a 20 55 54 46 2d 31 36 20 65 6e 63 /* UTF-16 enc
71a0: 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 oded SQL stateme
71b0: 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 nt. */. int nBy
71c0: 74 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 tes,
71d0: 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 /* Length of
71e0: 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a zSql in bytes. *
71f0: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 /. sqlite3_stmt
7200: 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a **ppStmt, /*
7210: 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 OUT: A pointer
7220: 74 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20 to the prepared
7230: 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 statement */. c
7240: 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70 7a 54 61 onst void **pzTa
7250: 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a il /* OUT:
7260: 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 End of parsed s
7270: 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e tring */.){. in
7280: 74 20 72 63 3b 0a 20 20 72 63 20 3d 20 73 71 6c t rc;. rc = sql
7290: 69 74 65 33 50 72 65 70 61 72 65 31 36 28 64 62 ite3Prepare16(db
72a0: 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 30 2c 70 ,zSql,nBytes,0,p
72b0: 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a 20 pStmt,pzTail);.
72c0: 20 61 73 73 65 72 74 28 20 72 63 3d 3d 53 51 4c assert( rc==SQL
72d0: 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d 74 ITE_OK || ppStmt
72e0: 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d 74 3d 3d ==0 || *ppStmt==
72f0: 30 20 29 3b 20 20 2f 2a 20 56 45 52 49 46 59 3a 0 ); /* VERIFY:
7300: 20 46 31 33 30 32 31 20 2a 2f 0a 20 20 72 65 74 F13021 */. ret
7310: 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 urn rc;.}.int sq
7320: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 31 36 5f lite3_prepare16_
7330: 76 32 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 v2(. sqlite3 *d
7340: 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 b,
7350: 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 /* Database hand
7360: 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e 73 74 20 le. */ . const
7370: 76 6f 69 64 20 2a 7a 53 71 6c 2c 20 20 20 20 20 void *zSql,
7380: 20 20 20 20 2f 2a 20 55 54 46 2d 31 36 20 65 6e /* UTF-16 en
7390: 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d coded SQL statem
73a0: 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 ent. */. int nB
73b0: 79 74 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 ytes,
73c0: 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 /* Length of
73d0: 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 zSql in bytes.
73e0: 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d */. sqlite3_stm
73f0: 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f t **ppStmt, /
7400: 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 * OUT: A pointer
7410: 20 74 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 to the prepared
7420: 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 statement */.
7430: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 2a 70 7a 54 const void **pzT
7440: 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 ail /* OUT
7450: 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 : End of parsed
7460: 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 string */.){. i
7470: 6e 74 20 72 63 3b 0a 20 20 72 63 20 3d 20 73 71 nt rc;. rc = sq
7480: 6c 69 74 65 33 50 72 65 70 61 72 65 31 36 28 64 lite3Prepare16(d
7490: 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 53 51 b,zSql,nBytes,SQ
74a0: 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 53 41 56 LITE_PREPARE_SAV
74b0: 45 53 51 4c 2c 70 70 53 74 6d 74 2c 70 7a 54 61 ESQL,ppStmt,pzTa
74c0: 69 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 il);. assert( r
74d0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c==SQLITE_OK ||
74e0: 70 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 ppStmt==0 || *pp
74f0: 53 74 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 Stmt==0 ); /* V
7500: 45 52 49 46 59 3a 20 46 31 33 30 32 31 20 2a 2f ERIFY: F13021 */
7510: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
7520: 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 int sqlite3_prep
7530: 61 72 65 31 36 5f 76 33 28 0a 20 20 73 71 6c 69 are16_v3(. sqli
7540: 74 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 te3 *db,
7550: 20 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 /* Databas
7560: 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 e handle. */ .
7570: 63 6f 6e 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c const void *zSql
7580: 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 , /* UTF
7590: 2d 31 36 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 -16 encoded SQL
75a0: 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 statement. */.
75b0: 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20 20 int nBytes,
75c0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e /* Len
75d0: 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 gth of zSql in b
75e0: 79 74 65 73 2e 20 2a 2f 0a 20 20 75 6e 73 69 67 ytes. */. unsig
75f0: 6e 65 64 20 69 6e 74 20 70 72 65 70 46 6c 61 67 ned int prepFlag
7600: 73 2c 20 20 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 s, /* Zero or
7610: 6d 6f 72 65 20 53 51 4c 49 54 45 5f 50 52 45 50 more SQLITE_PREP
7620: 41 52 45 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a 20 ARE_* flags */.
7630: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a sqlite3_stmt **
7640: 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 ppStmt, /* OU
7650: 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 T: A pointer to
7660: 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 the prepared sta
7670: 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 tement */. cons
7680: 74 20 76 6f 69 64 20 2a 2a 70 7a 54 61 69 6c 20 t void **pzTail
7690: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e /* OUT: En
76a0: 64 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 69 d of parsed stri
76b0: 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 ng */.){. int r
76c0: 63 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 c;. rc = sqlite
76d0: 33 50 72 65 70 61 72 65 31 36 28 64 62 2c 7a 53 3Prepare16(db,zS
76e0: 71 6c 2c 6e 42 79 74 65 73 2c 0a 20 20 20 20 20 ql,nBytes,.
76f0: 20 20 20 20 53 51 4c 49 54 45 5f 50 52 45 50 41 SQLITE_PREPA
7700: 52 45 5f 53 41 56 45 53 51 4c 7c 28 70 72 65 70 RE_SAVESQL|(prep
7710: 46 6c 61 67 73 26 53 51 4c 49 54 45 5f 50 52 45 Flags&SQLITE_PRE
7720: 50 41 52 45 5f 4d 41 53 4b 29 2c 0a 20 20 20 20 PARE_MASK),.
7730: 20 20 20 20 20 70 70 53 74 6d 74 2c 70 7a 54 61 ppStmt,pzTa
7740: 69 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 il);. assert( r
7750: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c==SQLITE_OK ||
7760: 70 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 ppStmt==0 || *pp
7770: 53 74 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 Stmt==0 ); /* V
7780: 45 52 49 46 59 3a 20 46 31 33 30 32 31 20 2a 2f ERIFY: F13021 */
7790: 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a . return rc;.}.
77a0: 0a 23 65 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 .#endif /* SQLIT
77b0: 45 5f 4f 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a E_OMIT_UTF16 */.