0000: 2f 2a 0a 2a 2a 20 32 30 30 35 20 4d 61 79 20 32 /*.** 2005 May 2
0010: 35 0a 2a 2a 0a 2a 2a 20 54 68 65 20 61 75 74 68 5.**.** The auth
0020: 6f 72 20 64 69 73 63 6c 61 69 6d 73 20 63 6f 70 or disclaims cop
0030: 79 72 69 67 68 74 20 74 6f 20 74 68 69 73 20 73 yright to this s
0040: 6f 75 72 63 65 20 63 6f 64 65 2e 20 20 49 6e 20 ource code. In
0050: 70 6c 61 63 65 20 6f 66 0a 2a 2a 20 61 20 6c 65 place of.** a le
0060: 67 61 6c 20 6e 6f 74 69 63 65 2c 20 68 65 72 65 gal notice, here
0070: 20 69 73 20 61 20 62 6c 65 73 73 69 6e 67 3a 0a is a blessing:.
0080: 2a 2a 0a 2a 2a 20 20 20 20 4d 61 79 20 79 6f 75 **.** May you
0090: 20 64 6f 20 67 6f 6f 64 20 61 6e 64 20 6e 6f 74 do good and not
00a0: 20 65 76 69 6c 2e 0a 2a 2a 20 20 20 20 4d 61 79 evil..** May
00b0: 20 79 6f 75 20 66 69 6e 64 20 66 6f 72 67 69 76 you find forgiv
00c0: 65 6e 65 73 73 20 66 6f 72 20 79 6f 75 72 73 65 eness for yourse
00d0: 6c 66 20 61 6e 64 20 66 6f 72 67 69 76 65 20 6f lf and forgive o
00e0: 74 68 65 72 73 2e 0a 2a 2a 20 20 20 20 4d 61 79 thers..** May
00f0: 20 79 6f 75 20 73 68 61 72 65 20 66 72 65 65 6c you share freel
0100: 79 2c 20 6e 65 76 65 72 20 74 61 6b 69 6e 67 20 y, never taking
0110: 6d 6f 72 65 20 74 68 61 6e 20 79 6f 75 20 67 69 more than you gi
0120: 76 65 2e 0a 2a 2a 0a 2a 2a 2a 2a 2a 2a 2a 2a 2a ve..**.*********
0130: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0140: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0150: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0160: 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a 2a ****************
0170: 0a 2a 2a 20 54 68 69 73 20 66 69 6c 65 20 63 6f .** This file co
0180: 6e 74 61 69 6e 73 20 74 68 65 20 69 6d 70 6c 65 ntains the imple
0190: 6d 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 mentation of the
01a0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 sqlite3_prepare
01b0: 28 29 0a 2a 2a 20 69 6e 74 65 72 66 61 63 65 2c ().** interface,
01c0: 20 61 6e 64 20 72 6f 75 74 69 6e 65 73 20 74 68 and routines th
01d0: 61 74 20 63 6f 6e 74 72 69 62 75 74 65 20 74 6f at contribute to
01e0: 20 6c 6f 61 64 69 6e 67 20 74 68 65 20 64 61 74 loading the dat
01f0: 61 62 61 73 65 20 73 63 68 65 6d 61 0a 2a 2a 20 abase schema.**
0200: 66 72 6f 6d 20 64 69 73 6b 2e 0a 2a 2f 0a 23 69 from disk..*/.#i
0210: 6e 63 6c 75 64 65 20 22 73 71 6c 69 74 65 49 6e nclude "sqliteIn
0220: 74 2e 68 22 0a 23 69 6e 63 6c 75 64 65 20 22 6c t.h".#include "l
0230: 6f 6f 6b 61 73 69 64 65 2e 68 22 0a 0a 2f 2a 0a ookaside.h"../*.
0240: 2a 2a 20 46 69 6c 6c 20 74 68 65 20 49 6e 69 74 ** Fill the Init
0250: 44 61 74 61 20 73 74 72 75 63 74 75 72 65 20 77 Data structure w
0260: 69 74 68 20 61 6e 20 65 72 72 6f 72 20 6d 65 73 ith an error mes
0270: 73 61 67 65 20 74 68 61 74 20 69 6e 64 69 63 61 sage that indica
0280: 74 65 73 0a 2a 2a 20 74 68 61 74 20 74 68 65 20 tes.** that the
0290: 64 61 74 61 62 61 73 65 20 69 73 20 63 6f 72 72 database is corr
02a0: 75 70 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 76 upt..*/.static v
02b0: 6f 69 64 20 63 6f 72 72 75 70 74 53 63 68 65 6d oid corruptSchem
02c0: 61 28 0a 20 20 49 6e 69 74 44 61 74 61 20 2a 70 a(. InitData *p
02d0: 44 61 74 61 2c 20 20 20 20 20 2f 2a 20 49 6e 69 Data, /* Ini
02e0: 74 69 61 6c 69 7a 61 74 69 6f 6e 20 63 6f 6e 74 tialization cont
02f0: 65 78 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 ext */. const c
0300: 68 61 72 20 2a 7a 4f 62 6a 2c 20 20 20 20 2f 2a har *zObj, /*
0310: 20 4f 62 6a 65 63 74 20 62 65 69 6e 67 20 70 61 Object being pa
0320: 72 73 65 64 20 61 74 20 74 68 65 20 70 6f 69 6e rsed at the poin
0330: 74 20 6f 66 20 65 72 72 6f 72 20 2a 2f 0a 20 20 t of error */.
0340: 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 45 78 74 const char *zExt
0350: 72 61 20 20 20 2f 2a 20 45 72 72 6f 72 20 69 6e ra /* Error in
0360: 66 6f 72 6d 61 74 69 6f 6e 20 2a 2f 0a 29 7b 0a formation */.){.
0370: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 20 3d 20 sqlite3 *db =
0380: 70 44 61 74 61 2d 3e 64 62 3b 0a 20 20 69 66 28 pData->db;. if(
0390: 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
03a0: 64 20 29 7b 0a 20 20 20 20 70 44 61 74 61 2d 3e d ){. pData->
03b0: 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f 4d 45 rc = SQLITE_NOME
03c0: 4d 5f 42 4b 50 54 3b 0a 20 20 7d 65 6c 73 65 20 M_BKPT;. }else
03d0: 69 66 28 20 70 44 61 74 61 2d 3e 70 7a 45 72 72 if( pData->pzErr
03e0: 4d 73 67 5b 30 5d 21 3d 30 20 29 7b 0a 20 20 20 Msg[0]!=0 ){.
03f0: 20 2f 2a 20 41 20 65 72 72 6f 72 20 6d 65 73 73 /* A error mess
0400: 61 67 65 20 68 61 73 20 61 6c 72 65 61 64 79 20 age has already
0410: 62 65 65 6e 20 67 65 6e 65 72 61 74 65 64 2e 20 been generated.
0420: 20 44 6f 20 6e 6f 74 20 6f 76 65 72 77 72 69 74 Do not overwrit
0430: 65 20 69 74 20 2a 2f 0a 20 20 7d 65 6c 73 65 20 e it */. }else
0440: 69 66 28 20 70 44 61 74 61 2d 3e 6d 49 6e 69 74 if( pData->mInit
0450: 46 6c 61 67 73 20 26 20 49 4e 49 54 46 4c 41 47 Flags & INITFLAG
0460: 5f 41 6c 74 65 72 54 61 62 6c 65 20 29 7b 0a 20 _AlterTable ){.
0470: 20 20 20 2a 70 44 61 74 61 2d 3e 70 7a 45 72 72 *pData->pzErr
0480: 4d 73 67 20 3d 20 73 71 6c 69 74 65 33 44 62 53 Msg = sqlite3DbS
0490: 74 72 44 75 70 28 64 62 2c 20 7a 45 78 74 72 61 trDup(db, zExtra
04a0: 29 3b 0a 20 20 20 20 70 44 61 74 61 2d 3e 72 63 );. pData->rc
04b0: 20 3d 20 53 51 4c 49 54 45 5f 45 52 52 4f 52 3b = SQLITE_ERROR;
04c0: 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 64 62 2d . }else if( db-
04d0: 3e 66 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f >flags & SQLITE_
04e0: 57 72 69 74 65 53 63 68 65 6d 61 20 29 7b 0a 20 WriteSchema ){.
04f0: 20 20 20 70 44 61 74 61 2d 3e 72 63 20 3d 20 53 pData->rc = S
0500: 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 5f 42 4b QLITE_CORRUPT_BK
0510: 50 54 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 PT;. }else{.
0520: 20 63 68 61 72 20 2a 7a 3b 0a 20 20 20 20 69 66 char *z;. if
0530: 28 20 7a 4f 62 6a 3d 3d 30 20 29 20 7a 4f 62 6a ( zObj==0 ) zObj
0540: 20 3d 20 22 3f 22 3b 0a 20 20 20 20 7a 20 3d 20 = "?";. z =
0550: 73 71 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 sqlite3MPrintf(d
0560: 62 2c 20 22 6d 61 6c 66 6f 72 6d 65 64 20 64 61 b, "malformed da
0570: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 28 25 tabase schema (%
0580: 73 29 22 2c 20 7a 4f 62 6a 29 3b 0a 20 20 20 20 s)", zObj);.
0590: 69 66 28 20 7a 45 78 74 72 61 20 26 26 20 7a 45 if( zExtra && zE
05a0: 78 74 72 61 5b 30 5d 20 29 20 7a 20 3d 20 73 71 xtra[0] ) z = sq
05b0: 6c 69 74 65 33 4d 50 72 69 6e 74 66 28 64 62 2c lite3MPrintf(db,
05c0: 20 22 25 7a 20 2d 20 25 73 22 2c 20 7a 2c 20 7a "%z - %s", z, z
05d0: 45 78 74 72 61 29 3b 0a 20 20 20 20 2a 70 44 61 Extra);. *pDa
05e0: 74 61 2d 3e 70 7a 45 72 72 4d 73 67 20 3d 20 7a ta->pzErrMsg = z
05f0: 3b 0a 20 20 20 20 70 44 61 74 61 2d 3e 72 63 20 ;. pData->rc
0600: 3d 20 53 51 4c 49 54 45 5f 43 4f 52 52 55 50 54 = SQLITE_CORRUPT
0610: 5f 42 4b 50 54 3b 0a 20 20 7d 0a 7d 0a 0a 2f 2a _BKPT;. }.}../*
0620: 0a 2a 2a 20 43 68 65 63 6b 20 74 6f 20 73 65 65 .** Check to see
0630: 20 69 66 20 61 6e 79 20 73 69 62 6c 69 6e 67 20 if any sibling
0640: 69 6e 64 65 78 20 28 61 6e 6f 74 68 65 72 20 69 index (another i
0650: 6e 64 65 78 20 6f 6e 20 74 68 65 20 73 61 6d 65 ndex on the same
0660: 20 74 61 62 6c 65 29 0a 2a 2a 20 6f 66 20 70 49 table).** of pI
0670: 6e 64 65 78 20 68 61 73 20 74 68 65 20 73 61 6d ndex has the sam
0680: 65 20 72 6f 6f 74 20 70 61 67 65 20 6e 75 6d 62 e root page numb
0690: 65 72 2c 20 61 6e 64 20 69 66 20 69 74 20 64 6f er, and if it do
06a0: 65 73 2c 20 72 65 74 75 72 6e 20 74 72 75 65 2e es, return true.
06b0: 0a 2a 2a 20 54 68 69 73 20 77 6f 75 6c 64 20 69 .** This would i
06c0: 6e 64 69 63 61 74 65 20 61 20 63 6f 72 72 75 70 ndicate a corrup
06d0: 74 20 73 63 68 65 6d 61 2e 0a 2a 2f 0a 69 6e 74 t schema..*/.int
06e0: 20 73 71 6c 69 74 65 33 49 6e 64 65 78 48 61 73 sqlite3IndexHas
06f0: 44 75 70 6c 69 63 61 74 65 52 6f 6f 74 50 61 67 DuplicateRootPag
0700: 65 28 49 6e 64 65 78 20 2a 70 49 6e 64 65 78 29 e(Index *pIndex)
0710: 7b 0a 20 20 49 6e 64 65 78 20 2a 70 3b 0a 20 20 {. Index *p;.
0720: 66 6f 72 28 70 3d 70 49 6e 64 65 78 2d 3e 70 54 for(p=pIndex->pT
0730: 61 62 6c 65 2d 3e 70 49 6e 64 65 78 3b 20 70 3b able->pIndex; p;
0740: 20 70 3d 70 2d 3e 70 4e 65 78 74 29 7b 0a 20 20 p=p->pNext){.
0750: 20 20 69 66 28 20 70 2d 3e 74 6e 75 6d 3d 3d 70 if( p->tnum==p
0760: 49 6e 64 65 78 2d 3e 74 6e 75 6d 20 26 26 20 70 Index->tnum && p
0770: 21 3d 70 49 6e 64 65 78 20 29 20 72 65 74 75 72 !=pIndex ) retur
0780: 6e 20 31 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 n 1;. }. retur
0790: 6e 20 30 3b 0a 7d 0a 0a 2f 2a 20 66 6f 72 77 61 n 0;.}../* forwa
07a0: 72 64 20 64 65 63 6c 61 72 61 74 69 6f 6e 20 2a rd declaration *
07b0: 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c /.static int sql
07c0: 69 74 65 33 50 72 65 70 61 72 65 28 0a 20 20 73 ite3Prepare(. s
07d0: 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 20 qlite3 *db,
07e0: 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 61 /* Data
07f0: 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a base handle. */.
0800: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a 53 const char *zS
0810: 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 55 ql, /* U
0820: 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 4c TF-8 encoded SQL
0830: 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 statement. */.
0840: 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 20 int nBytes,
0850: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c 65 /* Le
0860: 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e 20 ngth of zSql in
0870: 62 79 74 65 73 2e 20 2a 2f 0a 20 20 75 33 32 20 bytes. */. u32
0880: 70 72 65 70 46 6c 61 67 73 2c 20 20 20 20 20 20 prepFlags,
0890: 20 20 20 20 20 20 2f 2a 20 5a 65 72 6f 20 6f 72 /* Zero or
08a0: 20 6d 6f 72 65 20 53 51 4c 49 54 45 5f 50 52 45 more SQLITE_PRE
08b0: 50 41 52 45 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a PARE_* flags */.
08c0: 20 20 56 64 62 65 20 2a 70 52 65 70 72 65 70 61 Vdbe *pReprepa
08d0: 72 65 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 56 re, /* V
08e0: 4d 20 62 65 69 6e 67 20 72 65 70 72 65 70 61 72 M being reprepar
08f0: 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f ed */. sqlite3_
0900: 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 stmt **ppStmt,
0910: 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e /* OUT: A poin
0920: 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61 ter to the prepa
0930: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f red statement */
0940: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a . const char **
0950: 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 pzTail /*
0960: 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 OUT: End of pars
0970: 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 3b 0a ed string */.);.
0980: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 ../*.** This is
0990: 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 the callback rou
09a0: 74 69 6e 65 20 66 6f 72 20 74 68 65 20 63 6f 64 tine for the cod
09b0: 65 20 74 68 61 74 20 69 6e 69 74 69 61 6c 69 7a e that initializ
09c0: 65 73 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 es the.** databa
09d0: 73 65 2e 20 20 53 65 65 20 73 71 6c 69 74 65 33 se. See sqlite3
09e0: 49 6e 69 74 28 29 20 62 65 6c 6f 77 20 66 6f 72 Init() below for
09f0: 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f additional info
0a00: 72 6d 61 74 69 6f 6e 2e 0a 2a 2a 20 54 68 69 73 rmation..** This
0a10: 20 72 6f 75 74 69 6e 65 20 69 73 20 61 6c 73 6f routine is also
0a20: 20 63 61 6c 6c 65 64 20 66 72 6f 6d 20 74 68 65 called from the
0a30: 20 4f 50 5f 50 61 72 73 65 53 63 68 65 6d 61 20 OP_ParseSchema
0a40: 6f 70 63 6f 64 65 20 6f 66 20 74 68 65 20 56 44 opcode of the VD
0a50: 42 45 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 68 20 63 BE..**.** Each c
0a60: 61 6c 6c 62 61 63 6b 20 63 6f 6e 74 61 69 6e 73 allback contains
0a70: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 69 the following i
0a80: 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a 2a 0a 2a nformation:.**.*
0a90: 2a 20 20 20 20 20 61 72 67 76 5b 30 5d 20 3d 20 * argv[0] =
0aa0: 74 79 70 65 20 6f 66 20 6f 62 6a 65 63 74 3a 20 type of object:
0ab0: 22 74 61 62 6c 65 22 2c 20 22 69 6e 64 65 78 22 "table", "index"
0ac0: 2c 20 22 74 72 69 67 67 65 72 22 2c 20 6f 72 20 , "trigger", or
0ad0: 22 76 69 65 77 22 2e 0a 2a 2a 20 20 20 20 20 61 "view"..** a
0ae0: 72 67 76 5b 31 5d 20 3d 20 6e 61 6d 65 20 6f 66 rgv[1] = name of
0af0: 20 74 68 69 6e 67 20 62 65 69 6e 67 20 63 72 65 thing being cre
0b00: 61 74 65 64 0a 2a 2a 20 20 20 20 20 61 72 67 76 ated.** argv
0b10: 5b 32 5d 20 3d 20 61 73 73 6f 63 69 61 74 65 64 [2] = associated
0b20: 20 74 61 62 6c 65 20 69 66 20 61 6e 20 69 6e 64 table if an ind
0b30: 65 78 20 6f 72 20 74 72 69 67 67 65 72 0a 2a 2a ex or trigger.**
0b40: 20 20 20 20 20 61 72 67 76 5b 33 5d 20 3d 20 72 argv[3] = r
0b50: 6f 6f 74 20 70 61 67 65 20 6e 75 6d 62 65 72 20 oot page number
0b60: 66 6f 72 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 for table or ind
0b70: 65 78 2e 20 30 20 66 6f 72 20 74 72 69 67 67 65 ex. 0 for trigge
0b80: 72 20 6f 72 20 76 69 65 77 2e 0a 2a 2a 20 20 20 r or view..**
0b90: 20 20 61 72 67 76 5b 34 5d 20 3d 20 53 51 4c 20 argv[4] = SQL
0ba0: 74 65 78 74 20 66 6f 72 20 74 68 65 20 43 52 45 text for the CRE
0bb0: 41 54 45 20 73 74 61 74 65 6d 65 6e 74 2e 0a 2a ATE statement..*
0bc0: 2a 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 *.*/.int sqlite3
0bd0: 49 6e 69 74 43 61 6c 6c 62 61 63 6b 28 76 6f 69 InitCallback(voi
0be0: 64 20 2a 70 49 6e 69 74 2c 20 69 6e 74 20 61 72 d *pInit, int ar
0bf0: 67 63 2c 20 63 68 61 72 20 2a 2a 61 72 67 76 2c gc, char **argv,
0c00: 20 63 68 61 72 20 2a 2a 4e 6f 74 55 73 65 64 29 char **NotUsed)
0c10: 7b 0a 20 20 49 6e 69 74 44 61 74 61 20 2a 70 44 {. InitData *pD
0c20: 61 74 61 20 3d 20 28 49 6e 69 74 44 61 74 61 2a ata = (InitData*
0c30: 29 70 49 6e 69 74 3b 0a 20 20 73 71 6c 69 74 65 )pInit;. sqlite
0c40: 33 20 2a 64 62 20 3d 20 70 44 61 74 61 2d 3e 64 3 *db = pData->d
0c50: 62 3b 0a 20 20 69 6e 74 20 69 44 62 20 3d 20 70 b;. int iDb = p
0c60: 44 61 74 61 2d 3e 69 44 62 3b 0a 0a 20 20 61 73 Data->iDb;.. as
0c70: 73 65 72 74 28 20 61 72 67 63 3d 3d 35 20 29 3b sert( argc==5 );
0c80: 0a 20 20 55 4e 55 53 45 44 5f 50 41 52 41 4d 45 . UNUSED_PARAME
0c90: 54 45 52 32 28 4e 6f 74 55 73 65 64 2c 20 61 72 TER2(NotUsed, ar
0ca0: 67 63 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 gc);. assert( s
0cb0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
0cc0: 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a d(db->mutex) );.
0cd0: 20 20 44 62 43 6c 65 61 72 50 72 6f 70 65 72 74 DbClearPropert
0ce0: 79 28 64 62 2c 20 69 44 62 2c 20 44 42 5f 45 6d y(db, iDb, DB_Em
0cf0: 70 74 79 29 3b 0a 20 20 70 44 61 74 61 2d 3e 6e pty);. pData->n
0d00: 49 6e 69 74 52 6f 77 2b 2b 3b 0a 20 20 69 66 28 InitRow++;. if(
0d10: 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
0d20: 64 20 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 d ){. corrupt
0d30: 53 63 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 Schema(pData, ar
0d40: 67 76 5b 31 5d 2c 20 30 29 3b 0a 20 20 20 20 72 gv[1], 0);. r
0d50: 65 74 75 72 6e 20 31 3b 0a 20 20 7d 0a 0a 20 20 eturn 1;. }..
0d60: 61 73 73 65 72 74 28 20 69 44 62 3e 3d 30 20 26 assert( iDb>=0 &
0d70: 26 20 69 44 62 3c 64 62 2d 3e 6e 44 62 20 29 3b & iDb<db->nDb );
0d80: 0a 20 20 69 66 28 20 61 72 67 76 3d 3d 30 20 29 . if( argv==0 )
0d90: 20 72 65 74 75 72 6e 20 30 3b 20 20 20 2f 2a 20 return 0; /*
0da0: 4d 69 67 68 74 20 68 61 70 70 65 6e 20 69 66 20 Might happen if
0db0: 45 4d 50 54 59 5f 52 45 53 55 4c 54 5f 43 41 4c EMPTY_RESULT_CAL
0dc0: 4c 42 41 43 4b 53 20 61 72 65 20 6f 6e 20 2a 2f LBACKS are on */
0dd0: 0a 20 20 69 66 28 20 61 72 67 76 5b 33 5d 3d 3d . if( argv[3]==
0de0: 30 20 29 7b 0a 20 20 20 20 63 6f 72 72 75 70 74 0 ){. corrupt
0df0: 53 63 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 Schema(pData, ar
0e00: 67 76 5b 31 5d 2c 20 30 29 3b 0a 20 20 7d 65 6c gv[1], 0);. }el
0e10: 73 65 20 69 66 28 20 73 71 6c 69 74 65 33 5f 73 se if( sqlite3_s
0e20: 74 72 6e 69 63 6d 70 28 61 72 67 76 5b 34 5d 2c trnicmp(argv[4],
0e30: 22 63 72 65 61 74 65 20 22 2c 37 29 3d 3d 30 20 "create ",7)==0
0e40: 29 7b 0a 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74 ){. /* Call t
0e50: 68 65 20 70 61 72 73 65 72 20 74 6f 20 70 72 6f he parser to pro
0e60: 63 65 73 73 20 61 20 43 52 45 41 54 45 20 54 41 cess a CREATE TA
0e70: 42 4c 45 2c 20 49 4e 44 45 58 20 6f 72 20 56 49 BLE, INDEX or VI
0e80: 45 57 2e 0a 20 20 20 20 2a 2a 20 42 75 74 20 62 EW.. ** But b
0e90: 65 63 61 75 73 65 20 64 62 2d 3e 69 6e 69 74 2e ecause db->init.
0ea0: 62 75 73 79 20 69 73 20 73 65 74 20 74 6f 20 31 busy is set to 1
0eb0: 2c 20 6e 6f 20 56 44 42 45 20 63 6f 64 65 20 69 , no VDBE code i
0ec0: 73 20 67 65 6e 65 72 61 74 65 64 0a 20 20 20 20 s generated.
0ed0: 2a 2a 20 6f 72 20 65 78 65 63 75 74 65 64 2e 20 ** or executed.
0ee0: 20 41 6c 6c 20 74 68 65 20 70 61 72 73 65 72 20 All the parser
0ef0: 64 6f 65 73 20 69 73 20 62 75 69 6c 64 20 74 68 does is build th
0f00: 65 20 69 6e 74 65 72 6e 61 6c 20 64 61 74 61 0a e internal data.
0f10: 20 20 20 20 2a 2a 20 73 74 72 75 63 74 75 72 65 ** structure
0f20: 73 20 74 68 61 74 20 64 65 73 63 72 69 62 65 20 s that describe
0f30: 74 68 65 20 74 61 62 6c 65 2c 20 69 6e 64 65 78 the table, index
0f40: 2c 20 6f 72 20 76 69 65 77 2e 0a 20 20 20 20 2a , or view.. *
0f50: 2f 0a 20 20 20 20 69 6e 74 20 72 63 3b 0a 20 20 /. int rc;.
0f60: 20 20 75 38 20 73 61 76 65 64 5f 69 44 62 20 3d u8 saved_iDb =
0f70: 20 64 62 2d 3e 69 6e 69 74 2e 69 44 62 3b 0a 20 db->init.iDb;.
0f80: 20 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 sqlite3_stmt
0f90: 2a 70 53 74 6d 74 3b 0a 20 20 20 20 54 45 53 54 *pStmt;. TEST
0fa0: 4f 4e 4c 59 28 69 6e 74 20 72 63 70 29 3b 20 20 ONLY(int rcp);
0fb0: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 52 65 74 /* Ret
0fc0: 75 72 6e 20 63 6f 64 65 20 66 72 6f 6d 20 73 71 urn code from sq
0fd0: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 20 lite3_prepare()
0fe0: 2a 2f 0a 0a 20 20 20 20 61 73 73 65 72 74 28 20 */.. assert(
0ff0: 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 29 3b db->init.busy );
1000: 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e 69 44 . db->init.iD
1010: 62 20 3d 20 69 44 62 3b 0a 20 20 20 20 64 62 2d b = iDb;. db-
1020: 3e 69 6e 69 74 2e 6e 65 77 54 6e 75 6d 20 3d 20 >init.newTnum =
1030: 73 71 6c 69 74 65 33 41 74 6f 69 28 61 72 67 76 sqlite3Atoi(argv
1040: 5b 33 5d 29 3b 0a 20 20 20 20 64 62 2d 3e 69 6e [3]);. db->in
1050: 69 74 2e 6f 72 70 68 61 6e 54 72 69 67 67 65 72 it.orphanTrigger
1060: 20 3d 20 30 3b 0a 20 20 20 20 64 62 2d 3e 69 6e = 0;. db->in
1070: 69 74 2e 61 7a 49 6e 69 74 20 3d 20 61 72 67 76 it.azInit = argv
1080: 3b 0a 20 20 20 20 70 53 74 6d 74 20 3d 20 30 3b ;. pStmt = 0;
1090: 0a 20 20 20 20 54 45 53 54 4f 4e 4c 59 28 72 63 . TESTONLY(rc
10a0: 70 20 3d 20 29 20 73 71 6c 69 74 65 33 50 72 65 p = ) sqlite3Pre
10b0: 70 61 72 65 28 64 62 2c 20 61 72 67 76 5b 34 5d pare(db, argv[4]
10c0: 2c 20 2d 31 2c 20 30 2c 20 30 2c 20 26 70 53 74 , -1, 0, 0, &pSt
10d0: 6d 74 2c 20 30 29 3b 0a 20 20 20 20 72 63 20 3d mt, 0);. rc =
10e0: 20 64 62 2d 3e 65 72 72 43 6f 64 65 3b 0a 20 20 db->errCode;.
10f0: 20 20 61 73 73 65 72 74 28 20 28 72 63 26 30 78 assert( (rc&0x
1100: 46 46 29 3d 3d 28 72 63 70 26 30 78 46 46 29 20 FF)==(rcp&0xFF)
1110: 29 3b 0a 20 20 20 20 64 62 2d 3e 69 6e 69 74 2e );. db->init.
1120: 69 44 62 20 3d 20 73 61 76 65 64 5f 69 44 62 3b iDb = saved_iDb;
1130: 0a 20 20 20 20 2f 2a 20 61 73 73 65 72 74 28 20 . /* assert(
1140: 73 61 76 65 64 5f 69 44 62 3d 3d 30 20 7c 7c 20 saved_iDb==0 ||
1150: 28 64 62 2d 3e 6d 44 62 46 6c 61 67 73 20 26 20 (db->mDbFlags &
1160: 44 42 46 4c 41 47 5f 56 61 63 75 75 6d 29 21 3d DBFLAG_Vacuum)!=
1170: 30 20 29 3b 20 2a 2f 0a 20 20 20 20 69 66 28 20 0 ); */. if(
1180: 53 51 4c 49 54 45 5f 4f 4b 21 3d 72 63 20 29 7b SQLITE_OK!=rc ){
1190: 0a 20 20 20 20 20 20 69 66 28 20 64 62 2d 3e 69 . if( db->i
11a0: 6e 69 74 2e 6f 72 70 68 61 6e 54 72 69 67 67 65 nit.orphanTrigge
11b0: 72 20 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 r ){. ass
11c0: 65 72 74 28 20 69 44 62 3d 3d 31 20 29 3b 0a 20 ert( iDb==1 );.
11d0: 20 20 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 }else{.
11e0: 20 20 20 20 69 66 28 20 72 63 20 3e 20 70 44 61 if( rc > pDa
11f0: 74 61 2d 3e 72 63 20 29 20 70 44 61 74 61 2d 3e ta->rc ) pData->
1200: 72 63 20 3d 20 72 63 3b 0a 20 20 20 20 20 20 20 rc = rc;.
1210: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
1220: 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 20 NOMEM ){.
1230: 20 20 20 73 71 6c 69 74 65 33 4f 6f 6d 46 61 75 sqlite3OomFau
1240: 6c 74 28 64 62 29 3b 0a 20 20 20 20 20 20 20 20 lt(db);.
1250: 7d 65 6c 73 65 20 69 66 28 20 72 63 21 3d 53 51 }else if( rc!=SQ
1260: 4c 49 54 45 5f 49 4e 54 45 52 52 55 50 54 20 26 LITE_INTERRUPT &
1270: 26 20 28 72 63 26 30 78 46 46 29 21 3d 53 51 4c & (rc&0xFF)!=SQL
1280: 49 54 45 5f 4c 4f 43 4b 45 44 20 29 7b 0a 20 20 ITE_LOCKED ){.
1290: 20 20 20 20 20 20 20 20 63 6f 72 72 75 70 74 53 corruptS
12a0: 63 68 65 6d 61 28 70 44 61 74 61 2c 20 61 72 67 chema(pData, arg
12b0: 76 5b 31 5d 2c 20 73 71 6c 69 74 65 33 5f 65 72 v[1], sqlite3_er
12c0: 72 6d 73 67 28 64 62 29 29 3b 0a 20 20 20 20 20 rmsg(db));.
12d0: 20 20 20 7d 0a 20 20 20 20 20 20 7d 0a 20 20 20 }. }.
12e0: 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 5f 66 }. sqlite3_f
12f0: 69 6e 61 6c 69 7a 65 28 70 53 74 6d 74 29 3b 0a inalize(pStmt);.
1300: 20 20 7d 65 6c 73 65 20 69 66 28 20 61 72 67 76 }else if( argv
1310: 5b 31 5d 3d 3d 30 20 7c 7c 20 28 61 72 67 76 5b [1]==0 || (argv[
1320: 34 5d 21 3d 30 20 26 26 20 61 72 67 76 5b 34 5d 4]!=0 && argv[4]
1330: 5b 30 5d 21 3d 30 29 20 29 7b 0a 20 20 20 20 63 [0]!=0) ){. c
1340: 6f 72 72 75 70 74 53 63 68 65 6d 61 28 70 44 61 orruptSchema(pDa
1350: 74 61 2c 20 61 72 67 76 5b 31 5d 2c 20 30 29 3b ta, argv[1], 0);
1360: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2f 2a . }else{. /*
1370: 20 49 66 20 74 68 65 20 53 51 4c 20 63 6f 6c 75 If the SQL colu
1380: 6d 6e 20 69 73 20 62 6c 61 6e 6b 20 69 74 20 6d mn is blank it m
1390: 65 61 6e 73 20 74 68 69 73 20 69 73 20 61 6e 20 eans this is an
13a0: 69 6e 64 65 78 20 74 68 61 74 0a 20 20 20 20 2a index that. *
13b0: 2a 20 77 61 73 20 63 72 65 61 74 65 64 20 74 6f * was created to
13c0: 20 62 65 20 74 68 65 20 50 52 49 4d 41 52 59 20 be the PRIMARY
13d0: 4b 45 59 20 6f 72 20 74 6f 20 66 75 6c 66 69 6c KEY or to fulfil
13e0: 6c 20 61 20 55 4e 49 51 55 45 0a 20 20 20 20 2a l a UNIQUE. *
13f0: 2a 20 63 6f 6e 73 74 72 61 69 6e 74 20 66 6f 72 * constraint for
1400: 20 61 20 43 52 45 41 54 45 20 54 41 42 4c 45 2e a CREATE TABLE.
1410: 20 20 54 68 65 20 69 6e 64 65 78 20 73 68 6f 75 The index shou
1420: 6c 64 20 68 61 76 65 20 61 6c 72 65 61 64 79 0a ld have already.
1430: 20 20 20 20 2a 2a 20 62 65 65 6e 20 63 72 65 61 ** been crea
1440: 74 65 64 20 77 68 65 6e 20 77 65 20 70 72 6f 63 ted when we proc
1450: 65 73 73 65 64 20 74 68 65 20 43 52 45 41 54 45 essed the CREATE
1460: 20 54 41 42 4c 45 2e 20 20 41 6c 6c 20 77 65 20 TABLE. All we
1470: 68 61 76 65 0a 20 20 20 20 2a 2a 20 74 6f 20 64 have. ** to d
1480: 6f 20 68 65 72 65 20 69 73 20 72 65 63 6f 72 64 o here is record
1490: 20 74 68 65 20 72 6f 6f 74 20 70 61 67 65 20 6e the root page n
14a0: 75 6d 62 65 72 20 66 6f 72 20 74 68 61 74 20 69 umber for that i
14b0: 6e 64 65 78 2e 0a 20 20 20 20 2a 2f 0a 20 20 20 ndex.. */.
14c0: 20 49 6e 64 65 78 20 2a 70 49 6e 64 65 78 3b 0a Index *pIndex;.
14d0: 20 20 20 20 70 49 6e 64 65 78 20 3d 20 73 71 6c pIndex = sql
14e0: 69 74 65 33 46 69 6e 64 49 6e 64 65 78 28 64 62 ite3FindIndex(db
14f0: 2c 20 61 72 67 76 5b 31 5d 2c 20 64 62 2d 3e 61 , argv[1], db->a
1500: 44 62 5b 69 44 62 5d 2e 7a 44 62 53 4e 61 6d 65 Db[iDb].zDbSName
1510: 29 3b 0a 20 20 20 20 69 66 28 20 70 49 6e 64 65 );. if( pInde
1520: 78 3d 3d 30 0a 20 20 20 20 20 7c 7c 20 73 71 6c x==0. || sql
1530: 69 74 65 33 47 65 74 49 6e 74 33 32 28 61 72 67 ite3GetInt32(arg
1540: 76 5b 33 5d 2c 26 70 49 6e 64 65 78 2d 3e 74 6e v[3],&pIndex->tn
1550: 75 6d 29 3d 3d 30 0a 20 20 20 20 20 7c 7c 20 70 um)==0. || p
1560: 49 6e 64 65 78 2d 3e 74 6e 75 6d 3c 32 0a 20 20 Index->tnum<2.
1570: 20 20 20 7c 7c 20 73 71 6c 69 74 65 33 49 6e 64 || sqlite3Ind
1580: 65 78 48 61 73 44 75 70 6c 69 63 61 74 65 52 6f exHasDuplicateRo
1590: 6f 74 50 61 67 65 28 70 49 6e 64 65 78 29 0a 20 otPage(pIndex).
15a0: 20 20 20 29 7b 0a 20 20 20 20 20 20 63 6f 72 72 ){. corr
15b0: 75 70 74 53 63 68 65 6d 61 28 70 44 61 74 61 2c uptSchema(pData,
15c0: 20 61 72 67 76 5b 31 5d 2c 20 70 49 6e 64 65 78 argv[1], pIndex
15d0: 3f 22 69 6e 76 61 6c 69 64 20 72 6f 6f 74 70 61 ?"invalid rootpa
15e0: 67 65 22 3a 22 6f 72 70 68 61 6e 20 69 6e 64 65 ge":"orphan inde
15f0: 78 22 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 x");. }. }.
1600: 20 72 65 74 75 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a return 0;.}../*
1610: 0a 2a 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 72 .** Attempt to r
1620: 65 61 64 20 74 68 65 20 64 61 74 61 62 61 73 65 ead the database
1630: 20 73 63 68 65 6d 61 20 61 6e 64 20 69 6e 69 74 schema and init
1640: 69 61 6c 69 7a 65 20 69 6e 74 65 72 6e 61 6c 0a ialize internal.
1650: 2a 2a 20 64 61 74 61 20 73 74 72 75 63 74 75 72 ** data structur
1660: 65 73 20 66 6f 72 20 61 20 73 69 6e 67 6c 65 20 es for a single
1670: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2e 20 20 database file.
1680: 54 68 65 20 69 6e 64 65 78 20 6f 66 20 74 68 65 The index of the
1690: 0a 2a 2a 20 64 61 74 61 62 61 73 65 20 66 69 6c .** database fil
16a0: 65 20 69 73 20 67 69 76 65 6e 20 62 79 20 69 44 e is given by iD
16b0: 62 2e 20 20 69 44 62 3d 3d 30 20 69 73 20 75 73 b. iDb==0 is us
16c0: 65 64 20 66 6f 72 20 74 68 65 20 6d 61 69 6e 0a ed for the main.
16d0: 2a 2a 20 64 61 74 61 62 61 73 65 2e 20 20 69 44 ** database. iD
16e0: 62 3d 3d 31 20 73 68 6f 75 6c 64 20 6e 65 76 65 b==1 should neve
16f0: 72 20 62 65 20 75 73 65 64 2e 20 20 69 44 62 3e r be used. iDb>
1700: 3d 32 20 69 73 20 75 73 65 64 20 66 6f 72 0a 2a =2 is used for.*
1710: 2a 20 61 75 78 69 6c 69 61 72 79 20 64 61 74 61 * auxiliary data
1720: 62 61 73 65 73 2e 20 20 52 65 74 75 72 6e 20 6f bases. Return o
1730: 6e 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45 ne of the SQLITE
1740: 5f 20 65 72 72 6f 72 20 63 6f 64 65 73 20 74 6f _ error codes to
1750: 0a 2a 2a 20 69 6e 64 69 63 61 74 65 20 73 75 63 .** indicate suc
1760: 63 65 73 73 20 6f 72 20 66 61 69 6c 75 72 65 2e cess or failure.
1770: 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 33 49 .*/.int sqlite3I
1780: 6e 69 74 4f 6e 65 28 73 71 6c 69 74 65 33 20 2a nitOne(sqlite3 *
1790: 64 62 2c 20 69 6e 74 20 69 44 62 2c 20 63 68 61 db, int iDb, cha
17a0: 72 20 2a 2a 70 7a 45 72 72 4d 73 67 2c 20 75 33 r **pzErrMsg, u3
17b0: 32 20 6d 46 6c 61 67 73 29 7b 0a 20 20 69 6e 74 2 mFlags){. int
17c0: 20 72 63 3b 0a 20 20 69 6e 74 20 69 3b 0a 23 69 rc;. int i;.#i
17d0: 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d 49 fndef SQLITE_OMI
17e0: 54 5f 44 45 50 52 45 43 41 54 45 44 0a 20 20 69 T_DEPRECATED. i
17f0: 6e 74 20 73 69 7a 65 3b 0a 23 65 6e 64 69 66 0a nt size;.#endif.
1800: 20 20 44 62 20 2a 70 44 62 3b 0a 20 20 63 68 61 Db *pDb;. cha
1810: 72 20 63 6f 6e 73 74 20 2a 61 7a 41 72 67 5b 36 r const *azArg[6
1820: 5d 3b 0a 20 20 69 6e 74 20 6d 65 74 61 5b 35 5d ];. int meta[5]
1830: 3b 0a 20 20 49 6e 69 74 44 61 74 61 20 69 6e 69 ;. InitData ini
1840: 74 44 61 74 61 3b 0a 20 20 63 6f 6e 73 74 20 63 tData;. const c
1850: 68 61 72 20 2a 7a 4d 61 73 74 65 72 4e 61 6d 65 har *zMasterName
1860: 3b 0a 20 20 69 6e 74 20 6f 70 65 6e 65 64 54 72 ;. int openedTr
1870: 61 6e 73 61 63 74 69 6f 6e 20 3d 20 30 3b 0a 0a ansaction = 0;..
1880: 20 20 61 73 73 65 72 74 28 20 28 64 62 2d 3e 6d assert( (db->m
1890: 44 62 46 6c 61 67 73 20 26 20 44 42 46 4c 41 47 DbFlags & DBFLAG
18a0: 5f 53 63 68 65 6d 61 4b 6e 6f 77 6e 4f 6b 29 3d _SchemaKnownOk)=
18b0: 3d 30 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 =0 );. assert(
18c0: 69 44 62 3e 3d 30 20 26 26 20 69 44 62 3c 64 62 iDb>=0 && iDb<db
18d0: 2d 3e 6e 44 62 20 29 3b 0a 20 20 61 73 73 65 72 ->nDb );. asser
18e0: 74 28 20 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e t( db->aDb[iDb].
18f0: 70 53 63 68 65 6d 61 20 29 3b 0a 20 20 61 73 73 pSchema );. ass
1900: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
1910: 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 ex_held(db->mute
1920: 78 29 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 x) );. assert(
1930: 69 44 62 3d 3d 31 20 7c 7c 20 73 71 6c 69 74 65 iDb==1 || sqlite
1940: 33 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 3BtreeHoldsMutex
1950: 28 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 (db->aDb[iDb].pB
1960: 74 29 20 29 3b 0a 0a 20 20 64 62 2d 3e 69 6e 69 t) );.. db->ini
1970: 74 2e 62 75 73 79 20 3d 20 31 3b 0a 0a 20 20 2f t.busy = 1;.. /
1980: 2a 20 43 6f 6e 73 74 72 75 63 74 20 74 68 65 20 * Construct the
1990: 69 6e 2d 6d 65 6d 6f 72 79 20 72 65 70 72 65 73 in-memory repres
19a0: 65 6e 74 61 74 69 6f 6e 20 73 63 68 65 6d 61 20 entation schema
19b0: 74 61 62 6c 65 73 20 28 73 71 6c 69 74 65 5f 6d tables (sqlite_m
19c0: 61 73 74 65 72 20 6f 72 0a 20 20 2a 2a 20 73 71 aster or. ** sq
19d0: 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 lite_temp_master
19e0: 29 20 62 79 20 69 6e 76 6f 6b 69 6e 67 20 74 68 ) by invoking th
19f0: 65 20 70 61 72 73 65 72 20 64 69 72 65 63 74 6c e parser directl
1a00: 79 2e 20 20 54 68 65 20 61 70 70 72 6f 70 72 69 y. The appropri
1a10: 61 74 65 0a 20 20 2a 2a 20 74 61 62 6c 65 20 6e ate. ** table n
1a20: 61 6d 65 20 77 69 6c 6c 20 62 65 20 69 6e 73 65 ame will be inse
1a30: 72 74 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c rted automatical
1a40: 6c 79 20 62 79 20 74 68 65 20 70 61 72 73 65 72 ly by the parser
1a50: 20 73 6f 20 77 65 20 63 61 6e 20 6a 75 73 74 0a so we can just.
1a60: 20 20 2a 2a 20 75 73 65 20 74 68 65 20 61 62 62 ** use the abb
1a70: 72 65 76 69 61 74 69 6f 6e 20 22 78 22 20 68 65 reviation "x" he
1a80: 72 65 2e 20 20 54 68 65 20 70 61 72 73 65 72 20 re. The parser
1a90: 77 69 6c 6c 20 61 6c 73 6f 20 61 75 74 6f 6d 61 will also automa
1aa0: 74 69 63 61 6c 6c 79 20 74 61 67 0a 20 20 2a 2a tically tag. **
1ab0: 20 74 68 65 20 73 63 68 65 6d 61 20 74 61 62 6c the schema tabl
1ac0: 65 20 61 73 20 72 65 61 64 2d 6f 6e 6c 79 2e 20 e as read-only.
1ad0: 2a 2f 0a 20 20 61 7a 41 72 67 5b 30 5d 20 3d 20 */. azArg[0] =
1ae0: 22 74 61 62 6c 65 22 3b 0a 20 20 61 7a 41 72 67 "table";. azArg
1af0: 5b 31 5d 20 3d 20 7a 4d 61 73 74 65 72 4e 61 6d [1] = zMasterNam
1b00: 65 20 3d 20 53 43 48 45 4d 41 5f 54 41 42 4c 45 e = SCHEMA_TABLE
1b10: 28 69 44 62 29 3b 0a 20 20 61 7a 41 72 67 5b 32 (iDb);. azArg[2
1b20: 5d 20 3d 20 61 7a 41 72 67 5b 31 5d 3b 0a 20 20 ] = azArg[1];.
1b30: 61 7a 41 72 67 5b 33 5d 20 3d 20 22 31 22 3b 0a azArg[3] = "1";.
1b40: 20 20 61 7a 41 72 67 5b 34 5d 20 3d 20 22 43 52 azArg[4] = "CR
1b50: 45 41 54 45 20 54 41 42 4c 45 20 78 28 74 79 70 EATE TABLE x(typ
1b60: 65 20 74 65 78 74 2c 6e 61 6d 65 20 74 65 78 74 e text,name text
1b70: 2c 74 62 6c 5f 6e 61 6d 65 20 74 65 78 74 2c 22 ,tbl_name text,"
1b80: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 .
1b90: 20 20 20 20 20 20 20 20 20 20 20 20 20 22 72 6f "ro
1ba0: 6f 74 70 61 67 65 20 69 6e 74 2c 73 71 6c 20 74 otpage int,sql t
1bb0: 65 78 74 29 22 3b 0a 20 20 61 7a 41 72 67 5b 35 ext)";. azArg[5
1bc0: 5d 20 3d 20 30 3b 0a 20 20 69 6e 69 74 44 61 74 ] = 0;. initDat
1bd0: 61 2e 64 62 20 3d 20 64 62 3b 0a 20 20 69 6e 69 a.db = db;. ini
1be0: 74 44 61 74 61 2e 69 44 62 20 3d 20 69 44 62 3b tData.iDb = iDb;
1bf0: 0a 20 20 69 6e 69 74 44 61 74 61 2e 72 63 20 3d . initData.rc =
1c00: 20 53 51 4c 49 54 45 5f 4f 4b 3b 0a 20 20 69 6e SQLITE_OK;. in
1c10: 69 74 44 61 74 61 2e 70 7a 45 72 72 4d 73 67 20 itData.pzErrMsg
1c20: 3d 20 70 7a 45 72 72 4d 73 67 3b 0a 20 20 69 6e = pzErrMsg;. in
1c30: 69 74 44 61 74 61 2e 6d 49 6e 69 74 46 6c 61 67 itData.mInitFlag
1c40: 73 20 3d 20 6d 46 6c 61 67 73 3b 0a 20 20 69 6e s = mFlags;. in
1c50: 69 74 44 61 74 61 2e 6e 49 6e 69 74 52 6f 77 20 itData.nInitRow
1c60: 3d 20 30 3b 0a 20 20 73 71 6c 69 74 65 33 49 6e = 0;. sqlite3In
1c70: 69 74 43 61 6c 6c 62 61 63 6b 28 26 69 6e 69 74 itCallback(&init
1c80: 44 61 74 61 2c 20 35 2c 20 28 63 68 61 72 20 2a Data, 5, (char *
1c90: 2a 29 61 7a 41 72 67 2c 20 30 29 3b 0a 20 20 69 *)azArg, 0);. i
1ca0: 66 28 20 69 6e 69 74 44 61 74 61 2e 72 63 20 29 f( initData.rc )
1cb0: 7b 0a 20 20 20 20 72 63 20 3d 20 69 6e 69 74 44 {. rc = initD
1cc0: 61 74 61 2e 72 63 3b 0a 20 20 20 20 67 6f 74 6f ata.rc;. goto
1cd0: 20 65 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a error_out;. }.
1ce0: 0a 20 20 2f 2a 20 43 72 65 61 74 65 20 61 20 63 . /* Create a c
1cf0: 75 72 73 6f 72 20 74 6f 20 68 6f 6c 64 20 74 68 ursor to hold th
1d00: 65 20 64 61 74 61 62 61 73 65 20 6f 70 65 6e 0a e database open.
1d10: 20 20 2a 2f 0a 20 20 70 44 62 20 3d 20 26 64 62 */. pDb = &db
1d20: 2d 3e 61 44 62 5b 69 44 62 5d 3b 0a 20 20 69 66 ->aDb[iDb];. if
1d30: 28 20 70 44 62 2d 3e 70 42 74 3d 3d 30 20 29 7b ( pDb->pBt==0 ){
1d40: 0a 20 20 20 20 61 73 73 65 72 74 28 20 69 44 62 . assert( iDb
1d50: 3d 3d 31 20 29 3b 0a 20 20 20 20 44 62 53 65 74 ==1 );. DbSet
1d60: 50 72 6f 70 65 72 74 79 28 64 62 2c 20 31 2c 20 Property(db, 1,
1d70: 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 29 DB_SchemaLoaded)
1d80: 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 ;. rc = SQLIT
1d90: 45 5f 4f 4b 3b 0a 20 20 20 20 67 6f 74 6f 20 65 E_OK;. goto e
1da0: 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 7d 0a 0a 20 rror_out;. }..
1db0: 20 2f 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 /* If there is
1dc0: 6e 6f 74 20 61 6c 72 65 61 64 79 20 61 20 72 65 not already a re
1dd0: 61 64 2d 6f 6e 6c 79 20 28 6f 72 20 72 65 61 64 ad-only (or read
1de0: 2d 77 72 69 74 65 29 20 74 72 61 6e 73 61 63 74 -write) transact
1df0: 69 6f 6e 20 6f 70 65 6e 65 64 0a 20 20 2a 2a 20 ion opened. **
1e00: 6f 6e 20 74 68 65 20 62 2d 74 72 65 65 20 64 61 on the b-tree da
1e10: 74 61 62 61 73 65 2c 20 6f 70 65 6e 20 6f 6e 65 tabase, open one
1e20: 20 6e 6f 77 2e 20 49 66 20 61 20 74 72 61 6e 73 now. If a trans
1e30: 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 65 64 action is opened
1e40: 2c 20 69 74 20 0a 20 20 2a 2a 20 77 69 6c 6c 20 , it . ** will
1e50: 62 65 20 63 6c 6f 73 65 64 20 62 65 66 6f 72 65 be closed before
1e60: 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 72 this function r
1e70: 65 74 75 72 6e 73 2e 20 20 2a 2f 0a 20 20 73 71 eturns. */. sq
1e80: 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 72 28 lite3BtreeEnter(
1e90: 70 44 62 2d 3e 70 42 74 29 3b 0a 20 20 69 66 28 pDb->pBt);. if(
1ea0: 20 21 73 71 6c 69 74 65 33 42 74 72 65 65 49 73 !sqlite3BtreeIs
1eb0: 49 6e 52 65 61 64 54 72 61 6e 73 28 70 44 62 2d InReadTrans(pDb-
1ec0: 3e 70 42 74 29 20 29 7b 0a 20 20 20 20 72 63 20 >pBt) ){. rc
1ed0: 3d 20 73 71 6c 69 74 65 33 42 74 72 65 65 42 65 = sqlite3BtreeBe
1ee0: 67 69 6e 54 72 61 6e 73 28 70 44 62 2d 3e 70 42 ginTrans(pDb->pB
1ef0: 74 2c 20 30 2c 20 30 29 3b 0a 20 20 20 20 69 66 t, 0, 0);. if
1f00: 28 20 72 63 21 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc!=SQLITE_OK
1f10: 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 33 ){. sqlite3
1f20: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d SetString(pzErrM
1f30: 73 67 2c 20 64 62 2c 20 73 71 6c 69 74 65 33 45 sg, db, sqlite3E
1f40: 72 72 53 74 72 28 72 63 29 29 3b 0a 20 20 20 20 rrStr(rc));.
1f50: 20 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f 65 goto initone_e
1f60: 72 72 6f 72 5f 6f 75 74 3b 0a 20 20 20 20 7d 0a rror_out;. }.
1f70: 20 20 20 20 6f 70 65 6e 65 64 54 72 61 6e 73 61 openedTransa
1f80: 63 74 69 6f 6e 20 3d 20 31 3b 0a 20 20 7d 0a 0a ction = 1;. }..
1f90: 20 20 2f 2a 20 47 65 74 20 74 68 65 20 64 61 74 /* Get the dat
1fa0: 61 62 61 73 65 20 6d 65 74 61 20 69 6e 66 6f 72 abase meta infor
1fb0: 6d 61 74 69 6f 6e 2e 0a 20 20 2a 2a 0a 20 20 2a mation.. **. *
1fc0: 2a 20 4d 65 74 61 20 76 61 6c 75 65 73 20 61 72 * Meta values ar
1fd0: 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 20 e as follows:.
1fe0: 2a 2a 20 20 20 20 6d 65 74 61 5b 30 5d 20 20 20 ** meta[0]
1ff0: 53 63 68 65 6d 61 20 63 6f 6f 6b 69 65 2e 20 20 Schema cookie.
2000: 43 68 61 6e 67 65 73 20 77 69 74 68 20 65 61 63 Changes with eac
2010: 68 20 73 63 68 65 6d 61 20 63 68 61 6e 67 65 2e h schema change.
2020: 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 31 5d . ** meta[1]
2030: 20 20 20 46 69 6c 65 20 66 6f 72 6d 61 74 20 6f File format o
2040: 66 20 73 63 68 65 6d 61 20 6c 61 79 65 72 2e 0a f schema layer..
2050: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 32 5d 20 ** meta[2]
2060: 20 20 53 69 7a 65 20 6f 66 20 74 68 65 20 70 61 Size of the pa
2070: 67 65 20 63 61 63 68 65 2e 0a 20 20 2a 2a 20 20 ge cache.. **
2080: 20 20 6d 65 74 61 5b 33 5d 20 20 20 4c 61 72 67 meta[3] Larg
2090: 65 73 74 20 72 6f 6f 74 70 61 67 65 20 28 61 75 est rootpage (au
20a0: 74 6f 2f 69 6e 63 72 5f 76 61 63 75 75 6d 20 6d to/incr_vacuum m
20b0: 6f 64 65 29 0a 20 20 2a 2a 20 20 20 20 6d 65 74 ode). ** met
20c0: 61 5b 34 5d 20 20 20 44 62 20 74 65 78 74 20 65 a[4] Db text e
20d0: 6e 63 6f 64 69 6e 67 2e 20 31 3a 55 54 46 2d 38 ncoding. 1:UTF-8
20e0: 20 32 3a 55 54 46 2d 31 36 4c 45 20 33 3a 55 54 2:UTF-16LE 3:UT
20f0: 46 2d 31 36 42 45 0a 20 20 2a 2a 20 20 20 20 6d F-16BE. ** m
2100: 65 74 61 5b 35 5d 20 20 20 55 73 65 72 20 76 65 eta[5] User ve
2110: 72 73 69 6f 6e 0a 20 20 2a 2a 20 20 20 20 6d 65 rsion. ** me
2120: 74 61 5b 36 5d 20 20 20 49 6e 63 72 65 6d 65 6e ta[6] Incremen
2130: 74 61 6c 20 76 61 63 75 75 6d 20 6d 6f 64 65 0a tal vacuum mode.
2140: 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 37 5d 20 ** meta[7]
2150: 20 20 75 6e 75 73 65 64 0a 20 20 2a 2a 20 20 20 unused. **
2160: 20 6d 65 74 61 5b 38 5d 20 20 20 75 6e 75 73 65 meta[8] unuse
2170: 64 0a 20 20 2a 2a 20 20 20 20 6d 65 74 61 5b 39 d. ** meta[9
2180: 5d 20 20 20 75 6e 75 73 65 64 0a 20 20 2a 2a 0a ] unused. **.
2190: 20 20 2a 2a 20 4e 6f 74 65 3a 20 54 68 65 20 23 ** Note: The #
21a0: 64 65 66 69 6e 65 64 20 53 51 4c 49 54 45 5f 55 defined SQLITE_U
21b0: 54 46 2a 20 73 79 6d 62 6f 6c 73 20 69 6e 20 73 TF* symbols in s
21c0: 71 6c 69 74 65 49 6e 74 2e 68 20 63 6f 72 72 65 qliteInt.h corre
21d0: 73 70 6f 6e 64 20 74 6f 0a 20 20 2a 2a 20 74 68 spond to. ** th
21e0: 65 20 70 6f 73 73 69 62 6c 65 20 76 61 6c 75 65 e possible value
21f0: 73 20 6f 66 20 6d 65 74 61 5b 34 5d 2e 0a 20 20 s of meta[4]..
2200: 2a 2f 0a 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c */. for(i=0; i<
2210: 41 72 72 61 79 53 69 7a 65 28 6d 65 74 61 29 3b ArraySize(meta);
2220: 20 69 2b 2b 29 7b 0a 20 20 20 20 73 71 6c 69 74 i++){. sqlit
2230: 65 33 42 74 72 65 65 47 65 74 4d 65 74 61 28 70 e3BtreeGetMeta(p
2240: 44 62 2d 3e 70 42 74 2c 20 69 2b 31 2c 20 28 75 Db->pBt, i+1, (u
2250: 33 32 20 2a 29 26 6d 65 74 61 5b 69 5d 29 3b 0a 32 *)&meta[i]);.
2260: 20 20 7d 0a 20 20 69 66 28 20 28 64 62 2d 3e 66 }. if( (db->f
2270: 6c 61 67 73 20 26 20 53 51 4c 49 54 45 5f 52 65 lags & SQLITE_Re
2280: 73 65 74 44 61 74 61 62 61 73 65 29 21 3d 30 20 setDatabase)!=0
2290: 29 7b 0a 20 20 20 20 6d 65 6d 73 65 74 28 6d 65 ){. memset(me
22a0: 74 61 2c 20 30 2c 20 73 69 7a 65 6f 66 28 6d 65 ta, 0, sizeof(me
22b0: 74 61 29 29 3b 0a 20 20 7d 0a 20 20 70 44 62 2d ta));. }. pDb-
22c0: 3e 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 >pSchema->schema
22d0: 5f 63 6f 6f 6b 69 65 20 3d 20 6d 65 74 61 5b 42 _cookie = meta[B
22e0: 54 52 45 45 5f 53 43 48 45 4d 41 5f 56 45 52 53 TREE_SCHEMA_VERS
22f0: 49 4f 4e 2d 31 5d 3b 0a 0a 20 20 2f 2a 20 49 66 ION-1];.. /* If
2300: 20 6f 70 65 6e 69 6e 67 20 61 20 6e 6f 6e 2d 65 opening a non-e
2310: 6d 70 74 79 20 64 61 74 61 62 61 73 65 2c 20 63 mpty database, c
2320: 68 65 63 6b 20 74 68 65 20 74 65 78 74 20 65 6e heck the text en
2330: 63 6f 64 69 6e 67 2e 20 46 6f 72 20 74 68 65 0a coding. For the.
2340: 20 20 2a 2a 20 6d 61 69 6e 20 64 61 74 61 62 61 ** main databa
2350: 73 65 2c 20 73 65 74 20 73 71 6c 69 74 65 33 2e se, set sqlite3.
2360: 65 6e 63 20 74 6f 20 74 68 65 20 65 6e 63 6f 64 enc to the encod
2370: 69 6e 67 20 6f 66 20 74 68 65 20 6d 61 69 6e 20 ing of the main
2380: 64 61 74 61 62 61 73 65 2e 0a 20 20 2a 2a 20 46 database.. ** F
2390: 6f 72 20 61 6e 20 61 74 74 61 63 68 65 64 20 64 or an attached d
23a0: 62 2c 20 69 74 20 69 73 20 61 6e 20 65 72 72 6f b, it is an erro
23b0: 72 20 69 66 20 74 68 65 20 65 6e 63 6f 64 69 6e r if the encodin
23c0: 67 20 69 73 20 6e 6f 74 20 74 68 65 20 73 61 6d g is not the sam
23d0: 65 0a 20 20 2a 2a 20 61 73 20 73 71 6c 69 74 65 e. ** as sqlite
23e0: 33 2e 65 6e 63 2e 0a 20 20 2a 2f 0a 20 20 69 66 3.enc.. */. if
23f0: 28 20 6d 65 74 61 5b 42 54 52 45 45 5f 54 45 58 ( meta[BTREE_TEX
2400: 54 5f 45 4e 43 4f 44 49 4e 47 2d 31 5d 20 29 7b T_ENCODING-1] ){
2410: 20 20 2f 2a 20 74 65 78 74 20 65 6e 63 6f 64 69 /* text encodi
2420: 6e 67 20 2a 2f 0a 20 20 20 20 69 66 28 20 69 44 ng */. if( iD
2430: 62 3d 3d 30 20 29 7b 0a 23 69 66 6e 64 65 66 20 b==0 ){.#ifndef
2440: 53 51 4c 49 54 45 5f 4f 4d 49 54 5f 55 54 46 31 SQLITE_OMIT_UTF1
2450: 36 0a 20 20 20 20 20 20 75 38 20 65 6e 63 6f 64 6. u8 encod
2460: 69 6e 67 3b 0a 20 20 20 20 20 20 2f 2a 20 49 66 ing;. /* If
2470: 20 6f 70 65 6e 69 6e 67 20 74 68 65 20 6d 61 69 opening the mai
2480: 6e 20 64 61 74 61 62 61 73 65 2c 20 73 65 74 20 n database, set
2490: 45 4e 43 28 64 62 29 2e 20 2a 2f 0a 20 20 20 20 ENC(db). */.
24a0: 20 20 65 6e 63 6f 64 69 6e 67 20 3d 20 28 75 38 encoding = (u8
24b0: 29 6d 65 74 61 5b 42 54 52 45 45 5f 54 45 58 54 )meta[BTREE_TEXT
24c0: 5f 45 4e 43 4f 44 49 4e 47 2d 31 5d 20 26 20 33 _ENCODING-1] & 3
24d0: 3b 0a 20 20 20 20 20 20 69 66 28 20 65 6e 63 6f ;. if( enco
24e0: 64 69 6e 67 3d 3d 30 20 29 20 65 6e 63 6f 64 69 ding==0 ) encodi
24f0: 6e 67 20 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 ng = SQLITE_UTF8
2500: 3b 0a 20 20 20 20 20 20 45 4e 43 28 64 62 29 20 ;. ENC(db)
2510: 3d 20 65 6e 63 6f 64 69 6e 67 3b 0a 23 65 6c 73 = encoding;.#els
2520: 65 0a 20 20 20 20 20 20 45 4e 43 28 64 62 29 20 e. ENC(db)
2530: 3d 20 53 51 4c 49 54 45 5f 55 54 46 38 3b 0a 23 = SQLITE_UTF8;.#
2540: 65 6e 64 69 66 0a 20 20 20 20 7d 65 6c 73 65 7b endif. }else{
2550: 0a 20 20 20 20 20 20 2f 2a 20 49 66 20 6f 70 65 . /* If ope
2560: 6e 69 6e 67 20 61 6e 20 61 74 74 61 63 68 65 64 ning an attached
2570: 20 64 61 74 61 62 61 73 65 2c 20 74 68 65 20 65 database, the e
2580: 6e 63 6f 64 69 6e 67 20 6d 75 63 68 20 6d 61 74 ncoding much mat
2590: 63 68 20 45 4e 43 28 64 62 29 20 2a 2f 0a 20 20 ch ENC(db) */.
25a0: 20 20 20 20 69 66 28 20 6d 65 74 61 5b 42 54 52 if( meta[BTR
25b0: 45 45 5f 54 45 58 54 5f 45 4e 43 4f 44 49 4e 47 EE_TEXT_ENCODING
25c0: 2d 31 5d 21 3d 45 4e 43 28 64 62 29 20 29 7b 0a -1]!=ENC(db) ){.
25d0: 20 20 20 20 20 20 20 20 73 71 6c 69 74 65 33 53 sqlite3S
25e0: 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 etString(pzErrMs
25f0: 67 2c 20 64 62 2c 20 22 61 74 74 61 63 68 65 64 g, db, "attached
2600: 20 64 61 74 61 62 61 73 65 73 20 6d 75 73 74 20 databases must
2610: 75 73 65 20 74 68 65 20 73 61 6d 65 22 0a 20 20 use the same".
2620: 20 20 20 20 20 20 20 20 20 20 22 20 74 65 78 74 " text
2630: 20 65 6e 63 6f 64 69 6e 67 20 61 73 20 6d 61 69 encoding as mai
2640: 6e 20 64 61 74 61 62 61 73 65 22 29 3b 0a 20 20 n database");.
2650: 20 20 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 rc = SQLIT
2660: 45 5f 45 52 52 4f 52 3b 0a 20 20 20 20 20 20 20 E_ERROR;.
2670: 20 67 6f 74 6f 20 69 6e 69 74 6f 6e 65 5f 65 72 goto initone_er
2680: 72 6f 72 5f 6f 75 74 3b 0a 20 20 20 20 20 20 7d ror_out;. }
2690: 0a 20 20 20 20 7d 0a 20 20 7d 65 6c 73 65 7b 0a . }. }else{.
26a0: 20 20 20 20 44 62 53 65 74 50 72 6f 70 65 72 74 DbSetPropert
26b0: 79 28 64 62 2c 20 69 44 62 2c 20 44 42 5f 45 6d y(db, iDb, DB_Em
26c0: 70 74 79 29 3b 0a 20 20 7d 0a 20 20 70 44 62 2d pty);. }. pDb-
26d0: 3e 70 53 63 68 65 6d 61 2d 3e 65 6e 63 20 3d 20 >pSchema->enc =
26e0: 45 4e 43 28 64 62 29 3b 0a 0a 20 20 69 66 28 20 ENC(db);.. if(
26f0: 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 63 61 pDb->pSchema->ca
2700: 63 68 65 5f 73 69 7a 65 3d 3d 30 20 29 7b 0a 23 che_size==0 ){.#
2710: 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f 4d ifndef SQLITE_OM
2720: 49 54 5f 44 45 50 52 45 43 41 54 45 44 0a 20 20 IT_DEPRECATED.
2730: 20 20 73 69 7a 65 20 3d 20 73 71 6c 69 74 65 33 size = sqlite3
2740: 41 62 73 49 6e 74 33 32 28 6d 65 74 61 5b 42 54 AbsInt32(meta[BT
2750: 52 45 45 5f 44 45 46 41 55 4c 54 5f 43 41 43 48 REE_DEFAULT_CACH
2760: 45 5f 53 49 5a 45 2d 31 5d 29 3b 0a 20 20 20 20 E_SIZE-1]);.
2770: 69 66 28 20 73 69 7a 65 3d 3d 30 20 29 7b 20 73 if( size==0 ){ s
2780: 69 7a 65 20 3d 20 53 51 4c 49 54 45 5f 44 45 46 ize = SQLITE_DEF
2790: 41 55 4c 54 5f 43 41 43 48 45 5f 53 49 5a 45 3b AULT_CACHE_SIZE;
27a0: 20 7d 0a 20 20 20 20 70 44 62 2d 3e 70 53 63 68 }. pDb->pSch
27b0: 65 6d 61 2d 3e 63 61 63 68 65 5f 73 69 7a 65 20 ema->cache_size
27c0: 3d 20 73 69 7a 65 3b 0a 23 65 6c 73 65 0a 20 20 = size;.#else.
27d0: 20 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e pDb->pSchema->
27e0: 63 61 63 68 65 5f 73 69 7a 65 20 3d 20 53 51 4c cache_size = SQL
27f0: 49 54 45 5f 44 45 46 41 55 4c 54 5f 43 41 43 48 ITE_DEFAULT_CACH
2800: 45 5f 53 49 5a 45 3b 0a 23 65 6e 64 69 66 0a 20 E_SIZE;.#endif.
2810: 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 65 53 sqlite3BtreeS
2820: 65 74 43 61 63 68 65 53 69 7a 65 28 70 44 62 2d etCacheSize(pDb-
2830: 3e 70 42 74 2c 20 70 44 62 2d 3e 70 53 63 68 65 >pBt, pDb->pSche
2840: 6d 61 2d 3e 63 61 63 68 65 5f 73 69 7a 65 29 3b ma->cache_size);
2850: 0a 20 20 7d 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 . }.. /*. **
2860: 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 31 20 20 file_format==1
2870: 20 20 56 65 72 73 69 6f 6e 20 33 2e 30 2e 30 2e Version 3.0.0.
2880: 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 6f 72 6d 61 . ** file_forma
2890: 74 3d 3d 32 20 20 20 20 56 65 72 73 69 6f 6e 20 t==2 Version
28a0: 33 2e 31 2e 33 2e 20 20 2f 2f 20 41 4c 54 45 52 3.1.3. // ALTER
28b0: 20 54 41 42 4c 45 20 41 44 44 20 43 4f 4c 55 4d TABLE ADD COLUM
28c0: 4e 0a 20 20 2a 2a 20 66 69 6c 65 5f 66 6f 72 6d N. ** file_form
28d0: 61 74 3d 3d 33 20 20 20 20 56 65 72 73 69 6f 6e at==3 Version
28e0: 20 33 2e 31 2e 34 2e 20 20 2f 2f 20 64 69 74 74 3.1.4. // ditt
28f0: 6f 20 62 75 74 20 77 69 74 68 20 6e 6f 6e 2d 4e o but with non-N
2900: 55 4c 4c 20 64 65 66 61 75 6c 74 73 0a 20 20 2a ULL defaults. *
2910: 2a 20 66 69 6c 65 5f 66 6f 72 6d 61 74 3d 3d 34 * file_format==4
2920: 20 20 20 20 56 65 72 73 69 6f 6e 20 33 2e 33 2e Version 3.3.
2930: 30 2e 20 20 2f 2f 20 44 45 53 43 20 69 6e 64 69 0. // DESC indi
2940: 63 65 73 2e 20 20 42 6f 6f 6c 65 61 6e 20 63 6f ces. Boolean co
2950: 6e 73 74 61 6e 74 73 0a 20 20 2a 2f 0a 20 20 70 nstants. */. p
2960: 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69 6c Db->pSchema->fil
2970: 65 5f 66 6f 72 6d 61 74 20 3d 20 28 75 38 29 6d e_format = (u8)m
2980: 65 74 61 5b 42 54 52 45 45 5f 46 49 4c 45 5f 46 eta[BTREE_FILE_F
2990: 4f 52 4d 41 54 2d 31 5d 3b 0a 20 20 69 66 28 20 ORMAT-1];. if(
29a0: 70 44 62 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69 pDb->pSchema->fi
29b0: 6c 65 5f 66 6f 72 6d 61 74 3d 3d 30 20 29 7b 0a le_format==0 ){.
29c0: 20 20 20 20 70 44 62 2d 3e 70 53 63 68 65 6d 61 pDb->pSchema
29d0: 2d 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 ->file_format =
29e0: 31 3b 0a 20 20 7d 0a 20 20 69 66 28 20 70 44 62 1;. }. if( pDb
29f0: 2d 3e 70 53 63 68 65 6d 61 2d 3e 66 69 6c 65 5f ->pSchema->file_
2a00: 66 6f 72 6d 61 74 3e 53 51 4c 49 54 45 5f 4d 41 format>SQLITE_MA
2a10: 58 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 20 29 7b X_FILE_FORMAT ){
2a20: 0a 20 20 20 20 73 71 6c 69 74 65 33 53 65 74 53 . sqlite3SetS
2a30: 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 tring(pzErrMsg,
2a40: 64 62 2c 20 22 75 6e 73 75 70 70 6f 72 74 65 64 db, "unsupported
2a50: 20 66 69 6c 65 20 66 6f 72 6d 61 74 22 29 3b 0a file format");.
2a60: 20 20 20 20 72 63 20 3d 20 53 51 4c 49 54 45 5f rc = SQLITE_
2a70: 45 52 52 4f 52 3b 0a 20 20 20 20 67 6f 74 6f 20 ERROR;. goto
2a80: 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 5f 6f 75 initone_error_ou
2a90: 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 54 69 63 t;. }.. /* Tic
2aa0: 6b 65 74 20 23 32 38 30 34 3a 20 20 57 68 65 6e ket #2804: When
2ab0: 20 77 65 20 6f 70 65 6e 20 61 20 64 61 74 61 62 we open a datab
2ac0: 61 73 65 20 69 6e 20 74 68 65 20 6e 65 77 65 72 ase in the newer
2ad0: 20 66 69 6c 65 20 66 6f 72 6d 61 74 2c 0a 20 20 file format,.
2ae0: 2a 2a 20 63 6c 65 61 72 20 74 68 65 20 6c 65 67 ** clear the leg
2af0: 61 63 79 5f 66 69 6c 65 5f 66 6f 72 6d 61 74 20 acy_file_format
2b00: 70 72 61 67 6d 61 20 66 6c 61 67 20 73 6f 20 74 pragma flag so t
2b10: 68 61 74 20 61 20 56 41 43 55 55 4d 20 77 69 6c hat a VACUUM wil
2b20: 6c 0a 20 20 2a 2a 20 6e 6f 74 20 64 6f 77 6e 67 l. ** not downg
2b30: 72 61 64 65 20 74 68 65 20 64 61 74 61 62 61 73 rade the databas
2b40: 65 20 61 6e 64 20 74 68 75 73 20 69 6e 76 61 6c e and thus inval
2b50: 69 64 61 74 65 20 61 6e 79 20 64 65 73 63 65 6e idate any descen
2b60: 64 69 6e 67 0a 20 20 2a 2a 20 69 6e 64 69 63 65 ding. ** indice
2b70: 73 20 74 68 61 74 20 74 68 65 20 75 73 65 72 20 s that the user
2b80: 6d 69 67 68 74 20 68 61 76 65 20 63 72 65 61 74 might have creat
2b90: 65 64 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 69 ed.. */. if( i
2ba0: 44 62 3d 3d 30 20 26 26 20 6d 65 74 61 5b 42 54 Db==0 && meta[BT
2bb0: 52 45 45 5f 46 49 4c 45 5f 46 4f 52 4d 41 54 2d REE_FILE_FORMAT-
2bc0: 31 5d 3e 3d 34 20 29 7b 0a 20 20 20 20 64 62 2d 1]>=4 ){. db-
2bd0: 3e 66 6c 61 67 73 20 26 3d 20 7e 28 75 36 34 29 >flags &= ~(u64)
2be0: 53 51 4c 49 54 45 5f 4c 65 67 61 63 79 46 69 6c SQLITE_LegacyFil
2bf0: 65 46 6d 74 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 20 eFmt;. }.. /*
2c00: 52 65 61 64 20 74 68 65 20 73 63 68 65 6d 61 20 Read the schema
2c10: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6f 75 74 20 information out
2c20: 6f 66 20 74 68 65 20 73 63 68 65 6d 61 20 74 61 of the schema ta
2c30: 62 6c 65 73 0a 20 20 2a 2f 0a 20 20 61 73 73 65 bles. */. asse
2c40: 72 74 28 20 64 62 2d 3e 69 6e 69 74 2e 62 75 73 rt( db->init.bus
2c50: 79 20 29 3b 0a 20 20 7b 0a 20 20 20 20 63 68 61 y );. {. cha
2c60: 72 20 2a 7a 53 71 6c 3b 0a 20 20 20 20 7a 53 71 r *zSql;. zSq
2c70: 6c 20 3d 20 73 71 6c 69 74 65 33 4d 50 72 69 6e l = sqlite3MPrin
2c80: 74 66 28 64 62 2c 20 0a 20 20 20 20 20 20 20 20 tf(db, .
2c90: 22 53 45 4c 45 43 54 2a 46 52 4f 4d 5c 22 25 77 "SELECT*FROM\"%w
2ca0: 5c 22 2e 25 73 20 4f 52 44 45 52 20 42 59 20 72 \".%s ORDER BY r
2cb0: 6f 77 69 64 22 2c 0a 20 20 20 20 20 20 20 20 64 owid",. d
2cc0: 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 7a 44 62 53 b->aDb[iDb].zDbS
2cd0: 4e 61 6d 65 2c 20 7a 4d 61 73 74 65 72 4e 61 6d Name, zMasterNam
2ce0: 65 29 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 e);.#ifndef SQLI
2cf0: 54 45 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a TE_OMIT_AUTHORIZ
2d00: 41 54 49 4f 4e 0a 20 20 20 20 7b 0a 20 20 20 20 ATION. {.
2d10: 20 20 73 71 6c 69 74 65 33 5f 78 61 75 74 68 20 sqlite3_xauth
2d20: 78 41 75 74 68 3b 0a 20 20 20 20 20 20 78 41 75 xAuth;. xAu
2d30: 74 68 20 3d 20 64 62 2d 3e 78 41 75 74 68 3b 0a th = db->xAuth;.
2d40: 20 20 20 20 20 20 64 62 2d 3e 78 41 75 74 68 20 db->xAuth
2d50: 3d 20 30 3b 0a 23 65 6e 64 69 66 0a 20 20 20 20 = 0;.#endif.
2d60: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 5f 65 rc = sqlite3_e
2d70: 78 65 63 28 64 62 2c 20 7a 53 71 6c 2c 20 73 71 xec(db, zSql, sq
2d80: 6c 69 74 65 33 49 6e 69 74 43 61 6c 6c 62 61 63 lite3InitCallbac
2d90: 6b 2c 20 26 69 6e 69 74 44 61 74 61 2c 20 30 29 k, &initData, 0)
2da0: 3b 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ;.#ifndef SQLITE
2db0: 5f 4f 4d 49 54 5f 41 55 54 48 4f 52 49 5a 41 54 _OMIT_AUTHORIZAT
2dc0: 49 4f 4e 0a 20 20 20 20 20 20 64 62 2d 3e 78 41 ION. db->xA
2dd0: 75 74 68 20 3d 20 78 41 75 74 68 3b 0a 20 20 20 uth = xAuth;.
2de0: 20 7d 0a 23 65 6e 64 69 66 0a 20 20 20 20 69 66 }.#endif. if
2df0: 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 ( rc==SQLITE_OK
2e00: 29 20 72 63 20 3d 20 69 6e 69 74 44 61 74 61 2e ) rc = initData.
2e10: 72 63 3b 0a 20 20 20 20 73 71 6c 69 74 65 33 44 rc;. sqlite3D
2e20: 62 46 72 65 65 28 64 62 2c 20 7a 53 71 6c 29 3b bFree(db, zSql);
2e30: 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f .#ifndef SQLITE_
2e40: 4f 4d 49 54 5f 41 4e 41 4c 59 5a 45 0a 20 20 20 OMIT_ANALYZE.
2e50: 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f if( rc==SQLITE_
2e60: 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 OK ){. sqli
2e70: 74 65 33 41 6e 61 6c 79 73 69 73 4c 6f 61 64 28 te3AnalysisLoad(
2e80: 64 62 2c 20 69 44 62 29 3b 0a 20 20 20 20 7d 0a db, iDb);. }.
2e90: 23 65 6e 64 69 66 0a 20 20 7d 0a 20 20 69 66 28 #endif. }. if(
2ea0: 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 69 6c 65 db->mallocFaile
2eb0: 64 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 53 51 d ){. rc = SQ
2ec0: 4c 49 54 45 5f 4e 4f 4d 45 4d 5f 42 4b 50 54 3b LITE_NOMEM_BKPT;
2ed0: 0a 20 20 20 20 73 71 6c 69 74 65 33 52 65 73 65 . sqlite3Rese
2ee0: 74 41 6c 6c 53 63 68 65 6d 61 73 4f 66 43 6f 6e tAllSchemasOfCon
2ef0: 6e 65 63 74 69 6f 6e 28 64 62 29 3b 0a 20 20 7d nection(db);. }
2f00: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
2f10: 45 5f 4f 4b 20 7c 7c 20 28 64 62 2d 3e 66 6c 61 E_OK || (db->fla
2f20: 67 73 26 53 51 4c 49 54 45 5f 4e 6f 53 63 68 65 gs&SQLITE_NoSche
2f30: 6d 61 45 72 72 6f 72 29 29 7b 0a 20 20 20 20 2f maError)){. /
2f40: 2a 20 42 6c 61 63 6b 20 6d 61 67 69 63 3a 20 49 * Black magic: I
2f50: 66 20 74 68 65 20 53 51 4c 49 54 45 5f 4e 6f 53 f the SQLITE_NoS
2f60: 63 68 65 6d 61 45 72 72 6f 72 20 66 6c 61 67 20 chemaError flag
2f70: 69 73 20 73 65 74 2c 20 74 68 65 6e 20 63 6f 6e is set, then con
2f80: 73 69 64 65 72 0a 20 20 20 20 2a 2a 20 74 68 65 sider. ** the
2f90: 20 73 63 68 65 6d 61 20 6c 6f 61 64 65 64 2c 20 schema loaded,
2fa0: 65 76 65 6e 20 69 66 20 65 72 72 6f 72 73 20 6f even if errors o
2fb0: 63 63 75 72 72 65 64 2e 20 49 6e 20 74 68 69 73 ccurred. In this
2fc0: 20 73 69 74 75 61 74 69 6f 6e 20 74 68 65 20 0a situation the .
2fd0: 20 20 20 20 2a 2a 20 63 75 72 72 65 6e 74 20 73 ** current s
2fe0: 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 28 29 qlite3_prepare()
2ff0: 20 6f 70 65 72 61 74 69 6f 6e 20 77 69 6c 6c 20 operation will
3000: 66 61 69 6c 2c 20 62 75 74 20 74 68 65 20 66 6f fail, but the fo
3010: 6c 6c 6f 77 69 6e 67 20 6f 6e 65 0a 20 20 20 20 llowing one.
3020: 2a 2a 20 77 69 6c 6c 20 61 74 74 65 6d 70 74 20 ** will attempt
3030: 74 6f 20 63 6f 6d 70 69 6c 65 20 74 68 65 20 73 to compile the s
3040: 75 70 70 6c 69 65 64 20 73 74 61 74 65 6d 65 6e upplied statemen
3050: 74 20 61 67 61 69 6e 73 74 20 77 68 61 74 65 76 t against whatev
3060: 65 72 20 73 75 62 73 65 74 0a 20 20 20 20 2a 2a er subset. **
3070: 20 6f 66 20 74 68 65 20 73 63 68 65 6d 61 20 77 of the schema w
3080: 61 73 20 6c 6f 61 64 65 64 20 62 65 66 6f 72 65 as loaded before
3090: 20 74 68 65 20 65 72 72 6f 72 20 6f 63 63 75 72 the error occur
30a0: 72 65 64 2e 20 54 68 65 20 70 72 69 6d 61 72 79 red. The primary
30b0: 0a 20 20 20 20 2a 2a 20 70 75 72 70 6f 73 65 20 . ** purpose
30c0: 6f 66 20 74 68 69 73 20 69 73 20 74 6f 20 61 6c of this is to al
30d0: 6c 6f 77 20 61 63 63 65 73 73 20 74 6f 20 74 68 low access to th
30e0: 65 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20 e sqlite_master
30f0: 74 61 62 6c 65 0a 20 20 20 20 2a 2a 20 65 76 65 table. ** eve
3100: 6e 20 77 68 65 6e 20 69 74 73 20 63 6f 6e 74 65 n when its conte
3110: 6e 74 73 20 68 61 76 65 20 62 65 65 6e 20 63 6f nts have been co
3120: 72 72 75 70 74 65 64 2e 0a 20 20 20 20 2a 2f 0a rrupted.. */.
3130: 20 20 20 20 44 62 53 65 74 50 72 6f 70 65 72 74 DbSetPropert
3140: 79 28 64 62 2c 20 69 44 62 2c 20 44 42 5f 53 63 y(db, iDb, DB_Sc
3150: 68 65 6d 61 4c 6f 61 64 65 64 29 3b 0a 20 20 20 hemaLoaded);.
3160: 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b 3b rc = SQLITE_OK;
3170: 0a 20 20 7d 0a 0a 20 20 2f 2a 20 4a 75 6d 70 20 . }.. /* Jump
3180: 68 65 72 65 20 66 6f 72 20 61 6e 20 65 72 72 6f here for an erro
3190: 72 20 74 68 61 74 20 6f 63 63 75 72 73 20 61 66 r that occurs af
31a0: 74 65 72 20 73 75 63 63 65 73 73 66 75 6c 6c 79 ter successfully
31b0: 20 61 6c 6c 6f 63 61 74 69 6e 67 0a 20 20 2a 2a allocating. **
31c0: 20 63 75 72 4d 61 69 6e 20 61 6e 64 20 63 61 6c curMain and cal
31d0: 6c 69 6e 67 20 73 71 6c 69 74 65 33 42 74 72 65 ling sqlite3Btre
31e0: 65 45 6e 74 65 72 28 29 2e 20 46 6f 72 20 61 6e eEnter(). For an
31f0: 20 65 72 72 6f 72 20 74 68 61 74 20 6f 63 63 75 error that occu
3200: 72 73 0a 20 20 2a 2a 20 62 65 66 6f 72 65 20 74 rs. ** before t
3210: 68 61 74 20 70 6f 69 6e 74 2c 20 6a 75 6d 70 20 hat point, jump
3220: 74 6f 20 65 72 72 6f 72 5f 6f 75 74 2e 0a 20 20 to error_out..
3230: 2a 2f 0a 69 6e 69 74 6f 6e 65 5f 65 72 72 6f 72 */.initone_error
3240: 5f 6f 75 74 3a 0a 20 20 69 66 28 20 6f 70 65 6e _out:. if( open
3250: 65 64 54 72 61 6e 73 61 63 74 69 6f 6e 20 29 7b edTransaction ){
3260: 0a 20 20 20 20 73 71 6c 69 74 65 33 42 74 72 65 . sqlite3Btre
3270: 65 43 6f 6d 6d 69 74 28 70 44 62 2d 3e 70 42 74 eCommit(pDb->pBt
3280: 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 );. }. sqlite3
3290: 42 74 72 65 65 4c 65 61 76 65 28 70 44 62 2d 3e BtreeLeave(pDb->
32a0: 70 42 74 29 3b 0a 0a 65 72 72 6f 72 5f 6f 75 74 pBt);..error_out
32b0: 3a 0a 20 20 69 66 28 20 72 63 20 29 7b 0a 20 20 :. if( rc ){.
32c0: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
32d0: 5f 4e 4f 4d 45 4d 20 7c 7c 20 72 63 3d 3d 53 51 _NOMEM || rc==SQ
32e0: 4c 49 54 45 5f 49 4f 45 52 52 5f 4e 4f 4d 45 4d LITE_IOERR_NOMEM
32f0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
3300: 33 4f 6f 6d 46 61 75 6c 74 28 64 62 29 3b 0a 20 3OomFault(db);.
3310: 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 65 33 }. sqlite3
3320: 52 65 73 65 74 4f 6e 65 53 63 68 65 6d 61 28 64 ResetOneSchema(d
3330: 62 2c 20 69 44 62 29 3b 0a 20 20 7d 0a 20 20 64 b, iDb);. }. d
3340: 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 3d 20 30 b->init.busy = 0
3350: 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d ;. return rc;.}
3360: 0a 0a 2f 2a 0a 2a 2a 20 49 6e 69 74 69 61 6c 69 ../*.** Initiali
3370: 7a 65 20 61 6c 6c 20 64 61 74 61 62 61 73 65 20 ze all database
3380: 66 69 6c 65 73 20 2d 20 74 68 65 20 6d 61 69 6e files - the main
3390: 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 database file,
33a0: 74 68 65 20 66 69 6c 65 0a 2a 2a 20 75 73 65 64 the file.** used
33b0: 20 74 6f 20 73 74 6f 72 65 20 74 65 6d 70 6f 72 to store tempor
33c0: 61 72 79 20 74 61 62 6c 65 73 2c 20 61 6e 64 20 ary tables, and
33d0: 61 6e 79 20 61 64 64 69 74 69 6f 6e 61 6c 20 64 any additional d
33e0: 61 74 61 62 61 73 65 20 66 69 6c 65 73 0a 2a 2a atabase files.**
33f0: 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 20 41 created using A
3400: 54 54 41 43 48 20 73 74 61 74 65 6d 65 6e 74 73 TTACH statements
3410: 2e 20 20 52 65 74 75 72 6e 20 61 20 73 75 63 63 . Return a succ
3420: 65 73 73 20 63 6f 64 65 2e 20 20 49 66 20 61 6e ess code. If an
3430: 0a 2a 2a 20 65 72 72 6f 72 20 6f 63 63 75 72 73 .** error occurs
3440: 2c 20 77 72 69 74 65 20 61 6e 20 65 72 72 6f 72 , write an error
3450: 20 6d 65 73 73 61 67 65 20 69 6e 74 6f 20 2a 70 message into *p
3460: 7a 45 72 72 4d 73 67 2e 0a 2a 2a 0a 2a 2a 20 41 zErrMsg..**.** A
3470: 66 74 65 72 20 61 20 64 61 74 61 62 61 73 65 20 fter a database
3480: 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 64 2c 20 is initialized,
3490: 74 68 65 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 the DB_SchemaLoa
34a0: 64 65 64 20 62 69 74 20 69 73 20 73 65 74 0a 2a ded bit is set.*
34b0: 2a 20 62 69 74 20 69 73 20 73 65 74 20 69 6e 20 * bit is set in
34c0: 74 68 65 20 66 6c 61 67 73 20 66 69 65 6c 64 20 the flags field
34d0: 6f 66 20 74 68 65 20 44 62 20 73 74 72 75 63 74 of the Db struct
34e0: 75 72 65 2e 20 49 66 20 74 68 65 20 64 61 74 61 ure. If the data
34f0: 62 61 73 65 0a 2a 2a 20 66 69 6c 65 20 77 61 73 base.** file was
3500: 20 6f 66 20 7a 65 72 6f 2d 6c 65 6e 67 74 68 2c of zero-length,
3510: 20 74 68 65 6e 20 74 68 65 20 44 42 5f 45 6d 70 then the DB_Emp
3520: 74 79 20 66 6c 61 67 20 69 73 20 61 6c 73 6f 20 ty flag is also
3530: 73 65 74 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 set..*/.int sqli
3540: 74 65 33 49 6e 69 74 28 73 71 6c 69 74 65 33 20 te3Init(sqlite3
3550: 2a 64 62 2c 20 63 68 61 72 20 2a 2a 70 7a 45 72 *db, char **pzEr
3560: 72 4d 73 67 29 7b 0a 20 20 69 6e 74 20 69 2c 20 rMsg){. int i,
3570: 72 63 3b 0a 20 20 69 6e 74 20 63 6f 6d 6d 69 74 rc;. int commit
3580: 5f 69 6e 74 65 72 6e 61 6c 20 3d 20 21 28 64 62 _internal = !(db
3590: 2d 3e 6d 44 62 46 6c 61 67 73 26 44 42 46 4c 41 ->mDbFlags&DBFLA
35a0: 47 5f 53 63 68 65 6d 61 43 68 61 6e 67 65 29 3b G_SchemaChange);
35b0: 0a 20 20 0a 20 20 61 73 73 65 72 74 28 20 73 71 . . assert( sq
35c0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
35d0: 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 (db->mutex) );.
35e0: 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 33 assert( sqlite3
35f0: 42 74 72 65 65 48 6f 6c 64 73 4d 75 74 65 78 28 BtreeHoldsMutex(
3600: 64 62 2d 3e 61 44 62 5b 30 5d 2e 70 42 74 29 20 db->aDb[0].pBt)
3610: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 64 62 2d );. assert( db-
3620: 3e 69 6e 69 74 2e 62 75 73 79 3d 3d 30 20 29 3b >init.busy==0 );
3630: 0a 20 20 45 4e 43 28 64 62 29 20 3d 20 53 43 48 . ENC(db) = SCH
3640: 45 4d 41 5f 45 4e 43 28 64 62 29 3b 0a 20 20 61 EMA_ENC(db);. a
3650: 73 73 65 72 74 28 20 64 62 2d 3e 6e 44 62 3e 30 ssert( db->nDb>0
3660: 20 29 3b 0a 20 20 2f 2a 20 44 6f 20 74 68 65 20 );. /* Do the
3670: 6d 61 69 6e 20 73 63 68 65 6d 61 20 66 69 72 73 main schema firs
3680: 74 20 2a 2f 0a 20 20 69 66 28 20 21 44 62 48 61 t */. if( !DbHa
3690: 73 50 72 6f 70 65 72 74 79 28 64 62 2c 20 30 2c sProperty(db, 0,
36a0: 20 44 42 5f 53 63 68 65 6d 61 4c 6f 61 64 65 64 DB_SchemaLoaded
36b0: 29 20 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 ) ){. rc = sq
36c0: 6c 69 74 65 33 49 6e 69 74 4f 6e 65 28 64 62 2c lite3InitOne(db,
36d0: 20 30 2c 20 70 7a 45 72 72 4d 73 67 2c 20 30 29 0, pzErrMsg, 0)
36e0: 3b 0a 20 20 20 20 69 66 28 20 72 63 20 29 20 72 ;. if( rc ) r
36f0: 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 0a 20 20 eturn rc;. }.
3700: 2f 2a 20 41 6c 6c 20 6f 74 68 65 72 20 73 63 68 /* All other sch
3710: 65 6d 61 73 20 61 66 74 65 72 20 74 68 65 20 6d emas after the m
3720: 61 69 6e 20 73 63 68 65 6d 61 2e 20 54 68 65 20 ain schema. The
3730: 22 74 65 6d 70 22 20 73 63 68 65 6d 61 20 6d 75 "temp" schema mu
3740: 73 74 20 62 65 20 6c 61 73 74 20 2a 2f 0a 20 20 st be last */.
3750: 66 6f 72 28 69 3d 64 62 2d 3e 6e 44 62 2d 31 3b for(i=db->nDb-1;
3760: 20 69 3e 30 3b 20 69 2d 2d 29 7b 0a 20 20 20 20 i>0; i--){.
3770: 61 73 73 65 72 74 28 20 69 3d 3d 31 20 7c 7c 20 assert( i==1 ||
3780: 73 71 6c 69 74 65 33 42 74 72 65 65 48 6f 6c 64 sqlite3BtreeHold
3790: 73 4d 75 74 65 78 28 64 62 2d 3e 61 44 62 5b 69 sMutex(db->aDb[i
37a0: 5d 2e 70 42 74 29 20 29 3b 0a 20 20 20 20 69 66 ].pBt) );. if
37b0: 28 20 21 44 62 48 61 73 50 72 6f 70 65 72 74 79 ( !DbHasProperty
37c0: 28 64 62 2c 20 69 2c 20 44 42 5f 53 63 68 65 6d (db, i, DB_Schem
37d0: 61 4c 6f 61 64 65 64 29 20 29 7b 0a 20 20 20 20 aLoaded) ){.
37e0: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 49 6e rc = sqlite3In
37f0: 69 74 4f 6e 65 28 64 62 2c 20 69 2c 20 70 7a 45 itOne(db, i, pzE
3800: 72 72 4d 73 67 2c 20 30 29 3b 0a 20 20 20 20 20 rrMsg, 0);.
3810: 20 69 66 28 20 72 63 20 29 20 72 65 74 75 72 6e if( rc ) return
3820: 20 72 63 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 rc;. }. }.
3830: 20 69 66 28 20 63 6f 6d 6d 69 74 5f 69 6e 74 65 if( commit_inte
3840: 72 6e 61 6c 20 29 7b 0a 20 20 20 20 73 71 6c 69 rnal ){. sqli
3850: 74 65 33 43 6f 6d 6d 69 74 49 6e 74 65 72 6e 61 te3CommitInterna
3860: 6c 43 68 61 6e 67 65 73 28 64 62 29 3b 0a 20 20 lChanges(db);.
3870: 7d 0a 20 20 72 65 74 75 72 6e 20 53 51 4c 49 54 }. return SQLIT
3880: 45 5f 4f 4b 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 E_OK;.}../*.** T
3890: 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 61 his routine is a
38a0: 20 6e 6f 2d 6f 70 20 69 66 20 74 68 65 20 64 61 no-op if the da
38b0: 74 61 62 61 73 65 20 73 63 68 65 6d 61 20 69 73 tabase schema is
38c0: 20 61 6c 72 65 61 64 79 20 69 6e 69 74 69 61 6c already initial
38d0: 69 7a 65 64 2e 0a 2a 2a 20 4f 74 68 65 72 77 69 ized..** Otherwi
38e0: 73 65 2c 20 74 68 65 20 73 63 68 65 6d 61 20 69 se, the schema i
38f0: 73 20 6c 6f 61 64 65 64 2e 20 41 6e 20 65 72 72 s loaded. An err
3900: 6f 72 20 63 6f 64 65 20 69 73 20 72 65 74 75 72 or code is retur
3910: 6e 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 ned..*/.int sqli
3920: 74 65 33 52 65 61 64 53 63 68 65 6d 61 28 50 61 te3ReadSchema(Pa
3930: 72 73 65 20 2a 70 50 61 72 73 65 29 7b 0a 20 20 rse *pParse){.
3940: 69 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f int rc = SQLITE_
3950: 4f 4b 3b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 OK;. sqlite3 *d
3960: 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a b = pParse->db;.
3970: 20 20 61 73 73 65 72 74 28 20 73 71 6c 69 74 65 assert( sqlite
3980: 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 64 62 2d 3_mutex_held(db-
3990: 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 69 66 28 >mutex) );. if(
39a0: 20 21 64 62 2d 3e 69 6e 69 74 2e 62 75 73 79 20 !db->init.busy
39b0: 29 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 ){. rc = sqli
39c0: 74 65 33 49 6e 69 74 28 64 62 2c 20 26 70 50 61 te3Init(db, &pPa
39d0: 72 73 65 2d 3e 7a 45 72 72 4d 73 67 29 3b 0a 20 rse->zErrMsg);.
39e0: 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 if( rc!=SQLIT
39f0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 70 50 E_OK ){. pP
3a00: 61 72 73 65 2d 3e 72 63 20 3d 20 72 63 3b 0a 20 arse->rc = rc;.
3a10: 20 20 20 20 20 70 50 61 72 73 65 2d 3e 6e 45 72 pParse->nEr
3a20: 72 2b 2b 3b 0a 20 20 20 20 7d 65 6c 73 65 20 69 r++;. }else i
3a30: 66 28 20 64 62 2d 3e 6e 6f 53 68 61 72 65 64 43 f( db->noSharedC
3a40: 61 63 68 65 20 29 7b 0a 20 20 20 20 20 20 64 62 ache ){. db
3a50: 2d 3e 6d 44 62 46 6c 61 67 73 20 7c 3d 20 44 42 ->mDbFlags |= DB
3a60: 46 4c 41 47 5f 53 63 68 65 6d 61 4b 6e 6f 77 6e FLAG_SchemaKnown
3a70: 4f 6b 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 Ok;. }. }.
3a80: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f return rc;.}.../
3a90: 2a 0a 2a 2a 20 43 68 65 63 6b 20 73 63 68 65 6d *.** Check schem
3aa0: 61 20 63 6f 6f 6b 69 65 73 20 69 6e 20 61 6c 6c a cookies in all
3ab0: 20 64 61 74 61 62 61 73 65 73 2e 20 20 49 66 20 databases. If
3ac0: 61 6e 79 20 63 6f 6f 6b 69 65 20 69 73 20 6f 75 any cookie is ou
3ad0: 74 0a 2a 2a 20 6f 66 20 64 61 74 65 20 73 65 74 t.** of date set
3ae0: 20 70 50 61 72 73 65 2d 3e 72 63 20 74 6f 20 53 pParse->rc to S
3af0: 51 4c 49 54 45 5f 53 43 48 45 4d 41 2e 20 20 49 QLITE_SCHEMA. I
3b00: 66 20 61 6c 6c 20 73 63 68 65 6d 61 20 63 6f 6f f all schema coo
3b10: 6b 69 65 73 0a 2a 2a 20 6d 61 6b 65 20 6e 6f 20 kies.** make no
3b20: 63 68 61 6e 67 65 73 20 74 6f 20 70 50 61 72 73 changes to pPars
3b30: 65 2d 3e 72 63 2e 0a 2a 2f 0a 73 74 61 74 69 63 e->rc..*/.static
3b40: 20 76 6f 69 64 20 73 63 68 65 6d 61 49 73 56 61 void schemaIsVa
3b50: 6c 69 64 28 50 61 72 73 65 20 2a 70 50 61 72 73 lid(Parse *pPars
3b60: 65 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 e){. sqlite3 *d
3b70: 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a b = pParse->db;.
3b80: 20 20 69 6e 74 20 69 44 62 3b 0a 20 20 69 6e 74 int iDb;. int
3b90: 20 72 63 3b 0a 20 20 69 6e 74 20 63 6f 6f 6b 69 rc;. int cooki
3ba0: 65 3b 0a 0a 20 20 61 73 73 65 72 74 28 20 70 50 e;.. assert( pP
3bb0: 61 72 73 65 2d 3e 63 68 65 63 6b 53 63 68 65 6d arse->checkSchem
3bc0: 61 20 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 a );. assert( s
3bd0: 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c qlite3_mutex_hel
3be0: 64 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a d(db->mutex) );.
3bf0: 20 20 66 6f 72 28 69 44 62 3d 30 3b 20 69 44 62 for(iDb=0; iDb
3c00: 3c 64 62 2d 3e 6e 44 62 3b 20 69 44 62 2b 2b 29 <db->nDb; iDb++)
3c10: 7b 0a 20 20 20 20 69 6e 74 20 6f 70 65 6e 65 64 {. int opened
3c20: 54 72 61 6e 73 61 63 74 69 6f 6e 20 3d 20 30 3b Transaction = 0;
3c30: 20 20 20 20 20 20 20 20 20 2f 2a 20 54 72 75 65 /* True
3c40: 20 69 66 20 61 20 74 72 61 6e 73 61 63 74 69 6f if a transactio
3c50: 6e 20 69 73 20 6f 70 65 6e 65 64 20 2a 2f 0a 20 n is opened */.
3c60: 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 3d 20 Btree *pBt =
3c70: 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e 70 42 74 db->aDb[iDb].pBt
3c80: 3b 20 20 20 20 20 2f 2a 20 42 74 72 65 65 20 64 ; /* Btree d
3c90: 61 74 61 62 61 73 65 20 74 6f 20 72 65 61 64 20 atabase to read
3ca0: 63 6f 6f 6b 69 65 20 66 72 6f 6d 20 2a 2f 0a 20 cookie from */.
3cb0: 20 20 20 69 66 28 20 70 42 74 3d 3d 30 20 29 20 if( pBt==0 )
3cc0: 63 6f 6e 74 69 6e 75 65 3b 0a 0a 20 20 20 20 2f continue;.. /
3cd0: 2a 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f * If there is no
3ce0: 74 20 61 6c 72 65 61 64 79 20 61 20 72 65 61 64 t already a read
3cf0: 2d 6f 6e 6c 79 20 28 6f 72 20 72 65 61 64 2d 77 -only (or read-w
3d00: 72 69 74 65 29 20 74 72 61 6e 73 61 63 74 69 6f rite) transactio
3d10: 6e 20 6f 70 65 6e 65 64 0a 20 20 20 20 2a 2a 20 n opened. **
3d20: 6f 6e 20 74 68 65 20 62 2d 74 72 65 65 20 64 61 on the b-tree da
3d30: 74 61 62 61 73 65 2c 20 6f 70 65 6e 20 6f 6e 65 tabase, open one
3d40: 20 6e 6f 77 2e 20 49 66 20 61 20 74 72 61 6e 73 now. If a trans
3d50: 61 63 74 69 6f 6e 20 69 73 20 6f 70 65 6e 65 64 action is opened
3d60: 2c 20 69 74 20 0a 20 20 20 20 2a 2a 20 77 69 6c , it . ** wil
3d70: 6c 20 62 65 20 63 6c 6f 73 65 64 20 69 6d 6d 65 l be closed imme
3d80: 64 69 61 74 65 6c 79 20 61 66 74 65 72 20 72 65 diately after re
3d90: 61 64 69 6e 67 20 74 68 65 20 6d 65 74 61 2d 76 ading the meta-v
3da0: 61 6c 75 65 2e 20 2a 2f 0a 20 20 20 20 69 66 28 alue. */. if(
3db0: 20 21 73 71 6c 69 74 65 33 42 74 72 65 65 49 73 !sqlite3BtreeIs
3dc0: 49 6e 52 65 61 64 54 72 61 6e 73 28 70 42 74 29 InReadTrans(pBt)
3dd0: 20 29 7b 0a 20 20 20 20 20 20 72 63 20 3d 20 73 ){. rc = s
3de0: 71 6c 69 74 65 33 42 74 72 65 65 42 65 67 69 6e qlite3BtreeBegin
3df0: 54 72 61 6e 73 28 70 42 74 2c 20 30 2c 20 30 29 Trans(pBt, 0, 0)
3e00: 3b 0a 20 20 20 20 20 20 69 66 28 20 72 63 3d 3d ;. if( rc==
3e10: 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d 20 7c 7c 20 SQLITE_NOMEM ||
3e20: 72 63 3d 3d 53 51 4c 49 54 45 5f 49 4f 45 52 52 rc==SQLITE_IOERR
3e30: 5f 4e 4f 4d 45 4d 20 29 7b 0a 20 20 20 20 20 20 _NOMEM ){.
3e40: 20 20 73 71 6c 69 74 65 33 4f 6f 6d 46 61 75 6c sqlite3OomFaul
3e50: 74 28 64 62 29 3b 0a 20 20 20 20 20 20 7d 0a 20 t(db);. }.
3e60: 20 20 20 20 20 69 66 28 20 72 63 21 3d 53 51 4c if( rc!=SQL
3e70: 49 54 45 5f 4f 4b 20 29 20 72 65 74 75 72 6e 3b ITE_OK ) return;
3e80: 0a 20 20 20 20 20 20 6f 70 65 6e 65 64 54 72 61 . openedTra
3e90: 6e 73 61 63 74 69 6f 6e 20 3d 20 31 3b 0a 20 20 nsaction = 1;.
3ea0: 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 52 65 61 64 }.. /* Read
3eb0: 20 74 68 65 20 73 63 68 65 6d 61 20 63 6f 6f 6b the schema cook
3ec0: 69 65 20 66 72 6f 6d 20 74 68 65 20 64 61 74 61 ie from the data
3ed0: 62 61 73 65 2e 20 49 66 20 69 74 20 64 6f 65 73 base. If it does
3ee0: 20 6e 6f 74 20 6d 61 74 63 68 20 74 68 65 20 0a not match the .
3ef0: 20 20 20 20 2a 2a 20 76 61 6c 75 65 20 73 74 6f ** value sto
3f00: 72 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 74 red as part of t
3f10: 68 65 20 69 6e 2d 6d 65 6d 6f 72 79 20 73 63 68 he in-memory sch
3f20: 65 6d 61 20 72 65 70 72 65 73 65 6e 74 61 74 69 ema representati
3f30: 6f 6e 2c 0a 20 20 20 20 2a 2a 20 73 65 74 20 50 on,. ** set P
3f40: 61 72 73 65 2e 72 63 20 74 6f 20 53 51 4c 49 54 arse.rc to SQLIT
3f50: 45 5f 53 43 48 45 4d 41 2e 20 2a 2f 0a 20 20 20 E_SCHEMA. */.
3f60: 20 73 71 6c 69 74 65 33 42 74 72 65 65 47 65 74 sqlite3BtreeGet
3f70: 4d 65 74 61 28 70 42 74 2c 20 42 54 52 45 45 5f Meta(pBt, BTREE_
3f80: 53 43 48 45 4d 41 5f 56 45 52 53 49 4f 4e 2c 20 SCHEMA_VERSION,
3f90: 28 75 33 32 20 2a 29 26 63 6f 6f 6b 69 65 29 3b (u32 *)&cookie);
3fa0: 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 6c . assert( sql
3fb0: 69 74 65 33 53 63 68 65 6d 61 4d 75 74 65 78 48 ite3SchemaMutexH
3fc0: 65 6c 64 28 64 62 2c 20 69 44 62 2c 20 30 29 20 eld(db, iDb, 0)
3fd0: 29 3b 0a 20 20 20 20 69 66 28 20 63 6f 6f 6b 69 );. if( cooki
3fe0: 65 21 3d 64 62 2d 3e 61 44 62 5b 69 44 62 5d 2e e!=db->aDb[iDb].
3ff0: 70 53 63 68 65 6d 61 2d 3e 73 63 68 65 6d 61 5f pSchema->schema_
4000: 63 6f 6f 6b 69 65 20 29 7b 0a 20 20 20 20 20 20 cookie ){.
4010: 73 71 6c 69 74 65 33 52 65 73 65 74 4f 6e 65 53 sqlite3ResetOneS
4020: 63 68 65 6d 61 28 64 62 2c 20 69 44 62 29 3b 0a chema(db, iDb);.
4030: 20 20 20 20 20 20 70 50 61 72 73 65 2d 3e 72 63 pParse->rc
4040: 20 3d 20 53 51 4c 49 54 45 5f 53 43 48 45 4d 41 = SQLITE_SCHEMA
4050: 3b 0a 20 20 20 20 7d 0a 0a 20 20 20 20 2f 2a 20 ;. }.. /*
4060: 43 6c 6f 73 65 20 74 68 65 20 74 72 61 6e 73 61 Close the transa
4070: 63 74 69 6f 6e 2c 20 69 66 20 6f 6e 65 20 77 61 ction, if one wa
4080: 73 20 6f 70 65 6e 65 64 2e 20 2a 2f 0a 20 20 20 s opened. */.
4090: 20 69 66 28 20 6f 70 65 6e 65 64 54 72 61 6e 73 if( openedTrans
40a0: 61 63 74 69 6f 6e 20 29 7b 0a 20 20 20 20 20 20 action ){.
40b0: 73 71 6c 69 74 65 33 42 74 72 65 65 43 6f 6d 6d sqlite3BtreeComm
40c0: 69 74 28 70 42 74 29 3b 0a 20 20 20 20 7d 0a 20 it(pBt);. }.
40d0: 20 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6e 76 }.}../*.** Conv
40e0: 65 72 74 20 61 20 73 63 68 65 6d 61 20 70 6f 69 ert a schema poi
40f0: 6e 74 65 72 20 69 6e 74 6f 20 74 68 65 20 69 44 nter into the iD
4100: 62 20 69 6e 64 65 78 20 74 68 61 74 20 69 6e 64 b index that ind
4110: 69 63 61 74 65 73 0a 2a 2a 20 77 68 69 63 68 20 icates.** which
4120: 64 61 74 61 62 61 73 65 20 66 69 6c 65 20 69 6e database file in
4130: 20 64 62 2d 3e 61 44 62 5b 5d 20 74 68 65 20 73 db->aDb[] the s
4140: 63 68 65 6d 61 20 72 65 66 65 72 73 20 74 6f 2e chema refers to.
4150: 0a 2a 2a 0a 2a 2a 20 49 66 20 74 68 65 20 73 61 .**.** If the sa
4160: 6d 65 20 64 61 74 61 62 61 73 65 20 69 73 20 61 me database is a
4170: 74 74 61 63 68 65 64 20 6d 6f 72 65 20 74 68 61 ttached more tha
4180: 6e 20 6f 6e 63 65 2c 20 74 68 65 20 66 69 72 73 n once, the firs
4190: 74 0a 2a 2a 20 61 74 74 61 63 68 65 64 20 64 61 t.** attached da
41a0: 74 61 62 61 73 65 20 69 73 20 72 65 74 75 72 6e tabase is return
41b0: 65 64 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 ed..*/.int sqlit
41c0: 65 33 53 63 68 65 6d 61 54 6f 49 6e 64 65 78 28 e3SchemaToIndex(
41d0: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 53 63 68 sqlite3 *db, Sch
41e0: 65 6d 61 20 2a 70 53 63 68 65 6d 61 29 7b 0a 20 ema *pSchema){.
41f0: 20 69 6e 74 20 69 20 3d 20 2d 31 30 30 30 30 30 int i = -100000
4200: 30 3b 0a 0a 20 20 2f 2a 20 49 66 20 70 53 63 68 0;.. /* If pSch
4210: 65 6d 61 20 69 73 20 4e 55 4c 4c 2c 20 74 68 65 ema is NULL, the
4220: 6e 20 72 65 74 75 72 6e 20 2d 31 30 30 30 30 30 n return -100000
4230: 30 2e 20 54 68 69 73 20 68 61 70 70 65 6e 73 20 0. This happens
4240: 77 68 65 6e 20 63 6f 64 65 20 69 6e 20 0a 20 20 when code in .
4250: 2a 2a 20 65 78 70 72 2e 63 20 69 73 20 74 72 79 ** expr.c is try
4260: 69 6e 67 20 74 6f 20 72 65 73 6f 6c 76 65 20 61 ing to resolve a
4270: 20 72 65 66 65 72 65 6e 63 65 20 74 6f 20 61 20 reference to a
4280: 74 72 61 6e 73 69 65 6e 74 20 74 61 62 6c 65 20 transient table
4290: 28 69 2e 65 2e 20 6f 6e 65 0a 20 20 2a 2a 20 63 (i.e. one. ** c
42a0: 72 65 61 74 65 64 20 62 79 20 61 20 73 75 62 2d reated by a sub-
42b0: 73 65 6c 65 63 74 29 2e 20 49 6e 20 74 68 69 73 select). In this
42c0: 20 63 61 73 65 20 74 68 65 20 72 65 74 75 72 6e case the return
42d0: 20 76 61 6c 75 65 20 6f 66 20 74 68 69 73 20 0a value of this .
42e0: 20 20 2a 2a 20 66 75 6e 63 74 69 6f 6e 20 73 68 ** function sh
42f0: 6f 75 6c 64 20 6e 65 76 65 72 20 62 65 20 75 73 ould never be us
4300: 65 64 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 65 ed.. **. ** We
4310: 20 72 65 74 75 72 6e 20 2d 31 30 30 30 30 30 30 return -1000000
4320: 20 69 6e 73 74 65 61 64 20 6f 66 20 74 68 65 20 instead of the
4330: 6d 6f 72 65 20 75 73 75 61 6c 20 2d 31 20 73 69 more usual -1 si
4340: 6d 70 6c 79 20 62 65 63 61 75 73 65 20 75 73 69 mply because usi
4350: 6e 67 0a 20 20 2a 2a 20 2d 31 30 30 30 30 30 30 ng. ** -1000000
4360: 20 61 73 20 74 68 65 20 69 6e 63 6f 72 72 65 63 as the incorrec
4370: 74 20 69 6e 64 65 78 20 69 6e 74 6f 20 64 62 2d t index into db-
4380: 3e 61 44 62 5b 5d 20 69 73 20 6d 75 63 68 20 0a >aDb[] is much .
4390: 20 20 2a 2a 20 6d 6f 72 65 20 6c 69 6b 65 6c 79 ** more likely
43a0: 20 74 6f 20 63 61 75 73 65 20 61 20 73 65 67 66 to cause a segf
43b0: 61 75 6c 74 20 74 68 61 6e 20 2d 31 20 28 6f 66 ault than -1 (of
43c0: 20 63 6f 75 72 73 65 20 74 68 65 72 65 20 61 72 course there ar
43d0: 65 20 61 73 73 65 72 74 28 29 0a 20 20 2a 2a 20 e assert(). **
43e0: 73 74 61 74 65 6d 65 6e 74 73 20 74 6f 6f 2c 20 statements too,
43f0: 62 75 74 20 69 74 20 6e 65 76 65 72 20 68 75 72 but it never hur
4400: 74 73 20 74 6f 20 70 6c 61 79 20 74 68 65 20 6f ts to play the o
4410: 64 64 73 29 2e 0a 20 20 2a 2f 0a 20 20 61 73 73 dds).. */. ass
4420: 65 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 ert( sqlite3_mut
4430: 65 78 5f 68 65 6c 64 28 64 62 2d 3e 6d 75 74 65 ex_held(db->mute
4440: 78 29 20 29 3b 0a 20 20 69 66 28 20 70 53 63 68 x) );. if( pSch
4450: 65 6d 61 20 29 7b 0a 20 20 20 20 66 6f 72 28 69 ema ){. for(i
4460: 3d 30 3b 20 31 3b 20 69 2b 2b 29 7b 0a 20 20 20 =0; 1; i++){.
4470: 20 20 20 61 73 73 65 72 74 28 20 69 3c 64 62 2d assert( i<db-
4480: 3e 6e 44 62 20 29 3b 0a 20 20 20 20 20 20 69 66 >nDb );. if
4490: 28 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 53 63 ( db->aDb[i].pSc
44a0: 68 65 6d 61 3d 3d 70 53 63 68 65 6d 61 20 29 7b hema==pSchema ){
44b0: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a . break;.
44c0: 20 20 20 20 20 20 7d 0a 20 20 20 20 7d 0a 20 20 }. }.
44d0: 20 20 61 73 73 65 72 74 28 20 69 3e 3d 30 20 26 assert( i>=0 &
44e0: 26 20 69 3c 64 62 2d 3e 6e 44 62 20 29 3b 0a 20 & i<db->nDb );.
44f0: 20 7d 0a 20 20 72 65 74 75 72 6e 20 69 3b 0a 7d }. return i;.}
4500: 0a 0a 2f 2a 0a 2a 2a 20 46 72 65 65 20 61 6c 6c ../*.** Free all
4510: 20 6d 65 6d 6f 72 79 20 61 6c 6c 6f 63 61 74 69 memory allocati
4520: 6f 6e 73 20 69 6e 20 74 68 65 20 70 50 61 72 73 ons in the pPars
4530: 65 20 6f 62 6a 65 63 74 0a 2a 2f 0a 76 6f 69 64 e object.*/.void
4540: 20 73 71 6c 69 74 65 33 50 61 72 73 65 72 52 65 sqlite3ParserRe
4550: 73 65 74 28 50 61 72 73 65 20 2a 70 50 61 72 73 set(Parse *pPars
4560: 65 29 7b 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 e){. sqlite3 *d
4570: 62 20 3d 20 70 50 61 72 73 65 2d 3e 64 62 3b 0a b = pParse->db;.
4580: 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 65 28 sqlite3DbFree(
4590: 64 62 2c 20 70 50 61 72 73 65 2d 3e 61 4c 61 62 db, pParse->aLab
45a0: 65 6c 29 3b 0a 20 20 73 71 6c 69 74 65 33 45 78 el);. sqlite3Ex
45b0: 70 72 4c 69 73 74 44 65 6c 65 74 65 28 64 62 2c prListDelete(db,
45c0: 20 70 50 61 72 73 65 2d 3e 70 43 6f 6e 73 74 45 pParse->pConstE
45d0: 78 70 72 29 3b 0a 20 20 69 66 28 20 64 62 20 29 xpr);. if( db )
45e0: 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 73 71 {. assert( sq
45f0: 6c 69 74 65 33 4c 6f 6f 6b 61 73 69 64 65 44 69 lite3LookasideDi
4600: 73 61 62 6c 65 64 28 26 64 62 2d 3e 6c 6f 6f 6b sabled(&db->look
4610: 61 73 69 64 65 29 20 3e 3d 20 70 50 61 72 73 65 aside) >= pParse
4620: 2d 3e 64 69 73 61 62 6c 65 4c 6f 6f 6b 61 73 69 ->disableLookasi
4630: 64 65 20 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 de );. sqlite
4640: 33 4c 6f 6f 6b 61 73 69 64 65 45 6e 61 62 6c 65 3LookasideEnable
4650: 43 6e 74 28 26 64 62 2d 3e 6c 6f 6f 6b 61 73 69 Cnt(&db->lookasi
4660: 64 65 2c 20 70 50 61 72 73 65 2d 3e 64 69 73 61 de, pParse->disa
4670: 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 29 3b 0a 20 bleLookaside);.
4680: 20 7d 0a 20 20 70 50 61 72 73 65 2d 3e 64 69 73 }. pParse->dis
4690: 61 62 6c 65 4c 6f 6f 6b 61 73 69 64 65 20 3d 20 ableLookaside =
46a0: 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 6f 6d 70 0;.}../*.** Comp
46b0: 69 6c 65 20 74 68 65 20 55 54 46 2d 38 20 65 6e ile the UTF-8 en
46c0: 63 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d coded SQL statem
46d0: 65 6e 74 20 7a 53 71 6c 20 69 6e 74 6f 20 61 20 ent zSql into a
46e0: 73 74 61 74 65 6d 65 6e 74 20 68 61 6e 64 6c 65 statement handle
46f0: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
4700: 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 28 0a sqlite3Prepare(.
4710: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 sqlite3 *db,
4720: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 /* D
4730: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 atabase handle.
4740: 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 */. const char
4750: 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f *zSql, /
4760: 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 * UTF-8 encoded
4770: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a SQL statement. *
4780: 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 /. int nBytes,
4790: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
47a0: 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 Length of zSql
47b0: 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 75 in bytes. */. u
47c0: 33 32 20 70 72 65 70 46 6c 61 67 73 2c 20 20 20 32 prepFlags,
47d0: 20 20 20 20 20 20 20 20 20 2f 2a 20 5a 65 72 6f /* Zero
47e0: 20 6f 72 20 6d 6f 72 65 20 53 51 4c 49 54 45 5f or more SQLITE_
47f0: 50 52 45 50 41 52 45 5f 2a 20 66 6c 61 67 73 20 PREPARE_* flags
4800: 2a 2f 0a 20 20 56 64 62 65 20 2a 70 52 65 70 72 */. Vdbe *pRepr
4810: 65 70 61 72 65 2c 20 20 20 20 20 20 20 20 20 2f epare, /
4820: 2a 20 56 4d 20 62 65 69 6e 67 20 72 65 70 72 65 * VM being repre
4830: 70 61 72 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 pared */. sqlit
4840: 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 e3_stmt **ppStmt
4850: 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 , /* OUT: A p
4860: 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 ointer to the pr
4870: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 epared statement
4880: 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 */. const char
4890: 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 **pzTail
48a0: 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 /* OUT: End of p
48b0: 61 72 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a arsed string */.
48c0: 29 7b 0a 20 20 63 68 61 72 20 2a 7a 45 72 72 4d ){. char *zErrM
48d0: 73 67 20 3d 20 30 3b 20 20 20 20 20 20 20 20 2f sg = 0; /
48e0: 2a 20 45 72 72 6f 72 20 6d 65 73 73 61 67 65 20 * Error message
48f0: 2a 2f 0a 20 20 69 6e 74 20 72 63 20 3d 20 53 51 */. int rc = SQ
4900: 4c 49 54 45 5f 4f 4b 3b 20 20 20 20 20 20 20 2f LITE_OK; /
4910: 2a 20 52 65 73 75 6c 74 20 63 6f 64 65 20 2a 2f * Result code */
4920: 0a 20 20 69 6e 74 20 69 3b 20 20 20 20 20 20 20 . int i;
4930: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
4940: 4c 6f 6f 70 20 63 6f 75 6e 74 65 72 20 2a 2f 0a Loop counter */.
4950: 20 20 50 61 72 73 65 20 73 50 61 72 73 65 3b 20 Parse sParse;
4960: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 50 /* P
4970: 61 72 73 69 6e 67 20 63 6f 6e 74 65 78 74 20 2a arsing context *
4980: 2f 0a 0a 20 20 6d 65 6d 73 65 74 28 26 73 50 61 /.. memset(&sPa
4990: 72 73 65 2c 20 30 2c 20 50 41 52 53 45 5f 48 44 rse, 0, PARSE_HD
49a0: 52 5f 53 5a 29 3b 0a 20 20 6d 65 6d 73 65 74 28 R_SZ);. memset(
49b0: 50 41 52 53 45 5f 54 41 49 4c 28 26 73 50 61 72 PARSE_TAIL(&sPar
49c0: 73 65 29 2c 20 30 2c 20 50 41 52 53 45 5f 54 41 se), 0, PARSE_TA
49d0: 49 4c 5f 53 5a 29 3b 0a 20 20 73 50 61 72 73 65 IL_SZ);. sParse
49e0: 2e 70 52 65 70 72 65 70 61 72 65 20 3d 20 70 52 .pReprepare = pR
49f0: 65 70 72 65 70 61 72 65 3b 0a 20 20 61 73 73 65 eprepare;. asse
4a00: 72 74 28 20 70 70 53 74 6d 74 20 26 26 20 2a 70 rt( ppStmt && *p
4a10: 70 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 2f 2a pStmt==0 );. /*
4a20: 20 61 73 73 65 72 74 28 20 21 64 62 2d 3e 6d 61 assert( !db->ma
4a30: 6c 6c 6f 63 46 61 69 6c 65 64 20 29 3b 20 2f 2f llocFailed ); //
4a40: 20 6e 6f 74 20 74 72 75 65 20 77 69 74 68 20 53 not true with S
4a50: 51 4c 49 54 45 5f 55 53 45 5f 41 4c 4c 4f 43 41 QLITE_USE_ALLOCA
4a60: 20 2a 2f 0a 20 20 61 73 73 65 72 74 28 20 73 71 */. assert( sq
4a70: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 lite3_mutex_held
4a80: 28 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 0a (db->mutex) );..
4a90: 20 20 2f 2a 20 46 6f 72 20 61 20 6c 6f 6e 67 2d /* For a long-
4aa0: 74 65 72 6d 20 75 73 65 20 70 72 65 70 61 72 65 term use prepare
4ab0: 64 20 73 74 61 74 65 6d 65 6e 74 20 61 76 6f 69 d statement avoi
4ac0: 64 20 74 68 65 20 75 73 65 20 6f 66 0a 20 20 2a d the use of. *
4ad0: 2a 20 6c 6f 6f 6b 61 73 69 64 65 20 6d 65 6d 6f * lookaside memo
4ae0: 72 79 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 70 ry.. */. if( p
4af0: 72 65 70 46 6c 61 67 73 20 26 20 53 51 4c 49 54 repFlags & SQLIT
4b00: 45 5f 50 52 45 50 41 52 45 5f 50 45 52 53 49 53 E_PREPARE_PERSIS
4b10: 54 45 4e 54 20 29 7b 0a 20 20 20 20 73 50 61 72 TENT ){. sPar
4b20: 73 65 2e 64 69 73 61 62 6c 65 4c 6f 6f 6b 61 73 se.disableLookas
4b30: 69 64 65 2b 2b 3b 0a 20 20 20 20 73 71 6c 69 74 ide++;. sqlit
4b40: 65 33 4c 6f 6f 6b 61 73 69 64 65 44 69 73 61 62 e3LookasideDisab
4b50: 6c 65 28 26 64 62 2d 3e 6c 6f 6f 6b 61 73 69 64 le(&db->lookasid
4b60: 65 29 3b 0a 20 20 7d 0a 20 20 73 50 61 72 73 65 e);. }. sParse
4b70: 2e 64 69 73 61 62 6c 65 56 74 61 62 20 3d 20 28 .disableVtab = (
4b80: 70 72 65 70 46 6c 61 67 73 20 26 20 53 51 4c 49 prepFlags & SQLI
4b90: 54 45 5f 50 52 45 50 41 52 45 5f 4e 4f 5f 56 54 TE_PREPARE_NO_VT
4ba0: 41 42 29 21 3d 30 3b 0a 0a 20 20 2f 2a 20 43 68 AB)!=0;.. /* Ch
4bb0: 65 63 6b 20 74 6f 20 76 65 72 69 66 79 20 74 68 eck to verify th
4bc0: 61 74 20 69 74 20 69 73 20 70 6f 73 73 69 62 6c at it is possibl
4bd0: 65 20 74 6f 20 67 65 74 20 61 20 72 65 61 64 20 e to get a read
4be0: 6c 6f 63 6b 20 6f 6e 20 61 6c 6c 0a 20 20 2a 2a lock on all. **
4bf0: 20 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 database schema
4c00: 73 2e 20 20 54 68 65 20 69 6e 61 62 69 6c 69 74 s. The inabilit
4c10: 79 20 74 6f 20 67 65 74 20 61 20 72 65 61 64 20 y to get a read
4c20: 6c 6f 63 6b 20 69 6e 64 69 63 61 74 65 73 20 74 lock indicates t
4c30: 68 61 74 0a 20 20 2a 2a 20 73 6f 6d 65 20 6f 74 hat. ** some ot
4c40: 68 65 72 20 64 61 74 61 62 61 73 65 20 63 6f 6e her database con
4c50: 6e 65 63 74 69 6f 6e 20 69 73 20 68 6f 6c 64 69 nection is holdi
4c60: 6e 67 20 61 20 77 72 69 74 65 2d 6c 6f 63 6b 2c ng a write-lock,
4c70: 20 77 68 69 63 68 20 69 6e 0a 20 20 2a 2a 20 74 which in. ** t
4c80: 75 72 6e 20 6d 65 61 6e 73 20 74 68 61 74 20 74 urn means that t
4c90: 68 65 20 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 he other connect
4ca0: 69 6f 6e 20 68 61 73 20 6d 61 64 65 20 75 6e 63 ion has made unc
4cb0: 6f 6d 6d 69 74 74 65 64 20 63 68 61 6e 67 65 73 ommitted changes
4cc0: 0a 20 20 2a 2a 20 74 6f 20 74 68 65 20 73 63 68 . ** to the sch
4cd0: 65 6d 61 2e 0a 20 20 2a 2a 0a 20 20 2a 2a 20 57 ema.. **. ** W
4ce0: 65 72 65 20 77 65 20 74 6f 20 70 72 6f 63 65 65 ere we to procee
4cf0: 64 20 61 6e 64 20 70 72 65 70 61 72 65 20 74 68 d and prepare th
4d00: 65 20 73 74 61 74 65 6d 65 6e 74 20 61 67 61 69 e statement agai
4d10: 6e 73 74 20 74 68 65 20 75 6e 63 6f 6d 6d 69 74 nst the uncommit
4d20: 74 65 64 0a 20 20 2a 2a 20 73 63 68 65 6d 61 20 ted. ** schema
4d30: 63 68 61 6e 67 65 73 20 61 6e 64 20 69 66 20 74 changes and if t
4d40: 68 6f 73 65 20 73 63 68 65 6d 61 20 63 68 61 6e hose schema chan
4d50: 67 65 73 20 61 72 65 20 73 75 62 73 65 71 75 65 ges are subseque
4d60: 6e 74 6c 79 20 72 6f 6c 6c 65 64 0a 20 20 2a 2a ntly rolled. **
4d70: 20 62 61 63 6b 20 61 6e 64 20 64 69 66 66 65 72 back and differ
4d80: 65 6e 74 20 63 68 61 6e 67 65 73 20 61 72 65 20 ent changes are
4d90: 6d 61 64 65 20 69 6e 20 74 68 65 69 72 20 70 6c made in their pl
4da0: 61 63 65 2c 20 74 68 65 6e 20 77 68 65 6e 20 74 ace, then when t
4db0: 68 69 73 0a 20 20 2a 2a 20 70 72 65 70 61 72 65 his. ** prepare
4dc0: 64 20 73 74 61 74 65 6d 65 6e 74 20 67 6f 65 73 d statement goes
4dd0: 20 74 6f 20 72 75 6e 20 74 68 65 20 73 63 68 65 to run the sche
4de0: 6d 61 20 63 6f 6f 6b 69 65 20 77 6f 75 6c 64 20 ma cookie would
4df0: 66 61 69 6c 20 74 6f 20 64 65 74 65 63 74 0a 20 fail to detect.
4e00: 20 2a 2a 20 74 68 65 20 73 63 68 65 6d 61 20 63 ** the schema c
4e10: 68 61 6e 67 65 2e 20 20 44 69 73 61 73 74 65 72 hange. Disaster
4e20: 20 77 6f 75 6c 64 20 66 6f 6c 6c 6f 77 2e 0a 20 would follow..
4e30: 20 2a 2a 0a 20 20 2a 2a 20 54 68 69 73 20 74 68 **. ** This th
4e40: 72 65 61 64 20 69 73 20 63 75 72 72 65 6e 74 6c read is currentl
4e50: 79 20 68 6f 6c 64 69 6e 67 20 6d 75 74 65 78 65 y holding mutexe
4e60: 73 20 6f 6e 20 61 6c 6c 20 42 74 72 65 65 73 20 s on all Btrees
4e70: 28 62 65 63 61 75 73 65 0a 20 20 2a 2a 20 6f 66 (because. ** of
4e80: 20 74 68 65 20 73 71 6c 69 74 65 33 42 74 72 65 the sqlite3Btre
4e90: 65 45 6e 74 65 72 41 6c 6c 28 29 20 69 6e 20 73 eEnterAll() in s
4ea0: 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 qlite3LockAndPre
4eb0: 70 61 72 65 28 29 29 20 73 6f 20 69 74 0a 20 20 pare()) so it.
4ec0: 2a 2a 20 69 73 20 6e 6f 74 20 70 6f 73 73 69 62 ** is not possib
4ed0: 6c 65 20 66 6f 72 20 61 6e 6f 74 68 65 72 20 74 le for another t
4ee0: 68 72 65 61 64 20 74 6f 20 73 74 61 72 74 20 61 hread to start a
4ef0: 20 6e 65 77 20 73 63 68 65 6d 61 20 63 68 61 6e new schema chan
4f00: 67 65 0a 20 20 2a 2a 20 77 68 69 6c 65 20 74 68 ge. ** while th
4f10: 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20 72 75 is routine is ru
4f20: 6e 6e 69 6e 67 2e 20 20 48 65 6e 63 65 2c 20 77 nning. Hence, w
4f30: 65 20 64 6f 20 6e 6f 74 20 6e 65 65 64 20 74 6f e do not need to
4f40: 20 68 6f 6c 64 20 0a 20 20 2a 2a 20 6c 6f 63 6b hold . ** lock
4f50: 73 20 6f 6e 20 74 68 65 20 73 63 68 65 6d 61 2c s on the schema,
4f60: 20 77 65 20 6a 75 73 74 20 6e 65 65 64 20 74 6f we just need to
4f70: 20 6d 61 6b 65 20 73 75 72 65 20 6e 6f 62 6f 64 make sure nobod
4f80: 79 20 65 6c 73 65 20 69 73 20 0a 20 20 2a 2a 20 y else is . **
4f90: 68 6f 6c 64 69 6e 67 20 74 68 65 6d 2e 0a 20 20 holding them..
4fa0: 2a 2a 0a 20 20 2a 2a 20 4e 6f 74 65 20 74 68 61 **. ** Note tha
4fb0: 74 20 73 65 74 74 69 6e 67 20 52 45 41 44 5f 55 t setting READ_U
4fc0: 4e 43 4f 4d 4d 49 54 54 45 44 20 6f 76 65 72 72 NCOMMITTED overr
4fd0: 69 64 65 73 20 6d 6f 73 74 20 6c 6f 63 6b 20 64 ides most lock d
4fe0: 65 74 65 63 74 69 6f 6e 2c 0a 20 20 2a 2a 20 62 etection,. ** b
4ff0: 75 74 20 69 74 20 64 6f 65 73 20 2a 6e 6f 74 2a ut it does *not*
5000: 20 6f 76 65 72 72 69 64 65 20 73 63 68 65 6d 61 override schema
5010: 20 6c 6f 63 6b 20 64 65 74 65 63 74 69 6f 6e 2c lock detection,
5020: 20 73 6f 20 74 68 69 73 20 61 6c 6c 20 73 74 69 so this all sti
5030: 6c 6c 0a 20 20 2a 2a 20 77 6f 72 6b 73 20 65 76 ll. ** works ev
5040: 65 6e 20 69 66 20 52 45 41 44 5f 55 4e 43 4f 4d en if READ_UNCOM
5050: 4d 49 54 54 45 44 20 69 73 20 73 65 74 2e 0a 20 MITTED is set..
5060: 20 2a 2f 0a 20 20 69 66 28 20 21 64 62 2d 3e 6e */. if( !db->n
5070: 6f 53 68 61 72 65 64 43 61 63 68 65 20 29 7b 0a oSharedCache ){.
5080: 20 20 20 20 66 6f 72 28 69 3d 30 3b 20 69 3c 64 for(i=0; i<d
5090: 62 2d 3e 6e 44 62 3b 20 69 2b 2b 29 20 7b 0a 20 b->nDb; i++) {.
50a0: 20 20 20 20 20 42 74 72 65 65 20 2a 70 42 74 20 Btree *pBt
50b0: 3d 20 64 62 2d 3e 61 44 62 5b 69 5d 2e 70 42 74 = db->aDb[i].pBt
50c0: 3b 0a 20 20 20 20 20 20 69 66 28 20 70 42 74 20 ;. if( pBt
50d0: 29 7b 0a 20 20 20 20 20 20 20 20 61 73 73 65 72 ){. asser
50e0: 74 28 20 73 71 6c 69 74 65 33 42 74 72 65 65 48 t( sqlite3BtreeH
50f0: 6f 6c 64 73 4d 75 74 65 78 28 70 42 74 29 20 29 oldsMutex(pBt) )
5100: 3b 0a 20 20 20 20 20 20 20 20 72 63 20 3d 20 73 ;. rc = s
5110: 71 6c 69 74 65 33 42 74 72 65 65 53 63 68 65 6d qlite3BtreeSchem
5120: 61 4c 6f 63 6b 65 64 28 70 42 74 29 3b 0a 20 20 aLocked(pBt);.
5130: 20 20 20 20 20 20 69 66 28 20 72 63 20 29 7b 0a if( rc ){.
5140: 20 20 20 20 20 20 20 20 20 20 63 6f 6e 73 74 20 const
5150: 63 68 61 72 20 2a 7a 44 62 20 3d 20 64 62 2d 3e char *zDb = db->
5160: 61 44 62 5b 69 5d 2e 7a 44 62 53 4e 61 6d 65 3b aDb[i].zDbSName;
5170: 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 . sqlit
5180: 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 64 e3ErrorWithMsg(d
5190: 62 2c 20 72 63 2c 20 22 64 61 74 61 62 61 73 65 b, rc, "database
51a0: 20 73 63 68 65 6d 61 20 69 73 20 6c 6f 63 6b 65 schema is locke
51b0: 64 3a 20 25 73 22 2c 20 7a 44 62 29 3b 0a 20 20 d: %s", zDb);.
51c0: 20 20 20 20 20 20 20 20 74 65 73 74 63 61 73 65 testcase
51d0: 28 20 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 ( db->flags & SQ
51e0: 4c 49 54 45 5f 52 65 61 64 55 6e 63 6f 6d 6d 69 LITE_ReadUncommi
51f0: 74 20 29 3b 0a 20 20 20 20 20 20 20 20 20 20 67 t );. g
5200: 6f 74 6f 20 65 6e 64 5f 70 72 65 70 61 72 65 3b oto end_prepare;
5210: 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 . }.
5220: 20 7d 0a 20 20 20 20 7d 0a 20 20 7d 0a 0a 20 20 }. }. }..
5230: 73 71 6c 69 74 65 33 56 74 61 62 55 6e 6c 6f 63 sqlite3VtabUnloc
5240: 6b 4c 69 73 74 28 64 62 29 3b 0a 0a 20 20 73 50 kList(db);.. sP
5250: 61 72 73 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20 arse.db = db;.
5260: 69 66 28 20 6e 42 79 74 65 73 3e 3d 30 20 26 26 if( nBytes>=0 &&
5270: 20 28 6e 42 79 74 65 73 3d 3d 30 20 7c 7c 20 7a (nBytes==0 || z
5280: 53 71 6c 5b 6e 42 79 74 65 73 2d 31 5d 21 3d 30 Sql[nBytes-1]!=0
5290: 29 20 29 7b 0a 20 20 20 20 63 68 61 72 20 2a 7a ) ){. char *z
52a0: 53 71 6c 43 6f 70 79 3b 0a 20 20 20 20 69 6e 74 SqlCopy;. int
52b0: 20 6d 78 4c 65 6e 20 3d 20 64 62 2d 3e 61 4c 69 mxLen = db->aLi
52c0: 6d 69 74 5b 53 51 4c 49 54 45 5f 4c 49 4d 49 54 mit[SQLITE_LIMIT
52d0: 5f 53 51 4c 5f 4c 45 4e 47 54 48 5d 3b 0a 20 20 _SQL_LENGTH];.
52e0: 20 20 74 65 73 74 63 61 73 65 28 20 6e 42 79 74 testcase( nByt
52f0: 65 73 3d 3d 6d 78 4c 65 6e 20 29 3b 0a 20 20 20 es==mxLen );.
5300: 20 74 65 73 74 63 61 73 65 28 20 6e 42 79 74 65 testcase( nByte
5310: 73 3d 3d 6d 78 4c 65 6e 2b 31 20 29 3b 0a 20 20 s==mxLen+1 );.
5320: 20 20 69 66 28 20 6e 42 79 74 65 73 3e 6d 78 4c if( nBytes>mxL
5330: 65 6e 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 en ){. sqli
5340: 74 65 33 45 72 72 6f 72 57 69 74 68 4d 73 67 28 te3ErrorWithMsg(
5350: 64 62 2c 20 53 51 4c 49 54 45 5f 54 4f 4f 42 49 db, SQLITE_TOOBI
5360: 47 2c 20 22 73 74 61 74 65 6d 65 6e 74 20 74 6f G, "statement to
5370: 6f 20 6c 6f 6e 67 22 29 3b 0a 20 20 20 20 20 20 o long");.
5380: 72 63 20 3d 20 73 71 6c 69 74 65 33 41 70 69 45 rc = sqlite3ApiE
5390: 78 69 74 28 64 62 2c 20 53 51 4c 49 54 45 5f 54 xit(db, SQLITE_T
53a0: 4f 4f 42 49 47 29 3b 0a 20 20 20 20 20 20 67 6f OOBIG);. go
53b0: 74 6f 20 65 6e 64 5f 70 72 65 70 61 72 65 3b 0a to end_prepare;.
53c0: 20 20 20 20 7d 0a 20 20 20 20 7a 53 71 6c 43 6f }. zSqlCo
53d0: 70 79 20 3d 20 73 71 6c 69 74 65 33 44 62 53 74 py = sqlite3DbSt
53e0: 72 4e 44 75 70 28 64 62 2c 20 7a 53 71 6c 2c 20 rNDup(db, zSql,
53f0: 6e 42 79 74 65 73 29 3b 0a 20 20 20 20 69 66 28 nBytes);. if(
5400: 20 7a 53 71 6c 43 6f 70 79 20 29 7b 0a 20 20 20 zSqlCopy ){.
5410: 20 20 20 73 71 6c 69 74 65 33 52 75 6e 50 61 72 sqlite3RunPar
5420: 73 65 72 28 26 73 50 61 72 73 65 2c 20 7a 53 71 ser(&sParse, zSq
5430: 6c 43 6f 70 79 2c 20 26 7a 45 72 72 4d 73 67 29 lCopy, &zErrMsg)
5440: 3b 0a 20 20 20 20 20 20 73 50 61 72 73 65 2e 7a ;. sParse.z
5450: 54 61 69 6c 20 3d 20 26 7a 53 71 6c 5b 73 50 61 Tail = &zSql[sPa
5460: 72 73 65 2e 7a 54 61 69 6c 2d 7a 53 71 6c 43 6f rse.zTail-zSqlCo
5470: 70 79 5d 3b 0a 20 20 20 20 20 20 73 71 6c 69 74 py];. sqlit
5480: 65 33 44 62 46 72 65 65 28 64 62 2c 20 7a 53 71 e3DbFree(db, zSq
5490: 6c 43 6f 70 79 29 3b 0a 20 20 20 20 7d 65 6c 73 lCopy);. }els
54a0: 65 7b 0a 20 20 20 20 20 20 73 50 61 72 73 65 2e e{. sParse.
54b0: 7a 54 61 69 6c 20 3d 20 26 7a 53 71 6c 5b 6e 42 zTail = &zSql[nB
54c0: 79 74 65 73 5d 3b 0a 20 20 20 20 7d 0a 20 20 7d ytes];. }. }
54d0: 65 6c 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 else{. sqlite
54e0: 33 52 75 6e 50 61 72 73 65 72 28 26 73 50 61 72 3RunParser(&sPar
54f0: 73 65 2c 20 7a 53 71 6c 2c 20 26 7a 45 72 72 4d se, zSql, &zErrM
5500: 73 67 29 3b 0a 20 20 7d 0a 20 20 61 73 73 65 72 sg);. }. asser
5510: 74 28 20 30 3d 3d 73 50 61 72 73 65 2e 6e 51 75 t( 0==sParse.nQu
5520: 65 72 79 4c 6f 6f 70 20 29 3b 0a 0a 20 20 69 66 eryLoop );.. if
5530: 28 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 51 4c ( sParse.rc==SQL
5540: 49 54 45 5f 44 4f 4e 45 20 29 20 73 50 61 72 73 ITE_DONE ) sPars
5550: 65 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f 4b e.rc = SQLITE_OK
5560: 3b 0a 20 20 69 66 28 20 73 50 61 72 73 65 2e 63 ;. if( sParse.c
5570: 68 65 63 6b 53 63 68 65 6d 61 20 29 7b 0a 20 20 heckSchema ){.
5580: 20 20 73 63 68 65 6d 61 49 73 56 61 6c 69 64 28 schemaIsValid(
5590: 26 73 50 61 72 73 65 29 3b 0a 20 20 7d 0a 20 20 &sParse);. }.
55a0: 69 66 28 20 64 62 2d 3e 6d 61 6c 6c 6f 63 46 61 if( db->mallocFa
55b0: 69 6c 65 64 20 29 7b 0a 20 20 20 20 73 50 61 72 iled ){. sPar
55c0: 73 65 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e se.rc = SQLITE_N
55d0: 4f 4d 45 4d 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 OMEM_BKPT;. }.
55e0: 20 69 66 28 20 70 7a 54 61 69 6c 20 29 7b 0a 20 if( pzTail ){.
55f0: 20 20 20 2a 70 7a 54 61 69 6c 20 3d 20 73 50 61 *pzTail = sPa
5600: 72 73 65 2e 7a 54 61 69 6c 3b 0a 20 20 7d 0a 20 rse.zTail;. }.
5610: 20 72 63 20 3d 20 73 50 61 72 73 65 2e 72 63 3b rc = sParse.rc;
5620: 0a 0a 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 ..#ifndef SQLITE
5630: 5f 4f 4d 49 54 5f 45 58 50 4c 41 49 4e 0a 20 20 _OMIT_EXPLAIN.
5640: 2f 2a 20 4a 75 73 74 69 66 69 63 61 74 69 6f 6e /* Justification
5650: 20 66 6f 72 20 74 68 65 20 41 4c 57 41 59 53 28 for the ALWAYS(
5660: 29 3a 20 54 68 65 20 6f 6e 6c 79 20 77 61 79 20 ): The only way
5670: 66 6f 72 20 72 63 20 74 6f 20 62 65 20 53 51 4c for rc to be SQL
5680: 49 54 45 5f 4f 4b 20 61 6e 64 0a 20 20 2a 2a 20 ITE_OK and. **
5690: 73 50 61 72 73 65 2e 70 56 64 62 65 20 74 6f 20 sParse.pVdbe to
56a0: 62 65 20 4e 55 4c 4c 20 69 73 20 69 66 20 74 68 be NULL is if th
56b0: 65 20 69 6e 70 75 74 20 53 51 4c 20 69 73 20 61 e input SQL is a
56c0: 6e 20 65 6d 70 74 79 20 73 74 72 69 6e 67 2c 20 n empty string,
56d0: 62 75 74 20 69 6e 0a 20 20 2a 2a 20 74 68 61 74 but in. ** that
56e0: 20 63 61 73 65 2c 20 73 50 61 72 73 65 2e 65 78 case, sParse.ex
56f0: 70 6c 61 69 6e 20 77 69 6c 6c 20 62 65 20 66 61 plain will be fa
5700: 6c 73 65 2e 20 2a 2f 0a 20 20 69 66 28 20 73 50 lse. */. if( sP
5710: 61 72 73 65 2e 65 78 70 6c 61 69 6e 20 26 26 20 arse.explain &&
5720: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 26 26 rc==SQLITE_OK &&
5730: 20 41 4c 57 41 59 53 28 73 50 61 72 73 65 2e 70 ALWAYS(sParse.p
5740: 56 64 62 65 29 20 29 7b 0a 20 20 20 20 73 74 61 Vdbe) ){. sta
5750: 74 69 63 20 63 6f 6e 73 74 20 63 68 61 72 20 2a tic const char *
5760: 20 63 6f 6e 73 74 20 61 7a 43 6f 6c 4e 61 6d 65 const azColName
5770: 5b 5d 20 3d 20 7b 0a 20 20 20 20 20 20 20 22 61 [] = {. "a
5780: 64 64 72 22 2c 20 22 6f 70 63 6f 64 65 22 2c 20 ddr", "opcode",
5790: 22 70 31 22 2c 20 22 70 32 22 2c 20 22 70 33 22 "p1", "p2", "p3"
57a0: 2c 20 22 70 34 22 2c 20 22 70 35 22 2c 20 22 63 , "p4", "p5", "c
57b0: 6f 6d 6d 65 6e 74 22 2c 0a 20 20 20 20 20 20 20 omment",.
57c0: 22 69 64 22 2c 20 22 70 61 72 65 6e 74 22 2c 20 "id", "parent",
57d0: 22 6e 6f 74 75 73 65 64 22 2c 20 22 64 65 74 61 "notused", "deta
57e0: 69 6c 22 0a 20 20 20 20 7d 3b 0a 20 20 20 20 69 il". };. i
57f0: 6e 74 20 69 46 69 72 73 74 2c 20 6d 78 3b 0a 20 nt iFirst, mx;.
5800: 20 20 20 69 66 28 20 73 50 61 72 73 65 2e 65 78 if( sParse.ex
5810: 70 6c 61 69 6e 3d 3d 32 20 29 7b 0a 20 20 20 20 plain==2 ){.
5820: 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 65 74 sqlite3VdbeSet
5830: 4e 75 6d 43 6f 6c 73 28 73 50 61 72 73 65 2e 70 NumCols(sParse.p
5840: 56 64 62 65 2c 20 34 29 3b 0a 20 20 20 20 20 20 Vdbe, 4);.
5850: 69 46 69 72 73 74 20 3d 20 38 3b 0a 20 20 20 20 iFirst = 8;.
5860: 20 20 6d 78 20 3d 20 31 32 3b 0a 20 20 20 20 7d mx = 12;. }
5870: 65 6c 73 65 7b 0a 20 20 20 20 20 20 73 71 6c 69 else{. sqli
5880: 74 65 33 56 64 62 65 53 65 74 4e 75 6d 43 6f 6c te3VdbeSetNumCol
5890: 73 28 73 50 61 72 73 65 2e 70 56 64 62 65 2c 20 s(sParse.pVdbe,
58a0: 38 29 3b 0a 20 20 20 20 20 20 69 46 69 72 73 74 8);. iFirst
58b0: 20 3d 20 30 3b 0a 20 20 20 20 20 20 6d 78 20 3d = 0;. mx =
58c0: 20 38 3b 0a 20 20 20 20 7d 0a 20 20 20 20 66 6f 8;. }. fo
58d0: 72 28 69 3d 69 46 69 72 73 74 3b 20 69 3c 6d 78 r(i=iFirst; i<mx
58e0: 3b 20 69 2b 2b 29 7b 0a 20 20 20 20 20 20 73 71 ; i++){. sq
58f0: 6c 69 74 65 33 56 64 62 65 53 65 74 43 6f 6c 4e lite3VdbeSetColN
5900: 61 6d 65 28 73 50 61 72 73 65 2e 70 56 64 62 65 ame(sParse.pVdbe
5910: 2c 20 69 2d 69 46 69 72 73 74 2c 20 43 4f 4c 4e , i-iFirst, COLN
5920: 41 4d 45 5f 4e 41 4d 45 2c 0a 20 20 20 20 20 20 AME_NAME,.
5930: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
5940: 20 20 20 20 20 20 61 7a 43 6f 6c 4e 61 6d 65 5b azColName[
5950: 69 5d 2c 20 53 51 4c 49 54 45 5f 53 54 41 54 49 i], SQLITE_STATI
5960: 43 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 23 65 C);. }. }.#e
5970: 6e 64 69 66 0a 0a 20 20 69 66 28 20 64 62 2d 3e ndif.. if( db->
5980: 69 6e 69 74 2e 62 75 73 79 3d 3d 30 20 29 7b 0a init.busy==0 ){.
5990: 20 20 20 20 73 71 6c 69 74 65 33 56 64 62 65 53 sqlite3VdbeS
59a0: 65 74 53 71 6c 28 73 50 61 72 73 65 2e 70 56 64 etSql(sParse.pVd
59b0: 62 65 2c 20 7a 53 71 6c 2c 20 28 69 6e 74 29 28 be, zSql, (int)(
59c0: 73 50 61 72 73 65 2e 7a 54 61 69 6c 2d 7a 53 71 sParse.zTail-zSq
59d0: 6c 29 2c 20 70 72 65 70 46 6c 61 67 73 29 3b 0a l), prepFlags);.
59e0: 20 20 7d 0a 20 20 69 66 28 20 72 63 21 3d 53 51 }. if( rc!=SQ
59f0: 4c 49 54 45 5f 4f 4b 20 7c 7c 20 64 62 2d 3e 6d LITE_OK || db->m
5a00: 61 6c 6c 6f 63 46 61 69 6c 65 64 20 29 7b 0a 20 allocFailed ){.
5a10: 20 20 20 69 66 28 20 73 50 61 72 73 65 2e 70 56 if( sParse.pV
5a20: 64 62 65 20 29 20 73 71 6c 69 74 65 33 56 64 62 dbe ) sqlite3Vdb
5a30: 65 46 69 6e 61 6c 69 7a 65 28 73 50 61 72 73 65 eFinalize(sParse
5a40: 2e 70 56 64 62 65 29 3b 0a 20 20 20 20 61 73 73 .pVdbe);. ass
5a50: 65 72 74 28 21 28 2a 70 70 53 74 6d 74 29 29 3b ert(!(*ppStmt));
5a60: 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 2a 70 . }else{. *p
5a70: 70 53 74 6d 74 20 3d 20 28 73 71 6c 69 74 65 33 pStmt = (sqlite3
5a80: 5f 73 74 6d 74 2a 29 73 50 61 72 73 65 2e 70 56 _stmt*)sParse.pV
5a90: 64 62 65 3b 0a 20 20 7d 0a 0a 20 20 69 66 28 20 dbe;. }.. if(
5aa0: 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 73 zErrMsg ){. s
5ab0: 71 6c 69 74 65 33 45 72 72 6f 72 57 69 74 68 4d qlite3ErrorWithM
5ac0: 73 67 28 64 62 2c 20 72 63 2c 20 22 25 73 22 2c sg(db, rc, "%s",
5ad0: 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 73 zErrMsg);. s
5ae0: 71 6c 69 74 65 33 44 62 46 72 65 65 28 64 62 2c qlite3DbFree(db,
5af0: 20 7a 45 72 72 4d 73 67 29 3b 0a 20 20 7d 65 6c zErrMsg);. }el
5b00: 73 65 7b 0a 20 20 20 20 73 71 6c 69 74 65 33 45 se{. sqlite3E
5b10: 72 72 6f 72 28 64 62 2c 20 72 63 29 3b 0a 20 20 rror(db, rc);.
5b20: 7d 0a 0a 20 20 2f 2a 20 44 65 6c 65 74 65 20 61 }.. /* Delete a
5b30: 6e 79 20 54 72 69 67 67 65 72 50 72 67 20 73 74 ny TriggerPrg st
5b40: 72 75 63 74 75 72 65 73 20 61 6c 6c 6f 63 61 74 ructures allocat
5b50: 65 64 20 77 68 69 6c 65 20 70 61 72 73 69 6e 67 ed while parsing
5b60: 20 74 68 69 73 20 73 74 61 74 65 6d 65 6e 74 2e this statement.
5b70: 20 2a 2f 0a 20 20 77 68 69 6c 65 28 20 73 50 61 */. while( sPa
5b80: 72 73 65 2e 70 54 72 69 67 67 65 72 50 72 67 20 rse.pTriggerPrg
5b90: 29 7b 0a 20 20 20 20 54 72 69 67 67 65 72 50 72 ){. TriggerPr
5ba0: 67 20 2a 70 54 20 3d 20 73 50 61 72 73 65 2e 70 g *pT = sParse.p
5bb0: 54 72 69 67 67 65 72 50 72 67 3b 0a 20 20 20 20 TriggerPrg;.
5bc0: 73 50 61 72 73 65 2e 70 54 72 69 67 67 65 72 50 sParse.pTriggerP
5bd0: 72 67 20 3d 20 70 54 2d 3e 70 4e 65 78 74 3b 0a rg = pT->pNext;.
5be0: 20 20 20 20 73 71 6c 69 74 65 33 44 62 46 72 65 sqlite3DbFre
5bf0: 65 28 64 62 2c 20 70 54 29 3b 0a 20 20 7d 0a 0a e(db, pT);. }..
5c00: 65 6e 64 5f 70 72 65 70 61 72 65 3a 0a 0a 20 20 end_prepare:..
5c10: 73 71 6c 69 74 65 33 50 61 72 73 65 72 52 65 73 sqlite3ParserRes
5c20: 65 74 28 26 73 50 61 72 73 65 29 3b 0a 20 20 72 et(&sParse);. r
5c30: 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 73 74 61 74 eturn rc;.}.stat
5c40: 69 63 20 69 6e 74 20 73 71 6c 69 74 65 33 4c 6f ic int sqlite3Lo
5c50: 63 6b 41 6e 64 50 72 65 70 61 72 65 28 0a 20 20 ckAndPrepare(.
5c60: 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 20 20 sqlite3 *db,
5c70: 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 61 74 /* Dat
5c80: 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 2a 2f abase handle. */
5c90: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 7a . const char *z
5ca0: 53 71 6c 2c 20 20 20 20 20 20 20 20 20 2f 2a 20 Sql, /*
5cb0: 55 54 46 2d 38 20 65 6e 63 6f 64 65 64 20 53 51 UTF-8 encoded SQ
5cc0: 4c 20 73 74 61 74 65 6d 65 6e 74 2e 20 2a 2f 0a L statement. */.
5cd0: 20 20 69 6e 74 20 6e 42 79 74 65 73 2c 20 20 20 int nBytes,
5ce0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 4c /* L
5cf0: 65 6e 67 74 68 20 6f 66 20 7a 53 71 6c 20 69 6e ength of zSql in
5d00: 20 62 79 74 65 73 2e 20 2a 2f 0a 20 20 75 33 32 bytes. */. u32
5d10: 20 70 72 65 70 46 6c 61 67 73 2c 20 20 20 20 20 prepFlags,
5d20: 20 20 20 20 20 20 20 2f 2a 20 5a 65 72 6f 20 6f /* Zero o
5d30: 72 20 6d 6f 72 65 20 53 51 4c 49 54 45 5f 50 52 r more SQLITE_PR
5d40: 45 50 41 52 45 5f 2a 20 66 6c 61 67 73 20 2a 2f EPARE_* flags */
5d50: 0a 20 20 56 64 62 65 20 2a 70 4f 6c 64 2c 20 20 . Vdbe *pOld,
5d60: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
5d70: 56 4d 20 62 65 69 6e 67 20 72 65 70 72 65 70 61 VM being reprepa
5d80: 72 65 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 red */. sqlite3
5d90: 5f 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 _stmt **ppStmt,
5da0: 20 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 /* OUT: A poi
5db0: 6e 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 nter to the prep
5dc0: 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a ared statement *
5dd0: 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a /. const char *
5de0: 2a 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a *pzTail /*
5df0: 20 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 OUT: End of par
5e00: 73 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b sed string */.){
5e10: 0a 20 20 69 6e 74 20 72 63 3b 0a 20 20 69 6e 74 . int rc;. int
5e20: 20 63 6e 74 20 3d 20 30 3b 0a 0a 23 69 66 64 65 cnt = 0;..#ifde
5e30: 66 20 53 51 4c 49 54 45 5f 45 4e 41 42 4c 45 5f f SQLITE_ENABLE_
5e40: 41 50 49 5f 41 52 4d 4f 52 0a 20 20 69 66 28 20 API_ARMOR. if(
5e50: 70 70 53 74 6d 74 3d 3d 30 20 29 20 72 65 74 75 ppStmt==0 ) retu
5e60: 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 45 rn SQLITE_MISUSE
5e70: 5f 42 4b 50 54 3b 0a 23 65 6e 64 69 66 0a 20 20 _BKPT;.#endif.
5e80: 2a 70 70 53 74 6d 74 20 3d 20 30 3b 0a 20 20 69 *ppStmt = 0;. i
5e90: 66 28 20 21 73 71 6c 69 74 65 33 53 61 66 65 74 f( !sqlite3Safet
5ea0: 79 43 68 65 63 6b 4f 6b 28 64 62 29 7c 7c 7a 53 yCheckOk(db)||zS
5eb0: 71 6c 3d 3d 30 20 29 7b 0a 20 20 20 20 72 65 74 ql==0 ){. ret
5ec0: 75 72 6e 20 53 51 4c 49 54 45 5f 4d 49 53 55 53 urn SQLITE_MISUS
5ed0: 45 5f 42 4b 50 54 3b 0a 20 20 7d 0a 20 20 73 71 E_BKPT;. }. sq
5ee0: 6c 69 74 65 33 5f 6d 75 74 65 78 5f 65 6e 74 65 lite3_mutex_ente
5ef0: 72 28 64 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 r(db->mutex);.
5f00: 73 71 6c 69 74 65 33 42 74 72 65 65 45 6e 74 65 sqlite3BtreeEnte
5f10: 72 41 6c 6c 28 64 62 29 3b 0a 20 20 64 6f 7b 0a rAll(db);. do{.
5f20: 20 20 20 20 2f 2a 20 4d 61 6b 65 20 6d 75 6c 74 /* Make mult
5f30: 69 70 6c 65 20 61 74 74 65 6d 70 74 73 20 74 6f iple attempts to
5f40: 20 63 6f 6d 70 69 6c 65 20 74 68 65 20 53 51 4c compile the SQL
5f50: 2c 20 75 6e 74 69 6c 20 69 74 20 65 69 74 68 65 , until it eithe
5f60: 72 20 73 75 63 63 65 65 64 73 0a 20 20 20 20 2a r succeeds. *
5f70: 2a 20 6f 72 20 65 6e 63 6f 75 6e 74 65 72 73 20 * or encounters
5f80: 61 20 70 65 72 6d 61 6e 65 6e 74 20 65 72 72 6f a permanent erro
5f90: 72 2e 20 20 41 20 73 63 68 65 6d 61 20 70 72 6f r. A schema pro
5fa0: 62 6c 65 6d 20 61 66 74 65 72 20 6f 6e 65 20 73 blem after one s
5fb0: 63 68 65 6d 61 0a 20 20 20 20 2a 2a 20 72 65 73 chema. ** res
5fc0: 65 74 20 69 73 20 63 6f 6e 73 69 64 65 72 65 64 et is considered
5fd0: 20 61 20 70 65 72 6d 61 6e 65 6e 74 20 65 72 72 a permanent err
5fe0: 6f 72 2e 20 2a 2f 0a 20 20 20 20 72 63 20 3d 20 or. */. rc =
5ff0: 73 71 6c 69 74 65 33 50 72 65 70 61 72 65 28 64 sqlite3Prepare(d
6000: 62 2c 20 7a 53 71 6c 2c 20 6e 42 79 74 65 73 2c b, zSql, nBytes,
6010: 20 70 72 65 70 46 6c 61 67 73 2c 20 70 4f 6c 64 prepFlags, pOld
6020: 2c 20 70 70 53 74 6d 74 2c 20 70 7a 54 61 69 6c , ppStmt, pzTail
6030: 29 3b 0a 20 20 20 20 61 73 73 65 72 74 28 20 72 );. assert( r
6040: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c==SQLITE_OK ||
6050: 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 *ppStmt==0 );.
6060: 7d 77 68 69 6c 65 28 20 72 63 3d 3d 53 51 4c 49 }while( rc==SQLI
6070: 54 45 5f 45 52 52 4f 52 5f 52 45 54 52 59 0a 20 TE_ERROR_RETRY.
6080: 20 20 20 20 20 20 7c 7c 20 28 72 63 3d 3d 53 51 || (rc==SQ
6090: 4c 49 54 45 5f 53 43 48 45 4d 41 20 26 26 20 28 LITE_SCHEMA && (
60a0: 73 71 6c 69 74 65 33 52 65 73 65 74 4f 6e 65 53 sqlite3ResetOneS
60b0: 63 68 65 6d 61 28 64 62 2c 2d 31 29 2c 20 63 6e chema(db,-1), cn
60c0: 74 2b 2b 29 3d 3d 30 29 20 29 3b 0a 20 20 73 71 t++)==0) );. sq
60d0: 6c 69 74 65 33 42 74 72 65 65 4c 65 61 76 65 41 lite3BtreeLeaveA
60e0: 6c 6c 28 64 62 29 3b 0a 20 20 72 63 20 3d 20 73 ll(db);. rc = s
60f0: 71 6c 69 74 65 33 41 70 69 45 78 69 74 28 64 62 qlite3ApiExit(db
6100: 2c 20 72 63 29 3b 0a 20 20 61 73 73 65 72 74 28 , rc);. assert(
6110: 20 28 72 63 26 64 62 2d 3e 65 72 72 4d 61 73 6b (rc&db->errMask
6120: 29 3d 3d 72 63 20 29 3b 0a 20 20 73 71 6c 69 74 )==rc );. sqlit
6130: 65 33 5f 6d 75 74 65 78 5f 6c 65 61 76 65 28 64 e3_mutex_leave(d
6140: 62 2d 3e 6d 75 74 65 78 29 3b 0a 20 20 72 65 74 b->mutex);. ret
6150: 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a urn rc;.}.../*.*
6160: 2a 20 52 65 72 75 6e 20 74 68 65 20 63 6f 6d 70 * Rerun the comp
6170: 69 6c 61 74 69 6f 6e 20 6f 66 20 61 20 73 74 61 ilation of a sta
6180: 74 65 6d 65 6e 74 20 61 66 74 65 72 20 61 20 73 tement after a s
6190: 63 68 65 6d 61 20 63 68 61 6e 67 65 2e 0a 2a 2a chema change..**
61a0: 0a 2a 2a 20 49 66 20 74 68 65 20 73 74 61 74 65 .** If the state
61b0: 6d 65 6e 74 20 69 73 20 73 75 63 63 65 73 73 66 ment is successf
61c0: 75 6c 6c 79 20 72 65 63 6f 6d 70 69 6c 65 64 2c ully recompiled,
61d0: 20 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4f return SQLITE_O
61e0: 4b 2e 20 4f 74 68 65 72 77 69 73 65 2c 0a 2a 2a K. Otherwise,.**
61f0: 20 69 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e if the statemen
6200: 74 20 63 61 6e 6e 6f 74 20 62 65 20 72 65 63 6f t cannot be reco
6210: 6d 70 69 6c 65 64 20 62 65 63 61 75 73 65 20 61 mpiled because a
6220: 6e 6f 74 68 65 72 20 63 6f 6e 6e 65 63 74 69 6f nother connectio
6230: 6e 20 68 61 73 0a 2a 2a 20 6c 6f 63 6b 65 64 20 n has.** locked
6240: 74 68 65 20 73 71 6c 69 74 65 33 5f 6d 61 73 74 the sqlite3_mast
6250: 65 72 20 74 61 62 6c 65 2c 20 72 65 74 75 72 6e er table, return
6260: 20 53 51 4c 49 54 45 5f 4c 4f 43 4b 45 44 2e 20 SQLITE_LOCKED.
6270: 49 66 20 61 6e 79 20 6f 74 68 65 72 20 65 72 72 If any other err
6280: 6f 72 0a 2a 2a 20 6f 63 63 75 72 73 2c 20 72 65 or.** occurs, re
6290: 74 75 72 6e 20 53 51 4c 49 54 45 5f 53 43 48 45 turn SQLITE_SCHE
62a0: 4d 41 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 MA..*/.int sqlit
62b0: 65 33 52 65 70 72 65 70 61 72 65 28 56 64 62 65 e3Reprepare(Vdbe
62c0: 20 2a 70 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a *p){. int rc;.
62d0: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a sqlite3_stmt *
62e0: 70 4e 65 77 3b 0a 20 20 63 6f 6e 73 74 20 63 68 pNew;. const ch
62f0: 61 72 20 2a 7a 53 71 6c 3b 0a 20 20 73 71 6c 69 ar *zSql;. sqli
6300: 74 65 33 20 2a 64 62 3b 0a 20 20 75 38 20 70 72 te3 *db;. u8 pr
6310: 65 70 46 6c 61 67 73 3b 0a 0a 20 20 61 73 73 65 epFlags;.. asse
6320: 72 74 28 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 rt( sqlite3_mute
6330: 78 5f 68 65 6c 64 28 73 71 6c 69 74 65 33 56 64 x_held(sqlite3Vd
6340: 62 65 44 62 28 70 29 2d 3e 6d 75 74 65 78 29 20 beDb(p)->mutex)
6350: 29 3b 0a 20 20 7a 53 71 6c 20 3d 20 73 71 6c 69 );. zSql = sqli
6360: 74 65 33 5f 73 71 6c 28 28 73 71 6c 69 74 65 33 te3_sql((sqlite3
6370: 5f 73 74 6d 74 20 2a 29 70 29 3b 0a 20 20 61 73 _stmt *)p);. as
6380: 73 65 72 74 28 20 7a 53 71 6c 21 3d 30 20 29 3b sert( zSql!=0 );
6390: 20 20 2f 2a 20 52 65 70 72 65 70 61 72 65 20 6f /* Reprepare o
63a0: 6e 6c 79 20 63 61 6c 6c 65 64 20 66 6f 72 20 70 nly called for p
63b0: 72 65 70 61 72 65 5f 76 32 28 29 20 73 74 61 74 repare_v2() stat
63c0: 65 6d 65 6e 74 73 20 2a 2f 0a 20 20 64 62 20 3d ements */. db =
63d0: 20 73 71 6c 69 74 65 33 56 64 62 65 44 62 28 70 sqlite3VdbeDb(p
63e0: 29 3b 0a 20 20 61 73 73 65 72 74 28 20 73 71 6c );. assert( sql
63f0: 69 74 65 33 5f 6d 75 74 65 78 5f 68 65 6c 64 28 ite3_mutex_held(
6400: 64 62 2d 3e 6d 75 74 65 78 29 20 29 3b 0a 20 20 db->mutex) );.
6410: 70 72 65 70 46 6c 61 67 73 20 3d 20 73 71 6c 69 prepFlags = sqli
6420: 74 65 33 56 64 62 65 50 72 65 70 61 72 65 46 6c te3VdbePrepareFl
6430: 61 67 73 28 70 29 3b 0a 20 20 72 63 20 3d 20 73 ags(p);. rc = s
6440: 71 6c 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 qlite3LockAndPre
6450: 70 61 72 65 28 64 62 2c 20 7a 53 71 6c 2c 20 2d pare(db, zSql, -
6460: 31 2c 20 70 72 65 70 46 6c 61 67 73 2c 20 70 2c 1, prepFlags, p,
6470: 20 26 70 4e 65 77 2c 20 30 29 3b 0a 20 20 69 66 &pNew, 0);. if
6480: 28 20 72 63 20 29 7b 0a 20 20 20 20 69 66 28 20 ( rc ){. if(
6490: 72 63 3d 3d 53 51 4c 49 54 45 5f 4e 4f 4d 45 4d rc==SQLITE_NOMEM
64a0: 20 29 7b 0a 20 20 20 20 20 20 73 71 6c 69 74 65 ){. sqlite
64b0: 33 4f 6f 6d 46 61 75 6c 74 28 64 62 29 3b 0a 20 3OomFault(db);.
64c0: 20 20 20 7d 0a 20 20 20 20 61 73 73 65 72 74 28 }. assert(
64d0: 20 70 4e 65 77 3d 3d 30 20 29 3b 0a 20 20 20 20 pNew==0 );.
64e0: 72 65 74 75 72 6e 20 72 63 3b 0a 20 20 7d 65 6c return rc;. }el
64f0: 73 65 7b 0a 20 20 20 20 61 73 73 65 72 74 28 20 se{. assert(
6500: 70 4e 65 77 21 3d 30 20 29 3b 0a 20 20 7d 0a 20 pNew!=0 );. }.
6510: 20 73 71 6c 69 74 65 33 56 64 62 65 53 77 61 70 sqlite3VdbeSwap
6520: 28 28 56 64 62 65 2a 29 70 4e 65 77 2c 20 70 29 ((Vdbe*)pNew, p)
6530: 3b 0a 20 20 73 71 6c 69 74 65 33 54 72 61 6e 73 ;. sqlite3Trans
6540: 66 65 72 42 69 6e 64 69 6e 67 73 28 70 4e 65 77 ferBindings(pNew
6550: 2c 20 28 73 71 6c 69 74 65 33 5f 73 74 6d 74 2a , (sqlite3_stmt*
6560: 29 70 29 3b 0a 20 20 73 71 6c 69 74 65 33 56 64 )p);. sqlite3Vd
6570: 62 65 52 65 73 65 74 53 74 65 70 52 65 73 75 6c beResetStepResul
6580: 74 28 28 56 64 62 65 2a 29 70 4e 65 77 29 3b 0a t((Vdbe*)pNew);.
6590: 20 20 73 71 6c 69 74 65 33 56 64 62 65 46 69 6e sqlite3VdbeFin
65a0: 61 6c 69 7a 65 28 28 56 64 62 65 2a 29 70 4e 65 alize((Vdbe*)pNe
65b0: 77 29 3b 0a 20 20 72 65 74 75 72 6e 20 53 51 4c w);. return SQL
65c0: 49 54 45 5f 4f 4b 3b 0a 7d 0a 0a 0a 2f 2a 0a 2a ITE_OK;.}.../*.*
65d0: 2a 20 54 77 6f 20 76 65 72 73 69 6f 6e 73 20 6f * Two versions o
65e0: 66 20 74 68 65 20 6f 66 66 69 63 69 61 6c 20 41 f the official A
65f0: 50 49 2e 20 20 4c 65 67 61 63 79 20 61 6e 64 20 PI. Legacy and
6600: 6e 65 77 20 75 73 65 2e 20 20 49 6e 20 74 68 65 new use. In the
6610: 20 6c 65 67 61 63 79 0a 2a 2a 20 76 65 72 73 69 legacy.** versi
6620: 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69 6e 61 6c on, the original
6630: 20 53 51 4c 20 74 65 78 74 20 69 73 20 6e 6f 74 SQL text is not
6640: 20 73 61 76 65 64 20 69 6e 20 74 68 65 20 70 72 saved in the pr
6650: 65 70 61 72 65 64 20 73 74 61 74 65 6d 65 6e 74 epared statement
6660: 0a 2a 2a 20 61 6e 64 20 73 6f 20 69 66 20 61 20 .** and so if a
6670: 73 63 68 65 6d 61 20 63 68 61 6e 67 65 20 6f 63 schema change oc
6680: 63 75 72 73 2c 20 53 51 4c 49 54 45 5f 53 43 48 curs, SQLITE_SCH
6690: 45 4d 41 20 69 73 20 72 65 74 75 72 6e 65 64 20 EMA is returned
66a0: 62 79 0a 2a 2a 20 73 71 6c 69 74 65 33 5f 73 74 by.** sqlite3_st
66b0: 65 70 28 29 2e 20 20 49 6e 20 74 68 65 20 6e 65 ep(). In the ne
66c0: 77 20 76 65 72 73 69 6f 6e 2c 20 74 68 65 20 6f w version, the o
66d0: 72 69 67 69 6e 61 6c 20 53 51 4c 20 74 65 78 74 riginal SQL text
66e0: 20 69 73 20 72 65 74 61 69 6e 65 64 0a 2a 2a 20 is retained.**
66f0: 61 6e 64 20 74 68 65 20 73 74 61 74 65 6d 65 6e and the statemen
6700: 74 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c t is automatical
6710: 6c 79 20 72 65 63 6f 6d 70 69 6c 65 64 20 69 66 ly recompiled if
6720: 20 61 6e 20 73 63 68 65 6d 61 20 63 68 61 6e 67 an schema chang
6730: 65 0a 2a 2a 20 6f 63 63 75 72 73 2e 0a 2a 2f 0a e.** occurs..*/.
6740: 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 70 int sqlite3_prep
6750: 61 72 65 28 0a 20 20 73 71 6c 69 74 65 33 20 2a are(. sqlite3 *
6760: 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 db,
6770: 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 61 6e /* Database han
6780: 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 dle. */. const
6790: 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 char *zSql,
67a0: 20 20 20 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63 /* UTF-8 enc
67b0: 6f 64 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 oded SQL stateme
67c0: 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 nt. */. int nBy
67d0: 74 65 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 tes,
67e0: 20 20 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 /* Length of
67f0: 7a 53 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a zSql in bytes. *
6800: 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 /. sqlite3_stmt
6810: 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a **ppStmt, /*
6820: 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 OUT: A pointer
6830: 74 6f 20 74 68 65 20 70 72 65 70 61 72 65 64 20 to the prepared
6840: 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 statement */. c
6850: 6f 6e 73 74 20 63 68 61 72 20 2a 2a 70 7a 54 61 onst char **pzTa
6860: 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a il /* OUT:
6870: 20 45 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 End of parsed s
6880: 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e tring */.){. in
6890: 74 20 72 63 3b 0a 20 20 72 63 20 3d 20 73 71 6c t rc;. rc = sql
68a0: 69 74 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 ite3LockAndPrepa
68b0: 72 65 28 64 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 re(db,zSql,nByte
68c0: 73 2c 30 2c 30 2c 70 70 53 74 6d 74 2c 70 7a 54 s,0,0,ppStmt,pzT
68d0: 61 69 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 ail);. assert(
68e0: 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c rc==SQLITE_OK ||
68f0: 20 70 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 ppStmt==0 || *p
6900: 70 53 74 6d 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 pStmt==0 ); /*
6910: 56 45 52 49 46 59 3a 20 46 31 33 30 32 31 20 2a VERIFY: F13021 *
6920: 2f 0a 20 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d /. return rc;.}
6930: 0a 69 6e 74 20 73 71 6c 69 74 65 33 5f 70 72 65 .int sqlite3_pre
6940: 70 61 72 65 5f 76 32 28 0a 20 20 73 71 6c 69 74 pare_v2(. sqlit
6950: 65 33 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 e3 *db,
6960: 20 20 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 /* Database
6970: 20 68 61 6e 64 6c 65 2e 20 2a 2f 0a 20 20 63 6f handle. */. co
6980: 6e 73 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 nst char *zSql,
6990: 20 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 38 /* UTF-8
69a0: 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 encoded SQL sta
69b0: 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 tement. */. int
69c0: 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 nBytes,
69d0: 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 /* Length
69e0: 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 of zSql in byte
69f0: 73 2e 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f s. */. sqlite3_
6a00: 73 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 stmt **ppStmt,
6a10: 20 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e /* OUT: A poin
6a20: 74 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61 ter to the prepa
6a30: 72 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f red statement */
6a40: 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a . const char **
6a50: 70 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 pzTail /*
6a60: 4f 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 OUT: End of pars
6a70: 65 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a ed string */.){.
6a80: 20 20 69 6e 74 20 72 63 3b 0a 20 20 2f 2a 20 45 int rc;. /* E
6a90: 56 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 33 37 VIDENCE-OF: R-37
6aa0: 39 32 33 2d 31 32 31 37 33 20 54 68 65 20 73 71 923-12173 The sq
6ab0: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76 32 lite3_prepare_v2
6ac0: 28 29 20 69 6e 74 65 72 66 61 63 65 20 77 6f 72 () interface wor
6ad0: 6b 73 0a 20 20 2a 2a 20 65 78 61 63 74 6c 79 20 ks. ** exactly
6ae0: 74 68 65 20 73 61 6d 65 20 61 73 20 73 71 6c 69 the same as sqli
6af0: 74 65 33 5f 70 72 65 70 61 72 65 5f 76 33 28 29 te3_prepare_v3()
6b00: 20 77 69 74 68 20 61 20 7a 65 72 6f 20 70 72 65 with a zero pre
6b10: 70 46 6c 61 67 73 0a 20 20 2a 2a 20 70 61 72 61 pFlags. ** para
6b20: 6d 65 74 65 72 2e 0a 20 20 2a 2a 0a 20 20 2a 2a meter.. **. **
6b30: 20 50 72 6f 6f 66 20 69 6e 20 74 68 61 74 20 74 Proof in that t
6b40: 68 65 20 35 74 68 20 70 61 72 61 6d 65 74 65 72 he 5th parameter
6b50: 20 74 6f 20 73 71 6c 69 74 65 33 4c 6f 63 6b 41 to sqlite3LockA
6b60: 6e 64 50 72 65 70 61 72 65 20 69 73 20 30 20 2a ndPrepare is 0 *
6b70: 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 /. rc = sqlite3
6b80: 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 28 64 LockAndPrepare(d
6b90: 62 2c 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 53 51 b,zSql,nBytes,SQ
6ba0: 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 53 41 56 LITE_PREPARE_SAV
6bb0: 45 53 51 4c 2c 30 2c 0a 20 20 20 20 20 20 20 20 ESQL,0,.
6bc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
6bd0: 20 20 20 20 20 70 70 53 74 6d 74 2c 70 7a 54 61 ppStmt,pzTa
6be0: 69 6c 29 3b 0a 20 20 61 73 73 65 72 74 28 20 72 il);. assert( r
6bf0: 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 c==SQLITE_OK ||
6c00: 70 70 53 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 ppStmt==0 || *pp
6c10: 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 20 72 65 74 Stmt==0 );. ret
6c20: 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 urn rc;.}.int sq
6c30: 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f 76 33 lite3_prepare_v3
6c40: 28 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c (. sqlite3 *db,
6c50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a /*
6c60: 20 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 Database handle
6c70: 2e 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 63 68 61 . */. const cha
6c80: 72 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 r *zSql,
6c90: 20 2f 2a 20 55 54 46 2d 38 20 65 6e 63 6f 64 65 /* UTF-8 encode
6ca0: 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e d SQL statement.
6cb0: 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 */. int nBytes
6cc0: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
6cd0: 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 /* Length of zSq
6ce0: 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 l in bytes. */.
6cf0: 20 75 6e 73 69 67 6e 65 64 20 69 6e 74 20 70 72 unsigned int pr
6d00: 65 70 46 6c 61 67 73 2c 20 20 20 2f 2a 20 5a 65 epFlags, /* Ze
6d10: 72 6f 20 6f 72 20 6d 6f 72 65 20 53 51 4c 49 54 ro or more SQLIT
6d20: 45 5f 50 52 45 50 41 52 45 5f 2a 20 66 6c 61 67 E_PREPARE_* flag
6d30: 73 20 2a 2f 0a 20 20 73 71 6c 69 74 65 33 5f 73 s */. sqlite3_s
6d40: 74 6d 74 20 2a 2a 70 70 53 74 6d 74 2c 20 20 20 tmt **ppStmt,
6d50: 20 2f 2a 20 4f 55 54 3a 20 41 20 70 6f 69 6e 74 /* OUT: A point
6d60: 65 72 20 74 6f 20 74 68 65 20 70 72 65 70 61 72 er to the prepar
6d70: 65 64 20 73 74 61 74 65 6d 65 6e 74 20 2a 2f 0a ed statement */.
6d80: 20 20 63 6f 6e 73 74 20 63 68 61 72 20 2a 2a 70 const char **p
6d90: 7a 54 61 69 6c 20 20 20 20 20 20 20 2f 2a 20 4f zTail /* O
6da0: 55 54 3a 20 45 6e 64 20 6f 66 20 70 61 72 73 65 UT: End of parse
6db0: 64 20 73 74 72 69 6e 67 20 2a 2f 0a 29 7b 0a 20 d string */.){.
6dc0: 20 69 6e 74 20 72 63 3b 0a 20 20 2f 2a 20 45 56 int rc;. /* EV
6dd0: 49 44 45 4e 43 45 2d 4f 46 3a 20 52 2d 35 36 38 IDENCE-OF: R-568
6de0: 36 31 2d 34 32 36 37 33 20 73 71 6c 69 74 65 33 61-42673 sqlite3
6df0: 5f 70 72 65 70 61 72 65 5f 76 33 28 29 20 64 69 _prepare_v3() di
6e00: 66 66 65 72 73 20 66 72 6f 6d 0a 20 20 2a 2a 20 ffers from. **
6e10: 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 5f sqlite3_prepare_
6e20: 76 32 28 29 20 6f 6e 6c 79 20 69 6e 20 68 61 76 v2() only in hav
6e30: 69 6e 67 20 74 68 65 20 65 78 74 72 61 20 70 72 ing the extra pr
6e40: 65 70 46 6c 61 67 73 20 70 61 72 61 6d 65 74 65 epFlags paramete
6e50: 72 2c 0a 20 20 2a 2a 20 77 68 69 63 68 20 69 73 r,. ** which is
6e60: 20 61 20 62 69 74 20 61 72 72 61 79 20 63 6f 6e a bit array con
6e70: 73 69 73 74 69 6e 67 20 6f 66 20 7a 65 72 6f 20 sisting of zero
6e80: 6f 72 20 6d 6f 72 65 20 6f 66 20 74 68 65 0a 20 or more of the.
6e90: 20 2a 2a 20 53 51 4c 49 54 45 5f 50 52 45 50 41 ** SQLITE_PREPA
6ea0: 52 45 5f 2a 20 66 6c 61 67 73 2e 0a 20 20 2a 2a RE_* flags.. **
6eb0: 0a 20 20 2a 2a 20 50 72 6f 6f 66 20 62 79 20 63 . ** Proof by c
6ec0: 6f 6d 70 61 72 69 73 6f 6e 20 74 6f 20 74 68 65 omparison to the
6ed0: 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 implementation
6ee0: 6f 66 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 of sqlite3_prepa
6ef0: 72 65 5f 76 32 28 29 0a 20 20 2a 2a 20 64 69 72 re_v2(). ** dir
6f00: 65 63 74 6c 79 20 61 62 6f 76 65 2e 20 2a 2f 0a ectly above. */.
6f10: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 4c 6f rc = sqlite3Lo
6f20: 63 6b 41 6e 64 50 72 65 70 61 72 65 28 64 62 2c ckAndPrepare(db,
6f30: 7a 53 71 6c 2c 6e 42 79 74 65 73 2c 0a 20 20 20 zSql,nBytes,.
6f40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 53 51 SQ
6f50: 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 53 41 56 LITE_PREPARE_SAV
6f60: 45 53 51 4c 7c 28 70 72 65 70 46 6c 61 67 73 26 ESQL|(prepFlags&
6f70: 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f 4d SQLITE_PREPARE_M
6f80: 41 53 4b 29 2c 0a 20 20 20 20 20 20 20 20 20 20 ASK),.
6f90: 20 20 20 20 20 20 20 30 2c 70 70 53 74 6d 74 2c 0,ppStmt,
6fa0: 70 7a 54 61 69 6c 29 3b 0a 20 20 61 73 73 65 72 pzTail);. asser
6fb0: 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 5f 4f 4b t( rc==SQLITE_OK
6fc0: 20 7c 7c 20 70 70 53 74 6d 74 3d 3d 30 20 7c 7c || ppStmt==0 ||
6fd0: 20 2a 70 70 53 74 6d 74 3d 3d 30 20 29 3b 0a 20 *ppStmt==0 );.
6fe0: 20 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 0a return rc;.}...
6ff0: 23 69 66 6e 64 65 66 20 53 51 4c 49 54 45 5f 4f #ifndef SQLITE_O
7000: 4d 49 54 5f 55 54 46 31 36 0a 2f 2a 0a 2a 2a 20 MIT_UTF16./*.**
7010: 43 6f 6d 70 69 6c 65 20 74 68 65 20 55 54 46 2d Compile the UTF-
7020: 31 36 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 16 encoded SQL s
7030: 74 61 74 65 6d 65 6e 74 20 7a 53 71 6c 20 69 6e tatement zSql in
7040: 74 6f 20 61 20 73 74 61 74 65 6d 65 6e 74 20 68 to a statement h
7050: 61 6e 64 6c 65 2e 0a 2a 2f 0a 73 74 61 74 69 63 andle..*/.static
7060: 20 69 6e 74 20 73 71 6c 69 74 65 33 50 72 65 70 int sqlite3Prep
7070: 61 72 65 31 36 28 0a 20 20 73 71 6c 69 74 65 33 are16(. sqlite3
7080: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 *db,
7090: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 /* Database h
70a0: 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e andle. */ . con
70b0: 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c 20 20 st void *zSql,
70c0: 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 31 36 /* UTF-16
70d0: 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 encoded SQL sta
70e0: 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 tement. */. int
70f0: 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 nBytes,
7100: 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 /* Length
7110: 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 of zSql in byte
7120: 73 2e 20 2a 2f 0a 20 20 75 33 32 20 70 72 65 70 s. */. u32 prep
7130: 46 6c 61 67 73 2c 20 20 20 20 20 20 20 20 20 20 Flags,
7140: 20 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 /* Zero or mor
7150: 65 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 e SQLITE_PREPARE
7160: 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a 20 20 73 71 _* flags */. sq
7170: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53 lite3_stmt **ppS
7180: 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20 tmt, /* OUT:
7190: 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 A pointer to the
71a0: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d prepared statem
71b0: 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 ent */. const v
71c0: 6f 69 64 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20 oid **pzTail
71d0: 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f /* OUT: End o
71e0: 66 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20 f parsed string
71f0: 2a 2f 0a 29 7b 0a 20 20 2f 2a 20 54 68 69 73 20 */.){. /* This
7200: 66 75 6e 63 74 69 6f 6e 20 63 75 72 72 65 6e 74 function current
7210: 6c 79 20 77 6f 72 6b 73 20 62 79 20 66 69 72 73 ly works by firs
7220: 74 20 74 72 61 6e 73 66 6f 72 6d 69 6e 67 20 74 t transforming t
7230: 68 65 20 55 54 46 2d 31 36 0a 20 20 2a 2a 20 65 he UTF-16. ** e
7240: 6e 63 6f 64 65 64 20 73 74 72 69 6e 67 20 74 6f ncoded string to
7250: 20 55 54 46 2d 38 2c 20 74 68 65 6e 20 69 6e 76 UTF-8, then inv
7260: 6f 6b 69 6e 67 20 73 71 6c 69 74 65 33 5f 70 72 oking sqlite3_pr
7270: 65 70 61 72 65 28 29 2e 20 54 68 65 0a 20 20 2a epare(). The. *
7280: 2a 20 74 72 69 63 6b 79 20 62 69 74 20 69 73 20 * tricky bit is
7290: 66 69 67 75 72 69 6e 67 20 6f 75 74 20 74 68 65 figuring out the
72a0: 20 70 6f 69 6e 74 65 72 20 74 6f 20 72 65 74 75 pointer to retu
72b0: 72 6e 20 69 6e 20 2a 70 7a 54 61 69 6c 2e 0a 20 rn in *pzTail..
72c0: 20 2a 2f 0a 20 20 63 68 61 72 20 2a 7a 53 71 6c */. char *zSql
72d0: 38 3b 0a 20 20 63 6f 6e 73 74 20 63 68 61 72 20 8;. const char
72e0: 2a 7a 54 61 69 6c 38 20 3d 20 30 3b 0a 20 20 69 *zTail8 = 0;. i
72f0: 6e 74 20 72 63 20 3d 20 53 51 4c 49 54 45 5f 4f nt rc = SQLITE_O
7300: 4b 3b 0a 0a 23 69 66 64 65 66 20 53 51 4c 49 54 K;..#ifdef SQLIT
7310: 45 5f 45 4e 41 42 4c 45 5f 41 50 49 5f 41 52 4d E_ENABLE_API_ARM
7320: 4f 52 0a 20 20 69 66 28 20 70 70 53 74 6d 74 3d OR. if( ppStmt=
7330: 3d 30 20 29 20 72 65 74 75 72 6e 20 53 51 4c 49 =0 ) return SQLI
7340: 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b 0a TE_MISUSE_BKPT;.
7350: 23 65 6e 64 69 66 0a 20 20 2a 70 70 53 74 6d 74 #endif. *ppStmt
7360: 20 3d 20 30 3b 0a 20 20 69 66 28 20 21 73 71 6c = 0;. if( !sql
7370: 69 74 65 33 53 61 66 65 74 79 43 68 65 63 6b 4f ite3SafetyCheckO
7380: 6b 28 64 62 29 7c 7c 7a 53 71 6c 3d 3d 30 20 29 k(db)||zSql==0 )
7390: 7b 0a 20 20 20 20 72 65 74 75 72 6e 20 53 51 4c {. return SQL
73a0: 49 54 45 5f 4d 49 53 55 53 45 5f 42 4b 50 54 3b ITE_MISUSE_BKPT;
73b0: 0a 20 20 7d 0a 20 20 69 66 28 20 6e 42 79 74 65 . }. if( nByte
73c0: 73 3e 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 s>=0 ){. int
73d0: 73 7a 3b 0a 20 20 20 20 63 6f 6e 73 74 20 63 68 sz;. const ch
73e0: 61 72 20 2a 7a 20 3d 20 28 63 6f 6e 73 74 20 63 ar *z = (const c
73f0: 68 61 72 2a 29 7a 53 71 6c 3b 0a 20 20 20 20 66 har*)zSql;. f
7400: 6f 72 28 73 7a 3d 30 3b 20 73 7a 3c 6e 42 79 74 or(sz=0; sz<nByt
7410: 65 73 20 26 26 20 28 7a 5b 73 7a 5d 21 3d 30 20 es && (z[sz]!=0
7420: 7c 7c 20 7a 5b 73 7a 2b 31 5d 21 3d 30 29 3b 20 || z[sz+1]!=0);
7430: 73 7a 20 2b 3d 20 32 29 7b 7d 0a 20 20 20 20 6e sz += 2){}. n
7440: 42 79 74 65 73 20 3d 20 73 7a 3b 0a 20 20 7d 0a Bytes = sz;. }.
7450: 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 65 78 5f sqlite3_mutex_
7460: 65 6e 74 65 72 28 64 62 2d 3e 6d 75 74 65 78 29 enter(db->mutex)
7470: 3b 0a 20 20 7a 53 71 6c 38 20 3d 20 73 71 6c 69 ;. zSql8 = sqli
7480: 74 65 33 55 74 66 31 36 74 6f 38 28 64 62 2c 20 te3Utf16to8(db,
7490: 7a 53 71 6c 2c 20 6e 42 79 74 65 73 2c 20 53 51 zSql, nBytes, SQ
74a0: 4c 49 54 45 5f 55 54 46 31 36 4e 41 54 49 56 45 LITE_UTF16NATIVE
74b0: 29 3b 0a 20 20 69 66 28 20 7a 53 71 6c 38 20 29 );. if( zSql8 )
74c0: 7b 0a 20 20 20 20 72 63 20 3d 20 73 71 6c 69 74 {. rc = sqlit
74d0: 65 33 4c 6f 63 6b 41 6e 64 50 72 65 70 61 72 65 e3LockAndPrepare
74e0: 28 64 62 2c 20 7a 53 71 6c 38 2c 20 2d 31 2c 20 (db, zSql8, -1,
74f0: 70 72 65 70 46 6c 61 67 73 2c 20 30 2c 20 70 70 prepFlags, 0, pp
7500: 53 74 6d 74 2c 20 26 7a 54 61 69 6c 38 29 3b 0a Stmt, &zTail8);.
7510: 20 20 7d 0a 0a 20 20 69 66 28 20 7a 54 61 69 6c }.. if( zTail
7520: 38 20 26 26 20 70 7a 54 61 69 6c 20 29 7b 0a 20 8 && pzTail ){.
7530: 20 20 20 2f 2a 20 49 66 20 73 71 6c 69 74 65 33 /* If sqlite3
7540: 5f 70 72 65 70 61 72 65 20 72 65 74 75 72 6e 73 _prepare returns
7550: 20 61 20 74 61 69 6c 20 70 6f 69 6e 74 65 72 2c a tail pointer,
7560: 20 77 65 20 63 61 6c 63 75 6c 61 74 65 20 74 68 we calculate th
7570: 65 0a 20 20 20 20 2a 2a 20 65 71 75 69 76 61 6c e. ** equival
7580: 65 6e 74 20 70 6f 69 6e 74 65 72 20 69 6e 74 6f ent pointer into
7590: 20 74 68 65 20 55 54 46 2d 31 36 20 73 74 72 69 the UTF-16 stri
75a0: 6e 67 20 62 79 20 63 6f 75 6e 74 69 6e 67 20 74 ng by counting t
75b0: 68 65 20 75 6e 69 63 6f 64 65 0a 20 20 20 20 2a he unicode. *
75c0: 2a 20 63 68 61 72 61 63 74 65 72 73 20 62 65 74 * characters bet
75d0: 77 65 65 6e 20 7a 53 71 6c 38 20 61 6e 64 20 7a ween zSql8 and z
75e0: 54 61 69 6c 38 2c 20 61 6e 64 20 74 68 65 6e 20 Tail8, and then
75f0: 72 65 74 75 72 6e 69 6e 67 20 61 20 70 6f 69 6e returning a poin
7600: 74 65 72 0a 20 20 20 20 2a 2a 20 74 68 65 20 73 ter. ** the s
7610: 61 6d 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 68 ame number of ch
7620: 61 72 61 63 74 65 72 73 20 69 6e 74 6f 20 74 68 aracters into th
7630: 65 20 55 54 46 2d 31 36 20 73 74 72 69 6e 67 2e e UTF-16 string.
7640: 0a 20 20 20 20 2a 2f 0a 20 20 20 20 69 6e 74 20 . */. int
7650: 63 68 61 72 73 5f 70 61 72 73 65 64 20 3d 20 73 chars_parsed = s
7660: 71 6c 69 74 65 33 55 74 66 38 43 68 61 72 4c 65 qlite3Utf8CharLe
7670: 6e 28 7a 53 71 6c 38 2c 20 28 69 6e 74 29 28 7a n(zSql8, (int)(z
7680: 54 61 69 6c 38 2d 7a 53 71 6c 38 29 29 3b 0a 20 Tail8-zSql8));.
7690: 20 20 20 2a 70 7a 54 61 69 6c 20 3d 20 28 75 38 *pzTail = (u8
76a0: 20 2a 29 7a 53 71 6c 20 2b 20 73 71 6c 69 74 65 *)zSql + sqlite
76b0: 33 55 74 66 31 36 42 79 74 65 4c 65 6e 28 7a 53 3Utf16ByteLen(zS
76c0: 71 6c 2c 20 63 68 61 72 73 5f 70 61 72 73 65 64 ql, chars_parsed
76d0: 29 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 65 33 );. }. sqlite3
76e0: 44 62 46 72 65 65 28 64 62 2c 20 7a 53 71 6c 38 DbFree(db, zSql8
76f0: 29 3b 20 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 ); . rc = sqlit
7700: 65 33 41 70 69 45 78 69 74 28 64 62 2c 20 72 63 e3ApiExit(db, rc
7710: 29 3b 0a 20 20 73 71 6c 69 74 65 33 5f 6d 75 74 );. sqlite3_mut
7720: 65 78 5f 6c 65 61 76 65 28 64 62 2d 3e 6d 75 74 ex_leave(db->mut
7730: 65 78 29 3b 0a 20 20 72 65 74 75 72 6e 20 72 63 ex);. return rc
7740: 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 77 6f 20 76 ;.}../*.** Two v
7750: 65 72 73 69 6f 6e 73 20 6f 66 20 74 68 65 20 6f ersions of the o
7760: 66 66 69 63 69 61 6c 20 41 50 49 2e 20 20 4c 65 fficial API. Le
7770: 67 61 63 79 20 61 6e 64 20 6e 65 77 20 75 73 65 gacy and new use
7780: 2e 20 20 49 6e 20 74 68 65 20 6c 65 67 61 63 79 . In the legacy
7790: 0a 2a 2a 20 76 65 72 73 69 6f 6e 2c 20 74 68 65 .** version, the
77a0: 20 6f 72 69 67 69 6e 61 6c 20 53 51 4c 20 74 65 original SQL te
77b0: 78 74 20 69 73 20 6e 6f 74 20 73 61 76 65 64 20 xt is not saved
77c0: 69 6e 20 74 68 65 20 70 72 65 70 61 72 65 64 20 in the prepared
77d0: 73 74 61 74 65 6d 65 6e 74 0a 2a 2a 20 61 6e 64 statement.** and
77e0: 20 73 6f 20 69 66 20 61 20 73 63 68 65 6d 61 20 so if a schema
77f0: 63 68 61 6e 67 65 20 6f 63 63 75 72 73 2c 20 53 change occurs, S
7800: 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 69 73 20 QLITE_SCHEMA is
7810: 72 65 74 75 72 6e 65 64 20 62 79 0a 2a 2a 20 73 returned by.** s
7820: 71 6c 69 74 65 33 5f 73 74 65 70 28 29 2e 20 20 qlite3_step().
7830: 49 6e 20 74 68 65 20 6e 65 77 20 76 65 72 73 69 In the new versi
7840: 6f 6e 2c 20 74 68 65 20 6f 72 69 67 69 6e 61 6c on, the original
7850: 20 53 51 4c 20 74 65 78 74 20 69 73 20 72 65 74 SQL text is ret
7860: 61 69 6e 65 64 0a 2a 2a 20 61 6e 64 20 74 68 65 ained.** and the
7870: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 61 75 statement is au
7880: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 72 65 63 6f tomatically reco
7890: 6d 70 69 6c 65 64 20 69 66 20 61 6e 20 73 63 68 mpiled if an sch
78a0: 65 6d 61 20 63 68 61 6e 67 65 0a 2a 2a 20 6f 63 ema change.** oc
78b0: 63 75 72 73 2e 0a 2a 2f 0a 69 6e 74 20 73 71 6c curs..*/.int sql
78c0: 69 74 65 33 5f 70 72 65 70 61 72 65 31 36 28 0a ite3_prepare16(.
78d0: 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 20 sqlite3 *db,
78e0: 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 44 /* D
78f0: 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e 20 atabase handle.
7900: 2a 2f 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 64 */ . const void
7910: 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 20 *zSql,
7920: 2f 2a 20 55 54 46 2d 31 36 20 65 6e 63 6f 64 65 /* UTF-16 encode
7930: 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 2e d SQL statement.
7940: 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 73 */. int nBytes
7950: 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 ,
7960: 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 71 /* Length of zSq
7970: 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a 20 l in bytes. */.
7980: 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a sqlite3_stmt **
7990: 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 ppStmt, /* OU
79a0: 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 T: A pointer to
79b0: 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74 61 the prepared sta
79c0: 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 tement */. cons
79d0: 74 20 76 6f 69 64 20 2a 2a 70 7a 54 61 69 6c 20 t void **pzTail
79e0: 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e /* OUT: En
79f0: 64 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 69 d of parsed stri
7a00: 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 ng */.){. int r
7a10: 63 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 c;. rc = sqlite
7a20: 33 50 72 65 70 61 72 65 31 36 28 64 62 2c 7a 53 3Prepare16(db,zS
7a30: 71 6c 2c 6e 42 79 74 65 73 2c 30 2c 70 70 53 74 ql,nBytes,0,ppSt
7a40: 6d 74 2c 70 7a 54 61 69 6c 29 3b 0a 20 20 61 73 mt,pzTail);. as
7a50: 73 65 72 74 28 20 72 63 3d 3d 53 51 4c 49 54 45 sert( rc==SQLITE
7a60: 5f 4f 4b 20 7c 7c 20 70 70 53 74 6d 74 3d 3d 30 _OK || ppStmt==0
7a70: 20 7c 7c 20 2a 70 70 53 74 6d 74 3d 3d 30 20 29 || *ppStmt==0 )
7a80: 3b 20 20 2f 2a 20 56 45 52 49 46 59 3a 20 46 31 ; /* VERIFY: F1
7a90: 33 30 32 31 20 2a 2f 0a 20 20 72 65 74 75 72 6e 3021 */. return
7aa0: 20 72 63 3b 0a 7d 0a 69 6e 74 20 73 71 6c 69 74 rc;.}.int sqlit
7ab0: 65 33 5f 70 72 65 70 61 72 65 31 36 5f 76 32 28 e3_prepare16_v2(
7ac0: 0a 20 20 73 71 6c 69 74 65 33 20 2a 64 62 2c 20 . sqlite3 *db,
7ad0: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
7ae0: 44 61 74 61 62 61 73 65 20 68 61 6e 64 6c 65 2e Database handle.
7af0: 20 2a 2f 20 0a 20 20 63 6f 6e 73 74 20 76 6f 69 */ . const voi
7b00: 64 20 2a 7a 53 71 6c 2c 20 20 20 20 20 20 20 20 d *zSql,
7b10: 20 2f 2a 20 55 54 46 2d 31 36 20 65 6e 63 6f 64 /* UTF-16 encod
7b20: 65 64 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 ed SQL statement
7b30: 2e 20 2a 2f 0a 20 20 69 6e 74 20 6e 42 79 74 65 . */. int nByte
7b40: 73 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 20 s,
7b50: 20 2f 2a 20 4c 65 6e 67 74 68 20 6f 66 20 7a 53 /* Length of zS
7b60: 71 6c 20 69 6e 20 62 79 74 65 73 2e 20 2a 2f 0a ql in bytes. */.
7b70: 20 20 73 71 6c 69 74 65 33 5f 73 74 6d 74 20 2a sqlite3_stmt *
7b80: 2a 70 70 53 74 6d 74 2c 20 20 20 20 2f 2a 20 4f *ppStmt, /* O
7b90: 55 54 3a 20 41 20 70 6f 69 6e 74 65 72 20 74 6f UT: A pointer to
7ba0: 20 74 68 65 20 70 72 65 70 61 72 65 64 20 73 74 the prepared st
7bb0: 61 74 65 6d 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e atement */. con
7bc0: 73 74 20 76 6f 69 64 20 2a 2a 70 7a 54 61 69 6c st void **pzTail
7bd0: 20 20 20 20 20 20 20 2f 2a 20 4f 55 54 3a 20 45 /* OUT: E
7be0: 6e 64 20 6f 66 20 70 61 72 73 65 64 20 73 74 72 nd of parsed str
7bf0: 69 6e 67 20 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 ing */.){. int
7c00: 72 63 3b 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 rc;. rc = sqlit
7c10: 65 33 50 72 65 70 61 72 65 31 36 28 64 62 2c 7a e3Prepare16(db,z
7c20: 53 71 6c 2c 6e 42 79 74 65 73 2c 53 51 4c 49 54 Sql,nBytes,SQLIT
7c30: 45 5f 50 52 45 50 41 52 45 5f 53 41 56 45 53 51 E_PREPARE_SAVESQ
7c40: 4c 2c 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29 L,ppStmt,pzTail)
7c50: 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d ;. assert( rc==
7c60: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53 SQLITE_OK || ppS
7c70: 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d tmt==0 || *ppStm
7c80: 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52 49 t==0 ); /* VERI
7c90: 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20 20 FY: F13021 */.
7ca0: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 69 6e 74 return rc;.}.int
7cb0: 20 73 71 6c 69 74 65 33 5f 70 72 65 70 61 72 65 sqlite3_prepare
7cc0: 31 36 5f 76 33 28 0a 20 20 73 71 6c 69 74 65 33 16_v3(. sqlite3
7cd0: 20 2a 64 62 2c 20 20 20 20 20 20 20 20 20 20 20 *db,
7ce0: 20 20 20 2f 2a 20 44 61 74 61 62 61 73 65 20 68 /* Database h
7cf0: 61 6e 64 6c 65 2e 20 2a 2f 20 0a 20 20 63 6f 6e andle. */ . con
7d00: 73 74 20 76 6f 69 64 20 2a 7a 53 71 6c 2c 20 20 st void *zSql,
7d10: 20 20 20 20 20 20 20 2f 2a 20 55 54 46 2d 31 36 /* UTF-16
7d20: 20 65 6e 63 6f 64 65 64 20 53 51 4c 20 73 74 61 encoded SQL sta
7d30: 74 65 6d 65 6e 74 2e 20 2a 2f 0a 20 20 69 6e 74 tement. */. int
7d40: 20 6e 42 79 74 65 73 2c 20 20 20 20 20 20 20 20 nBytes,
7d50: 20 20 20 20 20 20 20 2f 2a 20 4c 65 6e 67 74 68 /* Length
7d60: 20 6f 66 20 7a 53 71 6c 20 69 6e 20 62 79 74 65 of zSql in byte
7d70: 73 2e 20 2a 2f 0a 20 20 75 6e 73 69 67 6e 65 64 s. */. unsigned
7d80: 20 69 6e 74 20 70 72 65 70 46 6c 61 67 73 2c 20 int prepFlags,
7d90: 20 20 2f 2a 20 5a 65 72 6f 20 6f 72 20 6d 6f 72 /* Zero or mor
7da0: 65 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 e SQLITE_PREPARE
7db0: 5f 2a 20 66 6c 61 67 73 20 2a 2f 0a 20 20 73 71 _* flags */. sq
7dc0: 6c 69 74 65 33 5f 73 74 6d 74 20 2a 2a 70 70 53 lite3_stmt **ppS
7dd0: 74 6d 74 2c 20 20 20 20 2f 2a 20 4f 55 54 3a 20 tmt, /* OUT:
7de0: 41 20 70 6f 69 6e 74 65 72 20 74 6f 20 74 68 65 A pointer to the
7df0: 20 70 72 65 70 61 72 65 64 20 73 74 61 74 65 6d prepared statem
7e00: 65 6e 74 20 2a 2f 0a 20 20 63 6f 6e 73 74 20 76 ent */. const v
7e10: 6f 69 64 20 2a 2a 70 7a 54 61 69 6c 20 20 20 20 oid **pzTail
7e20: 20 20 20 2f 2a 20 4f 55 54 3a 20 45 6e 64 20 6f /* OUT: End o
7e30: 66 20 70 61 72 73 65 64 20 73 74 72 69 6e 67 20 f parsed string
7e40: 2a 2f 0a 29 7b 0a 20 20 69 6e 74 20 72 63 3b 0a */.){. int rc;.
7e50: 20 20 72 63 20 3d 20 73 71 6c 69 74 65 33 50 72 rc = sqlite3Pr
7e60: 65 70 61 72 65 31 36 28 64 62 2c 7a 53 71 6c 2c epare16(db,zSql,
7e70: 6e 42 79 74 65 73 2c 0a 20 20 20 20 20 20 20 20 nBytes,.
7e80: 20 53 51 4c 49 54 45 5f 50 52 45 50 41 52 45 5f SQLITE_PREPARE_
7e90: 53 41 56 45 53 51 4c 7c 28 70 72 65 70 46 6c 61 SAVESQL|(prepFla
7ea0: 67 73 26 53 51 4c 49 54 45 5f 50 52 45 50 41 52 gs&SQLITE_PREPAR
7eb0: 45 5f 4d 41 53 4b 29 2c 0a 20 20 20 20 20 20 20 E_MASK),.
7ec0: 20 20 70 70 53 74 6d 74 2c 70 7a 54 61 69 6c 29 ppStmt,pzTail)
7ed0: 3b 0a 20 20 61 73 73 65 72 74 28 20 72 63 3d 3d ;. assert( rc==
7ee0: 53 51 4c 49 54 45 5f 4f 4b 20 7c 7c 20 70 70 53 SQLITE_OK || ppS
7ef0: 74 6d 74 3d 3d 30 20 7c 7c 20 2a 70 70 53 74 6d tmt==0 || *ppStm
7f00: 74 3d 3d 30 20 29 3b 20 20 2f 2a 20 56 45 52 49 t==0 ); /* VERI
7f10: 46 59 3a 20 46 31 33 30 32 31 20 2a 2f 0a 20 20 FY: F13021 */.
7f20: 72 65 74 75 72 6e 20 72 63 3b 0a 7d 0a 0a 23 65 return rc;.}..#e
7f30: 6e 64 69 66 20 2f 2a 20 53 51 4c 49 54 45 5f 4f ndif /* SQLITE_O
7f40: 4d 49 54 5f 55 54 46 31 36 20 2a 2f 0a MIT_UTF16 */.