0000: 2f 2a 0a 2a 2a 20 32 30 30 31 20 53 65 70 74 65 /*.** 2001 Septe
0010: 6d 62 65 72 20 31 35 0a 2a 2a 0a 2a 2a 20 54 68 mber 15.**.** Th
0020: 65 20 61 75 74 68 6f 72 20 64 69 73 63 6c 61 69 e author disclai
0030: 6d 73 20 63 6f 70 79 72 69 67 68 74 20 74 6f 20 ms copyright to
0040: 74 68 69 73 20 73 6f 75 72 63 65 20 63 6f 64 65 this source code
0050: 2e 20 20 49 6e 20 70 6c 61 63 65 20 6f 66 0a 2a . In place of.*
0060: 2a 20 61 20 6c 65 67 61 6c 20 6e 6f 74 69 63 65 * a legal notice
0070: 2c 20 68 65 72 65 20 69 73 20 61 20 62 6c 65 73 , here is a bles
0080: 73 69 6e 67 3a 0a 2a 2a 0a 2a 2a 20 20 20 20 4d sing:.**.** M
0090: 61 79 20 79 6f 75 20 64 6f 20 67 6f 6f 64 20 61 ay you do good a
00a0: 6e 64 20 6e 6f 74 20 65 76 69 6c 2e 0a 2a 2a 20 nd not evil..**
00b0: 20 20 20 4d 61 79 20 79 6f 75 20 66 69 6e 64 20 May you find
00c0: 66 6f 72 67 69 76 65 6e 65 73 73 20 66 6f 72 20 forgiveness for
00d0: 79 6f 75 72 73 65 6c 66 20 61 6e 64 20 66 6f 72 yourself and for
00e0: 67 69 76 65 20 6f 74 68 65 72 73 2e 0a 2a 2a 20 give others..**
00f0: 20 20 20 4d 61 79 20 79 6f 75 20 73 68 61 72 65 May you share
0100: 20 66 72 65 65 6c 79 2c 20 6e 65 76 65 72 20 74 freely, never t
0110: 61 6b 69 6e 67 20 6d 6f 72 65 20 74 68 61 6e 20 aking more than
0120: 79 6f 75 20 67 69 76 65 2e 0a 2a 2a 0a 2a 2a 2a you give..**.***
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: 2a 2a 2a 2a 2a 2a 0a 2a 2a 20 4d 61 69 6e 20 66 ******.** Main f
0180: 69 6c 65 20 66 6f 72 20 74 68 65 20 53 51 4c 69 ile for the SQLi
0190: 74 65 20 6c 69 62 72 61 72 79 2e 20 20 54 68 65 te library. The
01a0: 20 72 6f 75 74 69 6e 65 73 20 69 6e 20 74 68 69 routines in thi
01b0: 73 20 66 69 6c 65 0a 2a 2a 20 69 6d 70 6c 65 6d s file.** implem
01c0: 65 6e 74 20 74 68 65 20 70 72 6f 67 72 61 6d 6d ent the programm
01d0: 65 72 20 69 6e 74 65 72 66 61 63 65 20 74 6f 20 er interface to
01e0: 74 68 65 20 6c 69 62 72 61 72 79 2e 20 20 52 6f the library. Ro
01f0: 75 74 69 6e 65 73 20 69 6e 0a 2a 2a 20 6f 74 68 utines in.** oth
0200: 65 72 20 66 69 6c 65 73 20 61 72 65 20 66 6f 72 er files are for
0210: 20 69 6e 74 65 72 6e 61 6c 20 75 73 65 20 62 79 internal use by
0220: 20 53 51 4c 69 74 65 20 61 6e 64 20 73 68 6f 75 SQLite and shou
0230: 6c 64 20 6e 6f 74 20 62 65 0a 2a 2a 20 61 63 63 ld not be.** acc
0240: 65 73 73 65 64 20 62 79 20 75 73 65 72 73 20 6f essed by users o
0250: 66 20 74 68 65 20 6c 69 62 72 61 72 79 2e 0a 2a f the library..*
0260: 2a 0a 2a 2a 20 24 49 64 3a 20 6d 61 69 6e 2e 63 *.** $Id: main.c
0270: 2c 76 20 31 2e 35 33 20 32 30 30 32 2f 30 31 2f ,v 1.53 2002/01/
0280: 30 36 20 31 37 3a 30 37 3a 34 30 20 64 72 68 20 06 17:07:40 drh
0290: 45 78 70 20 24 0a 2a 2f 0a 23 69 6e 63 6c 75 64 Exp $.*/.#includ
02a0: 65 20 22 73 71 6c 69 74 65 49 6e 74 2e 68 22 0a e "sqliteInt.h".
02b0: 23 69 6e 63 6c 75 64 65 20 22 6f 73 2e 68 22 0a #include "os.h".
02c0: 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 69 73 20 74 ./*.** This is t
02d0: 68 65 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 he callback rout
02e0: 69 6e 65 20 66 6f 72 20 74 68 65 20 63 6f 64 65 ine for the code
02f0: 20 74 68 61 74 20 69 6e 69 74 69 61 6c 69 7a 65 that initialize
0300: 73 20 74 68 65 0a 2a 2a 20 64 61 74 61 62 61 73 s the.** databas
0310: 65 2e 20 20 53 65 65 20 73 71 6c 69 74 65 49 6e e. See sqliteIn
0320: 69 74 28 29 20 62 65 6c 6f 77 20 66 6f 72 20 61 it() below for a
0330: 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d dditional inform
0340: 61 74 69 6f 6e 2e 0a 2a 2a 0a 2a 2a 20 45 61 63 ation..**.** Eac
0350: 68 20 63 61 6c 6c 62 61 63 6b 20 63 6f 6e 74 61 h callback conta
0360: 69 6e 73 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e ins the followin
0370: 67 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 3a 0a 2a g information:.*
0380: 2a 0a 2a 2a 20 20 20 20 20 61 72 67 76 5b 30 5d *.** argv[0]
0390: 20 3d 20 22 66 69 6c 65 2d 66 6f 72 6d 61 74 22 = "file-format"
03a0: 20 6f 72 20 22 73 63 68 65 6d 61 2d 63 6f 6f 6b or "schema-cook
03b0: 69 65 22 20 6f 72 20 22 74 61 62 6c 65 22 20 6f ie" or "table" o
03c0: 72 20 22 69 6e 64 65 78 22 0a 2a 2a 20 20 20 20 r "index".**
03d0: 20 61 72 67 76 5b 31 5d 20 3d 20 74 61 62 6c 65 argv[1] = table
03e0: 20 6f 72 20 69 6e 64 65 78 20 6e 61 6d 65 20 6f or index name o
03f0: 72 20 6d 65 74 61 20 73 74 61 74 65 6d 65 6e 74 r meta statement
0400: 20 74 79 70 65 2e 0a 2a 2a 20 20 20 20 20 61 72 type..** ar
0410: 67 76 5b 32 5d 20 3d 20 72 6f 6f 74 20 70 61 67 gv[2] = root pag
0420: 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 61 62 e number for tab
0430: 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 4e 55 le or index. NU
0440: 4c 4c 20 66 6f 72 20 6d 65 74 61 2e 0a 2a 2a 20 LL for meta..**
0450: 20 20 20 20 61 72 67 76 5b 33 5d 20 3d 20 53 51 argv[3] = SQ
0460: 4c 20 63 72 65 61 74 65 20 73 74 61 74 65 6d 65 L create stateme
0470: 6e 74 20 66 6f 72 20 74 68 65 20 74 61 62 6c 65 nt for the table
0480: 20 6f 72 20 69 6e 64 65 78 0a 2a 2a 0a 2a 2f 0a or index.**.*/.
0490: 73 74 61 74 69 63 20 69 6e 74 20 73 71 6c 69 74 static int sqlit
04a0: 65 4f 70 65 6e 43 62 28 76 6f 69 64 20 2a 70 44 eOpenCb(void *pD
04b0: 62 2c 20 69 6e 74 20 61 72 67 63 2c 20 63 68 61 b, int argc, cha
04c0: 72 20 2a 2a 61 72 67 76 2c 20 63 68 61 72 20 2a r **argv, char *
04d0: 2a 61 7a 43 6f 6c 4e 61 6d 65 29 7b 0a 20 20 73 *azColName){. s
04e0: 71 6c 69 74 65 20 2a 64 62 20 3d 20 28 73 71 6c qlite *db = (sql
04f0: 69 74 65 2a 29 70 44 62 3b 0a 20 20 50 61 72 73 ite*)pDb;. Pars
0500: 65 20 73 50 61 72 73 65 3b 0a 20 20 69 6e 74 20 e sParse;. int
0510: 6e 45 72 72 20 3d 20 30 3b 0a 0a 20 20 2f 2a 20 nErr = 0;.. /*
0520: 54 4f 44 4f 3a 20 44 6f 20 73 6f 6d 65 20 76 61 TODO: Do some va
0530: 6c 69 64 69 74 79 20 63 68 65 63 6b 73 20 6f 6e lidity checks on
0540: 20 61 6c 6c 20 66 69 65 6c 64 73 2e 20 20 49 6e all fields. In
0550: 20 70 61 72 74 69 63 75 6c 61 72 2c 0a 20 20 2a particular,. *
0560: 2a 20 6d 61 6b 65 20 73 75 72 65 20 66 69 65 6c * make sure fiel
0570: 64 73 20 64 6f 20 6e 6f 74 20 63 6f 6e 74 61 69 ds do not contai
0580: 6e 20 4e 55 4c 4c 73 2e 20 4f 74 68 65 72 77 69 n NULLs. Otherwi
0590: 73 65 20 77 65 20 6d 69 67 68 74 20 63 6f 72 65 se we might core
05a0: 0a 20 20 2a 2a 20 77 68 65 6e 20 61 74 74 65 6d . ** when attem
05b0: 70 74 69 6e 67 20 74 6f 20 69 6e 69 74 69 61 6c pting to initial
05c0: 69 7a 65 20 66 72 6f 6d 20 61 20 63 6f 72 72 75 ize from a corru
05d0: 70 74 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 pt database file
05e0: 2e 20 2a 2f 0a 0a 20 20 61 73 73 65 72 74 28 20 . */.. assert(
05f0: 61 72 67 63 3d 3d 34 20 29 3b 0a 20 20 73 77 69 argc==4 );. swi
0600: 74 63 68 28 20 61 72 67 76 5b 30 5d 5b 30 5d 20 tch( argv[0][0]
0610: 29 7b 0a 20 20 20 20 63 61 73 65 20 27 66 27 3a ){. case 'f':
0620: 20 7b 20 20 2f 2a 20 46 69 6c 65 20 66 6f 72 6d { /* File form
0630: 61 74 20 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e at */. db->
0640: 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 61 74 file_format = at
0650: 6f 69 28 61 72 67 76 5b 33 5d 29 3b 0a 20 20 20 oi(argv[3]);.
0660: 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 7d 0a break;. }.
0670: 20 20 20 20 63 61 73 65 20 27 73 27 3a 20 7b 20 case 's': {
0680: 2f 2a 20 53 63 68 65 6d 61 20 63 6f 6f 6b 69 65 /* Schema cookie
0690: 20 2a 2f 0a 20 20 20 20 20 20 64 62 2d 3e 73 63 */. db->sc
06a0: 68 65 6d 61 5f 63 6f 6f 6b 69 65 20 3d 20 61 74 hema_cookie = at
06b0: 6f 69 28 61 72 67 76 5b 33 5d 29 3b 0a 20 20 20 oi(argv[3]);.
06c0: 20 20 20 64 62 2d 3e 6e 65 78 74 5f 63 6f 6f 6b db->next_cook
06d0: 69 65 20 3d 20 64 62 2d 3e 73 63 68 65 6d 61 5f ie = db->schema_
06e0: 63 6f 6f 6b 69 65 3b 0a 20 20 20 20 20 20 62 72 cookie;. br
06f0: 65 61 6b 3b 0a 20 20 20 20 7d 0a 20 20 20 20 63 eak;. }. c
0700: 61 73 65 20 27 69 27 3a 0a 20 20 20 20 63 61 73 ase 'i':. cas
0710: 65 20 27 74 27 3a 20 7b 20 20 2f 2a 20 43 52 45 e 't': { /* CRE
0720: 41 54 45 20 54 41 42 4c 45 20 20 61 6e 64 20 43 ATE TABLE and C
0730: 52 45 41 54 45 20 49 4e 44 45 58 20 73 74 61 74 REATE INDEX stat
0740: 65 6d 65 6e 74 73 20 2a 2f 0a 20 20 20 20 20 20 ements */.
0750: 69 66 28 20 61 72 67 76 5b 33 5d 20 26 26 20 61 if( argv[3] && a
0760: 72 67 76 5b 33 5d 5b 30 5d 20 29 7b 0a 20 20 20 rgv[3][0] ){.
0770: 20 20 20 20 20 2f 2a 20 43 61 6c 6c 20 74 68 65 /* Call the
0780: 20 70 61 72 73 65 72 20 74 6f 20 70 72 6f 63 65 parser to proce
0790: 73 73 20 61 20 43 52 45 41 54 45 20 54 41 42 4c ss a CREATE TABL
07a0: 45 20 6f 72 20 43 52 45 41 54 45 20 49 4e 44 45 E or CREATE INDE
07b0: 58 20 73 74 61 74 65 6d 65 6e 74 2e 0a 20 20 20 X statement..
07c0: 20 20 20 20 20 2a 2a 20 42 75 74 20 62 65 63 61 ** But beca
07d0: 75 73 65 20 73 50 61 72 73 65 2e 69 6e 69 74 46 use sParse.initF
07e0: 6c 61 67 20 69 73 20 73 65 74 20 74 6f 20 31 2c lag is set to 1,
07f0: 20 6e 6f 20 56 44 42 45 20 63 6f 64 65 20 69 73 no VDBE code is
0800: 20 67 65 6e 65 72 61 74 65 64 0a 20 20 20 20 20 generated.
0810: 20 20 20 2a 2a 20 6f 72 20 65 78 65 63 75 74 65 ** or execute
0820: 64 2e 20 20 41 6c 6c 20 74 68 65 20 70 61 72 73 d. All the pars
0830: 65 72 20 64 6f 65 73 20 69 73 20 62 75 69 6c 64 er does is build
0840: 20 74 68 65 20 69 6e 74 65 72 6e 61 6c 20 64 61 the internal da
0850: 74 61 0a 20 20 20 20 20 20 20 20 2a 2a 20 73 74 ta. ** st
0860: 72 75 63 74 75 72 65 73 20 74 68 61 74 20 64 65 ructures that de
0870: 73 63 72 69 62 65 20 74 68 65 20 74 61 62 6c 65 scribe the table
0880: 20 6f 72 20 69 6e 64 65 78 2e 0a 20 20 20 20 20 or index..
0890: 20 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 6d 65 */. me
08a0: 6d 73 65 74 28 26 73 50 61 72 73 65 2c 20 30 2c mset(&sParse, 0,
08b0: 20 73 69 7a 65 6f 66 28 73 50 61 72 73 65 29 29 sizeof(sParse))
08c0: 3b 0a 20 20 20 20 20 20 20 20 73 50 61 72 73 65 ;. sParse
08d0: 2e 64 62 20 3d 20 64 62 3b 0a 20 20 20 20 20 20 .db = db;.
08e0: 20 20 73 50 61 72 73 65 2e 69 6e 69 74 46 6c 61 sParse.initFla
08f0: 67 20 3d 20 31 3b 0a 20 20 20 20 20 20 20 20 73 g = 1;. s
0900: 50 61 72 73 65 2e 6e 65 77 54 6e 75 6d 20 3d 20 Parse.newTnum =
0910: 61 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a 20 atoi(argv[2]);.
0920: 20 20 20 20 20 20 20 73 71 6c 69 74 65 52 75 6e sqliteRun
0930: 50 61 72 73 65 72 28 26 73 50 61 72 73 65 2c 20 Parser(&sParse,
0940: 61 72 67 76 5b 33 5d 2c 20 30 29 3b 0a 20 20 20 argv[3], 0);.
0950: 20 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 }else{.
0960: 20 20 2f 2a 20 49 66 20 74 68 65 20 53 51 4c 20 /* If the SQL
0970: 63 6f 6c 75 6d 6e 20 69 73 20 62 6c 61 6e 6b 20 column is blank
0980: 69 74 20 6d 65 61 6e 73 20 74 68 69 73 20 69 73 it means this is
0990: 20 61 6e 20 69 6e 64 65 78 20 74 68 61 74 0a 20 an index that.
09a0: 20 20 20 20 20 20 20 2a 2a 20 77 61 73 20 63 72 ** was cr
09b0: 65 61 74 65 64 20 74 6f 20 62 65 20 74 68 65 20 eated to be the
09c0: 50 52 49 4d 41 52 59 20 4b 45 59 20 6f 72 20 74 PRIMARY KEY or t
09d0: 6f 20 66 75 6c 66 69 6c 6c 20 61 20 55 4e 49 51 o fulfill a UNIQ
09e0: 55 45 0a 20 20 20 20 20 20 20 20 2a 2a 20 63 6f UE. ** co
09f0: 6e 73 74 72 61 69 6e 74 20 66 6f 72 20 61 20 43 nstraint for a C
0a00: 52 45 41 54 45 20 54 41 42 4c 45 2e 20 20 54 68 REATE TABLE. Th
0a10: 65 20 69 6e 64 65 78 20 73 68 6f 75 6c 64 20 68 e index should h
0a20: 61 76 65 20 61 6c 72 65 61 64 79 0a 20 20 20 20 ave already.
0a30: 20 20 20 20 2a 2a 20 62 65 65 6e 20 63 72 65 61 ** been crea
0a40: 74 65 64 20 77 68 65 6e 20 77 65 20 70 72 6f 63 ted when we proc
0a50: 65 73 73 65 64 20 74 68 65 20 43 52 45 41 54 45 essed the CREATE
0a60: 20 54 41 42 4c 45 2e 20 20 41 6c 6c 20 77 65 20 TABLE. All we
0a70: 68 61 76 65 0a 20 20 20 20 20 20 20 20 2a 2a 20 have. **
0a80: 74 6f 20 64 6f 20 68 65 72 65 20 69 73 20 72 65 to do here is re
0a90: 63 6f 72 64 20 74 68 65 20 72 6f 6f 74 20 70 61 cord the root pa
0aa0: 67 65 20 6e 75 6d 62 65 72 20 66 6f 72 20 74 68 ge number for th
0ab0: 61 74 20 69 6e 64 65 78 2e 0a 20 20 20 20 20 20 at index..
0ac0: 20 20 2a 2f 0a 20 20 20 20 20 20 20 20 49 6e 64 */. Ind
0ad0: 65 78 20 2a 70 49 6e 64 65 78 20 3d 20 73 71 6c ex *pIndex = sql
0ae0: 69 74 65 46 69 6e 64 49 6e 64 65 78 28 64 62 2c iteFindIndex(db,
0af0: 20 61 72 67 76 5b 31 5d 29 3b 0a 20 20 20 20 20 argv[1]);.
0b00: 20 20 20 69 66 28 20 70 49 6e 64 65 78 3d 3d 30 if( pIndex==0
0b10: 20 7c 7c 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d || pIndex->tnum
0b20: 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 20 !=0 ){.
0b30: 20 6e 45 72 72 2b 2b 3b 0a 20 20 20 20 20 20 20 nErr++;.
0b40: 20 7d 65 6c 73 65 7b 0a 20 20 20 20 20 20 20 20 }else{.
0b50: 20 20 70 49 6e 64 65 78 2d 3e 74 6e 75 6d 20 3d pIndex->tnum =
0b60: 20 61 74 6f 69 28 61 72 67 76 5b 32 5d 29 3b 0a atoi(argv[2]);.
0b70: 20 20 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 }.
0b80: 7d 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 }. break;.
0b90: 20 20 20 7d 0a 20 20 20 20 64 65 66 61 75 6c 74 }. default
0ba0: 3a 20 7b 0a 20 20 20 20 20 20 2f 2a 20 54 68 69 : {. /* Thi
0bb0: 73 20 63 61 6e 20 6e 6f 74 20 68 61 70 70 65 6e s can not happen
0bc0: 21 20 2a 2f 0a 20 20 20 20 20 20 6e 45 72 72 20 ! */. nErr
0bd0: 3d 20 31 3b 0a 20 20 20 20 20 20 61 73 73 65 72 = 1;. asser
0be0: 74 28 20 6e 45 72 72 3d 3d 30 20 29 3b 0a 20 20 t( nErr==0 );.
0bf0: 20 20 7d 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e }. }. return
0c00: 20 6e 45 72 72 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 nErr;.}../*.**
0c10: 41 74 74 65 6d 70 74 20 74 6f 20 72 65 61 64 20 Attempt to read
0c20: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68 the database sch
0c30: 65 6d 61 20 61 6e 64 20 69 6e 69 74 69 61 6c 69 ema and initiali
0c40: 7a 65 20 69 6e 74 65 72 6e 61 6c 0a 2a 2a 20 64 ze internal.** d
0c50: 61 74 61 20 73 74 72 75 63 74 75 72 65 73 2e 20 ata structures.
0c60: 20 52 65 74 75 72 6e 20 6f 6e 65 20 6f 66 20 74 Return one of t
0c70: 68 65 20 53 51 4c 49 54 45 5f 20 65 72 72 6f 72 he SQLITE_ error
0c80: 20 63 6f 64 65 73 20 74 6f 0a 2a 2a 20 69 6e 64 codes to.** ind
0c90: 69 63 61 74 65 20 73 75 63 63 65 73 73 20 6f 72 icate success or
0ca0: 20 66 61 69 6c 75 72 65 2e 0a 2a 2a 0a 2a 2a 20 failure..**.**
0cb0: 41 66 74 65 72 20 74 68 65 20 64 61 74 61 62 61 After the databa
0cc0: 73 65 20 69 73 20 69 6e 69 74 69 61 6c 69 7a 65 se is initialize
0cd0: 64 2c 20 74 68 65 20 53 51 4c 49 54 45 5f 49 6e d, the SQLITE_In
0ce0: 69 74 69 61 6c 69 7a 65 64 0a 2a 2a 20 62 69 74 itialized.** bit
0cf0: 20 69 73 20 73 65 74 20 69 6e 20 74 68 65 20 66 is set in the f
0d00: 6c 61 67 73 20 66 69 65 6c 64 20 6f 66 20 74 68 lags field of th
0d10: 65 20 73 71 6c 69 74 65 20 73 74 72 75 63 74 75 e sqlite structu
0d20: 72 65 2e 20 20 41 6e 0a 2a 2a 20 61 74 74 65 6d re. An.** attem
0d30: 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20 69 6e pt is made to in
0d40: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 64 61 74 itialize the dat
0d50: 61 62 61 73 65 20 61 73 20 73 6f 6f 6e 20 61 73 abase as soon as
0d60: 20 69 74 0a 2a 2a 20 69 73 20 6f 70 65 6e 65 64 it.** is opened
0d70: 2e 20 20 49 66 20 74 68 61 74 20 66 61 69 6c 73 . If that fails
0d80: 20 28 70 65 72 68 61 70 73 20 62 65 63 61 75 73 (perhaps becaus
0d90: 65 20 61 6e 6f 74 68 65 72 20 70 72 6f 63 65 73 e another proces
0da0: 73 0a 2a 2a 20 68 61 73 20 74 68 65 20 73 71 6c s.** has the sql
0db0: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 ite_master table
0dc0: 20 6c 6f 63 6b 65 64 29 20 74 68 61 6e 20 61 6e locked) than an
0dd0: 6f 74 68 65 72 20 61 74 74 65 6d 70 74 0a 2a 2a other attempt.**
0de0: 20 69 73 20 6d 61 64 65 20 74 68 65 20 66 69 72 is made the fir
0df0: 73 74 20 74 69 6d 65 20 74 68 65 20 64 61 74 61 st time the data
0e00: 62 61 73 65 20 69 73 20 61 63 63 65 73 73 65 64 base is accessed
0e10: 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e 74 20 ..*/.static int
0e20: 73 71 6c 69 74 65 49 6e 69 74 28 73 71 6c 69 74 sqliteInit(sqlit
0e30: 65 20 2a 64 62 2c 20 63 68 61 72 20 2a 2a 70 7a e *db, char **pz
0e40: 45 72 72 4d 73 67 29 7b 0a 20 20 56 64 62 65 20 ErrMsg){. Vdbe
0e50: 2a 76 64 62 65 3b 0a 20 20 69 6e 74 20 72 63 3b *vdbe;. int rc;
0e60: 0a 0a 20 20 2f 2a 0a 20 20 2a 2a 20 54 68 65 20 .. /*. ** The
0e70: 6d 61 73 74 65 72 20 64 61 74 61 62 61 73 65 20 master database
0e80: 74 61 62 6c 65 20 68 61 73 20 61 20 73 74 72 75 table has a stru
0e90: 63 74 75 72 65 20 6c 69 6b 65 20 74 68 69 73 0a cture like this.
0ea0: 20 20 2a 2f 0a 20 20 73 74 61 74 69 63 20 63 68 */. static ch
0eb0: 61 72 20 6d 61 73 74 65 72 5f 73 63 68 65 6d 61 ar master_schema
0ec0: 5b 5d 20 3d 20 0a 20 20 20 20 20 22 43 52 45 41 [] = . "CREA
0ed0: 54 45 20 54 41 42 4c 45 20 22 20 4d 41 53 54 45 TE TABLE " MASTE
0ee0: 52 5f 4e 41 4d 45 20 22 20 28 5c 6e 22 0a 20 20 R_NAME " (\n".
0ef0: 20 20 20 22 20 20 74 79 70 65 20 74 65 78 74 2c " type text,
0f00: 5c 6e 22 0a 20 20 20 20 20 22 20 20 6e 61 6d 65 \n". " name
0f10: 20 74 65 78 74 2c 5c 6e 22 0a 20 20 20 20 20 22 text,\n". "
0f20: 20 20 74 62 6c 5f 6e 61 6d 65 20 74 65 78 74 2c tbl_name text,
0f30: 5c 6e 22 0a 20 20 20 20 20 22 20 20 72 6f 6f 74 \n". " root
0f40: 70 61 67 65 20 69 6e 74 65 67 65 72 2c 5c 6e 22 page integer,\n"
0f50: 0a 20 20 20 20 20 22 20 20 73 71 6c 20 74 65 78 . " sql tex
0f60: 74 5c 6e 22 0a 20 20 20 20 20 22 29 22 0a 20 20 t\n". ")".
0f70: 3b 0a 0a 20 20 2f 2a 20 54 68 65 20 66 6f 6c 6c ;.. /* The foll
0f80: 6f 77 69 6e 67 20 56 44 42 45 20 70 72 6f 67 72 owing VDBE progr
0f90: 61 6d 20 69 73 20 75 73 65 64 20 74 6f 20 69 6e am is used to in
0fa0: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 69 6e 74 itialize the int
0fb0: 65 72 6e 61 6c 0a 20 20 2a 2a 20 73 74 72 75 63 ernal. ** struc
0fc0: 74 75 72 65 20 68 6f 6c 64 69 6e 67 20 74 68 65 ture holding the
0fd0: 20 74 61 62 6c 65 73 20 61 6e 64 20 69 6e 64 65 tables and inde
0fe0: 78 65 73 20 6f 66 20 74 68 65 20 64 61 74 61 62 xes of the datab
0ff0: 61 73 65 2e 0a 20 20 2a 2a 20 54 68 65 20 64 61 ase.. ** The da
1000: 74 61 62 61 73 65 20 63 6f 6e 74 61 69 6e 73 20 tabase contains
1010: 61 20 73 70 65 63 69 61 6c 20 74 61 62 6c 65 20 a special table
1020: 6e 61 6d 65 64 20 22 73 71 6c 69 74 65 5f 6d 61 named "sqlite_ma
1030: 73 74 65 72 22 0a 20 20 2a 2a 20 64 65 66 69 6e ster". ** defin
1040: 65 64 20 61 73 20 66 6f 6c 6c 6f 77 73 3a 0a 20 ed as follows:.
1050: 20 2a 2a 0a 20 20 2a 2a 20 20 20 20 43 52 45 41 **. ** CREA
1060: 54 45 20 54 41 42 4c 45 20 73 71 6c 69 74 65 5f TE TABLE sqlite_
1070: 6d 61 73 74 65 72 20 28 0a 20 20 2a 2a 20 20 20 master (. **
1080: 20 20 20 20 20 74 79 70 65 20 20 20 20 20 20 20 type
1090: 74 65 78 74 2c 20 20 20 20 2d 2d 20 20 45 69 74 text, -- Eit
10a0: 68 65 72 20 22 74 61 62 6c 65 22 20 6f 72 20 22 her "table" or "
10b0: 69 6e 64 65 78 22 20 6f 72 20 22 6d 65 74 61 22 index" or "meta"
10c0: 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 6e 61 6d . ** nam
10d0: 65 20 20 20 20 20 20 20 74 65 78 74 2c 20 20 20 e text,
10e0: 20 2d 2d 20 20 4e 61 6d 65 20 6f 66 20 74 61 62 -- Name of tab
10f0: 6c 65 20 6f 72 20 69 6e 64 65 78 0a 20 20 2a 2a le or index. **
1100: 20 20 20 20 20 20 20 20 74 62 6c 5f 6e 61 6d 65 tbl_name
1110: 20 20 20 74 65 78 74 2c 20 20 20 20 2d 2d 20 20 text, --
1120: 41 73 73 6f 63 69 61 74 65 64 20 74 61 62 6c 65 Associated table
1130: 20 0a 20 20 2a 2a 20 20 20 20 20 20 20 20 72 6f . ** ro
1140: 6f 74 70 61 67 65 20 20 20 69 6e 74 65 67 65 72 otpage integer
1150: 2c 20 2d 2d 20 20 54 68 65 20 69 6e 74 65 67 65 , -- The intege
1160: 72 20 70 61 67 65 20 6e 75 6d 62 65 72 20 6f 66 r page number of
1170: 20 72 6f 6f 74 20 70 61 67 65 0a 20 20 2a 2a 20 root page. **
1180: 20 20 20 20 20 20 20 73 71 6c 20 20 20 20 20 20 sql
1190: 20 20 74 65 78 74 20 20 20 20 20 2d 2d 20 20 54 text -- T
11a0: 68 65 20 43 52 45 41 54 45 20 73 74 61 74 65 6d he CREATE statem
11b0: 65 6e 74 20 66 6f 72 20 74 68 69 73 20 6f 62 6a ent for this obj
11c0: 65 63 74 0a 20 20 2a 2a 20 20 20 20 29 3b 0a 20 ect. ** );.
11d0: 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 73 71 6c **. ** The sql
11e0: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65 ite_master table
11f0: 20 63 6f 6e 74 61 69 6e 73 20 61 20 73 69 6e 67 contains a sing
1200: 6c 65 20 65 6e 74 72 79 20 66 6f 72 20 65 61 63 le entry for eac
1210: 68 20 74 61 62 6c 65 0a 20 20 2a 2a 20 61 6e 64 h table. ** and
1220: 20 65 61 63 68 20 69 6e 64 65 78 2e 20 20 54 68 each index. Th
1230: 65 20 22 74 79 70 65 22 20 63 6f 6c 75 6d 6e 20 e "type" column
1240: 74 65 6c 6c 73 20 77 68 65 74 68 65 72 20 74 68 tells whether th
1250: 65 20 65 6e 74 72 79 20 69 73 0a 20 20 2a 2a 20 e entry is. **
1260: 61 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 a table or index
1270: 2e 20 20 54 68 65 20 22 6e 61 6d 65 22 20 63 6f . The "name" co
1280: 6c 75 6d 6e 20 69 73 20 74 68 65 20 6e 61 6d 65 lumn is the name
1290: 20 6f 66 20 74 68 65 20 6f 62 6a 65 63 74 2e 0a of the object..
12a0: 20 20 2a 2a 20 54 68 65 20 22 74 62 6c 5f 6e 61 ** The "tbl_na
12b0: 6d 65 22 20 69 73 20 74 68 65 20 6e 61 6d 65 20 me" is the name
12c0: 6f 66 20 74 68 65 20 61 73 73 6f 63 69 61 74 65 of the associate
12d0: 64 20 74 61 62 6c 65 2e 20 20 46 6f 72 20 74 61 d table. For ta
12e0: 62 6c 65 73 2c 0a 20 20 2a 2a 20 74 68 65 20 74 bles,. ** the t
12f0: 62 6c 5f 6e 61 6d 65 20 63 6f 6c 75 6d 6e 20 69 bl_name column i
1300: 73 20 61 6c 77 61 79 73 20 74 68 65 20 73 61 6d s always the sam
1310: 65 20 61 73 20 6e 61 6d 65 2e 20 20 46 6f 72 20 e as name. For
1320: 69 6e 64 69 63 65 73 2c 20 74 68 65 0a 20 20 2a indices, the. *
1330: 2a 20 74 62 6c 5f 6e 61 6d 65 20 63 6f 6c 75 6d * tbl_name colum
1340: 6e 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 6e n contains the n
1350: 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 ame of the table
1360: 20 74 68 61 74 20 74 68 65 20 69 6e 64 65 78 0a that the index.
1370: 20 20 2a 2a 20 69 6e 64 65 78 65 73 2e 20 20 54 ** indexes. T
1380: 68 65 20 22 72 6f 6f 74 70 61 67 65 22 20 63 6f he "rootpage" co
1390: 6c 75 6d 6e 20 68 6f 6c 64 73 20 74 68 65 20 6e lumn holds the n
13a0: 75 6d 62 65 72 20 6f 66 20 74 68 65 20 72 6f 6f umber of the roo
13b0: 74 20 70 61 67 65 0a 20 20 2a 2a 20 66 6f 72 20 t page. ** for
13c0: 74 68 65 20 62 2d 74 72 65 65 20 66 6f 72 20 74 the b-tree for t
13d0: 68 65 20 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 he table or inde
13e0: 78 2e 20 20 46 69 6e 61 6c 6c 79 2c 20 74 68 65 x. Finally, the
13f0: 20 22 73 71 6c 22 20 63 6f 6c 75 6d 6e 0a 20 20 "sql" column.
1400: 2a 2a 20 63 6f 6e 74 61 69 6e 73 20 74 68 65 20 ** contains the
1410: 63 6f 6d 70 6c 65 74 65 20 74 65 78 74 20 6f 66 complete text of
1420: 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c the CREATE TABL
1430: 45 20 6f 72 20 43 52 45 41 54 45 20 49 4e 44 45 E or CREATE INDE
1440: 58 0a 20 20 2a 2a 20 73 74 61 74 65 6d 65 6e 74 X. ** statement
1450: 20 74 68 61 74 20 6f 72 69 67 69 6e 61 6c 6c 79 that originally
1460: 20 63 72 65 61 74 65 64 20 74 68 65 20 74 61 62 created the tab
1470: 6c 65 20 6f 72 20 69 6e 64 65 78 2e 20 20 49 66 le or index. If
1480: 20 61 6e 20 69 6e 64 65 78 0a 20 20 2a 2a 20 77 an index. ** w
1490: 61 73 20 63 72 65 61 74 65 64 20 74 6f 20 66 75 as created to fu
14a0: 6c 66 69 6c 6c 20 61 20 50 52 49 4d 41 52 59 20 lfill a PRIMARY
14b0: 4b 45 59 20 6f 72 20 55 4e 49 51 55 45 20 63 6f KEY or UNIQUE co
14c0: 6e 73 74 72 61 69 6e 74 20 6f 6e 20 61 20 74 61 nstraint on a ta
14d0: 62 6c 65 2c 0a 20 20 2a 2a 20 74 68 65 6e 20 74 ble,. ** then t
14e0: 68 65 20 22 73 71 6c 22 20 63 6f 6c 75 6d 6e 20 he "sql" column
14f0: 69 73 20 4e 55 4c 4c 2e 0a 20 20 2a 2a 0a 20 20 is NULL.. **.
1500: 2a 2a 20 49 66 20 74 68 65 20 22 74 79 70 65 22 ** If the "type"
1510: 20 63 6f 6c 75 6d 6e 20 68 61 73 20 74 68 65 20 column has the
1520: 76 61 6c 75 65 20 22 6d 65 74 61 22 2c 20 74 68 value "meta", th
1530: 65 6e 20 74 68 65 20 22 73 71 6c 22 20 63 6f 6c en the "sql" col
1540: 75 6d 6e 0a 20 20 2a 2a 20 63 6f 6e 74 61 69 6e umn. ** contain
1550: 73 20 65 78 74 72 61 20 69 6e 66 6f 72 6d 61 74 s extra informat
1560: 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20 64 61 ion about the da
1570: 74 61 62 61 73 65 2c 20 73 75 63 68 20 61 73 20 tabase, such as
1580: 74 68 65 0a 20 20 2a 2a 20 66 69 6c 65 20 66 6f the. ** file fo
1590: 72 6d 61 74 20 76 65 72 73 69 6f 6e 20 6e 75 6d rmat version num
15a0: 62 65 72 2e 20 20 41 6c 6c 20 6d 65 74 61 20 69 ber. All meta i
15b0: 6e 66 6f 72 6d 61 74 69 6f 6e 20 6d 75 73 74 20 nformation must
15c0: 62 65 20 70 72 6f 63 65 73 73 65 64 0a 20 20 2a be processed. *
15d0: 2a 20 62 65 66 6f 72 65 20 61 6e 79 20 74 61 62 * before any tab
15e0: 6c 65 73 20 6f 72 20 69 6e 64 69 63 65 73 20 61 les or indices a
15f0: 72 65 20 63 6f 6e 73 74 72 75 63 74 65 64 2e 0a re constructed..
1600: 20 20 2a 2a 0a 20 20 2a 2a 20 54 68 65 20 66 6f **. ** The fo
1610: 6c 6c 6f 77 69 6e 67 20 70 72 6f 67 72 61 6d 20 llowing program
1620: 69 6e 76 6f 6b 65 73 20 69 74 73 20 63 61 6c 6c invokes its call
1630: 62 61 63 6b 20 6f 6e 20 74 68 65 20 53 51 4c 20 back on the SQL
1640: 66 6f 72 20 65 61 63 68 0a 20 20 2a 2a 20 74 61 for each. ** ta
1650: 62 6c 65 20 74 68 65 6e 20 67 6f 65 73 20 62 61 ble then goes ba
1660: 63 6b 20 61 6e 64 20 69 6e 76 6f 6b 65 73 20 74 ck and invokes t
1670: 68 65 20 63 61 6c 6c 62 61 63 6b 20 6f 6e 20 74 he callback on t
1680: 68 65 0a 20 20 2a 2a 20 53 51 4c 20 66 6f 72 20 he. ** SQL for
1690: 65 61 63 68 20 69 6e 64 65 78 2e 20 20 54 68 65 each index. The
16a0: 20 63 61 6c 6c 62 61 63 6b 20 77 69 6c 6c 20 69 callback will i
16b0: 6e 76 6f 6b 65 20 74 68 65 0a 20 20 2a 2a 20 70 nvoke the. ** p
16c0: 61 72 73 65 72 20 74 6f 20 62 75 69 6c 64 20 74 arser to build t
16d0: 68 65 20 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 he internal repr
16e0: 65 73 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 esentation of th
16f0: 65 0a 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 e. ** database
1700: 73 63 68 65 6d 65 2e 0a 20 20 2a 2f 0a 20 20 73 scheme.. */. s
1710: 74 61 74 69 63 20 56 64 62 65 4f 70 20 69 6e 69 tatic VdbeOp ini
1720: 74 50 72 6f 67 5b 5d 20 3d 20 7b 0a 20 20 20 20 tProg[] = {.
1730: 7b 20 4f 50 5f 4f 70 65 6e 2c 20 20 20 20 20 20 { OP_Open,
1740: 20 30 2c 20 32 2c 20 20 30 7d 2c 0a 20 20 20 20 0, 2, 0},.
1750: 7b 20 4f 50 5f 53 74 72 69 6e 67 2c 20 20 20 20 { OP_String,
1760: 20 30 2c 20 30 2c 20 20 22 66 69 6c 65 2d 66 6f 0, 0, "file-fo
1770: 72 6d 61 74 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 rmat"},. { OP
1780: 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 _String, 0,
1790: 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 0, 0},. { OP
17a0: 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 _String, 0,
17b0: 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 0, 0},. { OP
17c0: 5f 52 65 61 64 43 6f 6f 6b 69 65 2c 20 30 2c 20 _ReadCookie, 0,
17d0: 31 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 1, 0},. { OP
17e0: 5f 43 61 6c 6c 62 61 63 6b 2c 20 20 20 34 2c 20 _Callback, 4,
17f0: 30 2c 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 0, 0},. { OP
1800: 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 _String, 0,
1810: 30 2c 20 20 22 73 63 68 65 6d 61 5f 63 6f 6f 6b 0, "schema_cook
1820: 69 65 22 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 ie"},. { OP_S
1830: 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 30 2c tring, 0, 0,
1840: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 53 0},. { OP_S
1850: 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 30 2c tring, 0, 0,
1860: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52 0},. { OP_R
1870: 65 61 64 43 6f 6f 6b 69 65 2c 20 30 2c 20 30 2c eadCookie, 0, 0,
1880: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 0},. { OP_C
1890: 61 6c 6c 62 61 63 6b 2c 20 20 20 34 2c 20 30 2c allback, 4, 0,
18a0: 20 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 52 0},. { OP_R
18b0: 65 77 69 6e 64 2c 20 20 20 20 20 30 2c 20 33 31 ewind, 0, 31
18c0: 2c 20 30 7d 2c 0a 20 20 20 20 7b 20 4f 50 5f 43 , 0},. { OP_C
18d0: 6f 6c 75 6d 6e 2c 20 20 20 20 20 30 2c 20 30 2c olumn, 0, 0,
18e0: 20 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20 0},
18f0: 2f 2a 20 31 32 20 2a 2f 0a 20 20 20 20 7b 20 4f /* 12 */. { O
1900: 50 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c P_String, 0,
1910: 20 30 2c 20 20 22 74 61 62 6c 65 22 7d 2c 0a 20 0, "table"},.
1920: 20 20 20 7b 20 4f 50 5f 4e 65 2c 20 20 20 20 20 { OP_Ne,
1930: 20 20 20 20 30 2c 20 32 30 2c 20 30 7d 2c 0a 20 0, 20, 0},.
1940: 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 { OP_Column,
1950: 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 0, 0, 0},.
1960: 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 { OP_Column,
1970: 20 20 20 20 30 2c 20 31 2c 20 20 30 7d 2c 0a 20 0, 1, 0},.
1980: 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 { OP_Column,
1990: 20 20 20 20 30 2c 20 33 2c 20 20 30 7d 2c 0a 20 0, 3, 0},.
19a0: 20 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 { OP_Column,
19b0: 20 20 20 20 30 2c 20 34 2c 20 20 30 7d 2c 0a 20 0, 4, 0},.
19c0: 20 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61 63 6b { OP_Callback
19d0: 2c 20 20 20 34 2c 20 30 2c 20 20 30 7d 2c 0a 20 , 4, 0, 0},.
19e0: 20 20 20 7b 20 4f 50 5f 4e 65 78 74 2c 20 20 20 { OP_Next,
19f0: 20 20 20 20 30 2c 20 31 32 2c 20 30 7d 2c 20 20 0, 12, 0},
1a00: 20 20 20 20 20 20 20 20 20 2f 2a 20 32 30 20 2a /* 20 *
1a10: 2f 0a 20 20 20 20 7b 20 4f 50 5f 52 65 77 69 6e /. { OP_Rewin
1a20: 64 2c 20 20 20 20 20 30 2c 20 33 31 2c 20 30 7d d, 0, 31, 0}
1a30: 2c 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 32 , /* 2
1a40: 31 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 43 6f 1 */. { OP_Co
1a50: 6c 75 6d 6e 2c 20 20 20 20 20 30 2c 20 30 2c 20 lumn, 0, 0,
1a60: 20 30 7d 2c 20 20 20 20 20 20 20 20 20 20 20 2f 0}, /
1a70: 2a 20 32 32 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 * 22 */. { OP
1a80: 5f 53 74 72 69 6e 67 2c 20 20 20 20 20 30 2c 20 _String, 0,
1a90: 30 2c 20 20 22 69 6e 64 65 78 22 7d 2c 0a 20 20 0, "index"},.
1aa0: 20 20 7b 20 4f 50 5f 4e 65 2c 20 20 20 20 20 20 { OP_Ne,
1ab0: 20 20 20 30 2c 20 33 30 2c 20 30 7d 2c 0a 20 20 0, 30, 0},.
1ac0: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 { OP_Column,
1ad0: 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 0, 0, 0},.
1ae0: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 { OP_Column,
1af0: 20 20 20 30 2c 20 31 2c 20 20 30 7d 2c 0a 20 20 0, 1, 0},.
1b00: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 { OP_Column,
1b10: 20 20 20 30 2c 20 33 2c 20 20 30 7d 2c 0a 20 20 0, 3, 0},.
1b20: 20 20 7b 20 4f 50 5f 43 6f 6c 75 6d 6e 2c 20 20 { OP_Column,
1b30: 20 20 20 30 2c 20 34 2c 20 20 30 7d 2c 0a 20 20 0, 4, 0},.
1b40: 20 20 7b 20 4f 50 5f 43 61 6c 6c 62 61 63 6b 2c { OP_Callback,
1b50: 20 20 20 34 2c 20 30 2c 20 20 30 7d 2c 0a 20 20 4, 0, 0},.
1b60: 20 20 7b 20 4f 50 5f 4e 65 78 74 2c 20 20 20 20 { OP_Next,
1b70: 20 20 20 30 2c 20 32 32 2c 20 30 7d 2c 20 20 20 0, 22, 0},
1b80: 20 20 20 20 20 20 20 20 2f 2a 20 33 30 20 2a 2f /* 30 */
1b90: 0a 20 20 20 20 7b 20 4f 50 5f 43 6c 6f 73 65 2c . { OP_Close,
1ba0: 20 20 20 20 20 20 30 2c 20 30 2c 20 20 30 7d 2c 0, 0, 0},
1bb0: 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 33 31 /* 31
1bc0: 20 2a 2f 0a 20 20 20 20 7b 20 4f 50 5f 48 61 6c */. { OP_Hal
1bd0: 74 2c 20 20 20 20 20 20 20 30 2c 20 30 2c 20 20 t, 0, 0,
1be0: 30 7d 2c 0a 20 20 7d 3b 0a 0a 20 20 2f 2a 20 43 0},. };.. /* C
1bf0: 72 65 61 74 65 20 61 20 76 69 72 74 75 61 6c 20 reate a virtual
1c00: 6d 61 63 68 69 6e 65 20 74 6f 20 72 75 6e 20 74 machine to run t
1c10: 68 65 20 69 6e 69 74 69 61 6c 69 7a 61 74 69 6f he initializatio
1c20: 6e 20 70 72 6f 67 72 61 6d 2e 20 20 52 75 6e 0a n program. Run.
1c30: 20 20 2a 2a 20 74 68 65 20 70 72 6f 67 72 61 6d ** the program
1c40: 2e 20 20 54 68 65 6e 20 64 65 6c 65 74 65 20 74 . Then delete t
1c50: 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 he virtual machi
1c60: 6e 65 2e 0a 20 20 2a 2f 0a 20 20 76 64 62 65 20 ne.. */. vdbe
1c70: 3d 20 73 71 6c 69 74 65 56 64 62 65 43 72 65 61 = sqliteVdbeCrea
1c80: 74 65 28 64 62 29 3b 0a 20 20 69 66 28 20 76 64 te(db);. if( vd
1c90: 62 65 3d 3d 30 20 29 7b 0a 20 20 20 20 73 71 6c be==0 ){. sql
1ca0: 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 iteSetString(pzE
1cb0: 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66 20 6d rrMsg, "out of m
1cc0: 65 6d 6f 72 79 22 2c 20 30 29 3b 0a 20 20 20 20 emory", 0);.
1cd0: 72 65 74 75 72 6e 20 53 51 4c 49 54 45 5f 4e 4f return SQLITE_NO
1ce0: 4d 45 4d 3b 0a 20 20 7d 0a 20 20 73 71 6c 69 74 MEM;. }. sqlit
1cf0: 65 56 64 62 65 41 64 64 4f 70 4c 69 73 74 28 76 eVdbeAddOpList(v
1d00: 64 62 65 2c 20 73 69 7a 65 6f 66 28 69 6e 69 74 dbe, sizeof(init
1d10: 50 72 6f 67 29 2f 73 69 7a 65 6f 66 28 69 6e 69 Prog)/sizeof(ini
1d20: 74 50 72 6f 67 5b 30 5d 29 2c 20 69 6e 69 74 50 tProg[0]), initP
1d30: 72 6f 67 29 3b 0a 20 20 72 63 20 3d 20 73 71 6c rog);. rc = sql
1d40: 69 74 65 56 64 62 65 45 78 65 63 28 76 64 62 65 iteVdbeExec(vdbe
1d50: 2c 20 73 71 6c 69 74 65 4f 70 65 6e 43 62 2c 20 , sqliteOpenCb,
1d60: 64 62 2c 20 70 7a 45 72 72 4d 73 67 2c 20 0a 20 db, pzErrMsg, .
1d70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20
1d80: 20 20 20 20 20 64 62 2d 3e 70 42 75 73 79 41 72 db->pBusyAr
1d90: 67 2c 20 64 62 2d 3e 78 42 75 73 79 43 61 6c 6c g, db->xBusyCall
1da0: 62 61 63 6b 29 3b 0a 20 20 73 71 6c 69 74 65 56 back);. sqliteV
1db0: 64 62 65 44 65 6c 65 74 65 28 76 64 62 65 29 3b dbeDelete(vdbe);
1dc0: 0a 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 . if( rc==SQLIT
1dd0: 45 5f 4f 4b 20 26 26 20 64 62 2d 3e 6e 54 61 62 E_OK && db->nTab
1de0: 6c 65 3d 3d 30 20 29 7b 0a 20 20 20 20 64 62 2d le==0 ){. db-
1df0: 3e 66 69 6c 65 5f 66 6f 72 6d 61 74 20 3d 20 46 >file_format = F
1e00: 49 4c 45 5f 46 4f 52 4d 41 54 3b 0a 20 20 7d 0a ILE_FORMAT;. }.
1e10: 20 20 69 66 28 20 72 63 3d 3d 53 51 4c 49 54 45 if( rc==SQLITE
1e20: 5f 4f 4b 20 26 26 20 64 62 2d 3e 66 69 6c 65 5f _OK && db->file_
1e30: 66 6f 72 6d 61 74 3e 46 49 4c 45 5f 46 4f 52 4d format>FILE_FORM
1e40: 41 54 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 AT ){. sqlite
1e50: 53 65 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d SetString(pzErrM
1e60: 73 67 2c 20 22 75 6e 73 75 70 70 6f 72 74 65 64 sg, "unsupported
1e70: 20 66 69 6c 65 20 66 6f 72 6d 61 74 22 2c 20 30 file format", 0
1e80: 29 3b 0a 20 20 20 20 72 63 20 3d 20 53 51 4c 49 );. rc = SQLI
1e90: 54 45 5f 45 52 52 4f 52 3b 0a 20 20 7d 0a 0a 20 TE_ERROR;. }..
1ea0: 20 2f 2a 20 54 68 65 20 73 63 68 65 6d 61 20 66 /* The schema f
1eb0: 6f 72 20 74 68 65 20 53 51 4c 49 54 45 5f 4d 41 or the SQLITE_MA
1ec0: 53 54 45 52 20 74 61 62 6c 65 20 69 73 20 6e 6f STER table is no
1ed0: 74 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 0a t stored in the.
1ee0: 20 20 2a 2a 20 64 61 74 61 62 61 73 65 20 69 74 ** database it
1ef0: 73 65 6c 66 2e 20 20 57 65 20 68 61 76 65 20 74 self. We have t
1f00: 6f 20 69 6e 76 6f 6b 65 20 74 68 65 20 63 61 6c o invoke the cal
1f10: 6c 62 61 63 6b 20 6f 6e 65 20 65 78 74 72 61 0a lback one extra.
1f20: 20 20 2a 2a 20 74 69 6d 65 20 74 6f 20 67 65 74 ** time to get
1f30: 20 69 74 20 74 6f 20 70 72 6f 63 65 73 73 20 74 it to process t
1f40: 68 65 20 53 51 4c 49 54 45 5f 4d 41 53 54 45 52 he SQLITE_MASTER
1f50: 20 74 61 62 6c 65 20 64 65 66 69 6e 74 69 6f 6e table defintion
1f60: 2e 0a 20 20 2a 2f 0a 20 20 69 66 28 20 72 63 3d .. */. if( rc=
1f70: 3d 53 51 4c 49 54 45 5f 4f 4b 20 29 7b 0a 20 20 =SQLITE_OK ){.
1f80: 20 20 54 61 62 6c 65 20 2a 70 54 61 62 3b 0a 20 Table *pTab;.
1f90: 20 20 20 63 68 61 72 20 2a 61 7a 41 72 67 5b 36 char *azArg[6
1fa0: 5d 3b 0a 20 20 20 20 61 7a 41 72 67 5b 30 5d 20 ];. azArg[0]
1fb0: 3d 20 22 74 61 62 6c 65 22 3b 0a 20 20 20 20 61 = "table";. a
1fc0: 7a 41 72 67 5b 31 5d 20 3d 20 4d 41 53 54 45 52 zArg[1] = MASTER
1fd0: 5f 4e 41 4d 45 3b 0a 20 20 20 20 61 7a 41 72 67 _NAME;. azArg
1fe0: 5b 32 5d 20 3d 20 22 32 22 3b 0a 20 20 20 20 61 [2] = "2";. a
1ff0: 7a 41 72 67 5b 33 5d 20 3d 20 6d 61 73 74 65 72 zArg[3] = master
2000: 5f 73 63 68 65 6d 61 3b 0a 20 20 20 20 61 7a 41 _schema;. azA
2010: 72 67 5b 34 5d 20 3d 20 30 3b 0a 20 20 20 20 73 rg[4] = 0;. s
2020: 71 6c 69 74 65 4f 70 65 6e 43 62 28 64 62 2c 20 qliteOpenCb(db,
2030: 34 2c 20 61 7a 41 72 67 2c 20 30 29 3b 0a 20 20 4, azArg, 0);.
2040: 20 20 70 54 61 62 20 3d 20 73 71 6c 69 74 65 46 pTab = sqliteF
2050: 69 6e 64 54 61 62 6c 65 28 64 62 2c 20 4d 41 53 indTable(db, MAS
2060: 54 45 52 5f 4e 41 4d 45 29 3b 0a 20 20 20 20 69 TER_NAME);. i
2070: 66 28 20 70 54 61 62 20 29 7b 0a 20 20 20 20 20 f( pTab ){.
2080: 20 70 54 61 62 2d 3e 72 65 61 64 4f 6e 6c 79 20 pTab->readOnly
2090: 3d 20 31 3b 0a 20 20 20 20 7d 0a 20 20 20 20 64 = 1;. }. d
20a0: 62 2d 3e 66 6c 61 67 73 20 7c 3d 20 53 51 4c 49 b->flags |= SQLI
20b0: 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a TE_Initialized;.
20c0: 20 20 20 20 73 71 6c 69 74 65 43 6f 6d 6d 69 74 sqliteCommit
20d0: 49 6e 74 65 72 6e 61 6c 43 68 61 6e 67 65 73 28 InternalChanges(
20e0: 64 62 29 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 db);. }. retur
20f0: 6e 20 72 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 n rc;.}../*.** T
2100: 68 65 20 76 65 72 73 69 6f 6e 20 6f 66 20 74 68 he version of th
2110: 65 20 6c 69 62 72 61 72 79 0a 2a 2f 0a 63 6f 6e e library.*/.con
2120: 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 5f 76 st char sqlite_v
2130: 65 72 73 69 6f 6e 5b 5d 20 3d 20 53 51 4c 49 54 ersion[] = SQLIT
2140: 45 5f 56 45 52 53 49 4f 4e 3b 0a 0a 2f 2a 0a 2a E_VERSION;../*.*
2150: 2a 20 44 6f 65 73 20 74 68 65 20 6c 69 62 72 61 * Does the libra
2160: 72 79 20 65 78 70 65 63 74 20 64 61 74 61 20 74 ry expect data t
2170: 6f 20 62 65 20 65 6e 63 6f 64 65 64 20 61 73 20 o be encoded as
2180: 55 54 46 2d 38 20 6f 72 20 69 73 6f 38 38 35 39 UTF-8 or iso8859
2190: 3f 20 20 54 68 65 0a 2a 2a 20 66 6f 6c 6c 6f 77 ? The.** follow
21a0: 69 6e 67 20 67 6c 6f 62 61 6c 20 63 6f 6e 73 74 ing global const
21b0: 61 6e 74 20 61 6c 77 61 79 73 20 6c 65 74 73 20 ant always lets
21c0: 75 73 20 6b 6e 6f 77 2e 0a 2a 2f 0a 23 69 66 64 us know..*/.#ifd
21d0: 65 66 20 53 51 4c 49 54 45 5f 55 54 46 38 0a 63 ef SQLITE_UTF8.c
21e0: 6f 6e 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 onst char sqlite
21f0: 5f 65 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20 22 55 _encoding[] = "U
2200: 54 46 2d 38 22 3b 0a 23 65 6c 73 65 0a 63 6f 6e TF-8";.#else.con
2210: 73 74 20 63 68 61 72 20 73 71 6c 69 74 65 5f 65 st char sqlite_e
2220: 6e 63 6f 64 69 6e 67 5b 5d 20 3d 20 22 69 73 6f ncoding[] = "iso
2230: 38 38 35 39 22 3b 0a 23 65 6e 64 69 66 0a 0a 2f 8859";.#endif../
2240: 2a 0a 2a 2a 20 4f 70 65 6e 20 61 20 6e 65 77 20 *.** Open a new
2250: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e SQLite database.
2260: 20 20 43 6f 6e 73 74 72 75 63 74 20 61 6e 20 22 Construct an "
2270: 73 71 6c 69 74 65 22 20 73 74 72 75 63 74 75 72 sqlite" structur
2280: 65 20 74 6f 20 64 65 66 69 6e 65 0a 2a 2a 20 74 e to define.** t
2290: 68 65 20 73 74 61 74 65 20 6f 66 20 74 68 69 73 he state of this
22a0: 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 72 65 database and re
22b0: 74 75 72 6e 20 61 20 70 6f 69 6e 74 65 72 20 74 turn a pointer t
22c0: 6f 20 74 68 61 74 20 73 74 72 75 63 74 75 72 65 o that structure
22d0: 2e 0a 2a 2a 0a 2a 2a 20 41 6e 20 61 74 74 65 6d ..**.** An attem
22e0: 70 74 20 69 73 20 6d 61 64 65 20 74 6f 20 69 6e pt is made to in
22f0: 69 74 69 61 6c 69 7a 65 20 74 68 65 20 69 6e 2d itialize the in-
2300: 6d 65 6d 6f 72 79 20 64 61 74 61 20 73 74 72 75 memory data stru
2310: 63 74 75 72 65 73 20 74 68 61 74 0a 2a 2a 20 68 ctures that.** h
2320: 6f 6c 64 20 74 68 65 20 64 61 74 61 62 61 73 65 old the database
2330: 20 73 63 68 65 6d 61 2e 20 20 42 75 74 20 69 66 schema. But if
2340: 20 74 68 69 73 20 66 61 69 6c 73 20 28 62 65 63 this fails (bec
2350: 61 75 73 65 20 74 68 65 20 73 63 68 65 6d 61 20 ause the schema
2360: 66 69 6c 65 0a 2a 2a 20 69 73 20 6c 6f 63 6b 65 file.** is locke
2370: 64 29 20 74 68 65 6e 20 74 68 61 74 20 73 74 65 d) then that ste
2380: 70 20 69 73 20 64 65 66 65 72 72 65 64 20 75 6e p is deferred un
2390: 74 69 6c 20 74 68 65 20 66 69 72 73 74 20 63 61 til the first ca
23a0: 6c 6c 20 74 6f 0a 2a 2a 20 73 71 6c 69 74 65 5f ll to.** sqlite_
23b0: 65 78 65 63 28 29 2e 0a 2a 2f 0a 73 71 6c 69 74 exec()..*/.sqlit
23c0: 65 20 2a 73 71 6c 69 74 65 5f 6f 70 65 6e 28 63 e *sqlite_open(c
23d0: 6f 6e 73 74 20 63 68 61 72 20 2a 7a 46 69 6c 65 onst char *zFile
23e0: 6e 61 6d 65 2c 20 69 6e 74 20 6d 6f 64 65 2c 20 name, int mode,
23f0: 63 68 61 72 20 2a 2a 70 7a 45 72 72 4d 73 67 29 char **pzErrMsg)
2400: 7b 0a 20 20 73 71 6c 69 74 65 20 2a 64 62 3b 0a {. sqlite *db;.
2410: 20 20 69 6e 74 20 72 63 3b 0a 0a 20 20 2f 2a 20 int rc;.. /*
2420: 41 6c 6c 6f 63 61 74 65 20 74 68 65 20 73 71 6c Allocate the sql
2430: 69 74 65 20 64 61 74 61 20 73 74 72 75 63 74 75 ite data structu
2440: 72 65 20 2a 2f 0a 20 20 64 62 20 3d 20 73 71 6c re */. db = sql
2450: 69 74 65 4d 61 6c 6c 6f 63 28 20 73 69 7a 65 6f iteMalloc( sizeo
2460: 66 28 73 71 6c 69 74 65 29 20 29 3b 0a 20 20 69 f(sqlite) );. i
2470: 66 28 20 70 7a 45 72 72 4d 73 67 20 29 20 2a 70 f( pzErrMsg ) *p
2480: 7a 45 72 72 4d 73 67 20 3d 20 30 3b 0a 20 20 69 zErrMsg = 0;. i
2490: 66 28 20 64 62 3d 3d 30 20 29 20 67 6f 74 6f 20 f( db==0 ) goto
24a0: 6e 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e 3b 0a no_mem_on_open;.
24b0: 20 20 73 71 6c 69 74 65 48 61 73 68 49 6e 69 74 sqliteHashInit
24c0: 28 26 64 62 2d 3e 74 62 6c 48 61 73 68 2c 20 53 (&db->tblHash, S
24d0: 51 4c 49 54 45 5f 48 41 53 48 5f 53 54 52 49 4e QLITE_HASH_STRIN
24e0: 47 2c 20 30 29 3b 0a 20 20 73 71 6c 69 74 65 48 G, 0);. sqliteH
24f0: 61 73 68 49 6e 69 74 28 26 64 62 2d 3e 69 64 78 ashInit(&db->idx
2500: 48 61 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 Hash, SQLITE_HAS
2510: 48 5f 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 H_STRING, 0);.
2520: 64 62 2d 3e 6e 65 78 74 52 6f 77 69 64 20 3d 20 db->nextRowid =
2530: 73 71 6c 69 74 65 52 61 6e 64 6f 6d 49 6e 74 65 sqliteRandomInte
2540: 67 65 72 28 29 3b 0a 20 20 0a 20 20 2f 2a 20 4f ger();. . /* O
2550: 70 65 6e 20 74 68 65 20 62 61 63 6b 65 6e 64 20 pen the backend
2560: 64 61 74 61 62 61 73 65 20 64 72 69 76 65 72 20 database driver
2570: 2a 2f 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 */. rc = sqlite
2580: 42 74 72 65 65 4f 70 65 6e 28 7a 46 69 6c 65 6e BtreeOpen(zFilen
2590: 61 6d 65 2c 20 6d 6f 64 65 2c 20 4d 41 58 5f 50 ame, mode, MAX_P
25a0: 41 47 45 53 2c 20 26 64 62 2d 3e 70 42 65 29 3b AGES, &db->pBe);
25b0: 0a 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 . if( rc!=SQLIT
25c0: 45 5f 4f 4b 20 29 7b 0a 20 20 20 20 73 77 69 74 E_OK ){. swit
25d0: 63 68 28 20 72 63 20 29 7b 0a 20 20 20 20 20 20 ch( rc ){.
25e0: 64 65 66 61 75 6c 74 3a 20 7b 0a 20 20 20 20 20 default: {.
25f0: 20 20 20 73 71 6c 69 74 65 53 65 74 53 74 72 69 sqliteSetStri
2600: 6e 67 28 70 7a 45 72 72 4d 73 67 2c 20 22 75 6e ng(pzErrMsg, "un
2610: 61 62 6c 65 20 74 6f 20 6f 70 65 6e 20 64 61 74 able to open dat
2620: 61 62 61 73 65 3a 20 22 2c 20 7a 46 69 6c 65 6e abase: ", zFilen
2630: 61 6d 65 2c 20 30 29 3b 0a 20 20 20 20 20 20 7d ame, 0);. }
2640: 0a 20 20 20 20 7d 0a 20 20 20 20 73 71 6c 69 74 . }. sqlit
2650: 65 46 72 65 65 28 64 62 29 3b 0a 20 20 20 20 73 eFree(db);. s
2660: 71 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 qliteStrRealloc(
2670: 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 72 pzErrMsg);. r
2680: 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a 0a 20 20 eturn 0;. }..
2690: 2f 2a 20 41 74 74 65 6d 70 74 20 74 6f 20 72 65 /* Attempt to re
26a0: 61 64 20 74 68 65 20 73 63 68 65 6d 61 20 2a 2f ad the schema */
26b0: 0a 20 20 72 63 20 3d 20 73 71 6c 69 74 65 49 6e . rc = sqliteIn
26c0: 69 74 28 64 62 2c 20 70 7a 45 72 72 4d 73 67 29 it(db, pzErrMsg)
26d0: 3b 0a 20 20 69 66 28 20 73 71 6c 69 74 65 5f 6d ;. if( sqlite_m
26e0: 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 20 29 7b 0a alloc_failed ){.
26f0: 20 20 20 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65 sqlite_close
2700: 28 64 62 29 3b 0a 20 20 20 20 67 6f 74 6f 20 6e (db);. goto n
2710: 6f 5f 6d 65 6d 5f 6f 6e 5f 6f 70 65 6e 3b 0a 20 o_mem_on_open;.
2720: 20 7d 65 6c 73 65 20 69 66 28 20 72 63 21 3d 53 }else if( rc!=S
2730: 51 4c 49 54 45 5f 4f 4b 20 26 26 20 72 63 21 3d QLITE_OK && rc!=
2740: 53 51 4c 49 54 45 5f 42 55 53 59 20 29 7b 0a 20 SQLITE_BUSY ){.
2750: 20 20 20 73 71 6c 69 74 65 5f 63 6c 6f 73 65 28 sqlite_close(
2760: 64 62 29 3b 0a 20 20 20 20 73 71 6c 69 74 65 53 db);. sqliteS
2770: 74 72 52 65 61 6c 6c 6f 63 28 70 7a 45 72 72 4d trRealloc(pzErrM
2780: 73 67 29 3b 0a 20 20 20 20 72 65 74 75 72 6e 20 sg);. return
2790: 30 3b 0a 20 20 7d 65 6c 73 65 20 69 66 28 20 70 0;. }else if( p
27a0: 7a 45 72 72 4d 73 67 20 29 7b 0a 20 20 20 20 73 zErrMsg ){. s
27b0: 71 6c 69 74 65 46 72 65 65 28 2a 70 7a 45 72 72 qliteFree(*pzErr
27c0: 4d 73 67 29 3b 0a 20 20 20 20 2a 70 7a 45 72 72 Msg);. *pzErr
27d0: 4d 73 67 20 3d 20 30 3b 0a 20 20 7d 0a 20 20 72 Msg = 0;. }. r
27e0: 65 74 75 72 6e 20 64 62 3b 0a 0a 6e 6f 5f 6d 65 eturn db;..no_me
27f0: 6d 5f 6f 6e 5f 6f 70 65 6e 3a 0a 20 20 73 71 6c m_on_open:. sql
2800: 69 74 65 53 65 74 53 74 72 69 6e 67 28 70 7a 45 iteSetString(pzE
2810: 72 72 4d 73 67 2c 20 22 6f 75 74 20 6f 66 20 6d rrMsg, "out of m
2820: 65 6d 6f 72 79 22 2c 20 30 29 3b 0a 20 20 73 71 emory", 0);. sq
2830: 6c 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 liteStrRealloc(p
2840: 7a 45 72 72 4d 73 67 29 3b 0a 20 20 72 65 74 75 zErrMsg);. retu
2850: 72 6e 20 30 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 45 rn 0;.}../*.** E
2860: 72 61 73 65 20 61 6c 6c 20 73 63 68 65 6d 61 20 rase all schema
2870: 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 66 72 6f 6d information from
2880: 20 74 68 65 20 73 63 68 65 6d 61 20 68 61 73 68 the schema hash
2890: 20 74 61 62 6c 65 2e 20 20 45 78 63 65 70 74 0a table. Except.
28a0: 2a 2a 20 74 61 62 6c 65 73 20 74 68 61 74 20 61 ** tables that a
28b0: 72 65 20 63 72 65 61 74 65 64 20 75 73 69 6e 67 re created using
28c0: 20 43 52 45 41 54 45 20 54 45 4d 50 4f 52 41 52 CREATE TEMPORAR
28d0: 59 20 54 41 42 4c 45 20 61 72 65 20 70 72 65 73 Y TABLE are pres
28e0: 65 72 76 65 64 0a 2a 2a 20 69 66 20 74 68 65 20 erved.** if the
28f0: 70 72 65 73 65 72 76 65 54 65 6d 70 73 20 66 6c preserveTemps fl
2900: 61 67 20 69 73 20 74 72 75 65 2e 0a 2a 2a 0a 2a ag is true..**.*
2910: 2a 20 54 68 65 20 64 61 74 61 62 61 73 65 20 73 * The database s
2920: 63 68 65 6d 61 20 69 73 20 6e 6f 72 6d 61 6c 6c chema is normall
2930: 79 20 72 65 61 64 20 69 6e 20 6f 6e 63 65 20 77 y read in once w
2940: 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 hen the database
2950: 0a 2a 2a 20 69 73 20 66 69 72 73 74 20 6f 70 65 .** is first ope
2960: 6e 65 64 20 61 6e 64 20 73 74 6f 72 65 64 20 69 ned and stored i
2970: 6e 20 61 20 68 61 73 68 20 74 61 62 6c 65 20 69 n a hash table i
2980: 6e 20 74 68 65 20 73 71 6c 69 74 65 20 73 74 72 n the sqlite str
2990: 75 63 74 75 72 65 2e 0a 2a 2a 20 54 68 69 73 20 ucture..** This
29a0: 72 6f 75 74 69 6e 65 20 65 72 61 73 65 73 20 74 routine erases t
29b0: 68 65 20 73 74 6f 72 65 64 20 73 63 68 65 6d 61 he stored schema
29c0: 2e 20 20 54 68 69 73 20 65 72 61 73 75 72 65 20 . This erasure
29d0: 6f 63 63 75 72 73 20 62 65 63 61 75 73 65 0a 2a occurs because.*
29e0: 2a 20 65 69 74 68 65 72 20 74 68 65 20 64 61 74 * either the dat
29f0: 61 62 61 73 65 20 69 73 20 62 65 69 6e 67 20 63 abase is being c
2a00: 6c 6f 73 65 64 20 6f 72 20 62 65 63 61 75 73 65 losed or because
2a10: 20 73 6f 6d 65 20 6f 74 68 65 72 20 70 72 6f 63 some other proc
2a20: 65 73 73 0a 2a 2a 20 63 68 61 6e 67 65 64 20 74 ess.** changed t
2a30: 68 65 20 73 63 68 65 6d 61 20 61 6e 64 20 74 68 he schema and th
2a40: 69 73 20 70 72 6f 63 65 73 73 20 6e 65 65 64 73 is process needs
2a50: 20 74 6f 20 72 65 72 65 61 64 20 69 74 2e 0a 2a to reread it..*
2a60: 2f 0a 73 74 61 74 69 63 20 76 6f 69 64 20 63 6c /.static void cl
2a70: 65 61 72 48 61 73 68 54 61 62 6c 65 28 73 71 6c earHashTable(sql
2a80: 69 74 65 20 2a 64 62 2c 20 69 6e 74 20 70 72 65 ite *db, int pre
2a90: 73 65 72 76 65 54 65 6d 70 73 29 7b 0a 20 20 48 serveTemps){. H
2aa0: 61 73 68 45 6c 65 6d 20 2a 70 45 6c 65 6d 3b 0a ashElem *pElem;.
2ab0: 20 20 48 61 73 68 20 74 65 6d 70 31 3b 0a 20 20 Hash temp1;.
2ac0: 74 65 6d 70 31 20 3d 20 64 62 2d 3e 74 62 6c 48 temp1 = db->tblH
2ad0: 61 73 68 3b 0a 20 20 73 71 6c 69 74 65 48 61 73 ash;. sqliteHas
2ae0: 68 49 6e 69 74 28 26 64 62 2d 3e 74 62 6c 48 61 hInit(&db->tblHa
2af0: 73 68 2c 20 53 51 4c 49 54 45 5f 48 41 53 48 5f sh, SQLITE_HASH_
2b00: 53 54 52 49 4e 47 2c 20 30 29 3b 0a 20 20 73 71 STRING, 0);. sq
2b10: 6c 69 74 65 48 61 73 68 43 6c 65 61 72 28 26 64 liteHashClear(&d
2b20: 62 2d 3e 69 64 78 48 61 73 68 29 3b 0a 20 20 66 b->idxHash);. f
2b30: 6f 72 28 70 45 6c 65 6d 3d 73 71 6c 69 74 65 48 or(pElem=sqliteH
2b40: 61 73 68 46 69 72 73 74 28 26 74 65 6d 70 31 29 ashFirst(&temp1)
2b50: 3b 20 70 45 6c 65 6d 3b 20 70 45 6c 65 6d 3d 73 ; pElem; pElem=s
2b60: 71 6c 69 74 65 48 61 73 68 4e 65 78 74 28 70 45 qliteHashNext(pE
2b70: 6c 65 6d 29 29 7b 0a 20 20 20 20 54 61 62 6c 65 lem)){. Table
2b80: 20 2a 70 54 61 62 20 3d 20 73 71 6c 69 74 65 48 *pTab = sqliteH
2b90: 61 73 68 44 61 74 61 28 70 45 6c 65 6d 29 3b 0a ashData(pElem);.
2ba0: 20 20 20 20 69 66 28 20 70 72 65 73 65 72 76 65 if( preserve
2bb0: 54 65 6d 70 73 20 26 26 20 70 54 61 62 2d 3e 69 Temps && pTab->i
2bc0: 73 54 65 6d 70 20 29 7b 0a 20 20 20 20 20 20 49 sTemp ){. I
2bd0: 6e 64 65 78 20 2a 70 49 64 78 3b 0a 20 20 20 20 ndex *pIdx;.
2be0: 20 20 69 6e 74 20 6e 4e 61 6d 65 20 3d 20 73 74 int nName = st
2bf0: 72 6c 65 6e 28 70 54 61 62 2d 3e 7a 4e 61 6d 65 rlen(pTab->zName
2c00: 29 3b 0a 20 20 20 20 20 20 54 61 62 6c 65 20 2a );. Table *
2c10: 70 4f 6c 64 20 3d 20 73 71 6c 69 74 65 48 61 73 pOld = sqliteHas
2c20: 68 49 6e 73 65 72 74 28 26 64 62 2d 3e 74 62 6c hInsert(&db->tbl
2c30: 48 61 73 68 2c 20 70 54 61 62 2d 3e 7a 4e 61 6d Hash, pTab->zNam
2c40: 65 2c 20 6e 4e 61 6d 65 2b 31 2c 20 70 54 61 62 e, nName+1, pTab
2c50: 29 3b 0a 20 20 20 20 20 20 69 66 28 20 70 4f 6c );. if( pOl
2c60: 64 21 3d 30 20 29 7b 0a 20 20 20 20 20 20 20 20 d!=0 ){.
2c70: 61 73 73 65 72 74 28 20 70 4f 6c 64 3d 3d 70 54 assert( pOld==pT
2c80: 61 62 20 29 3b 20 20 20 2f 2a 20 4d 61 6c 6c 6f ab ); /* Mallo
2c90: 63 20 66 61 69 6c 65 64 20 6f 6e 20 74 68 65 20 c failed on the
2ca0: 48 61 73 68 49 6e 73 65 72 74 20 2a 2f 0a 20 20 HashInsert */.
2cb0: 20 20 20 20 20 20 73 71 6c 69 74 65 44 65 6c 65 sqliteDele
2cc0: 74 65 54 61 62 6c 65 28 64 62 2c 20 70 4f 6c 64 teTable(db, pOld
2cd0: 29 3b 0a 20 20 20 20 20 20 20 20 63 6f 6e 74 69 );. conti
2ce0: 6e 75 65 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 nue;. }.
2cf0: 20 20 20 66 6f 72 28 70 49 64 78 3d 70 54 61 62 for(pIdx=pTab
2d00: 2d 3e 70 49 6e 64 65 78 3b 20 70 49 64 78 3b 20 ->pIndex; pIdx;
2d10: 70 49 64 78 3d 70 49 64 78 2d 3e 70 4e 65 78 74 pIdx=pIdx->pNext
2d20: 29 7b 0a 20 20 20 20 20 20 20 20 69 6e 74 20 6e ){. int n
2d30: 20 3d 20 73 74 72 6c 65 6e 28 70 49 64 78 2d 3e = strlen(pIdx->
2d40: 7a 4e 61 6d 65 29 2b 31 3b 0a 20 20 20 20 20 20 zName)+1;.
2d50: 20 20 49 6e 64 65 78 20 2a 70 4f 6c 64 49 64 78 Index *pOldIdx
2d60: 3b 0a 20 20 20 20 20 20 20 20 70 4f 6c 64 49 64 ;. pOldId
2d70: 78 20 3d 20 73 71 6c 69 74 65 48 61 73 68 49 6e x = sqliteHashIn
2d80: 73 65 72 74 28 26 64 62 2d 3e 69 64 78 48 61 73 sert(&db->idxHas
2d90: 68 2c 20 70 49 64 78 2d 3e 7a 4e 61 6d 65 2c 20 h, pIdx->zName,
2da0: 6e 2c 20 70 49 64 78 29 3b 0a 20 20 20 20 20 20 n, pIdx);.
2db0: 20 20 69 66 28 20 70 4f 6c 64 20 29 7b 0a 20 20 if( pOld ){.
2dc0: 20 20 20 20 20 20 20 20 61 73 73 65 72 74 28 20 assert(
2dd0: 70 4f 6c 64 49 64 78 3d 3d 70 49 64 78 20 29 3b pOldIdx==pIdx );
2de0: 0a 20 20 20 20 20 20 20 20 20 20 73 71 6c 69 74 . sqlit
2df0: 65 55 6e 6c 69 6e 6b 41 6e 64 44 65 6c 65 74 65 eUnlinkAndDelete
2e00: 49 6e 64 65 78 28 64 62 2c 20 70 4f 6c 64 49 64 Index(db, pOldId
2e10: 78 29 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 x);. }.
2e20: 20 20 20 20 7d 0a 20 20 20 20 7d 65 6c 73 65 7b }. }else{
2e30: 0a 20 20 20 20 20 20 73 71 6c 69 74 65 44 65 6c . sqliteDel
2e40: 65 74 65 54 61 62 6c 65 28 64 62 2c 20 70 54 61 eteTable(db, pTa
2e50: 62 29 3b 0a 20 20 20 20 7d 0a 20 20 7d 0a 20 20 b);. }. }.
2e60: 73 71 6c 69 74 65 48 61 73 68 43 6c 65 61 72 28 sqliteHashClear(
2e70: 26 74 65 6d 70 31 29 3b 0a 20 20 64 62 2d 3e 66 &temp1);. db->f
2e80: 6c 61 67 73 20 26 3d 20 7e 53 51 4c 49 54 45 5f lags &= ~SQLITE_
2e90: 49 6e 69 74 69 61 6c 69 7a 65 64 3b 0a 7d 0a 0a Initialized;.}..
2ea0: 2f 2a 0a 2a 2a 20 43 6c 6f 73 65 20 61 6e 20 65 /*.** Close an e
2eb0: 78 69 73 74 69 6e 67 20 53 51 4c 69 74 65 20 64 xisting SQLite d
2ec0: 61 74 61 62 61 73 65 0a 2a 2f 0a 76 6f 69 64 20 atabase.*/.void
2ed0: 73 71 6c 69 74 65 5f 63 6c 6f 73 65 28 73 71 6c sqlite_close(sql
2ee0: 69 74 65 20 2a 64 62 29 7b 0a 20 20 73 71 6c 69 ite *db){. sqli
2ef0: 74 65 42 74 72 65 65 43 6c 6f 73 65 28 64 62 2d teBtreeClose(db-
2f00: 3e 70 42 65 29 3b 0a 20 20 63 6c 65 61 72 48 61 >pBe);. clearHa
2f10: 73 68 54 61 62 6c 65 28 64 62 2c 20 30 29 3b 0a shTable(db, 0);.
2f20: 20 20 69 66 28 20 64 62 2d 3e 70 42 65 54 65 6d if( db->pBeTem
2f30: 70 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 42 p ){. sqliteB
2f40: 74 72 65 65 43 6c 6f 73 65 28 64 62 2d 3e 70 42 treeClose(db->pB
2f50: 65 54 65 6d 70 29 3b 0a 20 20 7d 0a 20 20 73 71 eTemp);. }. sq
2f60: 6c 69 74 65 46 72 65 65 28 64 62 29 3b 0a 7d 0a liteFree(db);.}.
2f70: 0a 2f 2a 0a 2a 2a 20 52 65 74 75 72 6e 20 54 52 ./*.** Return TR
2f80: 55 45 20 69 66 20 74 68 65 20 67 69 76 65 6e 20 UE if the given
2f90: 53 51 4c 20 73 74 72 69 6e 67 20 65 6e 64 73 20 SQL string ends
2fa0: 69 6e 20 61 20 73 65 6d 69 63 6f 6c 6f 6e 2e 0a in a semicolon..
2fb0: 2a 2f 0a 69 6e 74 20 73 71 6c 69 74 65 5f 63 6f */.int sqlite_co
2fc0: 6d 70 6c 65 74 65 28 63 6f 6e 73 74 20 63 68 61 mplete(const cha
2fd0: 72 20 2a 7a 53 71 6c 29 7b 0a 20 20 69 6e 74 20 r *zSql){. int
2fe0: 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a isComplete = 0;.
2ff0: 20 20 77 68 69 6c 65 28 20 2a 7a 53 71 6c 20 29 while( *zSql )
3000: 7b 0a 20 20 20 20 73 77 69 74 63 68 28 20 2a 7a {. switch( *z
3010: 53 71 6c 20 29 7b 0a 20 20 20 20 20 20 63 61 73 Sql ){. cas
3020: 65 20 27 3b 27 3a 20 7b 0a 20 20 20 20 20 20 20 e ';': {.
3030: 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 31 3b isComplete = 1;
3040: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a . break;.
3050: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 61 }. ca
3060: 73 65 20 27 20 27 3a 0a 20 20 20 20 20 20 63 61 se ' ':. ca
3070: 73 65 20 27 5c 74 27 3a 0a 20 20 20 20 20 20 63 se '\t':. c
3080: 61 73 65 20 27 5c 6e 27 3a 0a 20 20 20 20 20 20 ase '\n':.
3090: 63 61 73 65 20 27 5c 66 27 3a 20 7b 0a 20 20 20 case '\f': {.
30a0: 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 20 20 20 break;.
30b0: 20 20 7d 0a 20 20 20 20 20 20 63 61 73 65 20 27 }. case '
30c0: 5c 27 27 3a 20 7b 0a 20 20 20 20 20 20 20 20 69 \'': {. i
30d0: 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30 3b 0a 20 sComplete = 0;.
30e0: 20 20 20 20 20 20 20 7a 53 71 6c 2b 2b 3b 0a 20 zSql++;.
30f0: 20 20 20 20 20 20 20 77 68 69 6c 65 28 20 2a 7a while( *z
3100: 53 71 6c 20 26 26 20 2a 7a 53 71 6c 21 3d 27 5c Sql && *zSql!='\
3110: 27 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20 7d 0a '' ){ zSql++; }.
3120: 20 20 20 20 20 20 20 20 69 66 28 20 2a 7a 53 71 if( *zSq
3130: 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b l==0 ) return 0;
3140: 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 3b 0a . break;.
3150: 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 63 61 }. ca
3160: 73 65 20 27 22 27 3a 20 7b 0a 20 20 20 20 20 20 se '"': {.
3170: 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30 isComplete = 0
3180: 3b 0a 20 20 20 20 20 20 20 20 7a 53 71 6c 2b 2b ;. zSql++
3190: 3b 0a 20 20 20 20 20 20 20 20 77 68 69 6c 65 28 ;. while(
31a0: 20 2a 7a 53 71 6c 20 26 26 20 2a 7a 53 71 6c 21 *zSql && *zSql!
31b0: 3d 27 22 27 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20 ='"' ){ zSql++;
31c0: 7d 0a 20 20 20 20 20 20 20 20 69 66 28 20 2a 7a }. if( *z
31d0: 53 71 6c 3d 3d 30 20 29 20 72 65 74 75 72 6e 20 Sql==0 ) return
31e0: 30 3b 0a 20 20 20 20 20 20 20 20 62 72 65 61 6b 0;. break
31f0: 3b 0a 20 20 20 20 20 20 7d 0a 20 20 20 20 20 20 ;. }.
3200: 63 61 73 65 20 27 2d 27 3a 20 7b 0a 20 20 20 20 case '-': {.
3210: 20 20 20 20 69 66 28 20 7a 53 71 6c 5b 31 5d 21 if( zSql[1]!
3220: 3d 27 2d 27 20 29 7b 0a 20 20 20 20 20 20 20 20 ='-' ){.
3230: 20 20 69 73 43 6f 6d 70 6c 65 74 65 20 3d 20 30 isComplete = 0
3240: 3b 0a 20 20 20 20 20 20 20 20 20 20 62 72 65 61 ;. brea
3250: 6b 3b 0a 20 20 20 20 20 20 20 20 7d 0a 20 20 20 k;. }.
3260: 20 20 20 20 20 77 68 69 6c 65 28 20 2a 7a 53 71 while( *zSq
3270: 6c 20 26 26 20 2a 7a 53 71 6c 21 3d 27 5c 6e 27 l && *zSql!='\n'
3280: 20 29 7b 20 7a 53 71 6c 2b 2b 3b 20 7d 0a 20 20 ){ zSql++; }.
3290: 20 20 20 20 20 20 69 66 28 20 2a 7a 53 71 6c 3d if( *zSql=
32a0: 3d 30 20 29 20 72 65 74 75 72 6e 20 69 73 43 6f =0 ) return isCo
32b0: 6d 70 6c 65 74 65 3b 0a 20 20 20 20 20 20 20 20 mplete;.
32c0: 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 20 0a break;. } .
32d0: 20 20 20 20 20 20 64 65 66 61 75 6c 74 3a 20 7b default: {
32e0: 0a 20 20 20 20 20 20 20 20 69 73 43 6f 6d 70 6c . isCompl
32f0: 65 74 65 20 3d 20 30 3b 0a 20 20 20 20 20 20 20 ete = 0;.
3300: 20 62 72 65 61 6b 3b 0a 20 20 20 20 20 20 7d 0a break;. }.
3310: 20 20 20 20 7d 0a 20 20 20 20 7a 53 71 6c 2b 2b }. zSql++
3320: 3b 0a 20 20 7d 0a 20 20 72 65 74 75 72 6e 20 69 ;. }. return i
3330: 73 43 6f 6d 70 6c 65 74 65 3b 0a 7d 0a 0a 2f 2a sComplete;.}../*
3340: 0a 2a 2a 20 45 78 65 63 75 74 65 20 53 51 4c 20 .** Execute SQL
3350: 63 6f 64 65 2e 20 20 52 65 74 75 72 6e 20 6f 6e code. Return on
3360: 65 20 6f 66 20 74 68 65 20 53 51 4c 49 54 45 5f e of the SQLITE_
3370: 20 73 75 63 63 65 73 73 2f 66 61 69 6c 75 72 65 success/failure
3380: 0a 2a 2a 20 63 6f 64 65 73 2e 20 20 41 6c 73 6f .** codes. Also
3390: 20 77 72 69 74 65 20 61 6e 20 65 72 72 6f 72 20 write an error
33a0: 6d 65 73 73 61 67 65 20 69 6e 74 6f 20 6d 65 6d message into mem
33b0: 6f 72 79 20 6f 62 74 61 69 6e 65 64 20 66 72 6f ory obtained fro
33c0: 6d 0a 2a 2a 20 6d 61 6c 6c 6f 63 28 29 20 61 6e m.** malloc() an
33d0: 64 20 6d 61 6b 65 20 2a 70 7a 45 72 72 4d 73 67 d make *pzErrMsg
33e0: 20 70 6f 69 6e 74 20 74 6f 20 74 68 61 74 20 6d point to that m
33f0: 65 73 73 61 67 65 2e 0a 2a 2a 0a 2a 2a 20 49 66 essage..**.** If
3400: 20 74 68 65 20 53 51 4c 20 69 73 20 61 20 71 75 the SQL is a qu
3410: 65 72 79 2c 20 74 68 65 6e 20 66 6f 72 20 65 61 ery, then for ea
3420: 63 68 20 72 6f 77 20 69 6e 20 74 68 65 20 71 75 ch row in the qu
3430: 65 72 79 20 72 65 73 75 6c 74 0a 2a 2a 20 74 68 ery result.** th
3440: 65 20 78 43 61 6c 6c 62 61 63 6b 28 29 20 66 75 e xCallback() fu
3450: 6e 63 74 69 6f 6e 20 69 73 20 63 61 6c 6c 65 64 nction is called
3460: 2e 20 20 70 41 72 67 20 62 65 63 6f 6d 65 73 20 . pArg becomes
3470: 74 68 65 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 the first.** arg
3480: 75 6d 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 ument to xCallba
3490: 63 6b 28 29 2e 20 20 49 66 20 78 43 61 6c 6c 62 ck(). If xCallb
34a0: 61 63 6b 3d 4e 55 4c 4c 20 74 68 65 6e 20 6e 6f ack=NULL then no
34b0: 20 63 61 6c 6c 62 61 63 6b 0a 2a 2a 20 69 73 20 callback.** is
34c0: 69 6e 76 6f 6b 65 64 2c 20 65 76 65 6e 20 66 6f invoked, even fo
34d0: 72 20 71 75 65 72 69 65 73 2e 0a 2a 2f 0a 69 6e r queries..*/.in
34e0: 74 20 73 71 6c 69 74 65 5f 65 78 65 63 28 0a 20 t sqlite_exec(.
34f0: 20 73 71 6c 69 74 65 20 2a 64 62 2c 20 20 20 20 sqlite *db,
3500: 20 20 20 20 20 20 20 20 20 20 20 20 20 2f 2a 20 /*
3510: 54 68 65 20 64 61 74 61 62 61 73 65 20 6f 6e 20 The database on
3520: 77 68 69 63 68 20 74 68 65 20 53 51 4c 20 65 78 which the SQL ex
3530: 65 63 75 74 65 73 20 2a 2f 0a 20 20 63 6f 6e 73 ecutes */. cons
3540: 74 20 63 68 61 72 20 2a 7a 53 71 6c 2c 20 20 20 t char *zSql,
3550: 20 20 20 20 20 20 20 20 2f 2a 20 54 68 65 20 53 /* The S
3560: 51 4c 20 74 6f 20 62 65 20 65 78 65 63 75 74 65 QL to be execute
3570: 64 20 2a 2f 0a 20 20 73 71 6c 69 74 65 5f 63 61 d */. sqlite_ca
3580: 6c 6c 62 61 63 6b 20 78 43 61 6c 6c 62 61 63 6b llback xCallback
3590: 2c 20 20 2f 2a 20 49 6e 76 6f 6b 65 20 74 68 69 , /* Invoke thi
35a0: 73 20 63 61 6c 6c 62 61 63 6b 20 72 6f 75 74 69 s callback routi
35b0: 6e 65 20 2a 2f 0a 20 20 76 6f 69 64 20 2a 70 41 ne */. void *pA
35c0: 72 67 2c 20 20 20 20 20 20 20 20 20 20 20 20 20 rg,
35d0: 20 20 20 20 2f 2a 20 46 69 72 73 74 20 61 72 67 /* First arg
35e0: 75 6d 65 6e 74 20 74 6f 20 78 43 61 6c 6c 62 61 ument to xCallba
35f0: 63 6b 28 29 20 2a 2f 0a 20 20 63 68 61 72 20 2a ck() */. char *
3600: 2a 70 7a 45 72 72 4d 73 67 20 20 20 20 20 20 20 *pzErrMsg
3610: 20 20 20 20 20 20 2f 2a 20 57 72 69 74 65 20 65 /* Write e
3620: 72 72 6f 72 20 6d 65 73 73 61 67 65 73 20 68 65 rror messages he
3630: 72 65 20 2a 2f 0a 29 7b 0a 20 20 50 61 72 73 65 re */.){. Parse
3640: 20 73 50 61 72 73 65 3b 0a 0a 20 20 69 66 28 20 sParse;.. if(
3650: 70 7a 45 72 72 4d 73 67 20 29 20 2a 70 7a 45 72 pzErrMsg ) *pzEr
3660: 72 4d 73 67 20 3d 20 30 3b 0a 20 20 69 66 28 20 rMsg = 0;. if(
3670: 28 64 62 2d 3e 66 6c 61 67 73 20 26 20 53 51 4c (db->flags & SQL
3680: 49 54 45 5f 49 6e 69 74 69 61 6c 69 7a 65 64 29 ITE_Initialized)
3690: 3d 3d 30 20 29 7b 0a 20 20 20 20 69 6e 74 20 72 ==0 ){. int r
36a0: 63 20 3d 20 73 71 6c 69 74 65 49 6e 69 74 28 64 c = sqliteInit(d
36b0: 62 2c 20 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 b, pzErrMsg);.
36c0: 20 20 69 66 28 20 72 63 21 3d 53 51 4c 49 54 45 if( rc!=SQLITE
36d0: 5f 4f 4b 20 29 7b 0a 20 20 20 20 20 20 73 71 6c _OK ){. sql
36e0: 69 74 65 53 74 72 52 65 61 6c 6c 6f 63 28 70 7a iteStrRealloc(pz
36f0: 45 72 72 4d 73 67 29 3b 0a 20 20 20 20 20 20 72 ErrMsg);. r
3700: 65 74 75 72 6e 20 72 63 3b 0a 20 20 20 20 7d 0a eturn rc;. }.
3710: 20 20 7d 0a 20 20 6d 65 6d 73 65 74 28 26 73 50 }. memset(&sP
3720: 61 72 73 65 2c 20 30 2c 20 73 69 7a 65 6f 66 28 arse, 0, sizeof(
3730: 73 50 61 72 73 65 29 29 3b 0a 20 20 73 50 61 72 sParse));. sPar
3740: 73 65 2e 64 62 20 3d 20 64 62 3b 0a 20 20 73 50 se.db = db;. sP
3750: 61 72 73 65 2e 70 42 65 20 3d 20 64 62 2d 3e 70 arse.pBe = db->p
3760: 42 65 3b 0a 20 20 73 50 61 72 73 65 2e 78 43 61 Be;. sParse.xCa
3770: 6c 6c 62 61 63 6b 20 3d 20 78 43 61 6c 6c 62 61 llback = xCallba
3780: 63 6b 3b 0a 20 20 73 50 61 72 73 65 2e 70 41 72 ck;. sParse.pAr
3790: 67 20 3d 20 70 41 72 67 3b 0a 20 20 73 71 6c 69 g = pArg;. sqli
37a0: 74 65 52 75 6e 50 61 72 73 65 72 28 26 73 50 61 teRunParser(&sPa
37b0: 72 73 65 2c 20 7a 53 71 6c 2c 20 70 7a 45 72 72 rse, zSql, pzErr
37c0: 4d 73 67 29 3b 0a 20 20 69 66 28 20 73 71 6c 69 Msg);. if( sqli
37d0: 74 65 5f 6d 61 6c 6c 6f 63 5f 66 61 69 6c 65 64 te_malloc_failed
37e0: 20 29 7b 0a 20 20 20 20 73 71 6c 69 74 65 53 65 ){. sqliteSe
37f0: 74 53 74 72 69 6e 67 28 70 7a 45 72 72 4d 73 67 tString(pzErrMsg
3800: 2c 20 22 6f 75 74 20 6f 66 20 6d 65 6d 6f 72 79 , "out of memory
3810: 22 2c 20 30 29 3b 0a 20 20 20 20 73 50 61 72 73 ", 0);. sPars
3820: 65 2e 72 63 20 3d 20 53 51 4c 49 54 45 5f 4e 4f e.rc = SQLITE_NO
3830: 4d 45 4d 3b 0a 20 20 20 20 73 71 6c 69 74 65 42 MEM;. sqliteB
3840: 74 72 65 65 52 6f 6c 6c 62 61 63 6b 28 64 62 2d treeRollback(db-
3850: 3e 70 42 65 29 3b 0a 20 20 20 20 69 66 28 20 64 >pBe);. if( d
3860: 62 2d 3e 70 42 65 54 65 6d 70 20 29 20 73 71 6c b->pBeTemp ) sql
3870: 69 74 65 42 74 72 65 65 52 6f 6c 6c 62 61 63 6b iteBtreeRollback
3880: 28 64 62 2d 3e 70 42 65 54 65 6d 70 29 3b 0a 20 (db->pBeTemp);.
3890: 20 20 20 64 62 2d 3e 66 6c 61 67 73 20 26 3d 20 db->flags &=
38a0: 7e 53 51 4c 49 54 45 5f 49 6e 54 72 61 6e 73 3b ~SQLITE_InTrans;
38b0: 0a 20 20 20 20 63 6c 65 61 72 48 61 73 68 54 61 . clearHashTa
38c0: 62 6c 65 28 64 62 2c 20 30 29 3b 0a 20 20 7d 0a ble(db, 0);. }.
38d0: 20 20 73 71 6c 69 74 65 53 74 72 52 65 61 6c 6c sqliteStrReall
38e0: 6f 63 28 70 7a 45 72 72 4d 73 67 29 3b 0a 20 20 oc(pzErrMsg);.
38f0: 69 66 28 20 73 50 61 72 73 65 2e 72 63 3d 3d 53 if( sParse.rc==S
3900: 51 4c 49 54 45 5f 53 43 48 45 4d 41 20 29 7b 0a QLITE_SCHEMA ){.
3910: 20 20 20 20 63 6c 65 61 72 48 61 73 68 54 61 62 clearHashTab
3920: 6c 65 28 64 62 2c 20 31 29 3b 0a 20 20 7d 0a 20 le(db, 1);. }.
3930: 20 72 65 74 75 72 6e 20 73 50 61 72 73 65 2e 72 return sParse.r
3940: 63 3b 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 c;.}../*.** This
3950: 20 72 6f 75 74 69 6e 65 20 69 6d 70 6c 65 6d 65 routine impleme
3960: 6e 74 73 20 61 20 62 75 73 79 20 63 61 6c 6c 62 nts a busy callb
3970: 61 63 6b 20 74 68 61 74 20 73 6c 65 65 70 73 20 ack that sleeps
3980: 61 6e 64 20 74 72 69 65 73 0a 2a 2a 20 61 67 61 and tries.** aga
3990: 69 6e 20 75 6e 74 69 6c 20 61 20 74 69 6d 65 6f in until a timeo
39a0: 75 74 20 76 61 6c 75 65 20 69 73 20 72 65 61 63 ut value is reac
39b0: 68 65 64 2e 20 20 54 68 65 20 74 69 6d 65 6f 75 hed. The timeou
39c0: 74 20 76 61 6c 75 65 20 69 73 0a 2a 2a 20 61 6e t value is.** an
39d0: 20 69 6e 74 65 67 65 72 20 6e 75 6d 62 65 72 20 integer number
39e0: 6f 66 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 20 of milliseconds
39f0: 70 61 73 73 65 64 20 69 6e 20 61 73 20 74 68 65 passed in as the
3a00: 20 66 69 72 73 74 0a 2a 2a 20 61 72 67 75 6d 65 first.** argume
3a10: 6e 74 2e 0a 2a 2f 0a 73 74 61 74 69 63 20 69 6e nt..*/.static in
3a20: 74 20 73 71 6c 69 74 65 44 65 66 61 75 6c 74 42 t sqliteDefaultB
3a30: 75 73 79 43 61 6c 6c 62 61 63 6b 28 0a 20 76 6f usyCallback(. vo
3a40: 69 64 20 2a 54 69 6d 65 6f 75 74 2c 20 20 20 20 id *Timeout,
3a50: 20 20 20 20 20 20 20 2f 2a 20 4d 61 78 69 6d 75 /* Maximu
3a60: 6d 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69 6d 65 m amount of time
3a70: 20 74 6f 20 77 61 69 74 20 2a 2f 0a 20 63 6f 6e to wait */. con
3a80: 73 74 20 63 68 61 72 20 2a 4e 6f 74 55 73 65 64 st char *NotUsed
3a90: 2c 20 20 20 20 20 2f 2a 20 54 68 65 20 6e 61 6d , /* The nam
3aa0: 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74 e of the table t
3ab0: 68 61 74 20 69 73 20 62 75 73 79 20 2a 2f 0a 20 hat is busy */.
3ac0: 69 6e 74 20 63 6f 75 6e 74 20 20 20 20 20 20 20 int count
3ad0: 20 20 20 20 20 20 20 20 20 2f 2a 20 4e 75 6d 62 /* Numb
3ae0: 65 72 20 6f 66 20 74 69 6d 65 73 20 74 61 62 6c er of times tabl
3af0: 65 20 68 61 73 20 62 65 65 6e 20 62 75 73 79 20 e has been busy
3b00: 2a 2f 0a 29 7b 0a 23 69 66 20 53 51 4c 49 54 45 */.){.#if SQLITE
3b10: 5f 4d 49 4e 5f 53 4c 45 45 50 5f 4d 53 3d 3d 31 _MIN_SLEEP_MS==1
3b20: 0a 20 20 69 6e 74 20 64 65 6c 61 79 20 3d 20 31 . int delay = 1
3b30: 30 3b 0a 20 20 69 6e 74 20 70 72 69 6f 72 5f 64 0;. int prior_d
3b40: 65 6c 61 79 20 3d 20 30 3b 0a 20 20 69 6e 74 20 elay = 0;. int
3b50: 74 69 6d 65 6f 75 74 20 3d 20 28 69 6e 74 29 54 timeout = (int)T
3b60: 69 6d 65 6f 75 74 3b 0a 20 20 69 6e 74 20 69 3b imeout;. int i;
3b70: 0a 0a 20 20 66 6f 72 28 69 3d 31 3b 20 69 3c 63 .. for(i=1; i<c
3b80: 6f 75 6e 74 3b 20 69 2b 2b 29 7b 20 0a 20 20 20 ount; i++){ .
3b90: 20 70 72 69 6f 72 5f 64 65 6c 61 79 20 2b 3d 20 prior_delay +=
3ba0: 64 65 6c 61 79 3b 0a 20 20 20 20 64 65 6c 61 79 delay;. delay
3bb0: 20 3d 20 64 65 6c 61 79 2a 32 3b 0a 20 20 20 20 = delay*2;.
3bc0: 69 66 28 20 64 65 6c 61 79 3e 3d 31 30 30 30 20 if( delay>=1000
3bd0: 29 7b 0a 20 20 20 20 20 20 64 65 6c 61 79 20 3d ){. delay =
3be0: 20 31 30 30 30 3b 0a 20 20 20 20 20 20 70 72 69 1000;. pri
3bf0: 6f 72 5f 64 65 6c 61 79 20 2b 3d 20 31 30 30 30 or_delay += 1000
3c00: 2a 28 63 6f 75 6e 74 20 2d 20 69 20 2d 20 31 29 *(count - i - 1)
3c10: 3b 0a 20 20 20 20 20 20 62 72 65 61 6b 3b 0a 20 ;. break;.
3c20: 20 20 20 7d 0a 20 20 7d 0a 20 20 69 66 28 20 70 }. }. if( p
3c30: 72 69 6f 72 5f 64 65 6c 61 79 20 2b 20 64 65 6c rior_delay + del
3c40: 61 79 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a ay > timeout ){.
3c50: 20 20 20 20 64 65 6c 61 79 20 3d 20 74 69 6d 65 delay = time
3c60: 6f 75 74 20 2d 20 70 72 69 6f 72 5f 64 65 6c 61 out - prior_dela
3c70: 79 3b 0a 20 20 20 20 69 66 28 20 64 65 6c 61 79 y;. if( delay
3c80: 3c 3d 30 20 29 20 72 65 74 75 72 6e 20 30 3b 0a <=0 ) return 0;.
3c90: 20 20 7d 0a 20 20 73 71 6c 69 74 65 4f 73 53 6c }. sqliteOsSl
3ca0: 65 65 70 28 64 65 6c 61 79 29 3b 0a 20 20 72 65 eep(delay);. re
3cb0: 74 75 72 6e 20 31 3b 0a 23 65 6c 73 65 0a 20 20 turn 1;.#else.
3cc0: 69 6e 74 20 74 69 6d 65 6f 75 74 20 3d 20 28 69 int timeout = (i
3cd0: 6e 74 29 54 69 6d 65 6f 75 74 3b 0a 20 20 69 66 nt)Timeout;. if
3ce0: 28 20 28 63 6f 75 6e 74 2b 31 29 2a 31 30 30 30 ( (count+1)*1000
3cf0: 20 3e 20 74 69 6d 65 6f 75 74 20 29 7b 0a 20 20 > timeout ){.
3d00: 20 20 72 65 74 75 72 6e 20 30 3b 0a 20 20 7d 0a return 0;. }.
3d10: 20 20 73 71 6c 69 74 65 4f 73 53 6c 65 65 70 28 sqliteOsSleep(
3d20: 31 30 30 30 29 3b 0a 20 20 72 65 74 75 72 6e 20 1000);. return
3d30: 31 3b 0a 23 65 6e 64 69 66 0a 7d 0a 0a 2f 2a 0a 1;.#endif.}../*.
3d40: 2a 2a 20 54 68 69 73 20 72 6f 75 74 69 6e 65 20 ** This routine
3d50: 73 65 74 73 20 74 68 65 20 62 75 73 79 20 63 61 sets the busy ca
3d60: 6c 6c 62 61 63 6b 20 66 6f 72 20 61 6e 20 53 71 llback for an Sq
3d70: 6c 69 74 65 20 64 61 74 61 62 61 73 65 20 74 6f lite database to
3d80: 20 74 68 65 0a 2a 2a 20 67 69 76 65 6e 20 63 61 the.** given ca
3d90: 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 20 llback function
3da0: 77 69 74 68 20 74 68 65 20 67 69 76 65 6e 20 61 with the given a
3db0: 72 67 75 6d 65 6e 74 2e 0a 2a 2f 0a 76 6f 69 64 rgument..*/.void
3dc0: 20 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e sqlite_busy_han
3dd0: 64 6c 65 72 28 0a 20 20 73 71 6c 69 74 65 20 2a dler(. sqlite *
3de0: 64 62 2c 0a 20 20 69 6e 74 20 28 2a 78 42 75 73 db,. int (*xBus
3df0: 79 29 28 76 6f 69 64 2a 2c 63 6f 6e 73 74 20 63 y)(void*,const c
3e00: 68 61 72 2a 2c 69 6e 74 29 2c 0a 20 20 76 6f 69 har*,int),. voi
3e10: 64 20 2a 70 41 72 67 0a 29 7b 0a 20 20 64 62 2d d *pArg.){. db-
3e20: 3e 78 42 75 73 79 43 61 6c 6c 62 61 63 6b 20 3d >xBusyCallback =
3e30: 20 78 42 75 73 79 3b 0a 20 20 64 62 2d 3e 70 42 xBusy;. db->pB
3e40: 75 73 79 41 72 67 20 3d 20 70 41 72 67 3b 0a 7d usyArg = pArg;.}
3e50: 0a 0a 2f 2a 0a 2a 2a 20 54 68 69 73 20 72 6f 75 ../*.** This rou
3e60: 74 69 6e 65 20 69 6e 73 74 61 6c 6c 73 20 61 20 tine installs a
3e70: 64 65 66 61 75 6c 74 20 62 75 73 79 20 68 61 6e default busy han
3e80: 64 6c 65 72 20 74 68 61 74 20 77 61 69 74 73 20 dler that waits
3e90: 66 6f 72 20 74 68 65 0a 2a 2a 20 73 70 65 63 69 for the.** speci
3ea0: 66 69 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 6d fied number of m
3eb0: 69 6c 6c 69 73 65 63 6f 6e 64 73 20 62 65 66 6f illiseconds befo
3ec0: 72 65 20 72 65 74 75 72 6e 69 6e 67 20 30 2e 0a re returning 0..
3ed0: 2a 2f 0a 76 6f 69 64 20 73 71 6c 69 74 65 5f 62 */.void sqlite_b
3ee0: 75 73 79 5f 74 69 6d 65 6f 75 74 28 73 71 6c 69 usy_timeout(sqli
3ef0: 74 65 20 2a 64 62 2c 20 69 6e 74 20 6d 73 29 7b te *db, int ms){
3f00: 0a 20 20 69 66 28 20 6d 73 3e 30 20 29 7b 0a 20 . if( ms>0 ){.
3f10: 20 20 20 73 71 6c 69 74 65 5f 62 75 73 79 5f 68 sqlite_busy_h
3f20: 61 6e 64 6c 65 72 28 64 62 2c 20 73 71 6c 69 74 andler(db, sqlit
3f30: 65 44 65 66 61 75 6c 74 42 75 73 79 43 61 6c 6c eDefaultBusyCall
3f40: 62 61 63 6b 2c 20 28 76 6f 69 64 2a 29 6d 73 29 back, (void*)ms)
3f50: 3b 0a 20 20 7d 65 6c 73 65 7b 0a 20 20 20 20 73 ;. }else{. s
3f60: 71 6c 69 74 65 5f 62 75 73 79 5f 68 61 6e 64 6c qlite_busy_handl
3f70: 65 72 28 64 62 2c 20 30 2c 20 30 29 3b 0a 20 20 er(db, 0, 0);.
3f80: 7d 0a 7d 0a 0a 2f 2a 0a 2a 2a 20 43 61 75 73 65 }.}../*.** Cause
3f90: 20 61 6e 79 20 70 65 6e 64 69 6e 67 20 6f 70 65 any pending ope
3fa0: 72 61 74 69 6f 6e 20 74 6f 20 73 74 6f 70 20 61 ration to stop a
3fb0: 74 20 69 74 73 20 65 61 72 6c 69 65 73 74 20 6f t its earliest o
3fc0: 70 70 6f 72 74 75 6e 69 74 79 2e 0a 2a 2f 0a 76 pportunity..*/.v
3fd0: 6f 69 64 20 73 71 6c 69 74 65 5f 69 6e 74 65 72 oid sqlite_inter
3fe0: 72 75 70 74 28 73 71 6c 69 74 65 20 2a 64 62 29 rupt(sqlite *db)
3ff0: 7b 0a 20 20 64 62 2d 3e 66 6c 61 67 73 20 7c 3d {. db->flags |=
4000: 20 53 51 4c 49 54 45 5f 49 6e 74 65 72 72 75 70 SQLITE_Interrup
4010: 74 3b 0a 7d 0a t;.}.